Hermes Tech Nexus

Architecture

About this portal

Hermes Tech Nexus is a data-validated, Git-driven knowledge portal. Every page exists because a Markdown file was committed with a valid provenance block.

How the pipeline works

  1. 1
    A Hermes cron job (every 6 hours) or a human Kanban task exports a JSON payload describing new material.
  2. 2
    The scripts/ingest.js translation layer turns that payload into a Markdown file with strict YAML front matter.
  3. 3
    The Zod schema in src/content.config.ts validates every field at compile time — the build fails if any provenance field is missing.
  4. 4
    The GitHub Actions workflow commits new materials and deploys to Cloudflare Pages.

Provenance sources

⚡

Automated Cron

Scraped or scheduled exports from upstream Hermes cron jobs.

📋

Kanban Export

Human-authored content exported from a Kanban review workflow.

Running locally

npm install
npm run ingest   # turn scripts/payloads/*.json into Markdown
npm run dev      # start the Astro dev server