@mknightzzz/stw 0.1.0

package/dist/poller.js.map

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

package/dist/progress.d.ts

@@ -0,0 +1,34 @@
+export interface ProgressState {
+    runId: string;
+    totalTasks: number;
+    complete: number;
+    inProgress: number;
+    pending: number;
+    failed: number;
+    escalated: number;
+    skipped: number;
+    currentTask?: {
+        id: string;
+        tier?: string;
+        model?: string;
+        attempt: number;
+        elapsedMs: number;
+        startTime: number;
+    };
+    runElapsedMs: number;
+    runStartTime: number;
+    budget?: {
+        spent: number;
+        limit: number;
+    };
+}
+export interface ProgressOptions {
+    stwRoot: string;
+    runId: string;
+    startTime: number;
+    noProgress?: boolean;
+}
+export declare function buildProgressState(options: ProgressOptions): ProgressState | null;
+export declare function formatProgressBar(state: ProgressState, width?: number): string;
+export declare function formatDuration(ms: number): string;
+export declare function renderProgress(state: ProgressState): string;

package/dist/progress.js

@@ -0,0 +1,122 @@
+import { join } from 'node:path';
+import { readJson, fileExists, runDir } from './storage.js';
+import { readRunStatus, readTaskStatus } from './status.js';
+import { loadCosts } from './cost.js';
+import { loadConfig } from './config.js';
+export function buildProgressState(options) {
+    const { stwRoot, runId, startTime } = options;
+    const graphPath = join(stwRoot, 'runs', runId, 'task_graph.json');
+    const manifestPath = join(runDir(stwRoot, runId), 'manifest.json');
+    if (!fileExists(graphPath) || !fileExists(manifestPath)) {
+        return null;
+    }
+    const graph = readJson(graphPath);
+    const manifest = readJson(manifestPath);
+    const taskIds = graph.tasks.map((t) => t.id);
+    const statuses = readRunStatus(stwRoot, runId, taskIds);
+    let complete = 0;
+    let inProgress = 0;
+    let pending = 0;
+    let failed = 0;
+    let escalated = 0;
+    let skipped = 0;
+    for (const taskId of taskIds) {
+        const status = statuses[taskId];
+        switch (status) {
+            case 'complete':
+                complete++;
+                break;
+            case 'in_progress':
+            case 'blocked':
+            case 'question':
+                inProgress++;
+                break;
+            case 'failed':
+                failed++;
+                break;
+            case 'escalated':
+                escalated++;
+                break;
+            case 'skipped':
+                skipped++;
+                break;
+            default:
+                pending++;
+        }
+    }
+    const now = Date.now();
+    const config = loadConfig(join(stwRoot, 'config.yml'));
+    const costs = loadCosts(stwRoot, runId);
+    const progressState = {
+        runId,
+        totalTasks: graph.tasks.length,
+        complete,
+        inProgress,
+        pending,
+        failed,
+        escalated,
+        skipped,
+        runElapsedMs: now - startTime,
+        runStartTime: startTime,
+        budget: config.budget
+            ? {
+                spent: costs?.total_cost_usd ?? 0,
+                limit: config.budget.max_run_usd,
+            }
+            : undefined,
+    };
+    // Find current in-progress task
+    for (const taskId of taskIds) {
+        const status = statuses[taskId];
+        if (status === 'in_progress' || status === 'blocked' || status === 'question') {
+            const taskStatus = readTaskStatus(stwRoot, runId, taskId);
+            if (taskStatus) {
+                progressState.currentTask = {
+                    id: taskId,
+                    tier: taskStatus.execution_mode,
+                    attempt: 1,
+                    elapsedMs: now - new Date(taskStatus.started_at || manifest.created_at).getTime(),
+                    startTime: new Date(taskStatus.started_at || manifest.created_at).getTime(),
+                };
+            }
+            break;
+        }
+    }
+    return progressState;
+}
+export function formatProgressBar(state, width = 20) {
+    const { complete, totalTasks, failed, escalated, skipped } = state;
+    const done = complete + failed + escalated + skipped;
+    const filled = Math.round((done / totalTasks) * width);
+    const empty = width - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    return `${bar} ${done}/${totalTasks}`;
+}
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+export function renderProgress(state) {
+    const lines = [];
+    lines.push(`Run: ${state.runId}`);
+    lines.push(`Tasks: ${formatProgressBar(state)} complete | ${state.inProgress} running | ${state.pending} pending`);
+    if (state.currentTask) {
+        const tier = state.currentTask.tier ? ` (${state.currentTask.tier})` : '';
+        lines.push(`Running: ${state.currentTask.id}${tier} attempt ${state.currentTask.attempt} [${formatDuration(state.currentTask.elapsedMs)}]`);
+    }
+    lines.push(`Run total: ${formatDuration(state.runElapsedMs)}`);
+    if (state.budget) {
+        const pct = state.budget.limit > 0 ? (state.budget.spent / state.budget.limit) * 100 : 0;
+        lines.push(`Budget: $${state.budget.spent.toFixed(2)} / $${state.budget.limit.toFixed(2)} (${pct.toFixed(0)}%)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=progress.js.map

package/dist/progress.js.map

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

package/dist/prompt-builder.d.ts

@@ -0,0 +1,51 @@
+import type { Task, RetryContextLevel } from './types.js';
+import type { ValidationResult } from './validation.js';
+export { buildRetryContext } from './retry-context.js';
+export interface PromptContextFile {
+    path: string;
+    content: string;
+    source: 'scope' | 'local_import';
+    editable: boolean;
+}
+export interface BuildWorkerPromptOptions {
+    repoRoot: string;
+    task: Task;
+    taskDir: string;
+    retryReason?: string;
+    retryContextLevel?: RetryContextLevel;
+    questionAnswers?: Record<number, string>;
+}
+export interface BuildReviewerPromptOptions {
+    repoRoot: string;
+    task: Task;
+    taskDir: string;
+    diff: string;
+    validationResult: ValidationResult;
+}
+export interface TrimLogEntry {
+    step: 'initial' | 'drop_spec_context' | 'drop_local_imports' | 'truncate_context_files' | 'drop_scope_context' | 'final';
+    estimated_tokens: number;
+    context_file_count: number;
+    notes?: string;
+}
+export interface PromptBudgetResult {
+    prompt: string;
+    estimatedTokens: number;
+    maxTokens: number;
+    trimmed: boolean;
+    fits: boolean;
+    trimLog: TrimLogEntry[];
+}
+/** @deprecated Use ValidationResult from validation.ts directly */
+export type ReviewerValidationResult = ValidationResult;
+export declare function estimateTokens(text: string): number;
+export declare function buildWorkerPrompt(options: BuildWorkerPromptOptions): string;
+export declare function buildWorkerPromptWithBudget(options: BuildWorkerPromptOptions, maxTokens: number): PromptBudgetResult;
+export declare function buildReviewerPrompt(options: BuildReviewerPromptOptions): string;
+export declare function gatherTaskContext(repoRoot: string, scopeFiles: string[]): PromptContextFile[];
+export declare function extractSpecSections(content: string, taskId?: string): string | null;
+export declare function getSpecContext(repoRoot: string, specPath: string | undefined, taskId?: string): string | null;
+export declare function renderList(items: string[]): string;
+export declare function renderContextFiles(contextFiles: PromptContextFile[]): string;
+export declare function inferCodeFence(filePath: string): string;
+export declare function withResolvedQuestionAnswers(options: BuildWorkerPromptOptions): BuildWorkerPromptOptions;