@mknightzzz/stw 0.1.0

package/dist/question-triage.js

@@ -0,0 +1,175 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJson, writeAtomic, writeJson } from './storage.js';
+const MIN_AUTO_ANSWER_CONFIDENCE = 0.85;
+const MAX_CONSECUTIVE_AUTO_ANSWERS_PER_THREAD = 1;
+const MAX_TOTAL_AUTO_ANSWERS_PER_TASK = 2;
+/**
+ * Normalizes question text for deterministic hashing.
+ * Lowercases, collapses whitespace, strips punctuation at boundaries.
+ */
+export function normalizeQuestionText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[\r\n]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/[?!.,;:]+$/, '')
+        .trim();
+}
+/**
+ * Computes a deterministic question_thread_id from normalized question text.
+ * Uses SHA-256, returns first 16 hex chars prefixed with 'qt_'.
+ */
+export function computeQuestionThreadId(question) {
+    const normalized = normalizeQuestionText(question);
+    const hash = createHash('sha256').update(normalized, 'utf8').digest('hex');
+    return `qt_${hash.slice(0, 16)}`;
+}
+/**
+ * Validates that evidence and confidence meet the bar for auto-answering.
+ */
+function isEligibleForAutoAnswer(evidence, confidence) {
+    if (!evidence || evidence.trim().length === 0) {
+        return false;
+    }
+    if (confidence === undefined || confidence < MIN_AUTO_ANSWER_CONFIDENCE) {
+        return false;
+    }
+    return true;
+}
+function triageArtifactPath(taskDir) {
+    return join(taskDir, 'question-triage.json');
+}
+export function triageDecisionPath(taskDir) {
+    return join(taskDir, 'triage.json');
+}
+function loadTriageArtifact(taskDir, taskId) {
+    const path = triageArtifactPath(taskDir);
+    if (existsSync(path)) {
+        try {
+            return readJson(path);
+        }
+        catch { }
+    }
+    return {
+        schema_version: 1,
+        task_id: taskId,
+        total_auto_answers: 0,
+        threads: {},
+    };
+}
+function saveTriageArtifact(taskDir, artifact) {
+    mkdirSync(taskDir, { recursive: true });
+    writeAtomic(triageArtifactPath(taskDir), JSON.stringify(artifact, null, 2) + '\n');
+}
+function writeTriageDecisionArtifact(taskDir, artifact) {
+    writeJson(triageDecisionPath(taskDir), artifact);
+}
+export function triageQuestion(input) {
+    const { question, task, taskDir, evidence, confidence, questionNumber, maxAutoAnswers } = input;
+    const threadId = computeQuestionThreadId(question);
+    const artifact = loadTriageArtifact(taskDir, task.id);
+    const limit = maxAutoAnswers ?? MAX_TOTAL_AUTO_ANSWERS_PER_TASK;
+    const threadRecord = artifact.threads[threadId] ?? {
+        question_thread_id: threadId,
+        consecutive_auto_answers: 0,
+        last_decision: 'ask_human',
+    };
+    if (!isEligibleForAutoAnswer(evidence, confidence)) {
+        const result = {
+            decision: 'ask_human',
+            question_thread_id: threadId,
+            reason: 'Insufficient evidence or confidence for auto-answer',
+        };
+        persistDecision(taskDir, artifact, threadRecord, 'ask_human');
+        writeTriageDecisionArtifact(taskDir, {
+            schema_version: 1,
+            task_id: task.id,
+            question,
+            question_number: questionNumber ?? 1,
+            question_thread_id: threadId,
+            decision: 'ask_human',
+            reason: result.reason,
+            created_at: new Date().toISOString(),
+        });
+        return result;
+    }
+    if (artifact.total_auto_answers >= limit) {
+        const result = {
+            decision: 'ask_human',
+            question_thread_id: threadId,
+            reason: `Total auto-answer limit (${limit}) reached for this task`,
+        };
+        persistDecision(taskDir, artifact, threadRecord, 'ask_human');
+        writeTriageDecisionArtifact(taskDir, {
+            schema_version: 1,
+            task_id: task.id,
+            question,
+            question_number: questionNumber ?? 1,
+            question_thread_id: threadId,
+            decision: 'ask_human',
+            reason: result.reason,
+            created_at: new Date().toISOString(),
+        });
+        return result;
+    }
+    if (threadRecord.consecutive_auto_answers >= MAX_CONSECUTIVE_AUTO_ANSWERS_PER_THREAD) {
+        const result = {
+            decision: 'ask_human',
+            question_thread_id: threadId,
+            reason: `Consecutive auto-answer limit (${MAX_CONSECUTIVE_AUTO_ANSWERS_PER_THREAD}) reached for thread ${threadId}`,
+        };
+        persistDecision(taskDir, artifact, threadRecord, 'ask_human');
+        writeTriageDecisionArtifact(taskDir, {
+            schema_version: 1,
+            task_id: task.id,
+            question,
+            question_number: questionNumber ?? 1,
+            question_thread_id: threadId,
+            decision: 'ask_human',
+            reason: result.reason,
+            created_at: new Date().toISOString(),
+        });
+        return result;
+    }
+    const result = {
+        decision: 'auto_answer',
+        answer: evidence,
+        confidence,
+        question_thread_id: threadId,
+        reason: `Auto-answer approved (confidence=${confidence})`,
+    };
+    persistDecision(taskDir, artifact, threadRecord, 'auto_answer');
+    writeTriageDecisionArtifact(taskDir, {
+        schema_version: 1,
+        task_id: task.id,
+        question,
+        question_number: questionNumber ?? 1,
+        question_thread_id: threadId,
+        decision: 'auto_answer',
+        reason: result.reason,
+        answer: result.answer,
+        confidence,
+        created_at: new Date().toISOString(),
+    });
+    return result;
+}
+function persistDecision(taskDir, artifact, threadRecord, decision) {
+    const updated = {
+        ...threadRecord,
+        last_decision: decision,
+        consecutive_auto_answers: decision === 'auto_answer' ? threadRecord.consecutive_auto_answers + 1 : 0,
+    };
+    const updatedArtifact = {
+        ...artifact,
+        total_auto_answers: decision === 'auto_answer' ? artifact.total_auto_answers + 1 : artifact.total_auto_answers,
+        threads: {
+            ...artifact.threads,
+            [threadRecord.question_thread_id]: updated,
+        },
+    };
+    saveTriageArtifact(taskDir, updatedArtifact);
+}
+//# sourceMappingURL=question-triage.js.map

package/dist/question-triage.js.map

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

package/dist/repo-detection.d.ts

@@ -0,0 +1,8 @@
+import type { RepoProfile, RepoType } from './init.js';
+export type { RepoProfile, RepoType };
+export declare function detectWorktreeRepo(worktreePath: string): RepoProfile;
+/**
+ * Detect repo type in a worktree and return acceptance-check commands.
+ * Returns an empty array when nothing is detected.
+ */
+export declare function buildGreenfieldChecks(worktreePath: string): string[];

package/dist/repo-detection.js

@@ -0,0 +1,18 @@
+import { detectRepo } from './init.js';
+export function detectWorktreeRepo(worktreePath) {
+    return detectRepo(worktreePath);
+}
+/**
+ * Detect repo type in a worktree and return acceptance-check commands.
+ * Returns an empty array when nothing is detected.
+ */
+export function buildGreenfieldChecks(worktreePath) {
+    const profile = detectWorktreeRepo(worktreePath);
+    const commands = [];
+    if (profile.testCommand)
+        commands.push(profile.testCommand);
+    if (profile.lintCommand)
+        commands.push(profile.lintCommand);
+    return commands;
+}
+//# sourceMappingURL=repo-detection.js.map

package/dist/repo-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-detection.js","sourceRoot":"","sources":["../src/repo-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAKvC,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,OAAO,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/retry-context.d.ts

@@ -0,0 +1,2 @@
+import type { RetryContextLevel, FailureCategory } from './types.js';
+export declare function buildRetryContext(taskDir: string, retryReason: string, level: RetryContextLevel, failureCategory?: FailureCategory): string;

package/dist/retry-context.js

@@ -0,0 +1,196 @@
+import { join } from 'node:path';
+import { readdirSync } from 'node:fs';
+import { fileExists, readText } from './storage.js';
+import { inferCodeFence } from './prompt-builder.js';
+const RETRY_SECTION_BUDGETS = {
+    minimal: 1200,
+    basic: 4000,
+    full: 12000,
+};
+const RETRY_SECTION_PRIORITY = [
+    'failure_reason',
+    'acceptance_errors',
+    'diagnostic_stderr',
+    'previous_diff',
+    'worker_prompt',
+    'status',
+    'worker_response',
+    'validation',
+    'review',
+];
+function estimateRetryTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function truncateSection(content, maxTokens, strategy) {
+    if (estimateRetryTokens(content) <= maxTokens) {
+        return content;
+    }
+    if (strategy === 'head') {
+        const hunkPattern = /^@@.*@@$/gm;
+        const hunkStarts = [];
+        let match;
+        while ((match = hunkPattern.exec(content)) !== null) {
+            hunkStarts.push(match.index);
+        }
+        const totalHunks = hunkStarts.length;
+        if (totalHunks === 0) {
+            const maxChars = maxTokens * 4;
+            return content.slice(0, maxChars) + '\n... (truncated)';
+        }
+        let keptHunks = 0;
+        let lastEnd = content.length;
+        for (let i = 0; i < hunkStarts.length; i++) {
+            const end = i < hunkStarts.length - 1 ? hunkStarts[i + 1] : content.length;
+            const partial = content.slice(0, end);
+            if (estimateRetryTokens(partial) > maxTokens) {
+                lastEnd = i > 0 ? hunkStarts[i] : end;
+                keptHunks = i > 0 ? i : 1;
+                break;
+            }
+            keptHunks = i + 1;
+            lastEnd = end;
+        }
+        return content.slice(0, lastEnd) + `\n... (truncated, ${keptHunks}/${totalHunks} hunks shown)`;
+    }
+    else {
+        const lines = content.split('\n');
+        let keptLines = 0;
+        const result = [];
+        for (let i = lines.length - 1; i >= 0; i--) {
+            const candidate = [lines[i], ...result].join('\n');
+            if (estimateRetryTokens(candidate) > maxTokens) {
+                break;
+            }
+            result.unshift(lines[i]);
+            keptLines++;
+        }
+        if (keptLines === 0 && lines.length > 0) {
+            result.push(lines[lines.length - 1]);
+            keptLines = 1;
+        }
+        return `... (truncated, showing last ${keptLines} lines)\n` + result.join('\n');
+    }
+}
+const TRUNCATION_STRATEGIES = {
+    previous_diff: 'head',
+    diagnostic_stderr: 'tail',
+};
+export function buildRetryContext(taskDir, retryReason, level, failureCategory) {
+    const attemptsDir = join(taskDir, 'attempts');
+    const latestAttemptDir = findLatestAttemptDir(attemptsDir);
+    if (!latestAttemptDir) {
+        const lines = ['Retry context:', `- Previous failure reason: ${retryReason}`];
+        if (failureCategory) {
+            lines.push(`- Failure category: ${failureCategory}`);
+        }
+        return lines.join('\n');
+    }
+    const sections = collectRetrySections(latestAttemptDir, retryReason, failureCategory);
+    const budget = RETRY_SECTION_BUDGETS[level];
+    const selected = [];
+    let used = 0;
+    for (const key of RETRY_SECTION_PRIORITY) {
+        const section = sections[key];
+        if (!section) {
+            continue;
+        }
+        let cost = estimateRetryTokens(section);
+        if (used + cost > budget) {
+            const remainingBudget = budget - used;
+            if (remainingBudget <= 0) {
+                continue;
+            }
+            const strategy = TRUNCATION_STRATEGIES[key] ?? 'head';
+            const truncated = truncateSection(section, remainingBudget, strategy);
+            const truncatedCost = estimateRetryTokens(truncated);
+            if (truncatedCost > remainingBudget) {
+                continue;
+            }
+            selected.push(truncated);
+            used += truncatedCost;
+            continue;
+        }
+        selected.push(section);
+        used += cost;
+    }
+    return ['Retry context:', ...selected].join('\n');
+}
+function findLatestAttemptDir(attemptsDir) {
+    try {
+        const entries = readdirSync(attemptsDir, { withFileTypes: true });
+        const attemptNumbers = entries
+            .filter((entry) => entry.isDirectory() && /^\d+$/.test(entry.name))
+            .map((entry) => Number(entry.name))
+            .sort((left, right) => right - left);
+        if (attemptNumbers.length === 0) {
+            return null;
+        }
+        return join(attemptsDir, String(attemptNumbers[0]));
+    }
+    catch {
+        return null;
+    }
+}
+function collectRetrySections(attemptDir, retryReason, failureCategory) {
+    const failureReasonLines = [`- Previous failure reason: ${retryReason}`];
+    if (failureCategory) {
+        failureReasonLines.push(`- Failure category: ${failureCategory}`);
+    }
+    return {
+        failure_reason: failureReasonLines.join('\n'),
+        acceptance_errors: readRetryArtifactSection(attemptDir, 'acceptance-errors.txt', 'Acceptance Check Failures'),
+        diagnostic_stderr: readDiagnosticStderr(attemptDir),
+        previous_diff: readPreviousDiff(attemptDir),
+        worker_prompt: readRetryArtifactSection(attemptDir, 'worker_prompt.md', 'Previous worker prompt'),
+        status: readRetryArtifactSection(attemptDir, 'status.json', 'Previous task status'),
+        worker_response: readRetryArtifactSection(attemptDir, 'worker_response.json', 'Previous worker response'),
+        validation: readRetryArtifactSection(attemptDir, 'validation.json', 'Previous validation result'),
+        review: readRetryArtifactSection(attemptDir, 'review.json', 'Previous review result'),
+    };
+}
+function readRetryArtifactSection(attemptDir, fileName, title) {
+    const artifactPath = join(attemptDir, fileName);
+    if (!fileExists(artifactPath)) {
+        return undefined;
+    }
+    const content = readText(artifactPath).trim();
+    if (content.length === 0) {
+        return undefined;
+    }
+    const fence = inferCodeFence(fileName);
+    return [`### ${title}`, '```' + fence, content, '```'].join('\n');
+}
+function readPreviousDiff(attemptDir) {
+    const diffPath = join(attemptDir, 'diff.patch');
+    if (!fileExists(diffPath)) {
+        return undefined;
+    }
+    const content = readText(diffPath).trim();
+    if (content.length === 0) {
+        return undefined;
+    }
+    return ['### Previous diff', '```patch', content, '```'].join('\n');
+}
+function readDiagnosticStderr(attemptDir) {
+    const diagnosticPath = join(attemptDir, 'diagnostic.json');
+    if (fileExists(diagnosticPath)) {
+        try {
+            const diagnostic = JSON.parse(readText(diagnosticPath));
+            if (diagnostic.stderr && diagnostic.stderr.trim().length > 0) {
+                return ['### Diagnostic stderr', '```text', diagnostic.stderr.trim(), '```'].join('\n');
+            }
+        }
+        catch {
+            // Fall through to agentic_stderr.txt
+        }
+    }
+    const agenticStderrPath = join(attemptDir, 'agentic_stderr.txt');
+    if (fileExists(agenticStderrPath)) {
+        const content = readText(agenticStderrPath).trim();
+        if (content.length > 0) {
+            return ['### Diagnostic stderr', '```text', content, '```'].join('\n');
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=retry-context.js.map

package/dist/retry-context.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,18 @@
+import { type ExecutionMode, type ModelTier, type RiskLevel, type StwConfig } from './types.js';
+export declare function getNextTier(currentTier: ModelTier): ModelTier | null;
+export interface RouteInput {
+    risk: RiskLevel;
+    task_type: string;
+    model_tier: string;
+    execution_mode?: ExecutionMode;
+    planner_eligible?: boolean;
+    estimated_prompt_tokens?: number;
+    max_prompt_tokens?: number;
+}
+export interface RouteResult {
+    tier: ModelTier;
+    model_id: string;
+    provider: string;
+    model: string;
+}
+export declare function routeTask(input: RouteInput, config: StwConfig): RouteResult;

package/dist/router.js

@@ -0,0 +1,137 @@
+import { resolveModel } from './config.js';
+import { MODEL_TIERS, } from './types.js';
+const NEXT_TIER = {
+    cheap: 'medium',
+    medium: 'strong',
+    strong: null,
+    reader: 'strong',
+};
+export function getNextTier(currentTier) {
+    return NEXT_TIER[currentTier];
+}
+const ESCALATION_LADDER = {
+    cheap: ['cheap', 'medium', 'strong'],
+    medium: ['medium', 'strong'],
+    strong: ['strong'],
+    reader: ['reader', 'strong'],
+};
+export function routeTask(input, config) {
+    const normalizedInput = applyPreEscalationRouting(applyExecutionModeRouting(input, config));
+    if (config.models && Object.keys(config.models).length > 0) {
+        const routedFromModels = routeWithModelRegistry(normalizedInput, config);
+        if (routedFromModels) {
+            return routedFromModels;
+        }
+        const startingTier = asModelTier(normalizedInput.model_tier);
+        const reachableTiers = startingTier ? ESCALATION_LADDER[startingTier].join(', ') : normalizedInput.model_tier;
+        throw new Error(`No models configured for requested tier "${normalizedInput.model_tier}" or any reachable tier (${reachableTiers})`);
+    }
+    return routeWithLegacyProviders(normalizedInput, config);
+}
+function applyPreEscalationRouting(input) {
+    if (input.estimated_prompt_tokens === undefined || input.max_prompt_tokens === undefined) {
+        return input;
+    }
+    const ratio = input.estimated_prompt_tokens / input.max_prompt_tokens;
+    const currentTier = asModelTier(input.model_tier);
+    if (!currentTier) {
+        return input;
+    }
+    let escalatedTier = currentTier;
+    if (ratio > 0.9 && currentTier === 'medium') {
+        escalatedTier = 'strong';
+    }
+    else if (ratio > 0.7 && currentTier === 'cheap') {
+        escalatedTier = 'medium';
+    }
+    if (escalatedTier !== currentTier) {
+        return { ...input, model_tier: escalatedTier };
+    }
+    return input;
+}
+function routeWithModelRegistry(input, config) {
+    const exactMatch = resolveModel(config, input.model_tier);
+    if (exactMatch && exactMatch.id === input.model_tier) {
+        return toRouteResult(exactMatch);
+    }
+    const startingTier = exactMatch?.tier ?? asModelTier(input.model_tier);
+    if (!startingTier) {
+        return null;
+    }
+    for (const tier of ESCALATION_LADDER[startingTier]) {
+        const entries = listModelsForTier(config, tier);
+        if (entries.length === 0) {
+            continue;
+        }
+        const preferences = config.routing_policy.provider_preferences?.[tier] ?? Object.keys(config.providers);
+        for (const providerName of preferences) {
+            const modelEntry = entries.find((entry) => entry.provider === providerName);
+            if (!modelEntry) {
+                continue;
+            }
+            return toRouteResult(modelEntry);
+        }
+        const [fallbackEntry] = entries;
+        if (fallbackEntry) {
+            return toRouteResult(fallbackEntry);
+        }
+    }
+    return null;
+}
+function routeWithLegacyProviders(input, config) {
+    const requestedTier = asModelTier(input.model_tier);
+    if (!requestedTier) {
+        throw new Error(`No model configured for "${input.model_tier}"`);
+    }
+    for (const tier of ESCALATION_LADDER[requestedTier]) {
+        const preferences = config.routing_policy.provider_preferences?.[tier] ?? Object.keys(config.providers);
+        for (const providerName of preferences) {
+            const provider = config.providers[providerName];
+            if (!provider) {
+                continue;
+            }
+            const model = provider.models[tier];
+            if (!model) {
+                continue;
+            }
+            return {
+                tier,
+                model_id: tier,
+                provider: providerName,
+                model,
+            };
+        }
+    }
+    throw new Error(`No provider available for tier "${input.model_tier}" or any escalation tier`);
+}
+function listModelsForTier(config, tier) {
+    return Object.entries(config.models ?? {})
+        .filter(([, entry]) => entry.tier === tier)
+        .map(([id, entry]) => ({ id, ...entry }));
+}
+function toRouteResult(entry) {
+    return {
+        tier: entry.tier,
+        model_id: entry.id,
+        provider: entry.provider,
+        model: entry.model,
+    };
+}
+function asModelTier(value) {
+    return MODEL_TIERS.includes(value) ? value : null;
+}
+function applyExecutionModeRouting(input, config) {
+    const conservativeTaskTypes = new Set(config.routing_policy.conservative_execution_task_types ?? ['integration', 'final_validation']);
+    const shouldForceConservative = conservativeTaskTypes.has(input.task_type) || input.planner_eligible === false;
+    if (!shouldForceConservative) {
+        return input;
+    }
+    if (input.model_tier === 'cheap') {
+        return {
+            ...input,
+            model_tier: 'medium',
+        };
+    }
+    return input;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/run-artifact-types.d.ts

@@ -0,0 +1,43 @@
+export type RunEventType = 'manual_completion' | 'status_correction' | 'resume' | 'retry' | 'replan' | 'sync_repair' | 'stop' | 'answer' | 'escalation';
+export type EscalationCategory = 'human_review' | 'spec_gap' | 'validation_failure' | 'integration_issue' | 'sync_issue' | 'budget' | 'drift' | 'operator_override' | 'other';
+export interface RunEvent {
+    schema_version: 1;
+    event_id: string;
+    run_id: string;
+    event_type: RunEventType;
+    created_at: string;
+    actor: string;
+    task_id?: string;
+    summary: string;
+    details?: string;
+    escalation_category?: EscalationCategory;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+export interface RunEventsArtifact {
+    schema_version: 1;
+    run_id: string;
+    events: RunEvent[];
+}
+export interface RunMetricsArtifact {
+    schema_version: 1;
+    run_id: string;
+    machine: {
+        total_tasks?: number;
+        completed_tasks?: number;
+        failed_tasks?: number;
+        escalated_tasks?: number;
+        skipped_tasks?: number;
+        pending_tasks?: number;
+        total_cost_usd?: number;
+        total_input_tokens?: number;
+        total_output_tokens?: number;
+        avg_latency_ms?: number;
+    };
+    operator?: {
+        objective_score?: number;
+        outcome_notes?: string;
+        true_cost_notes?: string;
+        intervention_notes?: string;
+    };
+    updated_at: string;
+}

package/dist/run-artifact-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-artifact-types.js.map

package/dist/run-artifact-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-artifact-types.js","sourceRoot":"","sources":["../src/run-artifact-types.ts"],"names":[],"mappings":""}

package/dist/run-summary.d.ts

@@ -0,0 +1,14 @@
+import type { Task, CostsFile, RunManifest, BudgetConfig, TaskStatus } from './types.js';
+import type { RunEventsArtifact, RunMetricsArtifact } from './types.js';
+export interface RunSummaryOptions {
+    manifest: RunManifest;
+    tasks: Task[];
+    taskStatuses: Record<string, string>;
+    costs?: CostsFile | null;
+    budget?: BudgetConfig | null;
+    taskStatusRecords?: Record<string, TaskStatus> | null;
+    runEvents?: RunEventsArtifact | null;
+    runMetrics?: RunMetricsArtifact | null;
+    taskEvents?: Record<string, string[]> | null;
+}
+export declare function generateRunSummary(options: RunSummaryOptions): string;