caedora-mcp 0.2.0

package/dist/providers/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Trimmed VaultProvider interface for the MCP server. Mirrors
+ * `lib/types.ts` in the web app but only declares the subset the MCP
+ * actually needs (no diff/log helpers).
+ */
+export interface FileEntry {
+    path: string;
+    name: string;
+    type: 'file' | 'dir';
+    size?: number;
+    lastModified?: number;
+}
+export interface VaultProvider {
+    readonly type: 'local' | 'github';
+    readonly writesAreCommits: boolean;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    listFiles(dir?: string): Promise<FileEntry[]>;
+    renamePath(from: string, to: string): Promise<void>;
+    deletePath(path: string): Promise<void>;
+    commit(message: string, paths: string[]): Promise<string>;
+}
+/** Walks a provider and returns every file/dir underneath root. */
+export declare function listFilesRecursive(provider: VaultProvider): Promise<FileEntry[]>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,KAAK,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;IACjC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAElC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC7C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1D;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAYtF"}

package/dist/providers/types.js

@@ -0,0 +1,21 @@
+/**
+ * Trimmed VaultProvider interface for the MCP server. Mirrors
+ * `lib/types.ts` in the web app but only declares the subset the MCP
+ * actually needs (no diff/log helpers).
+ */
+/** Walks a provider and returns every file/dir underneath root. */
+export async function listFilesRecursive(provider) {
+    const out = [];
+    const queue = [''];
+    while (queue.length) {
+        const dir = queue.shift();
+        const entries = await provider.listFiles(dir);
+        for (const e of entries) {
+            out.push(e);
+            if (e.type === 'dir')
+                queue.push(e.path);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=types.js.map

package/dist/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAuB;IAC9D,MAAM,GAAG,GAAgB,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAa,CAAC,EAAE,CAAC,CAAA;IAC5B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAG,CAAA;QAC1B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC7C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACX,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { VaultProvider } from './providers/types.js';
+export interface BuildServerOptions {
+    provider: VaultProvider;
+    readOnly?: boolean;
+}
+export declare function buildServer({ provider, readOnly }: BuildServerOptions): McpServer;
+export type { VaultProvider } from './providers/types.js';
+export { LocalNodeProvider } from './providers/local-node.js';
+export { GitHubNodeProvider } from './providers/github.js';
+export { z };
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AA0CzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,QAAgB,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAiHzF;AAQD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,CAAC,EAAE,CAAA"}

package/dist/server.js

@@ -0,0 +1,43 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { grepConcepts, grepConceptsSchema, listConcepts, listConceptsSchema, readConcept, readConceptSchema, } from './tools/read.js';
+import { conceptGraph, conceptGraphSchema, conceptsByTag, conceptsByTagSchema, listTags, listTagsSchema, listTypes, listTypesSchema, searchConcepts, searchConceptsSchema, } from './tools/search.js';
+import { createConcept, createConceptSchema, deleteConcept, deleteConceptSchema, renameConcept, renameConceptSchema, updateConcept, updateConceptSchema, } from './tools/write.js';
+import { ingestSource, ingestSourceSchema, lintBundle, rebuildBundleIndexes, rebuildIndexesSchema, recordQuery, recordQuerySchema, validateBundleSchema, } from './tools/operations.js';
+export function buildServer({ provider, readOnly = false }) {
+    const server = new McpServer({
+        name: 'caedora-mcp',
+        version: '0.2.0',
+    });
+    server.tool('list_concepts', 'List OKF concepts with structured metadata, optionally filtered by directory or type.', listConceptsSchema, async (args) => textResult(await listConcepts(provider, args)));
+    server.tool('read_concept', 'Read one OKF concept and return its concept ID, metadata, body, and conformance state.', readConceptSchema, async (args) => textResult(await readConcept(provider, args)));
+    server.tool('search_concepts', 'Ranked search across concept metadata and Markdown bodies, with type and tag filters.', searchConceptsSchema, async (args) => textResult(await searchConcepts(provider, args)));
+    server.tool('grep_concepts', 'Run a regular expression across all concept documents.', grepConceptsSchema, async (args) => textResult(await grepConcepts(provider, args)));
+    server.tool('list_tags', 'List bundle tags and concept counts.', listTagsSchema, async () => textResult(await listTags(provider)));
+    server.tool('list_types', 'List concept types and usage counts.', listTypesSchema, async () => textResult(await listTypes(provider)));
+    server.tool('concepts_by_tag', 'List concepts carrying a normalized tag.', conceptsByTagSchema, async (args) => textResult(await conceptsByTag(provider, args)));
+    server.tool('concept_graph', 'Return outgoing links, external references, and backlinks for one concept or the full bundle.', conceptGraphSchema, async (args) => textResult(await conceptGraph(provider, args)));
+    server.tool('lint_bundle', 'Validate OKF v0.1 conformance and report invalid metadata, reserved files, and broken links.', validateBundleSchema, async (args) => textResult(await lintBundle(provider, {
+        ...args,
+        recordLint: readOnly ? false : args.recordLint,
+    })));
+    if (!readOnly) {
+        server.tool('create_concept', 'Create a conformant OKF concept and update bundle indexes and log.', createConceptSchema, async (args) => textResult(await createConcept(provider, args)));
+        server.tool('update_concept', 'Update a concept body or metadata while preserving producer-defined YAML fields.', updateConceptSchema, async (args) => textResult(await updateConcept(provider, args)));
+        server.tool('rename_concept', 'Move a concept to a new path-based concept ID, then rebuild indexes and log the move.', renameConceptSchema, async (args) => textResult(await renameConcept(provider, args)));
+        server.tool('delete_concept', 'Delete a concept or concept directory while protecting reserved OKF documents.', deleteConceptSchema, async (args) => textResult(await deleteConcept(provider, args)));
+        server.tool('ingest_source', 'Create a source concept with provenance metadata and record an ingest operation.', ingestSourceSchema, async (args) => textResult(await ingestSource(provider, args)));
+        server.tool('rebuild_indexes', 'Regenerate hierarchical index.md files for progressive disclosure.', rebuildIndexesSchema, async () => textResult(await rebuildBundleIndexes(provider)));
+        server.tool('record_query', 'Append a durable query or synthesis operation to the bundle log.', recordQuerySchema, async (args) => textResult(await recordQuery(provider, args)));
+    }
+    return server;
+}
+function textResult(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+}
+export { LocalNodeProvider } from './providers/local-node.js';
+export { GitHubNodeProvider } from './providers/github.js';
+export { z };
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/operations.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import type { VaultProvider } from '../providers/types.js';
+export declare const validateBundleSchema: {
+    recordLint: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function lintBundle(provider: VaultProvider, { recordLint }: {
+    recordLint?: boolean;
+}): Promise<{
+    version: string;
+    conformant: boolean;
+    concepts: number;
+    links: number;
+    brokenLinks: number;
+    issues: {
+        path: string;
+        severity: "error" | "warning";
+        code: string;
+        message: string;
+    }[];
+}>;
+export declare const rebuildIndexesSchema: {};
+export declare function rebuildBundleIndexes(provider: VaultProvider): Promise<{
+    updated: string[];
+}>;
+export declare const ingestSourceSchema: {
+    path: z.ZodString;
+    title: z.ZodString;
+    sourceType: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    resource: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    body: z.ZodString;
+};
+export declare function ingestSource(provider: VaultProvider, args: {
+    path: string;
+    title: string;
+    sourceType?: string;
+    description: string;
+    resource?: string;
+    tags?: string[];
+    body: string;
+}): Promise<{
+    id: string;
+    path: string;
+    created: boolean;
+    metadata: import("../lib/frontmatter.js").Frontmatter;
+}>;
+export declare const recordQuerySchema: {
+    summary: z.ZodString;
+    conceptPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare function recordQuery(provider: VaultProvider, { summary, conceptPaths }: {
+    summary: string;
+    conceptPaths?: string[];
+}): Promise<{
+    path: string;
+    action: string;
+    recorded: boolean;
+}>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/tools/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/tools/operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D,eAAO,MAAM,oBAAoB;;CAEhC,CAAA;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,aAAa,EACvB,EAAE,UAAkB,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;;;;;GAWjD;AAED,eAAO,MAAM,oBAAoB,IAAK,CAAA;AAEtC,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,aAAa;;GAEjE;AAED,eAAO,MAAM,kBAAkB;;;;;;;;CAQ9B,CAAA;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;;;;;GAaF;AAED,eAAO,MAAM,iBAAiB;;;CAG7B,CAAA;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,aAAa,EACvB,EAAE,OAAO,EAAE,YAAiB,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;;;;GAI7E"}

package/dist/tools/operations.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { appendLog, rebuildIndexes, validateBundle } from '../lib/okf.js';
+import { createConcept } from './write.js';
+export const validateBundleSchema = {
+    recordLint: z.boolean().optional().describe('Append the lint result to log.md. Defaults to false.'),
+};
+export async function lintBundle(provider, { recordLint = false }) {
+    const report = await validateBundle(provider);
+    if (recordLint) {
+        await appendLog(provider, 'Lint', `${report.conformant ? 'Passed' : 'Found issues'}: ${report.concepts} concepts, ${report.issues.length} issues, ${report.brokenLinks} broken links.`);
+    }
+    return report;
+}
+export const rebuildIndexesSchema = {};
+export async function rebuildBundleIndexes(provider) {
+    return rebuildIndexes(provider);
+}
+export const ingestSourceSchema = {
+    path: z.string().describe('Source concept path, normally under sources/, ending in .md.'),
+    title: z.string().describe('Source title.'),
+    sourceType: z.string().optional().describe('Concept type. Defaults to Source.'),
+    description: z.string().describe('One-sentence source summary.'),
+    resource: z.string().optional().describe('Canonical URI for the source.'),
+    tags: z.array(z.string()).optional(),
+    body: z.string().describe('Source notes, claims, quotations, and citations in Markdown.'),
+};
+export async function ingestSource(provider, args) {
+    const result = await createConcept(provider, {
+        path: args.path,
+        type: args.sourceType ?? 'Source',
+        title: args.title,
+        description: args.description,
+        resource: args.resource,
+        tags: ['source', ...(args.tags ?? [])],
+        body: args.body,
+    });
+    await appendLog(provider, 'Ingest', `Ingested [${args.title}](/${args.path}).`);
+    return result;
+}
+export const recordQuerySchema = {
+    summary: z.string().describe('Concise description of the query or durable synthesis produced.'),
+    conceptPaths: z.array(z.string()).optional().describe('Concept paths used or created.'),
+};
+export async function recordQuery(provider, { summary, conceptPaths = [] }) {
+    const links = conceptPaths.map((path) => `[${path.replace(/\.md$/i, '')}](/${path})`).join(', ');
+    return appendLog(provider, 'Query', links ? `${summary} Concepts: ${links}.` : summary);
+}
+//# sourceMappingURL=operations.js.map

package/dist/tools/operations.js.map

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

package/dist/tools/read.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { type VaultProvider } from '../providers/types.js';
+export declare const listConceptsSchema: {
+    folder: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+};
+export declare function listConcepts(provider: VaultProvider, { folder, type }: {
+    folder?: string;
+    type?: string;
+}): Promise<{
+    id: string;
+    path: string;
+    type: string;
+    title: string;
+    description: string;
+    tags: string[];
+    timestamp: string;
+    conformant: boolean;
+    size: number | undefined;
+    lastModified: number | undefined;
+}[]>;
+export declare const readConceptSchema: {
+    path: z.ZodString;
+};
+export declare function readConcept(provider: VaultProvider, { path }: {
+    path: string;
+}): Promise<{
+    id: string;
+    path: string;
+    metadata: import("../lib/frontmatter.js").Frontmatter;
+    body: string;
+    conformant: boolean;
+    parseError: string | null;
+}>;
+export declare const grepConceptsSchema: {
+    regex: z.ZodString;
+    flags: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function grepConcepts(provider: VaultProvider, { regex, flags, limit }: {
+    regex: string;
+    flags?: string;
+    limit?: number;
+}): Promise<{
+    path: string;
+    line: number;
+    text: string;
+}[]>;
+//# sourceMappingURL=read.d.ts.map

package/dist/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE9E,eAAO,MAAM,kBAAkB;;;CAG9B,CAAA;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;KAwBrD;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAA;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,aAAa,EACvB,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;GAa3B;AAED,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAA;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,EAAE,KAAK,EAAE,KAAW,EAAE,KAAW,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;UAI5D,MAAM;UAAQ,MAAM;UAAQ,MAAM;KAU7D"}

package/dist/tools/read.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { parseFrontmatter } from '../lib/frontmatter.js';
+import { conceptId, isConceptPath } from '../lib/okf.js';
+import { listFilesRecursive } from '../providers/types.js';
+export const listConceptsSchema = {
+    folder: z.string().optional().describe('Directory path relative to the bundle root.'),
+    type: z.string().optional().describe('Optional exact concept type filter.'),
+};
+export async function listConcepts(provider, { folder, type }) {
+    const entries = await listFilesRecursive(provider);
+    const concepts = [];
+    for (const entry of entries) {
+        if (entry.type !== 'file' || !isConceptPath(entry.path))
+            continue;
+        if (folder && entry.path !== folder && !entry.path.startsWith(`${folder}/`))
+            continue;
+        const raw = await provider.readFile(entry.path);
+        const parsed = parseFrontmatter(raw);
+        if (type && parsed.frontmatter.type !== type)
+            continue;
+        concepts.push({
+            id: conceptId(entry.path),
+            path: entry.path,
+            type: parsed.frontmatter.type || 'Unknown',
+            title: parsed.frontmatter.title,
+            description: parsed.frontmatter.description,
+            tags: parsed.frontmatter.tags,
+            timestamp: parsed.frontmatter.timestamp,
+            conformant: parsed.hasFrontmatter && !parsed.error && !!parsed.frontmatter.type.trim(),
+            size: entry.size,
+            lastModified: entry.lastModified,
+        });
+    }
+    return concepts;
+}
+export const readConceptSchema = {
+    path: z.string().describe('Concept path relative to the bundle root.'),
+};
+export async function readConcept(provider, { path }) {
+    if (!isConceptPath(path))
+        throw new Error(`${path} is not an OKF concept path.`);
+    const raw = await provider.readFile(path);
+    const parsed = parseFrontmatter(raw);
+    return {
+        id: conceptId(path),
+        path,
+        metadata: parsed.frontmatter,
+        body: parsed.body,
+        conformant: parsed.hasFrontmatter && !parsed.error && !!parsed.frontmatter.type.trim(),
+        parseError: parsed.error,
+    };
+}
+export const grepConceptsSchema = {
+    regex: z.string().describe('JavaScript regular expression to search for.'),
+    flags: z.string().optional().describe('Regex flags. Defaults to "i".'),
+    limit: z.number().int().positive().max(500).optional().describe('Maximum matches.'),
+};
+export async function grepConcepts(provider, { regex, flags = 'i', limit = 100 }) {
+    const re = new RegExp(regex, flags.includes('g') ? flags : `${flags}g`);
+    const entries = await listFilesRecursive(provider);
+    const hits = [];
+    for (const entry of entries.filter((item) => item.type === 'file' && isConceptPath(item.path))) {
+        const lines = (await provider.readFile(entry.path)).split(/\r?\n/);
+        for (let index = 0; index < lines.length && hits.length < limit; index++) {
+            if (re.test(lines[index]))
+                hits.push({ path: entry.path, line: index + 1, text: lines[index].trim() });
+            re.lastIndex = 0;
+        }
+        if (hits.length >= limit)
+            break;
+    }
+    return hits;
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/search.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import type { VaultProvider } from '../providers/types.js';
+export declare const searchConceptsSchema: {
+    query: z.ZodString;
+    tag: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function searchConcepts(provider: VaultProvider, { query, tag, type, limit, }: {
+    query: string;
+    tag?: string;
+    type?: string;
+    limit?: number;
+}): Promise<{
+    id: string;
+    path: string;
+    type: string;
+    title: string;
+    description: string;
+    tags: string[];
+    timestamp: string;
+    score: number;
+    snippet: string;
+}[]>;
+export declare const listTagsSchema: {};
+export declare function listTags(provider: VaultProvider): Promise<{
+    tag: string;
+    count: number;
+}[]>;
+export declare const listTypesSchema: {};
+export declare function listTypes(provider: VaultProvider): Promise<{
+    type: string;
+    count: number;
+}[]>;
+export declare const conceptsByTagSchema: {
+    tag: z.ZodString;
+};
+export declare function conceptsByTag(provider: VaultProvider, { tag }: {
+    tag: string;
+}): Promise<{
+    id: string;
+    path: string;
+    type: string;
+    title: string;
+    description: string;
+}[]>;
+export declare const conceptGraphSchema: {
+    path: z.ZodOptional<z.ZodString>;
+};
+export declare function conceptGraph(provider: VaultProvider, { path }: {
+    path?: string;
+}): Promise<{
+    id: string;
+    path: string;
+    title: string;
+    type: string;
+    outgoing: {
+        label: string;
+        href: string;
+        targetPath: string | null;
+        targetId: string | null;
+        external: boolean;
+    }[];
+    external: {
+        label: string;
+        href: string;
+        targetPath: string | null;
+        targetId: string | null;
+        external: boolean;
+    }[];
+    backlinks: {
+        id: string;
+        path: string;
+        title: string;
+    }[];
+}[]>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAA;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,aAAa,EACvB,EACE,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAU,GACX,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;KAmClE;AAED,eAAO,MAAM,cAAc,IAAK,CAAA;AAEhC,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,aAAa;;;KAMrD;AAED,eAAO,MAAM,eAAe,IAAK,CAAA;AAEjC,wBAAsB,SAAS,CAAC,QAAQ,EAAE,aAAa;;;KAMtD;AAED,eAAO,MAAM,mBAAmB;;CAE/B,CAAA;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE;;;;;;KAKpF;AAED,eAAO,MAAM,kBAAkB;;CAE9B,CAAA;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;KActF"}

package/dist/tools/search.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { normalizeTag, parseFrontmatter } from '../lib/frontmatter.js';
+import { buildConceptCatalog } from '../lib/okf.js';
+export const searchConceptsSchema = {
+    query: z.string().describe('Free-text query across structured metadata and Markdown bodies.'),
+    tag: z.string().optional().describe('Optional normalized tag filter.'),
+    type: z.string().optional().describe('Optional exact concept type filter.'),
+    limit: z.number().int().positive().max(100).optional().describe('Maximum results.'),
+};
+export async function searchConcepts(provider, { query, tag, type, limit = 20, }) {
+    const q = query.trim().toLowerCase();
+    const tagFilter = tag ? normalizeTag(tag) : null;
+    const catalog = await buildConceptCatalog(provider);
+    const hits = [];
+    for (const concept of catalog) {
+        if (tagFilter && !concept.tags.includes(tagFilter))
+            continue;
+        if (type && concept.type !== type)
+            continue;
+        const raw = await provider.readFile(concept.path);
+        const body = parseFrontmatter(raw).body;
+        const metadataText = [
+            concept.title,
+            concept.description,
+            concept.type,
+            concept.resource,
+            concept.tags.join(' '),
+        ].join(' ').toLowerCase();
+        const metadataMatches = q ? countMatches(metadataText, q) : 0;
+        const bodyMatches = q ? countMatches(body.toLowerCase(), q) : 0;
+        const score = metadataMatches * 5 + bodyMatches;
+        if (q && score === 0)
+            continue;
+        hits.push({
+            id: concept.id,
+            path: concept.path,
+            type: concept.type,
+            title: concept.title,
+            description: concept.description,
+            tags: concept.tags,
+            timestamp: concept.timestamp,
+            score,
+            snippet: snippetAround(body, q),
+        });
+    }
+    return hits.sort((a, b) => b.score - a.score).slice(0, limit);
+}
+export const listTagsSchema = {};
+export async function listTags(provider) {
+    const counts = new Map();
+    for (const concept of await buildConceptCatalog(provider)) {
+        for (const tag of concept.tags)
+            counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+    return [...counts].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count - a.count);
+}
+export const listTypesSchema = {};
+export async function listTypes(provider) {
+    const counts = new Map();
+    for (const concept of await buildConceptCatalog(provider)) {
+        counts.set(concept.type, (counts.get(concept.type) ?? 0) + 1);
+    }
+    return [...counts].map(([type, count]) => ({ type, count })).sort((a, b) => b.count - a.count);
+}
+export const conceptsByTagSchema = {
+    tag: z.string().describe('Tag to filter by.'),
+};
+export async function conceptsByTag(provider, { tag }) {
+    const target = normalizeTag(tag);
+    return (await buildConceptCatalog(provider))
+        .filter((concept) => concept.tags.includes(target))
+        .map(({ id, path, type, title, description }) => ({ id, path, type, title, description }));
+}
+export const conceptGraphSchema = {
+    path: z.string().optional().describe('Optional concept path to focus on.'),
+};
+export async function conceptGraph(provider, { path }) {
+    const concepts = await buildConceptCatalog(provider);
+    const nodes = path ? concepts.filter((concept) => concept.path === path) : concepts;
+    return nodes.map((concept) => ({
+        id: concept.id,
+        path: concept.path,
+        title: concept.title,
+        type: concept.type,
+        outgoing: concept.links.filter((link) => !link.external),
+        external: concept.links.filter((link) => link.external),
+        backlinks: concepts
+            .filter((candidate) => candidate.links.some((link) => link.targetPath === concept.path))
+            .map(({ id, path: sourcePath, title }) => ({ id, path: sourcePath, title })),
+    }));
+}
+function countMatches(text, query) {
+    if (!query)
+        return 0;
+    return text.split(query).length - 1;
+}
+function snippetAround(body, query, radius = 80) {
+    if (!query)
+        return body.slice(0, 160).trim();
+    const index = body.toLowerCase().indexOf(query);
+    if (index < 0)
+        return body.slice(0, 160).trim();
+    const start = Math.max(0, index - radius);
+    const end = Math.min(body.length, index + query.length + radius);
+    return `${start > 0 ? '... ' : ''}${body.slice(start, end).replace(/\s+/g, ' ').trim()}${end < body.length ? ' ...' : ''}`;
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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