zelari-code 1.29.0 → 1.30.1

package/dist/cli/kraken/scriptPlanner.js

@@ -0,0 +1,286 @@
+/**
+ * Kraken script planner — emits `.ts` plans instead of JSON DAGs.
+ *
+ * Companion to `planner.ts` (the JSON-DAG path). Same LLM plumbing, same
+ * model selection, same workspace summary — different system prompt and
+ * different output (TypeScript source, not a parsed JSON object).
+ *
+ * The script planner is opt-in: the JSON path stays the default for small
+ * goals. Select via `ZELARI_KRAKEN_PLAN_FORMAT=script`. The `auto` mode
+ * (future) picks the script path when the goal suggests > 4 nodes.
+ *
+ * On parse / compile failure, retry once with corrective feedback; on
+ * second failure, surface the error so the caller can fall back to the
+ * JSON-DAG path.
+ *
+ * @since Kraken v1.30.x — workflow script runtime (F1.2)
+ */
+import { promises as fs } from 'node:fs';
+import { build } from 'esbuild';
+import path from 'node:path';
+import { z } from 'zod';
+import { buildWorkspaceSummary } from '../workspace/workspaceSummary.js';
+import { resolveApiKeyWithMeta } from '../keyStore.js';
+import { resolveBaseUrl } from '../provider/openai-compatible.js';
+import { getModelForProvider, getProviderConfig } from '../providerConfig.js';
+import { PlannerTransportError } from './planner.js';
+const MAX_PLAN_ATTEMPTS = 2;
+const ScriptPlannerOptionsSchema = z.object({
+    prompt: z.string().min(1),
+    graphId: z.string().optional(),
+    provider: z.string().optional(),
+    model: z.string().optional(),
+    previousAttempt: z.string().optional(),
+    cwd: z.string().optional(),
+    workspace: z.string().optional(),
+    llmClient: z.custom().optional(),
+});
+/** SDK surface the script can import. Mirrored in the system prompt. */
+const SDK_SURFACE_DOC = `\
+- \`tentacle({ kind, label, prompt, scope?, acceptance?, deps?, maxRetries?, maxRuntimeMs? })\`
+  Returns a \`TentacleRef { id, kind, label, status, findings, verdict?, scope? }\`.
+  - \`kind\`: "explore" | "general" | "verify" | "fix" | "merge".
+  - \`prompt\`: self-contained instruction handed to the sub-agent.
+  - \`scope\`: path/glob allowlist (required for parallel writers).
+  - \`acceptance\`: checkable checklist (enforced by verify tentacles).
+- \`merge([refs], { strategy?, message?, cleanup? })\` — ONE-SHOT per plan.
+- \`barrier([t1, t2, t3])\` — typed wait over N parallel tentacles.
+- \`race([t1, t2])\` — first-completed wins; losers are skipped.
+- \`while_(cond, body, maxIter)\` / \`until(cond, body, maxIter)\` — bounded loops.
+- \`checkpoint(label?)\` — persist the current plan state to disk.
+- \`log(msg, data?)\` / \`emit({ kind, detail? })\` — radio + workbench events.
+- \`getContext()\` — read-only { graphId, goal, parentCwd, maxTentacles, planTimeoutMs }.`;
+export const KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT = [
+    'You are the SCRIPT PLANNER for Kraken, a multi-agent graph executor.',
+    '',
+    'You write a TypeScript module that imports capabilities from',
+    "'@zelari/kraken-runtime' and calls them to drive a multi-agent run.",
+    '',
+    'Return ONLY the TypeScript source — no markdown fence, no prose, no',
+    "explanation. The whole response is parsed as code, so even one extra",
+    "character outside the source breaks the run.",
+    '',
+    '# SDK',
+    '',
+    '```ts',
+    "import { tentacle, merge, barrier, race, while_, until, checkpoint, log, emit, getContext } from '@zelari/kraken-runtime';",
+    '```',
+    '',
+    SDK_SURFACE_DOC,
+    '',
+    '# Constraints',
+    '',
+    '- The plan is a script, NOT a graph: call `tentacle()` in the order you',
+    '  want, with whatever control flow makes sense. Sequential calls are',
+    '  sequential; `Promise.all([...])` is parallel.',
+    '- You do NOT need to declare deps explicitly. The script awaits each',
+    "  `tentacle()` in turn; whatever has already run is in scope by id.",
+    '- You can only `merge()` ONCE. If you need to merge at two stages, split',
+    '  into two plans (run them sequentially) or use checkpoint + follow-up.',
+    '- Use `while_` / `until` for the Gauntlet Loop pattern: a writer runs,',
+    '  a verify judges it, and on FAIL the body retries with the verify',
+    "  findings as context. Cap `maxIter` — the wall-clock budget cuts past it.",
+    '- Reach for `Promise.all` to fan out independent writers in parallel.',
+    '  When you do, give each a `scope` of paths it may touch; the executor',
+    '  refuses to run two parallel writers with overlapping scopes.',
+    '- End with either `merge(...)` or no merge and a final `log(...)`. Both',
+    '  are valid convergence shapes.',
+    '',
+    '# Style',
+    '',
+    '- Top-level `await` is fine. Write the plan as a sequence of',
+    '  `const x = await ...`.',
+    '- No `import` other than the SDK. The plan is single-file.',
+    '- No `process`, `require`, `Buffer`, `eval`, or `new Function` — the',
+    '  sandbox will reject the bundle.',
+    '- Keep it under ~200 lines. The plan is a sketch of intent, not full code.',
+    '',
+    '# Default shape (most goals fit this)',
+    '',
+    '1. `const ctx = await tentacle({ kind: "explore", label: "map", prompt: "..." })`',
+    '2. `const [a, b, c] = await Promise.all([tentacle({ kind: "general", scope: [...] }), ...])`',
+    '3. `const verify = await tentacle({ kind: "verify", label: "judge", deps: [a, b, c] })`',
+    '4. `if (verify.verdict === "fail") { ... rework via while_ ... }`',
+    '5. `await merge([a, b, c])`',
+    '',
+    '# Reviewer personas (Pillar 2)',
+    '',
+    'Three reviewer kinds exist, all using the same trailer format:',
+    '',
+    '- `kind: "verify"` — checks `acceptance[]` on disk. Default after every writer.',
+    '- `kind: "spec"` — compares the writer\'s output against a written spec,',
+    '  per requirement. System prompt is the spec-reviewer persona (conservative).',
+    '  Use when the task has a written spec / plan you can paste into the prompt.',
+    '- `kind: "conformance"` — compares the writer\'s output against the user\'s',
+    '  ORIGINAL VERBATIM PROMPT. System prompt is the conformance-reviewer persona',
+    '  (literal). Use as the LAST reviewer before `merge()` on goal-aligned tasks.',
+    '',
+    'All three return `{ kind, status, findings, verdict }`. The trailer is',
+    '`VERDICT: PASS|FAIL`; the per-requirement table (when present) is a JSON',
+    'code block before the trailer. Failure rewrites the work via the existing',
+    '`while_` pattern.',
+    '',
+    'Example with all three personas:',
+    '',
+    '```ts',
+    'const writer = await tentacle({ kind: "general", label: "do it", prompt: "...", scope: ["src/x"] });',
+    'const verify = await tentacle({ kind: "verify", label: "acceptance", deps: [writer] });',
+    'const spec = await tentacle({ kind: "spec", label: "spec review", deps: [writer], prompt: "<paste spec here>" });',
+    'const conf = await tentacle({ kind: "conformance", label: "conformance", deps: [writer], prompt: "<paste user prompt here>" });',
+    'if (verify.verdict === "fail" || spec.verdict === "fail" || conf.verdict === "fail") {',
+    '  // rework via while_',
+    '}',
+    'await merge([writer]);',
+    '```',
+].join('\n');
+/**
+ * Plan a script: ask the LLM for a `.ts` source, strip any markdown fence,
+ * compile it (esbuild) to validate syntax, write to
+ * `.zelari/kraken/runs/<graphId>/plan.ts`, return the path. On any failure,
+ * retry once with corrective feedback; on second failure, throw.
+ *
+ * NOTE: the resolver / `createDefaultLlmClient` is duplicated from
+ * `planner.ts` to keep this slice's diff small. A future slice will
+ * extract both into `plannerHelpers.ts`.
+ */
+export async function planScript(opts) {
+    // Empty-prompt check before Zod so the error message is friendlier.
+    if (!opts.prompt || !opts.prompt.trim()) {
+        throw new Error('planScript: prompt is required');
+    }
+    const parsed = ScriptPlannerOptionsSchema.parse(opts);
+    const client = parsed.llmClient ?? (await createScriptPlannerLlmClient({ provider: parsed.provider, model: parsed.model }));
+    const graphId = parsed.graphId ?? `kraken-script-${Date.now().toString(36)}`;
+    const workspace = await resolveWorkspaceListing(parsed);
+    const baseUser = buildUserPrompt(parsed.prompt, workspace, parsed.previousAttempt);
+    const runDir = parsed.cwd
+        ? path.join(parsed.cwd, '.zelari', 'kraken', 'runs', graphId)
+        : path.join('.zelari', 'kraken', 'runs', graphId);
+    const planPath = path.join(runDir, 'plan.ts');
+    let lastError;
+    let userMessage = baseUser;
+    let source = '';
+    let bytes = 0;
+    let attempts = 0;
+    for (let attempt = 1; attempt <= MAX_PLAN_ATTEMPTS; attempt++) {
+        attempts = attempt;
+        let text;
+        try {
+            text = await client.complete({ system: KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT, user: userMessage });
+        }
+        catch (err) {
+            throw new PlannerTransportError(err instanceof Error ? err.message : String(err));
+        }
+        bytes = text.length;
+        source = extractCodeBlock(text, 'ts');
+        if (!source.trim()) {
+            lastError = 'response was empty or not a code block';
+            userMessage = `${baseUser}\n\n---\n\nYour last reply was empty or not a TypeScript code block. Return ONLY TypeScript source — no markdown fence.`;
+            continue;
+        }
+        try {
+            await build({
+                stdin: { contents: source, resolveDir: parsed.cwd ?? process.cwd(), loader: 'ts' },
+                bundle: false,
+                write: false,
+                logLevel: 'silent',
+            });
+            await fs.mkdir(runDir, { recursive: true });
+            await fs.writeFile(planPath, source, 'utf8');
+            return { planPath, source, bytes, attempts, compiled: true };
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+            userMessage = `${baseUser}\n\n---\n\nYour last script failed to compile with esbuild. The error was:\n\n${lastError}\n\nFix the error and return ONLY the corrected TypeScript source.`;
+        }
+    }
+    throw new Error(`kraken script planner: failed to produce a compilable plan after ${MAX_PLAN_ATTEMPTS} attempts — ${lastError ?? 'unknown'}`);
+}
+/** Build the workspace listing handed to the planner. Reuses the JSON
+ *  planner's summary so the two paths see the same project context. */
+async function resolveWorkspaceListing(opts) {
+    if (opts.workspace)
+        return opts.workspace;
+    if (!opts.cwd)
+        return '(no project listing — no cwd provided)';
+    const budget = Number.parseInt(process.env.ZELARI_KRAKEN_PLANNER_WORKSPACE_CHARS ?? '3000', 10);
+    const maxChars = Number.isFinite(budget) && budget > 0 ? budget : 3000;
+    return buildWorkspaceSummary(opts.cwd, { maxChars });
+}
+function buildUserPrompt(prompt, workspace, previousAttempt) {
+    return [
+        '## Goal',
+        prompt.trim(),
+        '',
+        '## Project listing (real paths on disk; build `scope` from these)',
+        workspace,
+        '',
+        previousAttempt ? `## Previous unfinished graph in this project\n${previousAttempt}\n` : '',
+        'Write the plan now. Return ONLY TypeScript source — no markdown fence.',
+    ].join('\n');
+}
+/**
+ * Strip a markdown ```ts / ```typescript / ``` fence from a model reply, if
+ * present. Returns the inner text or the original if no fence is found.
+ *
+ * Mirrors the JSON planner's `bodyOf` for the `.ts` language.
+ */
+export function extractCodeBlock(text, language) {
+    const trimmed = text.trim();
+    const re = new RegExp('^```(?:' + language + '|typescript|javascript)?\\s*([\\s\\S]*?)```\\s*$', 'i');
+    const m = re.exec(trimmed);
+    if (m)
+        return m[1].trim();
+    // Unfenced: assume the whole reply is code (most common shape for
+    // models that follow the "no fence" instruction).
+    return trimmed;
+}
+/** Local LLM client builder, duplicated from `planner.ts` to keep the diff
+ *  small. Will be unified in a follow-up slice. */
+async function createScriptPlannerLlmClient(opts) {
+    const active = (opts.provider?.trim() || getProviderConfig().activeProviderId);
+    const meta = await resolveApiKeyWithMeta(active);
+    if (!meta?.apiKey) {
+        throw new Error(`No API key for provider '${active}'. Save a key in Settings → Provider.`);
+    }
+    const baseUrl = resolveBaseUrl(active);
+    if (!baseUrl) {
+        throw new Error(`No base URL for provider '${active}'. Set a custom endpoint in Settings.`);
+    }
+    const model = opts.model?.trim() ||
+        process.env.ZELARI_KRAKEN_PLANNER_MODEL?.trim() ||
+        getModelForProvider(active) ||
+        'grok-4.5';
+    // We just need the `complete` function. The metadata is unused past this
+    // point; the planner only needs to call the LLM.
+    return {
+        async complete({ system, user }) {
+            const res = await fetch(`${baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    ...(meta.apiKey ? { authorization: `Bearer ${meta.apiKey}` } : {}),
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: [
+                        { role: 'system', content: system },
+                        { role: 'user', content: user },
+                    ],
+                    stream: false,
+                    temperature: 0.2,
+                }),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                throw new Error(`LLM HTTP ${res.status}: ${body.slice(0, 200)}`);
+            }
+            const json = (await res.json());
+            const content = json.choices?.[0]?.message?.content;
+            if (typeof content !== 'string')
+                throw new Error('LLM returned no content');
+            return content;
+        },
+    };
+}
+//# sourceMappingURL=scriptPlanner.js.map

package/dist/cli/kraken/scriptPlanner.js.map

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

package/dist/cli/kraken/scriptPlanner.test.js

@@ -0,0 +1,152 @@
+/**
+ * Kraken script planner — tests.
+ *
+ * Covers:
+ *   - `extractCodeBlock` — markdown fence stripping
+ *   - `planScript` — happy path, retry on compile failure, empty response
+ *
+ * Tests pass a `llmClient` override so the planner never hits the network.
+ */
+import { describe, it, expect } from 'vitest';
+import { promises as fs } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { extractCodeBlock, planScript, KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT, } from './scriptPlanner.js';
+function fakeClient(responses) {
+    const calls = [];
+    let i = 0;
+    const client = {
+        async complete({ system, user }) {
+            calls.push(user);
+            const out = responses[i] ?? responses[responses.length - 1] ?? '';
+            i += 1;
+            // Sanity: the system prompt should mention the SDK.
+            if (!system.includes('tentacle')) {
+                throw new Error('system prompt missing tentacle mention');
+            }
+            return out;
+        },
+    };
+    return { client, calls };
+}
+describe('extractCodeBlock', () => {
+    it('strips a ```ts fence', () => {
+        expect(extractCodeBlock('```ts\nconst x = 1;\n```', 'ts')).toBe('const x = 1;');
+    });
+    it('strips a ```typescript fence', () => {
+        expect(extractCodeBlock('```typescript\nconst x = 1;\n```', 'ts')).toBe('const x = 1;');
+    });
+    it('strips a ``` fence with no language', () => {
+        expect(extractCodeBlock('```\nconst x = 1;\n```', 'ts')).toBe('const x = 1;');
+    });
+    it('returns the original text if no fence is present', () => {
+        const src = 'const x = 1;';
+        expect(extractCodeBlock(src, 'ts')).toBe(src);
+    });
+    it('trims surrounding whitespace', () => {
+        expect(extractCodeBlock('  \n  const x = 1;\n  ', 'ts')).toBe('const x = 1;');
+    });
+});
+describe('KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT', () => {
+    it('mentions the SDK capabilities', () => {
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('tentacle');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('merge');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('while_');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('until');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('checkpoint');
+    });
+    it('warns against process / require / Buffer', () => {
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('process');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('require');
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toContain('Buffer');
+    });
+    it('says return ONLY code (no fence)', () => {
+        expect(KRAKEN_SCRIPT_PLANNER_SYSTEM_PROMPT).toMatch(/no markdown fence/i);
+    });
+});
+describe('planScript', () => {
+    it('writes a compilable plan to .zelari/kraken/runs/<graphId>/plan.ts', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'kraken-scriptplan-'));
+        const goodSource = `
+      import { tentacle, merge } from '@zelari/kraken-runtime';
+      const a = await tentacle({ kind: 'explore', label: 'map', prompt: 'x' });
+      await merge([a]);
+    `;
+        const { client, calls } = fakeClient([goodSource]);
+        const result = await planScript({
+            prompt: 'map the auth system',
+            graphId: 'g-happy',
+            cwd: tmp,
+            llmClient: client,
+        });
+        expect(result.compiled).toBe(true);
+        expect(result.attempts).toBe(1);
+        expect(result.source).toContain("import { tentacle");
+        expect(calls).toHaveLength(1);
+        // The file is on disk.
+        const written = await fs.readFile(result.planPath, 'utf8');
+        expect(written).toBe(goodSource.trim());
+        // Path is the expected one.
+        expect(result.planPath).toBe(path.join(tmp, '.zelari', 'kraken', 'runs', 'g-happy', 'plan.ts'));
+    });
+    it('retries on compile failure and succeeds on the second attempt', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'kraken-scriptplan-'));
+        // A real SYNTAX error: unbalanced brace. esbuild fails on parse.
+        const broken = `function oops( { return 1;`;
+        const good = `import { log } from '@zelari/kraken-runtime';\nlog('hello');`;
+        const { client, calls } = fakeClient([broken, good]);
+        const result = await planScript({
+            prompt: 'do a thing',
+            graphId: 'g-retry',
+            cwd: tmp,
+            llmClient: client,
+        });
+        expect(result.attempts).toBe(2);
+        expect(result.compiled).toBe(true);
+        expect(calls).toHaveLength(2);
+        // The corrective user message should mention the previous error.
+        expect(calls[1]).toMatch(/failed to compile/i);
+    });
+    it('throws after MAX_PLAN_ATTEMPTS on persistent compile failure', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'kraken-scriptplan-'));
+        const broken = `function oops( { return 1;`;
+        const { client } = fakeClient([broken, broken]);
+        await expect(planScript({
+            prompt: 'still broken',
+            graphId: 'g-fail',
+            cwd: tmp,
+            llmClient: client,
+        })).rejects.toThrowError(/failed to produce a compilable plan/);
+    });
+    it('retries on empty response and succeeds on the second attempt', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'kraken-scriptplan-'));
+        const good = `import { log } from '@zelari/kraken-runtime';\nlog('ok');`;
+        const { client } = fakeClient(['', good]);
+        const result = await planScript({
+            prompt: 'empty first',
+            graphId: 'g-empty',
+            cwd: tmp,
+            llmClient: client,
+        });
+        expect(result.attempts).toBe(2);
+        expect(result.compiled).toBe(true);
+    });
+    it('strips a ```ts fence from the LLM reply', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'kraken-scriptplan-'));
+        const fenced = '```ts\nimport { log } from \'@zelari/kraken-runtime\';\nlog(\'ok\');\n```';
+        const { client } = fakeClient([fenced]);
+        const result = await planScript({
+            prompt: 'fenced',
+            graphId: 'g-fence',
+            cwd: tmp,
+            llmClient: client,
+        });
+        expect(result.compiled).toBe(true);
+        expect(result.source.startsWith('import')).toBe(true);
+        expect(result.source).not.toContain('```');
+    });
+    it('rejects an empty prompt (Zod schema)', async () => {
+        await expect(planScript({ prompt: '', llmClient: fakeClient(['']).client })).rejects.toThrowError(/prompt|Too small/i);
+    });
+});
+//# sourceMappingURL=scriptPlanner.test.js.map

package/dist/cli/kraken/scriptPlanner.test.js.map

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

package/dist/cli/kraken/skillSuggest.js

@@ -0,0 +1,97 @@
+/**
+ * Kraken — skill auto-suggest (Gauntlet Loop step 8, Cross-cutting C1).
+ *
+ * After a converged graph, scan the run for patterns worth promoting to
+ * a reusable skill. Today the patterns are simple:
+ *
+ *   - A `verify`/`spec`/`conformance` reviewer returned FAIL with a
+ *     concrete, actionable gap, the next attempt fixed it. The (gap,
+ *     fix) pair is a candidate.
+ *   - A writer hit the same scope twice (rework round) and the second
+ *     attempt succeeded where the first failed.
+ *
+ * The suggestion is *offered, not applied*. The user accepts via the
+ * existing `/promote-skill <id>` command. We deliberately do not
+ * auto-promote: a converged run is not always a good run, and a
+ * suggestion the user can audit is much safer than a silent
+ * write-to-SKILL.md.
+ *
+ * The threshold is "did the same kind of review reject a writer and a
+ * later iteration accept the work?". The function below is pure: it
+ * takes a structured run summary and returns zero or more suggestions.
+ *
+ * @since Kraken v1.30.x — workflow script runtime (Cross-cutting C1)
+ */
+const MAX_FINDINGS_CHARS = 600;
+/** Produce a short, kebab-case id from a free-text label. */
+export function slugifyLabel(label) {
+    return label
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 40) || 'kraken-skill';
+}
+/** Compute skill suggestions from a finished run. Pure function. */
+export function suggestSkillsFromRun(result, opts = { graphId: 'g', goal: '' }) {
+    if (!result.converged)
+        return [];
+    const refs = [...result.tentacles.values()];
+    // 1. Pattern: a reviewer FAILed with concrete findings, and a later
+    //    pass produced a `done` with a similar scope/label. Heuristic: a
+    //    reviewer FAIL followed by a `fix` node that the executor resolved
+    //    (a rework round).
+    const reviewerFails = refs.filter((r) => (r.kind === 'verify' || r.kind === 'spec' || r.kind === 'conformance') && r.verdict === 'fail');
+    const fixNodes = refs.filter((r) => r.kind === 'fix' && r.status === 'done');
+    if (reviewerFails.length === 0 || fixNodes.length === 0)
+        return [];
+    // Pair the first reviewer FAIL with the first fix-node. One suggestion
+    // per run is the right cadence for v1; multi-suggestion can come later.
+    const fail = reviewerFails[0];
+    const fix = fixNodes[0];
+    const failureFindings = (fail.findings || '').slice(0, MAX_FINDINGS_CHARS);
+    const fixFindings = (fix.findings || '').slice(0, MAX_FINDINGS_CHARS);
+    const id = `kraken-skill-${slugifyLabel(fail.label)}-${opts.graphId}`;
+    // Confidence: stronger when the fix succeeded on a fresh attempt (no
+    // cascading errors), when the failure findings are concrete, and when
+    // the goal is non-empty.
+    let confidence = 0.4;
+    if (failureFindings.length > 60)
+        confidence += 0.2;
+    if (fixFindings.length > 60)
+        confidence += 0.2;
+    if (opts.goal.trim().length > 0)
+        confidence += 0.1;
+    if (result.tentacles.size > 1)
+        confidence += 0.1;
+    confidence = Math.min(1, confidence);
+    return [
+        {
+            id,
+            title: `Skill from "${fail.label}" (fixed on rework)`,
+            body: [
+                `The reviewer \`${fail.label}\` (${fail.kind}) FAILed with:`,
+                '',
+                '```',
+                failureFindings,
+                '```',
+                '',
+                `The follow-up \`${fix.label}\` fixed the issue.`,
+                '',
+                `Promote this to a skill with:`,
+                '```',
+                `/promote-skill ${id}`,
+                '```',
+                '',
+                `Confidence: ${(confidence * 100).toFixed(0)}%`,
+            ].join('\n'),
+            sourceKind: fail.kind,
+            failureFindings,
+            confidence,
+        },
+    ];
+}
+/** Render a single suggestion as a Markdown card for the transcript. */
+export function renderSuggestionCard(s) {
+    return s.body;
+}
+//# sourceMappingURL=skillSuggest.js.map

package/dist/cli/kraken/skillSuggest.js.map

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