caedora-mcp 0.2.0

package/README.md

@@ -0,0 +1,71 @@
+# caedora-mcp
+
+An MCP server for reading, searching, validating, and maintaining Open Knowledge
+Format bundles. It exposes structured concept metadata, cross-links, backlinks,
+source ingestion, progressive indexes, and bundle logs to MCP-aware agents.
+
+## Run
+
+```bash
+npx caedora-mcp --bundle /path/to/knowledge-bundle
+```
+
+The legacy `--vault` flag remains an alias for `--bundle`.
+
+For GitHub-hosted bundles:
+
+```bash
+GITHUB_TOKEN=github_pat_xxx npx caedora-mcp --github owner/repository
+```
+
+Add `--read-only` to disable all write tools.
+
+## Connect an MCP client
+
+The server speaks stdio, so any MCP-aware client uses the same config block:
+
+```json
+{
+  "mcpServers": {
+    "caedora": {
+      "command": "npx",
+      "args": ["-y", "caedora-mcp", "--bundle", "/absolute/path/to/your-vault"]
+    }
+  }
+}
+```
+
+Config file locations:
+
+- **Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json`
+  (macOS) / `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+- **Cursor** — `~/.cursor/mcp.json`
+- **Gemini CLI** — `~/.gemini/settings.json`
+- **Claude Code** — already has file tools; run `claude` from the vault folder, and
+  optionally add this server for indexed search, graph traversal, and conformant writes.
+
+## Read tools
+
+- `list_concepts(folder?, type?)`
+- `read_concept(path)`
+- `search_concepts(query, tag?, type?, limit?)`
+- `grep_concepts(regex, flags?, limit?)`
+- `list_tags()`
+- `list_types()`
+- `concepts_by_tag(tag)`
+- `concept_graph(path?)`
+- `lint_bundle(recordLint?)`
+
+## Write tools
+
+- `create_concept(...)`
+- `update_concept(...)`
+- `rename_concept(from, to)`
+- `delete_concept(path)`
+- `ingest_source(...)`
+- `rebuild_indexes()`
+- `record_query(summary, conceptPaths?)`
+
+Every mutation preserves producer-defined YAML fields, maintains timestamps,
+regenerates hierarchical indexes, and records significant operations in
+`log.md`. Reserved `index.md` and `log.md` documents are protected.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import path from 'node:path';
+import { buildServer } from './server.js';
+import { LocalNodeProvider } from './providers/local-node.js';
+import { GitHubNodeProvider } from './providers/github.js';
+function parseArgs(argv) {
+    const out = { readOnly: false, help: false };
+    for (let index = 0; index < argv.length; index++) {
+        switch (argv[index]) {
+            case '--bundle':
+            case '--vault':
+                out.bundle = argv[++index];
+                break;
+            case '--github':
+                out.github = argv[++index];
+                break;
+            case '--pat':
+                out.pat = argv[++index];
+                break;
+            case '--read-only':
+                out.readOnly = true;
+                break;
+            case '-h':
+            case '--help':
+                out.help = true;
+                break;
+            default:
+                if (argv[index].startsWith('--')) {
+                    console.error(`Unknown flag: ${argv[index]}`);
+                    process.exit(2);
+                }
+        }
+    }
+    return out;
+}
+function printHelp() {
+    console.error(`caedora-mcp - MCP server for OKF knowledge bundles
+
+Usage:
+  caedora-mcp --bundle <path>
+  caedora-mcp --github <owner>/<repo> --pat <token>
+  caedora-mcp --bundle <path> --read-only
+
+Options:
+  --bundle <path>      Serve a local OKF bundle.
+  --vault <path>       Legacy alias for --bundle.
+  --github owner/repo  Serve a GitHub-hosted OKF bundle.
+  --pat <token>        GitHub personal access token. Falls back to GITHUB_TOKEN.
+  --read-only          Disable all write tools.
+  -h, --help           Show this help.
+
+The server speaks stdio. Example MCP configuration:
+
+  {
+    "mcpServers": {
+      "caedora": {
+        "command": "npx",
+        "args": ["-y", "caedora-mcp", "--bundle", "/path/to/bundle"]
+      }
+    }
+  }
+`);
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        printHelp();
+        process.exit(0);
+    }
+    let provider;
+    if (args.bundle) {
+        provider = new LocalNodeProvider(path.resolve(args.bundle));
+    }
+    else if (args.github) {
+        const [owner, repo] = args.github.split('/');
+        if (!owner || !repo) {
+            console.error('--github must be in the form owner/repo');
+            process.exit(2);
+        }
+        const token = args.pat ?? process.env.GITHUB_TOKEN;
+        if (!token) {
+            console.error('Missing --pat (or GITHUB_TOKEN) for --github mode');
+            process.exit(2);
+        }
+        provider = new GitHubNodeProvider(token, owner, repo);
+    }
+    else {
+        console.error('Must provide either --bundle <path> or --github owner/repo');
+        printHelp();
+        process.exit(2);
+    }
+    const server = buildServer({ provider, readOnly: args.readOnly });
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    console.error(`caedora-mcp: fatal error - ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/lib/conventions.d.ts

@@ -0,0 +1,3 @@
+export declare function stemFromPath(path: string): string;
+export declare function titleFromPath(path: string): string;
+//# sourceMappingURL=conventions.d.ts.map

package/dist/lib/conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.d.ts","sourceRoot":"","sources":["../../src/lib/conventions.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/lib/conventions.js

@@ -0,0 +1,12 @@
+export function stemFromPath(path) {
+    const name = path.split('/').pop() ?? path;
+    return name.replace(/\.md$/i, '');
+}
+export function titleFromPath(path) {
+    return stemFromPath(path)
+        .split(/[-_]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=conventions.js.map

package/dist/lib/conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.js","sourceRoot":"","sources":["../../src/lib/conventions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAA;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC;SACtB,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC"}

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,23 @@
+export interface Frontmatter {
+    type: string;
+    title: string;
+    description: string;
+    resource: string;
+    tags: string[];
+    timestamp: string;
+    extra: Record<string, unknown>;
+}
+export declare function emptyFrontmatter(overrides?: Partial<Frontmatter>): Frontmatter;
+export declare function parseFrontmatter(markdown: string): {
+    frontmatter: Frontmatter;
+    body: string;
+    hasFrontmatter: boolean;
+    error: string | null;
+};
+export declare function serializeFrontmatter(frontmatter: Frontmatter): string;
+export declare function combine(frontmatter: Frontmatter, body: string): string;
+export declare function createConceptFrontmatter(title: string, type: string, overrides?: Partial<Frontmatter>): Frontmatter;
+export declare function normalizeTag(raw: string): string;
+export declare function uniqueTags(tags: string[]): string[];
+export declare function slugifyFilename(raw: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAYD,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAWlF;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM;;;;WAO5B,MAAM,GAAG,IAAI;EAwCjC;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAarE;AAED,wBAAgB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,WAAW,CASb;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASnD"}

package/dist/lib/frontmatter.js

@@ -0,0 +1,139 @@
+import { parseDocument, stringify } from 'yaml';
+const FENCE = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*\r?\n?/;
+const STANDARD_KEYS = new Set([
+    'type',
+    'title',
+    'description',
+    'resource',
+    'tags',
+    'timestamp',
+]);
+export function emptyFrontmatter(overrides = {}) {
+    return {
+        type: '',
+        title: '',
+        description: '',
+        resource: '',
+        tags: [],
+        timestamp: '',
+        extra: {},
+        ...overrides,
+    };
+}
+export function parseFrontmatter(markdown) {
+    const match = markdown.match(FENCE);
+    if (!match) {
+        return {
+            frontmatter: emptyFrontmatter(),
+            body: markdown,
+            hasFrontmatter: false,
+            error: null,
+        };
+    }
+    try {
+        const document = parseDocument(match[1], { prettyErrors: false, uniqueKeys: false });
+        if (document.errors.length > 0)
+            throw new Error(document.errors[0].message);
+        const value = document.toJS();
+        if (!isRecord(value))
+            throw new Error('YAML frontmatter must be a mapping.');
+        const extra = {};
+        for (const [key, fieldValue] of Object.entries(value)) {
+            if (!STANDARD_KEYS.has(key))
+                extra[key] = fieldValue;
+        }
+        return {
+            frontmatter: {
+                type: stringValue(value.type),
+                title: stringValue(value.title),
+                description: stringValue(value.description),
+                resource: stringValue(value.resource),
+                tags: uniqueTags(Array.isArray(value.tags)
+                    ? value.tags.filter((item) => typeof item === 'string')
+                    : typeof value.tags === 'string'
+                        ? value.tags.split(/[\s,]+/)
+                        : []),
+                timestamp: stringValue(value.timestamp),
+                extra,
+            },
+            body: markdown.slice(match[0].length),
+            hasFrontmatter: true,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            frontmatter: emptyFrontmatter(),
+            body: markdown.slice(match[0].length),
+            hasFrontmatter: true,
+            error: error instanceof Error ? error.message : 'Invalid YAML frontmatter.',
+        };
+    }
+}
+export function serializeFrontmatter(frontmatter) {
+    const data = {};
+    if (frontmatter.type.trim())
+        data.type = frontmatter.type.trim();
+    if (frontmatter.title.trim())
+        data.title = frontmatter.title.trim();
+    if (frontmatter.description.trim())
+        data.description = frontmatter.description.trim();
+    if (frontmatter.resource.trim())
+        data.resource = frontmatter.resource.trim();
+    if (frontmatter.tags.length > 0)
+        data.tags = uniqueTags(frontmatter.tags);
+    if (frontmatter.timestamp.trim())
+        data.timestamp = frontmatter.timestamp.trim();
+    for (const [key, value] of Object.entries(frontmatter.extra)) {
+        if (!STANDARD_KEYS.has(key) && value !== undefined)
+            data[key] = value;
+    }
+    if (Object.keys(data).length === 0)
+        return '';
+    return `---\n${stringify(data, { lineWidth: 0 }).trimEnd()}\n---\n`;
+}
+export function combine(frontmatter, body) {
+    return `${serializeFrontmatter(frontmatter)}\n${body.replace(/^\n+/, '')}`;
+}
+export function createConceptFrontmatter(title, type, overrides = {}) {
+    return emptyFrontmatter({
+        type: type.trim(),
+        title: title.trim(),
+        timestamp: new Date().toISOString(),
+        ...overrides,
+        tags: uniqueTags(overrides.tags ?? []),
+        extra: overrides.extra ?? {},
+    });
+}
+export function normalizeTag(raw) {
+    return raw
+        .trim()
+        .replace(/^#/, '')
+        .replace(/\s+/g, '-')
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, '');
+}
+export function uniqueTags(tags) {
+    return [...new Set(tags.map(normalizeTag).filter(Boolean))];
+}
+export function slugifyFilename(raw) {
+    const stem = raw.replace(/\.md$/i, '');
+    return stem
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .replace(/['"]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'untitled';
+}
+function stringValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (value instanceof Date)
+        return value.toISOString();
+    return typeof value === 'string' ? value : String(value);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/lib/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAY/C,MAAM,KAAK,GAAG,+CAA+C,CAAA;AAC7D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,MAAM;IACN,OAAO;IACP,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;CACZ,CAAC,CAAA;AAEF,MAAM,UAAU,gBAAgB,CAAC,YAAkC,EAAE;IACnE,OAAO;QACL,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,EAAE;QACZ,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,WAAW,EAAE,gBAAgB,EAAE;YAC/B,IAAI,EAAE,QAAQ;YACd,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,IAAqB;SAC7B,CAAA;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;QACpF,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAa,CAAA;QACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QAE5E,MAAM,KAAK,GAA4B,EAAE,CAAA;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAA;QACtD,CAAC;QAED,OAAO;YACL,WAAW,EAAE;gBACX,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC7B,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC/B,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;gBAC3C,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC;gBACrC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;oBACxC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;oBACvE,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;wBAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;wBAC5B,CAAC,CAAC,EAAE,CAAC;gBACT,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;gBACvC,KAAK;aACN;YACD,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,cAAc,EAAE,IAAI;YACpB,KAAK,EAAE,IAAqB;SAC7B,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,WAAW,EAAE,gBAAgB,EAAE;YAC/B,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACrC,cAAc,EAAE,IAAI;YACpB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;SAC5E,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,MAAM,IAAI,GAA4B,EAAE,CAAA;IACxC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IAChE,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;IACnE,IAAI,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;IACrF,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC5E,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IACzE,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;IAC/E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACvE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7C,OAAO,QAAQ,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,WAAwB,EAAE,IAAY;IAC5D,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAA;AAC5E,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,IAAY,EACZ,YAAkC,EAAE;IAEpC,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,SAAS;QACZ,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC;QACtC,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,EAAE;KAC7B,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,IAAI,EAAE;SACN,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;SACjB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAc;IACvC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACtC,OAAO,IAAI;SACR,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,CAAA;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACpD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAA;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC"}

package/dist/lib/okf.d.ts

@@ -0,0 +1,55 @@
+import { type VaultProvider } from '../providers/types.js';
+export declare const OKF_VERSION = "0.1";
+export declare const INDEX_FILENAME = "index.md";
+export declare const LOG_FILENAME = "log.md";
+export declare function isReservedPath(path: string): boolean;
+export declare function isConceptPath(path: string): boolean;
+export declare function conceptId(path: string): string;
+export declare function extractLinks(markdown: string, sourcePath: string): {
+    label: string;
+    href: string;
+    targetPath: string | null;
+    targetId: string | null;
+    external: boolean;
+}[];
+export declare function resolveBundleLink(sourcePath: string, href: string): string | null;
+export declare function validateBundle(provider: VaultProvider): Promise<{
+    version: string;
+    conformant: boolean;
+    concepts: number;
+    links: number;
+    brokenLinks: number;
+    issues: {
+        path: string;
+        severity: "error" | "warning";
+        code: string;
+        message: string;
+    }[];
+}>;
+export declare function buildConceptCatalog(provider: VaultProvider): Promise<{
+    id: string;
+    path: string;
+    type: string;
+    title: string;
+    description: string;
+    resource: string;
+    tags: string[];
+    timestamp: string;
+    links: {
+        label: string;
+        href: string;
+        targetPath: string | null;
+        targetId: string | null;
+        external: boolean;
+    }[];
+    conformant: boolean;
+}[]>;
+export declare function rebuildIndexes(provider: VaultProvider): Promise<{
+    updated: string[];
+}>;
+export declare function appendLog(provider: VaultProvider, action: string, message: string): Promise<{
+    path: string;
+    action: string;
+    recorded: boolean;
+}>;
+//# sourceMappingURL=okf.d.ts.map

package/dist/lib/okf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf.d.ts","sourceRoot":"","sources":["../../src/lib/okf.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE9F,eAAO,MAAM,WAAW,QAAQ,CAAA;AAChC,eAAO,MAAM,cAAc,aAAa,CAAA;AACxC,eAAO,MAAM,YAAY,WAAW,CAAA;AAEpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;WAGtD,MAAM;UACP,MAAM;gBACA,MAAM,GAAG,IAAI;cACf,MAAM,GAAG,IAAI;cACb,OAAO;IAcpB;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjF;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa;;;;;;;cAI9B,MAAM;kBAAY,OAAO,GAAG,SAAS;cAAQ,MAAM;iBAAW,MAAM;;GA4CjG;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,aAAa;;;;;;;;;;eAjFtD,MAAM;cACP,MAAM;oBACA,MAAM,GAAG,IAAI;kBACf,MAAM,GAAG,IAAI;kBACb,OAAO;;;KAiGpB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,aAAa;;GAiB3D;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;;;;GAmBhB"}