@massu/core 1.5.7 → 1.6.0

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@massu/core",
-  "version": "1.5.7",
+  "version": "1.6.0",
   "type": "module",
   "description": "AI Engineering Governance MCP Server - Session memory, knowledge system, feature registry, code intelligence, rule enforcement, tiered tooling (12 free / 72 total), 55+ workflow commands, 11 agents, 20+ patterns",
   "main": "src/server.ts",
   "exports": {
     ".": "./src/server.ts",
-    "./adapter": "./src/adapter.ts"
+    "./adapter": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/adapter.js",
+      "default": "./dist/adapter.js"
+    }
   },
   "bin": {
     "massu": "./dist/cli.js"
@@ -14,14 +18,22 @@
   "scripts": {
     "start": "npx tsx src/server.ts",
     "test": "vitest run",
-    "build": "tsc --noEmit && npm run build:cli && npm run build:hooks",
+    "build": "tsc --noEmit && npm run build:cli && npm run build:hooks && npm run build:adapter-types && npm run build:adapter-subpath && npm run build:bundle-adapters",
+    "build:adapter-types": "tsc -p tsconfig.adapter-types.json",
+    "build:adapter-subpath": "tsx scripts/bundle-adapters.ts --subpath-only",
+    "build:bundle-adapters": "tsx scripts/bundle-adapters.ts",
     "build:cli": "esbuild --bundle --platform=node --format=esm --outfile=dist/cli.js src/cli.ts --external:better-sqlite3 --external:yaml --external:zod --external:chokidar --external:proper-lockfile --external:fsevents --external:web-tree-sitter --external:tweetnacl --external:tar --external:smol-toml --external:vscode-languageserver-protocol --banner:js='#!/usr/bin/env node\nimport{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
-    "build:hooks": "esbuild --bundle --platform=node --format=esm --outdir=dist/hooks src/hooks/*.ts --external:better-sqlite3 --external:yaml --external:zod --external:chokidar --external:proper-lockfile --external:fsevents --banner:js='import{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
+    "build:hooks": "esbuild --bundle --platform=node --format=esm --outdir=dist/hooks src/hooks/*.ts --external:better-sqlite3 --external:yaml --external:zod --external:chokidar --external:proper-lockfile --external:fsevents --external:web-tree-sitter --external:tweetnacl --external:tar --external:smol-toml --external:vscode-languageserver-protocol --banner:js='import{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
     "prepublishOnly": "bash ../../scripts/prepublish-check.sh && node ../../scripts/bundle-pubkey.mjs && npm run build",
     "bench:watch": "tsx test/perf/watch-benchmark.ts"
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
+    "@massu/adapter-aspnet": "^1.0.0",
+    "@massu/adapter-go-chi": "^1.0.0",
+    "@massu/adapter-phoenix": "^1.0.0",
+    "@massu/adapter-rails": "^1.0.0",
+    "@massu/adapter-spring": "^1.0.0",
     "better-sqlite3": "^12.6.2",
     "chokidar": "^3.6.0",
     "fast-glob": "^3.3.0",
@@ -70,7 +82,7 @@
     "feature-registry"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0 <26.0.0"
   },
   "repository": {
     "type": "git",

package/src/adapter.ts

@@ -74,6 +74,37 @@ export {
 
 import type { CodebaseAdapter } from './detect/adapters/types.js';
 
+// ============================================================
+// Plan 3c Phase 9b P-A-001a: runtime helper re-exports.
+//
+// The 5 first-party framework adapters (rails/phoenix/aspnet/spring/go-chi)
+// migrated to `packages/adapter-<f>/src/index.ts` workspace packages need
+// these helpers from `@massu/core/adapter` rather than reaching into
+// `@massu/core` internals (which would couple the workspace package to
+// every transitive .ts file).
+//
+// CR-46: a single SemVer-stable authoring surface. Every export from this
+// file is part of the public adapter API; breaking changes require a
+// major version bump per `massu-adapter-api-version`.
+// ============================================================
+
+// Tree-sitter query helpers (compileQuery is intentionally NOT re-exported —
+// only `runQuery` returns the cooked record shape adapters consume).
+export { runQuery, InvalidQueryError, type RunQueryHit } from './detect/adapters/query-helpers.js';
+
+// Grammar acquisition (runtime: downloads + verifies SHA-256 + caches).
+export { loadGrammar } from './detect/adapters/tree-sitter-loader.js';
+
+// Parse-time safety guards (size cap + nested-depth check).
+export {
+  isParsableSource,
+  MAX_AST_FILE_BYTES,
+  MAX_AST_PARSE_DEPTH,
+  MAX_AST_PARSE_MS,
+  type ParseSkip,
+  type ParseSkipReason,
+} from './detect/adapters/parse-guard.js';
+
 /**
  * Identity factory — narrows the input's type to `CodebaseAdapter` so
  * authors get compile-time checking + IDE autocomplete for missing /

package/src/detect/adapters/aspnet.ts

@@ -1,293 +1,4 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-/**
- * Plan 3c — Phase 7: ASP.NET Core AST adapter.
- *
- * Fifth Phase 7 framework after go-chi + Flask + Rails + Phoenix. First to
- * consume the `csharp` Tree-sitter grammar entry from GRAMMAR_MANIFEST
- * (commit fbb8aa9). All queries verified against actual tree-sitter-c-sharp
- * AST shape via probe (R-011) BEFORE writing the adapter.
- *
- * ASP.NET Core supports two routing styles, both first-class per the
- * official routing guide (https://learn.microsoft.com/aspnet/core/fundamentals/routing):
- *   1. **Minimal API** (recommended for new projects since .NET 6):
- *      `app.MapGet("/path", handler)`, `app.MapPost(...)`, etc. in
- *      Program.cs.
- *   2. **Attribute routing** (MVC controllers): `[HttpGet("{id}")]`,
- *      `[HttpPost]`, `[Route("api/[controller]")]` on controller classes
- *      and methods.
- *
- * The adapter handles BOTH styles uniformly — extracted route_method
- * normalizes `MapGet`/`HttpGet` → `Get`, `MapPost`/`HttpPost` → `Post`,
- * etc. so downstream consumers don't need to know which style produced
- * the signal.
- *
- * Extracts:
- *   - route_method: most-common HTTP verb captured from EITHER `app.Map<Verb>`
- *     invocations (minimal API) OR `[Http<Verb>]` attributes (MVC).
- *   - route_prefix_base: first path segment from EITHER the first `MapGet`
- *     string-literal path arg OR the first class-level `[Route("template")]`
- *     attribute. Mirrors phoenix scope_prefix_base / rails api_namespace.
- *   - controller_class: name of the first class ending in `Controller`
- *     (attribute-routing style only — minimal API has no controllers).
- *     Mirrors python-flask app_factory / phoenix router_module.
- *
- * Confidence rules (mirror phoenix / rails / go-chi):
- *   - 'high'   if exactly ONE distinct route_method seen.
- *   - 'low'    if multiple distinct route_methods seen.
- *   - 'medium' if route_prefix_base or controller_class found but no
- *              route_method.
- *   - 'none'   if no ASP.NET signals at all (regex fallback takes over).
- *
- * Tree-sitter-c-sharp AST shape (verified via probe 2026-05-07):
- *   - Method calls: `(invocation_expression function: (member_access_expression
- *     name: (identifier)) arguments: (argument_list (argument
- *     (string_literal)) ...))`.
- *   - Attributes: `(attribute name: (identifier) (attribute_argument_list
- *     (attribute_argument (string_literal))?))` — argument list is optional
- *     because attributes like `[HttpPost]` have no args.
- *   - Class declarations: `(class_declaration name: (identifier)
- *     bases: (base_list (identifier)?))` — bases optional.
- *
- * Does NOT use regex on file content — only Tree-sitter S-expression queries
- * compiled via query-helpers.ts.
- */
-
-import { Parser } from 'web-tree-sitter';
-import type { CodebaseAdapter, AdapterResult, DetectionSignals, Provenance, SourceFile } from './types.ts';
-import { runQuery, InvalidQueryError } from './query-helpers.ts';
-import { loadGrammar } from './tree-sitter-loader.ts';
-import { isParsableSource, MAX_AST_FILE_BYTES } from './parse-guard.ts';
-
-// ============================================================
-// Tree-sitter S-expression queries (C# grammar)
-// ============================================================
-
-/**
- * Minimal-API verb mapping: `app.MapGet("/path", handler)`,
- * `app.MapPost(...)`, etc. Anchored on the first argument being a
- * string_literal so we capture the route path together with the verb.
- *
- * The captured @method is the full method name like `MapGet` — the
- * adapter strips the `Map` prefix in post-processing.
- *
- * Per ASP.NET Core minimal API docs:
- * https://learn.microsoft.com/aspnet/core/fundamentals/minimal-apis
- */
-const MAP_VERB_QUERY = `
-(invocation_expression
-  function: (member_access_expression
-    name: (identifier) @method (#match? @method "^Map(Get|Post|Put|Patch|Delete|Head|Options)$"))
-  arguments: (argument_list
-    .
-    (argument (string_literal) @route_path)))
-`;
-
-/**
- * Attribute-routing HTTP verb attributes: `[HttpGet]`, `[HttpGet("{id}")]`,
- * `[HttpPost]`, etc. Captures BOTH the parameterless and parameterized
- * forms — the route path may or may not be present.
- *
- * The captured @attr_name is `HttpGet` etc. — the adapter strips the
- * `Http` prefix in post-processing.
- *
- * Per ASP.NET Core attribute routing docs:
- * https://learn.microsoft.com/aspnet/core/mvc/controllers/routing
- */
-const HTTP_ATTR_QUERY = `
-(attribute
-  name: (identifier) @attr_name (#match? @attr_name "^Http(Get|Post|Put|Patch|Delete|Head|Options)$"))
-`;
-
-/**
- * Class-level `[Route("api/[controller]")]` attribute. Captures the
- * route template string so we can extract its first path segment.
- * Tokens like `[controller]` inside the template are kept verbatim —
- * the prefix-base extractor splits on `/` so `api/[controller]` → `/api`.
- */
-const ROUTE_ATTR_QUERY = `
-(attribute
-  name: (identifier) @_attr_name (#eq? @_attr_name "Route")
-  (attribute_argument_list
-    (attribute_argument (string_literal) @route_template)))
-`;
-
-/**
- * Controller class declaration: `class FooController : ControllerBase`.
- * We restrict to class names ending in `Controller` to avoid every class
- * in the project (canonical ASP.NET MVC naming convention).
- */
-const CONTROLLER_CLASS_QUERY = `
-(class_declaration
-  name: (identifier) @class_name (#match? @class_name "Controller$"))
-`;
-
-// ============================================================
-// Adapter
-// ============================================================
-
-export const aspnetAdapter: CodebaseAdapter = {
-  id: 'aspnet',
-  languages: ['csharp'],
-
-  matches(signals: DetectionSignals): boolean {
-    // Cheap signal-only check. No file IO. The canonical ASP.NET Core
-    // declaration is `<Project Sdk="Microsoft.NET.Sdk.Web">` in the .csproj
-    // file (per https://learn.microsoft.com/aspnet/core/fundamentals/target-aspnetcore).
-    // Fallback: presence of `Microsoft.AspNetCore.App` framework reference,
-    // which appears in older .csproj formats.
-    if (!signals.csproj) return false;
-    if (/Sdk\s*=\s*["']Microsoft\.NET\.Sdk\.Web["']/i.test(signals.csproj)) return true;
-    if (/Microsoft\.AspNetCore\.App/i.test(signals.csproj)) return true;
-    return false;
-  },
-
-  async introspect(files: SourceFile[], _rootDir: string): Promise<AdapterResult> {
-    if (files.length === 0) {
-      return { conventions: {}, provenance: [], confidence: 'none' };
-    }
-
-    let language;
-    try {
-      language = await loadGrammar('csharp');
-    } catch (e) {
-      // Grammar unavailable → adapter returns 'none' so regex fallback takes over.
-      return { conventions: {}, provenance: [], confidence: 'none' };
-    }
-
-    const parser = new Parser();
-    parser.setLanguage(language);
-
-    const routeMethods = new Map<string, { line: number; file: string }>();
-    const prefixBases = new Map<string, { line: number; file: string }>();
-    const controllerClasses = new Map<string, { line: number; file: string }>();
-
-    try {
-      for (const file of files) {
-        const skip = isParsableSource(file.content, file.size);
-        if (skip) {
-          process.stderr.write(
-            `[massu/ast] WARN: aspnet skipping ${file.path}: ${skip.reason} (${skip.detail}). Cap=${MAX_AST_FILE_BYTES}. (Phase 3.5 mitigation)\n`,
-          );
-          continue;
-        }
-        try {
-          // Minimal API: app.MapGet("/path", ...)
-          for (const hit of runQuery(parser, file.content, MAP_VERB_QUERY, 'aspnet-map-verb', file.path)) {
-            const methodRaw = hit.captures.method;
-            if (!methodRaw) continue;
-            const verb = methodRaw.replace(/^Map/, ''); // MapGet → Get
-            if (!routeMethods.has(verb)) {
-              routeMethods.set(verb, { line: hit.line, file: file.path });
-            }
-            // Also capture the route path for prefix base
-            const pathRaw = hit.captures.route_path;
-            if (pathRaw) {
-              const literal = pathRaw.replace(/^["']/, '').replace(/["']$/, '');
-              const base = extractPrefixBase(literal);
-              if (base && !prefixBases.has(base)) {
-                prefixBases.set(base, { line: hit.line, file: file.path });
-              }
-            }
-          }
-          // Attribute routing: [HttpGet], [HttpPost], etc.
-          for (const hit of runQuery(parser, file.content, HTTP_ATTR_QUERY, 'aspnet-http-attr', file.path)) {
-            const attrRaw = hit.captures.attr_name;
-            if (!attrRaw) continue;
-            const verb = attrRaw.replace(/^Http/, ''); // HttpGet → Get
-            if (!routeMethods.has(verb)) {
-              routeMethods.set(verb, { line: hit.line, file: file.path });
-            }
-          }
-          // Class-level [Route("api/[controller]")]
-          for (const hit of runQuery(parser, file.content, ROUTE_ATTR_QUERY, 'aspnet-route-attr', file.path)) {
-            const tplRaw = hit.captures.route_template;
-            if (!tplRaw) continue;
-            const literal = tplRaw.replace(/^["']/, '').replace(/["']$/, '');
-            const base = extractPrefixBase(literal);
-            if (base && !prefixBases.has(base)) {
-              prefixBases.set(base, { line: hit.line, file: file.path });
-            }
-          }
-          // Controller class: class FooController : ControllerBase
-          for (const hit of runQuery(parser, file.content, CONTROLLER_CLASS_QUERY, 'aspnet-controller-class', file.path)) {
-            const name = hit.captures.class_name;
-            if (name && !controllerClasses.has(name)) {
-              controllerClasses.set(name, { line: hit.line, file: file.path });
-            }
-          }
-        } catch (e) {
-          if (e instanceof InvalidQueryError) {
-            throw e;
-          }
-          continue;
-        }
-      }
-    } finally {
-      try { parser.delete(); } catch { /* ignore */ }
-    }
-
-    const conventions: Record<string, unknown> = {};
-    const provenance: Provenance[] = [];
-
-    if (routeMethods.size === 1) {
-      const [name, { line, file }] = routeMethods.entries().next().value as [string, { line: number; file: string }];
-      conventions.route_method = name;
-      provenance.push({ field: 'route_method', sourceFile: file, line, query: 'aspnet-map-verb' });
-    } else if (routeMethods.size >= 2) {
-      const [name, { line, file }] = routeMethods.entries().next().value as [string, { line: number; file: string }];
-      conventions.route_method = name;
-      provenance.push({ field: 'route_method', sourceFile: file, line, query: 'aspnet-map-verb' });
-    }
-
-    if (prefixBases.size >= 1) {
-      const [base, { line, file }] = prefixBases.entries().next().value as [string, { line: number; file: string }];
-      conventions.route_prefix_base = base;
-      provenance.push({ field: 'route_prefix_base', sourceFile: file, line, query: 'aspnet-route-prefix' });
-    }
-
-    if (controllerClasses.size >= 1) {
-      const [name, { line, file }] = controllerClasses.entries().next().value as [string, { line: number; file: string }];
-      conventions.controller_class = name;
-      provenance.push({ field: 'controller_class', sourceFile: file, line, query: 'aspnet-controller-class' });
-    }
-
-    let confidence: AdapterResult['confidence'];
-    if (Object.keys(conventions).length === 0) {
-      confidence = 'none';
-    } else if (routeMethods.size === 1) {
-      confidence = 'high';
-    } else if (routeMethods.size >= 2) {
-      confidence = 'low';
-    } else {
-      confidence = 'medium';
-    }
-
-    return { conventions, provenance, confidence };
-  },
-};
-
-// ============================================================
-// Helpers
-// ============================================================
-
-/**
- * Extract the first path segment of an ASP.NET route template. Mirrors
- * phoenix/rails/python-flask/go-chi prefix-base extractors. Returns null
- * if input is empty or `/`-only.
- *
- * Examples (verified against test fixtures):
- *   "/health"             → "/health"
- *   "api/[controller]"    → "/api"
- *   "/api/v1/users"       → "/api"
- *   "/"                   → null
- *   ""                    → null
- */
-function extractPrefixBase(prefix: string): string | null {
-  // ASP.NET route templates may or may not begin with `/`. Normalize.
-  const stripped = prefix.replace(/^\/+/, '');
-  const firstSeg = stripped.split('/')[0];
-  if (!firstSeg) return null;
-  return '/' + firstSeg;
-}
+// Plan 3c Phase 9b P-A-005: re-export shim. Source-of-truth lives at
+// `packages/adapter-aspnet/src/index.ts` (workspace package). This shim
+// preserves the legacy import path used by codebase-introspector + tests.
+export { aspnetAdapter } from '@massu/adapter-aspnet';

package/src/detect/adapters/go-chi.ts

@@ -1,261 +1,4 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-/**
- * Plan 3c — Phase 7: go-chi AST adapter.
- *
- * First Phase 7 framework that introduces a NEW Tree-sitter grammar
- * (`go`) — added to GRAMMAR_MANIFEST in the preceding Commit 1
- * (plan-3c-phase7-grammar-infra). End-to-end proof that the grammar
- * load + parse + query path works for non-Python/JS/Swift languages.
- *
- * Establishes the per-framework deliverable pattern (4 artifacts) for
- * the remaining registry-verified frameworks (rails / aspnet / spring /
- * phoenix) and the bundled Go adapters (gin / echo / fiber / net-http):
- *   1. packages/core/templates/go-chi/massu.config.yaml      (variant template)
- *   2. packages/core/src/detect/adapters/go-chi.ts           (this file — AST adapter)
- *   3. Adversarial fixtures (inline in the test file via mkdirSync+writeFileSync)
- *   4. packages/core/src/__tests__/go-chi.test.ts            (golden-output test)
- *
- * Extracts:
- *   - route_method: most-common HTTP method registered via `r.<Method>(...)`
- *     (one of Get/Post/Put/Delete/Patch/Head/Options/Connect/Trace).
- *     Useful for scaffold-router templates that need to know which verb
- *     style the project uses.
- *   - mount_prefix_base: first path segment of `r.Mount("/api/...", ...)`
- *     mirroring python-fastapi's APIRouter prefix extraction. The chi
- *     `Mount` call is the canonical way to attach a sub-router under
- *     a path prefix (per chi docs: https://go-chi.io/#/pages/routing).
- *   - middleware_name: first chi middleware registered via
- *     `r.Use(middleware.<Name>)` (e.g., "Logger", "Recoverer", "RequestID").
- *     Captured from the canonical chi `middleware.*` package qualifier.
- *
- * Confidence rules (mirror python-fastapi/python-flask):
- *   - 'high' if exactly ONE distinct route_method seen (clear convention).
- *   - 'medium' if mount_prefix_base or middleware_name found but no route_method.
- *   - 'low' if multiple distinct route_methods seen (mixed convention).
- *   - 'none' if no chi signals at all (regex fallback takes over).
- *
- * Does NOT use regex on file content — only Tree-sitter S-expression queries
- * compiled via query-helpers.ts. Regex would be the regex-fallback path.
- */
-
-import { Parser } from 'web-tree-sitter';
-import type { CodebaseAdapter, AdapterResult, DetectionSignals, Provenance, SourceFile } from './types.ts';
-import { runQuery, InvalidQueryError } from './query-helpers.ts';
-import { loadGrammar } from './tree-sitter-loader.ts';
-import { isParsableSource, MAX_AST_FILE_BYTES } from './parse-guard.ts';
-
-// ============================================================
-// Tree-sitter S-expression queries (Go grammar)
-// ============================================================
-
-/**
- * HTTP method route registration: matches `r.Get("/path", handler)`,
- * `r.Post(...)`, etc. Anchored on the chi-canonical method names; we
- * deliberately do NOT match arbitrary `r.<Anything>(...)` calls because
- * Go's selector_expression shape is shared by every method call.
- *
- * The Tree-sitter Go grammar represents `r.Get(...)` as:
- *   call_expression {
- *     function: selector_expression {
- *       operand: identifier   (e.g. "r")
- *       field:   field_identifier  (e.g. "Get")
- *     }
- *     arguments: argument_list { ... }
- *   }
- *
- * The #match? predicate constrains @method to chi's HTTP verb set.
- */
-const ROUTE_METHOD_QUERY = `
-(call_expression
-  function: (selector_expression
-    field: (field_identifier) @method (#match? @method "^(Get|Post|Put|Delete|Patch|Head|Options|Connect|Trace)$"))
-  arguments: (argument_list
-    .
-    (interpreted_string_literal) @route_path))
-`;
-
-/**
- * Subrouter mount: `r.Mount("/api/v1", apiRouter)`. Captures the path
- * literal so we can split off the base segment, mirroring python-fastapi's
- * APIRouter prefix extraction.
- *
- * Per chi docs (https://go-chi.io/#/pages/routing#mounting):
- *   "Mount attaches another http.Handler along ./pattern/*"
- */
-const MOUNT_PREFIX_QUERY = `
-(call_expression
-  function: (selector_expression
-    field: (field_identifier) @_field (#eq? @_field "Mount"))
-  arguments: (argument_list
-    .
-    (interpreted_string_literal) @mount_path))
-`;
-
-/**
- * chi middleware registration: `r.Use(middleware.Logger)`,
- * `r.Use(middleware.Recoverer)`, etc. We require the canonical
- * `middleware.<Name>` qualifier to avoid matching user-defined
- * middleware (which we couldn't classify by name alone).
- *
- * The selector_expression inside the argument captures the package
- * qualifier (`middleware`) and the function name (`Logger`/etc).
- */
-const MIDDLEWARE_USE_QUERY = `
-(call_expression
-  function: (selector_expression
-    field: (field_identifier) @_use (#eq? @_use "Use"))
-  arguments: (argument_list
-    .
-    (selector_expression
-      operand: (identifier) @_pkg (#eq? @_pkg "middleware")
-      field: (field_identifier) @middleware_name)))
-`;
-
-// ============================================================
-// Adapter
-// ============================================================
-
-export const goChiAdapter: CodebaseAdapter = {
-  id: 'go-chi',
-  languages: ['go'],
-
-  matches(signals: DetectionSignals): boolean {
-    // Cheap signal-only check. No file IO. Match if:
-    //   1. go.mod text mentions github.com/go-chi/chi (canonical require), OR
-    //   2. project has cmd/ + internal/ AND go.mod is present (Go layout) — but
-    //      only when go.mod ALSO mentions chi (avoids matching every Go project).
-    if (!signals.goMod) return false;
-    if (/github\.com\/go-chi\/chi/i.test(signals.goMod)) return true;
-    return false;
-  },
-
-  async introspect(files: SourceFile[], _rootDir: string): Promise<AdapterResult> {
-    if (files.length === 0) {
-      return { conventions: {}, provenance: [], confidence: 'none' };
-    }
-
-    let language;
-    try {
-      language = await loadGrammar('go');
-    } catch (e) {
-      // Grammar unavailable → adapter returns 'none' so regex fallback takes over.
-      return { conventions: {}, provenance: [], confidence: 'none' };
-    }
-
-    const parser = new Parser();
-    parser.setLanguage(language);
-
-    const routeMethods = new Map<string, { line: number; file: string }>();
-    const mountBases = new Map<string, { line: number; file: string }>();
-    const middlewareNames = new Map<string, { line: number; file: string }>();
-
-    try {
-      for (const file of files) {
-        // Phase 3.5 defense-in-depth size + depth gate at adapter tier.
-        const skip = isParsableSource(file.content, file.size);
-        if (skip) {
-          process.stderr.write(
-            `[massu/ast] WARN: go-chi skipping ${file.path}: ${skip.reason} (${skip.detail}). Cap=${MAX_AST_FILE_BYTES}. (Phase 3.5 mitigation)\n`,
-          );
-          continue;
-        }
-        try {
-          for (const hit of runQuery(parser, file.content, ROUTE_METHOD_QUERY, 'chi-route-method', file.path)) {
-            const method = hit.captures.method;
-            if (method && !routeMethods.has(method)) {
-              routeMethods.set(method, { line: hit.line, file: file.path });
-            }
-          }
-          for (const hit of runQuery(parser, file.content, MOUNT_PREFIX_QUERY, 'chi-mount-prefix', file.path)) {
-            const raw = hit.captures.mount_path;
-            if (!raw) continue;
-            const literal = raw.replace(/^["`]/, '').replace(/["`]$/, '');
-            const base = extractPrefixBase(literal);
-            if (base && !mountBases.has(base)) {
-              mountBases.set(base, { line: hit.line, file: file.path });
-            }
-          }
-          for (const hit of runQuery(parser, file.content, MIDDLEWARE_USE_QUERY, 'chi-middleware-use', file.path)) {
-            const name = hit.captures.middleware_name;
-            if (name && !middlewareNames.has(name)) {
-              middlewareNames.set(name, { line: hit.line, file: file.path });
-            }
-          }
-        } catch (e) {
-          if (e instanceof InvalidQueryError) {
-            // Compile-time failure of OUR query is a developer bug — surface it.
-            throw e;
-          }
-          // Per-file parse error: skip + keep going.
-          continue;
-        }
-      }
-    } finally {
-      try { parser.delete(); } catch { /* ignore */ }
-    }
-
-    const conventions: Record<string, unknown> = {};
-    const provenance: Provenance[] = [];
-
-    if (routeMethods.size === 1) {
-      const [name, { line, file }] = routeMethods.entries().next().value as [string, { line: number; file: string }];
-      conventions.route_method = name;
-      provenance.push({ field: 'route_method', sourceFile: file, line, query: 'chi-route-method' });
-    } else if (routeMethods.size >= 2) {
-      // Mixed convention — emit first-seen for visibility.
-      const [name, { line, file }] = routeMethods.entries().next().value as [string, { line: number; file: string }];
-      conventions.route_method = name;
-      provenance.push({ field: 'route_method', sourceFile: file, line, query: 'chi-route-method' });
-    }
-
-    if (mountBases.size >= 1) {
-      const [base, { line, file }] = mountBases.entries().next().value as [string, { line: number; file: string }];
-      conventions.mount_prefix_base = base;
-      provenance.push({ field: 'mount_prefix_base', sourceFile: file, line, query: 'chi-mount-prefix' });
-    }
-
-    if (middlewareNames.size >= 1) {
-      const [name, { line, file }] = middlewareNames.entries().next().value as [string, { line: number; file: string }];
-      conventions.middleware_name = name;
-      provenance.push({ field: 'middleware_name', sourceFile: file, line, query: 'chi-middleware-use' });
-    }
-
-    let confidence: AdapterResult['confidence'];
-    if (Object.keys(conventions).length === 0) {
-      confidence = 'none';
-    } else if (routeMethods.size === 1) {
-      confidence = 'high';
-    } else if (routeMethods.size >= 2) {
-      confidence = 'low';
-    } else {
-      confidence = 'medium';
-    }
-
-    return { conventions, provenance, confidence };
-  },
-};
-
-// ============================================================
-// Helpers
-// ============================================================
-
-/**
- * Extract the first path segment of a chi mount path. Mirrors
- * python-fastapi/python-flask's extractPrefixBase. Returns null if input
- * doesn't start with `/`.
- *
- * NOTE: future refactor opportunity once a third adapter needs identical
- * logic — extracting a shared helper module. The Phase 7 Flask commit
- * deliberately copied this from python-fastapi rather than premature
- * extraction (per its self-attest #3); the same reasoning applies here
- * until a fourth consumer appears.
- */
-function extractPrefixBase(prefix: string): string | null {
-  if (!prefix.startsWith('/')) return null;
-  const stripped = prefix.replace(/^\/+/, '');
-  const firstSeg = stripped.split('/')[0];
-  if (!firstSeg) return null;
-  return '/' + firstSeg;
-}
+// Plan 3c Phase 9b P-A-005: re-export shim. Source-of-truth lives at
+// `packages/adapter-go-chi/src/index.ts` (workspace package). This shim
+// preserves the legacy import path used by codebase-introspector + tests.
+export { goChiAdapter } from '@massu/adapter-go-chi';