@encore-os/eos-spec 0.3.1

package/dist/commands/precedent.js

@@ -0,0 +1,343 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { relative } from 'node:path';
+import { getSpecLastModified } from '../lib/archive.js';
+import { createdTables, findMigrationCollisions, migrationTables } from '../lib/migration-collision.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { searchSpecs } from '../lib/precedent-search.js';
+import { coresList, getRepoRoot, isKnownCore } from '../lib/repo.js';
+import { findSpecsById, listSpecs } from '../lib/specs.js';
+/** Ranked --topic matches shown by default; --all lifts the cap. */
+const TOPIC_LIMIT = 15;
+/** Document-frequency cap for --spec overlap matching. Tables referenced by more specs
+ *  than this are ubiquitous infrastructure (pf_module_permissions, pf_organizations,
+ *  hr_employees, …) and say nothing about WHICH prior art is relevant, so they are
+ *  zero-weighted for overlap matching only (HR-41 measured 90% of its 251 matches came
+ *  solely from 4 such tables). Absolute floor of 30 with a 2.5%-of-corpus scale-up —
+ *  the measured max df is ~15.8% of the corpus, so a relative threshold like
+ *  30%-of-corpus would never fire. */
+export function thresholdForCorpus(corpusSize) {
+    return Math.max(30, Math.ceil(0.025 * corpusSize));
+}
+/** Backtick-quoted {core}_* identifiers referenced in a spec body. */
+export function extractCoreIdentifiers(body, core) {
+    const re = new RegExp(`\`(${core.toLowerCase()}_[a-z0-9_]+)\``, 'gi');
+    const out = new Set();
+    let m;
+    while ((m = re.exec(body)) !== null)
+        out.add(m[1].toLowerCase());
+    return [...out];
+}
+/** Backtick-quoted `{core}_*` identifiers for ANY known core prefix — a spec that
+ *  touches another core's tables is exactly the precedent worth surfacing. */
+export function extractKnownCoreIdentifiers(body, cores) {
+    if (cores.length === 0)
+        return [];
+    const re = new RegExp(`\`((?:${cores.map((c) => c.toLowerCase()).join('|')})_[a-z0-9_]+)\``, 'gi');
+    const out = new Set();
+    let m;
+    while ((m = re.exec(body)) !== null)
+        out.add(m[1].toLowerCase());
+    return [...out];
+}
+/** Error text for a --core value outside the canonical core list; null when valid.
+ *  A silently-accepted bogus core returns 0 matches with exit 0 — lethal for a
+ *  HALT-to-review gate, so the command exits 1 instead. */
+export function unknownCoreError(core, repoRoot) {
+    if (isKnownCore(core, repoRoot))
+        return null;
+    return `precedent: unknown core "${core}" — valid cores: ${coresList(repoRoot).join(', ')}`;
+}
+export function registerPrecedent(program) {
+    program
+        .command('precedent')
+        .description('Search active + archived specs, registry, and deferred dashboard for prior art.')
+        .option('--spec <id>', 'Lookup precedent for one spec ID')
+        .option('--topic <text>', 'Lookup precedent for a topic keyword')
+        .option('--core <core>', 'Limit search to one core')
+        .option('--all', 'Show every ranked topic match (default: top 15)')
+        .option('--check-migrations', 'Check for migration table collisions on body identifiers (requires --spec)')
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const spec = options.spec ? String(options.spec).toUpperCase() : undefined;
+        const topic = options.topic ? String(options.topic).trim() : undefined;
+        const core = options.core ? String(options.core).toLowerCase() : undefined;
+        const all = Boolean(options.all);
+        const checkMigrations = Boolean(options.checkMigrations);
+        if (!spec && !topic) {
+            emit(global, {
+                ok: false,
+                error: { code: ErrorCode.INVALID_ARGUMENT, message: 'precedent: pass --spec <id> or --topic <text>' },
+                data: null,
+                text: 'precedent: pass --spec <id> or --topic <text>',
+            });
+        }
+        if (core) {
+            const coreError = unknownCoreError(core, repoRoot);
+            if (coreError) {
+                // F7: emit the machine code on the TOP-LEVEL `error` envelope (matching
+                // reconcile.ts) so an agent can switch on envelope.error.code. The
+                // candidate-core list stays in `data.valid` for suggestions.
+                emit(global, {
+                    ok: false,
+                    error: { code: ErrorCode.UNKNOWN_CORE, message: coreError },
+                    data: { core, valid: coresList(repoRoot) },
+                    text: coreError,
+                });
+            }
+        }
+        let report;
+        try {
+            report = buildPrecedentReport(repoRoot, { spec, topic, core, checkMigrations, all });
+        }
+        catch (err) {
+            emit(global, {
+                ok: false,
+                data: null,
+                text: `precedent: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        const total = report.active.length + report.archived.length + report.registry.length + report.deferred.length;
+        const text = formatPrecedentText(report);
+        emit(global, {
+            ok: true,
+            data: report,
+            text: `${text}\n\nTotal matches: ${total}`,
+        });
+    });
+}
+export function buildPrecedentReport(repoRoot, query) {
+    const idUpper = query.spec?.toUpperCase();
+    const warnings = [];
+    let active = [];
+    let archived = [];
+    let targetSpec;
+    let targetBody = '';
+    let targetBodyIds = [];
+    if (idUpper) {
+        // --spec path: identifier-overlap analysis reads spec bodies, so it stays on listSpecs.
+        const specs = listSpecs(repoRoot, query.core, { includeArchived: true });
+        targetSpec = specs.find((s) => s.id.toUpperCase() === idUpper);
+        // Duplicate spec IDs are live in the corpus (e.g. PF-76/PF-77) — surface them
+        // instead of silently analyzing whichever file listSpecs happened to find first.
+        const duplicates = findSpecsById(repoRoot, idUpper, { includeArchived: true });
+        if (duplicates.length > 1) {
+            const paths = duplicates.map((d) => relative(repoRoot, d.path)).join(', ');
+            const used = targetSpec ? relative(repoRoot, targetSpec.path) : 'none';
+            warnings.push(`${duplicates.length} spec files share ID ${idUpper}: ${paths} — identifier analysis uses ${used}`);
+        }
+        const cores = coresList(repoRoot);
+        if (targetSpec && existsSync(targetSpec.path)) {
+            targetBody = readFileSync(targetSpec.path, 'utf8');
+            targetBodyIds = extractKnownCoreIdentifiers(targetBody, cores);
+        }
+        // De-noise stage 1: only identifiers naming REAL tables (a CREATE TABLE in
+        // supabase/migrations) count toward surfacing other specs. The inline scan
+        // measured ~85ms over the live corpus (91 files / 11MB). Identifiers for
+        // not-yet-migrated tables are excluded from overlap but still flow into
+        // bodyIdentifiers and the --check-migrations analysis.
+        const knownTables = migrationTables(repoRoot);
+        const targetTableIds = targetBodyIds.filter((t) => /^[a-z]+_[a-z0-9_]+$/.test(t) && knownTables.has(t));
+        // One pass over the corpus (each spec body read once): which target tables each
+        // spec shares, plus per-table document frequency (df = number of specs whose body
+        // references that table).
+        const sharedByPath = new Map();
+        const df = new Map();
+        if (targetTableIds.length > 0) {
+            for (const s of specs) {
+                if (!existsSync(s.path))
+                    continue;
+                const sIds = extractKnownCoreIdentifiers(readFileSync(s.path, 'utf8'), cores);
+                const shared = targetTableIds.filter((t) => sIds.includes(t));
+                if (shared.length === 0)
+                    continue;
+                sharedByPath.set(s.path, shared);
+                for (const t of shared)
+                    df.set(t, (df.get(t) ?? 0) + 1);
+            }
+        }
+        // De-noise stage 2: zero-weight ubiquitous infrastructure tables (df above the
+        // corpus threshold) for OVERLAP matching only — bodyIdentifiers and
+        // --check-migrations keep the full identifier set.
+        const dfCap = thresholdForCorpus(specs.length);
+        const dfOf = (t) => df.get(t) ?? 0;
+        const toMatch = (s, sharedTables) => ({
+            id: s.id,
+            core: s.core,
+            title: s.title ?? '',
+            status: s.status ?? 'unknown',
+            path: relative(repoRoot, s.path),
+            archived: s.archived,
+            archivedAt: s.archived ? getSpecLastModified(repoRoot, s.path)?.toISOString() : undefined,
+            sharedTables,
+        });
+        // The queried spec itself always leads; other specs rank by Σ(1/df) of their
+        // distinctive shared tables, so the most-distinctive prior art sorts first.
+        const selves = specs.filter((s) => s.id.toUpperCase() === idUpper).map((s) => toMatch(s));
+        const ranked = specs
+            .filter((s) => s.id.toUpperCase() !== idUpper)
+            .map((s) => {
+            const shared = (sharedByPath.get(s.path) ?? []).filter((t) => dfOf(t) <= dfCap);
+            return { spec: s, shared, weight: shared.reduce((sum, t) => sum + 1 / dfOf(t), 0) };
+        })
+            .filter((r) => r.shared.length > 0)
+            .sort((a, b) => b.weight - a.weight || a.spec.id.localeCompare(b.spec.id))
+            .map((r) => toMatch(r.spec, [...r.shared].sort((a, b) => dfOf(a) - dfOf(b) || a.localeCompare(b))));
+        const matches = [...selves, ...ranked];
+        active = matches.filter((m) => !m.archived);
+        archived = matches.filter((m) => m.archived);
+    }
+    else if (query.topic) {
+        // --topic path (precedent v2): ranked, body-aware lexical search over specs/spec-index.json.
+        const limit = query.all ? Number.POSITIVE_INFINITY : TOPIC_LIMIT;
+        const hits = searchSpecs(query.topic, {
+            core: query.core,
+            repoRoot,
+            includeArchived: true,
+            limit: Number.POSITIVE_INFINITY,
+        });
+        const isArchivedHit = (h) => h.status === 'archived' || h.file.includes('/archive/');
+        const toRanked = (h, isArchived) => ({
+            id: h.id,
+            core: h.core,
+            title: h.title,
+            status: h.status,
+            path: h.file,
+            archived: isArchived,
+            score: h.score,
+            matchedFields: h.matchedFields,
+        });
+        active = hits
+            .filter((h) => !isArchivedHit(h))
+            .slice(0, limit)
+            .map((h) => toRanked(h, false));
+        archived = hits
+            .filter(isArchivedHit)
+            .slice(0, limit)
+            .map((h) => toRanked(h, true));
+    }
+    const registry = scanLines(`${repoRoot}/specs/SPEC_STATUS_REGISTRY.md`, query);
+    const deferred = scanLines(`${repoRoot}/specs/DEFERRED_DASHBOARD.md`, query);
+    const report = { query, warnings, active, archived, registry, deferred };
+    // Migration collision check (only meaningful with --spec)
+    if (query.checkMigrations && targetSpec) {
+        const created = createdTables(targetBody, targetBodyIds);
+        report.bodyIdentifiers = targetBodyIds;
+        report.migrationCollisions = findMigrationCollisions(repoRoot, created);
+    }
+    return report;
+}
+function scanLines(path, query) {
+    if (!existsSync(path))
+        return [];
+    const lines = readFileSync(path, 'utf8').split('\n');
+    const topicLower = query.topic?.toLowerCase();
+    const specUpper = query.spec?.toUpperCase();
+    const coreUpper = query.core?.toUpperCase();
+    const out = [];
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        if (line.startsWith('#'))
+            continue;
+        if (specUpper && !line.toUpperCase().includes(specUpper))
+            continue;
+        if (topicLower && !line.toLowerCase().includes(topicLower))
+            continue;
+        const id = extractId(line);
+        if (coreUpper && id && !id.startsWith(`${coreUpper}-`))
+            continue;
+        if (coreUpper && !id && !line.toUpperCase().includes(`${coreUpper}-`))
+            continue;
+        out.push({ id, line });
+    }
+    return out.slice(0, 30);
+}
+function extractId(line) {
+    const match = /([A-Z]{2,3}-\d+(?:\.\d+)?(?:-(?:EN-\d+|E\d+|P\d+(?:\.\d+)?(?:-EN-\d+)?))?)/.exec(line);
+    return match?.[1];
+}
+function formatSpecLine(item, rank) {
+    if (item.score !== undefined) {
+        return `  ${rank}. ${item.id} (score ${item.score}) ${item.title} — ${item.path}`;
+    }
+    const shares = item.sharedTables && item.sharedTables.length > 0 ? ` — shares: ${item.sharedTables.join(', ')}` : '';
+    return `  - ${item.id} [${item.status}] ${item.title} (${item.path})${shares}`;
+}
+export function formatPrecedentText(report) {
+    const q = report.query.spec ? `spec=${report.query.spec}` : `topic="${report.query.topic ?? ''}"`;
+    const lines = [`precedent: ${q}${report.query.core ? ` core=${report.query.core}` : ''}`];
+    lines.push('');
+    if (report.warnings.length > 0) {
+        for (const w of report.warnings)
+            lines.push(`⚠ ${w}`);
+        lines.push('');
+    }
+    // --spec overlap lists are ranked but uncapped in the report data; cap the DISPLAY
+    // at TOPIC_LIMIT (--all lifts it) so the section header keeps the true count.
+    // --topic lists are already capped at build time, so the slice is a no-op there.
+    const displayLimit = report.query.spec && !report.query.all ? TOPIC_LIMIT : Number.POSITIVE_INFINITY;
+    const pushSpecSection = (label, items) => {
+        lines.push(`${label} (${items.length}):`);
+        if (items.length === 0) {
+            lines.push('  - none');
+            return;
+        }
+        items.slice(0, displayLimit).forEach((item, i) => {
+            lines.push(formatSpecLine(item, i + 1));
+        });
+        if (items.length > displayLimit) {
+            lines.push(`  … ${items.length - displayLimit} more (use --all)`);
+        }
+    };
+    pushSpecSection('Active specs', report.active);
+    lines.push('');
+    pushSpecSection('Archived specs', report.archived);
+    lines.push('');
+    lines.push(`Registry hits (${report.registry.length}):`);
+    if (report.registry.length === 0) {
+        lines.push('  - none');
+    }
+    else {
+        for (const item of report.registry.slice(0, 8)) {
+            lines.push(`  - ${item.line}`);
+        }
+    }
+    lines.push('');
+    lines.push(`Deferred hits (${report.deferred.length}):`);
+    if (report.deferred.length === 0) {
+        lines.push('  - none');
+    }
+    else {
+        for (const item of report.deferred.slice(0, 8)) {
+            lines.push(`  - ${item.line}`);
+        }
+    }
+    // Migration collision block
+    if (report.bodyIdentifiers !== undefined) {
+        lines.push('');
+        lines.push(`Body identifiers (${report.bodyIdentifiers.length}):`);
+        if (report.bodyIdentifiers.length === 0) {
+            lines.push('  - none');
+        }
+        else {
+            for (const id of report.bodyIdentifiers) {
+                lines.push(`  - ${id}`);
+            }
+        }
+        lines.push('');
+        const cols = report.migrationCollisions ?? [];
+        lines.push(`Migration collisions (${cols.length}):`);
+        if (cols.length === 0) {
+            lines.push('  - none');
+        }
+        else {
+            for (const c of cols) {
+                lines.push(`  - ${c.table}  →  ${c.migration}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=precedent.js.map

package/dist/commands/precedent.js.map

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

package/dist/commands/ready.d.ts

@@ -0,0 +1,28 @@
+import type { Command } from 'commander';
+import { type BlockerRef, type Readiness } from '../lib/blockers.js';
+import { type SpecFile } from '../lib/specs.js';
+/** In-progress = has a status that is not Complete and not terminal (deferred/archived/blocked/
+ *  superseded). Shares the canonical predicate with `next`'s candidate filter. */
+export declare function inProgress(s: SpecFile): boolean;
+export type Proposal = {
+    specId: string;
+    /** Blocker ids extracted from the spec's dirty `dependencies`, with resolved state. */
+    candidateBlockers: BlockerRef[];
+    /** A `dependencies` block was present but yielded no extractable spec-id (prose only). */
+    hadProse: boolean;
+};
+/**
+ * Pure core of the migration proposal: given each in-progress spec's raw
+ * `dependencies` value and the full corpus, extract spec-id tokens, drop a
+ * self-reference, and resolve each to complete/open/unknown. No I/O.
+ */
+export declare function buildProposals(inputs: {
+    id: string;
+    depsRaw: unknown;
+}[], corpus: SpecFile[]): Proposal[];
+/** Blocked-section lines for the default listing. Unknown blocker ids carry the
+ *  same remediation hint `--propose` prints, instead of only a bare `(unknown)`. */
+export declare function formatBlockedLines(blocked: Readiness[]): string[];
+/** Drop specs that carry an active claim from another worktree, unless includeClaimed. */
+export declare function excludeClaimed(repoRoot: string, specs: SpecFile[], includeClaimed: boolean): SpecFile[];
+export declare function registerReady(program: Command): void;

package/dist/commands/ready.js

@@ -0,0 +1,147 @@
+import { readFileSync } from 'node:fs';
+import { collectSpecIds, computeReadiness, isComplete, isTerminal, } from '../lib/blockers.js';
+import { activeClaims, readClaims } from '../lib/claims.js';
+import { readFrontmatter } from '../lib/frontmatter.js';
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { listSpecs } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+/** In-progress = has a status that is not Complete and not terminal (deferred/archived/blocked/
+ *  superseded). Shares the canonical predicate with `next`'s candidate filter. */
+export function inProgress(s) {
+    return Boolean(s.status) && !isComplete(s) && !isTerminal(s);
+}
+/**
+ * Pure core of the migration proposal: given each in-progress spec's raw
+ * `dependencies` value and the full corpus, extract spec-id tokens, drop a
+ * self-reference, and resolve each to complete/open/unknown. No I/O.
+ */
+export function buildProposals(inputs, corpus) {
+    const byId = new Map(corpus.map((s) => [s.id.toUpperCase(), s]));
+    return inputs.map(({ id, depsRaw }) => {
+        const ids = collectSpecIds(depsRaw).filter((dep) => dep.toUpperCase() !== id.toUpperCase());
+        const candidateBlockers = ids.map((dep) => {
+            const target = byId.get(dep.toUpperCase());
+            return { id: dep, state: !target ? 'unknown' : isComplete(target) ? 'complete' : 'open' };
+        });
+        return { specId: id, candidateBlockers, hadProse: depsRaw != null && ids.length === 0 };
+    });
+}
+/**
+ * Read-only migration proposal: extract spec-id tokens from each in-progress
+ * spec's dirty `dependencies` frontmatter, resolve their status, and emit a
+ * per-spec proposal (plus a copy-pasteable `blocked_by:` block of the ids that
+ * resolve to real specs) for a human to promote. Never writes frontmatter.
+ */
+function propose(repoRoot, core) {
+    const corpus = listSpecs(repoRoot);
+    const candidates = listSpecs(repoRoot, core).filter(inProgress);
+    const inputs = candidates.map((spec) => {
+        let depsRaw;
+        try {
+            depsRaw = readFrontmatter(readFileSync(spec.path, 'utf8')).dependencies;
+        }
+        catch {
+            depsRaw = undefined;
+        }
+        return { id: spec.id, depsRaw };
+    });
+    const proposals = buildProposals(inputs, corpus);
+    const withCandidates = proposals.filter((p) => p.candidateBlockers.length > 0);
+    const lines = [
+        `ready --propose: ${candidates.length} in-progress spec(s)${core ? ` in ${core}` : ''}; ${withCandidates.length} have extractable blocker ids.`,
+        'Review each, then paste the suggested block into the spec frontmatter. Drop any that are "builds-on" (not hard blockers); entries already marked (complete) are cleared and can be omitted:',
+        '',
+    ];
+    for (const p of withCandidates) {
+        const resolved = p.candidateBlockers.filter((b) => b.state !== 'unknown');
+        const unknown = p.candidateBlockers.filter((b) => b.state === 'unknown');
+        lines.push(`▌ ${p.specId}`);
+        for (const b of p.candidateBlockers)
+            lines.push(`    - ${b.id} (${b.state})`);
+        if (unknown.length > 0) {
+            lines.push(`    ⚠ unresolved id(s) — fix the reference or drop: ${unknown.map((b) => b.id).join(', ')}`);
+        }
+        if (resolved.length > 0) {
+            lines.push('    suggested frontmatter:');
+            lines.push('      blocked_by:');
+            for (const b of resolved)
+                lines.push(`        - ${b.id}`);
+        }
+        lines.push('');
+    }
+    const proseOnly = proposals.filter((p) => p.hadProse).map((p) => p.specId);
+    if (proseOnly.length > 0) {
+        lines.push(`(${proseOnly.length} spec(s) had a dependencies block with no extractable spec-id — prose only.)`);
+    }
+    return { text: lines.join('\n').trimEnd(), data: { proposals } };
+}
+/** Blocked-section lines for the default listing. Unknown blocker ids carry the
+ *  same remediation hint `--propose` prints, instead of only a bare `(unknown)`. */
+export function formatBlockedLines(blocked) {
+    const lines = ['⛔ blocked:'];
+    for (const r of blocked) {
+        const open = r.blockers
+            .filter((b) => b.state !== 'complete')
+            .map((b) => `${b.id} (${b.state})`)
+            .join(', ');
+        lines.push(`    ${r.spec.id} ← ${open}`);
+        const unknown = r.blockers.filter((b) => b.state === 'unknown');
+        if (unknown.length > 0) {
+            lines.push(`      ⚠ unresolved id(s) — fix the reference or drop: ${unknown.map((b) => b.id).join(', ')}`);
+        }
+    }
+    return lines;
+}
+/** Drop specs that carry an active claim from another worktree, unless includeClaimed. */
+export function excludeClaimed(repoRoot, specs, includeClaimed) {
+    if (includeClaimed)
+        return specs;
+    const claimed = new Set(activeClaims(readClaims(repoRoot), Date.now()).map((c) => c.id.toUpperCase()));
+    return specs.filter((s) => !claimed.has(s.id.toUpperCase()));
+}
+export function registerReady(program) {
+    program
+        .command('ready')
+        .description('List in-progress specs whose blockers are all Complete (the bd-ready query); --propose seeds blocked_by from legacy dependencies.')
+        .option('--core <core>', 'Limit to one core')
+        .option('--propose', 'Read-only: propose blocked_by entries extracted from each spec’s dirty dependencies field', false)
+        .option('--include-claimed', 'Include specs already claimed by another worktree', false)
+        .action(withEventLog('ready', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        if (options.propose) {
+            const { text, data } = propose(repoRoot, options.core);
+            emit(global, { ok: true, data, text });
+        }
+        const corpus = listSpecs(repoRoot);
+        const candidates = excludeClaimed(repoRoot, listSpecs(repoRoot, options.core).filter(inProgress), Boolean(options.includeClaimed));
+        const readiness = computeReadiness(candidates, corpus);
+        const ready = readiness.filter((r) => r.ready);
+        const blocked = readiness.filter((r) => !r.ready);
+        const lines = [
+            `ready${options.core ? ` [${options.core}]` : ''}: ${ready.length} unblocked, ${blocked.length} blocked (of ${candidates.length} in-progress).`,
+            '',
+        ];
+        if (ready.length > 0) {
+            lines.push('✅ ready:');
+            for (const r of ready)
+                lines.push(`    ${r.spec.id}`);
+            lines.push('');
+        }
+        if (blocked.length > 0) {
+            lines.push(...formatBlockedLines(blocked));
+        }
+        emit(global, {
+            ok: true,
+            data: {
+                core: options.core ?? null,
+                ready: ready.map((r) => r.spec.id),
+                blocked: blocked.map((r) => ({ specId: r.spec.id, blockers: r.blockers })),
+                totalInProgress: candidates.length,
+            },
+            text: lines.join('\n').trimEnd(),
+        });
+    }));
+}
+//# sourceMappingURL=ready.js.map

package/dist/commands/ready.js.map

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

package/dist/commands/reconcile.d.ts

@@ -0,0 +1,44 @@
+import type { Command } from 'commander';
+export type ReconcileDirection = 'ok' | 'lagging' | 'overstated';
+/** Classify frontmatter status vs the artifact-derived stage. */
+export declare function classify(written: string | undefined, computed: string | undefined): ReconcileDirection;
+export type ReconcileRow = {
+    id: string;
+    core: string;
+    written?: string;
+    computed?: string;
+    direction: ReconcileDirection;
+};
+/** Human-output scope label: `--spec` wins over `--core`; `--changed` → 'changed'; default `all`. */
+export declare function reconcileScopeLabel(opts: {
+    spec?: string;
+    core?: string;
+    changed?: boolean;
+}): string;
+/** Human-readable report: header + BOTH divergence directions, each with ids. */
+export declare function formatReconcileText(args: {
+    scope: string;
+    total: number;
+    rows: ReconcileRow[];
+    write: boolean;
+}): string;
+/**
+ * Map a list of changed file paths to the spec IDs they belong to. Counts
+ * canonical spec markdown under `specs/<core>/specs/…` AND wizard/UX specs under
+ * `specs/<core>/ux/…` (ignores research/reviews/reports and non-spec files).
+ * Ids are extracted with the same parser `listSpecs` uses (`extractSpecId`) so
+ * the `--changed` filter matches corpus identity exactly — including qualifier
+ * ids like `HR-UX-14`. Upper-cased, de-duplicated, input order preserved.
+ * Used by `reconcile --changed` to scope the write to branch-touched specs.
+ */
+export declare function specIdsFromChangedPaths(paths: string[]): string[];
+/** Parse `git status --porcelain` output into pathnames (rename rows yield the new path). */
+export declare function pathsFromPorcelain(out: string): string[];
+/**
+ * Files changed on this branch vs `base` (three-dot; falling back to the diff
+ * vs HEAD when the base ref is unavailable), UNIONED with uncommitted
+ * working-tree changes from `git status --porcelain` — so post-signoff spec
+ * edits that haven't been committed yet are still in scope for `--changed`.
+ */
+export declare function gitChangedPaths(repoRoot: string, base: string): string[];
+export declare function registerReconcile(program: Command): void;