Operations

This page collects the commands that keep the index usable as a documentation site and as an agent-facing operating memory.

Local Checks

npm ci
make check
npm run check:watson
npm run test:watson

The root make check verifies core files and Python syntax for the MCP server. Watson checks cover the TypeScript merge-conflict analysis harness.

Documentation Site

npm run docs:dev
npm run docs:build
npm run docs:preview

The production build is emitted to docs/.vitepress/dist. The VitePress LLM plugin writes llms.txt and llms-full.txt into that output directory.

Deploy Docs

The docs are configured for Cloudflare Pages project cdp-index.

npm run docs:deploy

Deployment settings:

Setting	Value
Build command	npm run docs:build
Output directory	docs/.vitepress/dist
Pages project	cdp-index
Target host	Custom hostname attached in Cloudflare Pages

The custom hostname is attached to the Pages project. It requires this DNS record in the relevant Cloudflare zone:

Type	Name	Target	Proxy
CNAME	Custom hostname label	cdp-index.pages.dev	Proxied

Doppler

Shared Doppler bindings live in doppler.yaml. The manifest lists project/config names and required secret names, but never secret values.

npm run env:doppler:projects
npm run env:doppler:check -- adapt-action-explorer

The current Adapt Action Explorer automation expects Slack, Typeform, PostHog, and OpenCode Zen secrets.

Adapt Action Explorer Automation

Run these from adapt-action-explorer/ after installing dependencies:

npm run check
npm run env:check
npm run feedback:share-slack:dry-run -- --date 2026-06-08
npm run posthog:share-slack:dry-run
npm run sentry:setup-alerts
npm run symphony:once -- --workflow ./WORKFLOW.md

MCP Server

cd mcp
uv sync
uv run src/server.py

Use MCP_TRANSPORT=http PORT=8080 uv run src/server.py for local HTTP testing.