@massu/core 1.10.8 → 1.12.0

package/dist/hooks/user-prompt.js

@@ -348,6 +348,22 @@ var RawConfigSchema = z.object({
   accessScopes: z.array(z.string()).optional(),
   domains: z.array(DomainConfigSchema).default([]),
   rules: z.array(PatternRuleConfigSchema).default([]),
+  // P-M-036 (plan-stage-d-medium-sweep): customer-authored CR-style
+  // governance rules. DISTINCT from `rules:` above (path-scoped lint hints
+  // used by pattern-scanner). At config-refresh time these entries are
+  // loaded into the `knowledge_rules` SQLite table with
+  // `source = 'customer-config'` so `massu_knowledge_rule` and the
+  // governance docs surface customer-defined rules alongside framework CRs.
+  governance_rules: z.array(
+    z.object({
+      id: z.string().min(1, "governance_rules[].id is required"),
+      title: z.string().min(1, "governance_rules[].title is required"),
+      description: z.string().min(1, "governance_rules[].description is required"),
+      vr_type: z.string().default("VR-CUSTOM"),
+      reference_path: z.string().optional(),
+      severity: z.enum(["critical", "high", "medium", "low", "info"]).default("medium")
+    }).passthrough()
+  ).default([]),
   analytics: AnalyticsConfigSchema,
   governance: GovernanceConfigSchema,
   security: SecurityConfigSchema,
@@ -466,6 +482,8 @@ Hint: run \`massu config refresh\` to regenerate a valid config or fix the liste
     accessScopes: parsed.accessScopes,
     domains: parsed.domains,
     rules: parsed.rules,
+    // P-M-036: customer-authored CR-style governance rules.
+    governance_rules: parsed.governance_rules,
     analytics: parsed.analytics,
     governance: parsed.governance,
     security: parsed.security,
@@ -1018,6 +1036,12 @@ function initMemorySchema(db) {
       features TEXT DEFAULT '[]'
     );
   `);
+  const licenseCacheCols = db.prepare(`PRAGMA table_info(license_cache)`).all();
+  if (!licenseCacheCols.some((c) => c.name === "signed_payload_json")) {
+    db.exec(
+      `ALTER TABLE license_cache ADD COLUMN signed_payload_json TEXT NOT NULL DEFAULT ''`
+    );
+  }
   db.exec(`
     CREATE TABLE IF NOT EXISTS failure_classes (
       id INTEGER PRIMARY KEY AUTOINCREMENT,

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@massu/core",
-  "version": "1.10.8",
+  "version": "1.12.0",
   "type": "module",
   "description": "AI Engineering Governance MCP Server - Session memory, knowledge system, feature registry, code intelligence, rule enforcement, tiered tooling (12 free / 73 total), 59 workflow commands, 11 agents, 20+ patterns",
-  "main": "src/server.ts",
+  "main": "./dist/cli.js",
+  "types": "./dist/adapter.d.ts",
   "exports": {
-    ".": "./src/server.ts",
+    ".": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/cli.js",
+      "default": "./dist/cli.js"
+    },
     "./adapter": {
       "types": "./dist/adapter.d.ts",
       "import": "./dist/adapter.js",
@@ -22,18 +27,16 @@
     "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 --external:@massu/adapter-rails --external:@massu/adapter-phoenix --external:@massu/adapter-aspnet --external:@massu/adapter-spring --external:@massu/adapter-go-chi --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 --external:web-tree-sitter --external:tweetnacl --external:tar --external:smol-toml --external:vscode-languageserver-protocol --external:@massu/adapter-rails --external:@massu/adapter-phoenix --external:@massu/adapter-aspnet --external:@massu/adapter-spring --external:@massu/adapter-go-chi --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 && node ../../scripts/bundle-license-pubkey.mjs && npm run build",
+    "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 --external:@massu/adapter-rails --external:@massu/adapter-spring --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 --external:web-tree-sitter --external:tweetnacl --external:tar --external:smol-toml --external:vscode-languageserver-protocol --external:@massu/adapter-rails --external:@massu/adapter-spring --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 && node ../../scripts/bundle-license-pubkey.mjs && cp ../../CHANGELOG.md ./CHANGELOG.md && 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",
+    "@massu/types": "1.12.0",
     "better-sqlite3": "^12.6.2",
     "chokidar": "^3.6.0",
     "fast-glob": "^3.3.0",
@@ -55,23 +58,17 @@
     "vitest": "^4.0.18"
   },
   "files": [
-    "src/**/*",
-    "!src/**/__tests__/**",
-    "!src/**/*.test.ts",
-    "!src/**/*.spec.ts",
-    "!**/.build/**",
-    "!**/.swiftpm/**",
-    "!**/node_modules/**",
-    "!**/__pycache__/**",
     "dist/**/*",
     "commands/**/*",
+    "!commands/README.md",
     "agents/**/*",
     "docs/**/*",
     "patterns/**/*",
     "protocols/**/*",
     "reference/**/*",
     "templates/**/*",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "mcp",

package/commands/README.md

@@ -1,134 +0,0 @@
-# Massu Slash-Command Templates
-
-This directory ships the slash commands installed into a consumer project's `<claudeDirName>/commands/` (default `.claude/commands/`) when the consumer runs `npx @massu/core install-commands` (or `npx @massu/core init`, which calls install-commands as part of its flow).
-
-As of `@massu/core@1.3.0`, command files are **stack-aware**: a template can ship one or more language-specific variants alongside the default, and the installer picks the variant that matches the consumer's `massu.config.yaml`. Local edits are preserved across reinstalls via a manifest written to `<claudeDirName>/.massu/install-manifest.json`.
-
-This README covers:
-
-1. The variant filename convention.
-2. The variant-resolution algorithm (priority order + tie-break).
-3. The local-edit-protection manifest.
-4. The `npx @massu/core show-template <name>` debugging command.
-
-## 1. Variant filename convention
-
-```
-<base>.md                        # default — used when no variant matches
-<base>.python.md                 # FastAPI / Django / generic Python (one-axis)
-<base>.python-fastapi.md         # Python + FastAPI (two-axis: lang + sub-framework)
-<base>.python-django.md          # Python + Django (two-axis: lang + sub-framework)
-<base>.swift.md                  # SwiftUI / iOS / visionOS
-<base>.rust.md                   # axum / actix / generic Rust
-<base>.typescript.md             # reserved for future use; currently no variants ship
-```
-
-The two-axis form (`<base>.<lang>-<framework>.md`) is tried BEFORE the one-axis (`<base>.<lang>.md`) form. It is selected when the consumer's config declares `framework.languages.<lang>.framework = "<sub-framework>"` (e.g. `fastapi` or `django`).
-
-The variant convention applies **only at the top level** of `packages/core/commands/`. Files inside subdirectories (e.g., `_shared-references/`, `massu-loop/references/`) are copied recursively as-is — no variant resolution, no dot-skip filtering. Future authors can use dotted filenames in nested dirs without losing them to the variant filter.
-
-The variant convention is **opt-in**: a template that does NOT ship any `<base>.<variant>.md` siblings is variant-agnostic and the unsuffixed `<base>.md` is used everywhere.
-
-## 2. Variant-resolution algorithm
-
-Given a base template name `B` and the consumer's `framework` config from `massu.config.yaml`:
-
-1. **Build the candidate list `V`** in priority order:
-   1. `framework.primary` (or `framework.type` if `primary` is undefined). Skipped if the value is `"multi"`.
-   2. Each declared `framework.languages.<lang>` entry whose `framework` field is a non-empty string, in **YAML declaration order** (first-declared wins on ties).
-   3. **Passthrough fallback**: well-known top-level `framework.<lang>` blocks (typescript / javascript / python / swift / rust / go) with a non-empty `framework` field, in fixed order, excluding any language already covered. This is what lets a project that declares `framework.swift` at the top level (alongside `framework.languages.python`) still pick up the `.swift.md` variant when the languages block doesn't contain swift.
-   4. The unsuffixed default (`""`) as the last fallback.
-2. **Probe disk** in order: for each candidate `c`, check whether `<base>.<c>.md` exists in the bundled commands directory.
-3. **Return**:
-   - First hit → copy that file.
-   - No hit AND `framework.type === "multi"` AND `framework.primary` is undefined → write a one-line warning to stderr and copy the unsuffixed default.
-   - No hit otherwise → skip the file (this only happens if the base template was deleted and only orphan variants remain, which the Phase 0 audit prevents).
-
-The target filename in the consumer dir is always the BASE name (`<base>.md`) — variant suffixes are an internal package detail.
-
-### Tie-break — which variant wins?
-
-If a consumer declares both `python` and `swift` in `framework.languages` AND a template ships both `.python.md` and `.swift.md`, the variant declared FIRST in `framework.languages` wins. Consumers control this by reordering keys in `massu.config.yaml`. Passthrough-fallback entries (rule 1.3) are appended AFTER all `framework.languages` entries.
-
-There is no per-template override mechanism. If you need one, file an issue.
-
-## 3. Local-edit protection — the manifest
-
-`@massu/core@1.3.0` introduces a manifest at:
-
-```
-<consumer-root>/<claudeDirName>/.massu/install-manifest.json
-```
-
-(where `claudeDirName` is the value of `conventions.claudeDirName` in `massu.config.yaml`, defaulting to `.claude`).
-
-Each entry maps an asset-relative path (e.g., `commands/massu-scaffold-router.md`) to the SHA-256 of its content at the last successful install.
-
-### What the installer does on each run
-
-For each file `<asset>` to be installed, three hashes are computed:
-
-| Hash | What it represents |
-|------|--------------------|
-| `sourceHash` | The bundled upstream content NOW. |
-| `existingHash` | The current consumer file content. `undefined` if missing. |
-| `lastInstalledHash` | The hash recorded in the manifest. `undefined` on first install. |
-
-Decision matrix:
-
-| Condition | Action | Counter |
-|-----------|--------|---------|
-| target missing | write upstream, record `sourceHash` in manifest | `installed` |
-| `existingHash === sourceHash` | already in sync; record `sourceHash` (covers manifest healing) | `skipped` |
-| `lastInstalledHash` undefined AND `existingHash !== sourceHash` | first-install heuristic: keep the consumer file, record `existingHash`, print a one-line notice | `kept` |
-| `existingHash !== lastInstalledHash` (consumer edited it) | preserve, print `kept your version` notice + diff hint | `kept` |
-| `existingHash === lastInstalledHash` AND `sourceHash !== lastInstalledHash` (clean upstream upgrade) | write upstream, record `sourceHash` | `updated` |
-
-The manifest is written **atomically** (`tempfile + renameSync`) so a crash mid-install never leaves a partially-written manifest.
-
-### What this means for you
-
-- Edit your `<claudeDirName>/commands/*.md` freely. The installer will not stomp your edits.
-- To accept the upstream version of a file you've edited: delete it and rerun `install-commands`.
-- To diff your version against upstream:
-  ```bash
-  diff .claude/commands/massu-scaffold-router.md \
-       <(npx @massu/core show-template massu-scaffold-router)
-  ```
-
-## 4. `npx @massu/core show-template <name>`
-
-Prints the resolved template content (post-variant-resolution) to stdout. Used in the diff one-liner above. Accepts both `massu-scaffold-router` and `massu-scaffold-router.md`. Exits 1 on unknown names.
-
-## 5. Currently shipped variants
-
-| Base | Variants |
-|------|----------|
-| `massu-scaffold-router` | `.python-fastapi.md` (FastAPI — two-axis), `.python-django.md` (Django — two-axis) |
-| `massu-scaffold-page` | `.swift.md` (SwiftUI), regenerated default with embedded Next.js / FastAPI / SwiftUI / Rust examples |
-| `massu-deploy` | `.python-launchd.md`, `.python-systemd.md`, `.python-docker.md`, `.python-fly.md` (all two-axis) |
-
-All other top-level templates ship as variant-agnostic defaults (one `<base>.md`).
-
-### Template variable substitution
-
-As of `@massu/core@1.3.0`, template files may contain `{{variable.path}}` and `{{variable.path | default("fallback")}}` placeholders. These are rendered against the consumer's `massu.config.yaml` (all `framework.*`, `paths.*`, and `config.*` fields) plus the `detected.*` block written by the codebase introspector (e.g. `detected.python.auth_dep`, `detected.swift.api_client_class`).
-
-Rules:
-- Every `{{detected.*}}` reference MUST include a `| default("...")` fallback — introspection may return nothing.
-- Use `\{{` to emit a literal `{{` in the rendered output (e.g. Go/Docker format strings).
-- A render error on a single file causes that file to be skipped (stderr message only); the rest of the install continues.
-
-Pass `--skip-commands` to `massu init` or `massu refresh` to suppress command installation entirely.
-
-## 6. Adding a new variant
-
-1. Create `<base>.<lang>.md` in this directory using the same frontmatter shape as the default.
-2. The default `<base>.md` should remain generic (or be regenerated if it was previously stack-specific — see `massu-scaffold-page.md` for the pattern of an embedded multi-stack default).
-3. Add a row to the table in section 5.
-4. Add a test case to `packages/core/src/__tests__/install-commands.test.ts` that exercises the new variant against a fixture config.
-
-## 7. Reference
-
-- Implementation: `packages/core/src/commands/install-commands.ts`
-- Tests: `packages/core/src/__tests__/install-commands.test.ts` and `show-template.test.ts`

package/src/adapter.ts

@@ -1,121 +0,0 @@
-/**
- * `@massu/core/adapter` — public adapter authoring SDK (Plan 3c gap-31, gap-35).
- *
- * Adapter authors import from this subpath ONLY; everything inside @massu/core
- * outside this entry point is implementation detail subject to change without
- * a major version bump. The contract surface here is part of the SemVer-
- * stable API.
- *
- * Usage (adapter package author):
- *
- *   import { defineAdapter, type CodebaseAdapter } from '@massu/core/adapter';
- *
- *   export default defineAdapter({
- *     id: 'rails-active-record',
- *     languages: ['ruby'],
- *     matches(signals) {
- *       return Boolean(signals.gemfile?.includes('rails'));
- *     },
- *     async introspect(files, rootDir) {
- *       // Tree-sitter queries, AST walks, file sampling…
- *       return {
- *         conventions: { router: 'rails' },
- *         provenance: [{ field: 'router', value: 'config/routes.rb:1', query: 'gemfile' }],
- *         confidence: 'high',
- *       };
- *     },
- *   });
- *
- * Then in the adapter package's package.json:
- *   {
- *     "name": "@massu/adapter-rails",
- *     "version": "0.1.0",
- *     "main": "dist/index.js",
- *     "type": "module",
- *     "massu-adapter": true,
- *     "massu-adapter-api-version": "1",
- *     "peerDependencies": { "@massu/core": ">=1.5.0 <2.0.0" }
- *   }
- *
- * The adapter loader (Plan 3b runner.ts) does
- *   const mod = await import(`<package-dir>/${main}`);
- *   const adapter = (mod.default ?? mod) as CodebaseAdapter;
- * and dispatches matches() + introspect() accordingly.
- *
- * defineAdapter is a NO-OP at runtime — it's an identity function that
- * exists for compile-time type narrowing (so adapter authors get IDE
- * autocomplete + type errors for missing fields). The factory's only job
- * is to anchor the type contract; it does NOT validate at runtime, register
- * anywhere, or mutate state. Runtime validation happens at the loader
- * (Plan 3b runner.ts) which checks the dispatched object shape before
- * invoking matches/introspect.
- *
- * Stability: every export here is part of @massu/core's public SemVer
- * surface. Breaking changes to the CodebaseAdapter shape (renamed fields,
- * removed methods) require a major version bump per the
- * massu-adapter-api-version contract. Adapter packages declare
- * `"massu-adapter-api-version": "1"` so the loader refuses incompatible
- * majors at startup.
- */
-
-export {
-  // The contract every adapter package must implement.
-  type CodebaseAdapter,
-  // Inputs the runner provides to matches() / introspect().
-  type DetectionSignals,
-  type SourceFile,
-  type TreeSitterLanguage,
-  // Output shapes from introspect() + the runner's merge step.
-  type AdapterResult,
-  type Provenance,
-  type AdapterResolved,
-  type MergedAdapterOutput,
-} from './detect/adapters/types.js';
-
-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 /
- * mistyped fields. Runtime: returns the input unchanged. Use this in
- * place of an inline `const adapter: CodebaseAdapter = { ... }`
- * annotation.
- *
- * Returning the input (instead of `void`) means adapter packages can do
- * `export default defineAdapter({ ... })` and the loader's
- * `mod.default` destructuring just works.
- */
-export function defineAdapter(spec: CodebaseAdapter): CodebaseAdapter {
-  return spec;
-}

package/src/adr-generator.ts

@@ -1,292 +0,0 @@
-// Copyright (c) 2026 Massu. All rights reserved.
-// Licensed under BSL 1.1 - see LICENSE file for details.
-
-import type Database from 'better-sqlite3';
-import type { ToolDefinition, ToolResult } from './tools.ts';
-import { getConfig } from './config.ts';
-
-// ============================================================
-// ADR (Architecture Decision Record) Auto-Generation
-// ============================================================
-
-/** Prefix a base tool name with the configured tool prefix. */
-function p(baseName: string): string {
-  return `${getConfig().toolPrefix}_${baseName}`;
-}
-
-/** Default decision detection phrases. Configurable via governance.adr.detection_phrases */
-const DEFAULT_DETECTION_PHRASES = ['chose', 'decided', 'switching to', 'moving from', 'going with'];
-
-/**
- * Get decision detection phrases from config or defaults.
- */
-function getDetectionPhrases(): string[] {
-  return getConfig().governance?.adr?.detection_phrases ?? DEFAULT_DETECTION_PHRASES;
-}
-
-/**
- * Detect decision patterns in text.
- */
-export function detectDecisionPatterns(text: string): boolean {
-  const phrases = getDetectionPhrases();
-  const lower = text.toLowerCase();
-  return phrases.some(phrase => lower.includes(phrase));
-}
-
-/**
- * Extract alternatives from a decision description.
- */
-export function extractAlternatives(description: string): string[] {
-  const alternatives: string[] = [];
-
-  // Pattern: "X over Y"
-  const overMatch = description.match(/(\w[\w\s-]+)\s+over\s+(\w[\w\s-]+)/i);
-  if (overMatch) {
-    alternatives.push(overMatch[1].trim());
-    alternatives.push(overMatch[2].trim());
-  }
-
-  // Pattern: "X instead of Y"
-  const insteadMatch = description.match(/(\w[\w\s-]+)\s+instead\s+of\s+(\w[\w\s-]+)/i);
-  if (insteadMatch) {
-    alternatives.push(insteadMatch[1].trim());
-    alternatives.push(insteadMatch[2].trim());
-  }
-
-  // Pattern: "switching from X to Y"
-  const switchMatch = description.match(/switching\s+from\s+(\w[\w\s-]+)\s+to\s+(\w[\w\s-]+)/i);
-  if (switchMatch) {
-    alternatives.push(switchMatch[2].trim()); // Chosen
-    alternatives.push(switchMatch[1].trim()); // Rejected
-  }
-
-  return [...new Set(alternatives)];
-}
-
-/**
- * Store an architecture decision.
- */
-export function storeDecision(
-  db: Database.Database,
-  decision: {
-    title: string;
-    context: string;
-    decision: string;
-    alternatives: string[];
-    consequences: string;
-    sessionId?: string;
-    status?: string;
-  }
-): number {
-  const result = db.prepare(`
-    INSERT INTO architecture_decisions
-    (title, context, decision, alternatives, consequences, session_id, status)
-    VALUES (?, ?, ?, ?, ?, ?, ?)
-  `).run(
-    decision.title,
-    decision.context,
-    decision.decision,
-    JSON.stringify(decision.alternatives),
-    decision.consequences,
-    decision.sessionId ?? null,
-    decision.status ?? 'accepted'
-  );
-
-  return Number(result.lastInsertRowid);
-}
-
-// ============================================================
-// MCP Tool Definitions & Handlers
-// ============================================================
-
-export function getAdrToolDefinitions(): ToolDefinition[] {
-  return [
-    {
-      name: p('adr_list'),
-      description: 'List all recorded architecture decisions. Filter by status or search text.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          status: { type: 'string', description: 'Filter by status: accepted, superseded, deprecated' },
-          search: { type: 'string', description: 'Search in title and context' },
-        },
-        required: [],
-      },
-    },
-    {
-      name: p('adr_detail'),
-      description: 'Get full details of a specific architecture decision by ID.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          id: { type: 'number', description: 'ADR ID' },
-        },
-        required: ['id'],
-      },
-    },
-    {
-      name: p('adr_create'),
-      description: 'Generate an ADR from a description. Extracts alternatives, context, and consequences.',
-      inputSchema: {
-        type: 'object',
-        properties: {
-          title: { type: 'string', description: 'Decision title' },
-          context: { type: 'string', description: 'Why was this decision needed?' },
-          decision: { type: 'string', description: 'What was decided?' },
-          consequences: { type: 'string', description: 'What are the consequences?' },
-        },
-        required: ['title', 'decision'],
-      },
-    },
-  ];
-}
-
-const ADR_BASE_NAMES = new Set(['adr_list', 'adr_detail', 'adr_create']);
-
-export function isAdrTool(name: string): boolean {
-  const pfx = getConfig().toolPrefix + '_';
-  const baseName = name.startsWith(pfx) ? name.slice(pfx.length) : name;
-  return ADR_BASE_NAMES.has(baseName);
-}
-
-export function handleAdrToolCall(
-  name: string,
-  args: Record<string, unknown>,
-  memoryDb: Database.Database
-): ToolResult {
-  try {
-    const pfx = getConfig().toolPrefix + '_';
-    const baseName = name.startsWith(pfx) ? name.slice(pfx.length) : name;
-
-    switch (baseName) {
-      case 'adr_list':
-        return handleAdrList(args, memoryDb);
-      case 'adr_detail':
-        return handleAdrDetail(args, memoryDb);
-      case 'adr_create':
-        return handleAdrGenerate(args, memoryDb);
-      default:
-        return text(`Unknown ADR tool: ${name}`);
-    }
-  } catch (error) {
-    return text(`Error in ${name}: ${error instanceof Error ? error.message : String(error)}\n\nUsage: ${p('adr_list')} {}, ${p('adr_create')} { title: "...", decision: "..." }`);
-  }
-}
-
-function handleAdrList(args: Record<string, unknown>, db: Database.Database): ToolResult {
-  let sql = 'SELECT id, title, status, created_at FROM architecture_decisions WHERE 1=1';
-  const params: string[] = [];
-
-  if (args.status) {
-    sql += ' AND status = ?';
-    params.push(args.status as string);
-  }
-
-  if (args.search) {
-    sql += ' AND (title LIKE ? OR context LIKE ?)';
-    const searchTerm = `%${args.search}%`;
-    params.push(searchTerm, searchTerm);
-  }
-
-  sql += ' ORDER BY created_at DESC';
-
-  const decisions = db.prepare(sql).all(...params) as Array<Record<string, unknown>>;
-
-  if (decisions.length === 0) {
-    return text(`No architecture decisions found. Decisions are recorded when you use ${p('adr_create')} during design discussions. Try: ${p('adr_create')} { title: "Use Redis for caching", decision: "We chose Redis over Memcached" }`);
-  }
-
-  const lines = [
-    `## Architecture Decisions (${decisions.length})`,
-    '',
-    '| ID | Title | Status | Date |',
-    '|----|-------|--------|------|',
-  ];
-
-  for (const d of decisions) {
-    lines.push(`| ${d.id} | ${d.title} | ${d.status} | ${(d.created_at as string).slice(0, 10)} |`);
-  }
-
-  return text(lines.join('\n'));
-}
-
-function handleAdrDetail(args: Record<string, unknown>, db: Database.Database): ToolResult {
-  const id = args.id as number;
-  if (!id) return text(`Usage: ${p('adr_detail')} { id: 1 } - Get full details of an architecture decision.`);
-
-  const decision = db.prepare(
-    'SELECT * FROM architecture_decisions WHERE id = ?'
-  ).get(id) as Record<string, unknown> | undefined;
-
-  if (!decision) {
-    return text(`ADR #${id} not found. Decisions are stored when created via ${p('adr_create')}. Try: ${p('adr_list')} {} to see all recorded decisions.`);
-  }
-
-  const alternatives = JSON.parse((decision.alternatives as string) || '[]') as string[];
-
-  const lines = [
-    `# ADR-${decision.id}: ${decision.title}`,
-    `Status: ${decision.status}`,
-    `Date: ${(decision.created_at as string).slice(0, 10)}`,
-    '',
-    '## Context',
-    decision.context as string || 'Not specified',
-    '',
-    '## Decision',
-    decision.decision as string,
-    '',
-  ];
-
-  if (alternatives.length > 0) {
-    lines.push('## Alternatives Considered');
-    for (const alt of alternatives) {
-      lines.push(`- ${alt}`);
-    }
-    lines.push('');
-  }
-
-  if (decision.consequences) {
-    lines.push('## Consequences');
-    lines.push(decision.consequences as string);
-  }
-
-  return text(lines.join('\n'));
-}
-
-function handleAdrGenerate(args: Record<string, unknown>, db: Database.Database): ToolResult {
-  const title = args.title as string;
-  const decisionText = args.decision as string;
-  if (!title || !decisionText) return text(`Usage: ${p('adr_create')} { title: "Use Redis for caching", decision: "We chose Redis over Memcached for caching", context: "...", consequences: "..." }`);
-
-  const context = (args.context as string) ?? '';
-  const consequences = (args.consequences as string) ?? '';
-
-  // Extract alternatives from the decision text
-  const alternatives = extractAlternatives(decisionText);
-
-  const id = storeDecision(db, {
-    title,
-    context,
-    decision: decisionText,
-    alternatives,
-    consequences,
-  });
-
-  const lines = [
-    `## ADR-${id} Created: ${title}`,
-    '',
-    `**Status**: accepted`,
-    `**Decision**: ${decisionText}`,
-    alternatives.length > 0 ? `**Alternatives**: ${alternatives.join(', ')}` : '',
-    context ? `**Context**: ${context}` : '',
-    consequences ? `**Consequences**: ${consequences}` : '',
-    '',
-    `View full details: ${p('adr_detail')} { id: ${id} }`,
-  ];
-
-  return text(lines.filter(Boolean).join('\n'));
-}
-
-function text(content: string): ToolResult {
-  return { content: [{ type: 'text', text: content }] };
-}