Brummel/Aura
1
0
Fork 0
Code Issues 31 Pull Requests Actions Packages Projects Releases Wiki Activity

Document the Rust node-authoring pattern (ParamSpec/builder/roster) in the enumerated public docs #228

New Issue
Closed
opened 2026-07-10 14:34:16 +02:00 by Brummel · 0 comments
Brummel commented 2026-07-10 14:34:16 +02:00
Owner
Copy Link
Copy Source

Surfaced by the triage-harvest milestone fieldtest (2026-07-10). A downstream consumer restricted to the public surface (README, authoring-guide, glossary, ledger INDEX, --help, examples) cannot learn the Rust node-authoring pattern — declaring a param-bearing node (ParamSpec, the build closure reading p[i], rostering it into the project vocabulary). It is learnable today only from the aura new scaffold source plus project-layout.md, which the guide does not point to from its authoring path.

Direction (not prescriptive): a short "authoring a new node in Rust" section in the authoring-guide (the scaffold's Scale node as the worked example), cross-linked from the op-script section's vocabulary note.

context: milestone-fieldtest spec_gap finding.

Surfaced by the triage-harvest milestone fieldtest (2026-07-10). A downstream consumer restricted to the public surface (README, authoring-guide, glossary, ledger INDEX, --help, examples) cannot learn the Rust node-authoring pattern — declaring a param-bearing node (ParamSpec, the build closure reading p[i], rostering it into the project vocabulary). It is learnable today only from the `aura new` scaffold source plus project-layout.md, which the guide does not point to from its authoring path. Direction (not prescriptive): a short "authoring a new node in Rust" section in the authoring-guide (the scaffold's Scale node as the worked example), cross-linked from the op-script section's vocabulary note. context: milestone-fieldtest spec_gap finding.
Brummel added this to the Real-project readiness — role-complete research loop (no freeze) milestone 2026-07-10 17:16:15 +02:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
BLOCKER
Core functionality blocked; preempts other selection
 bug
Observable misbehaviour
 feature
Substantial extension; no full spec required
 idea
Droppable; no commitment
No Label
Milestone
No items
No Milestone Real-project readiness — role-complete research loop (no freeze)
Projects
Clear projects
No project
Assignees
Clear assignees
claude (Claude) Brummel
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Brummel/Aura#228
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?