@blxzer/pactile 0.5.0

package/dist/utils/readiness.js.map

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

package/dist/utils/retrieval-agent-instructions.d.ts

@@ -0,0 +1,10 @@
+import type { CodebaseRetrievalPlanEnvelope } from "./codebase-retrieval-router.js";
+export declare function guessSymbolFromQuery(query: string): string | null;
+export interface RenderAgentInstructionsOptions {
+    readonly locale?: "zh" | "en";
+}
+export declare function renderAgentInstructions(plan: CodebaseRetrievalPlanEnvelope, options?: RenderAgentInstructionsOptions | "zh" | "en"): string;
+export declare function attachAgentInstructions(plan: CodebaseRetrievalPlanEnvelope, options?: RenderAgentInstructionsOptions | "zh" | "en"): CodebaseRetrievalPlanEnvelope & {
+    readonly agentInstructions: string;
+};
+//# sourceMappingURL=retrieval-agent-instructions.d.ts.map

package/dist/utils/retrieval-agent-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-agent-instructions.d.ts","sourceRoot":"","sources":["../../src/utils/retrieval-agent-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAE9B,MAAM,gCAAgC,CAAC;AAiBxC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjE;AAwDD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE,8BAA8B,GAAG,IAAI,GAAG,IAAS,GACzD,MAAM,CAuCR;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,6BAA6B,EACnC,OAAO,GAAE,8BAA8B,GAAG,IAAI,GAAG,IAAS,GACzD,6BAA6B,GAAG;IAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAKxE"}

package/dist/utils/retrieval-agent-instructions.js

@@ -0,0 +1,97 @@
+import { semanticComplianceGateHint } from "./semantic-plan-gate.js";
+const SYMBOL_CANDIDATE = /(?:`([^`]+)`|\b([A-Za-z_$][A-Za-z0-9_$]{2,})\b)/g;
+const SKIP_SYMBOLS = new Set([
+    "where",
+    "which",
+    "what",
+    "when",
+    "how",
+    "does",
+    "find",
+    "show",
+    "source",
+    "exact",
+]);
+export function guessSymbolFromQuery(query) {
+    const matches = [...query.matchAll(SYMBOL_CANDIDATE)];
+    for (const match of matches) {
+        const candidate = (match[1] ?? match[2] ?? "").trim();
+        if (candidate && !SKIP_SYMBOLS.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    return null;
+}
+function intentLabel(intent, locale) {
+    if (locale === "en")
+        return intent;
+    switch (intent) {
+        case "exact":
+            return "精确";
+        case "semantic":
+            return "语义";
+        case "structural":
+            return "结构";
+        case "external":
+            return "外部";
+    }
+}
+function stepInstruction(plan, index, locale) {
+    const step = plan.steps[index];
+    if (step.kind === "local-exact") {
+        const symbol = guessSymbolFromQuery(plan.query);
+        if (locale === "en") {
+            return symbol
+                ? `Use \`rg\` for the exact candidate \`${symbol}\` within the declared scope hints.`
+                : "Use `rg` for bounded local text, path, or symbol candidates within the declared scope hints.";
+        }
+        return symbol
+            ? `在声明的 scope hints 内用 \`rg\` 精确定位候选 \`${symbol}\`。`
+            : "在声明的 scope hints 内用 `rg` 做有界的本地文本、路径或符号定位。";
+    }
+    const requirement = step.providerRequirement;
+    if (!requirement) {
+        return locale === "en"
+            ? "Stop because the Provider requirement is missing."
+            : "Provider requirement 缺失，停止执行。";
+    }
+    if (locale === "en") {
+        return (`Request the \`${step.intent}\` intent from the project resolver with minimum assurance ` +
+            `\`${requirement.minimumAssurance}\` and status \`${requirement.status}\`. ` +
+            "Do not infer or choose an implementation in the planner.");
+    }
+    return (`向项目 Resolver 请求 \`${step.intent}\` intent，最低 assurance 为 ` +
+        `\`${requirement.minimumAssurance}\`，当前状态为 \`${requirement.status}\`。` +
+        "不得在 Planner 或说明文本中推断、选择具体实现。");
+}
+export function renderAgentInstructions(plan, options = {}) {
+    const locale = typeof options === "string" ? options : (options.locale ?? "zh");
+    const lines = [];
+    if (locale === "en") {
+        lines.push(`Retrieval plan V${plan.schemaVersion}`, `Intents: ${plan.intents.map((intent) => intentLabel(intent, locale)).join(", ")}`, `Minimum assurance: ${plan.minimumAssurance}`, "");
+    }
+    else {
+        lines.push(`检索计划 V${plan.schemaVersion}`, `意图：${plan.intents.map((intent) => intentLabel(intent, locale)).join("、")}`, `最低 assurance：${plan.minimumAssurance}`, "");
+    }
+    for (let index = 0; index < plan.steps.length; index += 1) {
+        lines.push(`${index + 1}. ${stepInstruction(plan, index, locale)}`);
+    }
+    lines.push("", locale === "en"
+        ? "Verification: candidate -> corroborate with source/Git/repeatable tests -> classify evidence -> check assurance -> accept or stop."
+        : "验证链：candidate → 源码/Git/可重复测试佐证 → Evidence 分类 → assurance 检查 → 接受或停止。");
+    const semanticGate = semanticComplianceGateHint(plan, locale);
+    if (semanticGate)
+        lines.push("", semanticGate);
+    if (plan.stopReasons.length > 0) {
+        lines.push("", locale === "en"
+            ? `Blocking reasons: ${plan.stopReasons.map((reason) => reason.code).join(", ")}`
+            : `阻断原因：${plan.stopReasons.map((reason) => reason.code).join("、")}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function attachAgentInstructions(plan, options = {}) {
+    return {
+        ...plan,
+        agentInstructions: renderAgentInstructions(plan, options),
+    };
+}
+//# sourceMappingURL=retrieval-agent-instructions.js.map

package/dist/utils/retrieval-agent-instructions.js.map

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

package/dist/utils/retrieval-execution-telemetry.d.ts

@@ -0,0 +1,53 @@
+import type { AssuranceLevelV1, PactileIntentV1 } from "@blxzer/pactile-core";
+import type { CodebaseRetrievalPlanEnvelope } from "./codebase-retrieval-router.js";
+import { type ClassifiedToolCalls } from "./retrieval-tool-classification.js";
+export declare const RETRIEVAL_TELEMETRY_SCHEMA_VERSION: 3;
+export interface RetrievalPlanFacts {
+    readonly plan_fingerprint: string;
+    readonly planned_intents: readonly PactileIntentV1[];
+    readonly minimum_assurance: AssuranceLevelV1;
+    readonly provider_request_intents: readonly PactileIntentV1[];
+    readonly blocking_reason_codes: readonly string[];
+}
+export interface RetrievalQueryTelemetry extends RetrievalPlanFacts {
+    readonly schema_version: typeof RETRIEVAL_TELEMETRY_SCHEMA_VERSION;
+    readonly query_id: string;
+    readonly observations: ClassifiedToolCalls;
+    readonly corroboration_kinds: readonly string[];
+    readonly accepted: boolean;
+    readonly achieved_assurance: AssuranceLevelV1 | null;
+    readonly compliance_score: number;
+}
+export interface RetrievalTelemetryMetrics {
+    readonly total_queries: number;
+    readonly accepted_queries: number;
+    readonly intent_plan_counts: Readonly<Record<PactileIntentV1, number>>;
+    readonly intent_execution_counts: Readonly<Record<PactileIntentV1, number>>;
+    readonly corroborated_queries: number;
+    readonly average_compliance_score: number;
+}
+export declare function planFactsFromEnvelope(plan: CodebaseRetrievalPlanEnvelope): RetrievalPlanFacts;
+export declare function computeComplianceScore(plan: CodebaseRetrievalPlanEnvelope, observations: ClassifiedToolCalls, corroborationKinds: readonly string[]): number;
+export declare function createRetrievalTelemetry(input: {
+    readonly queryId: string;
+    readonly plan: CodebaseRetrievalPlanEnvelope;
+    readonly toolsCalled?: readonly string[];
+    readonly corroborationKinds?: readonly string[];
+    readonly accepted?: boolean;
+    readonly achievedAssurance?: AssuranceLevelV1 | null;
+}): RetrievalQueryTelemetry;
+export declare function applyToolClassification(record: Omit<RetrievalQueryTelemetry, "observations" | "compliance_score">, plan: CodebaseRetrievalPlanEnvelope, toolsCalled: readonly string[]): RetrievalQueryTelemetry;
+export declare function withDerivedComplianceScore(record: Omit<RetrievalQueryTelemetry, "compliance_score">, plan: CodebaseRetrievalPlanEnvelope): RetrievalQueryTelemetry;
+export declare function deriveRetrievalTelemetryMetrics(records: readonly RetrievalQueryTelemetry[]): RetrievalTelemetryMetrics;
+export declare function migrateTelemetryRecord(record: Partial<RetrievalQueryTelemetry>, plan: CodebaseRetrievalPlanEnvelope): RetrievalQueryTelemetry;
+export declare const RETRIEVAL_TELEMETRY_EXAMPLES: Readonly<{
+    exact: {
+        planned_intents: string[];
+        corroboration_kinds: string[];
+    };
+    multiIntent: {
+        planned_intents: string[];
+        corroboration_kinds: string[];
+    };
+}>;
+//# sourceMappingURL=retrieval-execution-telemetry.d.ts.map

package/dist/utils/retrieval-execution-telemetry.d.ts.map

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

package/dist/utils/retrieval-execution-telemetry.js

@@ -0,0 +1,116 @@
+import { classifyToolCalls, observedIntentCount, } from "./retrieval-tool-classification.js";
+export const RETRIEVAL_TELEMETRY_SCHEMA_VERSION = 3;
+function emptyIntentCounts() {
+    return { exact: 0, semantic: 0, structural: 0, external: 0 };
+}
+export function planFactsFromEnvelope(plan) {
+    return {
+        plan_fingerprint: plan.fingerprint,
+        planned_intents: [...plan.intents],
+        minimum_assurance: plan.minimumAssurance,
+        provider_request_intents: plan.steps
+            .filter((step) => step.kind === "provider-request")
+            .map((step) => step.intent),
+        blocking_reason_codes: plan.stopReasons
+            .filter((reason) => reason.blocking)
+            .map((reason) => reason.code),
+    };
+}
+export function computeComplianceScore(plan, observations, corroborationKinds) {
+    if (plan.intents.length === 0)
+        return 0;
+    const executed = plan.intents.filter((intent) => observedIntentCount(observations, intent) > 0).length;
+    const intentScore = executed / plan.intents.length;
+    const corroborated = corroborationKinds.some((kind) => ["source-reference", "git-evidence", "repeatable-test"].includes(kind));
+    const evidenceScore = corroborated ? 1 : 0;
+    return Number((intentScore * 0.7 + evidenceScore * 0.3).toFixed(6));
+}
+export function createRetrievalTelemetry(input) {
+    const observations = classifyToolCalls(input.toolsCalled ?? []);
+    const corroborationKinds = [
+        ...new Set(input.corroborationKinds ?? []),
+    ].sort();
+    return {
+        schema_version: RETRIEVAL_TELEMETRY_SCHEMA_VERSION,
+        query_id: input.queryId,
+        ...planFactsFromEnvelope(input.plan),
+        observations,
+        corroboration_kinds: corroborationKinds,
+        accepted: input.accepted ?? false,
+        achieved_assurance: input.achievedAssurance ?? null,
+        compliance_score: computeComplianceScore(input.plan, observations, corroborationKinds),
+    };
+}
+export function applyToolClassification(record, plan, toolsCalled) {
+    const observations = classifyToolCalls(toolsCalled);
+    return {
+        ...record,
+        observations,
+        compliance_score: computeComplianceScore(plan, observations, record.corroboration_kinds),
+    };
+}
+export function withDerivedComplianceScore(record, plan) {
+    return {
+        ...record,
+        compliance_score: computeComplianceScore(plan, record.observations, record.corroboration_kinds),
+    };
+}
+export function deriveRetrievalTelemetryMetrics(records) {
+    const planCounts = emptyIntentCounts();
+    const executionCounts = emptyIntentCounts();
+    let accepted = 0;
+    let corroborated = 0;
+    let complianceTotal = 0;
+    for (const record of records) {
+        if (record.accepted)
+            accepted += 1;
+        if (record.corroboration_kinds.some((kind) => ["source-reference", "git-evidence", "repeatable-test"].includes(kind))) {
+            corroborated += 1;
+        }
+        for (const intent of record.planned_intents)
+            planCounts[intent] += 1;
+        for (const intent of [
+            "exact",
+            "semantic",
+            "structural",
+            "external",
+        ]) {
+            if (observedIntentCount(record.observations, intent) > 0) {
+                executionCounts[intent] += 1;
+            }
+        }
+        complianceTotal += record.compliance_score;
+    }
+    return {
+        total_queries: records.length,
+        accepted_queries: accepted,
+        intent_plan_counts: planCounts,
+        intent_execution_counts: executionCounts,
+        corroborated_queries: corroborated,
+        average_compliance_score: records.length === 0
+            ? 0
+            : Number((complianceTotal / records.length).toFixed(6)),
+    };
+}
+export function migrateTelemetryRecord(record, plan) {
+    return createRetrievalTelemetry({
+        queryId: typeof record.query_id === "string" ? record.query_id : "unknown-query",
+        plan,
+        corroborationKinds: Array.isArray(record.corroboration_kinds)
+            ? record.corroboration_kinds.filter((value) => typeof value === "string")
+            : [],
+        accepted: record.accepted === true,
+        achievedAssurance: record.achieved_assurance ?? null,
+    });
+}
+export const RETRIEVAL_TELEMETRY_EXAMPLES = Object.freeze({
+    exact: {
+        planned_intents: ["exact"],
+        corroboration_kinds: ["source-reference"],
+    },
+    multiIntent: {
+        planned_intents: ["semantic", "structural"],
+        corroboration_kinds: ["source-reference", "repeatable-test"],
+    },
+});
+//# sourceMappingURL=retrieval-execution-telemetry.js.map

package/dist/utils/retrieval-execution-telemetry.js.map

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

package/dist/utils/retrieval-result-ranking.d.ts

@@ -0,0 +1,34 @@
+import type { PactileIntentV1 } from "@blxzer/pactile-core";
+export type RetrievalRankingIntent = PactileIntentV1;
+export interface RetrievalResultCandidate {
+    readonly path: string;
+    readonly line?: number;
+    readonly baseScore?: number;
+    readonly exactMatch?: boolean;
+    readonly semanticScore?: number;
+    readonly structuralMatch?: boolean;
+    readonly externalFreshness?: number;
+    readonly sourceReference?: string;
+    readonly assemblyOnly?: boolean;
+}
+export interface RankedRetrievalResultCandidate extends RetrievalResultCandidate {
+    readonly score: number;
+    readonly reasons: readonly string[];
+}
+export interface RankRetrievalResultOptions {
+    readonly intents: readonly RetrievalRankingIntent[];
+    readonly topK?: number;
+}
+export interface RankedRetrievalResult {
+    readonly ranked: readonly RankedRetrievalResultCandidate[];
+    readonly total: number;
+}
+export declare function rankRetrievalResultCandidates(candidates: readonly RetrievalResultCandidate[], options: RankRetrievalResultOptions): RankedRetrievalResult;
+export interface PagedCallerResult {
+    readonly page: number;
+    readonly candidates: readonly RetrievalResultCandidate[];
+}
+export declare function pagedCallerAggregation(pages: readonly PagedCallerResult[], options?: Omit<RankRetrievalResultOptions, "intents"> & {
+    readonly intents?: readonly RetrievalRankingIntent[];
+}): RankedRetrievalResult;
+//# sourceMappingURL=retrieval-result-ranking.d.ts.map

package/dist/utils/retrieval-result-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-result-ranking.d.ts","sourceRoot":"","sources":["../../src/utils/retrieval-result-ranking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AA4CD,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,SAAS,wBAAwB,EAAE,EAC/C,OAAO,EAAE,0BAA0B,GAClC,qBAAqB,CAoBvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC1D;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,SAAS,CAAC,GAAG;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACjD,GACL,qBAAqB,CAavB"}

package/dist/utils/retrieval-result-ranking.js

@@ -0,0 +1,71 @@
+import { Buffer } from "node:buffer";
+function clamp(value, min = 0, max = 1) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return min;
+    return Math.max(min, Math.min(max, value));
+}
+function normalizedPath(value) {
+    return value.replace(/\\/g, "/").normalize("NFC").toLowerCase();
+}
+function scoreCandidate(candidate, intents) {
+    let score = clamp(candidate.baseScore, -1000, 1000);
+    const reasons = [];
+    if (intents.has("exact") && candidate.exactMatch) {
+        score += 100;
+        reasons.push("exact-match");
+    }
+    if (intents.has("semantic") && candidate.semanticScore !== undefined) {
+        score += clamp(candidate.semanticScore) * 40;
+        reasons.push("semantic-candidate");
+    }
+    if (intents.has("structural") && candidate.structuralMatch) {
+        score += 60;
+        reasons.push("structural-match");
+    }
+    if (intents.has("external") && candidate.externalFreshness !== undefined) {
+        score += clamp(candidate.externalFreshness) * 30;
+        reasons.push("external-freshness-candidate");
+    }
+    if (candidate.sourceReference) {
+        score += 10;
+        reasons.push("source-reference-present");
+    }
+    if (candidate.assemblyOnly) {
+        score -= intents.has("structural") ? 30 : 10;
+        reasons.push("assembly-only-demotion");
+    }
+    return { ...candidate, score, reasons };
+}
+export function rankRetrievalResultCandidates(candidates, options) {
+    const intents = new Set(options.intents);
+    const topK = Math.max(0, Math.min(options.topK ?? candidates.length, candidates.length));
+    const ranked = candidates
+        .map((candidate) => scoreCandidate(candidate, intents))
+        .sort((left, right) => {
+        const byScore = right.score - left.score;
+        if (byScore !== 0)
+            return byScore;
+        const byPath = Buffer.compare(Buffer.from(normalizedPath(left.path), "utf8"), Buffer.from(normalizedPath(right.path), "utf8"));
+        if (byPath !== 0)
+            return byPath;
+        return (left.line ?? 0) - (right.line ?? 0);
+    })
+        .slice(0, topK);
+    return { ranked, total: candidates.length };
+}
+export function pagedCallerAggregation(pages, options = {}) {
+    const ordered = [...pages].sort((left, right) => left.page - right.page);
+    const unique = new Map();
+    for (const page of ordered) {
+        for (const candidate of page.candidates) {
+            const key = `${normalizedPath(candidate.path)}:${candidate.line ?? 0}`;
+            if (!unique.has(key))
+                unique.set(key, candidate);
+        }
+    }
+    return rankRetrievalResultCandidates([...unique.values()], {
+        intents: options.intents ?? ["structural"],
+        topK: options.topK,
+    });
+}
+//# sourceMappingURL=retrieval-result-ranking.js.map

package/dist/utils/retrieval-result-ranking.js.map

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

package/dist/utils/retrieval-tool-classification.d.ts

@@ -0,0 +1,18 @@
+import type { PactileIntentV1 } from "@blxzer/pactile-core";
+export interface ClassifiedToolCalls {
+    readonly exact_count: number;
+    readonly semantic_count: number;
+    readonly structural_count: number;
+    readonly external_count: number;
+    readonly read_count: number;
+    readonly git_count: number;
+    readonly test_count: number;
+    readonly router_cli_invoked: boolean;
+    readonly unclassified_count: number;
+}
+/** Classify observed execution only; this function never selects a route. */
+export declare function classifyToolCalls(rawNames: readonly string[]): ClassifiedToolCalls;
+export declare function structuralRoutesInPlan(intents: readonly string[]): boolean;
+export declare function semanticRoutesInPlan(intents: readonly string[]): boolean;
+export declare function observedIntentCount(classified: ClassifiedToolCalls, intent: PactileIntentV1): number;
+//# sourceMappingURL=retrieval-tool-classification.d.ts.map

package/dist/utils/retrieval-tool-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-tool-classification.d.ts","sourceRoot":"","sources":["../../src/utils/retrieval-tool-classification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAsCD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,mBAAmB,CA8DrB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE1E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAExE;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,eAAe,GACtB,MAAM,CAWR"}

package/dist/utils/retrieval-tool-classification.js

@@ -0,0 +1,118 @@
+const EXACT_PATTERNS = [
+    /^grep$/i,
+    /^rg$/i,
+    /ripgrep/i,
+    /find.?files?/i,
+    /^glob$/i,
+];
+const SEMANTIC_PATTERNS = [/semantic/i, /concept/i, /meaning/i];
+const STRUCTURAL_PATTERNS = [
+    /structural/i,
+    /callers?/i,
+    /callees?/i,
+    /dependenc/i,
+    /call.?graph/i,
+];
+const EXTERNAL_PATTERNS = [
+    /external/i,
+    /^web/i,
+    /browser/i,
+    /http.?fetch/i,
+    /remote.?search/i,
+];
+const READ_PATTERNS = [
+    /^read$/i,
+    /read.?file/i,
+    /get-content/i,
+    /source.?read/i,
+];
+const GIT_PATTERNS = [/^git(?:\s|$)/i, /git.?diff/i, /git.?log/i, /git.?show/i];
+const TEST_PATTERNS = [/test/i, /vitest/i, /pytest/i, /check/i];
+const ROUTER_PATTERNS = [/route.?codebase.?retrieval/i, /retrieval.?plan/i];
+function matches(name, patterns) {
+    return patterns.some((pattern) => pattern.test(name));
+}
+/** Classify observed execution only; this function never selects a route. */
+export function classifyToolCalls(rawNames) {
+    let exact = 0;
+    let semantic = 0;
+    let structural = 0;
+    let external = 0;
+    let read = 0;
+    let git = 0;
+    let test = 0;
+    let router = false;
+    let unclassified = 0;
+    for (const raw of rawNames) {
+        const name = typeof raw === "string" ? raw.trim() : "";
+        if (!name) {
+            unclassified += 1;
+            continue;
+        }
+        let classified = false;
+        if (matches(name, EXACT_PATTERNS)) {
+            exact += 1;
+            classified = true;
+        }
+        if (matches(name, SEMANTIC_PATTERNS)) {
+            semantic += 1;
+            classified = true;
+        }
+        if (matches(name, STRUCTURAL_PATTERNS)) {
+            structural += 1;
+            classified = true;
+        }
+        if (matches(name, EXTERNAL_PATTERNS)) {
+            external += 1;
+            classified = true;
+        }
+        if (matches(name, READ_PATTERNS)) {
+            read += 1;
+            classified = true;
+        }
+        if (matches(name, GIT_PATTERNS)) {
+            git += 1;
+            classified = true;
+        }
+        if (matches(name, TEST_PATTERNS)) {
+            test += 1;
+            classified = true;
+        }
+        if (matches(name, ROUTER_PATTERNS)) {
+            router = true;
+            classified = true;
+        }
+        if (!classified)
+            unclassified += 1;
+    }
+    return {
+        exact_count: exact,
+        semantic_count: semantic,
+        structural_count: structural,
+        external_count: external,
+        read_count: read,
+        git_count: git,
+        test_count: test,
+        router_cli_invoked: router,
+        unclassified_count: unclassified,
+    };
+}
+export function structuralRoutesInPlan(intents) {
+    return intents.includes("structural");
+}
+export function semanticRoutesInPlan(intents) {
+    return intents.includes("semantic");
+}
+export function observedIntentCount(classified, intent) {
+    switch (intent) {
+        case "exact":
+            return classified.exact_count;
+        case "semantic":
+            return classified.semantic_count;
+        case "structural":
+            return classified.structural_count;
+        case "external":
+            return classified.external_count;
+    }
+}
+//# sourceMappingURL=retrieval-tool-classification.js.map

package/dist/utils/retrieval-tool-classification.js.map

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

package/dist/utils/semantic-plan-gate.d.ts

@@ -0,0 +1,8 @@
+import type { CodebaseRetrievalPlanEnvelope } from "./codebase-retrieval-router.js";
+export declare function semanticProviderOrderFromEnvelope(plan: Pick<CodebaseRetrievalPlanEnvelope, "steps">): number | null;
+/**
+ * Render a neutral reminder. The text deliberately leaves tool and Provider
+ * selection to the project resolver/Adapter.
+ */
+export declare function semanticComplianceGateHint(plan: Pick<CodebaseRetrievalPlanEnvelope, "steps" | "minimumAssurance">, locale?: "zh" | "en"): string;
+//# sourceMappingURL=semantic-plan-gate.d.ts.map

package/dist/utils/semantic-plan-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-plan-gate.d.ts","sourceRoot":"","sources":["../../src/utils/semantic-plan-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAEpF,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,OAAO,CAAC,GACjD,MAAM,GAAG,IAAI,CAMf;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,OAAO,GAAG,kBAAkB,CAAC,EACvE,MAAM,GAAE,IAAI,GAAG,IAAW,GACzB,MAAM,CAoBR"}