Repository navigation
docs: fold nix2cf into tendcf; plugin-type layout (D46) - #46
Merged
Merged
Conversation
…to tendcf djbclark, 2026-11-13: frdminc/nix2cf folds into tendcf under compiler/; the compiler becomes `tendcf compile`, the name nix2cf moves to the Nix frontend plugin, plugins are found through the tendcf.frontends, tendcf.supervisors and tendcf.importers entry-point groups and run at compile time only. Docs only: no files move, no code or schema changes. - guide §2-§4, §18: layer diagram, lockfile, compiler name and home; buildfile recorded as built (verified: nix2cf master 572b0b7 CI green) - map: §1, §3, §5, Step 3, D12, D21 amended; new D46; document map - change-process: one repo, no tendcf.lock, two-step bump; site.lock kept - linux-targets step 6 and §5; GLOSSARY nix2cf entry; architecture README - new docs/architecture/plugin-layout.md: tree, today vs planned, entry-point groups, consent rule, contrib/out of tree, move order Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…with D46 The nix2cf_services / nix2cf_edges keys only ever appeared in guide §16.A's illustrative, non-loading preview example and its copy in the paper; no schema, fixture, projector or bundle carried them. Rename them to tendcf_services / tendcf_edges there now, note that the projection's real keys are tendcf_service / tendcf_interlock (and that tendcf_services is the real bundle's name), and drop the planned schema-v6 rename from D46 and plugin-layout.md: no schema bump is involved. Paper §2.1, §2.2, §2.6, §6.2, §8: compiler is tendcf compile, folded into tendcf (decided 2026-11-13); nix2cf names the Nix frontend; one tendcf pin covers schemas and compiler; buildfile recorded as built. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Lead call on the follow-up: tendcf_services matched the real generic bundle's name and was one letter off the projected key tendcf_service. Rename the guide §16.A / paper §2.6 illustration keys to preview_* and reword the note, D46 (6) and plugin-layout.md §6 item 4 accordingly. No schema change. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Both frontier reviews (Astra gpt-6-astra high, Fable claude-fable-5-2 high) said merge after fixes. This records djbclark's decisions on them: plugins are trusted build-time code the operator allows, with gates and signing run apart from plugins; a plugin loads only if site-private names it, in-tree only for releases until #47; supervisor renderers are in tree only; one tendcf rev is the pinned unit; no shims (tendcf compile with no alias, package renamed tendcf, bin/ -> tools/ with no wrappers); current schema_version only until a non-operator device enrolls; nix2cf archived as soon as #45 merges. Also: device-boundary import rules (M1), site.lock wording (M6), the compile/--host mapping (L2), the living-file list for the restructure (L4), D15 pointer (L5), the paper's Nix passthrough exception and the systemd adapter status (A4, A5), the device receives the full goal file (A3), fixture counts 159 (125/6/28). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…uded (djbclark 2026-11-13) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
djbclark
force-pushed
the
monorepo-layout-docs
branch
from
November 13, 2026 11:50
f2646cd to
64994e3
Compare
Re-reviews (Astra gpt-6-astra high, Fable claude-fable-5-2 high) both said merge after fixes. - Rewrite scope matches djbclark's ruling everywhere: every path in every file, dated records included; prose naming nix2cf stays (A1/F1). - Reproducibility qualified: the pin identifies compiler and plugin source; byte reproduction also needs a fixed dependency/toolchain closure and controlled external inputs, not yet specified (A2). - Guide section 7 carries the current-schema-version-only note (F2). - PR 45 merged (ca4fa90) and frdminc/nix2cf is archived: compiler/ exists and its tests run in tendcf CI (F3). Branch rebased on master. - N1-N4: operator-host wording, deployment caveat, operator-host check in the guide, the rest of compiler/ in the restructure list. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…caveat, two sentences) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
djbclark
marked this pull request as ready for review
November 13, 2026 12:07
Bugbot couldn't run - usage limit reachedBugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit. A user or team admin can review and increase usage limits in the Cursor dashboard. (requestId: 33e4a8e8-525f-4b50-afd2-732651c5a64f) |
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
4 tasks done
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Documents djbclark's 2026-11-13 decision to fold
frdminc/nix2cfinto tendcf and give the repo a plugin-type layout. New decision D46; D12 and D21 amended, D15 and §9.6 given D46 notes; newdocs/architecture/plugin-layout.md.compiler/with history. Done: Import nix2cf under compiler/ (history preserved) #45 merged 2026-11-13 (ca4fa90), andfrdminc/nix2cfwas archived the same day. This branch is rebased on that master, so the docs citecompiler/and its CI job as they exist.tools/(wasbin/),compiler/,plugins/{frontends,supervisors,importers}/,contrib/. It becomes one Python package, import nametendcf. Public entry-point groupstendcf.frontendsandtendcf.importers, so third-party frontends and importers can also live out of tree; supervisor renderers are in tree only (no publictendcf.supervisorsgroup). Plugins are compile-time only and are trusted build-time code the operator explicitly allows (see Decisions).tendcf compile(every host by default,--hostfor one), replacingnix2cf buildfilewith no alias; the namenix2cfmoves to the Nix-module frontend (D12).change-process.mdloses the two-repo bump order and nix2cf's never-builttendcf.lock;site.lockloses only itsnix2cfentry. One tendcf rev is now the unit a site pins, and the docs name that coupling.nix2cf_services/nix2cf_edgeskeys (never real wire keys; the projected keys aretendcf_service/tendcf_interlock) becomepreview_services/preview_edges. No schema change.buildfileexists. Stale "only launchd adapter" text corrected: the systemd branch of the generic bundle exists. Fixture counts updated to 159 (125 schema-level, 6 byte-class, 28 projection).Files: the guide, the paper,
architecture-DEFINITIVE-v3.md,change-process.md,linux-targets.md,GLOSSARY.md,docs/architecture/README.md, newplugin-layout.md. No code, schema, fixture or path moves.Decisions (djbclark, 2026-11-13, on the reviews)
explain-hunk(D44) is compiler output and inherits plugin trust. The consent claim is now stated exactly in all five places: a plugin cannot make a device accept anything its own diff does not show, and cannot emit a shape the schema forbids, but it can make the goal file say something other than the Site Model says.contrib/'s lower bar waives support and maintenance promises, never the standing review rule. Out-of-tree trust establishment (OpenPGP web of trust,tendcf pluginmanagement): Plugins: OpenPGP web of trust and paseo-styletendcf pluginmanagement #47.tendcf pluginmanagement #47); the release'stargets.jsoncustomrecords the plugin set.unitis a closedoneOf, so an out-of-tree renderer could only shadow a built-in. Public groups:tendcf.frontends,tendcf.importers.tendcf compilereplacesnix2cf buildfileoutright, the Python package is renamedtendcf,bin/→tools/leaves no symlinks or wrappers and rewrites every path reference in every file, dated records included (djbclark, 2026-11-13: a one-time exception to their append-only convention; only paths change, and prose naming nix2cf as the old repository stays as history). (c) The compiler renders only the currentschema_version; older-version rendering is removed in the restructure; map §9.6's ceiling design stays and applies once the first non-operator device enrolls. (d)frdminc/nix2cfis archived as soon as Import nix2cf under compiler/ (history preserved) #45 merges: done 2026-11-13.Not in this PR
The restructure (one PR after #41/#42):
bin/→tools/, package rename totendcf, the plugin split,tendcf compile, removal of older-version rendering, the device-boundary import check.plugin-layout.md§5 states its rewrite scope and lists the files found. Historical records (handoffs, reviews, deprecated, dated opinions) are unchanged in this PR; the restructure rewrites their paths only.Verification
bin/schema_lint.py: OK (8 schemas, 125 negative, 6 byte-class, 28 projection fixtures).bin/xref_lint.py: 107 live documents, 0 findings. Both run throughbin/bgat the final head.git diff --checkclean.Review
Design ruling: two cross-model frontier reviews.
gpt-6-astra, high): "MERGE AFTER FIXES. The consolidation is sound; the plugin trust and reproducibility claims need bounded guarantees before this becomes implementation guidance."claude-fable-5-2, high): "Merge after fixes." Nothing argues against the fold itself.The two reviews do not disagree; Astra's A1/A2 and Fable's H1/H2 are the same two gaps seen from two sides. Resolution of every finding:
plugin-layout.md§4, D46 (4),change-process.md§6)targets.jsonrecords the plugin set) plus round-2 A2: the pin identifies sources; byte reproduction also needs a dependency/toolchain closure and controlled external inputs, not yet specified (plugin-layout.md§4, §7;change-process.md§3; guide §4)plugin-layout.md§4)buildfileis the compilation command,eval-nixa hook (plugin-layout.md§2, map Step 3,change-process.md§2)plugin-layout.md§4, D46 (5), change-process gate 2)plugin-layout.md§4, D46 (4))change-process.md§8 items 2 and 5, §9 item 2;plugin-layout.md§1; D46 (8))schema_versiononly; change-process sentences qualified; map §9.6 notetendcf.supervisorsnot a real extension pointplugin-layout.md§3)contrib/lower barsite.lockloses only itsnix2cfentry …" (change-process top note, plugin-layout §1)nix2cftendcf compilecompiles every host,--hostrenders one;eval-nixmoves to the Nix frontend; Bcfg2buildfilelineage kept in prose onlytendcf; directory mapping and schema-as-package-data listed in §7plugin-layout.md§5 states the rewrite scope (every path in every file, dated records included; prose stays) and lists the files found (incl. all ofcompiler/, schema descriptions, examples, AGENTS.md and its handoff rule, README, overlay, check.yml, canary check, D45)linux-targets.mdnames today'snix-instantiatehook beside the plannednix evalFix-round re-reviews (at
f2646cd)gpt-6-astra, high): "MERGE AFTER FIXES — reconcile the historical-path rewrite instructions and qualify the remaining reproducibility claim."claude-fable-5-2, high): "Merge after fixes." All 17 first-round findings resolved in substance; three text fixes left by the fix round.No disagreement between them (Astra A1 = Fable F1). All fixed in
b315772 (plus fd43679, a13e892):plugin-layout.md§5 item 5 and the AGENTS.md handoff-rule clause in item 4, §6 item 2, map D46 (6), GLOSSARY, this PR bodyplugin-layout.md§4 activation item 4 and §7,change-process.md§3 property 1, guide §4 "pure function"change-process.mdtop note, §2 table, §5, §6 compiler gate now "yes:compilerjob";plugin-layout.md§1, §2, §5; map §3, §5, Step 3, D46 (1), doc map; guide §2, §3, §4, §18 built list and Step 3; paper §2.1, §2.2; GLOSSARY). Remaining "move" wording names the restructure (§5 step 4)compiler/filescompiler/(README, DESIGN.md, pyproject.toml, sitemodel.py, examples, tests, package name)Lints at
b315772 (plus fd43679, a13e892)(throughbin/bg):bin/schema_lint.pyOK (8 schemas, 125 negative, 6 byte-class, 28 projection fixtures);bin/xref_lint.py107 live documents, 0 findings.Final check (head fd43679, then a13e892)
gpt-6-astra, high): merge. Fix-round A1 and A2 are resolved, and so are the original A1–A6. Nothing new in64994e3..fd43679. fd43679 also qualifies the paper's §2.2 purity sentence to match the guide (A2).claude-fable-5-2, high): merge. F1–F3 and N1–N4 are resolved, nothing new, and djbclark's decisions are recorded accurately. Its four non-blocking leftovers are fixed in a13e892: X1 (the paper's "nothing deployed" now names the operator-host canary), X2 (the purity caveat no longer says "with plugins"), X3 (two sentences reworded) and X4 (this body).Lints at a13e892:
bin/xref_lint.py0 findings;git diff --checkclean.🤖 Generated with Claude Code
Note
Low Risk
Documentation-only changes to architecture and process specs; no runtime code, schemas, or repository layout are modified in this PR.
Overview
Records operator decision D46 (2026-11-13): the compiler moves from archived
frdminc/nix2cfinto tendcf ascompiler/, with a future plugin layout (tools/,compiler/,plugins/,contrib/) and CLItendcf compilereplacingnix2cf buildfilewith no alias.nix2cfis redefined as the Nix module frontend plugin only.Adds
plugin-layout.mdand threads the ruling through the implementer map, change-process (dropnix2cffromsite.lock, two-repo bump order, andtendcf.lock; one tendcf pin; plugin activation/trust and release-gate separation), GLOSSARY, README, linux-targets, and the architecture guide and paper.Also renames illustrative
nix2cf_services/nix2cf_edgestopreview_services/preview_edges, and updates status text (e.g.buildfileand systemd bundle exist, 159 broken fixtures, canary deployment caveat)—no code, schema, or path moves in this PR.Reviewed by Cursor Bugbot for commit a13e892. Bugbot is set up for automated code reviews on this repo. Configure here.