Document the op-script grammar; refresh the stale cycle-0088 example #163

New Issue

2026-06-30T14:36:27+02:00

Brummel commented

2026-06-30 14:36:27 +02:00

The construction op-script (aura graph build) has no durable public schema doc — not in the design ledger, the glossary, a README, or a --help. A downstream consumer must reverse-engineer the op-list grammar (the verbs source/add/feed/connect/expose and their keys).

Validated in the 2026-06-30 milestone fieldtest (fieldtests/milestone-topology-as-data/): the only worked example is the cycle-0088 fixture corpus (fieldtests/cycle-0088-construction-op-script/), which still uses the retired as key for add. Replaying it verbatim against the current binary fails — add's naming key was renamed as -> name (commit 3c4b667), so the old key is ignored, the node is left unnamed, and a later reference breaks (op 2 (add): duplicate identifier "sma"). A consumer copying the visible example is misled.

Verified current grammar: add names a node with name; expose retains as for its boundary alias (crates/aura-cli/src/graph_construct.rs).

Acceptance:

The op-script grammar — verbs, keys, and the typed-Scalar bind form ({"length":{"I64":2}}) — is documented in a durable public place (the C24 ledger entry or aura graph build --help).
The cycle-0088 example corpus is refreshed to the current name key, or clearly date-stamped as pre-rename so a consumer is not misled.

The construction op-script (`aura graph build`) has no durable public schema doc — not in the design ledger, the glossary, a README, or a `--help`. A downstream consumer must reverse-engineer the op-list grammar (the verbs `source`/`add`/`feed`/`connect`/`expose` and their keys). Validated in the 2026-06-30 milestone fieldtest (`fieldtests/milestone-topology-as-data/`): the only worked example is the cycle-0088 fixture corpus (`fieldtests/cycle-0088-construction-op-script/`), which still uses the retired `as` key for `add`. Replaying it verbatim against the current binary fails — `add`'s naming key was renamed `as` -> `name` (commit `3c4b667`), so the old key is ignored, the node is left unnamed, and a later reference breaks (`op 2 (add): duplicate identifier "sma"`). A consumer copying the visible example is misled. Verified current grammar: `add` names a node with `name`; `expose` retains `as` for its boundary alias (`crates/aura-cli/src/graph_construct.rs`). Acceptance: - [ ] The op-script grammar — verbs, keys, and the typed-`Scalar` bind form (`{"length":{"I64":2}}`) — is documented in a durable public place (the C24 ledger entry or `aura graph build --help`). - [ ] The cycle-0088 example corpus is refreshed to the current `name` key, or clearly date-stamped as pre-rename so a consumer is not misled.

Brummel added the idea label 2026-06-30 14:36:27 +02:00

Brummel referenced this issue from a commit

2026-06-30 15:31:28 +02:00

audit(0090): cycle + C24 milestone close — fieldtest green; ledger + rm ephemeral spec/plan

Brummel referenced this issue from a commit

2026-06-30 16:07:42 +02:00

docs(0088): document op-script grammar; refresh stale cycle-0088 example corpus

Brummel closed this issue

2026-06-30 16:07:42 +02:00

Sign in to join this conversation.