@maxgfr/codeindex 2.18.0 → 2.19.1

package/README.md

@@ -244,7 +244,13 @@ exactly what it saw before.
 
 From `2025-03-26` every tool carries behaviour annotations — `readOnlyHint` on
 the 21 read tools, `destructiveHint`/`idempotentHint` on the five that write —
-which is what lets a host auto-approve reads and confirm only writes.
+which is what lets a host auto-approve reads and confirm only writes. From
+`2025-06-18`, the 15 tools whose result is always a JSON object also declare an
+`outputSchema` and return `structuredContent`, so a client can validate and type
+the result instead of re-parsing a string. The remaining tools return arrays,
+argument-dependent shapes or plain text, which cannot yield a conforming
+structured result without diverging from the text block — they are left
+unschema'd rather than described inaccurately.
 
 Responses are capped (`--max-response-bytes`, default 1 MB). Under the cap
 nothing changes. Over it — where a whole-repo `graph` on a large monorepo runs

package/docs/MIGRATION.md

@@ -366,6 +366,16 @@ which is where the 5s → 0.3s figures come from.
   silently ignored. If you drive this server programmatically with loosely
   typed arguments, a call that used to fall back to a default now errors —
   numeric strings (`"50"`) are still accepted.
+- **outputSchema + structuredContent** on the 15 tools whose response is a JSON
+  object for every argument combination (scan_summary, graph, symbols, callers,
+  workspaces, churn, find_references, hotspots, coupling, embed_status, the
+  three symbolic edits, write_memory, delete_memory). Additive: `content` is
+  unchanged, `structuredContent` is added beside it, and both are gated on the
+  negotiated version. The other 11 tools deliberately have no schema — array
+  responses and argument-dependent shapes cannot produce a conforming object
+  without either diverging from `content` or breaking existing clients, and
+  repo_map/mermaid/read_memory are not JSON. structuredContent is also withheld
+  when the response was capped, since the truncation notice would not conform.
 - **New optional tool arguments**, all defaulting to today's behaviour:
   `find_symbol.maxResults`, `complexity.top`, `complexity.since` (risk mode
   previously dropped it), `mermaid.maxEdges`, `dead_code.limit`, `grep.scope`
@@ -374,6 +384,16 @@ which is where the 5s → 0.3s figures come from.
 - **Session cache is a 4-entry LRU**, not one entry, so alternating repos or
   scopes no longer forces a cold rebuild each call.
 
+### src/mcp.ts is now a facade over src/mcp/
+
+The server split into `src/mcp/protocol.ts` (version negotiation, argument
+validation, the response guard), `src/mcp/tools.ts` (tool definitions, metadata,
+output schemas) and `src/mcp/session.ts` (the scan/artifacts LRU and the embed
+memoization). `src/mcp.ts` keeps `callTool` + `runMcpServer` and **re-exports
+every symbol that used to live there**, so imports from `"./mcp.js"` are
+unaffected. New exports available either way: `TOOLS`, `TOOL_META`,
+`OUTPUT_SCHEMAS`, `annotationsFor`, `toolsFor`, `structuredContentFor`.
+
 ### New CLI flags
 
 `--workers <n>` (index), `--index <dir>` and `--no-index-cache` (read commands),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxgfr/codeindex",
-  "version": "2.18.0",
+  "version": "2.19.1",
   "description": "Self-contained, deterministic repo-indexing engine: walk + language detection + symbol/import extraction (tree-sitter AST with regex fallback) + import resolution + typed cross-file link-graph + analytics. Ships as a single zero-dependency engine.mjs that consumer tools vendor.",
   "type": "module",
   "packageManager": "pnpm@10.33.0",

package/scripts/engine.d.mts

@@ -1,4 +1,4 @@
-declare const ENGINE_VERSION = "2.18.0";
+declare const ENGINE_VERSION = "2.19.1";
 declare const SCHEMA_VERSION = 4;
 declare const EXTRACTOR_VERSION = 10;
 type FileKind = "code" | "doc" | "config" | "asset" | "other";
@@ -347,7 +347,7 @@ declare function extractAst(rel: string, ext: string, content: string, opts?: {
     imports?: boolean;
 }): AstResult | undefined;
 
-declare const DEFAULT_GRAMMARS_URL = "https://github.com/maxgfr/codeindex/releases/download/v2.18.0/grammars-2.18.0.tar.gz";
+declare const DEFAULT_GRAMMARS_URL = "https://github.com/maxgfr/codeindex/releases/download/v2.19.1/grammars-2.19.1.tar.gz";
 interface GrammarsPullTarget {
     url: string;
     sha256Url?: string;