@sjawhar/pi-envoy 16.49.0 → 16.49.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.
package/dist/dispatch.js
CHANGED
|
@@ -15166,7 +15166,7 @@ function imagesArgument(z, owner) {
|
|
|
15166
15166
|
var ASK_URGENCIES = ["low", "med", "high", "blocking"];
|
|
15167
15167
|
var DISPATCH_BLOCK_UNITS = 32000;
|
|
15168
15168
|
var DISPATCH_ITEM_BLOCKS = 32768;
|
|
15169
|
-
var BODY_BLOCK_RULE = `Each block (a paragraph, list, quote, table or code block) holds at most ${DISPATCH_BLOCK_UNITS} ` + `characters and a body at most ${DISPATCH_ITEM_BLOCKS} blocks; Dispatch refuses a longer one and ` + "names it, and `dispatch limits` prints the bounds.";
|
|
15169
|
+
var BODY_BLOCK_RULE = `Each block (a paragraph, list, quote, table or code block) holds at most ${DISPATCH_BLOCK_UNITS} ` + `characters and a body at most ${DISPATCH_ITEM_BLOCKS} blocks; Dispatch refuses a longer one and ` + "names it, and `dispatch limits` prints the bounds. A body holding a decision block (`:::ask`) " + "is refused however short it is, since nobody can answer a question put in a comment or a " + "message: ask the question in the issue's own document, as a decision block there, or open an " + "ask with `dispatch ask`.";
|
|
15170
15170
|
var ASK_BOUND_RULE = "Dispatch bounds an ask's question and its options together, refuses a longer one and names " + "the bound, and `dispatch limits` prints it. An ask is short and asks one thing; its reasoning " + "goes in the document, not in the question.";
|
|
15171
15171
|
var DISPATCH_HANDOFF_BODY_MAX = 262144;
|
|
15172
15172
|
var HANDOFF_PHASE_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
|
package/dist/envoy.js
CHANGED
|
@@ -30208,7 +30208,7 @@ function imagesArgument(z, owner) {
|
|
|
30208
30208
|
var ASK_URGENCIES = ["low", "med", "high", "blocking"];
|
|
30209
30209
|
var DISPATCH_BLOCK_UNITS = 32000;
|
|
30210
30210
|
var DISPATCH_ITEM_BLOCKS = 32768;
|
|
30211
|
-
var BODY_BLOCK_RULE = `Each block (a paragraph, list, quote, table or code block) holds at most ${DISPATCH_BLOCK_UNITS} ` + `characters and a body at most ${DISPATCH_ITEM_BLOCKS} blocks; Dispatch refuses a longer one and ` + "names it, and `dispatch limits` prints the bounds.";
|
|
30211
|
+
var BODY_BLOCK_RULE = `Each block (a paragraph, list, quote, table or code block) holds at most ${DISPATCH_BLOCK_UNITS} ` + `characters and a body at most ${DISPATCH_ITEM_BLOCKS} blocks; Dispatch refuses a longer one and ` + "names it, and `dispatch limits` prints the bounds. A body holding a decision block (`:::ask`) " + "is refused however short it is, since nobody can answer a question put in a comment or a " + "message: ask the question in the issue's own document, as a decision block there, or open an " + "ask with `dispatch ask`.";
|
|
30212
30212
|
var ASK_BOUND_RULE = "Dispatch bounds an ask's question and its options together, refuses a longer one and names " + "the bound, and `dispatch limits` prints it. An ask is short and asks one thing; its reasoning " + "goes in the document, not in the question.";
|
|
30213
30213
|
var DISPATCH_HANDOFF_BODY_MAX = 262144;
|
|
30214
30214
|
var HANDOFF_PHASE_PATTERN = /^[a-z][a-z0-9-]{0,31}$/;
|
|
@@ -42775,7 +42775,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
|
|
|
42775
42775
|
|
|
42776
42776
|
// package.json
|
|
42777
42777
|
var name = "@sjawhar/pi-envoy";
|
|
42778
|
-
var version2 = "16.49.
|
|
42778
|
+
var version2 = "16.49.1";
|
|
42779
42779
|
var package_default = {
|
|
42780
42780
|
name,
|
|
42781
42781
|
version: version2,
|
|
@@ -10,13 +10,13 @@ Dispatch is a record for the people who decide, never a log of your work.
|
|
|
10
10
|
- Use the `dispatch` command; the HTTP API only for what no command does. `dispatch <command> --help` gives its rules and an example.
|
|
11
11
|
- Put long text on stdin: `--<field>-file -` with a quoted here-document (`<<'EOF'`); give object and list fields as JSON.
|
|
12
12
|
- Exit 1 is a refusal, 2 a usage error. A refusal lists every problem: fix all, call once.
|
|
13
|
-
- A
|
|
13
|
+
- A command hard to use, or storing or losing something wrongly, is a defect to report, not work around: open an issue in the owning project's code and tell its controller; a Legion role tells its architect (`skill://legion-worker/references/findings.md`).
|
|
14
14
|
|
|
15
15
|
## Asks and ask blocks
|
|
16
16
|
|
|
17
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
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
|
|
19
|
+
- A design question a document records is an ask block ending its section:
|
|
20
20
|
|
|
21
21
|
```md
|
|
22
22
|
:::ask{urgency="med"}
|
|
@@ -27,6 +27,7 @@ The question and the recommendation (`skill://dispatch-writing-specs`).
|
|
|
27
27
|
:::
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
+
- A decision block in a comment, message or close reason is refused: ask in the issue's document, or `dispatch ask`.
|
|
30
31
|
- Never repeat an open ask in a message.
|
|
31
32
|
- 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.
|
|
32
33
|
- 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.
|
|
@@ -28,7 +28,7 @@ dispatch search --query 'reviewer threads OR review comments'
|
|
|
28
28
|
|
|
29
29
|
## Research before you ask
|
|
30
30
|
|
|
31
|
-
- Research when a file, command or document can show the answer
|
|
31
|
+
- Research when a file, command or document can show the answer.
|
|
32
32
|
- Ask a person only for what their authority, taste or risk appetite settles, because no file holds that. Where a file records the decision, cite it (`file:line`) and follow it; ask again only when the facts it rested on changed.
|
|
33
33
|
- Say what you searched: each part you found with its source, and each part you did not, with the queries you ran. Ask only the part no search answered.
|
|
34
34
|
|