@mknightzzz/stw 0.1.0

package/dist/parallel.js

@@ -0,0 +1,214 @@
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { readTaskStatus } from './status.js';
+import { runGit, applyPatchToBranch } from './git-utils.js';
+import { cleanupWorktree } from './worktree.js';
+import { fileExists } from './storage.js';
+import { executeTask } from './task-executor.js';
+export function findReadyTasks(graph, stwRoot, runId) {
+    const ready = [];
+    for (let i = 0; i < graph.tasks.length; i++) {
+        const task = graph.tasks[i];
+        const status = readTaskStatus(stwRoot, runId, task.id);
+        if (status)
+            continue;
+        const depsDone = task.dependencies.every((dep) => {
+            const depStatus = readTaskStatus(stwRoot, runId, dep);
+            return depStatus?.status === 'complete';
+        });
+        if (!depsDone)
+            continue;
+        ready.push({ task, index: i });
+    }
+    return ready;
+}
+export function mergeBackSequentially(input) {
+    const { completedResults, repoRoot, runBranch, logger } = input;
+    const results = [];
+    for (const batch of completedResults) {
+        const { task, result, worktreePath, taskBranch, taskDir } = batch;
+        if (result.finalState !== 'complete' || !worktreePath || !taskBranch) {
+            results.push({ taskId: task.id, merged: false, needsRetry: false });
+            continue;
+        }
+        // Commit any uncommitted changes in the worktree
+        const gitOpts = { cwd: worktreePath, encoding: 'utf-8', stdio: 'pipe' };
+        try {
+            runGit(worktreePath, ['add', '-A']);
+            execFileSync('git', ['commit', '--allow-empty', '-m', `feat(${task.id}): ${task.description}`], gitOpts);
+        }
+        catch {
+            // May already be committed by the agentic backend
+        }
+        // Try fast-forward first
+        let merged = false;
+        try {
+            execFileSync('git', ['fetch', '.', `${taskBranch}:${runBranch}`], {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                stdio: 'pipe',
+            });
+            merged = true;
+            logger?.info('Fast-forward merge succeeded', { task_id: task.id });
+        }
+        catch {
+            // Fast-forward failed — run branch has moved. Try rebase.
+            logger?.info('Fast-forward failed, attempting rebase', { task_id: task.id });
+            try {
+                execFileSync('git', ['rebase', runBranch], {
+                    cwd: worktreePath,
+                    encoding: 'utf-8',
+                    stdio: 'pipe',
+                });
+                // Rebase succeeded — now fast-forward
+                execFileSync('git', ['fetch', '.', `${taskBranch}:${runBranch}`], {
+                    cwd: repoRoot,
+                    encoding: 'utf-8',
+                    stdio: 'pipe',
+                });
+                merged = true;
+                logger?.info('Rebase + fast-forward succeeded', { task_id: task.id });
+            }
+            catch {
+                // Rebase failed — abort it and try patch-based fallback
+                try {
+                    execFileSync('git', ['rebase', '--abort'], {
+                        cwd: worktreePath,
+                        encoding: 'utf-8',
+                        stdio: 'pipe',
+                    });
+                }
+                catch {
+                    // rebase --abort may fail if not in rebase state
+                }
+                logger?.info('Rebase failed, trying patch fallback', { task_id: task.id });
+                // Try applying the diff patch directly
+                const patchPath = join(taskDir, 'diff.patch');
+                if (fileExists(patchPath)) {
+                    const applyResult = applyPatchToBranch({
+                        repoRoot,
+                        branch: runBranch,
+                        patchPath,
+                        commitMessage: `stw(${task.id}): apply task changes`,
+                    });
+                    if (applyResult.success) {
+                        merged = true;
+                        logger?.info('Patch fallback succeeded', { task_id: task.id });
+                    }
+                }
+            }
+        }
+        if (merged) {
+            // Clean up worktree and branch
+            try {
+                cleanupWorktree(worktreePath, repoRoot);
+            }
+            catch {
+                // Best effort
+            }
+            try {
+                execFileSync('git', ['branch', '-D', taskBranch], {
+                    cwd: repoRoot,
+                    encoding: 'utf-8',
+                    stdio: 'pipe',
+                });
+            }
+            catch {
+                // Branch already gone
+            }
+            results.push({ taskId: task.id, merged: true, needsRetry: false });
+        }
+        else {
+            // All merge strategies failed — signal retry
+            logger?.warn('All merge strategies failed, task needs retry', { task_id: task.id });
+            try {
+                cleanupWorktree(worktreePath, repoRoot);
+            }
+            catch {
+                // Best effort
+            }
+            try {
+                execFileSync('git', ['branch', '-D', taskBranch], {
+                    cwd: repoRoot,
+                    encoding: 'utf-8',
+                    stdio: 'pipe',
+                });
+            }
+            catch {
+                // Best effort
+            }
+            results.push({
+                taskId: task.id,
+                merged: false,
+                needsRetry: true,
+                error: 'Fast-forward, rebase, and patch apply all failed',
+            });
+        }
+    }
+    return results;
+}
+export async function executeBatch(options) {
+    const { tasks, config, baseOptions, taskDirFn, logger } = options;
+    const promises = tasks.map(async (task) => {
+        console.log(`  Starting task: ${task.id}`);
+        const td = taskDirFn(task.id);
+        const result = await executeTask(task, config, {
+            ...baseOptions,
+            taskDir: td,
+            deferMerge: true,
+        });
+        return {
+            task,
+            result,
+            worktreePath: result.worktreePath,
+            taskBranch: result.taskBranch,
+            taskDir: td,
+        };
+    });
+    const settled = await Promise.allSettled(promises);
+    const results = [];
+    for (const [i, outcome] of settled.entries()) {
+        const task = tasks[i];
+        if (outcome.status === 'fulfilled') {
+            results.push(outcome.value);
+        }
+        else {
+            logger?.warn('Parallel task execution failed', {
+                task_id: task.id,
+                error: outcome.reason instanceof Error ? outcome.reason.message : String(outcome.reason),
+            });
+            results.push({
+                task,
+                result: {
+                    finalState: 'escalated',
+                    attempts: 0,
+                    totalTokens: { input_tokens: 0, output_tokens: 0 },
+                },
+                taskDir: taskDirFn(task.id),
+            });
+        }
+    }
+    // Sequential merge-back for completed tasks
+    const completedForMerge = results.filter((br) => br.result.finalState === 'complete');
+    if (completedForMerge.length > 0) {
+        console.log(`Merging ${completedForMerge.length} completed task(s) to run branch...`);
+        const mergeResults = mergeBackSequentially({
+            completedResults: completedForMerge,
+            repoRoot: baseOptions.repoRoot,
+            runBranch: baseOptions.runBranch,
+            logger,
+        });
+        for (const mr of mergeResults) {
+            if (mr.needsRetry) {
+                console.log(`Task ${mr.taskId} needs retry due to merge conflict`);
+                const br = results.find((b) => b.task.id === mr.taskId);
+                if (br) {
+                    br.result.finalState = 'rejected';
+                    br.result.failureClass = 'merge_conflict_needs_retry';
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=parallel.js.map

package/dist/parallel.js.map

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

package/dist/plan-validation.d.ts

@@ -0,0 +1,19 @@
+import type { Task, TaskGraph } from './types.js';
+export interface PlanScopeValidationResult {
+    warnings: string[];
+    errors: string[];
+    valid: boolean;
+}
+export interface AcceptanceCheckValidationResult {
+    warnings: string[];
+    fixedChecks: Map<string, string[]>;
+}
+export declare function validatePlanScope(graph: TaskGraph, repoRoot?: string, config?: {
+    max_scope_files_per_task?: number;
+    max_tasks_per_spec?: number;
+}): PlanScopeValidationResult;
+export declare function isSerialized(leftTaskId: string, rightTaskId: string, taskById: Map<string, Task>, dependencyCache: Map<string, Set<string>>): boolean;
+export declare function intersectFiles(leftFiles: string[], rightFiles: string[]): string[];
+export declare function validatePlannerOutput(graph: TaskGraph, repoRoot?: string): AcceptanceCheckValidationResult;
+export { expandScopesFromImportGraph } from './scope-expansion.js';
+export type { ScopeExpansionResult } from './scope-expansion.js';

package/dist/plan-validation.js

@@ -0,0 +1,253 @@
+import { readFileSync } from 'node:fs';
+import { join, normalize } from 'node:path';
+import { fileExists } from './storage.js';
+const TEST_FILE_PATTERNS = [
+    /^tests\/.*\.test\.ts$/,
+    /^tests\/.*\.test\.js$/,
+    /^tests\/.*\.spec\.ts$/,
+    /^tests\/.*\.spec\.js$/,
+    /^__tests__\/.*\.ts$/,
+    /^__tests__\/.*\.js$/,
+    /^.*\.test\.ts$/,
+    /^.*\.test\.js$/,
+    /^.*\.spec\.ts$/,
+    /^.*\.spec\.js$/,
+    /^test\/.*\.ts$/,
+    /^test\/.*\.js$/,
+];
+const TEST_RUNNER_PATTERNS = [
+    { pattern: /npx\s+vitest\s+run\s+(\S+)/, runner: 'vitest', replaceWith: 'npx vitest run' },
+    { pattern: /npx\s+vitest\s+(\S+)/, runner: 'vitest', replaceWith: 'npx vitest' },
+    { pattern: /npx\s+jest\s+(.+)/, runner: 'jest', replaceWith: 'npx jest' },
+    { pattern: /npx\s+pytest\s+(.+)/, runner: 'pytest', replaceWith: 'npx pytest' },
+    { pattern: /yarn\s+vitest\s+run\s+(\S+)/, runner: 'vitest', replaceWith: 'yarn vitest run' },
+    { pattern: /yarn\s+jest\s+(.+)/, runner: 'jest', replaceWith: 'yarn jest' },
+    { pattern: /npm\s+test\s+--\s+(.+)/, runner: 'npm', replaceWith: 'npm test' },
+];
+function isTestFilePath(path) {
+    return TEST_FILE_PATTERNS.some((pattern) => pattern.test(path));
+}
+function extractFilePathsFromCheck(check) {
+    const filePaths = [];
+    const pathPattern = /(?<!\S)(?:\.{0,2}\/)?[\w\-\.]+\/[\w\-\.\/]+\.\w+(?!\S)/g;
+    const matches = check.match(pathPattern);
+    if (matches) {
+        for (const match of matches) {
+            const cleanedPath = match.replace(/^\.\//, '');
+            if (isTestFilePath(cleanedPath)) {
+                filePaths.push(cleanedPath);
+            }
+        }
+    }
+    return filePaths;
+}
+function getAutoFixForCommand(check) {
+    for (const { pattern, replaceWith } of TEST_RUNNER_PATTERNS) {
+        if (pattern.test(check)) {
+            return check.replace(pattern, replaceWith);
+        }
+    }
+    return null;
+}
+export function validatePlanScope(graph, repoRoot, config) {
+    const warnings = [];
+    const errors = [];
+    const taskById = new Map(graph.tasks.map((task) => [task.id, task]));
+    const dependencyCache = new Map();
+    const maxScopeFiles = config?.max_scope_files_per_task ?? 8;
+    const maxTasks = config?.max_tasks_per_spec ?? 15;
+    if (graph.tasks.length > maxTasks) {
+        errors.push(`Task count ${graph.tasks.length} exceeds maximum ${maxTasks} per spec`);
+    }
+    for (const task of graph.tasks) {
+        if (task.scope.files.length === 0) {
+            warnings.push(`${task.id}: task has zero scope files`);
+        }
+        if (task.scope.files.length > maxScopeFiles) {
+            errors.push(`${task.id}: task has ${task.scope.files.length} scope files, exceeds maximum ${maxScopeFiles}`);
+        }
+        if (task.scope.files.length > 5) {
+            warnings.push(`${task.id}: task has ${task.scope.files.length} scope files (>5), consider splitting`);
+        }
+        if (repoRoot) {
+            const newFiles = new Set((task.scope.new_files ?? []).map((f) => normalize(f).replace(/^\.\//, '')));
+            const upstreamNewFiles = getUpstreamNewFiles(task.id, taskById, dependencyCache);
+            for (const file of task.scope.files) {
+                const normalizedFile = normalize(file).replace(/^\.\//, '');
+                const absolutePath = join(repoRoot, file);
+                if (!fileExists(absolutePath)) {
+                    if (newFiles.has(normalizedFile)) {
+                        warnings.push(`${task.id}: scope file ${file} does not exist yet (declared as new_files, will be created)`);
+                    }
+                    else if (upstreamNewFiles.has(normalizedFile)) {
+                        const creators = [];
+                        for (const depId of getReachableDependencies(task.id, taskById, dependencyCache)) {
+                            const depTask = taskById.get(depId);
+                            if (depTask?.scope.new_files?.some((f) => normalize(f).replace(/^\.\//, '') === normalizedFile)) {
+                                creators.push(depId);
+                            }
+                        }
+                        warnings.push(`${task.id}: scope file ${file} does not exist yet (will be created by upstream task${creators.length > 1 ? 's' : ''} ${creators.join(', ')})`);
+                    }
+                    else {
+                        errors.push(`${task.id}: scope file does not exist: ${file} (add to scope.new_files if the task creates it)`);
+                    }
+                }
+                else {
+                    try {
+                        const content = readFileSync(absolutePath, 'utf-8');
+                        const lines = content.split('\n').length;
+                        if (lines > 500) {
+                            warnings.push(`${task.id}: scope file ${file} is ${lines} lines (>500), consider narrowing task description to specific sections`);
+                        }
+                    }
+                    catch {
+                        warnings.push(`${task.id}: could not read scope file ${file} for line count`);
+                    }
+                }
+            }
+        }
+    }
+    for (let index = 0; index < graph.tasks.length; index += 1) {
+        for (let otherIndex = index + 1; otherIndex < graph.tasks.length; otherIndex += 1) {
+            const left = graph.tasks[index];
+            const right = graph.tasks[otherIndex];
+            if (!left || !right) {
+                continue;
+            }
+            if (isSerialized(left.id, right.id, taskById, dependencyCache)) {
+                continue;
+            }
+            const overlap = intersectFiles(left.scope.files, right.scope.files);
+            if (overlap.length === 0) {
+                continue;
+            }
+            if (left.scope.allow_shared_files && right.scope.allow_shared_files) {
+                warnings.push(`Scope overlap between ${left.id} and ${right.id}: ${overlap.join(', ')}`);
+                warnings.push(`Consider consolidating or serializing ${left.id} and ${right.id} for shared files: ${overlap.join(', ')}`);
+                continue;
+            }
+            errors.push(`Scope overlap between ${left.id} and ${right.id}: ${overlap.join(', ')} — set allow_shared_files: true on both tasks or add a dependency to serialize them`);
+        }
+    }
+    // Boundary-crossing detection: warn if a task's description references other task IDs
+    const allTaskIds = new Set(graph.tasks.map((t) => t.id));
+    for (const task of graph.tasks) {
+        const text = task.description;
+        for (const otherId of allTaskIds) {
+            if (otherId === task.id)
+                continue;
+            // Match "T3" as a word boundary (not inside "T31")
+            const pattern = new RegExp(`\\b${otherId}\\b`);
+            if (pattern.test(text)) {
+                warnings.push(`${task.id}: description references ${otherId} — may indicate cross-task scope bleed`);
+            }
+        }
+    }
+    return {
+        warnings,
+        errors,
+        valid: errors.length === 0,
+    };
+}
+function getUpstreamNewFiles(taskId, taskById, dependencyCache) {
+    const upstreamNewFiles = new Set();
+    const upstreamTaskIds = getReachableDependencies(taskId, taskById, dependencyCache);
+    for (const upstreamId of upstreamTaskIds) {
+        const upstreamTask = taskById.get(upstreamId);
+        if (upstreamTask?.scope.new_files) {
+            for (const file of upstreamTask.scope.new_files) {
+                upstreamNewFiles.add(normalize(file).replace(/^\.\//, ''));
+            }
+        }
+    }
+    return upstreamNewFiles;
+}
+export function isSerialized(leftTaskId, rightTaskId, taskById, dependencyCache) {
+    return (hasDependencyPath(leftTaskId, rightTaskId, taskById, dependencyCache) ||
+        hasDependencyPath(rightTaskId, leftTaskId, taskById, dependencyCache));
+}
+function hasDependencyPath(fromTaskId, toTaskId, taskById, dependencyCache) {
+    return getReachableDependencies(fromTaskId, taskById, dependencyCache).has(toTaskId);
+}
+function getReachableDependencies(taskId, taskById, dependencyCache, visiting) {
+    const cached = dependencyCache.get(taskId);
+    if (cached) {
+        return cached;
+    }
+    const currentVisiting = visiting ?? new Set();
+    if (currentVisiting.has(taskId)) {
+        // Cycle detected — return empty set to avoid infinite recursion
+        return new Set();
+    }
+    currentVisiting.add(taskId);
+    const task = taskById.get(taskId);
+    const reachable = new Set();
+    if (task) {
+        for (const dependencyId of task.dependencies) {
+            reachable.add(dependencyId);
+            for (const nestedDependencyId of getReachableDependencies(dependencyId, taskById, dependencyCache, currentVisiting)) {
+                reachable.add(nestedDependencyId);
+            }
+        }
+    }
+    dependencyCache.set(taskId, reachable);
+    return reachable;
+}
+export function intersectFiles(leftFiles, rightFiles) {
+    const rightSet = new Set(rightFiles);
+    const seen = new Set();
+    const overlap = [];
+    for (const file of leftFiles) {
+        if (rightSet.has(file) && !seen.has(file)) {
+            seen.add(file);
+            overlap.push(file);
+        }
+    }
+    return overlap.sort();
+}
+export function validatePlannerOutput(graph, repoRoot) {
+    const warnings = [];
+    const fixedChecks = new Map();
+    const taskById = new Map(graph.tasks.map((task) => [task.id, task]));
+    const dependencyCache = new Map();
+    for (const task of graph.tasks) {
+        const newFiles = new Set((task.scope.new_files ?? []).map((f) => normalize(f).replace(/^\.\//, '')));
+        const upstreamNewFiles = getUpstreamNewFiles(task.id, taskById, dependencyCache);
+        for (const check of task.acceptance_checks) {
+            const testFilePaths = extractFilePathsFromCheck(check);
+            for (const filePath of testFilePaths) {
+                const normalizedPath = normalize(filePath).replace(/^\.\//, '');
+                let pathExists = false;
+                if (repoRoot) {
+                    const absolutePath = join(repoRoot, filePath);
+                    if (fileExists(absolutePath)) {
+                        pathExists = true;
+                    }
+                }
+                if (!pathExists && newFiles.has(normalizedPath)) {
+                    pathExists = true;
+                }
+                if (!pathExists && upstreamNewFiles.has(normalizedPath)) {
+                    pathExists = true;
+                }
+                if (!pathExists) {
+                    const autoFixed = getAutoFixForCommand(check);
+                    if (autoFixed && autoFixed !== check) {
+                        const existingFixed = fixedChecks.get(task.id) ?? [];
+                        existingFixed.push(check);
+                        fixedChecks.set(task.id, existingFixed);
+                        warnings.push(`${task.id}: acceptance check references missing test file ${filePath}, auto-fixing to: ${autoFixed}`);
+                    }
+                    else {
+                        warnings.push(`${task.id}: acceptance check references missing test file ${filePath} (not on disk, not in scope.new_files, not in upstream new_files)`);
+                    }
+                }
+            }
+        }
+    }
+    return { warnings, fixedChecks };
+}
+// Re-export scope expansion from its own module
+export { expandScopesFromImportGraph } from './scope-expansion.js';
+//# sourceMappingURL=plan-validation.js.map

package/dist/plan-validation.js.map

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

package/dist/planner-prompt.d.ts

@@ -0,0 +1,33 @@
+import type { CompletedTaskContext, OversizedTask } from './types.js';
+export interface ImportGraphEdge {
+    importer: string;
+    specifier: string;
+    resolved: string | null;
+}
+export interface ImportGraph {
+    resolvedEdges: ImportGraphEdge[];
+    unresolvedEdges: ImportGraphEdge[];
+}
+export declare function buildPlannerPrompt(input: {
+    spec: string;
+    repoFiles: string[];
+    repoRoot?: string;
+    completedTasks?: CompletedTaskContext[];
+    extraConstraints?: string;
+    importGraph?: ImportGraph;
+}): string;
+export declare function buildReplanPrompt(input: {
+    spec: string;
+    repoFiles: string[];
+    repoRoot?: string;
+    completedTasks?: CompletedTaskContext[];
+    oversizedTasks: OversizedTask[];
+    attemptNumber: number;
+    importGraph?: ImportGraph;
+}): string;
+export declare function buildImportGraph(repoRoot: string, repoFiles: string[]): ImportGraph;
+export declare function selectImportGraphEdgesForPrompt(importGraph: ImportGraph): ImportGraph;
+export { validatePlanScope } from './plan-validation.js';
+export type { PlanScopeValidationResult } from './plan-validation.js';
+export declare const TEST_FILE_PATTERN: RegExp;
+export declare function isTestFile(filePath: string): boolean;