torbscript/language
Watch
1
0
Fork
You've already forked language
 0
Code Issues 139 Pull requests 2 Projects Releases 18 Packages 3 Wiki Activity Actions

Script receivers 6/6: migrate repository scripts and docs #517

New issue
Open
opened 2026-10-26 21:47:22 +00:00 by orion · 2 comments
orion commented 2026-10-26 21:47:22 +00:00
Collaborator
Copy link

Slice 7 of Design: docs/design/SCRIPT-RECEIVERS.md (branch docs/script-receivers). Part of the script-receivers epic.

Introduce and document the optional mapping; lands together with slices 2-4. Existing scripts keep working unmapped, so no migration of every script is required.

Scope

  • examples/config-dsl/project.trb: scripts "config.trb", receiver: "ServerConfig", from: "./src/server-config".
  • tests/conformance/project.trb: families for crossing/*.trb and the vm-only/ scripts (receivers are the Settings of each test program), where mapping pays; other scripts may stay unmapped.
  • Sandbox tests in compiler/tests (receivers.test.trb, sandbox.test.trb, reference.test.trb) cover both mapped (manifests with scripts) and unmapped scripts.
  • Guides: docs/language/configuration/, docs/how-to/write-a-configuration-file.md, docs/standard-library/sandbox.md, glossary; SCRIPTS.md (section 3 "the load decides") and PROJECT.md vocabulary table; regenerated skill docs.

Acceptance

  • Tier A gates green, incl. torb manifest --check and the docs --check gate.
  • Docs describe the mapping as optional and the fallback precisely (inference from literal loads, D18 on conflict, untyped otherwise); no doc says the first load decides.
  • SCRIPT-RECEIVERS.md status line updated to done.

Amended 2026-10-26 (owner): the scripts mapping is optional; unmapped scripts stay valid and are typed by inference from literal Sandbox.load calls, else untyped (SCRIPT-RECEIVERS.md sections 1, 5, 6).

Slice 7 of Design: `docs/design/SCRIPT-RECEIVERS.md` (branch `docs/script-receivers`). Part of the script-receivers epic. Introduce and document the optional mapping; lands together with slices 2-4. Existing scripts keep working unmapped, so no migration of every script is required. Scope - `examples/config-dsl/project.trb`: `scripts "config.trb", receiver: "ServerConfig", from: "./src/server-config"`. - `tests/conformance/project.trb`: families for `crossing/*.trb` and the `vm-only/` scripts (receivers are the `Settings` of each test program), where mapping pays; other scripts may stay unmapped. - Sandbox tests in `compiler/tests` (`receivers.test.trb`, `sandbox.test.trb`, `reference.test.trb`) cover both mapped (manifests with `scripts`) and unmapped scripts. - Guides: `docs/language/configuration/`, `docs/how-to/write-a-configuration-file.md`, `docs/standard-library/sandbox.md`, glossary; SCRIPTS.md (section 3 "the load decides") and PROJECT.md vocabulary table; regenerated skill docs. Acceptance - [ ] Tier A gates green, incl. `torb manifest --check` and the docs `--check` gate. - [ ] Docs describe the mapping as optional and the fallback precisely (inference from literal loads, D18 on conflict, untyped otherwise); no doc says the first load decides. - [ ] SCRIPT-RECEIVERS.md status line updated to done. Amended 2026-10-26 (owner): the `scripts` mapping is optional; unmapped scripts stay valid and are typed by inference from literal `Sandbox.load` calls, else untyped (SCRIPT-RECEIVERS.md sections 1, 5, 6).
orion commented 2026-10-26 21:47:52 +00:00
Author
Collaborator
Copy link

Design PR: #519 · Epic: #518

Design PR: https://git.torb.dev/torbscript/language/pulls/519 · Epic: https://git.torb.dev/torbscript/language/issues/518
orion commented 2026-10-29 12:58:16 +00:00
Author
Collaborator
Copy link

[loop:torbscript] intake: in scope (author orion, label loop), no duplicate, no collision with a design record (SCRIPT-RECEIVERS.md landed via #519), no owner question. Lands with slices 2-4 of epic #518 (#513 in review), so refine sequences it last. next: refine

[loop:torbscript] intake: in scope (author orion, label loop), no duplicate, no collision with a design record (SCRIPT-RECEIVERS.md landed via #519), no owner question. Lands with slices 2-4 of epic #518 (#513 in review), so refine sequences it last. next: refine
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
loop/705-default-shadow
loop/691-tensor-core
loop/705-fix-candidate
orion/456-tierb-probe
loop/164-measure2
loop/207-measure
loop/164-prototype
probe/207-count
loop/205-measure
loop/140-hide-staged
nightly-20261103
nightly-20261031
nightly-20261029
nightly-20261027
nightly-20261026
nightly-20261025
nightly-20261024
nightly-20261023
nightly-20261021
nightly-20261020
nightly-20261015
nightly-20261014
nightly-20261013
nightly-20261011
nightly-20261010
nightly-20261009
nightly-20261008
seeds
Labels
Clear labels   
loop
Backlog item of the project loop (Orion), see CONTRIBUTING

  
ready
Refined to the definition of ready

No labels
loop
ready
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
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#517
No description provided.