@raidiant/notifai 11.3.1 → 11.3.2

package/CHANGELOG.md

@@ -8,6 +8,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
 
+## [11.3.2](https://github.com/Raidiant-io/notifai/compare/v11.3.1...v11.3.2) (2026-09-23)
+
+
+### Bug Fixes
+
+* register owned user questions through notifai ([#190](https://github.com/Raidiant-io/notifai/issues/190)) ([c6fa124](https://github.com/Raidiant-io/notifai/commit/c6fa1249dee02d9e90c7c855c86a0c13a5bb08fe))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @raidiant/notifai-protocol bumped from 8.0.2 to 8.0.3
+
 ## [11.3.1](https://github.com/Raidiant-io/notifai/compare/v11.3.0...v11.3.1) (2026-09-23)
 
 

package/dist/guidance-content.js

@@ -41,26 +41,23 @@ Notify when something changed for the user:
 - Substantial autonomous work finished — succeeded or failed. Work is
   substantial when it required multiple meaningful investigation, editing,
   build, test, deployment, or coordination steps.
-- Work cannot proceed: ask an answerable question when continuing needs a User
-  response; send a one-way blocked notification only when no User reply would
-  resume the work.
+- Work you own or coordinate needs a User response: ask an answerable question
+  through Notifai, even while other work continues or the User was recently
+  active. The question itself is a Notification Request; conversation alone
+  does not reach an away User. One-way blocked is only for work no User reply
+  would resume.
 - You found something that needs their attention soon.
-- The User requested something through Notifai: return the requested answer,
-  result, or actionable artifact through Notifai, even for a small task. Make
-  it self-contained; do not assume the User is at their machine.
+- The User requested something through Notifai: return the answer, result, or
+  actionable artifact through Notifai, even for a small task. Make it
+  self-contained; do not assume the User is at their machine.
 
-Never notify for:
-
-- Routine progress: starting, still working, one more subtask done.
-- A problem you hit and fixed yourself.
+Never notify for routine progress or a problem you fixed yourself.
 
 Completion of substantial work is an outcome, not routine progress.
-A requested audit or diagnosis that resolves the user's uncertainty through
-several distinct checks counts as substantial even when the result is clean
-and needs no further action.
+A requested audit or diagnosis resolving uncertainty through several distinct
+checks counts as substantial even when clean.
 
-One notification per event. When a status changes, replace your stale
-notification rather than stacking a new one.
+One notification per event. Replace stale status instead of stacking it.
 `;
 const TITLES = `# Titles
 
@@ -143,33 +140,29 @@ terminal for details".
 `;
 const QUESTIONS = `# Questions
 
-When work needs a User response before it can continue, ask an answerable
-question. A one-way blocked Notification Request is only for work that no User
-reply would resume. If the User must act and then tell you it is ready, that
-readiness is an answer — ask for it.
+When work you own or coordinate needs a User response, the answerable question
+itself is a Notification Request. Register it with \`notifai ask\` in the same
+turn you ask in the conversation, even while other work continues or the User
+was recently active. Conversation alone does not reach an away User.
+
+Decisions, approvals, sign-in, credential setup and physical actions count.
+Ask for safe setup or readiness, never for credentials or other private
+material. Readiness is an answer. Harness permission prompts and interactive
+pickers stay in the harness. One-way blocked is only for work no User reply
+would resume.
 
-A question is answerable from the notification alone, in the user's terms, not
-the machinery's. Its one askable sentence is the Summary. Put reasoning and
-stakes in an optional standalone Markdown Body when they are needed.
-Offer closed choices whose wording carries its own consequence.
+Make it answerable from the notification alone. The Summary asks one question;
+optional standalone Markdown Body adds reasoning and stakes. Closed choices
+carry their own consequence.
 
 Good:
 
-- \`The schema change is ready. It touches live order data — deploy now or
-  wait for off-peak?\` with choices \`Deploy now\` / \`Wait for off-peak\`
-- \`The API key in .env.example is live. Revoke it now, or wait until the
-  replacement is provisioned?\` with \`Revoke now\` / \`Wait for the new key\`
 - \`Is the test device unlocked and ready for the install?\` with
   \`Ready — install now\` / \`Not yet — wait\`
 
 Bad:
 
 - \`What should I do?\` — nothing to answer without the terminal
-- \`Deploy to staging and notify the team?\` with \`Yes\` / \`No\` — two
-  decisions, one answer
-- \`Retry with --force-with-lease?\` — machinery; the real decision is
-  \`Overwrite the remote branch, or keep both versions?\`
-- Choices \`Option A\` / \`Option B\` — labels that point back into the body
 - \`Reply here with your choice\` — never name where the answer must arrive
 `;
 const ACKNOWLEDGEMENTS = `# Acknowledgements

package/dist/guidance-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"guidance-content.js","sourceRoot":"","sources":["../src/guidance-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;4DAawB,CAAA;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;gEAI4B,CAAA;AAEhE,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BtB,CAAA;AAED,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBd,CAAA;AAED,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDf,CAAA;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BjB,CAAA;AAED,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,cAAc;KACxB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,MAAM;KAChB;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,4DAA4D;QACrE,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,SAAS;KACnB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,gBAAgB;KAC1B;CACF,CAAA;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA+BJ,CAAA"}
+{"version":3,"file":"guidance-content.js","sourceRoot":"","sources":["../src/guidance-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;4DAawB,CAAA;AAE5D,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;gEAI4B,CAAA;AAEhE,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAA;AAED,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBd,CAAA;AAED,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDf,CAAA;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB,CAAA;AAED,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD;QACE,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,cAAc;KACxB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,qCAAqC;QAC9C,OAAO,EAAE,MAAM;KAChB;IACD;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,4DAA4D;QACrE,OAAO,EAAE,OAAO;KACjB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,SAAS;KACnB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,kCAAkC;QAC3C,OAAO,EAAE,gBAAgB;KAC1B;CACF,CAAA;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC9D,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA+BJ,CAAA"}

package/dist/session-activation.js

@@ -1,7 +1,8 @@
 import { Buffer } from 'node:buffer';
 import { GUIDANCE_CONTEXT_MAX_BYTES, boundedEffectiveGuidance } from './guidance-render.js';
-const ROOT_OWNERSHIP = 'Notifai is enabled for this Project. The effective, provenance-marked guidance below governs Notification Requests. ' +
-    'Missing CLI readiness is handled through `notifai init --json`.';
+const ROOT_OWNERSHIP = 'Notifai is enabled for this Project. You own Notification Requests unless explicitly assigned elsewhere. Load the Notifai skill before your first Notification Request. ' +
+    'Follow the effective guidance below. Under it, when owned or coordinated work needs a User decision, approval, sign-in, credential setup or physical action, register with `notifai ask` in the same turn as the conversation question; conversation alone misses an away User. Ask for safe setup or readiness, never for credentials. Harness permission prompts stay in the harness. ' +
+    'Missing readiness: `notifai init --json`.';
 export const WORKER_ACTIVATION_CONTEXT = 'Notifai worker context: an Agent Event is a meaningful occurrence in your work; a Notification Request is a deliberate User-visible message about one. Report Agent Events to the parent and do not send Notification Requests unless the parent explicitly delegated that ownership. If delegated, load the Notifai skill and run `notifai guidance` before composing one.';
 export const MISSING_LIFECYCLE_GUIDANCE_CONTEXT = 'Notifai lifecycle guidance could not be loaded, so Project Enablement is unverified. Run `notifai init --json` to check setup, then `notifai guidance` before deciding whether or how to send a Notification Request.';
 function rootActivationContext(cwd, env, notice) {

package/dist/session-activation.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-activation.js","sourceRoot":"","sources":["../src/session-activation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAE3F,MAAM,cAAc,GAClB,sHAAsH;IACtH,iEAAiE,CAAA;AAEnE,MAAM,CAAC,MAAM,yBAAyB,GACpC,6WAA6W,CAAA;AAE/W,MAAM,CAAC,MAAM,kCAAkC,GAC7C,uNAAuN,CAAA;AAEzN,SAAS,qBAAqB,CAAC,GAAW,EAAE,GAAsB,EAAE,MAAe;IACjF,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,OAAO,MAAM,EAAE,CAAA;IACxF,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,GAAG;QACH,GAAG;QACH,QAAQ,EAAE,0BAA0B,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,MAAM,EAAE,MAAM,CAAC;KACnF,CAAC,CAAA;IACF,OAAO,GAAG,OAAO,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAA;AAC9E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,aAA+C,EAC/C,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,MAAe;IAEf,MAAM,OAAO,GAAG,aAAa,KAAK,eAAe;QAC/C,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IAC3C,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,OAAO,CAAA;IACpE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,kBAAkB,EAAE;gBAClB,aAAa;gBACb,iBAAiB,EAAE,OAAO;aAC3B;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,OAAe;IAEf,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,OAAO,CAAA;IACpE,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAA;IAChF,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,kBAAkB,EAAE;gBAClB,aAAa,EAAE,kBAAkB;gBACjC,iBAAiB,EAAE,OAAO;aAC3B;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,MAAe;IAEf,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,gBAAgB,EAAE,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;KAC1D,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"session-activation.js","sourceRoot":"","sources":["../src/session-activation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAE3F,MAAM,cAAc,GAClB,0KAA0K;IAC1K,0XAA0X;IAC1X,2CAA2C,CAAA;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GACpC,6WAA6W,CAAA;AAE/W,MAAM,CAAC,MAAM,kCAAkC,GAC7C,uNAAuN,CAAA;AAEzN,SAAS,qBAAqB,CAAC,GAAW,EAAE,GAAsB,EAAE,MAAe;IACjF,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,OAAO,MAAM,EAAE,CAAA;IACxF,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,GAAG;QACH,GAAG;QACH,QAAQ,EAAE,0BAA0B,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,MAAM,EAAE,MAAM,CAAC;KACnF,CAAC,CAAA;IACF,OAAO,GAAG,OAAO,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAA;AAC9E,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,aAA+C,EAC/C,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,MAAe;IAEf,MAAM,OAAO,GAAG,aAAa,KAAK,eAAe;QAC/C,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IAC3C,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,OAAO,CAAA;IACpE,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,kBAAkB,EAAE;gBAClB,aAAa;gBACb,iBAAiB,EAAE,OAAO;aAC3B;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,uBAAuB,CACrC,OAAgC,EAChC,OAAe;IAEf,IAAI,OAAO,KAAK,UAAU,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,OAAO,CAAA;IACpE,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAA;IAChF,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,kBAAkB,EAAE;gBAClB,aAAa,EAAE,kBAAkB;gBACjC,iBAAiB,EAAE,OAAO;aAC3B;SACF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAc,OAAO,CAAC,GAAG,EAAE,EAC3B,MAAyB,OAAO,CAAC,GAAG,EACpC,MAAe;IAEf,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,gBAAgB,EAAE,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC;KAC1D,CAAC,CAAA;AACJ,CAAC"}

package/dist/skill-source/manifest.json

@@ -1,12 +1,12 @@
 {
   "schema_version": 1,
-  "package_version": "11.3.1",
+  "package_version": "11.3.2",
   "skill": "notifai",
-  "digest": "sha256:9c172bbc3bbd127dab05b135a6172e446699bfe4b78a0e7d88802049c94011bb",
+  "digest": "sha256:6b5b2a43d5798a8d6095e3884046aeb0e6758fc9211a07c6130e01e99edd00d3",
   "files": [
     {
       "path": "SKILL.md",
-      "sha256": "99c919520d43c785e8fb7e108ae8dbec702a48d89ebde8ecea50b98f0ce1ae5c"
+      "sha256": "7769c166269c9612bd3fdfc24fe2d884321f68959c999f109a18d82a41a01803"
     },
     {
       "path": "references/harness-setup.md",

package/dist/skill-source/notifai/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: notifai
-description: Use Notifai proactively in every agent session that owns User-visible Notification Requests, even when the user does not mention it. The parent owns by default; use it in a worker only when ownership is explicitly delegated. Read guidance.
+description: Use when work needs a User decision, approval, sign-in, credential setup or physical action, or substantial work finishes or fails, even if the User was recently active or does not mention Notifai. For Notification Request owners; parent owns by default, workers only by explicit delegation. Read guidance.
 ---
 
 # Notifai
@@ -112,9 +112,8 @@ saved config from inventing a Project and never enables one.
 
 **Declare the kind that is true**: it decides how insistently the notification lands.
 
-Work needs a User response to continue? Ask an answerable question — even if
-blocked. Use one-way blocked only when no User reply would resume the work.
-Reporting ready is a response.
+Work needs a User response? [Ask an answerable question](#ask-a-question).
+Use one-way blocked only when no User reply would resume the work.
 
 `titles` and `content` guidance own each field. The wire shape:
 
@@ -160,54 +159,56 @@ the active harness proves the exact current Agent Session.
 
 ## Ask a question
 
-A question must be answerable from the notification itself. The positional
-question is its Summary (under 240 characters) and supplies the notification
-title. Put reasoning in the optional standalone Markdown Body. Offer 2-6 closed choices, one
-flag per choice — commas inside a label are literal. A typed answer is always
-possible; closed choices appear after pressing and holding the notification.
+Make the question answerable from the notification itself. The positional
+question is its Summary (under 240 characters) and title. Body adds standalone
+Markdown reasoning. Offer 2-6 closed choices, one flag each; commas are literal.
+Typed answers are always possible; closed choices appear after pressing and
+holding the notification.
 
-For both `ask` and `send --reply`, the Summary is the exact answerable question.
-Notifai never infers or truncates it from Body.
+For `ask` and `send --reply`, Summary is the exact question, never inferred or
+truncated from Body.
 
 ### Default: resume when they answer
 
-When work needs a User response before it can continue, use `ask`. It preserves
-the exact return path for the complete answer window without making the
-foreground command its owner:
+When work you own or coordinate needs a User response, use `notifai ask` in the
+same turn as its conversation question, even while other work continues or after
+recent User activity; conversation alone misses an away User.
+Ask for safe setup or readiness, never credentials. Harness permission prompts
+and interactive pickers stay in the harness.
+
+`ask` keeps the exact return path for the complete answer window:
 
 ```bash
 notifai ask "Which environment should I roll out to?" \
   --choice Staging --choice Production --choice Cancel
 ```
 
-Add `--json` for choice ids and the `question_id`.
+`--json` returns choice ids and `question_id`.
 
 `registered: true` is local only. It has not yet been submitted as a
 Notification Request and has no Provider Acceptance. Never call a question sent
-or delivered from registration alone. Settlement preserves its `question_id` and adds a
-`request_id`. Inspect without changing it:
+or delivered from registration alone. Settlement adds `request_id`, keeping
+`question_id`. Inspect:
 
 ```bash
 notifai status <question_id> --json
 ```
 
-State is `local`, `frozen`, `live`, `answered`, `withdrawn`, or `retired`;
-promoted questions also show downstream evidence.
+States: `local`, `frozen`, `live`, `answered`, `withdrawn`, `retired`.
 
 **Registering is not the end of the turn.** In that same turn, ask the question
 in the conversation and say what each answer will make you do, then end your
 turn to start submission. Ordinary sends need no turn boundary. Continue
 independent work in later turns; preserve supervision.
 
-**Never say where the answer must arrive:** not "tell me here" or "type it at
-this prompt". The route is the harness's concern.
+**Never say where the answer must arrive** ("tell me here"). The harness owns routing.
 
-Other surfaces: `--multi` combines answers; `--body`/`--body-file` adds Body;
-`--image`/`--image-alt` adds evidence; `--form <path|->` groups up to 10
-questions and requires a set-level `summary`.
+Use `--multi` for combined answers, `--body`/`--body-file` for Body,
+`--image`/`--image-alt` for evidence, or `--form <path|->` for up to 10 questions
+with a set-level `summary`.
 
-Keep independent questions as separate `ask` calls. Retire a registration
-that is obsolete or that they answer in the conversation with
+Register independent questions separately. Retire an obsolete registration or
+one they answer in the conversation with
 `notifai close <question_id>` or `notifai close --pending`.
 
 Keep every ID after a timeout or unavailable route. Inspect the original with

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raidiant/notifai",
-  "version": "11.3.1",
+  "version": "11.3.2",
   "type": "module",
   "description": "Send native device notifications from agents and local programs",
   "bin": {
@@ -12,7 +12,7 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@raidiant/notifai-protocol": "8.0.2",
+    "@raidiant/notifai-protocol": "8.0.3",
     "commander": "^14.0.0",
     "picocolors": "^1.1.1",
     "smol-toml": "^1.4.0"