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.
| Source | Repository | Branch | Pinned commit | Imported documents |
|---|---|---|---|---|
| Άρκτος Wallet (arktos-wallet) | cognokratos/arktos-wallet | main | 92650a0347993622cbb3e5eeac2c908069c67fd6 | 15 |
| etf-research-agent | cognokratos/etf-research-agent | main | 493a67a721ef56ee64151e66e6e47c974552a23f | 16 |
| simple-agent-template | cognokratos/simple-agent-template | main | c66ce19d7b0c5c88c41b6860c78f66075485a07a | 33 |
| Σοφός Agent (sophos-agent) | cognokratos/sophos-agent | main | 8d9fe52182d8441454916ec8a6ab13c0773228e2 | 20 |
| Ταύρος Revenue (tauros-revenue) | cognokratos/tauros-revenue | main | facbbc927eb4b9090937524ca02486c026f1f025 | 28 |
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
- The chapter's file is read from the pinned commit. Nothing is checked out, and nothing from the source repository is executed.
- 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.
- Mermaid diagram blocks are handed to a pinned Mermaid renderer. Every other code block is unchanged.
- A provenance line is added under the title and a source note at the end.
- 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
Σοφός Agent (sophos-agent)
Ταύρος Revenue (tauros-revenue)
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).