@sjawhar/pi-envoy 16.40.0 → 16.41.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,24 +14,23 @@ Dispatch is a record for the people who decide, never a log of your work.
14
14
 
15
15
  ## Asks and ask blocks
16
16
 
17
- - A design question a document records is an ask block (a decision block) at the end of its section:
17
+ - An ask is a question for a person, never a request to another agent. Ask an agent by envoy_send or a comment on the issue.
18
+ - An ask waits on the issue's assignee until a person hands it on. No agent can hand one on.
19
+ - A design question a document records is an ask block at the end of its section:
18
20
 
19
21
  ```md
20
22
  :::ask{urgency="med"}
21
- The question and the recommendation, as `skill://dispatch-writing-specs` writes them.
23
+ The question and the recommendation (`skill://dispatch-writing-specs`).
22
24
 
23
25
  - Option one: what it costs.
24
26
  - Option two: what it costs.
25
27
  :::
26
28
  ```
27
29
 
28
- - An ask is short and asks one thing; its reasoning goes in the document.
29
- - An open ask is the request; never repeat it per message.
30
- - Change an open ask's block with `dispatch edit-ask`, or `doc-edit`'s `replace` or `move`. An answered ask is fixed: ask anew.
30
+ - Never repeat an open ask in a message.
31
+ - Change an open ask's block with `dispatch edit-ask` (its ask id), or `doc-edit`'s `replace` or `move` (its block id). An answered ask is fixed: ask anew. `dispatch read --ref` takes either id.
31
32
  - Reply on an open ask with `dispatch comment --reply-to-ask`; `--turn agent` (a progress note) needs it. An approval request a newer version moved needs `request-approval` again.
32
33
  - When an answer's option and text disagree, the text wins.
33
- - An ask block has a block id, for `doc-edit`, and an ask id, for the ask commands. `dispatch read --ref dispatch://KEY/ask/<id>` takes either.
34
- - An ask reaches the issue's assignee; if none, name who answers.
35
34
 
36
35
  ## Choosing what to work on
37
36
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sjawhar/pi-envoy",
3
- "version": "16.40.0",
3
+ "version": "16.41.1",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "omp": {