Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Source revisions and provenance

This edition is assembled from fixed commits. Ordinary builds of the book always use these commits. They are changed only by a deliberate, reviewed update of the book's lock file, never by a branch moving upstream.

SourceRepositoryBranchPinned commitImported documents
Άρκτος Wallet (arktos-wallet)cognokratos/arktos-walletmain92650a0347993622cbb3e5eeac2c908069c67fd615
etf-research-agentcognokratos/etf-research-agentmain493a67a721ef56ee64151e66e6e47c974552a23f16
simple-agent-templatecognokratos/simple-agent-templatemainc66ce19d7b0c5c88c41b6860c78f66075485a07a33
Σοφός Agent (sophos-agent)cognokratos/sophos-agentmain8d9fe52182d8441454916ec8a6ab13c0773228e220
Ταύρος Revenue (tauros-revenue)cognokratos/tauros-revenuemainfacbbc927eb4b9090937524ca02486c026f1f02528

All five sources follow main. Tauros's course was developed on a learning branch. Earlier builds of this book pinned that branch (556a7209…). It is now merged into main (a247cfc, a squash merge with an identical tree), and the pin above is a later main commit that adds the licence files. The organisation profile (cognokratos/.github, profile/README.md) informed the orientation chapters. It is not a source of imported chapters.

Each pinned revision includes its repository's MIT LICENSE. Pins are updated deliberately, either from the canonical GitHub branch (make update-source) or from the committed head of a local clone (make update-source-local). A pin is only buildable elsewhere once that commit has been pushed.

How an imported chapter is produced

  1. The chapter's file is read from the pinned commit. Nothing is checked out, and nothing from the source repository is executed.
  2. Link destinations are rewritten. Everything else is copied byte for byte:
    • links to chapters included in the book become book links;
    • links to source files, directories and non-included documents point at GitHub at the pinned commit;
    • links into other CognoKratos projects become book links when the target is included;
    • explicit historical commit links and external links are left unchanged.
  3. Mermaid diagram blocks are handed to a pinned Mermaid renderer. Every other code block is unchanged.
  4. A provenance line is added under the title and a source note at the end.
  5. Where the editors verified that a sentence is broader than the pinned code, a labelled Book edition note is inserted. The upstream text is not edited.

Imported documents

Άρκτος Wallet (arktos-wallet)

etf-research-agent

simple-agent-template

Book chapterSource path at the pinned revision
docs/APPROVALS.mddocs/APPROVALS.md
docs/ARCHITECTURE.mddocs/ARCHITECTURE.md
docs/CHALLENGES.mddocs/CHALLENGES.md
docs/CONFIGURATION.mddocs/CONFIGURATION.md
docs/EVALUATION.mddocs/EVALUATION.md
docs/EXTENDING.mddocs/EXTENDING.md
docs/GUARDRAILS.mddocs/GUARDRAILS.md
docs/LEARNING-PATH.mddocs/LEARNING-PATH.md
docs/LIMITATIONS.mddocs/LIMITATIONS.md
docs/OBSERVABILITY.mddocs/OBSERVABILITY.md
docs/SECURITY.mddocs/SECURITY.md
docs/TEST-SCENARIOS.mddocs/TEST-SCENARIOS.md
docs/concepts/01-agents-and-agent-loops.mddocs/concepts/01-agents-and-agent-loops.md
docs/concepts/02-tools-and-mcp.mddocs/concepts/02-tools-and-mcp.md
docs/concepts/03-grounding-and-authoritative-state.mddocs/concepts/03-grounding-and-authoritative-state.md
docs/concepts/04-guardrails-and-deterministic-controls.mddocs/concepts/04-guardrails-and-deterministic-controls.md
docs/concepts/05-evaluation.mddocs/concepts/05-evaluation.md
docs/concepts/06-observability.mddocs/concepts/06-observability.md
docs/concepts/07-security-and-trust-boundaries.mddocs/concepts/07-security-and-trust-boundaries.md
docs/concepts/08-human-in-the-loop.mddocs/concepts/08-human-in-the-loop.md
docs/concepts/ANTI-PATTERNS.mddocs/concepts/ANTI-PATTERNS.md
docs/tutorials/01-run-the-agent.mddocs/tutorials/01-run-the-agent.md
docs/tutorials/02-understand-tool-calling.mddocs/tutorials/02-understand-tool-calling.md
docs/tutorials/03-add-an-mcp-tool.mddocs/tutorials/03-add-an-mcp-tool.md
docs/tutorials/04-break-the-agent.mddocs/tutorials/04-break-the-agent.md
docs/tutorials/05-evaluate-the-agent.mddocs/tutorials/05-evaluate-the-agent.md
docs/tutorials/06-debug-with-traces.mddocs/tutorials/06-debug-with-traces.md
docs/tutorials/07-experiment-with-guardrails.mddocs/tutorials/07-experiment-with-guardrails.md
docs/tutorials/08-add-a-state-changing-action.mddocs/tutorials/08-add-a-state-changing-action.md
docs/tutorials/09-add-human-approval.mddocs/tutorials/09-add-human-approval.md
docs/tutorials/10-build-your-own-domain-agent.mddocs/tutorials/10-build-your-own-domain-agent.md
docs/tutorials/README.mddocs/tutorials/README.md
docs/tutorials/REQUEST-WALKTHROUGH.mddocs/tutorials/REQUEST-WALKTHROUGH.md

Σοφός Agent (sophos-agent)

Book chapterSource path at the pinned revision
docs/RUNTIME-LEARNING-PATH.mddocs/RUNTIME-LEARNING-PATH.md
docs/architecture/11-roadmap-from-prd.mddocs/architecture/11-roadmap-from-prd.md
docs/architecture/3-runtime-integration-details.mddocs/architecture/3-runtime-integration-details.md
docs/architecture/3a-durable-execution-persistence.mddocs/architecture/3a-durable-execution-persistence.md
docs/architecture/4-deployment-topology-docker-compose.mddocs/architecture/4-deployment-topology-docker-compose.md
docs/architecture/5-trade-off-decisions.mddocs/architecture/5-trade-off-decisions.md
docs/architecture/6-core-workflows.mddocs/architecture/6-core-workflows.md
docs/architecture/9-security-posture.mddocs/architecture/9-security-posture.md
docs/runtime/01-own-the-process.mddocs/runtime/01-own-the-process.md
docs/runtime/02-model-execution-state.mddocs/runtime/02-model-execution-state.md
docs/runtime/03-design-durability-boundaries.mddocs/runtime/03-design-durability-boundaries.md
docs/runtime/04-streaming-is-not-persistence.mddocs/runtime/04-streaming-is-not-persistence.md
docs/runtime/05-memory-is-not-one-thing.mddocs/runtime/05-memory-is-not-one-thing.md
docs/runtime/06-failure-restart-and-resume.mddocs/runtime/06-failure-restart-and-resume.md
docs/runtime/07-side-effects-and-idempotency.mddocs/runtime/07-side-effects-and-idempotency.md
docs/runtime/08-local-first-and-runtime-ownership.mddocs/runtime/08-local-first-and-runtime-ownership.md
docs/runtime/CASE-STUDIES.mddocs/runtime/CASE-STUDIES.md
docs/runtime/CHALLENGES.mddocs/runtime/CHALLENGES.md
docs/runtime/README.mddocs/runtime/README.md
docs/runtime/RUN-LIFECYCLE-WALKTHROUGH.mddocs/runtime/RUN-LIFECYCLE-WALKTHROUGH.md

Ταύρος Revenue (tauros-revenue)

Book chapterSource path at the pinned revision
docs/AI-AUTHORITY.mddocs/AI-AUTHORITY.md
docs/DOMAIN_MODEL.mddocs/DOMAIN_MODEL.md
docs/EXERCISES.mddocs/EXERCISES.md
docs/LEARNING-PATH.mddocs/LEARNING-PATH.md
docs/MCP.mddocs/MCP.md
docs/concepts/auditability.mddocs/concepts/auditability.md
docs/concepts/eventual-consistency.mddocs/concepts/eventual-consistency.md
docs/concepts/exact-payload-approval.mddocs/concepts/exact-payload-approval.md
docs/concepts/financial-state-machines.mddocs/concepts/financial-state-machines.md
docs/concepts/idempotency.mddocs/concepts/idempotency.md
docs/concepts/intent-authority-execution.mddocs/concepts/intent-authority-execution.md
docs/concepts/payment-destinations.mddocs/concepts/payment-destinations.md
docs/course/01-humans-and-agents.mddocs/course/01-humans-and-agents.md
docs/course/02-policies-and-ownership.mddocs/course/02-policies-and-ownership.md
docs/course/03-tenant-isolation.mddocs/course/03-tenant-isolation.md
docs/course/04-payment-destinations.mddocs/course/04-payment-destinations.md
docs/course/05-invoice-revisions.mddocs/course/05-invoice-revisions.md
docs/course/06-state-machines.mddocs/course/06-state-machines.md
docs/course/07-idempotency.mddocs/course/07-idempotency.md
docs/course/08-exact-payload-approval.mddocs/course/08-exact-payload-approval.md
docs/course/09-concurrency.mddocs/course/09-concurrency.md
docs/course/10-auditability.mddocs/course/10-auditability.md
docs/course/11-breaking-the-boundary.mddocs/course/11-breaking-the-boundary.md
docs/course/12-ashai-and-mcp.mddocs/course/12-ashai-and-mcp.md
docs/course/13-reviewed-tool-surface.mddocs/course/13-reviewed-tool-surface.md
docs/course/14-capability-vs-permission.mddocs/course/14-capability-vs-permission.md
docs/course/15-prompt-injection.mddocs/course/15-prompt-injection.md
docs/course/16-capstone-mcp-to-approval.mddocs/course/16-capstone-mcp-to-approval.md

Documents not imported

Documents that are linked but not imported are listed, with reasons, in each part's reference page: Part I, Part II, Part III, Part IV, Part V. The full audit of every source document is kept with the book's build tooling (docs/CONTENT-AUDIT.md in the book repository).