@vinaes/succ 1.3.19

package/dist/lib/prd/scheduler.js

@@ -0,0 +1,113 @@
+/**
+ * PRD Task Scheduler
+ *
+ * Validates the task graph and provides topological sort
+ * for determining execution order with dependency resolution.
+ */
+import { ValidationError } from '../errors.js';
+// ============================================================================
+// Topological Sort
+// ============================================================================
+/**
+ * Topological sort of tasks respecting depends_on relationships.
+ * Returns tasks in execution order. Throws on circular dependencies.
+ */
+export function topologicalSort(tasks) {
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    const visited = new Set();
+    const inStack = new Set();
+    const sorted = [];
+    function visit(taskId) {
+        if (inStack.has(taskId)) {
+            throw new ValidationError(`Circular dependency detected involving task ${taskId}`);
+        }
+        if (visited.has(taskId))
+            return;
+        inStack.add(taskId);
+        const task = taskMap.get(taskId);
+        if (task) {
+            for (const dep of task.depends_on) {
+                if (taskMap.has(dep)) {
+                    visit(dep);
+                }
+            }
+            visited.add(taskId);
+            sorted.push(task);
+        }
+        inStack.delete(taskId);
+    }
+    for (const task of tasks) {
+        visit(task.id);
+    }
+    return sorted;
+}
+// ============================================================================
+// Dependency Resolution
+// ============================================================================
+/**
+ * Check if all dependencies of a task are met (completed or skipped).
+ */
+export function allDependenciesMet(task, tasks) {
+    if (task.depends_on.length === 0)
+        return true;
+    const taskMap = new Map(tasks.map((t) => [t.id, t]));
+    for (const depId of task.depends_on) {
+        const dep = taskMap.get(depId);
+        if (!dep)
+            continue; // Missing dep — treat as met (warning elsewhere)
+        if (dep.status !== 'completed' && dep.status !== 'skipped') {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Validate the task graph before execution.
+ * Checks for: circular deps, invalid refs, file overlaps without deps.
+ */
+export function validateTaskGraph(tasks) {
+    const warnings = [];
+    const errors = [];
+    const taskIds = new Set(tasks.map((t) => t.id));
+    // 1. Check for circular dependencies
+    try {
+        topologicalSort(tasks);
+    }
+    catch (e) {
+        errors.push(e instanceof Error ? e.message : String(e));
+    }
+    // 2. Check for invalid dependency references
+    for (const task of tasks) {
+        for (const dep of task.depends_on) {
+            if (!taskIds.has(dep)) {
+                errors.push(`Task ${task.id} depends on non-existent task ${dep}`);
+            }
+        }
+    }
+    // 3. Check for file overlap without dependency
+    for (let i = 0; i < tasks.length; i++) {
+        for (let j = i + 1; j < tasks.length; j++) {
+            const a = tasks[i];
+            const b = tasks[j];
+            const overlap = a.files_to_modify.filter((f) => b.files_to_modify.includes(f));
+            if (overlap.length > 0) {
+                const hasDep = a.depends_on.includes(b.id) || b.depends_on.includes(a.id);
+                if (!hasDep) {
+                    warnings.push(`Tasks ${a.id} and ${b.id} both modify ${overlap.join(', ')} but have no dependency`);
+                }
+            }
+        }
+    }
+    // 4. Check for tasks with no files_to_modify
+    for (const task of tasks) {
+        if (task.files_to_modify.length === 0) {
+            warnings.push(`Task ${task.id} "${task.title}": no files_to_modify predicted`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        warnings,
+        errors,
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/lib/prd/scheduler.js.map

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

package/dist/lib/prd/state.d.ts

@@ -0,0 +1,77 @@
+/**
+ * PRD State Management
+ *
+ * File-based CRUD for PRD state in .succ/prds/.
+ * NOT using StorageBackend — this is file-based like Ralph.
+ * .succ/prds/ should be in .gitignore (state management, not code).
+ */
+import type { Prd, PrdExecution, PrdIndexEntry, Task } from './types.js';
+/**
+ * Ensure .succ/prds/ directory exists
+ */
+export declare function ensurePrdsDir(): void;
+/**
+ * Load the PRD index (list of all PRDs)
+ */
+export declare function loadIndex(): PrdIndexEntry[];
+/**
+ * Save a PRD (creates directory, writes prd.json, updates index)
+ */
+export declare function savePrd(prd: Prd): void;
+/**
+ * Load a PRD by ID
+ */
+export declare function loadPrd(prdId: string): Prd | null;
+/**
+ * Delete a PRD and all its files
+ */
+export declare function deletePrd(prdId: string): void;
+/**
+ * List all PRDs (from index)
+ */
+export declare function listPrds(includeArchived?: boolean): PrdIndexEntry[];
+/**
+ * Find the most recent PRD (for commands without explicit ID)
+ */
+export declare function findLatestPrd(): PrdIndexEntry | null;
+/**
+ * Save the PRD markdown content
+ */
+export declare function savePrdMarkdown(prdId: string, content: string): void;
+/**
+ * Load the PRD markdown content
+ */
+export declare function loadPrdMarkdown(prdId: string): string | null;
+/**
+ * Save tasks for a PRD
+ */
+export declare function saveTasks(prdId: string, tasks: Task[]): void;
+/**
+ * Load tasks for a PRD
+ */
+export declare function loadTasks(prdId: string): Task[];
+/**
+ * Save execution state
+ */
+export declare function saveExecution(execution: PrdExecution): void;
+/**
+ * Load execution state
+ */
+export declare function loadExecution(prdId: string): PrdExecution | null;
+/**
+ * Append a line to progress.md
+ */
+export declare function appendProgress(prdId: string, line: string): void;
+/**
+ * Load progress.md content
+ */
+export declare function loadProgress(prdId: string): string;
+/**
+ * Get the path for a task log file
+ */
+export declare function getTaskLogPath(prdId: string, taskId: string): string;
+/**
+ * Append output to a task log
+ */
+export declare function appendTaskLog(prdId: string, taskId: string, content: string): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/lib/prd/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA+CzE;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAoBD;;GAEG;AACH,wBAAgB,SAAS,IAAI,aAAa,EAAE,CAM3C;AAoCD;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAKtC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAMjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM7C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,eAAe,UAAQ,GAAG,aAAa,EAAE,CAIjE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,GAAG,IAAI,CAIpD;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI5D;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAG5D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAI/C;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,CAG3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIhE;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGlF"}

package/dist/lib/prd/state.js

@@ -0,0 +1,253 @@
+/**
+ * PRD State Management
+ *
+ * File-based CRUD for PRD state in .succ/prds/.
+ * NOT using StorageBackend — this is file-based like Ralph.
+ * .succ/prds/ should be in .gitignore (state management, not code).
+ */
+import fs from 'fs';
+import path from 'path';
+import { getSuccDir } from '../config.js';
+import { prdToIndexEntry } from './types.js';
+// ============================================================================
+// Path helpers
+// ============================================================================
+function getPrdsDir() {
+    return path.join(getSuccDir(), 'prds');
+}
+function getPrdDir(prdId) {
+    return path.join(getPrdsDir(), prdId);
+}
+function getIndexPath() {
+    return path.join(getPrdsDir(), 'index.json');
+}
+function getPrdJsonPath(prdId) {
+    return path.join(getPrdDir(prdId), 'prd.json');
+}
+function getPrdMdPath(prdId) {
+    return path.join(getPrdDir(prdId), 'prd.md');
+}
+function getTasksPath(prdId) {
+    return path.join(getPrdDir(prdId), 'tasks.json');
+}
+function getExecutionPath(prdId) {
+    return path.join(getPrdDir(prdId), 'execution.json');
+}
+function getProgressPath(prdId) {
+    return path.join(getPrdDir(prdId), 'progress.md');
+}
+function getLogsDir(prdId) {
+    return path.join(getPrdDir(prdId), 'logs');
+}
+// ============================================================================
+// Directory setup
+// ============================================================================
+/**
+ * Ensure .succ/prds/ directory exists
+ */
+export function ensurePrdsDir() {
+    const dir = getPrdsDir();
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Ensure a specific PRD directory exists with logs subdirectory
+ */
+function ensurePrdDir(prdId) {
+    const dir = getPrdDir(prdId);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const logsDir = getLogsDir(prdId);
+    if (!fs.existsSync(logsDir)) {
+        fs.mkdirSync(logsDir, { recursive: true });
+    }
+}
+// ============================================================================
+// Index operations
+// ============================================================================
+/**
+ * Load the PRD index (list of all PRDs)
+ */
+export function loadIndex() {
+    const indexPath = getIndexPath();
+    if (!fs.existsSync(indexPath)) {
+        return [];
+    }
+    return JSON.parse(fs.readFileSync(indexPath, 'utf-8'));
+}
+/**
+ * Save the PRD index
+ */
+function saveIndex(entries) {
+    ensurePrdsDir();
+    fs.writeFileSync(getIndexPath(), JSON.stringify(entries, null, 2));
+}
+/**
+ * Update or add an entry in the index
+ */
+function upsertIndex(entry) {
+    const entries = loadIndex();
+    const idx = entries.findIndex((e) => e.id === entry.id);
+    if (idx >= 0) {
+        entries[idx] = entry;
+    }
+    else {
+        entries.push(entry);
+    }
+    saveIndex(entries);
+}
+/**
+ * Remove an entry from the index
+ */
+function removeFromIndex(prdId) {
+    const entries = loadIndex().filter((e) => e.id !== prdId);
+    saveIndex(entries);
+}
+// ============================================================================
+// PRD CRUD
+// ============================================================================
+/**
+ * Save a PRD (creates directory, writes prd.json, updates index)
+ */
+export function savePrd(prd) {
+    ensurePrdDir(prd.id);
+    prd.updated_at = new Date().toISOString();
+    fs.writeFileSync(getPrdJsonPath(prd.id), JSON.stringify(prd, null, 2));
+    upsertIndex(prdToIndexEntry(prd));
+}
+/**
+ * Load a PRD by ID
+ */
+export function loadPrd(prdId) {
+    const jsonPath = getPrdJsonPath(prdId);
+    if (!fs.existsSync(jsonPath)) {
+        return null;
+    }
+    return JSON.parse(fs.readFileSync(jsonPath, 'utf-8'));
+}
+/**
+ * Delete a PRD and all its files
+ */
+export function deletePrd(prdId) {
+    const dir = getPrdDir(prdId);
+    if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    removeFromIndex(prdId);
+}
+/**
+ * List all PRDs (from index)
+ */
+export function listPrds(includeArchived = false) {
+    const entries = loadIndex();
+    if (includeArchived)
+        return entries;
+    return entries.filter((e) => e.status !== 'archived');
+}
+/**
+ * Find the most recent PRD (for commands without explicit ID)
+ */
+export function findLatestPrd() {
+    const entries = loadIndex().filter((e) => e.status !== 'archived');
+    if (entries.length === 0)
+        return null;
+    return entries.sort((a, b) => b.updated_at.localeCompare(a.updated_at))[0];
+}
+// ============================================================================
+// PRD Markdown
+// ============================================================================
+/**
+ * Save the PRD markdown content
+ */
+export function savePrdMarkdown(prdId, content) {
+    ensurePrdDir(prdId);
+    fs.writeFileSync(getPrdMdPath(prdId), content, 'utf-8');
+}
+/**
+ * Load the PRD markdown content
+ */
+export function loadPrdMarkdown(prdId) {
+    const mdPath = getPrdMdPath(prdId);
+    if (!fs.existsSync(mdPath))
+        return null;
+    return fs.readFileSync(mdPath, 'utf-8');
+}
+// ============================================================================
+// Tasks
+// ============================================================================
+/**
+ * Save tasks for a PRD
+ */
+export function saveTasks(prdId, tasks) {
+    ensurePrdDir(prdId);
+    fs.writeFileSync(getTasksPath(prdId), JSON.stringify(tasks, null, 2));
+}
+/**
+ * Load tasks for a PRD
+ */
+export function loadTasks(prdId) {
+    const tasksPath = getTasksPath(prdId);
+    if (!fs.existsSync(tasksPath))
+        return [];
+    return JSON.parse(fs.readFileSync(tasksPath, 'utf-8'));
+}
+// ============================================================================
+// Execution state
+// ============================================================================
+/**
+ * Save execution state
+ */
+export function saveExecution(execution) {
+    ensurePrdDir(execution.prd_id);
+    fs.writeFileSync(getExecutionPath(execution.prd_id), JSON.stringify(execution, null, 2));
+}
+/**
+ * Load execution state
+ */
+export function loadExecution(prdId) {
+    const execPath = getExecutionPath(prdId);
+    if (!fs.existsSync(execPath))
+        return null;
+    return JSON.parse(fs.readFileSync(execPath, 'utf-8'));
+}
+// ============================================================================
+// Progress log
+// ============================================================================
+/**
+ * Append a line to progress.md
+ */
+export function appendProgress(prdId, line) {
+    ensurePrdDir(prdId);
+    const progressPath = getProgressPath(prdId);
+    const timestamp = new Date().toISOString().slice(0, 19).replace('T', ' ');
+    fs.appendFileSync(progressPath, `[${timestamp}] ${line}\n`);
+}
+/**
+ * Load progress.md content
+ */
+export function loadProgress(prdId) {
+    const progressPath = getProgressPath(prdId);
+    if (!fs.existsSync(progressPath))
+        return '';
+    return fs.readFileSync(progressPath, 'utf-8');
+}
+// ============================================================================
+// Task logs
+// ============================================================================
+/**
+ * Get the path for a task log file
+ */
+export function getTaskLogPath(prdId, taskId) {
+    ensurePrdDir(prdId);
+    return path.join(getLogsDir(prdId), `${taskId}.log`);
+}
+/**
+ * Append output to a task log
+ */
+export function appendTaskLog(prdId, taskId, content) {
+    const logPath = getTaskLogPath(prdId, taskId);
+    fs.appendFileSync(logPath, content);
+}
+//# sourceMappingURL=state.js.map

package/dist/lib/prd/state.js.map

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

package/dist/lib/prd/team-runner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Team Runner — Parallel Task Execution
+ *
+ * Orchestrates concurrent Claude processes, each in an isolated git worktree.
+ * - Parallel dispatch with configurable concurrency limit
+ * - File conflict prevention via files_to_modify overlap check
+ * - Serial merge back to PRD branch after each task completes
+ * - Quality gates per task (run in the worktree)
+ * - Deadlock detection and critical task abort
+ */
+import { LoopExecutor, WSExecutor } from './executor.js';
+import type { ExecuteResult } from './executor.js';
+import type { Prd, Task, PrdExecution } from './types.js';
+export interface TeamRunOptions {
+    concurrency: number;
+    model: string;
+    prdId: string;
+    root: string;
+    prd: Prd;
+    execution: PrdExecution;
+}
+export interface RunningTask {
+    task: Task;
+    executor: LoopExecutor | WSExecutor;
+    promise: Promise<WorkerResult>;
+    worktreePath: string;
+}
+interface WorkerResult {
+    task: Task;
+    result: ExecuteResult;
+    worktreePath: string;
+}
+/**
+ * Get tasks that can be dispatched right now.
+ *
+ * A task is ready when:
+ * 1. status is 'pending'
+ * 2. all dependencies are met (completed/skipped)
+ * 3. no files_to_modify overlap with currently running tasks
+ * 4. hasn't exhausted max_attempts
+ */
+export declare function getReadyTasks(tasks: Task[], runningTasks: RunningTask[]): Task[];
+/**
+ * Run tasks in parallel with worktree isolation.
+ */
+export declare function runTeam(tasks: Task[], options: TeamRunOptions): Promise<void>;
+export {};
+//# sourceMappingURL=team-runner.d.ts.map

package/dist/lib/prd/team-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/team-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,eAAe,CAAC;AAgBnE,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAYvE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAsBhF;AAMD;;GAEG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FnF"}