Repository navigation
Expand file tree
/
Copy pathmkdocs.yml
More file actions
767 lines (760 loc) · 36.4 KB
/
Copy pathmkdocs.yml
File metadata and controls
767 lines (760 loc) · 36.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
site_name: Bernstein
site_url: https://docs.bernstein.run/
site_author: Alex Chernysh
site_description: >-
The open-source governance layer for AI agents. No model in the coordination
loop, so parallel runs in per-task git worktrees replay byte-identically.
Signed lineage and an opt-in HMAC audit chain, air-gap friendly.
repo_url: https://github.com/sipyourdrink-ltd/bernstein
repo_name: sipyourdrink-ltd/bernstein
edit_uri: edit/main/docs/
copyright: >-
Copyright © 2025–2026 <a href="https://alexchernysh.com">Alex Chernysh</a>
theme:
name: material
custom_dir: docs/overrides
palette:
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: custom
accent: custom
toggle:
icon: material/brightness-7
name: Switch to light mode
- media: "(prefers-color-scheme: light)"
scheme: default
primary: custom
accent: custom
toggle:
icon: material/brightness-4
name: Switch to dark mode
# Fonts are loaded in docs/overrides/main.html (block fonts).
font: false
features:
- navigation.instant
- navigation.instant.progress
- navigation.tracking
- navigation.sections
- navigation.tabs
- navigation.tabs.sticky
- navigation.top
- navigation.indexes
- navigation.footer
- navigation.prune
- search.suggest
- search.highlight
- search.share
- content.code.copy
- content.code.annotate
- content.action.edit
- content.tabs.link
- toc.follow
- announce.dismiss
logo: assets/brand/bernstein-mark.svg
favicon: assets/brand/bernstein-mark.svg
icon:
repo: fontawesome/brands/github
extra_css:
- stylesheets/extra.css
extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/sipyourdrink-ltd/bernstein
name: Bernstein on GitHub
- icon: fontawesome/brands/python
link: https://pypi.org/project/bernstein/
name: Bernstein on PyPI
- icon: fontawesome/brands/x-twitter
link: https://x.com/alex_chernysh
name: Alex Chernysh on X
- icon: fontawesome/solid/globe
link: https://alexchernysh.com
name: Alex Chernysh
analytics:
provider: google
property: G-PLACEHOLDER
feedback:
title: Was this page helpful?
ratings:
- icon: material/thumb-up-outline
name: This page was helpful
data: 1
note: Thanks for your feedback!
- icon: material/thumb-down-outline
name: This page could be improved
data: 0
note: Thanks, we'll improve this page.
generator: false
consent:
title: Cookie consent
description: >-
We use cookies to recognize your repeated visits and preferences,
as well as to measure the effectiveness of our documentation and
whether users find what they're searching for. With your consent,
you're helping us to make our documentation better.
plugins:
- search:
separator: '[\s\-\.]+'
- social:
# Card image generation makes a live, unauthenticated request to
# fonts.google.com per build (material.plugins.social._fetch_font_from_google_fonts)
# to resolve the "Inter" theme font, and Read the Docs starts every
# build from a fresh container, so the plugin's on-disk cache never
# gets a chance to warm up: every single build re-hits Google Fonts.
# That endpoint began rejecting the shared RTD/CI build IPs, which is
# what took bernstein.readthedocs.io down. Disable card image
# generation so the build has no runtime network dependency; the
# plugin still emits the per-page meta description tags. Re-enable
# once the fonts are vendored into a committed cache_dir instead.
cards: false
cards_layout_options:
background_color: "#4a148c"
color: "#ffffff"
- redirects:
redirect_maps:
'operations/DEPLOYMENT.md': 'operations/deployment-guide.md'
'architecture/CLUSTER.md': 'operations/cluster-mode.md'
'quickstart/remote.md': 'getting-started/remote.md'
'operations/observability.md': 'operations/error-telemetry.md'
'security/security-acknowledgments.md': 'security/bug-bounty.md'
- minify:
minify_html: true
markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.snippets
- pymdownx.tabbed:
alternate_style: true
slugify: !!python/object/apply:pymdownx.slugs.slugify
kwds:
case: lower
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- pymdownx.keys
- pymdownx.mark
- pymdownx.critic
- toc:
permalink: true
toc_depth: 3
- attr_list
- md_in_html
- def_list
- tables
- footnotes
- abbr
nav:
- Home:
- index.md
- Use cases:
- Who it is for: use-cases.md
- Reproducible nightly runs: use-cases/reproducible-nightly-runs.md
- Tamper-evident audit trail: use-cases/tamper-evident-audit-trail.md
- Signed results from untrusted workers: use-cases/signed-worker-results.md
- Scope (what this does not do): scope.md
- What's new: whats-new.md
- Mentions: mentions.md
- Benchmarks: benchmarks/BENCHMARKS.md
- Blog:
- Ten agents one release: blog/ten-agents-one-release.md
- Zero-LLM coordination: blog/zero-llm-coordination.md
- Multi-agent benchmark: blog/multi-agent-benchmark.md
- Self-evolution 30 days: blog/self-evolution-30-days.md
- COBOL modernization: blog/cobol-modernization.md
- v1.9 four commands: blog/v1.9-four-commands-last-mile.md
- Get started:
- getting-started/index.md
- Install: getting-started/install.md
- Install on Linux: getting-started/install-linux.md
- Remote quickstart (Codespaces): getting-started/remote.md
- First run: getting-started/first-run.md
- Tutorial: getting-started/quickstart-tutorial.md
- Zero-config demo: getting-started/quickstart-demo.md
- Tutorials:
- tutorials/index.md
- Verified scheduled run: tutorials/verified-scheduled-run.md
- Signed result receipt: tutorials/signed-result-receipt.md
- Guides:
- guides/index.md
- Web GUI:
- gui/index.md
- Install: gui/install.md
- Screens: gui/screens.md
- Playground: gui/playground.md
- Configuration: gui/configuration.md
- Mobile: gui/mobile.md
- Troubleshooting: gui/troubleshooting.md
- Adapters:
- adapters/index.md
- Choosing an adapter: adapters/openai-agents-comparison.md
- OpenAI Agents SDK: adapters/openai-agents.md
- Gemini CLI: adapters/gemini.md
- CLM: adapters/clm.md
- DeepSeek V4: adapters/deepseek.md
- Agy: adapters/agy.md
- Antigravity: adapters/antigravity.md
- Deep-research agents: adapters/deep-research.md
- Deferred adapters: adapter-deferred.md
- Adapter operations: operations/adapters.md
- Adapter security floor: adapters/security-floor.md
- Adapter admission receipts: adapters/admission-receipts.md
- Session isolation: adapters/session_isolation.md
- Stream signals: adapters/stream_signals.md
- Strict output schemas: adapters/schemas.md
- Conformance canary: adapters/conformance-canary.md
- Capability profiles: adapters/capability_profiles.md
- Browser / computer-use adapter: adapters/computer_use.md
- Adapter smoke test: adapters/test-adapter.md
- Sandboxes:
- Overview: architecture/sandbox.md
- Backend selector: concepts/sandbox-selector.md
- Named sandbox pools: operations/sandbox-pools.md
- MicroVM on libkrun: operations/microvm-libkrun.md
- Daytona: sandbox/daytona.md
- Blaxel: sandbox/blaxel.md
- Runloop: sandbox/runloop.md
- Vercel: sandbox/vercel.md
- Playwright self-test: sandbox/playwright-self-test.md
- Editors & host registration:
- Claude Code: substrate/claude-code.md
- Claude Desktop: substrate/claude-desktop.md
- Cursor: substrate/cursor.md
- Continue: substrate/continue.md
- Cline: substrate/cline.md
- Zed: substrate/zed.md
- Aider: substrate/aider.md
- Issue trackers:
- Contract: trackers/contract.md
- Tracker pipeline: orchestration/tracker-pipeline.md
- Issue-to-PR: orchestration/issue-to-pr.md
- Linear: trackers/linear.md
- Jira Data Center: trackers/jira-data-center.md
- Asana: trackers/asana.md
- ClickUp: trackers/clickup.md
- GitHub Projects: trackers/github-projects.md
- Plane: trackers/plane.md
- ServiceNow: trackers/servicenow.md
- OData (system of record): operations/odata.md
- Webhooks: trackers/webhooks.md
- Git hosting & CI:
- GitHub Action: integrations/github-action.md
- GitHub App: integrations/github-app-setup.md
- GitLab App: integrations/gitlab-app-setup.md
- GitLab integration: operations/gitlab.md
- Workflow automation:
- Automation bridge: integrations/automation-bridge.md
- n8n: integrations/n8n.md
- Zapier: integrations/zapier.md
- Workato: integrations/workato.md
- MCP:
- Server: mcp/server.md
- Client: mcp/client.md
- Server injection: integrations/mcp-server-injection.md
- Tool-search lazy loading: protocols/tool-search.md
- cocoindex-code catalog: integrations/cocoindex-code.md
- Tool-call input validation: mcp/input-validation.md
- Gateway proxy: operations/mcp-gateway.md
- x402 settlement: operations/x402-settlement.md
- Hooks, plugins & skills:
- Hook system: integrations/hook-system.md
- Hook prefilter: operations/hooks.md
- Plugin SDK: integrations/plugin-sdk.md
- Agent sessions: integrations/agent-session.md
- agents-md sync: agents-md.md
- Agent docs (00-AGENT):
- Overview: agent/00-AGENT.md
- Repo map: agent/10-map.md
- Verification commands: agent/20-commands.md
- CI & testing: agent/30-ci.md
- Environment: agent/40-env.md
- Invariants: agent/50-invariants.md
- Deep notes:
- Governance architecture: agent/90-notes/governance-architecture.md
- Adapter isolation: agent/90-notes/adapter-isolation.md
- Receipt lineage: agent/90-notes/receipt-lineage.md
- Agent catalogs: operations/agent-catalogs.md
- Skills catalog: operations/skills-catalog.md
- Skill lint: operations/skill-lint.md
- Skill selection rules: operations/skill-selection-rules.md
- Skill selection rules design: sdd/skill-selection-rules.md
- Layered skill merge: skills/layered-merge.md
- Agent prompt template: examples/agent-prompt-template.md
- Memory & context:
- Session memory: memory/session-memory.md
- Cross-task share: memory/cross-task-share.md
- Operator memory: operations/memory.md
- Knowledge diary: operations/knowledge-diary.md
- Context compaction: operations/context-compaction.md
- Cloud (Cloudflare):
- cloudflare/cloudflare-overview.md
- Setup: cloudflare/cloudflare-setup.md
- Cloud CLI: cloudflare/cloudflare-cli.md
- Bridges: cloudflare/cloudflare-bridges.md
- Browser Rendering: cloudflare/cloudflare-browser-rendering.md
- Adapters: cloudflare/cloudflare-adapters.md
- Codex sandboxes: cloudflare/cloudflare-codex-sandbox.md
- Workers AI: cloudflare/cloudflare-ai.md
- MCP Remote: cloudflare/cloudflare-mcp.md
- Analytics: cloudflare/cloudflare-analytics.md
- Everyday workflows:
- Recipes: operations/recipes.md
- Worktrees: operations/worktrees.md
- Snapshot undo: git/snapshot-undo.md
- Task revert: operations/task-revert.md
- Session handoff: operations/session-handoff.md
- Routine scenarios: routine-scenarios.md
- Per-step routing: workflows/per-step-routing.md
- Operations:
- operations/index.md
- Deploy & scale:
- Deployment guide: operations/deployment-guide.md
- Helm chart: operations/HELM_DEPLOYMENT.md
- Cluster mode: operations/cluster-mode.md
- Cluster mTLS: cluster/mtls-setup.md
- Cluster patterns: cluster/deployment-patterns.md
- Cluster e2e harness: testing/cluster-e2e-harness.md
- Fleet: operations/fleet.md
- Fleet directory registry: fleet/directory-registry.md
- Air-gap install: installation/air-gap.md
- Migrations: operations/migrations.md
- Updates (check, verify, apply): operations/updates.md
- Self-update: operations/self-update.md
- Shell completions: operations/shell-completions.md
- Pilot-to-production graduation: operations/graduation.md
- Enterprise evaluation: ENTERPRISE.md
- Run & supervise:
- Commands overview: operations/commands.md
- Run: operations/run.md
- Run names: operations/run_names.md
- Schedule: operations/schedule.md
- Resume: operations/resume.md
- Replay: operations/replay.md
- Seal anchors: operations/seal.md
- Fork from step: operations/fork-from-step.md
- Simulate: operations/simulate.md
- Compare: operations/compare.md
- Doctor: operations/doctor.md
- Holds: operations/HOLDS.md
- Review board: operations/review-board.md
- Mission timeline and digests: operations/mission-timeline.md
- Work ledger: operations/work-ledger.md
- Decision log: operations/decision-log.md
- Intent capsules: operations/intent-capsules.md
- Notifications: operations/notifications.md
- Chat bridges: operations/chat-bridges.md
- Approval cards v2: integrations/approval-cards.md
- Microsoft Teams setup: integrations/teams-setup.md
- Webhook node: operations/webhook-node.md
- Preview server: operations/preview.md
- Voice control: operations/voice-control.md
- Session checkpoint: operations/checkpoint.md
- Session wrap-up: operations/wrap-up.md
- Session fast resume: operations/session-fast-resume.md
- File watch: operations/watch.md
- Detached run service: operations/run-service.md
- Tournament runs: operations/tournament-runs.md
- Fleet steering: operations/fleet-steering.md
- Named resource pools: operations/named-resource-pools.md
- Trigger sources: operations/trigger-sources.md
- Slack webhooks: operations/slack-webhooks.md
- TUI keybindings: operations/tui-keybindings.md
- Worker process identity: operations/worker-process-identity.md
- Reliability:
- Troubleshooting: operations/TROUBLESHOOTING.md
- Checkpointed retries: operations/checkpointed-retries.md
- Durable suspend and resume: operations/durable-suspend-resume.md
- Retry budget: operations/retry-budget.md
- Auto-heal: operations/auto-heal.md
- Agent crash loops: operations/agent_crash_loop.md
- Stall escalation: operations/stall-escalation.md
- Abandonments: operations/abandonments.md
- Activity boundary: operations/activity-boundary.md
- Max turns: operations/MAX_TURNS.md
- Provider availability: operations/provider-availability.md
- Disaster recovery: operations/disaster-recovery.md
- Chaos engineering: operations/chaos-engineering.md
- Runbooks: operations/runbooks.md
- Agent edit-loop detection: operations/agent-loop-detection.md
- In-process verification gates: operations/hook-gate.md
- Per-goal SLA contracts: operations/sla.md
- Cost & performance:
- Cost optimization: operations/cost-optimization.md
- Cost-aware scheduling: operations/cost-aware-scheduling.md
- Spending mandates: operations/spending-mandates.md
- Ticket cap: cost/ticket-cap.md
- Task budgets: concepts/task-budgets.md
- Performance tuning: operations/performance-tuning.md
- Response-style profiles: operations/response-style-profiles.md
- Per-profile cost attribution: operations/profile-cost-attribution.md
- Profile A/B harness: operations/profile-ab-harness.md
- Template compression: operations/template-compression.md
- Cost envelopes: operations/cost-envelopes.md
- Cost anomaly detection: operations/cost-anomaly-detection.md
- Token growth monitor: operations/token-growth-monitor.md
- Payment mandates: operations/payment-mandates.md
- Showback canonicalization: cost/showback-canonical.md
- Budget halt receipts: cost/budget-halt-receipts.md
- Observability:
- Overview: operations/observability-overview.md
- Instrumentation: operations/INSTRUMENTATION.md
- Verification tracking: operations/verification-tracking.md
- Deterministic replay: operations/deterministic-replay.md
- Error telemetry & SBOM: operations/error-telemetry.md
- Telemetry disclosure: telemetry.md
- Side-channel telemetry: observability/side-channel.md
- Run archive retention: observability/run-archive-retention.md
- LLM watcher: observability/llm-watcher.md
- Ticket bundle: observability/ticket-bundle.md
- Trace store: observability/trace-store.md
- OTLP export: observability/otlp-export.md
- Trends: observability/trends.md
- Retry sequences: observability/retry-sequences.md
- Progress watch: observability/progress-watch.md
- Task artifacts and progress: observability/task-artifacts.md
- Rate limits: observability/rate-limits.md
- Unified doctor: observability/unified-doctor.md
- Telemetry share: observability/telemetry-share.md
- Cluster observability: observability/cluster.md
- Per-agent token progress: observability/token-progress.md
- Cumulative progress: observability/cumulative-progress.md
- OTel GenAI span projection: observability/otel-span-projection.md
- Journal-anchored OTLP bridge: sdd/otel-journal-bridge.md
- Session analytics: operations/session-analytics.md
- Debug bundle: operations/debug-bundle.md
- Merge & review automation:
- Merge queue: operations/merge-queue.md
- Merge gate: operations/merge-gate.md
- Autofix daemon: operations/autofix.md
- Autofix tier 3: operations/autofix-tier3.md
- Autofix ladder: autofix/ladder.md
- Telemetry-grounded autofix: autofix/telemetry-grounded.md
- Review responder: operations/review-responder.md
- Coverage ratchet: operations/coverage-ratchet.md
- Nightly canary: operations/nightly-canary.md
- CI: operations/ci.md
- CI topology: operations/ci-topology.md
- Type-check scope: operations/type-check-scope.md
- Post-CI dispatcher: operations/post-ci-dispatcher.md
- Review pipeline DSL: operations/review-pipeline.md
- Review and autofix receipts: operations/review-receipts.md
- Commit attribution stats: operations/commit-attribution.md
- Backlog sync: operations/backlog-sync.md
- Plan archival: operations/plan-archival.md
- on_fail recovery receipts: workflows/on-fail-recovery-receipts.md
- Evaluation & calibration:
- Incident-to-eval synthesis: eval/incident-synthesis.md
- A/B runner: eval/ab-runner.md
- YAML harness: eval/yaml-harness.md
- Pentest scenario: eval/security_pentest_scenario.md
- Calibration: operations/calibration.md
- Criterion profiles: operations/criterion-profiles.md
- Golden benchmark harness: eval/golden-harness.md
- Reproducible bench bundles: eval/bench.md
- pass^k reliability floor: eval/reliability.md
- Security & identity:
- Security & identity stack: operations/security-and-identity.md
- Security operations: operations/security.md
- Hardening: security/security-hardening.md
- Governance: operations/governance.md
- Review charter: governance/review-charter.md
- Inventory topology: operations/govern-inventory.md
- Govern ingest: operations/govern-ingest.md
- Secrets & creds: operations/secrets.md
- Secrets broker: security/secrets-broker.md
- Env isolation: operations/env-isolation.md
- Credential scoping: security/credential-scoping.md
- Capability matrix: security/capability-matrix.md
- Admission policy: operations/admission-policy.md
- Manager auth: security/manager-auth.md
- Agent-card keystore: security/keystore.md
- JCS canonicalization: security/jcs-canonicalization.md
- MCP signing: security/mcp-signing.md
- OWASP ASI detectors: security/owasp-asi.md
- NIST AI 100-2 crosswalk: security/nist-ai-100-2-crosswalk.md
- Promptware: security/promptware.md
- Lethal trifecta: security/lethal-trifecta.md
- Coordinated disclosure: security/bug-bounty.md
- Log redaction: security/log-redaction.md
- Tool-output redaction: security/tool-output-redaction.md
- PII scan gate: security/pii-scan-gate.md
- Compliance & audit:
- Compliance overview: operations/compliance.md
- AI bill of materials: operations/run-bom.md
- SOC 2 audit: security/AUDIT.md
- Audit log: security/audit-log.md
- Multi-tenant audit export: security/audit-multitenant.md
- Delegation narrowing: security/delegation-narrowing.md
- DSSE / in-toto envelope: security/audit-dsse-envelope.md
- EU AI Act Article 12: compliance/eu-ai-act-article-12-bundle.md
- EU residency setup: compliance/eu-residency-customer-setup.md
- Regulator-mapped compliance packs: compliance/regulator-mapped-packs.md
- FINOS AIGF mapping: compliance/finos-aigf-mapping.md
- ISO/IEC 42001 mapping: compliance/iso42001-mapping.md
- CoSAI mapping: compliance/cosai-mapping.md
- Regulator-class lineage: compliance/regulatory-lineage.md
- Lineage export: compliance/lineage-export.md
- Lineage v1 (user reference): lineage.md
- Lineage v2: operations/lineage-v2.md
- Artifact contract: operations/artifacts.md
- Artifact keys: lineage/artifacts.md
- Lineage conflict resolution: lineage/conflict-resolution.md
- Tracker audit: lineage/tracker-audit.md
- A2A message receipts: operations/a2a-message-receipts.md
- A2A JSON-RPC server surface: operations/a2a-server.md
- Datasources & query receipts: operations/datasources.md
- Batch pass receipts: operations/batch-receipts.md
- Verifiable audit receipts: security/audit-receipt.md
- Evidence envelope: security/evidence-envelope.md
- Gate adjudication records: operations/gate-adjudication.md
- Agent run manifest: operations/run-manifest.md
- Verification evidence bundles: operations/evidence-bundles.md
- Delegation chain verification: operations/delegation-verify.md
- Access review: operations/access-review.md
- Skill usage provenance: operations/skill-provenance.md
- C2PA content credentials: operations/content-credentials.md
- Reference:
- reference/index.md
- CLI:
- CLI reference: reference/cli-reference.md
- Task lifecycle CLI: reference/cli/task-lifecycle.md
- Replay CLI: reference/cli/replay.md
- Verify CLI: reference/cli/verify.md
- Evolve CLI: reference/cli/evolve.md
- Receipt CLI: reference/receipt.md
- Configuration & schemas:
- Configuration: operations/CONFIG.md
- Task format: operations/task_format.md
- Plans (YAML schema): architecture/plans.md
- Team manifests: operations/team-manifests.md
- Worker contracts: operations/worker-contracts.md
- Model policy: operations/MODEL_POLICY.md
- Ticket schema: sdd/ticket_schema.md
- Design tokens: design/tokens.md
- Brand and logo: design/brand.md
- Adapter capability contract: adapters/capability_contract.md
- Global config CLI: operations/global-config.md
- Workflow manifests: operations/workflow-manifests.md
- APIs & protocols:
- REST API: reference/openapi-reference.md
- API server operations: operations/api.md
- Supervisor API: api/supervisor.md
- Local endpoints: reference/local-endpoints.md
- Self-hosted endpoints: operations/self-hosted-endpoints.md
- ACP bridge: reference/acp-bridge.md
- ACP server and client roles: interop/acp.md
- A2A signed agent cards: architecture/a2a.md
- A2A capability cards & lineage interop: interop/a2a.md
- Authority envelope: interop/authority-envelope.md
- Eventing v2 (unified feed): events/grammar.md
- .well-known manifest: protocols/well-known-manifest.md
- SPIFFE workload identity: reference/spiffe-workload-identity.md
- Volunteer project manifest: reference/volunteer-manifest.md
- Volunteer sandbox profile: reference/volunteer-sandbox.md
- Volunteer issue text: reference/volunteer-issue-text.md
- Volunteer task runner: reference/volunteer-runner.md
- Volunteer lease store: reference/volunteer-lease-store.md
- MCP catalog: reference/mcp-catalog.md
- Published identifiers: reference/published-identifiers.md
- MCP tool tiers: mcp/tool_tiers.md
- Compatibility & limits:
- Capabilities: reference/capabilities.md
- Feature matrix: reference/FEATURE_MATRIX.md
- Adapter compatibility: adapters/compatibility.md
- MkDocs Material coupling: reference/mkdocs-material-coupling.md
- Known limitations: reference/KNOWN_LIMITATIONS.md
- Glossary: reference/GLOSSARY.md
- Release notes:
- Changelog: CHANGELOG.md
- Unreleased: release-notes/unreleased.md
- v3.22.0: release-notes/v3.22.0.md
- v3.21.0: release-notes/v3.21.0.md
- v3.20.0: release-notes/v3.20.0.md
- v3.19.2: release-notes/v3.19.2.md
- v3.19.1: release-notes/v3.19.1.md
- v3.19.0: release-notes/v3.19.0.md
- v3.18.2: release-notes/v3.18.2.md
- v3.18.1: release-notes/v3.18.1.md
- v3.18.0: release-notes/v3.18.0.md
- v3.17.2: release-notes/v3.17.2.md
- v3.17.1: release-notes/v3.17.1.md
- v3.17.0: release-notes/v3.17.0.md
- v3.16.0: release-notes/v3.16.0.md
- v3.15.1: release-notes/v3.15.1.md
- v3.15.0: release-notes/v3.15.0.md
- v3.14.159: release-notes/v3.14.159.md
- v3.13.0: release-notes/v3.13.0.md
- v3.12.0: release-notes/v3.12.0.md
- v3.11.0: release-notes/v3.11.0.md
- v3.10.0: release-notes/v3.10.0.md
- v3.9.0: release-notes/v3.9.0.md
- v3.8.4: release-notes/v3.8.4.md
- v3.8.3: release-notes/v3.8.3.md
- v3.8.2: release-notes/v3.8.2.md
- v3.8.1: release-notes/v3.8.1.md
- v3.8.0: release-notes/v3.8.0.md
- v3.7.1: release-notes/v3.7.1.md
- v3.7.0: release-notes/v3.7.0.md
- v3.6.0: release-notes/v3.6.0.md
- v3.5.0: release-notes/v3.5.0.md
- v3.4.4: release-notes/v3.4.4.md
- v3.4.3: release-notes/v3.4.3.md
- v3.4.2: release-notes/v3.4.2.md
- v3.4.1: release-notes/v3.4.1.md
- v3.4.0: release-notes/v3.4.0.md
- v3.3.0: release-notes/v3.3.0.md
- v3.2.0: release-notes/v3.2.0.md
- v3.1.0: release-notes/v3.1.0.md
- v3.0.0: release-notes/v3.0.0.md
- v2.x:
- v2.16.1: release-notes/v2.16.1.md
- v2.16.0: release-notes/v2.16.0.md
- v2.15.0: release-notes/v2.15.0.md
- v2.14.1: release-notes/v2.14.1.md
- v2.14.0: release-notes/v2.14.0.md
- v2.13.0: release-notes/v2.13.0.md
- v2.12.0: release-notes/v2.12.0.md
- v2.11.0: release-notes/v2.11.0.md
- v2.10.0: release-notes/v2.10.0.md
- v2.9.0: release-notes/v2.9.0.md
- v2.8.5: release-notes/v2.8.5.md
- v2.8.2: release-notes/v2.8.2.md
- v2.6.0: release-notes/v2.6.0.md
- v2.5.1: release-notes/v2.5.1.md
- v2.5.0: release-notes/v2.5.0.md
- v2.4.0: release-notes/v2.4.0.md
- v2.3.1: release-notes/v2.3.1.md
- v2.3.0: release-notes/v2.3.0.md
- v2.0.0: release-notes/v2.0.0.md
- Architecture & internals:
- architecture/index.md
- System:
- Architecture: architecture/ARCHITECTURE.md
- Design notes: architecture/DESIGN.md
- Why deterministic: architecture/WHY_DETERMINISTIC.md
- Task lifecycle: architecture/LIFECYCLE.md
- Agent lifecycle diagram: diagrams/agent_lifecycle.md
- Task lifecycle diagram: diagrams/task_lifecycle.md
- Inventory topology diagram: diagrams/inventory_topology.md
- Graphs: architecture/graphs.md
- Dependency resolver: architecture/DEPENDENCY_RESOLVER.md
- Quality pipeline: architecture/quality-pipeline.md
- Merge-tree integration probe: architecture/merge-tree-probe.md
- Model routing: architecture/model-routing.md
- State persistence: architecture/state-persistence.md
- CAS store: architecture/cas-store.md
- Artifact storage: architecture/storage.md
- Permission modes: architecture/permission-modes.md
- Warm pool: architecture/warm-pool.md
- Adaptive parallelism: architecture/adaptive-parallelism.md
- Tiered context compaction: architecture/memory_tiers.md
- Skill packs: architecture/skills.md
- Orchestration approaches: architecture/orchestration-approaches.md
- Fast-path execution: architecture/fast-path-execution.md
- Batch routing: architecture/batch-routing.md
- Deadlock detection: architecture/deadlock-detection.md
- Context degradation detector: architecture/context-degradation-detector.md
- Protocol version negotiation: architecture/protocol-negotiation.md
- Task-payload schema registry: architecture/schema-registry.md
- Native subagent delegation: architecture/subagent-delegation.md
- Concepts:
- AST-aware reviewer chunks: concepts/ast-aware-chunking.md
- Fingerprint memoization: concepts/fingerprint-memoization.md
- Artifact lineage trail: concepts/artifact-lineage.md
- Feature contract: concepts/feature-contract.md
- Schema validation retry: concepts/schema-validation-retry.md
- Action cache and replay: concepts/action-cache.md
- Cache policy engine: concepts/cache-policy.md
- Discrete phase pipeline: concepts/phase-pipeline.md
- Spec-as-test loop: concepts/spec-as-test.md
- Abstracted code review: concepts/abstracted-code-review.md
- Agent mode profiles: concepts/agent-mode-profiles.md
- Best-of-N delegation: concepts/best-of-n.md
- Swarm migration: concepts/swarm-migration.md
- Wiki build: concepts/wiki-build.md
- JSONL memory log: concepts/jsonl-memory-log.md
- Prompt-to-repo scaffold: concepts/scaffold.md
- Team-hub conventions: concepts/team-hub.md
- Orchestrator hardening: concepts/orchestrator-hardening.md
- Agent lesson persistence: concepts/lesson-persistence.md
- Semantic caching: concepts/semantic-caching.md
- Orchestration internals:
- Task DAG: orchestration/task-dag.md
- Research activities: orchestration/research-activity.md
- Browser activities: orchestration/browser-activity.md
- Run actor: orchestration/run-actor.md
- Worker coordination: orchestration/worker-coordination.md
- Review gate: orchestration/review-gate.md
- Merge-gate repair: orchestration/gate-repair.md
- Failure taxonomy: orchestration/failure-taxonomy.md
- Federation: orchestration/federation.md
- Consensus scoring: quality/consensus-scoring.md
- Empirical confidence: quality/empirical-confidence.md
- Spec quality gate: planning/spec-quality-gate.md
- Multi-cell orchestration: orchestration/multi-cell.md
- Bulletin board: orchestration/bulletin-board.md
- Decisions (ADRs):
- Index: decisions/index.md
- Agent lifecycle: decisions/001-agent-lifecycle.md
- ADR-002 (withdrawn): decisions/002-withdrawn.md
- Self-evolution: decisions/003-self-evolution.md
- File-based state: decisions/004-file-based-state.md
- Short-lived agents: decisions/005-short-lived-agents.md
- No embedded LLM: decisions/006-no-embedded-llm.md
- Pluggy plugin system: decisions/007-pluggy-plugin-system.md
- Click for CLI: decisions/008-click-for-cli.md
- Lineage v1: decisions/009-lineage-v1.md
- Audit-chain default cost: decisions/010-audit-chain-default-cost.md
- A model drafts, a human signs: decisions/011-model-drafts-human-signs.md
- Govern versus observe: decisions/012-govern-versus-observe.md
- Typed ingest contract: decisions/013-typed-ingest-contract.md
- Agent identity plane: decisions/014-agent-identity-plane.md
- Artifact contract completion: decisions/015-artifact-contract-completion.md
- TRACE conformance level: decisions/016-trace-conformance-level.md
- Receipt coverage gap: decisions/017-receipt-states-its-gap.md
- Contribute:
- contributing/index.md
- Project pulse: project-pulse.md
- Contributor recognition: community/recognition.md
- Code review: CODE_REVIEW.md
- Testing & CI hardening: contributing/testing.md
- Lifecycle hooks contract: contributing/hooks.md
- Git hooks: contributing/git-hooks.md
- Adapter contracts: contributing/adapter-contracts.md
- Writing adapters: adapters/ADAPTER_GUIDE.md
- The issue shelf: contributing/issue-shelf.md
- Flake handling: contributing/flake-handling.md
- Demo recording: contributing/demo-recording.md
- Render freshness: contributing/render-freshness.md
- CI apps: maintainers/ci-apps.md
- Extended static analysis: ci/extended-static-analysis.md
- Release process: operations/release.md
- Docs drift playbook: playbooks/docs-drift.md
- Docs update sweep: playbooks/docs-update-sweep.md
- Docs source-of-truth notes: llm-citation-surface.md
- Trend scan automation: devops/trend-scan-automation.md
docs_dir: docs
strict: false
# Internal working notes live under docs/_internal/ and are not part of the
# published documentation set. Excluding them keeps them out of the built
# site and out of strict link validation.
# Setting exclude_docs replaces the MkDocs defaults, so restate them
# (dotfiles, /templates/) alongside the _internal guard.
# /assets/*.md holds render fragments (ASCII banner), not pages.
exclude_docs: |
.*
/templates/
_internal/
/assets/*.md
/i18n/