@holmes-lab/holmes-kit 0.1.13 → 0.1.14

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+<!-- @implements A-SPEC-209 -->
+## [0.1.14] - 2026-08-23
+
+A defect found by installing 0.1.13 from the registry and driving the shipped HITL cycle:
+`holmes-kit approve --help` printed the whole-CLI usage instead of its own. The approve
+subcommand — the human decision surface — had its help swallowed at its first touch.
+
+### Fixed
+- **`approve --help` reaches APPROVE_USAGE (A-SPEC-171)**: the global `--help` handler fired
+  before approve's dispatch (which carries its own usage) could run, so it printed the top-level
+  usage over it — approve dispatches last only because it was added last. A declarative
+  `SELF_HELP_COMMANDS` set now exempts any subcommand that renders its own usage, so the fix does
+  not depend on dispatch order. Two reproducing tests (RED before, GREEN after).
+- **Repo hygiene: a stray `C:/proj/.ax` was tracked (A-SPEC-237/§25a)**: the Windows path tests
+  pass `projectRoot: 'C:/proj'`, which on POSIX resolves as a relative path into the repo. A
+  pre-§25a residue directory had been committed in 0.1.13 and kept growing on every suite run;
+  removed, with a `.gitignore` guard against drive-letter directories. Verified the §25a
+  enqueue-only-under-existing-.ax guard now prevents recreation — the suite no longer plants it.
+
 <!-- @implements A-SPEC-209 -->
 ## [0.1.13] - 2026-08-23
 

package/dist/.build-id

@@ -1 +1 @@
-0c506c6-mt5buls8
+2500532-mt5cs4a5

package/dist/holmes/cli/index.js

@@ -76,6 +76,12 @@ const KNOWN_FLAGS = {
     serve: ['help', 'target', 'port'],
     approve: ['help', 'target', 'list', 'grant', 'deny', 'ask', 'reason', 'question', 'ttl', 'rationale'],
 };
+// @implements A-SPEC-171 — subcommands that render their OWN usage on `--help`. A-SPEC-171 governs
+// "help before any side effect"; a command whose usage lives past this handler (approve, whose
+// APPROVE_USAGE is emitted in its own dispatch) must be exempted here or the global handler prints
+// the whole-CLI usage over it. This set is that exemption, kept declarative so a future self-help
+// command is one edit, not a dispatch-order gamble.
+const SELF_HELP_COMMANDS = new Set(['approve']);
 const APPROVE_USAGE = `holmes-kit approve — 승인 대기 요청의 결재 (HITL)
 
   대화형(TTY):        항목마다 [a]승인 [d]거부 [q]질문 [s]건너뛰기
@@ -237,8 +243,10 @@ async function main(argv) {
     }
     // @implements A-SPEC-171
     // BEFORE any side effect. The measured defect was not that help was missing but that the writing
-    // happened first, so the order here is the fix.
-    if (knownFlagsFor(cmd) && flags.help) {
+    // happened first, so the order here is the fix. Measured again on 0.1.13: `approve --help` printed
+    // the whole-CLI usage because this handler fired before approve's dispatch (which carries its own
+    // APPROVE_USAGE) could run — so a command in SELF_HELP_COMMANDS is deferred to, not printed over.
+    if (knownFlagsFor(cmd) && flags.help && !SELF_HELP_COMMANDS.has(cmd)) {
         process.stdout.write(USAGE);
         return 0;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "@implements A-SPEC-209",
   "name": "@holmes-lab/holmes-kit",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Holmes-Kit — deterministic Agentic Software Engineering (ASE) harness with causal traceability (spec chain + D-CPG + RTM + phase guardrail)",
   "main": "dist/holmes/mcp/server.js",
   "types": "dist/holmes/mcp/server.d.ts",