# =====================================================================
# subagentceo/knowledge-engineering — Deployment Runbook
# TABLE OF CONTENTS (cite refs map to references: block below)
# refs are absolute entry-point URLs (absolute_entrypoint + relative)
# =====================================================================
table_of_contents:
- section: "0. topology" cites: [1]
- section: "1. task_state_machine (canonical)" cites: [2, 3]
- section: "2. schema_contract (ts→py→rust)" cites: [4, 5, 6, 7]
- section: "3. pg_durable setup" cites: [3]
- section: "4. per-language MCP servers" cites: [2, 8, 9, 10, 11]
- section: "5. claude_code_web setup" cites: [12]
- section: "6. repo ⇄ site wiring" cites: [1]
- section: "7. cloudflare subdomain runbook" cites: [12] # user-executed
- section: "8. end-to-end durable task flow" cites: [2, 3]
# ---------------------------------------------------------------------
# REFERENCES (absolute entry-point URLs; reuse anchors inline as # [n])
# ---------------------------------------------------------------------
references:
1:
repo: https://github.com/subagentceo/knowledge-engineering
issue: https://github.com/subagentceo/knowledge-engineering/issues/504
2:
github: https://github.com/modelcontextprotocol/ext-tasks
npm: https://www.npmjs.com/package/@modelcontextprotocol/sdk # 1.29.0
pypi: https://pypi.org/project/mcp/ # 1.28.0
crates: https://crates.io/crates/rmcp # 0.16.0
3:
github: https://github.com/microsoft/pg_durable
4:
github: https://github.com/fabien0102/ts-to-zod
npm: https://www.npmjs.com/package/ts-to-zod
npm_zod: https://www.npmjs.com/package/zod # 4.x
5: # TS schema/runtime authority
github: https://github.com/anthropics/anthropic-sdk-typescript
npm: https://www.npmjs.com/package/@anthropic-ai/sdk # 0.104.2
6: # Python schema/runtime authority
github: https://github.com/anthropics/anthropic-sdk-python
pypi: https://pypi.org/project/anthropic/
pydantic:https://pypi.org/project/pydantic/ # 2.13.4
7: # Rust schema/runtime authority
github: https://github.com/anthropics/buffa
crates: https://crates.io/crates/serde
crates_json: https://crates.io/crates/serde_json
crates_schemars:https://crates.io/crates/schemars
8: # MCP servers (TS/Py/Rust)
github: https://github.com/modelcontextprotocol/servers
github_ts: https://github.com/modelcontextprotocol/typescript-sdk
github_py: https://github.com/modelcontextprotocol/python-sdk
github_rs: https://github.com/modelcontextprotocol/rust-sdk
npm: https://www.npmjs.com/package/@modelcontextprotocol/sdk # 1.29.0
pypi: https://pypi.org/project/mcp/ # 1.28.0
crates: https://crates.io/crates/rmcp # 0.16.0
9: # ACP (TS/Py/Rust)
github: https://github.com/agentclientprotocol/agent-client-protocol
github_ts: https://github.com/agentclientprotocol/typescript-sdk
github_py: https://github.com/agentclientprotocol/python-sdk
github_rs: https://github.com/agentclientprotocol/rust-sdk
pypi: https://pypi.org/project/agent-client-protocol/
crates: https://crates.io/crates/agent-client-protocol
10: # Redis Rust client
github: https://github.com/redis-rs/redis-rs
crates: https://crates.io/crates/redis # redis-rs, 1.x
11: # Redis (TS/Py)
github: https://github.com/redis/node-redis
github_py: https://github.com/redis/redis-py
npm: https://www.npmjs.com/package/redis
npm_client: https://www.npmjs.com/package/@redis/client # 6.0.0
pypi: https://pypi.org/project/redis/ # 8.0.0
12:
human: https://code.claude.com/docs/en/claude-code-on-the-web
agent: https://code.claude.com/docs/en/claude-code-on-the-web.md
section: https://code.claude.com/docs/en/claude-code-on-the-web#setup-scripts
github:
absolute_entrypoint: https://github.com
orgs:
anthropics:
anthropic-sdk-typescript: /anthropics/anthropic-sdk-typescript
anthropic-sdk-python: /anthropics/anthropic-sdk-python
anthropic-sdk-go: /anthropics/anthropic-sdk-go
anthropic-sdk-java: /anthropics/anthropic-sdk-java
anthropic-sdk-ruby: /anthropics/anthropic-sdk-ruby
anthropic-sdk-csharp: /anthropics/anthropic-sdk-csharp
anthropic-sdk-php: /anthropics/anthropic-sdk-php
anthropic-bedrock-typescript: /anthropics/anthropic-bedrock-typescript
anthropic-bedrock-python: /anthropics/anthropic-bedrock-python
anthropic-tokenizer-typescript: /anthropics/anthropic-tokenizer-typescript
anthropic-cli: /anthropics/anthropic-cli
anthropic-tools: /anthropics/anthropic-tools
anthropic-retrieval-demo: /anthropics/anthropic-retrieval-demo
claude-code: /anthropics/claude-code
claude-code-action: /anthropics/claude-code-action
claude-code-base-action: /anthropics/claude-code-base-action
claude-code-security-review: /anthropics/claude-code-security-review
claude-code-monitoring-guide: /anthropics/claude-code-monitoring-guide
claude-agent-sdk-python: /anthropics/claude-agent-sdk-python
claude-agent-sdk-typescript: /anthropics/claude-agent-sdk-typescript
claude-agent-sdk-demos: /anthropics/claude-agent-sdk-demos
agent-sdk-workshop: /anthropics/agent-sdk-workshop
claude-quickstarts: /anthropics/claude-quickstarts
claude-cookbooks: /anthropics/claude-cookbooks
claude-plugins-official: /anthropics/claude-plugins-official
claude-plugins-community: /anthropics/claude-plugins-community
claude-for-legal: /anthropics/claude-for-legal
claude-ai-mcp: /anthropics/claude-ai-mcp
claude-desktop-buddy: /anthropics/claude-desktop-buddy
claude-constitution: /anthropics/claude-constitution
claudes-c-compiler: /anthropics/claudes-c-compiler
ClaudeForFoundationModels: /anthropics/ClaudeForFoundationModels
knowledge-work-plugins: /anthropics/knowledge-work-plugins
skills: /anthropics/skills
courses: /anthropics/courses
prompt-eng-interactive-tutorial: /anthropics/prompt-eng-interactive-tutorial
healthcare: /anthropics/healthcare
financial-services: /anthropics/financial-services
life-sciences: /anthropics/life-sciences
defending-code-reference-harness: /anthropics/defending-code-reference-harness
scone-bench: /anthropics/scone-bench
cwc-workshops: /anthropics/cwc-workshops
cwc-long-running-agents: /anthropics/cwc-long-running-agents
launch-your-agent: /anthropics/launch-your-agent
html-effectiveness: /anthropics/html-effectiveness
devcontainer-features: /anthropics/devcontainer-features
tailscale-hint-extension: /anthropics/tailscale-hint-extension
homebrew-tap: /anthropics/homebrew-tap
homebrew-claude: /anthropics/homebrew-claude
buffa: /anthropics/buffa
connect-rust: /anthropics/connect-rust
cargo-nix-plugin: /anthropics/cargo-nix-plugin
tokio: /anthropics/tokio
riegeli-rs: /anthropics/riegeli-rs
leptos-chartistry: /anthropics/leptos-chartistry
redis-py: /anthropics/redis-py
github-mcp-server: /anthropics/github-mcp-server
httpcore: /anthropics/httpcore
hypercorn: /anthropics/hypercorn
sse-starlette: /anthropics/sse-starlette
orjson: /anthropics/orjson
torchtyping: /anthropics/torchtyping
apitools: /anthropics/apitools
blobfile: /anthropics/blobfile
python-tblib: /anthropics/python-tblib
cfaulthandler: /anthropics/cfaulthandler
s5cmd: /anthropics/s5cmd
rclone: /anthropics/rclone
rcp_argo-cd: /anthropics/argo-cd
terragrunt: /anthropics/terragrunt
maestro: /anthropics/maestro
beam: /anthropics/beam
triton: /anthropics/triton
nix-eval-jobs: /anthropics/nix-eval-jobs
swift-markdown: /anthropics/swift-markdown
swift-markdown-ui: /anthropics/swift-markdown-ui
headvis: /anthropics/headvis
model-cards: /anthropics/model-cards
evals: /anthropics/evals
political-neutrality-eval: /anthropics/political-neutrality-eval
original_performance_takehome: /anthropics/original_performance_takehome
riv2025-long-horizon-coding-agent-demo: /anthropics/riv2025-long-horizon-coding-agent-demo
hh-rlhf: /anthropics/hh-rlhf
attribution-graphs-frontend: /anthropics/attribution-graphs-frontend
sycophancy-to-subterfuge-paper: /anthropics/sycophancy-to-subterfuge-paper
sleeper-agents-paper: /anthropics/sleeper-agents-paper
ConstitutionalHarmlessnessPaper: /anthropics/ConstitutionalHarmlessnessPaper
DecompositionFaithfulnessPaper: /anthropics/DecompositionFaithfulnessPaper
toy-models-of-superposition: /anthropics/toy-models-of-superposition
rogue-deploy-eval: /anthropics/rogue-deploy-eval
PySvelte: /anthropics/PySvelte
modelcontextprotocol:
typescript-sdk: /modelcontextprotocol/typescript-sdk
python-sdk: /modelcontextprotocol/python-sdk
rust-sdk: /modelcontextprotocol/rust-sdk
go-sdk: /modelcontextprotocol/go-sdk
kotlin-sdk: /modelcontextprotocol/kotlin-sdk
csharp-sdk: /modelcontextprotocol/csharp-sdk
java-sdk: /modelcontextprotocol/java-sdk
ruby-sdk: /modelcontextprotocol/ruby-sdk
php-sdk: /modelcontextprotocol/php-sdk
swift-sdk: /modelcontextprotocol/swift-sdk
modelcontextprotocol: /modelcontextprotocol/modelcontextprotocol
servers: /modelcontextprotocol/servers
servers-archived: /modelcontextprotocol/servers-archived
inspector: /modelcontextprotocol/inspector
registry: /modelcontextprotocol/registry
conformance: /modelcontextprotocol/conformance
quickstart-resources: /modelcontextprotocol/quickstart-resources
create-python-server: /modelcontextprotocol/create-python-server
create-typescript-server: /modelcontextprotocol/create-typescript-server
access: /modelcontextprotocol/access
dns: /modelcontextprotocol/dns
mcpb: /modelcontextprotocol/mcpb
use-mcp: /modelcontextprotocol/use-mcp
static: /modelcontextprotocol/static
docs: /modelcontextprotocol/docs
actions: /modelcontextprotocol/actions
example-remote-server: /modelcontextprotocol/example-remote-server
example-remote-client: /modelcontextprotocol/example-remote-client
ext-auth: /modelcontextprotocol/ext-auth
ext-apps: /modelcontextprotocol/ext-apps
ext-tasks: /modelcontextprotocol/ext-tasks
experimental-ext-interceptors: /modelcontextprotocol/experimental-ext-interceptors
experimental-ext-skills: /modelcontextprotocol/experimental-ext-skills
experimental-ext-variants: /modelcontextprotocol/experimental-ext-variants
experimental-ext-server-card: /modelcontextprotocol/experimental-ext-server-card
experimental-ext-tool-annotations: /modelcontextprotocol/experimental-ext-tool-annotations
experimental-ext-triggers-events: /modelcontextprotocol/experimental-ext-triggers-events
experimental-ext-grouping: /modelcontextprotocol/experimental-ext-grouping
transports-wg: /modelcontextprotocol/transports-wg
agents-wg: /modelcontextprotocol/agents-wg
financial-services-interest-group: /modelcontextprotocol/financial-services-interest-group
agentclientprotocol:
agent-client-protocol: /agentclientprotocol/agent-client-protocol
typescript-sdk: /agentclientprotocol/typescript-sdk
python-sdk: /agentclientprotocol/python-sdk
rust-sdk: /agentclientprotocol/rust-sdk
java-sdk: /agentclientprotocol/java-sdk
kotlin-sdk: /agentclientprotocol/kotlin-sdk
claude-agent-acp: /agentclientprotocol/claude-agent-acp
codex-acp: /agentclientprotocol/codex-acp
acpr: /agentclientprotocol/acpr
symposium-acp: /agentclientprotocol/symposium-acp
registry: /agentclientprotocol/registry
docs: /agentclientprotocol/docs
meetings: /agentclientprotocol/meetings
a2aproject:
A2A: /a2aproject/A2A
a2a-js: /a2aproject/a2a-js
a2a-python: /a2aproject/a2a-python
a2a-rs: /a2aproject/a2a-rs
a2a-go: /a2aproject/a2a-go
a2a-java: /a2aproject/a2a-java
a2a-dotnet: /a2aproject/a2a-dotnet
a2a-samples: /a2aproject/a2a-samples
a2a-inspector: /a2aproject/a2a-inspector
a2a-itk: /a2aproject/a2a-itk
a2a-tck: /a2aproject/a2a-tck
a2a-gateway: /a2aproject/a2a-gateway
adk-docs: /a2aproject/adk-docs
experimental-cpb-slimrpc: /a2aproject/experimental-cpb-slimrpc
experimental-ext-oid4vp-auth: /a2aproject/experimental-ext-oid4vp-auth
redis:
redis: /redis/redis
node-redis: /redis/node-redis
ioredis: /redis/ioredis
redis-py: /redis/redis-py
redis-py-entraid: /redis/redis-py-entraid
go-redis: /redis/go-redis
go-redis-entraid: /redis/go-redis-entraid
rueidis: /redis/rueidis
jedis: /redis/jedis
lettuce: /redis/lettuce
lettucemod: /redis/lettucemod
redis-rb: /redis/redis-rb
NRedisStack: /redis/NRedisStack
hiredis: /redis/hiredis
hiredis-py: /redis/hiredis-py
hiredis-rb: /redis/hiredis-rb
hiredis-node: /redis/hiredis-node
hiredis-rs: /redis/hiredis-rs
hiredis-rs-sys: /redis/hiredis-rs-sys
librdb: /redis/librdb
RedisInsight: /redis/RedisInsight
Redis-for-VS-Code: /redis/Redis-for-VS-Code
RedisDesktopManager: /redis/RedisDesktopManager
mcp-redis: /redis/mcp-redis
mcp-redis-cloud: /redis/mcp-redis-cloud
redis-mcp-java: /redis/redis-mcp-java
agent-memory-server: /redis/agent-memory-server
agent-filesystem: /redis/agent-filesystem
agent-skills: /redis/agent-skills
redis-vl-python: /redis/redis-vl-python
redis-vl-java: /redis/redis-vl-java
vector-sets-browser: /redis/vector-sets-browser
redis-om-python: /redis/redis-om-python
redis-om-node: /redis/redis-om-node
redis-om-spring: /redis/redis-om-spring
redis-om-dotnet: /redis/redis-om-dotnet
redisctl: /redis/redisctl
riot: /redis/riot
fastapi-redis-sdk: /redis/fastapi-redis-sdk
docker-library-redis: /redis/docker-library-redis
redis-debian: /redis/redis-debian
redis-rpm: /redis/redis-rpm
redis-snap: /redis/redis-snap
redis-hashes: /redis/redis-hashes
memtier_benchmark: /redis/memtier_benchmark
redis-benchmarks-specification: /redis/redis-benchmarks-specification
docs: /redis/docs
redis-doc: /redis/redis-doc
Tutorials: /redis/Tutorials
redis-rs:
redis-rs: /redis-rs/redis-rs
microsoft:
pg_durable: /microsoft/pg_durable
fabien0102:
ts-to-zod: /fabien0102/ts-to-zod
subagentceo:
knowledge-engineering: /subagentceo/knowledge-engineering
npmjs:
absolute_entrypoint: https://www.npmjs.com
orgs:
anthropic-ai: # /org/anthropic-ai
"@anthropic-ai/sdk": /package/@anthropic-ai/sdk # 0.104.2
"@anthropic-ai/claude-code": /package/@anthropic-ai/claude-code # 2.1.181
"@anthropic-ai/claude-agent-sdk": /package/@anthropic-ai/claude-agent-sdk # 0.3.181
"@anthropic-ai/aws-sdk": /package/@anthropic-ai/aws-sdk # 0.4.2
"@anthropic-ai/bedrock-sdk": /package/@anthropic-ai/bedrock-sdk # 0.30.2
"@anthropic-ai/vertex-sdk": /package/@anthropic-ai/vertex-sdk # 0.17.1
"@anthropic-ai/foundry-sdk": /package/@anthropic-ai/foundry-sdk # 0.3.1
"@anthropic-ai/sandbox-runtime": /package/@anthropic-ai/sandbox-runtime # 0.0.55
"@anthropic-ai/tokenizer": /package/@anthropic-ai/tokenizer # 0.0.4
"@anthropic-ai/claude-trace": /package/@anthropic-ai/claude-trace # 0.1.2
"@anthropic-ai/dxt": /package/@anthropic-ai/dxt # 0.2.6
"@anthropic-ai/mcpb": /package/@anthropic-ai/mcpb # 2.1.2
"@anthropic-ai/universal-sdk": /package/@anthropic-ai/universal-sdk # 0.0.0
anthropic: /package/anthropic # 0.0.0 (legacy)
claude-agent-sdk-native: /package/@anthropic-ai/claude-agent-sdk-darwin-arm64 # +darwin-x64, linux-arm64[-musl], linux-x64[-musl], win32-arm64, win32-x64 @0.3.181
claude-code-native: /package/@anthropic-ai/claude-code-darwin-arm64 # +darwin-x64, linux-arm64[-musl], linux-x64[-musl], win32-arm64, win32-x64 @2.1.181
modelcontextprotocol: # /org/modelcontextprotocol
"@modelcontextprotocol/sdk": /package/@modelcontextprotocol/sdk # 1.29.0
"@modelcontextprotocol/client": /package/@modelcontextprotocol/client # 2.0.0-alpha.2
"@modelcontextprotocol/server": /package/@modelcontextprotocol/server # 2.0.0-alpha.2
"@modelcontextprotocol/node": /package/@modelcontextprotocol/node # 2.0.0-alpha.2
"@modelcontextprotocol/express": /package/@modelcontextprotocol/express # 2.0.0-alpha.2
"@modelcontextprotocol/fastify": /package/@modelcontextprotocol/fastify # 2.0.0-alpha.2
"@modelcontextprotocol/hono": /package/@modelcontextprotocol/hono # 2.0.0-alpha.2
"@modelcontextprotocol/ext-apps": /package/@modelcontextprotocol/ext-apps # 1.7.4
"@modelcontextprotocol/conformance": /package/@modelcontextprotocol/conformance # 0.1.16
"@modelcontextprotocol/create-server": /package/@modelcontextprotocol/create-server # 0.3.1
"@modelcontextprotocol/inspector": /package/@modelcontextprotocol/inspector # 0.22.0
"@modelcontextprotocol/inspector-cli": /package/@modelcontextprotocol/inspector-cli # 0.22.0
"@modelcontextprotocol/inspector-client": /package/@modelcontextprotocol/inspector-client # 0.22.0
"@modelcontextprotocol/inspector-server": /package/@modelcontextprotocol/inspector-server # 0.22.0
"@modelcontextprotocol/server-everything": /package/@modelcontextprotocol/server-everything # 2026.1.26
"@modelcontextprotocol/server-filesystem": /package/@modelcontextprotocol/server-filesystem # 2026.1.14
"@modelcontextprotocol/server-memory": /package/@modelcontextprotocol/server-memory # 2026.1.26
"@modelcontextprotocol/server-sequential-thinking": /package/@modelcontextprotocol/server-sequential-thinking # 2025.12.18
"@modelcontextprotocol/server-github": /package/@modelcontextprotocol/server-github # 2025.4.8
"@modelcontextprotocol/server-gitlab": /package/@modelcontextprotocol/server-gitlab # 2025.4.25
"@modelcontextprotocol/server-gdrive": /package/@modelcontextprotocol/server-gdrive # 2025.1.14
"@modelcontextprotocol/server-slack": /package/@modelcontextprotocol/server-slack # 2025.4.25
"@modelcontextprotocol/server-puppeteer": /package/@modelcontextprotocol/server-puppeteer # 2025.5.12
"@modelcontextprotocol/server-postgres": /package/@modelcontextprotocol/server-postgres # 0.6.2
"@modelcontextprotocol/server-redis": /package/@modelcontextprotocol/server-redis # 2025.4.25
"@modelcontextprotocol/server-brave-search": /package/@modelcontextprotocol/server-brave-search # 0.6.2
"@modelcontextprotocol/server-google-maps": /package/@modelcontextprotocol/server-google-maps # 0.6.2
"@modelcontextprotocol/server-everart": /package/@modelcontextprotocol/server-everart # 0.6.2
"@modelcontextprotocol/server-aws-kb-retrieval": /package/@modelcontextprotocol/server-aws-kb-retrieval # 0.6.2
# apps-server examples @1.7.4: server-debug, server-map, server-pdf, server-threejs, server-shadertoy,
# server-transcript, server-sheet-music, server-system-monitor, server-budget-allocator,
# server-cohort-heatmap, server-customer-segmentation, server-scenario-modeler, server-lazy-auth,
# server-wiki-explorer, server-video-resource, server-basic-{react,preact,solid,svelte,vue,vanillajs}
redis: # /org/redis
redis: /package/redis # node-redis meta
"@redis/client": /package/@redis/client # 6.0.0
"@redis/bloom": /package/@redis/bloom # 6.0.0
"@redis/entraid": /package/@redis/entraid # 6.0.0
"@redis/graph": /package/@redis/graph # 1.1.1
"@redis/json": /package/@redis/json # 6.0.0
"@redis/search": /package/@redis/search # 6.0.0
"@redis/time-series": /package/@redis/time-series # 6.0.0
ioredis: /package/ioredis
standalone:
zod: /package/zod # 4.x
ts-to-zod: /package/ts-to-zod
pypi:
absolute_entrypoint: https://pypi.org
packages:
anthropic:
anthropic: /project/anthropic/
claude-agent-sdk: /project/claude-agent-sdk/
modelcontextprotocol:
mcp: /project/mcp/ # 1.28.0
agentclientprotocol:
agent-client-protocol: /project/agent-client-protocol/
a2a:
a2a-sdk: /project/a2a-sdk/
redis:
redis: /project/redis/ # 8.0.0
hiredis: /project/hiredis/
redisvl: /project/redisvl/
redis-om: /project/redis-om/
redis-entraid: /project/redis-entraid/
standalone:
pydantic: /project/pydantic/ # 2.13.4
crates:
absolute_entrypoint: https://crates.io
packages:
modelcontextprotocol:
rmcp: /crates/rmcp # 0.16.0
agentclientprotocol:
agent-client-protocol: /crates/agent-client-protocol
a2a:
a2a-rs: /crates/a2a-rs
redis:
redis: /crates/redis # redis-rs, 1.x
redisctl: /crates/redisctl
hiredis: /crates/hiredis # CORRECTED (was /crates/hiredis-rs → 404)
anthropics:
buffa: /crates/buffa
standalone:
serde: /crates/serde
serde_json: /crates/serde_json
schemars: /crates/schemars
