heor-agent-mcp 0.1.0

package/dist/knowledge/paths.js

@@ -0,0 +1,35 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function getKbRoot() {
+    return process.env.HEOR_KB_ROOT ?? join(homedir(), ".heor-agent");
+}
+export function getProjectRoot(projectId) {
+    return join(getKbRoot(), "projects", sanitizeProjectId(projectId));
+}
+export function getRawLiteratureDir(projectId) {
+    return join(getProjectRoot(projectId), "raw", "literature");
+}
+export function getRawModelsDir(projectId) {
+    return join(getProjectRoot(projectId), "raw", "models");
+}
+export function getRawDossiersDir(projectId) {
+    return join(getProjectRoot(projectId), "raw", "dossiers");
+}
+export function getWikiDir(projectId) {
+    return join(getProjectRoot(projectId), "wiki");
+}
+// Sanitize project ID to prevent path traversal and filesystem issues
+export function sanitizeProjectId(id) {
+    // Allow alphanumeric, hyphens, underscores. Replace all else with hyphen.
+    const clean = id.replace(/[^a-zA-Z0-9_-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    if (clean.length === 0)
+        throw new Error("Invalid project ID: must contain alphanumeric characters");
+    if (clean.length > 64)
+        return clean.slice(0, 64).toLowerCase();
+    return clean.toLowerCase();
+}
+// Sanitize filename (for file IDs like "pubmed_12345")
+export function sanitizeFilename(name) {
+    return name.replace(/[^a-zA-Z0-9_.-]/g, "_").slice(0, 200);
+}
+//# sourceMappingURL=paths.js.map

package/dist/knowledge/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/knowledge/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,0EAA0E;IAC1E,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACpG,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC"}

package/dist/knowledge/projectStore.d.ts

@@ -0,0 +1,37 @@
+export interface ProjectConfig {
+    project_id: string;
+    drug: string;
+    indication: string;
+    hta_targets?: string[];
+    picos?: Array<{
+        id: string;
+        population: string;
+        comparator: string;
+        outcomes: string[];
+    }>;
+    created_at: string;
+    notes?: string;
+}
+export interface ProjectCreateParams {
+    project_id: string;
+    drug: string;
+    indication: string;
+    hta_targets?: string[];
+    notes?: string;
+}
+export declare function projectExists(projectId: string): Promise<boolean>;
+/**
+ * Create a new project with directory skeleton and project.yaml.
+ * Idempotent: if project exists, returns existing config without overwriting.
+ */
+export declare function createProject(params: ProjectCreateParams): Promise<{
+    config: ProjectConfig;
+    created: boolean;
+    path: string;
+}>;
+export declare function readProjectConfig(projectId: string): Promise<ProjectConfig>;
+/**
+ * List all projects in the KB root.
+ */
+export declare function listProjects(): Promise<string[]>;
+//# sourceMappingURL=projectStore.d.ts.map

package/dist/knowledge/projectStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectStore.d.ts","sourceRoot":"","sources":["../../src/knowledge/projectStore.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAsDpE;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAcjF;AAiBD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAWtD"}

package/dist/knowledge/projectStore.js

@@ -0,0 +1,112 @@
+import { writeFile, readFile, mkdir, access, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { getProjectRoot, getWikiDir, getRawLiteratureDir, getRawModelsDir, getRawDossiersDir, getKbRoot, sanitizeProjectId, } from "./paths.js";
+import { stringifyFrontmatter, parseFrontmatter } from "./yaml.js";
+export async function projectExists(projectId) {
+    try {
+        const yamlPath = join(getProjectRoot(projectId), "project.yaml");
+        await access(yamlPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a new project with directory skeleton and project.yaml.
+ * Idempotent: if project exists, returns existing config without overwriting.
+ */
+export async function createProject(params) {
+    const projectId = sanitizeProjectId(params.project_id);
+    const projectRoot = getProjectRoot(projectId);
+    if (await projectExists(projectId)) {
+        const existing = await readProjectConfig(projectId);
+        return { config: existing, created: false, path: projectRoot };
+    }
+    // Create directory skeleton
+    await mkdir(getRawLiteratureDir(projectId), { recursive: true });
+    await mkdir(getRawModelsDir(projectId), { recursive: true });
+    await mkdir(getRawDossiersDir(projectId), { recursive: true });
+    await mkdir(getWikiDir(projectId), { recursive: true });
+    const config = {
+        project_id: projectId,
+        drug: params.drug,
+        indication: params.indication,
+        hta_targets: params.hta_targets ?? [],
+        picos: [],
+        created_at: new Date().toISOString(),
+        notes: params.notes,
+    };
+    await writeProjectConfig(projectId, config);
+    // Create starter wiki index.md
+    const indexContent = `---
+project: ${projectId}
+drug: ${params.drug}
+indication: ${params.indication}
+---
+
+# ${params.drug} — ${params.indication}
+
+Project knowledge base index.
+
+## Structure
+- [[trials/]] — clinical trials and evidence
+- [[comparators/]] — comparator drugs and standards of care
+- [[outcomes/]] — outcome measures and endpoints
+- [[picos/]] — PICO definitions per scoping decision
+- [[models/]] — CE model runs and PSA results
+
+## Data Sources
+Raw search results are auto-saved to \`raw/literature/\`, \`raw/models/\`, and \`raw/dossiers/\`.
+
+*Created: ${config.created_at}*
+`;
+    await writeFile(join(getWikiDir(projectId), "index.md"), indexContent, "utf-8");
+    return { config, created: true, path: projectRoot };
+}
+export async function readProjectConfig(projectId) {
+    const yamlPath = join(getProjectRoot(projectId), "project.yaml");
+    const raw = await readFile(yamlPath, "utf-8");
+    const { frontmatter } = parseFrontmatter(raw);
+    return {
+        project_id: String(frontmatter.project_id ?? projectId),
+        drug: String(frontmatter.drug ?? ""),
+        indication: String(frontmatter.indication ?? ""),
+        hta_targets: Array.isArray(frontmatter.hta_targets) ? frontmatter.hta_targets : [],
+        picos: [], // picos are complex; skip for v1
+        created_at: String(frontmatter.created_at ?? ""),
+        notes: frontmatter.notes ? String(frontmatter.notes) : undefined,
+    };
+}
+async function writeProjectConfig(projectId, config) {
+    const yamlPath = join(getProjectRoot(projectId), "project.yaml");
+    // project.yaml uses frontmatter format (--- delimiters) for consistency with other .md files
+    const fm = {
+        project_id: config.project_id,
+        drug: config.drug,
+        indication: config.indication,
+        hta_targets: config.hta_targets ?? [],
+        created_at: config.created_at,
+    };
+    if (config.notes)
+        fm.notes = config.notes;
+    const body = "# Project metadata\nManaged by heor-agent-mcp. Edit with care.";
+    await writeFile(yamlPath, stringifyFrontmatter(fm, body), "utf-8");
+}
+/**
+ * List all projects in the KB root.
+ */
+export async function listProjects() {
+    try {
+        const projectsRoot = join(getKbRoot(), "projects");
+        const entries = await readdir(projectsRoot, { withFileTypes: true });
+        return entries
+            .filter(e => e.isDirectory())
+            .map(e => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=projectStore.js.map

package/dist/knowledge/projectStore.js.map

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

package/dist/knowledge/rawStore.d.ts

@@ -0,0 +1,18 @@
+import type { LiteratureResult } from "../providers/types.js";
+/**
+ * Save a literature result to the project's raw/literature/ directory.
+ * If a file with the same ID exists, merges: keeps original metadata,
+ * appends current timestamp to retrieved_at array, appends query to query_history.
+ */
+export declare function saveLiteratureResult(projectId: string, result: LiteratureResult, query: string): Promise<string>;
+/**
+ * Save a CE model run to raw/models/.
+ * Filename: {iso-date}_{model_type}.md
+ */
+export declare function saveModelRun(projectId: string, metadata: Record<string, unknown>, textContent: string): Promise<string>;
+/**
+ * Save an HTA dossier draft to raw/dossiers/.
+ * Filename: {hta_body}_{submission_type}_{iso-date}.md
+ */
+export declare function saveDossier(projectId: string, htaBody: string, submissionType: string, metadata: Record<string, unknown>, textContent: string): Promise<string>;
+//# sourceMappingURL=rawStore.d.ts.map

package/dist/knowledge/rawStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rawStore.d.ts","sourceRoot":"","sources":["../../src/knowledge/rawStore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/knowledge/rawStore.js

@@ -0,0 +1,103 @@
+import { mkdir, readFile, writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { parseFrontmatter, stringifyFrontmatter } from "./yaml.js";
+import { sanitizeFilename, getRawLiteratureDir, getRawModelsDir, getRawDossiersDir } from "./paths.js";
+/**
+ * Save a literature result to the project's raw/literature/ directory.
+ * If a file with the same ID exists, merges: keeps original metadata,
+ * appends current timestamp to retrieved_at array, appends query to query_history.
+ */
+export async function saveLiteratureResult(projectId, result, query) {
+    const dir = getRawLiteratureDir(projectId);
+    await mkdir(dir, { recursive: true });
+    const filename = `${sanitizeFilename(result.id)}.md`;
+    const filepath = join(dir, filename);
+    const nowIso = new Date().toISOString();
+    let frontmatter;
+    let body;
+    if (await fileExists(filepath)) {
+        // Merge: read existing, append retrieval
+        const existing = await readFile(filepath, "utf-8");
+        const parsed = parseFrontmatter(existing);
+        frontmatter = parsed.frontmatter;
+        body = parsed.body;
+        const retrievedAt = Array.isArray(frontmatter.retrieved_at) ? frontmatter.retrieved_at : [];
+        const queryHistory = Array.isArray(frontmatter.query_history) ? frontmatter.query_history : [];
+        frontmatter.retrieved_at = [...retrievedAt, nowIso];
+        if (!queryHistory.includes(query)) {
+            frontmatter.query_history = [...queryHistory, query];
+        }
+    }
+    else {
+        // Create new
+        frontmatter = {
+            id: result.id,
+            source: result.source,
+            title: result.title,
+            authors: result.authors,
+            date: result.date,
+            study_type: result.study_type,
+            url: result.url,
+            project: projectId,
+            retrieved_at: [nowIso],
+            query_history: [query],
+        };
+        body = `# ${result.title}\n\n${result.abstract || "*No abstract available*"}\n\n**URL:** ${result.url}`;
+    }
+    const content = stringifyFrontmatter(frontmatter, body);
+    await writeFile(filepath, content, "utf-8");
+    return filepath;
+}
+/**
+ * Save a CE model run to raw/models/.
+ * Filename: {iso-date}_{model_type}.md
+ */
+export async function saveModelRun(projectId, metadata, textContent) {
+    const dir = getRawModelsDir(projectId);
+    await mkdir(dir, { recursive: true });
+    const nowIso = new Date().toISOString().replace(/[:.]/g, "-");
+    const modelType = String(metadata.model_type ?? "markov");
+    const filename = `${nowIso}_${sanitizeFilename(modelType)}.md`;
+    const filepath = join(dir, filename);
+    const frontmatter = {
+        tool: "cost_effectiveness_model",
+        generated_at: new Date().toISOString(),
+        project: projectId,
+        ...Object.fromEntries(Object.entries(metadata).map(([k, v]) => [k, v])),
+    };
+    const content = stringifyFrontmatter(frontmatter, textContent);
+    await writeFile(filepath, content, "utf-8");
+    return filepath;
+}
+/**
+ * Save an HTA dossier draft to raw/dossiers/.
+ * Filename: {hta_body}_{submission_type}_{iso-date}.md
+ */
+export async function saveDossier(projectId, htaBody, submissionType, metadata, textContent) {
+    const dir = getRawDossiersDir(projectId);
+    await mkdir(dir, { recursive: true });
+    const nowIso = new Date().toISOString().replace(/[:.]/g, "-");
+    const filename = `${sanitizeFilename(htaBody)}_${sanitizeFilename(submissionType)}_${nowIso}.md`;
+    const filepath = join(dir, filename);
+    const frontmatter = {
+        tool: "hta_dossier_prep",
+        hta_body: htaBody,
+        submission_type: submissionType,
+        generated_at: new Date().toISOString(),
+        project: projectId,
+        ...Object.fromEntries(Object.entries(metadata).map(([k, v]) => [k, v])),
+    };
+    const content = stringifyFrontmatter(frontmatter, textContent);
+    await writeFile(filepath, content, "utf-8");
+    return filepath;
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=rawStore.js.map

package/dist/knowledge/rawStore.js.map

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

package/dist/knowledge/search.d.ts

@@ -0,0 +1,19 @@
+export interface SearchMatch {
+    file: string;
+    line_number: number;
+    snippet: string;
+    score: number;
+    title?: string;
+    source?: string;
+}
+export interface SearchOptions {
+    paths?: Array<"raw" | "wiki">;
+    max_results?: number;
+    case_sensitive?: boolean;
+}
+/**
+ * Search project files for a query. Returns matches with snippets.
+ * Case-insensitive by default. Multi-term queries match any term (OR).
+ */
+export declare function searchProject(projectId: string, query: string, options?: SearchOptions): Promise<SearchMatch[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/knowledge/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/knowledge/search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CA0BxB"}

package/dist/knowledge/search.js

@@ -0,0 +1,105 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { getProjectRoot } from "./paths.js";
+/**
+ * Search project files for a query. Returns matches with snippets.
+ * Case-insensitive by default. Multi-term queries match any term (OR).
+ */
+export async function searchProject(projectId, query, options = {}) {
+    const { paths = ["raw", "wiki"], max_results = 20, case_sensitive = false } = options;
+    const projectRoot = getProjectRoot(projectId);
+    // Tokenize query into terms
+    const terms = query.trim().split(/\s+/).filter(Boolean);
+    if (terms.length === 0)
+        return [];
+    const matches = [];
+    for (const subtree of paths) {
+        const dirPath = join(projectRoot, subtree);
+        try {
+            const files = await walkMarkdownFiles(dirPath);
+            for (const filePath of files) {
+                const fileMatches = await searchFile(filePath, projectRoot, terms, case_sensitive);
+                matches.push(...fileMatches);
+            }
+        }
+        catch {
+            // Directory doesn't exist yet — skip
+        }
+    }
+    // Sort by score desc, then file path asc for stability
+    matches.sort((a, b) => b.score - a.score || a.file.localeCompare(b.file));
+    return matches.slice(0, max_results);
+}
+async function walkMarkdownFiles(dir) {
+    const out = [];
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const nested = await walkMarkdownFiles(full);
+                out.push(...nested);
+            }
+            else if (entry.isFile() && entry.name.endsWith(".md")) {
+                out.push(full);
+            }
+        }
+    }
+    catch {
+        // directory not accessible — return empty
+    }
+    return out;
+}
+async function searchFile(filePath, projectRoot, terms, caseSensitive) {
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split("\n");
+    const haystackTerms = caseSensitive ? terms : terms.map(t => t.toLowerCase());
+    const matches = [];
+    const relFile = relative(projectRoot, filePath);
+    // Extract title and source from frontmatter (simple regex, no full parse)
+    let title;
+    let source;
+    for (let i = 0; i < Math.min(lines.length, 30); i++) {
+        const line = lines[i];
+        if (line.startsWith("title:"))
+            title = line.slice(6).trim().replace(/^["']|["']$/g, "");
+        if (line.startsWith("source:"))
+            source = line.slice(7).trim().replace(/^["']|["']$/g, "");
+    }
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const haystack = caseSensitive ? line : line.toLowerCase();
+        let matchCount = 0;
+        for (const term of haystackTerms) {
+            if (haystack.includes(term))
+                matchCount++;
+        }
+        if (matchCount > 0) {
+            // Snippet: trim line to ~200 chars, centered around first match if possible
+            const firstTerm = haystackTerms.find(t => haystack.includes(t));
+            let snippet = line;
+            if (line.length > 200 && firstTerm) {
+                const idx = haystack.indexOf(firstTerm);
+                const start = Math.max(0, idx - 80);
+                const end = Math.min(line.length, idx + firstTerm.length + 80);
+                snippet = (start > 0 ? "..." : "") + line.slice(start, end) + (end < line.length ? "..." : "");
+            }
+            matches.push({
+                file: relFile,
+                line_number: i + 1,
+                snippet: snippet.trim(),
+                score: matchCount,
+                title,
+                source,
+            });
+        }
+    }
+    return matches;
+}
+//# sourceMappingURL=search.js.map

package/dist/knowledge/search.js.map

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

package/dist/knowledge/types.d.ts

@@ -0,0 +1,6 @@
+export interface SaveResult {
+    saved: boolean;
+    path?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/knowledge/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":""}

package/dist/knowledge/wikiStore.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Read a file from anywhere in the project's raw/ or wiki/ tree.
+ * Path is relative to project root.
+ * Allowed prefixes: "raw/", "wiki/"
+ */
+export declare function readKnowledgeFile(projectId: string, path: string): Promise<string>;
+/**
+ * Write a file to the project's wiki/ tree.
+ * Path is relative to project root, MUST start with "wiki/".
+ * Creates parent directories as needed.
+ * Raw files can NOT be written via this tool — they come only from tool auto-save.
+ */
+export declare function writeWikiFile(projectId: string, path: string, content: string): Promise<string>;
+/**
+ * Check if a file exists in the project tree (raw/ or wiki/).
+ */
+export declare function knowledgeFileExists(projectId: string, path: string): Promise<boolean>;
+//# sourceMappingURL=wikiStore.d.ts.map

package/dist/knowledge/wikiStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikiStore.d.ts","sourceRoot":"","sources":["../../src/knowledge/wikiStore.ts"],"names":[],"mappings":"AA0BA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBrG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3F"}

package/dist/knowledge/wikiStore.js

@@ -0,0 +1,77 @@
+import { readFile, writeFile, mkdir, access } from "node:fs/promises";
+import { dirname, join, normalize, relative, isAbsolute, sep } from "node:path";
+import { getProjectRoot } from "./paths.js";
+/**
+ * Validate that a requested path stays inside the allowed directory.
+ * Prevents path traversal (../../etc/passwd).
+ * Returns the resolved absolute path if safe, or throws.
+ */
+function validatePath(allowedRoot, requestedPath) {
+    if (isAbsolute(requestedPath)) {
+        throw new Error(`Path must be relative: ${requestedPath}`);
+    }
+    // Normalize removes ../ etc.
+    const normalized = normalize(requestedPath);
+    if (normalized.startsWith("..") || normalized.includes(`${sep}..`) || normalized.includes(`..${sep}`)) {
+        throw new Error(`Path traversal not allowed: ${requestedPath}`);
+    }
+    const resolved = join(allowedRoot, normalized);
+    const rel = relative(allowedRoot, resolved);
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new Error(`Path escapes allowed root: ${requestedPath}`);
+    }
+    return resolved;
+}
+/**
+ * Read a file from anywhere in the project's raw/ or wiki/ tree.
+ * Path is relative to project root.
+ * Allowed prefixes: "raw/", "wiki/"
+ */
+export async function readKnowledgeFile(projectId, path) {
+    const projectRoot = getProjectRoot(projectId);
+    const fullPath = validatePath(projectRoot, path);
+    // Only allow reading from raw/ or wiki/ subtrees
+    const rel = relative(projectRoot, fullPath);
+    const inRaw = rel.startsWith("raw/") || rel.startsWith("raw" + sep);
+    const inWiki = rel.startsWith("wiki/") || rel.startsWith("wiki" + sep);
+    if (!inRaw && !inWiki) {
+        throw new Error(`Read only allowed in raw/ or wiki/ subtrees: ${path}`);
+    }
+    return readFile(fullPath, "utf-8");
+}
+/**
+ * Write a file to the project's wiki/ tree.
+ * Path is relative to project root, MUST start with "wiki/".
+ * Creates parent directories as needed.
+ * Raw files can NOT be written via this tool — they come only from tool auto-save.
+ */
+export async function writeWikiFile(projectId, path, content) {
+    const projectRoot = getProjectRoot(projectId);
+    const fullPath = validatePath(projectRoot, path);
+    // Must be inside wiki/
+    const rel = relative(projectRoot, fullPath);
+    if (!rel.startsWith("wiki/") && !rel.startsWith("wiki" + sep)) {
+        throw new Error(`Writes only allowed in wiki/ subtree. Got: ${path}`);
+    }
+    if (!fullPath.endsWith(".md")) {
+        throw new Error(`Wiki files must have .md extension: ${path}`);
+    }
+    await mkdir(dirname(fullPath), { recursive: true });
+    await writeFile(fullPath, content, "utf-8");
+    return fullPath;
+}
+/**
+ * Check if a file exists in the project tree (raw/ or wiki/).
+ */
+export async function knowledgeFileExists(projectId, path) {
+    try {
+        const projectRoot = getProjectRoot(projectId);
+        const fullPath = validatePath(projectRoot, path);
+        await access(fullPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=wikiStore.js.map

package/dist/knowledge/wikiStore.js.map

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

package/dist/knowledge/yaml.d.ts

@@ -0,0 +1,17 @@
+export interface Frontmatter {
+    [key: string]: string | number | boolean | string[] | Date | Record<string, unknown> | null | undefined;
+}
+/**
+ * Parse YAML frontmatter from a markdown string.
+ * Returns { frontmatter, body } where body is the content after the frontmatter.
+ * If no frontmatter present, returns { frontmatter: {}, body: content }.
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: Frontmatter;
+    body: string;
+};
+/**
+ * Serialize a Frontmatter object + body into a markdown string with YAML frontmatter.
+ */
+export declare function stringifyFrontmatter(frontmatter: Frontmatter, body: string): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/knowledge/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/knowledge/yaml.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,IAAI,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,IAAI,GACJ,SAAS,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA;AA6DD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAuBR"}