@diegonogueiradev_/mcp-graph 1.0.0 → 2.0.1

package/dist/core/insights/metrics-calculator.js

@@ -0,0 +1,78 @@
+import { calculateVelocity } from "../planner/velocity.js";
+import { logger } from "../utils/logger.js";
+const ALL_STATUSES = ["backlog", "ready", "in_progress", "blocked", "done"];
+/**
+ * Calculate comprehensive metrics from the graph.
+ */
+export function calculateMetrics(doc) {
+    logger.info("Calculating metrics", { nodes: doc.nodes.length });
+    const tasks = doc.nodes.filter((n) => n.type === "task" || n.type === "subtask");
+    const doneTasks = tasks.filter((n) => n.status === "done");
+    // Status distribution
+    const statusCounts = new Map();
+    for (const status of ALL_STATUSES)
+        statusCounts.set(status, 0);
+    for (const node of doc.nodes) {
+        const count = statusCounts.get(node.status) ?? 0;
+        statusCounts.set(node.status, count + 1);
+    }
+    const totalNodes = doc.nodes.length;
+    const statusDistribution = ALL_STATUSES.map((status) => {
+        const count = statusCounts.get(status) ?? 0;
+        return {
+            status,
+            count,
+            percentage: totalNodes > 0 ? Math.round((count / totalNodes) * 100) : 0,
+        };
+    });
+    // Velocity from existing planner
+    let velocityData = { tasksCompleted: 0, avgPointsPerTask: 0, avgCompletionHours: 0 };
+    try {
+        const velocity = calculateVelocity(doc);
+        velocityData = {
+            tasksCompleted: velocity.overall.totalTasksCompleted,
+            avgPointsPerTask: velocity.overall.totalPoints > 0 && velocity.overall.totalTasksCompleted > 0
+                ? Math.round(velocity.overall.totalPoints / velocity.overall.totalTasksCompleted * 10) / 10
+                : 0,
+            avgCompletionHours: velocity.overall.avgCompletionHours ?? 0,
+        };
+    }
+    catch {
+        // Velocity calculation may fail with no sprints
+    }
+    // Sprint progress
+    const sprintMap = new Map();
+    for (const task of tasks) {
+        const sprint = task.sprint ?? "__unassigned__";
+        const list = sprintMap.get(sprint) ?? [];
+        list.push(task);
+        sprintMap.set(sprint, list);
+    }
+    const sprintProgress = [];
+    for (const [sprint, sprintTasks] of sprintMap) {
+        if (sprint === "__unassigned__")
+            continue;
+        const total = sprintTasks.length;
+        const done = sprintTasks.filter((t) => t.status === "done").length;
+        const inProgress = sprintTasks.filter((t) => t.status === "in_progress").length;
+        const blocked = sprintTasks.filter((t) => t.status === "blocked" || t.blocked).length;
+        sprintProgress.push({
+            sprint,
+            total,
+            done,
+            inProgress,
+            blocked,
+            percentage: total > 0 ? Math.round((done / total) * 100) : 0,
+        });
+    }
+    sprintProgress.sort((a, b) => a.sprint.localeCompare(b.sprint));
+    return {
+        totalNodes,
+        totalTasks: tasks.length,
+        completionRate: tasks.length > 0 ? Math.round((doneTasks.length / tasks.length) * 100) : 0,
+        statusDistribution,
+        velocity: velocityData,
+        sprintProgress,
+    };
+}
+//# sourceMappingURL=metrics-calculator.js.map

package/dist/core/insights/metrics-calculator.js.map

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

package/dist/core/insights/skill-recommender.d.ts

@@ -0,0 +1,21 @@
+import type { GraphDocument } from "../graph/graph-types.js";
+export interface SkillInfo {
+    name: string;
+    description: string;
+    category: string;
+    filePath: string;
+}
+export interface SkillRecommendation {
+    skill: string;
+    reason: string;
+    phase: string;
+}
+/**
+ * Scan skills directory for SKILL.md files and extract frontmatter.
+ */
+export declare function scanSkills(basePath: string): Promise<SkillInfo[]>;
+/**
+ * Generate skill recommendations based on current graph state.
+ */
+export declare function recommendSkills(doc: GraphDocument, availableSkills: SkillInfo[]): SkillRecommendation[];
+//# sourceMappingURL=skill-recommender.d.ts.map

package/dist/core/insights/skill-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-recommender.d.ts","sourceRoot":"","sources":["../../../src/core/insights/skill-recommender.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6BvE;AAgCD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,eAAe,EAAE,SAAS,EAAE,GAC3B,mBAAmB,EAAE,CA8EvB"}

package/dist/core/insights/skill-recommender.js

@@ -0,0 +1,129 @@
+import path from "node:path";
+import { readdir, readFile } from "node:fs/promises";
+import { logger } from "../utils/logger.js";
+/**
+ * Scan skills directory for SKILL.md files and extract frontmatter.
+ */
+export async function scanSkills(basePath) {
+    const skillsDirs = [
+        path.join(basePath, "copilot-ecosystem", "skills", "agents"),
+        path.join(basePath, ".claude", "skills"),
+    ];
+    const skills = [];
+    for (const dir of skillsDirs) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillMdPath = path.join(dir, entry.name, "SKILL.md");
+                try {
+                    const content = await readFile(skillMdPath, "utf-8");
+                    const info = parseSkillFrontmatter(content, entry.name, skillMdPath);
+                    if (info)
+                        skills.push(info);
+                }
+                catch {
+                    // No SKILL.md in this directory
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    logger.info("Skills scanned", { count: skills.length });
+    return skills;
+}
+function parseSkillFrontmatter(content, dirName, filePath) {
+    // Parse YAML frontmatter between --- delimiters
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+        return {
+            name: dirName,
+            description: extractFirstLine(content),
+            category: "general",
+            filePath,
+        };
+    }
+    const frontmatter = match[1];
+    const name = extractField(frontmatter, "name") ?? dirName;
+    const description = extractField(frontmatter, "description") ?? extractFirstLine(content);
+    const category = extractField(frontmatter, "category") ?? "general";
+    return { name, description, category, filePath };
+}
+function extractField(yaml, field) {
+    const match = yaml.match(new RegExp(`^${field}:\\s*(.+)$`, "m"));
+    return match ? match[1].trim().replace(/^["']|["']$/g, "") : null;
+}
+function extractFirstLine(content) {
+    const lines = content.split("\n").filter((l) => l.trim() && !l.startsWith("---") && !l.startsWith("#"));
+    return lines[0]?.trim().substring(0, 120) ?? "";
+}
+/**
+ * Generate skill recommendations based on current graph state.
+ */
+export function recommendSkills(doc, availableSkills) {
+    const recommendations = [];
+    const skillNames = new Set(availableSkills.map((s) => s.name));
+    const tasksByStatus = new Map();
+    for (const node of doc.nodes) {
+        if (node.type === "task" || node.type === "subtask") {
+            const count = tasksByStatus.get(node.status) ?? 0;
+            tasksByStatus.set(node.status, count + 1);
+        }
+    }
+    const inProgressCount = tasksByStatus.get("in_progress") ?? 0;
+    const backlogCount = tasksByStatus.get("backlog") ?? 0;
+    const blockedCount = tasksByStatus.get("blocked") ?? 0;
+    // Tasks without tests
+    const tasksWithoutTests = doc.nodes.filter((n) => (n.type === "task" || n.type === "subtask") &&
+        n.status === "in_progress" &&
+        !n.tags?.includes("tested"));
+    if (tasksWithoutTests.length > 0 && skillNames.has("polyglot-test-generator")) {
+        recommendations.push({
+            skill: "polyglot-test-generator",
+            reason: `${tasksWithoutTests.length} tasks in progress without test coverage`,
+            phase: "IMPLEMENT",
+        });
+    }
+    // Review pending
+    const readyForReview = doc.nodes.filter((n) => n.type === "task" && n.status === "in_progress" && n.tags?.includes("review-pending"));
+    if (readyForReview.length > 0 && skillNames.has("code-reviewer")) {
+        recommendations.push({
+            skill: "code-reviewer",
+            reason: `${readyForReview.length} tasks pending review`,
+            phase: "REVIEW",
+        });
+    }
+    // High blocked count
+    if (blockedCount > 3) {
+        recommendations.push({
+            skill: "dev-flow-orchestrator",
+            reason: `${blockedCount} blocked tasks — consider re-planning dependencies`,
+            phase: "ANALYZE",
+        });
+    }
+    // Large backlog
+    if (backlogCount > 20 && inProgressCount === 0) {
+        recommendations.push({
+            skill: "dev-flow-orchestrator",
+            reason: `${backlogCount} tasks in backlog with none in progress — start sprint planning`,
+            phase: "PLAN",
+        });
+    }
+    // Missing acceptance criteria
+    const missingAC = doc.nodes.filter((n) => (n.type === "task" || n.type === "epic") &&
+        n.status !== "done" &&
+        (!n.acceptanceCriteria || n.acceptanceCriteria.length === 0));
+    if (missingAC.length > 5) {
+        recommendations.push({
+            skill: "create-prd-chat-mode",
+            reason: `${missingAC.length} tasks/epics without acceptance criteria`,
+            phase: "DESIGN",
+        });
+    }
+    logger.info("Skill recommendations generated", { count: recommendations.length });
+    return recommendations;
+}
+//# sourceMappingURL=skill-recommender.js.map

package/dist/core/insights/skill-recommender.js.map

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

package/dist/core/integrations/serena-reader.d.ts

@@ -0,0 +1,18 @@
+export interface SerenaMemory {
+    name: string;
+    content: string;
+    sizeBytes: number;
+}
+/**
+ * List all Serena memory files from the project directory.
+ */
+export declare function listSerenaMemories(basePath: string): Promise<string[]>;
+/**
+ * Read a specific Serena memory file.
+ */
+export declare function readSerenaMemory(basePath: string, name: string): Promise<SerenaMemory | null>;
+/**
+ * Read all Serena memories at once.
+ */
+export declare function readAllSerenaMemories(basePath: string): Promise<SerenaMemory[]>;
+//# sourceMappingURL=serena-reader.d.ts.map

package/dist/core/integrations/serena-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serena-reader.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/serena-reader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAanG;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAUrF"}

package/dist/core/integrations/serena-reader.js

@@ -0,0 +1,50 @@
+import path from "node:path";
+import { readdir, readFile } from "node:fs/promises";
+import { logger } from "../utils/logger.js";
+const SERENA_MEMORIES_DIR = ".serena/memories";
+/**
+ * List all Serena memory files from the project directory.
+ */
+export async function listSerenaMemories(basePath) {
+    try {
+        const dir = path.join(basePath, SERENA_MEMORIES_DIR);
+        const files = await readdir(dir);
+        return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, ""));
+    }
+    catch {
+        logger.info("No Serena memories directory found", { basePath });
+        return [];
+    }
+}
+/**
+ * Read a specific Serena memory file.
+ */
+export async function readSerenaMemory(basePath, name) {
+    try {
+        const filePath = path.join(basePath, SERENA_MEMORIES_DIR, `${name}.md`);
+        const content = await readFile(filePath, "utf-8");
+        return {
+            name,
+            content,
+            sizeBytes: Buffer.byteLength(content, "utf-8"),
+        };
+    }
+    catch {
+        logger.info("Serena memory not found", { name });
+        return null;
+    }
+}
+/**
+ * Read all Serena memories at once.
+ */
+export async function readAllSerenaMemories(basePath) {
+    const names = await listSerenaMemories(basePath);
+    const memories = [];
+    for (const name of names) {
+        const memory = await readSerenaMemory(basePath, name);
+        if (memory)
+            memories.push(memory);
+    }
+    return memories;
+}
+//# sourceMappingURL=serena-reader.js.map

package/dist/core/integrations/serena-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serena-reader.js","sourceRoot":"","sources":["../../../src/core/integrations/serena-reader.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAAY;IACnE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO;YACL,IAAI;YACJ,OAAO;YACP,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;SAC/C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IAC1D,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/core/integrations/tool-status.d.ts

@@ -0,0 +1,18 @@
+export interface ToolInfo {
+    installed: boolean;
+    running: boolean;
+    url?: string;
+    details?: Record<string, unknown>;
+}
+export interface IntegrationsStatus {
+    gitnexus: ToolInfo;
+    serena: ToolInfo & {
+        memories: string[];
+    };
+    playwright: ToolInfo;
+}
+/**
+ * Detect status of all ecosystem tools.
+ */
+export declare function getIntegrationsStatus(basePath: string): Promise<IntegrationsStatus>;
+//# sourceMappingURL=tool-status.d.ts.map

package/dist/core/integrations/tool-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-status.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/tool-status.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAE,QAAQ,CAAC;CACtB;AA6DD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+BzF"}

package/dist/core/integrations/tool-status.js

@@ -0,0 +1,92 @@
+import { logger } from "../utils/logger.js";
+/**
+ * Detect whether a local HTTP service is running by attempting a fetch.
+ */
+async function probeHttp(url, timeoutMs = 2000) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const res = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+        return res.ok || res.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a command-line tool is installed by looking for it in PATH.
+ */
+async function isCommandInstalled(command) {
+    try {
+        const { execFile } = await import("node:child_process");
+        const { promisify } = await import("node:util");
+        const exec = promisify(execFile);
+        await exec("which", [command]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read Serena memory file names from .serena/memories/ directory.
+ */
+async function readSerenaMemories(basePath) {
+    try {
+        const path = await import("node:path");
+        const { readdir } = await import("node:fs/promises");
+        const memoriesDir = path.join(basePath, ".serena", "memories");
+        const files = await readdir(memoriesDir);
+        return files.filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, ""));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if Serena is configured for this project.
+ */
+async function isSerenaConfigured(basePath) {
+    try {
+        const path = await import("node:path");
+        const { access } = await import("node:fs/promises");
+        await access(path.join(basePath, ".serena"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect status of all ecosystem tools.
+ */
+export async function getIntegrationsStatus(basePath) {
+    logger.info("Checking integrations status", { basePath });
+    const GITNEXUS_PORT = parseInt(process.env.GITNEXUS_PORT || "3737", 10);
+    const gitnexusUrl = `http://localhost:${GITNEXUS_PORT}`;
+    const [gitnexusInstalled, gitnexusRunning, serenaConfigured, serenaMemories, playwrightInstalled] = await Promise.all([
+        isCommandInstalled("gitnexus"),
+        probeHttp(gitnexusUrl),
+        isSerenaConfigured(basePath),
+        readSerenaMemories(basePath),
+        isCommandInstalled("npx").then(() => true).catch(() => false),
+    ]);
+    return {
+        gitnexus: {
+            installed: gitnexusInstalled,
+            running: gitnexusRunning,
+            ...(gitnexusRunning ? { url: gitnexusUrl } : {}),
+        },
+        serena: {
+            installed: serenaConfigured,
+            running: serenaConfigured,
+            memories: serenaMemories,
+        },
+        playwright: {
+            installed: playwrightInstalled,
+            running: false,
+        },
+    };
+}
+//# sourceMappingURL=tool-status.js.map

package/dist/core/integrations/tool-status.js.map

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

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

@@ -0,0 +1,13 @@
+export interface FileReadResult {
+    text: string;
+    originalName: string;
+    format: string;
+    sizeBytes: number;
+}
+/**
+ * Read a file and extract its text content based on extension.
+ * Supports: .md, .txt, .pdf, .html, .htm
+ */
+export declare function readFileContent(filePath: string, originalName?: string): Promise<FileReadResult>;
+export declare function isSupportedFormat(filename: string): boolean;
+//# sourceMappingURL=file-reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/core/parser/file-reader.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CA4CzB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG3D"}

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

@@ -0,0 +1,52 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { readPdfBuffer } from "./read-pdf.js";
+import { readHtmlContent } from "./read-html.js";
+import { logger } from "../utils/logger.js";
+const SUPPORTED_EXTENSIONS = new Set([".md", ".txt", ".pdf", ".html", ".htm"]);
+/**
+ * Read a file and extract its text content based on extension.
+ * Supports: .md, .txt, .pdf, .html, .htm
+ */
+export async function readFileContent(filePath, originalName) {
+    const name = originalName ?? path.basename(filePath);
+    const ext = path.extname(name).toLowerCase();
+    if (!SUPPORTED_EXTENSIONS.has(ext)) {
+        throw new Error(`Unsupported file format: "${ext}". Supported: ${[...SUPPORTED_EXTENSIONS].join(", ")}`);
+    }
+    logger.info("Reading file", { name, ext });
+    const buffer = await readFile(filePath);
+    const sizeBytes = buffer.length;
+    let text;
+    switch (ext) {
+        case ".pdf": {
+            const result = await readPdfBuffer(buffer);
+            text = result.text;
+            break;
+        }
+        case ".html":
+        case ".htm": {
+            const html = buffer.toString("utf-8");
+            text = await readHtmlContent(html);
+            break;
+        }
+        case ".md":
+        case ".txt":
+        default: {
+            text = buffer.toString("utf-8");
+            break;
+        }
+    }
+    logger.info("File read complete", { name, format: ext, textLength: text.length });
+    return {
+        text,
+        originalName: name,
+        format: ext,
+        sizeBytes,
+    };
+}
+export function isSupportedFormat(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    return SUPPORTED_EXTENSIONS.has(ext);
+}
+//# sourceMappingURL=file-reader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.js","sourceRoot":"","sources":["../../../src/core/parser/file-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAS/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,YAAqB;IAErB,MAAM,IAAI,GAAG,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,iBAAiB,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,IAAI,IAAY,CAAC;IAEjB,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,IAAI,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM;QACR,CAAC;QACD,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAElF,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,IAAI;QAClB,MAAM,EAAE,GAAG;QACX,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Extract text content from an HTML string using cheerio.
+ * Converts headings to markdown format so the parser pipeline can segment them.
+ * Strips tags, scripts, styles, and normalizes whitespace.
+ */
+export declare function readHtmlContent(html: string): Promise<string>;
+//# sourceMappingURL=read-html.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-html.d.ts","sourceRoot":"","sources":["../../../src/core/parser/read-html.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CnE"}

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

@@ -0,0 +1,51 @@
+import { logger } from "../utils/logger.js";
+const HEADING_MAP = {
+    h1: "#",
+    h2: "##",
+    h3: "###",
+    h4: "####",
+    h5: "#####",
+    h6: "######",
+};
+/**
+ * Extract text content from an HTML string using cheerio.
+ * Converts headings to markdown format so the parser pipeline can segment them.
+ * Strips tags, scripts, styles, and normalizes whitespace.
+ */
+export async function readHtmlContent(html) {
+    // Dynamic import — cheerio is heavy, lazy-load
+    const { load } = await import("cheerio");
+    logger.info("Parsing HTML content", { sizeChars: html.length });
+    const $ = load(html);
+    // Remove non-content elements
+    $("script, style, nav, footer, header, noscript, iframe").remove();
+    // Convert HTML headings to markdown headings
+    for (const [tag, prefix] of Object.entries(HEADING_MAP)) {
+        $(tag).each(function () {
+            const el = $(this);
+            const text = el.text().trim();
+            el.replaceWith(`\n\n${prefix} ${text}\n\n`);
+        });
+    }
+    // Convert list items to markdown bullets
+    $("li").each(function () {
+        const el = $(this);
+        const text = el.text().trim();
+        el.replaceWith(`\n- ${text}`);
+    });
+    // Add line breaks for block elements
+    const blockElements = "p, div, section, article, blockquote, pre, br, tr";
+    $(blockElements).each(function () {
+        $(this).prepend("\n");
+        $(this).append("\n");
+    });
+    // Extract text from body (or whole doc if no body)
+    const rawText = $("body").length ? $("body").text() : $.root().text();
+    const text = rawText
+        .replace(/[ \t]+/g, " ")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    logger.info("HTML parsed", { textLength: text.length });
+    return text;
+}
+//# sourceMappingURL=read-html.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-html.js","sourceRoot":"","sources":["../../../src/core/parser/read-html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,GAA2B;IAC1C,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,QAAQ;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,+CAA+C;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAEzC,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhE,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAErB,8BAA8B;IAC9B,CAAC,CAAC,sDAAsD,CAAC,CAAC,MAAM,EAAE,CAAC;IAEnE,6CAA6C;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACV,MAAM,EAAE,GAAG,CAAC,CAAC,IAAc,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC9B,EAAE,CAAC,WAAW,CAAC,OAAO,MAAM,IAAI,IAAI,MAAM,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,EAAE,GAAG,CAAC,CAAC,IAAc,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC9B,EAAE,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,aAAa,GAAG,mDAAmD,CAAC;IAC1E,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,IAAc,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,IAAc,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,mDAAmD;IACnD,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAEtE,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,IAAI,EAAE,CAAC;IAEV,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAExD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,10 @@
+interface PdfReadResult {
+    text: string;
+    pages: number;
+}
+/**
+ * Extract text content from a PDF buffer using pdf-parse.
+ */
+export declare function readPdfBuffer(buffer: Buffer): Promise<PdfReadResult>;
+export {};
+//# sourceMappingURL=read-pdf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-pdf.d.ts","sourceRoot":"","sources":["../../../src/core/parser/read-pdf.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAc1E"}

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

@@ -0,0 +1,16 @@
+import { logger } from "../utils/logger.js";
+/**
+ * Extract text content from a PDF buffer using pdf-parse.
+ */
+export async function readPdfBuffer(buffer) {
+    // Dynamic import — pdf-parse is CJS, lazy-load to avoid startup cost
+    const pdfParse = (await import("pdf-parse")).default;
+    logger.info("Parsing PDF buffer", { sizeBytes: buffer.length });
+    const result = await pdfParse(buffer);
+    logger.info("PDF parsed", { pages: result.numpages, textLength: result.text.length });
+    return {
+        text: result.text,
+        pages: result.numpages,
+    };
+}
+//# sourceMappingURL=read-pdf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-pdf.js","sourceRoot":"","sources":["../../../src/core/parser/read-pdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAO5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,qEAAqE;IACrE,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAErD,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEtF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC"}

package/dist/core/planner/next-task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next-task.d.ts","sourceRoot":"","sources":["../../../src/core/planner/next-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAU,MAAM,yBAAyB,CAAC;AAOhF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,GAAG,IAAI,CA0EtE"}
+{"version":3,"file":"next-task.d.ts","sourceRoot":"","sources":["../../../src/core/planner/next-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAU,MAAM,yBAAyB,CAAC;AAOhF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,cAAc,GAAG,IAAI,CA6EtE"}