Document the op-script grammar on the public surface (graph introspect / project-layout) #208

Closed
opened 2026-07-04 04:45:36 +02:00 by Brummel · 0 comments
Owner

Milestone fieldtest F8 (fieldtests/milestone-research-artifacts/FINDINGS.md): graph introspect surfaces node vocabulary and ports but not the op-list verbs (source/add/feed/connect/expose) or their JSON shape; graph build --help and docs/project-layout.md omit them too — an author cannot write the role-6a op-script from introspection alone (the corpus is the only teacher). Fix shape: document the op grammar (a --ops introspect mode, a worked example in docs/, or both). Sibling of the #197 docs half (worked process/campaign examples) — one docwriter pass covers both now that the surfaces are stable. context: role 6a shipped cycle 0088; orthogonal to the research-artifacts milestone.

Milestone fieldtest F8 (fieldtests/milestone-research-artifacts/FINDINGS.md): graph introspect surfaces node vocabulary and ports but not the op-list verbs (source/add/feed/connect/expose) or their JSON shape; graph build --help and docs/project-layout.md omit them too — an author cannot write the role-6a op-script from introspection alone (the corpus is the only teacher). Fix shape: document the op grammar (a --ops introspect mode, a worked example in docs/, or both). Sibling of the #197 docs half (worked process/campaign examples) — one docwriter pass covers both now that the surfaces are stable. context: role 6a shipped cycle 0088; orthogonal to the research-artifacts milestone.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Brummel/Aura#208