@coreyuan/vector-mind 1.0.48 → 1.0.52

package/dist/tool-handlers/requirements.js

@@ -0,0 +1,357 @@
+import path from "node:path";
+import { CompleteRequirementArgsSchema, GetPendingChangesArgsSchema, MAX_PENDING_LIMIT, PreflightChangeScopeArgsSchema, StartRequirementArgsSchema, SyncChangeIntentArgsSchema } from "../tool-schemas.js";
+import { buildDevelopmentWarnings, buildRequirementMappingWarnings, buildRequirementScopeContract, buildRequirementStartWarnings, buildScopeDriftWarnings, getRequirementItems, getRequirementScopeContract, isDevelopmentWarningBlockingForChangeMode, mergeScopeContracts, normalizeRequirementItems } from "../development-warnings.js";
+import { mergePendingWithGit } from "../pending-changes.js";
+import { toolCompactOrJson } from "../token-savings.js";
+import { flushPendingChangeBuffer, indexFile } from "../file-indexing.js";
+import { completeAllActiveRequirementMemoryItems, completeRequirementMemoryItemsByReqId } from "../memory-mutations.js";
+import { makePreviewText } from "../memory-recall.js";
+import { logActivity } from "../activity-log.js";
+import { compactPreflightChangeScopeText, safeJson, toolJson } from "../tool-output.js";
+export async function handleStartRequirement(rawArgs, context) {
+    const sha256Hex = context.sha256Hex;
+    const { insertRequirementStmt, completeAllActiveRequirementsStmt, insertMemoryItemStmt } = context.getStatements();
+    const args = StartRequirementArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const scope_contract = buildRequirementScopeContract({
+        title: args.title,
+        background: args.background,
+        scope_allow: args.scope_allow,
+        scope_deny: args.scope_deny,
+        allowed_paths: args.allowed_paths,
+        denied_paths: args.denied_paths,
+    });
+    const requirement_items = normalizeRequirementItems(args.requirement_items);
+    const development_warnings = buildRequirementStartWarnings({
+        title: args.title,
+        background: args.background,
+        close_previous: args.close_previous,
+    });
+    if (args.close_previous) {
+        try {
+            completeAllActiveRequirementsStmt.run();
+            completeAllActiveRequirementMemoryItems();
+        }
+        catch (err) {
+            console.error("[vectormind] failed to close previous active requirements:", err);
+        }
+    }
+    const info = insertRequirementStmt.run(args.title, args.background || null);
+    const id = Number(info.lastInsertRowid);
+    const background = args.background?.trim() ?? "";
+    const content = background ? `${args.title}\n\n${background}` : args.title;
+    const memoryInfo = insertMemoryItemStmt.run("requirement", args.title, content, null, null, null, id, safeJson({ status: "active", scope_contract, requirement_items }), sha256Hex(content));
+    const memory_id = Number(memoryInfo.lastInsertRowid);
+    logActivity("start_requirement", {
+        req_id: id,
+        title: args.title,
+        closed_previous: args.close_previous,
+        scope_contract,
+        requirement_items,
+        development_warnings: development_warnings.length,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolJson({
+                    ok: true,
+                    requirement: { id, title: args.title },
+                    memory_item: { id: memory_id },
+                    closed_previous: args.close_previous,
+                    scope_contract,
+                    requirement_items,
+                    development_warnings,
+                }),
+            },
+        ],
+    };
+}
+export async function handlePreflightChangeScope(rawArgs, context) {
+    const normalizeToDbPath = context.normalizeToDbPath;
+    const { getActiveRequirementStmt } = context.getStatements();
+    const args = PreflightChangeScopeArgsSchema.parse(rawArgs);
+    const changeMode = args.change_mode;
+    flushPendingChangeBuffer();
+    const files = (args.files ?? args.planned_files ?? []).filter((f) => typeof f === "string" && f.length > 0);
+    const active = getActiveRequirementStmt.get();
+    const explicitContract = buildRequirementScopeContract({
+        title: active?.title ?? "",
+        background: active?.context_data ?? "",
+        scope_allow: args.scope_allow,
+        scope_deny: args.scope_deny,
+        allowed_paths: args.allowed_paths,
+        denied_paths: args.denied_paths,
+    });
+    const explicitRequirementItems = normalizeRequirementItems(args.requirement_items);
+    const requirementItems = explicitRequirementItems.length
+        ? explicitRequirementItems
+        : active
+            ? getRequirementItems(active.id)
+            : [];
+    const fileInputs = files.map((file_path) => ({ file_path }));
+    const development_warnings = [
+        ...buildDevelopmentWarnings(fileInputs, { includeUnspecified: fileInputs.length === 0 }),
+        ...buildScopeDriftWarnings({
+            requirement: active,
+            contract: explicitContract,
+            intent: args.intent,
+            files: fileInputs,
+            includeMissingContractHint: true,
+        }),
+        ...buildRequirementMappingWarnings({
+            requirement: active,
+            requirement_items: requirementItems,
+            planned_changes: args.planned_changes,
+            files: fileInputs,
+            change_mode: changeMode,
+        }),
+    ];
+    const scope_contract = mergeScopeContracts(active ? getRequirementScopeContract(active.id) : null, explicitContract);
+    logActivity("preflight_change_scope", {
+        req_id: active?.id ?? null,
+        intent_preview: makePreviewText(args.intent, 200),
+        change_mode: changeMode,
+        files: files.slice(0, 25),
+        files_total: files.length,
+        development_warnings: development_warnings.length,
+    });
+    const hasTargetFiles = fileInputs.length > 0;
+    const hugeWarnings = development_warnings.filter((w) => w.code === "huge_file_modularization_required");
+    const hasHugeFile = hugeWarnings.length > 0;
+    const blockingWarnings = development_warnings.filter((w) => isDevelopmentWarningBlockingForChangeMode(w, changeMode));
+    const hasBlockingWarnings = blockingWarnings.length > 0;
+    const safeToEdit = hasTargetFiles && !hasBlockingWarnings;
+    const recommendedAction = !hasTargetFiles
+        ? "Identify the intended target files/modules and rerun preflight_change_scope before editing."
+        : hasHugeFile && changeMode === "mechanical_modularization" && safeToEdit
+            ? "Proceed only with mechanical modularization: call plan_large_file_split, move whole declarations into real named modules/directories, avoid generated/parts files, validate, then record_large_file_split."
+            : hasHugeFile && changeMode === "emergency_hotfix" && safeToEdit
+                ? "Proceed only with the smallest urgent fix, do not add new responsibilities, record why mechanical modularization was deferred, and plan/record the split next."
+                : hasHugeFile
+                    ? "Stop normal feature work. Call plan_large_file_split and perform mechanical modularization first, or rerun preflight_change_scope with change_mode='mechanical_modularization' for the split itself."
+                    : hasBlockingWarnings
+                        ? "Stop before editing. Narrow the planned files or explicitly expand the current requirement/scope contract."
+                        : "Planned files are within the current generic scope checks.";
+    const requiredAction = hasHugeFile && changeMode !== "mechanical_modularization"
+        ? "mechanical_modularization"
+        : undefined;
+    const allowedChangeModes = hasHugeFile
+        ? ["mechanical_modularization", "emergency_hotfix"]
+        : undefined;
+    const outputValue = {
+        ok: safeToEdit,
+        safe_to_edit: safeToEdit,
+        change_mode: changeMode,
+        recommended_action: recommendedAction,
+        required_action: requiredAction,
+        allowed_change_modes: allowedChangeModes,
+        active_requirement: active ? { id: active.id, title: active.title } : null,
+        intent: args.intent,
+        files: files.map(normalizeToDbPath),
+        requirement_mapping: {
+            requirement_items: requirementItems,
+            planned_changes: args.planned_changes ?? [],
+        },
+        scope_contract,
+        development_warnings,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolCompactOrJson("preflight_change_scope", outputValue, compactPreflightChangeScopeText(outputValue), args.format),
+            },
+        ],
+    };
+}
+export async function handleSyncChangeIntent(rawArgs, context) {
+    const db = context.getDb();
+    const projectRoot = context.getProjectRoot();
+    const normalizeToDbPath = context.normalizeToDbPath;
+    const sha256Hex = context.sha256Hex;
+    const getFileStateHash = context.getFileStateHash;
+    const { insertChangeLogStmt, insertMemoryItemStmt, getActiveRequirementStmt, listPendingChangesStmt, deletePendingChangeStmt, deleteAllPendingChangesStmt, } = context.getStatements();
+    const args = SyncChangeIntentArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const explicitFiles = (args.files ?? args.affected_files ?? []).filter((f) => typeof f === "string" && f.length > 0);
+    const active = getActiveRequirementStmt.get();
+    if (!active) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: toolJson({
+                        ok: false,
+                        error: "No active requirement. Call start_requirement({ project_root, title, background }) before syncing change intent.",
+                    }),
+                },
+            ],
+        };
+    }
+    const created = [];
+    const synced_files = [];
+    const insertTx = db.transaction(() => {
+        const targets = [];
+        if (explicitFiles.length) {
+            for (const rawFile of explicitFiles) {
+                const dbFilePath = normalizeToDbPath(rawFile);
+                targets.push({ rawFile, dbFilePath, event: "manual", source: "args" });
+            }
+            for (const t of targets) {
+                deletePendingChangeStmt.run(t.dbFilePath);
+            }
+        }
+        else {
+            const pendingAll = listPendingChangesStmt.all();
+            const merged = mergePendingWithGit(pendingAll, { offset: 0, limit: MAX_PENDING_LIMIT });
+            if (merged.page.length) {
+                for (const p of merged.page) {
+                    targets.push({
+                        rawFile: p.file_path,
+                        dbFilePath: p.file_path,
+                        event: p.last_event,
+                        source: p.source === "git" ? "pending" : "pending",
+                    });
+                }
+                deleteAllPendingChangesStmt.run();
+            }
+            else {
+                targets.push({
+                    rawFile: "(unspecified)",
+                    dbFilePath: "(unspecified)",
+                    event: "manual",
+                    source: "unspecified",
+                });
+            }
+        }
+        for (const t of targets) {
+            const isUnspecified = t.dbFilePath === "(unspecified)";
+            const changeInfo = insertChangeLogStmt.run(active.id, t.dbFilePath, args.intent);
+            const change_log_id = Number(changeInfo.lastInsertRowid);
+            const memoryInfo = insertMemoryItemStmt.run("change_intent", active.title, args.intent, isUnspecified ? null : t.dbFilePath, null, null, active.id, safeJson({
+                change_log_id,
+                event: t.event,
+                source: t.source,
+                file_state_hash: isUnspecified ? null : getFileStateHash(t.rawFile),
+            }), sha256Hex(args.intent));
+            const memory_item_id = Number(memoryInfo.lastInsertRowid);
+            synced_files.push({ file_path: t.dbFilePath, event: t.event, source: t.source });
+            created.push({
+                file_path: t.dbFilePath,
+                event: t.event,
+                source: t.source,
+                change_log_id,
+                memory_item_id,
+            });
+            if (!isUnspecified && t.event !== "unlink") {
+                const abs = path.isAbsolute(t.rawFile)
+                    ? t.rawFile
+                    : path.join(projectRoot, t.rawFile);
+                indexFile(abs, "manual");
+            }
+        }
+    });
+    insertTx();
+    const development_warnings = [
+        ...buildDevelopmentWarnings(synced_files, {
+            includeUnspecified: synced_files.some((f) => f.file_path === "(unspecified)"),
+        }),
+        ...buildScopeDriftWarnings({
+            requirement: active,
+            intent: args.intent,
+            files: synced_files,
+        }),
+    ];
+    logActivity("sync_change_intent", {
+        req_id: active.id,
+        title: active.title,
+        intent_preview: makePreviewText(args.intent, 200),
+        files: synced_files.slice(0, 25),
+        files_total: synced_files.length,
+        development_warnings: development_warnings.length,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolJson({
+                    ok: true,
+                    linked_to_requirement: { id: active.id, title: active.title },
+                    synced_files,
+                    created,
+                    development_warnings,
+                }),
+            },
+        ],
+    };
+}
+export async function handleGetPendingChanges(rawArgs, context) {
+    const { getActiveRequirementStmt, listPendingChangesStmt } = context.getStatements();
+    const args = GetPendingChangesArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const offset = args.offset;
+    const limit = args.limit;
+    const pendingDbRows = listPendingChangesStmt.all();
+    const mergedPending = mergePendingWithGit(pendingDbRows, { offset, limit });
+    const total = mergedPending.total;
+    const truncated = mergedPending.truncated;
+    const pending = mergedPending.page;
+    const activeForScope = getActiveRequirementStmt.get();
+    const development_warnings = [
+        ...buildDevelopmentWarnings(pending),
+        ...(activeForScope ? buildScopeDriftWarnings({ requirement: activeForScope, files: pending }) : []),
+    ];
+    logActivity("get_pending_changes", {
+        total,
+        offset,
+        limit,
+        returned: pending.length,
+        truncated,
+        development_warnings: development_warnings.length,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: toolJson({ ok: true, total, offset, limit, truncated, pending, development_warnings }),
+            },
+        ],
+    };
+}
+export async function handleCompleteRequirement(rawArgs, context) {
+    const db = context.getDb();
+    const { completeAllActiveRequirementsStmt, getActiveRequirementStmt, completeRequirementByIdStmt } = context.getStatements();
+    const args = CompleteRequirementArgsSchema.parse(rawArgs);
+    flushPendingChangeBuffer();
+    const updated = [];
+    if (args.all_active) {
+        const activeRows = db.prepare(`SELECT id FROM requirements WHERE status = 'active' ORDER BY created_at DESC, id DESC`).all().slice(0, 200);
+        try {
+            completeAllActiveRequirementsStmt.run();
+            completeAllActiveRequirementMemoryItems();
+        }
+        catch (err) {
+            console.error("[vectormind] complete all active requirements failed:", err);
+        }
+        for (const r of activeRows)
+            updated.push({ id: r.id });
+        logActivity("complete_requirement", { all_active: true, completed: updated.map((u) => u.id) });
+        return { content: [{ type: "text", text: toolJson({ ok: true, completed: updated }) }] };
+    }
+    const targetId = args.req_id ?? getActiveRequirementStmt.get()?.id ?? null;
+    if (!targetId) {
+        return { content: [{ type: "text", text: toolJson({ ok: true, completed: [] }) }] };
+    }
+    try {
+        completeRequirementByIdStmt.run(targetId);
+        completeRequirementMemoryItemsByReqId(targetId);
+    }
+    catch (err) {
+        console.error("[vectormind] complete requirement failed:", err);
+    }
+    logActivity("complete_requirement", { req_id: targetId });
+    return { content: [{ type: "text", text: toolJson({ ok: true, completed: [{ id: targetId }] }) }] };
+}
+//# sourceMappingURL=requirements.js.map

package/dist/tool-handlers/requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/tool-handlers/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC3M,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,yCAAyC,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC3U,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,uCAAuC,EAAE,qCAAqC,EAAE,MAAM,wBAAwB,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,+BAA+B,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgC,EAChC,OAA2B;IAE3B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,EAAE,qBAAqB,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAEnH,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,wBAAwB,EAAE,CAAC;IAC3B,MAAM,cAAc,GAAG,6BAA6B,CAAC;QACnD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;QACzD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,iCAAiC,CAAC,GAAG,EAAE,CAAC;YACxC,uCAAuC,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4DAA4D,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IAC5E,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAExC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,OAAO,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAC3E,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CACzC,aAAa,EACb,IAAI,CAAC,KAAK,EACV,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,EAAE,EACF,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,EACjE,SAAS,CAAC,OAAO,CAAC,CACnB,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IAErD,WAAW,CAAC,mBAAmB,EAAE;QAC/B,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,eAAe,EAAE,IAAI,CAAC,cAAc;QACpC,cAAc;QACd,iBAAiB;QACjB,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ,CAAC;oBACb,EAAE,EAAE,IAAI;oBACR,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;oBACtC,WAAW,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;oBAC9B,eAAe,EAAE,IAAI,CAAC,cAAc;oBACpC,cAAc;oBACd,iBAAiB;oBACjB,oBAAoB;iBACrB,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAgC,EAChC,OAA2B;IAE3B,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpD,MAAM,EAAE,wBAAwB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE7D,MAAM,IAAI,GAAG,8BAA8B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAyB,CAAC;IAClD,wBAAwB,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAC3D,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC1D,CAAC;IACF,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,EAAgC,CAAC;IAC5E,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;QACrD,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;QAC1B,UAAU,EAAE,MAAM,EAAE,YAAY,IAAI,EAAE;QACtC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IACH,MAAM,wBAAwB,GAAG,yBAAyB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACnF,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,MAAM;QACtD,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,MAAM;YACN,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,oBAAoB,GAAG;QAC3B,GAAG,wBAAwB,CAAC,UAAU,EAAE,EAAE,kBAAkB,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxF,GAAG,uBAAuB,CAAC;YACzB,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,UAAU;YACjB,0BAA0B,EAAE,IAAI;SACjC,CAAC;QACF,GAAG,+BAA+B,CAAC;YACjC,WAAW,EAAE,MAAM;YACnB,iBAAiB,EAAE,gBAAgB;YACnC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,KAAK,EAAE,UAAU;YACjB,WAAW,EAAE,UAAU;SACxB,CAAC;KACH,CAAC;IACF,MAAM,cAAc,GAAG,mBAAmB,CACxC,MAAM,CAAC,CAAC,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EACtD,gBAAgB,CACjB,CAAC;IAEF,WAAW,CAAC,wBAAwB,EAAE;QACpC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,IAAI;QAC1B,cAAc,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;QACjD,WAAW,EAAE,UAAU;QACvB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACzB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;KAClD,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mCAAmC,CAAC,CAAC;IACxG,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,yCAAyC,CAAC,CAAC,EAAE,UAAU,CAAC,CACzD,CAAC;IACF,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,cAAc,IAAI,CAAC,mBAAmB,CAAC;IAC1D,MAAM,iBAAiB,GAAG,CAAC,cAAc;QACvC,CAAC,CAAC,6FAA6F;QAC/F,CAAC,CAAC,WAAW,IAAI,UAAU,KAAK,2BAA2B,IAAI,UAAU;YACvE,CAAC,CAAC,4MAA4M;YAC9M,CAAC,CAAC,WAAW,IAAI,UAAU,KAAK,kBAAkB,IAAI,UAAU;gBAC9D,CAAC,CAAC,gKAAgK;gBAClK,CAAC,CAAC,WAAW;oBACX,CAAC,CAAC,sMAAsM;oBACxM,CAAC,CAAC,mBAAmB;wBACnB,CAAC,CAAC,4GAA4G;wBAC9G,CAAC,CAAC,4DAA4D,CAAC;IACzE,MAAM,cAAc,GAAG,WAAW,IAAI,UAAU,KAAK,2BAA2B;QAC9E,CAAC,CAAC,2BAA2B;QAC7B,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,kBAAkB,GAAG,WAAW;QACpC,CAAC,CAAE,CAAC,2BAA2B,EAAE,kBAAkB,CAAkB;QACrE,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAG;QAClB,EAAE,EAAE,UAAU;QACd,YAAY,EAAE,UAAU;QACxB,WAAW,EAAE,UAAU;QACvB,kBAAkB,EAAE,iBAAiB;QACrC,eAAe,EAAE,cAAc;QAC/B,oBAAoB,EAAE,kBAAkB;QACxC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;QAC1E,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACnC,mBAAmB,EAAE;YACnB,iBAAiB,EAAE,gBAAgB;YACnC,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,EAAE;SAC5C;QACD,cAAc;QACd,oBAAoB;KACrB,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,iBAAiB,CACrB,wBAAwB,EACxB,WAAW,EACX,+BAA+B,CAAC,WAAW,CAAC,EAC5C,IAAI,CAAC,MAAM,CACZ;aACF;SACF;KACF,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAgC,EAChC,OAA2B;IAE3B,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAC7C,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAClD,MAAM,EACJ,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,GAC5B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE5B,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,wBAAwB,EAAE,CAAC;IAC3B,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,CACpE,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC1D,CAAC;IACF,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,EAAgC,CAAC;IAC5E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,CAAC;wBACb,EAAE,EAAE,KAAK;wBACT,KAAK,EACH,kHAAkH;qBACrH,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAMR,EAAE,CAAC;IACR,MAAM,YAAY,GAIb,EAAE,CAAC;IACR,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACnC,MAAM,OAAO,GAKR,EAAE,CAAC;QAER,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACpC,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACzE,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,sBAAsB,CAAC,GAAG,EAI3C,CAAC;YACH,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC5B,OAAO,CAAC,IAAI,CAAC;wBACX,OAAO,EAAE,CAAC,CAAC,SAAS;wBACpB,UAAU,EAAE,CAAC,CAAC,SAAS;wBACvB,KAAK,EAAE,CAAC,CAAC,UAAU;wBACnB,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;qBACnD,CAAC,CAAC;gBACL,CAAC;gBACD,2BAA2B,CAAC,GAAG,EAAE,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO,EAAE,eAAe;oBACxB,UAAU,EAAE,eAAe;oBAC3B,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,aAAa;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,CAAC,CAAC,UAAU,KAAK,eAAe,CAAC;YACvD,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACjF,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;YAEzD,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CACzC,eAAe,EACf,MAAM,CAAC,KAAK,EACZ,IAAI,CAAC,MAAM,EACX,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EACnC,IAAI,EACJ,IAAI,EACJ,MAAM,CAAC,EAAE,EACT,QAAQ,CAAC;gBACP,aAAa;gBACb,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC;aACpE,CAAC,EACF,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CACvB,CAAC;YACF,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;YAE1D,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,CAAC,CAAC,UAAU;gBACvB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,aAAa;gBACb,cAAc;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;oBACpC,CAAC,CAAC,CAAC,CAAC,OAAO;oBACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;gBACtC,SAAS,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC;IACX,MAAM,oBAAoB,GAAG;QAC3B,GAAG,wBAAwB,CAAC,YAAY,EAAE;YACxC,kBAAkB,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,eAAe,CAAC;SAC9E,CAAC;QACF,GAAG,uBAAuB,CAAC;YACzB,WAAW,EAAE,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,YAAY;SACpB,CAAC;KACH,CAAC;IAEF,WAAW,CAAC,oBAAoB,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;QACjD,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAChC,WAAW,EAAE,YAAY,CAAC,MAAM;QAChC,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ,CAAC;oBACb,EAAE,EAAE,IAAI;oBACR,qBAAqB,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;oBAC7D,YAAY;oBACZ,OAAO;oBACP,oBAAoB;iBACrB,CAAC;aACH;SACF;KACF,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAgC,EAChC,OAA2B;IAE3B,MAAM,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAErF,MAAM,IAAI,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,wBAAwB,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,aAAa,GAAG,sBAAsB,CAAC,GAAG,EAI9C,CAAC;IACH,MAAM,aAAa,GAAG,mBAAmB,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC;IAClC,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC;IACnC,MAAM,cAAc,GAAG,wBAAwB,CAAC,GAAG,EAAgC,CAAC;IACpF,MAAM,oBAAoB,GAAG;QAC3B,GAAG,wBAAwB,CAAC,OAAO,CAAC;QACpC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,uBAAuB,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACpG,CAAC;IAEF,WAAW,CAAC,qBAAqB,EAAE;QACjC,KAAK;QACL,MAAM;QACN,KAAK;QACL,QAAQ,EAAE,OAAO,CAAC,MAAM;QACxB,SAAS;QACT,oBAAoB,EAAE,oBAAoB,CAAC,MAAM;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;aAC7F;SACF;KACF,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAgC,EAChC,OAA2B;IAE3B,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3B,MAAM,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE7H,MAAM,IAAI,GAAG,6BAA6B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1D,wBAAwB,EAAE,CAAC;IAE3B,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,UAAU,GAAI,EAAE,CAAC,OAAO,CAC5B,uFAAuF,CACxF,CAAC,GAAG,EAA4B,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAEhD,IAAI,CAAC;YACH,iCAAiC,CAAC,GAAG,EAAE,CAAC;YACxC,uCAAuC,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE,GAAG,CAAC,CAAC;QAC9E,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,WAAW,CAAC,sBAAsB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3F,CAAC;IAED,MAAM,QAAQ,GACZ,IAAI,CAAC,MAAM,IAAK,wBAAwB,CAAC,GAAG,EAAiC,EAAE,EAAE,IAAI,IAAI,CAAC;IAC5F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,CAAC;QACH,2BAA2B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,qCAAqC,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACtG,CAAC"}

package/dist/tool-handlers.d.ts

@@ -0,0 +1,4 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ToolHandlerContext } from "./tool-handlers/context.js";
+export type { ToolHandlerContext } from "./tool-handlers/context.js";
+export declare function registerToolHandlers(server: Server, context: ToolHandlerContext): void;

package/dist/tool-handlers.js

@@ -0,0 +1,105 @@
+import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { handleStartRequirement, handlePreflightChangeScope, handleSyncChangeIntent, handleGetPendingChanges, handleCompleteRequirement } from "./tool-handlers/requirements.js";
+import { handlePruneIndex, handleMaintainMemory } from "./tool-handlers/maintenance.js";
+import { handlePlanLargeFileSplit, handleRecordLargeFileSplit } from "./tool-handlers/large-files.js";
+import { handleBootstrapContext, handleGetBrainDump, handleReadMemoryItem, handleSemanticSearch } from "./tool-handlers/memory.js";
+import { handleGrep, handleListProjectFiles, handleReadFileText, handleReadCodexTextFile, handleReadFileLines, handleQueryCodebase } from "./tool-handlers/files.js";
+import { handleUpsertProjectSummary, handleAddNote, handleUpsertDecision, handleSupersedeMemory, handleUpsertConvention } from "./tool-handlers/notes-decisions.js";
+import { handleGetActivityLog, handleGetActivitySummary, handleClearActivityLog, handleDetectRtk, handleInstallRtk, handleGetTokenSavings } from "./tool-handlers/diagnostics.js";
+import { handleCreateCheckpoint, handleListCheckpoints, handleMemoryTimeline, handleRestoreCheckpointContext } from "./tool-handlers/context-recovery.js";
+import { handleAnalyzeMemoryConflicts, handleCompareCheckpointContext, handleMemoryQualityReport } from "./tool-handlers/memory-diagnostics.js";
+import { oneLine, toolJson } from "./tool-output.js";
+const TOOL_HANDLERS = {
+    start_requirement: handleStartRequirement,
+    prune_index: handlePruneIndex,
+    maintain_memory: handleMaintainMemory,
+    preflight_change_scope: handlePreflightChangeScope,
+    plan_large_file_split: handlePlanLargeFileSplit,
+    record_large_file_split: handleRecordLargeFileSplit,
+    sync_change_intent: handleSyncChangeIntent,
+    bootstrap_context: handleBootstrapContext,
+    get_brain_dump: handleGetBrainDump,
+    get_pending_changes: handleGetPendingChanges,
+    complete_requirement: handleCompleteRequirement,
+    read_memory_item: handleReadMemoryItem,
+    get_activity_log: handleGetActivityLog,
+    get_activity_summary: handleGetActivitySummary,
+    clear_activity_log: handleClearActivityLog,
+    detect_rtk: handleDetectRtk,
+    install_rtk: handleInstallRtk,
+    get_token_savings: handleGetTokenSavings,
+    grep: handleGrep,
+    list_project_files: handleListProjectFiles,
+    read_file_text: handleReadFileText,
+    read_codex_text_file: handleReadCodexTextFile,
+    read_file_lines: handleReadFileLines,
+    query_codebase: handleQueryCodebase,
+    upsert_project_summary: handleUpsertProjectSummary,
+    add_note: handleAddNote,
+    upsert_decision: handleUpsertDecision,
+    supersede_memory: handleSupersedeMemory,
+    upsert_convention: handleUpsertConvention,
+    semantic_search: handleSemanticSearch,
+    memory_timeline: handleMemoryTimeline,
+    create_checkpoint: handleCreateCheckpoint,
+    list_checkpoints: handleListCheckpoints,
+    restore_checkpoint_context: handleRestoreCheckpointContext,
+    analyze_memory_conflicts: handleAnalyzeMemoryConflicts,
+    memory_quality_report: handleMemoryQualityReport,
+    compare_checkpoint_context: handleCompareCheckpointContext,
+};
+function attachProjectContextAdvisory(result, advisory) {
+    if (!advisory)
+        return result;
+    const content = result.content?.map((item, index) => {
+        if (index !== 0 || item.type !== "text" || typeof item.text !== "string")
+            return item;
+        const text = item.text.trim();
+        if (text.startsWith("{") || text.startsWith("[")) {
+            try {
+                const parsed = JSON.parse(item.text);
+                return {
+                    ...item,
+                    text: toolJson({
+                        ...parsed,
+                        project_context_advisory: advisory,
+                    }),
+                };
+            }
+            catch {
+                // Fall back to compact-text injection below.
+            }
+        }
+        const advisoryLine = `project_context_advisory ${advisory.code}: external_reference=true read_only_reference=true previous="${oneLine(advisory.previous_project_root, 90)}" current="${oneLine(advisory.current_project_root, 90)}"`;
+        return {
+            ...item,
+            text: `${advisoryLine}\n${item.text}`,
+        };
+    });
+    return { ...result, content };
+}
+export function registerToolHandlers(server, context) {
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const rawArgs = (request.params.arguments ?? {});
+        try {
+            await context.ensureInitializedForArgs(rawArgs);
+            const handler = TOOL_HANDLERS[toolName];
+            if (!handler) {
+                return attachProjectContextAdvisory({
+                    isError: true,
+                    content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
+                }, context.consumeProjectContextAdvisory());
+            }
+            const result = await handler(rawArgs, context);
+            return attachProjectContextAdvisory(result, context.consumeProjectContextAdvisory());
+        }
+        catch (err) {
+            return attachProjectContextAdvisory({
+                isError: true,
+                content: [{ type: "text", text: String(err) }],
+            }, context.consumeProjectContextAdvisory());
+        }
+    });
+}
+//# sourceMappingURL=tool-handlers.js.map

package/dist/tool-handlers.js.map

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