@holmes-lab/holmes-kit 0.41.2 → 0.41.3

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 (103) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/README.md +28 -5
  3. package/bin/holmes-mcp.js +36 -1
  4. package/dist/.build-id +1 -1
  5. package/dist/holmes/cli/claude-switches.d.ts +9 -0
  6. package/dist/holmes/cli/claude-switches.js +11 -8
  7. package/dist/holmes/cli/doctor.d.ts +7 -1
  8. package/dist/holmes/cli/doctor.js +63 -20
  9. package/dist/holmes/cli/holmes-hook-id.d.ts +9 -0
  10. package/dist/holmes/cli/holmes-hook-id.js +22 -0
  11. package/dist/holmes/cli/hook-failure-posture.d.ts +44 -0
  12. package/dist/holmes/cli/hook-failure-posture.js +65 -0
  13. package/dist/holmes/cli/index.js +3 -1
  14. package/dist/holmes/cli/init.d.ts +6 -0
  15. package/dist/holmes/cli/init.js +151 -3
  16. package/dist/holmes/cli/native-deps.d.ts +10 -4
  17. package/dist/holmes/cli/native-deps.js +30 -29
  18. package/dist/holmes/cli/run-wiring.js +4 -2
  19. package/dist/holmes/cli/runtime-binding.d.ts +24 -0
  20. package/dist/holmes/cli/runtime-binding.js +67 -25
  21. package/dist/holmes/cli/settings-merge.d.ts +3 -2
  22. package/dist/holmes/cli/settings-merge.js +11 -9
  23. package/dist/holmes/config/config.d.ts +6 -0
  24. package/dist/holmes/config/config.js +23 -3
  25. package/dist/holmes/config/judgement-keys.d.ts +20 -0
  26. package/dist/holmes/config/judgement-keys.js +100 -0
  27. package/dist/holmes/config/project-caps.js +3 -2
  28. package/dist/holmes/governance/autonomous-shell.js +1 -1
  29. package/dist/holmes/governance/autonomy.d.ts +27 -1
  30. package/dist/holmes/governance/autonomy.js +126 -6
  31. package/dist/holmes/governance/wiring-receipt.d.ts +7 -0
  32. package/dist/holmes/governance/wiring-receipt.js +84 -0
  33. package/dist/holmes/guardrail/cli-root.d.ts +31 -0
  34. package/dist/holmes/guardrail/cli-root.js +261 -0
  35. package/dist/holmes/guardrail/command-traits.d.ts +2 -0
  36. package/dist/holmes/guardrail/command-traits.js +26 -1
  37. package/dist/holmes/guardrail/impact-gate.d.ts +17 -1
  38. package/dist/holmes/guardrail/impact-gate.js +44 -5
  39. package/dist/holmes/guardrail/outward-acts.js +10 -3
  40. package/dist/holmes/guardrail/package-manager-acts.d.ts +41 -0
  41. package/dist/holmes/guardrail/package-manager-acts.js +1298 -0
  42. package/dist/holmes/guardrail/refusal-codes.js +9 -1
  43. package/dist/holmes/guardrail/shell-syntax.d.ts +3 -0
  44. package/dist/holmes/guardrail/shell-syntax.js +7 -2
  45. package/dist/holmes/guardrail/write-target.d.ts +20 -0
  46. package/dist/holmes/guardrail/write-target.js +168 -2
  47. package/dist/holmes/hooks/pre-tool-use.d.ts +110 -3
  48. package/dist/holmes/hooks/pre-tool-use.js +1208 -60
  49. package/dist/holmes/mcp/evidence-artifact.d.ts +112 -0
  50. package/dist/holmes/mcp/evidence-artifact.js +2 -0
  51. package/dist/holmes/mcp/handlers/maintenance-evidence.d.ts +2 -1
  52. package/dist/holmes/mcp/handlers/maintenance-evidence.js +24 -2
  53. package/dist/holmes/mcp/handlers/operator-inspection.d.ts +1 -1
  54. package/dist/holmes/mcp/handlers/operator-inspection.js +2 -2
  55. package/dist/holmes/mcp/handlers/requirement-triage.d.ts +1 -1
  56. package/dist/holmes/mcp/handlers/requirement-triage.js +3 -2
  57. package/dist/holmes/mcp/handlers/spec-approval.d.ts +1 -1
  58. package/dist/holmes/mcp/handlers/spec-approval.js +6 -6
  59. package/dist/holmes/mcp/handlers/test-execution.d.ts +8 -0
  60. package/dist/holmes/mcp/handlers/test-execution.js +12 -6
  61. package/dist/holmes/mcp/handlers.d.ts +16 -7
  62. package/dist/holmes/mcp/maintenance-evidence.d.ts +11 -82
  63. package/dist/holmes/mcp/maintenance-evidence.js +57 -2
  64. package/dist/holmes/mcp/outcome-replay.d.ts +18 -0
  65. package/dist/holmes/mcp/outcome-replay.js +85 -0
  66. package/dist/holmes/mcp/outcome-windows.d.ts +136 -0
  67. package/dist/holmes/mcp/outcome-windows.js +236 -0
  68. package/dist/holmes/mcp/tool-schemas.js +1 -1
  69. package/dist/holmes/project/hook-specs-arg.d.ts +4 -0
  70. package/dist/holmes/project/hook-specs-arg.js +39 -0
  71. package/dist/holmes/project/install-layout.d.ts +11 -0
  72. package/dist/holmes/project/install-layout.js +109 -0
  73. package/dist/holmes/project/install-scripts-policy.d.ts +4 -1
  74. package/dist/holmes/project/install-scripts-policy.js +6 -3
  75. package/dist/holmes/project/native-recovery.d.ts +29 -0
  76. package/dist/holmes/project/native-recovery.js +62 -0
  77. package/dist/holmes/project/root.d.ts +6 -0
  78. package/dist/holmes/project/root.js +15 -3
  79. package/dist/holmes/project/wiring-receipt-format.d.ts +20 -0
  80. package/dist/holmes/project/wiring-receipt-format.js +42 -0
  81. package/dist/holmes/project/workspace-preflight.d.ts +9 -0
  82. package/dist/holmes/project/workspace-preflight.js +40 -1
  83. package/dist/holmes/review/classification-replay.d.ts +53 -0
  84. package/dist/holmes/review/classification-replay.js +78 -0
  85. package/dist/holmes/review/head-worktree.js +5 -4
  86. package/dist/holmes/review/run-provenance.js +3 -2
  87. package/dist/holmes/review/test-evidence.js +2 -2
  88. package/dist/holmes/review/test-outcomes.js +3 -1
  89. package/dist/holmes/rtm/graph-store.d.ts +5 -0
  90. package/dist/holmes/rtm/graph-store.js +12 -4
  91. package/dist/holmes/rtm/native-driver.d.ts +42 -0
  92. package/dist/holmes/rtm/native-driver.js +147 -0
  93. package/dist/holmes/rtm/rtm-graph.js +11 -2
  94. package/dist/holmes/runtime/dispatch.d.ts +6 -0
  95. package/dist/holmes/runtime/dispatch.js +51 -2
  96. package/dist/holmes/runtime/hook-process.d.ts +6 -0
  97. package/dist/holmes/runtime/hook-process.js +3 -3
  98. package/dist/holmes/update/semver-strict.d.ts +3 -0
  99. package/dist/holmes/update/semver-strict.js +58 -0
  100. package/docs/install-guide.md +8 -1
  101. package/package.json +1 -1
  102. package/playbooks/tdd-slice/PLAYBOOK.md +1 -1
  103. package/release-history.json +36 -1
@@ -34,8 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
36
  exports.DISPATCH_REFUSAL = void 0;
37
+ exports.preToolUseAnswerProblem = preToolUseAnswerProblem;
37
38
  exports.runDispatch = runDispatch;
38
- // @implements A-SPEC-751, A-SPEC-751.1, A-SPEC-751.5, A-SPEC-751.6, A-SPEC-751.7, A-SPEC-754, A-SPEC-769.10, A-SPEC-772.1
39
+ // @implements A-SPEC-751, A-SPEC-751.1, A-SPEC-751.5, A-SPEC-751.6, A-SPEC-751.7, A-SPEC-754, A-SPEC-769.10, A-SPEC-772.1, A-SPEC-772.20, A-SPEC-772.22
39
40
  const path = __importStar(require("node:path"));
40
41
  const node_child_process_1 = require("node:child_process");
41
42
  const binding_1 = require("./binding");
@@ -93,6 +94,42 @@ function hintsFromInput(input) {
93
94
  }
94
95
  return hints;
95
96
  }
97
+ /**
98
+ * @implements A-SPEC-772.22 — why a PreToolUse answer is not one, or null. claude/codex: the gate's own contract
99
+ * (validHookAnswer, A-SPEC-728.4 — restated here because this module imports nothing of the gate; a test holds the two
100
+ * equal); antigravity: its adapter's `{decision: allow|deny|ask}` with exit 0.
101
+ */
102
+ function preToolUseAnswerProblem(harness, stdout, code) {
103
+ if (stdout.trim() === '')
104
+ return 'empty';
105
+ let parsed;
106
+ try {
107
+ parsed = JSON.parse(stdout);
108
+ }
109
+ catch {
110
+ return 'not-json';
111
+ }
112
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
113
+ return 'wrong-shape';
114
+ const decisions = new Set(['allow', 'deny', 'ask']);
115
+ if (harness === 'antigravity') {
116
+ const d = parsed.decision;
117
+ if (typeof d !== 'string' || !decisions.has(d))
118
+ return 'wrong-shape';
119
+ return code === 0 ? null : `exit ${code}`;
120
+ }
121
+ const h = parsed.hookSpecificOutput;
122
+ if (h === null || typeof h !== 'object' || Array.isArray(h))
123
+ return 'wrong-shape';
124
+ const { hookEventName, permissionDecision } = h;
125
+ if (hookEventName !== 'PreToolUse')
126
+ return 'wrong-shape';
127
+ if (permissionDecision !== undefined && (typeof permissionDecision !== 'string' || !decisions.has(permissionDecision)))
128
+ return 'wrong-shape';
129
+ if (code !== 0 && code !== 2)
130
+ return `exit ${code}`;
131
+ return (permissionDecision === 'deny') === (code === 2) ? null : 'decision/exit mismatch';
132
+ }
96
133
  async function runDispatch(opts) {
97
134
  const started = performance.now();
98
135
  let selectedBuild;
@@ -197,12 +234,24 @@ async function runDispatch(opts) {
197
234
  finally {
198
235
  phaseChild = Math.round(performance.now() - childStarted);
199
236
  }
200
- if (result.signal) {
237
+ // @implements A-SPEC-772.20 — a gate child ended by a signal never decided: refuse (killing the dispatcher with the
238
+ // same signal read as a failed hook, and with onFailure unset every tool passed — measured, an OOM kill included).
239
+ // A signal the dispatcher itself received (runHookChild forwarded it) still ends it with that signal, as before.
240
+ if (result.signal && result.external === true) {
201
241
  process.kill(process.pid, result.signal);
202
242
  return;
203
243
  }
244
+ if (result.signal)
245
+ throw new Error(`Selected hook runtime ended by ${result.signal} without a decision`);
204
246
  if (!result.bytes.length && result.code !== 0)
205
247
  throw new Error(`Selected hook runtime failed (exit ${result.code}) without a decision`);
248
+ // @implements A-SPEC-772.22 — a PreToolUse answer is forwarded only when it is one (empty output, null or {} with
249
+ // exit 0 let the call through; a decision then exit 1 was a failed hook — review B, measured)
250
+ if (opts.entry === 'pre-tool-use') {
251
+ const problem = preToolUseAnswerProblem(opts.harness, Buffer.from(result.bytes).toString('utf8'), result.code ?? 1);
252
+ if (problem !== null)
253
+ throw new Error(`Selected hook runtime gave no valid answer (${problem})`);
254
+ }
206
255
  if (result.bytes.length) {
207
256
  try {
208
257
  JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(result.bytes));
@@ -10,10 +10,16 @@ export declare const STOP_HOOK_BUDGET_MS = 60000;
10
10
  export declare const STOP_HOOK_TIMEOUT_SECONDS = 75;
11
11
  export declare function hookBudgetFor(entry: string): number;
12
12
  export declare function boundedHookBudget(value: number | undefined, maximum: number): number;
13
+ /**
14
+ * @implements A-SPEC-772.20 — `external`: the signal is one the dispatcher itself received (and forwarded); a child that
15
+ * ended by a signal of its own has `external: false`. The two had the same shape, so the dispatcher could not refuse one
16
+ * without breaking the other.
17
+ */
13
18
  export interface HookChildResult {
14
19
  bytes: Buffer;
15
20
  code: number | null;
16
21
  signal: NodeJS.Signals | null;
22
+ external?: boolean;
17
23
  }
18
24
  /** Bounded hook transport only. Persistent MCP transports do not call this function. */
19
25
  export declare function runHookChild(child: ChildProcess, input: Buffer, remainingMs: number, cleanupMs: number): Promise<HookChildResult>;
@@ -4,7 +4,7 @@ exports.STOP_HOOK_TIMEOUT_SECONDS = exports.STOP_HOOK_BUDGET_MS = exports.HOOK_C
4
4
  exports.hookBudgetFor = hookBudgetFor;
5
5
  exports.boundedHookBudget = boundedHookBudget;
6
6
  exports.runHookChild = runHookChild;
7
- // @implements A-SPEC-751.1
7
+ // @implements A-SPEC-751.1, A-SPEC-772.20
8
8
  // @implements A-SPEC-769.10
9
9
  const node_child_process_1 = require("node:child_process");
10
10
  exports.HOOK_BUDGET_MS = 18_000;
@@ -89,7 +89,7 @@ function runHookChild(child, input, remainingMs, cleanupMs) {
89
89
  const signals = ['SIGTERM', 'SIGINT', 'SIGHUP'];
90
90
  const handlers = signals.map(signal => () => {
91
91
  externalSignal ??= signal;
92
- void finish(undefined, { bytes: Buffer.alloc(0), code: null, signal: externalSignal }, true);
92
+ void finish(undefined, { bytes: Buffer.alloc(0), code: null, signal: externalSignal, external: true }, true);
93
93
  });
94
94
  const timer = setTimeout(() => { void finish(new Error('Selected hook runtime deadline exceeded'), undefined, true); }, Math.max(1, remainingMs));
95
95
  const finish = async (error, result, stop = false) => {
@@ -102,7 +102,7 @@ function runHookChild(child, input, remainingMs, cleanupMs) {
102
102
  cleanupFailure = await stopOwnedChild(child, () => closed, cleanupMs);
103
103
  if (externalSignal) {
104
104
  error = undefined;
105
- result = { bytes: Buffer.alloc(0), code: null, signal: externalSignal };
105
+ result = { bytes: Buffer.alloc(0), code: null, signal: externalSignal, external: true };
106
106
  }
107
107
  signals.forEach((signal, i) => process.removeListener(signal, handlers[i]));
108
108
  child.stdout?.removeListener('data', onData);
@@ -0,0 +1,3 @@
1
+ export declare function isStrictSemver(v: string): boolean;
2
+ /** -1 | 0 | 1 by semver precedence (build metadata ignored), or null when either is not strict semver. */
3
+ export declare function strictSemverCompare(a: string, b: string): -1 | 0 | 1 | null;
@@ -0,0 +1,58 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.isStrictSemver = isStrictSemver;
4
+ exports.strictSemverCompare = strictSemverCompare;
5
+ // @implements A-SPEC-772.23
6
+ /**
7
+ * Strict semver (`MAJOR.MINOR.PATCH`, optional `-pre` and `+build`) and its order, prereleases included. The lenient
8
+ * `compareSemver` (update-notice.ts) reads a non-numeric field as 0, so a label of `garbage`, `99` or `1e3` compared as a
9
+ * version and a prerelease equalled its release (review A of 772.16–772.17, measured). A guard that compares versions
10
+ * uses this one, and treats `null` (not strict) as "cannot judge".
11
+ */
12
+ const STRICT = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9]\d*|\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
13
+ function isStrictSemver(v) {
14
+ return v.length <= 64 && STRICT.test(v);
15
+ }
16
+ /** -1 | 0 | 1 by semver precedence (build metadata ignored), or null when either is not strict semver. */
17
+ function strictSemverCompare(a, b) {
18
+ if (!isStrictSemver(a) || !isStrictSemver(b))
19
+ return null;
20
+ const pa = STRICT.exec(a);
21
+ const pb = STRICT.exec(b);
22
+ for (let i = 1; i <= 3; i++) {
23
+ const x = BigInt(pa[i]);
24
+ const y = BigInt(pb[i]);
25
+ if (x !== y)
26
+ return x < y ? -1 : 1;
27
+ }
28
+ const ra = pa[4];
29
+ const rb = pb[4];
30
+ if (ra === undefined && rb === undefined)
31
+ return 0;
32
+ if (ra === undefined)
33
+ return 1; // a release is above its prereleases
34
+ if (rb === undefined)
35
+ return -1;
36
+ const ia = ra.split('.');
37
+ const ib = rb.split('.');
38
+ for (let i = 0; i < Math.max(ia.length, ib.length); i++) {
39
+ if (ia[i] === undefined)
40
+ return -1;
41
+ if (ib[i] === undefined)
42
+ return 1;
43
+ const na = /^\d+$/.test(ia[i]);
44
+ const nb = /^\d+$/.test(ib[i]);
45
+ if (na && nb) {
46
+ const x = BigInt(ia[i]);
47
+ const y = BigInt(ib[i]);
48
+ if (x !== y)
49
+ return x < y ? -1 : 1;
50
+ continue;
51
+ }
52
+ if (na !== nb)
53
+ return na ? -1 : 1; // numeric identifiers are below alphanumeric ones
54
+ if (ia[i] !== ib[i])
55
+ return ia[i] < ib[i] ? -1 : 1;
56
+ }
57
+ return 0;
58
+ }
@@ -187,9 +187,16 @@ only if `$LASTEXITCODE` is zero; `&&` requires a newer PowerShell.
187
187
  |---|---|
188
188
  | A project that depends on holmes-kit | `npm install-scripts approve better-sqlite3@12.11.1` then `npm rebuild better-sqlite3 --foreground-scripts` (from the project root; this writes the pin into YOUR package.json) |
189
189
  | This repository checkout | already approved — `npm rebuild better-sqlite3 --foreground-scripts` if the binary is missing |
190
- | Global (`npm install -g`) | `npm rebuild -g better-sqlite3 --foreground-scripts --allow-scripts=better-sqlite3` — a per-command flag scoped to one package; no npm config is changed. Target the dependency: `rebuild -g @holmes-lab/holmes-kit` re-links the bin and dies `EEXIST` under npm 12 (measured). If this fails `EPERM` under `C:\Program Files\nodejs`, your prefix is protected — see "Before `npm install -g`" above |
190
+ | Global (`npm install -g`) | `npm rebuild -g better-sqlite3 --foreground-scripts --allow-scripts=better-sqlite3` (installed with a prefix, `npm i -g --prefix P`? `holmes-kit doctor` prints the exact command — it alone names `--prefix`, and a path with a space or shell character appears as `<PREFIX>` with the path on its own line) — a per-command flag scoped to one package; no npm config is changed. Target the dependency: `rebuild -g @holmes-lab/holmes-kit` re-links the bin and dies `EEXIST` under npm 12 (measured). If this fails `EPERM` under `C:\Program Files\nodejs`, your prefix is protected — see "Before `npm install -g`" above |
191
191
  | Bare `npx` | not repairable in place — do a local install and use the first row |
192
192
 
193
+ **Known limitations of the printed recovery commands.**
194
+
195
+ - `holmes-kit doctor` names `--prefix` for a default global install when it cannot read npm's default prefix, or reaches it through a symbolic link. The directory is the same one, so nothing is installed elsewhere; the flag is redundant.
196
+ - holmes-kit does not quote a path for your shell. A prefix holding anything but letters, digits and `_ . : / -` (and `\` on Windows) — a space, Hangul, a quote or any shell character — appears as `<PREFIX>` in the command, with the path on its own line: put it in, quoted the way your shell quotes.
197
+ - A drive root alone (`C:`) means that drive's current directory to npm, so it is shown as `<PREFIX>` too.
198
+ - On Windows the commands are written for PowerShell or cmd; in Git Bash, quote a path holding `\`. None of PowerShell, cmd or Git Bash was measured running these exact commands.
199
+
193
200
  Never use `--dangerously-allow-all-scripts` or a global `allow-scripts` config: the point of the
194
201
  policy is that only the reviewed package runs code at install time. Older npm 11 (measured 11.6.2)
195
202
  ignores the `allowScripts` field and runs scripts as before; npm 11.19 honours it exactly like 12.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "//": "@implements A-SPEC-209, A-SPEC-794.58",
3
3
  "name": "@holmes-lab/holmes-kit",
4
- "version": "0.41.2",
4
+ "version": "0.41.3",
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",
@@ -25,7 +25,7 @@ holmes-kit은 이 규율의 상당 부분을 **헌법 조항으로 집행**한
25
25
  - `[ART-8]` 테스트-우선은 가정이 아니라 **관측**된다 — 소스가 바뀐 A-SPEC은 원장에
26
26
  `red-assertion`(코드 전) → `green`(코드 후) 시퀀스를 남겨야 한다. 코드 뒤에 써서 즉시 통과한
27
27
  테스트는 실패를 관측한 적이 없으니 아무것도 증명하지 못한다. 기본은 `track`(관측), 오너가
28
- 실측 후 `strict`(차단)로 올린다(config `redFirstEvidence`).
28
+ 실측 후 `strict`(차단)로 올린다. 그 설정은 오너의 것이고, 에이전트는 바꾸지 않고 오너에게 묻는다.
29
29
 
30
30
  ## Red-Green-Refactor (holmes 판)
31
31
 
@@ -1,8 +1,43 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "package": "@holmes-lab/holmes-kit",
4
- "reviewedAt": "2026-11-14",
4
+ "reviewedAt": "2026-11-18",
5
5
  "entries": [
6
+ {
7
+ "version": "0.41.3",
8
+ "title": {
9
+ "ko": "에이전트가 자기를 다스리는 게이트를 끄거나 바꿔치지 못하게 하기",
10
+ "en": "Keep an agent from switching off or swapping the gate that governs it"
11
+ },
12
+ "benefits": {
13
+ "ko": [
14
+ "holmes-kit init과 upgrade에서 게이트 연결을 바꾸는 옵션(--remove, --force, --matcher — --matcher \".*\"는 자유 —, --specs-dir, --settings, --autonomy)과 다른 사본이나 더 오래된 사본에서 하는 재연결은 오너의 승인(governance-wiring 또는 config-write)이 필요합니다. 게이트가 한 줄 전체를 읽을 수 없는 꼴로 holmes-kit init·upgrade·ledger·runtime-binding을 실행하는 셸 줄은 거부되며(line.unread) 승인으로도 풀리지 않으니, 평범한 한 줄로 쓰십시오. 인자 없는 holmes-kit init은 지워진 연결을 그대로 복구합니다.",
15
+ "holmes-kit을 제거하거나, 최신도 아니고 현재 다스리는 버전보다 높지도 않은 버전으로 지정하거나(읽기가 아닌 패키지 관리자 명령, 또는 report 실행이 아닌 러너), 다른 패키지로 바꿔치거나 link하는 명령, 그 항목을 지우거나 낮추거나 바꿔치는 manifest 편집, holmes-kit을 담은 package.json에 대한 셸 쓰기는 오너 몫입니다. 버전 없이 또는 @latest로 설치·갱신하는 명령과 holmes-kit upgrade는 그대로 자유입니다.",
16
+ "ax.config.json의 판단 키를 바꾸는 쓰기는 올리든 내리든, 그 파일 이름을 적은 쓰기라면(하드링크 포함) 오너의 승인이 필요합니다. 파일 이름을 적지 않는 쓰기(git apply, checkout, 변수, 스크립트)는 판정하지 않습니다. semantic.maxTier나 autonomy.ceiling을 낮추는 것은 그대로 자유입니다.",
17
+ "거버넌스 프로젝트에서 PreToolUse 훅의 답이 유효한 결정이 아니면(JSON 객체 하나가 아니거나, 이벤트·결정이 틀리거나, 종료 코드가 어긋나면) 거부로 바뀌고, 판정 작업자의 출력은 stderr로 갑니다. 라우팅된 게이트가 신호로 죽거나 유효한 결정을 내지 않아도 도구 사용이 거부됩니다. doctor와 workspace_preflight는 훅이 실패할 때 도구가 통과되는지를 알려 줍니다(doctor: hook failure posture, preflight: hook-failure).",
18
+ "작업 트리에서만 바뀐 로컬 전용 연결 파일(skip-worktree 또는 assume-unchanged)은, 그 바이트가 runtime binding 영수증에 기록된 것과 같으면 원칙 7에서 더는 열지 않은 파일로 판정되지 않습니다.",
19
+ "네이티브 드라이버가 없으면 도구가 실패하기 전에 workspace_preflight와 MCP 서버 시작 줄이 원인과 복구 명령을 알려 주고, 그래프 파일은 지워지지 않습니다.",
20
+ "maintenance_analyze 예측은 다음 분석 전까지의 커밋으로만 채점되고, maintenance_calibration이 파일 단위 점수(fileScores)를 돌려줍니다."
21
+ ],
22
+ "en": [
23
+ "holmes-kit init and upgrade options that re-wire the gate (--remove, --force, --matcher — --matcher \".*\" stays free —, --specs-dir, --settings, --autonomy) and re-wiring from another or an older copy need a governance-wiring or config-write approval. A shell line that runs holmes-kit init, upgrade, ledger or runtime-binding in a form the gate cannot read whole is refused (line.unread) — write it as a plain line; no approval lifts it. A plain holmes-kit init still repairs removed wiring.",
24
+ "A package-manager command that removes holmes-kit, names it at a version that is neither latest nor above the governing one (in any command but a read, or in a runner other than a report run), swaps or links it, a manifest edit that removes, lowers or swaps its entry, and a shell write to a package.json that names holmes-kit, are the owner's. An unversioned or @latest install or update and holmes-kit upgrade stay free.",
25
+ "A write that changes a judgement key of ax.config.json, raising or lowering, by any write that names the file (a hard link included), needs the owner's approval; a write that does not name it (git apply, a checkout, a variable, a script) is not judged; lowering semantic.maxTier or autonomy.ceiling stays free.",
26
+ "In a governed project, a PreToolUse answer that is not a valid decision (not one JSON object, a wrong event or decision, an exit code that disagrees) is replaced by a deny, and the judging worker's output goes to stderr. A routed gate that died by a signal or gave no valid decision refuses the tool too. doctor and workspace_preflight say whether a failed hook lets tools through (doctor: hook failure posture; preflight: hook-failure).",
27
+ "A local-only wiring file (skip-worktree or assume-unchanged) changed only in the working tree, whose bytes match what the runtime binding receipt recorded, is no longer judged unopened under principle 7.",
28
+ "A missing native driver is named before a tool fails: workspace_preflight and the MCP server's start-up line give the cause and the recovery, and no graph file is deleted for it.",
29
+ "A maintenance_analyze prediction is scored only on the commits up to the next analysis, and maintenance_calibration returns per-file scores (fileScores)."
30
+ ]
31
+ },
32
+ "upgrade": {
33
+ "ko": "에이전트가 하던 일 중 일부(게이트 재연결 옵션, holmes-kit 버전 고정·제거, ax.config.json 판단 키 변경)가 이제 오너의 승인 폼으로 갑니다. 라우팅된 작업공간은 이 빌드로 holmes-kit runtime-binding setup을 다시 실행해야 새 디스패처 거부가 적용됩니다(오너의 작업). PATH의 holmes-kit이 연결된 설치와 다르면 인자 없는 init도 승인이 필요하므로, 연결된 설치의 bin/holmes-kit.js나 npx @holmes-lab/holmes-kit init을 쓰십시오. 훅 명령이 --specs로 스펙 저장소를 적으므로 HOLMES_SPECS 환경 변수는 더 이상 스펙 저장소를 고르지 못합니다. full 프로필에서 publish 플래그가 꺼져 있으면 gh·hub·glab의 release 쓰기가 거부됩니다. maintenance_calibration의 falsePositives/falseNegatives는 세는 집합이 달라져 0.41.2와 값이 다릅니다.",
34
+ "en": "Some acts an agent used to do (re-wiring options, pinning or removing holmes-kit, changing a judgement key of ax.config.json) now go to the owner's approval form. Routed workspaces get the new dispatcher refusals only after holmes-kit runtime-binding setup is run again with this build, which is the owner's act. When the holmes-kit on PATH is another install than the wired one, a plain init needs the approval too; run the wired install's bin/holmes-kit.js or npx @holmes-lab/holmes-kit init instead. Hook commands now name their spec store with --specs, so HOLMES_SPECS no longer chooses it. Under a full profile with the publish flag off, gh, hub and glab release writes are refused. maintenance_calibration's falsePositives/falseNegatives count a different set, so they differ from 0.41.2."
35
+ },
36
+ "limitations": {
37
+ "ko": "셸 줄 규칙은 사고 방지이며 경계가 아닙니다. 한 줄에 보이는 것만 판단하므로, 파일에 써 두고 나중에 실행하는 프로그램, 표에 없는 래퍼, 그룹·서브셸 안의 판독기 같은 의도적 우회는 막지 못하고 CHANGELOG의 알려진 한계에 이름이 있습니다. 게이트 연결을 사후에 검사하는 무결성 확인은 0.41.4에 계획되어 있습니다. 같은 줄에 holmes-kit과 init·upgrade·ledger·runtime-binding이 함께 있을 때만 생기는 과차단 대가도 CHANGELOG에 적혀 있습니다. holmes-kit 버전을 바꾸는 패키지 관리자 명령의 판정도 흔한 꼴만 막는 사고 방지이며, 설정으로 고른 버전(.npmrc, npm config set tag, --tag)이나 읽을 수 없는 대상($(npm pack), 변수)은 판정하지 않습니다 — 고의 교체의 장벽은 0.41.4의 사후 무결성 검사입니다.",
38
+ "en": "The shell-line rule is accident prevention, not a boundary: it judges what one line shows, so deliberate bypasses such as a program written to a file and run later, a wrapper outside the gate's table or a reader inside a group or subshell are not stopped and are named in the CHANGELOG's Known limitations. An after-the-fact integrity check of the gate's wiring is planned for 0.41.4. The over-blocking costs, which arise only on a line that also names holmes-kit and init, upgrade, ledger or runtime-binding, are listed there too. The package-manager judgement of holmes-kit's version is accident prevention too: it stops the common forms and does not judge a version chosen by configuration (.npmrc, npm config set tag, --tag) or a target it cannot read ($(npm pack), a variable); the barrier against a deliberate swap is 0.41.4's after-the-fact integrity check."
39
+ }
40
+ },
6
41
  {
7
42
  "version": "0.41.2",
8
43
  "title": {