specforge-mcp 0.9.0 → 0.11.0

package/dist/engine/risk-analyzer/complexity-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-calculator.d.ts","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/complexity-calculator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAGjB,MAAM,sBAAsB,CAAC;AAiG9B;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,mBAAmB,GAAG,gBAAgB,CAiBpF"}

package/dist/engine/risk-analyzer/complexity-calculator.js

@@ -0,0 +1,110 @@
+function technicalScore(ctx) {
+    const score = ctx.difficulty;
+    return {
+        dimension: 'technical',
+        score,
+        justification: `Difficulty level ${score}/5 maps directly to technical complexity`,
+    };
+}
+function integrationScore(ctx) {
+    let base;
+    const f = ctx.fileCount;
+    if (f <= 3) {
+        base = 1;
+    }
+    else if (f <= 6) {
+        base = 2;
+    }
+    else if (f <= 10) {
+        base = 3;
+    }
+    else if (f <= 15) {
+        base = 4;
+    }
+    else {
+        base = 5;
+    }
+    const depFactor = ctx.dependencyCount > 5 ? 1 : 0;
+    const score = Math.min(base + depFactor, 5);
+    return {
+        dimension: 'integration',
+        score,
+        justification: `${f} files (base ${base}) + dependency factor ${depFactor}`,
+    };
+}
+function testingScore(ctx) {
+    const scopeMap = {
+        trivial: 1,
+        feature: 2,
+        'cross-module': 4,
+        architectural: 5,
+    };
+    const score = scopeMap[ctx.scope] ?? 2;
+    return {
+        dimension: 'testing',
+        score,
+        justification: `Scope "${ctx.scope}" requires testing at level ${score}/5`,
+    };
+}
+function organizationalScore(ctx) {
+    const hasBreaking = ctx.tags.includes('breaking-change') || ctx.tags.includes('migration');
+    const score = hasBreaking ? 4 : 2;
+    return {
+        dimension: 'organizational',
+        score,
+        justification: hasBreaking
+            ? 'Contains breaking-change or migration tags requiring coordination'
+            : 'No breaking changes detected',
+    };
+}
+function uncertaintyScore(ctx) {
+    let score = 2;
+    if (ctx.framework === null) {
+        score += 2;
+    }
+    // High difficulty without a known framework indicates exploratory/spike-like work
+    if (ctx.difficulty >= 4 && ctx.framework === null) {
+        score = Math.min(score + 1, 5);
+    }
+    score = Math.min(score, 5);
+    return {
+        dimension: 'uncertainty',
+        score,
+        justification: ctx.framework === null
+            ? 'Unknown framework increases estimation uncertainty'
+            : 'Framework known, moderate uncertainty',
+    };
+}
+function weightedAverage(scores) {
+    const weights = {
+        technical: 0.3,
+        integration: 0.25,
+        testing: 0.2,
+        organizational: 0.15,
+        uncertainty: 0.1,
+    };
+    return scores.reduce((acc, s) => {
+        const weight = weights[s.dimension];
+        return acc + s.score * weight;
+    }, 0);
+}
+/**
+ * Calculate the full complexity matrix for a spec.
+ */
+export function calculateComplexityMatrix(ctx) {
+    const scores = [
+        technicalScore(ctx),
+        integrationScore(ctx),
+        testingScore(ctx),
+        organizationalScore(ctx),
+        uncertaintyScore(ctx),
+    ];
+    const overallComplexity = weightedAverage(scores);
+    return {
+        specId: ctx.specId,
+        scores,
+        overallComplexity,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=complexity-calculator.js.map

package/dist/engine/risk-analyzer/complexity-calculator.js.map

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

package/dist/engine/risk-analyzer/confidence-scorer.d.ts

@@ -0,0 +1,7 @@
+import type { RiskAnalysisContext, EstimationConfidence } from '../../types/index.js';
+/**
+ * Calculate the estimation confidence for a spec.
+ * @param historicalAccuracy - optional 0-1 ratio from past estimates (1 = perfect accuracy)
+ */
+export declare function calculateConfidence(ctx: RiskAnalysisContext, historicalAccuracy?: number): EstimationConfidence;
+//# sourceMappingURL=confidence-scorer.d.ts.map

package/dist/engine/risk-analyzer/confidence-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-scorer.d.ts","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/confidence-scorer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AA0H9B;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,mBAAmB,EACxB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,oBAAoB,CAYtB"}

package/dist/engine/risk-analyzer/confidence-scorer.js

@@ -0,0 +1,113 @@
+const BASE_SCORE = 50;
+const HISTORICAL_ADJUSTMENT = 20;
+function buildPositiveFactors(ctx) {
+    const factors = [];
+    if (ctx.scope !== 'architectural') {
+        factors.push({
+            name: 'Well-defined scope',
+            impact: 'positive',
+            weight: 0.2,
+            description: `Scope "${ctx.scope}" is clearly bounded`,
+        });
+    }
+    if (ctx.framework !== null) {
+        factors.push({
+            name: 'Known framework',
+            impact: 'positive',
+            weight: 0.15,
+            description: `Framework "${ctx.framework}" is established and well-understood`,
+        });
+    }
+    if (ctx.dependencyCount < 3) {
+        factors.push({
+            name: 'Low dependency count',
+            impact: 'positive',
+            weight: 0.1,
+            description: `Only ${ctx.dependencyCount} dependencies reduces integration risk`,
+        });
+    }
+    if (ctx.difficulty <= 2) {
+        factors.push({
+            name: 'Low difficulty',
+            impact: 'positive',
+            weight: 0.15,
+            description: `Difficulty level ${ctx.difficulty}/5 is well within team capability`,
+        });
+    }
+    return factors;
+}
+function buildNegativeFactors(ctx) {
+    const factors = [];
+    if (ctx.framework === null) {
+        factors.push({
+            name: 'Unknown framework',
+            impact: 'negative',
+            weight: 0.2,
+            description: 'No framework specified increases estimation uncertainty',
+        });
+    }
+    if (ctx.dependencyCount > 5) {
+        factors.push({
+            name: 'Many dependencies',
+            impact: 'negative',
+            weight: 0.15,
+            description: `${ctx.dependencyCount} dependencies increase coordination risk`,
+        });
+    }
+    if (ctx.scope === 'cross-module' || ctx.scope === 'architectural') {
+        factors.push({
+            name: 'Broad scope',
+            impact: 'negative',
+            weight: 0.2,
+            description: `Scope "${ctx.scope}" spans multiple areas making estimation harder`,
+        });
+    }
+    if (ctx.risk === 'high' || ctx.risk === 'critical') {
+        factors.push({
+            name: 'High risk level',
+            impact: 'negative',
+            weight: 0.15,
+            description: `Risk level "${ctx.risk}" signals higher uncertainty`,
+        });
+    }
+    return factors;
+}
+function computeScore(positiveFactors, negativeFactors, historicalAccuracy) {
+    let score = BASE_SCORE;
+    for (const f of positiveFactors) {
+        score += f.weight * 100;
+    }
+    for (const f of negativeFactors) {
+        score -= f.weight * 100;
+    }
+    if (historicalAccuracy !== undefined) {
+        const adjustment = (historicalAccuracy - 0.5) * 2 * HISTORICAL_ADJUSTMENT;
+        score += adjustment;
+    }
+    return Math.min(Math.max(score, 0), 100);
+}
+function scoreToLevel(score) {
+    if (score < 35) {
+        return 'low';
+    }
+    if (score <= 65) {
+        return 'medium';
+    }
+    return 'high';
+}
+/**
+ * Calculate the estimation confidence for a spec.
+ * @param historicalAccuracy - optional 0-1 ratio from past estimates (1 = perfect accuracy)
+ */
+export function calculateConfidence(ctx, historicalAccuracy) {
+    const positiveFactors = buildPositiveFactors(ctx);
+    const negativeFactors = buildNegativeFactors(ctx);
+    const allFactors = [...positiveFactors, ...negativeFactors];
+    const score = computeScore(positiveFactors, negativeFactors, historicalAccuracy);
+    return {
+        level: scoreToLevel(score),
+        score,
+        factors: allFactors,
+    };
+}
+//# sourceMappingURL=confidence-scorer.js.map

package/dist/engine/risk-analyzer/confidence-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-scorer.js","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/confidence-scorer.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,SAAS,oBAAoB,CAAC,GAAwB;IACpD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,GAAG,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,UAAU,GAAG,CAAC,KAAK,sBAAsB;SACvD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,cAAc,GAAG,CAAC,SAAS,sCAAsC;SAC/E,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,sBAAsB;YAC5B,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,QAAQ,GAAG,CAAC,eAAe,wCAAwC;SACjF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,oBAAoB,GAAG,CAAC,UAAU,mCAAmC;SACnF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAwB;IACpD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,yDAAyD;SACvE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,GAAG,GAAG,CAAC,eAAe,0CAA0C;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,cAAc,IAAI,GAAG,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,GAAG;YACX,WAAW,EAAE,UAAU,GAAG,CAAC,KAAK,iDAAiD;SAClF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,eAAe,GAAG,CAAC,IAAI,8BAA8B;SACnE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CACnB,eAAmC,EACnC,eAAmC,EACnC,kBAAsC;IAEtC,IAAI,KAAK,GAAG,UAAU,CAAC;IAEvB,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC;QAC1E,KAAK,IAAI,UAAU,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAwB,EACxB,kBAA2B;IAE3B,MAAM,eAAe,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,eAAe,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,YAAY,CAAC,eAAe,EAAE,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAEjF,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;QAC1B,KAAK;QACL,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC"}

package/dist/engine/risk-analyzer/index.d.ts

@@ -0,0 +1,6 @@
+export { generateRiskRegister } from './risk-generator.js';
+export { calculateComplexityMatrix } from './complexity-calculator.js';
+export { detectTradeOffs } from './tradeoff-detector.js';
+export { analyzeApproach } from './approach-analyzer.js';
+export { calculateConfidence } from './confidence-scorer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/risk-analyzer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/risk-analyzer/index.js

@@ -0,0 +1,7 @@
+// risk-analyzer — Barrel exports
+export { generateRiskRegister } from './risk-generator.js';
+export { calculateComplexityMatrix } from './complexity-calculator.js';
+export { detectTradeOffs } from './tradeoff-detector.js';
+export { analyzeApproach } from './approach-analyzer.js';
+export { calculateConfidence } from './confidence-scorer.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/risk-analyzer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/risk-analyzer/risk-generator.d.ts

@@ -0,0 +1,6 @@
+import type { RiskAnalysisContext, RiskRegister } from '../../types/index.js';
+/**
+ * Generate an initial risk register from spec metadata.
+ */
+export declare function generateRiskRegister(ctx: RiskAnalysisContext, totalBudget?: number): RiskRegister;
+//# sourceMappingURL=risk-generator.d.ts.map

package/dist/engine/risk-analyzer/risk-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/risk-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EAGb,MAAM,sBAAsB,CAAC;AA0F9B;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAYjG"}

package/dist/engine/risk-analyzer/risk-generator.js

@@ -0,0 +1,94 @@
+function buildRiskTemplates(ctx) {
+    const templates = [];
+    if (ctx.difficulty >= 4) {
+        templates.push({
+            description: 'High complexity may lead to estimation overrun',
+            category: 'technical',
+            probability: 40,
+            impactDays: 3,
+            mitigationPlan: 'Break down into smaller tasks and reassess estimates',
+        });
+    }
+    if (ctx.scope === 'cross-module' || ctx.scope === 'architectural') {
+        templates.push({
+            description: 'Cross-module changes risk breaking existing integrations',
+            category: 'integration',
+            probability: 35,
+            impactDays: 2,
+            mitigationPlan: 'Add integration tests covering all affected modules before merging',
+        });
+    }
+    if (ctx.dependencyCount > 3) {
+        templates.push({
+            description: 'Multiple dependencies increase coordination overhead',
+            category: 'dependency',
+            probability: 30,
+            impactDays: 2,
+            mitigationPlan: 'Establish dependency contracts early and monitor for version conflicts',
+        });
+    }
+    if (ctx.risk === 'high' || ctx.risk === 'critical') {
+        templates.push({
+            description: 'Spec flagged as high-risk requires extra review',
+            category: 'organizational',
+            probability: 50,
+            impactDays: 3,
+            mitigationPlan: 'Schedule mandatory peer review and add approval gates before deployment',
+        });
+    }
+    if (ctx.tags.includes('security')) {
+        templates.push({
+            description: 'Security-sensitive changes require audit',
+            category: 'security',
+            probability: 25,
+            impactDays: 4,
+            mitigationPlan: 'Engage security team for review and run SAST/DAST tools',
+        });
+    }
+    if (ctx.fileCount > 10) {
+        templates.push({
+            description: 'Large number of files increases merge conflict risk',
+            category: 'technical',
+            probability: 30,
+            impactDays: 1,
+            mitigationPlan: 'Use feature flags and incremental PRs to reduce merge surface',
+        });
+    }
+    return templates;
+}
+function buildRisks(ctx, templates) {
+    return templates.map((t, index) => ({
+        id: `R${index + 1}`,
+        description: t.description,
+        category: t.category,
+        probability: t.probability,
+        impactUsd: 0,
+        impactDays: t.impactDays,
+        owner: '',
+        status: 'identified',
+        mitigationPlan: t.mitigationPlan,
+        specId: ctx.specId,
+    }));
+}
+function computeAggregateScore(risks, totalBudgetDays) {
+    const rawScore = risks.reduce((acc, r) => acc + (r.probability / 100) * r.impactDays, 0);
+    const denominator = Math.max(totalBudgetDays, 1);
+    const score = (rawScore / denominator) * 100;
+    return Math.min(score, 100);
+}
+/**
+ * Generate an initial risk register from spec metadata.
+ */
+export function generateRiskRegister(ctx, totalBudget) {
+    const budgetDays = totalBudget ?? 30;
+    const templates = buildRiskTemplates(ctx);
+    const risks = buildRisks(ctx, templates);
+    const aggregateRiskScore = computeAggregateScore(risks, budgetDays);
+    return {
+        specId: ctx.specId,
+        risks,
+        aggregateRiskScore,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=risk-generator.js.map

package/dist/engine/risk-analyzer/risk-generator.js.map

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

package/dist/engine/risk-analyzer/tradeoff-detector.d.ts

@@ -0,0 +1,6 @@
+import type { RiskAnalysisContext, TradeOff } from '../../types/index.js';
+/**
+ * Detect applicable trade-offs based on spec context patterns.
+ */
+export declare function detectTradeOffs(ctx: RiskAnalysisContext): TradeOff[];
+//# sourceMappingURL=tradeoff-detector.d.ts.map

package/dist/engine/risk-analyzer/tradeoff-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tradeoff-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/risk-analyzer/tradeoff-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAkB,MAAM,sBAAsB,CAAC;AAsH1F;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,QAAQ,EAAE,CAoBpE"}

package/dist/engine/risk-analyzer/tradeoff-detector.js

@@ -0,0 +1,128 @@
+function architecturalTradeOff() {
+    const options = [
+        {
+            name: 'Monolithic implementation',
+            pros: ['Simpler to develop', 'Faster initial delivery', 'Easier to debug'],
+            cons: ['Harder to scale', 'Tightly coupled components', 'Difficult to maintain long-term'],
+            riskIfChosen: 'Technical debt accumulates, refactoring will be costly later',
+            riskIfNotChosen: 'Over-engineering for current scope',
+            estimatedCostDelta: -8,
+        },
+        {
+            name: 'Modular implementation',
+            pros: ['Better separation of concerns', 'Easier to test in isolation', 'Scalable by design'],
+            cons: ['Higher upfront complexity', 'More files and boilerplate', 'Steeper learning curve'],
+            riskIfChosen: 'Over-engineering if scope does not expand',
+            riskIfNotChosen: 'Hard to scale or refactor once monolithic approach is established',
+            estimatedCostDelta: 8,
+        },
+    ];
+    return {
+        id: 'TO-1',
+        description: 'Monolithic vs modular implementation approach',
+        options,
+        chosenOption: '',
+        rationale: '',
+    };
+}
+function incrementalPrTradeOff() {
+    const options = [
+        {
+            name: 'Single large PR',
+            pros: ['All changes in one review', 'No partial states in main branch'],
+            cons: ['Large PR harder to review', 'Higher merge conflict risk', 'Blocks other work longer'],
+            riskIfChosen: 'Reviewers miss issues due to PR fatigue',
+            riskIfNotChosen: 'Parallel work may depend on partial changes',
+            estimatedCostDelta: -4,
+        },
+        {
+            name: 'Incremental PRs',
+            pros: ['Smaller, reviewable chunks', 'Earlier feedback', 'Reduces merge conflicts'],
+            cons: ['More coordination overhead', 'Partial features may be live temporarily'],
+            riskIfChosen: 'Partial states may cause confusion without feature flags',
+            riskIfNotChosen: 'Large PR increases review errors',
+            estimatedCostDelta: 4,
+        },
+    ];
+    return {
+        id: 'TO-2',
+        description: 'Single PR vs incremental PRs for large changeset',
+        options,
+        chosenOption: '',
+        rationale: '',
+    };
+}
+function performanceTradeOff() {
+    const options = [
+        {
+            name: 'Optimize now',
+            pros: ['Performance built-in from the start', 'Avoids costly rewrites later'],
+            cons: ['Premature optimization risk', 'Adds complexity before problems are confirmed'],
+            riskIfChosen: 'Optimizing the wrong bottleneck without profiling data',
+            riskIfNotChosen: 'Performance issues at scale require expensive retrofitting',
+            estimatedCostDelta: 12,
+        },
+        {
+            name: 'Defer optimization',
+            pros: ['Faster initial delivery', 'Optimize based on real profiling data'],
+            cons: ['May need rework later', 'Performance issues may reach production'],
+            riskIfChosen: 'Technical debt if optimization is never prioritized',
+            riskIfNotChosen: 'Early optimization may be unnecessary',
+            estimatedCostDelta: -12,
+        },
+    ];
+    return {
+        id: 'TO-3',
+        description: 'Optimize now vs defer optimization',
+        options,
+        chosenOption: '',
+        rationale: '',
+    };
+}
+function dependencyTradeOff() {
+    const options = [
+        {
+            name: 'Use external dependency',
+            pros: ['Faster delivery', 'Battle-tested solution', 'Community support'],
+            cons: ['Version lock-in risk', 'Security surface increases', 'License constraints possible'],
+            riskIfChosen: 'Dependency may be abandoned or introduce breaking changes',
+            riskIfNotChosen: 'Custom solution may lack features or have bugs',
+            estimatedCostDelta: -16,
+        },
+        {
+            name: 'Custom implementation',
+            pros: ['Full control', 'No external lock-in', 'Tailored to exact needs'],
+            cons: ['High development cost', 'Maintenance burden', 'Re-inventing the wheel risk'],
+            riskIfChosen: 'Under-resourced maintenance leads to accumulating bugs',
+            riskIfNotChosen: 'Dependency risks (abandonment, licensing) remain',
+            estimatedCostDelta: 16,
+        },
+    ];
+    return {
+        id: 'TO-4',
+        description: 'External dependency vs custom implementation',
+        options,
+        chosenOption: '',
+        rationale: '',
+    };
+}
+/**
+ * Detect applicable trade-offs based on spec context patterns.
+ */
+export function detectTradeOffs(ctx) {
+    const tradeoffs = [];
+    if (ctx.scope === 'architectural') {
+        tradeoffs.push(architecturalTradeOff());
+    }
+    if (ctx.fileCount > 8) {
+        tradeoffs.push(incrementalPrTradeOff());
+    }
+    if (ctx.tags.includes('performance')) {
+        tradeoffs.push(performanceTradeOff());
+    }
+    if (ctx.dependencyCount > 5) {
+        tradeoffs.push(dependencyTradeOff());
+    }
+    return tradeoffs;
+}
+//# sourceMappingURL=tradeoff-detector.js.map

package/dist/engine/risk-analyzer/tradeoff-detector.js.map

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

package/dist/index.js

@@ -61,6 +61,13 @@ const server = new McpServer({
         '4. When presenting lists or results, use plain language headers — not jargon.',
         '5. If the user seems confused, offer to explain further. Never assume knowledge.',
         "6. Adapt your language to the user's locale (English, Spanish, or Portuguese).",
+        '',
+        'GIT WORKFLOW — suggest branches at key moments:',
+        '- After creating spec(s): suggest creating a feature branch (e.g., "git checkout -b feat/SPEC-XXX-feature-name").',
+        '- When a spec moves to "implementing": remind the user to work in a dedicated branch, not directly on main or develop.',
+        '- Use manage_git to create branches, generate PR descriptions, and link them to specs.',
+        '- Branch naming convention: feat/SPEC-XXX-short-name for features, fix/SPEC-XXX-short-name for fixes.',
+        '- Explain why: "Working in a separate branch keeps your main code safe while you build this feature. When it is ready, you merge it back."',
     ].join('\n'),
 });
 // ---------------------------------------------------------------------------

package/dist/index.js.map

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

package/dist/storage/risk-store.d.ts

@@ -0,0 +1,16 @@
+import type { RiskRegister } from '../types/index.js';
+/**
+ * Load the risk register for a given spec.
+ * Returns null when no register has been saved yet.
+ */
+export declare function loadRiskRegister(projectDataDir: string, specId: string): Promise<RiskRegister | null>;
+/**
+ * Persist a risk register for a spec.
+ */
+export declare function saveRiskRegister(projectDataDir: string, register: RiskRegister): Promise<void>;
+/**
+ * Load all risk registers for a project.
+ * Returns an empty array when the risks directory does not exist.
+ */
+export declare function loadAllRiskRegisters(projectDataDir: string): Promise<RiskRegister[]>;
+//# sourceMappingURL=risk-store.d.ts.map

package/dist/storage/risk-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-store.d.ts","sourceRoot":"","sources":["../../src/storage/risk-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAiBjE;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAE9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAsB1F"}

package/dist/storage/risk-store.js

@@ -0,0 +1,53 @@
+import { readJson, writeJson } from './base-store.js';
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+// --- internal helpers ---
+function risksDir(projectDataDir) {
+    return join(projectDataDir, 'risks');
+}
+function riskFile(projectDataDir, specId) {
+    return join(risksDir(projectDataDir), `${specId}.json`);
+}
+// --- public API ---
+/**
+ * Load the risk register for a given spec.
+ * Returns null when no register has been saved yet.
+ */
+export async function loadRiskRegister(projectDataDir, specId) {
+    return readJson(riskFile(projectDataDir, specId), null);
+}
+/**
+ * Persist a risk register for a spec.
+ */
+export async function saveRiskRegister(projectDataDir, register) {
+    await writeJson(riskFile(projectDataDir, register.specId), register);
+}
+/**
+ * Load all risk registers for a project.
+ * Returns an empty array when the risks directory does not exist.
+ */
+export async function loadAllRiskRegisters(projectDataDir) {
+    const dir = risksDir(projectDataDir);
+    let files;
+    try {
+        files = await readdir(dir);
+    }
+    catch (err) {
+        if (isNodeError(err) && err.code === 'ENOENT') {
+            return [];
+        }
+        /* v8 ignore next */
+        throw err;
+    }
+    const jsonFiles = files.filter((f) => f.endsWith('.json'));
+    const registers = await Promise.all(jsonFiles.map(async (file) => {
+        const specId = file.replace(/\.json$/, '');
+        return loadRiskRegister(projectDataDir, specId);
+    }));
+    return registers.filter((r) => r !== null);
+}
+// --- internal helpers ---
+function isNodeError(err) {
+    return err instanceof Error && 'code' in err;
+}
+//# sourceMappingURL=risk-store.js.map