/**
 * Stable discovery facade: literal metadata and types have separate pure owners.
 * The transitive dependency boundary is checked by the CLI capability tests.
 * Command modules must never enter this graph: their top-level usage constants
 * can become undefined through an ESM cycle. This is not an execution sandbox.
 */
import { CAPABILITIES as BASE_CAPABILITIES } from "./capabilities-base";
import type { Capability } from "./capability-types";
import { PROVIDER_MODEL_CAPABILITIES } from "./capabilities-provider-models";
import { ACCOUNT_CAPABILITIES } from "./capabilities-accounts";
import { AGENT_ROUTING_CAPABILITIES } from "./capabilities-agents-routing";
import { INTEGRATION_CAPABILITIES } from "./capabilities-integrations";
import { OBSERVE_SYSTEM_CAPABILITIES } from "./capabilities-observe-system";
import { ACCESS_REMOTE_CAPABILITIES } from "./capabilities-access-remote";
import { LAB_CAPABILITIES } from "./capabilities-lab";
import { ROUTE_TO_CAPABILITIES } from "./capabilities-route-to";

export const CAPABILITIES: readonly Capability[] = [
  ...BASE_CAPABILITIES,
  ...PROVIDER_MODEL_CAPABILITIES,
  ...ACCOUNT_CAPABILITIES,
  ...AGENT_ROUTING_CAPABILITIES,
  ...INTEGRATION_CAPABILITIES,
  ...OBSERVE_SYSTEM_CAPABILITIES,
  ...ACCESS_REMOTE_CAPABILITIES,
  ...LAB_CAPABILITIES,
  ...ROUTE_TO_CAPABILITIES,
];

export { HEAD_CAPABILITIES } from "./capabilities-base";
export type {
  CapabilityRoute,
  CapabilityFlag,
  CapabilityJsonMode,
  Capability,
  HeadCapability,
} from "./capability-types";

/** Capabilities that drive `route`, for `ocx capabilities --route`. */
export function capabilitiesForRoute(path: string): Capability[] {
  return CAPABILITIES.filter(cap => cap.routes.some(r => r.path === path));
}

/** Every `(method, path)` pair any capability drives. */
export function capabilityRouteKeys(): Set<string> {
  const keys = new Set<string>();
  for (const cap of CAPABILITIES) {
    for (const route of cap.routes) keys.add(`${route.method} ${route.path}`);
  }
  return keys;
}

/** Rendered command path, e.g. `ocx account pause`. */
export function capabilityInvocation(cap: Capability): string {
  return `ocx ${cap.command.join(" ")}`;
}
