specweave 1.0.579 → 1.0.581

package/dist/src/core/skill-refine/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-refine/apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,OAAO,EAAkB,MAAM,MAAM,CAAC;AAC/C,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAiB,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkE9E;AA0BD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/src/core/skill-refine/apply.js

@@ -0,0 +1,97 @@
+/**
+ * Apply an approved diff to a SKILL.md file, commit the change, and record
+ * the event in the ledger.
+ *
+ * AC-US2-04: writes the diff AND runs `git commit -m "refine(<skill>): <rationale>"`.
+ *            NEVER pushes.
+ * AC-US2-05: records the refinement in `.specweave/state/skill-refinements.json`.
+ *
+ * Git operations go through `execFileNoThrow` so arguments cannot be shell-
+ * interpolated. If any step fails the SKILL.md is restored from the pre-diff
+ * snapshot and no ledger entry is written.
+ *
+ * @module core/skill-refine/apply
+ */
+import { promises as fs } from 'fs';
+import { mkdtemp, writeFile, unlink } from 'fs/promises';
+import { tmpdir } from 'os';
+import { dirname, join, relative } from 'path';
+import { execFileNoThrow, } from '../../utils/execFileNoThrow';
+import { appendApplied } from './ledger';
+/**
+ * Apply the diff + commit + record. Throws on any step failure; callers
+ * translate the error into user-facing text.
+ */
+export async function applyRefinement(opts) {
+    if (!opts.diff.trim()) {
+        throw new Error('applyRefinement: diff is empty — nothing to apply.');
+    }
+    const runGit = opts.runGit ?? ((args, cwd) => execFileNoThrow('git', args, { cwd }));
+    // Snapshot SKILL.md for rollback.
+    const snapshot = await fs.readFile(opts.skillPath, 'utf-8').catch(() => '');
+    const hadFile = snapshot.length > 0;
+    const patchPath = await writePatchTempfile(opts.diff);
+    try {
+        // Apply relative to the repo root so --- a/... / +++ b/... paths resolve.
+        const apply = await runGit(['apply', '--whitespace=nowarn', patchPath], opts.repoRoot);
+        if (!apply.success) {
+            throw new Error(`git apply failed: ${apply.stderr || apply.stdout || 'unknown'}`);
+        }
+        // Stage only the target SKILL.md — never blanket-stage the repo.
+        const relSkill = relative(opts.repoRoot, opts.skillPath);
+        const add = await runGit(['add', '--', relSkill], opts.repoRoot);
+        if (!add.success) {
+            throw new Error(`git add failed: ${add.stderr || 'unknown'}`);
+        }
+        const commit = await runGit([
+            'commit',
+            '-m',
+            `refine(${opts.targetSkill}): ${truncateFirstLine(opts.rationale)}`,
+        ], opts.repoRoot);
+        if (!commit.success) {
+            throw new Error(`git commit failed: ${commit.stderr || commit.stdout || 'unknown'}`);
+        }
+        const revParse = await runGit(['rev-parse', 'HEAD'], opts.repoRoot);
+        const commitSha = (revParse.stdout || '').trim() || 'unknown';
+        const author = opts.author ?? (await resolveGitAuthor(opts.repoRoot, runGit));
+        const ledgerEntry = await appendApplied(opts.ledgerPath, {
+            targetSkill: opts.targetSkill,
+            author,
+            signalIds: opts.signalIds,
+            diffSha: commitSha,
+            rationale: opts.rationale,
+        });
+        return { commitSha, ledgerEntry };
+    }
+    catch (err) {
+        // Restore pre-apply snapshot — never leave SKILL.md in a half-applied state.
+        if (hadFile) {
+            await fs.writeFile(opts.skillPath, snapshot, 'utf-8').catch(() => undefined);
+        }
+        throw err;
+    }
+    finally {
+        await unlink(patchPath).catch(() => undefined);
+    }
+}
+async function writePatchTempfile(diff) {
+    const dir = await mkdtemp(join(tmpdir(), 'skill-refine-patch-'));
+    const path = join(dir, 'diff.patch');
+    // Ensure trailing newline — git apply is picky otherwise.
+    const body = diff.endsWith('\n') ? diff : diff + '\n';
+    await writeFile(path, body, 'utf-8');
+    return path;
+}
+async function resolveGitAuthor(repoRoot, runGit) {
+    const res = await runGit(['config', 'user.email'], repoRoot);
+    if (res.success && res.stdout.trim())
+        return res.stdout.trim();
+    return 'unknown';
+}
+function truncateFirstLine(text, max = 72) {
+    const firstLine = text.split('\n')[0] ?? '';
+    return firstLine.length <= max ? firstLine : firstLine.slice(0, max - 1) + '…';
+}
+// helper for apply.ts consumers (re-exported for convenience)
+export { dirname };
+//# sourceMappingURL=apply.js.map

package/dist/src/core/skill-refine/apply.js.map

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

package/dist/src/core/skill-refine/approval.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Interactive approve/reject/edit prompt for `sw:skill-refine`.
+ *
+ * The user is shown the proposed diff + rationale and chooses one of:
+ * - **approve**: the caller applies the diff verbatim.
+ * - **reject**: the caller records a rejection (with reason) in the ledger;
+ *   no SKILL.md write happens.
+ * - **edit**: the user's `$EDITOR` opens on the diff so they can hand-tune
+ *   it before re-prompting for approval. Rejection during edit path is also
+ *   honored.
+ *
+ * The `promptFns` param lets tests inject deterministic behavior; in
+ * production we default to `@inquirer/prompts` (already used elsewhere in
+ * specweave for wizard UI).
+ *
+ * @module core/skill-refine/approval
+ */
+export type Decision = {
+    action: 'approve';
+    diff: string;
+} | {
+    action: 'reject';
+    reason: string;
+} | {
+    action: 'edit';
+    diff: string;
+};
+export interface ApprovalPromptContext {
+    targetSkill: string;
+    rationale: string;
+    diff: string;
+}
+export interface PromptFns {
+    /** Presents the approve/reject/edit menu. */
+    chooseAction: (ctx: ApprovalPromptContext) => Promise<'approve' | 'reject' | 'edit'>;
+    /** Prompted only when user picked 'reject'. */
+    askRejectionReason: () => Promise<string>;
+    /** Prompted only when user picked 'edit'; returns the new diff text. */
+    editDiff: (original: string) => Promise<string>;
+}
+export interface ApprovalOptions {
+    /** Max edit→re-ask loops before forcing a final decision. Default 3. */
+    maxEditLoops?: number;
+}
+/**
+ * Drive the approval flow. Returns a terminal decision:
+ * `{action:'approve', diff}` (the final, possibly-edited diff) OR
+ * `{action:'reject', reason}`.
+ *
+ * If the user loops through edits more than `maxEditLoops` without approving,
+ * the loop terminates as a rejection with an auto-reason so we never hang.
+ */
+export declare function runApprovalFlow(ctx: ApprovalPromptContext, prompts: PromptFns, opts?: ApprovalOptions): Promise<{
+    action: 'approve';
+    diff: string;
+} | {
+    action: 'reject';
+    reason: string;
+}>;
+/**
+ * Default production prompts backed by `@inquirer/prompts` + `$EDITOR`.
+ * Lazy-imported so tests that use stubs don't pay the dep cost.
+ */
+export declare function defaultPromptFns(): Promise<PromptFns>;
+/**
+ * Write `text` to a temp file, launch `$EDITOR` (or `vi` fallback), read the
+ * file back. Exposed for tests that want to validate the fallback path
+ * without actually spawning an editor.
+ */
+export declare function openInEditor(text: string): string;
+//# sourceMappingURL=approval.d.ts.map

package/dist/src/core/skill-refine/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-refine/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,MAAM,QAAQ,GAChB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,YAAY,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IACrF,+CAA+C;IAC/C,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,wEAAwE;IACxE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,SAAS,EAClB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BrF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,SAAS,CAAC,CA4B3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAejD"}

package/dist/src/core/skill-refine/approval.js

@@ -0,0 +1,113 @@
+/**
+ * Interactive approve/reject/edit prompt for `sw:skill-refine`.
+ *
+ * The user is shown the proposed diff + rationale and chooses one of:
+ * - **approve**: the caller applies the diff verbatim.
+ * - **reject**: the caller records a rejection (with reason) in the ledger;
+ *   no SKILL.md write happens.
+ * - **edit**: the user's `$EDITOR` opens on the diff so they can hand-tune
+ *   it before re-prompting for approval. Rejection during edit path is also
+ *   honored.
+ *
+ * The `promptFns` param lets tests inject deterministic behavior; in
+ * production we default to `@inquirer/prompts` (already used elsewhere in
+ * specweave for wizard UI).
+ *
+ * @module core/skill-refine/approval
+ */
+import { mkdtempSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { spawnSync } from 'child_process';
+const DEFAULT_MAX_EDIT_LOOPS = 3;
+/**
+ * Drive the approval flow. Returns a terminal decision:
+ * `{action:'approve', diff}` (the final, possibly-edited diff) OR
+ * `{action:'reject', reason}`.
+ *
+ * If the user loops through edits more than `maxEditLoops` without approving,
+ * the loop terminates as a rejection with an auto-reason so we never hang.
+ */
+export async function runApprovalFlow(ctx, prompts, opts = {}) {
+    const maxLoops = opts.maxEditLoops ?? DEFAULT_MAX_EDIT_LOOPS;
+    let currentDiff = ctx.diff;
+    let edits = 0;
+    while (true) {
+        const action = await prompts.chooseAction({
+            targetSkill: ctx.targetSkill,
+            rationale: ctx.rationale,
+            diff: currentDiff,
+        });
+        if (action === 'approve') {
+            return { action: 'approve', diff: currentDiff };
+        }
+        if (action === 'reject') {
+            const reason = await prompts.askRejectionReason();
+            return { action: 'reject', reason: reason || 'user rejected diff' };
+        }
+        // edit path
+        if (edits >= maxLoops) {
+            return {
+                action: 'reject',
+                reason: `auto-rejected: edit limit (${maxLoops}) exceeded without approval`,
+            };
+        }
+        currentDiff = await prompts.editDiff(currentDiff);
+        edits += 1;
+    }
+}
+/**
+ * Default production prompts backed by `@inquirer/prompts` + `$EDITOR`.
+ * Lazy-imported so tests that use stubs don't pay the dep cost.
+ */
+export async function defaultPromptFns() {
+    const { select, input } = await import('@inquirer/prompts');
+    return {
+        chooseAction: async (ctx) => {
+            // eslint-disable-next-line no-console
+            console.log(`\n── sw:skill-refine — ${ctx.targetSkill} ──`);
+            // eslint-disable-next-line no-console
+            console.log(`rationale: ${ctx.rationale}\n`);
+            // eslint-disable-next-line no-console
+            console.log(ctx.diff);
+            return (await select({
+                message: 'Apply this diff?',
+                choices: [
+                    { name: 'approve — write + commit', value: 'approve' },
+                    { name: 'reject — discard', value: 'reject' },
+                    { name: 'edit — open $EDITOR on the diff', value: 'edit' },
+                ],
+            }));
+        },
+        askRejectionReason: async () => {
+            return input({
+                message: 'Reason for rejection (recorded in ledger):',
+                default: 'not suitable',
+            });
+        },
+        editDiff: async (original) => openInEditor(original),
+    };
+}
+/**
+ * Write `text` to a temp file, launch `$EDITOR` (or `vi` fallback), read the
+ * file back. Exposed for tests that want to validate the fallback path
+ * without actually spawning an editor.
+ */
+export function openInEditor(text) {
+    const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+    const dir = mkdtempSync(join(tmpdir(), 'skill-refine-edit-'));
+    const path = join(dir, 'diff.patch');
+    try {
+        writeFileSync(path, text, 'utf-8');
+        const result = spawnSync(editor, [path], { stdio: 'inherit' });
+        if (result.status !== 0) {
+            // Editor closed uncleanly — keep original to avoid surprise data loss.
+            return text;
+        }
+        return readFileSync(path, 'utf-8');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/src/core/skill-refine/approval.js.map

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

package/dist/src/core/skill-refine/haiku-diff.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Haiku-backed diff proposer for `sw:skill-refine`.
+ *
+ * Given the current SKILL.md contents and an aggregate of refinement signals,
+ * asks Claude Haiku for a unified-diff proposal and a short rationale. The
+ * model is invoked at `temperature: 0` so repeat runs with the same inputs
+ * yield byte-identical output (AC-US2-02 determinism check).
+ *
+ * The Anthropic client is injected via the `client` option so tests can stub
+ * the call — production callers pass the real SDK instance.
+ *
+ * @module core/skill-refine/haiku-diff
+ */
+import type { AggregateResult } from './aggregator';
+export declare const HAIKU_MODEL = "claude-haiku-4-5-20251001";
+export interface HaikuDiffResult {
+    diff: string;
+    rationale: string;
+}
+export interface HaikuClientLike {
+    messages: {
+        create: (args: {
+            model: string;
+            max_tokens: number;
+            temperature: number;
+            system?: string;
+            messages: Array<{
+                role: 'user' | 'assistant';
+                content: string;
+            }>;
+        }) => Promise<{
+            content: Array<{
+                type: string;
+                text?: string;
+            }>;
+        }>;
+    };
+}
+export interface ProposeDiffOptions {
+    client: HaikuClientLike;
+    skillMd: string;
+    aggregate: AggregateResult;
+    model?: string;
+    maxTokens?: number;
+}
+/**
+ * Render the user-facing prompt. Exposed for test introspection — stable
+ * string shape is part of the determinism contract (same inputs → same
+ * prompt → same completion at temp 0).
+ */
+export declare function buildUserPrompt(skillMd: string, aggregate: AggregateResult): string;
+/**
+ * Call Haiku with temperature 0 and extract the proposed {diff, rationale}.
+ *
+ * Throws when the model returns malformed JSON — callers should surface the
+ * error so the user can retry or abort (we never silently fall back to a
+ * blank diff, because that would suggest "no change needed" when the truth
+ * is "the model broke").
+ */
+export declare function proposeDiff(opts: ProposeDiffOptions): Promise<HaikuDiffResult>;
+/**
+ * Extract the JSON object from a Haiku completion. Tolerates ```json fences
+ * in case the model slips past the system instruction.
+ */
+export declare function parseHaikuJson(raw: string): HaikuDiffResult;
+//# sourceMappingURL=haiku-diff.d.ts.map

package/dist/src/core/skill-refine/haiku-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haiku-diff.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-refine/haiku-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,WAAW,8BAA8B,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE;QACR,MAAM,EAAE,CAAC,IAAI,EAAE;YACb,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAClE,KAAK,OAAO,CAAC;YACZ,OAAO,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACjD,CAAC,CAAC;KACJ,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAyBnF;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,eAAe,CAAC,CAiB1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA4B3D"}

package/dist/src/core/skill-refine/haiku-diff.js

@@ -0,0 +1,111 @@
+/**
+ * Haiku-backed diff proposer for `sw:skill-refine`.
+ *
+ * Given the current SKILL.md contents and an aggregate of refinement signals,
+ * asks Claude Haiku for a unified-diff proposal and a short rationale. The
+ * model is invoked at `temperature: 0` so repeat runs with the same inputs
+ * yield byte-identical output (AC-US2-02 determinism check).
+ *
+ * The Anthropic client is injected via the `client` option so tests can stub
+ * the call — production callers pass the real SDK instance.
+ *
+ * @module core/skill-refine/haiku-diff
+ */
+export const HAIKU_MODEL = 'claude-haiku-4-5-20251001';
+const SYSTEM_PROMPT = [
+    'You are an expert editor of Claude Code SKILL.md files.',
+    'A SpecWeave user has collected refinement signals showing places where a skill\'s instructions led to gate failures.',
+    'Propose a MINIMAL unified diff against the current SKILL.md that addresses the signals.',
+    '',
+    'Requirements:',
+    '- Output a single JSON object with keys "diff" (a unified-diff string) and "rationale" (one sentence).',
+    '- The diff MUST be applicable with `git apply` (standard unified format, "--- a/SKILL.md" / "+++ b/SKILL.md").',
+    '- Do not restructure the document; make targeted edits that address the cited evidence.',
+    '- If the signals do not warrant a change, return {"diff":"","rationale":"No change warranted — signals insufficient."}.',
+    '- Never edit frontmatter unless signals specifically name it.',
+    '- No markdown fences around the JSON. No commentary.',
+].join('\n');
+/**
+ * Render the user-facing prompt. Exposed for test introspection — stable
+ * string shape is part of the determinism contract (same inputs → same
+ * prompt → same completion at temp 0).
+ */
+export function buildUserPrompt(skillMd, aggregate) {
+    const severity = aggregate.bySeverity;
+    const source = aggregate.bySource;
+    const evidenceBlock = aggregate.signals
+        .map((s, i) => `${i + 1}. [${s.severity}/${s.source}/${s.incrementId}] ${s.evidence}`)
+        .join('\n');
+    return [
+        `Target skill: ${aggregate.targetSkill}`,
+        `Window: last ${aggregate.window.lastNIncrements} increments — ${aggregate.incrementIds.join(', ') || '(none)'}`,
+        `Signals: ${aggregate.totalSignals} total | by-source judge-llm=${source['judge-llm']} rubric=${source.rubric} code-reviewer=${source['code-reviewer']} | by-severity high=${severity.high} medium=${severity.medium} low=${severity.low}`,
+        '',
+        'Evidence:',
+        evidenceBlock || '(no signals)',
+        '',
+        '--- BEGIN CURRENT SKILL.md ---',
+        skillMd,
+        '--- END CURRENT SKILL.md ---',
+        '',
+        'Return the JSON object now.',
+    ].join('\n');
+}
+/**
+ * Call Haiku with temperature 0 and extract the proposed {diff, rationale}.
+ *
+ * Throws when the model returns malformed JSON — callers should surface the
+ * error so the user can retry or abort (we never silently fall back to a
+ * blank diff, because that would suggest "no change needed" when the truth
+ * is "the model broke").
+ */
+export async function proposeDiff(opts) {
+    const userPrompt = buildUserPrompt(opts.skillMd, opts.aggregate);
+    const response = await opts.client.messages.create({
+        model: opts.model ?? HAIKU_MODEL,
+        max_tokens: opts.maxTokens ?? 4096,
+        temperature: 0,
+        system: SYSTEM_PROMPT,
+        messages: [{ role: 'user', content: userPrompt }],
+    });
+    const text = (response.content ?? [])
+        .filter((b) => b.type === 'text' && typeof b.text === 'string')
+        .map((b) => b.text)
+        .join('\n')
+        .trim();
+    return parseHaikuJson(text);
+}
+/**
+ * Extract the JSON object from a Haiku completion. Tolerates ```json fences
+ * in case the model slips past the system instruction.
+ */
+export function parseHaikuJson(raw) {
+    const cleaned = stripFences(raw);
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        throw new Error(`haiku-diff: model returned non-JSON output: ${truncate(raw, 200)}`);
+    }
+    if (parsed &&
+        typeof parsed === 'object' &&
+        'diff' in parsed &&
+        'rationale' in parsed &&
+        typeof parsed.diff === 'string' &&
+        typeof parsed.rationale === 'string') {
+        return {
+            diff: parsed.diff,
+            rationale: parsed.rationale,
+        };
+    }
+    throw new Error(`haiku-diff: JSON missing required keys {diff, rationale}: ${truncate(cleaned, 200)}`);
+}
+function stripFences(text) {
+    const fenced = text.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+    return fenced ? fenced[1].trim() : text.trim();
+}
+function truncate(text, max) {
+    return text.length <= max ? text : text.slice(0, max) + '…';
+}
+//# sourceMappingURL=haiku-diff.js.map

package/dist/src/core/skill-refine/haiku-diff.js.map

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

package/dist/src/core/skill-refine/ledger.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Append-only ledger for applied/rejected skill refinements.
+ *
+ * File lives at `.specweave/state/skill-refinements.json`. Missing/corrupt
+ * files degrade to an empty ledger — readers never throw.
+ *
+ * @module core/skill-refine/ledger
+ */
+import { EMPTY_LEDGER, type RefinementLedger, type RefinementLedgerEntry, type RefinementStatus } from '../../types/skill-refinements';
+export interface AppendAppliedInput {
+    targetSkill: string;
+    author: string;
+    signalIds: string[];
+    diffSha: string;
+    rationale: string;
+    /** Override appliedAt (mainly for tests). */
+    appliedAt?: string;
+    /** Override id (mainly for tests). */
+    id?: string;
+}
+export interface AppendRejectedInput {
+    targetSkill: string;
+    author: string;
+    signalIds: string[];
+    rationale: string;
+    rejectionReason: string;
+    appliedAt?: string;
+    id?: string;
+}
+export declare function readLedger(filePath: string): Promise<RefinementLedger>;
+export declare function appendApplied(filePath: string, input: AppendAppliedInput): Promise<RefinementLedgerEntry>;
+export declare function appendRejected(filePath: string, input: AppendRejectedInput): Promise<RefinementLedgerEntry>;
+export { EMPTY_LEDGER, type RefinementLedger, type RefinementLedgerEntry, type RefinementStatus };
+//# sourceMappingURL=ledger.d.ts.map

package/dist/src/core/skill-refine/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../../../src/core/skill-refine/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EACL,YAAY,EAEZ,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAahC;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAchC;AA2BD,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,CAAC"}

package/dist/src/core/skill-refine/ledger.js

@@ -0,0 +1,81 @@
+/**
+ * Append-only ledger for applied/rejected skill refinements.
+ *
+ * File lives at `.specweave/state/skill-refinements.json`. Missing/corrupt
+ * files degrade to an empty ledger — readers never throw.
+ *
+ * @module core/skill-refine/ledger
+ */
+import { randomUUID } from 'crypto';
+import { mkdir, readFile, writeFile, copyFile } from 'fs/promises';
+import { dirname } from 'path';
+import { EMPTY_LEDGER, RefinementLedgerSchema, } from '../../types/skill-refinements';
+export async function readLedger(filePath) {
+    let raw;
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        raw = JSON.parse(content);
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            return { refinements: [] };
+        }
+        await backup(filePath);
+        return { refinements: [] };
+    }
+    const parsed = RefinementLedgerSchema.safeParse(raw);
+    if (parsed.success)
+        return parsed.data;
+    await backup(filePath);
+    return { refinements: [] };
+}
+export async function appendApplied(filePath, input) {
+    const entry = {
+        id: input.id ?? generateRefinementId(),
+        targetSkill: input.targetSkill,
+        author: input.author,
+        signalIds: [...input.signalIds],
+        diffSha: input.diffSha,
+        rationale: input.rationale,
+        appliedAt: input.appliedAt ?? new Date().toISOString(),
+        status: 'applied',
+    };
+    await persistAppend(filePath, entry);
+    return entry;
+}
+export async function appendRejected(filePath, input) {
+    const entry = {
+        id: input.id ?? generateRefinementId(),
+        targetSkill: input.targetSkill,
+        author: input.author,
+        signalIds: [...input.signalIds],
+        diffSha: '',
+        rationale: input.rationale,
+        appliedAt: input.appliedAt ?? new Date().toISOString(),
+        status: 'rejected',
+        rejectionReason: input.rejectionReason,
+    };
+    await persistAppend(filePath, entry);
+    return entry;
+}
+// ── Internals ────────────────────────────────────────────────────────
+async function persistAppend(filePath, entry) {
+    const current = await readLedger(filePath);
+    current.refinements.push(entry);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(current, null, 2), 'utf-8');
+}
+async function backup(filePath) {
+    try {
+        await copyFile(filePath, filePath + '.bak');
+    }
+    catch {
+        // best-effort
+    }
+}
+function generateRefinementId() {
+    return `ref_${randomUUID().replace(/-/g, '').slice(0, 20).toUpperCase()}`;
+}
+// Re-export for convenience.
+export { EMPTY_LEDGER };
+//# sourceMappingURL=ledger.js.map

package/dist/src/core/skill-refine/ledger.js.map

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