specweave 3.0.23 → 3.1.0

package/dist/src/core/review/brief.js

@@ -0,0 +1,151 @@
+/**
+ * The brief `specweave review` hands a reviewer: what the increment promised
+ * (ACs, Approach, tasks and their Files), who wrote it (model family from the
+ * ledger), the diff range and the diff itself, and the report shape to answer in.
+ *
+ * @module core/review/brief
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawnSync } from 'child_process';
+import { readLedger, ledgerPath } from '../tasks/ledger.js';
+import { readSpecAcs } from '../tasks/verify-runner.js';
+import { loadTaskBoard } from '../tasks/task-board.js';
+import { readGlossary } from '../glossary/parse.js';
+/** Diff text above this many characters is left out; the reviewer runs git itself. */
+export const MAX_DIFF_CHARS = 150000;
+/** Model family of a tool name as the ledger records it (`claude@mbp` → claude). */
+export function familyOfTool(tool) {
+    const t = tool.toLowerCase();
+    if (/^(claude|anthropic|opus|sonnet|haiku)/.test(t))
+        return 'claude';
+    if (/^(codex|openai|gpt|chatgpt)/.test(t))
+        return 'openai';
+    if (/^(grok|xai)/.test(t))
+        return 'xai';
+    if (/^(gemini|google)/.test(t))
+        return 'google';
+    return t;
+}
+/**
+ * Who wrote the increment, from its ledger's `done` events (claims when no task is
+ * done yet). `SPECWEAVE_AGENT` names without a tool (`api`) do not count.
+ */
+export function authorFamilies(incrementDir) {
+    const { events } = readLedger(ledgerPath(incrementDir));
+    const tally = (type) => {
+        const counts = {};
+        for (const e of events) {
+            if (e.e !== type || !e.by.includes('@'))
+                continue;
+            const family = familyOfTool(e.by.split('@')[0]);
+            counts[family] = (counts[family] ?? 0) + 1;
+        }
+        return counts;
+    };
+    let counts = tally('done');
+    if (!Object.keys(counts).length)
+        counts = tally('claim');
+    const primary = Object.entries(counts).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))[0]?.[0];
+    return { primary, counts };
+}
+export function git(cwd, args) {
+    const res = spawnSync('git', args, { cwd, encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
+    return res.status === 0 ? res.stdout : null;
+}
+/** `--base`, else the merge-base with the remote's default branch, develop, main or master. */
+export function resolveBase(repoRoot, explicit) {
+    const candidates = explicit
+        ? [explicit]
+        : ['origin/HEAD', 'origin/develop', 'origin/main', 'origin/master', 'develop', 'main', 'master'];
+    for (const ref of candidates) {
+        const sha = git(repoRoot, ['merge-base', 'HEAD', ref])?.trim();
+        if (sha)
+            return sha;
+        if (explicit)
+            return null;
+    }
+    return null;
+}
+function section(spec, heading) {
+    const lines = spec.replace(/\r\n/g, '\n').split('\n');
+    const start = lines.findIndex((l) => l.trim().toLowerCase() === `## ${heading}`.toLowerCase());
+    if (start < 0)
+        return '';
+    const end = lines.findIndex((l, i) => i > start && /^##\s/.test(l));
+    return lines.slice(start + 1, end < 0 ? undefined : end).join('\n').trim();
+}
+export function buildBrief(opts) {
+    const { projectRoot, repoRoot, incrementId, incrementDir, base } = opts;
+    const specFile = path.join(incrementDir, 'spec.md');
+    const spec = fs.existsSync(specFile) ? fs.readFileSync(specFile, 'utf8') : '';
+    const title = spec.match(/^#\s+(.+)$/m)?.[1].trim() ?? incrementId;
+    const author = authorFamilies(incrementDir);
+    const acs = readSpecAcs(incrementDir);
+    let tasks = [];
+    try {
+        tasks = loadTaskBoard(incrementDir).tasks.map((t) => ({
+            id: t.id, title: t.title, files: t.filesAffected ?? [], test: t.test, status: t.state.status,
+        }));
+    }
+    catch {
+        // unreadable tasks: the brief still carries the ACs and the diff
+    }
+    const paths = [...new Set(tasks.flatMap((t) => t.files))]
+        .map((f) => path.relative(repoRoot, path.resolve(projectRoot, f.replace(/\/$/, ''))))
+        .filter((f) => f && !f.startsWith('..') && !path.isAbsolute(f))
+        .map((f) => f.split(path.sep).join('/'));
+    const head = git(repoRoot, ['rev-parse', 'HEAD'])?.trim() ?? 'HEAD';
+    const range = `${base}...HEAD`;
+    const scope = paths.length ? ['--', ...paths] : [];
+    const stat = git(repoRoot, ['diff', '--stat', range, ...scope])?.trim() ?? '';
+    const diff = git(repoRoot, ['diff', range, ...scope]) ?? '';
+    const diffIncluded = diff.length > 0 && diff.length <= MAX_DIFF_CHARS;
+    const diffCmd = `git diff ${base.slice(0, 12)}...HEAD${paths.length ? ` -- ${paths.join(' ')}` : ''}`;
+    const glossary = readGlossary(projectRoot);
+    const authorLine = author.primary
+        ? `${author.primary} (${Object.entries(author.counts).map(([f, n]) => `${f} ${n}`).join(', ')} finished tasks)`
+        : 'unknown (no finished tasks in the ledger)';
+    const parts = [
+        `# Adversarial review: ${incrementId} ${title}`,
+        '',
+        'You are reviewing code another model wrote. Do not edit files. Hunt for real failures:',
+        'input or state that leads to wrong output, a crash, a hang, data loss, a leak, or an',
+        'acceptance criterion claimed but not met. Every finding cites `path:line` and the',
+        'concrete failure. Re-open the lines before you report a finding; drop what does not',
+        'survive. "Consider refactoring" is not a finding.',
+        '',
+        `Repository: ${repoRoot}`,
+        `Written by: ${authorLine}`,
+        `Diff: ${diffCmd} (base ${base}, head ${head})`,
+        '',
+        'Order: correctness (logic, error paths, races, off-by-one), security (injection, path',
+        'traversal, secrets, unsafe exec), spec compliance (ACs below; tests that assert nothing',
+        'or mock the subject), portability (Windows paths, shells, encodings).',
+        '',
+    ];
+    if (acs.length) {
+        parts.push('## Acceptance criteria', '', ...acs.map((a) => `- ${a.id}: ${a.text}`), '');
+    }
+    const approach = section(spec, 'Approach');
+    if (approach)
+        parts.push('## Approach', '', approach, '');
+    if (tasks.length) {
+        parts.push('## Tasks', '');
+        for (const t of tasks) {
+            parts.push(`- ${t.id} ${t.title} [${t.status}]${t.files.length ? ` · Files: ${t.files.join(', ')}` : ''}${t.test ? ` · Test: ${t.test}` : ''}`);
+        }
+        parts.push('');
+    }
+    if (glossary.length) {
+        parts.push('## Glossary', '', 'New names must use these terms; an avoided word in a new identifier is a low finding.', '', ...glossary.map((g) => `- ${g.term}${g.avoid.length ? ` (avoid: ${g.avoid.join(', ')})` : ''}`), '');
+    }
+    parts.push('## Diff stat', '', '```', stat || '(empty diff)', '```', '');
+    if (diffIncluded)
+        parts.push('## Diff', '', '```diff', diff.trimEnd(), '```', '');
+    else if (diff.length)
+        parts.push(`The diff is ${diff.length} characters; run \`${diffCmd}\` and read it in parts.`, '');
+    parts.push('## Answer in exactly this shape', '', '```markdown', `# Review: ${incrementId} ${title}`, 'Verdict: fix first · risk: high · 6 files · 2 findings (1 critical, 1 high)', '', '## [critical] src/core/tasks/ledger.ts:142 lost claim under equal timestamps', 'Two agents claim T-01 in the same second; the fold sorts only by `at`, so both read', 'themselves as owner. Fix: break ties by `by`, then file order.', '', 'Nits: at most 5, on one line.', '```', '', 'Severity is critical, high, medium or low. The verdict is `fix first` while any critical', 'or high finding survives, otherwise `ship`. The second line must start with `Verdict:`.');
+    return { incrementId, title, author, base, head, paths, stat, diffIncluded, text: parts.join('\n') + '\n' };
+}
+//# sourceMappingURL=brief.js.map

package/dist/src/core/review/brief.js.map

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

package/dist/src/core/review/reviewer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Reviewers for `specweave review`: a CLI command per reviewer that reads the
+ * brief on stdin and answers on stdout, or into `{out}` when the command names
+ * one. SpecWeave holds no model keys; each CLI uses its own login.
+ *
+ * Defaults: Codex with GPT-6.1-Sol for code another family wrote, Claude Opus for
+ * code OpenAI models wrote. `review.reviewers` in config overrides or adds.
+ *
+ * @module core/review/reviewer
+ */
+import type { ReviewConfiguration, ReviewerConfiguration } from '../config/types.js';
+export interface Reviewer extends ReviewerConfiguration {
+    name: string;
+    family: string;
+}
+export declare const BUILTIN_REVIEWERS: Record<string, ReviewerConfiguration>;
+export declare const DEFAULT_TIMEOUT_MINUTES = 30;
+export declare function reviewersFrom(config: ReviewConfiguration | undefined): Reviewer[];
+/** First word of a command, unquoted. */
+export declare function commandBinary(command: string): string;
+export declare function onPath(binary: string, env?: NodeJS.ProcessEnv): boolean;
+export interface ReviewerChoice {
+    reviewer?: Reviewer;
+    /** Why this one, or why none. */
+    why: string;
+}
+/**
+ * `--reviewer`, else `review.reviewer` unless it is `auto`, else the first installed
+ * reviewer of another family than the author (Codex first). An unknown author gets
+ * Codex, since most code SpecWeave sees is written by Claude.
+ */
+export declare function pickReviewer(reviewers: Reviewer[], authorFamily: string | undefined, opts?: {
+    explicit?: string;
+    configured?: string;
+    available?: (r: Reviewer) => boolean;
+}): ReviewerChoice;
+/** Env var holding the answer file; `{out}` becomes a quoted reference to it, never the path itself. */
+export declare const OUT_ENV = "SPECWEAVE_REVIEW_OUT";
+/** `{out}`, `"{out}"` or `'{out}'` → `"$SPECWEAVE_REVIEW_OUT"` (`"%SPECWEAVE_REVIEW_OUT%"` on Windows). */
+export declare function expandOut(command: string, platform?: NodeJS.Platform): string;
+export interface RunResult {
+    code: number;
+    output: string;
+    timedOut: boolean;
+    stderr: string;
+}
+/**
+ * Run a reviewer with the brief on stdin; its answer is `{out}` when used, else
+ * stdout. On timeout the whole process tree is stopped, and the result returns
+ * within two grace periods even if a descendant keeps the pipes open.
+ */
+export declare function runReviewer(command: string, brief: string, opts: {
+    cwd: string;
+    outFile: string;
+    timeoutMs: number;
+    env?: NodeJS.ProcessEnv;
+    graceMs?: number;
+}): Promise<RunResult>;
+export type Verdict = 'ship' | 'fix first';
+/** `Verdict: fix first` / `**Verdict:** ship` anywhere in the answer; the first one wins. */
+export declare function parseVerdict(text: string): Verdict | undefined;
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/src/core/review/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../../../src/core/review/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGrF,MAAM,WAAW,QAAS,SAAQ,qBAAqB;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CASnE,CAAC;AAEF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,QAAQ,EAAE,CAMjF;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAKpF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,QAAQ,EAAE,EACrB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAA;CAAO,GAC1F,cAAc,CAgBhB;AAED,wGAAwG;AACxG,eAAO,MAAM,OAAO,yBAAyB,CAAC;AAE9C,2GAA2G;AAC3G,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAG/F;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnG,OAAO,CAAC,SAAS,CAAC,CAoEpB;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3C,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAI9D"}

package/dist/src/core/review/reviewer.js

@@ -0,0 +1,166 @@
+/**
+ * Reviewers for `specweave review`: a CLI command per reviewer that reads the
+ * brief on stdin and answers on stdout, or into `{out}` when the command names
+ * one. SpecWeave holds no model keys; each CLI uses its own login.
+ *
+ * Defaults: Codex with GPT-6.1-Sol for code another family wrote, Claude Opus for
+ * code OpenAI models wrote. `review.reviewers` in config overrides or adds.
+ *
+ * @module core/review/reviewer
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn, spawnSync } from 'child_process';
+import { familyOfTool } from './brief.js';
+export const BUILTIN_REVIEWERS = {
+    codex: {
+        command: 'codex exec -m gpt-6.1-sol -c model_reasoning_effort="high" -s read-only --skip-git-repo-check -o {out} -',
+        family: 'openai',
+    },
+    claude: {
+        command: 'claude -p --model opus --permission-mode plan',
+        family: 'claude',
+    },
+};
+export const DEFAULT_TIMEOUT_MINUTES = 30;
+export function reviewersFrom(config) {
+    const merged = { ...BUILTIN_REVIEWERS };
+    for (const [name, r] of Object.entries(config?.reviewers ?? {})) {
+        if (r && typeof r.command === 'string' && r.command.trim())
+            merged[name] = { ...BUILTIN_REVIEWERS[name], ...r };
+    }
+    return Object.entries(merged).map(([name, r]) => ({ name, command: r.command, family: familyOfTool(r.family ?? name) }));
+}
+/** First word of a command, unquoted. */
+export function commandBinary(command) {
+    const m = command.trim().match(/^"([^"]+)"|^'([^']+)'|^(\S+)/);
+    return m ? (m[1] ?? m[2] ?? m[3]) : '';
+}
+export function onPath(binary, env = process.env) {
+    if (!binary)
+        return false;
+    if (binary.includes('/') || binary.includes('\\'))
+        return fs.existsSync(binary);
+    const probe = process.platform === 'win32' ? spawnSync('where', [binary], { env }) : spawnSync('sh', ['-c', 'command -v "$1"', 'sh', binary], { env });
+    return probe.status === 0;
+}
+/**
+ * `--reviewer`, else `review.reviewer` unless it is `auto`, else the first installed
+ * reviewer of another family than the author (Codex first). An unknown author gets
+ * Codex, since most code SpecWeave sees is written by Claude.
+ */
+export function pickReviewer(reviewers, authorFamily, opts = {}) {
+    const available = opts.available ?? ((r) => onPath(commandBinary(r.command)));
+    const named = opts.explicit || (opts.configured && opts.configured !== 'auto' ? opts.configured : undefined);
+    if (named) {
+        const r = reviewers.find((x) => x.name === named);
+        if (!r)
+            return { why: `no reviewer "${named}"; known: ${reviewers.map((x) => x.name).join(', ')}` };
+        return { reviewer: r, why: opts.explicit ? '--reviewer' : 'review.reviewer' };
+    }
+    const order = [...reviewers].sort((a, b) => Number(b.name === 'codex') - Number(a.name === 'codex'));
+    const other = order.filter((r) => r.family !== authorFamily);
+    const pick = other.find(available);
+    if (pick) {
+        return { reviewer: pick, why: authorFamily ? `another family than the author (${authorFamily})` : 'author unknown' };
+    }
+    const missing = other.map((r) => commandBinary(r.command)).join(', ') || 'none configured';
+    return { why: `no reviewer from another family than ${authorFamily ?? 'the author'} is installed (${missing})` };
+}
+/** Env var holding the answer file; `{out}` becomes a quoted reference to it, never the path itself. */
+export const OUT_ENV = 'SPECWEAVE_REVIEW_OUT';
+/** `{out}`, `"{out}"` or `'{out}'` → `"$SPECWEAVE_REVIEW_OUT"` (`"%SPECWEAVE_REVIEW_OUT%"` on Windows). */
+export function expandOut(command, platform = process.platform) {
+    const ref = platform === 'win32' ? `"%${OUT_ENV}%"` : `"$${OUT_ENV}"`;
+    return command.replace(/(["']?)\{out\}\1/g, ref);
+}
+/** Grace between SIGTERM and SIGKILL, and again before giving up on the pipes. */
+const KILL_GRACE_MS = 5000;
+/**
+ * Run a reviewer with the brief on stdin; its answer is `{out}` when used, else
+ * stdout. On timeout the whole process tree is stopped, and the result returns
+ * within two grace periods even if a descendant keeps the pipes open.
+ */
+export function runReviewer(command, brief, opts) {
+    const usesOut = command.includes('{out}');
+    const cmd = expandOut(command);
+    const grace = opts.graceMs ?? KILL_GRACE_MS;
+    if (usesOut) {
+        fs.mkdirSync(path.dirname(opts.outFile), { recursive: true });
+        fs.rmSync(opts.outFile, { force: true });
+    }
+    return new Promise((resolve) => {
+        const posix = process.platform !== 'win32';
+        const child = spawn(cmd, {
+            cwd: opts.cwd,
+            shell: true,
+            // Own process group on POSIX so a timeout or Ctrl-C stops the reviewer's children too.
+            detached: posix,
+            env: { ...(opts.env ?? process.env), [OUT_ENV]: opts.outFile },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let done = false;
+        const killTree = (signal) => {
+            if (!child.pid)
+                return;
+            try {
+                if (posix)
+                    process.kill(-child.pid, signal);
+                else
+                    spawnSync('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore', windowsHide: true, timeout: 2000 });
+            }
+            catch {
+                // already gone
+            }
+        };
+        // Ctrl-C or a kill of `specweave review`: there is no time left to escalate, so
+        // the reviewer's group is killed outright before the signal is passed on.
+        const onSignal = (signal) => {
+            killTree('SIGKILL');
+            process.kill(process.pid, signal);
+        };
+        process.once('SIGINT', onSignal);
+        process.once('SIGTERM', onSignal);
+        child.stdout?.on('data', (d) => { stdout += d.toString('utf8'); });
+        child.stderr?.on('data', (d) => { stderr = (stderr + d.toString('utf8')).slice(-8000); });
+        child.stdin?.on('error', () => { });
+        child.stdin?.end(brief);
+        const timers = [];
+        const finish = (code) => {
+            if (done)
+                return;
+            done = true;
+            timers.forEach(clearTimeout);
+            // Whatever the reviewer left behind (a descendant that ignored SIGTERM, a
+            // background job) goes with it: the group is ours alone.
+            if (posix || timedOut)
+                killTree('SIGKILL');
+            process.removeListener('SIGINT', onSignal);
+            process.removeListener('SIGTERM', onSignal);
+            const fromFile = usesOut && fs.existsSync(opts.outFile) ? fs.readFileSync(opts.outFile, 'utf8') : '';
+            resolve({ code, output: (fromFile || stdout).trim(), timedOut, stderr: stderr.trim() });
+        };
+        timers.push(setTimeout(() => {
+            timedOut = true;
+            killTree('SIGTERM');
+            timers.push(setTimeout(() => {
+                killTree('SIGKILL');
+                timers.push(setTimeout(() => finish(124), grace));
+            }, grace));
+        }, opts.timeoutMs));
+        child.on('close', (code) => finish(code ?? 1));
+        child.on('error', (e) => { stderr += String(e); finish(127); });
+    });
+}
+/** `Verdict: fix first` / `**Verdict:** ship` anywhere in the answer; the first one wins. */
+export function parseVerdict(text) {
+    const m = text.match(/^[\s>*_#-]*verdict[*_]*\s*:[*_\s]*(ship|fix[ -]first)\b/im);
+    if (!m)
+        return undefined;
+    return m[1].toLowerCase() === 'ship' ? 'ship' : 'fix first';
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/src/core/review/reviewer.js.map

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

package/dist/src/core/skills/catalog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skill catalog: which SpecWeave skills a project gets.
+ *
+ * `skills/catalog.json` (copied to `plugins/specweave/skills-catalog.json` by
+ * scripts/build/generate-skills.mjs) lists the core skills every project gets,
+ * the optional ones, and the retired ones `update` removes. An optional skill is
+ * on when `.specweave/config.json` lists it under `skills.enabled`, or when its
+ * detect rule matches and it is not under `skills.disabled`.
+ *
+ * @module core/skills/catalog
+ */
+export type DetectRule = 'deep-interview' | 'glossary-file' | 'tracker' | 'hub' | 'jev';
+export interface OptionalSkill {
+    name: string;
+    summary: string;
+    detect?: DetectRule;
+}
+export interface SkillCatalog {
+    core: string[];
+    optional: OptionalSkill[];
+    retired: string[];
+}
+export interface SkillsConfig {
+    /** Optional skills to install even when nothing detects them. */
+    enabled?: string[];
+    /** Optional skills to leave out even when detected. */
+    disabled?: string[];
+}
+export type SkillState = {
+    name: string;
+    tier: 'core';
+    on: true;
+    reason: 'core';
+} | {
+    name: string;
+    tier: 'optional';
+    on: boolean;
+    reason: 'enabled' | 'disabled' | 'detected' | 'off';
+    detail?: string;
+    summary: string;
+};
+export declare function readSkillCatalog(pluginRoot: string): SkillCatalog;
+/** Why a detect rule matches in this project, or undefined when it does not. */
+export declare function detectSkill(rule: DetectRule | undefined, projectRoot: string, config: Record<string, any> | undefined): string | undefined;
+/** Every catalog skill with its state in this project, core first. */
+export declare function resolveSkills(projectRoot: string, catalog: SkillCatalog, config?: Record<string, any> | undefined): SkillState[];
+/** Names in a config list that are not optional skills (typos, core skills). */
+export declare function unknownSkillNames(list: unknown, catalog: SkillCatalog): string[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/src/core/skills/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/core/skills/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3I,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAOjE;AA4BD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAgB1I;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAA0B,GAAG,UAAU,EAAE,CAexH;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAGhF"}

package/dist/src/core/skills/catalog.js

@@ -0,0 +1,95 @@
+/**
+ * Skill catalog: which SpecWeave skills a project gets.
+ *
+ * `skills/catalog.json` (copied to `plugins/specweave/skills-catalog.json` by
+ * scripts/build/generate-skills.mjs) lists the core skills every project gets,
+ * the optional ones, and the retired ones `update` removes. An optional skill is
+ * on when `.specweave/config.json` lists it under `skills.enabled`, or when its
+ * detect rule matches and it is not under `skills.disabled`.
+ *
+ * @module core/skills/catalog
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export function readSkillCatalog(pluginRoot) {
+    const file = path.join(pluginRoot, 'skills-catalog.json');
+    const raw = JSON.parse(fs.readFileSync(file, 'utf8'));
+    if (!Array.isArray(raw.core) || !Array.isArray(raw.optional)) {
+        throw new Error(`${file}: needs "core" and "optional" arrays`);
+    }
+    return { core: raw.core, optional: raw.optional, retired: raw.retired ?? [] };
+}
+function readConfig(projectRoot) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(projectRoot, '.specweave', 'config.json'), 'utf8')) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Short names from a config list; tolerates `sw-` prefixes and non-arrays. */
+function names(list) {
+    if (!Array.isArray(list))
+        return new Set();
+    return new Set(list.filter((n) => typeof n === 'string').map((n) => n.replace(/^sw-/, '')));
+}
+function trackerConfigured(config) {
+    const sync = config?.sync;
+    for (const provider of ['github', 'jira', 'ado']) {
+        if (sync?.[provider]?.enabled === true)
+            return `sync.${provider}.enabled`;
+    }
+    if (sync?.profiles && typeof sync.profiles === 'object' && Object.keys(sync.profiles).length > 0)
+        return 'sync.profiles';
+    if (sync?.enabled === true)
+        return 'sync.enabled';
+    const tracker = config?.issueTracker?.provider;
+    if (typeof tracker === 'string' && tracker !== '' && tracker !== 'none')
+        return `issueTracker.provider: ${tracker}`;
+    return undefined;
+}
+/** Why a detect rule matches in this project, or undefined when it does not. */
+export function detectSkill(rule, projectRoot, config) {
+    switch (rule) {
+        case 'deep-interview':
+            return config?.planning?.deepInterview === 'deep' ? 'planning.deepInterview: deep' : undefined;
+        case 'glossary-file':
+            for (const f of ['GLOSSARY.md', 'GLOSSARY-MAP.md'])
+                if (fs.existsSync(path.join(projectRoot, f)))
+                    return f;
+            return undefined;
+        case 'tracker':
+            return trackerConfigured(config);
+        case 'hub':
+            return fs.existsSync(path.join(projectRoot, '.specweave', 'project', 'hub.json')) ? '.specweave/project/hub.json' : undefined;
+        case 'jev':
+            return config?.jev?.enabled === true ? 'jev.enabled' : undefined;
+        default:
+            return undefined;
+    }
+}
+/** Every catalog skill with its state in this project, core first. */
+export function resolveSkills(projectRoot, catalog, config = readConfig(projectRoot)) {
+    const skills = (config?.skills ?? {});
+    const enabled = names(skills.enabled);
+    const disabled = names(skills.disabled);
+    const out = catalog.core.map((name) => ({ name, tier: 'core', on: true, reason: 'core' }));
+    for (const s of catalog.optional) {
+        const base = { name: s.name, tier: 'optional', summary: s.summary };
+        if (enabled.has(s.name))
+            out.push({ ...base, on: true, reason: 'enabled' });
+        else if (disabled.has(s.name))
+            out.push({ ...base, on: false, reason: 'disabled' });
+        else {
+            const why = detectSkill(s.detect, projectRoot, config);
+            out.push(why ? { ...base, on: true, reason: 'detected', detail: why } : { ...base, on: false, reason: 'off' });
+        }
+    }
+    return out;
+}
+/** Names in a config list that are not optional skills (typos, core skills). */
+export function unknownSkillNames(list, catalog) {
+    const optional = new Set(catalog.optional.map((s) => s.name));
+    return [...names(list)].filter((n) => !optional.has(n));
+}
+//# sourceMappingURL=catalog.js.map

package/dist/src/core/skills/catalog.js.map

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

package/dist/src/core/skills/legacy-skill-hashes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SHA-256 of every file SpecWeave 3.0.0 to 3.0.23 installed into `.claude/skills/sw-<name>/` and
+ * `.agents/skills/sw-<name>/` (the project form of each plugin skill file, at every
+ * 3.0.x tag). Those versions wrote no install manifest, so a folder whose every file
+ * is listed here is SpecWeave's unmodified copy; anything else is the user's.
+ * Generated once from the release tags; 3.1 and later record a manifest instead.
+ *
+ * @module core/skills/legacy-skill-hashes
+ */
+export declare const LEGACY_SKILL_HASHES: Readonly<Record<string, Readonly<Record<string, readonly string[]>>>>;
+//# sourceMappingURL=legacy-skill-hashes.d.ts.map

package/dist/src/core/skills/legacy-skill-hashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-skill-hashes.d.ts","sourceRoot":"","sources":["../../../../src/core/skills/legacy-skill-hashes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CAwErG,CAAC"}