@cleocode/adapters 2026.5.4 → 2026.5.5

package/dist/providers/opencode/adapter.js

@@ -1,166 +0,0 @@
-/**
- * OpenCode Adapter
- *
- * Main CLEOProviderAdapter implementation for OpenCode AI coding assistant.
- * Provides spawn, hooks, and install capabilities for CLEO integration.
- *
- * @task T5240
- */
-import { exec } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { promisify } from 'node:util';
-import { OpenCodeHookProvider } from './hooks.js';
-import { OpenCodeInstallProvider } from './install.js';
-import { OpenCodeSpawnProvider } from './spawn.js';
-const execAsync = promisify(exec);
-/**
- * CLEO provider adapter for OpenCode AI coding assistant.
- *
- * Bridges CLEO's adapter system with OpenCode's native capabilities:
- * - Hooks: Maps OpenCode events (session.start, tool.complete, etc.) to CAAMP events
- * - Spawn: Launches subagent processes via the `opencode` CLI
- * - Install: Ensures AGENTS.md references for CLEO instruction files
- *
- * @remarks
- * OpenCode is the second-most feature-complete adapter after Claude Code,
- * supporting 10 canonical events through its JavaScript plugin system,
- * subagent spawning via the `opencode run` CLI command, and instruction
- * file management via AGENTS.md. It uniquely supports PreModel via the
- * `chat.params` event, which allows pre-inference parameter injection.
- */
-export class OpenCodeAdapter {
-    /** Unique provider identifier. */
-    id = 'opencode';
-    /** Human-readable provider name. */
-    name = 'OpenCode';
-    /** Adapter version string. */
-    version = '1.0.0';
-    /** Declared capabilities for this provider. */
-    capabilities = {
-        supportsHooks: true,
-        // 10/16 canonical events — derived from getProviderHookProfile('opencode') in CAAMP 1.9.1.
-        // PostToolUseFailure, SubagentStart, SubagentStop, Notification, ConfigChange are
-        // not supported by OpenCode's plugin system.
-        supportedHookEvents: [
-            'SessionStart',
-            'SessionEnd',
-            'PromptSubmit',
-            'ResponseComplete',
-            'PreToolUse',
-            'PostToolUse',
-            'PermissionRequest',
-            'PreModel',
-            'PreCompact',
-            'PostCompact',
-        ],
-        supportsSpawn: true,
-        supportsInstall: true,
-        supportsInstructionFiles: true,
-        instructionFilePattern: 'AGENTS.md',
-        supportsContextMonitor: false,
-        supportsStatusline: false,
-        supportsProviderPaths: true,
-        supportsTransport: false,
-        supportsTaskSync: false,
-    };
-    /** Hook provider for CAAMP event mapping via OpenCode's plugin system. */
-    hooks;
-    /** Spawn provider for launching subagent processes via `opencode run`. */
-    spawn;
-    /** Install provider for managing AGENTS.md instruction files. */
-    install;
-    /** Project directory this adapter was initialized with, or null. */
-    projectDir = null;
-    /** Whether {@link initialize} has been called. */
-    initialized = false;
-    constructor() {
-        this.hooks = new OpenCodeHookProvider();
-        this.spawn = new OpenCodeSpawnProvider();
-        this.install = new OpenCodeInstallProvider();
-    }
-    /**
-     * Initialize the adapter for a given project directory.
-     *
-     * Validates the environment by checking for the OpenCode CLI
-     * and OpenCode configuration directory.
-     *
-     * @param projectDir - Root directory of the project
-     */
-    async initialize(projectDir) {
-        this.projectDir = projectDir;
-        this.initialized = true;
-    }
-    /**
-     * Dispose the adapter and clean up resources.
-     *
-     * Unregisters hooks and releases any tracked state.
-     */
-    async dispose() {
-        if (this.hooks.isRegistered()) {
-            await this.hooks.unregisterNativeHooks();
-        }
-        this.initialized = false;
-        this.projectDir = null;
-    }
-    /**
-     * Run a health check to verify OpenCode is accessible.
-     *
-     * Checks:
-     * 1. Adapter has been initialized
-     * 2. OpenCode CLI is available in PATH
-     * 3. .opencode/ configuration directory exists in the project
-     *
-     * @returns Health status with details about each check
-     */
-    async healthCheck() {
-        const details = {};
-        if (!this.initialized) {
-            return {
-                healthy: false,
-                provider: this.id,
-                details: { error: 'Adapter not initialized' },
-            };
-        }
-        // Check OpenCode CLI availability
-        let cliAvailable = false;
-        try {
-            const { stdout } = await execAsync('which opencode');
-            cliAvailable = stdout.trim().length > 0;
-            details.cliPath = stdout.trim();
-        }
-        catch {
-            details.cliAvailable = false;
-        }
-        // Check for OpenCode config directory in the project
-        if (this.projectDir) {
-            const openCodeConfigDir = join(this.projectDir, '.opencode');
-            const configExists = existsSync(openCodeConfigDir);
-            details.configDirExists = configExists;
-        }
-        // Check for OPENCODE_VERSION env var
-        const versionEnvSet = process.env.OPENCODE_VERSION !== undefined;
-        details.versionEnvSet = versionEnvSet;
-        // Healthy if CLI is available (primary requirement)
-        const healthy = cliAvailable;
-        details.cliAvailable = cliAvailable;
-        return {
-            healthy,
-            provider: this.id,
-            details,
-        };
-    }
-    /**
-     * Check whether the adapter has been initialized.
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Get the project directory this adapter was initialized with.
-     */
-    getProjectDir() {
-        return this.projectDir;
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/dist/providers/opencode/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/providers/opencode/adapter.ts"],"names":[],"mappings":"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"}

package/dist/providers/opencode/hooks.js

@@ -1,206 +0,0 @@
-/**
- * OpenCode Hook Provider
- *
- * Maps OpenCode's native hook events to CAAMP canonical hook events.
- * OpenCode supports 10 of 16 canonical events through its plugin system.
- *
- * Event translation uses CAAMP normalizer APIs:
- * - `toCanonical(nativeName, 'opencode')` for runtime event name resolution
- * - `getSupportedEvents('opencode')` to enumerate supported canonical events
- * - `getProviderHookProfile('opencode')` for the full provider profile
- *
- * OpenCode uses a JavaScript plugin system with event-prefixed names
- * (e.g. `event:session.created`) for some hooks and bare names for others.
- * The map is derived from `getProviderHookProfile('opencode').mappings` in
- * CAAMP 1.9.1. PostToolUseFailure, SubagentStart, SubagentStop, Notification,
- * and ConfigChange are not supported by OpenCode.
- *
- * @task T164
- * @epic T134
- */
-/** CAAMP provider identifier for OpenCode. */
-const PROVIDER_ID = 'opencode';
-/**
- * Fallback map from OpenCode native event names to CAAMP canonical names.
- *
- * Derived from `getProviderHookProfile('opencode').mappings` in CAAMP 1.9.1.
- * Covers all 10 supported events. PostToolUseFailure, SubagentStart,
- * SubagentStop, Notification, and ConfigChange are not supported by OpenCode
- * and are absent from this map.
- *
- * OpenCode uses dot-delimited and event-prefixed names (e.g. "event:session.created")
- * while CAAMP canonical names are PascalCase (e.g. "SessionStart").
- */
-const OPENCODE_EVENT_MAP = {
-    // CAAMP: toNative('SessionStart',       'opencode') = 'event:session.created'
-    'event:session.created': 'SessionStart',
-    // CAAMP: toNative('SessionEnd',         'opencode') = 'event:session.deleted'
-    'event:session.deleted': 'SessionEnd',
-    // CAAMP: toNative('PromptSubmit',       'opencode') = 'chat.message'
-    'chat.message': 'PromptSubmit',
-    // CAAMP: toNative('ResponseComplete',   'opencode') = 'event:session.idle'
-    'event:session.idle': 'ResponseComplete',
-    // CAAMP: toNative('PreToolUse',         'opencode') = 'tool.execute.before'
-    'tool.execute.before': 'PreToolUse',
-    // CAAMP: toNative('PostToolUse',        'opencode') = 'tool.execute.after'
-    'tool.execute.after': 'PostToolUse',
-    // CAAMP: toNative('PermissionRequest',  'opencode') = 'permission.ask'
-    'permission.ask': 'PermissionRequest',
-    // CAAMP: toNative('PreModel',           'opencode') = 'chat.params'
-    'chat.params': 'PreModel',
-    // CAAMP: toNative('PreCompact',         'opencode') = 'experimental.session.compacting'
-    'experimental.session.compacting': 'PreCompact',
-    // CAAMP: toNative('PostCompact',        'opencode') = 'event:session.compacted'
-    'event:session.compacted': 'PostCompact',
-};
-/**
- * Hook provider for OpenCode.
- *
- * OpenCode registers hooks via its JavaScript plugin system at
- * `.opencode/plugins/`. Supported handler type: plugin (JavaScript).
- *
- * Event mapping is based on `getProviderHookProfile('opencode')` from
- * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
- * `getProviderProfile`) call CAAMP directly when available.
- *
- * Since hooks are registered through the plugin system (managed by the install
- * provider), `registerNativeHooks` and `unregisterNativeHooks` track registration
- * state without performing filesystem operations.
- *
- * @remarks
- * OpenCode uses dot-delimited and `event:`-prefixed event names
- * (e.g. `event:session.created`, `tool.execute.before`) which differ
- * significantly from the PascalCase CAAMP canonical names. The static
- * event map covers all 10 supported events. Async CAAMP accessors
- * (`getSupportedCanonicalEvents`, `getProviderProfile`, `toNativeEvent`)
- * call the normalizer directly when available and fall back to the static map.
- *
- * @task T164
- * @epic T134
- */
-export class OpenCodeHookProvider {
-    /** Whether hooks have been registered for the current session. */
-    registered = false;
-    /**
-     * Map an OpenCode native event name to a CAAMP canonical hook event name.
-     *
-     * Looks up the native event name in the map derived from
-     * `getProviderHookProfile('opencode').mappings` (CAAMP 1.9.1).
-     * Returns null for unsupported events (PostToolUseFailure, SubagentStart,
-     * SubagentStop, Notification, ConfigChange).
-     *
-     * @param providerEvent - OpenCode native event (e.g. "event:session.created", "tool.execute.before")
-     * @returns CAAMP canonical event name, or null if unmapped
-     * @task T164
-     */
-    mapProviderEvent(providerEvent) {
-        return OPENCODE_EVENT_MAP[providerEvent] ?? null;
-    }
-    /**
-     * Register native hooks for a project.
-     *
-     * For OpenCode, hooks are registered via the plugin system
-     * (`.opencode/plugins/`), managed by the install provider.
-     * This method marks hooks as registered without performing filesystem operations.
-     *
-     * Iterating supported events is handled at install time using
-     * `getSupportedCanonicalEvents()` to enumerate all 10 supported hooks.
-     *
-     * @param _projectDir - Project directory (unused; config manages registration)
-     * @task T164
-     */
-    async registerNativeHooks(_projectDir) {
-        this.registered = true;
-    }
-    /**
-     * Unregister native hooks.
-     *
-     * For OpenCode, this is a no-op since hooks are managed through the plugin
-     * system. Unregistration happens via the install provider's uninstall method.
-     *
-     * @task T164
-     */
-    async unregisterNativeHooks() {
-        this.registered = false;
-    }
-    /**
-     * Check whether hooks have been registered via `registerNativeHooks`.
-     */
-    isRegistered() {
-        return this.registered;
-    }
-    /**
-     * Get the native→canonical event mapping for introspection and debugging.
-     *
-     * Returns the map derived from `getProviderHookProfile('opencode').mappings`
-     * (CAAMP 1.9.1). Use `getSupportedCanonicalEvents()` to enumerate canonical
-     * names via live CAAMP APIs.
-     *
-     * @returns Immutable record of native event name → canonical event name
-     */
-    getEventMap() {
-        return { ...OPENCODE_EVENT_MAP };
-    }
-    /**
-     * Enumerate supported canonical events via CAAMP's `getSupportedEvents()`.
-     *
-     * Calls `getSupportedEvents('opencode')` from the CAAMP normalizer to get the
-     * authoritative list. OpenCode supports 10 of 16 canonical events via its
-     * plugin system. Falls back to the values of the static event map when
-     * CAAMP is unavailable at runtime.
-     *
-     * @returns Array of CAAMP canonical event names supported by OpenCode
-     * @task T164
-     */
-    async getSupportedCanonicalEvents() {
-        try {
-            const { getSupportedEvents } = await import('@cleocode/caamp');
-            return getSupportedEvents(PROVIDER_ID);
-        }
-        catch {
-            return [...new Set(Object.values(OPENCODE_EVENT_MAP))];
-        }
-    }
-    /**
-     * Retrieve the full provider hook profile from CAAMP.
-     *
-     * Calls `getProviderHookProfile('opencode')` from the CAAMP normalizer to
-     * get the complete profile: hook system type (`plugin`), config path
-     * (`.opencode/plugins/`), handler types, and all event mappings.
-     * Returns null when CAAMP is unavailable at runtime.
-     *
-     * @returns Provider hook profile or null if CAAMP is unavailable
-     * @task T164
-     */
-    async getProviderProfile() {
-        try {
-            const { getProviderHookProfile } = await import('@cleocode/caamp');
-            return getProviderHookProfile(PROVIDER_ID) ?? null;
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Translate a CAAMP canonical event to its OpenCode native name via CAAMP.
-     *
-     * Calls `toNative(canonical, 'opencode')` from the CAAMP normalizer.
-     * Returns null for unsupported events or when CAAMP is unavailable.
-     *
-     * @param canonical - CAAMP canonical event name (e.g. "PreToolUse")
-     * @returns OpenCode native event name or null
-     * @task T164
-     */
-    async toNativeEvent(canonical) {
-        try {
-            const { toNative } = await import('@cleocode/caamp');
-            return toNative(canonical, PROVIDER_ID);
-        }
-        catch {
-            // Invert the static map as fallback
-            const entry = Object.entries(OPENCODE_EVENT_MAP).find(([, v]) => v === canonical);
-            return entry?.[0] ?? null;
-        }
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/providers/opencode/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/providers/opencode/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,8CAA8C;AAC9C,MAAM,WAAW,GAAG,UAAmB,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAA2B;IACjD,8EAA8E;IAC9E,uBAAuB,EAAE,cAAc;IACvC,8EAA8E;IAC9E,uBAAuB,EAAE,YAAY;IACrC,qEAAqE;IACrE,cAAc,EAAE,cAAc;IAC9B,2EAA2E;IAC3E,oBAAoB,EAAE,kBAAkB;IACxC,4EAA4E;IAC5E,qBAAqB,EAAE,YAAY;IACnC,2EAA2E;IAC3E,oBAAoB,EAAE,aAAa;IACnC,uEAAuE;IACvE,gBAAgB,EAAE,mBAAmB;IACrC,oEAAoE;IACpE,aAAa,EAAE,UAAU;IACzB,wFAAwF;IACxF,iCAAiC,EAAE,YAAY;IAC/C,gFAAgF;IAChF,yBAAyB,EAAE,aAAa;CACzC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,oBAAoB;IAC/B,kEAAkE;IAC1D,UAAU,GAAG,KAAK,CAAC;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAqB;QACpC,OAAO,kBAAkB,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC;IACnD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,mBAAmB,CAAC,WAAmB;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,qBAAqB;QACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,2BAA2B;QAC/B,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC/D,OAAO,kBAAkB,CAAC,WAAW,CAAa,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,kBAAkB;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACnE,OAAO,sBAAsB,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC,SAA2C,EAAE,WAAW,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YAClF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;CACF"}

package/dist/providers/opencode/index.js

@@ -1,37 +0,0 @@
-/**
- * @packageDocumentation
- *
- * CLEO provider adapter for OpenCode AI coding assistant.
- * Default export is the adapter class for dynamic loading by AdapterManager.
- *
- * @task T5240
- */
-import { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeAdapter } from './adapter.js';
-export { OpenCodeHookProvider } from './hooks.js';
-export { OpenCodeInstallProvider } from './install.js';
-export { OpenCodeSpawnProvider } from './spawn.js';
-export default OpenCodeAdapter;
-/**
- * Factory function for creating adapter instances.
- * Used by AdapterManager's dynamic import fallback.
- *
- * @remarks
- * This is the primary entry point for dynamic adapter loading.
- * AdapterManager calls this function when it resolves the opencode
- * provider via its import-based discovery mechanism.
- *
- * @returns A new {@link OpenCodeAdapter} instance ready for initialization
- *
- * @example
- * ```typescript
- * import { createAdapter } from '@cleocode/adapters/providers/opencode';
- *
- * const adapter = createAdapter();
- * await adapter.initialize('/path/to/project');
- * ```
- */
-export function createAdapter() {
-    return new OpenCodeAdapter();
-}
-//# sourceMappingURL=index.js.map

package/dist/providers/opencode/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAe,eAAe,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/providers/opencode/install.js

@@ -1,242 +0,0 @@
-/**
- * OpenCode Install Provider
- *
- * Handles CLEO installation into OpenCode environments:
- * - Ensures AGENTS.md has CLEO @-references
- * - Installs PreCompact hook shell shims + a JS plugin wrapper (T1013)
- *
- * @task T5240
- * @task T1013
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { installProviderHookTemplates, } from '../shared/hook-template-installer.js';
-import { getCleoTemplatesTildePath } from '../shared/paths.js';
-/**
- * Lines that should appear in AGENTS.md to reference CLEO.
- * The CLEO-INJECTION.md path is resolved dynamically to support non-default
- * XDG / OS installation locations (T916).
- */
-const INSTRUCTION_REFERENCES = [
-    `@${getCleoTemplatesTildePath()}/CLEO-INJECTION.md`,
-    '@.cleo/memory-bridge.md',
-];
-/**
- * Install provider for OpenCode.
- *
- * Manages CLEO's integration with OpenCode by:
- * 1. Ensuring AGENTS.md contains @-references to CLEO instruction files
- * 2. Installing PreCompact hook shell templates + generating the JS plugin
- *    wrapper that spawns the shim on `experimental.session.compacting` (T1013).
- *
- * @remarks
- * Installation is idempotent -- running install multiple times on the same
- * project produces the same result. OpenCode's plugin system is the native
- * hook surface (OpenCode has no config-file hook registry like Claude Code or
- * Cursor), so the installer writes a JS plugin that subscribes to the native
- * event and spawns the shell shim as a child process. This keeps the DRY
- * contract: all providers funnel through the shared `cleo-precompact-core.sh`
- * helper and end up in the `cleo` CLI.
- */
-export class OpenCodeInstallProvider {
-    /**
-     * Install CLEO into an OpenCode project.
-     *
-     * @param options - Installation options including project directory
-     * @returns Result describing what was installed
-     */
-    async install(options) {
-        const { projectDir } = options;
-        const installedAt = new Date().toISOString();
-        let instructionFileUpdated = false;
-        const details = {};
-        // Step 1: Ensure AGENTS.md has @-references
-        instructionFileUpdated = this.updateInstructionFile(projectDir);
-        if (instructionFileUpdated) {
-            details.instructionFile = join(projectDir, 'AGENTS.md');
-        }
-        // Step 2 (T1013): Install PreCompact hook templates + generate the JS
-        // plugin wrapper that spawns the bash shim on
-        // `experimental.session.compacting`.
-        const hookResult = this.installHookTemplates(projectDir);
-        if (hookResult) {
-            details.hookTemplates = hookResult;
-        }
-        return {
-            success: true,
-            installedAt,
-            instructionFileUpdated,
-            details,
-        };
-    }
-    /**
-     * Uninstall CLEO from the current OpenCode project.
-     *
-     * Does not remove AGENTS.md references (they are harmless if CLEO is not present).
-     */
-    async uninstall() { }
-    /**
-     * Check whether CLEO is installed in the current environment.
-     *
-     * Checks for CLEO references in AGENTS.md.
-     */
-    async isInstalled() {
-        const agentsMdPath = join(process.cwd(), 'AGENTS.md');
-        if (existsSync(agentsMdPath)) {
-            try {
-                const content = readFileSync(agentsMdPath, 'utf-8');
-                if (INSTRUCTION_REFERENCES.some((ref) => content.includes(ref))) {
-                    return true;
-                }
-            }
-            catch {
-                // Fall through
-            }
-        }
-        return false;
-    }
-    /**
-     * Ensure AGENTS.md contains @-references to CLEO instruction files.
-     *
-     * Creates AGENTS.md if it does not exist. Appends any missing references.
-     *
-     * @param projectDir - Project root directory
-     */
-    async ensureInstructionReferences(projectDir) {
-        this.updateInstructionFile(projectDir);
-    }
-    /**
-     * Update AGENTS.md with CLEO @-references.
-     *
-     * @returns true if the file was created or modified
-     */
-    updateInstructionFile(projectDir) {
-        const agentsMdPath = join(projectDir, 'AGENTS.md');
-        let content = '';
-        let existed = false;
-        if (existsSync(agentsMdPath)) {
-            content = readFileSync(agentsMdPath, 'utf-8');
-            existed = true;
-        }
-        const missingRefs = INSTRUCTION_REFERENCES.filter((ref) => !content.includes(ref));
-        if (missingRefs.length === 0) {
-            return false;
-        }
-        const refsBlock = missingRefs.join('\n');
-        if (existed) {
-            // Append missing references
-            const separator = content.endsWith('\n') ? '' : '\n';
-            content = content + separator + refsBlock + '\n';
-        }
-        else {
-            // Create new AGENTS.md with references
-            content = refsBlock + '\n';
-        }
-        writeFileSync(agentsMdPath, content, 'utf-8');
-        return true;
-    }
-    /**
-     * Install the CLEO PreCompact hook templates for OpenCode (T1013).
-     *
-     * OpenCode uses a JavaScript plugin system, not config-based hooks. The
-     * installer:
-     *
-     * 1. Writes the shared bash helper and OpenCode-flavoured `precompact.sh`
-     *    to `<projectDir>/.opencode/plugins/hooks/` so the shim can be spawned
-     *    as a child process.
-     * 2. Generates an OpenCode plugin `.opencode/plugins/cleo-precompact.js`
-     *    that subscribes to `experimental.session.compacting` (CAAMP native
-     *    event for the canonical `PreCompact`) and spawns the shim.
-     *
-     * Idempotent.
-     *
-     * @param projectDir - Project root directory.
-     * @returns Install summary, or `null` when no change was required.
-     *
-     * @task T1013
-     */
-    installHookTemplates(projectDir) {
-        const pluginsDir = join(projectDir, '.opencode', 'plugins');
-        const hooksDir = join(pluginsDir, 'hooks');
-        // Template copy is best-effort so missing/locked filesystems (CI sandboxes,
-        // mocked `node:fs` in unit tests) don't fail the whole install.
-        let templates;
-        try {
-            templates = installProviderHookTemplates({
-                provider: 'opencode',
-                targetDir: hooksDir,
-            });
-        }
-        catch {
-            return null;
-        }
-        let pluginWritten = false;
-        try {
-            pluginWritten = this.writePrecompactPlugin(pluginsDir, join(hooksDir, 'precompact.sh'));
-        }
-        catch {
-            // Best-effort: never block install on hook wiring failures.
-        }
-        if (templates.installedFiles.length === 0 && !pluginWritten) {
-            return null;
-        }
-        return { templates, pluginWritten };
-    }
-    /**
-     * Write an OpenCode JavaScript plugin that spawns `precompact.sh` when the
-     * canonical `PreCompact` event fires. OpenCode exposes the event natively as
-     * `experimental.session.compacting` (see CAAMP `hook-mappings.json`).
-     *
-     * The generated file is idempotent — overwritten only when its content
-     * differs from the target on disk. Uses `child_process.spawn` so the bash
-     * shim runs in a separate process and does not block the compaction path.
-     *
-     * @param pluginsDir - Absolute path to `.opencode/plugins/`.
-     * @param shimPath - Absolute path to the installed `precompact.sh`.
-     * @returns `true` when the plugin file was written, `false` when unchanged.
-     *
-     * @task T1013
-     */
-    writePrecompactPlugin(pluginsDir, shimPath) {
-        const pluginPath = join(pluginsDir, 'cleo-precompact.js');
-        const generated = [
-            '// CLEO PreCompact plugin for OpenCode (generated by @cleocode/adapters).',
-            '// Bridges the canonical CAAMP `PreCompact` event',
-            '// (`experimental.session.compacting`) to the shell shim at:',
-            `//   ${shimPath}`,
-            '// The shim invokes only the `cleo` CLI — no core internals.',
-            '',
-            "import { spawn } from 'node:child_process';",
-            '',
-            'export default function register(plugin) {',
-            "  plugin.on('experimental.session.compacting', () => {",
-            '    try {',
-            `      const child = spawn(${JSON.stringify(shimPath)}, [], {`,
-            '        detached: true,',
-            "        stdio: 'ignore',",
-            '      });',
-            '      child.unref();',
-            '    } catch (err) {',
-            '      // Hook errors must never block compaction.',
-            "      console.error('[CLEO] precompact hook failed:', err);",
-            '    }',
-            '  });',
-            '}',
-            '',
-        ].join('\n');
-        if (existsSync(pluginPath)) {
-            try {
-                if (readFileSync(pluginPath, 'utf-8') === generated) {
-                    return false;
-                }
-            }
-            catch {
-                // Fall through and overwrite.
-            }
-        }
-        mkdirSync(pluginsDir, { recursive: true });
-        writeFileSync(pluginPath, generated, 'utf-8');
-        return true;
-    }
-}
-//# sourceMappingURL=install.js.map

package/dist/providers/opencode/install.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"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"}