specforge-mcp 0.1.0

package/dist/tools/facilitate.js

@@ -0,0 +1,264 @@
+import { scoreAmbiguity, shouldBlock } from '../engine/ambiguity-detector.js';
+import { setFocus, getFocus, checkFocusDrift, parseChangeFocusDirective, } from '../engine/focus-tracker.js';
+import { getParadigmRecommendations, formatParadigmObservations, } from '../engine/paradigm-advisor.js';
+// ---------------------------------------------------------------------------
+// Scenario detection
+// ---------------------------------------------------------------------------
+function detectScenario(description) {
+    const lower = description.toLowerCase();
+    // Concrete problem indicators — check before existing_project to avoid
+    // false positives with phrases like "existing spec"
+    if (lower.includes('how to') ||
+        lower.includes('how do i') ||
+        lower.includes('what tool') ||
+        lower.includes('i need help with') ||
+        lower.includes('fix') ||
+        lower.includes('error') ||
+        lower.includes('problem')) {
+        return 'concrete_problem';
+    }
+    // Existing project indicators
+    if (lower.includes('already have') ||
+        lower.includes('my project') ||
+        lower.includes('our project') ||
+        /existing project/i.test(description) ||
+        lower.includes('/') // path-like input
+    ) {
+        return 'existing_project';
+    }
+    return 'new_project';
+}
+// ---------------------------------------------------------------------------
+// Step questions for new_project scenario
+// ---------------------------------------------------------------------------
+const NEW_PROJECT_STEPS = [
+    'What is the main purpose of your app? What problem does it solve and for whom?',
+    'What platform will it run on? (web app, mobile iOS/Android, REST API, desktop app, CLI tool)',
+    'Do you have a preferred tech stack? (language, framework, database — skip if unsure)',
+];
+function buildNewProjectResponse(step, collectedInfo) {
+    if (step < NEW_PROJECT_STEPS.length) {
+        const question = NEW_PROJECT_STEPS[step] ?? NEW_PROJECT_STEPS[0];
+        const intro = step === 0
+            ? "Welcome to SpecForge! I'll guide you with a few questions to generate a precise spec.\n\n"
+            : `Got it! ${Object.values(collectedInfo).join(', ')}\n\n`;
+        return `${intro}Step ${step + 1}/3: ${question}`;
+    }
+    // All 3 steps complete — suggest create_spec
+    const info = Object.values(collectedInfo).join(' | ');
+    return (`Great — I have enough context to generate your spec.\n\n` +
+        `Summary: ${info}\n\n` +
+        `Next step: Call \`create_spec\` with this description:\n` +
+        `"${Object.values(collectedInfo).join('. ')}."\n\n` +
+        `Or call \`clarify_requirements\` first for deeper requirement analysis.`);
+}
+// ---------------------------------------------------------------------------
+// Existing project scenario
+// ---------------------------------------------------------------------------
+function buildExistingProjectResponse(description) {
+    return (`I'll run a diagnostic on your project.\n\n` +
+        `Please provide the project path and call:\n` +
+        `- \`init_project\` with your project path (if not yet initialized)\n` +
+        `- \`reverse_engineer\` to analyze the codebase\n` +
+        `- \`audit\` to check spec health\n\n` +
+        `Request received: "${description.slice(0, 120)}"`);
+}
+// ---------------------------------------------------------------------------
+// Concrete problem scenario
+// ---------------------------------------------------------------------------
+const PROBLEM_TO_TOOL = [
+    [/spec|user stor/i, 'create_spec', 'create a spec/user story'],
+    [/estimat/i, 'estimate', 'estimate effort and cost'],
+    [/test/i, 'generate_tests', 'generate tests'],
+    [/document|doc/i, 'generate_docs', 'generate documentation'],
+    [/drift|diverge/i, 'detect_drift', 'detect spec drift'],
+    [/validat/i, 'validate', 'validate a spec'],
+    [/schema|database|db/i, 'design_schema', 'design a database schema'],
+    [/ui|interface|screen/i, 'define_ui_contract', 'define a UI contract'],
+    [/execution|plan|roadmap/i, 'generate_execution_plan', 'generate an execution plan'],
+    [/checklist/i, 'generate_checklist', 'generate a checklist'],
+];
+function buildConcreteProblemResponse(description) {
+    const match = PROBLEM_TO_TOOL.find(([re]) => re.test(description));
+    if (match) {
+        const [, tool, action] = match;
+        return (`It sounds like you want to ${action}.\n\n` +
+            `Recommended tool: \`${tool}\`\n\n` +
+            `Call \`${tool}\` with your project ID and the relevant parameters.`);
+    }
+    return (`I can help with that! Here are the most relevant SpecForge tools:\n\n` +
+        `- \`create_spec\` — write a new user story / spec\n` +
+        `- \`clarify_requirements\` — clarify vague requirements\n` +
+        `- \`estimate\` — estimate effort and cost\n` +
+        `- \`validate\` — check if a spec is complete\n` +
+        `- \`generate_tests\` — generate test scaffolds\n\n` +
+        `What specifically would you like to do?`);
+}
+// ---------------------------------------------------------------------------
+// Paradigm observations (SPEC-035b)
+// ---------------------------------------------------------------------------
+/**
+ * Builds paradigm expert voice observations from a pre-computed ParadigmReport.
+ * Degrades gracefully when no detection data is available.
+ */
+export function buildParadigmObservations(paradigmReport) {
+    if (!paradigmReport) {
+        return '';
+    }
+    const recommendations = getParadigmRecommendations(paradigmReport);
+    return formatParadigmObservations(recommendations, null);
+}
+// ---------------------------------------------------------------------------
+// Expert observations generator
+// ---------------------------------------------------------------------------
+function generateExpertObservations(description) {
+    const observations = [];
+    const lower = description.toLowerCase();
+    if (/fast|quick|instant|real.?time/i.test(description)) {
+        observations.push({
+            type: 'metric',
+            text: 'Vague performance requirement detected ("fast", "quick"). Consider specifying concrete SLOs.',
+            action: 'Add: "Response time < 200ms at p95 under 1000 concurrent users"',
+        });
+    }
+    if (/payment|stripe|credit card|billing/i.test(description)) {
+        observations.push({
+            type: 'risk',
+            text: 'Payment handling requires PCI-DSS compliance consideration.',
+            action: 'Use a certified payment processor (Stripe, Braintree) — never store raw card data.',
+        });
+    }
+    if (/auth|login|password|jwt/i.test(description) && !lower.includes('oauth')) {
+        observations.push({
+            type: 'suggestion',
+            text: 'Consider OAuth2/OIDC instead of custom auth to reduce security risk.',
+            action: 'Evaluate Auth0, Clerk, or Supabase Auth before building from scratch.',
+        });
+    }
+    if (/microservice/i.test(description)) {
+        observations.push({
+            type: 'risk',
+            text: 'Microservices add operational complexity. Ensure you need them before committing.',
+            action: 'Start with a modular monolith and extract services when load justifies it.',
+        });
+    }
+    return observations;
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export function handleFacilitate(params) {
+    const { description, projectId, sessionId, scenario: explicitScenario, collectedInfo = {}, step = 0, targetTool, checkFocus = false, changeFocus, paradigmReport, } = params;
+    const sessionKey = sessionId ?? projectId ?? 'default';
+    try {
+        // --- Focus change directive ---
+        const changeFocusText = changeFocus ?? parseChangeFocusDirective(description);
+        if (changeFocusText) {
+            const newFocus = {
+                objective: changeFocusText,
+                associatedTool: targetTool,
+                startedAt: new Date().toISOString(),
+            };
+            setFocus(sessionKey, newFocus);
+            return ok({
+                action: 'focus_updated',
+                objective: changeFocusText,
+                message: `Focus updated to: "${changeFocusText}". All subsequent requests will be evaluated against this objective.`,
+            });
+        }
+        // --- Focus drift check ---
+        if (checkFocus) {
+            const shift = checkFocusDrift(sessionKey, description, targetTool);
+            if (shift) {
+                return ok({
+                    action: 'focus_drift_detected',
+                    shift,
+                    message: shift.redirectMessage,
+                    allowProceed: true,
+                });
+            }
+            return ok({
+                action: 'focus_aligned',
+                currentFocus: getFocus(sessionKey),
+                message: 'Request is aligned with the current session focus.',
+            });
+        }
+        // --- Ambiguity check for a specific tool ---
+        if (targetTool) {
+            const ambiguity = scoreAmbiguity(description);
+            const blocked = shouldBlock(targetTool, ambiguity);
+            if (blocked) {
+                return ok({
+                    action: 'ambiguity_block',
+                    level: ambiguity.level,
+                    score: ambiguity.score,
+                    blockingDimension: ambiguity.blockingDimension,
+                    question: ambiguity.clarificationQuestion,
+                    message: `Before calling \`${targetTool}\`, please answer: ${ambiguity.clarificationQuestion}`,
+                });
+            }
+            return ok({
+                action: 'ambiguity_clear',
+                level: ambiguity.level,
+                score: ambiguity.score,
+                message: `Request is clear enough for \`${targetTool}\`. Proceed.`,
+            });
+        }
+        // --- Main facilitate flow ---
+        const scenario = explicitScenario ?? detectScenario(description);
+        // Set initial focus for new sessions
+        const existingFocus = getFocus(sessionKey);
+        if (!existingFocus) {
+            setFocus(sessionKey, {
+                objective: description,
+                startedAt: new Date().toISOString(),
+            });
+        }
+        // Generate expert observations (non-blocking)
+        const observations = generateExpertObservations(description);
+        let guidance;
+        switch (scenario) {
+            case 'new_project': {
+                // Merge current description into collectedInfo for current step
+                const updatedInfo = step === 0
+                    ? { ...collectedInfo, step0: description }
+                    : { ...collectedInfo, [`step${step}`]: description };
+                guidance = buildNewProjectResponse(step, updatedInfo);
+                break;
+            }
+            case 'existing_project':
+                guidance = buildExistingProjectResponse(description);
+                break;
+            case 'concrete_problem':
+                guidance = buildConcreteProblemResponse(description);
+                break;
+        }
+        const result = {
+            action: 'facilitate',
+            scenario,
+            step,
+            guidance,
+        };
+        if (observations.length > 0) {
+            result.expertObservations = observations;
+            result.expertNote = 'Expert observations added below — these do not block execution.';
+        }
+        // SPEC-035b: Append paradigm expert voice observations when detection data is available
+        const paradigmObservations = buildParadigmObservations(paradigmReport);
+        if (paradigmObservations) {
+            result.paradigmObservations = paradigmObservations;
+        }
+        return ok(result);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }, null, 2) }],
+            isError: true,
+        };
+    }
+}
+function ok(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+//# sourceMappingURL=facilitate.js.map

package/dist/tools/facilitate.js.map

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

package/dist/tools/generate-adr/decisions.d.ts

@@ -0,0 +1,3 @@
+import type { Spec, ProjectKnowledge, LearnedPattern, ArchitectureDecision } from '../../types/index.js';
+export declare function generateDecisions(spec: Spec, knowledge: ProjectKnowledge, patterns: LearnedPattern[], specContent: string, requestedDecisions?: string[]): ArchitectureDecision[];
+//# sourceMappingURL=decisions.d.ts.map

package/dist/tools/generate-adr/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-adr/decisions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,cAAc,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAC5B,oBAAoB,EAAE,CA2DxB"}

package/dist/tools/generate-adr/decisions.js

@@ -0,0 +1,275 @@
+// tools/generate-adr/decisions.ts — Architecture decision generators
+export function generateDecisions(spec, knowledge, patterns, specContent, requestedDecisions) {
+    const decisions = [];
+    if (!requestedDecisions ||
+        requestedDecisions.some((d) => d.toLowerCase().includes('architect'))) {
+        decisions.push(generateArchitecturePatternDecision(spec, knowledge, patterns));
+    }
+    if (!requestedDecisions ||
+        requestedDecisions.some((d) => d.toLowerCase().includes('data') || d.toLowerCase().includes('schema'))) {
+        if (/(?:database|schema|table|model|entity|store|persist)/i.exec(specContent) ||
+            spec.target === 'backend' ||
+            spec.target === 'fullstack' ||
+            spec.target === 'database') {
+            decisions.push(generateDataLayerDecision(spec, knowledge));
+        }
+    }
+    if (!requestedDecisions || requestedDecisions.some((d) => d.toLowerCase().includes('api'))) {
+        if (spec.target === 'backend' || spec.target === 'fullstack') {
+            decisions.push(generateApiDecision(spec, knowledge));
+        }
+    }
+    if (!requestedDecisions ||
+        requestedDecisions.some((d) => d.toLowerCase().includes('state') || d.toLowerCase().includes('ui'))) {
+        if (spec.target === 'frontend' || spec.target === 'fullstack') {
+            decisions.push(generateStateManagementDecision(spec, knowledge));
+        }
+    }
+    if (!requestedDecisions || requestedDecisions.some((d) => d.toLowerCase().includes('error'))) {
+        decisions.push(generateErrorHandlingDecision(spec, knowledge));
+    }
+    if (requestedDecisions) {
+        for (const requested of requestedDecisions) {
+            const alreadyCovered = decisions.some((d) => d.decision.toLowerCase().includes(requested.toLowerCase()));
+            if (!alreadyCovered) {
+                decisions.push(generateGenericDecision(requested, spec, knowledge));
+            }
+        }
+    }
+    return decisions;
+}
+function generateArchitecturePatternDecision(spec, knowledge, patterns) {
+    const currentArch = knowledge.architecture.primary;
+    const patternNotes = patterns.map((p) => p.pattern).join('; ');
+    const options = [
+        {
+            name: 'Keep current pattern',
+            pros: ['No migration needed', 'Team already familiar', 'Existing tooling works'],
+            cons: ['May not scale for this feature', 'Possible tech debt accumulation'],
+            effort: 'None',
+            scalability: currentArch === 'monolith' ? 'Limited' : 'Good',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Vertical slice for this feature',
+            pros: ['Isolated changes', 'Easy to test', 'Minimal blast radius'],
+            cons: ['May diverge from existing patterns', 'Requires clear boundaries'],
+            effort: 'Low',
+            scalability: 'Good',
+            fitsEcosystem: true,
+        },
+    ];
+    if (spec.scope === 'architectural' || spec.scope === 'cross-module') {
+        options.push({
+            name: 'Modular approach with clear boundaries',
+            pros: ['Better separation of concerns', 'Independent deployability possible', 'Scalable'],
+            cons: ['Higher initial effort', 'Requires team alignment', 'More boilerplate'],
+            effort: 'Medium to High',
+            scalability: 'Excellent',
+            fitsEcosystem: knowledge.architecture.secondary.includes('modular-monolith'),
+        });
+    }
+    return {
+        decision: `Architecture pattern for "${spec.title}"`,
+        context: `Current architecture: ${currentArch}. Spec scope: ${spec.scope}. ${patternNotes ? `Learned patterns: ${patternNotes}` : ''}`.trim(),
+        options,
+        chosen: options[0]?.name ?? 'Keep current pattern',
+        rationale: `Maintain consistency with the existing ${currentArch} architecture unless the scope demands a structural change.`,
+        consequences: [
+            'New code follows existing architectural conventions',
+            'Changes are localized to the feature scope',
+            spec.scope === 'architectural'
+                ? 'May require follow-up refactoring spec'
+                : 'Minimal impact on other modules',
+        ],
+        tradeoffs: [
+            'Consistency vs. optimal structure for this specific feature',
+            'Short-term velocity vs. long-term maintainability',
+        ],
+    };
+}
+function generateDataLayerDecision(spec, knowledge) {
+    const dbEngine = knowledge.database;
+    const options = [
+        {
+            name: `Use existing ${dbEngine} with current ORM/driver`,
+            pros: [
+                'No migration',
+                'Consistent with existing data layer',
+                'Known performance characteristics',
+            ],
+            cons: ['May not be optimal for new data patterns'],
+            effort: 'Low',
+            scalability: 'Good',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Add a new data store for this feature',
+            pros: ['Optimized for use case', 'No schema conflicts'],
+            cons: ['Operational complexity', 'Data synchronization needed', 'Higher cost'],
+            effort: 'High',
+            scalability: 'Excellent for specific use case',
+            fitsEcosystem: false,
+        },
+    ];
+    return {
+        decision: `Data storage strategy for "${spec.title}"`,
+        context: `Current database: ${dbEngine}. Spec type: ${spec.type}, target: ${spec.target}.`,
+        options,
+        chosen: options[0]?.name ?? `Use existing ${dbEngine} with current ORM/driver`,
+        rationale: `Leverage the existing ${dbEngine} infrastructure. Adding a separate store is only justified for fundamentally different data access patterns.`,
+        consequences: [
+            `Schema changes in ${dbEngine}`,
+            'Migration scripts required',
+            'Existing backup/restore procedures apply',
+        ],
+        tradeoffs: ['Simplicity vs. optimization', 'Single source of truth vs. polyglot persistence'],
+    };
+}
+function generateApiDecision(spec, knowledge) {
+    const hasApi = knowledge.apiContracts.length > 0;
+    const firstContract = knowledge.apiContracts[0];
+    const apiType = hasApi && firstContract ? firstContract.type : 'rest-informal';
+    const options = [
+        {
+            name: `Extend existing ${apiType} API`,
+            pros: ['Consistent API surface', 'Existing clients work', 'Shared auth/middleware'],
+            cons: ['May bloat existing API', 'Versioning concerns'],
+            effort: 'Low',
+            scalability: 'Good',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Create a separate API module/service',
+            pros: ['Clean separation', 'Independent versioning', 'Focused responsibility'],
+            cons: ['More infrastructure', 'Cross-service communication overhead'],
+            effort: 'Medium',
+            scalability: 'Excellent',
+            fitsEcosystem: false,
+        },
+    ];
+    return {
+        decision: `API design for "${spec.title}"`,
+        context: `Existing API type: ${apiType}. ${knowledge.apiContracts.length} contracts detected.`,
+        options,
+        chosen: options[0]?.name ?? `Extend existing ${apiType} API`,
+        rationale: `Extend the existing ${apiType} API to maintain a unified API surface for clients.`,
+        consequences: [
+            'New endpoints added to existing API',
+            'API documentation updated',
+            'Existing authentication middleware reused',
+        ],
+        tradeoffs: [
+            'Unified API vs. microservice boundaries',
+            'Shared middleware vs. feature-specific requirements',
+        ],
+    };
+}
+function generateStateManagementDecision(spec, knowledge) {
+    const framework = knowledge.framework ?? 'unknown';
+    const options = [
+        {
+            name: 'Local component state',
+            pros: ['Simple', 'No dependencies', 'Easy to reason about'],
+            cons: ['No sharing between components', 'Prop drilling for deep trees'],
+            effort: 'Low',
+            scalability: 'Limited',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Context/Provider pattern',
+            pros: ['No external library', 'Framework-native', 'Good for moderate sharing'],
+            cons: ['Re-render concerns', 'Not ideal for frequent updates'],
+            effort: 'Low',
+            scalability: 'Moderate',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Dedicated state library',
+            pros: ['Powerful', 'DevTools', 'Middleware support'],
+            cons: ['Added dependency', 'Learning curve', 'Boilerplate'],
+            effort: 'Medium',
+            scalability: 'Excellent',
+            fitsEcosystem: true,
+        },
+    ];
+    return {
+        decision: `State management for "${spec.title}" UI components`,
+        context: `Frontend framework: ${framework}. Spec scope: ${spec.scope}.`,
+        options,
+        chosen: spec.scope === 'trivial' || spec.scope === 'feature'
+            ? (options[0]?.name ?? 'Local component state')
+            : (options[1]?.name ?? 'Context/Provider pattern'),
+        rationale: `For ${spec.scope} scope, ${spec.scope === 'trivial' || spec.scope === 'feature' ? 'local state is sufficient' : 'a shared state solution avoids prop drilling across modules'}.`,
+        consequences: [
+            'State management approach documented for this feature',
+            'Consistent with other features of similar scope',
+        ],
+        tradeoffs: ['Simplicity vs. power', 'Bundle size vs. developer experience'],
+    };
+}
+function generateErrorHandlingDecision(spec, knowledge) {
+    const options = [
+        {
+            name: 'Try-catch with structured error types',
+            pros: ['Explicit', 'Type-safe', 'Easy to trace'],
+            cons: ['Verbose', 'Requires discipline'],
+            effort: 'Low',
+            scalability: 'Good',
+            fitsEcosystem: true,
+        },
+        {
+            name: 'Result/Either pattern',
+            pros: ['Functional', 'No thrown exceptions', 'Composable'],
+            cons: ['Learning curve', 'Different from standard patterns'],
+            effort: 'Medium',
+            scalability: 'Excellent',
+            fitsEcosystem: knowledge.language === 'rust' || knowledge.language === 'go',
+        },
+    ];
+    return {
+        decision: `Error handling strategy for "${spec.title}"`,
+        context: `Language: ${knowledge.language}. Risk level: ${spec.risk}.`,
+        options,
+        chosen: options[0]?.name ?? 'Try-catch with structured error types',
+        rationale: 'Structured try-catch with typed errors provides a good balance of safety and readability.',
+        consequences: [
+            'All new functions have explicit error handling',
+            'Error types documented in spec',
+            'Logging integrated at catch boundaries',
+        ],
+        tradeoffs: ['Verbosity vs. safety', 'Performance overhead of try-catch vs. uncaught errors'],
+    };
+}
+function generateGenericDecision(topic, spec, knowledge) {
+    return {
+        decision: `${topic} for "${spec.title}"`,
+        context: `Spec type: ${spec.type}, scope: ${spec.scope}. Stack: ${knowledge.stack.join(', ')}.`,
+        options: [
+            {
+                name: `Follow existing ${topic} patterns`,
+                pros: ['Consistency', 'Known approach'],
+                cons: ['May not be optimal'],
+                effort: 'Low',
+                scalability: 'Moderate',
+                fitsEcosystem: true,
+            },
+            {
+                name: `Introduce new ${topic} approach`,
+                pros: ['Potentially better fit', 'Modern practices'],
+                cons: ['Migration effort', 'Team alignment needed'],
+                effort: 'Medium to High',
+                scalability: 'Good',
+                fitsEcosystem: false,
+            },
+        ],
+        chosen: `Follow existing ${topic} patterns`,
+        rationale: `Default to consistency unless there is a strong reason to diverge. Document the decision for future review.`,
+        consequences: [
+            `${topic} approach is documented`,
+            'Team can reference this ADR for future decisions',
+        ],
+        tradeoffs: ['Consistency vs. innovation', 'Short-term vs. long-term optimization'],
+    };
+}
+//# sourceMappingURL=decisions.js.map

package/dist/tools/generate-adr/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../../src/tools/generate-adr/decisions.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAUrE,MAAM,UAAU,iBAAiB,CAC/B,IAAU,EACV,SAA2B,EAC3B,QAA0B,EAC1B,WAAmB,EACnB,kBAA6B;IAE7B,MAAM,SAAS,GAA2B,EAAE,CAAC;IAE7C,IACE,CAAC,kBAAkB;QACnB,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EACrE,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,mCAAmC,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,IACE,CAAC,kBAAkB;QACnB,kBAAkB,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC9E,EACD,CAAC;QACD,IACE,uDAAuD,CAAC,IAAI,CAAC,WAAW,CAAC;YACzE,IAAI,CAAC,MAAM,KAAK,SAAS;YACzB,IAAI,CAAC,MAAM,KAAK,WAAW;YAC3B,IAAI,CAAC,MAAM,KAAK,UAAU,EAC1B,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC3F,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IACE,CAAC,kBAAkB;QACnB,kBAAkB,CAAC,IAAI,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC3E,EACD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC9D,SAAS,CAAC,IAAI,CAAC,+BAA+B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC7F,SAAS,CAAC,IAAI,CAAC,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACvB,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;YAC3C,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1C,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAC3D,CAAC;YACF,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mCAAmC,CAC1C,IAAU,EACV,SAA2B,EAC3B,QAA0B;IAE1B,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC;IACnD,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAgB;QAC3B;YACE,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,wBAAwB,CAAC;YAChF,IAAI,EAAE,CAAC,gCAAgC,EAAE,iCAAiC,CAAC;YAC3E,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YAC5D,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,iCAAiC;YACvC,IAAI,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,CAAC;YAClE,IAAI,EAAE,CAAC,oCAAoC,EAAE,2BAA2B,CAAC;YACzE,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,IAAI;SACpB;KACF,CAAC;IAEF,IAAI,IAAI,CAAC,KAAK,KAAK,eAAe,IAAI,IAAI,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,wCAAwC;YAC9C,IAAI,EAAE,CAAC,+BAA+B,EAAE,oCAAoC,EAAE,UAAU,CAAC;YACzF,IAAI,EAAE,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,kBAAkB,CAAC;YAC9E,MAAM,EAAE,gBAAgB;YACxB,WAAW,EAAE,WAAW;YACxB,aAAa,EAAE,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SAC7E,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,6BAA6B,IAAI,CAAC,KAAK,GAAG;QACpD,OAAO,EACL,yBAAyB,WAAW,iBAAiB,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE;QACtI,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,sBAAsB;QAClD,SAAS,EAAE,0CAA0C,WAAW,6DAA6D;QAC7H,YAAY,EAAE;YACZ,qDAAqD;YACrD,4CAA4C;YAC5C,IAAI,CAAC,KAAK,KAAK,eAAe;gBAC5B,CAAC,CAAC,wCAAwC;gBAC1C,CAAC,CAAC,iCAAiC;SACtC;QACD,SAAS,EAAE;YACT,6DAA6D;YAC7D,mDAAmD;SACpD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAU,EAAE,SAA2B;IACxE,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IAEpC,MAAM,OAAO,GAAgB;QAC3B;YACE,IAAI,EAAE,gBAAgB,QAAQ,0BAA0B;YACxD,IAAI,EAAE;gBACJ,cAAc;gBACd,qCAAqC;gBACrC,mCAAmC;aACpC;YACD,IAAI,EAAE,CAAC,0CAA0C,CAAC;YAClD,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,uCAAuC;YAC7C,IAAI,EAAE,CAAC,wBAAwB,EAAE,qBAAqB,CAAC;YACvD,IAAI,EAAE,CAAC,wBAAwB,EAAE,6BAA6B,EAAE,aAAa,CAAC;YAC9E,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,iCAAiC;YAC9C,aAAa,EAAE,KAAK;SACrB;KACF,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,8BAA8B,IAAI,CAAC,KAAK,GAAG;QACrD,OAAO,EAAE,qBAAqB,QAAQ,gBAAgB,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,MAAM,GAAG;QAC1F,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,gBAAgB,QAAQ,0BAA0B;QAC9E,SAAS,EAAE,yBAAyB,QAAQ,8GAA8G;QAC1J,YAAY,EAAE;YACZ,qBAAqB,QAAQ,EAAE;YAC/B,4BAA4B;YAC5B,0CAA0C;SAC3C;QACD,SAAS,EAAE,CAAC,6BAA6B,EAAE,iDAAiD,CAAC;KAC9F,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAU,EAAE,SAA2B;IAClE,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;IAE/E,MAAM,OAAO,GAAgB;QAC3B;YACE,IAAI,EAAE,mBAAmB,OAAO,MAAM;YACtC,IAAI,EAAE,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,wBAAwB,CAAC;YACnF,IAAI,EAAE,CAAC,wBAAwB,EAAE,qBAAqB,CAAC;YACvD,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,sCAAsC;YAC5C,IAAI,EAAE,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,CAAC;YAC9E,IAAI,EAAE,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;YACrE,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,WAAW;YACxB,aAAa,EAAE,KAAK;SACrB;KACF,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,mBAAmB,IAAI,CAAC,KAAK,GAAG;QAC1C,OAAO,EAAE,sBAAsB,OAAO,KAAK,SAAS,CAAC,YAAY,CAAC,MAAM,sBAAsB;QAC9F,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,mBAAmB,OAAO,MAAM;QAC5D,SAAS,EAAE,uBAAuB,OAAO,qDAAqD;QAC9F,YAAY,EAAE;YACZ,qCAAqC;YACrC,2BAA2B;YAC3B,2CAA2C;SAC5C;QACD,SAAS,EAAE;YACT,yCAAyC;YACzC,qDAAqD;SACtD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,IAAU,EACV,SAA2B;IAE3B,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC;IAEnD,MAAM,OAAO,GAAgB;QAC3B;YACE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;YAC3D,IAAI,EAAE,CAAC,+BAA+B,EAAE,8BAA8B,CAAC;YACvE,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,SAAS;YACtB,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,2BAA2B,CAAC;YAC9E,IAAI,EAAE,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;YAC9D,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,oBAAoB,CAAC;YACpD,IAAI,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,CAAC;YAC3D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,WAAW;YACxB,aAAa,EAAE,IAAI;SACpB;KACF,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,yBAAyB,IAAI,CAAC,KAAK,iBAAiB;QAC9D,OAAO,EAAE,uBAAuB,SAAS,iBAAiB,IAAI,CAAC,KAAK,GAAG;QACvE,OAAO;QACP,MAAM,EACJ,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAClD,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,uBAAuB,CAAC;YAC/C,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,0BAA0B,CAAC;QACtD,SAAS,EAAE,OAAO,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,6DAA6D,GAAG;QAC5L,YAAY,EAAE;YACZ,uDAAuD;YACvD,iDAAiD;SAClD;QACD,SAAS,EAAE,CAAC,sBAAsB,EAAE,sCAAsC,CAAC;KAC5E,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,IAAU,EACV,SAA2B;IAE3B,MAAM,OAAO,GAAgB;QAC3B;YACE,IAAI,EAAE,uCAAuC;YAC7C,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC;YAChD,IAAI,EAAE,CAAC,SAAS,EAAE,qBAAqB,CAAC;YACxC,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,IAAI;SACpB;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,CAAC,YAAY,EAAE,sBAAsB,EAAE,YAAY,CAAC;YAC1D,IAAI,EAAE,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;YAC5D,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,WAAW;YACxB,aAAa,EAAE,SAAS,CAAC,QAAQ,KAAK,MAAM,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI;SAC5E;KACF,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,gCAAgC,IAAI,CAAC,KAAK,GAAG;QACvD,OAAO,EAAE,aAAa,SAAS,CAAC,QAAQ,iBAAiB,IAAI,CAAC,IAAI,GAAG;QACrE,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,uCAAuC;QACnE,SAAS,EACP,2FAA2F;QAC7F,YAAY,EAAE;YACZ,gDAAgD;YAChD,gCAAgC;YAChC,wCAAwC;SACzC;QACD,SAAS,EAAE,CAAC,sBAAsB,EAAE,uDAAuD,CAAC;KAC7F,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAa,EACb,IAAU,EACV,SAA2B;IAE3B,OAAO;QACL,QAAQ,EAAE,GAAG,KAAK,SAAS,IAAI,CAAC,KAAK,GAAG;QACxC,OAAO,EAAE,cAAc,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,KAAK,YAAY,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC/F,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,mBAAmB,KAAK,WAAW;gBACzC,IAAI,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC;gBACvC,IAAI,EAAE,CAAC,oBAAoB,CAAC;gBAC5B,MAAM,EAAE,KAAK;gBACb,WAAW,EAAE,UAAU;gBACvB,aAAa,EAAE,IAAI;aACpB;YACD;gBACE,IAAI,EAAE,iBAAiB,KAAK,WAAW;gBACvC,IAAI,EAAE,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;gBACpD,IAAI,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;gBACnD,MAAM,EAAE,gBAAgB;gBACxB,WAAW,EAAE,MAAM;gBACnB,aAAa,EAAE,KAAK;aACrB;SACF;QACD,MAAM,EAAE,mBAAmB,KAAK,WAAW;QAC3C,SAAS,EAAE,6GAA6G;QACxH,YAAY,EAAE;YACZ,GAAG,KAAK,yBAAyB;YACjC,kDAAkD;SACnD;QACD,SAAS,EAAE,CAAC,4BAA4B,EAAE,uCAAuC,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-adr/helpers.d.ts

@@ -0,0 +1,5 @@
+import type { Spec, ProjectKnowledge, ArchitectureDecision } from '../../types/index.js';
+export declare function readSpecContent(spec: Spec): Promise<string>;
+export declare function buildEcosystemAnalysis(knowledge: ProjectKnowledge): string;
+export declare function buildRecommendation(decisions: ArchitectureDecision[], knowledge: ProjectKnowledge): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/generate-adr/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-adr/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBjE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAW1E;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,oBAAoB,EAAE,EACjC,SAAS,EAAE,gBAAgB,GAC1B,MAAM,CAGR"}

package/dist/tools/generate-adr/helpers.js

@@ -0,0 +1,39 @@
+// tools/generate-adr/helpers.ts — ADR I/O and analysis helpers
+import { readFile } from 'node:fs/promises';
+export async function readSpecContent(spec) {
+    let content = spec.title + ' ' + spec.type + ' ' + spec.scope;
+    try {
+        if (spec.huPath) {
+            content += ' ' + (await readFile(spec.huPath, 'utf-8'));
+        }
+    }
+    catch {
+        /* file not available */
+    }
+    try {
+        if (spec.fichaTecnicaPath) {
+            content += ' ' + (await readFile(spec.fichaTecnicaPath, 'utf-8'));
+        }
+    }
+    catch {
+        /* file not available */
+    }
+    return content;
+}
+export function buildEcosystemAnalysis(knowledge) {
+    const parts = [
+        `Stack: ${knowledge.stack.join(', ')}.`,
+        `Architecture: ${knowledge.architecture.primary}.`,
+        `Database: ${knowledge.database}.`,
+        `Layers: ${knowledge.layers.join(', ') || 'not detected'}.`,
+    ];
+    if (knowledge.apiContracts.length > 0) {
+        parts.push(`API contracts: ${knowledge.apiContracts.map((c) => c.type).join(', ')}.`);
+    }
+    return parts.join(' ');
+}
+export function buildRecommendation(decisions, knowledge) {
+    const chosen = decisions.map((d) => `- ${d.decision}: ${d.chosen}`).join('\n');
+    return `Recommended decisions for the current ${knowledge.architecture.primary} architecture:\n${chosen}\n\nAll decisions prioritize consistency with the existing ecosystem. Re-evaluate if requirements change significantly.`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/generate-adr/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/tools/generate-adr/helpers.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAU;IAC9C,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IAC9D,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IACD,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAA2B;IAChE,MAAM,KAAK,GAAG;QACZ,UAAU,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACvC,iBAAiB,SAAS,CAAC,YAAY,CAAC,OAAO,GAAG;QAClD,aAAa,SAAS,CAAC,QAAQ,GAAG;QAClC,WAAW,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,GAAG;KAC5D,CAAC;IACF,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAAiC,EACjC,SAA2B;IAE3B,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,OAAO,yCAAyC,SAAS,CAAC,YAAY,CAAC,OAAO,mBAAmB,MAAM,yHAAyH,CAAC;AACnO,CAAC"}

package/dist/tools/generate-adr/index.d.ts

@@ -0,0 +1,3 @@
+export { generateDecisions } from './decisions.js';
+export { readSpecContent, buildEcosystemAnalysis, buildRecommendation } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/generate-adr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/generate-adr/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/generate-adr/index.js

@@ -0,0 +1,4 @@
+// tools/generate-adr/index.ts — barrel re-exports for generate-adr sub-modules
+export { generateDecisions } from './decisions.js';
+export { readSpecContent, buildEcosystemAnalysis, buildRecommendation } from './helpers.js';
+//# sourceMappingURL=index.js.map