@diegonogueiradev_/mcp-graph 1.0.0

package/dist/core/importer/prd-to-graph.js

@@ -0,0 +1,188 @@
+/**
+ * Converts parser extraction results into graph nodes and edges.
+ */
+import { generateId } from "../utils/id.js";
+import { now } from "../utils/time.js";
+function mapBlockTypeToNodeType(blockType) {
+    const valid = [
+        "epic", "task", "subtask", "requirement", "constraint",
+        "milestone", "acceptance_criteria", "risk", "decision",
+    ];
+    if (valid.includes(blockType))
+        return blockType;
+    return null;
+}
+function defaultPriorityForType(type) {
+    switch (type) {
+        case "epic": return 2;
+        case "requirement": return 2;
+        case "constraint": return 1;
+        case "task": return 3;
+        case "subtask": return 3;
+        case "risk": return 2;
+        case "acceptance_criteria": return 4;
+        default: return 3;
+    }
+}
+function createNodeFromBlock(block, sourceFile, parentId = null) {
+    const nodeType = mapBlockTypeToNodeType(block.type);
+    if (!nodeType)
+        return null;
+    const timestamp = now();
+    return {
+        id: generateId("node"),
+        type: nodeType,
+        title: block.title,
+        description: block.description || undefined,
+        status: "backlog",
+        priority: defaultPriorityForType(nodeType),
+        parentId,
+        sourceRef: {
+            file: sourceFile,
+            startLine: block.startLine,
+            endLine: block.endLine,
+            confidence: block.confidence,
+        },
+        metadata: {
+            inferred: block.confidence < 0.7,
+            origin: "imported",
+        },
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+function createEdge(from, to, relationType, reason, inferred = false, confidence = 1) {
+    return {
+        id: generateId("edge"),
+        from,
+        to,
+        relationType,
+        reason,
+        metadata: { inferred, confidence },
+        createdAt: now(),
+    };
+}
+/**
+ * Detect simple sequential dependencies between tasks.
+ * If tasks appear in a numbered list, each depends on the previous.
+ */
+function inferSequentialDeps(taskNodes) {
+    const edges = [];
+    for (let i = 1; i < taskNodes.length; i++) {
+        edges.push(createEdge(taskNodes[i].id, taskNodes[i - 1].id, "depends_on", `Sequential order: "${taskNodes[i].title}" after "${taskNodes[i - 1].title}"`, true, 0.6));
+    }
+    return edges;
+}
+/**
+ * Detect keyword-based dependencies in descriptions.
+ */
+function inferKeywordDeps(nodes) {
+    const edges = [];
+    const depKeywords = [
+        /antes de/i, /após/i, /depois de/i, /depende de/i,
+        /somente depois/i, /before/i, /after/i, /depends on/i,
+    ];
+    for (const node of nodes) {
+        if (!node.description)
+            continue;
+        for (const other of nodes) {
+            if (node.id === other.id)
+                continue;
+            // Check if node's description references other's title
+            const titleLower = other.title.toLowerCase();
+            const descLower = node.description.toLowerCase();
+            if (descLower.includes(titleLower) && depKeywords.some((p) => p.test(descLower))) {
+                edges.push(createEdge(node.id, other.id, "depends_on", `Keyword inference from description`, true, 0.5));
+            }
+        }
+    }
+    return edges;
+}
+export function convertToGraph(extraction, sourceFile) {
+    const nodes = [];
+    const edges = [];
+    let blockedTasks = 0;
+    // Pass 1: Create nodes from top-level blocks
+    for (const block of extraction.blocks) {
+        const node = createNodeFromBlock(block, sourceFile);
+        if (!node)
+            continue;
+        nodes.push(node);
+        // Pass 2: Create child nodes from block items
+        const childTaskNodes = [];
+        for (const item of block.items) {
+            const itemType = mapBlockTypeToNodeType(item.type);
+            if (!itemType)
+                continue;
+            const timestamp = now();
+            const childNode = {
+                id: generateId("node"),
+                type: itemType,
+                title: item.text,
+                status: "backlog",
+                priority: defaultPriorityForType(itemType),
+                parentId: node.id,
+                sourceRef: {
+                    file: sourceFile,
+                    startLine: item.line,
+                    endLine: item.line,
+                    confidence: item.confidence,
+                },
+                metadata: {
+                    inferred: item.confidence < 0.7,
+                    origin: "imported",
+                },
+                createdAt: timestamp,
+                updatedAt: timestamp,
+            };
+            nodes.push(childNode);
+            // Parent-child edge
+            edges.push(createEdge(node.id, childNode.id, "parent_of", undefined, false, 1));
+            if (itemType === "task" || itemType === "subtask") {
+                childTaskNodes.push(childNode);
+            }
+        }
+        // Infer sequential dependencies among sibling tasks
+        if (childTaskNodes.length > 1) {
+            edges.push(...inferSequentialDeps(childTaskNodes));
+        }
+    }
+    // Pass 3: Link constraints to tasks as blockers
+    const constraintNodes = nodes.filter((n) => n.type === "constraint");
+    const taskNodes = nodes.filter((n) => n.type === "task" || n.type === "subtask");
+    for (const constraint of constraintNodes) {
+        for (const task of taskNodes) {
+            // Only create block edges if constraint text seems related
+            // For now, constraints block all tasks (simple heuristic for MVP)
+            edges.push(createEdge(constraint.id, task.id, "related_to", "Constraint applies to task", true, 0.4));
+        }
+    }
+    // Pass 4: Link acceptance criteria to epic/parent
+    const acNodes = nodes.filter((n) => n.type === "acceptance_criteria");
+    const epicNodes = nodes.filter((n) => n.type === "epic");
+    for (const ac of acNodes) {
+        if (ac.parentId)
+            continue; // already linked
+        for (const epic of epicNodes) {
+            edges.push(createEdge(ac.id, epic.id, "implements", "Acceptance criteria for epic", true, 0.6));
+        }
+    }
+    // Pass 5: Keyword-based dependency inference across all task nodes
+    const allTaskNodes = nodes.filter((n) => n.type === "task");
+    edges.push(...inferKeywordDeps(allTaskNodes));
+    // Count blocked tasks (tasks that have incoming depends_on edges to non-done nodes)
+    const dependentNodeIds = new Set(edges.filter((e) => e.relationType === "depends_on").map((e) => e.from));
+    blockedTasks = dependentNodeIds.size;
+    const inferredDeps = edges.filter((e) => e.metadata?.inferred).length;
+    return {
+        nodes,
+        edges,
+        stats: {
+            nodesCreated: nodes.length,
+            edgesCreated: edges.length,
+            blockedTasks,
+            inferredDeps,
+        },
+    };
+}
+//# sourceMappingURL=prd-to-graph.js.map

package/dist/core/importer/prd-to-graph.js.map

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

package/dist/core/parser/classify.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Stage 3: Heuristic classification.
+ * Classify sections and bullet items into semantic types.
+ */
+import type { NodeType } from "../graph/graph-types.js";
+export type BlockType = NodeType | "unknown";
+export interface ClassifiedBlock {
+    type: BlockType;
+    title: string;
+    description: string;
+    items: ClassifiedItem[];
+    startLine: number;
+    endLine: number;
+    confidence: number;
+}
+export interface ClassifiedItem {
+    type: BlockType;
+    text: string;
+    line: number;
+    confidence: number;
+}
+export declare function classifyText(text: string): {
+    type: BlockType;
+    confidence: number;
+};
+export declare function classifySectionTitle(title: string, level: number): {
+    type: BlockType;
+    confidence: number;
+};
+export declare function classifySection(title: string, body: string, level: number, startLine: number, endLine: number): ClassifiedBlock;
+//# sourceMappingURL=classify.d.ts.map

package/dist/core/parser/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/core/parser/classify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAwCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAQlF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAY1G;AAgDD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,eAAe,CA4BjB"}

package/dist/core/parser/classify.js

@@ -0,0 +1,128 @@
+/**
+ * Stage 3: Heuristic classification.
+ * Classify sections and bullet items into semantic types.
+ */
+// --- Heuristic keyword patterns (Portuguese + English) ---
+const REQUIREMENT_PATTERNS = [
+    /\bdeve\b/i, /\bprecisa\b/i, /\bnecessário\b/i, /\bmust\b/i,
+    /\bshould\b/i, /\brequired\b/i, /\brequisito/i, /\brequirement/i,
+];
+const CONSTRAINT_PATTERNS = [
+    /\bnão deve\b/i, /\bsem\b/i, /\brestrição/i, /\bnão depender/i,
+    /\bnão exigir/i, /\bconstraint/i, /\bwithout\b/i, /\bnot allowed/i,
+    /\bfora do escopo/i,
+];
+const TASK_PATTERNS = [
+    /\bimplementar\b/i, /\bcriar\b/i, /\badicionar\b/i, /\bdefinir\b/i,
+    /\bconstruir\b/i, /\bconfigurar\b/i, /\binstalar\b/i, /\bdesenvolver\b/i,
+    /\bimplement\b/i, /\bcreate\b/i, /\bbuild\b/i, /\bset up\b/i,
+    /\bdesign\b/i,
+];
+const ACCEPTANCE_PATTERNS = [
+    /\baceite\b/i, /\bcritério/i, /\bdone\b/i, /\bacceptance/i,
+    /\bcriterion/i, /\bcriteria/i, /\bdefinition of done/i,
+];
+const RISK_PATTERNS = [
+    /\brisco\b/i, /\brisk\b/i, /\bmitigação/i, /\bmitigation/i,
+];
+const EPIC_TITLE_PATTERNS = [
+    /\bepic\b/i, /\bvisão\b/i, /\bvision\b/i, /\bobjetivo principal/i,
+    /\bproduto\b/i, /\bprojeto\b/i,
+];
+function matchesAny(text, patterns) {
+    return patterns.some((p) => p.test(text));
+}
+export function classifyText(text) {
+    // Order matters: more specific checks first
+    if (matchesAny(text, CONSTRAINT_PATTERNS))
+        return { type: "constraint", confidence: 0.8 };
+    if (matchesAny(text, ACCEPTANCE_PATTERNS))
+        return { type: "acceptance_criteria", confidence: 0.8 };
+    if (matchesAny(text, RISK_PATTERNS))
+        return { type: "risk", confidence: 0.7 };
+    if (matchesAny(text, TASK_PATTERNS))
+        return { type: "task", confidence: 0.7 };
+    if (matchesAny(text, REQUIREMENT_PATTERNS))
+        return { type: "requirement", confidence: 0.7 };
+    return { type: "unknown", confidence: 0.3 };
+}
+export function classifySectionTitle(title, level) {
+    const lower = title.toLowerCase();
+    if (matchesAny(lower, ACCEPTANCE_PATTERNS))
+        return { type: "acceptance_criteria", confidence: 0.9 };
+    if (matchesAny(lower, RISK_PATTERNS))
+        return { type: "risk", confidence: 0.85 };
+    if (matchesAny(lower, CONSTRAINT_PATTERNS))
+        return { type: "constraint", confidence: 0.85 };
+    if (/\brequisito/i.test(lower) || /\brequirement/i.test(lower))
+        return { type: "requirement", confidence: 0.9 };
+    if (level === 1 || matchesAny(lower, EPIC_TITLE_PATTERNS))
+        return { type: "epic", confidence: 0.8 };
+    if (/\btask\b/i.test(lower) || /\bentrega/i.test(lower))
+        return { type: "task", confidence: 0.85 };
+    return { type: "unknown", confidence: 0.3 };
+}
+function parseBulletItems(body, startLine) {
+    const items = [];
+    const lines = body.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const bulletMatch = line.match(/^\s*[-]\s+(.+)$/);
+        if (!bulletMatch)
+            continue;
+        const text = bulletMatch[1].trim();
+        const { type, confidence } = classifyText(text);
+        items.push({
+            type,
+            text,
+            line: startLine + i,
+            confidence,
+        });
+    }
+    return items;
+}
+function parseNumberedItems(body, startLine) {
+    const items = [];
+    const lines = body.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const numMatch = line.match(/^\s*\d+[.)]\s+(.+)$/);
+        if (!numMatch)
+            continue;
+        const text = numMatch[1].trim();
+        const { type, confidence } = classifyText(text);
+        items.push({
+            type,
+            text,
+            line: startLine + i,
+            confidence,
+        });
+    }
+    return items;
+}
+export function classifySection(title, body, level, startLine, endLine) {
+    const { type: sectionType, confidence: sectionConf } = classifySectionTitle(title, level);
+    const bulletItems = parseBulletItems(body, startLine);
+    const numberedItems = parseNumberedItems(body, startLine);
+    const items = [...bulletItems, ...numberedItems];
+    // If the section is a generic "unknown" but its items are mostly tasks, promote it
+    let finalType = sectionType;
+    let finalConf = sectionConf;
+    if (sectionType === "unknown" && items.length > 0) {
+        const taskCount = items.filter((it) => it.type === "task").length;
+        if (taskCount > items.length / 2) {
+            finalType = "task";
+            finalConf = 0.6;
+        }
+    }
+    return {
+        type: finalType,
+        title,
+        description: body,
+        items,
+        startLine,
+        endLine,
+        confidence: finalConf,
+    };
+}
+//# sourceMappingURL=classify.js.map

package/dist/core/parser/classify.js.map

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

package/dist/core/parser/extract.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Stage 4: Entity extraction.
+ * Combine normalize → segment → classify to produce structured extraction results.
+ */
+import type { ClassifiedBlock } from "./classify.js";
+export interface ExtractionResult {
+    blocks: ClassifiedBlock[];
+    summary: {
+        totalSections: number;
+        epics: number;
+        tasks: number;
+        subtasks: number;
+        requirements: number;
+        constraints: number;
+        acceptanceCriteria: number;
+        risks: number;
+        unknown: number;
+    };
+}
+export declare function extractEntities(rawText: string): ExtractionResult;
+//# sourceMappingURL=extract.d.ts.map

package/dist/core/parser/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/core/parser/extract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,eAAe,CAAC;AAGhF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAQD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA2DjE"}

package/dist/core/parser/extract.js

@@ -0,0 +1,66 @@
+/**
+ * Stage 4: Entity extraction.
+ * Combine normalize → segment → classify to produce structured extraction results.
+ */
+import { normalize } from "./normalize.js";
+import { segment } from "./segment.js";
+import { classifySection, classifyText } from "./classify.js";
+import { logger } from "../utils/logger.js";
+function countByType(blocks, items, type) {
+    const blockCount = blocks.filter((b) => b.type === type).length;
+    const itemCount = items.filter((i) => i.type === type).length;
+    return blockCount + itemCount;
+}
+export function extractEntities(rawText) {
+    logger.info(`Extracting entities from ${rawText.length} chars`);
+    const normalized = normalize(rawText);
+    const sections = segment(normalized);
+    logger.info(`Segmented into ${sections.length} sections`);
+    const blocks = sections.map((sec) => classifySection(sec.title, sec.body, sec.level, sec.startLine, sec.endLine));
+    // Promote items inside task-sections to subtask if they're generic or tasks
+    for (const block of blocks) {
+        if (block.type === "task" || block.type === "epic") {
+            for (const item of block.items) {
+                if (item.type === "unknown" || item.type === "task") {
+                    // Items inside a task/epic section are subtasks
+                    if (block.type === "task") {
+                        item.type = "subtask";
+                        item.confidence = Math.max(item.confidence, 0.6);
+                    }
+                }
+            }
+        }
+    }
+    // Also classify numbered items inside sections that look like task lists
+    // (e.g., "Entregas" sections with numbered action items)
+    for (const block of blocks) {
+        if (block.type === "unknown") {
+            for (const item of block.items) {
+                if (item.type === "unknown") {
+                    const reclassified = classifyText(item.text);
+                    if (reclassified.type !== "unknown") {
+                        item.type = reclassified.type;
+                        item.confidence = reclassified.confidence;
+                    }
+                }
+            }
+        }
+    }
+    const allItems = blocks.flatMap((b) => b.items);
+    logger.info(`Extraction complete: ${blocks.length} blocks, ${allItems.length} items`);
+    return {
+        blocks,
+        summary: {
+            totalSections: blocks.length,
+            epics: countByType(blocks, allItems, "epic"),
+            tasks: countByType(blocks, allItems, "task"),
+            subtasks: countByType(blocks, allItems, "subtask"),
+            requirements: countByType(blocks, allItems, "requirement"),
+            constraints: countByType(blocks, allItems, "constraint"),
+            acceptanceCriteria: countByType(blocks, allItems, "acceptance_criteria"),
+            risks: countByType(blocks, allItems, "risk"),
+            unknown: countByType(blocks, allItems, "unknown"),
+        },
+    };
+}
+//# sourceMappingURL=extract.js.map

package/dist/core/parser/extract.js.map

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

package/dist/core/parser/normalize.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stage 1: Text normalization.
+ * - Standardize line endings
+ * - Remove duplicate blank lines
+ * - Trim whitespace
+ * - Standardize bullet markers to "-"
+ */
+export declare function normalize(raw: string): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/parser/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/parser/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAiB7C"}

package/dist/core/parser/normalize.js

@@ -0,0 +1,22 @@
+/**
+ * Stage 1: Text normalization.
+ * - Standardize line endings
+ * - Remove duplicate blank lines
+ * - Trim whitespace
+ * - Standardize bullet markers to "-"
+ */
+export function normalize(raw) {
+    let text = raw.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    // Collapse 3+ consecutive blank lines into 2
+    text = text.replace(/\n{3,}/g, "\n\n");
+    // Standardize bullet markers: *, •, ● → -
+    text = text.replace(/^(\s*)[*•●]\s/gm, "$1- ");
+    // Trim trailing whitespace per line
+    text = text
+        .split("\n")
+        .map((line) => line.trimEnd())
+        .join("\n")
+        .trim();
+    return text;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/parser/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/core/parser/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE3D,6CAA6C;IAC7C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAEvC,0CAA0C;IAC1C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAE/C,oCAAoC;IACpC,IAAI,GAAG,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IAEV,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/parser/read-file.d.ts

@@ -0,0 +1,7 @@
+export interface PrdFileResult {
+    content: string;
+    absolutePath: string;
+    sizeBytes: number;
+}
+export declare function readPrdFile(filePath: string): Promise<PrdFileResult>;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/core/parser/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../../src/core/parser/read-file.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAc1E"}

package/dist/core/parser/read-file.js

@@ -0,0 +1,17 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../utils/fs.js";
+import { FileNotFoundError } from "../utils/errors.js";
+export async function readPrdFile(filePath) {
+    const absolutePath = path.resolve(filePath);
+    if (!(await fileExists(absolutePath))) {
+        throw new FileNotFoundError(absolutePath);
+    }
+    const content = await readFile(absolutePath, "utf-8");
+    return {
+        content,
+        absolutePath,
+        sizeBytes: Buffer.byteLength(content, "utf-8"),
+    };
+}
+//# sourceMappingURL=read-file.js.map

package/dist/core/parser/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/core/parser/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEtD,OAAO;QACL,OAAO;QACP,YAAY;QACZ,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/core/parser/segment.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Stage 2: Segmentation.
+ * Split normalized text into structural blocks by headings.
+ */
+export interface Section {
+    level: number;
+    title: string;
+    body: string;
+    startLine: number;
+    endLine: number;
+}
+export declare function segment(text: string): Section[];
+//# sourceMappingURL=segment.d.ts.map

package/dist/core/parser/segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/core/parser/segment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAqD/C"}

package/dist/core/parser/segment.js

@@ -0,0 +1,53 @@
+/**
+ * Stage 2: Segmentation.
+ * Split normalized text into structural blocks by headings.
+ */
+export function segment(text) {
+    const lines = text.split("\n");
+    const sections = [];
+    let current = null;
+    let bodyLines = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            // Close previous section
+            if (current) {
+                current.body = bodyLines.join("\n").trim();
+                current.endLine = i;
+                sections.push(current);
+            }
+            const level = headingMatch[1].length;
+            const title = headingMatch[2].trim();
+            current = {
+                level,
+                title,
+                body: "",
+                startLine: i + 1, // 1-indexed
+                endLine: i + 1,
+            };
+            bodyLines = [];
+        }
+        else {
+            bodyLines.push(line);
+        }
+    }
+    // Close last section
+    if (current) {
+        current.body = bodyLines.join("\n").trim();
+        current.endLine = lines.length;
+        sections.push(current);
+    }
+    // If no headings found, treat entire text as a single section
+    if (sections.length === 0 && text.trim()) {
+        sections.push({
+            level: 0,
+            title: "Untitled",
+            body: text.trim(),
+            startLine: 1,
+            endLine: lines.length,
+        });
+    }
+    return sections;
+}
+//# sourceMappingURL=segment.js.map

package/dist/core/parser/segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment.js","sourceRoot":"","sources":["../../../src/core/parser/segment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,SAAS,GAAa,EAAE,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAErD,IAAI,YAAY,EAAE,CAAC;YACjB,yBAAyB;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC3C,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;gBACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAErC,OAAO,GAAG;gBACR,KAAK;gBACL,KAAK;gBACL,IAAI,EAAE,EAAE;gBACR,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY;gBAC9B,OAAO,EAAE,CAAC,GAAG,CAAC;aACf,CAAC;YACF,SAAS,GAAG,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,8DAA8D;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}