@ctxo/cli 0.14.0 → 0.15.0

package/dist/{chunk-G4BMKCKG.js → chunk-JDL6GGTO.js}

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
 import {
+  DOCUMENT_SEARCH_CONFIG,
+  SearchEngine,
   buildGraphFromIndices
-} from "./chunk-L2CAUER6.js";
+} from "./chunk-IT426P3F.js";
 import {
   SimpleGitAdapter,
+  SymbolTokenizer,
   TEST_FRAMEWORK_ANNOTATIONS,
   createTestFileClassifier,
   filesWithTestAnnotations,
@@ -14,20 +17,21 @@ import {
   resolveCoChangeConfig,
   selectWindow,
   windowCutoff
-} from "./chunk-7HSA5JVP.js";
+} from "./chunk-I7RPXT6L.js";
 import {
   getVersion,
   locateGitRoot
 } from "./chunk-72CEQEQD.js";
 import {
   JsonIndexReader
-} from "./chunk-X4TVFJ4C.js";
+} from "./chunk-EC6INGPV.js";
 import {
   createLogger
 } from "./chunk-5DSKZJNN.js";
 
 // src/cli/module-host.ts
 import { join } from "path";
+import { DATA_RESOURCE_KINDS } from "@ctxo/plugin-api";
 var log = createLogger("ctxo:module-host");
 async function readCoChangeWindow(projectRoot, config) {
   try {
@@ -58,7 +62,14 @@ var HOST_SERVICES = Object.freeze({
   buildGraph: buildGraphFromIndices,
   readCoChangeWindow,
   findGitRoot: (dir) => locateGitRoot(dir) ?? void 0,
-  testFrameworkAnnotations: TEST_FRAMEWORK_ANNOTATIONS
+  testFrameworkAnnotations: TEST_FRAMEWORK_ANNOTATIONS,
+  dataResourceKinds: DATA_RESOURCE_KINDS,
+  createDocumentSearch: (documents) => {
+    const engine = new SearchEngine(DOCUMENT_SEARCH_CONFIG);
+    engine.buildDocumentIndex(documents);
+    return { search: (query, limit) => engine.search(query, limit) };
+  },
+  splitIdentifier: (name) => SymbolTokenizer.splitName(name)
 });
 function createModuleHost(options) {
   return {
@@ -73,4 +84,4 @@ function createModuleHost(options) {
 export {
   createModuleHost
 };
-//# sourceMappingURL=chunk-G4BMKCKG.js.map
+//# sourceMappingURL=chunk-JDL6GGTO.js.map

package/dist/{cli-router-AZCDNX5R.js → cli-router-W56INOQ3.js}

@@ -12,11 +12,10 @@ import {
   RevertDetector,
   SessionRecorderAdapter,
   SqliteStorageAdapter,
-  SymbolTokenizer,
   buildCoChangeMatrix,
   detectWorkspace,
   findCoChangedFilesForBlastRadius
-} from "./chunk-ZL36YS2V.js";
+} from "./chunk-A4URKKPP.js";
 import {
   FAST_ROUTE_COMMANDS,
   isKnownModuleCommand,
@@ -24,7 +23,7 @@ import {
   moduleHelpLines,
   runFastRoute,
   runModuleCommand
-} from "./chunk-SRQZDGFZ.js";
+} from "./chunk-BBSJB4CG.js";
 import {
   DOMAIN_MODULE_PACKAGE,
   loadCtxoModules
@@ -38,6 +37,7 @@ import {
   DATA_EDGE_KINDS,
   SimpleGitAdapter,
   SymbolGraph,
+  SymbolTokenizer,
   communityDetectorOptions,
   createTestFileClassifier,
   factsRequested,
@@ -55,7 +55,7 @@ import {
   selectWindow,
   watchSnapshotMinFileChanges,
   windowCutoff
-} from "./chunk-7HSA5JVP.js";
+} from "./chunk-I7RPXT6L.js";
 import {
   compareCodepoint,
   getCliPackageRoot,
@@ -67,7 +67,7 @@ import {
   INDEX_ARTIFACT_FILES,
   JsonIndexReader,
   isMarkedArtifact
-} from "./chunk-X4TVFJ4C.js";
+} from "./chunk-EC6INGPV.js";
 import {
   atomicWrite
 } from "./chunk-RFEXMBTG.js";
@@ -2607,7 +2607,7 @@ var IndexCommand = class {
     if (passes.length === 0) return;
     let ctx;
     try {
-      const { createModuleHost } = await import("./module-host-KNMKS62R.js");
+      const { createModuleHost } = await import("./module-host-KTGDODES.js");
       const { services } = createModuleHost({ projectRoot: this.projectRoot, mode: "cli" });
       let graph;
       ctx = {
@@ -2783,7 +2783,7 @@ var IndexCommand = class {
     if (_roslyn) await _roslyn.dispose();
     const hasher = new ContentHasher();
     const files = this.discoverFilesIn(this.projectRoot);
-    const reader = new (await import("./json-index-reader-DBW32TCN.js")).JsonIndexReader(this.ctxoRoot);
+    const reader = new (await import("./json-index-reader-DKEIP2QR.js")).JsonIndexReader(this.ctxoRoot);
     const indices = reader.readAll();
     const indexedMap = new Map(indices.map((i) => [i.file, i]));
     let staleCount = 0;
@@ -4656,7 +4656,7 @@ var InitCommand = class {
       const [{ DOMAIN_MODULE_PACKAGE: DOMAIN_MODULE_PACKAGE2, loadCtxoModules: loadCtxoModules2 }, { resolvePackageCandidates: resolvePackageCandidates2 }, { createModuleHost }] = await Promise.all([
         import("./module-loader-B3LYF3W7.js"),
         import("./plugin-discovery-XRXI3IJF.js"),
-        import("./module-host-KNMKS62R.js")
+        import("./module-host-KTGDODES.js")
       ]);
       if (resolvePackageCandidates2(DOMAIN_MODULE_PACKAGE2, this.projectRoot, this.cliAnchor).length === 0) return void 0;
       const host = createModuleHost({ projectRoot: this.projectRoot, mode: "cli" });
@@ -5619,7 +5619,7 @@ async function collectModuleReports(projectRoot, options = {}) {
     if (resolvePackageCandidates(DOMAIN_MODULE_PACKAGE, projectRoot, options.cliAnchor).length === 0) {
       return [{ name: DOMAIN_MODULE_PACKAGE, status: "not-installed" }];
     }
-    const { createModuleHost } = await import("./module-host-KNMKS62R.js");
+    const { createModuleHost } = await import("./module-host-KTGDODES.js");
     const { reports } = await loadCtxoModules(createModuleHost({ projectRoot, mode: "cli" }), { cliAnchor: options.cliAnchor });
     return reports;
   } catch (err) {
@@ -8409,4 +8409,4 @@ Usage:
 export {
   CliRouter
 };
-//# sourceMappingURL=cli-router-AZCDNX5R.js.map
+//# sourceMappingURL=cli-router-W56INOQ3.js.map

package/dist/index.js

@@ -2,7 +2,7 @@
 import {
   FAST_ROUTE_COMMANDS,
   runFastRoute
-} from "./chunk-SRQZDGFZ.js";
+} from "./chunk-BBSJB4CG.js";
 import "./chunk-72CEQEQD.js";
 import {
   createLogger
@@ -28,12 +28,12 @@ async function main() {
       process.exitCode = await runFastRoute(args, process.cwd());
       return;
     }
-    const { CliRouter } = await import("./cli-router-AZCDNX5R.js");
+    const { CliRouter } = await import("./cli-router-W56INOQ3.js");
     const router = new CliRouter(process.cwd());
     await router.route(args);
     return;
   }
-  const { startMcpServer } = await import("./mcp-server-6YG2QE6E.js");
+  const { startMcpServer } = await import("./mcp-server-IYCCE74E.js");
   await startMcpServer(httpPortStr ? { httpPort: parseInt(httpPortStr, 10) } : {});
 }
 main().catch((err) => {

package/dist/internal.d.ts

@@ -216,6 +216,51 @@ interface GitRefs {
     /** Remote-tracking branches as `<remote>/<name>` (refs/remotes, no HEAD aliases), in codepoint order. */
     readonly remoteBranches?: readonly string[];
 }
+interface SearchResult {
+    symbolId: string;
+    name: string;
+    kind: string;
+    filePath: string;
+    /** BM25 relevance score (higher = more relevant) */
+    relevanceScore: number;
+    /** PageRank importance score (0-1) */
+    importanceScore: number;
+    /** Final combined score after all boosts */
+    combinedScore: number;
+}
+/**
+ * A document for the BM25 engine's document index (`SearchEngine.buildDocumentIndex`). A hit carries `id` in
+ * `symbolId`, `title` in `name`, `kind` and `path` in `filePath`.
+ */
+interface SearchDocument {
+    readonly id: string;
+    readonly title: string;
+    readonly kind: string;
+    readonly path: string;
+    readonly text: string;
+}
+interface SearchMetrics {
+    porterHits: number;
+    trigramHits: number;
+    phase2Activated: boolean;
+    fuzzyApplied: boolean;
+    latencyMs: number;
+}
+interface FuzzyCorrection {
+    originalQuery: string;
+    correctedQuery: string;
+    corrections: Array<{
+        original: string;
+        corrected: string;
+        distance: number;
+    }>;
+}
+interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    metrics: SearchMetrics;
+    fuzzyCorrection?: FuzzyCorrection;
+}
 interface CommunityEntry {
     readonly symbolId: string;
     readonly communityId: number;
@@ -533,9 +578,34 @@ interface IGitPort {
 type CoreToolName = 'get_logic_slice' | 'get_why_context' | 'get_change_intelligence' | 'get_blast_radius' | 'get_architectural_overlay' | 'find_dead_code' | 'get_context_for_task' | 'get_ranked_context' | 'search_symbols' | 'get_changed_symbols' | 'find_importers' | 'get_class_hierarchy' | 'get_symbol_importance' | 'get_pr_impact';
 /**
  * Adds fields to a core tool's payload before the envelope, truncation and masking see it. Additive only:
- * it returns the payload with its fields added and never removes or rewrites the core's fields.
+ * it returns the payload with its fields added and never removes or rewrites the core's fields. Seven core
+ * tools have the seam: `get_blast_radius`, `get_pr_impact` and `get_why_context` await a Promise result;
+ * the synchronous `search_symbols`, `find_importers`, `get_logic_slice` and `get_context_for_task` cannot,
+ * so for them a Promise result is dropped with a warning.
  */
-type ResponseEnricher = (payload: Record<string, unknown>, args: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+type ResponseEnricher = (payload: Record<string, unknown>, args: Readonly<Record<string, unknown>>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+/**
+ * The tokens a module keeps back from `get_context_for_task`'s budget for the fields its enricher adds,
+ * given the tool's validated arguments. The core packs the code context into what is left; it rounds the
+ * value and caps it at a quarter of the budget, and reserves nothing when it throws or is not finite.
+ */
+type TokenReservation = (args: Readonly<Record<string, unknown>>) => number;
+/**
+ * A scope of `get_ranked_context` a module contributes (`scope: "<name>"`). The tool gains its `scope`
+ * parameter only when a module provides one; `"code"`, the symbol ranking, stays the default. The CLI
+ * validates `query` and `tokenBudget` (at least 100, default 4000), then wraps the result in the `_meta`
+ * envelope and masks it. `strategy` and `searchMode` do not reach a module scope.
+ */
+interface RankedContextScope {
+    /** The scope name, never `code`. */
+    readonly scope: string;
+    /** One sentence appended to the `scope` parameter description, such as `"domain": card sections.` */
+    readonly description: string;
+    search(args: {
+        readonly query: string;
+        readonly tokenBudget: number;
+    }): Promise<Record<string, unknown>> | Record<string, unknown>;
+}
 /** An MCP tool a module contributes. The CLI wraps the handler with the envelope, masking and recording. */
 interface ModuleToolDefinition {
     readonly name: string;
@@ -634,10 +704,18 @@ interface CtxoModuleRegistration {
     indexPass?(ctx: IndexPassContext): Promise<void>;
     registerTools?(registrar: ToolRegistrar): void;
     readonly enrich?: Partial<Record<CoreToolName, ResponseEnricher>>;
+    /** Tokens kept back from `get_context_for_task`'s budget for this module's enriched fields. */
+    readonly reserveTaskContextTokens?: TokenReservation;
+    /** Extra `get_ranked_context` scopes; a name already taken, or `code`, is skipped with a warning. */
+    readonly rankedContextScopes?: readonly RankedContextScope[];
     registerCommands?(registrar: CommandRegistrar): void;
     readonly init?: InitContribution;
     readonly doctorChecks?: readonly IHealthCheck[];
 }
+/** A built document index. Hits carry the document `id` in `symbolId`, its `title` in `name`, its `kind` and `path`. */
+interface DocumentSearch {
+    search(query: string, limit?: number): SearchResponse;
+}
 /** The runtime services a module gets from the CLI instead of importing them. */
 interface CtxoHostServices {
     createLogger(namespace: string): Logger;
@@ -655,6 +733,15 @@ interface CtxoHostServices {
     findGitRoot(dir: string): string | undefined;
     /** Short names of the attributes that mark a test (`Fact`, `Test`, `TestMethod`, ...): the classifier's own list. */
     readonly testFrameworkAnnotations: readonly string[];
+    /** Symbol kinds that are data resources (`table`, `view`): plugin-api's own `DATA_RESOURCE_KINDS`, one source. */
+    readonly dataResourceKinds: readonly string[];
+    /**
+     * A BM25 search over documents (the core engine: camelCase-aware, trigram and fuzzy fallback), built once.
+     * Pass the documents in codepoint order (of `id`, say): equal scores keep the input order.
+     */
+    createDocumentSearch(documents: readonly SearchDocument[]): DocumentSearch;
+    /** Splits an identifier into its words: `ILoanRepository` gives `I`, `Loan`, `Repository`; `member_account_id` gives `member`, `account`, `id`. */
+    splitIdentifier(name: string): string[];
 }
 interface CtxoHost {
     readonly cliVersion: string;
@@ -744,4 +831,4 @@ declare function createModuleHost(options: CreateModuleHostOptions): CtxoHost;
 type SymbolGraph = SymbolGraph$1;
 type BlastRadiusCalculator = BlastRadiusCalculator$1;
 
-export { type BlastRadiusCalculator, type ChangeLog, type CheckContext, type CheckResult, type CheckStatus, type ClaudeHookEntry, type CoChangeEntry, type CoChangeWindowCommits, type CommandRegistrar, type CommitChangeSet, type CoreToolName, type CtxoConfig, type CtxoHost, type CtxoHostServices, type CtxoModuleRegister, type CtxoModuleRegistration, type EdgeKind, type FileChange, type FileChangeStatus, type FileIndex, type GitRange, type GitRefs, type GraphEdge, type IGitPort, type IHealthCheck, type IMaskingPort, type IStoragePort, type IndexPassContext, type InitContribution, type InitFileResult, type InitPartContext, type InitPrompter, type LoadedConfig, type Logger, type ModuleCommand, type ModuleCommandContext, type ModuleToolDefinition, type RangeCommit, type ResponseEnricher, type ResponseMeta, type SymbolGraph, type SymbolKind, type SymbolNode, type TestFileCheck, type ToolRegistrar, createModuleHost };
+export { type BlastRadiusCalculator, type ChangeLog, type CheckContext, type CheckResult, type CheckStatus, type ClaudeHookEntry, type CoChangeEntry, type CoChangeWindowCommits, type CommandRegistrar, type CommitChangeSet, type CoreToolName, type CtxoConfig, type CtxoHost, type CtxoHostServices, type CtxoModuleRegister, type CtxoModuleRegistration, type DocumentSearch, type EdgeKind, type FileChange, type FileChangeStatus, type FileIndex, type GitRange, type GitRefs, type GraphEdge, type IGitPort, type IHealthCheck, type IMaskingPort, type IStoragePort, type IndexPassContext, type InitContribution, type InitFileResult, type InitPartContext, type InitPrompter, type LoadedConfig, type Logger, type ModuleCommand, type ModuleCommandContext, type ModuleToolDefinition, type RangeCommit, type RankedContextScope, type ResponseEnricher, type ResponseMeta, type SearchDocument, type SearchMetrics, type SearchResponse, type SearchResult, type SymbolGraph, type SymbolKind, type SymbolNode, type TestFileCheck, type TokenReservation, type ToolRegistrar, createModuleHost };

package/dist/internal.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   createModuleHost
-} from "./chunk-G4BMKCKG.js";
-import "./chunk-L2CAUER6.js";
-import "./chunk-7HSA5JVP.js";
+} from "./chunk-JDL6GGTO.js";
+import "./chunk-IT426P3F.js";
+import "./chunk-I7RPXT6L.js";
 import "./chunk-72CEQEQD.js";
-import "./chunk-X4TVFJ4C.js";
+import "./chunk-EC6INGPV.js";
 import "./chunk-5DSKZJNN.js";
 export {
   createModuleHost

package/dist/{json-index-reader-DBW32TCN.js → json-index-reader-DKEIP2QR.js}

@@ -4,7 +4,7 @@ import {
   INDEX_ARTIFACT_FILES,
   JsonIndexReader,
   isMarkedArtifact
-} from "./chunk-X4TVFJ4C.js";
+} from "./chunk-EC6INGPV.js";
 import "./chunk-5DSKZJNN.js";
 export {
   COMMUNITY_HISTORY_DIR,
@@ -12,4 +12,4 @@ export {
   JsonIndexReader,
   isMarkedArtifact
 };
-//# sourceMappingURL=json-index-reader-DBW32TCN.js.map
+//# sourceMappingURL=json-index-reader-DKEIP2QR.js.map