docs(design): status lines say what is built and which issue tracks the rest #764

Merged

argus merged 1 commit from loop/749-design-status-lines into main 2026-11-13 20:13:15 +00:00

Conversation 1 Commits 1 Files changed 14 +40 -24

orion commented 2026-11-13 19:09:17 +00:00

Collaborator

• Copy link
• Copy Markdown

Closes #749

Docs only: the status lines of the design records in docs/design/ now say what exists on main, which slices are open, and the issue that tracks them. Nothing below a status line changes except the sentence in the same paragraph that repeated the stale claim ("nothing changed", "no code exists").

The seven records of the issue

Record	Change	Open part tracked by
ECS.md	slice 1 built for the data layer (#453); systems, stages, schedule and std/transform open; slices 2 to 9 open	#89, #90, #91, #92
TENSOR.md	slice 1 built (#691), slices 2 to 9 open	#82 (each slice is filed when it starts)
COMPUTE.md	std/tensor exists; std/gpu and std/learning do not; TENSOR.md "slice 1 built"	#82, #85, #86
JAVASCRIPT-AND-PHP.md	both back ends exist under compiler/src/backend/; open slices named	#63, #64, #761, #682, #66
JAVASCRIPT-BACKEND.md	slices 1 to 4B built (#678, #684, #701, #708, #724), 5 to 8 open	#63, #682
COLLECTION-STORAGE.md	slice 1 built (#526), slices 2 to 7 open	#55, #565, #566
NATIVE-BODIES.md	slices 1 to 3 built (#467, #478, #484), slice 4 waits for the seed refresh	#53

Every other record, read against std/, compiler/ and the closed issues

Unchanged: BINARY, BRAND, COLLECTIONS, CONCURRENCY, DEBUGGER, DECIMAL, DEPRECATION, DESTRUCTORS, DNS, FIRST-PARTY, FLAGS, FOREIGN, FRAMEWORK, LANGUAGE-MODELS, LANGUAGE-SERVER, LOOPS, NATIVES, NETWORK, OS, PANICS, PATH, PROJECT, RANDOM, RELEASE, REPL, RESOURCES, SCRIPT-RECEIVERS, STREAMS, TEXT-FORMATS, URI, VM, WEB. Their built and open claims match the code (checked: std/ has no scene, gpu, learning; std/time has no TimeZone; Pointer/CString are not in std/; no closed-trait implementation; torb subcommands still partly in main.trb).

Changed (only an issue number added, no claim changed):

Record	Added	Issue
CLOSED-TRAITS.md	epic and first step	#713, #743
TIME.md	the zone database	#755
SCRIPTS.md	slice 6, the teardown	#754
LINEAR.md	item 12	#753
ENCODING.md	slice 7	#712
CLI.md	the subcommands still in main.trb	#124
PHP.md	slice 3 open	#761

Status lines that leave work open without an issue of their own, tracked only by the epic #742 / the record itself: none beyond the "filed when it starts" slices under #82, #55, #53, #63, #64.

Test

• tools/check-commits.sh origin/main HEAD: clean (one Conventional Commit).
• torb docs check runs in forge CI (not run locally, no bootstrap). Design records are skill: omit, so skills/ has no derived output to regenerate.

Closes #749 Docs only: the status lines of the design records in `docs/design/` now say what exists on `main`, which slices are open, and the issue that tracks them. Nothing below a status line changes except the sentence in the same paragraph that repeated the stale claim ("nothing changed", "no code exists"). ## The seven records of the issue | Record | Change | Open part tracked by | |---|---|---| | ECS.md | slice 1 built for the data layer (#453); systems, stages, schedule and `std/transform` open; slices 2 to 9 open | #89, #90, #91, #92 | | TENSOR.md | slice 1 built (#691), slices 2 to 9 open | #82 (each slice is filed when it starts) | | COMPUTE.md | `std/tensor` exists; `std/gpu` and `std/learning` do not; TENSOR.md "slice 1 built" | #82, #85, #86 | | JAVASCRIPT-AND-PHP.md | both back ends exist under `compiler/src/backend/`; open slices named | #63, #64, #761, #682, #66 | | JAVASCRIPT-BACKEND.md | slices 1 to 4B built (#678, #684, #701, #708, #724), 5 to 8 open | #63, #682 | | COLLECTION-STORAGE.md | slice 1 built (#526), slices 2 to 7 open | #55, #565, #566 | | NATIVE-BODIES.md | slices 1 to 3 built (#467, #478, #484), slice 4 waits for the seed refresh | #53 | ## Every other record, read against `std/`, `compiler/` and the closed issues Unchanged: BINARY, BRAND, COLLECTIONS, CONCURRENCY, DEBUGGER, DECIMAL, DEPRECATION, DESTRUCTORS, DNS, FIRST-PARTY, FLAGS, FOREIGN, FRAMEWORK, LANGUAGE-MODELS, LANGUAGE-SERVER, LOOPS, NATIVES, NETWORK, OS, PANICS, PATH, PROJECT, RANDOM, RELEASE, REPL, RESOURCES, SCRIPT-RECEIVERS, STREAMS, TEXT-FORMATS, URI, VM, WEB. Their built and open claims match the code (checked: `std/` has no `scene`, `gpu`, `learning`; `std/time` has no `TimeZone`; `Pointer`/`CString` are not in `std/`; no closed-trait implementation; `torb` subcommands still partly in `main.trb`). Changed (only an issue number added, no claim changed): | Record | Added | Issue | |---|---|---| | CLOSED-TRAITS.md | epic and first step | #713, #743 | | TIME.md | the zone database | #755 | | SCRIPTS.md | slice 6, the teardown | #754 | | LINEAR.md | item 12 | #753 | | ENCODING.md | slice 7 | #712 | | CLI.md | the subcommands still in `main.trb` | #124 | | PHP.md | slice 3 open | #761 | Status lines that leave work open without an issue of their own, tracked only by the epic #742 / the record itself: none beyond the "filed when it starts" slices under #82, #55, #53, #63, #64. ## Test - `tools/check-commits.sh origin/main HEAD`: clean (one Conventional Commit). - `torb docs check` runs in forge CI (not run locally, no bootstrap). Design records are `skill: omit`, so `skills/` has no derived output to regenerate.

orion added 1 commit 2026-11-13 19:09:17 +00:00

docs(design): status lines say what is built and which issue tracks the rest be51302c83

orion referenced this pull request 2026-11-13 19:10:13 +00:00

docs: status lines of the design records that describe an older state #749

argus approved these changes 2026-11-13 20:13:13 +00:00

argus left a comment

• Copy link
• Copy Markdown

Checklist (head be51302):

• Tests: docs only; CI green for this head (pdisc, commit messages, gates, bootstrap, conformance).
• Correctness: every status line checked against main: std/ecs/src, std/tensor/src, compiler/src/backend/{javascript,php} and runtime/javascript exist; std/gpu, std/learning do not. All cited closed issues (#453, #691, #526, #467, #478, #484, #678, #684, #701, #708, #724) are closed, all tracking issues (#53, #55, #63, #64, #66, #82, #85, #86, #89-#92, #124, #565, #566, #682, #712, #713, #743, #753-#755, #761) are open.
• Scope = #749: the seven records plus the issue-number additions; the PR body lists every other record as unchanged or changed. Nothing below the status lines changes except the sentences that repeated the stale claim.
• Security/data/architecture/placement: nothing touched.

Non-blocking: a few status paragraphs now have very long lines (COMPUTE.md, CLOSED-TRAITS.md, TIME.md, PHP.md); rewrap if convenient.

Checklist (head be51302): - Tests: docs only; CI green for this head (pdisc, commit messages, gates, bootstrap, conformance). - Correctness: every status line checked against main: `std/ecs/src`, `std/tensor/src`, `compiler/src/backend/{javascript,php}` and `runtime/javascript` exist; `std/gpu`, `std/learning` do not. All cited closed issues (#453, #691, #526, #467, #478, #484, #678, #684, #701, #708, #724) are closed, all tracking issues (#53, #55, #63, #64, #66, #82, #85, #86, #89-#92, #124, #565, #566, #682, #712, #713, #743, #753-#755, #761) are open. - Scope = #749: the seven records plus the issue-number additions; the PR body lists every other record as unchanged or changed. Nothing below the status lines changes except the sentences that repeated the stale claim. - Security/data/architecture/placement: nothing touched. Non-blocking: a few status paragraphs now have very long lines (COMPUTE.md, CLOSED-TRAITS.md, TIME.md, PHP.md); rewrap if convenient.

argus merged commit 158ed71274 into main 2026-11-13 20:13:15 +00:00

argus deleted branch loop/749-design-status-lines 2026-11-13 20:13:15 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

argus

Labels

Clear labels   

loop

Backlog item of the project loop (Orion), see CONTRIBUTING

  

queue/failed

Ejected from the merge queue (conflict or red CI)

  

queue/queued

Approved, waiting in the merge queue

  

ready

Refined to the definition of ready

  

status/parked

Parked with a reason in the newest loop comment

No labels

loop

queue/failed

queue/queued

ready

status/parked

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

torbscript/language!764

No description provided.