@rasensio/aidlc 1.10.5 → 1.10.8

package/dist/doctor/migrations/cost-gitignore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost-gitignore.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/cost-gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAM7F,eAAO,MAAM,aAAa,EAAE,SAsB3B,CAAC"}
+{"version":3,"file":"cost-gitignore.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/cost-gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C,eAAO,MAAM,iBAAiB,UAM7B,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,SAsB3B,CAAC"}

package/dist/doctor/migrations/cost-gitignore.js

@@ -7,7 +7,21 @@
  */
 import { join } from 'node:path';
 import { ensureIgnoreLines, missingIgnoreLines } from './nested-gitignore.js';
-export const COST_IGNORE_LINES = ['active-sessions/', 'capture.log', 'locks/', '.gitignore'];
+/*
+ * `capture.sh` is generated per-install and its body embeds the node and CLI
+ * paths seen at install time as resolution *hints*. Those are machine-specific,
+ * so tracking the file would commit exactly the kind of absolute path this
+ * project just spent a bugfix removing from hook commands
+ * (cost-capture-goes-dark/AC-5). It is regenerated by `aidlc cost hooks install`
+ * and by the legacy-cost-hooks doctor migration, so nothing is lost by ignoring it.
+ */
+export const COST_IGNORE_LINES = [
+    'active-sessions/',
+    'capture.log',
+    'capture.sh',
+    'locks/',
+    '.gitignore',
+];
 function ignorePath(projectRoot) {
     return join(projectRoot, '.aidlc', 'cost', '.gitignore');
 }

package/dist/doctor/migrations/cost-gitignore.js.map

@@ -1 +1 @@
-{"version":3,"file":"cost-gitignore.js","sourceRoot":"","sources":["../../../src/doctor/migrations/cost-gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,kBAAkB,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AAE7F,SAAS,UAAU,CAAC,WAAmB;IACrC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,GAAG;QACP,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACtE,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,aAAa,OAAO,CAAC,MAAM,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACrG,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAChF,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;YACzB,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,oCAAoC;SACnE,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"cost-gitignore.js","sourceRoot":"","sources":["../../../src/doctor/migrations/cost-gitignore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kBAAkB;IAClB,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,YAAY;CACb,CAAC;AAEF,SAAS,UAAU,CAAC,WAAmB;IACrC,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,GAAG;QACP,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;QACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACtE,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,aAAa,OAAO,CAAC,MAAM,uCAAuC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACrG,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAChF,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC;YACzB,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,oCAAoC;SACnE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/doctor/migrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAY7C,eAAO,MAAM,UAAU,EAAE,SAAS,EAWjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAc7C,eAAO,MAAM,UAAU,EAAE,SAAS,EAajC,CAAC"}

package/dist/doctor/migrations/index.js

@@ -15,16 +15,20 @@ import { pruneCostLocks } from './prune-cost-locks.js';
 import { pruneCaptureLogMigration } from './prune-capture-log.js';
 import { pruneRegistry } from './prune-registry.js';
 import { unknownAgentClaims } from './unknown-agent-claims.js';
+import { legacyCostHooks } from './legacy-cost-hooks.js';
+import { installGuidance } from './install-guidance.js';
 export const MIGRATIONS = [
     costGitignore,
     knowledgeGitignore,
     gitattributes,
     shippedActions,
+    installGuidance,
     untrackCostEphemera,
     pruneSessionStash,
     pruneCostLocks,
     pruneCaptureLogMigration,
     pruneRegistry,
     unknownAgentClaims,
+    legacyCostHooks,
 ];
 //# sourceMappingURL=index.js.map

package/dist/doctor/migrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,aAAa;IACb,kBAAkB;CACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,aAAa;IACb,kBAAkB;IAClB,eAAe;CAChB,CAAC"}

package/dist/doctor/migrations/install-guidance.d.ts

@@ -0,0 +1,18 @@
+/**
+ * install-guidance migration (guidance-layers-never-resolve/AC-2).
+ *
+ * Projects initialized before guidance installation existed have no
+ * `.aidlc/guidance/` at all — or only the layers they authored themselves — so
+ * every `{{guidance:<layer>}}` placeholder in their skills has nothing to resolve
+ * against. This migration installs the layers the content package ships.
+ *
+ * Safe tier: it only adds files that are absent and appends entries to
+ * `index.yaml`. A layer whose body has been edited locally is reported and left
+ * alone, so applying this can never overwrite project-authored guidance.
+ *
+ * Note this repairs the *layers*; the placeholders in already-emitted skill
+ * bodies are rewritten by the skill refresh in `aidlc update`.
+ */
+import type { Migration } from '../types.js';
+export declare const installGuidance: Migration;
+//# sourceMappingURL=install-guidance.d.ts.map

package/dist/doctor/migrations/install-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-guidance.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/install-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,eAAe,EAAE,SA+C7B,CAAC"}

package/dist/doctor/migrations/install-guidance.js

@@ -0,0 +1,61 @@
+/**
+ * install-guidance migration (guidance-layers-never-resolve/AC-2).
+ *
+ * Projects initialized before guidance installation existed have no
+ * `.aidlc/guidance/` at all — or only the layers they authored themselves — so
+ * every `{{guidance:<layer>}}` placeholder in their skills has nothing to resolve
+ * against. This migration installs the layers the content package ships.
+ *
+ * Safe tier: it only adds files that are absent and appends entries to
+ * `index.yaml`. A layer whose body has been edited locally is reported and left
+ * alone, so applying this can never overwrite project-authored guidance.
+ *
+ * Note this repairs the *layers*; the placeholders in already-emitted skill
+ * bodies are rewritten by the skill refresh in `aidlc update`.
+ */
+import { getContentPackageRoot } from '../../compile/content-root.js';
+import { installBundledGuidance } from '../../compile/guidance-install.js';
+export const installGuidance = {
+    id: 'install-guidance',
+    tier: 'safe',
+    check(ctx) {
+        let contentRoot;
+        try {
+            contentRoot = getContentPackageRoot();
+        }
+        catch {
+            return { applicable: false, reason: 'content package not resolvable' };
+        }
+        const report = installBundledGuidance(ctx.projectRoot, contentRoot, { dryRun: true });
+        if (report.installed.length === 0 && !report.indexUpdated) {
+            return { applicable: true, pending: false };
+        }
+        const parts = [];
+        if (report.installed.length > 0) {
+            parts.push(`install ${report.installed.length} guidance layer(s): ${report.installed.join(', ')}`);
+        }
+        if (report.indexUpdated) {
+            parts.push('register them in .aidlc/guidance/index.yaml');
+        }
+        return {
+            applicable: true,
+            pending: true,
+            description: `would ${parts.join(' and ')}`,
+        };
+    },
+    apply(ctx) {
+        const report = installBundledGuidance(ctx.projectRoot, getContentPackageRoot());
+        const parts = [];
+        if (report.installed.length > 0) {
+            parts.push(`installed guidance layer(s): ${report.installed.join(', ')}`);
+        }
+        if (report.locallyModified.length > 0) {
+            parts.push(`left locally modified alone: ${report.locallyModified.join(', ')}`);
+        }
+        return {
+            changed: report.installed.length > 0 || report.indexUpdated,
+            summary: parts.join('; ') || 'guidance layers already installed',
+        };
+    },
+};
+//# sourceMappingURL=install-guidance.js.map

package/dist/doctor/migrations/install-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-guidance.js","sourceRoot":"","sources":["../../../src/doctor/migrations/install-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAG3E,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,GAAG;QACP,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,qBAAqB,EAAE,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;QACzE,CAAC;QAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtF,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC1D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,SAAS,CAAC,MAAM,uBAAuB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;SAC5C,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAEhF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,YAAY;YAC3D,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mCAAmC;SACjE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/doctor/migrations/legacy-cost-hooks.d.ts

@@ -0,0 +1,40 @@
+/**
+ * legacy-cost-hooks migration: re-install cost hooks that predate the shim.
+ *
+ * Replaces `stale-cost-hooks` (cost-capture-goes-dark/AC-14, AC-18). That
+ * migration asked "does the absolute CLI path recorded in the hook still exist?"
+ * — the right question only while the command *contained* an absolute path. Hook
+ * commands now invoke `.aidlc/cost/capture.sh`, which resolves node and the CLI
+ * at run time, so there is no longer a path that can go stale and nothing left
+ * to detect. What remains is a one-time migration: hooks installed by an older
+ * version still carry the frozen paths and are still silently broken.
+ *
+ * WHY THIS ONE REPAIRS, WHERE ITS PREDECESSOR ONLY REPORTED. `stale-cost-hooks`
+ * was deliberately report-only, reasoning that "a diagnostic must not silently
+ * rewrite a user's .claude/settings.json". That reasoning was sound and is
+ * narrowed here rather than discarded: this migration only ever replaces hook
+ * entries carrying our own `#aidlc-cost-hook` marker, via the same
+ * merge-not-clobber installer that leaves every other key and every unmarked
+ * hook untouched. Nothing the user wrote is rewritten.
+ *
+ * The reason to change the stance at all is what report-only cost us: the
+ * detection was correct, the report printed on every `aidlc update`, and the
+ * data was lost anyway, because the last link in the chain was a human reading a
+ * line. A repair that needs to be noticed is a repair that does not happen. The
+ * failure it prevents is silent and unrecoverable — usage that was never
+ * captured cannot be reconstructed later.
+ *
+ * Self-clearing: re-installing produces the shim form, so `legacy` goes false
+ * and this stops reporting without anyone editing state.
+ */
+import type { Migration } from '../types.js';
+/**
+ * Platforms whose installed hook still uses the pre-shim absolute-path form.
+ * Read-only half, exported for reuse and direct testing.
+ *
+ * Only installed hooks are considered: an absent hook is a different condition
+ * (never armed, not broken), and `aidlc cost hooks status` already says so.
+ */
+export declare function legacyCostHookPlatforms(projectRoot: string): string[];
+export declare const legacyCostHooks: Migration;
+//# sourceMappingURL=legacy-cost-hooks.d.ts.map

package/dist/doctor/migrations/legacy-cost-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-cost-hooks.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/legacy-cost-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAqB7C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE;AAWD,eAAO,MAAM,eAAe,EAAE,SAsB7B,CAAC"}

package/dist/doctor/migrations/legacy-cost-hooks.js

@@ -0,0 +1,92 @@
+/**
+ * legacy-cost-hooks migration: re-install cost hooks that predate the shim.
+ *
+ * Replaces `stale-cost-hooks` (cost-capture-goes-dark/AC-14, AC-18). That
+ * migration asked "does the absolute CLI path recorded in the hook still exist?"
+ * — the right question only while the command *contained* an absolute path. Hook
+ * commands now invoke `.aidlc/cost/capture.sh`, which resolves node and the CLI
+ * at run time, so there is no longer a path that can go stale and nothing left
+ * to detect. What remains is a one-time migration: hooks installed by an older
+ * version still carry the frozen paths and are still silently broken.
+ *
+ * WHY THIS ONE REPAIRS, WHERE ITS PREDECESSOR ONLY REPORTED. `stale-cost-hooks`
+ * was deliberately report-only, reasoning that "a diagnostic must not silently
+ * rewrite a user's .claude/settings.json". That reasoning was sound and is
+ * narrowed here rather than discarded: this migration only ever replaces hook
+ * entries carrying our own `#aidlc-cost-hook` marker, via the same
+ * merge-not-clobber installer that leaves every other key and every unmarked
+ * hook untouched. Nothing the user wrote is rewritten.
+ *
+ * The reason to change the stance at all is what report-only cost us: the
+ * detection was correct, the report printed on every `aidlc update`, and the
+ * data was lost anyway, because the last link in the chain was a human reading a
+ * line. A repair that needs to be noticed is a repair that does not happen. The
+ * failure it prevents is silent and unrecoverable — usage that was never
+ * captured cannot be reconstructed later.
+ *
+ * Self-clearing: re-installing produces the shim form, so `legacy` goes false
+ * and this stops reporting without anyone editing state.
+ */
+import { claudeCodeHookStatus, installClaudeCodeHooks } from '../../cost/hooks/claude-code.js';
+import { kiroHookStatus, installKiroHooks } from '../../cost/hooks/kiro.js';
+import { cliEntryPath } from '../../cost/hooks/entry.js';
+/*
+ * Deliberately NOT driven by allProviders(): that registry is populated by an
+ * explicit registerBuiltinProviders() call, so any caller that has not made it
+ * sees an EMPTY list — the predecessor migration reproduced exactly that bug on
+ * its first run and found nothing in every case. A diagnostic that silently
+ * finds nothing is worse than no diagnostic. Hook installation exists only for
+ * these two platforms, so the pairing is static.
+ */
+const HOOK_PLATFORMS = [
+    { name: 'claude-code', status: claudeCodeHookStatus, install: installClaudeCodeHooks },
+    { name: 'kiro', status: kiroHookStatus, install: installKiroHooks },
+];
+/**
+ * Platforms whose installed hook still uses the pre-shim absolute-path form.
+ * Read-only half, exported for reuse and direct testing.
+ *
+ * Only installed hooks are considered: an absent hook is a different condition
+ * (never armed, not broken), and `aidlc cost hooks status` already says so.
+ */
+export function legacyCostHookPlatforms(projectRoot) {
+    const legacy = [];
+    for (const p of HOOK_PLATFORMS) {
+        const status = p.status(projectRoot);
+        if (status.installed && status.legacy)
+            legacy.push(p.name);
+    }
+    return legacy;
+}
+function summarize(legacy) {
+    const one = legacy.length === 1;
+    return (`${legacy.length} cost hook${one ? '' : 's'} ` +
+        `still ${one ? 'names' : 'name'} an absolute node/CLI path frozen at install time ` +
+        `(${legacy.join(', ')}) — re-installed so capture survives a node or machine change`);
+}
+export const legacyCostHooks = {
+    id: 'legacy-cost-hooks',
+    tier: 'safe',
+    check(ctx) {
+        const legacy = legacyCostHookPlatforms(ctx.projectRoot);
+        if (legacy.length === 0)
+            return { applicable: true, pending: false };
+        return { applicable: true, pending: true, description: summarize(legacy) };
+    },
+    apply(ctx) {
+        const legacy = legacyCostHookPlatforms(ctx.projectRoot);
+        if (legacy.length === 0)
+            return { changed: false, summary: 'no legacy cost hooks' };
+        // process.execPath and the resolved CLI are only *hints* for the shim; they
+        // are validated at run time and never written into the command text, so a
+        // hint captured here going stale later is no longer a failure mode.
+        const nodePath = process.execPath;
+        const cliPath = cliEntryPath();
+        for (const p of HOOK_PLATFORMS) {
+            if (legacy.includes(p.name))
+                p.install(ctx.projectRoot, nodePath, cliPath);
+        }
+        return { changed: true, summary: summarize(legacy) };
+    },
+};
+//# sourceMappingURL=legacy-cost-hooks.js.map

package/dist/doctor/migrations/legacy-cost-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-cost-hooks.js","sourceRoot":"","sources":["../../../src/doctor/migrations/legacy-cost-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AASzD;;;;;;;GAOG;AACH,MAAM,cAAc,GAAmB;IACrC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,EAAE;IACtF,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE;CACpE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,MAAgB;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAChC,OAAO,CACL,GAAG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;QAC9C,SAAS,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,oDAAoD;QACnF,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,+DAA+D,CACrF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAEpF,4EAA4E;QAC5E,0EAA0E;QAC1E,oEAAoE;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IACvD,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.10.5",
+  "version": "1.10.8",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",
@@ -24,7 +24,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.10.5"
+    "@rasensio/aidlc-content": "1.10.8"
   },
   "devDependencies": {
     "@types/node": "22.15.32",