@encore-os/eos-spec 0.3.1

package/dist/commands/reconcile.js

@@ -0,0 +1,187 @@
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { resolveTasksArtifact, setPipelineStatus, setTasksArtifact } from '../lib/frontmatter.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { computeStage, rank } from '../lib/pipeline-map.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { extractSpecId, listSpecs } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+/** Classify frontmatter status vs the artifact-derived stage. */
+export function classify(written, computed) {
+    if (written === computed)
+        return 'ok';
+    return rank(computed) > rank(written) ? 'lagging' : 'overstated';
+}
+/** Human-output scope label: `--spec` wins over `--core`; `--changed` → 'changed'; default `all`. */
+export function reconcileScopeLabel(opts) {
+    if (opts.spec)
+        return String(opts.spec).toUpperCase();
+    if (opts.core)
+        return String(opts.core).toLowerCase();
+    if (opts.changed)
+        return 'changed';
+    return 'all';
+}
+/** Human-readable report: header + BOTH divergence directions, each with ids. */
+export function formatReconcileText(args) {
+    const diverged = args.rows.filter((r) => r.direction !== 'ok');
+    const overstated = diverged.filter((r) => r.direction === 'overstated');
+    const lagging = diverged.filter((r) => r.direction === 'lagging');
+    const line = (r) => `    ${r.id}: written=${r.written ?? '(none)'} computed=${r.computed ?? '(none)'}`;
+    return [
+        `reconcile (${args.scope}): ${args.total} specs, ${diverged.length} diverged${args.write ? ' (written)' : ' (dry-run; pass --write to apply)'}`,
+        `  overstated (status claims more than artifacts prove): ${overstated.length}`,
+        ...overstated.slice(0, 50).map(line),
+        `  lagging (artifacts prove more than status claims): ${lagging.length}`,
+        ...lagging.slice(0, 50).map(line),
+    ].join('\n');
+}
+/**
+ * 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 function specIdsFromChangedPaths(paths) {
+    const ids = [];
+    for (const p of paths) {
+        const m = /(^|\/)specs\/([a-z]{2,3})\/(?:specs|ux)\/.+\.md$/i.exec(p);
+        if (!m)
+            continue;
+        const base = p.split('/').pop() ?? '';
+        const id = extractSpecId(base, m[2]);
+        if (id)
+            ids.push(id.toUpperCase());
+    }
+    return [...new Set(ids)];
+}
+/** Parse `git status --porcelain` output into pathnames (rename rows yield the new path). */
+export function pathsFromPorcelain(out) {
+    return out
+        .split('\n')
+        .filter((line) => line.length > 3)
+        .map((line) => line.slice(3).trim())
+        .map((p) => (p.includes(' -> ') ? (p.split(' -> ').pop() ?? p) : p))
+        .map((p) => p.replace(/^"(.*)"$/, '$1'))
+        .filter(Boolean);
+}
+/**
+ * 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 function gitChangedPaths(repoRoot, base) {
+    const split = (out) => out
+        .split('\n')
+        .map((l) => l.trim())
+        .filter(Boolean);
+    let committed = [];
+    try {
+        committed = split(execSync(`git diff --name-only ${base}...HEAD`, { cwd: repoRoot, encoding: 'utf8' }));
+    }
+    catch {
+        try {
+            committed = split(execSync('git diff --name-only HEAD', { cwd: repoRoot, encoding: 'utf8' }));
+        }
+        catch {
+            committed = [];
+        }
+    }
+    let workingTree = [];
+    try {
+        workingTree = pathsFromPorcelain(execSync('git status --porcelain', { cwd: repoRoot, encoding: 'utf8' }));
+    }
+    catch {
+        workingTree = [];
+    }
+    return [...new Set([...committed, ...workingTree])];
+}
+export function registerReconcile(program) {
+    program
+        .command('reconcile')
+        .description('Recompute pipeline_status from artifacts; report divergence and (with --write) materialize it.')
+        .option('--core <core>', 'Limit to one core (default: all)')
+        .option('--spec <id>', 'Limit to one spec ID (safer than a whole-corpus write)')
+        .option('--changed', 'Limit to specs changed vs --base (scoped write — avoids corpus-wide conflicts)', false)
+        .option('--base <ref>', 'Base ref for --changed', 'origin/development')
+        .option('--write', 'Materialize the computed status into spec frontmatter', false)
+        .action(withEventLog('reconcile', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        // A bare `reconcile --write` rewrites pipeline_status across the WHOLE corpus,
+        // which collides with other parallel branches. Require an explicit scope when
+        // writing; dry-run stays unscoped. `--core`, `--spec`, and `--changed` all count.
+        if (options.write && !options.spec && !options.core && !options.changed) {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.SCOPE_REQUIRED,
+                    message: 'reconcile --write requires --spec/--core/--changed',
+                },
+                text: 'reconcile: --write requires a scope — pass --spec <id>, --core <core>, or --changed (bare corpus-wide writes are rejected)',
+                exitCode: 2,
+            });
+            return;
+        }
+        const all = listSpecs(repoRoot, options.core);
+        let specs = all;
+        if (options.changed) {
+            const ids = new Set(specIdsFromChangedPaths(gitChangedPaths(repoRoot, options.base)));
+            specs = specs.filter((s) => ids.has(s.id.toUpperCase()));
+        }
+        if (options.spec) {
+            specs = specs.filter((s) => s.id.toUpperCase() === String(options.spec).toUpperCase());
+        }
+        const rows = specs.map((spec) => {
+            const computed = computeStage(spec);
+            const written = spec.signals.pipelineStatus;
+            const direction = classify(written, computed);
+            if (options.write && computed) {
+                const original = readFileSync(spec.path, 'utf8');
+                let text = original;
+                if (direction !== 'ok')
+                    text = setPipelineStatus(text, computed);
+                // Materialize artifacts.tasks alongside pipeline_status so a spec that
+                // reaches tasks_generated satisfies the pipeline-status validator
+                // (pipeline/missing-tasks-artifact) without hand-editing (#997 Bug 2).
+                // Non-destructive: a VALID existing pointer (canonical or not — many
+                // specs use `<id>-credentialing-compliance-TASKS.md` etc.) is preserved.
+                // Only an absent or stale (dangling) pointer is set to the canonical
+                // path, and only when that canonical file actually exists (#16).
+                if (spec.hasTasks) {
+                    const fileExists = (rel) => existsSync(isAbsolute(rel) ? rel : join(repoRoot, rel));
+                    const next = resolveTasksArtifact(text, `specs/${spec.core}/tasks/${spec.id}-TASKS.md`, fileExists);
+                    if (next)
+                        text = setTasksArtifact(text, next);
+                }
+                if (text !== original)
+                    writeFileSync(spec.path, text, 'utf8');
+            }
+            return { id: spec.id, core: spec.core, written, computed, direction };
+        });
+        const diverged = rows.filter((r) => r.direction !== 'ok');
+        const overstated = diverged.filter((r) => r.direction === 'overstated');
+        emit(global, {
+            ok: true,
+            data: {
+                total: rows.length,
+                diverged: diverged.length,
+                overstated: overstated.length,
+                wrote: Boolean(options.write),
+                rows: diverged,
+            },
+            text: formatReconcileText({
+                scope: reconcileScopeLabel({ spec: options.spec, core: options.core, changed: options.changed }),
+                total: rows.length,
+                rows,
+                write: Boolean(options.write),
+            }),
+        });
+    }));
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/commands/reconcile.js.map

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

package/dist/commands/rollup.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerReadinessRollup(program: Command): void;

package/dist/commands/rollup.js

@@ -0,0 +1,43 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { coresList, getRepoRoot } from '../lib/repo.js';
+import { computeRollup } from '../lib/rollup.js';
+import { buildScorecardForCore } from '../lib/scorecard-run.js';
+import { scanVerifies } from '../lib/verifies-scan.js';
+import { withEventLog } from '../lib/with-event-log.js';
+export function registerReadinessRollup(program) {
+    program
+        .command('readiness-rollup')
+        .description("Aggregate every core's scorecard into a ranked platform readiness view (most-ready first).")
+        .option('--save', 'Write docs/development/PLATFORM_READINESS_ROLLUP_<date>.md', false)
+        .action(withEventLog('readiness-rollup', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const verifiedBySpec = scanVerifies(repoRoot);
+        const perCore = coresList(repoRoot).map((core) => buildScorecardForCore(repoRoot, core, verifiedBySpec));
+        const report = computeRollup(perCore);
+        const header = '| Core | Specs | Authored % | Claims complete | Unverified-complete | Verified % |';
+        const sep = '|------|-------|-----------|-----------------|---------------------|-----------|';
+        const rowLines = report.rows.map((r) => `| ${r.core} | ${r.total} | ${r.authoredPct}% | ${r.claimsComplete} | ${r.claimedCompleteButUnverified} | ${r.verifiedPct}% |`);
+        const text = [
+            `Platform readiness rollup — ${report.cores.length} cores, ${report.totals.specs} specs`,
+            `  claimed complete            : ${report.totals.claimsComplete}`,
+            `  claimed-complete-UNVERIFIED : ${report.totals.claimedCompleteButUnverified}    ← the platform verification-debt headline`,
+            `  specs w/ verified reqs      : ${report.totals.withVerifiedRequirements} (${report.totals.verifiedPct}%)`,
+            '',
+            header,
+            sep,
+            ...rowLines,
+        ].join('\n');
+        if (options.save) {
+            const date = new Date().toISOString().slice(0, 10);
+            const dir = join(repoRoot, 'docs/development');
+            mkdirSync(dir, { recursive: true });
+            const body = `# Platform Readiness Rollup — ${date}\n\n> Ranked most-ready first. Source: \`eos-spec scorecard\` per core (deterministic). "Verified %" = specs with >=1 \`@verifies\`-backed requirement; "Authored %" = specs at \`tasks_generated\`.\n\n\`\`\`\n${text}\n\`\`\`\n`;
+            writeFileSync(join(dir, `PLATFORM_READINESS_ROLLUP_${date}.md`), body, 'utf8');
+        }
+        emit(global, { ok: true, data: report, text });
+    }));
+}
+//# sourceMappingURL=rollup.js.map

package/dist/commands/rollup.js.map

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

package/dist/commands/scorecard.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+/**
+ * Validate `--core` against the canonical cores list. A bogus core used to fall through to
+ * listSpecs() → 0 specs → an all-zero scorecard with exit 0 — dangerously plausible output.
+ * Returns the normalized core, or an error message naming the valid cores.
+ */
+export declare function resolveCoreFilter(core: string | undefined, repoRoot: string): {
+    core?: string;
+    error?: string;
+};
+export declare function registerScorecard(program: Command): void;

package/dist/commands/scorecard.js

@@ -0,0 +1,55 @@
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { coresList, getRepoRoot, isKnownCore } from '../lib/repo.js';
+import { buildScorecardForCore } from '../lib/scorecard-run.js';
+import { scanVerifies } from '../lib/verifies-scan.js';
+import { withEventLog } from '../lib/with-event-log.js';
+/**
+ * Validate `--core` against the canonical cores list. A bogus core used to fall through to
+ * listSpecs() → 0 specs → an all-zero scorecard with exit 0 — dangerously plausible output.
+ * Returns the normalized core, or an error message naming the valid cores.
+ */
+export function resolveCoreFilter(core, repoRoot) {
+    if (!core)
+        return {};
+    const normalized = core.toLowerCase();
+    if (isKnownCore(normalized, repoRoot))
+        return { core: normalized };
+    return { error: `scorecard: unknown core "${core}". Valid cores: ${coresList(repoRoot).join(', ')}` };
+}
+export function registerScorecard(program) {
+    program
+        .command('scorecard')
+        .description('Deterministic readiness scorecard: per-spec stage, frontmatter accuracy, and @verifies-backed AC validation. Headline: claimed-complete-but-unverified.')
+        .option('--core <core>', 'Limit to one core')
+        .action(withEventLog('scorecard', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const resolved = resolveCoreFilter(options.core, repoRoot);
+        if (resolved.error) {
+            emit(global, {
+                ok: false,
+                error: { code: ErrorCode.UNKNOWN_CORE, message: resolved.error },
+                data: { core: options.core, validCores: coresList(repoRoot) },
+                text: resolved.error,
+            });
+        }
+        const verifiedBySpec = scanVerifies(repoRoot);
+        const report = buildScorecardForCore(repoRoot, resolved.core, verifiedBySpec);
+        const flagged = report.rows.filter((r) => r.claimedCompleteButUnverified);
+        const text = [
+            `Readiness scorecard (${report.core}): ${report.total} specs`,
+            `  claims complete             : ${report.claimsComplete}`,
+            `  claimed-complete-UNVERIFIED : ${report.claimedCompleteButUnverified}    ← @verifies-backed AC validation = 0`,
+            `  specs w/ verified reqs      : ${report.withVerifiedRequirements}`,
+            '',
+            ...(flagged.length
+                ? [
+                    '  Claimed complete but unverified:',
+                    ...flagged.map((r) => `    ${r.id}  (${r.stage}, ${r.requirementsVerified}/${r.requirementsTotal} reqs verified)`),
+                ]
+                : ['  None claimed-complete-but-unverified.']),
+        ].join('\n');
+        emit(global, { ok: true, data: report, text });
+    }));
+}
+//# sourceMappingURL=scorecard.js.map

package/dist/commands/scorecard.js.map

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

package/dist/commands/signoff.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerSignoff(program: Command): void;

package/dist/commands/signoff.js

@@ -0,0 +1,114 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { insertSignoffMarker } from '../lib/frontmatter.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot, specsRoot } from '../lib/repo.js';
+import { diagnoseMissingSpec, findSpec } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+const VALID_TYPES = [
+    'validated',
+    'spec-reviewed',
+    'ux-reviewed',
+    'heal-verified',
+    'docshots',
+    'ui-gate-waived',
+    'submit-e2e-waived',
+    'compliance',
+];
+/** Today's date in YYYY-MM-DD form in the operator's LOCAL timezone, suitable for
+ * sign-off markers. Local (not UTC) so an evening sign-off doesn't stamp tomorrow. */
+function isoToday() {
+    // en-CA formats as YYYY-MM-DD; using local time avoids the UTC off-by-one.
+    return new Date().toLocaleDateString('en-CA');
+}
+export function registerSignoff(program) {
+    program
+        .command('signoff')
+        .description('Write a sign-off marker (validated | ux-reviewed | heal-verified | docshots | ui-gate-waived | submit-e2e-waived | compliance) to a spec; idempotent.')
+        .requiredOption('--spec <id>', 'Spec id (e.g. PM-21)')
+        .requiredOption('--type <type>', 'Marker: validated | spec-reviewed | ux-reviewed | heal-verified | docshots | ui-gate-waived | submit-e2e-waived | compliance')
+        .option('--date <YYYY-MM-DD>', 'Override the marker date (default: today)')
+        .option('--reviewer <name>', 'Reviewer name (compliance sign-off only)')
+        .action(withEventLog('signoff', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const type = options.type;
+        if (!VALID_TYPES.includes(type)) {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.INVALID_ARGUMENT,
+                    message: `signoff: --type must be one of ${VALID_TYPES.join(' | ')} (got "${options.type}")`,
+                },
+                data: null,
+                text: `signoff: --type must be one of ${VALID_TYPES.join(' | ')} (got "${options.type}")`,
+            });
+            return;
+        }
+        const spec = findSpec(repoRoot, options.spec);
+        if (!spec) {
+            const diag = diagnoseMissingSpec(repoRoot, options.spec);
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.SPEC_NOT_FOUND,
+                    message: `signoff: spec ${options.spec} not found (${diag.reason})`,
+                },
+                data: null,
+                text: `signoff: spec ${options.spec} not found (${diag.reason})`,
+            });
+            return;
+        }
+        const date = options.date ?? isoToday();
+        if (type === 'compliance') {
+            const reviewsDir = join(specsRoot(repoRoot), spec.core, 'reviews');
+            const filePath = join(reviewsDir, `${spec.id}-COMPLIANCE-SIGNOFF.md`);
+            if (existsSync(filePath)) {
+                emit(global, {
+                    ok: true,
+                    data: { specId: spec.id, type, date, inserted: false, path: filePath },
+                    text: `signoff: ${spec.id} already has a compliance sign-off file (no change)\n  ${filePath}`,
+                });
+                return;
+            }
+            mkdirSync(dirname(filePath), { recursive: true });
+            const body = [
+                '---',
+                `spec_id: ${spec.id}`,
+                `reviewer: ${options.reviewer ?? '<name>'}`,
+                `date: ${date}`,
+                'determinations:',
+                '  - regime: <regime>',
+                '    status: <reviewed | not-applicable | deferred>',
+                '---',
+                '',
+                `# Compliance Sign-Off: ${spec.id}`,
+                '',
+                '| # | Item | Regulation | Confirmed | Signed Off By | Date |',
+                '|---|------|------------|-----------|---------------|------|',
+                '',
+            ].join('\n');
+            writeFileSync(filePath, body, 'utf8');
+            emit(global, {
+                ok: true,
+                data: { specId: spec.id, type, date, inserted: true, path: filePath },
+                text: `signoff: wrote compliance sign-off scaffold to ${filePath}\n` +
+                    '  edit reviewer + determinations[] (regimes from docs/compliance/*_TRACKING.md), then commit\n' +
+                    `  next: run \`eos-spec reconcile --spec ${spec.id} --write\` to materialize derived pipeline_status`,
+            });
+            return;
+        }
+        const text = readFileSync(spec.path, 'utf8');
+        const { text: next, inserted } = insertSignoffMarker(text, type, date);
+        if (inserted)
+            writeFileSync(spec.path, next, 'utf8');
+        emit(global, {
+            ok: true,
+            data: { specId: spec.id, type, date, inserted, path: spec.path },
+            text: inserted
+                ? `signoff: wrote <!-- ${type}: ${date} --> to ${spec.id}\n  ${spec.path}\n  next: run \`eos-spec reconcile --spec ${spec.id} --write\` to materialize derived pipeline_status`
+                : `signoff: ${spec.id} already has a ${type} marker (no change)\n  ${spec.path}`,
+        });
+    }));
+}
+//# sourceMappingURL=signoff.js.map

package/dist/commands/signoff.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerStatus(program: Command): void;

package/dist/commands/status.js

@@ -0,0 +1,100 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { computeStage } from '../lib/pipeline-map.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { isClaimedCompleteUnverified } from '../lib/spec-debt.js';
+import { findSpec, listSpecs } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+export function registerStatus(program) {
+    program
+        .command('status')
+        .description('Show detail (status, files, completion) for one spec or summary for a core.')
+        .option('--core <core>', 'Show summary for one core')
+        .option('--spec <id>', 'Show detail for one spec')
+        .option('--include-archived', 'Include specs from specs/{core}/archive/', false)
+        .action(withEventLog('status', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        if (options.spec) {
+            const spec = findSpec(repoRoot, options.spec, { includeArchived: options.includeArchived });
+            if (!spec) {
+                emit(global, {
+                    ok: false,
+                    error: { code: ErrorCode.SPEC_NOT_FOUND, message: `status: spec ${options.spec} not found` },
+                    data: null,
+                    text: `status: spec ${options.spec} not found`,
+                });
+            }
+            const tasksPath = join(repoRoot, 'specs', spec.core, 'tasks', `${spec.id}-TASKS.md`);
+            let totalTasks = 0;
+            let completedTasks = 0;
+            if (existsSync(tasksPath)) {
+                const text = readFileSync(tasksPath, 'utf8');
+                totalTasks = (text.match(/^\s*-\s*\[\s*[xX ]\s*\]\s+/gm) ?? []).length;
+                completedTasks = (text.match(/^\s*-\s*\[\s*[xX]\s*\]\s+/gm) ?? []).length;
+            }
+            const claimedCompleteUnverified = isClaimedCompleteUnverified(repoRoot, spec.id);
+            const data = {
+                id: spec.id,
+                core: spec.core,
+                title: spec.title,
+                status: spec.status,
+                pipelineStatus: spec.signals.pipelineStatus,
+                computedStage: computeStage(spec),
+                paths: { spec: spec.path, hasContext: spec.hasContext, hasPlan: spec.hasPlan, hasTasks: spec.hasTasks },
+                tasks: { total: totalTasks, completed: completedTasks },
+                claimedCompleteButUnverified: claimedCompleteUnverified,
+            };
+            emit(global, {
+                ok: true,
+                data,
+                text: [
+                    `Spec    : ${spec.id} — ${spec.title ?? '(no title)'}`,
+                    `Status  : ${spec.status ?? 'unknown'}`,
+                    `Stage   : computed=${computeStage(spec) ?? '(none)'} frontmatter=${spec.signals.pipelineStatus ?? '(none)'}`,
+                    `Archived: ${spec.archived ? 'yes' : 'no'}`,
+                    `Files   : context=${spec.hasContext} plan=${spec.hasPlan} tasks=${spec.hasTasks}`,
+                    `Tasks   : ${completedTasks}/${totalTasks} complete`,
+                    `Path    : ${spec.path}`,
+                    ...(claimedCompleteUnverified
+                        ? [
+                            `⚠ verification-debt: claims complete but 0 @verifies-backed ACs — run \`npm run spec:check-debt\` / \`npm run spec:verify-acs -- --enforce --spec ${spec.id}\``,
+                        ]
+                        : []),
+                ].join('\n'),
+            });
+        }
+        const specs = listSpecs(repoRoot, options.core, { includeArchived: options.includeArchived });
+        const summary = {
+            core: options.core ?? 'all',
+            total: specs.length,
+            archived: specs.filter((s) => s.archived).length,
+            byStatus: tally(specs.map((s) => s.status ?? 'unknown')),
+            byComputedStage: tally(specs.map((s) => computeStage(s))),
+            withPlan: specs.filter((s) => s.hasPlan).length,
+            withTasks: specs.filter((s) => s.hasTasks).length,
+        };
+        const text = [
+            `Status summary (${summary.core}):`,
+            `  Total specs       : ${summary.total}`,
+            `  Archived          : ${summary.archived}`,
+            `  By status (body)  : ${Object.entries(summary.byStatus)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(' ')}`,
+            `  By computed stage : ${Object.entries(summary.byComputedStage)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(' ')}`,
+            `  With plan         : ${summary.withPlan}`,
+            `  With tasks        : ${summary.withTasks}`,
+        ].join('\n');
+        emit(global, { ok: true, data: summary, text });
+    }));
+}
+function tally(items) {
+    const out = {};
+    for (const item of items)
+        out[item] = (out[item] ?? 0) + 1;
+    return out;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/tasks.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+export declare function registerTasks(program: Command): void;
+/**
+ * Rebase relative markdown-link targets written relative to `fromDir` so they
+ * resolve from `toDir` instead. In-document (`#…`), absolute (`/…`), and external
+ * (`scheme:`) links are left untouched; `#anchors` are preserved. Generic — it
+ * handles the TASKS template's sibling (`_templates/…`) and cross-core
+ * (`../pf/…`) links without hardcoding any path (#997 Bug 1).
+ *
+ * Exported for unit testing. Both dirs are POSIX, repo-relative; only their
+ * relative depth matters.
+ */
+export declare function rebaseRelativeLinks(body: string, fromDir: string, toDir: string): string;