specforge-mcp 0.1.0

package/dist/tools/create-spec/agent-spec-adapter-b.js

@@ -0,0 +1,119 @@
+// tools/create-spec/agent-spec-adapter-b.ts — Agent Contract, Memory, Inter-Agent, and HU section
+// SPEC-016a: Criteria 16, 17, 18, and HU section builder.
+import { generateAgentSpec, generateAgentConstitution, generateBeginnerAgentGuide, generateExpertAgentSpec, buildDefaultAgentTools, } from './agent-spec-adapter.js';
+// === Agent Contract (criterion 16) ===
+export function generateAgentContract(title, description) {
+    const tools = buildDefaultAgentTools(description);
+    const signatures = tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        params: Object.fromEntries(Object.entries(t.inputSchema).map(([k, v]) => [k, v.type ?? 'string'])),
+        output: Object.keys(t.outputSchema).join(', '),
+    }));
+    return {
+        naturalLanguageObjective: `${title}: ${description}`,
+        toolSignatures: signatures,
+        terminationCriterion: 'Task completed successfully OR escalation triggered OR max_iterations reached',
+        maxIterations: 10,
+        toolFailureBehavior: 'Retry once with exponential backoff; if still failing, return error response',
+    };
+}
+// === Memory Contract (criterion 17) ===
+export function generateMemoryContract(description) {
+    const lower = description.toLowerCase();
+    const needsVector = lower.includes('document') || lower.includes('knowledge') || lower.includes('rag');
+    return {
+        memoryType: needsVector ? 'vector-store' : 'in-context',
+        persistedFields: ['user-preferences', 'session-history', 'learned-context'],
+        ephemeralFields: ['current-tool-output', 'intermediate-reasoning', 'scratch-pad'],
+        retrievalCriteria: 'Semantic similarity threshold > 0.8 for vector-store; last 20 turns for in-context',
+        corruptionBehavior: 'On corrupt memory: clear ephemeral fields, reload from persistent store, notify user of context reset',
+    };
+}
+// === Inter-agent Communication Contract (criterion 18) ===
+export function generateInterAgentContract() {
+    return {
+        handoffMessageSchema: {
+            from: 'string',
+            to: 'string',
+            task: 'string',
+            context: 'object',
+            priority: "'low' | 'medium' | 'high'",
+            timeout_ms: 'number',
+        },
+        callerPermissions: {
+            coordinator: ['all-agents'],
+            analyst: ['implementor', 'reviewer'],
+            implementor: [],
+            reviewer: ['coordinator'],
+        },
+        conflictResolution: 'Coordinator agent has final authority. On conflict, pause execution and request human input.',
+        criticalSubagentFailureBehavior: 'Mark task as failed, rollback any partial state, escalate to coordinator with failure report.',
+    };
+}
+// === HU.md agent section builder ===
+export function buildAgentHuSection(title, description, knowledge, experienceLevel) {
+    const spec = generateAgentSpec(title, description);
+    const constitution = generateAgentConstitution();
+    const contract = generateAgentContract(title, description);
+    const memory = generateMemoryContract(description);
+    const lines = ['', '## AI Agent Specification', ''];
+    if (experienceLevel === 'beginner') {
+        lines.push(generateBeginnerAgentGuide(title, description));
+        lines.push('');
+    }
+    else {
+        lines.push(generateExpertAgentSpec(title, description, knowledge));
+        lines.push('');
+    }
+    lines.push('### Agent Goal');
+    lines.push(spec.goal);
+    lines.push('');
+    lines.push('### Triggers');
+    for (const trigger of spec.triggers) {
+        lines.push(`- ${trigger}`);
+    }
+    lines.push('');
+    lines.push('### Tools');
+    for (const tool of spec.tools) {
+        lines.push(`- **${tool.name}**: ${tool.description}`);
+        if (tool.sideEffects.length > 0) {
+            lines.push(`  - Side effects: ${tool.sideEffects.join(', ')}`);
+        }
+    }
+    lines.push('');
+    lines.push('### Agent Contract');
+    lines.push(`- **Objective**: ${contract.naturalLanguageObjective}`);
+    lines.push(`- **Max iterations**: ${contract.maxIterations}`);
+    lines.push(`- **Termination**: ${contract.terminationCriterion}`);
+    lines.push(`- **Tool failure**: ${contract.toolFailureBehavior}`);
+    lines.push('');
+    lines.push('### Memory Contract');
+    lines.push(`- **Memory type**: ${memory.memoryType}`);
+    lines.push(`- **Persisted fields**: ${memory.persistedFields.join(', ')}`);
+    lines.push(`- **Retrieval**: ${memory.retrievalCriteria}`);
+    lines.push(`- **Corruption behavior**: ${memory.corruptionBehavior}`);
+    lines.push('');
+    lines.push('### Agent Constitution');
+    lines.push('**Accuracy:**');
+    for (const a of constitution.accuracy) {
+        lines.push(`- ${a}`);
+    }
+    lines.push('**Safety:**');
+    for (const s of constitution.safety) {
+        lines.push(`- ${s}`);
+    }
+    lines.push('**Privacy:**');
+    for (const p of constitution.privacy) {
+        lines.push(`- ${p}`);
+    }
+    lines.push('**Escalation:**');
+    for (const e of constitution.escalation) {
+        lines.push(`- ${e}`);
+    }
+    lines.push('');
+    lines.push('### Error Handling');
+    lines.push(spec.errorHandling);
+    return lines.join('\n');
+}
+//# sourceMappingURL=agent-spec-adapter-b.js.map

package/dist/tools/create-spec/agent-spec-adapter-b.js.map

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

package/dist/tools/create-spec/agent-spec-adapter.d.ts

@@ -0,0 +1,15 @@
+export { generateAgentContract, generateMemoryContract, generateInterAgentContract, buildAgentHuSection, } from './agent-spec-adapter-b.js';
+import type { AgentSpec, AgentConstitution, AgentTool, ProjectKnowledge } from '../../types/index.js';
+/**
+ * Generate a step-by-step beginner guide for an agent spec.
+ */
+export declare function generateBeginnerAgentGuide(title: string, description: string): string;
+/**
+ * Generate a complete expert agent spec with system prompt, tool definitions,
+ * RAG pipeline notes, and evaluation criteria.
+ */
+export declare function generateExpertAgentSpec(title: string, description: string, knowledge: ProjectKnowledge | null): string;
+export declare function buildDefaultAgentTools(description: string): AgentTool[];
+export declare function generateAgentSpec(title: string, description: string): AgentSpec;
+export declare function generateAgentConstitution(): AgentConstitution;
+//# sourceMappingURL=agent-spec-adapter.d.ts.map

package/dist/tools/create-spec/agent-spec-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec-adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/create-spec/agent-spec-adapter.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA4BrF;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,MAAM,CAuDR;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAkDvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAkB/E;AAID,wBAAgB,yBAAyB,IAAI,iBAAiB,CA2B7D"}

package/dist/tools/create-spec/agent-spec-adapter.js

@@ -0,0 +1,189 @@
+// SpecForge — Agent Spec Adapter
+// SPEC-016a: Generates specialized agent spec content when type is "agent".
+// Criteria 1, 11, 12.
+// See agent-spec-adapter-b.ts for: generateAgentContract, generateMemoryContract,
+//   generateInterAgentContract, buildAgentHuSection (criteria 16, 17, 18).
+export { generateAgentContract, generateMemoryContract, generateInterAgentContract, buildAgentHuSection, } from './agent-spec-adapter-b.js';
+// === Beginner output (criterion 11) ===
+/**
+ * Generate a step-by-step beginner guide for an agent spec.
+ */
+export function generateBeginnerAgentGuide(title, description) {
+    const lines = [
+        `## Step-by-Step Guide: ${title}`,
+        '',
+        '### What this agent does',
+        description,
+        '',
+        '### Step 1: Define the goal',
+        'Write a single sentence describing what the agent accomplishes.',
+        '',
+        '### Step 2: Identify triggers',
+        'List events that start the agent: user message, scheduled task, webhook, etc.',
+        '',
+        '### Step 3: Choose tools',
+        'Pick tools the agent can call: web search, database, email, calendar, etc.',
+        '',
+        '### Step 4: Define outputs',
+        'Decide what the agent returns: text, JSON, action taken, file, notification.',
+        '',
+        '### Step 5: Handle errors',
+        'Plan what happens when a tool fails or the agent gets confused.',
+        '',
+        '### Step 6: Set limits',
+        'Configure max iterations to prevent infinite loops.',
+        '',
+        '> Tip: Start simple — one tool, one output. Add complexity once the basic flow works.',
+    ];
+    return lines.join('\n');
+}
+// === Expert spec generation (criterion 12) ===
+/**
+ * Generate a complete expert agent spec with system prompt, tool definitions,
+ * RAG pipeline notes, and evaluation criteria.
+ */
+export function generateExpertAgentSpec(title, description, knowledge) {
+    const lang = knowledge?.language ?? 'TypeScript';
+    const framework = knowledge?.framework ?? 'unknown';
+    const lines = [
+        `## Expert Agent Spec: ${title}`,
+        '',
+        '### System Prompt Template',
+        '```',
+        `You are ${title}, a specialized AI agent.`,
+        `Your mission: ${description}`,
+        '',
+        'Operating constraints:',
+        '- Only call tools when you have sufficient context',
+        '- Verify tool outputs before acting on them',
+        '- Escalate to human when confidence < 0.7',
+        '- Never exceed MAX_ITERATIONS tool calls',
+        '```',
+        '',
+        '### Tool Definitions',
+        '```json',
+        JSON.stringify([
+            {
+                name: 'primary_tool',
+                description: `Main tool for ${title}`,
+                input_schema: {
+                    type: 'object',
+                    properties: { query: { type: 'string', description: 'Input query' } },
+                    required: ['query'],
+                },
+            },
+        ], null, 2),
+        '```',
+        '',
+        '### RAG Pipeline',
+        `Language: ${lang} | Framework: ${framework}`,
+        '',
+        '1. **Ingest**: Load knowledge sources into vector store',
+        '2. **Embed**: Convert documents to embeddings (text-embedding-3-small or claude)',
+        '3. **Retrieve**: Semantic search with top-k=5, cosine similarity',
+        '4. **Augment**: Inject retrieved context into system prompt',
+        '5. **Generate**: LLM generates grounded response',
+        '',
+        '### Evaluation Criteria',
+        '- **Accuracy**: Ground truth comparison on test cases (target > 90%)',
+        '- **Faithfulness**: Response grounded in retrieved context (target > 95%)',
+        '- **Latency**: P95 < 3s for tool calls, < 10s for full response',
+        '- **Safety**: Zero harmful outputs on adversarial test suite',
+        '- **Cost**: < $0.01 per request at P50',
+    ];
+    return lines.join('\n');
+}
+// === Agent spec content generation (criterion 1) ===
+export function buildDefaultAgentTools(description) {
+    const lower = description.toLowerCase();
+    const tools = [];
+    if (lower.includes('search') || lower.includes('web') || lower.includes('research')) {
+        tools.push({
+            name: 'web_search',
+            description: 'Search the web for current information',
+            inputSchema: { query: { type: 'string' }, maxResults: { type: 'number' } },
+            outputSchema: { results: { type: 'array' } },
+            sideEffects: [],
+        });
+    }
+    if (lower.includes('email') || lower.includes('notify') || lower.includes('alert')) {
+        tools.push({
+            name: 'send_email',
+            description: 'Send email notification',
+            inputSchema: {
+                to: { type: 'string' },
+                subject: { type: 'string' },
+                body: { type: 'string' },
+            },
+            outputSchema: { messageId: { type: 'string' }, sent: { type: 'boolean' } },
+            sideEffects: ['network-call', 'external-service'],
+        });
+    }
+    if (lower.includes('database') || lower.includes('data') || lower.includes('record')) {
+        tools.push({
+            name: 'query_database',
+            description: 'Query the application database',
+            inputSchema: { query: { type: 'string' }, params: { type: 'array' } },
+            outputSchema: { rows: { type: 'array' }, count: { type: 'number' } },
+            sideEffects: ['database-read'],
+        });
+    }
+    // Always add a fallback tool
+    if (tools.length === 0) {
+        tools.push({
+            name: 'execute_task',
+            description: 'Execute the primary task',
+            inputSchema: { input: { type: 'string' } },
+            outputSchema: { result: { type: 'string' }, status: { type: 'string' } },
+            sideEffects: [],
+        });
+    }
+    return tools;
+}
+export function generateAgentSpec(title, description) {
+    const tools = buildDefaultAgentTools(description);
+    return {
+        goal: `${title}: ${description}`,
+        triggers: ['user-message', 'scheduled-task', 'webhook-event'],
+        tools,
+        knowledgeSources: ['project-documentation', 'knowledge-base'],
+        decisionRules: [
+            'Use tools only when user intent is clear',
+            'Verify tool outputs before proceeding',
+            'Escalate to human when confidence < 0.7',
+            'Stop after max_iterations to prevent infinite loops',
+        ],
+        outputs: ['structured-response', 'action-confirmation', 'error-report'],
+        errorHandling: 'On tool failure: retry once with backoff, then return graceful error to user. Log all failures.',
+    };
+}
+// === Agent Constitution (criterion 9) ===
+export function generateAgentConstitution() {
+    return {
+        accuracy: [
+            'Always verify information from at least 2 sources before presenting as fact',
+            'Acknowledge uncertainty explicitly — use "I believe" or "According to..."',
+            'Never hallucinate tool outputs — use actual tool call results only',
+            'Cross-validate numerical data before presenting',
+        ],
+        safety: [
+            'Never execute destructive operations without explicit user confirmation',
+            'Refuse requests that could harm users or third parties',
+            'Implement rate limiting: max 10 tool calls per conversation turn',
+            'Sanitize all tool inputs to prevent injection attacks',
+        ],
+        privacy: [
+            'Never log personally identifiable information (PII)',
+            'Do not retain conversation history beyond configured retention period',
+            'Mask sensitive fields (passwords, API keys, SSNs) in all outputs',
+            'Comply with user data deletion requests immediately',
+        ],
+        escalation: [
+            'Escalate when confidence < 0.7 on critical decisions',
+            'Escalate when tool has failed more than once on the same request',
+            'Escalate when user expresses frustration or confusion',
+            'Always provide escalation context: what was attempted, what failed, why',
+        ],
+    };
+}
+//# sourceMappingURL=agent-spec-adapter.js.map

package/dist/tools/create-spec/agent-spec-adapter.js.map

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

package/dist/tools/create-spec/analytics-spec-adapter.d.ts

@@ -0,0 +1,21 @@
+import type { AnalyticsStack, AnalyticsSpec } from '../../types/index.js';
+/**
+ * Returns true when create_spec should generate an Analytics section.
+ * Requires: user interaction feature AND a detected analytics provider.
+ */
+export declare function shouldGenerateAnalyticsSection(title: string, description: string, criteria: string, stack: AnalyticsStack | null): boolean;
+/**
+ * Builds a complete AnalyticsSpec for a feature.
+ * Called from create_spec when shouldGenerateAnalyticsSection returns true.
+ */
+export declare function buildAnalyticsSpec(specId: string, title: string, description: string, criteria: string, stack: AnalyticsStack, hasGdprOrCcpa: boolean): AnalyticsSpec;
+/**
+ * Generates a "no provider detected" note for specs where analytics is not configured.
+ */
+export declare function buildNoProviderNote(): string;
+/**
+ * Generates the HU.md Analytics section as a Markdown string.
+ */
+export declare function buildAnalyticsHuSection(analyticsSpec: AnalyticsSpec): string;
+export { isUserInteractionFeature, hasPIIProperties } from '../../engine/analytics-detector.js';
+//# sourceMappingURL=analytics-spec-adapter.d.ts.map

package/dist/tools/create-spec/analytics-spec-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-spec-adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/create-spec/analytics-spec-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAU,MAAM,sBAAsB,CAAC;AAclF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GAAG,IAAI,GAC3B,OAAO,CAKT;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,OAAO,GACrB,aAAa,CA2Bf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAyF5E;AA2BD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/tools/create-spec/analytics-spec-adapter.js

@@ -0,0 +1,155 @@
+// tools/create-spec/analytics-spec-adapter.ts
+// SPEC-032: Generates analytics spec sections for features with user interaction.
+import { isUserInteractionFeature, isFunnelFeature, isABTestFeature, generateEvents, generateFunnelEvents, hasPIIProperties, } from '../../engine/analytics-detector.js';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns true when create_spec should generate an Analytics section.
+ * Requires: user interaction feature AND a detected analytics provider.
+ */
+export function shouldGenerateAnalyticsSection(title, description, criteria, stack) {
+    if (!stack || stack.provider === 'unknown') {
+        return false;
+    }
+    return isUserInteractionFeature(title, description, criteria);
+}
+/**
+ * Builds a complete AnalyticsSpec for a feature.
+ * Called from create_spec when shouldGenerateAnalyticsSection returns true.
+ */
+export function buildAnalyticsSpec(specId, title, description, criteria, stack, hasGdprOrCcpa) {
+    const events = generateEvents(description, stack);
+    // Add consent flag if GDPR/CCPA is active
+    if (hasGdprOrCcpa) {
+        for (const event of events) {
+            event.consentRequired = true;
+        }
+    }
+    const funnels = isFunnelFeature(title, description, criteria)
+        ? [generateFunnelEvents(description, stack)]
+        : [];
+    const experiments = isABTestFeature(title, description, criteria)
+        ? [buildDefaultABTest(title)]
+        : [];
+    return {
+        provider: stack.provider,
+        integrationMethod: stack.integrationMethod,
+        namingConvention: stack.namingConvention,
+        events,
+        funnels,
+        experiments,
+        specId,
+    };
+}
+/**
+ * Generates a "no provider detected" note for specs where analytics is not configured.
+ */
+export function buildNoProviderNote() {
+    return ('\n> **Nota:** No se detecto proveedor de analytics configurado. ' +
+        'Para habilitar la especificacion automatica de eventos, considera integrar uno de los ' +
+        'proveedores soportados (PostHog, Mixpanel, Amplitude, Segment, GA4).\n');
+}
+/**
+ * Generates the HU.md Analytics section as a Markdown string.
+ */
+export function buildAnalyticsHuSection(analyticsSpec) {
+    const lines = ['', '## Analytics', ''];
+    lines.push(`**Provider:** ${analyticsSpec.provider}`);
+    lines.push(`**Integration:** ${analyticsSpec.integrationMethod}`);
+    lines.push(`**Naming convention:** ${analyticsSpec.namingConvention}`);
+    lines.push('');
+    if (analyticsSpec.events.length > 0) {
+        lines.push('### Events to Track');
+        lines.push('');
+        for (const event of analyticsSpec.events) {
+            lines.push(`#### \`${event.name}\``);
+            lines.push(`- **Trigger:** ${event.trigger}`);
+            lines.push(`- **Business goal:** ${event.businessGoal}`);
+            if (event.consentRequired) {
+                lines.push('- **Consent required:** Yes (GDPR/CCPA)');
+            }
+            if (event.includesPII) {
+                lines.push('- **PII detected:** Yes — anonymization required');
+            }
+            lines.push('- **Properties:**');
+            for (const prop of event.properties) {
+                const required = prop.required ? 'required' : 'optional';
+                lines.push(`  - \`${prop.name}\` (${prop.type}, ${required}): ${prop.description}`);
+            }
+            lines.push('');
+        }
+    }
+    if (analyticsSpec.funnels.length > 0) {
+        lines.push('### Funnels');
+        lines.push('');
+        for (const funnel of analyticsSpec.funnels) {
+            lines.push(`#### ${funnel.name}`);
+            lines.push(`- **Conversion goal:** ${funnel.conversionGoal}`);
+            lines.push(`- **Steps:** ${funnel.steps.length}`);
+            for (let i = 0; i < funnel.steps.length; i++) {
+                const step = funnel.steps[i];
+                if (step) {
+                    lines.push(`  - Step ${i + 1}: \`${step.name}\``);
+                }
+            }
+            lines.push('');
+        }
+    }
+    if (analyticsSpec.experiments.length > 0) {
+        lines.push('### A/B Experiments');
+        lines.push('');
+        for (const exp of analyticsSpec.experiments) {
+            lines.push(`#### ${exp.name}`);
+            lines.push(`- **Hypothesis:** ${exp.hypothesis}`);
+            lines.push(`- **Variants:** ${exp.variants.join(', ')}`);
+            lines.push(`- **Primary metric:** ${exp.primaryMetric}`);
+            lines.push(`- **Guard metrics:** ${exp.guardMetrics.join(', ')}`);
+            lines.push(`- **Guard threshold:** ${(exp.guardThreshold * 100).toFixed(0)}% relative degradation`);
+            lines.push(`- **Sample size / variant:** ${exp.estimatedSampleSize}`);
+            lines.push(`- **Estimated duration:** ${exp.estimatedDuration}`);
+            lines.push('');
+        }
+    }
+    lines.push('### Analytics Acceptance Criteria');
+    lines.push('');
+    for (const event of analyticsSpec.events) {
+        lines.push(`- [ ] Event \`${event.name}\` is implemented and fires with all required properties`);
+        if (event.consentRequired) {
+            lines.push(`- [ ] Event \`${event.name}\` only fires after analytics consent is granted`);
+        }
+    }
+    // PII anonymization criterion
+    const piiEvents = analyticsSpec.events.filter((e) => e.includesPII || hasPIIProperties(e.properties));
+    if (piiEvents.length > 0) {
+        lines.push('- [ ] All event properties with PII are anonymized: use hashed `user_id`, ' +
+            'truncated IP (first 3 octets), exclude name/email from event properties directly');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Builds a default A/B test for a feature.
+ */
+function buildDefaultABTest(title) {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .slice(0, 40);
+    return {
+        name: `${slug}-experiment`,
+        hypothesis: `If we change the ${title}, then conversion will improve because users will find it more intuitive`,
+        variants: ['control', 'variant_a'],
+        primaryMetric: 'conversion_rate',
+        guardMetrics: ['bounce_rate', 'error_rate'],
+        estimatedSampleSize: 1000,
+        estimatedDuration: '14 days',
+        guardThreshold: 0.05,
+        provider: undefined,
+    };
+}
+// ---------------------------------------------------------------------------
+// Re-export detection helpers for use in create-spec.ts
+// ---------------------------------------------------------------------------
+export { isUserInteractionFeature, hasPIIProperties } from '../../engine/analytics-detector.js';
+//# sourceMappingURL=analytics-spec-adapter.js.map

package/dist/tools/create-spec/analytics-spec-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-spec-adapter.js","sourceRoot":"","sources":["../../../src/tools/create-spec/analytics-spec-adapter.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,kFAAkF;AAGlF,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAE5C,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAAa,EACb,WAAmB,EACnB,QAAgB,EAChB,KAA4B;IAE5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,KAAa,EACb,WAAmB,EACnB,QAAgB,EAChB,KAAqB,EACrB,aAAsB;IAEtB,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAElD,0CAA0C;IAC1C,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC3D,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC/D,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,MAAM;QACN,OAAO;QACP,WAAW;QACX,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CACL,kEAAkE;QAClE,wFAAwF;QACxF,wEAAwE,CACzE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAA4B;IAClE,MAAM,KAAK,GAAa,CAAC,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IAEjD,KAAK,CAAC,IAAI,CAAC,iBAAiB,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,oBAAoB,aAAa,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,0BAA0B,aAAa,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;YACzD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACtF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC7B,IAAI,IAAI,EAAE,CAAC;oBACT,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,wBAAwB,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClE,KAAK,CAAC,IAAI,CACR,0BAA0B,CAAC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CACxF,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,gCAAgC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CACR,iBAAiB,KAAK,CAAC,IAAI,0DAA0D,CACtF,CAAC;QACF,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,IAAI,kDAAkD,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CACvD,CAAC;IACF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CACR,4EAA4E;YAC1E,kFAAkF,CACrF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO;QACL,IAAI,EAAE,GAAG,IAAI,aAAa;QAC1B,UAAU,EAAE,oBAAoB,KAAK,0EAA0E;QAC/G,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;QAClC,aAAa,EAAE,iBAAiB;QAChC,YAAY,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;QAC3C,mBAAmB,EAAE,IAAI;QACzB,iBAAiB,EAAE,SAAS;QAC5B,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAE9E,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/tools/create-spec/event-spec-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { ProjectKnowledge } from '../../types/index.js';
+/**
+ * Detect whether the project uses a known event broker.
+ * Returns true when at least one non-unknown broker is detected.
+ */
+export declare function isEventDrivenProject(knowledge: ProjectKnowledge): boolean;
+/**
+ * Build an event-driven section for the HU.md of a spec that produces or
+ * consumes events. Includes:
+ * - Idempotence criterion (mandatory when broker is at-least-once)
+ * - DLQ criteria (retry backoff, max retries, monitoring, re-injection)
+ */
+export declare function buildEventHuSection(specTitle: string, knowledge: ProjectKnowledge): string;
+//# sourceMappingURL=event-spec-adapter.d.ts.map

package/dist/tools/create-spec/event-spec-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-spec-adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/create-spec/event-spec-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,MAAM,CA6C1F"}

package/dist/tools/create-spec/event-spec-adapter.js

@@ -0,0 +1,47 @@
+// tools/create-spec/event-spec-adapter.ts — Event-driven spec enrichment (SPEC-031)
+// Adds DLQ and idempotence criteria to specs for event-driven features.
+import { detectBrokers, getBrokerConfig, requiresIdempotence, supportsDLQ, } from '../../engine/event-detector.js';
+/**
+ * Detect whether the project uses a known event broker.
+ * Returns true when at least one non-unknown broker is detected.
+ */
+export function isEventDrivenProject(knowledge) {
+    const brokers = detectBrokers(knowledge.stack);
+    return brokers.length > 0 && brokers[0] !== 'unknown';
+}
+/**
+ * Build an event-driven section for the HU.md of a spec that produces or
+ * consumes events. Includes:
+ * - Idempotence criterion (mandatory when broker is at-least-once)
+ * - DLQ criteria (retry backoff, max retries, monitoring, re-injection)
+ */
+export function buildEventHuSection(specTitle, knowledge) {
+    const brokers = detectBrokers(knowledge.stack);
+    const primaryBroker = brokers[0] ?? 'unknown';
+    if (primaryBroker === 'unknown') {
+        return '';
+    }
+    const brokerConfig = getBrokerConfig(primaryBroker);
+    const brokerName = brokerConfig?.displayName ?? primaryBroker;
+    const lines = [
+        '',
+        `## Event-Driven Contracts (${brokerName})`,
+        '',
+        `> Auto-generated by SpecForge for ${brokerName}-based features (SPEC-031).`,
+        '',
+        '### Contratos de Eventos',
+        '',
+        `- [ ] Un contrato formal de evento (JSON Schema) debe ser creado en \`data/projects/{hash}/event-contracts/\` antes de implementar. El contrato incluye: nombre del evento, version, schema del payload, producer, consumers conocidos, y garantia de entrega (${brokerConfig?.deliveryGuarantee ?? 'at-least-once'})`,
+    ];
+    // Idempotence criterion (when broker delivers at-least-once)
+    if (requiresIdempotence(primaryBroker)) {
+        lines.push('', '### Idempotencia', '', `- [ ] El consumer de \`${specTitle}\` DEBE ser idempotente: procesar el mismo evento dos veces debe producir el mismo resultado que procesarlo una vez. Describir el mecanismo de deduplicacion (event ID en DB, idempotency key, ventana de tiempo).`);
+    }
+    // DLQ criteria (when broker supports DLQ)
+    if (supportsDLQ(primaryBroker)) {
+        const dlqSupport = brokerConfig?.dlqSupport ?? 'DLQ';
+        lines.push('', '### Dead Letter Queue (DLQ)', '', `- [ ] Cuando el consumer falla al procesar un evento, implementar retry con backoff exponencial (initial: 1s, multiplier: 2, max: 5 reintentos). Tras 5 reintentos fallidos, el evento va a la DLQ (${dlqSupport}).`, `- [ ] La DLQ \`${brokerName.toLowerCase().replace(/\s+/g, '-')}-dlq\` tiene retension de 7 dias, alerta cuando acumula >100 eventos, y un responsable definido.`, `- [ ] Existe un proceso documentado de reinyeccion manual de eventos desde la DLQ, incluyendo validacion del payload antes de reintentar.`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=event-spec-adapter.js.map

package/dist/tools/create-spec/event-spec-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-spec-adapter.js","sourceRoot":"","sources":["../../../src/tools/create-spec/event-spec-adapter.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,wEAAwE;AAGxE,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA2B;IAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,SAA2B;IAChF,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAC9C,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,YAAY,EAAE,WAAW,IAAI,aAAa,CAAC;IAE9D,MAAM,KAAK,GAAa;QACtB,EAAE;QACF,8BAA8B,UAAU,GAAG;QAC3C,EAAE;QACF,qCAAqC,UAAU,6BAA6B;QAC5E,EAAE;QACF,0BAA0B;QAC1B,EAAE;QACF,kQAAkQ,YAAY,EAAE,iBAAiB,IAAI,eAAe,GAAG;KACxT,CAAC;IAEF,6DAA6D;IAC7D,IAAI,mBAAmB,CAAC,aAAa,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CACR,EAAE,EACF,kBAAkB,EAClB,EAAE,EACF,0BAA0B,SAAS,oNAAoN,CACxP,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,IAAI,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,YAAY,EAAE,UAAU,IAAI,KAAK,CAAC;QACrD,KAAK,CAAC,IAAI,CACR,EAAE,EACF,6BAA6B,EAC7B,EAAE,EACF,uMAAuM,UAAU,IAAI,EACrN,kBAAkB,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,kGAAkG,EACjK,2IAA2I,CAC5I,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/create-spec/mcp-spec-adapter.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectKnowledge, MCPServerSpec, AgentObservabilitySpec, MCPBreakingChange } from '../../types/index.js';
+export declare function isMcpSpec(knowledge: ProjectKnowledge | null): boolean;
+export declare function generateMcpServerSpec(_title: string, description: string, _knowledge: ProjectKnowledge | null): MCPServerSpec;
+export declare function buildMcpHuSection(title: string, description: string, knowledge: ProjectKnowledge | null): string;
+export declare function generateObservabilitySpec(description: string): AgentObservabilitySpec;
+export declare function detectMcpBreakingChange(toolName: string, oldSchema: Record<string, unknown>, newSchema: Record<string, unknown>): MCPBreakingChange | null;
+//# sourceMappingURL=mcp-spec-adapter.d.ts.map

package/dist/tools/create-spec/mcp-spec-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-spec-adapter.d.ts","sourceRoot":"","sources":["../../../src/tools/create-spec/mcp-spec-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAIb,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAK9B,wBAAgB,SAAS,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAKrE;AAmGD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,gBAAgB,GAAG,IAAI,GAClC,aAAa,CAkBf;AAID,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,gBAAgB,GAAG,IAAI,GACjC,MAAM,CAsDR;AAID,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAkCrF;AAID,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,iBAAiB,GAAG,IAAI,CAmD1B"}