@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.
Files changed (165) hide show
  1. package/all/copy-overwrite/scripts/lib/completion-authorization.mjs +282 -0
  2. package/all/copy-overwrite/scripts/lib/completion-proof-adapters.mjs +213 -0
  3. package/all/copy-overwrite/scripts/lib/completion-proof-conformance.mjs +115 -0
  4. package/all/copy-overwrite/scripts/lib/completion-proof-content.mjs +408 -0
  5. package/all/copy-overwrite/scripts/lib/completion-proof-errors.mjs +16 -0
  6. package/all/copy-overwrite/scripts/lib/completion-proof-github.mjs +233 -0
  7. package/all/copy-overwrite/scripts/lib/completion-proof-markdown.mjs +70 -0
  8. package/all/copy-overwrite/scripts/lib/completion-proof-projection.mjs +169 -0
  9. package/all/copy-overwrite/scripts/lib/completion-proof-publisher.mjs +238 -0
  10. package/all/copy-overwrite/scripts/lib/completion-proof-reader.mjs +175 -0
  11. package/all/copy-overwrite/scripts/lib/completion-proof-shape.mjs +374 -0
  12. package/all/copy-overwrite/scripts/lib/completion-proof-source.mjs +174 -0
  13. package/all/copy-overwrite/scripts/lib/history-secret-scanner.mjs +20 -5
  14. package/all/copy-overwrite/scripts/lib/npm-update-helper-inventory.mjs +15 -0
  15. package/all/copy-overwrite/scripts/lib/usage-effectiveness.d.mts +27 -0
  16. package/all/copy-overwrite/scripts/lib/usage-effectiveness.mjs +156 -0
  17. package/all/copy-overwrite/scripts/lib/usage-ledger-integrity.d.mts +8 -0
  18. package/all/copy-overwrite/scripts/lib/usage-ledger-integrity.mjs +141 -0
  19. package/all/copy-overwrite/scripts/lib/usage-ledger.d.mts +89 -0
  20. package/all/copy-overwrite/scripts/lib/usage-ledger.mjs +206 -0
  21. package/all/copy-overwrite/scripts/lisa-hooks/parity-safety-net.sh +3 -1
  22. package/all/copy-overwrite/scripts/lisa-work-item.mjs +255 -39
  23. package/all/copy-overwrite/scripts/npm-updater-helper-graph.json +141 -3
  24. package/dist/core/lisa-owned-hash-ledger.d.ts.map +1 -1
  25. package/dist/core/lisa-owned-hash-ledger.js +186 -0
  26. package/dist/core/lisa-owned-hash-ledger.js.map +1 -1
  27. package/dist/core/nightly-e2e-guard-behavior-certificate.js +2 -2
  28. package/dist/core/upstream-evidence-manifest.d.ts.map +1 -1
  29. package/dist/core/upstream-evidence-manifest.js +108 -15
  30. package/dist/core/upstream-evidence-manifest.js.map +1 -1
  31. package/dist/opencode/plugin-templates/parity-safety-net.sh +3 -1
  32. package/dist/utils/effectiveness.d.ts +4 -41
  33. package/dist/utils/effectiveness.d.ts.map +1 -1
  34. package/dist/utils/effectiveness.js +2 -126
  35. package/dist/utils/effectiveness.js.map +1 -1
  36. package/dist/utils/usage-accounting.d.ts +5 -100
  37. package/dist/utils/usage-accounting.d.ts.map +1 -1
  38. package/dist/utils/usage-accounting.js +4 -287
  39. package/dist/utils/usage-accounting.js.map +1 -1
  40. package/package.json +4 -4
  41. package/plugins/lisa/.claude-plugin/plugin.json +1 -1
  42. package/plugins/lisa/.codex-plugin/plugin.json +1 -1
  43. package/plugins/lisa/.codex-plugin/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  44. package/plugins/lisa/.codex-plugin/skills/lisa-tracker-evidence/SKILL.md +7 -1
  45. package/plugins/lisa/.codex-plugin/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  46. package/plugins/lisa/hooks/block-host-name-leak.mjs +25 -13
  47. package/plugins/lisa/hooks/host-name-command-context.mjs +16 -4
  48. package/plugins/lisa/hooks/parity-safety-net.sh +3 -1
  49. package/plugins/lisa/rules/eager/00-rule-index.md +1 -0
  50. package/plugins/lisa/rules/reference/completion-authorization.md +10 -0
  51. package/plugins/lisa/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  52. package/plugins/lisa/skills/lisa-tracker-evidence/SKILL.md +7 -1
  53. package/plugins/lisa/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  54. package/plugins/lisa-agy/hooks/block-host-name-leak.mjs +25 -13
  55. package/plugins/lisa-agy/hooks/host-name-command-context.mjs +16 -4
  56. package/plugins/lisa-agy/hooks/parity-safety-net.sh +3 -1
  57. package/plugins/lisa-agy/plugin.json +1 -1
  58. package/plugins/lisa-agy/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  59. package/plugins/lisa-agy/skills/lisa-tracker-evidence/SKILL.md +7 -1
  60. package/plugins/lisa-agy/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  61. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  62. package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
  63. package/plugins/lisa-cdk-agy/plugin.json +1 -1
  64. package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
  65. package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
  66. package/plugins/lisa-cdk-devin/.claude-plugin/plugin.json +1 -1
  67. package/plugins/lisa-cdk-devin/.devin-plugin/plugin.json +1 -1
  68. package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
  69. package/plugins/lisa-copilot/hooks/block-host-name-leak.mjs +25 -13
  70. package/plugins/lisa-copilot/hooks/host-name-command-context.mjs +16 -4
  71. package/plugins/lisa-copilot/hooks/parity-safety-net.sh +3 -1
  72. package/plugins/lisa-copilot/rules/eager/00-rule-index.md +1 -0
  73. package/plugins/lisa-copilot/rules/reference/completion-authorization.md +10 -0
  74. package/plugins/lisa-copilot/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  75. package/plugins/lisa-copilot/skills/lisa-tracker-evidence/SKILL.md +7 -1
  76. package/plugins/lisa-copilot/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  77. package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
  78. package/plugins/lisa-cursor/hooks/block-host-name-leak.mjs +25 -13
  79. package/plugins/lisa-cursor/hooks/host-name-command-context.mjs +16 -4
  80. package/plugins/lisa-cursor/hooks/parity-safety-net.sh +3 -1
  81. package/plugins/lisa-cursor/rules/00-rule-index.mdc +1 -0
  82. package/plugins/lisa-cursor/rules/completion-authorization-reference.mdc +15 -0
  83. package/plugins/lisa-cursor/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  84. package/plugins/lisa-cursor/skills/lisa-tracker-evidence/SKILL.md +7 -1
  85. package/plugins/lisa-cursor/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  86. package/plugins/lisa-devin/.claude-plugin/plugin.json +1 -1
  87. package/plugins/lisa-devin/.devin-plugin/plugin.json +1 -1
  88. package/plugins/lisa-devin/hooks/block-host-name-leak.mjs +25 -13
  89. package/plugins/lisa-devin/hooks/host-name-command-context.mjs +16 -4
  90. package/plugins/lisa-devin/hooks/parity-safety-net.sh +3 -1
  91. package/plugins/lisa-devin/rules/eager/00-rule-index.md +1 -0
  92. package/plugins/lisa-devin/rules/reference/completion-authorization.md +10 -0
  93. package/plugins/lisa-devin/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  94. package/plugins/lisa-devin/skills/lisa-tracker-evidence/SKILL.md +7 -1
  95. package/plugins/lisa-devin/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  96. package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
  97. package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
  98. package/plugins/lisa-expo-agy/plugin.json +1 -1
  99. package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
  100. package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
  101. package/plugins/lisa-expo-devin/.claude-plugin/plugin.json +1 -1
  102. package/plugins/lisa-expo-devin/.devin-plugin/plugin.json +1 -1
  103. package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
  104. package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
  105. package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
  106. package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
  107. package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
  108. package/plugins/lisa-harper-fabric-devin/.claude-plugin/plugin.json +1 -1
  109. package/plugins/lisa-harper-fabric-devin/.devin-plugin/plugin.json +1 -1
  110. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  111. package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
  112. package/plugins/lisa-nestjs-agy/plugin.json +1 -1
  113. package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
  114. package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
  115. package/plugins/lisa-nestjs-devin/.claude-plugin/plugin.json +1 -1
  116. package/plugins/lisa-nestjs-devin/.devin-plugin/plugin.json +1 -1
  117. package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
  118. package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
  119. package/plugins/lisa-openclaw-agy/plugin.json +1 -1
  120. package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
  121. package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
  122. package/plugins/lisa-openclaw-devin/.claude-plugin/plugin.json +1 -1
  123. package/plugins/lisa-openclaw-devin/.devin-plugin/plugin.json +1 -1
  124. package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
  125. package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
  126. package/plugins/lisa-phaser-agy/plugin.json +1 -1
  127. package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
  128. package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
  129. package/plugins/lisa-phaser-devin/.claude-plugin/plugin.json +1 -1
  130. package/plugins/lisa-phaser-devin/.devin-plugin/plugin.json +1 -1
  131. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
  132. package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
  133. package/plugins/lisa-rails-agy/plugin.json +1 -1
  134. package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
  135. package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
  136. package/plugins/lisa-rails-devin/.claude-plugin/plugin.json +1 -1
  137. package/plugins/lisa-rails-devin/.devin-plugin/plugin.json +1 -1
  138. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
  139. package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
  140. package/plugins/lisa-typescript-agy/plugin.json +1 -1
  141. package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
  142. package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
  143. package/plugins/lisa-typescript-devin/.claude-plugin/plugin.json +1 -1
  144. package/plugins/lisa-typescript-devin/.devin-plugin/plugin.json +1 -1
  145. package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
  146. package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
  147. package/plugins/lisa-wiki-agy/plugin.json +1 -1
  148. package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
  149. package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
  150. package/plugins/lisa-wiki-devin/.claude-plugin/plugin.json +1 -1
  151. package/plugins/lisa-wiki-devin/.devin-plugin/plugin.json +1 -1
  152. package/plugins/src/base/hooks/block-host-name-leak.mjs +25 -13
  153. package/plugins/src/base/hooks/host-name-command-context.mjs +16 -4
  154. package/plugins/src/base/hooks/parity-safety-net.sh +3 -1
  155. package/plugins/src/base/rules/eager/00-rule-index.md +1 -0
  156. package/plugins/src/base/rules/reference/completion-authorization.md +10 -0
  157. package/plugins/src/base/skills/lisa-drive-pr-to-merge/SKILL.md +15 -1
  158. package/plugins/src/base/skills/lisa-tracker-evidence/SKILL.md +7 -1
  159. package/plugins/src/base/skills/lisa-tracker-evidence/references/completion-authorization.md +193 -0
  160. package/scripts/lib/host-name-expanded-command-cases.mjs +286 -0
  161. package/scripts/lib/host-name-field-occurrence-cases.mjs +60 -0
  162. package/scripts/two-channel-couplings.json +2 -2
  163. package/scripts/verify-host-name-target-scope.mjs +27 -1
  164. package/typescript/copy-overwrite/.prettierignore +15 -0
  165. 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 (noun === "api" && /^[\w.[\]-]+=/u.test(value))
291
- return [fieldSource(value, cwd)];
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
- [...context.flags].some(([flag, item]) => {
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" && FIELD_FLAGS.has(flag)
432
+ (context.noun === "api" || context.noun === undefined) &&
433
+ FIELD_FLAGS.has(flag)
420
434
  ? /^([^=]+)=@(.+)$/u.exec(item.value)
421
435
  : null;
422
- const file =
423
- field !== null
424
- ? PROSE_FIELDS.has(field[1])
425
- ? field[2]
426
- : undefined
427
- : FILE_FLAGS.has(flag)
428
- ? item.value.replace(/^@/, "")
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 noun = positional[0]?.value,
147
- verb = positional[1]?.value;
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
- noun === "api"
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 -Eiq -- "$rule" || rule_status=$?
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 is terminal and closes the item; a merge into a
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. Pass through the vendor skill's output.
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
 
@@ -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-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo and React Native-specific skills, agents, rules, and MCP servers.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-expo",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Expo/React Native-specific skills, agents, rules, and MCP servers",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific Lisa rules for TypeScript component apps.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-harper-fabric",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "Harper/Fabric-specific rules for TypeScript component apps",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills and migration write-protection hooks.",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-nestjs",
3
- "version": "4.84.6",
3
+ "version": "4.84.8",
4
4
  "description": "NestJS-specific skills (GraphQL, TypeORM) and hooks (migration write-protection)",
5
5
  "author": {
6
6
  "name": "Cody Swann"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lisa-openclaw",
3
- "version": "4.84.6",
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.6",
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.6",
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.6",
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.6",
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"