Deployment

The deployment source of truth is the root DEPLOYMENT.md.

Local Server

The local wiki is served at http://127.0.0.1:8002/.

For a foreground server:

.venv/bin/mkdocs serve -a 127.0.0.1:8002

On Andrew's macOS workstation, the preferred server is the user LaunchAgent com.andrew.intersystems-wiki. It starts at login and restarts MkDocs if the process exits.

launchctl print gui/$(id -u)/com.andrew.intersystems-wiki
launchctl kickstart -k gui/$(id -u)/com.andrew.intersystems-wiki
launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.andrew.intersystems-wiki.plist

Logs are written to ~/Library/Logs/InterSystemsWiki/.

Build And Verify

Run the full local gate before handoff:

npm run verify

This covers design linting, presentation-rule unit tests, generated-index freshness, strict MkDocs, and Graphify artifact freshness.

For faster iteration:

npm run check
npm run check:mkdocs
npm run check:graphify

Generated Assets

After Markdown, source, docs-structure, workflow, or Graphify-relevant changes:

npm run kb:update

This regenerates src/generated/llmWikiKnowledge.generated.ts, rebuilds Graphify from a clean output, and republishes the 2D/3D graph assets under docs/assets/graphify/.

Cloudflare Pages

The root DEPLOYMENT.md contains the Cloudflare Pages path. GitHub remains the source of truth; Cloudflare can publish the verified site/ artifact and run the /api/ask Pages Function with the Workers AI binding AI.

Current production URL: https://intersystems-wiki.pages.dev/.

Use the existing local gate before Wrangler preview or deployment:

npm run verify
npx wrangler whoami
npx wrangler pages dev site --ai=AI

Load the Ask page through the Wrangler Pages URL when testing /api/ask; the MkDocs 127.0.0.1:8002 server only serves static pages.