@madmatt112org/spec-workflow-mcp 3.0.0

package/dist/tools/adversarial-review.js

@@ -0,0 +1,491 @@
+import { PathUtils } from '../core/path-utils.js';
+import { promises as fs } from 'fs';
+import { join } from 'path';
+export const adversarialReviewTool = {
+    name: 'adversarial-review',
+    description: `Prepare an adversarial review of a spec phase document, steering document, or spec decomposition.
+
+# Instructions
+Use this tool to set up an adversarial analysis of a requirements, design, tasks, steering,
+or decomposition document. The tool writes a self-contained adversarial prompt to disk and returns
+the output paths. Launch a fresh-context subagent with: "Read and execute the instructions in
+<promptOutputPath>." Context separation ensures genuinely critical output — the subagent reads
+the target document and chooses its attack dimensions in its first turn.
+
+For decomposition reviews, use specName: "decomposition" and phase: "decomposition".`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            specName: {
+                type: 'string',
+                description: 'Name of the spec to review (kebab-case), "steering" for steering documents, or "decomposition" for spec decomposition'
+            },
+            phase: {
+                type: 'string',
+                description: 'Which document to target (e.g. requirements, design, tasks for specs; product, tech, structure for steering; decomposition for spec decomposition)'
+            },
+            filePath: {
+                type: 'string',
+                description: 'Relative path to the target file (optional — used for steering docs whose files live outside the steering directory)'
+            },
+            projectPath: {
+                type: 'string',
+                description: 'Absolute path to the project root (optional - uses server context path if not provided)'
+            }
+        },
+        required: ['specName', 'phase'],
+        additionalProperties: false
+    },
+    annotations: {
+        title: 'Adversarial Review',
+        readOnlyHint: false,
+    }
+};
+export async function adversarialReviewHandler(args, context) {
+    const { specName, phase } = args;
+    const projectPath = args.projectPath || context.projectPath;
+    if (!specName || typeof specName !== 'string') {
+        return { success: false, message: 'specName is required and must be a string' };
+    }
+    if (!phase || typeof phase !== 'string') {
+        return { success: false, message: 'phase is required and must be a string' };
+    }
+    const workflowRoot = PathUtils.getWorkflowRoot(projectPath);
+    // Determine paths based on document type
+    const isSteering = specName === 'steering';
+    const isDecomposition = specName === 'decomposition' || specName === 'spec-decomposition'
+        || phase === 'decomposition'
+        || (args.filePath && args.filePath.includes('spec-decomposition/'));
+    let docDir;
+    let targetFile;
+    let reviewsDir;
+    if (isDecomposition) {
+        docDir = join(workflowRoot, 'spec-decomposition');
+        targetFile = join(docDir, 'decomposition.md');
+        reviewsDir = join(docDir, 'reviews');
+    }
+    else if (isSteering) {
+        docDir = join(workflowRoot, 'steering');
+        targetFile = args.filePath
+            ? join(projectPath, args.filePath)
+            : join(docDir, `${phase}.md`);
+        reviewsDir = join(docDir, 'reviews');
+    }
+    else {
+        docDir = join(workflowRoot, 'specs', specName);
+        targetFile = join(docDir, `${phase}.md`);
+        reviewsDir = join(docDir, 'reviews');
+    }
+    // Validate target file exists
+    try {
+        await fs.access(targetFile);
+    }
+    catch {
+        return {
+            success: false,
+            message: `Target file not found: ${targetFile}`
+        };
+    }
+    // Create reviews directory if needed
+    await fs.mkdir(reviewsDir, { recursive: true });
+    // Determine version by scanning existing files
+    const versionPhase = isDecomposition ? 'decomposition' : phase;
+    const version = await getNextVersion(reviewsDir, versionPhase);
+    const versionSuffix = version === 1 ? '' : `-r${version}`;
+    const promptOutputPath = join(reviewsDir, `adversarial-prompt-${versionPhase}${versionSuffix}.md`);
+    const analysisOutputPath = join(reviewsDir, `adversarial-analysis-${versionPhase}${versionSuffix}.md`);
+    // Find existing steering docs and prior phase docs as context
+    const steeringDir = join(workflowRoot, 'steering');
+    let steeringDocs;
+    let priorPhaseDocs;
+    if (isDecomposition) {
+        // Decomposition reviews use steering docs as prior context
+        steeringDocs = [];
+        priorPhaseDocs = await findExistingFiles(steeringDir, ['product.md', 'tech.md', 'structure.md']);
+    }
+    else if (isSteering) {
+        steeringDocs = [];
+        priorPhaseDocs = [];
+    }
+    else {
+        steeringDocs = await findExistingFiles(steeringDir, ['product.md', 'tech.md', 'structure.md']);
+        priorPhaseDocs = await findPriorPhaseDocs(docDir, phase);
+    }
+    // Check for methodology override in settings
+    const methodology = await getMethodologyOverride(workflowRoot, 'reviewMethodology') || getAdversarialReviewMethodology();
+    // Memory context for v2+ reviews
+    const memoryFilePath = join(reviewsDir, `adversarial-memory-${versionPhase}.md`);
+    const latestAnalysisPath = version > 1
+        ? await findLatestAnalysis(reviewsDir, versionPhase)
+        : null;
+    const scaffold = buildScaffoldedPrompt({
+        specName: isDecomposition ? 'decomposition' : specName,
+        phase: versionPhase,
+        version,
+        targetFile,
+        analysisOutputPath,
+        memoryFilePath,
+        latestAnalysisPath,
+    });
+    try {
+        await fs.writeFile(promptOutputPath, scaffold, 'utf-8');
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Failed to write scaffolded prompt: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    return {
+        success: true,
+        message: isDecomposition
+            ? `Adversarial review prepared for spec decomposition (version ${version})`
+            : `Adversarial review prepared for ${specName}/${phase}.md (version ${version})`,
+        data: {
+            targetFile,
+            promptOutputPath,
+            analysisOutputPath,
+            version,
+            phase,
+            steeringDocs,
+            priorPhaseDocs,
+            methodology,
+            memoryFilePath,
+            latestAnalysisPath,
+        },
+        nextSteps: [
+            `Launch a fresh-context subagent with only: "Read and execute the instructions in ${promptOutputPath}"`,
+            `The subagent will write its analysis to ${analysisOutputPath}`,
+        ]
+    };
+}
+async function getNextVersion(reviewsDir, phase) {
+    try {
+        const files = await fs.readdir(reviewsDir);
+        const pattern = new RegExp(`^adversarial-analysis-${phase}(-r(\\d+))?\\.md$`);
+        let maxVersion = 0;
+        for (const file of files) {
+            const match = file.match(pattern);
+            if (match) {
+                const ver = match[2] ? parseInt(match[2], 10) : 1;
+                if (ver > maxVersion)
+                    maxVersion = ver;
+            }
+        }
+        return maxVersion === 0 ? 1 : maxVersion + 1;
+    }
+    catch {
+        return 1;
+    }
+}
+async function findLatestAnalysis(reviewsDir, phase) {
+    try {
+        const files = await fs.readdir(reviewsDir);
+        const pattern = new RegExp(`^adversarial-analysis-${phase}(-r(\\d+))?\\.md$`);
+        let maxVersion = 0;
+        let latestFile = null;
+        for (const file of files) {
+            const match = file.match(pattern);
+            if (match) {
+                const ver = match[2] ? parseInt(match[2], 10) : 1;
+                if (ver > maxVersion) {
+                    maxVersion = ver;
+                    latestFile = join(reviewsDir, file);
+                }
+            }
+        }
+        return latestFile;
+    }
+    catch {
+        return null;
+    }
+}
+async function findExistingFiles(dir, filenames) {
+    const found = [];
+    for (const filename of filenames) {
+        const filePath = join(dir, filename);
+        try {
+            await fs.access(filePath);
+            found.push(filePath);
+        }
+        catch {
+            // File doesn't exist, skip
+        }
+    }
+    return found;
+}
+async function findPriorPhaseDocs(specDir, currentPhase) {
+    const phaseOrder = ['requirements', 'design', 'tasks'];
+    const currentIndex = phaseOrder.indexOf(currentPhase);
+    const priorPhases = phaseOrder.slice(0, currentIndex);
+    return findExistingFiles(specDir, priorPhases.map(p => `${p}.md`));
+}
+async function getMethodologyOverride(workflowRoot, key) {
+    try {
+        const raw = await fs.readFile(join(workflowRoot, 'adversarial-settings.json'), 'utf-8');
+        const settings = JSON.parse(raw);
+        const value = settings[key];
+        return typeof value === 'string' && value.trim() ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export const PHASE_ATTACK_ANGLES = {
+    requirements: {
+        persona: 'senior technical product manager',
+        attackSurface: 'Completeness, ambiguity, scope',
+        exampleAngles: 'Missing user stories, unstated assumptions, scope creep risk, contradictions between stories, acceptance criteria that can\'t be tested',
+    },
+    design: {
+        persona: 'staff engineer',
+        attackSurface: 'Feasibility, consistency, edge cases',
+        exampleAngles: 'Conflicts with steering docs, unaddressed failure modes, scaling bottlenecks, missing error paths, alternatives not considered',
+    },
+    tasks: {
+        persona: 'senior delivery lead',
+        attackSurface: 'Atomicity, ordering, coverage',
+        exampleAngles: 'Tasks too large or too small, missing dependency edges, gaps between tasks and design, unclear completion criteria, tasks that don\'t map to any requirement',
+    },
+    decomposition: {
+        persona: 'principal architect',
+        attackSurface: 'Completeness, granularity, ordering',
+        exampleAngles: 'Missing specs, over-scoped specs, wrong dependency order, horizontal instead of vertical slicing, INVEST violations (specs not independently valuable), cross-spec convention gaps, unresolved open questions that block implementation',
+    },
+    product: {
+        persona: 'head of product',
+        attackSurface: 'Vision clarity, user value, market fit',
+        exampleAngles: 'Vague target users, unvalidated value propositions, missing success metrics, undifferentiated positioning, overlooked competitor capabilities',
+    },
+    tech: {
+        persona: 'principal engineer',
+        attackSurface: 'Architectural soundness, constraints, tradeoffs',
+        exampleAngles: 'Unjustified technology choices, missing non-functional requirements, hidden integration costs, scalability ceilings, security or compliance gaps',
+    },
+    structure: {
+        persona: 'engineering lead with deep codebase ownership',
+        attackSurface: 'Organization, conventions, maintainability',
+        exampleAngles: 'Inconsistent module layout, ambiguous ownership boundaries, conventions that conflict with the stack, missing patterns for shared concerns, hard-to-navigate hierarchies',
+    },
+};
+const GENERIC_PHASE_GUIDANCE = {
+    persona: 'experienced senior reviewer',
+    attackSurface: 'Completeness, consistency, and unstated assumptions',
+    exampleAngles: 'Missing context, contradictions, ambiguous language, unaddressed failure modes, alternatives that were not considered',
+};
+export function buildScaffoldedPrompt(args) {
+    const { specName, phase, version, targetFile, analysisOutputPath, memoryFilePath, latestAnalysisPath } = args;
+    const guidance = PHASE_ATTACK_ANGLES[phase] ?? GENERIC_PHASE_GUIDANCE;
+    const priorReviewSection = version > 1
+        ? `## Prior review context
+
+This is review v${version}. Before attacking the target document:
+
+1. Read the rolling memory file at ${memoryFilePath} (it may not exist yet — the file is created/updated by each v2+ review).
+${latestAnalysisPath ? `2. Read the latest prior analysis at ${latestAnalysisPath} to understand what was found most recently.` : `2. No prior analysis is available on disk — proceed without it.`}
+3. Classify each finding you produce as one of:
+   - **Novel**: not identified in any prior review.
+   - **Compounding**: builds on or deepens a prior finding.
+   - **Recurring**: same issue identified before but not yet resolved — escalate severity.
+4. Focus on novel and compounding issues. Do not re-discover known findings unless they remain unresolved.
+5. After completing your analysis, write an UPDATED memory file to ${memoryFilePath} using this format:
+
+\`\`\`markdown
+# Adversarial Review Memory — ${phase}
+Last updated: <today's date> (after v${version} review)
+
+## Cumulative Findings Summary
+### Accepted
+- <finding>: <brief description, which version identified it>
+
+### Partially Accepted
+- <finding>: <brief description, user's stance>
+
+### Rejected
+- <finding>: <brief description, reason for rejection>
+
+### Unresolved
+- <finding>: <not yet responded to>
+
+## Patterns & Themes
+- <high-level observations about recurring issues>
+
+## Guidance for Next Review
+- Focus areas based on what's been found
+- Areas that have been well-covered and don't need re-examination
+\`\`\`
+
+`
+        : '';
+    return `# Adversarial Review — ${specName}/${phase} (v${version})
+
+You are a ${guidance.persona}. Your job is to tear apart this document and find every weakness — gaps, ambiguities, contradictions, unstated assumptions, failure modes that have not been considered. Do not validate or support. Use directive framing throughout.
+
+## Target document
+${targetFile}
+
+${priorReviewSection}## Analysis approach
+
+Before writing your analysis, read the target document. Then identify **3–6 specific topics, decisions, or sections** to attack — name actual headings, claims, or structures from the document. For each, list **3–5 directive bullets** grounded in the document's concrete content. Frame bullets as directives ("Challenge the claim that…", "Stress-test the assumption that…"), not questions. Do not write generic advice.
+
+**Primary attack surface for this phase:** ${guidance.attackSurface}
+
+**Example attack angles to consider:** ${guidance.exampleAngles}
+
+## Closing deliverables
+- Top N risks/gaps (3 for short docs, 5 for long)
+- Top 3 conclusions to challenge or reverse, with reasoning
+- What's missing — work that should be done before acting on this document
+
+Be specific and concrete. Cite failure scenarios, not abstract risks. If something
+is actually fine, say so briefly and move on.
+
+## Output
+Write your analysis to: ${analysisOutputPath}
+`;
+}
+function renderPhaseAttackAnglesTable() {
+    const phaseLabels = {
+        requirements: 'Requirements',
+        design: 'Design',
+        tasks: 'Tasks',
+        decomposition: 'Decomposition',
+        product: 'Product',
+        tech: 'Tech',
+        structure: 'Structure',
+    };
+    const rows = Object.entries(PHASE_ATTACK_ANGLES).map(([key, guidance]) => {
+        const label = phaseLabels[key] ?? key;
+        return `| **${label}** | ${guidance.attackSurface} | ${guidance.exampleAngles} |`;
+    });
+    return rows.join('\n');
+}
+export function getAdversarialReviewMethodology() {
+    return `# Adversarial Review Methodology
+
+## Technique
+
+This follows the adversarial prompting technique where an AI critiques work in a fresh session
+with no collaborative history, producing genuinely critical output rather than defending prior
+contributions. The technique relies on **context separation** (fresh session) and **oppositional
+framing** (the prompt directs the agent to attack, not validate).
+
+Reference: https://www.fightingwithai.com/prompt-engineering/adversarial-prompting/
+
+## How to Generate the Adversarial Prompt
+
+Write a markdown file containing a prompt for a fresh agent session. The prompt must follow
+this structure:
+
+### Opening
+
+- Assign the reviewing agent a **senior expert persona** relevant to the document's domain.
+- State clearly that the agent's job is to find weaknesses, not to validate or support.
+- Use oppositional framing: "tear apart", "stress-test", "find every gap", etc.
+
+### Analysis Dimensions
+
+Create **3-6 numbered sections**, each targeting a specific aspect of the document. These must
+be **tailored to the document's actual content**, not generic. For each section:
+
+- Name the specific topic or decision being targeted.
+- Provide 3-5 bullet points with concrete attack angles: assumptions to challenge, failure
+  modes to explore, missing considerations to surface, alternatives that were dismissed or ignored.
+- Frame bullets as directives, not questions ("Challenge the claim that..." not "Do you think...").
+
+**Phase-specific attack angles:**
+
+| Phase | Primary attack surface | Example angles |
+|---|---|---|
+${renderPhaseAttackAnglesTable()}
+
+If steering docs or prior phase docs exist, read them to ground the attack angles in the
+project's actual constraints and decisions.
+
+### Closing Deliverables
+
+Ask the reviewing agent to conclude with:
+
+- **Top N risks/gaps** (scaled to document size — 3 for a short doc, 5 for a long one)
+- **Top 3 conclusions to challenge or reverse**, with specific reasoning
+- **What's missing** — work that should be done before acting on the document
+
+Include this directive: "Be specific and concrete. Cite failure scenarios, not abstract risks.
+If something is actually fine, say so briefly and move on."
+
+### Document Insertion Point
+
+End the prompt by telling the reviewing agent where to write its analysis and providing
+the target document path.
+
+## What to Avoid
+
+- **Don't make the prompt generic.** The analysis dimensions must reference specific topics,
+  claims, and structures from the target document.
+- **Don't include collaborative language.** No "please review" or "what do you think".
+  Use directive framing throughout.
+- **Don't leak context.** The prompt should not mention that it was generated by another AI
+  or that there's a prior session. It should read as if a human architect wrote it.
+- **Don't pad with praise directives.** No "highlight what's good". The entire point is
+  oppositional analysis.
+
+## Execution
+
+After writing the prompt file, launch a fresh-context subagent. The subagent prompt must be
+exactly: "Read and execute the instructions in <path-to-prompt-file>." Do not add any other
+context, summary, or instructions.
+
+## Working with Prior Review Context (v2+ Reviews)
+
+When a memory file path and latest analysis path are provided (version 2+), the prompt
+generation step has additional responsibilities:
+
+### Reading Prior Context
+- Read the memory file at the provided path (if it exists on disk — it won't exist for the
+  first v2 review, but will for v3+).
+- Read the latest analysis file to understand what was found in the most recent review.
+
+### Updating the Memory File
+After reading both, write an updated memory file that:
+- Incorporates findings from the latest analysis into a cumulative record.
+- Categorizes findings as: Accepted, Partially Accepted, Rejected, or Unresolved.
+- Notes patterns and themes across iterations.
+- Provides guidance for the next review's focus areas.
+
+Use this format:
+\`\`\`markdown
+# Adversarial Review Memory — {phase}
+Last updated: {date} (after v{N} review)
+
+## Cumulative Findings Summary
+### Accepted
+- [finding]: [brief description, which version identified it]
+
+### Partially Accepted
+- [finding]: [brief description, user's stance]
+
+### Rejected
+- [finding]: [brief description, reason for rejection]
+
+### Unresolved
+- [finding]: [not yet responded to]
+
+## Patterns & Themes
+- [high-level observations about recurring issues]
+
+## Guidance for Next Review
+- Focus areas based on what's been found
+- Areas that have been well-covered and don't need re-examination
+\`\`\`
+
+### Embedding Context in the Generated Prompt
+Add a "## Prior Review Context" section to the generated adversarial prompt containing:
+- A summary of what prior reviews found.
+- Which findings were addressed and which persist.
+- A directive to focus on novel issues, not re-discover known ones.
+- Instruction to classify each finding as one of:
+  - **Novel**: Not identified in any prior review.
+  - **Compounding**: Builds on or deepens a prior finding.
+  - **Recurring**: Same issue identified before but not yet resolved — severity should escalate.`;
+}
+//# sourceMappingURL=adversarial-review.js.map

package/dist/tools/adversarial-review.js.map

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

package/dist/tools/approvals.d.ts

@@ -0,0 +1,14 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ToolContext, ToolResponse } from '../types.js';
+export declare const approvalsTool: Tool;
+export declare function approvalsHandler(args: {
+    action: 'request' | 'status' | 'delete';
+    projectPath?: string;
+    approvalId?: string;
+    title?: string;
+    filePath?: string;
+    type?: 'document' | 'action';
+    category?: 'spec' | 'steering' | 'decomposition';
+    categoryName?: string;
+}, context: ToolContext): Promise<ToolResponse>;
+//# sourceMappingURL=approvals.d.ts.map

package/dist/tools/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/tools/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA6BxD,eAAO,MAAM,aAAa,EAAE,IAwD3B,CAAC;AAwCF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IACJ,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,EACD,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAqDvB"}