@rasensio/aidlc 1.11.0 → 1.13.0

package/dist/doctor/migrations/missing-cost-shim.js

@@ -0,0 +1,92 @@
+/**
+ * missing-cost-shim migration: regenerate `.aidlc/cost/capture.sh` when a hook
+ * is armed against it and it cannot run.
+ *
+ * WHY THIS EXISTS. `cost-capture-goes-dark` replaced absolute hook paths with a
+ * generated shim and deleted `commandResolvable`, recording that "the failure
+ * class is retired, not merely detected". The shim removed the *stale path*
+ * failure and introduced a *missing file* one: the shim is generated per install,
+ * is gitignored on purpose (it embeds machine-specific resolution hints), and no
+ * tracked file can supply it — while `.claude/settings.json`, which arms the
+ * hooks, IS tracked. So every fresh clone and every second machine starts with
+ * hooks pointing at nothing.
+ *
+ * That is not hypothetical: capture was dead from 2026-08-26 21:12 to 2026-08-28
+ * 13:44 local, $535.54 of usage was never recorded, and `aidlc cost hooks status`
+ * read `installed` throughout.
+ *
+ * WHY SAFE TIER, AND WHY IT REPAIRS RATHER THAN REPORTS. The shim is generated
+ * output with no user content, already gitignored, and `writeShim` is idempotent —
+ * rewriting it destroys nothing a user authored. Report-only was tried for this
+ * exact failure class (`stale-cost-hooks`) and the data was lost anyway, because
+ * the last link in the chain was a human reading a line. `aidlc cost` already
+ * prints "run `aidlc doctor` to repair"; this is the migration that makes that
+ * sentence true.
+ *
+ * Self-clearing: once the shim exists and is executable, `shimProblem` returns
+ * null and this stops reporting without anyone editing state.
+ */
+import { claudeCodeHookStatus } from '../../cost/hooks/claude-code.js';
+import { kiroHookStatus } from '../../cost/hooks/kiro.js';
+import { cliEntryPath } from '../../cost/hooks/entry.js';
+import { describeShimProblem, shimProblem, writeShim } from '../../cost/hooks/shim.js';
+/*
+ * Static for the same reason `legacy-cost-hooks` is: allProviders() is only
+ * populated by an explicit registerBuiltinProviders() call, so a caller that has
+ * not made it sees an empty list and the migration silently finds nothing. Hook
+ * installation exists for these two platforms only.
+ */
+const HOOK_PLATFORMS = [
+    { name: 'claude-code', status: claudeCodeHookStatus },
+    { name: 'kiro', status: kiroHookStatus },
+];
+/**
+ * Platforms whose hook is armed against an unusable shim. Read-only half,
+ * exported for reuse and direct testing.
+ *
+ * Legacy hooks are excluded: they do not invoke the shim, so its state is not
+ * their problem — `legacy-cost-hooks` re-installs those, which writes the shim as
+ * a side effect anyway.
+ */
+export function platformsWithUnusableShim(projectRoot) {
+    if (shimProblem(projectRoot) === null)
+        return [];
+    return HOOK_PLATFORMS.filter((p) => {
+        const s = p.status(projectRoot);
+        return s.installed && !s.legacy;
+    }).map((p) => p.name);
+}
+export const missingCostShim = {
+    id: 'missing-cost-shim',
+    tier: 'safe',
+    check(ctx) {
+        const affected = platformsWithUnusableShim(ctx.projectRoot);
+        if (affected.length === 0)
+            return { applicable: true, pending: false };
+        const problem = shimProblem(ctx.projectRoot);
+        return {
+            applicable: true,
+            pending: true,
+            description: `${describeShimProblem(problem)} but ${affected.join(' and ')} ` +
+                `hook${affected.length === 1 ? ' is' : 's are'} armed against it — ` +
+                'capture cannot run and cannot report that it did not; would regenerate it',
+        };
+    },
+    apply(ctx) {
+        const affected = platformsWithUnusableShim(ctx.projectRoot);
+        if (affected.length === 0)
+            return { changed: false, summary: 'cost shim is usable' };
+        // Hints only. The shim validates both at run time and never trusts them to
+        // still exist, which is what lets it survive a node or machine change.
+        writeShim(ctx.projectRoot, process.execPath, cliEntryPath());
+        const remaining = shimProblem(ctx.projectRoot);
+        if (remaining !== null) {
+            return { changed: false, summary: `could not regenerate the cost shim: ${describeShimProblem(remaining)}` };
+        }
+        return {
+            changed: true,
+            summary: `regenerated .aidlc/cost/capture.sh for ${affected.join(', ')}`,
+        };
+    },
+};
+//# sourceMappingURL=missing-cost-shim.js.map

package/dist/doctor/migrations/missing-cost-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-cost-shim.js","sourceRoot":"","sources":["../../../src/doctor/migrations/missing-cost-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAQvF;;;;;GAKG;AACH,MAAM,cAAc,GAAmB;IACrC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,oBAAoB,EAAE;IACrD,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE;CACzC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,WAAW,CAAC,WAAW,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjD,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAClC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAc;IACxC,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,MAAM;IACZ,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,IAAI;YACb,WAAW,EACT,GAAG,mBAAmB,CAAC,OAAQ,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG;gBACjE,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,sBAAsB;gBACpE,2EAA2E;SAC9E,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;QAErF,2EAA2E;QAC3E,uEAAuE;QACvE,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,uCAAuC,mBAAmB,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAC9G,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,0CAA0C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACzE,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/doctor/migrations/roadmap-layout.d.ts

@@ -0,0 +1,73 @@
+/**
+ * roadmap-layout migration (roadmap-revamp/AC-23..AC-27, AC-38, confirm tier):
+ * move a legacy `.aidlc/ideas/` backlog into `.aidlc/roadmap/<status>/` and
+ * rewrite each item's frontmatter to the new schema.
+ *
+ * This is the first migration in this project that moves the *user's own*
+ * content rather than regenerating a framework artifact, which is why it is
+ * confirm tier and why every move goes through `git mv` when the file is
+ * tracked: a mistake stays one `git checkout` away from undone.
+ *
+ * `check` and `apply` both derive everything from `planRoadmapMoves` and nothing
+ * else computes pending-ness — the rule stated in `../types.ts`, so a dry run and
+ * a real run cannot disagree about what will happen.
+ *
+ * Old status maps to new directory: `raw` → `inbox`, `dropped` → `hold`,
+ * `promoted` → `done` or `in-progress` depending on whether the named instance
+ * actually finished. Raw items land in `inbox` rather than `backlog` because the
+ * old format has no field recording whether anything was ever triaged, and
+ * mapping to `backlog` would manufacture that signal (DD-8).
+ *
+ * Whether an instance finished is answered by `completionInfo` from the metrics
+ * module, not by a local "is the last phase complete?" test — that naive form is
+ * wrong for maintenance-terminal templates, which complete on maintenance entry.
+ */
+import type { Migration } from '../types.js';
+import type { DoctorContext } from '../types.js';
+import { type RoadmapStatus } from '../../roadmap/paths.js';
+/** One planned relocation, with everything `apply` needs to carry it out. */
+export interface RoadmapMove {
+    /** Absolute source path. */
+    from: string;
+    /** Absolute target path. */
+    to: string;
+    /** Repo-relative source, for the printed command list. */
+    fromRel: string;
+    /** Repo-relative target, for the printed command list. */
+    toRel: string;
+    status: RoadmapStatus;
+    /** Rewritten file contents. */
+    contents: string;
+    /** Tracked by git, so the move can preserve history. */
+    tracked: boolean;
+}
+export interface RoadmapPlan {
+    moves: RoadmapMove[];
+    /** Repo-relative paths the planner could not classify; left in place. */
+    unclassified: string[];
+}
+/**
+ * Rewrite a legacy idea's frontmatter to the roadmap schema.
+ *
+ * Key order is fixed by AC-4, so the block is rebuilt rather than edited: the
+ * legacy shape shares only `promoted_to` and `depends_on` with the new one.
+ * The body below the frontmatter is copied through untouched apart from being
+ * read for its title.
+ *
+ * `author` is deliberately omitted rather than guessed. The legacy format never
+ * recorded one, and `created_by` from an unrelated instance is not the author of
+ * an idea.
+ */
+export declare function rewriteFrontmatter(raw: string, filename: string, status: RoadmapStatus): {
+    contents: string;
+    id: string;
+} | null;
+/**
+ * Everything the migration would do, computed without writing.
+ *
+ * The single source of pending-ness. Sorted by source path so the plan never
+ * depends on directory read order.
+ */
+export declare function planRoadmapMoves(ctx: DoctorContext): RoadmapPlan;
+export declare const roadmapLayout: Migration;
+//# sourceMappingURL=roadmap-layout.d.ts.map

package/dist/doctor/migrations/roadmap-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-layout.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/roadmap-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,yEAAyE;IACzE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,GACpB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8CzC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CAmEhE;AASD,eAAO,MAAM,aAAa,EAAE,SA8G3B,CAAC"}

package/dist/doctor/migrations/roadmap-layout.js

@@ -0,0 +1,281 @@
+/**
+ * roadmap-layout migration (roadmap-revamp/AC-23..AC-27, AC-38, confirm tier):
+ * move a legacy `.aidlc/ideas/` backlog into `.aidlc/roadmap/<status>/` and
+ * rewrite each item's frontmatter to the new schema.
+ *
+ * This is the first migration in this project that moves the *user's own*
+ * content rather than regenerating a framework artifact, which is why it is
+ * confirm tier and why every move goes through `git mv` when the file is
+ * tracked: a mistake stays one `git checkout` away from undone.
+ *
+ * `check` and `apply` both derive everything from `planRoadmapMoves` and nothing
+ * else computes pending-ness — the rule stated in `../types.ts`, so a dry run and
+ * a real run cannot disagree about what will happen.
+ *
+ * Old status maps to new directory: `raw` → `inbox`, `dropped` → `hold`,
+ * `promoted` → `done` or `in-progress` depending on whether the named instance
+ * actually finished. Raw items land in `inbox` rather than `backlog` because the
+ * old format has no field recording whether anything was ever triaged, and
+ * mapping to `backlog` would manufacture that signal (DD-8).
+ *
+ * Whether an instance finished is answered by `completionInfo` from the metrics
+ * module, not by a local "is the last phase complete?" test — that naive form is
+ * wrong for maintenance-terminal templates, which complete on maintenance entry.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { trackedFiles } from '../git.js';
+import { completionInfo, loadAllTemplates, loadInstance } from '../../metrics/report.js';
+import { ITEM_FILENAME_RE, LEGACY_IDEAS_DIR, ROADMAP_DIR, } from '../../roadmap/paths.js';
+/** Map a legacy `status:` value onto a roadmap directory. */
+function targetStatus(legacy, promotedTo, ctx, templates) {
+    if (legacy === 'raw')
+        return 'inbox';
+    if (legacy === 'dropped')
+        return 'hold';
+    if (legacy !== 'promoted')
+        return null;
+    // A promoted item with no instance name is a broken record, not a status we
+    // can derive. Treat it as in-flight rather than claiming it shipped.
+    if (promotedTo === null)
+        return 'in-progress';
+    const inst = loadInstance(ctx.projectRoot, promotedTo);
+    if (inst === null)
+        return 'in-progress';
+    return completionInfo(inst, templates).completed ? 'done' : 'in-progress';
+}
+/**
+ * Rewrite a legacy idea's frontmatter to the roadmap schema.
+ *
+ * Key order is fixed by AC-4, so the block is rebuilt rather than edited: the
+ * legacy shape shares only `promoted_to` and `depends_on` with the new one.
+ * The body below the frontmatter is copied through untouched apart from being
+ * read for its title.
+ *
+ * `author` is deliberately omitted rather than guessed. The legacy format never
+ * recorded one, and `created_by` from an unrelated instance is not the author of
+ * an idea.
+ */
+export function rewriteFrontmatter(raw, filename, status) {
+    const nameMatch = ITEM_FILENAME_RE.exec(filename);
+    if (!nameMatch)
+        return null;
+    const [, digits, slug] = nameMatch;
+    const createdAt = `${digits.slice(0, 4)}-${digits.slice(4, 6)}-${digits.slice(6, 8)}`;
+    const id = `item-${digits}-${slug}`;
+    if (!raw.startsWith('---\n'))
+        return null;
+    const close = raw.indexOf('\n---\n', 4);
+    if (close === -1)
+        return null;
+    let legacy = {};
+    try {
+        const parsed = parseYaml(raw.slice(4, close + 1));
+        if (typeof parsed === 'object' && parsed !== null)
+            legacy = parsed;
+    }
+    catch {
+        return null;
+    }
+    const body = raw.slice(close + '\n---\n'.length);
+    const titleMatch = /^#\s+(?:Idea:\s*)?(.+)$/m.exec(body);
+    const title = titleMatch ? titleMatch[1].trim() : slug.replaceAll('-', ' ');
+    const promotedTo = typeof legacy.promoted_to === 'string' ? legacy.promoted_to : null;
+    // Legacy `depends_on` names files; the new field names identifiers.
+    const deps = Array.isArray(legacy.depends_on)
+        ? legacy.depends_on
+            .filter((d) => typeof d === 'string' && d.length > 0)
+            .map((d) => (d.startsWith('item-') ? d : `item-${d.replace(/\.md$/, '')}`))
+        : [];
+    const lines = [
+        '---',
+        `id: ${id}`,
+        `title: ${title.includes(': ') ? JSON.stringify(title) : title}`,
+        `created_at: ${createdAt}`,
+        'source: import',
+        `promoted_to: ${promotedTo === null ? 'null' : promotedTo}`,
+        `depends_on: [${deps.join(', ')}]`,
+        'history:',
+        `  - { status: ${status}, at: ${createdAt} }`,
+        '---',
+    ];
+    return { contents: `${lines.join('\n')}\n${body}`, id };
+}
+/**
+ * Everything the migration would do, computed without writing.
+ *
+ * The single source of pending-ness. Sorted by source path so the plan never
+ * depends on directory read order.
+ */
+export function planRoadmapMoves(ctx) {
+    const legacyDir = join(ctx.projectRoot, ...LEGACY_IDEAS_DIR.split('/'));
+    if (!existsSync(legacyDir))
+        return { moves: [], unclassified: [] };
+    const templates = loadAllTemplates(ctx.projectRoot);
+    const tracked = new Set(trackedFiles(ctx.projectRoot, [LEGACY_IDEAS_DIR]));
+    const moves = [];
+    const unclassified = [];
+    for (const name of readdirSync(legacyDir).sort()) {
+        if (!name.endsWith('.md'))
+            continue;
+        const from = join(legacyDir, name);
+        const fromRel = `${LEGACY_IDEAS_DIR}/${name}`;
+        let raw;
+        try {
+            raw = readFileSync(from, 'utf8');
+        }
+        catch {
+            unclassified.push(fromRel);
+            continue;
+        }
+        let legacyStatus = null;
+        if (raw.startsWith('---\n')) {
+            const close = raw.indexOf('\n---\n', 4);
+            if (close !== -1) {
+                const m = /^status:\s*(\w+)/m.exec(raw.slice(4, close + 1));
+                if (m)
+                    legacyStatus = m[1];
+            }
+        }
+        if (legacyStatus === null) {
+            unclassified.push(fromRel);
+            continue;
+        }
+        const promotedTo = /^promoted_to:\s*(\S+)/m.exec(raw)?.[1] ?? null;
+        const status = targetStatus(legacyStatus, promotedTo === null || promotedTo === 'null' ? null : promotedTo, ctx, templates);
+        if (status === null) {
+            unclassified.push(fromRel);
+            continue;
+        }
+        const rewritten = rewriteFrontmatter(raw, name, status);
+        if (rewritten === null) {
+            unclassified.push(fromRel);
+            continue;
+        }
+        const toRel = `${ROADMAP_DIR}/${status}/${name}`;
+        moves.push({
+            from,
+            to: join(ctx.projectRoot, ...toRel.split('/')),
+            fromRel,
+            toRel,
+            status,
+            contents: rewritten.contents,
+            tracked: tracked.has(fromRel),
+        });
+    }
+    return { moves, unclassified };
+}
+/** Counts per status, for a one-line description. */
+function byStatus(moves) {
+    const counts = new Map();
+    for (const m of moves)
+        counts.set(m.status, (counts.get(m.status) ?? 0) + 1);
+    return [...counts.entries()].map(([s, n]) => `${n} → ${s}`).join(', ');
+}
+export const roadmapLayout = {
+    id: 'roadmap-layout',
+    tier: 'confirm',
+    check(ctx) {
+        const legacyDir = join(ctx.projectRoot, ...LEGACY_IDEAS_DIR.split('/'));
+        if (!existsSync(legacyDir)) {
+            return { applicable: false, reason: `no legacy ${LEGACY_IDEAS_DIR} directory` };
+        }
+        const { moves, unclassified } = planRoadmapMoves(ctx);
+        if (moves.length === 0) {
+            // Files this migration cannot parse are reported as NOT APPLICABLE, not as
+            // pending work. `apply` will never fix them — only a human can — and
+            // `aidlc doctor` exits 1 on pending confirm work, so calling it pending
+            // would fail doctor forever on any repo holding one malformed file. That
+            // trains people to ignore doctor output, which costs more than the file
+            // does. `not-applicable` still prints the detail, and the files are sitting
+            // visibly in the legacy directory either way.
+            if (unclassified.length > 0) {
+                return {
+                    applicable: false,
+                    reason: `${unclassified.length} file(s) in ${LEGACY_IDEAS_DIR} have no readable status and need a human: ${unclassified.map((p) => basename(p)).join(', ')}`,
+                };
+            }
+            // An already-drained directory still needs removing, and `apply` only runs
+            // when `check` says pending — so reporting clean here would leave it on
+            // disk for good (AC-26). A directory holding non-item files is not empty
+            // and is correctly left alone.
+            if (readdirSync(legacyDir).length === 0) {
+                return {
+                    applicable: true,
+                    pending: true,
+                    description: `would remove the now-empty ${LEGACY_IDEAS_DIR} directory`,
+                    commands: [],
+                };
+            }
+            return { applicable: true, pending: false };
+        }
+        const existing = moves.filter((m) => existsSync(m.to));
+        if (existing.length > 0) {
+            return {
+                applicable: true,
+                pending: true,
+                description: `would move ${moves.length} roadmap item(s) (${byStatus(moves)})`,
+                commands: moves.map((m) => `git mv -- ${m.fromRel} ${m.toRel}`),
+                blocked: `${existing[0].toRel} already exists — resolve the collision, then re-run aidlc doctor`,
+            };
+        }
+        const suffix = unclassified.length > 0 ? `; ${unclassified.length} file(s) left in place` : '';
+        return {
+            applicable: true,
+            pending: true,
+            description: `would move ${moves.length} roadmap item(s) from ${LEGACY_IDEAS_DIR} (${byStatus(moves)})${suffix}`,
+            commands: moves.map((m) => `git mv -- ${m.fromRel} ${m.toRel}`),
+        };
+    },
+    apply(ctx) {
+        const { moves, unclassified } = planRoadmapMoves(ctx);
+        const legacyDir = join(ctx.projectRoot, ...LEGACY_IDEAS_DIR.split('/'));
+        for (const move of moves) {
+            mkdirSync(dirname(move.to), { recursive: true });
+            // Rewrite in place first, then move. A failure between the two leaves the
+            // item where it was with new frontmatter — recoverable — rather than moved
+            // with the old schema, which a second run would not detect.
+            writeFileSync(move.from, move.contents, 'utf8');
+            if (move.tracked) {
+                try {
+                    execFileSync('git', ['mv', '--', move.fromRel, move.toRel], {
+                        cwd: ctx.projectRoot,
+                        stdio: ['ignore', 'ignore', 'pipe'],
+                    });
+                    continue;
+                }
+                catch {
+                    // Fall through to a plain rename: git refuses in states (unmerged
+                    // index, unborn HEAD) where the move itself is still correct.
+                }
+            }
+            renameSync(move.from, move.to);
+        }
+        // Remove the legacy directory only when nothing is left in it (AC-26).
+        let removed = false;
+        if (existsSync(legacyDir) && readdirSync(legacyDir).length === 0) {
+            try {
+                rmdirSync(legacyDir);
+                removed = true;
+            }
+            catch {
+                // A non-empty-by-race or permission-denied directory is not a failure.
+            }
+        }
+        const parts = [];
+        if (moves.length > 0)
+            parts.push(`moved ${moves.length} roadmap item(s) (${byStatus(moves)})`);
+        if (unclassified.length > 0) {
+            parts.push(`left ${unclassified.length} unclassifiable file(s) in place: ${unclassified.map((p) => basename(p)).join(', ')}`);
+        }
+        if (removed)
+            parts.push(`removed empty ${LEGACY_IDEAS_DIR}`);
+        return {
+            changed: moves.length > 0 || removed,
+            summary: parts.length > 0 ? parts.join('; ') : 'nothing to move',
+        };
+    },
+};
+//# sourceMappingURL=roadmap-layout.js.map

package/dist/doctor/migrations/roadmap-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-layout.js","sourceRoot":"","sources":["../../../src/doctor/migrations/roadmap-layout.ts"],"names":[],"mappings":"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"}

package/dist/doctor/migrations/stale-idea-skill.d.ts

@@ -0,0 +1,28 @@
+/**
+ * stale-idea-skill migration (roadmap-revamp/AC-47, safe tier): remove the
+ * artifacts left behind when `aidlc-idea` was renamed to `aidlc-roadmap`.
+ *
+ * Renaming a framework skill leaves residue, because the emitters only ever
+ * *write* — `FileOp` has `create`, `replace` and `merge-block`, and no delete.
+ * So an existing project that updates gets the new skill and keeps the old one,
+ * and the old one is a live instruction pointing at a canonical body that no
+ * longer exists. An agent reading it follows a dangling path. That is a
+ * correctness problem, not untidiness, which is why this ships with the rename
+ * rather than after it.
+ *
+ * Safe tier, but narrowly: a file is deleted only when its content still points
+ * at the old canonical path. A user who edited their copy keeps it. Deleting on
+ * filename alone would be the destructive version of this migration, and the
+ * project has already learned that narrowing the blast radius to what you own is
+ * the precondition for repairing automatically.
+ */
+import type { Migration } from '../types.js';
+/**
+ * Orphaned artifact paths present and still pointing at the old canonical body.
+ *
+ * The canonical body itself is matched on its own heading instead, since it does
+ * not reference its own path.
+ */
+export declare function staleIdeaSkillPaths(projectRoot: string): string[];
+export declare const staleIdeaSkill: Migration;
+//# sourceMappingURL=stale-idea-skill.d.ts.map

package/dist/doctor/migrations/stale-idea-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-idea-skill.d.ts","sourceRoot":"","sources":["../../../src/doctor/migrations/stale-idea-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAsB7C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBjE;AAED,eAAO,MAAM,cAAc,EAAE,SA0C5B,CAAC"}

package/dist/doctor/migrations/stale-idea-skill.js

@@ -0,0 +1,111 @@
+/**
+ * stale-idea-skill migration (roadmap-revamp/AC-47, safe tier): remove the
+ * artifacts left behind when `aidlc-idea` was renamed to `aidlc-roadmap`.
+ *
+ * Renaming a framework skill leaves residue, because the emitters only ever
+ * *write* — `FileOp` has `create`, `replace` and `merge-block`, and no delete.
+ * So an existing project that updates gets the new skill and keeps the old one,
+ * and the old one is a live instruction pointing at a canonical body that no
+ * longer exists. An agent reading it follows a dangling path. That is a
+ * correctness problem, not untidiness, which is why this ships with the rename
+ * rather than after it.
+ *
+ * Safe tier, but narrowly: a file is deleted only when its content still points
+ * at the old canonical path. A user who edited their copy keeps it. Deleting on
+ * filename alone would be the destructive version of this migration, and the
+ * project has already learned that narrowing the blast radius to what you own is
+ * the precondition for repairing automatically.
+ */
+import { existsSync, readFileSync, readdirSync, rmSync, rmdirSync } from 'node:fs';
+import { join } from 'node:path';
+/** The canonical body path the orphaned artifacts still reference. */
+const OLD_CANONICAL = '.aidlc/skills/aidlc-idea.md';
+/**
+ * Every path the old skill name could have been emitted to, across all five
+ * supported platforms.
+ *
+ * Listed rather than derived from the platform config: a project that switched
+ * platforms still has the artifacts from the one it used before, and those are
+ * exactly the ones nothing else will ever clean up.
+ */
+const ORPHAN_PATHS = [
+    OLD_CANONICAL,
+    '.claude/skills/aidlc-idea/SKILL.md',
+    '.kiro/skills/aidlc-idea/SKILL.md',
+    '.cursor/rules/aidlc-idea.mdc',
+    '.windsurf/rules/aidlc-idea.md',
+    '.agents/skills/aidlc-idea/SKILL.md',
+];
+/**
+ * Orphaned artifact paths present and still pointing at the old canonical body.
+ *
+ * The canonical body itself is matched on its own heading instead, since it does
+ * not reference its own path.
+ */
+export function staleIdeaSkillPaths(projectRoot) {
+    const found = [];
+    for (const rel of ORPHAN_PATHS) {
+        const abs = join(projectRoot, ...rel.split('/'));
+        if (!existsSync(abs))
+            continue;
+        let body;
+        try {
+            body = readFileSync(abs, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const isFrameworkOwned = rel === OLD_CANONICAL
+            ? /^#\s+Idea Capture and Backlog\s*$/m.test(body)
+            : body.includes(OLD_CANONICAL);
+        if (isFrameworkOwned)
+            found.push(rel);
+    }
+    return found;
+}
+export const staleIdeaSkill = {
+    id: 'stale-idea-skill',
+    tier: 'safe',
+    check(ctx) {
+        const stale = staleIdeaSkillPaths(ctx.projectRoot);
+        if (stale.length === 0) {
+            return { applicable: true, pending: false };
+        }
+        return {
+            applicable: true,
+            pending: true,
+            description: `would remove ${stale.length} orphaned aidlc-idea skill file(s) superseded by aidlc-roadmap: ${stale.join(', ')}`,
+        };
+    },
+    apply(ctx) {
+        const stale = staleIdeaSkillPaths(ctx.projectRoot);
+        if (stale.length === 0)
+            return { changed: false, summary: 'no orphaned files' };
+        const removed = [];
+        for (const rel of stale) {
+            try {
+                rmSync(join(ctx.projectRoot, ...rel.split('/')));
+                removed.push(rel);
+            }
+            catch {
+                continue;
+            }
+            // A per-skill directory left empty by the removal is itself residue.
+            const parent = join(ctx.projectRoot, ...rel.split('/').slice(0, -1));
+            if (parent.endsWith('aidlc-idea')) {
+                try {
+                    if (readdirSync(parent).length === 0)
+                        rmdirSync(parent);
+                }
+                catch {
+                    // A non-empty or unremovable directory is not a failure.
+                }
+            }
+        }
+        return {
+            changed: removed.length > 0,
+            summary: `removed ${removed.length} orphaned aidlc-idea file(s): ${removed.join(', ')}`,
+        };
+    },
+};
+//# sourceMappingURL=stale-idea-skill.js.map

package/dist/doctor/migrations/stale-idea-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-idea-skill.js","sourceRoot":"","sources":["../../../src/doctor/migrations/stale-idea-skill.ts"],"names":[],"mappings":"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"}

package/dist/events/event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,KAAK,EACV,aAAa,EAEb,YAAY,EACZ,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAM1B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9E;AAkDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyB3E;AAMD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACxC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAwE1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE3E;AA0ED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,cAAc,CA6ChB"}
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/events/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EACV,aAAa,EAEb,YAAY,EACZ,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAM1B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM9E;AAkDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyB3E;AAMD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACxC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAwG1C;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAE3E;AA0ED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,IAAI,CAClB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,cAAc,CA6ChB"}