contextpro-mcp 0.0.0-stage → 1.5.0

package/build/tools/status.js

@@ -0,0 +1,227 @@
+// Project overview dashboard for instant agent orientation
+// FEATURE: Status — file count, index state, memory stats, recent changes
+import { walkDirectory } from "../core/walker.js";
+import { isSupportedFile } from "../core/parser.js";
+import { getDB } from "../core/db.js";
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { extname } from "path";
+import { loadProjectConfig } from "../core/project-config.js";
+import { getIndexState } from "../core/context-metadata.js";
+import { getToolTimingSnapshots } from "../core/tool-metrics.js";
+import { getRuntimeBuildIdentity } from "../core/startup-health.js";
+import { hasCompatibleEmbeddingModel, getEmbedProvider, getEmbedModel } from "../core/embeddings.js";
+const execFileAsync = promisify(execFile);
+async function gitInfo(rootDir) {
+    try {
+        const { stdout: branch } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: rootDir, timeout: 5000 });
+        const { stdout: status } = await execFileAsync("git", ["status", "--porcelain"], { cwd: rootDir, timeout: 5000 });
+        const uncommitted = status.trim().split("\n").filter((l) => l.trim()).length;
+        const { stdout: log } = await execFileAsync("git", ["log", "--oneline", "-5"], { cwd: rootDir, timeout: 5000 });
+        const recentCommits = log.trim().split("\n").filter((l) => l.trim());
+        return { branch: branch.trim(), uncommitted, recentCommits };
+    }
+    catch {
+        return { branch: "unknown", uncommitted: 0, recentCommits: [] };
+    }
+}
+function detectProjectType(files) {
+    const exts = new Map();
+    for (const f of files) {
+        const ext = extname(f.relativePath).toLowerCase();
+        if (ext)
+            exts.set(ext, (exts.get(ext) ?? 0) + 1);
+    }
+    const sorted = [...exts.entries()].sort((a, b) => b[1] - a[1]);
+    const top = sorted.slice(0, 3).map(([ext, count]) => `${ext} (${count})`).join(", ");
+    const has = (ext) => exts.has(ext);
+    let type = "Unknown";
+    if (has(".ts") || has(".tsx"))
+        type = "TypeScript";
+    else if (has(".js") || has(".jsx"))
+        type = "JavaScript";
+    else if (has(".py"))
+        type = "Python";
+    else if (has(".rs"))
+        type = "Rust";
+    else if (has(".go"))
+        type = "Go";
+    else if (has(".java"))
+        type = "Java";
+    return `${type} — ${top}`;
+}
+export async function getStatusData(options) {
+    const entries = await walkDirectory({ rootDir: options.rootDir, depthLimit: 0 });
+    const allFiles = entries.filter((e) => !e.isDirectory);
+    const sourceFiles = allFiles.filter((e) => isSupportedFile(e.path));
+    const [db, git, config, indexState] = await Promise.all([
+        getDB(options.rootDir),
+        gitInfo(options.rootDir),
+        loadProjectConfig(options.rootDir),
+        getIndexState(options.rootDir),
+    ]);
+    const indexedFiles = db.getAllFiles().filter((file) => isSupportedFile(file.path));
+    const graphStats = db.getGraphStats();
+    const embeddingStats = db.getEmbeddingStats();
+    const staleState = db.isEmbeddingsStale();
+    const lastEmbedSkipped = db.getMeta("last_embed_skipped") === "true";
+    const lastEmbedError = db.getMeta("last_embed_error");
+    const embedProvider = db.getMeta("embed_provider");
+    const embedModel = db.getMeta("embed_model");
+    const efficiency24h = db.getEfficiencyTotals(Date.now() - 24 * 60 * 60_000);
+    const embeddings = {
+        ...embeddingStats,
+        provider: embedProvider,
+        model: embedModel,
+        stale: staleState.stale,
+        staleReason: staleState.reason,
+        lastReindexSkipped: lastEmbedSkipped,
+        lastReindexError: lastEmbedError && lastEmbedError.length > 0 ? lastEmbedError : null,
+    };
+    const staleCount = indexedFiles.filter((f) => !allFiles.some((e) => e.relativePath === f.path)).length;
+    const warnings = [];
+    if (indexState.state === "empty")
+        warnings.push("Index is empty. Run reindex to populate the database.");
+    if (indexState.state === "indexing")
+        warnings.push("Indexing is currently in progress. Waiting for completion is safer than reading partial state.");
+    if (indexState.generation === 0 && indexedFiles.length > 0)
+        warnings.push("Index generation is still 0, so the index cannot be treated as fresh.");
+    if (indexState.missingIndexedFiles > 0)
+        warnings.push(`${indexState.missingIndexedFiles} supported source files are not indexed yet.`);
+    if (indexState.removedIndexedFiles > 0 || staleCount > 0)
+        warnings.push(`${Math.max(indexState.removedIndexedFiles, staleCount)} indexed files no longer match the current workspace.`);
+    if (indexState.state === "stale" && warnings.length === 0)
+        warnings.push("Index is stale. Run reindex to refresh.");
+    if (indexedFiles.length > 0 && embeddings.fileSearch === 0) {
+        if (embeddings.lastReindexSkipped) {
+            warnings.push("Semantic embeddings are skipped (CONTEXTPRO_REINDEX_NO_EMBED or no_embed=true). Search/start_task will fall back to keyword ranking. Run reindex without no_embed to populate.");
+        }
+        else if (embeddings.lastReindexError) {
+            warnings.push(`Semantic embeddings are empty because the last reindex hit an error: ${embeddings.lastReindexError.slice(0, 200)}. Search/start_task will fall back to keyword ranking. Fix the cause and rerun reindex.`);
+        }
+        else if (indexState.state === "empty") {
+            warnings.push("Semantic embeddings are empty because the index has never been built. Run reindex.");
+        }
+        else {
+            warnings.push("Semantic embeddings are empty; discovery uses lexical ranking. Search does not generate corpus embeddings. Configure an embedding provider and run reindex without no_embed to populate them.");
+        }
+    }
+    if (embeddings.stale) {
+        warnings.push(`Embeddings flagged stale: ${embeddings.staleReason ?? "unknown reason"}. Run reindex to rebuild.`);
+    }
+    if (embedModel && !hasCompatibleEmbeddingModel(db)) {
+        warnings.push(`Stored embeddings use ${embedProvider}/${embedModel}; this worker uses ${getEmbedProvider()}/${getEmbedModel()}. Semantic reads ignore incompatible vectors. Align client model settings and reconnect, or explicitly reindex with the intended model.`);
+    }
+    if ((embeddings.total || embeddings.memory) && (!embedProvider || !embedModel)) {
+        warnings.push("Stored vectors have no complete provider/model identity; semantic reads ignore them. Configure the intended model and run reindex with no_embed:false to rebuild.");
+    }
+    return {
+        runtime: { ...getRuntimeBuildIdentity(), pid: process.pid },
+        repo: {
+            root: options.rootDir,
+            projectId: config?.projectId ?? null,
+            clientId: config?.clientId ?? null,
+            gitRoot: config?.gitRoot ?? null,
+            fingerprint: config?.repoFingerprint ?? null,
+        },
+        files: {
+            total: allFiles.length,
+            source: sourceFiles.length,
+            indexed: indexedFiles.length,
+            staleRemoved: staleCount,
+        },
+        index: {
+            generation: indexState.generation,
+            sourceFiles: indexState.sourceFiles,
+            missingIndexedFiles: indexState.missingIndexedFiles,
+            removedIndexedFiles: indexState.removedIndexedFiles,
+            lastIndexedAt: indexState.lastIndexedAt,
+            lastReindexAt: indexState.lastReindexAt,
+            lastReindexDurationMs: indexState.lastReindexDurationMs,
+            autoHubCount: indexState.autoHubCount,
+            indexStartedAt: indexState.indexStartedAt,
+            state: indexState.state,
+        },
+        memory: {
+            nodes: graphStats.totalNodes,
+            edges: graphStats.totalEdges,
+        },
+        embeddings,
+        git,
+        tools: {
+            timings: getToolTimingSnapshots(options.rootDir),
+            efficiency24h: {
+                calls: efficiency24h.calls,
+                savedTokens: efficiency24h.savedTokens,
+                sourceTokens: efficiency24h.sourceTokens,
+                outputTokens: efficiency24h.outputTokens,
+                representedFiles: efficiency24h.representedFiles,
+            },
+        },
+        warnings,
+    };
+}
+export async function getStatus(options) {
+    const snapshot = await getStatusData(options);
+    if (options.format === "json") {
+        return JSON.stringify(snapshot, null, 2);
+    }
+    const projectType = detectProjectType((await walkDirectory({ rootDir: options.rootDir, depthLimit: 0 })).filter((e) => !e.isDirectory));
+    const lines = [
+        `=== ContextPro Status ===`,
+        `Runtime: ${snapshot.runtime.serverVersion} | Build: ${snapshot.runtime.buildStamp ?? "unknown"} | PID: ${snapshot.runtime.pid}`,
+        ``,
+        `Project: ${options.rootDir.split("/").pop()} (${projectType})`,
+        `Project ID: ${snapshot.repo.projectId ?? "unknown"} | Client ID: ${snapshot.repo.clientId ?? "none"}`,
+        `Git Root: ${snapshot.repo.gitRoot ?? "unknown"}`,
+        `Fingerprint: ${snapshot.repo.fingerprint ?? "unknown"}`,
+        `Branch: ${snapshot.git.branch}`,
+        ``,
+        `--- Files ---`,
+        `Total files: ${snapshot.files.total}`,
+        `Source files: ${snapshot.files.source}`,
+        `Indexed in DB: ${snapshot.files.indexed}`,
+        `Stale/removed: ${snapshot.files.staleRemoved}`,
+        ``,
+        `--- Index ---`,
+        `Generation: ${snapshot.index.generation} | State: ${snapshot.index.state}`,
+        `Source files: ${snapshot.index.sourceFiles} | Missing indexed: ${snapshot.index.missingIndexedFiles} | Removed indexed: ${snapshot.index.removedIndexedFiles}`,
+        `Last indexed: ${snapshot.index.lastIndexedAt ?? "unknown"}`,
+        `Index started: ${snapshot.index.indexStartedAt ?? "unknown"}`,
+        `Last full reindex: ${snapshot.index.lastReindexAt ?? "unknown"} (${snapshot.index.lastReindexDurationMs ?? 0}ms)`,
+        `Auto hubs: ${snapshot.index.autoHubCount ?? 0}`,
+        ``,
+        `--- Memory Graph ---`,
+        `Nodes: ${snapshot.memory.nodes}`,
+        `Edges: ${snapshot.memory.edges}`,
+        ``,
+        `--- Embeddings ---`,
+        `Vector tables: ${snapshot.embeddings.vectorTablesReady ? "ready" : "not initialized"} | Dimension: ${snapshot.embeddings.dimension ?? "unknown"}`,
+        `File search: ${snapshot.embeddings.fileSearch} | Identifiers: ${snapshot.embeddings.identifiers} | Memory: ${snapshot.embeddings.memory}`,
+        `Provider: ${snapshot.embeddings.provider ?? "unknown"} | Model: ${snapshot.embeddings.model ?? "unknown"}${snapshot.embeddings.stale ? " | STALE" : ""}`,
+        ``,
+        `--- Git ---`,
+        `Uncommitted changes: ${snapshot.git.uncommitted}`,
+        `Recent commits:`,
+    ];
+    for (const c of snapshot.git.recentCommits)
+        lines.push(`  ${c}`);
+    if (snapshot.tools.timings.length > 0) {
+        lines.push("");
+        lines.push("--- Tool Timings ---");
+        for (const timing of snapshot.tools.timings.slice(0, 8)) {
+            lines.push(`  ${timing.tool}: avg ${timing.avgMs}ms | last ${timing.lastMs}ms | calls ${timing.calls} | errors ${timing.errors}`);
+        }
+    }
+    lines.push("");
+    lines.push("--- Efficiency (24h estimate) ---");
+    lines.push(`  Source tokens avoided: ~${snapshot.tools.efficiency24h.savedTokens.toLocaleString("en-US")} | calls ${snapshot.tools.efficiency24h.calls} | file references ${snapshot.tools.efficiency24h.representedFiles}`);
+    lines.push("  Use efficiency_report for methodology, history, and optional cost scenarios.");
+    if (snapshot.warnings.length > 0) {
+        lines.push(``);
+        for (const warning of snapshot.warnings)
+            lines.push(`⚠ ${warning}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=status.js.map

package/build/tools/status.js.map

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

package/build/tools/symbolic-edit.d.ts

@@ -0,0 +1,57 @@
+import { type SymbolLocation } from "../core/parser.js";
+export interface FindSymbolOptions {
+    rootDir: string;
+    namePathPattern: string;
+    relativePath?: string;
+    includeBody?: boolean;
+    depth?: number;
+    maxMatches?: number;
+    substringMatching?: boolean;
+    includeKinds?: string[];
+    excludeKinds?: string[];
+    format?: "text" | "json";
+}
+export interface SymbolicEditOptions {
+    rootDir: string;
+    relativePath: string;
+    namePath: string;
+    body: string;
+    message?: string;
+    expectedContentHash?: string;
+}
+export interface InsertSymbolOptions {
+    rootDir: string;
+    relativePath: string;
+    namePath: string;
+    body: string;
+    position: "before" | "after";
+    message?: string;
+    expectedContentHash?: string;
+}
+export interface RenameSymbolOptions {
+    rootDir: string;
+    relativePath: string;
+    namePath: string;
+    newName: string;
+    message?: string;
+    expectedContentHash?: string;
+}
+export interface FoundSymbolEntry {
+    name: string;
+    kind: string;
+    namePath: string;
+    path: string;
+    line: number;
+    endLine: number;
+    signature: string;
+    body?: string;
+    contentHash?: string;
+    children?: FoundSymbolEntry[];
+}
+export declare function findSymbol(options: FindSymbolOptions): Promise<string>;
+export declare function replaceSymbolBody(options: SymbolicEditOptions): Promise<string>;
+export declare function insertAroundSymbol(options: InsertSymbolOptions): Promise<string>;
+export declare function renameSymbol(options: RenameSymbolOptions): Promise<string>;
+export declare function assertRenameName(name: string, filePath: string): void;
+export type { SymbolLocation };
+//# sourceMappingURL=symbolic-edit.d.ts.map

package/build/tools/symbolic-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbolic-edit.d.ts","sourceRoot":"","sources":["../../src/tools/symbolic-edit.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiF,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAUvI,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AA6GD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsD5E;AAuID,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAwDD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF;AA6DD,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhF;AA6DD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAiBrE;AAYD,YAAY,EAAE,cAAc,EAAE,CAAC"}