@holmes-lab/holmes-kit 0.26.2 → 0.28.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.
Files changed (41) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/README.md +10 -0
  3. package/dist/.build-id +1 -1
  4. package/dist/holmes/cli/agents-guidance-command.d.ts +9 -0
  5. package/dist/holmes/cli/agents-guidance-command.js +61 -0
  6. package/dist/holmes/cli/agents-guidance-file.d.ts +7 -0
  7. package/dist/holmes/cli/agents-guidance-file.js +86 -0
  8. package/dist/holmes/cli/agents-guidance-history.d.ts +10 -0
  9. package/dist/holmes/cli/agents-guidance-history.js +35 -0
  10. package/dist/holmes/cli/agents-guidance-plan.d.ts +11 -0
  11. package/dist/holmes/cli/agents-guidance-plan.js +81 -0
  12. package/dist/holmes/cli/agents-guidance.d.ts +1 -0
  13. package/dist/holmes/cli/agents-guidance.js +40 -0
  14. package/dist/holmes/cli/agents.d.ts +3 -19
  15. package/dist/holmes/cli/agents.js +12 -108
  16. package/dist/holmes/cli/attest.d.ts +15 -0
  17. package/dist/holmes/cli/attest.js +168 -0
  18. package/dist/holmes/cli/doctor-guidance.d.ts +2 -0
  19. package/dist/holmes/cli/doctor-guidance.js +61 -0
  20. package/dist/holmes/cli/doctor.d.ts +2 -0
  21. package/dist/holmes/cli/doctor.js +5 -1
  22. package/dist/holmes/cli/index.d.ts +1 -0
  23. package/dist/holmes/cli/index.js +51 -4
  24. package/dist/holmes/cli/init.js +32 -5
  25. package/dist/holmes/cli/upgrade.js +23 -26
  26. package/dist/holmes/cli/worktree-readiness.d.ts +6 -0
  27. package/dist/holmes/cli/worktree-readiness.js +81 -0
  28. package/dist/holmes/mcp/handlers/workspace-preflight.d.ts +9 -0
  29. package/dist/holmes/mcp/handlers/workspace-preflight.js +13 -0
  30. package/dist/holmes/mcp/handlers.d.ts +50 -46
  31. package/dist/holmes/mcp/handlers.js +6 -3
  32. package/dist/holmes/mcp/tool-schemas.js +6 -1
  33. package/dist/holmes/project/workspace-checkout.d.ts +8 -0
  34. package/dist/holmes/project/workspace-checkout.js +74 -0
  35. package/dist/holmes/project/workspace-preflight.d.ts +24 -0
  36. package/dist/holmes/project/workspace-preflight.js +99 -0
  37. package/dist/holmes/rtm/traced-files.d.ts +83 -0
  38. package/dist/holmes/rtm/traced-files.js +207 -0
  39. package/docs/install-guide.md +54 -0
  40. package/package.json +1 -1
  41. package/playbooks/superpowers-compat/PLAYBOOK.md +46 -0
@@ -0,0 +1,207 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.UNTRACED_LINE_CAP = exports.ATTEST_SCHEMA = exports.ATTEST_END = exports.ATTEST_BEGIN = void 0;
37
+ exports.normalizeExcludes = normalizeExcludes;
38
+ exports.flooredPct = flooredPct;
39
+ exports.tracedFiles = tracedFiles;
40
+ exports.attestProvenance = attestProvenance;
41
+ exports.renderAttestText = renderAttestText;
42
+ exports.renderAttestJson = renderAttestJson;
43
+ exports.renderAttestSvg = renderAttestSvg;
44
+ exports.renderAttestMarker = renderAttestMarker;
45
+ exports.replaceMarkerRegion = replaceMarkerRegion;
46
+ // @implements A-SPEC-702
47
+ /**
48
+ * How many of a repository's source files trace to an APPROVED spec — said as a number anyone can
49
+ * reproduce, with the commit and spec-store state it was measured at.
50
+ *
51
+ * This exists INSTEAD of a "generated under holmes-kit" header in every file (REQ-702). A header is
52
+ * a claim: it can be pasted, and it keeps saying "governed" after an ungoverned edit. Line 1 already
53
+ * carries the `implements` anchor, which a gate verifies. What was missing is a repository-level
54
+ * statement, and the spec-side half of it (`linkCensus`) lived only inside the dashboard.
55
+ *
56
+ * NO NEW JUDGEMENT. The denominator is whatever the scanner returned, the numerator is anchors ∩
57
+ * approved ids. Everything here is pure — no clock, no filesystem, no git — so the same input is the
58
+ * same bytes and a committed badge does not churn. The CLI that feeds it is `cli/attest.ts`.
59
+ */
60
+ const crypto = __importStar(require("node:crypto"));
61
+ exports.ATTEST_BEGIN = '<!-- holmes-kit:attest:begin -->';
62
+ exports.ATTEST_END = '<!-- holmes-kit:attest:end -->';
63
+ exports.ATTEST_SCHEMA = 'holmes-attest/1';
64
+ /** Above this many untraced files the text names none and points at `--json`. */
65
+ exports.UNTRACED_LINE_CAP = 10;
66
+ const posix = (p) => p.replace(/\\/g, '/').replace(/^\.\//, '');
67
+ /**
68
+ * Backslashes folded, one trailing slash. A prefix that means "everything" is DROPPED: excluding the
69
+ * whole tree would read as n/a at best and 100% at worst (the same rule A-SPEC-694 pinned for
70
+ * `cycleIgnore`). Sorted and de-duplicated so the provenance does not depend on how it was typed.
71
+ */
72
+ function normalizeExcludes(raw) {
73
+ const out = new Set();
74
+ for (const r of raw ?? []) {
75
+ const p = posix(String(r).trim()).replace(/^\/+/, '').replace(/\/+$/, '');
76
+ if (p === '' || p === '.')
77
+ continue;
78
+ out.add(p + '/');
79
+ }
80
+ return [...out].sort();
81
+ }
82
+ /** Floored to one decimal: 99.96 must not read as 100 — 100 means every file. */
83
+ function flooredPct(num, den) {
84
+ if (den <= 0)
85
+ return null;
86
+ return Math.floor((num / den) * 1000) / 10;
87
+ }
88
+ function tracedFiles(input) {
89
+ const approved = new Set(input.approvedIds);
90
+ const excludes = normalizeExcludes(input.exclude);
91
+ let excluded = 0, traced = 0, total = 0;
92
+ const untraced = [];
93
+ for (const f of input.files) {
94
+ const p = posix(f.path);
95
+ // Boundary match: every prefix ends in '/', so `reference/` cannot pardon `reference-impl/`.
96
+ if (excludes.some((e) => p.startsWith(e))) {
97
+ excluded++;
98
+ continue;
99
+ }
100
+ total++;
101
+ if (f.anchors.some((id) => approved.has(id)))
102
+ traced++;
103
+ else
104
+ untraced.push(p);
105
+ }
106
+ untraced.sort();
107
+ const reason = total === 0 ? 'no source files' : approved.size === 0 ? 'no approved specs' : undefined;
108
+ return {
109
+ total, traced, excluded, untraced,
110
+ measurable: reason === undefined,
111
+ ...(reason !== undefined ? { reason } : {}),
112
+ tracedPct: reason === undefined ? flooredPct(traced, total) : null,
113
+ };
114
+ }
115
+ /**
116
+ * Where and when the number is true. `+dirty` because a commit alone would call an unreproducible
117
+ * number reproducible. The spec digest covers (id, seal) of every approved spec — that set is what
118
+ * decides the numerator. No clock anywhere.
119
+ */
120
+ function attestProvenance(input) {
121
+ const lines = input.approved.map((a) => `${a.id}\t${a.digest}`).sort();
122
+ const specs = crypto.createHash('sha256').update(lines.join('\n')).digest('hex').slice(0, 12);
123
+ const commit = (input.commit ?? '').trim();
124
+ const at = commit === '' ? 'unversioned' : commit.slice(0, 12) + (input.dirty ? '+dirty' : '');
125
+ return { at, specs, exclude: normalizeExcludes(input.exclude) };
126
+ }
127
+ const pctText = (pct) => (pct === null ? 'n/a' : `${pct}%`);
128
+ const ratio = (num, den, sep) => `${num}${sep}${den}`;
129
+ function renderAttestText(r) {
130
+ const f = r.files;
131
+ const filesLine = f.measurable
132
+ ? `${ratio(f.traced, f.total, ' / ')} (${pctText(f.tracedPct)})`
133
+ : `n/a — ${f.reason}`;
134
+ const specPct = flooredPct(r.specs.linked, r.specs.total);
135
+ const specsLine = specPct === null ? 'n/a — no approved A-SPECs' : `${ratio(r.specs.linked, r.specs.total, ' / ')} (${pctText(specPct)})`;
136
+ const lines = [
137
+ `traced files ${filesLine} — source files anchored to an APPROVED spec`,
138
+ `linked specs ${specsLine} — approved A-SPECs anchored from code`,
139
+ ];
140
+ // Few enough to act on → name them; a wall of paths helps nobody, so beyond that point to --json.
141
+ if (f.measurable && f.untraced.length > 0) {
142
+ lines.push(f.untraced.length <= exports.UNTRACED_LINE_CAP
143
+ ? `untraced ${f.untraced.join(', ')}`
144
+ : `untraced ${f.untraced.length} file(s) — list them with --json`);
145
+ }
146
+ if (r.provenance.exclude.length > 0)
147
+ lines.push(`excluded ${f.excluded} file(s) under: ${r.provenance.exclude.join(', ')}`);
148
+ lines.push(`at ${r.provenance.at} · specs sha256:${r.provenance.specs}`);
149
+ return lines.join('\n') + '\n';
150
+ }
151
+ function renderAttestJson(r) {
152
+ return JSON.stringify({ schema: exports.ATTEST_SCHEMA, files: r.files, specs: r.specs, provenance: r.provenance }, null, 2) + '\n';
153
+ }
154
+ const xml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
155
+ /** Self-contained: no href, font, script or fetch. Only the ratio, the percentage and `at` go in. */
156
+ function renderAttestSvg(r) {
157
+ const f = r.files;
158
+ const value = f.measurable ? `${ratio(f.traced, f.total, '/')} · ${pctText(f.tracedPct)}` : 'n/a';
159
+ const label = 'traced files';
160
+ const lw = 86, vw = Math.max(64, 14 + value.length * 7), w = lw + vw;
161
+ const colour = !f.measurable ? '#9f9f9f' : (f.tracedPct ?? 0) >= 90 ? '#2e7d32' : (f.tracedPct ?? 0) >= 60 ? '#b08900' : '#b3541e';
162
+ return [
163
+ `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="34" role="img" aria-label="${xml(label + ': ' + value)}">`,
164
+ `<title>${xml(label + ': ' + value + ' @ ' + r.provenance.at)}</title>`,
165
+ `<rect width="${lw}" height="20" fill="#444"/>`,
166
+ `<rect x="${lw}" width="${vw}" height="20" fill="${colour}"/>`,
167
+ `<g fill="#fff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11">`,
168
+ `<text x="${lw / 2}" y="14" text-anchor="middle">${xml(label)}</text>`,
169
+ `<text x="${lw + vw / 2}" y="14" text-anchor="middle">${xml(value)}</text>`,
170
+ `</g>`,
171
+ `<text x="0" y="31" fill="#666" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="9">${xml('at ' + r.provenance.at)}</text>`,
172
+ `</svg>`,
173
+ ].join('') + '\n';
174
+ }
175
+ /** What goes between the markers. Carries the excludes, so the README says how to reproduce it. */
176
+ function renderAttestMarker(r) {
177
+ const f = r.files;
178
+ const files = f.measurable ? `**${ratio(f.traced, f.total, '/')}** source files (${pctText(f.tracedPct)}) trace to an approved spec` : `traced files: n/a — ${f.reason}`;
179
+ const specPct = flooredPct(r.specs.linked, r.specs.total);
180
+ const specs = specPct === null ? '' : ` · **${ratio(r.specs.linked, r.specs.total, '/')}** approved A-SPECs (${pctText(specPct)}) are anchored from code`;
181
+ const excl = r.provenance.exclude.length > 0 ? ` --exclude ${r.provenance.exclude.join(',')}` : '';
182
+ return [
183
+ `![traced files](.ax/badges/traced.svg)`,
184
+ ``,
185
+ `${files}${specs}.`,
186
+ `Measured at \`${r.provenance.at}\` (specs \`sha256:${r.provenance.specs}\`) — reproduce with \`holmes-kit attest${excl}\`.`,
187
+ ].join('\n');
188
+ }
189
+ const count = (hay, needle) => hay.split(needle).length - 1;
190
+ /**
191
+ * Replace what lies between the two markers — and ONLY when each appears exactly once, begin first.
192
+ * No marker is `no-marker`: the person never asked, so nothing is written. Anything else malformed is
193
+ * `unbalanced`: a lone begin marker followed by "replace to the end" is this feature's worst failure.
194
+ * The README's own line ending is kept, so a CRLF file does not become one whole-file diff.
195
+ */
196
+ function replaceMarkerRegion(readme, inner) {
197
+ const begins = count(readme, exports.ATTEST_BEGIN), ends = count(readme, exports.ATTEST_END);
198
+ if (begins === 0 && ends === 0)
199
+ return { ok: false, reason: 'no-marker' };
200
+ const b = readme.indexOf(exports.ATTEST_BEGIN), e = readme.indexOf(exports.ATTEST_END);
201
+ if (begins !== 1 || ends !== 1 || e < b)
202
+ return { ok: false, reason: 'unbalanced' };
203
+ const eol = readme.includes('\r\n') ? '\r\n' : '\n';
204
+ const body = inner.replace(/\r\n/g, '\n').split('\n').join(eol);
205
+ const text = readme.slice(0, b + exports.ATTEST_BEGIN.length) + eol + body + eol + readme.slice(e);
206
+ return { ok: true, text, changed: text !== readme };
207
+ }
@@ -164,6 +164,7 @@ from the registry or from a packed tarball.
164
164
  ```
165
165
  npx holmes-kit doctor # local install
166
166
  holmes-kit doctor # global install
167
+ holmes-kit doctor --target . --agent claude # selected-harness preparation
167
168
  ```
168
169
 
169
170
  Expect `0 fail` on a healthy install (a few `warn` lines are normal — measured `12 pass, 4 warn,
@@ -175,6 +176,19 @@ Expect `0 fail` on a healthy install (a few `warn` lines are normal — measured
175
176
  (`scripts-blocked`, `abi-mismatch`, `build-failed`, or `unknown` with the raw error) and the fix
176
177
  is the exact command for your install layout
177
178
 
179
+ For a worktree or resumed project, choose one harness explicitly: `--agent claude`,
180
+ `--agent codex`, or `--agent antigravity`. The resulting readiness lines inspect only
181
+ local checkout, identity, build and wiring evidence. A missing file means preparation
182
+ is incomplete; it does not prove a running client did or did not load a hook. The
183
+ separate `mcp wiring spawn` result is also a probe process, not the current conversation's
184
+ MCP binding. Restart the selected harness in the target workspace, then use its live
185
+ `workspace_preflight` result to verify binding.
186
+
187
+ When Superpowers is available, `holmes-superpowers-compat` is installed with the Holmes
188
+ playbook skills. It is optional guidance: it maps design, worktree, TDD, review, and finish
189
+ stages to the existing Holmes approval and evidence gates, without installing Superpowers or
190
+ claiming that a local configuration proves a live session loaded it.
191
+
178
192
  ## What we deliberately do NOT do
179
193
 
180
194
  | Idea | Why not |
@@ -266,3 +280,43 @@ implementation, but this Windows session did not execute platform-native tests t
266
280
  The optional cloud credential file uses a protected current-user-only NTFS DACL on Windows.
267
281
  Permission setup is verified before a new key is written; failure preserves the prior key and
268
282
  refuses the new value. The macOS keychain and POSIX 0700/0600 fallback remain available.
283
+ # Keeping AGENTS.md guidance current
284
+
285
+ Holmes-Kit generates common operating rules inside `holmes-kit:managed:begin/end`
286
+ markers. Keep project-specific rules outside that block. The development repository
287
+ uses the same renderer as installed packages; consumer checks compare against the
288
+ package executing the command, not unreleased upstream prose.
289
+
290
+ ```sh
291
+ holmes-kit guidance check --target .
292
+ holmes-kit guidance refresh --target . --dry-run
293
+ holmes-kit guidance refresh --target .
294
+ ```
295
+
296
+ `check` never writes: exit 0 means current, 1 means missing or recognized outdated
297
+ guidance, and 2 means a conflict or read failure. `refresh` only changes AGENTS.md;
298
+ dry-run prints the before/proposed contents and writes nothing. Successful refresh
299
+ returns 0, refusal returns 2. The target directory must already exist.
300
+
301
+ Known historical generated sections can migrate automatically. Unknown edits,
302
+ malformed markers, and obsolete prohibitions outside the block require review;
303
+ neither `--force` on init nor upgrade overrides a guidance conflict. Preserve local
304
+ instructions, inspect the installed template, and resolve the conflicting sections
305
+ before retrying. `doctor` reports these states with the installed package version.
306
+ It does not rewrite the file or prove that hooks are running.
307
+
308
+ Updating a file does not replace instructions already loaded by an agent. Reload
309
+ instructions or start a new session. Common guidance is the same for Claude Code,
310
+ Codex CLI, and Antigravity; actual enforcement requires evidence from that session.
311
+
312
+ For maintainers, a common-text change requires a new guidance revision and an
313
+ immutable baseline in `agents-guidance-history.ts`; preserve previous baselines.
314
+ The root consistency check refuses a renderer change without that registration.
315
+ Then refresh the development AGENTS.md with the same command used by consumers.
316
+
317
+ Publication compares the original bytes again before renaming a temporary file.
318
+ This detects observed concurrent changes but is not an atomic compare-and-swap
319
+ against an unrelated writer racing the final rename. Serialize edits to AGENTS.md
320
+ during refresh. On ownership conflicts, dry-run shows the preserved original and
321
+ the expected block as a reference for manual review; it does not guess which custom
322
+ instructions should be removed or present that reference as an approved replacement.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "//": "@implements A-SPEC-209",
3
3
  "name": "@holmes-lab/holmes-kit",
4
- "version": "0.26.2",
4
+ "version": "0.28.0",
5
5
  "description": "Holmes-Kit — deterministic Agentic Software Engineering (ASE) harness with causal traceability (spec chain + D-CPG + RTM + phase guardrail)",
6
6
  "main": "dist/holmes/mcp/server.js",
7
7
  "types": "dist/holmes/mcp/server.d.ts",
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: holmes-superpowers-compat
3
+ description: Use when Superpowers design, worktree, TDD, review, subagent, verification, or finishing workflows operate in a Holmes-Kit governed project, including a "Preceding REQ not found." refusal.
4
+ ---
5
+
6
+ # Superpowers workflow under Holmes governance
7
+
8
+ Superpowers organizes work; Holmes authorizes governed source changes and records evidence. A Superpowers task, plan approval, passing command, reviewer parking, or branch finish does not replace an approved Holmes slice or its execution evidence.
9
+
10
+ ## Start, resume, or change checkout
11
+
12
+ 1. In the actual client session call `workspace_preflight` for the intended root. If it reports `mismatch`, stop: restart/reconnect MCP with that workspace's spec store, then call it again. Never author specs through a main-bound server for another checkout.
13
+ 2. Run `holmes-kit doctor --target <root> --agent claude|codex|antigravity`. This observes local preparation only. A missing file is not proof that a live hook is absent; a doctor-spawned MCP is not this session's MCP.
14
+ 3. Read `workspace_identity`. Legacy stays supported. For initialized-but-unregistered replicas, register only through the official workflow; do not copy `.ax/state`. A child checkout inheriting a parent marker is blocked until its binding is explicit.
15
+
16
+ ## Governed implementation sequence
17
+
18
+ | Superpowers stage | Holmes requirement before proceeding |
19
+ |---|---|
20
+ | `brainstorming`, `writing-plans` | Design/plan are evidence, then scaffold and approve REQ → H-SPEC → A-SPEC for the actual slice. Bounded chat approval alone does not permit source edits. |
21
+ | `using-git-worktrees`, restart | Repeat live binding and selected-harness preparation in the new session. Worktree placement is the user's decision. |
22
+ | `test-driven-development`, `tdd-slice` | Persist `maintenance_analyze`, place first-line anchors, write a real assertion test, observe `red-assertion` with `test_run`, then approve the matching T-SPEC. `red-error` is setup failure, not RED. |
23
+ | implementation | Change only approved files, then use `test_run` for GREEN. Do not make an unapproved stub just to compile a test. |
24
+ | `systematic-debugging`, `diagnosing-superpowers` | Preserve the refusal, runtime and tool transcript. Use Holmes remediation for a gate refusal; do not inspect or bypass guardrails. |
25
+ | `dispatching-parallel-agents`, `subagent-driven-development` | Give each child its root, bound store, slice, edit ownership, persisted-analysis digest, test command and refusal procedure. Each child verifies its own binding. Serialize implementation/evidence in one checkout. |
26
+ | `requesting-code-review`, `receiving-code-review` | Record material findings with `review_record`; a parked critical remains open. Confirm `review_status` after a real resolution. |
27
+ | `verification-before-completion`, `finishing-a-development-branch` | Run required evidence for final code, perform store-appropriate reconciliation, confirm approval/review status, then make the authorized integration or cleanup decision. Preserve evidence before deleting a worktree or helper artifact. |
28
+
29
+ ## Boundaries that must stay visible
30
+
31
+ - `using-superpowers`, `executing-plans`, `writing-skills`, and visual/helper artifacts remain their own workflow artifacts. Do not copy task-start/task-done or review-package state into the Holmes ledger.
32
+ - `verification-before-completion` is necessary evidence, but it does not seal specs or resolve a critical finding.
33
+ - Claude, Codex, and Antigravity use the same governance sequence. Disk wiring, AGY links, and Codex discovery are preparation observations; only an actual session transcript proves active loading or hook inheritance.
34
+ - External diagnosis uploads, browser/visual artifacts, paid sessions, merge, push, publish, and discard retain their existing user-authorization boundaries.
35
+
36
+ ## Stop conditions and next action
37
+
38
+ | Observation | Next action |
39
+ |---|---|
40
+ | main-bound MCP, requested worktree | reconnect/restart for the requested root and rerun preflight |
41
+ | import or collection failure | diagnose until an assertion RED exists; do not call it valid RED |
42
+ | two writers in one checkout | serialize evidence or use separately bound checkouts |
43
+ | parked critical | keep it open and resolve/review it under the approved slice |
44
+ | Superpowers task says done | obtain Holmes review, reconciliation, final evidence, then an authorized finish decision |
45
+
46
+ This playbook is advisory guidance. It does not prove agent compliance or active enforcement; inspect the live session and official Holmes evidence.