nsaspy/zara
1
0
Fork 0
Code Issues 95 Pull requests 18 Projects Releases Packages Wiki Activity Actions

docs(rage): freeze IntentFrame v1 contract (research, design, migration map) #287

Closed
nsaspy wants to merge 0 commits from rage/154-intentframe-contract into master
pull from: rage/154-intentframe-contract
merge into: nsaspy:master
Conversation 0 Commits - Files changed -
nsaspy commented 2026-09-04 22:44:11 +00:00
Owner
Copy link

Closes #154.

Consumed issue #154 (P1, parent epic #150) at RAGE start commit 0661a2d. Auto-RAGE deliverables:

  • Normative contract — docs/intentframe-contract.md: IntentFrame v1 (frame/3 compounds + typed slot values, status algebra complete/missing/ambiguous/invalid/cancelled/superseded, single normalized serializer with versioned JSON mirror, semantic-vs-correlation metadata split). Includes all 13 required examples: complete timer, bare timer → missing duration, follow-up duration, correction with supersedes, cancellation, open app, bare open, text missing message, server search, device screenshot, server memory query, unavailable capability, same-input/different-platform-availability.
  • Research artifact — rage/154-intentframe-research.org: the mandatory intent-path audit with file:line evidence (five divergent verb authorities, stateless pending/1 with no slot-fill loop, daemon path lacking Prolog authority while its prompt demands it, execution split wake-vs-Prolog, four dialogue-state owners, no intent plane on the wire, ASCII tokenizer deleting non-ASCII, PySWIP marshalling fragility, dead kb/config.kb, PR #119 capability prior art); primary-source research (Alexa dialog/slot model; Trealla dict support refuted empirically → compounds+lists only); answers to all research questions; adversarial counterexamples; explicit rejection of raw args lists, arbitrary JSON bodies, prompt-managed clarification, global pending stores, and direct shell/provider strings.
  • Design artifact — rage/154-intentframe-design.org: decisions D1-D8, invariants, lifecycle/state ownership table, threat/failure analysis, complete migration map from every current intent path/result shape, and the acceptance-criteria → owning-issue → test matrix (A1-A9) for #155/#156/#157/#172/#173.

No production implementation in this slice (issue acceptance rule). Docs + RAGE artifacts only; full suite and nix flake check green at candidate head.

Closes #154. Consumed issue #154 (P1, parent epic #150) at RAGE start commit 0661a2d. Auto-RAGE deliverables: - **Normative contract** — `docs/intentframe-contract.md`: IntentFrame v1 (frame/3 compounds + typed slot values, status algebra complete/missing/ambiguous/invalid/cancelled/superseded, single normalized serializer with versioned JSON mirror, semantic-vs-correlation metadata split). Includes all 13 required examples: complete timer, bare timer → missing duration, follow-up duration, correction with supersedes, cancellation, open app, bare open, text missing message, server search, device screenshot, server memory query, unavailable capability, same-input/different-platform-availability. - **Research artifact** — `rage/154-intentframe-research.org`: the mandatory intent-path audit with file:line evidence (five divergent verb authorities, stateless pending/1 with no slot-fill loop, daemon path lacking Prolog authority while its prompt demands it, execution split wake-vs-Prolog, four dialogue-state owners, no intent plane on the wire, ASCII tokenizer deleting non-ASCII, PySWIP marshalling fragility, dead kb/config.kb, PR #119 capability prior art); primary-source research (Alexa dialog/slot model; Trealla dict support refuted empirically → compounds+lists only); answers to all research questions; adversarial counterexamples; explicit rejection of raw args lists, arbitrary JSON bodies, prompt-managed clarification, global pending stores, and direct shell/provider strings. - **Design artifact** — `rage/154-intentframe-design.org`: decisions D1-D8, invariants, lifecycle/state ownership table, threat/failure analysis, complete migration map from every current intent path/result shape, and the acceptance-criteria → owning-issue → test matrix (A1-A9) for #155/#156/#157/#172/#173. No production implementation in this slice (issue acceptance rule). Docs + RAGE artifacts only; full suite and nix flake check green at candidate head.
nsaspy closed this pull request 2026-09-04 23:08:54 +00:00
Some checks failed
CI / test (pull_request) Failing after 5s
Details
CI / android skeleton gate (pull_request) Failing after 4s
Details
CI / shared mic / Arch Linux (pull_request) Failing after 6m24s
Details
CI / shared mic / Ubuntu 24.04 (pull_request) Failing after 5m28s
Details

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
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
nsaspy/zara!287
No description provided.