@evomap/evolver-mcp 2.0.0-beta.4 → 2.0.0-beta.6

package/dist/index.d.ts

@@ -10,4 +10,7 @@ export * from './serviceGuidance.js';
 export * from './codexInstaller.js';
 export * from './cursorRulesInstaller.js';
 export * from './antigravityInstaller.js';
+export * from './jsonMcpInstaller.js';
+export * from './opencodeInstaller.js';
+export * from './kiroInstaller.js';
 export * from './envFile.js';

package/dist/index.js

@@ -10,4 +10,7 @@ export * from './serviceGuidance.js';
 export * from './codexInstaller.js';
 export * from './cursorRulesInstaller.js';
 export * from './antigravityInstaller.js';
+export * from './jsonMcpInstaller.js';
+export * from './opencodeInstaller.js';
+export * from './kiroInstaller.js';
 export * from './envFile.js';

package/dist/injection.d.ts

@@ -4,7 +4,8 @@ export type InjectionMode = 'mcp-hooks' | 'mcp-plugin' | 'mcp-config' | 'cursor-
  * Setup support contract (#217). A bootstrapper that delegates runtime onboarding to evolver v2 needs a
  * DETERMINISTIC answer for every runtime it might ask about — not just the ones v2 can write config for.
  * The three outcomes are the whole contract:
- *  - `installed`   v2 can write the runtime config/hooks and verify it (claude-code, codex, cursor, antigravity).
+ *  - `installed`   v2 can write the runtime config/hooks and verify it (claude-code, codex, cursor, antigravity,
+ *                  opencode, kiro).
  *  - `manual`      v2 cannot mutate this runtime's config, but the path is real: it prints precise MCP/HTTP
  *                  wiring the operator does by hand (opencode, openclaw, mcp-generic, http-agent, server).
  *  - `unsupported` v2 refuses with a clear reason (an unrecognized runtime id).

package/dist/injection.js

@@ -3,12 +3,10 @@ export const SETUP_RUNTIMES = [
     'claude-code', 'codex', 'cursor', 'antigravity', 'opencode', 'kiro', 'openclaw', 'mcp-generic', 'http-agent', 'server',
 ];
 /** Runtimes v2 can write config/hooks for and verify. Antigravity is MCP-config-only (no lifecycle hook). */
-const INSTALLED_RUNTIMES = new Set(['claude-code', 'codex', 'cursor', 'antigravity']);
+const INSTALLED_RUNTIMES = new Set(['claude-code', 'codex', 'cursor', 'antigravity', 'opencode', 'kiro']);
 /** Runtimes with no v2 auto-installer but a real manual path. The reason is the short, honest "do it by hand"
  *  line; the precise wiring text is a separate concern (#217 slice 2), not hard-coded here. */
 const MANUAL_RUNTIMES = new Map([
-    ['opencode', 'opencode is consumed passively today; register the evolver MCP server in its config by hand'],
-    ['kiro', 'kiro is consumed passively today; register the evolver MCP server in its config by hand'],
     ['openclaw', 'no v2 auto-installer yet; wire the evolver MCP server (or PrivateHub HTTP/A2A) by hand'],
     ['mcp-generic', 'no config writer for a generic MCP client; register the evolver MCP server by hand'],
     ['http-agent', 'no config writer for an HTTP/API-only agent; wire it to PrivateHub HTTP/A2A by hand'],
@@ -67,12 +65,17 @@ export function planInjection(runtime, server) {
                 config: { mcpServers: { evolver: { command: server.command, args: server.args ?? [], ...(server.env ? { env: server.env } : {}) } } },
                 note: 'antigravity: write mcpServers.evolver in the user-level MCP config; tool discovery only (no SessionStart hook)',
             };
-        case 'kiro':
         case 'opencode':
             return {
-                runtime, mode: 'passive',
-                config: {},
-                note: `${runtime}: MVP 仅被动消费会话日志(无工具注入); 接入方式待补`,
+                runtime, mode: 'mcp-config',
+                config: { mcp: { evolver: { type: 'local', command: [server.command, ...(server.args ?? [])], ...(server.env ? { environment: server.env } : {}), enabled: true } } },
+                note: 'OpenCode: write opencode.json local MCP registration; no lifecycle prompt injection.',
+            };
+        case 'kiro':
+            return {
+                runtime, mode: 'mcp-config',
+                config: { mcpServers: { evolver: { command: server.command, args: server.args ?? [], ...(server.env ? { env: server.env } : {}), disabled: false } } },
+                note: 'Kiro: write .kiro/settings/mcp.json MCP registration; no lifecycle prompt injection.',
             };
         default: {
             const _exhaustive = runtime;

package/dist/installer.d.ts

@@ -32,6 +32,8 @@ export interface InstallOptions {
     hookCommand?: string;
     /** Reinstall even if an evolver install is already present. */
     force?: boolean;
+    /** Plan and validate without writing config or backup files. */
+    dryRun?: boolean;
     /** Cursor only: the top genes to render into .cursor/rules/evolver.mdc. The daemon refreshes these on change;
      *  a one-shot `setup-hooks --runtime=cursor` install seeds the file (empty ⇒ a placeholder the daemon fills). */
     genes?: readonly CursorGene[];
@@ -40,12 +42,44 @@ export interface InstallOptions {
     /** Antigravity only: override the user home used to resolve ~/.gemini config roots. Intended for hermetic
      *  embedding/tests; normal callers omit it. configRoot and scope do not affect Antigravity's user config. */
     homeDir?: string;
+    /** Kiro user scope only: direct replacement for ~/.kiro, matching KIRO_HOME semantics. */
+    kiroHome?: string;
+    /** OpenCode user scope only: explicit XDG_CONFIG_HOME used to resolve the global config. */
+    xdgConfigHome?: string;
+    /** OpenCode user scope only: explicit OPENCODE_CONFIG file override. */
+    opencodeConfig?: string;
+    /** OpenCode user scope only: explicit OPENCODE_CONFIG_DIR override. */
+    opencodeConfigDir?: string;
+    /** OpenCode only: inline config loaded after project/custom-directory config. */
+    opencodeConfigContent?: string;
+    /** OpenCode only: mirrors truthy OPENCODE_DISABLE_PROJECT_CONFIG handling. */
+    opencodeDisableProjectConfig?: boolean;
+    /** OpenCode only: injectable managed-config directory for hermetic tests. */
+    opencodeManagedConfigDir?: string;
+    /** OpenCode only: injectable macOS managed-preference paths for hermetic tests. */
+    opencodeManagedPreferencePaths?: readonly string[];
+    /** OpenCode only: injectable platform used to resolve system managed paths. */
+    opencodePlatform?: NodeJS.Platform;
+    /** OpenCode only: injectable ProgramData used to resolve the Windows managed path. */
+    opencodeProgramData?: string;
+    /** OpenCode only: injectable username used to resolve macOS managed preferences. */
+    opencodeUsername?: string;
 }
 export interface UninstallOptions {
     configRoot: string;
     scope?: InstallScope;
     /** Antigravity only: override the user home used to resolve ~/.gemini config roots. */
     homeDir?: string;
+    /** Kiro user scope only: direct replacement for ~/.kiro, matching KIRO_HOME semantics. */
+    kiroHome?: string;
+    /** Validate and report the uninstall without changing config or backup files. */
+    dryRun?: boolean;
+    /** OpenCode user scope only: explicit XDG_CONFIG_HOME used to resolve the global config. */
+    xdgConfigHome?: string;
+    /** OpenCode user scope only: explicit OPENCODE_CONFIG file override. */
+    opencodeConfig?: string;
+    /** OpenCode user scope only: explicit OPENCODE_CONFIG_DIR override. */
+    opencodeConfigDir?: string;
 }
 export interface InstallResult {
     ok: boolean;
@@ -54,6 +88,9 @@ export interface InstallResult {
     /** Absolute paths written (install) or cleaned (uninstall). */
     files: string[];
     alreadyInstalled?: boolean;
+    dryRun?: boolean;
+    verified?: boolean;
+    backups?: string[];
     error?: string;
 }
 export declare class SymlinkRefusedError extends Error {

package/dist/installer.js

@@ -23,6 +23,8 @@ import { installCodex, uninstallCodex } from './codexInstaller.js';
 // top genes into .cursor/rules/evolver.mdc. It plugs into the same install/uninstall dispatch below.
 import { installCursorRules, uninstallCursorRules } from './cursorRulesInstaller.js';
 import { installAntigravity, uninstallAntigravity } from './antigravityInstaller.js';
+import { installOpenCode, uninstallOpenCode } from './opencodeInstaller.js';
+import { installKiro, uninstallKiro } from './kiroInstaller.js';
 /** Marks a config file as containing evolver-managed entries, so uninstall only removes what we added. */
 export const MANAGED_MARKER = '_evolver_managed';
 /** A hook entry is evolver-owned if any of its commands mention this — used to replace-not-duplicate on reinstall. */
@@ -404,9 +406,14 @@ export function installInjection(plan, opts) {
     if (plan.runtime === 'antigravity') {
         return installAntigravity(plan, opts);
     }
+    if (plan.runtime === 'opencode') {
+        return installOpenCode(plan, opts);
+    }
+    if (plan.runtime === 'kiro') {
+        return installKiro(plan, opts);
+    }
     if (plan.runtime !== 'claude-code') {
-        // kiro/opencode are passive (handled above); any other active runtime is not yet ported.
-        return { ok: false, runtime: plan.runtime, mode: plan.mode, files: [], error: `installer not yet implemented for ${plan.runtime} (supported: claude-code, codex, cursor, antigravity)` };
+        return { ok: false, runtime: plan.runtime, mode: plan.mode, files: [], error: `installer not yet implemented for ${plan.runtime} (supported: claude-code, codex, cursor, antigravity, opencode, kiro)` };
     }
     const hookCommand = opts.hookCommand ?? DEFAULT_HOOK_COMMAND;
     const scope = opts.scope ?? 'project';
@@ -487,6 +494,12 @@ export function uninstallInjection(runtime, opts) {
     if (runtime === 'antigravity') {
         return uninstallAntigravity(runtime, opts);
     }
+    if (runtime === 'opencode') {
+        return uninstallOpenCode(runtime, opts);
+    }
+    if (runtime === 'kiro') {
+        return uninstallKiro(runtime, opts);
+    }
     if (runtime !== 'claude-code') {
         return { ok: false, runtime, mode: 'n/a', files: [], error: `uninstall not implemented for ${runtime}` };
     }

package/dist/jsonMcpInstaller.d.ts

@@ -0,0 +1,75 @@
+import type { InjectionPlan, McpServerCmd, RuntimeId } from './injection.js';
+import { type InstallOptions, type InstallResult, type UninstallOptions } from './installer.js';
+type BeforeReplaceHook = (path: string) => void;
+export declare function _setJsonMcpBeforeReplaceHookForTest(hook?: BeforeReplaceHook): void;
+export declare function _setJsonMcpAfterReplaceHookForTest(hook?: BeforeReplaceHook): void;
+export declare function _setJsonMcpBeforeBackupRemoveHookForTest(hook?: BeforeReplaceHook): void;
+export interface JsonMcpRuntimeSpec {
+    runtime: 'opencode' | 'kiro';
+    configPath(opts: JsonMcpPathOptions): string;
+    resolveConfig?(opts: JsonMcpPathOptions): JsonMcpRuntimeResolution;
+    safeRoot?(opts: JsonMcpPathOptions): string;
+    conflictingPaths?(opts: JsonMcpPathOptions): string[];
+    containerKey: 'mcp' | 'mcpServers';
+    entry(server: McpServerCmd): Record<string, unknown>;
+    installPreflight?(resolution: JsonMcpRuntimeResolution, opts: InstallOptions, expected: Record<string, unknown>): JsonMcpInstallPreflight | undefined;
+}
+export interface JsonMcpInstallPreflight {
+    alreadyInstalled?: boolean;
+    assertUnchanged(): void;
+}
+type JsonMcpPathOptions = Pick<InstallOptions, 'configRoot' | 'scope' | 'homeDir' | 'kiroHome' | 'xdgConfigHome' | 'opencodeConfig' | 'opencodeConfigDir'>;
+export interface JsonMcpRuntimeResolution {
+    configPath: string;
+    safeRoot: string;
+    conflictingPaths: string[];
+    /** An active sibling at the same precedence slot that must remain user-owned and read-only. */
+    activePrecedencePath?: string;
+    /** The writable target was retargeted to a uniquely managed config discovered outside the active path. */
+    managedRetarget?: true;
+    /** Runtime config candidates ordered from lowest to highest precedence; the first path is the default target. */
+    topologyCandidatePaths?: string[];
+    evidencePaths?: string[];
+    /** Config locations that may contain a managed backup from an earlier active-precedence decision. */
+    uninstallCandidatePaths?: string[];
+    /** Broader locations used to reuse a managed target selected from an ancestor project directory. */
+    installDiscoveryPaths?: string[];
+    /** Safe root for install discovery and a selected managed target; does not affect default install writes. */
+    installSafeRoot?: string;
+    /** Broader read-only locations used only to discover managed backups during uninstall. */
+    uninstallDiscoveryPaths?: string[];
+    /** Safe root for uninstall discovery and a selected managed target; does not affect install writes. */
+    uninstallSafeRoot?: string;
+    /** Candidate-local conflicts that must be re-evaluated after uninstall retargeting. */
+    uninstallConflictingPaths?: (configPath: string) => string[];
+}
+export declare class McpConfigConflictError extends Error {
+    readonly diff: {
+        path: string;
+        expected: unknown;
+        actual: unknown;
+    };
+    constructor(runtime: string, path: string, expected: unknown, actual: unknown);
+}
+export declare class McpConfigShapeError extends Error {
+    constructor(runtime: string, path: string, detail: string);
+}
+export declare class McpConfigOwnershipError extends Error {
+    constructor(runtime: string, detail: string);
+}
+export declare class McpConfigVerificationError extends Error {
+    private readonly runtime;
+    private readonly path;
+    restored: boolean;
+    constructor(runtime: string, path: string);
+    markRestored(): void;
+}
+export declare class McpConfigChangedError extends Error {
+    constructor(runtime: string, path: string);
+}
+export declare class McpServerValidationError extends Error {
+    constructor(message: string);
+}
+export declare function installJsonMcpRuntime(spec: JsonMcpRuntimeSpec, plan: InjectionPlan, opts: InstallOptions): InstallResult;
+export declare function uninstallJsonMcpRuntime(spec: JsonMcpRuntimeSpec, runtime: RuntimeId, opts: UninstallOptions): InstallResult;
+export {};