@monoes/monograph 1.1.0 → 1.2.1

package/dist/src/mcp-tools/rename.js.map

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

package/dist/src/mcp-tools/route-map.d.ts

@@ -0,0 +1,21 @@
+import type Database from 'better-sqlite3';
+export interface RouteMapEntry {
+    method: string;
+    path: string;
+    handlerName: string | null;
+    handlerFile: string | null;
+    handlerLine: number | null;
+    routeNodeId: string;
+    middlewareChain: string[];
+}
+export interface MonographRouteMapResult {
+    routes: RouteMapEntry[];
+    total: number;
+}
+export declare function getMonographRouteMap(db: Database.Database, input: {
+    prefix?: string;
+    method?: string;
+    includeMiddleware?: boolean;
+    repoPath?: string;
+}): MonographRouteMapResult;
+//# sourceMappingURL=route-map.d.ts.map

package/dist/src/mcp-tools/route-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-map.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/route-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1F,uBAAuB,CAqEzB"}

package/dist/src/mcp-tools/route-map.js

@@ -0,0 +1,62 @@
+import { readFileSync, statSync } from 'fs';
+import { extractMiddlewareChain } from '../pipeline/phases/middleware-extractor.js';
+const MAX_FILE_BYTES = 1_048_576; // 1 MiB guard for middleware source reads
+// ── Implementation ─────────────────────────────────────────────────────────────
+export function getMonographRouteMap(db, input) {
+    // 1. Build SQL-level filters to avoid loading the whole Route table into JS
+    const conditions = ["label = 'Route'"];
+    const params = [];
+    if (input.prefix) {
+        // Route name format: "METHOD /path" — prefix applies to path portion after first space
+        conditions.push("name LIKE ?");
+        params.push(`% ${input.prefix}%`);
+    }
+    if (input.method) {
+        const methodUpper = input.method.toUpperCase();
+        conditions.push("(name LIKE ? OR name LIKE ?)");
+        params.push(`${methodUpper} %`, 'ANY %');
+    }
+    const sql = `SELECT * FROM nodes WHERE ${conditions.join(' AND ')}`;
+    const routeRows = db.prepare(sql).all(...params);
+    // 2. For each route, find handler via HANDLES_ROUTE edge (prepared once)
+    const handlerStmt = db.prepare(`SELECT n.name, n.file_path, n.start_line FROM nodes n
+     JOIN edges e ON n.id = e.target_id
+     WHERE e.source_id = ? AND e.relation = 'HANDLES_ROUTE'
+     LIMIT 1`);
+    const routes = routeRows.map((row) => {
+        const routeNodeId = row.id;
+        const name = row.name;
+        // Parse method and path from name (format: "METHOD /path")
+        const spaceIdx = name.indexOf(' ');
+        const method = spaceIdx >= 0 ? name.slice(0, spaceIdx) : 'ANY';
+        const path = spaceIdx >= 0 ? name.slice(spaceIdx + 1) : name;
+        // Look up handler
+        const handlerRow = handlerStmt.get(routeNodeId);
+        // Detect middleware chain at query time when requested
+        let middlewareChain = [];
+        if (input.includeMiddleware && input.repoPath && handlerRow?.name && handlerRow?.file_path) {
+            try {
+                const absPath = `${input.repoPath}/${handlerRow.file_path}`;
+                const st = statSync(absPath);
+                if (st.size <= MAX_FILE_BYTES) {
+                    const source = readFileSync(absPath, 'utf-8');
+                    middlewareChain = extractMiddlewareChain(source, handlerRow.name).middlewareNames;
+                }
+            }
+            catch {
+                // File not found, unreadable, or too large — leave middlewareChain as []
+            }
+        }
+        return {
+            method,
+            path,
+            handlerName: handlerRow?.name ?? null,
+            handlerFile: handlerRow?.file_path ?? null,
+            handlerLine: handlerRow?.start_line ?? null,
+            routeNodeId,
+            middlewareChain,
+        };
+    });
+    return { routes, total: routes.length };
+}
+//# sourceMappingURL=route-map.js.map

package/dist/src/mcp-tools/route-map.js.map

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

package/dist/src/mcp-tools/serve.d.ts

@@ -0,0 +1,16 @@
+import type Database from 'better-sqlite3';
+export interface ServeOptions {
+    port?: number;
+    open?: boolean;
+    db: Database.Database;
+}
+export interface ServeResult {
+    url: string;
+    status: 'started' | 'already_running';
+}
+/**
+ * Start the Monograph web UI server.
+ * If the server is already running, returns the existing URL.
+ */
+export declare function serveMonograph(options: ServeOptions): Promise<ServeResult>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/src/mcp-tools/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBhF"}

package/dist/src/mcp-tools/serve.js

@@ -0,0 +1,25 @@
+import { startServer, isServerRunning, getActiveUrl } from '../web/server.js';
+/**
+ * Start the Monograph web UI server.
+ * If the server is already running, returns the existing URL.
+ */
+export async function serveMonograph(options) {
+    const { port = 7374, open = false, db } = options;
+    if (isServerRunning()) {
+        const url = getActiveUrl() ?? `http://localhost:${port}`;
+        return { url, status: 'already_running' };
+    }
+    const handle = await startServer({ port, db });
+    if (open) {
+        // Use spawn with an argument array to avoid shell injection via URL characters
+        const { spawn } = await import('child_process');
+        const [bin, ...args] = process.platform === 'win32'
+            ? ['cmd', '/c', 'start', '', handle.url]
+            : process.platform === 'darwin'
+                ? ['open', handle.url]
+                : ['xdg-open', handle.url];
+        spawn(bin, args, { stdio: 'ignore', detached: true }).unref();
+    }
+    return { url: handle.url, status: 'started' };
+}
+//# sourceMappingURL=serve.js.map

package/dist/src/mcp-tools/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/mcp-tools/serve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAa9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAqB;IACxD,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;IAElD,IAAI,eAAe,EAAE,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,YAAY,EAAE,IAAI,oBAAoB,IAAI,EAAE,CAAC;QACzD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAE/C,IAAI,IAAI,EAAE,CAAC;QACT,+EAA+E;QAC/E,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;YACjD,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ;gBAC7B,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;gBACtB,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,KAAK,CAAC,GAAa,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAChD,CAAC"}

package/dist/src/mcp-tools/shape-check.d.ts

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+import { type RouteShape } from '../analysis/shape-extractor.js';
+export interface ShapeCheckResult {
+    route: {
+        path: string;
+        method: string;
+        handlerName: string;
+        handlerFile: string;
+    } | null;
+    shape: RouteShape;
+    consumers: {
+        name: string;
+        filePath: string;
+    }[];
+    message: string;
+}
+/**
+ * Check whether the JSON shape returned by a route handler matches what its
+ * consumers actually access.
+ *
+ * @param db        - Open monograph SQLite database
+ * @param repoPath  - Absolute path to repository root (used to resolve file_path)
+ * @param options   - `route` searches by route name/path substring;
+ *                    `file` searches by exact file_path of the Route node
+ */
+export declare function getShapeCheck(db: Database.Database, repoPath: string, options: {
+    route?: string;
+    file?: string;
+}): ShapeCheckResult;
+//# sourceMappingURL=shape-check.d.ts.map

package/dist/src/mcp-tools/shape-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-check.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/shape-check.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,gCAAgC,CAAC;AAIxC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI,CAAC;IACT,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,gBAAgB,CAgIlB"}

package/dist/src/mcp-tools/shape-check.js

@@ -0,0 +1,138 @@
+import { readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { extractHandlerReturnKeys, extractAccessedKeys, compareShapes, } from '../analysis/shape-extractor.js';
+// ── Internal helpers ───────────────────────────────────────────────────────────
+const MAX_FILE_BYTES = 1_048_576; // 1 MiB guard
+function safeReadFile(absPath) {
+    try {
+        const st = statSync(absPath);
+        if (st.size > MAX_FILE_BYTES)
+            return '';
+        return readFileSync(absPath, 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+// ── Implementation ─────────────────────────────────────────────────────────────
+/**
+ * Check whether the JSON shape returned by a route handler matches what its
+ * consumers actually access.
+ *
+ * @param db        - Open monograph SQLite database
+ * @param repoPath  - Absolute path to repository root (used to resolve file_path)
+ * @param options   - `route` searches by route name/path substring;
+ *                    `file` searches by exact file_path of the Route node
+ */
+export function getShapeCheck(db, repoPath, options) {
+    const UNKNOWN_SHAPE = {
+        returnedKeys: [],
+        accessedKeys: [],
+        mismatches: [],
+        extra: [],
+        status: 'UNKNOWN',
+    };
+    // 1. Find the Route node
+    let routeRow;
+    if (options.file) {
+        routeRow = db
+            .prepare("SELECT * FROM nodes WHERE label = 'Route' AND file_path = ? LIMIT 1")
+            .get(options.file);
+    }
+    else if (options.route) {
+        // Search by name substring (name is like "GET /api/users") using SQL LIKE to avoid full scan
+        // The route path follows the first space, so we match anywhere after it via a LIKE pattern.
+        const likeTerm = `% ${options.route.toLowerCase()}%`;
+        routeRow = db
+            .prepare("SELECT * FROM nodes WHERE label = 'Route' AND lower(name) LIKE ? LIMIT 1")
+            .get(likeTerm);
+        // Fallback: match anywhere in the name (e.g. no space prefix)
+        if (!routeRow) {
+            routeRow = db
+                .prepare("SELECT * FROM nodes WHERE label = 'Route' AND lower(name) LIKE ? LIMIT 1")
+                .get(`%${options.route.toLowerCase()}%`);
+        }
+    }
+    if (!routeRow) {
+        return {
+            route: null,
+            shape: UNKNOWN_SHAPE,
+            consumers: [],
+            message: 'Route not found',
+        };
+    }
+    const routeId = routeRow.id;
+    const routeName = routeRow.name;
+    const spaceIdx = routeName.indexOf(' ');
+    const method = spaceIdx >= 0 ? routeName.slice(0, spaceIdx) : 'ANY';
+    const routePath = spaceIdx >= 0 ? routeName.slice(spaceIdx + 1) : routeName;
+    // 2. Follow HANDLES_ROUTE edge to find the handler function node
+    const handlerRow = db
+        .prepare(`SELECT n.id, n.name, n.file_path FROM nodes n
+       JOIN edges e ON n.id = e.target_id
+       WHERE e.source_id = ? AND e.relation = 'HANDLES_ROUTE'
+       LIMIT 1`)
+        .get(routeId);
+    if (!handlerRow || !handlerRow.file_path) {
+        return {
+            route: {
+                path: routePath,
+                method,
+                handlerName: handlerRow?.name ?? '',
+                handlerFile: handlerRow?.file_path ?? '',
+            },
+            shape: UNKNOWN_SHAPE,
+            consumers: [],
+            message: 'Handler not found or has no source file',
+        };
+    }
+    // 3. Read handler source and extract return keys
+    const handlerAbsPath = join(repoPath, handlerRow.file_path);
+    const handlerSource = safeReadFile(handlerAbsPath);
+    const returnedKeys = extractHandlerReturnKeys(handlerSource);
+    // 4. Find consumers: functions that CALLS or FETCHES the handler node,
+    //    or that FETCHES the Route node directly
+    const consumerRows = db
+        .prepare(`SELECT DISTINCT n.id, n.name, n.file_path FROM nodes n
+       JOIN edges e ON n.id = e.source_id
+       WHERE (
+         (e.target_id = ? AND (e.relation = 'CALLS' OR e.relation = 'FETCHES'))
+         OR
+         (e.target_id = ? AND e.relation = 'FETCHES')
+       )
+       AND n.file_path IS NOT NULL`)
+        .all(handlerRow.id, routeId);
+    // 5. Extract accessed keys from each consumer's source
+    const allAccessedKeys = new Set();
+    for (const consumer of consumerRows) {
+        const consumerAbsPath = join(repoPath, consumer.file_path);
+        const consumerSource = safeReadFile(consumerAbsPath);
+        const accessed = extractAccessedKeys(consumerSource);
+        for (const k of accessed)
+            allAccessedKeys.add(k);
+    }
+    // 6. Compare shapes
+    const accessedKeys = Array.from(allAccessedKeys).sort();
+    const shape = compareShapes(returnedKeys, accessedKeys);
+    const consumers = consumerRows.map((c) => ({
+        name: c.name,
+        filePath: c.file_path,
+    }));
+    const statusMsg = shape.status === 'MATCH'
+        ? 'Shape matches: all accessed keys are returned by handler'
+        : shape.status === 'MISMATCH'
+            ? `Shape mismatch: ${shape.mismatches.join(', ')} accessed but not returned`
+            : 'Shape unknown: insufficient source information';
+    return {
+        route: {
+            path: routePath,
+            method,
+            handlerName: handlerRow.name,
+            handlerFile: handlerRow.file_path,
+        },
+        shape,
+        consumers,
+        message: statusMsg,
+    };
+}
+//# sourceMappingURL=shape-check.js.map

package/dist/src/mcp-tools/shape-check.js.map

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

package/dist/src/mcp-tools/staleness.d.ts

@@ -0,0 +1,3 @@
+import { type StalenessReport } from '../staleness/git-staleness.js';
+export declare function getMonographStaleness(repoPath: string): Promise<StalenessReport>;
+//# sourceMappingURL=staleness.d.ts.map

package/dist/src/mcp-tools/staleness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/staleness.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErF,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAStF"}

package/dist/src/mcp-tools/staleness.js

@@ -0,0 +1,14 @@
+import { openDb } from '../storage/db.js';
+import { checkStaleness } from '../staleness/git-staleness.js';
+export async function getMonographStaleness(repoPath) {
+    const { join } = await import('path');
+    const dbPath = join(repoPath, '.monomind', 'monograph.db');
+    const db = openDb(dbPath);
+    try {
+        return checkStaleness(db, repoPath);
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=staleness.js.map

package/dist/src/mcp-tools/staleness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staleness.js","sourceRoot":"","sources":["../../../src/mcp-tools/staleness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAwB,MAAM,+BAA+B,CAAC;AAErF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/src/mcp-tools/tool-map.d.ts

@@ -0,0 +1,14 @@
+import type Database from 'better-sqlite3';
+export interface ToolEntry {
+    id: string;
+    name: string;
+    description: string | null;
+    filePath: string | null;
+    handlerName: string | null;
+    handlerFile: string | null;
+    handlerLine: number | null;
+}
+export declare function getToolMap(db: Database.Database, options?: {
+    tool?: string;
+}): ToolEntry[];
+//# sourceMappingURL=tool-map.d.ts.map

package/dist/src/mcp-tools/tool-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/tool-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAI3C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAID,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,SAAS,EAAE,CA8Cb"}

package/dist/src/mcp-tools/tool-map.js

@@ -0,0 +1,37 @@
+// ── Implementation ─────────────────────────────────────────────────────────────
+export function getToolMap(db, options) {
+    const toolFilter = options?.tool ?? null;
+    const rows = db
+        .prepare(`SELECT t.id, t.name, t.properties, t.file_path,
+              h.name as handler_name, h.file_path as handler_file, h.start_line as handler_line
+       FROM nodes t
+       LEFT JOIN edges e ON e.source_id = t.id AND e.relation = 'HANDLES_TOOL'
+       LEFT JOIN nodes h ON h.id = e.target_id
+       WHERE t.label = 'Tool'
+       AND (? IS NULL OR t.name LIKE '%' || ? || '%')
+       ORDER BY t.name
+       LIMIT 100`)
+        .all(toolFilter, toolFilter);
+    return rows.map((row) => {
+        let description = null;
+        if (row.properties) {
+            try {
+                const props = JSON.parse(row.properties);
+                description = typeof props['description'] === 'string' ? props['description'] : null;
+            }
+            catch {
+                // ignore malformed JSON
+            }
+        }
+        return {
+            id: row.id,
+            name: row.name,
+            description,
+            filePath: row.file_path ?? null,
+            handlerName: row.handler_name ?? null,
+            handlerFile: row.handler_file ?? null,
+            handlerLine: row.handler_line ?? null,
+        };
+    });
+}
+//# sourceMappingURL=tool-map.js.map

package/dist/src/mcp-tools/tool-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-map.js","sourceRoot":"","sources":["../../../src/mcp-tools/tool-map.ts"],"names":[],"mappings":"AAcA,kFAAkF;AAElF,MAAM,UAAU,UAAU,CACxB,EAAqB,EACrB,OAA2B;IAE3B,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;IAEzC,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;;;;;;iBAQW,CACZ;SACA,GAAG,CAAC,UAAU,EAAE,UAAU,CAQ3B,CAAC;IAEH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,IAAI,WAAW,GAAkB,IAAI,CAAC;QACtC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAA4B,CAAC;gBACpE,WAAW,GAAG,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACvF,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW;YACX,QAAQ,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACrC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;YACrC,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;SACtC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp-tools/wiki-build.d.ts

@@ -0,0 +1,21 @@
+import type { MonographDb } from '../storage/db.js';
+import type { LlmClient } from '../wiki/wiki-generator.js';
+export interface WikiBuildToolInput {
+    communityId?: string;
+    force?: boolean;
+    model?: string;
+    /** Injected LLM client for testing (not part of MCP schema) */
+    llmClient?: LlmClient;
+}
+export interface WikiBuildToolResult {
+    generated?: number;
+    skipped?: number;
+    errors?: number;
+    error?: string;
+}
+/**
+ * monograph_wiki_build MCP tool handler.
+ * Generates wiki pages for communities using the LLM.
+ */
+export declare function runWikiBuildTool(db: MonographDb, input: WikiBuildToolInput): Promise<WikiBuildToolResult>;
+//# sourceMappingURL=wiki-build.d.ts.map

package/dist/src/mcp-tools/wiki-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-build.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/wiki-build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAA+B,MAAM,2BAA2B,CAAC;AAGxF,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,WAAW,EACf,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAe9B"}

package/dist/src/mcp-tools/wiki-build.js

@@ -0,0 +1,20 @@
+import { generateAllWikiPages } from '../wiki/wiki-generator.js';
+/**
+ * monograph_wiki_build MCP tool handler.
+ * Generates wiki pages for communities using the LLM.
+ */
+export async function runWikiBuildTool(db, input) {
+    const apiKey = process.env['ANTHROPIC_API_KEY'];
+    if (!apiKey && !input.llmClient) {
+        return { error: 'ANTHROPIC_API_KEY not set' };
+    }
+    const opts = {
+        force: input.force ?? false,
+        model: input.model,
+        communityId: input.communityId,
+        llmClient: input.llmClient,
+    };
+    const result = await generateAllWikiPages(db, opts);
+    return result;
+}
+//# sourceMappingURL=wiki-build.js.map

package/dist/src/mcp-tools/wiki-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-build.js","sourceRoot":"","sources":["../../../src/mcp-tools/wiki-build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAiBjE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAe,EACf,KAAyB;IAEzB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,GAAgC;QACxC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK;QAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/mcp-tools/wiki.d.ts

@@ -0,0 +1,18 @@
+import type { MonographDb } from '../storage/db.js';
+export interface WikiToolInput {
+    communityId?: string;
+}
+export interface WikiPage {
+    communityId: string;
+    content: string;
+    generatedAt: string;
+}
+export interface WikiToolResult {
+    pages: WikiPage[];
+}
+/**
+ * monograph_wiki MCP tool handler.
+ * Returns one wiki page (by communityId) or all pages.
+ */
+export declare function getWikiToolResult(db: MonographDb, input: WikiToolInput): WikiToolResult;
+//# sourceMappingURL=wiki.d.ts.map

package/dist/src/mcp-tools/wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/wiki.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,CAMvF"}

package/dist/src/mcp-tools/wiki.js

@@ -0,0 +1,13 @@
+import { getWikiPage, listWikiPages } from '../wiki/wiki-store.js';
+/**
+ * monograph_wiki MCP tool handler.
+ * Returns one wiki page (by communityId) or all pages.
+ */
+export function getWikiToolResult(db, input) {
+    if (input.communityId != null) {
+        const page = getWikiPage(db, String(input.communityId));
+        return { pages: page ? [page] : [] };
+    }
+    return { pages: listWikiPages(db) };
+}
+//# sourceMappingURL=wiki.js.map

package/dist/src/mcp-tools/wiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../../src/mcp-tools/wiki.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgBnE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAe,EAAE,KAAoB;IACrE,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACxD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,CAAC;AACtC,CAAC"}

package/dist/src/migrate/jscpd.d.ts

@@ -0,0 +1,9 @@
+export type { MigrationWarning } from './knip.js';
+import type { MigrationWarning } from './knip.js';
+export interface JscpdMigrationResult {
+    monographConfig: Record<string, unknown>;
+    warnings: MigrationWarning[];
+    inputFile: string;
+}
+export declare function migrateFromJscpd(jscpdConfigPath: string): JscpdMigrationResult;
+//# sourceMappingURL=jscpd.d.ts.map

package/dist/src/migrate/jscpd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jscpd.d.ts","sourceRoot":"","sources":["../../../src/migrate/jscpd.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,oBAAoB,CAiE9E"}

package/dist/src/migrate/jscpd.js

@@ -0,0 +1,65 @@
+import { readFileSync, existsSync } from 'fs';
+const JSCPD_REPORTERS_WARNING = 'Use monograph --format sarif|codeclimate|markdown instead';
+export function migrateFromJscpd(jscpdConfigPath) {
+    if (!existsSync(jscpdConfigPath)) {
+        throw new Error(`jscpd config not found: ${jscpdConfigPath}`);
+    }
+    const raw = readFileSync(jscpdConfigPath, 'utf-8');
+    const warnings = [];
+    const monographConfig = {};
+    let jscpdConfig;
+    try {
+        jscpdConfig = JSON.parse(raw);
+    }
+    catch {
+        warnings.push({
+            field: '<file>',
+            message: 'Failed to parse config as JSON',
+            knipValue: raw.slice(0, 100),
+        });
+        return { monographConfig, warnings, inputFile: jscpdConfigPath };
+    }
+    const knownFields = new Set([
+        'threshold',
+        'minTokens',
+        'ignore',
+        'reporters',
+        'languages',
+        'gitignore',
+    ]);
+    for (const [key, value] of Object.entries(jscpdConfig)) {
+        switch (key) {
+            case 'threshold':
+                monographConfig['cloneThreshold'] = value;
+                break;
+            case 'minTokens':
+                monographConfig['cloneMinTokens'] = value;
+                break;
+            case 'ignore':
+                monographConfig['exclude'] = value;
+                break;
+            case 'reporters':
+                warnings.push({
+                    field: key,
+                    message: JSCPD_REPORTERS_WARNING,
+                    knipValue: value,
+                });
+                break;
+            case 'languages':
+                monographConfig['languages'] = value;
+                break;
+            case 'gitignore':
+                monographConfig['respectGitignore'] = value;
+                break;
+            default:
+                warnings.push({
+                    field: key,
+                    message: 'No equivalent in monograph config',
+                    knipValue: value,
+                });
+                break;
+        }
+    }
+    return { monographConfig, warnings, inputFile: jscpdConfigPath };
+}
+//# sourceMappingURL=jscpd.js.map

package/dist/src/migrate/jscpd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jscpd.js","sourceRoot":"","sources":["../../../src/migrate/jscpd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAU9C,MAAM,uBAAuB,GAAG,2DAA2D,CAAC;AAE5F,MAAM,UAAU,gBAAgB,CAAC,eAAuB;IACtD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,2BAA2B,eAAe,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,eAAe,GAA4B,EAAE,CAAC;IAEpD,IAAI,WAAoC,CAAC;IACzC,IAAI,CAAC;QACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,gCAAgC;YACzC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SAC7B,CAAC,CAAC;QACH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1B,WAAW;QACX,WAAW;QACX,QAAQ;QACR,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,WAAW;gBACd,eAAe,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;gBAC1C,MAAM;YACR,KAAK,WAAW;gBACd,eAAe,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;gBAC1C,MAAM;YACR,KAAK,QAAQ;gBACX,eAAe,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBACnC,MAAM;YACR,KAAK,WAAW;gBACd,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,GAAG;oBACV,OAAO,EAAE,uBAAuB;oBAChC,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,WAAW;gBACd,eAAe,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;gBACrC,MAAM;YACR,KAAK,WAAW;gBACd,eAAe,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC;gBAC5C,MAAM;YACR;gBACE,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,GAAG;oBACV,OAAO,EAAE,mCAAmC;oBAC5C,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;gBACH,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACnE,CAAC"}

package/dist/src/migrate/jsonc-gen.d.ts

@@ -0,0 +1,5 @@
+declare function indentJsonValue(json: string, spaces: number): string;
+export declare function generateJsonc(config: Record<string, unknown>, sources: string[]): string;
+export declare function parseJsoncComments(input: string): Record<string, unknown>;
+export { indentJsonValue };
+//# sourceMappingURL=jsonc-gen.d.ts.map

package/dist/src/migrate/jsonc-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonc-gen.d.ts","sourceRoot":"","sources":["../../../src/migrate/jsonc-gen.ts"],"names":[],"mappings":"AAEA,iBAAS,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAoBxF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}