@specship/specship-win32-arm64 0.25.0 → 0.28.0

package/lib/dist/spec-quality/readiness.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Spec readiness gate (PIPETRUST-DOC, REQ-PIPETRUST-004).
+ *
+ * Implement must not start on a spec that cannot be implemented to a
+ * verifiable result. A requirement is READY when its spec file lints without
+ * errors, it has at least one acceptance criterion, and no criterion still
+ * carries a `[needs review]` marker. A ready requirement also yields an
+ * EVIDENCE PLAN — one line per criterion with the evidence kind it requires
+ * (REQ-PIPETRUST-001) and a suggested named test function — which the
+ * implement workflows hand to their plan and implement steps so "untested"
+ * can never be planned in.
+ *
+ * Pure core (`assessReadiness`) over plain inputs, plus a thin loader
+ * (`assessReadinessFromIndex`) that reads them from a SpecShip index.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestedTestName = suggestedTestName;
+exports.assessReadiness = assessReadiness;
+exports.formatEvidencePlan = formatEvidencePlan;
+exports.assessReadinessFromIndex = assessReadinessFromIndex;
+exports.criteriaFromBlock = criteriaFromBlock;
+exports.assessReadinessFromFile = assessReadinessFromFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const lint_1 = require("../spec-lint/lint");
+const evidence_kind_1 = require("./evidence-kind");
+const postcheck_1 = require("./postcheck");
+/** UI source files — same rule the behaviour surface uses for Playwright targets. */
+const UI_FILE = /\.(tsx|jsx|vue|svelte|astro)$/i;
+const NEEDS_REVIEW = /\[needs review/i;
+/** Criterion bullet text as stored by the extractor (title, falling back to body). */
+function criterionText(c) {
+    return (c.title && c.title.trim()) || (c.body ?? '').trim();
+}
+/**
+ * Deterministic test-function name for a criterion id:
+ * `REQ-PIPETRUST-004.A1` → `reqPipetrust004A1`. Authors are expected to rename
+ * it to describe the behaviour; it exists so the plan names a real symbol.
+ */
+function suggestedTestName(criterionId) {
+    const parts = criterionId.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    return parts
+        .map((p, i) => {
+        const lower = p.toLowerCase();
+        return i === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join('');
+}
+function assessReadiness(input) {
+    const { requirementId, requirement, criteria, implementsLinks, lintFindings } = input;
+    const reasons = [];
+    if (!requirement) {
+        return { requirementId, ready: false, reasons: [`no spec with id ${requirementId}`], plan: [] };
+    }
+    const lintErrors = lintFindings.filter((f) => f.severity === 'error');
+    for (const f of lintErrors) {
+        reasons.push(`lint error ${f.code}${f.line ? ` (line ${f.line})` : ''}: ${f.message}`);
+    }
+    if (criteria.length === 0) {
+        reasons.push(`${requirementId} has no acceptance criteria`);
+    }
+    for (const c of criteria) {
+        if (NEEDS_REVIEW.test(criterionText(c)) || NEEDS_REVIEW.test(c.body ?? '')) {
+            reasons.push(`${c.id} still carries [needs review]`);
+        }
+    }
+    const linksUi = implementsLinks.some((l) => UI_FILE.test(l.targetFilePath));
+    const linksRoute = implementsLinks.some((l) => l.targetNodeKind === 'route');
+    const plan = criteria.map((c) => ({
+        criterionId: c.id,
+        text: criterionText(c),
+        kind: (0, evidence_kind_1.requiredEvidenceKind)(criterionText(c), { linksUi, linksRoute }),
+        testName: suggestedTestName(c.id),
+    }));
+    return { requirementId, ready: reasons.length === 0, reasons, plan };
+}
+/** Human / prompt-facing rendering. The READY marker is the machine contract. */
+function formatEvidencePlan(result) {
+    const lines = [];
+    if (result.ready) {
+        lines.push(`READY=yes ${result.requirementId}`);
+        lines.push('Evidence plan (criterion → required evidence kind → suggested test function):');
+        for (const p of result.plan) {
+            lines.push(`- ${p.criterionId} → ${p.kind} → ${p.testName}  — ${p.text}`);
+        }
+        lines.push('Write each test as a NAMED function passed to it(), put the criterion id in the it() title, ' +
+            'and list it under the requirement\'s `verifies:` block.');
+    }
+    else {
+        lines.push(`READY=no ${result.requirementId}`);
+        for (const r of result.reasons)
+            lines.push(`- ${r}`);
+    }
+    return lines.join('\n');
+}
+/** Load the inputs for `assessReadiness` from an index and the spec file on disk. */
+function assessReadinessFromIndex(sq, projectRoot, requirementId) {
+    const requirement = sq.getSpecById(requirementId);
+    if (!requirement) {
+        return assessReadiness({ requirementId, requirement: null, criteria: [], implementsLinks: [], lintFindings: [] });
+    }
+    const criteria = sq.getSpecsByParent(requirementId).filter((s) => s.kind === 'acceptance');
+    const implementsLinks = [requirementId, ...criteria.map((c) => c.id)]
+        .flatMap((id) => sq.getLinksBySpec(id))
+        .filter((l) => l.kind === 'implements');
+    let lintFindings = [];
+    const abs = path.isAbsolute(requirement.sourcePath)
+        ? requirement.sourcePath
+        : path.join(projectRoot, requirement.sourcePath);
+    try {
+        lintFindings = (0, lint_1.lintSpecSource)(requirement.sourcePath, fs.readFileSync(abs, 'utf-8'));
+    }
+    catch (err) {
+        lintFindings = [
+            {
+                code: 'lint_unreadable_file',
+                severity: 'error',
+                filePath: requirement.sourcePath,
+                message: `Could not read: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ];
+    }
+    // Only findings about THIS requirement (or file-level ones) gate it — a
+    // sibling requirement's lint error must not block an unrelated implement.
+    const ownIds = new Set([requirementId, ...criteria.map((c) => c.id)]);
+    lintFindings = lintFindings.filter((f) => !f.specId || ownIds.has(f.specId));
+    return assessReadiness({ requirementId, requirement, criteria, implementsLinks, lintFindings });
+}
+const ID_MARKER = /^<!--\s*id:\s*([A-Za-z0-9._-]+)\s*-->\s*$/;
+/** Acceptance bullets (id → text) read straight from a requirement block. */
+function criteriaFromBlock(block, requirementId) {
+    const lines = block.split(/\r?\n/);
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = (lines[i] ?? '').match(ID_MARKER);
+        if (!m || !m[1].startsWith(`${requirementId}.A`))
+            continue;
+        const text = [];
+        for (let j = i + 1; j < lines.length; j++) {
+            const line = lines[j] ?? '';
+            if (ID_MARKER.test(line) || /^#{1,6}\s/.test(line) || (line.trim() === '' && text.length > 0))
+                break;
+            if (line.trim() === '')
+                continue;
+            text.push(line.replace(/^\s*-\s+/, '').trim());
+        }
+        out.push({ id: m[1], text: text.join(' ') });
+    }
+    return out;
+}
+/**
+ * File-based readiness: works without a SpecShip index (a workflow worktree
+ * has none — and a CLI with no project index must never walk up to $HOME).
+ * UI linkage comes from the `implementations:` bullets' file extensions;
+ * route linkage needs the index, so it is only known when `routeTargets`
+ * is supplied by an index-backed caller.
+ */
+function assessReadinessFromFile(projectRoot, requirementId, routeTargets = new Set()) {
+    const specFile = (0, postcheck_1.findSpecFile)(projectRoot, requirementId);
+    const source = specFile ? fs.readFileSync(specFile, 'utf-8') : null;
+    const block = source ? (0, postcheck_1.requirementBlock)(source, requirementId) : null;
+    if (!specFile || !source || !block) {
+        return assessReadiness({ requirementId, requirement: null, criteria: [], implementsLinks: [], lintFindings: [] });
+    }
+    const rel = path.relative(projectRoot, specFile);
+    const now = Date.now();
+    const asSpec = (id, title, kind) => ({
+        id, kind, title, body: title, format: 'markdown', sourcePath: rel, contentHash: '', createdAt: now, updatedAt: now,
+    });
+    const criteria = criteriaFromBlock(block, requirementId).map((c) => asSpec(c.id, c.text, 'acceptance'));
+    const implementsLinks = (0, postcheck_1.linkBullets)(block, 'implementations').map((b) => {
+        const idx = b.lastIndexOf(':');
+        const file = idx > 0 ? b.slice(0, idx) : b;
+        const symbol = idx > 0 ? b.slice(idx + 1) : '';
+        return {
+            targetFilePath: file,
+            targetQualifiedName: symbol,
+            targetNodeKind: routeTargets.has(`${file}:${symbol}`) ? 'route' : 'function',
+            kind: 'implements',
+        };
+    });
+    const ownIds = new Set([requirementId, ...criteria.map((c) => c.id)]);
+    const lintFindings = (0, lint_1.lintSpecSource)(rel, source).filter((f) => !f.specId || ownIds.has(f.specId));
+    return assessReadiness({
+        requirementId,
+        requirement: asSpec(requirementId, requirementId, 'requirement'),
+        criteria,
+        implementsLinks,
+        lintFindings,
+    });
+}
+//# sourceMappingURL=readiness.js.map

package/lib/dist/spec-quality/readiness.js.map

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

package/lib/dist/workflows/agents/claude.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Claude Code headless adapter (REQ-AGENTADAPT-005): `claude --print` with
+ * stream-json output. The argument list is exactly what the prompt runner
+ * built before adapters existed (REQ-AGENTADAPT-005.A1).
+ */
+import type { PromptNode } from '../schemas/workflow';
+import { EmitFn, HeadlessAgent, StreamParseState } from './types';
+export declare function buildClaudeArgs(node: PromptNode): string[];
+/**
+ * Parse one stream-json line, emit any activity events, and fold the result
+ * into `state`. Pure aside from the `emit` callback. Unknown / non-JSON lines
+ * are ignored. Extended-thinking blocks are intentionally NOT emitted.
+ */
+export declare function handleClaudeStreamLine(line: string, emit: EmitFn, state: StreamParseState): void;
+export declare const claudeHeadlessAgent: HeadlessAgent;
+//# sourceMappingURL=claude.d.ts.map

package/lib/dist/workflows/agents/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/workflows/agents/claude.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAsB,gBAAgB,EAAqC,MAAM,SAAS,CAAC;AAEzH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAkB1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CA4BhG;AAED,eAAO,MAAM,mBAAmB,EAAE,aAQjC,CAAC"}

package/lib/dist/workflows/agents/claude.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Claude Code headless adapter (REQ-AGENTADAPT-005): `claude --print` with
+ * stream-json output. The argument list is exactly what the prompt runner
+ * built before adapters existed (REQ-AGENTADAPT-005.A1).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeHeadlessAgent = void 0;
+exports.buildClaudeArgs = buildClaudeArgs;
+exports.handleClaudeStreamLine = handleClaudeStreamLine;
+const types_1 = require("./types");
+function buildClaudeArgs(node) {
+    const args = [];
+    args.push('--print');
+    // Stream the agent's activity as JSONL so we can surface tool calls and
+    // messages live. `--print` + `--output-format stream-json` requires
+    // `--verbose` (the CLI rejects the combination otherwise).
+    args.push('--output-format', 'stream-json', '--verbose');
+    if (node.model)
+        args.push('--model', node.model);
+    if (node.allowed_tools && node.allowed_tools.length > 0) {
+        args.push('--allowed-tools', node.allowed_tools.join(','));
+    }
+    if (node.denied_tools && node.denied_tools.length > 0) {
+        args.push('--disallowed-tools', node.denied_tools.join(','));
+    }
+    if (node.systemPromptAppend) {
+        args.push('--append-system-prompt', node.systemPromptAppend);
+    }
+    return args;
+}
+/**
+ * Parse one stream-json line, emit any activity events, and fold the result
+ * into `state`. Pure aside from the `emit` callback. Unknown / non-JSON lines
+ * are ignored. Extended-thinking blocks are intentionally NOT emitted.
+ */
+function handleClaudeStreamLine(line, emit, state) {
+    const e = (0, types_1.parseJsonLine)(line);
+    if (!e)
+        return;
+    if (e.type === 'assistant' && e.message && typeof e.message === 'object') {
+        state.sawStream = true;
+        const content = e.message.content;
+        if (Array.isArray(content)) {
+            for (const raw of content) {
+                const b = raw;
+                if (b?.type === 'tool_use') {
+                    emit('tool_called', { name: b.name, input: (0, types_1.summarizeToolInput)(b.input) });
+                }
+                else if (b?.type === 'text' && typeof b.text === 'string' && b.text.trim()) {
+                    state.assistantText += (state.assistantText ? '\n' : '') + b.text;
+                    emit('agent_message', { text: b.text });
+                }
+                // 'thinking' blocks: deliberately skipped.
+            }
+        }
+    }
+    else if (e.type === 'result') {
+        state.sawStream = true;
+        if (typeof e.result === 'string')
+            state.resultText = e.result;
+        if (typeof e.total_cost_usd === 'number')
+            state.costUsd = e.total_cost_usd;
+        if (typeof e.duration_ms === 'number')
+            state.durationMs = e.duration_ms;
+    }
+    else if (e.type === 'system') {
+        state.sawStream = true; // init/system frame — confirms we're on the stream path
+        if (typeof e.model === 'string' && e.model)
+            state.model = e.model;
+    }
+}
+exports.claudeHeadlessAgent = {
+    id: 'claude',
+    // Claude Code sets CLAUDECODE=1 in the environment of the commands it runs.
+    launchedFrom: (env) => env.CLAUDECODE === '1',
+    build(node, _config, env) {
+        return { bin: env.SPECSHIP_CLAUDE_BIN ?? 'claude', args: buildClaudeArgs(node), stdin: node.prompt };
+    },
+    handleLine: handleClaudeStreamLine,
+};
+//# sourceMappingURL=claude.js.map

package/lib/dist/workflows/agents/claude.js.map

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

package/lib/dist/workflows/agents/gemini.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Gemini CLI headless adapter (REQ-AGENTADAPT-007), against the installed
+ * 0.28.0 source (DOM-SPECSHIP-008): piped stdin runs Gemini headless, and in
+ * that mode every approval-needing tool not in `--allowed-tools` is removed,
+ * so each step's tools are translated to Gemini's names. There is no deny or
+ * append-system-prompt flag: `denied_tools` is refused, and the appended
+ * system prompt leads the stdin prompt.
+ */
+import { EmitFn, HeadlessAgent, StreamParseState } from './types';
+/** Translate a step's allowed tools, or name the first one with no Gemini equivalent. */
+export declare function translateGeminiTools(tools: string[]): {
+    tools: string[];
+} | {
+    error: string;
+};
+/** The Gemini model for a step: a mapped tier alias, a Gemini id as-is, else none (Gemini's default). */
+export declare function geminiModelFor(model: string | undefined, models: Record<string, string> | undefined): string | undefined;
+/** Parse one Gemini stream-json event (init / message / tool_use / error / result). */
+export declare function handleGeminiStreamLine(line: string, emit: EmitFn, state: StreamParseState): void;
+export declare const geminiHeadlessAgent: HeadlessAgent;
+//# sourceMappingURL=gemini.d.ts.map

package/lib/dist/workflows/agents/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/workflows/agents/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAsB,gBAAgB,EAAqC,MAAM,SAAS,CAAC;AAiBzH,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAa7F;AAED,yGAAyG;AACzG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIxH;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAmChG;AAED,eAAO,MAAM,mBAAmB,EAAE,aAsBjC,CAAC"}

package/lib/dist/workflows/agents/gemini.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Gemini CLI headless adapter (REQ-AGENTADAPT-007), against the installed
+ * 0.28.0 source (DOM-SPECSHIP-008): piped stdin runs Gemini headless, and in
+ * that mode every approval-needing tool not in `--allowed-tools` is removed,
+ * so each step's tools are translated to Gemini's names. There is no deny or
+ * append-system-prompt flag: `denied_tools` is refused, and the appended
+ * system prompt leads the stdin prompt.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.geminiHeadlessAgent = void 0;
+exports.translateGeminiTools = translateGeminiTools;
+exports.geminiModelFor = geminiModelFor;
+exports.handleGeminiStreamLine = handleGeminiStreamLine;
+const types_1 = require("./types");
+/** Claude-form built-in tool names → Gemini CLI 0.28 tool names. */
+const BUILTIN_TOOLS = {
+    Read: 'read_file',
+    Write: 'write_file',
+    Edit: 'replace',
+    MultiEdit: 'replace',
+    Bash: 'run_shell_command',
+    Glob: 'glob',
+    Grep: 'grep_search',
+    LS: 'list_directory',
+    WebFetch: 'web_fetch',
+    WebSearch: 'google_web_search',
+};
+const MODEL_TIERS = new Set(['haiku', 'sonnet', 'opus']);
+/** Translate a step's allowed tools, or name the first one with no Gemini equivalent. */
+function translateGeminiTools(tools) {
+    const out = [];
+    for (const tool of tools) {
+        let mapped;
+        const mcp = tool.match(/^mcp__([A-Za-z0-9_-]+?)__(.+)$/);
+        const shell = tool.match(/^Bash\((.+?)(?::\*)?\)$/);
+        if (mcp)
+            mapped = `${mcp[1]}__${mcp[2]}`;
+        else if (shell)
+            mapped = `run_shell_command(${shell[1].trim()})`;
+        else
+            mapped = BUILTIN_TOOLS[tool];
+        if (!mapped)
+            return { error: `allowed tool "${tool}" has no Gemini CLI equivalent` };
+        if (!out.includes(mapped))
+            out.push(mapped);
+    }
+    return { tools: out };
+}
+/** The Gemini model for a step: a mapped tier alias, a Gemini id as-is, else none (Gemini's default). */
+function geminiModelFor(model, models) {
+    if (!model)
+        return undefined;
+    if (MODEL_TIERS.has(model))
+        return models?.[model];
+    return /^gemini/i.test(model) ? model : undefined; // a Claude id is never passed to Gemini
+}
+/** Parse one Gemini stream-json event (init / message / tool_use / error / result). */
+function handleGeminiStreamLine(line, emit, state) {
+    const e = (0, types_1.parseJsonLine)(line);
+    if (!e)
+        return;
+    switch (e.type) {
+        case 'init':
+            state.sawStream = true;
+            if (typeof e.model === 'string' && e.model)
+                state.model = e.model;
+            break;
+        case 'message':
+            state.sawStream = true;
+            if (e.role === 'assistant' && typeof e.content === 'string' && e.content) {
+                // Deltas are fragments of one turn; whole messages are separate turns.
+                state.assistantText += e.delta === true || !state.assistantText ? e.content : `\n${e.content}`;
+                emit('agent_message', { text: e.content });
+            }
+            break;
+        case 'tool_use':
+            state.sawStream = true;
+            emit('tool_called', { name: e.tool_name, input: (0, types_1.summarizeToolInput)(e.parameters) });
+            break;
+        case 'result': {
+            state.sawStream = true;
+            const stats = e.stats;
+            if (stats && typeof stats.duration_ms === 'number')
+                state.durationMs = stats.duration_ms;
+            if (e.status === 'error') {
+                const err = e.error;
+                state.failure = typeof err?.message === 'string' ? err.message : 'Gemini CLI reported an error result';
+            }
+            break;
+        }
+        case 'error':
+            state.sawStream = true;
+            if (e.severity === 'error' && typeof e.message === 'string')
+                state.failure = e.message;
+            break;
+    }
+}
+exports.geminiHeadlessAgent = {
+    id: 'gemini',
+    // Gemini CLI sets GEMINI_CLI=1 for the shell commands it runs.
+    launchedFrom: (env) => env.GEMINI_CLI === '1',
+    build(node, config, env) {
+        if (node.denied_tools && node.denied_tools.length > 0) {
+            return { error: `denied_tools (${node.denied_tools.join(', ')}) cannot be enforced on Gemini CLI — it has no deny flag` };
+        }
+        const args = ['--output-format', 'stream-json'];
+        const model = geminiModelFor(node.model, config.models);
+        if (model)
+            args.push('--model', model);
+        if (node.allowed_tools && node.allowed_tools.length > 0) {
+            const t = translateGeminiTools(node.allowed_tools);
+            if ('error' in t)
+                return t;
+            args.push('--allowed-tools', ...t.tools);
+        }
+        const stdin = node.systemPromptAppend
+            ? `${node.systemPromptAppend.trimEnd()}\n\n---\n\n${node.prompt}`
+            : node.prompt;
+        return { bin: env.SPECSHIP_GEMINI_BIN ?? 'gemini', args, stdin };
+    },
+    handleLine: handleGeminiStreamLine,
+};
+//# sourceMappingURL=gemini.js.map

package/lib/dist/workflows/agents/gemini.js.map

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

package/lib/dist/workflows/agents/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Headless-agent registry and selection (REQ-AGENTADAPT-005/006).
+ *
+ * The agent is resolved once at run start — `--agent`, then
+ * `SPECSHIP_WORKFLOW_AGENT`, then `workflow.agent` in specship.config.json,
+ * then the coding agent that launched the command, then Claude Code — and is
+ * stored on the run so approve / revise / resume use the same one.
+ */
+import type { HeadlessAgent, HeadlessAgentConfig } from './types';
+export type { HeadlessAgent, HeadlessAgentConfig, HeadlessInvocation, StreamParseState } from './types';
+export declare const DEFAULT_WORKFLOW_AGENT: string;
+/** Run-metadata key the chosen agent is stored under. */
+export declare const RUN_AGENT_KEY = "agent";
+export declare function knownWorkflowAgents(): string[];
+export declare function getHeadlessAgent(id: string): HeadlessAgent | undefined;
+export declare class UnknownWorkflowAgentError extends Error {
+    constructor(name: string, source: string);
+}
+export interface ResolveAgentOptions {
+    flag?: string;
+    env?: NodeJS.ProcessEnv;
+    projectRoot: string;
+}
+/** The agent id for a new run, or throws UnknownWorkflowAgentError (REQ-AGENTADAPT-006.A4). */
+export declare function resolveWorkflowAgent(opts: ResolveAgentOptions): string;
+/** `workflow.agents.<id>` settings (model tier mapping), {} when unset. */
+export declare function workflowAgentConfig(projectRoot: string, id: string): HeadlessAgentConfig;
+//# sourceMappingURL=index.d.ts.map

package/lib/dist/workflows/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflows/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAElE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGxG,eAAO,MAAM,sBAAsB,QAAyB,CAAC;AAC7D,yDAAyD;AACzD,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEtE;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIzC;AAgBD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAgBtE;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAGxF"}

package/lib/dist/workflows/agents/index.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Headless-agent registry and selection (REQ-AGENTADAPT-005/006).
+ *
+ * The agent is resolved once at run start — `--agent`, then
+ * `SPECSHIP_WORKFLOW_AGENT`, then `workflow.agent` in specship.config.json,
+ * then the coding agent that launched the command, then Claude Code — and is
+ * stored on the run so approve / revise / resume use the same one.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownWorkflowAgentError = exports.RUN_AGENT_KEY = exports.DEFAULT_WORKFLOW_AGENT = void 0;
+exports.knownWorkflowAgents = knownWorkflowAgents;
+exports.getHeadlessAgent = getHeadlessAgent;
+exports.resolveWorkflowAgent = resolveWorkflowAgent;
+exports.workflowAgentConfig = workflowAgentConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const claude_1 = require("./claude");
+const gemini_1 = require("./gemini");
+const AGENTS = [claude_1.claudeHeadlessAgent, gemini_1.geminiHeadlessAgent];
+exports.DEFAULT_WORKFLOW_AGENT = claude_1.claudeHeadlessAgent.id;
+/** Run-metadata key the chosen agent is stored under. */
+exports.RUN_AGENT_KEY = 'agent';
+function knownWorkflowAgents() {
+    return AGENTS.map((a) => a.id);
+}
+function getHeadlessAgent(id) {
+    return AGENTS.find((a) => a.id === id);
+}
+class UnknownWorkflowAgentError extends Error {
+    constructor(name, source) {
+        super(`Unknown workflow agent "${name}" (from ${source}). Known agents: ${knownWorkflowAgents().join(', ')}`);
+        this.name = 'UnknownWorkflowAgentError';
+    }
+}
+exports.UnknownWorkflowAgentError = UnknownWorkflowAgentError;
+function readWorkflowConfig(projectRoot) {
+    try {
+        const cfg = JSON.parse(fs.readFileSync(path.join(projectRoot, 'specship.config.json'), 'utf8'));
+        return (cfg && typeof cfg.workflow === 'object' && cfg.workflow) || {};
+    }
+    catch {
+        return {};
+    }
+}
+/** The agent id for a new run, or throws UnknownWorkflowAgentError (REQ-AGENTADAPT-006.A4). */
+function resolveWorkflowAgent(opts) {
+    const env = opts.env ?? process.env;
+    const cfg = readWorkflowConfig(opts.projectRoot);
+    const explicit = [
+        [opts.flag, '--agent'],
+        [env.SPECSHIP_WORKFLOW_AGENT, 'SPECSHIP_WORKFLOW_AGENT'],
+        [cfg.agent, 'workflow.agent in specship.config.json'],
+    ];
+    for (const [value, source] of explicit) {
+        if (typeof value !== 'string' || !value.trim())
+            continue;
+        const id = value.trim().toLowerCase();
+        if (!getHeadlessAgent(id))
+            throw new UnknownWorkflowAgentError(value, source);
+        return id;
+    }
+    const launcher = AGENTS.find((a) => a.id !== exports.DEFAULT_WORKFLOW_AGENT && a.launchedFrom(env));
+    return launcher?.id ?? exports.DEFAULT_WORKFLOW_AGENT;
+}
+/** `workflow.agents.<id>` settings (model tier mapping), {} when unset. */
+function workflowAgentConfig(projectRoot, id) {
+    const entry = readWorkflowConfig(projectRoot).agents?.[id];
+    return entry && typeof entry === 'object' ? entry : {};
+}
+//# sourceMappingURL=index.js.map