@encore-os/eos-spec 0.3.1

package/dist/commands/list.js

@@ -0,0 +1,61 @@
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { listSpecs } from '../lib/specs.js';
+/** Canonicalize a status value for matching: lowercase and strip everything that is
+ *  not a letter or digit. Makes `--status InProgress`, frontmatter `in_progress`,
+ *  and legacy body prose like `🚧 In Progress (60% Complete)` all comparable. */
+export function canonicalStatus(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, '');
+}
+/** Prefix match on canonicalized status, both sides normalized. An empty filter
+ *  matches nothing (a typo'd flag must not silently return the whole corpus). */
+export function statusMatches(specStatus, filter) {
+    const target = canonicalStatus(filter);
+    if (target.length === 0)
+        return false;
+    return canonicalStatus(specStatus ?? '').startsWith(target);
+}
+export function registerList(program) {
+    program
+        .command('list')
+        .description('List specs filtered by core, status, or completeness. Supports --json on the subcommand.')
+        .option('--core <core>', 'Limit to one core')
+        .option('--status <status>', 'Filter by status — normalized prefix match (case/space/emoji-insensitive). Real values: specification, draft, in_progress, complete, blocked, deferred, archived')
+        .option('--include-archived', 'Include specs from specs/{core}/archive/', false)
+        .option('--missing-plan', 'Only specs with no PLAN.md', false)
+        .option('--missing-tasks', 'Only specs with no TASKS.md', false)
+        .option('--tag <tag>', 'Filter by tag (requires spec-index.json; falls back to unfiltered)')
+        .option('--json', 'Output JSON (also accepted as root-level flag)', false)
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        if (options.json)
+            global.json = true;
+        const repoRoot = getRepoRoot(global.repoRoot);
+        let specs = listSpecs(repoRoot, options.core, { includeArchived: options.includeArchived });
+        if (options.status) {
+            specs = specs.filter((s) => statusMatches(s.status, String(options.status)));
+        }
+        if (options.missingPlan)
+            specs = specs.filter((s) => !s.hasPlan);
+        if (options.missingTasks)
+            specs = specs.filter((s) => !s.hasTasks);
+        const data = specs.map((s) => ({
+            id: s.id,
+            core: s.core,
+            status: s.status ?? 'unknown',
+            title: s.title ?? '',
+            file: s.path,
+            hasPlan: s.hasPlan,
+            hasTasks: s.hasTasks,
+            hasContext: s.hasContext,
+            archived: s.archived,
+        }));
+        const text = data.length === 0
+            ? 'list: no specs match'
+            : data
+                .map((s) => `${s.id.padEnd(10)} [${(s.status ?? '').padEnd(12)}]${s.archived ? ' 🗄️' : ''} plan=${s.hasPlan ? 'Y' : 'N'} tasks=${s.hasTasks ? 'Y' : 'N'}  ${s.title}`)
+                .join('\n');
+        emit(global, { ok: true, data, text });
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/metrics.d.ts

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

package/dist/commands/metrics.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { EVENTS_RELATIVE_PATH } from '../lib/events.js';
+import { computeMetrics } from '../lib/metrics.js';
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { withEventLog } from '../lib/with-event-log.js';
+function loadEvents(path) {
+    if (!existsSync(path))
+        return [];
+    const text = readFileSync(path, 'utf8');
+    const out = [];
+    for (const line of text.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            out.push(JSON.parse(t));
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+    return out;
+}
+export function registerMetrics(program) {
+    program
+        .command('metrics')
+        .description('Roll .claude/tmp/eos-spec-events.jsonl into per-command, per-model, and autonomy metrics.')
+        .option('--since <iso>', 'Only include events at or after this ISO8601 timestamp')
+        .option('--core <core>', 'Only include events for this core')
+        .action(withEventLog('metrics', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const path = process.env.EOS_SPEC_EVENTS_PATH ?? join(repoRoot, EVENTS_RELATIVE_PATH);
+        const events = loadEvents(path);
+        const since = options.since ? new Date(options.since) : undefined;
+        const report = computeMetrics(events, { since, core: options.core });
+        const cmdRows = Object.entries(report.byCommand).map(([k, v]) => `  ${k.padEnd(16)}  count=${String(v.count).padStart(4)}   wall-clock=${(v.wallClockMs / 1000).toFixed(2)}s   success=${(v.successRate * 100).toFixed(0)}%`);
+        const modelRows = Object.entries(report.byModel).map(([k, v]) => `  ${k.padEnd(32)}  calls=${String(v.calls).padStart(3)}   in=${v.tokensIn}   out=${v.tokensOut}   cost=${v.totalCostUsd === null ? '(unknown)' : `$${v.totalCostUsd.toFixed(4)}`}`);
+        const text = [
+            `Workflow metrics (since ${options.since ?? 'beginning'}, ${options.core ?? 'all'}):`,
+            '',
+            '  Commands',
+            '  ─────────────────────────────────────────────────────',
+            ...cmdRows,
+            '',
+            '  AI calls',
+            '  ─────────────────────────────────────────────────────',
+            ...(modelRows.length ? modelRows : ['  (no AI calls in window)']),
+            '',
+            '  Autonomy estimate',
+            '  ─────────────────────────────────────────────────────',
+            `  Longest consecutive-success run: ${report.autonomy.longestRun}`,
+            `  Human touches (halts requiring intervention): ${report.autonomy.humanTouches}`,
+            `  Expected halts (governance gates fired): ${report.autonomy.byHaltCause.expectedHalts}`,
+            `  Unexpected halts (crashes / stalls): ${report.autonomy.byHaltCause.unexpectedHalts}`,
+            ...Object.entries(report.autonomy.byHaltCause.byCause).map(([cause, n]) => `    - ${cause}: ${n}`),
+            report.autonomy.lastHalt
+                ? `  Last halt: ${report.autonomy.lastHalt.command} (${report.autonomy.lastHalt.error ?? 'no error'})`
+                : '  No halts in window',
+        ].join('\n');
+        emit(global, { ok: true, data: report, text });
+    }));
+}
+//# sourceMappingURL=metrics.js.map

package/dist/commands/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/commands/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAqB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAiB,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2FAA2F,CAAC;SACxG,MAAM,CAAC,eAAe,EAAE,wDAAwD,CAAC;SACjF,MAAM,CAAC,eAAe,EAAE,mCAAmC,CAAC;SAC5D,MAAM,CACL,YAAY,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAc,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAA0B,EAAE,CAAC,CAAC;QAC3F,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAClD,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAC9J,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAClD,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CACT,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACtL,CAAC;QACF,MAAM,IAAI,GAAG;YACX,2BAA4B,OAAO,CAAC,KAA4B,IAAI,WAAW,KAAM,OAAO,CAAC,IAA2B,IAAI,KAAK,IAAI;YACrI,EAAE;YACF,YAAY;YACZ,yDAAyD;YACzD,GAAG,OAAO;YACV,EAAE;YACF,YAAY;YACZ,yDAAyD;YACzD,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC;YACjE,EAAE;YACF,qBAAqB;YACrB,yDAAyD;YACzD,sCAAsC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE;YAClE,mDAAmD,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE;YACjF,8CAA8C,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,EAAE;YACzF,0CAA0C,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,eAAe,EAAE;YACvF,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,EAAE,CAAC;YAClG,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBACtB,CAAC,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,UAAU,GAAG;gBACtG,CAAC,CAAC,sBAAsB;SAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/commands/next.d.ts

@@ -0,0 +1,48 @@
+import type { Command } from 'commander';
+import { type BlockerRef, type Readiness } from '../lib/blockers.js';
+import { type ActorType } from '../lib/pipeline-map.js';
+import { type SessionState } from '../lib/session-state.js';
+import { type SpecFile } from '../lib/specs.js';
+export type NextAction = {
+    type: string;
+    specId: string;
+    reason: string;
+    actor: string;
+    actorType: ActorType;
+    invocation: string;
+    optional?: boolean;
+    /** Disagreement between pipeline_status and on-disk artifacts, if any. */
+    note?: string;
+    /** Set for the implement/complete tail. */
+    taskHint?: string;
+};
+/** Disagreement between later artifacts and the first incomplete required gate
+ *  (e.g. tasks exist but validate-spec was never run). Optional and not-applicable
+ *  transitions never count, so only real out-of-order gaps are flagged. */
+export declare function computeOutOfOrder(spec: SpecFile): string | undefined;
+/** Human-output blocker lines for `next --spec`: open blockers and unresolvable
+ *  (likely typo'd) blocked_by references. Cleared (complete) blockers are omitted. */
+export declare function formatSpecBlockers(blockers: BlockerRef[]): string[];
+/** Assemble the `next --spec` human text: action, out-of-order warning, blocker
+ *  lines, landscape advisory. The warning and blockers used to be JSON-only. */
+export declare function buildSpecNextText(spec: SpecFile, action: NextAction, outOfOrder: string | undefined, blockers: BlockerRef[], advisory: string): string;
+/** Pick the core-level next spec from a readiness-ordered list, honoring claims.
+ *  Default: skip specs with an active claim. `--include-claimed`: keep them.
+ *  `--claim`: atomically reserve the chosen spec inside the same lock so two
+ *  concurrent core-picks in separate worktrees return distinct specs.
+ *  Returns null when no eligible candidate remains. */
+export declare function pickCorePick(repoRoot: string, ordered: Readiness[], opts: {
+    claim: boolean;
+    includeClaimed: boolean;
+    by?: string;
+    ttlMinutes?: number;
+}): Readiness | null;
+export declare function registerNext(program: Command): void;
+/** Walk the SSOT pipeline; return the first applicable, not-done transition, else the implement/complete tail.
+ *  An active session (STATE.md) on this spec short-circuits to resuming the in-progress task. */
+export declare function recommendAction(spec: SpecFile, session?: SessionState | null, repoRoot?: string): NextAction;
+/** True when TASKS.md carries at least one status marker we know how to read —
+ *  a GitHub checkbox (`[ ]`/`[x]`) or a ballot-box glyph (☐/☑/☒). Used to
+ *  distinguish "genuinely all complete" from "format we cannot parse". */
+export declare function hasRecognizedTaskMarkers(text: string): boolean;
+export declare function findIncompleteTaskHint(text: string): string | null;

package/dist/commands/next.js

@@ -0,0 +1,344 @@
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+import { computeReadiness, isCompleteStatus, isTerminal, orderByReadiness, unclearedBlockers, } from '../lib/blockers.js';
+import { activeClaims, addClaim, DEFAULT_TTL_MINUTES, readClaims, withClaimLock } from '../lib/claims.js';
+import { findExistingTableReferences } from '../lib/coherence.js';
+import { ErrorCode, emit, getGlobalOptions } from '../lib/output.js';
+import { computeStage, PIPELINE } from '../lib/pipeline-map.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { readSessionState } from '../lib/session-state.js';
+import { isClaimedCompleteUnverified } from '../lib/spec-debt.js';
+import { diagnoseMissingSpec, findSpec, listSpecs, resolveArtifactPath } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+/** Pipeline stages where a spec is still being shaped (pre-implementation), so an
+ *  "already-implemented table" advisory is actionable rather than noise. */
+const EARLY_STAGES = new Set([undefined, 'stub', 'clarified', 'validated']);
+/** Build an advisory when an early-stage spec references tables that already exist
+ *  in a migration — the signal that it may duplicate an existing feature. */
+function landscapeAdvisory(repoRoot, spec) {
+    if (!EARLY_STAGES.has(spec.signals.pipelineStatus))
+        return '';
+    const existing = findExistingTableReferences(repoRoot, spec.id, spec.core);
+    if (existing.length === 0)
+        return '';
+    const shown = existing.slice(0, 5).map((e) => `  - ${e.table} (already in ${e.migration})`);
+    const more = existing.length > 5 ? `\n  …and ${existing.length - 5} more` : '';
+    return `\n\n⚠ landscape: ${existing.length} referenced table(s) already exist in migrations — confirm you're EXTENDING the owning spec, not duplicating it:\n${shown.join('\n')}${more}`;
+}
+/** Disagreement between later artifacts and the first incomplete required gate
+ *  (e.g. tasks exist but validate-spec was never run). Optional and not-applicable
+ *  transitions never count, so only real out-of-order gaps are flagged. */
+export function computeOutOfOrder(spec) {
+    const applicable = PIPELINE.filter((t) => !t.optional && !(t.regulatedOnly && !spec.signals.isRegulated));
+    const firstNotDone = applicable.findIndex((t) => !t.isDone(spec));
+    const laterDone = firstNotDone >= 0 ? applicable.slice(firstNotDone + 1).find((t) => t.isDone(spec)) : undefined;
+    return firstNotDone >= 0 && laterDone
+        ? `out-of-order: ${laterDone.id} artifact exists but ${applicable[firstNotDone].id} is incomplete`
+        : undefined;
+}
+/** Human-output blocker lines for `next --spec`: open blockers and unresolvable
+ *  (likely typo'd) blocked_by references. Cleared (complete) blockers are omitted. */
+export function formatSpecBlockers(blockers) {
+    const lines = [];
+    for (const b of blockers) {
+        if (b.state === 'open')
+            lines.push(`  blocked by: ${b.id} (open)`);
+        if (b.state === 'unknown')
+            lines.push(`  warning: blocked_by references unknown spec ID ${b.id} (typo?)`);
+    }
+    return lines;
+}
+/** Assemble the `next --spec` human text: action, out-of-order warning, blocker
+ *  lines, landscape advisory. The warning and blockers used to be JSON-only. */
+export function buildSpecNextText(spec, action, outOfOrder, blockers, advisory) {
+    const extras = [...(outOfOrder ? [`  ⚠ ${outOfOrder}`] : []), ...formatSpecBlockers(blockers)];
+    return `${formatAction(spec.id, action)}${extras.length > 0 ? `\n${extras.join('\n')}` : ''}${advisory}`;
+}
+/** Pick the core-level next spec from a readiness-ordered list, honoring claims.
+ *  Default: skip specs with an active claim. `--include-claimed`: keep them.
+ *  `--claim`: atomically reserve the chosen spec inside the same lock so two
+ *  concurrent core-picks in separate worktrees return distinct specs.
+ *  Returns null when no eligible candidate remains. */
+export function pickCorePick(repoRoot, ordered, opts) {
+    return withClaimLock(repoRoot, () => {
+        const claimed = new Set(activeClaims(readClaims(repoRoot), Date.now()).map((c) => c.id.toUpperCase()));
+        const eligible = opts.includeClaimed ? ordered : ordered.filter((r) => !claimed.has(r.spec.id.toUpperCase()));
+        const choice = eligible[0] ?? null;
+        if (choice && opts.claim) {
+            addClaim(repoRoot, choice.spec.id, {
+                by: opts.by ?? process.env.EOS_SPEC_CLAIMED_BY ?? basename(repoRoot),
+                ttlMinutes: opts.ttlMinutes ?? DEFAULT_TTL_MINUTES,
+            });
+        }
+        return choice;
+    });
+}
+export function registerNext(program) {
+    program
+        .command('next')
+        .description('Show the next recommended action for a spec or core (replaces ad-hoc whats-next chat command).')
+        .option('--core <core>', 'Limit to one core')
+        .option('--spec <id>', 'Single spec id (preferred)')
+        .option('--claim', 'Atomically reserve the returned core-pick (parallel-agent lease)', false)
+        .option('--include-claimed', 'Include specs already claimed by another worktree', false)
+        .action(withEventLog('next', async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        const session = readSessionState(repoRoot);
+        if (options.spec) {
+            const spec = findSpec(repoRoot, options.spec);
+            if (!spec) {
+                const core = options.spec.split('-')[0]?.toLowerCase() ?? 'pf';
+                const diag = diagnoseMissingSpec(repoRoot, options.spec);
+                const text = diag.foundPath
+                    ? `next: spec ${options.spec} is not navigable\nreason: ${diag.reason}\nfile: ${diag.foundPath}\nhint: move/rename it under specs/${core}/specs/ or specs/${core}/ux/ with a {CORE}-UX-{N} name, or add YAML frontmatter, then re-run`
+                    : `next: spec ${options.spec} not found\nhint: run \`eos-spec precedent --core ${core} --topic "<feature>"\` to check archived prior art, then create-spec`;
+                emit(global, {
+                    ok: false,
+                    error: { code: ErrorCode.SPEC_NOT_FOUND, message: text },
+                    data: null,
+                    text,
+                });
+            }
+            const action = recommendAction(spec, session, repoRoot);
+            const outOfOrder = computeOutOfOrder(spec);
+            // Blockers resolve against the WHOLE corpus — a blocker may live in any core.
+            const [readiness] = computeReadiness([spec], listSpecs(repoRoot));
+            const claimedCompleteUnverified = isClaimedCompleteUnverified(repoRoot, spec.id);
+            const debtLine = claimedCompleteUnverified
+                ? `\n  ⚠ verification-debt: claims complete but 0 @verifies-backed ACs — run \`npm run spec:check-debt\` / \`npm run spec:verify-acs -- --enforce --spec ${spec.id}\``
+                : '';
+            emit(global, {
+                ok: true,
+                data: {
+                    specId: spec.id,
+                    computedStage: computeStage(spec),
+                    outOfOrder: outOfOrder ?? null,
+                    blockers: readiness.blockers,
+                    claimedCompleteButUnverified: claimedCompleteUnverified,
+                    action,
+                },
+                text: `${buildSpecNextText(spec, action, outOfOrder, readiness.blockers, landscapeAdvisory(repoRoot, spec))}${debtLine}`,
+            });
+        }
+        const candidates = listSpecs(repoRoot, options.core).filter((s) => s.status && !isCompleteStatus(s.status) && !isTerminal(s));
+        if (candidates.length === 0) {
+            emit(global, {
+                ok: true,
+                data: { action: { type: 'noop', reason: 'all specs complete or no in-progress specs found' } },
+                text: `next: no in-progress specs found\nhint: run \`eos-spec precedent --core ${options.core ?? 'pf'} --topic "<feature>"\` to check archived prior art`,
+            });
+        }
+        // Blocker-aware pick: prefer specs whose `blocked_by` targets are all Complete.
+        // Resolve against the WHOLE corpus — a blocker clears only when Complete, and
+        // completed specs are excluded from `candidates`, so the corpus must be unfiltered
+        // (and blockers may live in any core regardless of the --core filter).
+        const corpus = listSpecs(repoRoot);
+        const ordered = orderByReadiness(candidates, corpus);
+        const choice = pickCorePick(repoRoot, ordered, {
+            claim: Boolean(options.claim),
+            includeClaimed: Boolean(options.includeClaimed),
+        });
+        if (!choice) {
+            emit(global, {
+                ok: true,
+                data: { action: { type: 'noop', reason: 'all in-progress specs are claimed by other worktrees' } },
+                text: `next: all ${candidates.length} in-progress spec(s) are claimed by other worktrees\nhint: pass --include-claimed to override, or wait for a claim to expire`,
+            });
+        }
+        const first = choice.spec;
+        const action = recommendAction(first, session, repoRoot);
+        const readyCount = ordered.filter((r) => r.ready).length;
+        if (!choice.ready) {
+            const open = unclearedBlockers(choice)
+                .map((b) => `${b.id} (${b.state})`)
+                .join(', ');
+            action.note = `blocked-by: ${open} — surfaced because no unblocked in-progress spec remains`;
+        }
+        emit(global, {
+            ok: true,
+            data: {
+                specId: first.id,
+                action,
+                totalInProgress: candidates.length,
+                readyCount,
+                ready: choice.ready,
+                blockers: choice.blockers,
+                claimed: Boolean(options.claim),
+            },
+            text: `${formatAction(first.id, action)}\n\n(${readyCount}/${candidates.length} in-progress spec(s) unblocked — pass --spec for a different one)`,
+        });
+    }));
+}
+/** Walk the SSOT pipeline; return the first applicable, not-done transition, else the implement/complete tail.
+ *  An active session (STATE.md) on this spec short-circuits to resuming the in-progress task. */
+export function recommendAction(spec, session, repoRoot) {
+    if (session && session.specId.toUpperCase() === spec.id.toUpperCase()) {
+        return {
+            type: 'implement',
+            specId: spec.id,
+            reason: `Session in progress on ${session.currentTask}.`,
+            actor: 'module-lifecycle skill',
+            actorType: 'skill',
+            invocation: `the module-lifecycle skill on ${spec.id} (resume at ${session.currentTask})`,
+        };
+    }
+    // Derived from artifacts only — mirror the same predicates the PIPELINE uses for isDone.
+    const reviewStagesDone = spec.signals.isRegulated ? spec.signals.hasComplianceSignoff : spec.signals.hasSpecReview;
+    if (reviewStagesDone && !spec.signals.hasUserStories && !spec.signals.hasAcceptanceCriteria) {
+        return {
+            type: 'backfill-frontmatter',
+            specId: spec.id,
+            reason: 'Spec passed review but has neither user stories nor acceptance_criteria — draft-acs and generate-tests both silently skip, so it would reach plan with no ACs.',
+            actor: 'backfill (ac-draft + backfill-status)',
+            actorType: 'command',
+            invocation: `the encore-spec-ac-draft skill on ${spec.id} (then npm run spec:backfill-status -- --spec ${spec.id})`,
+        };
+    }
+    for (const t of PIPELINE) {
+        if (t.optional)
+            continue; // advisories never block; surfaced separately
+        if (t.regulatedOnly && !spec.signals.isRegulated)
+            continue;
+        // Artifacts are the single source of truth. `pipeline_status` is derived/cached
+        // (see eos-spec reconcile) and is intentionally NOT consulted here.
+        if (t.isDone(spec))
+            continue;
+        return {
+            type: t.id,
+            specId: spec.id,
+            reason: t.reason,
+            actor: t.actor,
+            actorType: t.actorType,
+            invocation: t.invocation(spec.id),
+        };
+    }
+    return implementOrComplete(spec, repoRoot);
+}
+/** Task-level tail the pipeline-map does not model: drill into TASKS.md or mark
+ *  complete. Implementation work routes to the module-lifecycle skill (Phase 8 —
+ *  the live entry point; the old dedicated command was deleted from automation/),
+ *  while the bookkeeping branches stay eos-spec CLI invocations. */
+function implementOrComplete(spec, repoRoot) {
+    const cli = { specId: spec.id, actor: 'eos-spec CLI', actorType: 'command' };
+    if (!spec.hasTasks) {
+        return { ...cli, type: 'generate-tasks', reason: 'No TASKS.md yet.', invocation: `eos-spec tasks ${spec.id}` };
+    }
+    let text = null;
+    // Resolve the TASKS file folder-agnostically (C2). The old
+    // spec.path.replace(/\/specs\/[^/]+\.md$/, …) keyed on a literal `/specs/` segment and
+    // silently failed for UX specs under `specs/{core}/ux/`, making the tail read the spec
+    // BODY as if it were TASKS — the 46/84 UI-bearing-spec misroute this fixes.
+    const tasksPath = repoRoot ? resolveArtifactPath(repoRoot, spec.core, 'tasks', spec.id, 'TASKS') : null;
+    if (tasksPath) {
+        try {
+            text = readFileSync(tasksPath, 'utf8');
+        }
+        catch {
+            text = null;
+        }
+    }
+    if (text !== null) {
+        const hint = findIncompleteTaskHint(text);
+        if (hint) {
+            return {
+                specId: spec.id,
+                actor: 'module-lifecycle skill',
+                actorType: 'skill',
+                type: 'implement',
+                reason: 'Incomplete task found in TASKS.md',
+                invocation: `the module-lifecycle skill on ${spec.id}`,
+                taskHint: hint.slice(0, 120),
+            };
+        }
+        // Guard against the false "all complete" verdict: a TASKS.md with zero
+        // recognized status markers ([ ]/[x]/☐/☑) is unparseable, NOT done. Never
+        // recommend `complete --update-registry` (which marks the spec done in the
+        // registry) on a spec whose completion we cannot prove from artifacts.
+        if (!hasRecognizedTaskMarkers(text)) {
+            return {
+                ...cli,
+                type: 'verify-tasks',
+                reason: 'TASKS.md has no recognized task-status markers ([ ]/[x]/☐/☑) — completion cannot be derived from artifacts. Verify the task format before completing.',
+                invocation: `eos-spec status --spec ${spec.id}  # then re-run \`eos-spec tasks ${spec.id} --force\` if the format is stale`,
+            };
+        }
+    }
+    // Verification tail (UI-bearing specs): tasks done is necessary, not
+    // sufficient — code-sourced docshots and a green browser auto-heal verdict
+    // are completion artifacts too (constitution §3.1: done = reachable
+    // capability, proven in the real browser and documented with real pixels).
+    if (spec.signals.isUiBearing && !spec.signals.hasDocshots) {
+        return {
+            specId: spec.id,
+            actor: 'encore-doc-screenshots skill',
+            actorType: 'skill',
+            type: 'capture-docshots',
+            reason: 'All tasks complete, but this UI-bearing spec has no docshot evidence — capture code-sourced screenshots before completing.',
+            invocation: `the encore-doc-screenshots skill on ${spec.id} (a tests/e2e/<core>/*-docs-shots.spec.ts writing docs/images/<area>/${spec.id.toLowerCase()}-*.png; verify with npm run docs:shots:check). No UI surface worth documenting? \`eos-spec signoff --type docshots --spec ${spec.id}\``,
+        };
+    }
+    // Submit→DB completion gate for create-wizards (Phase 3 / #1185): a render-only
+    // docshot/auto-heal can green-light a wizard whose submit path is broken (the
+    // GR-UX-10/05 gap). A kind:'create' wizard spec must have a passing submit→DB
+    // E2E before heal-verified/mark-complete. Config + non-wizard specs are exempt.
+    if (spec.signals.isCreateWizardSpec && !spec.signals.hasSubmitE2e) {
+        return {
+            specId: spec.id,
+            actor: 'submit→DB E2E (Playwright local lane)',
+            actorType: 'skill',
+            type: 'submit-e2e',
+            reason: 'This create-wizard has no submit→DB E2E — a render-only docshot/auto-heal can pass while the submit path is broken. Prove the wizard persists a row before completing.',
+            invocation: `add tests/e2e/${spec.core.toLowerCase()}/${spec.id.toLowerCase()}-local.spec.ts driving the wizard → submit → asserting the persisted row (exemplar: tests/e2e/gr/gr-ux-13-training-course-local.spec.ts); run \`npm run test:e2e:local\`. No submit path? \`eos-spec signoff --type submit-e2e-waived --spec ${spec.id}\``,
+        };
+    }
+    if (spec.signals.isUiBearing && !spec.signals.hasHealSignoff) {
+        return {
+            specId: spec.id,
+            actor: 'browser-autoheal skill',
+            actorType: 'skill',
+            type: 'browser-autoheal',
+            reason: 'All tasks complete, but no browser auto-heal verdict is recorded — drive the feature end-to-end with console/pageerror/network capture and fix to green.',
+            invocation: `the browser-autoheal skill on ${spec.id} (loop to HEAL_VERDICT=green), then \`eos-spec signoff --type heal-verified --spec ${spec.id}\``,
+        };
+    }
+    return {
+        ...cli,
+        type: 'mark-complete',
+        reason: 'All tasks appear complete.',
+        invocation: `eos-spec complete --spec ${spec.id} --update-registry` +
+            `\n  ▸ before completing, prove the ACs: \`npm run spec:check-debt\` then ` +
+            `\`npm run spec:verify-acs -- --enforce --spec ${spec.id}\` (an AC is verified only on a real @verifies-backed test pass).`,
+    };
+}
+/** True when TASKS.md carries at least one status marker we know how to read —
+ *  a GitHub checkbox (`[ ]`/`[x]`) or a ballot-box glyph (☐/☑/☒). Used to
+ *  distinguish "genuinely all complete" from "format we cannot parse". */
+export function hasRecognizedTaskMarkers(text) {
+    return /\[\s*[ xX]\s*\]/.test(text) || /[☐☑☒]/.test(text);
+}
+export function findIncompleteTaskHint(text) {
+    const headedTask = /^###\s+(T\d+[^\n]*)[\s\S]{0,240}?\*\*Status:\*\*\s*`?\[\s\]`?/m.exec(text);
+    if (headedTask?.[1])
+        return headedTask[1].trim();
+    const inlineTask = /^\s*-\s*\[\s\]\s+((?:T\d+|Task)[^\n]+)/m.exec(text);
+    if (inlineTask?.[1])
+        return inlineTask[1].trim();
+    // Table/glyph format (TASKS_TEMPLATE waves use markdown tables with a status
+    // cell): an open ballot-box glyph ☐ (U+2610) marks an incomplete row. Capture
+    // the first T-id on that line, else the line text, as the hint.
+    const glyphLine = /^.*☐.*$/m.exec(text);
+    if (glyphLine) {
+        const line = glyphLine[0];
+        const tid = /\bT\d+\b/.exec(line)?.[0];
+        return (tid ? `${tid} (incomplete)` : line.replace(/\|/g, ' ').replace(/\s+/g, ' ').trim()).slice(0, 120);
+    }
+    return null;
+}
+function formatAction(specId, action) {
+    const gate = action.actorType === 'human-gate' || action.actorType === 'agent' ? ' [human-gate]' : '';
+    const hint = action.taskHint ? `\n  hint: ${action.taskHint}` : '';
+    const note = action.note ? `\n  note: ${action.note}` : '';
+    return `next [${specId}] → ${action.type}${gate}: ${action.reason}\n  ▶ run: ${action.invocation}${hint}${note}`;
+}
+//# sourceMappingURL=next.js.map

package/dist/commands/next.js.map

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

package/dist/commands/precedent.d.ts

@@ -0,0 +1,66 @@
+import type { Command } from 'commander';
+type PrecedentSpecMatch = {
+    id: string;
+    core: string;
+    title: string;
+    status: string;
+    path: string;
+    archived: boolean;
+    archivedAt?: string;
+    /** Present on ranked --topic matches (precedent v2). */
+    score?: number;
+    matchedFields?: string[];
+    /** Present on --spec overlap matches: distinctive tables shared with the target (df ascending). */
+    sharedTables?: string[];
+};
+type PrecedentLineMatch = {
+    id?: string;
+    line: string;
+};
+export type MigrationCollision = {
+    table: string;
+    migration: string;
+};
+export type PrecedentReport = {
+    query: {
+        spec?: string;
+        topic?: string;
+        core?: string;
+        checkMigrations?: boolean;
+        all?: boolean;
+    };
+    warnings: string[];
+    active: PrecedentSpecMatch[];
+    archived: PrecedentSpecMatch[];
+    registry: PrecedentLineMatch[];
+    deferred: PrecedentLineMatch[];
+    bodyIdentifiers?: string[];
+    migrationCollisions?: MigrationCollision[];
+};
+/** 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 declare function thresholdForCorpus(corpusSize: number): number;
+/** Backtick-quoted {core}_* identifiers referenced in a spec body. */
+export declare function extractCoreIdentifiers(body: string, core: string): string[];
+/** Backtick-quoted `{core}_*` identifiers for ANY known core prefix — a spec that
+ *  touches another core's tables is exactly the precedent worth surfacing. */
+export declare function extractKnownCoreIdentifiers(body: string, cores: string[]): string[];
+/** 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 declare function unknownCoreError(core: string, repoRoot: string): string | null;
+export declare function registerPrecedent(program: Command): void;
+export declare function buildPrecedentReport(repoRoot: string, query: {
+    spec?: string;
+    topic?: string;
+    core?: string;
+    checkMigrations?: boolean;
+    all?: boolean;
+}): PrecedentReport;
+export declare function formatPrecedentText(report: PrecedentReport): string;
+export {};