Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# AGENTS.md - how to work in this repository

**Owner**: `git-rhizoid-builder` - the role that keeps git-rhizoid (this design log and the rhizoid tool), whichever session holds it (signing as `git-rhizoid-builder.RUN`); another session sends it the change - a message, or an upstream item naming git-rhizoid - and does not land here itself.

This repo is a small versioned "database" kept as plain files. The data lives as JSON lines, its tables
declared in `tables.toml`; [tad](https://github.com/creation-guidelines/tad-engine), a released Rust tool,
checks it, keeps it canonical and renders it, and CI enforces that it stays so. **Work on the content.**
Expand Down
26 changes: 13 additions & 13 deletions data/backlog.json

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions data/glimpses.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,4 @@
{"id":"g-20261117-193335","at":"2026-11-17T19:33:35Z","by":"research-bringup-tools","kind":"docs","summary":"Backlog: what a tools home needs of rhizoid (cargo pin, one pin bump, send back)"}
{"id":"g-20261118-144738","at":"2026-11-18T14:47:38Z","by":"rhizoid-graph-research","kind":"docs","summary":"Backlog: rhizoid's scope - the follow tool for every edge, status first, by conformance"}
{"id":"g-20261118-145705","at":"2026-11-18T14:57:05Z","by":"tad update-pins","kind":"build","summary":"tad 0.7.1: the pin moved, the data and documents re-rendered"}
{"id":"g-20261118-150749","at":"2026-11-18T15:07:49Z","by":"git-rhizoid-builder.b1c7f3","kind":"docs","summary":"git-rhizoid unparked: items ranked in the research's order, owner named"}
1 change: 1 addition & 0 deletions data/session_log.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,3 +19,4 @@
{"id":"2026-11-11-tad-in-rust","entry_date":"2026-11-11","title":"tad in Rust replaces the vendored Python engine","done":"This repository moved to tad in Rust: tables.toml is the authority, tad comes from its pinned release, the vendored .tad, schema.sql, load.sql and checks/ are gone, and AGENTS.md got simpler. The open item about dc.py blocking recovery from an empty table closed with it.","considered":null,"rejected":null}
{"id":"2026-11-11-one-word-summary","entry_date":"2026-11-11","title":"A concept's text is its summary","done":"The concepts table's statement field is now summary, the word the shared language (ocoeco's language.toml) and twenty other projects use; the observatory showed this repository's concepts without their text because of it. Found by checking every project against the shared language.","considered":"Teaching the shared language a second word for the same thing.","rejected":"That: one role, one word."}
{"id":"2026-11-18-scope-every-edge","entry_date":"2026-11-18","title":"Scope from linux-phone-oco's graph research: the follow tool for every edge, status first, by conformance","done":"A research lead of linux-phone-oco measured its repository graph (12 edges, 3 moved by a job, 6 by hand, 5 behind) and the world (no Rust or shell tool carries root-level files down and changes up; only copybara, on a JVM; josh needs a monorepo; subtree/subrepo need a prefix - the tad/subrepo lesson of 2026-09-22 again). It filed status-over-every-edge and follow-by-conformance here and reshaped slice-consumption, followers-one-pin-bump, send-back-writes-the-upstream-item and implement-cli to that order (source linux-phone-oco-base-graph).","considered":"Porting idealkb's follow.sh into rhizoid now; rhizoid as a template engine; rows as an edge kind.","rejected":"A port before conformance (the shell works and is tested); a template engine or a merge of data (bases are data); rows (docs' feeds own them)."}
{"id":"2026-11-18-unparked-by-the-authors-yes","entry_date":"2026-11-18","title":"git-rhizoid unparked by the author's yes: the follow tool for every edge, in the research's order","done":"The author's word, verbatim (through the Top Coordinator, 2026-11-18, recorded in linux-phone-oco/docs as session-log 2026-11-18-author-yes-device-layer-and-rhizoid): 'yes, if its the best we came up with, grounded in our extensive research and consideration, which it seems it did, so yes'. It unparks implement-cli with the scope of 2026-11-18-scope-every-edge and its order, now the backlog's rank: 1 status-over-every-edge (passes graph-drift.sh), 2 follow-by-conformance (passes idealkb's bin/test-follow.sh, keeping the pin names its source, one owner per file, the followers-answer gate), 3-4 slice-consumption and followers-one-pin-bump, 5 send-back, 6-7 cuttings (rhizcut, cutting-as-cargo-dependency). Owner: git-rhizoid-builder, who keeps AGENTS.md's Owner line here and in git-rhizoid/rhizoid. Each step replaces shell only once it passes; idealkb's update-pins and follow.sh stay until step 2 passes.","considered":"Unparking only status and leaving the rest parked; ranking only the first two.","rejected":"Leaving the order in notes: the rank is a field now, so the next builder reads it rather than infers it."}
29 changes: 25 additions & 4 deletions docs/backlog.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,10 @@ Opened
### Implement the actual rhizoid CLI

Status
: open
: in-progress

Note
: Boundary layer implemented: manifest infra, 7 argenv-typed commands, 39 tests, real CI including MSRV all green (see implement-boundary-layer). init and remove fully work; add/import/update/status/refresh are typed and tested but stubbed, waiting on the GitHubPort adapter. Parked 2026-11-11: tad's duties move into ocoeco; this returns there, or with the first cutting. Reshaped 2026-11-18 (docs research base-graph-measured, base-graph-world; decision 2026-11-18-device-layer-from-docs; upstream item rhizoid-scope-every-edge (linux-phone-oco/docs)): rhizoid's scope is the follow tool for every edge (slice, tool pin, cutting), built in order status-over-every-edge, follow-by-conformance, send-back, cuttings; each replaces shell only once it passes the shell's tests. Unparking implement-cli waits on the author's word.
: Boundary layer implemented: manifest infra, 7 argenv-typed commands, 39 tests, real CI including MSRV all green (see implement-boundary-layer). init and remove fully work; add/import/update/status/refresh are typed and tested but stubbed, waiting on the GitHubPort adapter. Parked 2026-11-11: tad's duties move into ocoeco; this returns there, or with the first cutting. Reshaped 2026-11-18 (docs research base-graph-measured, base-graph-world; decision 2026-11-18-device-layer-from-docs; upstream item rhizoid-scope-every-edge (linux-phone-oco/docs)): rhizoid's scope is the follow tool for every edge (slice, tool pin, cutting), built in order status-over-every-edge, follow-by-conformance, send-back, cuttings; each replaces shell only once it passes the shell's tests. Unparking implement-cli waits on the author's word. Unparked 2026-11-18, the author said: 'yes, if its the best we came up with, grounded in our extensive research and consideration, which it seems it did, so yes' (through the Top Coordinator, 2026-11-18; docs session-log 2026-11-18-author-yes-device-layer-and-rhizoid): git-rhizoid has the research's scope and order - status-over-every-edge, follow-by-conformance, send-back-writes-the-upstream-item, then cuttings - each replacing shell only once it passes the shell's tests. Owner: git-rhizoid-builder. This item is the umbrella; its first step is status-over-every-edge.

Opened
: 2026-09-22
Expand Down Expand Up @@ -92,6 +92,9 @@ Note
Opened
: 2026-11-12

Rank
: 6


<a id="slice-consumption"></a>
### Consumption mode for a slice: take a named list of files from a pinned release of a repository into one that has its own files
Expand All @@ -105,6 +108,9 @@ Note
Opened
: 2026-11-17

Rank
: 3


<a id="cutting-as-cargo-dependency"></a>
### A cutting consumed by a language manager: the patched fork of a Rust tool as a cargo git dependency at a pinned tag, written and bumped by rhizoid
Expand All @@ -118,6 +124,9 @@ Note
Opened
: 2026-11-17

Rank
: 7


<a id="followers-one-pin-bump"></a>
### Many followers, one pin and one verdict: a slice, a cutting and a tool version bumped by the same weekly job
Expand All @@ -131,6 +140,9 @@ Note
Opened
: 2026-11-17

Rank
: 4


<a id="send-back-writes-the-upstream-item"></a>
### Sending a change back: a patch to the source as a pull request, and the follower's own record of it
Expand All @@ -144,19 +156,25 @@ Note
Opened
: 2026-11-17

Rank
: 5


<a id="status-over-every-edge"></a>
### rhizoid status: one read-only report over every edge a repository has - a slice (pin vs source release, followed files equal, own files on their way up), a tool pin (vs latest tag), a cutting (tracking vs upstream head) - exit 1 on drift

Status
: open
: in-progress

Note
: Found 2026-11-18 by linux-phone-oco (docs research base-graph-measured, base-graph-world; decision 2026-11-18-device-layer-from-docs; upstream item rhizoid-scope-every-edge (linux-phone-oco/docs)). The first command to build: no risk, it replaces docs' graph-drift.sh (36 FAIL today) and passes it line for line. Edges are read from the pin files followers already own (idealkb.toml, devicebase.toml, lab.toml [tools], a fork's .rhizoid/module.toml), so the follower lists derive from the pins. Rust with argenv, the CLI's status command.
: Found 2026-11-18 by linux-phone-oco (docs research base-graph-measured, base-graph-world; decision 2026-11-18-device-layer-from-docs; upstream item rhizoid-scope-every-edge (linux-phone-oco/docs)). The first command to build: no risk, it replaces docs' graph-drift.sh (36 FAIL today) and passes it line for line. Edges are read from the pin files followers already own (idealkb.toml, devicebase.toml, lab.toml [tools], a fork's .rhizoid/module.toml), so the follower lists derive from the pins. Rust with argenv, the CLI's status command. Unparked 2026-11-18 (see implement-cli): first in the author's order. Built in rhizoid-cli: status reads a graph file of the edges and each follower's own pin files at origin/main, reports every edge current, behind or moved by hand, exits 1 on drift, and is proven by graph-drift.sh's cases as fixtures and by agreeing with graph-drift.sh run on the real graph.

Opened
: 2026-11-18

Rank
: 1


<a id="follow-by-conformance"></a>
### rhizoid follow lays a slice exactly as idealkb's bin/follow.sh does, proven by its fixtures, before update-pins calls it
Expand All @@ -169,3 +187,6 @@ Note

Opened
: 2026-11-18

Rank
: 2
2 changes: 1 addition & 1 deletion docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,5 @@

- [Backlog](backlog.md): 13
- [Concepts](concepts.md): 14
- [Session Log](session_log.md): 21
- [Session Log](session_log.md): 22
- [Sources](sources.md): 12
18 changes: 18 additions & 0 deletions docs/session_log.md
Original file line number Diff line number Diff line change
Expand Up @@ -322,3 +322,21 @@ Considered

Rejected
: A port before conformance (the shell works and is tested); a template engine or a merge of data (bases are data); rows (docs' feeds own them).

---


<a id="2026-11-18-unparked-by-the-authors-yes"></a>
### git-rhizoid unparked by the author's yes: the follow tool for every edge, in the research's order

Entry date
: 2026-11-18

Done
: The author's word, verbatim (through the Top Coordinator, 2026-11-18, recorded in linux-phone-oco/docs as session-log 2026-11-18-author-yes-device-layer-and-rhizoid): 'yes, if its the best we came up with, grounded in our extensive research and consideration, which it seems it did, so yes'. It unparks implement-cli with the scope of 2026-11-18-scope-every-edge and its order, now the backlog's rank: 1 status-over-every-edge (passes graph-drift.sh), 2 follow-by-conformance (passes idealkb's bin/test-follow.sh, keeping the pin names its source, one owner per file, the followers-answer gate), 3-4 slice-consumption and followers-one-pin-bump, 5 send-back, 6-7 cuttings (rhizcut, cutting-as-cargo-dependency). Owner: git-rhizoid-builder, who keeps AGENTS.md's Owner line here and in git-rhizoid/rhizoid. Each step replaces shell only once it passes; idealkb's update-pins and follow.sh stay until step 2 passes.

Considered
: Unparking only status and leaving the rest parked; ranking only the first two.

Rejected
: Leaving the order in notes: the rank is a field now, so the next builder reads it rather than infers it.
5 changes: 5 additions & 0 deletions tables.toml
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,11 @@ name = "opened"
type = "date"
required = true

# where the item stands in the order the author unparked git-rhizoid with (1 first; empty: after the ranked)
[[tables.backlog.fields]]
name = "rank"
type = "integer"

[tables.concept_sources]
key = ["concept_id", "source_id"]

Expand Down
Loading