@vinaes/succ 1.3.19

package/dist/lib/prd/executor.js

@@ -0,0 +1,154 @@
+/**
+ * Agent Executor
+ *
+ * Thin abstraction over cross-spawn for running Claude Code CLI.
+ * Uses `-p --no-session-persistence` with SUCC_SERVICE_SESSION env marker,
+ * matching the canonical pattern from llm.ts (buildClaudeArgs / CLAUDE_SPAWN_OPTIONS).
+ * Prompt is piped via stdin to avoid shell escaping issues.
+ */
+import spawn from 'cross-spawn';
+import { processRegistry } from '../process-registry.js';
+// ============================================================================
+// Loop Executor (claude --print)
+// ============================================================================
+/**
+ * Executes tasks via `claude --print` — one-shot CLI invocation.
+ * Prompt is piped via stdin. Stdout is captured as the result.
+ */
+export class LoopExecutor {
+    process = null;
+    aborted = false;
+    async execute(prompt, options) {
+        this.aborted = false;
+        const start = Date.now();
+        // Build args matching llm.ts pattern: -p, --no-session-persistence
+        const args = ['-p', '--no-session-persistence'];
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        if (options.permissionMode && options.permissionMode !== 'default') {
+            args.push('--permission-mode', options.permissionMode);
+        }
+        if (options.allowedTools && options.allowedTools.length > 0) {
+            args.push('--allowedTools', options.allowedTools.join(','));
+        }
+        // Pass MCP server config so spawned claude can access succ tools
+        if (options.mcpConfig && Object.keys(options.mcpConfig).length > 0) {
+            const mcpJson = JSON.stringify({ mcpServers: options.mcpConfig });
+            args.push('--mcp-config', mcpJson);
+        }
+        return new Promise((resolve) => {
+            const chunks = [];
+            let resolved = false;
+            const finish = (exit_code) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                this.process = null;
+                resolve({
+                    success: exit_code === 0 && !this.aborted,
+                    output: chunks.join(''),
+                    duration_ms: Date.now() - start,
+                    exit_code,
+                });
+            };
+            try {
+                this.process = spawn('claude', args, {
+                    cwd: options.cwd,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    env: { ...process.env, SUCC_SERVICE_SESSION: '1' },
+                    windowsHide: true,
+                });
+                if (this.process.pid)
+                    processRegistry.register(this.process.pid, 'claude-prd');
+                // Write prompt to stdin and close it
+                if (this.process.stdin) {
+                    this.process.stdin.write(prompt);
+                    this.process.stdin.end();
+                }
+                // Timeout handling
+                const timer = setTimeout(() => {
+                    if (!resolved && this.process) {
+                        this.process.kill('SIGTERM');
+                        chunks.push('\n[TIMEOUT] Task exceeded time limit\n');
+                        finish(124); // Standard timeout exit code
+                    }
+                }, options.timeout_ms);
+                this.process.stdout?.on('data', (data) => {
+                    const text = data.toString();
+                    chunks.push(text);
+                    options.onOutput?.(text);
+                });
+                this.process.stderr?.on('data', (data) => {
+                    const text = data.toString();
+                    chunks.push(text);
+                    options.onOutput?.(text);
+                });
+                this.process.on('close', (code) => {
+                    clearTimeout(timer);
+                    if (this.process?.pid)
+                        processRegistry.unregister(this.process.pid);
+                    finish(code ?? 1);
+                });
+                this.process.on('error', (err) => {
+                    clearTimeout(timer);
+                    if (this.process?.pid)
+                        processRegistry.unregister(this.process.pid);
+                    chunks.push(`\n[ERROR] ${err.message}\n`);
+                    finish(1);
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                chunks.push(`\n[SPAWN ERROR] ${msg}\n`);
+                finish(1);
+            }
+        });
+    }
+    abort() {
+        this.aborted = true;
+        if (this.process) {
+            this.process.kill('SIGTERM');
+        }
+    }
+}
+// ============================================================================
+// WebSocket Executor (claude --sdk-url, persistent connection)
+// ============================================================================
+/**
+ * Executes tasks via WebSocket transport to Claude CLI.
+ * Uses the persistent ClaudeWSTransport singleton — no process-per-call overhead.
+ *
+ * Protocol based on reverse-engineering by The-Vibe-Company/companion:
+ * https://github.com/The-Vibe-Company/companion
+ */
+export class WSExecutor {
+    async execute(prompt, options) {
+        const start = Date.now();
+        try {
+            const { ClaudeWSTransport } = await import('../claude-ws-transport.js');
+            const transport = await ClaudeWSTransport.getInstance();
+            const output = await transport.send(prompt, {
+                timeout: options.timeout_ms,
+            });
+            return {
+                success: true,
+                output,
+                duration_ms: Date.now() - start,
+                exit_code: 0,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: err instanceof Error ? err.message : String(err),
+                duration_ms: Date.now() - start,
+                exit_code: 1,
+            };
+        }
+    }
+    abort() {
+        // Future: send interrupt control_request via ClaudeWSTransport
+    }
+}
+//# sourceMappingURL=executor.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * PRD Export — Obsidian-compatible Mermaid workflow visualization
+ *
+ * Generates markdown files with Mermaid diagrams (Gantt timeline, dependency DAG)
+ * and per-task detail pages from PRD execution data.
+ */
+import type { Prd, Task, PrdExecution } from './types.js';
+export interface ExportResult {
+    prdId: string;
+    filesCreated: number;
+    outputDir: string;
+}
+/**
+ * Export a single PRD to Obsidian-compatible markdown with Mermaid diagrams.
+ * If prdId is not given, uses the latest PRD.
+ */
+export declare function exportPrdToObsidian(prdId?: string, outputDir?: string): ExportResult;
+/**
+ * Export all PRDs to Obsidian.
+ */
+export declare function exportAllPrds(outputDir?: string, includeArchived?: boolean): ExportResult[];
+/**
+ * Generate Mermaid gantt chart for task execution timeline.
+ * Exported for testing.
+ */
+export declare function generateGanttChart(prd: Prd, tasks: Task[], execution: PrdExecution | null): string;
+/**
+ * Generate Mermaid flowchart for task dependencies.
+ * Exported for testing.
+ */
+export declare function generateDependencyGraph(tasks: Task[]): string;
+/**
+ * Format ms duration as human-readable string. Exported for testing.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Sanitize text for use in Mermaid diagrams. Exported for testing.
+ */
+export declare function sanitizeMermaid(text: string): string;
+//# sourceMappingURL=export.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/lib/prd/export.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAqCpF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,UAAO,GAAG,YAAY,EAAE,CAexF;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,YAAY,GAAG,IAAI,GAC7B,MAAM,CAqCR;AAiGD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CA0C7D;AA0RD;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAUjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD"}