@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/dashboard/adversarial-runner.js

@@ -0,0 +1,168 @@
+import { EventEmitter } from 'events';
+import { spawn } from 'child_process';
+import { promises as fs } from 'fs';
+import { randomUUID } from 'crypto';
+const JOB_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes per review run
+const MAX_CONCURRENT_PER_PROJECT = 2;
+export class AdversarialRunner extends EventEmitter {
+    jobs = new Map();
+    processes = new Map();
+    timeouts = new Map();
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    getJobsForProject(projectId) {
+        return Array.from(this.jobs.values()).filter(j => j.projectId === projectId);
+    }
+    getActiveJobsForProject(projectId) {
+        return this.getJobsForProject(projectId).filter(j => j.status === 'pending' || j.status === 'running-review');
+    }
+    async run(opts) {
+        // Check concurrency limit
+        const activeJobs = this.getActiveJobsForProject(opts.projectId);
+        if (activeJobs.length >= MAX_CONCURRENT_PER_PROJECT) {
+            throw new Error(`Maximum ${MAX_CONCURRENT_PER_PROJECT} concurrent adversarial reviews per project. Wait for a running review to complete.`);
+        }
+        // Check for duplicate (same spec+phase already running)
+        const duplicate = activeJobs.find(j => j.specName === opts.specName && j.phase === opts.phase);
+        if (duplicate) {
+            throw new Error(`An adversarial review is already running for ${opts.specName}/${opts.phase}`);
+        }
+        const jobId = randomUUID();
+        const job = {
+            id: jobId,
+            projectId: opts.projectId,
+            specName: opts.specName,
+            phase: opts.phase,
+            status: 'pending',
+            startedAt: new Date().toISOString(),
+            analysisOutputPath: opts.analysisOutputPath,
+            promptOutputPath: opts.promptOutputPath,
+            targetFile: opts.targetFile,
+            model: opts.model,
+        };
+        this.jobs.set(jobId, job);
+        this.emit('job-update', job);
+        // Run the review in the background
+        this.executeJob(jobId, opts).catch(err => {
+            console.error(`[AdversarialRunner] Job ${jobId} failed:`, err);
+        });
+        return jobId;
+    }
+    async executeJob(jobId, opts) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return;
+        try {
+            // The scaffold prompt is written to disk by adversarialReviewHandler before run() is called.
+            try {
+                await fs.access(opts.promptOutputPath);
+            }
+            catch {
+                throw new Error(`Adversarial prompt file not found at ${opts.promptOutputPath}`);
+            }
+            job.status = 'running-review';
+            this.emit('job-update', { ...job });
+            const reviewInstructions = `Read and execute the instructions in ${opts.promptOutputPath}`;
+            await this.runAgent(jobId, opts.projectPath, reviewInstructions, opts);
+            // Verify the analysis file was written
+            try {
+                await fs.access(opts.analysisOutputPath);
+            }
+            catch {
+                throw new Error(`Review completed but analysis file was not created at ${opts.analysisOutputPath}`);
+            }
+            job.status = 'completed';
+            job.completedAt = new Date().toISOString();
+            this.emit('job-update', { ...job });
+        }
+        catch (err) {
+            job.status = 'failed';
+            job.error = err.message || 'Unknown error';
+            job.completedAt = new Date().toISOString();
+            this.emit('job-update', { ...job });
+        }
+        finally {
+            this.cleanupProcess(jobId);
+        }
+    }
+    runAgent(jobId, cwd, prompt, opts) {
+        const cli = opts.cli || 'claude';
+        const baseArgs = opts.cliArgs || ['--print', '--dangerously-skip-permissions'];
+        return new Promise((resolve, reject) => {
+            const args = [...baseArgs];
+            if (opts.model) {
+                args.push('--model', opts.model);
+            }
+            args.push(prompt);
+            const child = spawn(cli, args, {
+                cwd,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: { ...process.env },
+            });
+            this.processes.set(jobId, child);
+            // Set timeout
+            const timeout = setTimeout(() => {
+                child.kill('SIGTERM');
+                reject(new Error(`Agent process timed out after 10 minutes`));
+            }, JOB_TIMEOUT_MS);
+            this.timeouts.set(jobId, timeout);
+            let stderr = '';
+            child.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                clearTimeout(timeout);
+                this.timeouts.delete(jobId);
+                this.processes.delete(jobId);
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Agent process exited with code ${code}${stderr ? `: ${stderr.slice(0, 500)}` : ''}`));
+                }
+            });
+            child.on('error', (err) => {
+                clearTimeout(timeout);
+                this.timeouts.delete(jobId);
+                this.processes.delete(jobId);
+                if (err.code === 'ENOENT') {
+                    reject(new Error(`CLI "${cli}" not found. Ensure it is installed and available in PATH.`));
+                }
+                else {
+                    reject(err);
+                }
+            });
+        });
+    }
+    cancelJob(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job || job.status === 'completed' || job.status === 'failed') {
+            return false;
+        }
+        this.cleanupProcess(jobId);
+        job.status = 'failed';
+        job.error = 'Cancelled by user';
+        job.completedAt = new Date().toISOString();
+        this.emit('job-update', { ...job });
+        return true;
+    }
+    cleanupProcess(jobId) {
+        const child = this.processes.get(jobId);
+        if (child) {
+            child.kill('SIGTERM');
+            this.processes.delete(jobId);
+        }
+        const timeout = this.timeouts.get(jobId);
+        if (timeout) {
+            clearTimeout(timeout);
+            this.timeouts.delete(jobId);
+        }
+    }
+    shutdown() {
+        for (const [jobId] of this.processes) {
+            this.cleanupProcess(jobId);
+        }
+    }
+}
+//# sourceMappingURL=adversarial-runner.js.map

package/dist/dashboard/adversarial-runner.js.map

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

package/dist/dashboard/approval-storage.d.ts

@@ -0,0 +1,139 @@
+import { EventEmitter } from 'events';
+export interface ApprovalComment {
+    type: 'selection' | 'general';
+    selectedText?: string;
+    comment: string;
+    timestamp: string;
+    lineNumber?: number;
+    characterPosition?: number;
+    highlightColor?: string;
+}
+export interface DocumentSnapshot {
+    id: string;
+    approvalId: string;
+    approvalTitle: string;
+    version: number;
+    timestamp: string;
+    trigger: 'initial' | 'revision_requested' | 'approved' | 'manual';
+    status: 'pending' | 'approved' | 'rejected' | 'needs-revision';
+    content: string;
+    fileStats: {
+        size: number;
+        lines: number;
+        lastModified: string;
+    };
+    comments?: ApprovalComment[];
+    annotations?: string;
+}
+export interface SnapshotMetadata {
+    approvalId: string;
+    currentVersion: number;
+    snapshots: {
+        version: number;
+        filename: string;
+        timestamp: string;
+        trigger: string;
+    }[];
+}
+export interface FileSnapshotMetadata {
+    filePath: string;
+    currentVersion: number;
+    snapshots: {
+        version: number;
+        filename: string;
+        timestamp: string;
+        trigger: string;
+        approvalId: string;
+        approvalTitle: string;
+    }[];
+}
+export interface DiffResult {
+    additions: number;
+    deletions: number;
+    changes: number;
+    chunks: DiffChunk[];
+}
+export interface DiffChunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffLine[];
+}
+export interface DiffLine {
+    type: 'add' | 'delete' | 'normal';
+    oldLineNumber?: number;
+    newLineNumber?: number;
+    content: string;
+}
+export interface ApprovalRequest {
+    id: string;
+    title: string;
+    filePath: string;
+    type: 'document' | 'action';
+    status: 'pending' | 'approved' | 'rejected' | 'needs-revision';
+    createdAt: string;
+    respondedAt?: string;
+    response?: string;
+    annotations?: string;
+    comments?: ApprovalComment[];
+    revisionHistory?: {
+        version: number;
+        content: string;
+        timestamp: string;
+        reason?: string;
+    }[];
+    metadata?: Record<string, any>;
+    category: 'spec' | 'steering' | 'decomposition';
+    categoryName: string;
+}
+export declare class ApprovalStorage extends EventEmitter {
+    projectPath: string;
+    originalProjectPath: string;
+    fileResolutionPath: string;
+    private approvalsDir;
+    private watcher?;
+    private pendingEmit;
+    private readonly DEBOUNCE_MS;
+    constructor(translatedPath: string, options?: {
+        originalPath?: string;
+        fileResolutionPath?: string;
+    });
+    start(): Promise<void>;
+    /**
+     * Schedule a debounced approval-change event emission
+     * Coalesces rapid changes to prevent event flooding
+     */
+    private scheduleApprovalChangeEmit;
+    stop(): Promise<void>;
+    /**
+     * Candidate resolution order for relative approval file paths:
+     * 1) Workspace/worktree base (fileResolutionPath)
+     * 2) Shared workflow root (projectPath)
+     */
+    private getFilePathCandidates;
+    private resolveExistingFilePath;
+    private resolveFilePathForWrite;
+    createApproval(title: string, filePath: string, category: 'spec' | 'steering' | 'decomposition', categoryName: string, type?: 'document' | 'action', metadata?: Record<string, any>): Promise<string>;
+    getApproval(id: string): Promise<ApprovalRequest | null>;
+    private findApprovalPath;
+    updateApproval(id: string, status: 'approved' | 'rejected' | 'needs-revision', response: string, annotations?: string, comments?: ApprovalComment[]): Promise<void>;
+    /**
+     * Revert an approval back to pending status, clearing response and timestamp
+     * Used for undo operations after batch approvals/rejections
+     */
+    revertToPending(id: string): Promise<void>;
+    createRevision(originalId: string, newContent: string, reason?: string): Promise<string>;
+    getAllPendingApprovals(): Promise<ApprovalRequest[]>;
+    getAllApprovals(): Promise<ApprovalRequest[]>;
+    deleteApproval(id: string): Promise<boolean>;
+    cleanupOldApprovals(maxAgeDays?: number): Promise<void>;
+    captureSnapshot(approvalId: string, trigger: 'initial' | 'revision_requested' | 'approved' | 'manual'): Promise<void>;
+    getSnapshots(approvalId: string): Promise<DocumentSnapshot[]>;
+    getSnapshot(approvalId: string, version: number): Promise<DocumentSnapshot | null>;
+    getCurrentFileContent(approvalId: string): Promise<string | null>;
+    compareSnapshots(approvalId: string, fromVersion: number, toVersion: number | 'current'): Promise<DiffResult>;
+    private generateSnapshotId;
+    private generateId;
+}
+//# sourceMappingURL=approval-storage.d.ts.map

package/dist/dashboard/approval-storage.d.ts.map

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