@sjawhar/pi-envoy 15.5.0 → 15.6.0
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
|
@@ -15339,7 +15339,7 @@ var dispatchToolSpecs = [
|
|
|
15339
15339
|
{
|
|
15340
15340
|
name: "dispatch_request_approval",
|
|
15341
15341
|
example: { issue: "DSP-1", summary: "A live sync replaces the nightly export." },
|
|
15342
|
-
description: "Ask a human to approve a document at its current version. Before calling, have a fresh read-only reader check the spec against the code and the human's words, then resolve every finding; a Legion architect runs `plan-gap-analyst` and `plan-reviewer`. Opens an approval ask (Approve / " + "Request changes) in the human's Inbox whose question names the document and version, " + "followed by the summary; the answer pins a review to that version and arrives as " + "artifact.approved or artifact.changes_requested. An open request follows the document: a " + "later version moves it to that version and leaves it waiting on you, as a human's reply in " + "its thread does. Only the first move since the request was opened or handed back sends an " + "event, and never to the session whose version made it; dispatch doc-read shows whom it " + "waits on. Once the revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", call this again to hand that same Inbox row back. The request carries nothing new. A " + "call while it already waits on the human hands nothing back: the same summary changes " + "nothing, and a different one is refused, since it would rewrite the card the human is " + "reading. Approve and Request changes each close the request, so the next call opens a new " + "one. Call it once per revision, when the revision is complete, never after each edit. An " + "approval goes stale when the document changes outside its decision blocks after it: " + "request approval again once that revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", with a one-sentence summary naming what changed since the earlier approval: the card " + "names that approval (version, date, reviewer) and its Show diff control carries the detail. " + "A human's own answer to a decision block carries the approval to the version it writes when " + "that answer is the whole change since the approved version, so nothing is requested for " + "it. A new version of a Legion root spec closes its armed design gate until a human " + "approves it;
|
|
15342
|
+
description: "Ask a human to approve a document at its current version. Before calling, have a fresh read-only reader check the spec against the code and the human's words, then resolve every finding; a Legion architect runs `plan-gap-analyst` and `plan-reviewer`. Opens an approval ask (Approve / " + "Request changes) in the human's Inbox whose question names the document and version, " + "followed by the summary; the answer pins a review to that version and arrives as " + "artifact.approved or artifact.changes_requested. An open request follows the document: a " + "later version moves it to that version and leaves it waiting on you, as a human's reply in " + "its thread does. Only the first move since the request was opened or handed back sends an " + "event, and never to the session whose version made it; dispatch doc-read shows whom it " + "waits on. Once the revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", call this again to hand that same Inbox row back. The request carries nothing new. A " + "call while it already waits on the human hands nothing back: the same summary changes " + "nothing, and a different one is refused, since it would rewrite the card the human is " + "reading. Approve and Request changes each close the request, so the next call opens a new " + "one. Call it once per revision, when the revision is complete, never after each edit. An " + "approval goes stale when the document changes outside its decision blocks after it, until " + "a later version's text is exactly the approved version's again, as when an accidental " + "edit is undone exactly, and no decision block in it was decided since: that version " + "carries the approval and the document reads approved at it, so nothing is requested for " + "it. When the document does not read approved, request approval again once that revision " + "is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", with a one-sentence summary naming what changed since the earlier approval: the card " + "names that approval (version, date, reviewer) and its Show diff control carries the detail. " + "A human's own answer to a decision block carries the approval to the version it writes when " + "that answer is the whole change since the approved version, so nothing is requested for " + "it. A new version of a Legion root spec closes its armed design gate until a human " + "approves it; a carried approval reopens it too. " + "Refused, with nothing sent, while the document holds an open decision block, even when a " + "human asked for approval: the refusal names each block; ask the human to answer or waive " + "it first. " + OWNER_REFERENCE,
|
|
15343
15343
|
arguments: (z) => ({
|
|
15344
15344
|
issue: z.string().describe(ISSUE_REFERENCE).optional(),
|
|
15345
15345
|
project: z.string().describe("Project key owning the document.").optional(),
|
|
@@ -18464,7 +18464,7 @@ function renderAdvice(tool, key, advice, opts) {
|
|
|
18464
18464
|
}
|
|
18465
18465
|
const superseded = advice.superseded_approval;
|
|
18466
18466
|
if (superseded !== undefined && (tool === "dispatch_doc_edit" || tool === "dispatch_artifact")) {
|
|
18467
|
-
lines.push(`Stored version ${superseded.version}, superseding version ${superseded.approved_version}, which ${superseded.approved_by} approved. That approval is stale until someone approves version ${superseded.version},
|
|
18467
|
+
lines.push(`Stored version ${superseded.version}, superseding version ${superseded.approved_version}, which ${superseded.approved_by} approved. That approval is stale until someone approves version ${superseded.version} or a later write stores the text of version ${superseded.approved_version} again exactly, with no decision block in it decided since: a Legion design gate on this document is closed meanwhile, so every READY in its tree is refused. Meant to change the approved design? Request approval with \`dispatch request-approval\`. Meant a correction beside it? Tell the tree's architect, and keep the next one in a comment or in the plan.`);
|
|
18468
18468
|
}
|
|
18469
18469
|
if (hasIssueAdvice && writesSinceHuman !== undefined && writesSinceHuman >= 3 && (tool === "dispatch_message" || tool === "dispatch_ask" || tool === "dispatch_comment" && opts.isAskReply !== true)) {
|
|
18470
18470
|
const middle = writesSinceHuman >= 6 ? "Stop posting here until a human replies. Their reply ends this: post then what you held back." : "Progress ledger or scratchpad? If so, stop.";
|
|
@@ -18972,7 +18972,7 @@ function dispatchRefFromUrl(value, serverUrl) {
|
|
|
18972
18972
|
const id = url.hash.startsWith("#b-") ? decodeBlockId(url.hash.slice(3)) : undefined;
|
|
18973
18973
|
return id === undefined || versionName !== undefined && url.searchParams.get(versionName) ? "" : `#b-${encodeBlockId(id)}`;
|
|
18974
18974
|
};
|
|
18975
|
-
const issuePage = url.pathname.match(/^\/issues\/([A-Z][A-Z0-9]{1,9}-[1-9][0-9]*)(?:\/(spec|log|conversation|activity|children)|\/artifacts\/([^/]+)|\/asks\/([^/]+)|\/comments\/([^/]+)|\/messages\/([^/]+))?\/?$/);
|
|
18975
|
+
const issuePage = url.pathname.match(/^\/issues\/([A-Z][A-Z0-9]{1,9}-[1-9][0-9]*)(?:\/(spec|log|conversation|activity|children|decisions)|\/artifacts\/([^/]+)|\/asks\/([^/]+)|\/comments\/([^/]+)|\/messages\/([^/]+))?\/?$/);
|
|
18976
18976
|
if (issuePage) {
|
|
18977
18977
|
const [, key = "", page, artifact, ask, comment, message] = issuePage;
|
|
18978
18978
|
const version = versionOf("v");
|
|
@@ -18987,6 +18987,8 @@ function dispatchRefFromUrl(value, serverUrl) {
|
|
|
18987
18987
|
return `dispatch://${key}/artifact/spec${version}`;
|
|
18988
18988
|
if (page === "spec")
|
|
18989
18989
|
return `dispatch://${key}/spec${blockOf("v")}`;
|
|
18990
|
+
if (page === "decisions")
|
|
18991
|
+
return `dispatch://${key}/artifact/decisions-md`;
|
|
18990
18992
|
if (page !== undefined)
|
|
18991
18993
|
return `dispatch://${key}/${page === "conversation" ? "log" : page}`;
|
|
18992
18994
|
if (artifact !== undefined) {
|
package/dist/envoy.js
CHANGED
|
@@ -30459,7 +30459,7 @@ var dispatchToolSpecs = [
|
|
|
30459
30459
|
{
|
|
30460
30460
|
name: "dispatch_request_approval",
|
|
30461
30461
|
example: { issue: "DSP-1", summary: "A live sync replaces the nightly export." },
|
|
30462
|
-
description: "Ask a human to approve a document at its current version. Before calling, have a fresh read-only reader check the spec against the code and the human's words, then resolve every finding; a Legion architect runs `plan-gap-analyst` and `plan-reviewer`. Opens an approval ask (Approve / " + "Request changes) in the human's Inbox whose question names the document and version, " + "followed by the summary; the answer pins a review to that version and arrives as " + "artifact.approved or artifact.changes_requested. An open request follows the document: a " + "later version moves it to that version and leaves it waiting on you, as a human's reply in " + "its thread does. Only the first move since the request was opened or handed back sends an " + "event, and never to the session whose version made it; dispatch doc-read shows whom it " + "waits on. Once the revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", call this again to hand that same Inbox row back. The request carries nothing new. A " + "call while it already waits on the human hands nothing back: the same summary changes " + "nothing, and a different one is refused, since it would rewrite the card the human is " + "reading. Approve and Request changes each close the request, so the next call opens a new " + "one. Call it once per revision, when the revision is complete, never after each edit. An " + "approval goes stale when the document changes outside its decision blocks after it: " + "request approval again once that revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", with a one-sentence summary naming what changed since the earlier approval: the card " + "names that approval (version, date, reviewer) and its Show diff control carries the detail. " + "A human's own answer to a decision block carries the approval to the version it writes when " + "that answer is the whole change since the approved version, so nothing is requested for " + "it. A new version of a Legion root spec closes its armed design gate until a human " + "approves it;
|
|
30462
|
+
description: "Ask a human to approve a document at its current version. Before calling, have a fresh read-only reader check the spec against the code and the human's words, then resolve every finding; a Legion architect runs `plan-gap-analyst` and `plan-reviewer`. Opens an approval ask (Approve / " + "Request changes) in the human's Inbox whose question names the document and version, " + "followed by the summary; the answer pins a review to that version and arrives as " + "artifact.approved or artifact.changes_requested. An open request follows the document: a " + "later version moves it to that version and leaves it waiting on you, as a human's reply in " + "its thread does. Only the first move since the request was opened or handed back sends an " + "event, and never to the session whose version made it; dispatch doc-read shows whom it " + "waits on. Once the revision is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", call this again to hand that same Inbox row back. The request carries nothing new. A " + "call while it already waits on the human hands nothing back: the same summary changes " + "nothing, and a different one is refused, since it would rewrite the card the human is " + "reading. Approve and Request changes each close the request, so the next call opens a new " + "one. Call it once per revision, when the revision is complete, never after each edit. An " + "approval goes stale when the document changes outside its decision blocks after it, until " + "a later version's text is exactly the approved version's again, as when an accidental " + "edit is undone exactly, and no decision block in it was decided since: that version " + "carries the approval and the document reads approved at it, so nothing is requested for " + "it. When the document does not read approved, request approval again once that revision " + "is complete and " + HUMAN_AGREED_TO_DOCUMENT + ", with a one-sentence summary naming what changed since the earlier approval: the card " + "names that approval (version, date, reviewer) and its Show diff control carries the detail. " + "A human's own answer to a decision block carries the approval to the version it writes when " + "that answer is the whole change since the approved version, so nothing is requested for " + "it. A new version of a Legion root spec closes its armed design gate until a human " + "approves it; a carried approval reopens it too. " + "Refused, with nothing sent, while the document holds an open decision block, even when a " + "human asked for approval: the refusal names each block; ask the human to answer or waive " + "it first. " + OWNER_REFERENCE,
|
|
30463
30463
|
arguments: (z) => ({
|
|
30464
30464
|
issue: z.string().describe(ISSUE_REFERENCE).optional(),
|
|
30465
30465
|
project: z.string().describe("Project key owning the document.").optional(),
|
|
@@ -36927,7 +36927,7 @@ function dispatchRefFromUrl(value, serverUrl) {
|
|
|
36927
36927
|
const id = url.hash.startsWith("#b-") ? decodeBlockId(url.hash.slice(3)) : undefined;
|
|
36928
36928
|
return id === undefined || versionName !== undefined && url.searchParams.get(versionName) ? "" : `#b-${encodeBlockId(id)}`;
|
|
36929
36929
|
};
|
|
36930
|
-
const issuePage = url.pathname.match(/^\/issues\/([A-Z][A-Z0-9]{1,9}-[1-9][0-9]*)(?:\/(spec|log|conversation|activity|children)|\/artifacts\/([^/]+)|\/asks\/([^/]+)|\/comments\/([^/]+)|\/messages\/([^/]+))?\/?$/);
|
|
36930
|
+
const issuePage = url.pathname.match(/^\/issues\/([A-Z][A-Z0-9]{1,9}-[1-9][0-9]*)(?:\/(spec|log|conversation|activity|children|decisions)|\/artifacts\/([^/]+)|\/asks\/([^/]+)|\/comments\/([^/]+)|\/messages\/([^/]+))?\/?$/);
|
|
36931
36931
|
if (issuePage) {
|
|
36932
36932
|
const [, key = "", page, artifact, ask, comment, message] = issuePage;
|
|
36933
36933
|
const version = versionOf("v");
|
|
@@ -36942,6 +36942,8 @@ function dispatchRefFromUrl(value, serverUrl) {
|
|
|
36942
36942
|
return `dispatch://${key}/artifact/spec${version}`;
|
|
36943
36943
|
if (page === "spec")
|
|
36944
36944
|
return `dispatch://${key}/spec${blockOf("v")}`;
|
|
36945
|
+
if (page === "decisions")
|
|
36946
|
+
return `dispatch://${key}/artifact/decisions-md`;
|
|
36945
36947
|
if (page !== undefined)
|
|
36946
36948
|
return `dispatch://${key}/${page === "conversation" ? "log" : page}`;
|
|
36947
36949
|
if (artifact !== undefined) {
|
|
@@ -38280,7 +38282,7 @@ var import_nats2 = __toESM(require_mod4(), 1);
|
|
|
38280
38282
|
|
|
38281
38283
|
// package.json
|
|
38282
38284
|
var name = "@sjawhar/pi-envoy";
|
|
38283
|
-
var version2 = "15.
|
|
38285
|
+
var version2 = "15.6.0";
|
|
38284
38286
|
var package_default = {
|
|
38285
38287
|
name,
|
|
38286
38288
|
version: version2,
|
|
@@ -69,7 +69,7 @@ At your next edit, rewrite a spec outside the outline whole in one version, movi
|
|
|
69
69
|
## Approval
|
|
70
70
|
|
|
71
71
|
- Request approval once: each ask block answered or waived, each claim checked, this version unapproved. Unbuilt acceptance checks never delay it.
|
|
72
|
-
- After approval, version only a change to scope, acceptance, cost, risk or a person's decision, all at once; put other fixes in the plan or a comment.
|
|
72
|
+
- After approval, version only a change to scope, acceptance, cost, risk or a person's decision, all at once; put other fixes in the plan or a comment. An exact undo can restore approval.
|
|
73
73
|
|
|
74
74
|
## The plan
|
|
75
75
|
|