@coreyuan/vector-mind 1.0.52 → 1.0.54

package/dist/tool-handlers.js

@@ -8,12 +8,15 @@ import { handleUpsertProjectSummary, handleAddNote, handleUpsertDecision, handle
 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 { handlePreflightOperationScope } from "./tool-handlers/operations.js";
+import { runAutoMaintenanceIfDue } from "./memory-maintenance.js";
 import { oneLine, toolJson } from "./tool-output.js";
 const TOOL_HANDLERS = {
     start_requirement: handleStartRequirement,
     prune_index: handlePruneIndex,
     maintain_memory: handleMaintainMemory,
     preflight_change_scope: handlePreflightChangeScope,
+    preflight_operation_scope: handlePreflightOperationScope,
     plan_large_file_split: handlePlanLargeFileSplit,
     record_large_file_split: handleRecordLargeFileSplit,
     sync_change_intent: handleSyncChangeIntent,
@@ -78,12 +81,269 @@ function attachProjectContextAdvisory(result, advisory) {
     });
     return { ...result, content };
 }
+function firstTextContent(result) {
+    const item = result.content?.find((content) => content.type === "text");
+    return item?.type === "text" && typeof item.text === "string" ? item.text : "";
+}
+function parseJsonToolOutput(result) {
+    const text = firstTextContent(result).trim();
+    if (!text.startsWith("{"))
+        return null;
+    try {
+        const parsed = JSON.parse(text);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function warningCode(warning) {
+    if (!warning || typeof warning !== "object" || Array.isArray(warning))
+        return "";
+    const code = warning.code;
+    return typeof code === "string" ? code : "";
+}
+function warningMessage(warning) {
+    if (!warning || typeof warning !== "object" || Array.isArray(warning))
+        return "";
+    const record = warning;
+    for (const key of ["message", "detail", "title", "reason"]) {
+        const value = record[key];
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    const code = warningCode(warning);
+    return code || "MCP guard warning";
+}
+function eventForWarningCode(code) {
+    switch (code) {
+        case "huge_file_modularization_required":
+            return {
+                eventType: "blocked_large_file",
+                severity: "critical",
+                title: "阻止大文件直接修改，要求先拆模块",
+            };
+        case "very_large_file":
+        case "large_file":
+        case "large_file_read":
+            return {
+                eventType: "large_file_guard",
+                severity: "warn",
+                title: "提醒大文件风险，避免继续堆叠实现",
+            };
+        case "scope_drift":
+            return {
+                eventType: "scope_drift_guard",
+                severity: "warn",
+                title: "发现需求范围漂移，提醒收窄改动",
+            };
+        case "requirement_mapping_missing":
+            return {
+                eventType: "requirement_mapping_guard",
+                severity: "warn",
+                title: "拦截未映射到需求项的改动",
+            };
+        case "scope_contract_missing":
+            return {
+                eventType: "scope_contract_guard",
+                severity: "warn",
+                title: "缺少需求范围契约，阻止直接编辑",
+            };
+        case "cross_project_path":
+            return {
+                eventType: "cross_project_guard",
+                severity: "warn",
+                title: "发现跨项目路径引用，提醒隔离上下文",
+            };
+        default:
+            return {
+                eventType: code ? `development_warning:${code}` : "development_warning",
+                severity: "info",
+                title: code ? `MCP 开发防护提示：${code}` : "MCP 开发防护提示",
+            };
+    }
+}
+function normalizedGuardSeverity(value, fallback = "info") {
+    if (value === "critical" || value === "warn" || value === "info")
+        return value;
+    if (value === "warning")
+        return "warn";
+    if (value === "blocker" || value === "error")
+        return "critical";
+    return fallback;
+}
+function eventForOperationWarningCode(code) {
+    const title = code === "stale_default_conflict"
+        ? "发现过期默认操作，阻止继续执行"
+        : code === "operation_constraint_conflict"
+            ? "发现操作约束冲突，阻止继续执行"
+            : `MCP 操作防护提示：${code}`;
+    return {
+        eventType: `operation_guard:${code}`,
+        severity: "warn",
+        title,
+    };
+}
+function parseCompactToolOutputEvents(toolName, text) {
+    const events = [];
+    const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    if (!lines.length)
+        return events;
+    const hasDevelopmentWarnings = lines.some((line) => /^development warnings:$/i.test(line));
+    const hasOperationWarnings = lines.some((line) => /^operation warnings:$/i.test(line));
+    const header = lines[0] ?? "";
+    const okMatch = /\bok=(true|false)\b/.exec(header);
+    const safeToEditMatch = /\bsafe_to_edit=(true|false)\b/.exec(header);
+    const safeToProceedMatch = /\bsafe_to_proceed=(true|false)\b/.exec(header);
+    const compactState = {
+        ok: okMatch ? okMatch[1] === "true" : undefined,
+        safe_to_edit: safeToEditMatch ? safeToEditMatch[1] === "true" : undefined,
+        safe_to_proceed: safeToProceedMatch ? safeToProceedMatch[1] === "true" : undefined,
+    };
+    for (const line of lines) {
+        const advisory = /^project_context_advisory\s+([^:\s]+):\s*(.*)$/i.exec(line);
+        if (advisory) {
+            events.push({
+                eventType: "cross_project_reference",
+                severity: "info",
+                title: "识别跨项目上下文，只作为只读参考",
+                detail: advisory[2] || "MCP 检测到 project_root 切换或跨项目引用，提醒不要把外部项目当作当前需求范围。",
+                metadata: {
+                    tool_name: toolName,
+                    compact: true,
+                    advisory_code: advisory[1],
+                },
+            });
+            continue;
+        }
+        const operationWarning = /^-\s+([a-z_-]+)\s+([^:\s]+)(?:\s+[^:]*)?:\s*(.*)$/i.exec(line);
+        if (operationWarning && hasOperationWarnings) {
+            const code = operationWarning[2];
+            const base = eventForOperationWarningCode(code);
+            const lineSeverity = normalizedGuardSeverity(operationWarning[1], base.severity);
+            events.push({
+                ...base,
+                severity: lineSeverity,
+                detail: operationWarning[3] || code,
+                metadata: {
+                    tool_name: toolName,
+                    compact: true,
+                    warning: {
+                        code,
+                        severity: lineSeverity,
+                        message: operationWarning[3] || code,
+                    },
+                    ...compactState,
+                },
+            });
+            continue;
+        }
+        const warning = /^-\s+([a-z_-]+)\s+([^:\s]+):\s*(.*)$/i.exec(line);
+        if (warning && hasDevelopmentWarnings) {
+            const code = warning[2];
+            const base = eventForWarningCode(code);
+            const lineSeverity = normalizedGuardSeverity(warning[1]);
+            events.push({
+                ...base,
+                severity: base.severity === "info" ? lineSeverity : base.severity,
+                detail: warning[3] || code,
+                metadata: {
+                    tool_name: toolName,
+                    compact: true,
+                    warning: {
+                        code,
+                        severity: lineSeverity,
+                        message: warning[3] || code,
+                    },
+                    ...compactState,
+                },
+            });
+            continue;
+        }
+    }
+    return events;
+}
+function outputEventsForToolResult(toolName, result) {
+    const text = firstTextContent(result).trim();
+    const parsed = parseJsonToolOutput(result);
+    if (!parsed)
+        return parseCompactToolOutputEvents(toolName, text);
+    const events = [];
+    const developmentWarnings = Array.isArray(parsed.development_warnings) ? parsed.development_warnings : [];
+    for (const warning of developmentWarnings) {
+        const code = warningCode(warning);
+        const base = eventForWarningCode(code);
+        events.push({
+            ...base,
+            detail: warningMessage(warning),
+            metadata: {
+                tool_name: toolName,
+                warning,
+                ok: parsed.ok,
+                safe_to_edit: parsed.safe_to_edit,
+                safe_to_proceed: parsed.safe_to_proceed,
+            },
+        });
+    }
+    const operationWarnings = Array.isArray(parsed.warnings) ? parsed.warnings : [];
+    for (const warning of operationWarnings) {
+        const code = warningCode(warning);
+        if (!code)
+            continue;
+        const base = eventForOperationWarningCode(code);
+        events.push({
+            ...base,
+            detail: warningMessage(warning),
+            metadata: {
+                tool_name: toolName,
+                warning,
+                ok: parsed.ok,
+                safe_to_proceed: parsed.safe_to_proceed,
+            },
+        });
+    }
+    if (parsed.project_context_advisory && typeof parsed.project_context_advisory === "object") {
+        events.push({
+            eventType: "cross_project_reference",
+            severity: "info",
+            title: "识别跨项目上下文，只作为只读参考",
+            detail: "MCP 检测到 project_root 切换或跨项目引用，提醒不要把外部项目当作当前需求范围。",
+            metadata: {
+                tool_name: toolName,
+                advisory: parsed.project_context_advisory,
+            },
+        });
+    }
+    return events;
+}
+function persistMcpGuardEvents(toolName, result, context) {
+    const events = outputEventsForToolResult(toolName, result);
+    if (!events.length)
+        return;
+    const stmt = context.getStatements().insertMcpGuardEventStmt;
+    if (!stmt)
+        return;
+    try {
+        const db = context.getDb();
+        const tx = db.transaction(() => {
+            for (const event of events) {
+                stmt.run(toolName, event.eventType, event.severity, event.title, event.detail, JSON.stringify(event.metadata));
+            }
+        });
+        tx();
+    }
+    catch {
+        // Guard-event persistence must never break the original MCP tool result.
+    }
+}
 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);
+            if (toolName !== "maintain_memory")
+                runAutoMaintenanceIfDue();
             const handler = TOOL_HANDLERS[toolName];
             if (!handler) {
                 return attachProjectContextAdvisory({
@@ -92,7 +352,9 @@ export function registerToolHandlers(server, context) {
                 }, context.consumeProjectContextAdvisory());
             }
             const result = await handler(rawArgs, context);
-            return attachProjectContextAdvisory(result, context.consumeProjectContextAdvisory());
+            const finalResult = attachProjectContextAdvisory(result, context.consumeProjectContextAdvisory());
+            persistMcpGuardEvents(toolName, finalResult, context);
+            return finalResult;
         }
         catch (err) {
             return attachProjectContextAdvisory({

package/dist/tool-handlers.js.map

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

package/dist/tool-output.d.ts

@@ -32,7 +32,9 @@ type CompactRequirementPreview = {
 };
 type CompactChangeLogPreview = {
     id: number;
-    file_path: string;
+    file_path: string | null;
+    files?: string[];
+    file_count?: number;
     intent_preview: string;
 };
 type CompactSemanticSearchResult = {
@@ -44,9 +46,58 @@ type CompactSemanticSearchResult = {
         item: CompactMemoryItemPreview;
     }>;
 };
+type CompactCurrentConstraint = {
+    id: number;
+    kind: string;
+    title?: string | null;
+    source: string;
+    preview?: string | null;
+};
+type CompactOperationScopeWarning = {
+    code: string;
+    severity: string;
+    message: string;
+    evidence?: Array<{
+        constraint_id: number;
+        kind: string;
+        title?: string | null;
+        source: string;
+        preview?: string | null;
+    }>;
+};
+type CompactRelevantFixPattern = {
+    memory_id: number;
+    symptom: string;
+    root_cause: string;
+    invariant: string;
+    avoid_regression?: string[];
+    relevance_score: number;
+    reason?: string;
+};
+type CompactQualitySignals = {
+    advisory_only: boolean;
+    does_not_control_model_reasoning?: boolean;
+    does_not_control_host_runtime?: boolean;
+    does_not_replace_model_judgment?: boolean;
+    does_not_change_ok_or_safe_to_edit?: boolean;
+    does_not_expand_requirement_scope?: boolean;
+    relevant_fix_patterns?: CompactRelevantFixPattern[];
+};
 type CompactMaintenanceResult = {
     dry_run: boolean;
     trigger: string;
+    db_size_before?: {
+        total_bytes: number;
+        db_bytes: number;
+        wal_bytes: number;
+        shm_bytes: number;
+    };
+    db_size_after?: {
+        total_bytes: number;
+        db_bytes: number;
+        wal_bytes: number;
+        shm_bytes: number;
+    };
     compacted_memory: {
         candidates: number;
         compacted: number;
@@ -75,6 +126,30 @@ type CompactMaintenanceResult = {
             samples: string[];
         };
     };
+    pending_pruned?: {
+        ignored_deleted: number;
+        old_deleted: number;
+        overflow_deleted: number;
+    };
+    purged_hidden_memory?: {
+        memory_candidates: number;
+        memory_deleted: number;
+        archive_candidates: number;
+        archives_deleted: number;
+        samples: Array<{
+            id: number;
+            kind: string;
+            title?: string | null;
+            file_path?: string | null;
+            updated_at: string;
+        }>;
+    };
+    metrics_pruned?: {
+        token_savings_deleted: number;
+    };
+    fts_optimized?: boolean;
+    wal_checkpointed?: boolean;
+    vacuumed?: boolean;
 };
 type CompactTokenSavingsSummary = {
     summary: {
@@ -178,6 +253,20 @@ export declare function compactPreflightChangeScopeText(data: {
     };
     scope_contract: CompactRequirementScopeContract | null;
     development_warnings: CompactDevelopmentWarning[];
+    quality_signals?: CompactQualitySignals;
+}): string;
+export declare function compactPreflightOperationScopeText(data: {
+    ok: boolean;
+    safe_to_proceed: boolean;
+    advisory_only?: boolean;
+    operation: string;
+    intent: string;
+    planned_commands: string[];
+    planned_files: string[];
+    planned_targets: string[];
+    current_constraints: CompactCurrentConstraint[];
+    warnings: CompactOperationScopeWarning[];
+    recommended_action: string;
 }): string;
 export declare function compactLargeFileSplitPlanText(data: LargeFileSplitPlan): string;
 export declare function compactBootstrapText(data: {
@@ -189,6 +278,7 @@ export declare function compactBootstrapText(data: {
     project_summary: CompactMemoryItemPreview | null;
     decisions: Array<CompactMemoryItemPreview>;
     conventions: Array<CompactMemoryItemPreview>;
+    current_constraints?: Array<CompactCurrentConstraint>;
     current_context: Array<CompactMemoryItemPreview>;
     recent_notes: Array<CompactMemoryItemPreview>;
     pending_total: number;
@@ -197,6 +287,7 @@ export declare function compactBootstrapText(data: {
     pending_truncated: boolean;
     pending_changes: PendingChangeRow[];
     development_warnings?: CompactDevelopmentWarning[];
+    quality_signals?: CompactQualitySignals;
     items: Array<{
         requirement: CompactRequirementPreview;
         recent_changes: Array<CompactChangeLogPreview>;

package/dist/tool-output.js

@@ -9,6 +9,22 @@ function compactDevelopmentWarningsText(warnings) {
     }
     return lines;
 }
+function compactQualitySignalsText(signals) {
+    const patterns = signals?.relevant_fix_patterns ?? [];
+    if (!patterns.length)
+        return [];
+    const lines = [
+        `quality signals advisory_only=${signals?.advisory_only === true} relevant_fix_patterns=${patterns.length}`,
+    ];
+    for (const p of patterns.slice(0, 3)) {
+        lines.push(`- fix_pattern #${p.memory_id} score=${Number(p.relevance_score).toFixed(2)} invariant=${oneLine(p.invariant, 150)}`);
+        if (p.avoid_regression?.length) {
+            lines.push(`  avoid: ${p.avoid_regression.slice(0, 2).map((item) => oneLine(item, 90)).join("; ")}`);
+        }
+    }
+    lines.push("hint: fix_pattern matches are reminders only; do not expand scope or change ok/safe flags from them");
+    return lines;
+}
 export function safeJson(value) {
     if (value === undefined)
         return null;
@@ -45,7 +61,11 @@ function compactRequirementLabel(req) {
     return `req#${req.id}${mem} [${req.status}] ${oneLine(req.title, 80)}${ctx}`;
 }
 function compactChangeLabel(change) {
-    return `change#${change.id} ${change.file_path}: ${oneLine(change.intent_preview, 120)}`;
+    const files = change.files?.length
+        ? `${change.files.slice(0, 3).join(",")}${change.files.length > 3 ? "..." : ""}`
+        : (change.file_path ?? "unspecified");
+    const count = change.file_count && change.file_count > 1 ? ` files=${change.file_count}` : "";
+    return `change#${change.id}${count} ${files}: ${oneLine(change.intent_preview, 120)}`;
 }
 function compactPendingLabel(p) {
     const source = "source" in p && p.source === "git" ? " git" : "";
@@ -127,9 +147,20 @@ export function compactMaintenanceText(data) {
     const prunedSymbols = data.pruned.ignored_paths.symbols_deleted +
         data.pruned.filename_noise.symbols_deleted +
         data.pruned.stale_files.symbols_deleted;
+    const pendingPruned = data.pending_pruned
+        ? data.pending_pruned.ignored_deleted + data.pending_pruned.old_deleted + data.pending_pruned.overflow_deleted
+        : 0;
+    const hiddenDeleted = data.purged_hidden_memory?.memory_deleted ?? 0;
+    const archivesDeleted = data.purged_hidden_memory?.archives_deleted ?? 0;
+    const tokenSavingsDeleted = data.metrics_pruned?.token_savings_deleted ?? 0;
+    const beforeBytes = data.db_size_before?.total_bytes ?? 0;
+    const afterBytes = data.db_size_after?.total_bytes ?? 0;
     const lines = [
-        `maintain_memory ok dry_run=${data.dry_run} trigger=${data.trigger} compacted=${data.compacted_memory.compacted}/${data.compacted_memory.candidates} archived=${data.compacted_memory.archived} pruned_chunks=${prunedChunks} pruned_symbols=${prunedSymbols}`,
+        `maintain_memory ok dry_run=${data.dry_run} trigger=${data.trigger} compacted=${data.compacted_memory.compacted}/${data.compacted_memory.candidates} archived=${data.compacted_memory.archived} pruned_chunks=${prunedChunks} pruned_symbols=${prunedSymbols} pending_pruned=${pendingPruned} hidden_deleted=${hiddenDeleted} archives_deleted=${archivesDeleted} token_savings_deleted=${tokenSavingsDeleted}`,
     ];
+    if (beforeBytes || afterBytes) {
+        lines.push(`db_size total ${beforeBytes} -> ${afterBytes} bytes`);
+    }
     if (data.compacted_memory.summary_memory_id) {
         lines.push(`summary memory_compaction #${data.compacted_memory.summary_memory_id}`);
     }
@@ -144,6 +175,15 @@ export function compactMaintenanceText(data) {
         for (const s of data.pruned.stale_files.samples.slice(0, 8))
             lines.push(`- ${s}`);
     }
+    if (data.purged_hidden_memory?.samples?.length) {
+        lines.push("hidden memory purge candidates:");
+        for (const s of data.purged_hidden_memory.samples.slice(0, 8)) {
+            lines.push(`- #${s.id} ${s.kind} ${s.file_path ?? ""} ${oneLine(s.title ?? "", 80)} ${s.updated_at}`);
+        }
+    }
+    if (data.fts_optimized || data.wal_checkpointed || data.vacuumed) {
+        lines.push(`sqlite maintenance fts_optimized=${data.fts_optimized === true} wal_checkpointed=${data.wal_checkpointed === true} vacuumed=${data.vacuumed === true}`);
+    }
     lines.push("hint: dry_run=false applies changes; vacuum=true reclaims sqlite file space after pruning");
     return lines.join("\n");
 }
@@ -164,10 +204,37 @@ export function compactPreflightChangeScopeText(data) {
         lines.push(`scope allow_terms=${data.scope_contract.allow_terms.length} deny_terms=${data.scope_contract.deny_terms.length} allowed_paths=${data.scope_contract.allowed_paths.length} denied_paths=${data.scope_contract.denied_paths.length}`);
     }
     lines.push(...compactDevelopmentWarningsText(data.development_warnings));
+    lines.push(...compactQualitySignalsText(data.quality_signals));
     if (!data.development_warnings.length)
         lines.push("- no development warnings");
     return lines.join("\n");
 }
+export function compactPreflightOperationScopeText(data) {
+    const lines = [
+        `preflight_operation_scope ok=${data.ok} safe_to_proceed=${data.safe_to_proceed} advisory_only=${data.advisory_only === true} operation="${oneLine(data.operation, 80)}" commands=${data.planned_commands.length} files=${data.planned_files.length} targets=${data.planned_targets.length}`,
+        `action: ${oneLine(data.recommended_action, 200)}`,
+    ];
+    if (data.current_constraints.length) {
+        lines.push("current_constraints:");
+        for (const c of data.current_constraints.slice(0, 8)) {
+            lines.push(`- #${c.id} ${c.source}/${c.kind} ${oneLine(c.title ?? "", 60)} —${oneLine(c.preview ?? "", 140)}`);
+        }
+    }
+    else {
+        lines.push("current_constraints: none");
+    }
+    if (data.warnings.length) {
+        lines.push("operation warnings:");
+        for (const w of data.warnings.slice(0, 8)) {
+            const ev = w.evidence?.[0] ? ` evidence=#${w.evidence[0].constraint_id}` : "";
+            lines.push(`- ${w.severity} ${w.code}${ev}: ${oneLine(w.message, 180)}`);
+        }
+    }
+    else {
+        lines.push("- no operation warnings");
+    }
+    return lines.join("\n");
+}
 export function compactLargeFileSplitPlanText(data) {
     const lines = [
         `large_file_split ok=${data.ok} file=${data.file_path} lines=${data.line_count} threshold=${data.huge_threshold_lines} action=${data.required_action}`,
@@ -198,6 +265,12 @@ export function compactBootstrapText(data) {
         for (const d of data.decisions.slice(0, 5))
             lines.push(`- ${compactMemoryLabel(d, 160)}`);
     }
+    if (data.current_constraints?.length) {
+        lines.push("current constraints:");
+        for (const c of data.current_constraints.slice(0, 6)) {
+            lines.push(`- #${c.id} ${c.source}/${c.kind} ${oneLine(c.title ?? "", 54)} —${oneLine(c.preview ?? "", 130)}`);
+        }
+    }
     if (data.current_context.length) {
         lines.push("current context:");
         for (const c of data.current_context.slice(0, 8))
@@ -213,6 +286,7 @@ export function compactBootstrapText(data) {
         lines.push("pending 0");
     }
     lines.push(...compactDevelopmentWarningsText(data.development_warnings ?? []));
+    lines.push(...compactQualitySignalsText(data.quality_signals));
     if (data.items.length) {
         lines.push("requirements:");
         for (const item of data.items) {