@aperant/framework 0.6.2

package/dist/cli/config/upgrade-layout.mjs

@@ -0,0 +1,324 @@
+/**
+ * upgrade-layout.mjs — C36 migration from the pre-C36 .aperant/ folder shape
+ * to the normalized layout:
+ *
+ *   .aperant/contexts/*         → .aperant/context/installed/*   (durable-source)
+ *   .aperant/context/*.md       → .aperant/context/notes/*.md    (local-private ledgers)
+ *   .aperant/plans/             → removed (must be empty; error if not)
+ *
+ * Contract (mirrors upgrade-gitignore.mjs):
+ *   - Deterministic: sibling files sorted; destination paths computed purely.
+ *   - Idempotent: a second run finds no sources → status:'noop', moves:[].
+ *   - Non-destructive: refuses to delete a non-empty plans/ (status:'conflict').
+ *   - Atomic-per-file: each renameSync is individually atomic; on cross-device
+ *     (EXDEV) we fall back to copyFileSync + unlinkSync. Aborts on first
+ *     failure without attempting rollback — each successful rename is durable,
+ *     so a re-run picks up whatever remains.
+ *   - Collision-safe: every destination path is checked for pre-existence
+ *     before any write; emits status:'conflict' if any destination exists.
+ *
+ * After the physical moves succeed, cascades to runGitignoreUpgrade so the
+ * .aperant/.gitignore picks up the new allowlist (`!context/installed/**`).
+ *
+ * @internal
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, renameSync, rmdirSync, statSync, unlinkSync, } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { parseFlags } from '../util/args.mjs';
+import { withFileLock } from '../util/fs-lock.mjs';
+import { err, exitWith, ok } from '../util/result.mjs';
+import { runGitignoreUpgrade } from './upgrade-gitignore.mjs';
+/**
+ * List plain files at the top level of `dir`. Returns [] if the directory
+ * does not exist. Ignores subdirectories (they may be the new-shape
+ * children we are migrating INTO).
+ */
+function listTopLevelFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        try {
+            if (statSync(full).isFile())
+                out.push(entry);
+        }
+        catch {
+            /* skip unreadable entries */
+        }
+    }
+    return out.sort();
+}
+/**
+ * Plain-file count at `dir` (recursive). Used for the non-empty `plans/`
+ * conflict check — we refuse to silently delete anything.
+ */
+function countFilesRecursive(dir) {
+    if (!existsSync(dir))
+        return 0;
+    let n = 0;
+    for (const entry of readdirSync(dir)) {
+        const full = join(dir, entry);
+        try {
+            const s = statSync(full);
+            if (s.isFile())
+                n += 1;
+            else if (s.isDirectory())
+                n += countFilesRecursive(full);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return n;
+}
+/**
+ * Plan the migration without touching the disk. Pure function — returns the
+ * set of moves, directory removals, and any conflicts detected up front.
+ *
+ * @returns {{
+ *   moves: Array<{from: string, to: string, reason: string}>,
+ *   removeDirs: string[],
+ *   conflicts: Array<{kind: string, path: string, detail?: string}>,
+ *   collisions: string[],
+ * }}
+ */
+function planMigration(aperantDir) {
+    const moves = [];
+    const removeDirs = [];
+    const conflicts = [];
+    const collisions = [];
+    // (1) .aperant/contexts/* → .aperant/context/installed/*
+    const oldContextsDir = join(aperantDir, 'contexts');
+    const newInstalledDir = join(aperantDir, 'context', 'installed');
+    for (const f of listTopLevelFiles(oldContextsDir)) {
+        const from = join(oldContextsDir, f);
+        const to = join(newInstalledDir, f);
+        if (existsSync(to))
+            collisions.push(to);
+        moves.push({ from, to, reason: 'contexts→context/installed' });
+    }
+    if (existsSync(oldContextsDir))
+        removeDirs.push(oldContextsDir);
+    // (2) .aperant/context/*.md (top-level files) → .aperant/context/notes/*.md
+    //     Leave context/installed/ and context/notes/ subdirs untouched.
+    const contextDir = join(aperantDir, 'context');
+    const newNotesDir = join(contextDir, 'notes');
+    for (const f of listTopLevelFiles(contextDir)) {
+        const from = join(contextDir, f);
+        const to = join(newNotesDir, f);
+        if (existsSync(to))
+            collisions.push(to);
+        moves.push({ from, to, reason: 'context/→context/notes' });
+    }
+    // (3) .aperant/plans/ — must be empty; refuse to delete otherwise.
+    const plansDir = join(aperantDir, 'plans');
+    if (existsSync(plansDir)) {
+        const filesInPlans = countFilesRecursive(plansDir);
+        if (filesInPlans > 0) {
+            conflicts.push({
+                kind: 'plans-non-empty',
+                path: plansDir,
+                detail: `${filesInPlans} file(s) present — relocate manually before re-running upgrade-layout`,
+            });
+        }
+        else {
+            removeDirs.push(plansDir);
+        }
+    }
+    return { moves, removeDirs, conflicts, collisions };
+}
+/**
+ * Rename a single file, falling back to copy+unlink on EXDEV (cross-device).
+ */
+function renameWithExdevFallback(from, to) {
+    try {
+        renameSync(from, to);
+    }
+    catch (e) {
+        if (e && e.code === 'EXDEV') {
+            copyFileSync(from, to);
+            unlinkSync(from);
+            return;
+        }
+        throw e;
+    }
+}
+/**
+ * Main entry. Wrapped in a file lock keyed on
+ * `.aperant/config.lock-upgrade-layout` so concurrent callers serialize.
+ *
+ * @param {string} projectRoot
+ * @param {{ dryRun?: boolean }} [opts]
+ * @returns {{
+ *   status: 'ok' | 'noop' | 'conflict',
+ *   dryRun: boolean,
+ *   moves: Array<{from: string, to: string, ok: boolean, error?: string}>,
+ *   removedDirs: string[],
+ *   conflicts: Array<{kind: string, path: string, detail?: string}>,
+ *   collisions: string[],
+ *   gitignoreResult: object | null,
+ *   message: string,
+ * }}
+ */
+export function runLayoutUpgrade(projectRoot, opts = {}) {
+    const dryRun = opts.dryRun === true;
+    const targetDir = resolve(projectRoot);
+    const aperantDir = join(targetDir, '.aperant');
+    const lockPath = join(aperantDir, 'config.lock-upgrade-layout');
+    // Ensure the lock file's parent exists even on a freshly-cloned repo that
+    // has no .aperant/ yet — withFileLock would otherwise reject on mkdir.
+    if (!existsSync(aperantDir)) {
+        return {
+            status: 'noop',
+            dryRun,
+            moves: [],
+            removedDirs: [],
+            conflicts: [],
+            collisions: [],
+            gitignoreResult: null,
+            message: 'No .aperant/ directory — nothing to migrate.',
+        };
+    }
+    return withFileLock(lockPath, () => {
+        const plan = planMigration(aperantDir);
+        // Conflict: non-empty plans/. Refuse to proceed.
+        if (plan.conflicts.length > 0) {
+            return {
+                status: 'conflict',
+                dryRun,
+                moves: [],
+                removedDirs: [],
+                conflicts: plan.conflicts,
+                collisions: plan.collisions,
+                gitignoreResult: null,
+                message: 'Migration blocked: non-empty plans/ directory. Relocate its contents manually before re-running.',
+            };
+        }
+        // Collision: a destination file already exists. Refuse to clobber.
+        if (plan.collisions.length > 0) {
+            return {
+                status: 'conflict',
+                dryRun,
+                moves: [],
+                removedDirs: [],
+                conflicts: [],
+                collisions: plan.collisions,
+                gitignoreResult: null,
+                message: 'Migration blocked: destination path(s) already exist.',
+            };
+        }
+        // Nothing to do — idempotent second run.
+        if (plan.moves.length === 0 && plan.removeDirs.length === 0) {
+            const gi = dryRun ? null : runGitignoreUpgrade(targetDir);
+            return {
+                status: 'noop',
+                dryRun,
+                moves: [],
+                removedDirs: [],
+                conflicts: [],
+                collisions: [],
+                gitignoreResult: gi,
+                message: 'No legacy paths detected — layout already at C36 shape.',
+            };
+        }
+        // Dry-run: report the plan and exit.
+        if (dryRun) {
+            return {
+                status: 'ok',
+                dryRun: true,
+                moves: plan.moves.map((m) => ({ from: m.from, to: m.to, ok: false })),
+                removedDirs: plan.removeDirs,
+                conflicts: [],
+                collisions: [],
+                gitignoreResult: null,
+                message: `Dry run: would move ${plan.moves.length} file(s) and remove ${plan.removeDirs.length} empty dir(s).`,
+            };
+        }
+        // Apply: mkdir parents, rename each file, then rmdir empty legacy dirs.
+        const performedMoves = [];
+        let failingMove = null;
+        try {
+            for (const m of plan.moves) {
+                failingMove = m;
+                const destParent = join(m.to, '..');
+                mkdirSync(destParent, { recursive: true });
+                renameWithExdevFallback(m.from, m.to);
+                performedMoves.push({ from: m.from, to: m.to, ok: true });
+                failingMove = null;
+            }
+        }
+        catch (e) {
+            return {
+                status: 'conflict',
+                dryRun,
+                moves: performedMoves.concat([
+                    {
+                        from: failingMove?.from ?? 'unknown',
+                        to: failingMove?.to ?? 'unknown',
+                        ok: false,
+                        error: String(e?.message ?? e),
+                    },
+                ]),
+                removedDirs: [],
+                conflicts: [],
+                collisions: [],
+                gitignoreResult: null,
+                message: 'Migration aborted mid-apply. Each completed rename is atomic; re-run upgrade-layout to resume.',
+            };
+        }
+        const removedDirs = [];
+        for (const d of plan.removeDirs) {
+            try {
+                // Only remove if now empty (post-move) — preserves safety for
+                // any stray subdirs we did not explicitly migrate.
+                if (existsSync(d) && readdirSync(d).length === 0) {
+                    rmdirSync(d);
+                    removedDirs.push(d);
+                }
+            }
+            catch {
+                /* non-fatal; user can clean up by hand */
+            }
+        }
+        // Cascade: rewrite .aperant/.gitignore to the new allowlist.
+        const gitignoreResult = runGitignoreUpgrade(targetDir);
+        return {
+            status: 'ok',
+            dryRun: false,
+            moves: performedMoves,
+            removedDirs,
+            conflicts: [],
+            collisions: [],
+            gitignoreResult,
+            message: `Migrated ${performedMoves.length} file(s); removed ${removedDirs.length} empty legacy dir(s).`,
+        };
+    }, { projectRoot: targetDir });
+}
+export { listTopLevelFiles as _listTopLevelFilesForTests, planMigration as _planMigrationForTests };
+/**
+ * CLI entry wrapper mirroring cmdConfigUpgradeGitignore's shape.
+ */
+export function cmdConfigUpgradeLayout(projectDir, extraArgs = []) {
+    if (!projectDir) {
+        return err('Usage: apt-tools config upgrade-layout <project-dir> [--dry-run]');
+    }
+    const targetDir = resolve(projectDir);
+    const flags = parseFlags(extraArgs);
+    const dryRun = flags.has('dry-run');
+    const result = runLayoutUpgrade(targetDir, { dryRun });
+    const envelope = {
+        status: result.status,
+        command: 'config-upgrade-layout',
+        projectDir: targetDir,
+        dryRun: result.dryRun,
+        moves: result.moves,
+        removedDirs: result.removedDirs,
+        conflicts: result.conflicts,
+        collisions: result.collisions,
+        gitignoreResult: result.gitignoreResult,
+        message: result.message,
+    };
+    return result.status === 'conflict' ? exitWith(envelope, 2) : ok(envelope);
+}
+//# sourceMappingURL=upgrade-layout.mjs.map

package/dist/cli/config/upgrade-layout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-layout.mjs","sourceRoot":"","sources":["../../../src/cli/config/upgrade-layout.mjs"],"names":[],"mappings":"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"}

package/dist/cli/consistency/check.d.mts

@@ -0,0 +1,21 @@
+/**
+ * @param {{taskDir: string, stage?: string, ruleIds?: string[]}} args
+ */
+export function checkConsistency({ taskDir, stage, ruleIds }?: {
+    taskDir: string;
+    stage?: string;
+    ruleIds?: string[];
+}): Promise<{
+    status: string;
+    stage: string;
+    errors: number;
+    warnings: number;
+    rules: {
+        id: any;
+        severity: any;
+        status: any;
+        drift: any;
+        reason: any;
+    }[];
+}>;
+//# sourceMappingURL=check.d.mts.map

package/dist/cli/consistency/check.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.mts","sourceRoot":"","sources":["../../../src/cli/consistency/check.mjs"],"names":[],"mappings":"AAiCA;;GAEG;AACH,+DAFW;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC;;;;;;;;;;;;GAgD/D"}

package/dist/cli/consistency/check.mjs

@@ -0,0 +1,185 @@
+/**
+ * @internal
+ * consistency/check.mjs — composer: parse every task artifact once, run every
+ * applicable rule, aggregate into a single envelope (C15 subtask 5).
+ *
+ *   checkConsistency({taskDir, stage, ruleIds?}) -> {
+ *     status: 'pass' | 'fail',     // fail iff any error-severity rule failed
+ *     stage,
+ *     errors: N,
+ *     warnings: M,
+ *     rules: [{id, severity, status, drift, reason}]
+ *   }
+ *
+ * Missing artifact files produce empty-shaped parsed payloads + a `present:
+ * false` flag so individual rules can decide whether to skip.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { createCoordinationStore } from '../coordination/store.mjs';
+import { parsePlan } from './parse-plan.mjs';
+import { parsePlanApproval } from './parse-plan-approval.mjs';
+import { parseBuildProgress } from './parse-progress.mjs';
+import { parseQaSignoff } from './parse-qa.mjs';
+import { parseReview } from './parse-review.mjs';
+import { parseSpec } from './parse-spec.mjs';
+import { listRules } from './registry.mjs';
+// Eagerly populate the registry.
+import './rules/index.mjs';
+/**
+ * @param {{taskDir: string, stage?: string, ruleIds?: string[]}} args
+ */
+export async function checkConsistency({ taskDir, stage = 'ship', ruleIds } = {}) {
+    if (!taskDir || typeof taskDir !== 'string') {
+        throw new Error('checkConsistency: taskDir is required');
+    }
+    const parsed = parseTaskArtifacts(taskDir);
+    let rules = listRules({ stage });
+    if (Array.isArray(ruleIds) && ruleIds.length > 0) {
+        const wanted = new Set(ruleIds.map((r) => (typeof r === 'string' ? r.toLowerCase().trim() : '')).filter(Boolean));
+        rules = rules.filter((r) => {
+            // allow matching by full id ('r1-ac-coverage') or short form ('r1').
+            if (wanted.has(r.id.toLowerCase()))
+                return true;
+            const short = r.id.toLowerCase().match(/^(r\d+)/)?.[1];
+            return short ? wanted.has(short) : false;
+        });
+    }
+    const results = [];
+    for (const rule of rules) {
+        let verdict;
+        try {
+            verdict = await rule.check({ taskDir, parsed });
+        }
+        catch (err) {
+            verdict = {
+                status: 'fail',
+                drift: [],
+                reason: `rule threw: ${err?.message ?? String(err)}`,
+            };
+        }
+        const status = verdict?.status ?? 'skip';
+        const drift = Array.isArray(verdict?.drift) ? verdict.drift : [];
+        const reason = typeof verdict?.reason === 'string' ? verdict.reason : '';
+        results.push({ id: rule.id, severity: rule.severity, status, drift, reason });
+    }
+    let errors = 0;
+    let warnings = 0;
+    for (const r of results) {
+        if (r.status !== 'fail')
+            continue;
+        if (r.severity === 'error')
+            errors++;
+        else
+            warnings++;
+    }
+    const status = errors > 0 ? 'fail' : 'pass';
+    return { status, stage, errors, warnings, rules: results };
+}
+function parseTaskArtifacts(taskDir) {
+    const specPath = join(taskDir, 'spec.md');
+    const planPath = join(taskDir, 'implementation_plan.json');
+    const reviewPath = join(taskDir, 'review.json');
+    const qaPath = join(taskDir, 'qa_signoff.json');
+    const progressPath = join(taskDir, 'build-progress.json');
+    const approvalPath = join(taskDir, 'plan_approval.json');
+    const specMd = safeReadText(specPath);
+    const plan = safeReadJson(planPath);
+    const review = safeReadJson(reviewPath);
+    const qa = safeReadJson(qaPath);
+    const progress = safeReadJson(progressPath);
+    const planApproval = safeReadJson(approvalPath);
+    const specParsed = parseSpec(specMd ?? '');
+    // C21 — surface the task record so rules (notably r6-plan-approval) can
+    // branch on task.execution_mode without re-reading state.json. We resolve
+    // the project root by walking up from the task dir (`.aperant/tasks/{id}`).
+    const projectRoot = dirname(dirname(dirname(taskDir)));
+    const taskRecord = readTaskRecord(projectRoot, taskDir);
+    // Hashes used by r6 drift detection.
+    const planHash = sha256OfBytes(planPath);
+    const specHash = sha256OfBytes(specPath);
+    return {
+        spec: {
+            ...specParsed,
+            rawLower: typeof specMd === 'string' ? specMd.toLowerCase() : '',
+            present: specMd !== null,
+            sha256: specHash,
+        },
+        plan: {
+            ...parsePlan(plan),
+            present: plan !== null,
+            sha256: planHash,
+        },
+        review: {
+            ...parseReview(review),
+            present: review !== null,
+        },
+        qa: {
+            ...parseQaSignoff(qa),
+            present: qa !== null,
+        },
+        progress: {
+            ...parseBuildProgress(progress),
+            present: progress !== null,
+        },
+        plan_approval: {
+            ...parsePlanApproval(planApproval),
+            present: planApproval !== null,
+        },
+        task: taskRecord,
+    };
+}
+function readTaskRecord(projectRoot, taskDir) {
+    // `.aperant/tasks/{id}` → derive id from final segment.
+    const segments = taskDir.split(/[\\/]/).filter(Boolean);
+    const taskId = segments[segments.length - 1] || '';
+    // CLAUDE.md C31 R8 — go through CoordinationStore for state reads instead of
+    // hand-rolling readFileSync(state.json). The store handles shared-root
+    // resolution (worktree-aware) and consistent error handling.
+    const state = createCoordinationStore(projectRoot).readState();
+    if (!state)
+        return { id: taskId, present: false, execution_mode: null };
+    const record = state?.active_tasks?.[taskId] ?? null;
+    if (!record)
+        return { id: taskId, present: false, execution_mode: null };
+    return {
+        id: taskId,
+        present: true,
+        execution_mode: typeof record.execution_mode === 'string' ? record.execution_mode : null,
+        lifecycle_phase: typeof record.lifecycle_phase === 'string' ? record.lifecycle_phase : null,
+    };
+}
+function sha256OfBytes(p) {
+    if (!existsSync(p))
+        return null;
+    try {
+        const buf = readFileSync(p);
+        return createHash('sha256').update(buf).digest('hex');
+    }
+    catch {
+        return null;
+    }
+}
+function safeReadText(p) {
+    if (!existsSync(p))
+        return null;
+    try {
+        return readFileSync(p, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function safeReadJson(p) {
+    const text = safeReadText(p);
+    if (text === null)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=check.mjs.map

package/dist/cli/consistency/check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.mjs","sourceRoot":"","sources":["../../../src/cli/consistency/check.mjs"],"names":[],"mappings":"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"}

package/dist/cli/consistency/parse-plan-approval.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @param {object | null | undefined} record
+ */
+export function parsePlanApproval(record: object | null | undefined): {
+    decision: any;
+    actor: any;
+    timestamp: any;
+    plan_hash: any;
+    spec_hash: any;
+    note: any;
+    iteration: any;
+};
+//# sourceMappingURL=parse-plan-approval.d.mts.map

package/dist/cli/consistency/parse-plan-approval.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-plan-approval.d.mts","sourceRoot":"","sources":["../../../src/cli/consistency/parse-plan-approval.mjs"],"names":[],"mappings":"AAsBA;;GAEG;AACH,0CAFW,MAAM,GAAG,IAAI,GAAG,SAAS;;;;;;;;EA2BnC"}

package/dist/cli/consistency/parse-plan-approval.mjs

@@ -0,0 +1,49 @@
+/**
+ * @internal
+ * consistency/parse-plan-approval.mjs — normalize plan_approval.json (C21).
+ *
+ * Input: parsed JSON object (or null/undefined).
+ * Output:
+ *   {
+ *     decision:  'approved' | 'rejected' | 'revise' | 'unknown',
+ *     actor:     string,
+ *     timestamp: string,
+ *     plan_hash: string | null,
+ *     spec_hash: string | null,
+ *     note:      string | null,
+ *     iteration: number
+ *   }
+ *
+ * Tolerant of missing / malformed input — returns null-shaped fields so rules
+ * can decide how to react.
+ */
+const VALID_DECISIONS = new Set(['approved', 'rejected', 'revise']);
+/**
+ * @param {object | null | undefined} record
+ */
+export function parsePlanApproval(record) {
+    if (!record || typeof record !== 'object') {
+        return {
+            decision: 'unknown',
+            actor: '',
+            timestamp: '',
+            plan_hash: null,
+            spec_hash: null,
+            note: null,
+            iteration: 0,
+        };
+    }
+    const decision = VALID_DECISIONS.has(record.decision) ? record.decision : 'unknown';
+    const actor = typeof record.actor === 'string' ? record.actor : '';
+    const timestamp = typeof record.timestamp === 'string' ? record.timestamp : '';
+    const plan_hash = typeof record.plan_hash === 'string' ? record.plan_hash : null;
+    const spec_hash = typeof record.spec_hash === 'string' ? record.spec_hash : null;
+    const note = typeof record.note === 'string' ? record.note : null;
+    const iteration = typeof record.iteration === 'number' &&
+        Number.isFinite(record.iteration) &&
+        record.iteration > 0
+        ? record.iteration
+        : 0;
+    return { decision, actor, timestamp, plan_hash, spec_hash, note, iteration };
+}
+//# sourceMappingURL=parse-plan-approval.mjs.map

package/dist/cli/consistency/parse-plan-approval.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-plan-approval.mjs","sourceRoot":"","sources":["../../../src/cli/consistency/parse-plan-approval.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAA;AAEnE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAM;IACvC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO;YACN,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,CAAC;SACZ,CAAA;IACF,CAAC;IACD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IACnF,MAAM,KAAK,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAClE,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAChF,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;IAChF,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACjE,MAAM,SAAS,GACd,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QACjC,MAAM,CAAC,SAAS,GAAG,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC,SAAS;QAClB,CAAC,CAAC,CAAC,CAAA;IACL,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC7E,CAAC"}

package/dist/cli/consistency/parse-plan.d.mts

@@ -0,0 +1,34 @@
+/**
+ * @internal
+ * consistency/parse-plan.mjs — normalize implementation_plan.json (C15).
+ *
+ * Input: parsed JSON object (or null/undefined).
+ * Output:
+ *   {
+ *     subtasks: [{id, title, acceptance_criteria: string[]}],
+ *     dimensions_covered: Record<axis, {crossed: boolean, values?: object|string[], reason?: string}>
+ *   }
+ *
+ * Legacy alias: `dimensions_crossed` is accepted as a synonym for
+ * `dimensions_covered`.
+ */
+/**
+ * @param {object | null | undefined} plan
+ * @returns {{
+ *   subtasks: Array<{id: string, title: string, acceptance_criteria: string[]}>,
+ *   dimensions_covered: Record<string, {crossed: boolean, values?: unknown, reason?: string}>
+ * }}
+ */
+export function parsePlan(plan: object | null | undefined): {
+    subtasks: Array<{
+        id: string;
+        title: string;
+        acceptance_criteria: string[];
+    }>;
+    dimensions_covered: Record<string, {
+        crossed: boolean;
+        values?: unknown;
+        reason?: string;
+    }>;
+};
+//# sourceMappingURL=parse-plan.d.mts.map