specforge-mcp 0.1.0

package/dist/engine/advanced-testing/mutation-advisor.js

@@ -0,0 +1,226 @@
+// engine/advanced-testing/mutation-advisor.ts — SPEC-049
+// Recommends mutation testing configuration based on project language and coverage.
+/** Minimum coverage required before recommending mutation testing. */
+const MIN_COVERAGE_FOR_MUTATION = 90;
+/**
+ * Determine if mutation testing should be recommended.
+ * Only recommended when line/branch coverage is already >= 90%.
+ */
+export function shouldRecommendMutation(coverage) {
+    return coverage >= MIN_COVERAGE_FOR_MUTATION;
+}
+/** Map a language to its primary mutation testing tool. */
+export function getMutationTool(language) {
+    const lang = language.toLowerCase();
+    if (lang === 'typescript' || lang === 'javascript') {
+        return 'stryker';
+    }
+    if (lang === 'python') {
+        return 'mutmut';
+    }
+    if (lang === 'java' || lang === 'kotlin') {
+        return 'pitest';
+    }
+    if (lang === 'rust') {
+        return 'cargo-mutants';
+    }
+    if (lang === 'go') {
+        return 'gremlins';
+    }
+    if (lang === 'scala') {
+        return 'stryker4s';
+    }
+    if (lang === 'csharp' || lang === 'fsharp') {
+        return 'stryker-dotnet';
+    }
+    return 'stryker';
+}
+/** Generate the Stryker config file content for JS/TS with Vitest. */
+function buildStrykerVitestConfig(thresholdScore) {
+    return `// stryker.config.mjs
+/** @type {import('@stryker-mutator/api/core').PartialStrykerOptions} */
+const config = {
+  testRunner: 'vitest',
+  plugins: ['@stryker-mutator/vitest-runner'],
+  coverageAnalysis: 'perTest',
+  thresholds: {
+    high: ${thresholdScore},
+    low: ${Math.max(thresholdScore - 10, 60)},
+    break: ${Math.max(thresholdScore - 20, 50)},
+  },
+  mutate: [
+    'src/**/*.ts',
+    '!src/**/*.test.ts',
+    '!src/**/*.spec.ts',
+    '!src/**/index.ts',
+    '!src/config/**',
+  ],
+  reporters: ['html', 'json', 'progress'],
+  htmlReporter: { fileName: 'reports/mutation/index.html' },
+  jsonReporter: { fileName: 'reports/mutation/mutation.json' },
+  concurrency: 4,
+  timeoutMS: 60000,
+};
+
+export default config;
+`;
+}
+/** Generate the mutmut config for Python projects. */
+function buildMutmutConfig() {
+    return `# setup.cfg — mutmut configuration
+[mutmut]
+paths_to_mutate=src/
+backup=False
+runner=python -m pytest -x --timeout=10
+tests_dir=tests/
+dict_synonyms=
+`;
+}
+/** Generate the PIT (Pitest) Maven plugin config for Java. */
+function buildPitestConfig(thresholdScore) {
+    return `<!-- pom.xml — PIT mutation testing plugin -->
+<plugin>
+  <groupId>org.pitest</groupId>
+  <artifactId>pitest-maven</artifactId>
+  <version>1.15.0</version>
+  <configuration>
+    <targetClasses>
+      <param>com.yourcompany.*</param>
+    </targetClasses>
+    <targetTests>
+      <param>com.yourcompany.*Test</param>
+    </targetTests>
+    <mutationThreshold>${thresholdScore}</mutationThreshold>
+    <coverageThreshold>90</coverageThreshold>
+    <outputFormats>
+      <outputFormat>HTML</outputFormat>
+      <outputFormat>XML</outputFormat>
+    </outputFormats>
+    <timestampedReports>false</timestampedReports>
+    <threads>4</threads>
+  </configuration>
+</plugin>
+`;
+}
+/** Generate the cargo-mutants config for Rust projects. */
+function buildCargoMutantsConfig() {
+    return `# .cargo-mutants.toml
+timeout_multiplier = 3.0
+in_place = false
+jobs = 4
+
+# Exclude generated or external code
+exclude_globs = [
+  "src/generated/**",
+  "src/vendor/**",
+]
+`;
+}
+/** Generate the gremlins config for Go projects. */
+function buildGremlinsConfig(thresholdScore) {
+    return `# .gremlins.yaml
+threshold:
+  mutant_coverage: ${thresholdScore}
+  efficiency: 100
+
+mutants:
+  arithmetic_base:
+    enabled: true
+  conditional_boundary:
+    enabled: true
+  negate_conditionals:
+    enabled: true
+  remove_negation:
+    enabled: true
+
+output:
+  go_module: true
+`;
+}
+/** Generate the Stryker4s config for Scala projects. */
+function buildStryker4sConfig(thresholdScore) {
+    return `// stryker4s.conf
+stryker4s {
+  mutate = ["src/main/scala/**/*.scala"]
+  thresholds {
+    high = ${thresholdScore}
+    low = ${Math.max(thresholdScore - 10, 60)}
+    break = ${Math.max(thresholdScore - 20, 50)}
+  }
+  reporters = ["html", "json"]
+  base-dir = .
+}
+`;
+}
+/** Generate the Stryker .NET config. */
+function buildStrykerDotnetConfig(thresholdScore) {
+    return `// stryker-config.json
+{
+  "stryker-config": {
+    "project": "YourProject.csproj",
+    "test-projects": ["YourProject.Tests/YourProject.Tests.csproj"],
+    "threshold-high": ${thresholdScore},
+    "threshold-low": ${Math.max(thresholdScore - 10, 60)},
+    "threshold-break": ${Math.max(thresholdScore - 20, 50)},
+    "reporters": ["html", "json"],
+    "concurrency": 4
+  }
+}
+`;
+}
+/**
+ * Generate a mutation testing configuration for the given tool and language.
+ * Returns the full MutationConfig with config file content and threshold.
+ */
+export function generateMutationConfig(tool, language) {
+    const thresholdScore = 80;
+    let configFileContent = buildStrykerVitestConfig(thresholdScore);
+    switch (tool) {
+        case 'stryker':
+            configFileContent = buildStrykerVitestConfig(thresholdScore);
+            break;
+        case 'mutmut':
+        case 'cosmic-ray':
+            configFileContent = buildMutmutConfig();
+            break;
+        case 'pitest':
+            configFileContent = buildPitestConfig(thresholdScore);
+            break;
+        case 'cargo-mutants':
+            configFileContent = buildCargoMutantsConfig();
+            break;
+        case 'gremlins':
+            configFileContent = buildGremlinsConfig(thresholdScore);
+            break;
+        case 'stryker4s':
+            configFileContent = buildStryker4sConfig(thresholdScore);
+            break;
+        case 'stryker-dotnet':
+            configFileContent = buildStrykerDotnetConfig(thresholdScore);
+            break;
+    }
+    const excludePatterns = getDefaultExcludePatterns(language);
+    const includeReporters = ['html', 'json', 'progress'];
+    return {
+        tool,
+        thresholdScore,
+        configFile: configFileContent,
+        excludePatterns,
+        includeReporters,
+    };
+}
+/** Return sensible default exclude patterns for a language. */
+function getDefaultExcludePatterns(language) {
+    const lang = language.toLowerCase();
+    if (lang === 'typescript' || lang === 'javascript') {
+        return ['**/*.test.ts', '**/*.spec.ts', '**/index.ts', 'src/config/**', 'src/types/**'];
+    }
+    if (lang === 'python') {
+        return ['tests/**', 'setup.py', 'conftest.py'];
+    }
+    if (lang === 'java' || lang === 'kotlin') {
+        return ['**/*Test*.java', '**/*Spec*.java'];
+    }
+    return ['**/*.test.*', '**/*.spec.*'];
+}
+//# sourceMappingURL=mutation-advisor.js.map

package/dist/engine/advanced-testing/mutation-advisor.js.map

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

package/dist/engine/advanced-testing/property-based.d.ts

@@ -0,0 +1,14 @@
+import type { PropertyScaffold, PropertyTestFramework } from '../../types/index.js';
+/**
+ * Detect if the given criteria text suggests property-based testing is needed.
+ * Uses a conservative approach: requires strong invariant keywords.
+ */
+export declare function detectPropertyBasedNeed(criteria: string): boolean;
+/** Map a language identifier to its property test framework. */
+export declare function getPropertyTestFramework(language: string): PropertyTestFramework;
+/**
+ * Generate a property-based testing scaffold for the given language and invariant description.
+ * Returns a PropertyScaffold with the framework name, invariant description, and scaffold code.
+ */
+export declare function generatePropertyScaffold(language: string, invariantHint: string): PropertyScaffold;
+//# sourceMappingURL=property-based.d.ts.map

package/dist/engine/advanced-testing/property-based.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-based.d.ts","sourceRoot":"","sources":["../../../src/engine/advanced-testing/property-based.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA4BpF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAwBhF;AA2GD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CA6BlB"}

package/dist/engine/advanced-testing/property-based.js

@@ -0,0 +1,192 @@
+// engine/advanced-testing/property-based.ts — SPEC-049
+// Detects property-based testing needs and generates scaffold code.
+/** Keywords (case-insensitive) that indicate a property-based testing need. */
+const PBT_KEYWORDS_ES = [
+    'siempre',
+    'nunca',
+    'para cualquier',
+    'para todos',
+    'invariant',
+    'idempotent',
+    'commutative',
+    'conmutativo',
+    'idempotente',
+];
+const PBT_KEYWORDS_EN = [
+    'always',
+    'never',
+    'for any',
+    'for all',
+    'invariant',
+    'idempotent',
+    'commutative',
+];
+/** All keywords that trigger PBT detection. */
+const PBT_KEYWORDS = [...PBT_KEYWORDS_ES, ...PBT_KEYWORDS_EN];
+/**
+ * Detect if the given criteria text suggests property-based testing is needed.
+ * Uses a conservative approach: requires strong invariant keywords.
+ */
+export function detectPropertyBasedNeed(criteria) {
+    const lower = criteria.toLowerCase();
+    return PBT_KEYWORDS.some((kw) => lower.includes(kw));
+}
+/** Map a language identifier to its property test framework. */
+export function getPropertyTestFramework(language) {
+    const lang = language.toLowerCase();
+    if (lang === 'typescript' || lang === 'javascript') {
+        return 'fast-check';
+    }
+    if (lang === 'python') {
+        return 'hypothesis';
+    }
+    if (lang === 'rust') {
+        return 'proptest';
+    }
+    if (lang === 'java' || lang === 'kotlin') {
+        return 'jqwik';
+    }
+    if (lang === 'go') {
+        return 'gopter';
+    }
+    if (lang === 'haskell') {
+        return 'quickcheck';
+    }
+    if (lang === 'scala') {
+        return 'scalacheck';
+    }
+    return 'fast-check';
+}
+/** Generate the scaffold code for a fast-check (JS/TS) property test. */
+function buildFastCheckScaffold(invariantHint) {
+    return `import * as fc from 'fast-check';
+import { describe, it, expect } from 'vitest';
+
+describe('Property-based tests — ${invariantHint}', () => {
+  it('${invariantHint}', () => {
+    fc.assert(
+      fc.property(fc.integer(), fc.integer(), (a, b) => {
+        // TODO: replace with the actual function under test
+        const result = yourFunction(a, b);
+        // Assert the invariant holds for any valid input
+        expect(result).toBeDefined();
+      }),
+    );
+  });
+});
+`;
+}
+/** Generate the scaffold code for a Hypothesis (Python) property test. */
+function buildHypothesisScaffold(invariantHint) {
+    return `from hypothesis import given, settings, HealthCheck
+from hypothesis import strategies as st
+
+
+@given(st.integers(), st.integers())
+@settings(
+    max_examples=100,
+    suppress_health_check=[HealthCheck.too_slow],
+    deadline=None,
+)
+def test_${invariantHint.toLowerCase().replace(/[^a-z0-9]/g, '_')}(a: int, b: int) -> None:
+    """${invariantHint}"""
+    # TODO: replace with the actual function under test
+    result = your_function(a, b)
+    # Assert the invariant holds for any valid input
+    assert result is not None
+`;
+}
+/** Generate the scaffold code for a proptest (Rust) property test. */
+function buildProptestScaffold(invariantHint) {
+    return `use proptest::prelude::*;
+
+proptest! {
+    #[test]
+    fn test_${invariantHint.toLowerCase().replace(/[^a-z0-9]/g, '_')}(a in any::<i32>(), b in any::<i32>()) {
+        // ${invariantHint}
+        // TODO: replace with the actual function under test
+        let result = your_function(a, b);
+        // Assert the invariant holds for any valid input
+        prop_assert!(result.is_ok());
+    }
+}
+`;
+}
+/** Generate the scaffold code for a jqwik (Java) property test. */
+function buildJqwikScaffold(invariantHint) {
+    return `import net.jqwik.api.*;
+
+class ${invariantHint.replace(/[^a-zA-Z0-9]/g, '')}PropertyTest {
+
+    @Property
+    boolean ${invariantHint.toLowerCase().replace(/[^a-z0-9]/g, '_')}(
+            @ForAll int a,
+            @ForAll int b) {
+        // TODO: replace with the actual method under test
+        Object result = yourMethod(a, b);
+        // Assert the invariant holds for any valid input
+        return result != null;
+    }
+}
+`;
+}
+/** Generate the scaffold code for a gopter (Go) property test. */
+function buildGopterScaffold(invariantHint) {
+    return `package mypackage_test
+
+import (
+    "testing"
+
+    "github.com/leanovate/gopter"
+    "github.com/leanovate/gopter/gen"
+    "github.com/leanovate/gopter/prop"
+)
+
+func Test${invariantHint.replace(/[^a-zA-Z0-9]/g, '')}(t *testing.T) {
+    properties := gopter.NewProperties(nil)
+    properties.Property("${invariantHint}", prop.ForAll(
+        func(a, b int) bool {
+            // TODO: replace with the actual function under test
+            result := YourFunction(a, b)
+            // Assert the invariant holds for any valid input
+            return result != nil
+        },
+        gen.Int(), gen.Int(),
+    ))
+    properties.TestingRun(t)
+}
+`;
+}
+/**
+ * Generate a property-based testing scaffold for the given language and invariant description.
+ * Returns a PropertyScaffold with the framework name, invariant description, and scaffold code.
+ */
+export function generatePropertyScaffold(language, invariantHint) {
+    const framework = getPropertyTestFramework(language);
+    let scaffold = buildFastCheckScaffold(invariantHint);
+    switch (framework) {
+        case 'hypothesis':
+            scaffold = buildHypothesisScaffold(invariantHint);
+            break;
+        case 'proptest':
+            scaffold = buildProptestScaffold(invariantHint);
+            break;
+        case 'jqwik':
+            scaffold = buildJqwikScaffold(invariantHint);
+            break;
+        case 'gopter':
+            scaffold = buildGopterScaffold(invariantHint);
+            break;
+        case 'fast-check':
+        case 'quickcheck':
+        case 'scalacheck':
+            scaffold = buildFastCheckScaffold(invariantHint);
+            break;
+    }
+    return {
+        name: `Property test — ${invariantHint}`,
+        invariant: invariantHint,
+        scaffold,
+    };
+}
+//# sourceMappingURL=property-based.js.map

package/dist/engine/advanced-testing/property-based.js.map

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

package/dist/engine/advanced-testing/test-data-advisor.d.ts

@@ -0,0 +1,15 @@
+import type { ToolingEntry } from '../../types/index.js';
+/** Check if the project involves sensitive/PII data. */
+export declare function hasPiiSignals(stack: string[], description?: string): boolean;
+/**
+ * Build the test data management criteria for create_spec.
+ * These criteria enforce no production data and factory-based test data.
+ */
+export declare function buildTestDataCriteria(): string[];
+/**
+ * Map a language to synthetic data tooling recommendations.
+ */
+export declare function getTestDataTooling(language: string): ToolingEntry[];
+/** Get AI-assisted test generation tooling recommendations (language-agnostic). */
+export declare function getAiTestingTooling(): ToolingEntry[];
+//# sourceMappingURL=test-data-advisor.d.ts.map

package/dist/engine/advanced-testing/test-data-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-data-advisor.d.ts","sourceRoot":"","sources":["../../../src/engine/advanced-testing/test-data-advisor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAoBzD,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAQhD;AAsDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA2CnE;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,IAAI,YAAY,EAAE,CA4BpD"}

package/dist/engine/advanced-testing/test-data-advisor.js

@@ -0,0 +1,163 @@
+// engine/advanced-testing/test-data-advisor.ts — SPEC-049
+// Provides test data management criteria and synthetic data tooling recommendations.
+/** PII/PHI signals in stack or project descriptions. */
+const PII_SIGNALS = [
+    'pii',
+    'phi',
+    'gdpr',
+    'hipaa',
+    'personal data',
+    'sensitive',
+    'user data',
+    'patient',
+    'medical',
+    'financial',
+    'payment',
+    'credit card',
+    'ssn',
+    'social security',
+];
+/** Check if the project involves sensitive/PII data. */
+export function hasPiiSignals(stack, description) {
+    const text = [...stack, description ?? ''].join(' ').toLowerCase();
+    return PII_SIGNALS.some((sig) => text.includes(sig));
+}
+/**
+ * Build the test data management criteria for create_spec.
+ * These criteria enforce no production data and factory-based test data.
+ */
+export function buildTestDataCriteria() {
+    return [
+        '- [ ] Los tests no usan datos reales de producción — usan synthetic data generada programáticamente (requisito GDPR/HIPAA)',
+        '- [ ] Los fixtures de tests se generan con factories (factory_boy para Python, fishery/factory.ts para JS/TS) — no con archivos JSON estáticos hardcodeados',
+        '- [ ] Los datos sensibles en tests usan data masking o valores fake consistentes (Faker/Mimesis/Fakr)',
+        '- [ ] Los seeds de base de datos de test son deterministas — misma semilla siempre genera mismos datos',
+        '- [ ] Las factories pueden generar datos edge-case: campos vacíos, caracteres unicode, longitudes máximas',
+    ];
+}
+/** JS/TS test data tools. */
+function jsTestDataTools() {
+    return [
+        {
+            name: '@faker-js/faker',
+            description: 'Faker for JavaScript/TypeScript — generate realistic fake data',
+            category: 'test-data',
+            installCommand: 'pnpm add -D @faker-js/faker',
+            docsUrl: 'https://fakerjs.dev',
+            recommended: true,
+        },
+        {
+            name: 'fishery',
+            description: 'TypeScript factory library with trait support (factory_boy for TS)',
+            category: 'test-data',
+            installCommand: 'pnpm add -D fishery',
+            docsUrl: 'https://github.com/thoughtbot/fishery',
+            recommended: true,
+        },
+    ];
+}
+/** Python test data tools. */
+function pythonTestDataTools() {
+    return [
+        {
+            name: 'Faker',
+            description: 'Faker for Python — 100+ locales, most popular fake data library',
+            category: 'test-data',
+            installCommand: 'pip install faker',
+            docsUrl: 'https://faker.readthedocs.io',
+            recommended: true,
+        },
+        {
+            name: 'factory_boy',
+            description: 'Factory library for Django/SQLAlchemy — declarative test fixtures',
+            category: 'test-data',
+            installCommand: 'pip install factory_boy',
+            docsUrl: 'https://factoryboy.readthedocs.io',
+            recommended: true,
+        },
+        {
+            name: 'Mimesis',
+            description: 'High-performance fake data — 100+ locales, faster than Faker',
+            category: 'test-data',
+            installCommand: 'pip install mimesis',
+            docsUrl: 'https://mimesis.name',
+            recommended: false,
+        },
+    ];
+}
+/**
+ * Map a language to synthetic data tooling recommendations.
+ */
+export function getTestDataTooling(language) {
+    const lang = language.toLowerCase();
+    if (lang === 'typescript' || lang === 'javascript') {
+        return jsTestDataTools();
+    }
+    if (lang === 'python') {
+        return pythonTestDataTools();
+    }
+    if (lang === 'go') {
+        return [
+            {
+                name: 'go-faker',
+                description: 'Faker for Go — simple fake data generation',
+                category: 'test-data',
+                installCommand: 'go get github.com/brianvoe/gofakeit/v6',
+                docsUrl: 'https://github.com/brianvoe/gofakeit',
+                recommended: true,
+            },
+        ];
+    }
+    if (lang === 'java' || lang === 'kotlin') {
+        return [
+            {
+                name: 'JavaFaker',
+                description: 'Java port of Faker — widely used for test data',
+                category: 'test-data',
+                installCommand: 'implementation("com.github.javafaker:javafaker:1.0.2")',
+                docsUrl: 'https://github.com/DiUS/java-faker',
+                recommended: true,
+            },
+        ];
+    }
+    return [
+        {
+            name: 'Faker',
+            description: 'Cross-language fake data generation (Python/JS/Go/Ruby)',
+            category: 'test-data',
+            installCommand: 'See https://github.com/faker-ruby/faker for language-specific packages',
+            docsUrl: 'https://fakerjs.dev',
+            recommended: true,
+        },
+    ];
+}
+/** Get AI-assisted test generation tooling recommendations (language-agnostic). */
+export function getAiTestingTooling() {
+    return [
+        {
+            name: 'Keploy',
+            description: 'Captures real traffic and generates tests automatically — supports Go/Java/Node/Python',
+            category: 'ai-testing',
+            installCommand: 'curl --silent --location "https://get.keploy.io" | bash',
+            docsUrl: 'https://keploy.io/docs',
+            recommended: true,
+        },
+        {
+            name: 'CodiumAI',
+            description: 'AI unit test generation from existing code — VS Code / JetBrains plugin',
+            category: 'ai-testing',
+            installCommand: 'Install via IDE marketplace',
+            docsUrl: 'https://www.codium.ai',
+            recommended: false,
+        },
+        {
+            name: 'Qodo (formerly CodiumAI)',
+            description: 'AI-powered test suggestions for PRs — GitHub App integration',
+            category: 'ai-testing',
+            installCommand: 'Install via GitHub Marketplace',
+            docsUrl: 'https://qodo.ai',
+            recommended: false,
+        },
+    ];
+}
+//# sourceMappingURL=test-data-advisor.js.map

package/dist/engine/advanced-testing/test-data-advisor.js.map

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

package/dist/engine/agent-generator/builders.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+export declare function buildSystemPrompt(agentName: string, role: string, capabilities: string[], knowledge: ProjectKnowledge): string;
+export declare function buildCoordinatorPrompt(knowledge: ProjectKnowledge): string;
+export declare function inferModel(role: string, capabilities: string[]): string;
+export declare function inferTools(role: string, _capabilities: string[], knowledge: ProjectKnowledge): string[];
+export declare function inferMaxTurns(role: string): number;
+export declare function inferHandoffConditions(role: string): string[];
+//# sourceMappingURL=builders.d.ts.map

package/dist/engine/agent-generator/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/engine/agent-generator/builders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EAAE,EACtB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,CA2CR;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CA2B1E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAavE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,EAAE,CA+BV;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB7D"}