feat: MCP inventory (ecc.mcp.v1) — unified cross-harness MCP config view (#2146)

* feat: add MCP inventory (ecc.mcp.v1) across harnesses

Read-only MCP-gateway groundwork: discover MCP server configs across
every installed harness, normalize to a canonical ecc.mcp.v1 inventory,
redact secrets, and report which servers are configured in 2+ harnesses
(the configure-N-times pain). The read+dedup side of a unified gateway,
mirroring how the session-adapter layer started read-only.

Readers (per-harness config formats):
- claude-code: ~/.claude.json mcpServers + project .mcp.json
- codex: ~/.codex/config.toml [mcp_servers.*] TOML via @iarna/toml
- opencode: ~/.config/opencode/opencode.json mcp block (command ARRAY)

canonical-mcp.js:
- normalize transport labels (local=>stdio, remote=>http) to stdio/http/sse
- merge servers by name across harnesses; flag DRIFT when signatures differ
- fragmentation report + aggregates
- SECRET REDACTION: env values stripped to key names; secrets in args
  (--modelApiKey sk-ant-...), inline --flag=secret, and URL userinfo/token
  query params all redacted before storage AND before the dedup signature.

scripts/mcp-inventory.js: CLI (--json, --fragmented, --help).
tests/lib/mcp-inventory.test.js: 12 tests incl. a regression for the
real arg-carried-secret leak found while smoke-testing on live configs.

Tests: 12/0. Real-data smoke: 33 servers across 3 harnesses, 21
configured in 2+ harnesses (7 drift); secret-leak audit clean.

* test: cover reader error paths, collect skip-logic, and CLI main() for mcp-inventory

Lift global branch coverage past the 80% gate (was 79.86%). Adds 6
tests exercising: missing-file/malformed-JSON/missing-block reader
fallbacks, codex no-parser path, collect skipping non-function readers
and swallowing reader errors, CLI usage()/main() help+json+human paths,
and formatHumanReport no-fragmentation + fragmented-only branches.

Also scrub a real API-key fragment that had leaked into a test fixture;
all secret-like fixtures are now obviously-fake FAKE... tokens.

mcp-inventory.js branch 30%->93%, collect.js ->100%. Global branch 80.33%.

scripts/lib/mcp-inventory/readers/claude-code.js

@@ -0,0 +1,73 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+// Claude Code stores MCP servers under "mcpServers" in ~/.claude.json (user
+// scope) and in project-local .mcp.json files (project scope). Each entry:
+//   { type: "stdio"|"http"|"sse", command, args[], env{}, url }
+function mapClaudeServer(name, raw, source) {
+  if (!raw || typeof raw !== 'object') {
+    return null;
+  }
+
+  return {
+    name,
+    type: typeof raw.type === 'string' ? raw.type : (raw.url ? 'http' : 'stdio'),
+    command: raw.command || null,
+    args: Array.isArray(raw.args) ? raw.args : [],
+    url: raw.url || null,
+    env: raw.env && typeof raw.env === 'object' ? raw.env : {},
+    enabled: raw.disabled === true ? false : true,
+    source
+  };
+}
+
+function readMcpServersBlock(filePath, scope) {
+  if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+    return [];
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return [];
+  }
+
+  const block = parsed && typeof parsed.mcpServers === 'object' && parsed.mcpServers
+    ? parsed.mcpServers
+    : {};
+
+  return Object.entries(block)
+    .map(([name, raw]) => mapClaudeServer(name, raw, {
+      harness: 'claude-code',
+      scope,
+      configPath: filePath
+    }))
+    .filter(Boolean);
+}
+
+function readClaudeCodeMcp(options = {}) {
+  const homeDir = options.homeDir || os.homedir();
+  const userConfig = options.userConfigPath || path.join(homeDir, '.claude.json');
+  const projectConfigPaths = Array.isArray(options.projectConfigPaths)
+    ? options.projectConfigPaths
+    : [];
+
+  const records = [
+    ...readMcpServersBlock(userConfig, 'user')
+  ];
+
+  for (const projectPath of projectConfigPaths) {
+    records.push(...readMcpServersBlock(projectPath, 'project'));
+  }
+
+  return records;
+}
+
+module.exports = {
+  readClaudeCodeMcp,
+  mapClaudeServer
+};