contextpro-mcp 0.0.0-stage → 1.5.0

package/build/core/chat-model.js

@@ -0,0 +1,135 @@
+// Shared chat-model access for local Ollama/OpenAI-assisted ranking and naming
+// FEATURE: Optional LLM helpers for reranking and labeling without hard failure
+import { readFile } from "fs/promises";
+import { join } from "path";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { normalizeProvider, getApiKey, getBaseUrl, getChatModelName } from "./provider-config.js";
+import { observeProviderCall } from "./provider-usage.js";
+let ollamaClient = null;
+const chatSignals = new AsyncLocalStorage();
+async function getOllamaClient() {
+    if (!ollamaClient) {
+        const { Ollama } = await import("ollama");
+        ollamaClient = new Ollama({ host: process.env.OLLAMA_HOST,
+            fetch: (input, init) => fetch(input, { ...init, signal: chatSignals.getStore() ?? init?.signal }),
+        });
+    }
+    return ollamaClient;
+}
+function getErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function formatOllamaChatError(error, model) {
+    const message = getErrorMessage(error);
+    const lower = message.toLowerCase();
+    const installHint = "Install Ollama from https://ollama.com/download, then run `ollama serve`.";
+    const modelHint = `Run \`ollama pull ${model}\`, or set OLLAMA_CHAT_MODEL to any chat model shown by \`ollama list\`.`;
+    if (lower.includes("econnrefused")
+        || lower.includes("fetch failed")
+        || lower.includes("connection refused")
+        || lower.includes("connect")) {
+        return `Ollama is not reachable while loading the chat model "${model}". ${installHint} ${modelHint} Original error: ${message}`;
+    }
+    if (lower.includes("not found") || lower.includes("no such model") || lower.includes("model")) {
+        return `Ollama chat model "${model}" is not available. ${modelHint} Original error: ${message}`;
+    }
+    return `Ollama chat model "${model}" failed. ${installHint} ${modelHint} Original error: ${message}`;
+}
+async function readContextPlusConfig(rootDir) {
+    try {
+        const raw = await readFile(join(rootDir, ".contextpro", "config.json"), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// Resolve the chat provider, honoring an explicit CONTEXTPRO_CHAT_PROVIDER, then the general
+// provider keys, then a per-project .contextpro/config.json `provider`, then default ollama.
+function resolveChatProvider(config) {
+    const raw = process.env.CONTEXTPRO_CHAT_PROVIDER
+        ?? process.env.CONTEXTPLUS_CHAT_PROVIDER
+        ?? process.env.CONTEXTPRO_PROVIDER
+        ?? process.env.CONTEXTPRO_EMBED_PROVIDER
+        ?? process.env.CONTEXTPLUS_EMBED_PROVIDER
+        ?? config?.provider
+        ?? "ollama";
+    return normalizeProvider(raw);
+}
+export async function hasConfiguredChatModel(rootDir) {
+    const config = await readContextPlusConfig(rootDir);
+    const provider = resolveChatProvider(config);
+    if (provider === "openai") {
+        return Boolean(getApiKey());
+    }
+    return Boolean(process.env.CONTEXTPRO_CHAT_MODEL ?? process.env.OLLAMA_CHAT_MODEL ?? config?.chatModel);
+}
+export async function chatModelIdentity(rootDir) {
+    const config = await readContextPlusConfig(rootDir);
+    const provider = resolveChatProvider(config);
+    const model = provider === "openai" ? getChatModelName("openai") : process.env.CONTEXTPRO_CHAT_MODEL ?? process.env.OLLAMA_CHAT_MODEL ?? config?.chatModel ?? getChatModelName("ollama");
+    return `${provider}:${model}`;
+}
+export async function chatCompletion(rootDir, prompt, options = {}) {
+    const signal = AbortSignal.timeout(options.timeoutMs ?? 60_000);
+    const config = await readContextPlusConfig(rootDir);
+    const provider = resolveChatProvider(config);
+    if (provider === "openai") {
+        const apiKey = getApiKey();
+        if (!apiKey)
+            throw new Error("OpenAI-compatible chat requested but no API key is configured. Set CONTEXTPRO_API_KEY.");
+        const model = getChatModelName("openai");
+        const data = await observeProviderCall({ kind: "chat", provider: "openai", model }, async () => {
+            const response = await fetch(`${getBaseUrl().replace(/\/+$/, "")}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    model,
+                    messages: [{ role: "user", content: prompt }],
+                    stream: false,
+                    ...(options.maxOutputTokens ? { max_tokens: options.maxOutputTokens } : {}),
+                }),
+                signal,
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => "");
+                throw new Error(`OpenAI-compatible chat API error ${response.status}: ${body}`);
+            }
+            return await response.json();
+        }, result => ({ input: result.usage?.prompt_tokens, output: result.usage?.completion_tokens, cached: result.usage?.prompt_tokens_details?.cached_tokens }));
+        return data.choices[0]?.message?.content ?? "";
+    }
+    const model = process.env.CONTEXTPRO_CHAT_MODEL ?? process.env.OLLAMA_CHAT_MODEL ?? config?.chatModel ?? getChatModelName("ollama");
+    if (!model)
+        throw new Error("No Ollama chat model is configured.");
+    const client = await getOllamaClient();
+    try {
+        const response = await observeProviderCall({ kind: "chat", provider: "ollama", model }, () => chatSignals.run(signal, () => client.chat({
+            model,
+            messages: [{ role: "user", content: prompt }],
+            stream: false,
+            ...(options.maxOutputTokens ? { options: { num_predict: options.maxOutputTokens } } : {}),
+        })), result => ({ input: result.prompt_eval_count, output: result.eval_count }));
+        return response.message.content;
+    }
+    catch (error) {
+        throw new Error(formatOllamaChatError(error, model));
+    }
+}
+export function extractJsonBlock(raw) {
+    const trimmed = raw.trim();
+    if ((trimmed.startsWith("{") && trimmed.endsWith("}")) || (trimmed.startsWith("[") && trimmed.endsWith("]"))) {
+        return trimmed;
+    }
+    const arrayMatch = raw.match(/\[[\s\S]*\]/);
+    if (arrayMatch)
+        return arrayMatch[0];
+    const objectMatch = raw.match(/\{[\s\S]*\}/);
+    return objectMatch ? objectMatch[0] : null;
+}
+//# sourceMappingURL=chat-model.js.map

package/build/core/chat-model.js.map

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

package/build/core/clustering.d.ts

@@ -0,0 +1,6 @@
+export interface ClusterResult {
+    indices: number[];
+}
+export declare function spectralCluster(vectors: number[][], maxClusters?: number): ClusterResult[];
+export declare function findPathPattern(paths: string[]): string | null;
+//# sourceMappingURL=clustering.d.ts.map

package/build/core/clustering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clustering.d.ts","sourceRoot":"","sources":["../../src/core/clustering.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAiID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAE,MAAW,GAAG,aAAa,EAAE,CAsC9F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAqB9D"}

package/build/core/clustering.js

@@ -0,0 +1,201 @@
+// Spectral clustering with eigengap heuristic for tuning-free cluster counts
+// Builds affinity matrix, normalized Laplacian, k-means on eigenvectors
+import { Matrix, EigenvalueDecomposition } from "ml-matrix";
+function cosine(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function buildAffinityMatrix(vectors) {
+    const n = vectors.length;
+    const data = new Array(n);
+    for (let i = 0; i < n; i++) {
+        data[i] = new Array(n);
+        data[i][i] = 0;
+        for (let j = i + 1; j < n; j++) {
+            const sim = Math.max(0, cosine(vectors[i], vectors[j]));
+            data[i][j] = sim;
+        }
+        for (let j = 0; j < i; j++) {
+            data[i][j] = data[j][i];
+        }
+    }
+    return new Matrix(data);
+}
+function normalizedLaplacian(affinity) {
+    const n = affinity.rows;
+    const degrees = new Array(n);
+    for (let i = 0; i < n; i++) {
+        let sum = 0;
+        for (let j = 0; j < n; j++) {
+            if (i !== j)
+                sum += affinity.get(i, j);
+        }
+        degrees[i] = sum;
+    }
+    const data = new Array(n);
+    for (let i = 0; i < n; i++) {
+        data[i] = new Array(n);
+        for (let j = 0; j < n; j++) {
+            if (i === j) {
+                data[i][j] = 1;
+            }
+            else {
+                const di = degrees[i];
+                const dj = degrees[j];
+                data[i][j] = (di > 1e-10 && dj > 1e-10) ? -affinity.get(i, j) / Math.sqrt(di * dj) : 0;
+            }
+        }
+    }
+    return new Matrix(data);
+}
+function findOptimalK(eigenvalues, maxK) {
+    const sorted = [...eigenvalues].sort((a, b) => a - b);
+    if (sorted.length <= 2)
+        return Math.min(2, sorted.length);
+    let bestGap = 0;
+    let bestK = 2;
+    const limit = Math.min(maxK, sorted.length - 1);
+    for (let k = 2; k <= limit; k++) {
+        const gap = sorted[k] - sorted[k - 1];
+        if (gap > bestGap) {
+            bestGap = gap;
+            bestK = k;
+        }
+    }
+    return bestK;
+}
+function kMeans(data, k) {
+    const n = data.length;
+    const dim = data[0].length;
+    const centroids = [];
+    const used = new Set();
+    centroids.push([...data[0]]);
+    used.add(0);
+    for (let c = 1; c < k; c++) {
+        let bestIdx = 0;
+        let bestDist = -1;
+        for (let i = 0; i < n; i++) {
+            if (used.has(i))
+                continue;
+            let minDist = Infinity;
+            for (const cen of centroids) {
+                let d = 0;
+                for (let d2 = 0; d2 < dim; d2++)
+                    d += (data[i][d2] - cen[d2]) ** 2;
+                minDist = Math.min(minDist, d);
+            }
+            if (minDist > bestDist) {
+                bestDist = minDist;
+                bestIdx = i;
+            }
+        }
+        centroids.push([...data[bestIdx]]);
+        used.add(bestIdx);
+    }
+    const assignments = new Array(n).fill(0);
+    for (let iter = 0; iter < 50; iter++) {
+        let changed = false;
+        for (let i = 0; i < n; i++) {
+            let bestDist = Infinity;
+            let bestC = 0;
+            for (let c = 0; c < k; c++) {
+                let dist = 0;
+                for (let d = 0; d < dim; d++)
+                    dist += (data[i][d] - centroids[c][d]) ** 2;
+                if (dist < bestDist) {
+                    bestDist = dist;
+                    bestC = c;
+                }
+            }
+            if (assignments[i] !== bestC) {
+                assignments[i] = bestC;
+                changed = true;
+            }
+        }
+        if (!changed)
+            break;
+        for (let c = 0; c < k; c++) {
+            const members = [];
+            for (let i = 0; i < n; i++)
+                if (assignments[i] === c)
+                    members.push(i);
+            if (members.length === 0)
+                continue;
+            for (let d = 0; d < dim; d++) {
+                let sum = 0;
+                for (const m of members)
+                    sum += data[m][d];
+                centroids[c][d] = sum / members.length;
+            }
+        }
+    }
+    return assignments;
+}
+export function spectralCluster(vectors, maxClusters = 20) {
+    const n = vectors.length;
+    if (n <= 1)
+        return [{ indices: Array.from({ length: n }, (_, i) => i) }];
+    if (n <= maxClusters)
+        return vectors.map((_, i) => ({ indices: [i] }));
+    const affinity = buildAffinityMatrix(vectors);
+    const laplacian = normalizedLaplacian(affinity);
+    const eigen = new EigenvalueDecomposition(laplacian);
+    const eigenvalues = eigen.realEigenvalues;
+    const eigenvectors = eigen.eigenvectorMatrix;
+    const k = findOptimalK(eigenvalues, Math.min(maxClusters, Math.max(2, Math.floor(Math.sqrt(n)))));
+    const sortedIndices = eigenvalues
+        .map((v, i) => ({ v, i }))
+        .sort((a, b) => a.v - b.v)
+        .map((x) => x.i);
+    const embedding = [];
+    for (let i = 0; i < n; i++) {
+        const row = [];
+        for (let j = 0; j < k; j++)
+            row.push(eigenvectors.get(i, sortedIndices[j]));
+        const norm = Math.sqrt(row.reduce((s, v) => s + v * v, 0));
+        if (norm > 1e-10)
+            for (let d = 0; d < row.length; d++)
+                row[d] /= norm;
+        embedding.push(row);
+    }
+    const assignments = kMeans(embedding, k);
+    const clusters = new Map();
+    for (let i = 0; i < n; i++) {
+        const c = assignments[i];
+        if (!clusters.has(c))
+            clusters.set(c, []);
+        clusters.get(c).push(i);
+    }
+    return Array.from(clusters.values()).map((indices) => ({ indices }));
+}
+export function findPathPattern(paths) {
+    if (paths.length <= 1)
+        return null;
+    const parts = paths.map((p) => p.split("/"));
+    let commonPrefix = "";
+    const minLen = Math.min(...parts.map((p) => p.length));
+    for (let i = 0; i < minLen - 1; i++) {
+        if (parts.every((p) => p[i] === parts[0][i])) {
+            commonPrefix += parts[0][i] + "/";
+        }
+        else {
+            break;
+        }
+    }
+    const suffixes = paths.map((p) => p.split("/").pop());
+    const allSameSuffix = suffixes.every((s) => s === suffixes[0]);
+    if (commonPrefix && allSameSuffix)
+        return `${commonPrefix}${suffixes[0]}`;
+    if (commonPrefix)
+        return `${commonPrefix}*`;
+    if (allSameSuffix)
+        return `*/${suffixes[0]}`;
+    return null;
+}
+//# sourceMappingURL=clustering.js.map

package/build/core/clustering.js.map

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

package/build/core/context-metadata.d.ts

@@ -0,0 +1,50 @@
+import type { ArtifactReference } from "./artifacts.js";
+export interface IndexState {
+    generation: number;
+    indexedFiles: number;
+    sourceFiles: number;
+    missingIndexedFiles: number;
+    removedIndexedFiles: number;
+    changedIndexedFiles?: number;
+    lastIndexedAt: string | null;
+    lastReindexAt: string | null;
+    lastReindexDurationMs: number | null;
+    autoHubCount: number | null;
+    indexStartedAt: string | null;
+    state: "empty" | "indexing" | "stale" | "fresh";
+}
+export interface FreshnessMetadata {
+    staleCount: number;
+    refreshed: boolean;
+    warning: string | null;
+    indexGeneration: number;
+    indexedFiles: number;
+    lastIndexedAt: string | null;
+    lastReindexAt: string | null;
+    lastReindexDurationMs: number | null;
+    autoHubCount: number | null;
+    indexState: "empty" | "indexing" | "fresh" | "stale" | "refreshed";
+}
+export interface TrustMetadata {
+    confidence: number;
+    evidence: string[];
+    ambiguities: string[];
+    freshness: FreshnessMetadata;
+    artifact: ArtifactReference | null;
+}
+export declare function getIndexState(rootDir: string): Promise<IndexState>;
+export declare function buildFreshnessMetadata(indexState: IndexState, input: {
+    staleCount: number;
+    refreshed: boolean;
+    warning: string | null;
+    complete?: boolean;
+    remainingStaleCount?: number;
+}): FreshnessMetadata;
+export declare function buildTrustMetadata(input: {
+    baseConfidence?: number;
+    freshness: FreshnessMetadata;
+    evidence?: string[];
+    ambiguities?: string[];
+    artifact?: ArtifactReference | null;
+}): TrustMetadata;
+//# sourceMappingURL=context-metadata.d.ts.map

package/build/core/context-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-metadata.d.ts","sourceRoot":"","sources":["../../src/core/context-metadata.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;CACpE;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACpC;AAgBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CxE;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1H,iBAAiB,CAsBnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACrC,GAAG,aAAa,CAkBhB"}

package/build/core/context-metadata.js

@@ -0,0 +1,118 @@
+// Shared repo, freshness, and trust metadata for agent-facing JSON responses
+// FEATURE: Trust envelope — explicit index state, evidence, and confidence
+import { getDB, hashContent } from "./db.js";
+import { stat } from "node:fs/promises";
+import { matchesFileFingerprint, readSourceSnapshot } from "./file-fingerprint.js";
+import { walkDirectory } from "./walker.js";
+import { isSupportedFile } from "./parser.js";
+function parseNumber(value) {
+    if (!value)
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function toIso(timestamp) {
+    return timestamp ? new Date(timestamp).toISOString() : null;
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+export async function getIndexState(rootDir) {
+    const db = await getDB(rootDir);
+    const latestIndexedAt = db.getLatestIndexedAt();
+    const indexedSourceFiles = db.getAllFiles().filter((file) => isSupportedFile(file.path));
+    const indexedFiles = indexedSourceFiles.length;
+    const indexedPaths = new Set(indexedSourceFiles.map((file) => file.path));
+    const entries = await walkDirectory({ rootDir, depthLimit: 0 });
+    const sourceEntries = entries.filter((entry) => !entry.isDirectory && isSupportedFile(entry.path));
+    const sourcePaths = new Set(sourceEntries.map((entry) => entry.relativePath));
+    const missingIndexedFiles = sourceEntries.filter((entry) => !indexedPaths.has(entry.relativePath)).length;
+    const removedIndexedFiles = db.getRemovedFiles(sourcePaths).length;
+    const indexedByPath = new Map(indexedSourceFiles.map(file => [file.path, file]));
+    let changedIndexedFiles = 0;
+    for (const entry of sourceEntries) {
+        const indexed = indexedByPath.get(entry.relativePath);
+        if (!indexed)
+            continue;
+        try {
+            if (matchesFileFingerprint(indexed, await stat(entry.path)))
+                continue;
+            if (hashContent((await readSourceSnapshot(entry.path)).content) !== indexed.content_hash)
+                changedIndexedFiles++;
+        }
+        catch {
+            changedIndexedFiles++;
+        }
+    }
+    const generation = db.getIndexGeneration();
+    const activeStatus = db.getMeta("index_status");
+    const state = activeStatus === "indexing"
+        ? "indexing"
+        : indexedFiles === 0
+            ? "empty"
+            : db.getMeta("index_repair_required") === "1" || generation === 0 || changedIndexedFiles > 0 || missingIndexedFiles > 0 || removedIndexedFiles > 0 || sourceEntries.length !== indexedFiles
+                ? "stale"
+                : "fresh";
+    return {
+        generation,
+        indexedFiles,
+        sourceFiles: sourceEntries.length,
+        missingIndexedFiles,
+        removedIndexedFiles,
+        changedIndexedFiles,
+        lastIndexedAt: toIso(latestIndexedAt),
+        lastReindexAt: toIso(parseNumber(db.getMeta("last_reindex_at"))),
+        lastReindexDurationMs: parseNumber(db.getMeta("last_reindex_duration_ms")),
+        autoHubCount: parseNumber(db.getMeta("last_auto_hub_count")),
+        indexStartedAt: toIso(parseNumber(db.getMeta("index_started_at"))),
+        state,
+    };
+}
+export function buildFreshnessMetadata(indexState, input) {
+    const indexStateLabel = indexState.state === "empty"
+        ? "empty"
+        : indexState.state === "indexing"
+            ? "indexing"
+            : input.complete === false || (input.remainingStaleCount ?? 0) > 0 || indexState.state === "stale"
+                ? "stale"
+                : input.staleCount > 0
+                    ? input.refreshed ? "refreshed" : "stale"
+                    : "fresh";
+    return {
+        staleCount: input.staleCount,
+        refreshed: input.refreshed,
+        warning: input.warning,
+        indexGeneration: indexState.generation,
+        indexedFiles: indexState.indexedFiles,
+        lastIndexedAt: indexState.lastIndexedAt,
+        lastReindexAt: indexState.lastReindexAt,
+        lastReindexDurationMs: indexState.lastReindexDurationMs,
+        autoHubCount: indexState.autoHubCount,
+        indexState: indexStateLabel,
+    };
+}
+export function buildTrustMetadata(input) {
+    const evidence = [...new Set((input.evidence ?? []).filter(Boolean))];
+    const ambiguities = [...new Set((input.ambiguities ?? []).filter(Boolean))];
+    let confidence = input.baseConfidence ?? 0.72;
+    confidence += Math.min(evidence.length, 4) * 0.04;
+    confidence -= Math.min(ambiguities.length, 3) * 0.08;
+    if (input.freshness.indexState === "empty")
+        confidence -= 0.25;
+    if (input.freshness.indexState === "indexing")
+        confidence -= 0.14;
+    if (input.freshness.indexState === "stale")
+        confidence -= 0.18;
+    if (input.freshness.indexState === "refreshed")
+        confidence -= 0.08;
+    if (input.freshness.warning)
+        confidence -= 0.03;
+    return {
+        confidence: clamp(Number(confidence.toFixed(2)), 0.1, 0.99),
+        evidence,
+        ambiguities,
+        freshness: input.freshness,
+        artifact: input.artifact ?? null,
+    };
+}
+//# sourceMappingURL=context-metadata.js.map

package/build/core/context-metadata.js.map

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

package/build/core/data-dir.d.ts

@@ -0,0 +1,5 @@
+export declare const CONTEXTPRO_DIR = ".contextpro";
+export declare const LEGACY_CONTEXT_DIRS: readonly [".contextplus", ".mcp_data"];
+export declare function migrateLegacyProjectData(rootDir: string): Promise<string | null>;
+export declare function ensureContextProDir(rootDir: string): Promise<string | null>;
+//# sourceMappingURL=data-dir.d.ts.map

package/build/core/data-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-dir.d.ts","sourceRoot":"","sources":["../../src/core/data-dir.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,mBAAmB,wCAAyC,CAAC;AAc1E,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBtF;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWjF"}

package/build/core/data-dir.js

@@ -0,0 +1,61 @@
+// Canonical ContextPro project storage and one-way migration from legacy names.
+import { cp, mkdir, rename, rm, stat, writeFile } from "fs/promises";
+import { join } from "path";
+import { resolveProjectPath } from "./path-guard.js";
+export const CONTEXTPRO_DIR = ".contextpro";
+export const LEGACY_CONTEXT_DIRS = [".contextplus", ".mcp_data"];
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[contextpro/data-dir] stat failed for ${path}: ${message}\n`);
+        return false;
+    }
+}
+export async function migrateLegacyProjectData(rootDir) {
+    const destination = resolveProjectPath(rootDir, CONTEXTPRO_DIR);
+    if (await pathExists(destination))
+        return null;
+    for (const legacyName of LEGACY_CONTEXT_DIRS) {
+        const source = resolveProjectPath(rootDir, legacyName);
+        if (!(await pathExists(source)))
+            continue;
+        try {
+            await rename(source, destination);
+        }
+        catch (renameError) {
+            const renameMessage = renameError instanceof Error ? renameError.message : String(renameError);
+            process.stderr.write(`[contextpro/data-dir] rename ${legacyName} → ${CONTEXTPRO_DIR} failed (${renameMessage}); falling back to recursive copy\n`);
+            try {
+                await cp(source, destination, { recursive: true, force: true });
+                await rm(source, { recursive: true, force: true });
+            }
+            catch (copyError) {
+                const copyMessage = copyError instanceof Error ? copyError.message : String(copyError);
+                throw new Error(`Failed to migrate legacy directory ${legacyName} to ${CONTEXTPRO_DIR}: ${copyMessage}`);
+            }
+        }
+        return legacyName;
+    }
+    return null;
+}
+export async function ensureContextProDir(rootDir) {
+    const migratedFrom = await migrateLegacyProjectData(rootDir);
+    await mkdir(resolveProjectPath(rootDir, join(CONTEXTPRO_DIR, "backups")), { recursive: true });
+    await mkdir(resolveProjectPath(rootDir, join(CONTEXTPRO_DIR, "hubs")), { recursive: true });
+    // Local index state must not be committed; "wx" never overwrites a user-edited file.
+    try {
+        await writeFile(resolveProjectPath(rootDir, join(CONTEXTPRO_DIR, ".gitignore")), "*\n", { flag: "wx" });
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+    }
+    return migratedFrom;
+}
+//# sourceMappingURL=data-dir.js.map

package/build/core/data-dir.js.map

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