Techcle Wiki

Wiki

1 min read

Wiki

Git-backed, AI-maintained knowledge system — this site. A synthesis layer that references and cross-links content from source repositories, Paperclip issues, and GitHub.

Stack: Quartz 4 (static site generator), TypeScript/Node.js, nginx:alpine Repo: craigedmunds/wiki Deployed at: wiki.lab.ctoaas.co (public, authenticated) / wiki.lab.local.ctoaas.co (local)

How It Works

  1. Source ingestion (ingest-sources.sh) copies markdown from .ai/, all repo READMEs, and docs folders into content/sources/ at build time
  2. Quartz build renders all content into a static site with graph view, backlinks, search, and wikilinks
  3. nginx pod serves the dist/ output from the PVC — no image rebuild needed for content changes

Key Features

  • Graph view — interactive D3 visualisation of page connections
  • Full-text search — client-side FlexSearch index
  • Backlinks — automatic bi-directional linking
  • Wikilinks — [[page-name]] syntax
  • Source SHA tracking — pages record source git SHAs for staleness detection

Build Pipeline

task wiki:build
  → scripts/ingest-sources.sh  (populate content/sources/)
  → npx quartz build           (generate static site)
  → scripts/flatten-urls.sh    (clean URL support)

Deployment

  • K8s manifests in k8s/base/ (dojo pattern)
  • ArgoCD seed in k8s-lab other-seeds/wiki.yaml
  • nginx:alpine pod mounting code-server-storage PVC read-only

Graph View

Backlinks