Function ensurePluginRuntime

cli/src/opencode/utils/hookPlugin.ts:191–212

* Ensure the opencode runtime can resolve `@opencode-ai/plugin` from our * isolated config dir. Since opencode 1.14.x the plugin loader is a separate * npm package, and ` /plugins/*.ts` files are only evaluated when * that package is resolvable from ` `. HAPI's per-session *

(rootPath: string)

 *     degraded but not fatal.
 */
function ensurePluginRuntime(rootPath: string): void {
    if (!isHapiManagedDir(rootPath)) {
        logger.debug(`[opencode-hook] Skipping plugin runtime materialization for non-HAPI dir: ${rootPath}`);
        return;
    }

    const packageJsonPath = join(rootPath, PACKAGE_JSON_FILENAME);
    if (existsSync(packageJsonPath)) {
        if (hasDeclaredPluginPackage(packageJsonPath)) {
            // Existing file already declares the plugin (likely opencode-
            // installed with a matching lock file). Leave it untouched.
            return;
        }
        logger.debug(`[opencode-hook] package.json exists at ${packageJsonPath} but does not declare ${PLUGIN_PACKAGE}; overwriting placeholder.`);
    }

    try {
        writeFileSync(packageJsonPath, buildMinimalPackageJson(), 'utf-8');
    } catch (error) {
        logger.warn(`[opencode-hook] Failed to materialize ${packageJsonPath}; the hook plugin channel may stay inert. Storage scanner remains as fallback. Error: ${(error as Error).message}`);
    }
}

export function ensureOpencodeHookPlugin(rootPath: string, hookUrl: string, token: string): string {
    const pluginDir = resolvePluginDir(rootPath);