@encore-os/eos-spec 0.3.1

package/dist/index.js

@@ -0,0 +1,138 @@
+import { existsSync } from 'node:fs';
+import { Command } from 'commander';
+import { registerAcBackfill } from './commands/ac-backfill.js';
+import { registerArchive } from './commands/archive.js';
+import { registerAudit } from './commands/audit.js';
+import { registerBackfill } from './commands/backfill.js';
+import { registerCheckArtifacts } from './commands/checkArtifacts.js';
+import { registerCheckPlacement } from './commands/checkPlacement.js';
+import { registerClaim } from './commands/claim.js';
+import { registerComplete } from './commands/complete.js';
+import { registerConformance } from './commands/conformance.js';
+import { registerCreate } from './commands/create.js';
+import { registerDeferred } from './commands/deferred.js';
+import { registerDelta } from './commands/delta.js';
+import { registerFreshness } from './commands/freshness.js';
+import { registerFunnel } from './commands/funnel.js';
+import { registerGenTests } from './commands/gen-tests.js';
+import { registerInit } from './commands/init.js';
+import { registerList } from './commands/list.js';
+import { registerMetrics } from './commands/metrics.js';
+import { registerNext } from './commands/next.js';
+import { registerPrecedent } from './commands/precedent.js';
+import { registerReady } from './commands/ready.js';
+import { registerReconcile } from './commands/reconcile.js';
+import { registerReadinessRollup } from './commands/rollup.js';
+import { registerScorecard } from './commands/scorecard.js';
+import { registerSignoff } from './commands/signoff.js';
+import { registerStatus } from './commands/status.js';
+import { registerTasks } from './commands/tasks.js';
+import { registerValidate } from './commands/validate.js';
+import { registerVerifyAcs } from './commands/verify-acs.js';
+import { registerVerifyRollout } from './commands/verifyRollout.js';
+export { listSpecs, findSpec, findSpecsById, deriveSignals, diagnoseMissingSpec } from './lib/specs.js';
+export { loadConfig, resetConfigCache, coresFromConfig } from './lib/config.js';
+export { embeddingsSourceFromConfig, FilesystemEmbeddingsSource } from './lib/embeddings-source.js';
+// ── Consumer surface (epic #300, Wave 3a — encoreos repoint) ─────────────────
+// The other heavy consumer (encoreos: navigator evals, verification-debt and
+// scorecard scripts, the navigator-SSOT and compliance/UI-evidence gates) reaches
+// into the fs-bound corpus + navigator + scoring helpers. They live here on the
+// main entry (not `/pure`) because they read the repo. The deterministic leaves
+// among them (`computeStage`, `PIPELINE`, `isCompleteStatus`, `collectSpecIds`,
+// `uiEvidenceGate`, `parseComplianceSignoff`, `SessionState`) are ALSO exported
+// from `/pure`; they are re-exported here so a single import site suffices for a
+// server/Node consumer that does not care about the client boundary.
+export { recommendAction } from './commands/next.js';
+export { getRepoRoot, coresList } from './lib/repo.js';
+export { buildScorecardForCore } from './lib/scorecard-run.js';
+export { scanVerifies } from './lib/verifies-scan.js';
+export { computeStage, PIPELINE } from './lib/pipeline-map.js';
+export { isCompleteStatus, collectSpecIds } from './lib/blockers.js';
+export { uiEvidenceGate } from './lib/completion-gate.js';
+export { parseComplianceSignoff } from './lib/compliance-signoff.js';
+/** The fully-registered CLI program. Exported (not parsed on import — the parse
+ *  call below is guarded by the main-module check) so the command-surface gate
+ *  and conformance pack can enumerate the registered command set. */
+export const program = new Command();
+program
+    .name('eos-spec')
+    .description('Encore OS spec workflow CLI — agent-friendly wrapper around the existing spec, audit, and validation scripts. All commands accept `--json` for machine-readable output.')
+    .version('0.3.1')
+    .option('--repo-root <path>', 'Override repo root (defaults to git rev-parse --show-toplevel)')
+    .option('--config <path>', 'Override specs/config.yaml path (consumed by init, create, delta, verify-rollout; validated for all commands)')
+    .option('--json', 'Output JSON instead of human-readable text', false)
+    .option('--quiet', 'Suppress non-essential output', false);
+program.hook('preAction', () => {
+    const { config } = program.opts();
+    if (config && !existsSync(config)) {
+        console.error(`eos-spec: config file not found: ${config}`);
+        process.exit(1);
+    }
+});
+registerAcBackfill(program);
+registerInit(program);
+registerValidate(program);
+registerNext(program);
+registerReady(program);
+registerClaim(program);
+registerPrecedent(program);
+registerStatus(program);
+registerList(program);
+registerCreate(program);
+registerTasks(program);
+registerComplete(program);
+registerArchive(program);
+registerDeferred(program);
+registerDelta(program);
+registerFreshness(program);
+registerFunnel(program);
+registerScorecard(program);
+registerBackfill(program);
+registerReadinessRollup(program);
+registerMetrics(program);
+registerVerifyRollout(program);
+registerCheckPlacement(program);
+registerCheckArtifacts(program);
+registerReconcile(program);
+registerSignoff(program);
+registerVerifyAcs(program);
+registerGenTests(program);
+registerAudit(program);
+registerConformance(program);
+program.addHelpText('after', `
+Examples:
+  $ eos-spec validate                       # Validate every spec across the repo
+  $ eos-spec validate --core cl --json      # Validate CL specs, JSON output
+  $ eos-spec next --core hr                 # Show next recommended action for HR (blocker-aware)
+  $ eos-spec ready --core lo                # List LO specs whose blockers are all Complete
+  $ eos-spec ready --propose --core lo      # Propose blocked_by entries from legacy dependencies
+  $ eos-spec precedent --topic "billing reconciliation" --core fa
+  $ eos-spec status --spec PF-37            # Detail spec status (phases, tests, deferred)
+  $ eos-spec list --core pm --status InProgress
+  $ eos-spec create PF-99 "Foo Feature"     # Scaffold spec/plan/tasks files (stubs)
+  $ eos-spec tasks PF-99                    # Generate or refresh TASKS file
+  $ eos-spec complete --spec PF-37 --update-registry
+  $ eos-spec archive --spec PF-37           # Archive a completed spec
+  $ eos-spec deferred --sync                # Sync deferred dashboard
+  $ eos-spec scorecard --core fm            # Per-spec readiness; headline: claimed-complete-but-unverified
+  $ eos-spec backfill --core hr             # Classify verification debt; write specs/hr/VERIFICATION_DEBT.md (dry-run)
+  $ eos-spec backfill --core hr --apply     # Also downgrade overstated status lines (T1 relinks excluded)
+  $ eos-spec readiness-rollup --save        # Ranked platform readiness rollup across all cores
+  $ eos-spec delta validate --spec CL-15-EN-01   # Validate change delta section (compound enhancement ID)
+  $ eos-spec verify-rollout                 # Run rollout verification checks
+
+Documentation:
+  specs/_templates/SPEC_GUIDE.md            # Spec authoring decision tree
+  specs/_templates/TEMPLATE_INDEX.md        # Template selection
+  AI_GUIDE.md                               # Spec workflow process
+`);
+export async function run(argv) {
+    await program.parseAsync(argv);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    run(process.argv).catch((err) => {
+        process.stderr.write(`${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/ac-draft-prompt.d.ts

@@ -0,0 +1,18 @@
+export type UserStory = {
+    id: string;
+    text: string;
+};
+export type AcDraftInput = {
+    specId: string;
+    core: string;
+    title: string;
+    userStories: UserStory[];
+    /** Optional excerpt from specs/{core}/research/{ID}-RESEARCH.md (trimmed). */
+    research?: string;
+    /** Highest existing AC ordinal in the spec; new ACs start at existingAcCount + 1. */
+    existingAcCount: number;
+};
+/** Build a single prompt that asks the model to draft Gherkin ACs for unaddressed user stories.
+ *  The model must return STRICT JSON: { acceptance_criteria: [...] }.
+ *  Drafting guidance mirrors automation/skills/encore-spec-ac-draft/SKILL.md. */
+export declare function buildAcDraftPrompt(input: AcDraftInput): string;

package/dist/lib/ac-draft-prompt.js

@@ -0,0 +1,38 @@
+/** Build a single prompt that asks the model to draft Gherkin ACs for unaddressed user stories.
+ *  The model must return STRICT JSON: { acceptance_criteria: [...] }.
+ *  Drafting guidance mirrors automation/skills/encore-spec-ac-draft/SKILL.md. */
+export function buildAcDraftPrompt(input) {
+    const start = input.existingAcCount + 1;
+    const stories = input.userStories.map((s) => `- ${s.id}: ${s.text}`).join('\n');
+    const research = input.research ? `\n\n## Research excerpt\n${input.research.slice(0, 2000)}` : '';
+    return [
+        `You are drafting Gherkin acceptance criteria for spec ${input.specId} (${input.core}) — "${input.title}".`,
+        '',
+        'Return STRICT JSON only — no prose, no markdown fences:',
+        '{',
+        '  "acceptance_criteria": [',
+        '    { "id": "AC-N", "title": "...", "user_story": "US-N", "status": "planned", "draft": true,',
+        '      "given": ["...", "..."], "when": ["..."], "then": ["...", "..."] }',
+        '  ]',
+        '}',
+        '',
+        `Start AC numbering at AC-${start}.`,
+        '',
+        'Draft 1–3 scenarios per user story.',
+        '- Given clauses describe state setup (who is logged in, what data exists).',
+        '- When clauses describe the user action (clicked button, submitted form).',
+        '- Then clauses describe observable results (text appeared, count changed).',
+        '- Stay concrete: "user clicks the Save button" beats "user saves".',
+        '',
+        'Locator priority (semantic for Playwright compatibility):',
+        '1. Role-based ("user clicks the Submit button")',
+        '2. Label-based ("user enters 123 in the Account Number field")',
+        '3. TestId-based ("user opens the claims list")',
+        'Avoid visual descriptions ("the red error box") and translation-volatile strings.',
+        '',
+        '## User stories',
+        stories,
+        research,
+    ].join('\n');
+}
+//# sourceMappingURL=ac-draft-prompt.js.map

package/dist/lib/ac-draft-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ac-draft-prompt.js","sourceRoot":"","sources":["../../src/lib/ac-draft-prompt.ts"],"names":[],"mappings":"AAaA;;iFAEiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,4BAA4B,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,OAAO;QACL,yDAAyD,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,KAAK,IAAI;QAC3G,EAAE;QACF,yDAAyD;QACzD,GAAG;QACH,4BAA4B;QAC5B,+FAA+F;QAC/F,0EAA0E;QAC1E,KAAK;QACL,GAAG;QACH,EAAE;QACF,4BAA4B,KAAK,GAAG;QACpC,EAAE;QACF,qCAAqC;QACrC,4EAA4E;QAC5E,2EAA2E;QAC3E,4EAA4E;QAC5E,oEAAoE;QACpE,EAAE;QACF,2DAA2D;QAC3D,iDAAiD;QACjD,gEAAgE;QAChE,gDAAgD;QAChD,mFAAmF;QACnF,EAAE;QACF,iBAAiB;QACjB,OAAO;QACP,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/ac-response-parser.d.ts

@@ -0,0 +1,18 @@
+export type AcEntry = {
+    id: string;
+    title: string;
+    user_story?: string;
+    status: 'planned';
+    draft: true;
+    given: string[];
+    when: string[];
+    then: string[];
+};
+export type ParseResult = {
+    ok: true;
+    acs: AcEntry[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function parseAcResponse(raw: string): ParseResult;

package/dist/lib/ac-response-parser.js

@@ -0,0 +1,57 @@
+const REQUIRED = ['id', 'title', 'given', 'when', 'then'];
+function isStringArray(v) {
+    return Array.isArray(v) && v.every((x) => typeof x === 'string') && v.length > 0;
+}
+export function parseAcResponse(raw) {
+    // Strip code fences if any.
+    let text = raw
+        .replace(/```(?:json)?\s*/gi, '')
+        .replace(/```/g, '')
+        .trim();
+    // Carve out the JSON object — first '{' to matching last '}'.
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start < 0 || end <= start)
+        return { ok: false, error: 'no JSON object found' };
+    text = text.slice(start, end + 1);
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (e) {
+        return { ok: false, error: `JSON parse failed: ${e.message}` };
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return { ok: false, error: 'parsed value is not an object' };
+    const list = parsed.acceptance_criteria;
+    if (!Array.isArray(list))
+        return { ok: false, error: 'acceptance_criteria missing or not an array' };
+    const acs = [];
+    for (const entry of list) {
+        if (!entry || typeof entry !== 'object')
+            return { ok: false, error: 'AC entry is not an object' };
+        const rec = entry;
+        for (const k of REQUIRED) {
+            if (rec[k] === undefined)
+                return { ok: false, error: `AC entry missing required field "${k}"` };
+        }
+        if (typeof rec.id !== 'string' || typeof rec.title !== 'string') {
+            return { ok: false, error: 'AC entry id/title must be strings' };
+        }
+        if (!isStringArray(rec.given) || !isStringArray(rec.when) || !isStringArray(rec.then)) {
+            return { ok: false, error: 'AC entry given/when/then must be non-empty string arrays' };
+        }
+        acs.push({
+            id: rec.id,
+            title: rec.title,
+            user_story: typeof rec.user_story === 'string' ? rec.user_story : undefined,
+            status: 'planned',
+            draft: true,
+            given: rec.given,
+            when: rec.when,
+            then: rec.then,
+        });
+    }
+    return { ok: true, acs };
+}
+//# sourceMappingURL=ac-response-parser.js.map

package/dist/lib/ac-response-parser.js.map

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

package/dist/lib/ai-call.d.ts

@@ -0,0 +1,13 @@
+import { type AiTokens } from './cost.js';
+export type LogAiCallInput = {
+    command: string;
+    model: string;
+    ms: number;
+    ok: boolean;
+    tokens?: AiTokens;
+    error?: string;
+    ts?: string;
+};
+/** Log a single AI gateway call as an eos-spec event, computing USD cost from token counts.
+ *  Shared by every AI-calling command so token/cost capture is uniform (DRY). */
+export declare function logAiCall(input: LogAiCallInput): void;

package/dist/lib/ai-call.js

@@ -0,0 +1,17 @@
+import { computeCostUsd } from './cost.js';
+import { logEvent } from './events.js';
+/** Log a single AI gateway call as an eos-spec event, computing USD cost from token counts.
+ *  Shared by every AI-calling command so token/cost capture is uniform (DRY). */
+export function logAiCall(input) {
+    logEvent({
+        ts: input.ts ?? new Date().toISOString(),
+        command: input.command,
+        model: input.model,
+        ms: input.ms,
+        ok: input.ok,
+        tokens: input.tokens,
+        costUsd: input.tokens ? computeCostUsd(input.model, input.tokens) : undefined,
+        error: input.error,
+    });
+}
+//# sourceMappingURL=ai-call.js.map

package/dist/lib/ai-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-call.js","sourceRoot":"","sources":["../../src/lib/ai-call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAYvC;iFACiF;AACjF,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,QAAQ,CAAC;QACP,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7E,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/archive.d.ts

@@ -0,0 +1,21 @@
+import { type SpecFile } from './specs.js';
+export declare function isArchiveEligible(status: string | undefined): boolean;
+export type ArchiveResult = {
+    specId: string;
+    moved: string[];
+    skipped: string[];
+    /** Set when the status guard refused to archive (run again with --force to override). */
+    refused?: boolean;
+    reason?: string;
+};
+export declare function archiveSpec(repoRoot: string, specIdOrFile: string | SpecFile, log: ((msg: string) => void) | null, configPath?: string, opts?: {
+    force?: boolean;
+}): ArchiveResult;
+export declare function getSpecLastModified(repoRoot: string, specPath: string): Date | null;
+export declare function archiveSpecsByFilter(repoRoot: string, opts: {
+    core?: string;
+    status?: string;
+    olderThanDays?: number;
+    dryRun?: boolean;
+    force?: boolean;
+}, log: ((msg: string) => void) | null, configPath?: string): ArchiveResult[];

package/dist/lib/archive.js

@@ -0,0 +1,136 @@
+import { existsSync, mkdirSync, readdirSync, renameSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig } from './config.js';
+import { runScript } from './exec.js';
+import { findSpec, listSpecs } from './specs.js';
+const DONE_STATUSES = ['complete', 'implemented'];
+/** Statuses that make a spec eligible for physical archiving without --force.
+ *  Matched as case-insensitive substrings because legacy body statuses carry
+ *  decoration ("✅ Implemented", "Superseded by PF-12"). `deferred` is
+ *  intentionally excluded: deferred specs live on the deferred dashboard and
+ *  may be revived. */
+const ARCHIVE_ELIGIBLE_STATUSES = ['complete', 'implemented', 'archived', 'superseded'];
+export function isArchiveEligible(status) {
+    const lower = (status ?? '').toLowerCase();
+    return ARCHIVE_ELIGIBLE_STATUSES.some((kw) => lower.includes(kw));
+}
+export function archiveSpec(repoRoot, specIdOrFile, log, configPath, opts = {}) {
+    const spec = typeof specIdOrFile === 'string' ? findSpec(repoRoot, specIdOrFile) : specIdOrFile;
+    const specId = typeof specIdOrFile === 'string' ? specIdOrFile : specIdOrFile.id;
+    if (!spec) {
+        log?.(`archive: ${specId} not found, skipping`);
+        return { specId, moved: [], skipped: [] };
+    }
+    if (!opts.force && !isArchiveEligible(spec.status)) {
+        const reason = `status "${spec.status ?? '(none)'}" is not archive-eligible (${ARCHIVE_ELIGIBLE_STATUSES.join('/')})`;
+        log?.(`archive: refusing ${spec.id} — ${reason}; pass --force to override`);
+        return { specId: spec.id, moved: [], skipped: [], refused: true, reason };
+    }
+    let archiveSub = 'archive';
+    try {
+        const config = loadConfig(repoRoot, configPath);
+        archiveSub = config.paths.archive;
+    }
+    catch {
+        // use default
+    }
+    const archiveDir = join(repoRoot, 'specs', spec.core, archiveSub);
+    mkdirSync(archiveDir, { recursive: true });
+    const moved = [];
+    const skipped = [];
+    const candidates = collectCandidates(repoRoot, spec);
+    for (const src of candidates) {
+        if (!existsSync(src))
+            continue;
+        const filename = src.split('/').pop();
+        const dest = join(archiveDir, filename);
+        if (existsSync(dest)) {
+            log?.(`archive: skipping ${filename} (already in archive)`);
+            skipped.push(filename);
+            continue;
+        }
+        renameSync(src, dest);
+        moved.push(dest);
+        log?.(`archive: moved ${filename} → specs/${spec.core}/${archiveSub}/`);
+    }
+    return { specId: spec.id, moved, skipped };
+}
+function collectCandidates(repoRoot, spec) {
+    const coreBase = join(repoRoot, 'specs', spec.core);
+    const prefix = `${spec.id}-`;
+    const candidates = new Set();
+    candidates.add(spec.path);
+    const contextFile = join(coreBase, 'specs', `${spec.id}-CONTEXT.md`);
+    if (existsSync(contextFile))
+        candidates.add(contextFile);
+    for (const sub of ['plans', 'tasks']) {
+        const dir = join(coreBase, sub);
+        if (!existsSync(dir))
+            continue;
+        for (const file of readdirSync(dir)) {
+            if (!file.endsWith('.md'))
+                continue;
+            if (file.startsWith(prefix) || file === `${spec.id}.md`) {
+                candidates.add(join(dir, file));
+            }
+        }
+    }
+    return [...candidates];
+}
+function statusMatches(specStatus, requested) {
+    const lower = (specStatus ?? '').toLowerCase();
+    if (requested === 'complete') {
+        if (lower.includes('deferred'))
+            return false;
+        return DONE_STATUSES.some((kw) => lower.includes(kw));
+    }
+    return lower.includes(requested.toLowerCase());
+}
+export function getSpecLastModified(repoRoot, specPath) {
+    const result = runScript(['git', 'log', '-1', '--format=%cI', '--', specPath], repoRoot);
+    const iso = result.stdout.trim();
+    if (!iso)
+        return null;
+    const parsed = new Date(iso);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+export function archiveSpecsByFilter(repoRoot, opts, log, configPath) {
+    const specs = listSpecs(repoRoot, opts.core);
+    const results = [];
+    const seen = new Set();
+    const filtered = specs.filter((s) => {
+        if (opts.status && !statusMatches(s.status, opts.status))
+            return false;
+        if (seen.has(s.id))
+            return false;
+        seen.add(s.id);
+        if (opts.olderThanDays != null) {
+            const lastMod = getSpecLastModified(repoRoot, s.path);
+            if (!lastMod)
+                return false;
+            const cutoff = new Date();
+            cutoff.setDate(cutoff.getDate() - opts.olderThanDays);
+            if (lastMod > cutoff) {
+                log?.(`archive: skipping ${s.id} (last modified ${lastMod.toISOString()}, within ${opts.olderThanDays} days)`);
+                return false;
+            }
+        }
+        return true;
+    });
+    for (const spec of filtered) {
+        if (opts.dryRun) {
+            if (!opts.force && !isArchiveEligible(spec.status)) {
+                const reason = `status "${spec.status ?? '(none)'}" is not archive-eligible (${ARCHIVE_ELIGIBLE_STATUSES.join('/')})`;
+                log?.(`archive (dry-run): would refuse ${spec.id} — ${reason}`);
+                results.push({ specId: spec.id, moved: [], skipped: [], refused: true, reason });
+                continue;
+            }
+            log?.(`archive (dry-run): would archive ${spec.id}`);
+            results.push({ specId: spec.id, moved: [], skipped: [] });
+            continue;
+        }
+        results.push(archiveSpec(repoRoot, spec, log, configPath, { force: opts.force }));
+    }
+    return results;
+}
+//# sourceMappingURL=archive.js.map

package/dist/lib/archive.js.map

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

package/dist/lib/artifact-integrity.d.ts

@@ -0,0 +1,5 @@
+export type IntegrityReport = {
+    missingFrontmatter: string[];
+    danglingSymlinks: string[];
+};
+export declare function checkArtifactIntegrity(repoRoot: string): IntegrityReport;

package/dist/lib/artifact-integrity.js

@@ -0,0 +1,65 @@
+import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Collect primary artifact paths that require frontmatter:
+ *   - automation/skills/*\/SKILL.md  (top-level manifest only, no sub-docs)
+ *   - automation/commands/*.md       (top-level only, no recursion)
+ *   - automation/agents/*.md         (top-level only, no recursion)
+ */
+function collectPrimaryArtifacts(repoRoot) {
+    const files = [];
+    // Skills: only the SKILL.md inside each direct subdirectory
+    const skillsDir = join(repoRoot, 'automation', 'skills');
+    if (existsSync(skillsDir)) {
+        for (const e of readdirSync(skillsDir, { withFileTypes: true })) {
+            if (e.isDirectory()) {
+                const skillMd = join(skillsDir, e.name, 'SKILL.md');
+                if (existsSync(skillMd))
+                    files.push(skillMd);
+            }
+        }
+    }
+    // Commands and agents: top-level *.md files only (no recursion)
+    for (const sub of ['commands', 'agents']) {
+        const dir = join(repoRoot, 'automation', sub);
+        if (!existsSync(dir))
+            continue;
+        for (const e of readdirSync(dir, { withFileTypes: true })) {
+            if (!e.isDirectory() && e.name.endsWith('.md')) {
+                files.push(join(dir, e.name));
+            }
+        }
+    }
+    return files;
+}
+function walkSymlinks(dir, out) {
+    if (!existsSync(dir))
+        return;
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, e.name);
+        if (e.isSymbolicLink()) {
+            try {
+                realpathSync(full);
+            }
+            catch {
+                out.push(full);
+            }
+        }
+        else if (e.isDirectory()) {
+            walkSymlinks(full, out);
+        }
+    }
+}
+export function checkArtifactIntegrity(repoRoot) {
+    const mdFiles = collectPrimaryArtifacts(repoRoot);
+    const missingFrontmatter = mdFiles.filter((p) => {
+        const text = readFileSync(p, 'utf8');
+        return !/^---[ \t]*\n[\s\S]*?\bname:\s*\S/.test(text.slice(0, 600));
+    });
+    const danglingSymlinks = [];
+    for (const root of ['.claude', '.cursor']) {
+        walkSymlinks(join(repoRoot, root), danglingSymlinks);
+    }
+    return { missingFrontmatter, danglingSymlinks };
+}
+//# sourceMappingURL=artifact-integrity.js.map

package/dist/lib/artifact-integrity.js.map

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

package/dist/lib/backfill-queue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build a prioritised work queue from a set of backfill rows, ordering T1 relinks
+ * before T2/T3/T4 rebuilds, and dropping T0 entries (already done).
+ *
+ * The generic keeps the full caller row shape so downstream callers don't need to
+ * re-join against the original data.
+ */
+export declare function buildQueue<T extends {
+    id: string;
+    tier: string;
+}>(rows: T[]): T[];

package/dist/lib/backfill-queue.js

@@ -0,0 +1,14 @@
+const ORDER = { T1: 0, T2: 1, T3: 2, T4: 3 };
+/**
+ * Build a prioritised work queue from a set of backfill rows, ordering T1 relinks
+ * before T2/T3/T4 rebuilds, and dropping T0 entries (already done).
+ *
+ * The generic keeps the full caller row shape so downstream callers don't need to
+ * re-join against the original data.
+ */
+export function buildQueue(rows) {
+    return rows
+        .filter((r) => r.tier in ORDER)
+        .sort((a, b) => ORDER[a.tier] - ORDER[b.tier]);
+}
+//# sourceMappingURL=backfill-queue.js.map

package/dist/lib/backfill-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backfill-queue.js","sourceRoot":"","sources":["../../src/lib/backfill-queue.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAW,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAyC,IAAS;IAC1E,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAA0B,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAA0B,CAAC,CAAC,CAAC;AAC/F,CAAC"}