@moretea-labs/forge 1.7.2 → 1.8.0

package/src/cli/mcp/tool-capability-cache.ts

@@ -1,87 +1,2 @@
-import type { McpToolDefinition } from './tools';
-
-export type ControllerCapabilityGroup = 'core' | 'repository' | 'workflow' | 'git' | 'runtime' | 'plugins' | 'admin' | 'legacy';
-
-export interface CapabilityGroupSnapshot {
-  group: ControllerCapabilityGroup;
-  toolNames: string[];
-  definitions: McpToolDefinition[];
-}
-
-export interface ToolDefinitionCacheOptions {
-  maxSessions?: number;
-  maxEntriesPerSession?: number;
-}
-
-const CORE_TOOL_NAMES = new Set(['rh_context', 'rh_access', 'rh_work', 'rh_status', 'rh_inbox']);
-
-export function controllerCapabilityGroupForTool(name: string): ControllerCapabilityGroup {
-  if (CORE_TOOL_NAMES.has(name)) return 'core';
-  if (name.startsWith('repository_git_') || name.startsWith('git_')) return 'git';
-  if (name.startsWith('repository_')) return 'repository';
-  if (name.startsWith('plugin_') || name === 'list_plugins') return 'plugins';
-  if (name.startsWith('runtime_') || name.startsWith('controller_')) return 'runtime';
-  if (name.startsWith('work_') || name.startsWith('session_') || name.startsWith('approval_') || name.startsWith('result_')) return 'workflow';
-  if (name.startsWith('admin_')) return 'admin';
-  return 'legacy';
-}
-
-export function groupControllerToolDefinitions(definitions: readonly McpToolDefinition[]): CapabilityGroupSnapshot[] {
-  const grouped = new Map<ControllerCapabilityGroup, McpToolDefinition[]>();
-  for (const definition of definitions) {
-    const group = controllerCapabilityGroupForTool(definition.name);
-    const entries = grouped.get(group) ?? [];
-    entries.push(definition);
-    grouped.set(group, entries);
-  }
-  return [...grouped.entries()].map(([group, entries]) => ({ group, toolNames: entries.map((entry) => entry.name), definitions: entries }));
-}
-
-export class SessionToolDefinitionCache {
-  private readonly sessions = new Map<string, Map<string, readonly McpToolDefinition[]>>();
-  private readonly maxSessions: number;
-  private readonly maxEntriesPerSession: number;
-
-  constructor(options: ToolDefinitionCacheOptions = {}) {
-    this.maxSessions = Math.max(1, options.maxSessions ?? 32);
-    this.maxEntriesPerSession = Math.max(1, options.maxEntriesPerSession ?? 16);
-  }
-
-  getOrCreate(sessionId: string, cacheKey: string, factory: () => readonly McpToolDefinition[]): readonly McpToolDefinition[] {
-    let session = this.sessions.get(sessionId);
-    if (!session) {
-      session = new Map();
-      this.sessions.set(sessionId, session);
-      this.trimSessions();
-    } else {
-      this.sessions.delete(sessionId);
-      this.sessions.set(sessionId, session);
-    }
-    const cached = session.get(cacheKey);
-    if (cached) {
-      session.delete(cacheKey);
-      session.set(cacheKey, cached);
-      return cached;
-    }
-    const created = Object.freeze([...factory()]);
-    session.set(cacheKey, created);
-    while (session.size > this.maxEntriesPerSession) {
-      const oldest = session.keys().next().value;
-      if (oldest === undefined) break;
-      session.delete(oldest);
-    }
-    return created;
-  }
-
-  invalidateSession(sessionId: string): void { this.sessions.delete(sessionId); }
-  clear(): void { this.sessions.clear(); }
-  get sessionCount(): number { return this.sessions.size; }
-
-  private trimSessions(): void {
-    while (this.sessions.size > this.maxSessions) {
-      const oldest = this.sessions.keys().next().value;
-      if (oldest === undefined) break;
-      this.sessions.delete(oldest);
-    }
-  }
-}
+/** @deprecated Kernel V2 compatibility shim. MCP adapter owns this surface. */
+export * from '../../../adapters/mcp/tool-capability-cache';

package/src/cli/mcp/tool-contract.ts

@@ -1,14 +1,2 @@
-import type { CallToolResult as SdkCallToolResult } from '@modelcontextprotocol/sdk/types.js';
-
-/** Transport-neutral MCP tool schema used by legacy, repository and Runtime surfaces. */
-export interface McpToolDefinition {
-  name: string;
-  description: string;
-  inputSchema: Record<string, unknown>;
-  annotations?: Record<string, unknown>;
-}
-
-/** Bounded text-first result contract shared by Forge MCP adapters. */
-export type CallToolResult = Omit<SdkCallToolResult, 'content'> & {
-  content: Array<{ type: 'text'; text: string }>;
-};
+/** @deprecated Kernel V2 compatibility shim. MCP DTO authority lives in packages/protocols/mcp. */
+export * from '../../../packages/protocols/mcp/tool-contract';

package/src/cli/mcp/tools.ts

@@ -1,9 +1,2 @@
-/**
- * Legacy Controller MCP compatibility facade.
- *
- * Gateway code imports the stable tool schema and result types from this
- * module, while the compatibility implementation itself is isolated in
- * legacy-tool-service.ts and is invoked for long work only by Worker
- * processes through the durable ExecutionJob pipeline.
- */
-export * from './legacy-tool-service';
+/** @deprecated Kernel V2 compatibility shim. MCP adapter owns this surface. */
+export * from '../../../adapters/mcp/tool-mapping/tools';

package/src/cli/mcp/toolset-names.ts

@@ -1,70 +1,2 @@
-import { FACADE_TOOLS } from '../../runtime/control-plane/facade/types';
-
-/** Preferred ChatGPT-facing facade tools. Must stay small and stable. */
-export const PREFERRED_FACADE_TOOL_NAMES = [...FACADE_TOOLS] as const;
-
-/**
- * Default ChatGPT-facing MCP surface. The Runtime keeps every internal atomic
- * handler and the full compatibility profile; ChatGPT only needs this bounded
- * execution surface. Atomic Git / issue-task / edit-session / plugin
- * tools remain registered and reachable through `toolset=full`.
- */
-export const DEFAULT_CONTROLLER_TOOL_NAMES = [
-  ...PREFERRED_FACADE_TOOL_NAMES,
-
-  // Repository selection / bootstrap.
-  'repository_list',
-  'repository_get',
-  'repository_register',
-
-  // Generic repository-scoped command (readonly fast path, mutation, destructive gate).
-  'repository_command_execute',
-
-  // Source inspection and bounded Direct Edit. Code location is routed through
-  // rh_context.search; the low-level search_repository handler remains in full.
-  'read_repository_file',
-  'repository_safe_patch_apply',
-
-  // Focused checks through Process Runtime.
-  'run_check',
-
-  // One typed plugin dispatcher. Plugin discovery/action schemas stay routed
-  // through rh_context(capability_id=plugin.<plugin>.<action>) to avoid widening
-  // the default surface with list/get plugin atomics.
-  'plugin_action_execute',
-
-  // Managed Process Runtime lifecycle (attach / poll / cancel — never re-exec).
-  'process_get',
-  'process_wait',
-  'process_logs',
-  'process_cancel',
-
-  // Evidence. Approval resolution is available through rh_access/rh_work and
-  // the explicit full compatibility profile; it does not need a top-level
-  // default tool.
-  'result_read',
-  'result_search',
-] as const;
-
-/** Minimal bootstrap subset retained for diagnostics and constrained clients. */
-export const BOOTSTRAP_CONTROLLER_TOOL_NAMES = [
-  ...PREFERRED_FACADE_TOOL_NAMES,
-  'repository_access_get',
-  'repository_list',
-  'repository_get',
-  'repository_register',
-  'repository_latest_source_diagnose',
-  'repository_bootstrap_local_project',
-] as const;
-
-/**
- * Stable ChatGPT connector schema. Keep this identical to the bounded default
- * Runtime surface so discovery never advertises atomic tools that the default
- * Forge build will reject. The exhaustive `full` profile is assembled directly
- * from registered definitions and remains available for explicit compatibility
- * clients without widening the normal connector schema.
- */
-export const STABLE_CONTROLLER_TOOL_NAMES = DEFAULT_CONTROLLER_TOOL_NAMES;
-
-/** Core is a compatibility label for the bounded default Controller surface. */
-export const CORE_CONTROLLER_TOOL_NAMES = DEFAULT_CONTROLLER_TOOL_NAMES;
+/** @deprecated Kernel V2 compatibility shim. MCP adapter owns this surface. */
+export * from '../../../adapters/mcp/toolset-names';

package/src/cli/mcp/toolset-selection.ts

@@ -1,41 +1,2 @@
-import type { McpLocalConfig } from './auth';
-import type { McpToolset } from './types';
-
-export interface ControllerToolsetSelection {
-  toolset: McpToolset;
-  locked: boolean;
-  migratedLegacyAdvanced: boolean;
-}
-
-export function normalizeConfiguredMcpToolset(value: unknown): McpToolset | undefined {
-  return value === 'facade' || value === 'core' || value === 'advanced' || value === 'full' ? value : undefined;
-}
-
-/** Persisted Core and Advanced are compatibility-equivalent stable profiles. */
-export function configuredControllerToolset(config: McpLocalConfig | null | undefined): McpToolset | undefined {
-  return normalizeConfiguredMcpToolset(config?.toolset);
-}
-
-export function resolveControllerToolsetSelection(
-  config: McpLocalConfig | null | undefined,
-  override?: unknown,
-): ControllerToolsetSelection {
-  const explicitOverride = normalizeConfiguredMcpToolset(override);
-  const configured = configuredControllerToolset(config);
-  return {
-    toolset: explicitOverride ?? configured ?? 'advanced',
-    locked: explicitOverride !== undefined || configured !== undefined,
-    migratedLegacyAdvanced: false,
-  };
-}
-
-export function migrateControllerToolsetConfig(config: McpLocalConfig | null | undefined): {
-  toolset: McpToolset;
-  toolsetExplicit: boolean;
-} {
-  const configured = configuredControllerToolset(config);
-  return {
-    toolset: configured ?? 'advanced',
-    toolsetExplicit: configured !== undefined,
-  };
-}
+/** @deprecated Kernel V2 compatibility shim. MCP adapter owns this surface. */
+export * from '../../../adapters/mcp/toolset-selection';

package/src/cli/mcp/toolset.ts

@@ -1,336 +1,2 @@
-import type { McpToolDefinition } from './tool-contract';
-import type { MultiRepositoryMcpToolContext } from './multi-repository';
-import { buildMultiRepositoryToolDefinitions } from './multi-repository';
-import { accessToolDefinitions } from './access-tools';
-import {
-  resolveControllerAccessState,
-  type ControllerAccessState,
-} from './access-mode';
-import { repositoryToolDefinitions } from './repository-tools';
-import { runtimeToolDefinitions } from '../../runtime/gateway/mcp/runtime-tool-definitions';
-import { executionToolDefinitions } from '../../runtime/gateway/mcp/execution-tools';
-import { processToolDefinitions } from '../../runtime/gateway/mcp/process-tools';
-import { injectDurableCommandFields } from '../../runtime/gateway/mcp/router';
-import { DEFAULT_CONTROLLER_TOOL_NAMES, PREFERRED_FACADE_TOOL_NAMES, STABLE_CONTROLLER_TOOL_NAMES } from './toolset-names';
-export { BOOTSTRAP_CONTROLLER_TOOL_NAMES, CORE_CONTROLLER_TOOL_NAMES, DEFAULT_CONTROLLER_TOOL_NAMES, PREFERRED_FACADE_TOOL_NAMES, STABLE_CONTROLLER_TOOL_NAMES } from './toolset-names';
-import type { McpToolset } from './types';
-import { forgeToolSurfaceFingerprint } from '../controller/runtime-config';
-
-export type ToolExposureClass = 'facade' | 'advanced' | 'internal' | 'compatibility';
-export type ControllerToolProfile = 'facade' | 'core' | 'advanced' | 'full';
-
-export interface ControllerToolInventoryEntry {
-  name: string;
-  profile: ControllerToolProfile;
-  capability: string;
-  exposedVia: 'facade' | 'core' | 'advanced' | 'full';
-}
-
-/**
- * One authoritative snapshot of the MCP schema actually served to a client.
- * Access mode intentionally does not alter this schema: Request vs Full Access
- * is an execution-policy decision, not a tool-discovery decision.
- */
-export interface ControllerExposureSnapshot {
-  access: ControllerAccessState;
-  toolset: McpToolset;
-  profile: ControllerToolProfile;
-  definitions: McpToolDefinition[];
-  toolNames: string[];
-  expectedToolNames: string[];
-  actualToolNames: string[];
-  missingToolNames: string[];
-  unexpectedToolNames: string[];
-  duplicateToolNames: string[];
-  fingerprint: string;
-  inventory: ControllerToolInventoryEntry[];
-  schemaStableAcrossAccessModes: true;
-  ready: boolean;
-}
-
-/**
- * Cached schema/readiness projection for hot paths that do not need access
- * policy or a per-tool inventory. Status uses this rather than rebuilding a
- * complete controller exposure response on every read.
- */
-export interface ControllerToolSurfaceStatus {
-  expectedToolNames: string[];
-  actualToolNames: string[];
-  missingToolNames: string[];
-  unexpectedToolNames: string[];
-  duplicateToolNames: string[];
-  fingerprint: string;
-  schemaStableAcrossAccessModes: true;
-  ready: boolean;
-}
-
-/**
- * Core and Advanced expose the same bounded default ChatGPT surface
- * (DEFAULT_CONTROLLER_TOOL_NAMES). Full remains the exhaustive compatibility
- * surface for legacy integrations; internal atomic handlers are never deleted.
- */
-
-/** Historical Advanced name retained for compatibility. */
-export const ADVANCED_CONTROLLER_TOOL_NAMES = DEFAULT_CONTROLLER_TOOL_NAMES;
-
-const DEFAULT_CONTROLLER_TOOL_SET = new Set<string>(DEFAULT_CONTROLLER_TOOL_NAMES);
-
-interface StaticControllerExposureSnapshot {
-  definitions: McpToolDefinition[];
-  toolNames: string[];
-  expectedToolNames: string[];
-  actualToolNames: string[];
-  missingToolNames: string[];
-  unexpectedToolNames: string[];
-  duplicateToolNames: string[];
-  fingerprint: string;
-  schemaStableAcrossAccessModes: true;
-  ready: boolean;
-}
-
-const STATIC_EXPOSURE_CACHE_MAX_ENTRIES = 64;
-const staticControllerExposureCache = new Map<string, StaticControllerExposureSnapshot>();
-
-function pruneStaticExposureCache(): void {
-  while (staticControllerExposureCache.size > STATIC_EXPOSURE_CACHE_MAX_ENTRIES) {
-    const oldest = staticControllerExposureCache.keys().next().value as string | undefined;
-    if (!oldest) break;
-    staticControllerExposureCache.delete(oldest);
-  }
-}
-
-export function normalizeMcpToolset(value: unknown): McpToolset {
-  if (value === 'full' || value === 'advanced' || value === 'core' || value === 'facade') return value;
-  return 'advanced';
-}
-
-/**
- * null means expose every registered definition. Profile membership only
- * changes schema discovery; authorization remains an independent policy.
- */
-export function controllerToolNamesForToolset(
-  toolset: McpToolset,
-  _ctx?: MultiRepositoryMcpToolContext,
-): readonly string[] | null {
-  if (toolset === 'full') return null;
-  if (toolset === 'facade') return PREFERRED_FACADE_TOOL_NAMES;
-  return DEFAULT_CONTROLLER_TOOL_NAMES;
-}
-
-export function resolveControllerAccessStateForContext(
-  ctx: MultiRepositoryMcpToolContext,
-): ControllerAccessState {
-  return resolveControllerAccessState({
-    controllerHome: ctx.controllerHome,
-    repoRoot: ctx.explicitRepository?.canonicalRoot,
-    toolsetOverride: ctx.toolset,
-    toolsetLocked: ctx.toolsetLocked ?? false,
-  });
-}
-
-function uniqueDefinitions(definitions: McpToolDefinition[]): {
-  definitions: McpToolDefinition[];
-  duplicates: string[];
-} {
-  const byName = new Map<string, McpToolDefinition>();
-  const duplicates = new Set<string>();
-  for (const definition of definitions) {
-    if (byName.has(definition.name)) {
-      duplicates.add(definition.name);
-      continue;
-    }
-    byName.set(definition.name, definition);
-  }
-  const preferredOrder = new Map<string, number>(
-    (PREFERRED_FACADE_TOOL_NAMES as readonly string[]).map((name, index) => [name, index]),
-  );
-  const orderedDefinitions = [...byName.values()].sort((left, right) => {
-    const leftOrder = preferredOrder.get(left.name);
-    const rightOrder = preferredOrder.get(right.name);
-    if (leftOrder !== undefined || rightOrder !== undefined) {
-      if (leftOrder === undefined) return 1;
-      if (rightOrder === undefined) return -1;
-      return leftOrder - rightOrder;
-    }
-    return 0;
-  });
-  return { definitions: orderedDefinitions, duplicates: [...duplicates].sort() };
-}
-
-function staticExposureCacheKey(ctx: MultiRepositoryMcpToolContext): string {
-  return JSON.stringify({
-    controllerHome: ctx.controllerHome,
-    repoRoot: ctx.repoRoot,
-    explicitRepositoryId: ctx.explicitRepository?.repoId,
-    toolset: ctx.toolset,
-    profile: ctx.policy.profile,
-    enableChatgptBrowser: ctx.enableChatgptBrowser === true,
-    devAgentRunner: ctx.policy.execution.agentRunner,
-    allowedAgents: [...ctx.policy.execution.allowedAgents].sort(),
-    runnerTimeoutMs: ctx.policy.execution.runnerTimeoutMs,
-    runnerMaxTimeoutMs: ctx.policy.execution.runnerMaxTimeoutMs,
-  });
-}
-
-function buildStaticControllerExposureSnapshot(
-  ctx: MultiRepositoryMcpToolContext,
-): StaticControllerExposureSnapshot {
-  const currentDefinitions = runtimeToolDefinitions.concat(
-    executionToolDefinitions,
-    processToolDefinitions,
-    accessToolDefinitions,
-    repositoryToolDefinitions,
-  );
-  const rawDefinitions = ctx.toolset === 'full'
-    ? currentDefinitions.concat(
-      buildMultiRepositoryToolDefinitions(ctx).filter(
-        (legacy) => !currentDefinitions.some((current) => current.name === legacy.name),
-      ),
-    )
-    : currentDefinitions;
-  const unique = uniqueDefinitions(rawDefinitions);
-  const allowed = controllerToolNamesForToolset(ctx.toolset, ctx);
-  const expectedToolNames = allowed === null
-    ? unique.definitions.map((tool) => tool.name)
-    : [...new Set(allowed)];
-  const definitionByName = new Map(unique.definitions.map((definition) => [definition.name, definition]));
-  const definitions = expectedToolNames
-    .map((name) => definitionByName.get(name))
-    .filter((definition): definition is McpToolDefinition => Boolean(definition))
-    // Fingerprint the definitions that ListTools actually returns. The server
-    // adds durable command fields to every object schema, so calculating the
-    // fence from the pre-injection form would miss a change to those fields.
-    .map(injectDurableCommandFields);
-  const actualToolNames = definitions.map((tool) => tool.name);
-  const actualSet = new Set(actualToolNames);
-  const expectedSet = new Set(expectedToolNames);
-  const missingToolNames = expectedToolNames.filter((name) => !actualSet.has(name));
-  const unexpectedToolNames = actualToolNames.filter((name) => !expectedSet.has(name));
-  const fingerprint = forgeToolSurfaceFingerprint(definitions);
-  return {
-    definitions,
-    toolNames: actualToolNames,
-    expectedToolNames,
-    actualToolNames,
-    missingToolNames,
-    unexpectedToolNames,
-    duplicateToolNames: unique.duplicates,
-    fingerprint,
-    schemaStableAcrossAccessModes: true,
-    ready: missingToolNames.length === 0 && unexpectedToolNames.length === 0 && unique.duplicates.length === 0,
-  };
-}
-
-function staticControllerExposureSnapshot(
-  ctx: MultiRepositoryMcpToolContext,
-): StaticControllerExposureSnapshot {
-  const key = staticExposureCacheKey(ctx);
-  const cached = staticControllerExposureCache.get(key);
-  if (cached) return cached;
-  const built = buildStaticControllerExposureSnapshot(ctx);
-  staticControllerExposureCache.set(key, built);
-  pruneStaticExposureCache();
-  return built;
-}
-
-function capabilityForToolName(name: string): string {
-  if (name.startsWith('rh_')) return 'facade';
-  if (name.startsWith('git_') || name.startsWith('repository_git_')) return 'git';
-  if (/(^|_)(issue|task|project|worklog)(_|$)/.test(name)) return 'issue-task';
-  if (name.startsWith('repository_') || name.startsWith('search_') || name.startsWith('read_')) return 'repository';
-  if (name.startsWith('ios_')) return 'ios';
-  if (name.startsWith('web_')) return 'browser';
-  if (name.includes('plugin')) return 'plugin';
-  if (name.startsWith('result_') || name.includes('artifact') || name.includes('evidence')) return 'evidence';
-  if (name.includes('controller_')) return 'controller';
-  if (name.startsWith('process_') || name.startsWith('schedule_') || name.startsWith('runtime_') || name.startsWith('maintenance_')) return 'runtime-maintenance';
-  if (name.startsWith('work_') || name.startsWith('session_')) return 'workflow';
-  return 'compatibility';
-}
-
-function profileForToolset(toolset: McpToolset): ControllerToolProfile {
-  return toolset === 'full' ? 'full' : toolset === 'facade' ? 'facade' : toolset === 'core' ? 'core' : 'advanced';
-}
-
-export function controllerToolInventory(
-  toolNames: readonly string[],
-  toolset: McpToolset,
-): ControllerToolInventoryEntry[] {
-  const profile = profileForToolset(toolset);
-  return toolNames.map((name) => ({
-    name,
-    profile,
-    capability: capabilityForToolName(name),
-    exposedVia: name.startsWith('rh_') ? 'facade' : profile,
-  }));
-}
-
-export function clearControllerExposureCacheForTest(): void {
-  staticControllerExposureCache.clear();
-}
-
-export function allControllerToolDefinitions(ctx: MultiRepositoryMcpToolContext): McpToolDefinition[] {
-  return uniqueDefinitions(
-    runtimeToolDefinitions.concat(executionToolDefinitions, processToolDefinitions, accessToolDefinitions, repositoryToolDefinitions, buildMultiRepositoryToolDefinitions(ctx)),
-  ).definitions;
-}
-
-export function controllerExposureSnapshot(ctx: MultiRepositoryMcpToolContext): ControllerExposureSnapshot {
-  const staticSnapshot = staticControllerExposureSnapshot(ctx);
-  return {
-    access: resolveControllerAccessStateForContext(ctx),
-    toolset: ctx.toolset,
-    profile: profileForToolset(ctx.toolset),
-    inventory: controllerToolInventory(staticSnapshot.actualToolNames, ctx.toolset),
-    ...staticSnapshot,
-  };
-}
-
-export function controllerToolSurfaceStatus(ctx: MultiRepositoryMcpToolContext): ControllerToolSurfaceStatus {
-  const snapshot = staticControllerExposureSnapshot(ctx);
-  return {
-    expectedToolNames: snapshot.expectedToolNames,
-    actualToolNames: snapshot.actualToolNames,
-    missingToolNames: snapshot.missingToolNames,
-    unexpectedToolNames: snapshot.unexpectedToolNames,
-    duplicateToolNames: snapshot.duplicateToolNames,
-    fingerprint: snapshot.fingerprint,
-    schemaStableAcrossAccessModes: snapshot.schemaStableAcrossAccessModes,
-    ready: snapshot.ready,
-  };
-}
-
-export function controllerExposedToolNames(ctx: MultiRepositoryMcpToolContext): string[] {
-  return controllerExposureSnapshot(ctx).actualToolNames;
-}
-
-export function classifyControllerToolExposure(toolName: string): ToolExposureClass {
-  if ((PREFERRED_FACADE_TOOL_NAMES as readonly string[]).includes(toolName)) return 'facade';
-  if (toolName.startsWith('rh_')) return 'facade';
-  if (DEFAULT_CONTROLLER_TOOL_SET.has(toolName)) return 'advanced';
-  return 'compatibility';
-}
-
-export function controllerToolExposureMetadata(toolNames: readonly string[]): {
-  preferredTools: string[];
-  advancedTools: string[];
-  compatibilityTools: string[];
-  classification: Record<string, ToolExposureClass>;
-} {
-  const classification: Record<string, ToolExposureClass> = {};
-  for (const name of toolNames) classification[name] = classifyControllerToolExposure(name);
-  return {
-    preferredTools: toolNames.filter((name) => classification[name] === 'facade'),
-    advancedTools: toolNames.filter((name) => classification[name] === 'advanced'),
-    compatibilityTools: toolNames.filter((name) => classification[name] === 'compatibility'),
-    classification,
-  };
-}
-
-export function exposedControllerToolDefinitions(ctx: MultiRepositoryMcpToolContext): McpToolDefinition[] {
-  return controllerExposureSnapshot(ctx).definitions;
-}
-
-export function isControllerToolExposed(ctx: MultiRepositoryMcpToolContext, name: string): boolean {
-  return controllerExposureSnapshot(ctx).actualToolNames.includes(name);
-}
+/** @deprecated Kernel V2 compatibility shim. MCP adapter owns this surface. */
+export * from '../../../adapters/mcp/toolset';

package/src/cli/mcp/transports/AGENTS.md

@@ -26,14 +26,5 @@ Keep this file focused on the local contract for this primary functional block.
 - Semantic diagram source: `docs/architecture/modules/controller-runtime/transport-lifecycle.md`
 - Latest human diagram: `(none yet)`
 - Pending architecture request: `none`
-
-## Active Workstreams
-
-- (none yet)
-
-## Current Session Projection
-
-- Durable progress lives under `tasks/workstreams/controller-runtime/transport-lifecycle`.
-- `tasks/current.md` is the tracked derived status snapshot; it is not a live lock or task source.
-- `tasks/todos.md` is the deferred-goal ledger; current execution slices stay in the active plan's `## Task Breakdown`.
+- Runtime progress authority: Forge Controller Home Requirement/Plan/Work/Evidence; this repository block contains authored architecture context only.
 <!-- END ARCHITECTURE CONTRACT -->

package/src/cli/mcp/transports/CLAUDE.md

@@ -26,14 +26,5 @@ Keep this file focused on the local contract for this primary functional block.
 - Semantic diagram source: `docs/architecture/modules/controller-runtime/transport-lifecycle.md`
 - Latest human diagram: `(none yet)`
 - Pending architecture request: `none`
-
-## Active Workstreams
-
-- (none yet)
-
-## Current Session Projection
-
-- Durable progress lives under `tasks/workstreams/controller-runtime/transport-lifecycle`.
-- `tasks/current.md` is the tracked derived status snapshot; it is not a live lock or task source.
-- `tasks/todos.md` is the deferred-goal ledger; current execution slices stay in the active plan's `## Task Breakdown`.
+- Runtime progress authority: Forge Controller Home Requirement/Plan/Work/Evidence; this repository block contains authored architecture context only.
 <!-- END ARCHITECTURE CONTRACT -->