contextpro-mcp 0.0.0-stage → 1.4.0

package/build/core/project-config.js

@@ -0,0 +1,302 @@
+// Project identity, verification, registry, and pattern promotion utilities
+// FEATURE: Trust foundation for multi-project and multi-client ContextPro usage
+import { execFile } from "child_process";
+import { createHash, randomUUID } from "crypto";
+import { mkdir, open, readFile, rename, unlink, writeFile } from "fs/promises";
+import { homedir } from "os";
+import { basename, join, resolve } from "path";
+import { isDeepStrictEqual, promisify } from "util";
+import { CONTEXTPRO_DIR } from "./data-dir.js";
+const execFileAsync = promisify(execFile);
+const CONFIG_FILE = "config.json";
+const REGISTRY_DIR = CONTEXTPRO_DIR;
+const LEGACY_REGISTRY_DIR = ".contextplus";
+const REGISTRY_FILE = "workspace-registry.json";
+const PATTERN_FILE = "promoted-patterns.json";
+const CONFIG_VERSION = 1;
+function generateId(prefix) {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function normalizeNullable(input) {
+    if (input === undefined || input === null)
+        return null;
+    const trimmed = input.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function defaultProjectId(rootDir) {
+    return basename(resolve(rootDir)).replace(/[^a-zA-Z0-9._-]/g, "-").toLowerCase() || "project";
+}
+function registryBaseDir() {
+    return join(homedir(), REGISTRY_DIR);
+}
+function registryPath() {
+    return join(registryBaseDir(), REGISTRY_FILE);
+}
+function patternPath() {
+    return join(registryBaseDir(), PATTERN_FILE);
+}
+function legacyRegistryPath(fileName) {
+    return join(homedir(), LEGACY_REGISTRY_DIR, fileName);
+}
+async function readJsonFile(path, fallback) {
+    try {
+        return JSON.parse(await readFile(path, "utf-8"));
+    }
+    catch {
+        return fallback;
+    }
+}
+async function readRegistryFile(fileName, fallback) {
+    const current = await readJsonFile(join(registryBaseDir(), fileName), null);
+    if (current !== null)
+        return current;
+    return readJsonFile(legacyRegistryPath(fileName), fallback);
+}
+async function writeJsonFile(path, value) {
+    await mkdir(join(path, ".."), { recursive: true }).catch(() => { });
+    await writeFile(path, JSON.stringify(value, null, 2) + "\n", "utf-8");
+}
+async function detectGitRoot(rootDir) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+            cwd: rootDir,
+            timeout: 4000,
+        });
+        const gitRoot = stdout.trim();
+        return gitRoot.length > 0 ? resolve(gitRoot) : resolve(rootDir);
+    }
+    catch {
+        return resolve(rootDir);
+    }
+}
+async function gitRevParse(rootDir, flag) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", flag], {
+            cwd: rootDir,
+            timeout: 4000,
+        });
+        const value = stdout.trim();
+        return value.length > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the worktree the request belongs to and the shared base checkout.
+ *
+ * Git worktrees share one object store: `git rev-parse --git-common-dir` resolves
+ * to the MAIN repo's `.git` for every linked worktree, while `--git-dir` resolves
+ * to that worktree's private `.git/worktrees/<name>` directory. When the two differ
+ * the caller is inside a linked worktree, and the parent of the common dir is the
+ * base checkout that should own the shared index.
+ */
+export async function detectWorktreeInfo(rootDir) {
+    const worktreeRoot = await detectGitRoot(rootDir);
+    const commonRaw = await gitRevParse(worktreeRoot, "--git-common-dir");
+    const gitDirRaw = await gitRevParse(worktreeRoot, "--git-dir");
+    if (!commonRaw) {
+        // Not a git repo (or git unavailable): the directory is its own base.
+        return { worktreeRoot, baseRoot: worktreeRoot, gitCommonDir: resolve(worktreeRoot, ".git"), isWorktree: false };
+    }
+    const gitCommonDir = resolve(worktreeRoot, commonRaw);
+    const gitDir = gitDirRaw ? resolve(worktreeRoot, gitDirRaw) : gitCommonDir;
+    const isWorktree = gitDir !== gitCommonDir;
+    // The base checkout is the parent of the shared .git directory.
+    const baseRoot = isWorktree ? resolve(gitCommonDir, "..") : worktreeRoot;
+    return { worktreeRoot, baseRoot, gitCommonDir, isWorktree };
+}
+async function detectGitRemote(rootDir) {
+    try {
+        const { stdout } = await execFileAsync("git", ["remote", "get-url", "origin"], {
+            cwd: rootDir,
+            timeout: 4000,
+        });
+        return stdout.trim();
+    }
+    catch {
+        return "";
+    }
+}
+function computeRepoFingerprint(input) {
+    const raw = [
+        input.workspaceRoot,
+        input.gitRoot,
+        input.projectId,
+        input.clientId ?? "",
+        input.remoteUrl,
+    ].join("|");
+    return createHash("sha256").update(raw).digest("hex").slice(0, 16);
+}
+function stringField(record, key) {
+    const value = record?.[key];
+    return typeof value === "string" ? value : undefined;
+}
+function migrateProjectConfig(raw) {
+    if (!raw)
+        return null;
+    const incomingVersion = typeof raw.version === "number" ? raw.version : 0;
+    if (incomingVersion === CONFIG_VERSION)
+        return raw;
+    if (incomingVersion < CONFIG_VERSION) {
+        return { ...raw, version: CONFIG_VERSION };
+    }
+    process.stderr.write(`[contextpro/project-config] config version ${incomingVersion} is newer than supported ${CONFIG_VERSION}; reading as-is\n`);
+    return raw;
+}
+export async function loadProjectConfig(rootDir) {
+    const configPath = join(resolve(rootDir), CONTEXTPRO_DIR, CONFIG_FILE);
+    const raw = await readJsonFile(configPath, null);
+    const migrated = migrateProjectConfig(raw);
+    return migrated;
+}
+export async function ensureProjectConfig(options) {
+    const workspaceRoot = resolve(options.rootDir);
+    const gitRoot = await detectGitRoot(workspaceRoot);
+    const remoteUrl = await detectGitRemote(workspaceRoot);
+    const configPath = join(workspaceRoot, CONTEXTPRO_DIR, CONFIG_FILE);
+    const rawExisting = await readJsonFile(configPath, null);
+    const existing = migrateProjectConfig(rawExisting);
+    const projectId = normalizeNullable(options.projectId) ?? stringField(existing, "projectId") ?? defaultProjectId(workspaceRoot);
+    const clientId = normalizeNullable(options.clientId) ?? normalizeNullable(stringField(existing, "clientId")) ?? null;
+    const sessionSource = normalizeNullable(options.sessionSource) ?? stringField(existing, "sessionSource") ?? "mcp";
+    const repoFingerprint = computeRepoFingerprint({
+        workspaceRoot,
+        gitRoot,
+        projectId,
+        clientId,
+        remoteUrl,
+    });
+    const createdAt = stringField(existing, "createdAt") ?? new Date().toISOString();
+    const config = {
+        ...(existing ?? {}),
+        version: CONFIG_VERSION,
+        clientId,
+        projectId,
+        workspaceRoot,
+        gitRoot,
+        repoFingerprint,
+        sessionSource,
+        createdAt,
+        updatedAt: stringField(existing, "updatedAt") ?? new Date().toISOString(),
+    };
+    // Verification runs before reads as well as writes. Do not turn every read
+    // into a config rewrite just to advance updatedAt (or require writable disk).
+    if (isDeepStrictEqual(rawExisting, config))
+        return config;
+    config.updatedAt = new Date().toISOString();
+    await mkdir(join(workspaceRoot, CONTEXTPRO_DIR), { recursive: true });
+    // A failed write must not truncate the previous identity/provider settings.
+    const temporaryPath = `${configPath}.${randomUUID()}.tmp`;
+    const handle = await open(temporaryPath, "wx", 0o600);
+    try {
+        await handle.writeFile(JSON.stringify(config, null, 2) + "\n", "utf-8");
+        await handle.close();
+        await rename(temporaryPath, configPath);
+    }
+    finally {
+        await handle.close();
+        await unlink(temporaryPath).catch(() => { });
+    }
+    return config;
+}
+export async function verifyProjectContext(rootDir) {
+    const workspaceRoot = resolve(rootDir);
+    const config = await ensureProjectConfig({
+        rootDir: workspaceRoot,
+        clientId: process.env.CONTEXTPRO_CLIENT_ID ?? process.env.CONTEXTPLUS_CLIENT_ID,
+        projectId: process.env.CONTEXTPRO_PROJECT_ID ?? process.env.CONTEXTPLUS_PROJECT_ID,
+        sessionSource: process.env.CONTEXTPRO_SESSION_SOURCE ?? process.env.CONTEXTPLUS_SESSION_SOURCE ?? "mcp",
+    });
+    const actualGitRoot = await detectGitRoot(workspaceRoot);
+    if (config.workspaceRoot !== workspaceRoot) {
+        throw new Error(`Project config workspace root mismatch. Expected ${config.workspaceRoot}, got ${workspaceRoot}.`);
+    }
+    if (config.gitRoot !== actualGitRoot) {
+        throw new Error(`Project config git root mismatch. Expected ${config.gitRoot}, got ${actualGitRoot}.`);
+    }
+    const remoteUrl = await detectGitRemote(workspaceRoot);
+    const actualFingerprint = computeRepoFingerprint({
+        workspaceRoot,
+        gitRoot: actualGitRoot,
+        projectId: config.projectId,
+        clientId: config.clientId,
+        remoteUrl,
+    });
+    if (config.repoFingerprint !== actualFingerprint) {
+        throw new Error(`Project fingerprint mismatch for ${workspaceRoot}. Re-run init or update .contextpro/config.json.`);
+    }
+    return {
+        rootDir: workspaceRoot,
+        gitRoot: actualGitRoot,
+        config,
+        verifiedAt: new Date().toISOString(),
+    };
+}
+export async function registerWorkspace(entry) {
+    const path = registryPath();
+    const items = await readRegistryFile(REGISTRY_FILE, []);
+    const now = new Date().toISOString();
+    const next = {
+        clientId: entry.clientId,
+        projectId: entry.projectId,
+        workspaceRoot: entry.workspaceRoot,
+        gitRoot: entry.gitRoot,
+        repoFingerprint: entry.repoFingerprint,
+        sessionSource: entry.sessionSource,
+        lastActiveAt: now,
+    };
+    const filtered = items.filter((item) => item.workspaceRoot !== entry.workspaceRoot);
+    filtered.push(next);
+    filtered.sort((a, b) => b.lastActiveAt.localeCompare(a.lastActiveAt));
+    await mkdir(registryBaseDir(), { recursive: true });
+    await writeFile(path, JSON.stringify(filtered, null, 2) + "\n", "utf-8");
+}
+const KNOWN_CLI_SUBCOMMANDS = new Set([
+    "init", "skeleton", "tree", "doctor", "reindex", "status", "search", "help",
+    "version", "--help", "-h", "--version", "-v", "list", "ls",
+]);
+function looksLikeCliFlag(projectId) {
+    if (!projectId)
+        return true;
+    if (projectId.startsWith("-"))
+        return true;
+    if (KNOWN_CLI_SUBCOMMANDS.has(projectId.toLowerCase()))
+        return true;
+    return false;
+}
+export async function listRegisteredWorkspaces(clientId) {
+    const items = await readRegistryFile(REGISTRY_FILE, []);
+    // Filter out phantom projects created by accidental CLI invocations like
+    // `npx contextpro --help` or `npx contextpro reindex` outside any project.
+    const filtered = items.filter((item) => !looksLikeCliFlag(item.projectId ?? ""));
+    if (!clientId)
+        return filtered;
+    return filtered.filter((item) => item.clientId === clientId);
+}
+export async function createPromotedPattern(input) {
+    const items = await readRegistryFile(PATTERN_FILE, []);
+    const pattern = {
+        patternId: generateId("pattern"),
+        targetScope: input.targetScope,
+        clientId: input.clientId,
+        projectId: input.projectId,
+        sourceMemoryId: input.sourceMemoryId,
+        summary: input.summary,
+        sanitized: input.sanitize,
+        linkedSource: input.sourceMemoryId,
+        createdAt: new Date().toISOString(),
+    };
+    items.push(pattern);
+    items.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    await mkdir(registryBaseDir(), { recursive: true });
+    await writeFile(patternPath(), JSON.stringify(items, null, 2) + "\n", "utf-8");
+    return pattern;
+}
+export async function listPromotedPatterns(clientId) {
+    const items = await readRegistryFile(PATTERN_FILE, []);
+    if (!clientId)
+        return items;
+    return items.filter((item) => item.clientId === clientId || item.targetScope === "global");
+}
+//# sourceMappingURL=project-config.js.map

package/build/core/project-config.js.map

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

package/build/core/project-graph.d.ts

@@ -0,0 +1,69 @@
+import { type ContextPlusDB } from "./db.js";
+import { type ProjectGraphAnalysis } from "./graph-analytics.js";
+export type GraphNodeType = "project" | "folder" | "file" | "test" | "config" | "document" | "symbol" | "package" | "route";
+export type GraphEdgeType = "contains" | "defines" | "imports" | "calls" | "references" | "tests" | "configures" | "inherits" | "implements" | "route_handles" | "co_changes_with";
+export type GraphConfidence = "SCIP_RESOLVED" | "LSP_RESOLVED" | "AST_EXTRACTED" | "HEURISTIC" | "AMBIGUOUS";
+export interface ProjectGraphNode {
+    id: string;
+    type: GraphNodeType;
+    label: string;
+    path?: string;
+    language?: string | null;
+    lineStart?: number;
+    lineEnd?: number | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ProjectGraphEdge {
+    id: string;
+    type: GraphEdgeType;
+    source: string;
+    target: string;
+    confidence: GraphConfidence;
+    evidence: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ProjectGraph {
+    version: 1;
+    generatedAt: string;
+    rootDir: string;
+    indexGeneration: number;
+    nodes: ProjectGraphNode[];
+    edges: ProjectGraphEdge[];
+    stats: {
+        nodes: number;
+        edges: number;
+        files: number;
+        symbols: number;
+        imports: number;
+        calls: number;
+        tests: number;
+        ambiguousCalls: number;
+    };
+}
+export interface ProjectGraphQueryResult {
+    graph: Pick<ProjectGraph, "generatedAt" | "indexGeneration" | "stats">;
+    nodes: ProjectGraphNode[];
+    edges: ProjectGraphEdge[];
+    analysis?: ProjectGraphAnalysis;
+}
+export declare function buildProjectGraph(rootDir: string): Promise<ProjectGraph>;
+export declare function invalidateProjectGraphCache(rootDir?: string): void;
+export declare function buildProjectGraphFromDB(rootDir: string, db: ContextPlusDB): Promise<ProjectGraph>;
+export declare function formatGraphReport(graph: ProjectGraph): string;
+export declare function formatGraphDashboard(graph: ProjectGraph): string;
+export declare function writeProjectGraphArtifacts(rootDir: string): Promise<{
+    graph: ProjectGraph;
+    graphPath: string;
+    reportPath: string;
+    dashboardPath: string;
+}>;
+export declare function queryProjectGraph(rootDir: string, input: {
+    kind?: "summary" | "file" | "symbol" | "impact" | "path" | "hotspots" | "communities";
+    file?: string;
+    symbol?: string;
+    source?: string;
+    target?: string;
+    maxHops?: number;
+    limit?: number;
+}): Promise<ProjectGraphQueryResult>;
+//# sourceMappingURL=project-graph.d.ts.map

package/build/core/project-graph.d.ts.map

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