specs/docs: system documentation as a declared .t27 document (7 chapters) + docs/system bodies + i18n docs-ru - #3555
Merged
Merged
Conversation
…ers) + docs/system bodies + i18n docs-ru Closes #3550 - specs/docs/system.t27 (docs_system) + specs/docs/chapters/<id>.t27 x7 - docs/system/<id>.md x7: English canonical prose, sections = SECTIONS - specs/i18n/docs-ru.t27: RU translation contract (bundle in trinity) - specs/docs/README.md, specs/OWNERS.md row docs/ -> Z-Zeta (+T-Queen), docs/README.md system/ row - docs/now entry; 9/9 typecheck ok under the vendored wasm, 0 discarded - records L1-L7 vs 'L1-L8', two loop statements, and missing tri git as discrepancies
…es; drop README.md and main.rs Closes #3550
…dead tri invocations check_documented_commands_exist reported dead tri mentions rising 141 -> 146: docs/system/queen.md:27,28,32,46 wrote the alphabet's Phase 7 as backticked `tri git ...` commands, and docs/system/layers.md:56 began a line with "tri card", which the anchored matcher reads as an invocation. The clap surface in cli/tri/src/main.rs has no git variant, so the prose now states the discrepancy instead of quoting a command a reader would copy: the phase is described as commit/push steps, with the witness that no such subcommand exists; the tool-card sentence is re-wrapped. The same rewrite is applied to the RU bundle in trinity (apps/website/i18n/docs.ru.json). MAX_DEAD_TRI is not raised. Closes #3550
Contributor
Contributor
|
📓 NotebookLM Notebook linked to this PR
This notebook contains session context, decisions, and artifacts for this work. |
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
1 participant
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.
Closes #3550
Stacked on #3548 (
feat/specs-tools). Merge order: #3546 -> #3548 -> this.What
specs/docs/system.t27(moduledocs_system,KIND = "docs"): CHAPTERS (7), SOURCES (10), DIAGRAMS (6), LOCALES (en,ru), ENABLED.specs/docs/chapters/<id>.t27x7 (docs_chapter_<id>,KIND = "docs-chapter"): DOCUMENT, ORDER, TITLE, SOURCES, SECTIONS, DIAGRAM, TABLE, BODY_EN, ENABLED. Chapters: project, rules, layers, alphabet, queen, tooling, evidence.docs/system/<id>.mdx7: English canonical prose (LANG-EN), ASCII only; every SECTIONS entry is a##heading in order (checked by the site generator).specs/i18n/docs-ru.t27(i18n_docs_ru): RU translation contract; the bundle istrinity:apps/website/i18n/docs.ru.json. No Cyrillic in this repo.specs/docs/README.md(schema, rules, "Where this lives":T27_ROOT/git rev-parse --show-toplevel),specs/OWNERS.mdrowdocs/-> Z-Zeta (+T-Queen forchapters/queen.t27),docs/README.mdsystem/row (DOCS-TREE),docs/now/2026-09-09-system-documentation-as-a-declared-t27-document.md.Witnesses
4d9c0447b5ca2887...): 9/9 typecheck ok, 0 discarded (system + 7 chapters + i18n).python3 tools/check_devhome_paths.py: no new offenders (theFAIL fixedlines are sparse-checkout absences, as in specs/tools: the tri CLI and the MCP servers as first-class .t27 specs (layer 5) #3548).PR_BASE_SHA=$(git rev-parse origin/master) GITHUB_BASE_REF=master python3 tools/check_now_entry_shape.py: OK.git cat-file -e).Recorded, not resolved
AGENTS.mdsection 5 says "L1-L8"; its table anddocs/T27-CONSTITUTION.mddefine L1-L7, no L8 exists. The prose documents seven laws and notes the discrepancy.CLAUDE.md's AEL v2.0 loop; both are stated, neither is reconciled.tri git(Phase 7) has no variant in the clapCommandsenum ofcli/tri/src/main.rs, sospecs/toolshas no card for it; marked[declared].Not claimed
masterwas not run against these files.gate-topologyanduntrusted-inputare the known pre-existing reds; not--blessed.Site side (generator
scripts/docs-from-specs.mjs,check:docs,#/docs, Queen moduleprojecton keyp): gHashTag/trinity, stacked on #978.Re-opened against master: #3551 was auto-closed when its base branch feat/specs-tools was deleted by the merge of #3554. Rebased onto master (same four commits, 0350fef).