@holmes-lab/holmes-kit 0.41.1 → 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 (105) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +29 -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/release-history.d.ts +21 -0
  19. package/dist/holmes/cli/release-history.js +116 -0
  20. package/dist/holmes/cli/run-wiring.js +4 -2
  21. package/dist/holmes/cli/runtime-binding.d.ts +24 -0
  22. package/dist/holmes/cli/runtime-binding.js +67 -25
  23. package/dist/holmes/cli/settings-merge.d.ts +3 -2
  24. package/dist/holmes/cli/settings-merge.js +11 -9
  25. package/dist/holmes/config/config.d.ts +6 -0
  26. package/dist/holmes/config/config.js +23 -3
  27. package/dist/holmes/config/judgement-keys.d.ts +20 -0
  28. package/dist/holmes/config/judgement-keys.js +100 -0
  29. package/dist/holmes/config/project-caps.js +3 -2
  30. package/dist/holmes/governance/autonomous-shell.js +1 -1
  31. package/dist/holmes/governance/autonomy.d.ts +27 -1
  32. package/dist/holmes/governance/autonomy.js +126 -6
  33. package/dist/holmes/governance/wiring-receipt.d.ts +7 -0
  34. package/dist/holmes/governance/wiring-receipt.js +84 -0
  35. package/dist/holmes/guardrail/cli-root.d.ts +31 -0
  36. package/dist/holmes/guardrail/cli-root.js +261 -0
  37. package/dist/holmes/guardrail/command-traits.d.ts +2 -0
  38. package/dist/holmes/guardrail/command-traits.js +26 -1
  39. package/dist/holmes/guardrail/impact-gate.d.ts +17 -1
  40. package/dist/holmes/guardrail/impact-gate.js +44 -5
  41. package/dist/holmes/guardrail/outward-acts.js +10 -3
  42. package/dist/holmes/guardrail/package-manager-acts.d.ts +41 -0
  43. package/dist/holmes/guardrail/package-manager-acts.js +1298 -0
  44. package/dist/holmes/guardrail/refusal-codes.js +9 -1
  45. package/dist/holmes/guardrail/shell-syntax.d.ts +3 -0
  46. package/dist/holmes/guardrail/shell-syntax.js +7 -2
  47. package/dist/holmes/guardrail/write-target.d.ts +20 -0
  48. package/dist/holmes/guardrail/write-target.js +168 -2
  49. package/dist/holmes/hooks/pre-tool-use.d.ts +110 -3
  50. package/dist/holmes/hooks/pre-tool-use.js +1208 -60
  51. package/dist/holmes/mcp/evidence-artifact.d.ts +112 -0
  52. package/dist/holmes/mcp/evidence-artifact.js +2 -0
  53. package/dist/holmes/mcp/handlers/maintenance-evidence.d.ts +2 -1
  54. package/dist/holmes/mcp/handlers/maintenance-evidence.js +24 -2
  55. package/dist/holmes/mcp/handlers/operator-inspection.d.ts +1 -1
  56. package/dist/holmes/mcp/handlers/operator-inspection.js +2 -2
  57. package/dist/holmes/mcp/handlers/requirement-triage.d.ts +1 -1
  58. package/dist/holmes/mcp/handlers/requirement-triage.js +3 -2
  59. package/dist/holmes/mcp/handlers/spec-approval.d.ts +1 -1
  60. package/dist/holmes/mcp/handlers/spec-approval.js +6 -6
  61. package/dist/holmes/mcp/handlers/test-execution.d.ts +8 -0
  62. package/dist/holmes/mcp/handlers/test-execution.js +12 -6
  63. package/dist/holmes/mcp/handlers.d.ts +16 -7
  64. package/dist/holmes/mcp/maintenance-evidence.d.ts +11 -82
  65. package/dist/holmes/mcp/maintenance-evidence.js +57 -2
  66. package/dist/holmes/mcp/outcome-replay.d.ts +18 -0
  67. package/dist/holmes/mcp/outcome-replay.js +85 -0
  68. package/dist/holmes/mcp/outcome-windows.d.ts +136 -0
  69. package/dist/holmes/mcp/outcome-windows.js +236 -0
  70. package/dist/holmes/mcp/tool-schemas.js +1 -1
  71. package/dist/holmes/project/hook-specs-arg.d.ts +4 -0
  72. package/dist/holmes/project/hook-specs-arg.js +39 -0
  73. package/dist/holmes/project/install-layout.d.ts +11 -0
  74. package/dist/holmes/project/install-layout.js +109 -0
  75. package/dist/holmes/project/install-scripts-policy.d.ts +4 -1
  76. package/dist/holmes/project/install-scripts-policy.js +6 -3
  77. package/dist/holmes/project/native-recovery.d.ts +29 -0
  78. package/dist/holmes/project/native-recovery.js +62 -0
  79. package/dist/holmes/project/root.d.ts +6 -0
  80. package/dist/holmes/project/root.js +15 -3
  81. package/dist/holmes/project/wiring-receipt-format.d.ts +20 -0
  82. package/dist/holmes/project/wiring-receipt-format.js +42 -0
  83. package/dist/holmes/project/workspace-preflight.d.ts +9 -0
  84. package/dist/holmes/project/workspace-preflight.js +40 -1
  85. package/dist/holmes/review/classification-replay.d.ts +53 -0
  86. package/dist/holmes/review/classification-replay.js +78 -0
  87. package/dist/holmes/review/head-worktree.js +5 -4
  88. package/dist/holmes/review/run-provenance.js +3 -2
  89. package/dist/holmes/review/test-evidence.js +2 -2
  90. package/dist/holmes/review/test-outcomes.js +3 -1
  91. package/dist/holmes/rtm/graph-store.d.ts +5 -0
  92. package/dist/holmes/rtm/graph-store.js +12 -4
  93. package/dist/holmes/rtm/native-driver.d.ts +42 -0
  94. package/dist/holmes/rtm/native-driver.js +147 -0
  95. package/dist/holmes/rtm/rtm-graph.js +11 -2
  96. package/dist/holmes/runtime/dispatch.d.ts +6 -0
  97. package/dist/holmes/runtime/dispatch.js +51 -2
  98. package/dist/holmes/runtime/hook-process.d.ts +6 -0
  99. package/dist/holmes/runtime/hook-process.js +3 -3
  100. package/dist/holmes/update/semver-strict.d.ts +3 -0
  101. package/dist/holmes/update/semver-strict.js +58 -0
  102. package/docs/install-guide.md +8 -1
  103. package/package.json +3 -2
  104. package/playbooks/tdd-slice/PLAYBOOK.md +1 -1
  105. package/release-history.json +181 -0
@@ -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.1",
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",
@@ -17,7 +17,8 @@
17
17
  "scripts/install.ps1",
18
18
  "docs/install-guide.md",
19
19
  "docs/language-support.md",
20
- "CHANGELOG.md"
20
+ "CHANGELOG.md",
21
+ "release-history.json"
21
22
  ],
22
23
  "engines": {
23
24
  "node": ">=20"
@@ -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
 
@@ -0,0 +1,181 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "package": "@holmes-lab/holmes-kit",
4
+ "reviewedAt": "2026-11-18",
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
+ },
41
+ {
42
+ "version": "0.41.2",
43
+ "title": {
44
+ "ko": "버전별 요약을 패키지에 싣고 발행 때 확인하기",
45
+ "en": "Ship a per-version summary in the package and check it at release"
46
+ },
47
+ "benefits": {
48
+ "ko": [
49
+ "패키지 루트에 버전별 한국어·영어 요약 파일이 실려, 웹사이트가 정확히 그 발행 버전에서 요약을 읽을 수 있습니다.",
50
+ "발행 검증이 이 파일이 없거나, 형식이 틀리거나, 발행하는 버전의 항목이 없거나, 언어가 빠졌거나, 자리표시 문구·절대 경로·URL이나 호스트가 있거나, 발행물에 빠진 경우 발행을 거부합니다."
51
+ ],
52
+ "en": [
53
+ "The package root carries a Korean and English summary per version, so the website can read it from the exact published version.",
54
+ "The release check refuses a publish whose file is absent, malformed, lacks an entry for the version being published, misses a language, holds placeholder text, an absolute path, a URL or a host, or is missing from the packed artifact."
55
+ ]
56
+ },
57
+ "upgrade": {
58
+ "ko": "도구의 동작은 바뀌지 않습니다. Holmes-Kit을 직접 발행하는 경우, 발행하는 버전의 요약 항목을 release-history.json에 추가해야 발행 검증을 통과합니다.",
59
+ "en": "The tool's behaviour does not change. Publishing Holmes-Kit itself now needs an entry for the version being published in release-history.json to pass the release check."
60
+ },
61
+ "limitations": {
62
+ "ko": "요약은 0.40.0부터 있습니다. 그 이전 버전의 요약은 패키지에 없어, 웹사이트는 그 버전들을 요약 준비 중으로 표시합니다. 요약 문구는 AI 에이전트가 CHANGELOG와 대조해 검토했고, 발행은 오너가 승인합니다. 발행 검증은 형식과 금지 문구만 확인하고 내용의 정확성은 확인하지 않습니다.",
63
+ "en": "Summaries start at 0.40.0. Versions before it have no summary in the package, so the website shows them as awaiting a summary. The text was reviewed by AI agents against the CHANGELOG, and the owner approves the publish; the release check confirms its shape and forbidden text, not the accuracy of its content."
64
+ }
65
+ },
66
+ {
67
+ "version": "0.41.1",
68
+ "title": {
69
+ "ko": "백업 정리, 원장 보증 확인, 테스트 실행 환경을 바로잡기",
70
+ "en": "Fix backup cleanup, the ledger-witness form and the test-run environment"
71
+ },
72
+ "benefits": {
73
+ "ko": [
74
+ "이 버전부터 init이 만드는 새 스킬 백업은 지워도 full 자율 프로필의 거버넌스 스테이징을 막지 않습니다. 새 백업은 감시 대상 밖의 상태 폴더에 남습니다.",
75
+ "원장 보증 폼의 첫 줄이 보증 확인 결과를 보여 주고, 정상이 아닌 결과에는 보증하지 말라는 경고가 붙습니다.",
76
+ "서버가 CLAUDE_PROJECT_DIR를 가진 경우, 전체 test_run의 준비 단계는 HEAD의 작업 트리를, 변이 실행은 그 실행의 루트를 그 값으로 받습니다. 준비 단계는 HOLMES_SPECS, HOLMES_MCP_AUTORELOAD, HOLMES_MCP_PROFILE, npm_config_dry_run, PYTEST_ADDOPTS, PYTEST_PLUGINS를 더는 받지 않습니다.",
77
+ "읽을 수 없는 ax.config.json 때문에 선언된 준비 단계가 조용히 빠진 채 통과 증거가 기록되는 일이 없어졌습니다."
78
+ ],
79
+ "en": [
80
+ "From this version on, removing a new skill backup that init makes does not close governance staging under a full autonomy profile; new backups are kept in a state folder outside what the gate watches.",
81
+ "The ledger-witness form leads with the witness's own verdict, and every verdict other than ok carries a warning not to vouch unless the chain is meant as the reference.",
82
+ "Where the server carries CLAUDE_PROJECT_DIR, a full test_run's prepare step gets it as HEAD's worktree and a mutate run as the run's root; the prepare step no longer receives HOLMES_SPECS, HOLMES_MCP_AUTORELOAD, HOLMES_MCP_PROFILE, npm_config_dry_run, PYTEST_ADDOPTS or PYTEST_PLUGINS.",
83
+ "An unreadable ax.config.json no longer lets a full run drop a declared prepare step silently and record passing evidence."
84
+ ]
85
+ },
86
+ "upgrade": {
87
+ "ko": "이미 지운 백업이 설치 manifest에 기록된 작업공간은 사람이 holmes-kit init을 한 번 실행해야 스테이징이 다시 열립니다. ax.config.json의 testRun.prepare는 없거나, 빈 배열이거나, null이면 선언 없음이고, 그 밖에 비어 있지 않은 문자열 배열이 아닌 값이면 전체 실행이 이유와 함께 실패합니다.",
88
+ "en": "A workspace whose install manifest already records a removed backup needs one holmes-kit init by a person before staging opens again. testRun.prepare in ax.config.json declares nothing when absent, empty or null; any other value that is not a non-empty array of non-empty strings fails a full run with the reason."
89
+ },
90
+ "limitations": {
91
+ "ko": "보증 확인 파일은 .git 아래에 있어 셸이 지울 수 있고, 지워지면 첫 보증처럼 읽힙니다. 푸시된 체인과의 비교는 세션이 옮길 수 있는 로컬 ref를 기준으로 합니다. 위조된 보증 파일에 대한 저항은 검증되지 않았고, 사람이 터미널에서 한 보증은 기록이 남지 않습니다. 이전 버전이 스킬 옆에 남긴 백업은 그대로 남습니다.",
92
+ "en": "The witness lives under .git, where a shell can delete it, and a removed witness reads as a first vouch. The comparison with the pushed chain goes through a local ref a session can move. Resistance to a forged witness file is not verified, and a vouch made at a person's own terminal leaves no record. Backups an earlier version left beside a skill stay where they are."
93
+ }
94
+ },
95
+ {
96
+ "version": "0.41.0",
97
+ "title": {
98
+ "ko": "승인 종류 분리, full 프로필의 명세 자율 스테이징, 런타임 쓰기 보호",
99
+ "en": "Separate approval kinds, autonomous spec staging under a full profile, and write protection for the runtime"
100
+ },
101
+ "benefits": {
102
+ "ko": [
103
+ "봉인 해제와 폐기가 각각의 승인 종류가 되어, 명세 봉인(spec-approve)으로 범위를 건 승인이 해제·폐기를 덮지 않습니다. 범위를 걸지 않은 승인은 여전히 덮습니다.",
104
+ "훅이나 CLI가 낸 승인 요청 가운데, 요청한 실행이나 서버가 없고 사람이 보류하지도 않은 채 24시간이 지난 것은 다음 세션 시작 때 실행되지 않은 상태로 닫힙니다. 요청한 실행이나 서버가 있는 요청은 대상이 아닙니다.",
105
+ "full 프로필(오너가 지정한 작업공간에서 정해진 판정을 사람 승인 없이 처리하는 자율 프로필)에서, 명세와 그 상위 명세가 모두 봉인돼 있으면 사람 없이 스테이징될 수 있습니다. 열리는 조건은 업그레이드 (1)에 있습니다.",
106
+ "훅을 실행하는 런타임 파일과 npm으로 설치된 패키지(실제 경로에 node_modules가 있는 설치본)에 대해, 명령에 경로가 드러나는 세션의 쓰기·이동·삭제를 훅이 거부합니다."
107
+ ],
108
+ "en": [
109
+ "Un-seal and retire are approval kinds of their own, so an approval scoped to sealing a specification (spec-approve) no longer covers them; an unscoped approval still does.",
110
+ "A request filed by a hook or the CLI, with no requesting run or server and not held by a person, is closed unrun at the next session start once 24 hours pass undecided. A request with a requesting run or server is not affected.",
111
+ "Under a full profile (the autonomy profile in which the owner's chosen workspaces have set judgements decided without a person's approval), a specification whose own and parent seals hold can be staged without a person; when that opens is in upgrade (1).",
112
+ "The hook refuses a session's writes, moves and removals, where the command names the path, in the runtime that dispatches the hooks and in an npm-installed package (one whose real path has a node_modules segment)."
113
+ ]
114
+ },
115
+ "upgrade": {
116
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) full 프로필에서 명세 스테이징을 사람 없이 승인하는 것이 기본입니다. 끄려면 ax.config.json에 \"autonomy\": { \"specStaging\": \"off\" }를 두세요. 이 자율 승인은 Holmes-Kit이 npm으로 설치된 경우(실제 경로에 node_modules)에 열립니다. 손으로 푼 패키지에서는 사람이 승인하고, npm link·file: 의존성·workspace로 연결한 경우는 연결 대상에 기록된 빌드가 없으면 사람이 승인합니다. 그 밖의 조건은 CHANGELOG에 있습니다. (2) spec-approve로 범위를 건 grant나 승인은 봉인 해제·폐기를 덮지 않으니, spec-unseal·spec-retire로 범위를 다시 거세요. (3) 승인 변수를 명령에 붙인 holmes-kit autonomy full·on·delegate는 거부됩니다(profile.own-request). 변수 없이 실행하면 세션 폼으로 요청이 갑니다. (4) full 프로필에서 게이트·승인 처리 범주를 범위에 둔 명세는 사람 폼으로만 봉인됩니다. 주로 Holmes-Kit 저장소의 게이트 소스가 해당하지만, dist·상위 디렉터리·루트 설정 파일을 범위에 둔 명세도 해당될 수 있습니다. (5) publish 플래그가 꺼진 full 프로필에서 publish 판정이 레지스트리 쓰기, 릴리스 도구, 패키지 스크립트 안으로 넓어졌습니다. push 플래그가 꺼져 있으면 패키지 스크립트 안의 push도 판정됩니다. 이것은 사고 방지이지 장벽이 아닙니다. npm 계정의 2FA를 켜 두고, 에이전트에는 발행 권한이 없는 토큰을 주세요.",
117
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) Under a full profile, approving spec staging without a person is the default; turn it off with \"autonomy\": { \"specStaging\": \"off\" } in ax.config.json. This autonomous approval opens where Holmes-Kit is npm-installed (its real path has a node_modules segment). A package unpacked by hand is approved by a person, and so is one reached through npm link, a file: dependency or a workspace while the checkout it points at has no recorded build. The other conditions are in the CHANGELOG. (2) A grant or approval scoped to spec-approve does not cover un-seal or retire; scope it again to spec-unseal or spec-retire. (3) holmes-kit autonomy full, on or delegate with an approval variable set in the command is refused (profile.own-request); without the variable it asks in the session form. (4) Under a full profile, a specification scoped to the gate and approval-processing category is sealed only in a person's form. That is mostly Holmes-Kit's own gate source, but a specification scoped to dist, a parent directory or a root configuration file can fall in it too. (5) Under a full profile with the publish flag off, the publish judgement now reaches registry writes, release tools and package scripts; with the push flag off, a push inside a package script is judged too. It prevents accidents and is not a barrier: keep two-factor authentication required on the npm account, and give agents a token without publish rights."
118
+ },
119
+ "limitations": {
120
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) 훅은 사고 예방을 위한 장치이며, 같은 사용자 권한의 에이전트 셸에 대한 위조 저항은 검증되지 않았습니다. (2) 쓰기 거부는 명령에 경로가 드러나는 경우에만 걸립니다. 이름을 드러내지 않고 쓰는 프로그램, 게이트가 따라갈 수 없는 cd 뒤의 상대 경로, 사람 본인의 터미널은 보지 못합니다. (3) full 프로필에서 init이 남긴 스킬 백업을 지우면 요청 없이 거버넌스 스테이징이 닫힙니다(0.41.1에서 수리. 이미 닫힌 작업공간은 사람이 holmes-kit init을 한 번 실행해야 풀립니다). (4) 설치된 복구 스킬이 실행 중인 패키지의 것과 다르면 자율 스테이징이 거부됩니다.",
121
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) Hooks aim to prevent accidents; forgery resistance against an agent shell running as the same user is not verified. (2) The write refusals apply where the command names the path: a program that writes without naming it, a relative path after a cd the gate cannot resolve, and a person's own terminal are not seen. (3) Under a full profile, removing a skill backup that init left closes governance staging with no request (repaired in 0.41.1; a workspace already closed stays closed until a person runs holmes-kit init once). (4) An installed recovery skill that differs from the running package's refuses autonomous staging."
122
+ }
123
+ },
124
+ {
125
+ "version": "0.40.1",
126
+ "title": {
127
+ "ko": "푸시마다 그 커밋의 전체 test_run을 근거로 요구",
128
+ "en": "Each push needs a full test_run of the pushed commit"
129
+ },
130
+ "benefits": {
131
+ "ko": [
132
+ "푸시 게이트가 푸시할 커밋의 깨끗한 임시 checkout(HEAD worktree)에서 돈 전체 test_run만 근거로 받아, 다른 코드의 통과 기록이나 범위 실행과 구분합니다.",
133
+ "전체 실행을 한 번 한 뒤에는, 감지된 생태계마다 테스트가 하나 이상 실행돼야 하고 실행된 시험이 없는 구현 코드는 푸시가 거부됩니다.",
134
+ "test_run에 jest 작업자 수(workers)와 실행기마다의 시간 예산(timeoutMinutes)을 지정할 수 있습니다.",
135
+ "녹색 실행 뒤에 작업 디렉터리를 편집해도 그 커밋의 증거는 무효가 되지 않습니다."
136
+ ],
137
+ "en": [
138
+ "The push gate accepts only a full test_run that ran in a clean temporary checkout of the pushed commit (a HEAD worktree), distinguishing it from tests of other code and from scoped runs.",
139
+ "Once a full run has been attempted, every detected ecosystem must have run at least one test, and implementation code with no executed test refuses the push.",
140
+ "test_run takes a jest worker count (workers) and a time budget per runner (timeoutMinutes).",
141
+ "Editing the work tree after a green run no longer voids that commit's evidence."
142
+ ]
143
+ },
144
+ "upgrade": {
145
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) 푸시는 세 경우로 갈립니다. test_run 기록이 한 번도 없는 저장소는 활성화 안내와 함께 통과합니다. 저장소에 시험 파일도 구현 코드도 없으면 알림과 기록을 남기고 통과합니다. 그 밖에는 푸시마다 그 커밋에서 전체 test_run(full: true)이 필요하며, 범위 실행과 0.40.0이 쓴 기록은 근거가 되지 않습니다. (2) 전체 실행의 비용은 스위트 전체입니다. Holmes-Kit 저장소에서는 작업자 2개로 약 40분이었고, 시간 예산은 기본 120분, 최대 180분입니다. (3) 시험이 빌드 산출물에 기대면 ax.config.json에 testRun.prepare(예: [\"npm\", \"run\", \"build\"])를 선언하세요. (4) 사람 본인 터미널에서 처음 설치할 때 holmes-kit init의 자율 승인 질문 기본값이 Y여서, Enter만 치면 저위험 명세의 자율 승인이 켜집니다. 에이전트 하네스나 CI 아래에서는 꺼진 채이고, 이미 설정된 값은 유지됩니다. 끄려면 holmes-kit init --no-autonomy를 쓰거나 .mcp.json에서 HOLMES_AUTONOMOUS_APPROVAL을 지우세요.",
146
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) A push falls into three cases: a repository with no test_run record at all passes with the activation notice; a repository with neither a test file nor implementation code passes with a notice and a record; otherwise each push needs a full test_run (full: true) at the pushed commit, and scoped runs and records written by 0.40.0 are not evidence. (2) A full run costs the whole suite: about 40 minutes at two workers on the Holmes-Kit repository, with a time budget of 120 minutes by default and 180 at most. (3) If tests need build output, declare testRun.prepare in ax.config.json (for example [\"npm\", \"run\", \"build\"]). (4) On a first install at a person's own terminal, the autonomy question of holmes-kit init defaults to Y, so pressing Enter turns on autonomous approval of low-risk specifications; under an agent harness or CI it stays off, and a value already set is kept; turn it off with holmes-kit init --no-autonomy, or remove HOLMES_AUTONOMOUS_APPROVAL from .mcp.json."
147
+ },
148
+ "limitations": {
149
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) 푸시 근거가 되는 구성은 설정 하나·프로젝트 하나의 jest, 기본 이름의 pytest, go입니다. cargo·maven/gradle·dotnet 빌드 루트, jest projects나 여러 jest 설정은 environment로 거부되며, 그 밖의 구성은 CHANGELOG에 있습니다. (2) environment 거부는 사유가 문장에 적히며, 시험 코드를 고치는 것만으로는 대개 풀리지 않습니다. 러너 설치·설정 변경·커밋·스위트 분할로 풀리는 경우가 있고, 0.40.x가 지원하지 않아 풀 수 없는 구성도 있습니다. (3) Go의 전체 실행은 Stop 훅의 명세별 실행 집계에 잡히지 않고, 범위 실행은 그 집계와 근거를 갱신하지 않습니다. (4) 시험 근거의 위조 저항은 검증되지 않았습니다. HEAD의 conftest가 로드된 모듈 기록을 바꿀 수 있습니다.",
150
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) Push evidence covers jest with one configuration and one project, pytest under default names, and go. cargo, maven/gradle and dotnet build roots, jest projects and several jest configurations are refused as environment; the rest are in the CHANGELOG. (2) An environment refusal states its reason, and changing the test code alone usually does not clear it: some are cleared by installing the runner, changing a setting, committing or splitting the suite, and some configurations 0.40.x does not support cannot be cleared. (3) A full Go run is not counted in the Stop hook's per-specification execution counts, and a scoped run refreshes neither those counts nor the evidence. (4) The forgery resistance of the test evidence is not verified: a HEAD conftest can rewrite the loaded-module record."
151
+ }
152
+ },
153
+ {
154
+ "version": "0.40.0",
155
+ "title": {
156
+ "ko": "full 프로필의 푸시·배포 플래그 강제와 승인·명령 판정 변경",
157
+ "en": "Enforce the full profile's push and publish flags, and change how approvals and commands are judged"
158
+ },
159
+ "benefits": {
160
+ "ko": [
161
+ "full 프로필(오너가 지정한 작업공간에서 정해진 판정을 사람 승인 없이 처리하는 자율 프로필)에서 git push와 npm publish가 프로필의 허용 플래그를 따릅니다. 플래그가 없으면 거부되고 grant로도 풀리지 않습니다.",
162
+ "승인 결정(approve)이 요청 id나 8자 이상의 고유한 접두어로만 이뤄져, 목록 번호가 바뀌는 사이에 읽지 않은 요청을 승인하는 일을 줄입니다.",
163
+ "run start가 하네스 설정이 실제로 Holmes-Kit 패키지를 실행하는지 판정해, 이름만 holmes인 설정은 통과하지 않습니다."
164
+ ],
165
+ "en": [
166
+ "Under a full profile (the autonomy profile in which the owner's chosen workspaces have set judgements decided without a person's approval), git push and npm publish follow the profile's flags: without the flag they are refused, and a grant does not lift that.",
167
+ "Approval decisions (approve) take a request id or a unique id prefix of eight or more characters only, which reduces granting a request no one read after a list number moved.",
168
+ "run start judges whether the harness configuration actually launches the Holmes-Kit package; configuration that only names holmes no longer passes."
169
+ ]
170
+ },
171
+ "upgrade": {
172
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) full 프로필에서 --allow-push 없는 git push와 --allow-publish 없는 npm publish는 거부되고 grant로 풀리지 않습니다. 도움말·dry-run 형태는 통과하지만, push 플래그가 꺼져 있으면 강제 푸시는 그 형태도 거부됩니다. (2) git add -A, git add ., git commit -a가 다른 복제본(다른 기기, 연결된 worktree, run 실행)의 provenance 원장 파일에 닿으면 사람의 몫입니다. (3) 실행 중에 .ax 경로를 만들어 쓰는 셸 명령은 .ax 보호 경로를 직접 쓴 명령과 같이 판정되어 거부될 수 있고, .ax로 cd한 뒤 읽기가 아닌 것을 실행하는 형태도 거부됩니다. 거부문이 안내하는 대로 명령에서 .ax 언급을 빼거나 명령을 나누세요. 주석, here-document 본문, 메시지 문자열 속의 경로는 명령 전체가 확실히 읽힐 때 세지 않습니다. (4) approve --grant·--deny·--ask·--withdraw는 id나 8자 이상의 고유 접두어만 받고 목록 번호는 거부합니다. (5) run start는 하네스 설정이 Holmes-Kit 패키지의 MCP 진입점과 PreToolUse·Stop 훅 스크립트를 실제로 실행할 때만 통과합니다. 이름만 holmes인 설정은 실패합니다. (6) 업그레이드 뒤 MCP 서버를 다시 시작하세요. (7) 봉인이 기록되기 전에 봉인한 명세는 후계의 근거가 되지 않으니, spec_unseal 뒤 spec_approve(사람의 승인)로 이행하세요. 후계와 스테이징의 근거는 신뢰된 원장 기록에서만 읽으므로, 폐기 이력도 그 기록이 있어야 인정됩니다.",
173
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) Under a full profile, a git push without --allow-push and an npm publish without --allow-publish are refused, and a grant does not lift that; help and dry-run forms pass, except a force push while the push flag is off. (2) git add -A, git add . and git commit -a that reach another replica's provenance ledger file (another machine, a linked worktree, a run) are a person's act. (3) A shell command that builds a path into .ax while it runs is judged like one that names a protected .ax path and can be refused, and so is a command that changes into .ax and runs something that is not a read; as the refusal says, take the .ax mention out of the command or split it. Comments, here-document bodies and message text do not count when the whole command is read with certainty. (4) approve --grant, --deny, --ask and --withdraw take an id or a unique id prefix of eight or more characters only; a list number is refused. (5) run start passes only when the harness configuration actually runs the Holmes-Kit package's MCP entry and its PreToolUse and Stop hook scripts; configuration that only names holmes fails. (6) Restart MCP servers after upgrading. (7) A specification sealed before seals were recorded is no basis for a successor; migrate it with spec_unseal, then spec_approve (a person's approval). A successor and a staging proof are read only from trusted ledger events, so a retirement counts only with such a record."
174
+ },
175
+ "limitations": {
176
+ "ko": "이 요약은 설치해 쓰는 프로젝트에 조용히 영향을 주는 변경만 고른 것입니다. 업그레이드 전에 CHANGELOG의 이 버전 절(Upgrading·Known limitations)을 읽으세요. (1) 훅은 같은 사용자 권한의 에이전트 셸에 대한 보안 경계가 아니며 위조 저항은 검증되지 않았습니다. (2) push·publish 플래그는 게이트가 읽는 명령 형태에만 적용되고, 러너·명령 치환·패키지 스크립트 안에서 실행되는 것은 읽지 못합니다. (3) full 프로필은 범위 밖의 일반 쓰기를 거부하지 않습니다(재귀 삭제는 거부). (4) full 프로필에서도 게이트가 인식하는 형태의 명세 스테이징은 사람의 승인을 묻습니다. 스테이징 게이트는 사고 방지 장치이며, 승인된 스테이징만 일어난다고 보장하지 않습니다. 다만 이 버전의 spec_approve는 명세 등급과 무관하게 곧바로 봉인하므로, 사람 승인이 필요한 봉인 계약 수정도 full 프로필이 봉인합니다. (5) 접두어 대조는 명령을 입력한 뒤에 접수된 요청을 보지 못합니다. (6) 홈 경로에 공백이나 비ASCII 문자(예: 한글 사용자 이름)가 있으면 세션 승인 폼이 열리지 않습니다.",
177
+ "en": "This summary picks only the changes that quietly affect a project using the package. Before upgrading, read this version's section of the CHANGELOG (Upgrading and Known limitations). (1) The hook is not a security boundary against the same user's agent shell, and its forgery resistance is not verified. (2) The push and publish flags apply to the command forms the gate reads; what a runner, a substitution or a package script runs inside is not read. (3) A full profile does not refuse a plain write outside its scope (a recursive delete is refused). (4) Even under a full profile, spec staging in a form the gate recognises asks for a person's approval; the staging gate prevents accidents and does not guarantee approval-only staging. But this version's spec_approve seals at once whatever the specification's grade, so a sealed-contract amendment that needs a person's approval is sealed by the full profile. (5) The prefix check does not see a request filed after the command was typed. (6) A home path holding a space or non-ASCII characters (such as a Korean user name) gives no in-session approval form."
178
+ }
179
+ }
180
+ ]
181
+ }