@mknightzzz/stw 0.1.0

package/dist/run.js

@@ -0,0 +1,150 @@
+import { execFileSync } from 'node:child_process';
+import { randomInt } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from './config.js';
+import { generateAssignments } from './assignments.js';
+import { generatePlan } from './planner.js';
+import { buildRunRecoveryReport, readTaskStatus, writeRunState } from './status.js';
+import { ensureDir, fileExists, readJson, writeAtomic, writeJson } from './storage.js';
+export function generateRunId(now = new Date()) {
+    const date = now.toISOString().slice(0, 10).replace(/-/g, '_');
+    const sequence = String(randomInt(100, 1000));
+    return `run_${date}_${sequence}`;
+}
+export function createRun(options) {
+    const runId = getUniqueRunId(options.stwRoot);
+    const runPath = join(options.stwRoot, 'runs', runId);
+    ensureDir(runPath);
+    ensureDir(join(runPath, 'tasks'));
+    const manifest = {
+        schema_version: 1,
+        run_id: runId,
+        spec_path: options.specPath,
+        repo_root: options.repoRoot,
+        base_branch: options.baseBranch,
+        branch: `${options.branchPrefix}${runId.replace(/_/g, '-')}`,
+        status: 'pending',
+        pr_number: null,
+        created_at: new Date().toISOString(),
+        ...(options.greenfield !== undefined && { greenfield: options.greenfield }),
+        ...(options.seedDir && { seedDir: options.seedDir }),
+    };
+    writeJson(join(runPath, 'manifest.json'), manifest);
+    writeAtomic(join(options.stwRoot, 'ACTIVE_RUN'), runId);
+    // Create the run branch from current HEAD (non-fatal if not in a git repo)
+    try {
+        execFileSync('git', ['branch', manifest.branch, 'HEAD'], {
+            cwd: options.repoRoot,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        });
+    }
+    catch {
+        // Branch creation may fail if not in a git repo or branch already exists
+    }
+    return manifest;
+}
+export async function replanRun(options) {
+    const manifestPath = join(options.stwRoot, 'runs', options.runId, 'manifest.json');
+    const manifest = readJson(manifestPath);
+    validateRunCanBeReplanned(manifest.status);
+    const config = loadConfig(join(options.stwRoot, 'config.yml'));
+    const specPath = resolve(manifest.repo_root, manifest.spec_path);
+    const spec = readFileSync(specPath, 'utf-8');
+    const previousGraph = readExistingTaskGraph(options.stwRoot, options.runId);
+    const completedStatuses = collectCompletedTaskStatuses(options.stwRoot, options.runId, previousGraph);
+    const completedTaskIds = completedStatuses.map((entry) => entry.task.id);
+    const completedTaskContext = completedStatuses.map(({ task, status }) => ({
+        task_id: task.id,
+        description: task.description,
+        status: status.status,
+        notes: status.notes,
+    }));
+    const plannerResult = await generatePlan({
+        spec,
+        repoRoot: manifest.repo_root,
+        config,
+        runId: options.runId,
+        completedTasks: completedTaskContext,
+    });
+    const mergedGraph = mergeCompletedTasksIntoGraph(plannerResult.task_graph, completedStatuses);
+    writeJson(join(options.stwRoot, 'runs', options.runId, 'task_graph.json'), mergedGraph);
+    const agents = options.agents ?? getDefaultAgents();
+    const assignmentResult = generateAssignments(mergedGraph, agents, config);
+    writeJson(join(options.stwRoot, 'runs', options.runId, 'assignments.json'), assignmentResult.assignments);
+    const updatedManifest = setRunStateToPending(options.stwRoot, options.runId, manifest.status);
+    return {
+        manifest: updatedManifest,
+        taskGraph: mergedGraph,
+        completedTaskIds,
+    };
+}
+function getUniqueRunId(stwRoot) {
+    const MAX_RETRIES = 20;
+    for (let i = 0; i < MAX_RETRIES; i++) {
+        const runId = generateRunId();
+        if (!fileExists(join(stwRoot, 'runs', runId))) {
+            return runId;
+        }
+    }
+    throw new Error(`Failed to generate unique run ID after ${MAX_RETRIES} attempts`);
+}
+function validateRunCanBeReplanned(status) {
+    if (status === 'running') {
+        throw new Error('Cannot replan a run while it is running');
+    }
+    if (status === 'complete' || status === 'failed' || status === 'stopped') {
+        throw new Error(`Cannot replan a run in terminal state: ${status}`);
+    }
+}
+function readExistingTaskGraph(stwRoot, runId) {
+    const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+    if (!fileExists(graphPath)) {
+        throw new Error(`No task graph found for run ${runId}`);
+    }
+    return readJson(graphPath);
+}
+function collectCompletedTaskStatuses(stwRoot, runId, graph) {
+    return graph.tasks
+        .map((task) => ({ task, status: readTaskStatus(stwRoot, runId, task.id) }))
+        .filter((entry) => entry.status?.status === 'complete');
+}
+function mergeCompletedTasksIntoGraph(replannedGraph, completedTasks) {
+    const completedById = new Map(completedTasks.map((entry) => [entry.task.id, entry.task]));
+    const remainingTasks = replannedGraph.tasks.filter((task) => !completedById.has(task.id));
+    const mergedTasks = [...completedTasks.map((entry) => entry.task), ...remainingTasks];
+    return {
+        ...replannedGraph,
+        tasks: mergedTasks,
+    };
+}
+function setRunStateToPending(stwRoot, runId, currentStatus) {
+    if (currentStatus === 'pending') {
+        const manifestPath = join(stwRoot, 'runs', runId, 'manifest.json');
+        return readJson(manifestPath);
+    }
+    try {
+        return writeRunState(stwRoot, runId, 'pending');
+    }
+    catch {
+        const manifestPath = join(stwRoot, 'runs', runId, 'manifest.json');
+        const manifest = readJson(manifestPath);
+        manifest.status = 'pending';
+        writeJson(manifestPath, manifest);
+        return manifest;
+    }
+}
+function getDefaultAgents() {
+    return [
+        { agent_id: 'agent-strong-1', tool: 'claude-code', model: 'opus-4.6', tier: 'strong' },
+        { agent_id: 'agent-medium-1', tool: 'opencode', model: 'gpt-5.4', tier: 'medium' },
+        { agent_id: 'agent-cheap-1', tool: 'opencode', model: 'minimax-2.5', tier: 'cheap' },
+    ];
+}
+export function getRunRecoveryReport(stwRoot, runId) {
+    const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+    const taskIds = fileExists(graphPath) ? readJson(graphPath).tasks.map((task) => task.id) : [];
+    return buildRunRecoveryReport(stwRoot, runId, taskIds);
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/scope-expansion.d.ts

@@ -0,0 +1,10 @@
+import type { ImportGraph } from './planner-prompt.js';
+import type { TaskGraph } from './types.js';
+export interface ScopeExpansionResult {
+    expanded: Map<string, string[]>;
+    warnings: string[];
+}
+export declare function expandScopesFromImportGraph(graph: TaskGraph, importGraph: ImportGraph, options?: {
+    maxExpansionPerTask?: number;
+    maxScopeFilesPerTask?: number;
+}): ScopeExpansionResult;

package/dist/scope-expansion.js

@@ -0,0 +1,117 @@
+import { isTestFile } from './planner-prompt.js';
+import { isSerialized } from './plan-validation.js';
+export function expandScopesFromImportGraph(graph, importGraph, options) {
+    const maxExpansion = options?.maxExpansionPerTask ?? 3;
+    const maxScope = options?.maxScopeFilesPerTask ?? 8;
+    const expanded = new Map();
+    const warnings = [];
+    // Build reverse index: imported file -> list of importers
+    const reverseIndex = new Map();
+    for (const edge of importGraph.resolvedEdges) {
+        if (!edge.resolved)
+            continue;
+        const importers = reverseIndex.get(edge.resolved) ?? [];
+        if (!importers.includes(edge.importer)) {
+            importers.push(edge.importer);
+        }
+        reverseIndex.set(edge.resolved, importers);
+    }
+    const taskById = new Map(graph.tasks.map((t) => [t.id, t]));
+    const dependencyCache = new Map();
+    // Build map of file -> tasks that own it (for overlap detection)
+    const fileOwnership = new Map();
+    for (const task of graph.tasks) {
+        for (const file of task.scope.files) {
+            const owners = fileOwnership.get(file) ?? [];
+            owners.push(task.id);
+            fileOwnership.set(file, owners);
+        }
+    }
+    // Track files claimed by expansion across tasks (for parallel dedup)
+    const expansionClaims = new Map();
+    // First pass: compute candidate expansions per task with relevance scores
+    const candidatesPerTask = new Map();
+    for (const task of graph.tasks) {
+        const currentScope = new Set(task.scope.files);
+        const candidateScores = new Map();
+        for (const scopeFile of task.scope.files) {
+            const importers = reverseIndex.get(scopeFile) ?? [];
+            for (const importer of importers) {
+                if (currentScope.has(importer))
+                    continue;
+                if (isTestFile(importer))
+                    continue;
+                candidateScores.set(importer, (candidateScores.get(importer) ?? 0) + 1);
+            }
+        }
+        const ranked = [...candidateScores.entries()]
+            .map(([file, relevance]) => ({ file, relevance }))
+            .sort((a, b) => b.relevance - a.relevance || a.file.localeCompare(b.file));
+        candidatesPerTask.set(task.id, ranked);
+    }
+    // Second pass: deduplicate across parallel tasks
+    for (const task of graph.tasks) {
+        const candidates = candidatesPerTask.get(task.id) ?? [];
+        const added = [];
+        for (const candidate of candidates) {
+            if (added.length >= maxExpansion)
+                break;
+            if (task.scope.files.length + added.length >= maxScope) {
+                warnings.push(`${task.id}: skipped expanding ${candidate.file} (would exceed ${String(maxScope)}-file scope cap)`);
+                continue;
+            }
+            // Check if file is in a parallel task's scope
+            const owners = fileOwnership.get(candidate.file) ?? [];
+            const inParallelScope = owners.some((ownerId) => {
+                if (ownerId === task.id)
+                    return false;
+                const ownerTask = taskById.get(ownerId);
+                if (ownerTask?.scope.allow_shared_files)
+                    return false;
+                return !isSerialized(task.id, ownerId, taskById, dependencyCache);
+            });
+            if (inParallelScope)
+                continue;
+            // Deduplicate: if another parallel task also wants this file, pick the higher relevance
+            const existingClaim = expansionClaims.get(candidate.file);
+            if (existingClaim) {
+                const claimantParallel = !isSerialized(task.id, existingClaim.taskId, taskById, dependencyCache);
+                if (claimantParallel) {
+                    if (candidate.relevance > existingClaim.relevance ||
+                        (candidate.relevance === existingClaim.relevance && task.id < existingClaim.taskId)) {
+                        // This task wins — remove from previous claimant
+                        const prevAdded = expanded.get(existingClaim.taskId);
+                        if (prevAdded) {
+                            const idx = prevAdded.indexOf(candidate.file);
+                            if (idx !== -1) {
+                                prevAdded.splice(idx, 1);
+                                const prevTask = taskById.get(existingClaim.taskId);
+                                if (prevTask) {
+                                    const scopeIdx = prevTask.scope.files.indexOf(candidate.file);
+                                    if (scopeIdx !== -1)
+                                        prevTask.scope.files.splice(scopeIdx, 1);
+                                }
+                            }
+                        }
+                        warnings.push(`${existingClaim.taskId}: expansion of ${candidate.file} reassigned to ${task.id} (higher relevance)`);
+                        expansionClaims.set(candidate.file, { taskId: task.id, relevance: candidate.relevance });
+                    }
+                    else {
+                        warnings.push(`${task.id}: skipped expanding ${candidate.file} (already claimed by ${existingClaim.taskId})`);
+                        continue;
+                    }
+                }
+            }
+            else {
+                expansionClaims.set(candidate.file, { taskId: task.id, relevance: candidate.relevance });
+            }
+            added.push(candidate.file);
+            task.scope.files.push(candidate.file);
+        }
+        if (added.length > 0) {
+            expanded.set(task.id, added);
+        }
+    }
+    return { expanded, warnings };
+}
+//# sourceMappingURL=scope-expansion.js.map

package/dist/scope-expansion.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,4 @@
+import type { Task } from './types.js';
+export declare function expandScope(task: Task): string[];
+export declare function isAllowedScopeFile(scopeFiles: string[], candidatePath: string): boolean;
+export declare function toRelativePath(filePath: string): string;

package/dist/scope.js

@@ -0,0 +1,37 @@
+import { normalize } from 'node:path';
+const TEST_COMMAND_PATTERNS = /\b(vitest|jest|pytest|go\s+test|cargo\s+test)\b/;
+export function expandScope(task) {
+    const base = [...task.scope.files, ...(task.scope.new_files ?? [])];
+    const hasTestCommand = task.acceptance_checks.some((check) => TEST_COMMAND_PATTERNS.test(check));
+    if (!hasTestCommand) {
+        return base;
+    }
+    const expanded = new Set(base.map((f) => toRelativePath(f)));
+    for (const file of base) {
+        const rel = toRelativePath(file);
+        // Extract the base filename without extension and its directory prefix
+        // e.g. "src/utils/foo.ts" -> stem="foo", ext=".ts"
+        const lastSlash = rel.lastIndexOf('/');
+        const filename = lastSlash >= 0 ? rel.slice(lastSlash + 1) : rel;
+        const dotIndex = filename.lastIndexOf('.');
+        if (dotIndex <= 0)
+            continue;
+        const stem = filename.slice(0, dotIndex);
+        const ext = filename.slice(dotIndex);
+        // Generate test file counterparts
+        expanded.add(`tests/${stem}.test${ext}`);
+        expanded.add(`test/${stem}.test${ext}`);
+        expanded.add(`__tests__/${stem}.test${ext}`);
+        // Python convention: test_<stem>
+        expanded.add(`tests/test_${stem}${ext}`);
+    }
+    return [...expanded];
+}
+export function isAllowedScopeFile(scopeFiles, candidatePath) {
+    const allowed = new Set(scopeFiles.map((file) => toRelativePath(file)));
+    return allowed.has(candidatePath);
+}
+export function toRelativePath(filePath) {
+    return normalize(filePath).replace(/^\.\//, '');
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,qBAAqB,GAAG,iDAAiD,CAAC;AAEhF,MAAM,UAAU,WAAW,CAAC,IAAU;IACpC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACjG,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QACjC,uEAAuE;QACvE,mDAAmD;QACnD,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,QAAQ,IAAI,CAAC;YAAE,SAAS;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAErC,kCAAkC;QAClC,QAAQ,CAAC,GAAG,CAAC,SAAS,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAC;QACzC,QAAQ,CAAC,GAAG,CAAC,QAAQ,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC,aAAa,IAAI,QAAQ,GAAG,EAAE,CAAC,CAAC;QAC7C,iCAAiC;QACjC,QAAQ,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAoB,EAAE,aAAqB;IAC5E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/scorecard.d.ts

@@ -0,0 +1,18 @@
+export interface RunScorecard {
+    schema_version: 1;
+    run_id: string;
+    worker_cost_usd: number;
+    planner_cost_usd: number;
+    total_tasks: number;
+    auto_completed: number;
+    escalated: number;
+    rescued: number;
+    skipped: number;
+    total_retries: number;
+    auto_completion_rate: number;
+    wall_clock_seconds: number;
+    spec_to_ingest_seconds?: number;
+}
+export declare function generateScorecard(stwRoot: string, runId: string): RunScorecard;
+export declare function formatScorecard(scorecard: RunScorecard): string;
+export declare function writeScorecard(stwRoot: string, runId: string, scorecard: RunScorecard): void;

package/dist/scorecard.js

@@ -0,0 +1,128 @@
+import { join } from 'node:path';
+import { fileExists, readJson, runDir, taskDir, writeJson } from './storage.js';
+import { loadCosts } from './cost.js';
+function readManifest(stwRoot, runId) {
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    if (!fileExists(manifestPath)) {
+        return null;
+    }
+    return readJson(manifestPath);
+}
+function readTaskGraph(stwRoot, runId) {
+    const graphPath = join(runDir(stwRoot, runId), 'task_graph.json');
+    if (!fileExists(graphPath)) {
+        return null;
+    }
+    return readJson(graphPath);
+}
+function readTaskStatuses(stwRoot, runId, taskIds) {
+    const statuses = new Map();
+    for (const taskId of taskIds) {
+        const statusPath = join(taskDir(stwRoot, runId, taskId), 'status.json');
+        if (fileExists(statusPath)) {
+            const status = readJson(statusPath);
+            statuses.set(taskId, status);
+        }
+    }
+    return statuses;
+}
+function parseRetriesFromNotes(notes) {
+    if (!notes)
+        return 0;
+    const match = notes.match(/attempts:\s*(\d+)/);
+    return match ? parseInt(match[1], 10) : 0;
+}
+export function generateScorecard(stwRoot, runId) {
+    const manifest = readManifest(stwRoot, runId);
+    const graph = readTaskGraph(stwRoot, runId);
+    const costs = loadCosts(stwRoot, runId);
+    const totalTasks = graph?.tasks.length ?? 0;
+    const taskIds = graph?.tasks.map((t) => t.id) ?? [];
+    const taskStatuses = readTaskStatuses(stwRoot, runId, taskIds);
+    let autoCompleted = 0;
+    let escalated = 0;
+    let rescued = 0;
+    let skipped = 0;
+    let totalRetries = 0;
+    for (const taskId of taskIds) {
+        const status = taskStatuses.get(taskId);
+        if (!status)
+            continue;
+        if (status.status === 'complete') {
+            autoCompleted++;
+        }
+        else if (status.status === 'escalated' || status.status === 'failed') {
+            escalated++;
+        }
+        else if (status.status === 'skipped') {
+            skipped++;
+        }
+        if (status.preserved_worktree_path) {
+            rescued++;
+        }
+        const attempts = parseRetriesFromNotes(status.notes);
+        if (attempts > 1) {
+            totalRetries += attempts - 1;
+        }
+    }
+    const workerCostUsd = costs?.total_cost_usd ?? 0;
+    const plannerCostUsd = 0;
+    const totalRetriesFromCosts = costs?.total_retries ?? 0;
+    const autoCompletionRate = totalTasks > 0 ? (autoCompleted / totalTasks) * 100 : 0;
+    let wallClockSeconds = 0;
+    if (manifest?.created_at) {
+        const startTime = new Date(manifest.created_at).getTime();
+        const endTime = Date.now();
+        wallClockSeconds = Math.floor((endTime - startTime) / 1000);
+    }
+    let specToIngestSeconds;
+    if (manifest?.spec_started_at && manifest?.spec_completed_at) {
+        const startTime = new Date(manifest.spec_started_at).getTime();
+        const endTime = new Date(manifest.spec_completed_at).getTime();
+        if (!isNaN(startTime) && !isNaN(endTime) && endTime > startTime) {
+            specToIngestSeconds = Math.floor((endTime - startTime) / 1000);
+        }
+    }
+    return {
+        schema_version: 1,
+        run_id: runId,
+        worker_cost_usd: workerCostUsd,
+        planner_cost_usd: plannerCostUsd,
+        total_tasks: totalTasks,
+        auto_completed: autoCompleted,
+        escalated: escalated,
+        rescued: rescued,
+        skipped: skipped,
+        total_retries: totalRetries + totalRetriesFromCosts,
+        auto_completion_rate: autoCompletionRate,
+        wall_clock_seconds: wallClockSeconds,
+        spec_to_ingest_seconds: specToIngestSeconds,
+    };
+}
+export function formatScorecard(scorecard) {
+    const lines = [];
+    lines.push('=== True-Cost Scorecard ===');
+    lines.push(`Run: ${scorecard.run_id}`);
+    lines.push('');
+    lines.push(`Total Tasks: ${scorecard.total_tasks}`);
+    lines.push(`Auto Completed: ${scorecard.auto_completed}`);
+    lines.push(`Escalated: ${scorecard.escalated}`);
+    lines.push(`Rescued: ${scorecard.rescued}`);
+    lines.push(`Skipped: ${scorecard.skipped}`);
+    lines.push(`Total Retries: ${scorecard.total_retries}`);
+    lines.push(`Auto-Completion Rate: ${scorecard.auto_completion_rate.toFixed(1)}%`);
+    lines.push('');
+    lines.push(`Worker Cost: $${scorecard.worker_cost_usd.toFixed(4)}`);
+    lines.push(`Planner Cost: $${scorecard.planner_cost_usd.toFixed(4)}`);
+    lines.push(`Total Cost: $${(scorecard.worker_cost_usd + scorecard.planner_cost_usd).toFixed(4)}`);
+    lines.push(`Wall Clock: ${scorecard.wall_clock_seconds}s`);
+    if (scorecard.spec_to_ingest_seconds != null) {
+        lines.push(`Spec-to-Ingest: ${scorecard.spec_to_ingest_seconds}s`);
+    }
+    return lines.join('\n');
+}
+export function writeScorecard(stwRoot, runId, scorecard) {
+    const scorecardPath = join(runDir(stwRoot, runId), 'scorecard.json');
+    writeJson(scorecardPath, scorecard);
+}
+//# sourceMappingURL=scorecard.js.map

package/dist/scorecard.js.map

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

package/dist/spec-templates.d.ts

@@ -0,0 +1,2 @@
+export declare function getTemplate(name: string): string | null;
+export declare function listTemplates(): string[];