@codyswann/lisa 4.84.6 → 4.84.8
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/all/copy-overwrite/scripts/lib/completion-authorization.mjs +282 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-adapters.mjs +213 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-conformance.mjs +115 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-content.mjs +408 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-errors.mjs +16 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-github.mjs +233 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-markdown.mjs +70 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-projection.mjs +169 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-publisher.mjs +238 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-reader.mjs +175 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-shape.mjs +374 -0
- package/all/copy-overwrite/scripts/lib/completion-proof-source.mjs +174 -0
- package/all/copy-overwrite/scripts/lib/history-secret-scanner.mjs +20 -5
- package/all/copy-overwrite/scripts/lib/npm-update-helper-inventory.mjs +15 -0
- package/all/copy-overwrite/scripts/lib/usage-effectiveness.d.mts +27 -0
- package/all/copy-overwrite/scripts/lib/usage-effectiveness.mjs +156 -0
- package/all/copy-overwrite/scripts/lib/usage-ledger-integrity.d.mts +8 -0
- package/all/copy-overwrite/scripts/lib/usage-ledger-integrity.mjs +141 -0
- package/all/copy-overwrite/scripts/lib/usage-ledger.d.mts +89 -0
- package/all/copy-overwrite/scripts/lib/usage-ledger.mjs +206 -0
- package/all/copy-overwrite/scripts/lisa-hooks/parity-safety-net.sh +3 -1
- package/all/copy-overwrite/scripts/lisa-work-item.mjs +255 -39
- package/all/copy-overwrite/scripts/npm-updater-helper-graph.json +141 -3
- package/dist/core/lisa-owned-hash-ledger.d.ts.map +1 -1
- package/dist/core/lisa-owned-hash-ledger.js +186 -0
- package/dist/core/lisa-owned-hash-ledger.js.map +1 -1
- package/dist/core/nightly-e2e-guard-behavior-certificate.js +2 -2
- package/dist/core/upstream-evidence-manifest.d.ts.map +1 -1
- package/dist/core/upstream-evidence-manifest.js +108 -15
- package/dist/core/upstream-evidence-manifest.js.map +1 -1
- package/dist/opencode/plugin-templates/parity-safety-net.sh +3 -1
- package/dist/utils/effectiveness.d.ts +4 -41
- package/dist/utils/effectiveness.d.ts.map +1 -1
- package/dist/utils/effectiveness.js +2 -126
- package/dist/utils/effectiveness.js.map +1 -1
- package/dist/utils/usage-accounting.d.ts +5 -100
- package/dist/utils/usage-accounting.d.ts.map +1 -1
- package/dist/utils/usage-accounting.js +4 -287
- package/dist/utils/usage-accounting.js.map +1 -1
- package/package.json +4 -4
- package/plugins/lisa/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/lisa/hooks/host-name-command-context.mjs +16 -4
- package/plugins/lisa/hooks/parity-safety-net.sh +3 -1
- package/plugins/lisa/rules/eager/00-rule-index.md +1 -0
- package/plugins/lisa/rules/reference/completion-authorization.md +10 -0
- package/plugins/lisa/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa-agy/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/lisa-agy/hooks/host-name-command-context.mjs +16 -4
- package/plugins/lisa-agy/hooks/parity-safety-net.sh +3 -1
- package/plugins/lisa-agy/plugin.json +1 -1
- package/plugins/lisa-agy/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa-agy/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa-agy/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-agy/plugin.json +1 -1
- package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/lisa-copilot/hooks/host-name-command-context.mjs +16 -4
- package/plugins/lisa-copilot/hooks/parity-safety-net.sh +3 -1
- package/plugins/lisa-copilot/rules/eager/00-rule-index.md +1 -0
- package/plugins/lisa-copilot/rules/reference/completion-authorization.md +10 -0
- package/plugins/lisa-copilot/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa-copilot/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa-copilot/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cursor/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/lisa-cursor/hooks/host-name-command-context.mjs +16 -4
- package/plugins/lisa-cursor/hooks/parity-safety-net.sh +3 -1
- package/plugins/lisa-cursor/rules/00-rule-index.mdc +1 -0
- package/plugins/lisa-cursor/rules/completion-authorization-reference.mdc +15 -0
- package/plugins/lisa-cursor/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa-cursor/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa-cursor/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-devin/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/lisa-devin/hooks/host-name-command-context.mjs +16 -4
- package/plugins/lisa-devin/hooks/parity-safety-net.sh +3 -1
- package/plugins/lisa-devin/rules/eager/00-rule-index.md +1 -0
- package/plugins/lisa-devin/rules/reference/completion-authorization.md +10 -0
- package/plugins/lisa-devin/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/lisa-devin/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/lisa-devin/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-agy/plugin.json +1 -1
- package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-agy/plugin.json +1 -1
- package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-agy/plugin.json +1 -1
- package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-agy/plugin.json +1 -1
- package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-agy/plugin.json +1 -1
- package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-agy/plugin.json +1 -1
- package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-agy/plugin.json +1 -1
- package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-devin/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-devin/.devin-plugin/plugin.json +1 -1
- package/plugins/src/base/hooks/block-host-name-leak.mjs +25 -13
- package/plugins/src/base/hooks/host-name-command-context.mjs +16 -4
- package/plugins/src/base/hooks/parity-safety-net.sh +3 -1
- package/plugins/src/base/rules/eager/00-rule-index.md +1 -0
- package/plugins/src/base/rules/reference/completion-authorization.md +10 -0
- package/plugins/src/base/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
- package/plugins/src/base/skills/lisa-tracker-evidence/SKILL.md +7 -1
- package/plugins/src/base/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
- package/scripts/lib/host-name-expanded-command-cases.mjs +286 -0
- package/scripts/lib/host-name-field-occurrence-cases.mjs +60 -0
- package/scripts/two-channel-couplings.json +2 -2
- package/scripts/verify-host-name-target-scope.mjs +27 -1
- package/typescript/copy-overwrite/.prettierignore +15 -0
- package/typescript/copy-overwrite/scripts/check-skipped-required-checks.mjs +32 -0
|
@@ -287,8 +287,16 @@ export function publishableText(tokens, cwd, noun) {
|
|
|
287
287
|
const value = valueAt(tokens, index);
|
|
288
288
|
// On `gh api`, `-F` is `--field`: `key=@path` or `key=value`. Read as a
|
|
289
289
|
// bare path, `body=@file` named no file and published unchecked (#4462).
|
|
290
|
-
if (
|
|
291
|
-
|
|
290
|
+
if (
|
|
291
|
+
(noun === "api" || (noun === undefined && bare === "-F")) &&
|
|
292
|
+
/^[\w.[\]-]+=/u.test(value)
|
|
293
|
+
) {
|
|
294
|
+
const field = fieldSource(value, cwd);
|
|
295
|
+
if (noun === "api") return [field];
|
|
296
|
+
// An unresolved noun may become api or issue/pr. Inspect both possible
|
|
297
|
+
// meanings of -F without evaluating the expansion or certifying routing.
|
|
298
|
+
return [field, { origin: value, text: readIfPresent(value, cwd) }];
|
|
299
|
+
}
|
|
292
300
|
const file = value.replace(/^@/u, "");
|
|
293
301
|
return [{ origin: file, text: readIfPresent(file, cwd) }];
|
|
294
302
|
}
|
|
@@ -414,20 +422,24 @@ export async function evaluate(command, projectDir) {
|
|
|
414
422
|
// protection, and name the unread input instead of claiming the text clean.
|
|
415
423
|
if (
|
|
416
424
|
context.cwd === undefined &&
|
|
417
|
-
[
|
|
425
|
+
[
|
|
426
|
+
...context.flags,
|
|
427
|
+
...(context.noun === "api" || context.noun === undefined
|
|
428
|
+
? context.fieldOccurrences
|
|
429
|
+
: []),
|
|
430
|
+
].some(([flag, item]) => {
|
|
418
431
|
const field =
|
|
419
|
-
context.noun === "api"
|
|
432
|
+
(context.noun === "api" || context.noun === undefined) &&
|
|
433
|
+
FIELD_FLAGS.has(flag)
|
|
420
434
|
? /^([^=]+)=@(.+)$/u.exec(item.value)
|
|
421
435
|
: null;
|
|
422
|
-
const
|
|
423
|
-
field !== null
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
: undefined;
|
|
430
|
-
return file !== undefined && !path.isAbsolute(file);
|
|
436
|
+
const files = [
|
|
437
|
+
field !== null && PROSE_FIELDS.has(field[1]) ? field[2] : undefined,
|
|
438
|
+
FILE_FLAGS.has(flag) && (context.noun !== "api" || field === null)
|
|
439
|
+
? item.value.replace(/^@/, "")
|
|
440
|
+
: undefined,
|
|
441
|
+
];
|
|
442
|
+
return files.some(file => file !== undefined && !path.isAbsolute(file));
|
|
431
443
|
})
|
|
432
444
|
) {
|
|
433
445
|
return {
|
|
@@ -103,6 +103,7 @@ function words(command) {
|
|
|
103
103
|
*/
|
|
104
104
|
function argumentsOf(input) {
|
|
105
105
|
const flags = new Map(),
|
|
106
|
+
fieldOccurrences = [],
|
|
106
107
|
positional = [],
|
|
107
108
|
tokens = [];
|
|
108
109
|
// Any expansion can add/replace routing arguments after shell word splitting.
|
|
@@ -139,23 +140,34 @@ function argumentsOf(input) {
|
|
|
139
140
|
flag === "-R" ? "--repo" : flag === "-X" ? "--method" : flag,
|
|
140
141
|
value
|
|
141
142
|
);
|
|
143
|
+
// API fields are additive even though routing options use last values.
|
|
144
|
+
if (FIELD_FLAGS.has(flag)) fieldOccurrences.push([flag, value]);
|
|
142
145
|
tokens.push(value.value);
|
|
143
146
|
} else if (!word.value.startsWith("-")) positional.push(word);
|
|
144
147
|
else if (!word.literal) certain = false;
|
|
145
148
|
}
|
|
146
|
-
const
|
|
147
|
-
|
|
149
|
+
const nounWord = positional[0],
|
|
150
|
+
verbWord = positional[1];
|
|
151
|
+
const noun = nounWord?.literal ? nounWord.value : undefined,
|
|
152
|
+
verb = verbWord?.value;
|
|
153
|
+
// Command-name expansions can supply several argv words. A following
|
|
154
|
+
// read-looking literal does not prove that the expanded command is a read.
|
|
155
|
+
const uncertainName =
|
|
156
|
+
nounWord?.literal === false ||
|
|
157
|
+
(["issue", "pr"].includes(noun) && verbWord?.literal === false);
|
|
148
158
|
const method = flags.get("--method");
|
|
149
159
|
const writes =
|
|
150
|
-
|
|
160
|
+
uncertainName ||
|
|
161
|
+
(noun === "api"
|
|
151
162
|
? method
|
|
152
163
|
? !method.literal || METHODS.has(method.value.toUpperCase())
|
|
153
164
|
: [...FIELD_FLAGS].some(flag => flags.has(flag)) ||
|
|
154
165
|
Boolean(flags.get("--input")?.value)
|
|
155
166
|
: ["issue", "pr"].includes(noun) &&
|
|
156
|
-
["create", "comment", "edit"].includes(verb);
|
|
167
|
+
["create", "comment", "edit"].includes(verb));
|
|
157
168
|
return {
|
|
158
169
|
flags,
|
|
170
|
+
fieldOccurrences,
|
|
159
171
|
positional,
|
|
160
172
|
tokens: ["gh", ...tokens],
|
|
161
173
|
noun,
|
|
@@ -3475,8 +3475,10 @@ if [ -f "$rules_file" ]; then
|
|
|
3475
3475
|
# here — before the remaining rules ran, and with an exit status that is
|
|
3476
3476
|
# not a refusal. The `||` puts the pipeline in a condition context, where
|
|
3477
3477
|
# a non-zero status is expected rather than fatal.
|
|
3478
|
+
# Consume the whole input: grep -q can close an early match while printf
|
|
3479
|
+
# is still writing, making pipefail report SIGPIPE instead of the match.
|
|
3478
3480
|
rule_status=0
|
|
3479
|
-
printf '%s' "$custom_command_str" | grep -
|
|
3481
|
+
printf '%s' "$custom_command_str" | grep -Ei -- "$rule" >/dev/null || rule_status=$?
|
|
3480
3482
|
case "$rule_status" in
|
|
3481
3483
|
0) block "matched a project custom safety rule (${rules_file##*/}): $rule" ;;
|
|
3482
3484
|
1) ;; # no match
|
|
@@ -46,6 +46,7 @@ Paths are relative to this file.
|
|
|
46
46
|
| `bdd-e2e-coverage` | the work item adds or changes a user-observable surface | [../reference/bdd-e2e-coverage.md](../reference/bdd-e2e-coverage.md) |
|
|
47
47
|
| `reset-seed-coverage` | the work item adds or changes persistent state | [../reference/reset-seed-coverage.md](../reference/reset-seed-coverage.md) |
|
|
48
48
|
| `claim-evidence-mapping` | citing evidence for a claim, or reviewing evidence someone cited | [../reference/claim-evidence-mapping.md](../reference/claim-evidence-mapping.md) |
|
|
49
|
+
| `completion-authorization` | publishing proof or completing work items | [../reference/completion-authorization.md](../reference/completion-authorization.md) |
|
|
49
50
|
| `observability-audit` | running the `lisa-monitor` audit-and-file arm | [../reference/observability-audit.md](../reference/observability-audit.md) |
|
|
50
51
|
| `readiness-rubric` | judging whether an unattended fleet may run in a repository | [../reference/readiness-rubric.md](../reference/readiness-rubric.md) |
|
|
51
52
|
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# Accepted completion proof
|
|
2
|
+
|
|
3
|
+
Read the single maintained contract at
|
|
4
|
+
`skills/lisa-tracker-evidence/references/completion-authorization.md`, relative
|
|
5
|
+
to the Lisa plugin root. The tracker-evidence skill resolves it as its own
|
|
6
|
+
`references/completion-authorization.md` companion.
|
|
7
|
+
|
|
8
|
+
The contract travels with skill resources on every supported agent, including
|
|
9
|
+
Antigravity, whose native plugin intentionally omits the rules tree. The shared
|
|
10
|
+
Node producer and completion guard enforce the same contract for every agent.
|
|
@@ -1353,7 +1353,8 @@ Four properties make the command safe to run unconditionally:
|
|
|
1353
1353
|
above does, and for the same reason. A merged pull request is not evidence
|
|
1354
1354
|
on its own: the writer resolves `<baseRefName>` through `.lisa.config.json`
|
|
1355
1355
|
`deploy.branches` and applies only the role that base earned. A merge into
|
|
1356
|
-
the production deploy branch
|
|
1356
|
+
the production deploy branch becomes eligible for terminal completion only
|
|
1357
|
+
after canonical accepted-for-completion proof passes; a merge into a
|
|
1357
1358
|
branch mapping to a lower env records that env's role and leaves the item
|
|
1358
1359
|
open; a merge into a branch the project does not deploy at all — an
|
|
1359
1360
|
integration/stack branch — records nothing, closes nothing, and reports the
|
|
@@ -1375,6 +1376,19 @@ If the command refuses, do not close by hand. A refusal means the evidence is
|
|
|
1375
1376
|
not there, and a lifecycle step performed by hand is one nothing can verify
|
|
1376
1377
|
happened.
|
|
1377
1378
|
|
|
1379
|
+
`work-item pending-proof` is a normal nonterminal outcome: the merge does not
|
|
1380
|
+
prove the configured whole delivery run, runtime behavior, typed attachments,
|
|
1381
|
+
CONFORMS, canonical Verify usage, exact linkage and acceptance. Keep the item
|
|
1382
|
+
owned/open, finish canonical Verify and `lisa-tracker-evidence`, and use its
|
|
1383
|
+
shipped `publish-completion-proof` producer after actual uploads/readbacks.
|
|
1384
|
+
Then retry canonical completion. Read the sibling skill companion
|
|
1385
|
+
`../lisa-tracker-evidence/references/completion-authorization.md` relative to this
|
|
1386
|
+
skill directory; it is the portable `completion-authorization` reference.
|
|
1387
|
+
Publish an immutable required pending-state journey artifact first; append the
|
|
1388
|
+
real native terminal readback/acceptedAt afterward. Never require the future
|
|
1389
|
+
close event as its own authorization. A configured bot publisher's still-running
|
|
1390
|
+
pinned attempt keeps completion pending until that exact attempt succeeds.
|
|
1391
|
+
|
|
1378
1392
|
**The backstop, for the ones that still slip:** `lisa-work-item.mjs sweep`
|
|
1379
1393
|
reports every open item — in the **ready** lane as well as the **claimed** one —
|
|
1380
1394
|
that a commit on a deploy branch DECLARES via its `Work-Item:` trailer, and
|
|
@@ -14,6 +14,11 @@ Apply `lisa-tracker-sync` — **Agent attribution** when composing evidence comm
|
|
|
14
14
|
|
|
15
15
|
## Workflow
|
|
16
16
|
|
|
17
|
+
The portable accepted-completion contract is this skill's own
|
|
18
|
+
`references/completion-authorization.md` companion. Read that file when preparing
|
|
19
|
+
or publishing completion proof. It ships with the skill even on runtimes that
|
|
20
|
+
omit the plugin rules tree; do not assume a runtime-specific rules directory.
|
|
21
|
+
|
|
17
22
|
1. Resolve tracker config (same logic as `lisa-tracker-write`).
|
|
18
23
|
2. Missing / empty → stop and report `"No tracker configured in .lisa.config.json. Run /lisa:setup:jira, /lisa:setup:github, or /lisa:setup:linear first."`
|
|
19
24
|
3. Before dispatching, update the generated evidence artifact through `lisa-usage-accounting` so the comment body / PR evidence section carries a direct `lisa-verify` usage entry in the canonical `## Lisa Usage` section. If the originating work item's parentage or child refs are already known, prefer `record_and_rollup` so ancestor totals refresh in the same write; otherwise still write the direct entry, and if trustworthy runtime usage is unavailable, write `source: unavailable` with nullable token/cost fields instead of skipping the row.
|
|
@@ -22,7 +27,8 @@ Apply `lisa-tracker-sync` — **Agent attribution** when composing evidence comm
|
|
|
22
27
|
- `github` → invoke `lisa-github-evidence` with `$ARGUMENTS` verbatim. Arg shape: `<ISSUE_REF> <EVIDENCE_DIR> <PR_NUMBER>` where `ISSUE_REF` is `org/repo#<number>` or a GitHub issue URL.
|
|
23
28
|
- `linear` → invoke `lisa-linear-evidence` with `$ARGUMENTS` verbatim. Arg shape: `<IDENTIFIER> <EVIDENCE_DIR>` where `IDENTIFIER` is a Linear Issue identifier (e.g., `ENG-123`).
|
|
24
29
|
- Anything else → stop and report `"Unknown tracker '<value>' in .lisa.config.json. Expected 'jira', 'github', or 'linear'."`
|
|
25
|
-
5.
|
|
30
|
+
5. For supported GitHub/Linear production completion, after actual uploads and exact native readbacks, prepare the accepted-for-completion input from the observed source/delivery, schema2 verdicts, actual typed attachment pointers, complete requirement conjunction map, structured CONFORMS report, canonical Verify usage, linkage and explicit acceptance. Apply the shipped `completion-authorization` reference; the executable validates the contract in every installed host. Run `node scripts/lisa-work-item.mjs publish-completion-proof --ref <exact-work-item> --record <evidence-dir>/completion-record.json`. It uploads immutable hash-named acceptance bytes to the implementation repository's `pr-assets`, reads them back and publishes the exact-item native locator. Never construct a locator manually or treat a narrative evidence comment as acceptance. Jira completion remains unsupported.
|
|
31
|
+
6. Pass through both the vendor output and actual producer category. `published/pending-producer` means the pinned configured automation attempt must finish successfully before completion; do not rewrite the asset after the job or invent a successful future outcome. A User publisher does not require a producer workflow run. Only after accepted publication may the canonical lifecycle owner retry `complete`; pending proof preserves ownership and state and names the Verify/evidence action. Capture actual terminal readback/usage acceptedAt afterward, not as a circular publication prerequisite. A required pending-state journey artifact is immutable Phase-A proof captured before completion; the later actual terminal readback is a separate Phase-B supplement.
|
|
26
32
|
|
|
27
33
|
## Rules
|
|
28
34
|
|
package/plugins/lisa-devin/skills/lisa-tracker-evidence/references/completion-authorization.md
ADDED
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
# Accepted completion proof
|
|
2
|
+
|
|
3
|
+
Merging a pull request makes work available for delivery. It does not authorize
|
|
4
|
+
closing the work item. The canonical `scripts/lisa-work-item.mjs complete` and
|
|
5
|
+
GitHub applying sweep require the same accepted-for-completion record before
|
|
6
|
+
adding a terminal label, removing competing lifecycle labels, closing an issue,
|
|
7
|
+
or changing a Linear item to its terminal state. Jira completion remains
|
|
8
|
+
unsupported. Intermediate deployment roles retain their existing behavior.
|
|
9
|
+
|
|
10
|
+
An absent record or pending delivery leaves the item open with its current owner
|
|
11
|
+
and labels. The command names the pending obligation and asks for canonical
|
|
12
|
+
Verify/evidence. An invalid record, unreadable provider, or failed write is a
|
|
13
|
+
different outcome. A workflow must not file a delivery-failure issue merely
|
|
14
|
+
because verification has not finished.
|
|
15
|
+
|
|
16
|
+
## Publish after verification
|
|
17
|
+
|
|
18
|
+
The canonical tracker-evidence skill performs these steps after real evidence
|
|
19
|
+
uploads and exact readbacks:
|
|
20
|
+
|
|
21
|
+
1. Capture the delivered behavior, required hosted checks, actual configured
|
|
22
|
+
delivery, and every local typed evidence marker. Keep historical RED captures
|
|
23
|
+
and expected refusal exits as captures; current required claims and criteria
|
|
24
|
+
must independently pass.
|
|
25
|
+
2. Write canonical Verify usage, including explicit unavailable metrics when
|
|
26
|
+
needed. The future native completion time (`acceptedAt`) remains null.
|
|
27
|
+
3. Prepare the record input below from actual native source and uploaded asset
|
|
28
|
+
identities. Attach a structured CONFORMS report for the complete requirement
|
|
29
|
+
conjunctions and current full specification.
|
|
30
|
+
4. Execute the shipped producer:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
node scripts/lisa-work-item.mjs publish-completion-proof \
|
|
34
|
+
--ref acme/code#42 --record evidence/completion-record.json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Linear uses its configured identifier and implementation GitHub repository.
|
|
38
|
+
Both providers use the implementation repository's existing `pr-assets`
|
|
39
|
+
release. The producer reads current native requirements/configuration,
|
|
40
|
+
validates the actual attachment bytes and source/delivery, uploads a uniquely
|
|
41
|
+
hash-named JSON asset without replacement, reads it back, then posts and reads
|
|
42
|
+
back an exact native-item locator. The locator alone proves nothing.
|
|
43
|
+
5. Run canonical completion. Record the real native terminal readback and usage
|
|
44
|
+
acceptance afterward. A pending result is retryable after its named proof
|
|
45
|
+
obligation is satisfied; it does not authorize a manual close.
|
|
46
|
+
|
|
47
|
+
For a journey requiring a pending-state screenshot or state dump, capture and
|
|
48
|
+
upload that nonempty Phase-A artifact before publication/completion. Keep it
|
|
49
|
+
immutable. Append the later real terminal readback as a separate Phase-B
|
|
50
|
+
postcondition. Historical pending text in the earlier artifact is valid.
|
|
51
|
+
|
|
52
|
+
When a final requirement includes the terminal event itself, retain its claim
|
|
53
|
+
as an explicit pending postcondition in the complete phase ledger. The
|
|
54
|
+
accepted record's conjunctions and CONFORMS report cover only actual transition
|
|
55
|
+
inputs; they do not claim the future event passed. Keep the full final-spec
|
|
56
|
+
report PARTIAL until native Phase B, then attach the actual readback and update
|
|
57
|
+
the final required claim. Never fabricate a future closed state to obtain
|
|
58
|
+
pre-transition CONFORMS.
|
|
59
|
+
|
|
60
|
+
## Record contract
|
|
61
|
+
|
|
62
|
+
Schema version 1 has kind `lisa-completion-authorization`. The producer derives
|
|
63
|
+
the stable record ID, monotonic revision, predecessor digest, capture timestamp,
|
|
64
|
+
native item ID/provider/scope, repository ID/name, publisher ID, production
|
|
65
|
+
environment/branch and current `spec_sha256`. Input supplies:
|
|
66
|
+
|
|
67
|
+
- `state`: `accepted-for-completion`, `pending`, or `revoked`. A newer trusted
|
|
68
|
+
pending, revoked or malformed revision never falls back to an older accepted
|
|
69
|
+
record. Untrusted comments cannot select or revoke a record.
|
|
70
|
+
- `source`: primary `pull_request`, `pr_head`, actual `tested_head`, `merge_sha`,
|
|
71
|
+
`declaring_commits`, `production_snapshot_sha`, and `delivered_sha`. These are
|
|
72
|
+
distinct identities with native reconciliation, not a requirement that all
|
|
73
|
+
SHAs be equal. The primary PR and source commits must declare this exact work
|
|
74
|
+
item. A supplied `--pr-url` must identify that primary PR. Timeline mentions
|
|
75
|
+
and a different work item's accepted record cannot substitute.
|
|
76
|
+
- `evidence`: rows with `evidence_id`, canonical `kind`, native `asset_id`, actual
|
|
77
|
+
`bytes`, `sha256`, `captured_at`, and `artifact_head_sha`.
|
|
78
|
+
- `manifest`: one `{name, kind, evidence_id}` row for every local marker.
|
|
79
|
+
`EVIDENCE-REF` is non-claiming and cannot satisfy a local marker.
|
|
80
|
+
- `verdicts`: actual native JSON asset pointers (`asset_id`, `bytes`, `sha256`)
|
|
81
|
+
with role `remote` or `quality`. Each is schema2 PASS with passing criteria,
|
|
82
|
+
positively established required claims, attached reaching evidence and
|
|
83
|
+
`not_established_reviewed: true`. Each claim's evidence must also occur in its
|
|
84
|
+
own verdict's evidence list with the same execution head and digest.
|
|
85
|
+
- `requirements`: unique `{requirement_id, operator: "all", claim_ids}` rows.
|
|
86
|
+
Every required conjunct must be a validated required established claim.
|
|
87
|
+
Canonical `required_evidence_kinds` remain alternatives; an explicit
|
|
88
|
+
`evidence_operator: "all"` requires each listed kind.
|
|
89
|
+
- `obligations`: exactly `remote`, `conformance`, `typed_manifest`, `delivery`,
|
|
90
|
+
`usage`, `linkage`, and `acceptance`. Each has an explicit boolean `required`
|
|
91
|
+
and applicable status. Required values are `pass`, except conformance uses
|
|
92
|
+
`CONFORMS` and acceptance uses `accepted-for-completion`.
|
|
93
|
+
|
|
94
|
+
The conformance obligation includes `requirement_ids` and a native `report`
|
|
95
|
+
asset pointer. Its JSON is `{verdict: "CONFORMS", work_item, spec_sha256,
|
|
96
|
+
requirements, scenario_names}`. Requirement rows include status `pass` and must
|
|
97
|
+
match the record's complete conjunction map; every primary acceptance scenario
|
|
98
|
+
must be covered. The usage obligation lists the actual canonical `entry_ids`.
|
|
99
|
+
The remote obligation lists empirical required `claim_ids` against the delivered
|
|
100
|
+
environment/source, beyond code-unit checks.
|
|
101
|
+
|
|
102
|
+
Runtime leaves require remote and delivery proof. Explicit doc-only,
|
|
103
|
+
config-only and type-only no-runtime declarations permit their corresponding
|
|
104
|
+
N/A reasons; no-local-markers permits only the empty manifest exemption.
|
|
105
|
+
Missing or duplicate environment declarations cannot grant an exemption.
|
|
106
|
+
Childless Story/Spike work remains a leaf. Container rollup is a separate path;
|
|
107
|
+
older blanket container wording in evidence guidance does not grant a new
|
|
108
|
+
terminal-writer bypass.
|
|
109
|
+
|
|
110
|
+
Attachments must be nonempty bounded actual native assets in this repository's
|
|
111
|
+
`pr-assets` release, with matching byte counts and SHA256. Canonical kinds are
|
|
112
|
+
screenshot, recording, http-transcript, cli-output, log-snippet, db-query-output,
|
|
113
|
+
perf-trace, test-run-log, deploy-log and state-dump. The reader validates actual
|
|
114
|
+
captured structure/header, not an extension. HTTP HEAD/204 and empty query rows
|
|
115
|
+
can be legitimate observations. Structure checks do not claim to evaluate the
|
|
116
|
+
visual truth of an image or the business meaning of every captured line.
|
|
117
|
+
|
|
118
|
+
Native JSON reads use a separate 16 MiB ceiling per response, including the
|
|
119
|
+
complete slurped output of a paginated listing. The immutable proof record
|
|
120
|
+
remains limited to 2 MiB. Page and row limits are additional bounds: a listing
|
|
121
|
+
with at most 100 pages or 10,000 comments can still exceed its byte ceiling and
|
|
122
|
+
must fail closed without a lifecycle write. Visible local evidence markers
|
|
123
|
+
claim attachments; fenced or indented examples and HTML comments do not.
|
|
124
|
+
|
|
125
|
+
An ordinary pending result from `complete` or the applying sweep exits zero
|
|
126
|
+
because it preserves the nonterminal state. A refused `publish-completion-proof`
|
|
127
|
+
exits nonzero when no locator was published. A successful bot publication with
|
|
128
|
+
category `published/pending-producer` remains a successful publication; only
|
|
129
|
+
completion waits for its pinned producer attempt.
|
|
130
|
+
|
|
131
|
+
## Delivery and publisher configuration
|
|
132
|
+
|
|
133
|
+
Configure the actual production delivery mechanism under
|
|
134
|
+
`verification.completion.delivery.<environment>`. For GitHub Actions, use
|
|
135
|
+
`mechanism: "github-actions"`, exact `workflow_path`, and permitted native
|
|
136
|
+
`events`. Records pin each actual run's `run_id`, `workflow_id`, `workflow_path`,
|
|
137
|
+
`event`, `attempt` and `head_sha`. The whole configured post-merge run must
|
|
138
|
+
finish successfully and reconcile with delivered source. Pre-merge CI and an
|
|
139
|
+
auxiliary green workflow cannot replace it. Artifact or external-deployment
|
|
140
|
+
projects declare their applicable mechanism and empirical attached
|
|
141
|
+
`evidence_refs`; npm, browser, cloud and device checks are not universal.
|
|
142
|
+
|
|
143
|
+
User publishers require fresh native repository write/maintain/admin permission
|
|
144
|
+
and matching stable native asset-uploader identity. Association labels, display
|
|
145
|
+
names and issue edit access are insufficient. `automationPublishers` defaults
|
|
146
|
+
to an empty array. A configured automation row requires stable Bot `user_id`,
|
|
147
|
+
`type: "Bot"`, `repository_id`, exact `workflow_id`, `workflow_path`, allowed
|
|
148
|
+
`events`, and branch `ref`. Its record producer additionally pins
|
|
149
|
+
`workflow_run_id`, `workflow_attempt`, and `workflow_head`.
|
|
150
|
+
|
|
151
|
+
The native asset belongs to the repository and uploader; exact native run
|
|
152
|
+
repository, workflow, ref, head, attempt and upload interval corroborate that
|
|
153
|
+
configured automation policy. This is not a cryptographic claim about which
|
|
154
|
+
step uploaded the asset. A bot can publish during its pinned attempt and gets
|
|
155
|
+
`published/pending-producer`. Completion remains pending until that exact native
|
|
156
|
+
attempt succeeds, without rewriting the asset. A failed/cancelled/timed-out
|
|
157
|
+
attempt cannot be upgraded by a later successful rerun. User records do not
|
|
158
|
+
gain an unnecessary producer-run requirement.
|
|
159
|
+
|
|
160
|
+
## Freshness and readbacks
|
|
161
|
+
|
|
162
|
+
The full primary specification is hashed except positively recognized canonical
|
|
163
|
+
accounting lines/tokens and closed-schema machine metadata. Unknown visible
|
|
164
|
+
prose and table rows inside the usage section remain hashed, including text
|
|
165
|
+
before its rollup. Fenced examples cannot declare runtime scope or machine
|
|
166
|
+
blocks. Duplicate declarations are refused.
|
|
167
|
+
|
|
168
|
+
Precisely delimited `lisa:completion-authorization` blocks exclude only the
|
|
169
|
+
JSON locator's six exact fields: `schema_version`, `record_id`, `revision`,
|
|
170
|
+
`repository`, `asset_id`, `sha256`. `lisa:completion-postcondition` blocks exclude
|
|
171
|
+
only JSON with `schema_version: 1`, `provider`, canonical `ref`, real `native_id`,
|
|
172
|
+
`record_sha256`, UTC `completed_at`, and native terminal `state` (`CLOSED` for
|
|
173
|
+
GitHub, `completed` for Linear). Unknown keys, prose, or visible requirements
|
|
174
|
+
inside either block remain part of the specification. These bookkeeping fields
|
|
175
|
+
must use the exact canonical compact or two-space JSON serialization; duplicate
|
|
176
|
+
keys and other raw forms remain hashed. These bookkeeping fields
|
|
177
|
+
never authorize completion or replace the actual native readback; publish them
|
|
178
|
+
only after observing the real terminal event. Do not add outside prose or
|
|
179
|
+
spacing as if it were part of the machine metadata block.
|
|
180
|
+
|
|
181
|
+
The reader checks the accepted production snapshot against a fresh native
|
|
182
|
+
branch tip and fully paginates native compare commits. Newer source declaring
|
|
183
|
+
this same item anywhere from delivered source through the accepted snapshot to
|
|
184
|
+
the current tip requires fresh proof; unrelated newer work does not invalidate
|
|
185
|
+
it. It re-reads the trusted record, native scope, canonical usage, backlink and
|
|
186
|
+
lifecycle state immediately before mutation, preserving freshly observed owner
|
|
187
|
+
and unrelated labels. This is bounded authoritative rereading and post-write
|
|
188
|
+
verification, not a distributed atomic transaction.
|
|
189
|
+
|
|
190
|
+
The shipped Node usage parser is the same implementation used by the TypeScript
|
|
191
|
+
facade and works in a host without application `dist`. Local advisory Stop-hook
|
|
192
|
+
files cannot authorize production writes. Protocol version 1.2.0 adds these
|
|
193
|
+
verdict semantics; normal generator checks maintain its dependent versions.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "4.84.
|
|
3
|
+
"version": "4.84.8",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "4.84.
|
|
3
|
+
"version": "4.84.8",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, across Claude and Codex.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "4.84.
|
|
3
|
+
"version": "4.84.8",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "4.84.
|
|
3
|
+
"version": "4.84.8",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lisa-openclaw",
|
|
3
|
-
"version": "4.84.
|
|
3
|
+
"version": "4.84.8",
|
|
4
4
|
"description": "Connect staff roles to Telegram or Slack via OpenClaw — facilitator/specialist hub-and-spoke routing and repo-coding topics, for Claude Code and Codex",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Cody Swann"
|