/** * xray Nucleus — the callable governance kernel (Phase 1.1 facade) * * This is the primary, stable import surface for the v3 nucleus. * * Consumers (bridges, custom tools, the MCP governance server, future self-proposal * engines, CLI, etc.) should import from here rather than reaching into * governance-service.ts, govern-http.ts, or postprocessor internals directly. * * Goals: * - Single place to import the core "govern" capability + supporting types. * - Zero risk to the 41-server federation or existing bridges. * - Easy to tree-shake / split later (e.g. "nucleus/core", "nucleus/http"). * - Documents the public kernel contract. * * Current surface (Phase 1.1): * - handleGovernRequest: the pure semantic convenience handler (direct JSON in/out) * - getGovernanceService: the underlying singleton (for advanced / in-process use) * - Governance types * - MetamorphosisEngine interface (for PostProcessor lifecycle integration) * * MCP remains the canonical standard surface (see governance.server.ts). * The direct HTTP adapter (govern-http.ts) is a convenience on top of this kernel. * * Anti-goals (for this file): * - No new business logic * - No side effects on import * - Does not pull in the full 25 knowledge-skill servers (dynamic via pluginRegistry only) */ import type { GovernOptions, GovernanceContext, GovernanceRequest, GovernanceResponse } from '../governance/governance-types.js'; import { handleGovernRequest } from './govern-http.js'; export { handleGovernRequest }; export type { GovernHTTPConfig } from './govern-http.js'; export { getGovernanceService } from '../governance/governance-service.js'; export type { GovernanceRequest, GovernanceResponse, GovernanceProposal, GovernanceVote, GovernanceResult, GovernanceContext, GovernOptions, ProposalType, } from '../governance/governance-types.js'; export type { MetamorphosisEngine, MetamorphosisProposal, } from '../types/metamorphosis.js'; export { GovernHTTPAdapter } from './govern-http.js'; export { pluginRegistry } from './plugin-registry.js'; export type { SkillPlugin, SkillToolPlugin, SkillProposalArgs, SkillPluginResult } from './plugin-registry.js'; /** * High-level kernel description for introspection / docs. */ export declare const NUCLEUS_VERSION = "0.1.0"; export declare const NUCLEUS_DESCRIPTION: string; /** * Quick helper for the common case: govern a single proposal and get the overall decision. * (Thin wrapper — real power users should use handleGovernRequest directly for batch + full response.) */ export declare function governSingle(proposal: Omit & { id?: string; }, context?: GovernanceContext, options?: GovernOptions): Promise;