From d7036dfe937bec3c4c62e949af6a59e2e997b0f9 Mon Sep 17 00:00:00 2001 From: orchestration-renewed Date: Wed, 18 Nov 2026 15:47:45 +0100 Subject: [PATCH] docs: Backlog: rhizoid's scope - the follow tool for every edge, status first, by conformance Glimpse: g-20261118-144738 Co-Authored-By: Claude Opus 5.5 --- data/backlog.json | 10 ++++++---- data/glimpses.json | 1 + data/session_log.json | 1 + data/sources.json | 1 + docs/backlog.md | 34 ++++++++++++++++++++++++++++++---- docs/index.md | 6 +++--- docs/session_log.md | 18 ++++++++++++++++++ docs/sources.md | 13 +++++++++++++ 8 files changed, 73 insertions(+), 11 deletions(-) diff --git a/data/backlog.json b/data/backlog.json index 97f6d23..ae0e7ce 100644 --- a/data/backlog.json +++ b/data/backlog.json @@ -1,11 +1,13 @@ {"id":"design-consumption-side","title":"Design the consumption-side manifest","status":"open","note":"How a repo declares \"I depend on this org's fork of X at version Y\" and pulls it in - deliberately not designed yet, kept separate from the fork-management side.","opened":"2026-09-22"} -{"id":"implement-cli","title":"Implement the actual rhizoid CLI","status":"open","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.","opened":"2026-09-22"} +{"id":"implement-cli","title":"Implement the actual rhizoid CLI","status":"open","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.","opened":"2026-09-22"} {"id":"verify-pages-root","title":"Verify Pages serves at the org root","status":"done","note":"git-rhizoid.github.io should serve at https://git-rhizoid.github.io/ once Pages is enabled here, since the repo name matches the org.github.io convention - not yet confirmed live.","opened":"2026-09-22"} {"id":"decide-dot-github-repo","title":"Decide whether a separate git-rhizoid/.github repo is worth adding","status":"open","note":"For org-wide issue/PR template defaults - a different, smaller thing than this repo, and not yet built.","opened":"2026-09-22"} {"id":"dc-check-blocks-empty-recovery","title":"dc.py check() blocks recovering from an all-empty table","status":"done","note":"Gone with the switch to tad in Rust (2026-11-11): tad has no rule that every field must appear on some line, so an empty table checks out and canon keeps it - tried on a copy.","opened":"2026-09-22"} {"id":"tui-for-rhizoid","title":"Add a TUI for Rhizoid","status":"open","note":"Explicitly a later phase, after the CLI (init/add/import/update/status/refresh/remove) is working - not designed at all yet.","opened":"2026-09-22"} {"id":"rhizcut","title":"rhizcut: the tool that takes a cutting","status":"open","note":"Named by the milestone rhizoid-carries-ocoeco's criteria but never recorded: found 2026-11-12 when ocoeco check followed every link. The milestone is right to depend on it.","opened":"2026-11-12"} -{"id":"slice-consumption","title":"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","status":"open","note":"Found 2026-11-17 by grenudi/ideal-knowledge-base (research chain-follow-world, decision 2026-11-17-chain-follow-by-slice). Its chain - idealkb to device-template to device bases - lays a slice, not a repository: a source names what it gives (a generic list, files whole or the part between two marker lines), a follower pins a release and names its own files, and the verdict says whether the follower changed a generic file (idealkb's bin/follow.sh ends 3). rhizoid today takes a whole fork (a cutting); this is the consumption side design-consumption-side leaves open. follow.sh and update-pins.sh are the prototype; when rhizoid has it, idealkb can hand its chain over. Also lacking for that chain: the pin read from the follower's own file, a release gate (every follower answers before a release is tagged), and sending a changed generic file back as a patch. Also 2026-11-17: the tools home (linux-phone-oco/lab-tools) has the same slice case for the device-template files that go with a tool - the [boot] manifest skeleton, hook examples, an initramfs skeleton - beside the tool's own version pin (see cutting-as-cargo-dependency, followers-one-pin-bump).","opened":"2026-11-17"} +{"id":"slice-consumption","title":"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","status":"open","note":"Found 2026-11-17 by grenudi/ideal-knowledge-base (research chain-follow-world, decision 2026-11-17-chain-follow-by-slice). Its chain - idealkb to device-template to device bases - lays a slice, not a repository: a source names what it gives (a generic list, files whole or the part between two marker lines), a follower pins a release and names its own files, and the verdict says whether the follower changed a generic file (idealkb's bin/follow.sh ends 3). rhizoid today takes a whole fork (a cutting); this is the consumption side design-consumption-side leaves open. follow.sh and update-pins.sh are the prototype; when rhizoid has it, idealkb can hand its chain over. Also lacking for that chain: the pin read from the follower's own file, a release gate (every follower answers before a release is tagged), and sending a changed generic file back as a patch. Also 2026-11-17: the tools home (linux-phone-oco/lab-tools) has the same slice case for the device-template files that go with a tool - the [boot] manifest skeleton, hook examples, an initramfs skeleton - beside the tool's own version pin (see cutting-as-cargo-dependency, followers-one-pin-bump). 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.","opened":"2026-11-17"} {"id":"cutting-as-cargo-dependency","title":"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","status":"open","note":"Found 2026-11-17 by linux-phone-oco/docs (research bringup-home-follow-and-rhizoid, decision 2026-11-17-bringup-in-lab-tools). A device repository uses lab-tools' bringup as a pinned binary or cargo git dependency; when it must patch the tool itself before upstream takes the change, the true case is a cutting of lab-tools (tracking branch pristine, patch branch merged from it, clean patch back). What rhizoid lacks is the consumption side for it: the follower declares this tool, this cutting, this tag, and rhizoid writes the pin where the language manager reads it (Cargo.toml git tag or [patch] entry; a rust-script file's cargo header; a version line in a manifest) and bumps it when the tracking branch has a new release - the open item design-consumption-side, for a case that now has a user. Until then: a plain fork and a [patch] line by hand, recorded as a problem.","opened":"2026-11-17"} -{"id":"followers-one-pin-bump","title":"Many followers, one pin and one verdict: a slice, a cutting and a tool version bumped by the same weekly job","status":"open","note":"Found 2026-11-17 by linux-phone-oco/docs (same research). A device repository follows three sources - idealkb (a slice), device-template (a slice) and lab-tools (a tool version, maybe a cutting) - each with its own pin line, and today an updater (idealkb's update-pins.sh) only for the slices. Lacking: one pin file the follower owns (source, kind slice|cutting|tool, release), one command that bumps every pin to the newest release and opens a pull request per source, and one verdict (up to date, behind, own change to a generic file) that CI can gate on. update-pins.sh and follow.sh's exit 3 are the prototype; slice-consumption is the first kind.","opened":"2026-11-17"} -{"id":"send-back-writes-the-upstream-item","title":"Sending a change back: a patch to the source as a pull request, and the follower's own record of it","status":"open","note":"Found 2026-11-17 by linux-phone-oco/docs (same research). clean-patch-back says a diff of the patch branch against the pristine tracking branch is a clean patch; the CLI that makes it and opens the pull request is stubbed. The follower's bases keep an upstream item per change (idealkb: ikb upstream-item, form patch, draft, ready on the person's word, sent with the PR address, landed when released). Lacking: a rhizoid verb that, for a changed generic file or a patch branch, writes the patch, opens the pull request only after the person says ready, and returns the PR address and later the release that carried it, in a form the follower's record command takes - without rhizoid knowing that base's tables. It never sends in the person's name by itself.","opened":"2026-11-17"} +{"id":"followers-one-pin-bump","title":"Many followers, one pin and one verdict: a slice, a cutting and a tool version bumped by the same weekly job","status":"open","note":"Found 2026-11-17 by linux-phone-oco/docs (same research). A device repository follows three sources - idealkb (a slice), device-template (a slice) and lab-tools (a tool version, maybe a cutting) - each with its own pin line, and today an updater (idealkb's update-pins.sh) only for the slices. Lacking: one pin file the follower owns (source, kind slice|cutting|tool, release), one command that bumps every pin to the newest release and opens a pull request per source, and one verdict (up to date, behind, own change to a generic file) that CI can gate on. update-pins.sh and follow.sh's exit 3 are the prototype; slice-consumption is the first kind. 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.","opened":"2026-11-17"} +{"id":"send-back-writes-the-upstream-item","title":"Sending a change back: a patch to the source as a pull request, and the follower's own record of it","status":"open","note":"Found 2026-11-17 by linux-phone-oco/docs (same research). clean-patch-back says a diff of the patch branch against the pristine tracking branch is a clean patch; the CLI that makes it and opens the pull request is stubbed. The follower's bases keep an upstream item per change (idealkb: ikb upstream-item, form patch, draft, ready on the person's word, sent with the PR address, landed when released). Lacking: a rhizoid verb that, for a changed generic file or a patch branch, writes the patch, opens the pull request only after the person says ready, and returns the PR address and later the release that carried it, in a form the follower's record command takes - without rhizoid knowing that base's tables. It never sends in the person's name by itself. 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.","opened":"2026-11-17"} +{"id":"status-over-every-edge","title":"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","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.","opened":"2026-11-18"} +{"id":"follow-by-conformance","title":"rhizoid follow lays a slice exactly as idealkb's bin/follow.sh does, proven by its fixtures, before update-pins calls it","status":"open","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)). Passes grenudi/ideal-knowledge-base bin/test-follow.sh byte for byte and keeps three things its owner names: the pin names its source, one owner per file (check-one-owner), the followers' gate before a release (followers-answer.sh). Adds #! from = DIR/ and own needing an upstream item (idealkb items idealkb-slice-from-prefix, idealkb-own-needs-item) only after idealkb has them. Until it passes, the shell is the tool. Blocked by status-over-every-edge.","opened":"2026-11-18"} diff --git a/data/glimpses.json b/data/glimpses.json index b505e51..129b36b 100644 --- a/data/glimpses.json +++ b/data/glimpses.json @@ -10,3 +10,4 @@ {"id":"g-20261116-160937","at":"2026-11-16T16:09:37Z","by":"claude","kind":"chore","summary":"a caller: what the gatherer writes is said where it writes it, not here"} {"id":"g-20261117-174558","at":"2026-11-17T17:45:58Z","by":"ikb-cli","kind":"docs","summary":"Backlog: rhizoid lacks a consumption mode for a slice (idealkb's chain needs it)"} {"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"} diff --git a/data/session_log.json b/data/session_log.json index dfd819a..784225e 100644 --- a/data/session_log.json +++ b/data/session_log.json @@ -18,3 +18,4 @@ {"id":"its-workings","entry_date":"2026-11-10","title":"Its workings, told","done":"What delivers and proves the steps reached so far - the design log, the declarations layer and its tests - written under the steps they serve. The TUI and carrying ocoeco are left with nothing under them.","considered":"Filling every step.","rejected":"That: a step nothing serves should be seen."} {"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)."} diff --git a/data/sources.json b/data/sources.json index d616d57..8ab9852 100644 --- a/data/sources.json +++ b/data/sources.json @@ -9,3 +9,4 @@ {"id":"yaml-document-from-hell","title":"The YAML Document From Hell","url":"https://ruudvanasseldonk.com/2023/01/11/the-yaml-document-from-hell","author":"Ruud van Asseldonk","year":2023} {"id":"wrangler-toml-to-jsonc","title":"The future of Wrangler configuration","url":"https://github.com/cloudflare/workers-sdk/discussions/1951","author":"Cloudflare workers-sdk","year":null} {"id":"argenv-repo","title":"argenv","url":"https://github.com/argenv-opencommons/argenv","author":"argenv-opencommons","year":null} +{"id":"linux-phone-oco-base-graph","title":"linux-phone-oco docs: research base-graph-measured and base-graph-world, decision 2026-11-18-device-layer-from-docs","url":"https://github.com/linux-phone-oco/docs/tree/main/research/base-graph/2026-11-18","author":"linux-phone-oco","year":2026} diff --git a/docs/backlog.md b/docs/backlog.md index d408b29..b3b4f24 100644 --- a/docs/backlog.md +++ b/docs/backlog.md @@ -22,7 +22,7 @@ Status : open 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. +: 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. Opened : 2026-09-22 @@ -100,7 +100,7 @@ Status : open Note -: Found 2026-11-17 by grenudi/ideal-knowledge-base (research chain-follow-world, decision 2026-11-17-chain-follow-by-slice). Its chain - idealkb to device-template to device bases - lays a slice, not a repository: a source names what it gives (a generic list, files whole or the part between two marker lines), a follower pins a release and names its own files, and the verdict says whether the follower changed a generic file (idealkb's bin/follow.sh ends 3). rhizoid today takes a whole fork (a cutting); this is the consumption side design-consumption-side leaves open. follow.sh and update-pins.sh are the prototype; when rhizoid has it, idealkb can hand its chain over. Also lacking for that chain: the pin read from the follower's own file, a release gate (every follower answers before a release is tagged), and sending a changed generic file back as a patch. Also 2026-11-17: the tools home (linux-phone-oco/lab-tools) has the same slice case for the device-template files that go with a tool - the [boot] manifest skeleton, hook examples, an initramfs skeleton - beside the tool's own version pin (see cutting-as-cargo-dependency, followers-one-pin-bump). +: Found 2026-11-17 by grenudi/ideal-knowledge-base (research chain-follow-world, decision 2026-11-17-chain-follow-by-slice). Its chain - idealkb to device-template to device bases - lays a slice, not a repository: a source names what it gives (a generic list, files whole or the part between two marker lines), a follower pins a release and names its own files, and the verdict says whether the follower changed a generic file (idealkb's bin/follow.sh ends 3). rhizoid today takes a whole fork (a cutting); this is the consumption side design-consumption-side leaves open. follow.sh and update-pins.sh are the prototype; when rhizoid has it, idealkb can hand its chain over. Also lacking for that chain: the pin read from the follower's own file, a release gate (every follower answers before a release is tagged), and sending a changed generic file back as a patch. Also 2026-11-17: the tools home (linux-phone-oco/lab-tools) has the same slice case for the device-template files that go with a tool - the [boot] manifest skeleton, hook examples, an initramfs skeleton - beside the tool's own version pin (see cutting-as-cargo-dependency, followers-one-pin-bump). 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. Opened : 2026-11-17 @@ -126,7 +126,7 @@ Status : open Note -: Found 2026-11-17 by linux-phone-oco/docs (same research). A device repository follows three sources - idealkb (a slice), device-template (a slice) and lab-tools (a tool version, maybe a cutting) - each with its own pin line, and today an updater (idealkb's update-pins.sh) only for the slices. Lacking: one pin file the follower owns (source, kind slice|cutting|tool, release), one command that bumps every pin to the newest release and opens a pull request per source, and one verdict (up to date, behind, own change to a generic file) that CI can gate on. update-pins.sh and follow.sh's exit 3 are the prototype; slice-consumption is the first kind. +: Found 2026-11-17 by linux-phone-oco/docs (same research). A device repository follows three sources - idealkb (a slice), device-template (a slice) and lab-tools (a tool version, maybe a cutting) - each with its own pin line, and today an updater (idealkb's update-pins.sh) only for the slices. Lacking: one pin file the follower owns (source, kind slice|cutting|tool, release), one command that bumps every pin to the newest release and opens a pull request per source, and one verdict (up to date, behind, own change to a generic file) that CI can gate on. update-pins.sh and follow.sh's exit 3 are the prototype; slice-consumption is the first kind. 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. Opened : 2026-11-17 @@ -139,7 +139,33 @@ Status : open Note -: Found 2026-11-17 by linux-phone-oco/docs (same research). clean-patch-back says a diff of the patch branch against the pristine tracking branch is a clean patch; the CLI that makes it and opens the pull request is stubbed. The follower's bases keep an upstream item per change (idealkb: ikb upstream-item, form patch, draft, ready on the person's word, sent with the PR address, landed when released). Lacking: a rhizoid verb that, for a changed generic file or a patch branch, writes the patch, opens the pull request only after the person says ready, and returns the PR address and later the release that carried it, in a form the follower's record command takes - without rhizoid knowing that base's tables. It never sends in the person's name by itself. +: Found 2026-11-17 by linux-phone-oco/docs (same research). clean-patch-back says a diff of the patch branch against the pristine tracking branch is a clean patch; the CLI that makes it and opens the pull request is stubbed. The follower's bases keep an upstream item per change (idealkb: ikb upstream-item, form patch, draft, ready on the person's word, sent with the PR address, landed when released). Lacking: a rhizoid verb that, for a changed generic file or a patch branch, writes the patch, opens the pull request only after the person says ready, and returns the PR address and later the release that carried it, in a form the follower's record command takes - without rhizoid knowing that base's tables. It never sends in the person's name by itself. 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. Opened : 2026-11-17 + + + +### 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 + +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. + +Opened +: 2026-11-18 + + + +### rhizoid follow lays a slice exactly as idealkb's bin/follow.sh does, proven by its fixtures, before update-pins calls it + +Status +: open + +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)). Passes grenudi/ideal-knowledge-base bin/test-follow.sh byte for byte and keeps three things its owner names: the pin names its source, one owner per file (check-one-owner), the followers' gate before a release (followers-answer.sh). Adds #! from = DIR/ and own needing an upstream item (idealkb items idealkb-slice-from-prefix, idealkb-own-needs-item) only after idealkb has them. Until it passes, the shell is the tool. Blocked by status-over-every-edge. + +Opened +: 2026-11-18 diff --git a/docs/index.md b/docs/index.md index cbcd6df..6cfd696 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,7 +2,7 @@ # Index -- [Backlog](backlog.md): 11 +- [Backlog](backlog.md): 13 - [Concepts](concepts.md): 14 -- [Session Log](session_log.md): 20 -- [Sources](sources.md): 11 +- [Session Log](session_log.md): 21 +- [Sources](sources.md): 12 diff --git a/docs/session_log.md b/docs/session_log.md index 7191c4a..9cce18d 100644 --- a/docs/session_log.md +++ b/docs/session_log.md @@ -304,3 +304,21 @@ Considered Rejected : That: one role, one word. + +--- + + + +### Scope from linux-phone-oco's graph research: the follow tool for every edge, status first, by conformance + +Entry date +: 2026-11-18 + +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). diff --git a/docs/sources.md b/docs/sources.md index adde903..4560891 100644 --- a/docs/sources.md +++ b/docs/sources.md @@ -152,3 +152,16 @@ Author Cited by : [argenv declares flags and env vars - not subcommands or positionals](concepts.md#argenv-is-flags-and-env-only) + + + +### linux-phone-oco docs: research base-graph-measured and base-graph-world, decision 2026-11-18-device-layer-from-docs + +Url +: https://github.com/linux-phone-oco/docs/tree/main/research/base-graph/2026-11-18 + +Author +: linux-phone-oco + +Year +: 2026