@rasensio/aidlc 1.12.0 → 1.13.0

package/dist/core/version.js

@@ -0,0 +1,69 @@
+/**
+ * The package's own version and name — read once, from one place
+ * (roadmap-revamp/AC-18).
+ *
+ * Two call sites resolved `package.json` independently before this module
+ * existed, at *different* relative depths because each computed the path from
+ * its own compiled location: `cli.ts` builds to `dist/cli.js` so the package
+ * root is `..`, while `commands/update.ts` builds to `dist/commands/update.js`
+ * so it is `../..`. Both were correct and neither was copyable. A third reader
+ * at a third depth — roadmap-revamp added one — is a third chance to get it
+ * wrong, and the failure mode is silent: a bad path throws, the catch returns
+ * `0.0.0`, and the CLI reports a version it is not.
+ *
+ * Resolving here once removes the choice. This module compiles to
+ * `dist/core/version.js`, so the package root is `../..`.
+ *
+ * The values are module constants rather than functions because the manifest
+ * cannot change while the process runs, and a constant is what a template
+ * emitter can interpolate without threading a call through its signature.
+ *
+ * Deliberately NOT a literal: `scripts/check-docs-drift.mjs` fails the build on
+ * a hardcoded version in `cli.ts` because v1.1.0 shipped reporting `0.1.0`. The
+ * same check now covers the roadmap authoring skill's source template
+ * (roadmap-revamp/AC-17).
+ *
+ * @module
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Fallbacks match the ones the previous private readers used. */
+const FALLBACK_VERSION = '0.0.0';
+const FALLBACK_NAME = '@rasensio/aidlc';
+/**
+ * Absolute path to this package's root — the directory holding `package.json`.
+ *
+ * Exported because `commands/update.ts` needs the root itself, not only the
+ * two fields read from the manifest inside it.
+ */
+export function cliPackageRoot() {
+    return join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+}
+/**
+ * Read the manifest once at module load.
+ *
+ * A throw here is not fatal: an unreadable manifest means a broken install, and
+ * every previous reader degraded to a placeholder rather than refusing to run.
+ * That behaviour is preserved so this refactor cannot change what a damaged
+ * install does.
+ */
+function readManifest() {
+    try {
+        const raw = readFileSync(join(cliPackageRoot(), 'package.json'), 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            version: typeof parsed.version === 'string' ? parsed.version : FALLBACK_VERSION,
+            name: typeof parsed.name === 'string' ? parsed.name : FALLBACK_NAME,
+        };
+    }
+    catch {
+        return { version: FALLBACK_VERSION, name: FALLBACK_NAME };
+    }
+}
+const manifest = readManifest();
+/** This package's version, e.g. `1.12.0`. */
+export const VERSION = manifest.version;
+/** This package's npm name, e.g. `@rasensio/aidlc`. */
+export const PACKAGE_NAME = manifest.name;
+//# sourceMappingURL=version.js.map

package/dist/core/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/core/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,kEAAkE;AAClE,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0C,CAAC;QACxE,OAAO;YACL,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB;YAC/E,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa;SACpE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;AAEhC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,OAAO,GAAW,QAAQ,CAAC,OAAO,CAAC;AAEhD,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAAW,QAAQ,CAAC,IAAI,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;AAe7C,eAAO,MAAM,UAAU,EAAE,SAAS,EAiBjC,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;AAiB7C,eAAO,MAAM,UAAU,EAAE,SAAS,EAsBjC,CAAC"}

package/dist/doctor/migrations/index.js

@@ -18,12 +18,19 @@ import { unknownAgentClaims } from './unknown-agent-claims.js';
 import { legacyCostHooks } from './legacy-cost-hooks.js';
 import { missingCostShim } from './missing-cost-shim.js';
 import { installGuidance } from './install-guidance.js';
+import { staleIdeaSkill } from './stale-idea-skill.js';
+import { roadmapLayout } from './roadmap-layout.js';
 export const MIGRATIONS = [
     costGitignore,
     knowledgeGitignore,
     gitattributes,
     shippedActions,
     installGuidance,
+    // Ordered before roadmap-layout: the orphaned skill still describes the old
+    // ideas directory, so clearing it first means a single run never leaves an
+    // instruction on disk that contradicts the layout the next migration creates.
+    staleIdeaSkill,
+    roadmapLayout,
     untrackCostEphemera,
     pruneSessionStash,
     pruneCostLocks,

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;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,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,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,eAAe;IACf,eAAe;CAChB,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,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,aAAa;IACb,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,eAAe;IACf,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,cAAc;IACd,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,cAAc;IACd,wBAAwB;IACxB,aAAa;IACb,kBAAkB;IAClB,6EAA6E;IAC7E,6EAA6E;IAC7E,4EAA4E;IAC5E,eAAe;IACf,eAAe;CAChB,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"}