diff options
| author | main <main@swarm.moe> | 2026-03-20 01:11:39 -0400 |
|---|---|---|
| committer | main <main@swarm.moe> | 2026-03-20 01:11:39 -0400 |
| commit | 22fe3d2ce7478450a1d7443c4ecbd85fd4c46716 (patch) | |
| tree | d534d4585a804081b53fcf2f3bbb3a8fc5d29190 /docs/architecture.md | |
| parent | ce41a229dcd57f9a2c35359fe77d9f54f603e985 (diff) | |
| download | fidget_spinner-22fe3d2ce7478450a1d7443c4ecbd85fd4c46716.zip | |
Excise git provenance from experiment ledger
Diffstat (limited to 'docs/architecture.md')
| -rw-r--r-- | docs/architecture.md | 34 |
1 files changed, 7 insertions, 27 deletions
diff --git a/docs/architecture.md b/docs/architecture.md index 30d01fc..e274ad5 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -80,7 +80,6 @@ The engine depends on a stable, typed spine stored in SQLite: - node annotations - node edges - frontiers -- checkpoints - runs - metrics - experiments @@ -207,23 +206,6 @@ Important constraint: That keeps frontier filtering honest. -### `checkpoints` - -Stores committed candidate or champion checkpoints: - -- checkpoint id -- frontier id -- anchoring node id -- repo/worktree metadata -- commit hash -- disposition -- summary -- created timestamp - -In the current codebase, a frontier may temporarily exist without a champion if -it was initialized outside a git repo. Core-path experimentation is only fully -available once git-backed checkpoints exist. - ### `runs` Stores run envelopes: @@ -233,8 +215,7 @@ Stores run envelopes: - frontier id - backend - status -- code snapshot metadata -- benchmark suite +- run dimensions - command envelope - started and finished timestamps @@ -254,12 +235,12 @@ Stores the atomic closure object for core-path work: - experiment id - frontier id -- base checkpoint id -- candidate checkpoint id - hypothesis node id - run node id and run id - optional analysis node id - decision node id +- title +- summary - verdict - note payload - created timestamp @@ -307,9 +288,9 @@ Track is derived from class, not operator whim. The frontier projection currently exposes: - frontier record -- champion checkpoint id -- active candidate checkpoint ids -- experiment count +- open experiment count +- completed experiment count +- verdict counts This projection is derived from canonical state and intentionally rebuildable. @@ -336,11 +317,10 @@ It persists, in one transaction: - run node - run record -- candidate checkpoint - decision node - experiment record - lineage and evidence edges -- frontier touch and champion demotion when needed +- frontier touch and verdict accounting inputs That atomic boundary is the answer to the ceremony/atomicity pre-mortem. |