cc-agentic-framework 1.14.1

package/dist/lib/agent-generator.js

@@ -0,0 +1,274 @@
+/**
+ * Agent Generator Module
+ *
+ * Generates Claude Code custom agent JSON definitions from slim agent markdown files.
+ * These JSON files enable slim agents to be invoked as true subagents via the Task tool
+ * with their own subagent_type.
+ *
+ * Usage:
+ *     const generator = new AgentGenerator(projectRoot);
+ *     const results = await generator.generateAll();
+ *
+ * The generated JSON files are written to module source directories (framework/modules/{module}/agents/)
+ * alongside the markdown files. They are then deployed to .claude/agents/ by the sync command.
+ */
+import fs from "fs-extra";
+import path from "path";
+import yaml from "js-yaml";
+/**
+ * Generates Claude Code custom agent JSON definitions from slim agent markdown files.
+ *
+ * The generator:
+ * 1. Reads agents.json to find all slim agents
+ * 2. Parses each slim agent's markdown file
+ * 3. Extracts description, instructions, and metadata
+ * 4. Generates JSON matching custom-agent.schema.json
+ * 5. Writes JSON files alongside markdown sources
+ */
+export class AgentGenerator {
+    /** Default tools for slim agents */
+    static DEFAULT_TOOLS = [
+        "Read",
+        "Write",
+        "Edit",
+        "Glob",
+        "Grep",
+        "Bash",
+        "Task",
+        "TodoWrite",
+        "Skill",
+    ];
+    projectRoot;
+    /**
+     * Initialize the AgentGenerator.
+     *
+     * @param projectRoot - Absolute path to the project root directory
+     */
+    constructor(projectRoot) {
+        this.projectRoot = path.resolve(projectRoot);
+    }
+    /**
+     * Generate custom agent JSON files for all slim agents.
+     *
+     * @param options - Generation options
+     * @returns List of generation results
+     */
+    async generateAll(options = {}) {
+        const results = [];
+        // Load agents registry
+        const registryPath = path.join(this.projectRoot, ".claude/registries/agents.json");
+        if (!(await fs.pathExists(registryPath))) {
+            throw new Error(`Agents registry not found: ${registryPath}`);
+        }
+        const registry = await fs.readJson(registryPath);
+        const agents = registry.agents || [];
+        // Apply agent filter if specified
+        const targetAgents = options.agentId
+            ? agents.filter((a) => a.id === options.agentId)
+            : agents;
+        if (options.agentId && targetAgents.length === 0) {
+            throw new Error(`Agent not found: ${options.agentId}`);
+        }
+        for (const agent of targetAgents) {
+            const result = await this.generateAgent(agent, options);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Generate custom agent JSON for a single slim agent.
+     *
+     * @param agent - Agent definition from registry
+     * @param options - Generation options
+     * @returns Generation result
+     */
+    async generateAgent(agent, options) {
+        // Resolve paths
+        // agents.json stores paths like ".claude/commands/ai-xxx.md" but actual source is in framework/modules/*/agents/
+        const sourcePath = await this.resolveAgentSourcePath(agent);
+        const outputPath = sourcePath.replace(".md", ".json");
+        const result = {
+            agentId: agent.id,
+            sourcePath,
+            outputPath,
+            action: "skipped",
+        };
+        try {
+            // Check if output exists
+            const outputExists = await fs.pathExists(outputPath);
+            if (outputExists && !options.force) {
+                result.action = "skipped";
+                return result;
+            }
+            // Read and parse source markdown
+            const content = await fs.readFile(sourcePath, "utf-8");
+            const { frontmatter, body } = this.parseMarkdown(content);
+            // Skip JSON generation for command-only agents
+            const deployTo = frontmatter["deploy-to"] || agent["deploy-to"] || "both";
+            if (deployTo === "command") {
+                result.action = "skipped";
+                return result;
+            }
+            // Generate custom agent definition
+            const customAgent = this.buildCustomAgent(agent, frontmatter, body);
+            // Write output
+            if (!options.dryRun) {
+                await fs.writeJson(outputPath, customAgent, { spaces: 2 });
+            }
+            result.action = outputExists ? "updated" : "created";
+        }
+        catch (error) {
+            result.action = "failed";
+            result.error = error instanceof Error ? error.message : String(error);
+        }
+        return result;
+    }
+    /**
+     * Resolve the actual source path for an agent.
+     *
+     * The registry stores paths relative to project root, but we need the actual
+     * source file in framework/modules/{module}/agents/.
+     */
+    async resolveAgentSourcePath(agent) {
+        // Try framework module path first
+        const modulePath = path.join(this.projectRoot, "framework/modules", agent.module, "agents", `${agent.id}.md`);
+        if (await fs.pathExists(modulePath)) {
+            return modulePath;
+        }
+        // Fallback to registry file path
+        const registryPath = path.join(this.projectRoot, agent.file);
+        if (await fs.pathExists(registryPath)) {
+            return registryPath;
+        }
+        throw new Error(`Agent source file not found for ${agent.id}`);
+    }
+    /**
+     * Parse markdown file with YAML frontmatter.
+     */
+    parseMarkdown(content) {
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!frontmatterMatch) {
+            throw new Error("Invalid markdown: missing frontmatter");
+        }
+        const frontmatter = yaml.load(frontmatterMatch[1]);
+        const body = frontmatterMatch[2];
+        return { frontmatter, body };
+    }
+    /**
+     * Build custom agent JSON definition from parsed markdown.
+     */
+    buildCustomAgent(agent, frontmatter, body) {
+        // Extract description from Purpose line in body
+        const description = this.extractDescription(body, frontmatter.role);
+        // Generate condensed instructions
+        const instructions = this.generateInstructions(agent, frontmatter, body);
+        // Determine model (slim agents default to sonnet)
+        const model = "sonnet";
+        // Build skills list from essential skills
+        const skills = agent["essential-skills"] || frontmatter["essential-skills"] || [];
+        // Build context from registry or frontmatter
+        const context = agent["context-category-needs"] || frontmatter["context-category-needs"];
+        return {
+            $schema: "../../../framework/modules/core/registries/schemas/custom-agent.schema.json",
+            name: agent.id,
+            description,
+            model,
+            instructions,
+            tools: [...AgentGenerator.DEFAULT_TOOLS],
+            skills,
+            context,
+            sourceAgent: agent.id,
+            generated: new Date().toISOString(),
+        };
+    }
+    /**
+     * Extract description from markdown body.
+     */
+    extractDescription(body, role) {
+        // Try to find Purpose line
+        const purposeMatch = body.match(/\*\*Purpose:\*\*\s*(.+)/);
+        if (purposeMatch) {
+            return purposeMatch[1].trim();
+        }
+        // Try to find first paragraph after heading
+        const paragraphMatch = body.match(/^#[^\n]+\n+([^#\n][^\n]+)/);
+        if (paragraphMatch) {
+            return paragraphMatch[1].trim().substring(0, 200);
+        }
+        // Fallback to role
+        return role || "Slim agent for focused task execution";
+    }
+    /**
+     * Generate condensed instructions for the custom agent.
+     */
+    generateInstructions(agent, frontmatter, body) {
+        const agentName = agent.id;
+        const parentAgent = agent["parent-agent"] || frontmatter["parent-agent"] || "orchestrator";
+        const skills = agent["essential-skills"] || frontmatter["essential-skills"] || [];
+        // Extract key sections from body
+        const scope = this.extractSection(body, "Scope");
+        const execution = this.extractSection(body, "Task Execution") ||
+            this.extractSection(body, "Execution Steps");
+        const validation = this.extractSection(body, "Validation Checklist");
+        const antiPatterns = this.extractSection(body, "Anti-Patterns");
+        // Build condensed instructions
+        let instructions = `You are ${agentName}, a slim agent variant designed for focused task execution.
+
+## Role
+${scope || "Execute a single focused task as delegated by the parent orchestrator."}
+
+## Parent Agent
+This agent is invoked by ${parentAgent}. Control returns to parent after completion.
+
+## Pre-loaded Skills
+${skills.map((s) => `- ${s}`).join("\n")}
+
+`;
+        if (execution) {
+            instructions += `## Execution
+${this.condenseSection(execution)}
+
+`;
+        }
+        if (validation) {
+            instructions += `## Validation
+${this.condenseSection(validation)}
+
+`;
+        }
+        if (antiPatterns) {
+            instructions += `## Critical Rules
+${this.condenseSection(antiPatterns)}
+
+`;
+        }
+        instructions += `## Output
+Return a structured summary to the orchestrator including:
+- What was accomplished
+- Files modified
+- Test results (if applicable)
+- Issues or blockers encountered
+- Suggested next steps`;
+        return instructions;
+    }
+    /**
+     * Extract a section from markdown body by heading.
+     */
+    extractSection(body, heading) {
+        const pattern = new RegExp(`(?:^|\\n)#+\\s*${heading}[^\\n]*\\n([\\s\\S]*?)(?=\\n#|$)`, "i");
+        const match = body.match(pattern);
+        return match ? match[1].trim() : null;
+    }
+    /**
+     * Condense a section by removing excessive whitespace and limiting length.
+     */
+    condenseSection(section) {
+        return section
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0)
+            .join("\n")
+            .substring(0, 1500); // Limit length
+    }
+}
+//# sourceMappingURL=agent-generator.js.map

package/dist/lib/agent-generator.js.map

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

package/dist/lib/backlog/__mocks__/prompt-utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Mock for prompt-utils
+ */
+export declare const prompt: jest.Mock<any, any, any>;
+//# sourceMappingURL=prompt-utils.d.ts.map

package/dist/lib/backlog/__mocks__/prompt-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.d.ts","sourceRoot":"","sources":["../../../../src/lib/backlog/__mocks__/prompt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,MAAM,0BAAY,CAAC"}

package/dist/lib/backlog/__mocks__/prompt-utils.js

@@ -0,0 +1,5 @@
+/**
+ * Mock for prompt-utils
+ */
+export const prompt = jest.fn();
+//# sourceMappingURL=prompt-utils.js.map

package/dist/lib/backlog/__mocks__/prompt-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-utils.js","sourceRoot":"","sources":["../../../../src/lib/backlog/__mocks__/prompt-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC"}

package/dist/lib/backlog/content-parser.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Content Parser Module
+ *
+ * Parses Jira descriptions to extract structured content:
+ * - AS/WANT/SO THAT user story format
+ * - Context paragraphs
+ * - Requirements (bullet points)
+ * - Technical notes
+ *
+ * Handles both Jira wiki markup and markdown formats.
+ *
+ * @module content-parser
+ */
+/**
+ * AS/WANT/SO THAT structure
+ */
+export interface AsWantSoThat {
+    asA: string;
+    iWant: string;
+    soThat: string | null;
+}
+/**
+ * Parsed description sections
+ */
+export interface DescriptionSections {
+    asWantSoThat: AsWantSoThat | null;
+    context: string;
+    requirements: string[];
+    technicalNotes: string[];
+}
+/**
+ * Extract AS/WANT/SO THAT from description.
+ *
+ * Handles multiple formats:
+ * - Bold markdown: **AS** a user, **I WANT** X, **SO THAT** Y
+ * - Plain text: AS a user, I WANT X, SO THAT Y
+ * - Jira wiki: *AS* a user, *I WANT* X, *SO THAT* Y
+ *
+ * @param description - Raw description text
+ * @returns Extracted AS/WANT/SO THAT or null if not found
+ */
+export declare function extractAsWantSoThat(description: string): AsWantSoThat | null;
+/**
+ * Extract context paragraphs from description.
+ *
+ * Context is prose text that is NOT:
+ * - AS/WANT/SO THAT section
+ * - Bullet points
+ * - Headers
+ * - Technical notes section
+ *
+ * @param description - Raw description text
+ * @returns Context paragraphs joined with newlines
+ */
+export declare function extractContext(description: string): string;
+/**
+ * Extract requirements from description.
+ *
+ * Requirements are bullet points (- or *) that are NOT in the technical notes section.
+ *
+ * @param description - Raw description text
+ * @returns Array of requirement strings
+ */
+export declare function extractRequirements(description: string): string[];
+/**
+ * Extract technical notes from description.
+ *
+ * Looks for a "Technical Notes" section and extracts its bullet points.
+ *
+ * @param description - Raw description text
+ * @returns Array of technical note strings
+ */
+export declare function extractTechnicalNotes(description: string): string[];
+/**
+ * Parse description into structured sections.
+ *
+ * Combines all extraction functions into a single call.
+ *
+ * @param description - Raw description text
+ * @returns Structured description sections
+ */
+export declare function parseDescriptionSections(description: string): DescriptionSections;
+//# sourceMappingURL=content-parser.d.ts.map

package/dist/lib/backlog/content-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parser.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/content-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgC5E;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6E1D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA8CjE;AAsCD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAuCnE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAOjF"}

package/dist/lib/backlog/content-parser.js

@@ -0,0 +1,284 @@
+/**
+ * Content Parser Module
+ *
+ * Parses Jira descriptions to extract structured content:
+ * - AS/WANT/SO THAT user story format
+ * - Context paragraphs
+ * - Requirements (bullet points)
+ * - Technical notes
+ *
+ * Handles both Jira wiki markup and markdown formats.
+ *
+ * @module content-parser
+ */
+import { convertJiraToMarkdown } from './csv-extractor.js';
+/**
+ * Extract AS/WANT/SO THAT from description.
+ *
+ * Handles multiple formats:
+ * - Bold markdown: **AS** a user, **I WANT** X, **SO THAT** Y
+ * - Plain text: AS a user, I WANT X, SO THAT Y
+ * - Jira wiki: *AS* a user, *I WANT* X, *SO THAT* Y
+ *
+ * @param description - Raw description text
+ * @returns Extracted AS/WANT/SO THAT or null if not found
+ */
+export function extractAsWantSoThat(description) {
+    if (!description) {
+        return null;
+    }
+    // Normalize to single string (join lines)
+    const text = description.replace(/\r\n/g, '\n');
+    // Pattern variations for AS
+    // Handles: **AS**, *AS*, AS (at start of line or sentence)
+    const asPattern = /(?:\*{1,2})?AS\*{0,2}\s+(.+?)(?=[,.]?\s*(?:\*{1,2})?I\s*WANT|$)/is;
+    // Pattern for I WANT
+    const wantPattern = /(?:\*{1,2})?I\s*WANT\*{0,2}\s+(.+?)(?=[,.]?\s*(?:\*{1,2})?SO\s*THAT|[,.]?\s*$)/is;
+    // Pattern for SO THAT
+    const soThatPattern = /(?:\*{1,2})?SO\s*THAT\*{0,2}\s+(.+?)(?=[,.]?\s*$|\n\n)/is;
+    const asMatch = text.match(asPattern);
+    const wantMatch = text.match(wantPattern);
+    if (!asMatch || !wantMatch) {
+        return null;
+    }
+    const soThatMatch = text.match(soThatPattern);
+    return {
+        asA: cleanExtractedText(asMatch[1]),
+        iWant: cleanExtractedText(wantMatch[1]),
+        soThat: soThatMatch ? cleanExtractedText(soThatMatch[1]) : null,
+    };
+}
+/**
+ * Clean extracted text by removing trailing punctuation and extra whitespace.
+ */
+function cleanExtractedText(text) {
+    return text
+        .replace(/[,.]$/, '') // Remove trailing comma or period
+        .replace(/\s+/g, ' ') // Collapse whitespace
+        .trim();
+}
+/**
+ * Check if a line is part of AS/WANT/SO THAT pattern.
+ * Handles various formats including bold markdown and Jira wiki.
+ */
+function isAsWantSoThatLine(line) {
+    // Match patterns like: **AS**, *AS*, AS (with various bold markers)
+    // Also handles converted markdown where *text* becomes **text**
+    return /^\*{0,4}AS\*{0,4}\s+/i.test(line) ||
+        /^\*{0,4}I\s*WANT\*{0,4}/i.test(line) ||
+        /^\*{0,4}SO\s*THAT\*{0,4}/i.test(line);
+}
+/**
+ * Extract context paragraphs from description.
+ *
+ * Context is prose text that is NOT:
+ * - AS/WANT/SO THAT section
+ * - Bullet points
+ * - Headers
+ * - Technical notes section
+ *
+ * @param description - Raw description text
+ * @returns Context paragraphs joined with newlines
+ */
+export function extractContext(description) {
+    if (!description) {
+        return '';
+    }
+    // Convert to markdown first
+    const text = convertJiraToMarkdown(description);
+    const lines = text.split('\n');
+    const contextLines = [];
+    let skipUntilBlankLine = false;
+    let inTechnicalNotes = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Handle blank lines
+        if (!trimmed) {
+            skipUntilBlankLine = false;
+            if (contextLines.length > 0 && contextLines[contextLines.length - 1] !== '') {
+                contextLines.push('');
+            }
+            continue;
+        }
+        // Detect and skip AS/WANT/SO THAT section (may span multiple lines)
+        if (isAsWantSoThatLine(trimmed)) {
+            skipUntilBlankLine = true;
+            continue;
+        }
+        // Skip continuation lines of AS/WANT/SO THAT
+        if (skipUntilBlankLine) {
+            continue;
+        }
+        // Detect technical notes section
+        if (isTechnicalNotesHeader(trimmed)) {
+            inTechnicalNotes = true;
+            continue;
+        }
+        // Skip if in technical notes
+        if (inTechnicalNotes) {
+            continue;
+        }
+        // Skip bullets
+        if (/^[-*]\s+/.test(trimmed)) {
+            continue;
+        }
+        // Skip numbered lists
+        if (/^\d+\.\s+/.test(trimmed)) {
+            continue;
+        }
+        // Skip headers
+        if (/^#{1,6}\s+/.test(trimmed) || /^h[1-6]\.\s+/i.test(trimmed)) {
+            continue;
+        }
+        // Skip bold section headers (e.g., **Context:**, **Technical Notes:**)
+        if (/^\*{1,2}[^*]+:\*{0,2}$/.test(trimmed)) {
+            continue;
+        }
+        // This is context content
+        contextLines.push(trimmed);
+    }
+    // Clean up: remove trailing empty lines
+    while (contextLines.length > 0 && contextLines[contextLines.length - 1] === '') {
+        contextLines.pop();
+    }
+    return contextLines.join('\n');
+}
+/**
+ * Extract requirements from description.
+ *
+ * Requirements are bullet points (- or *) that are NOT in the technical notes section.
+ *
+ * @param description - Raw description text
+ * @returns Array of requirement strings
+ */
+export function extractRequirements(description) {
+    if (!description) {
+        return [];
+    }
+    // Convert to markdown first
+    const text = convertJiraToMarkdown(description);
+    const lines = text.split('\n');
+    const requirements = [];
+    let inTechnicalNotes = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect technical notes section start
+        if (/^(?:\*{1,2})?Technical\s*Notes:?\*{0,2}$/i.test(trimmed) ||
+            /^#{1,3}\s*Technical\s*Notes/i.test(trimmed) ||
+            /^h[1-4]\.\s*Technical\s*Notes/i.test(trimmed)) {
+            inTechnicalNotes = true;
+            continue;
+        }
+        // Detect next section header (exit technical notes)
+        if (inTechnicalNotes &&
+            (/^(?:\*{1,2})?[A-Z][^*]+:\*{0,2}$/i.test(trimmed) ||
+                /^#{1,3}\s+/.test(trimmed))) {
+            inTechnicalNotes = false;
+        }
+        // Skip if in technical notes
+        if (inTechnicalNotes) {
+            continue;
+        }
+        // Extract bullet points
+        const bulletMatch = trimmed.match(/^[-*]\s+(.+)$/);
+        if (bulletMatch) {
+            const content = bulletMatch[1].trim();
+            if (content) {
+                requirements.push(content);
+            }
+        }
+    }
+    return requirements;
+}
+/**
+ * Check if a line is a Technical Notes header.
+ * Handles various formats including bold markdown and Jira wiki.
+ * Note: After convertJiraToMarkdown, bold markers may double up (e.g., *** or ****)
+ */
+function isTechnicalNotesHeader(line) {
+    // Match: **Technical Notes:**, *Technical Notes*, Technical Notes:
+    // After conversion may have extra asterisks like ***Technical Notes:****
+    // Also h2. Technical Notes, ## Technical Notes
+    return /^\*{0,}Technical\s*Notes:?\*{0,}$/i.test(line) ||
+        /^#{1,3}\s*Technical\s*Notes/i.test(line) ||
+        /^h[1-4]\.\s*Technical\s*Notes/i.test(line);
+}
+/**
+ * Check if a line is a section header (used to detect end of a section).
+ * Note: After convertJiraToMarkdown, bold markers may double up (e.g., *** or ****)
+ */
+function isSectionHeader(line) {
+    // Bold header like **Section:** or **Next Section:**
+    // After conversion may have extra asterisks like ****Next Section:***
+    // Match: asterisks, then text with colon, then asterisks
+    if (/^\*+[^*]+:\*+$/i.test(line)) {
+        return true;
+    }
+    // Markdown header
+    if (/^#{1,3}\s+[^#]/.test(line)) {
+        return true;
+    }
+    // Jira wiki header
+    if (/^h[1-4]\.\s+/i.test(line)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract technical notes from description.
+ *
+ * Looks for a "Technical Notes" section and extracts its bullet points.
+ *
+ * @param description - Raw description text
+ * @returns Array of technical note strings
+ */
+export function extractTechnicalNotes(description) {
+    if (!description) {
+        return [];
+    }
+    // Convert to markdown first
+    const text = convertJiraToMarkdown(description);
+    const lines = text.split('\n');
+    const notes = [];
+    let inTechnicalNotes = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Detect technical notes section start
+        if (isTechnicalNotesHeader(trimmed)) {
+            inTechnicalNotes = true;
+            continue;
+        }
+        // Detect next section header (exit technical notes)
+        if (inTechnicalNotes && trimmed && isSectionHeader(trimmed)) {
+            break;
+        }
+        // Extract bullet points if in technical notes
+        if (inTechnicalNotes) {
+            const bulletMatch = trimmed.match(/^[-*]\s+(.+)$/);
+            if (bulletMatch) {
+                const content = bulletMatch[1].trim();
+                if (content) {
+                    notes.push(content);
+                }
+            }
+        }
+    }
+    return notes;
+}
+/**
+ * Parse description into structured sections.
+ *
+ * Combines all extraction functions into a single call.
+ *
+ * @param description - Raw description text
+ * @returns Structured description sections
+ */
+export function parseDescriptionSections(description) {
+    return {
+        asWantSoThat: extractAsWantSoThat(description),
+        context: extractContext(description),
+        requirements: extractRequirements(description),
+        technicalNotes: extractTechnicalNotes(description),
+    };
+}
+//# sourceMappingURL=content-parser.js.map