opencode-lcm 0.13.5 → 0.13.6

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.6] - 2026-04-11
+
+### Fixed
+- Bun on Windows now leaves the plugin in a pre-SQLite safe mode by default and requires an explicit override to enable the full archive hooks
+
 ## [0.13.5] - 2026-04-11
 
 ### Fixed

package/README.md

@@ -105,6 +105,9 @@ Add `opencode-lcm` to your `opencode.json` (project or global `~/.config/opencod
 > [!IMPORTANT]
 > All defaults are applied automatically. Expand below only if you need to override settings.
 
+> [!IMPORTANT]
+> On Bun for Windows, `opencode-lcm` now starts in a pre-SQLite safe mode and only exposes `lcm_status` by default. This avoids a Bun/Windows native-crash path seen in the field. To force-enable the full plugin anyway, set `"runtimeSafety": { "allowUnsafeBunWindows": true }` in the plugin config or export `OPENCODE_LCM_ALLOW_UNSAFE_BUN_WINDOWS=1` before starting OpenCode.
+
 <details>
 <summary><strong>Full Configuration</strong> (click to expand)</summary>
 

package/dist/index.js

@@ -1,8 +1,59 @@
 import { tool } from '@opencode-ai/plugin';
 import { resolveOptions } from './options.js';
 import { SqliteLcmStore } from './store.js';
+const ALLOW_UNSAFE_BUN_WINDOWS_ENV = 'OPENCODE_LCM_ALLOW_UNSAFE_BUN_WINDOWS';
+function isTruthyEnvFlag(value) {
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+}
+function isBunRuntime() {
+    return typeof globalThis === 'object' && globalThis !== null && 'Bun' in globalThis;
+}
+function isUnsafeBunWindowsRuntime() {
+    return isBunRuntime() && process.platform === 'win32';
+}
+function resolveAllowUnsafeBunWindows(options) {
+    return (options.runtimeSafety.allowUnsafeBunWindows ||
+        isTruthyEnvFlag(process.env[ALLOW_UNSAFE_BUN_WINDOWS_ENV]));
+}
+function buildSafeModeStatus(allowUnsafeBunWindows) {
+    return [
+        'status=disabled',
+        'reason=bun_windows_runtime_guard',
+        'available_tools=lcm_status',
+        `platform=${process.platform}`,
+        `bun_runtime=${isBunRuntime()}`,
+        `runtime_safety_allow_unsafe_bun_windows=${allowUnsafeBunWindows}`,
+        'override_config=runtimeSafety.allowUnsafeBunWindows=true',
+        `override_env=${ALLOW_UNSAFE_BUN_WINDOWS_ENV}=1`,
+        'message=opencode-lcm disabled itself before opening SQLite because Bun on Windows has reported native crashes in this path',
+    ].join('\n');
+}
+function createSafeModeHooks(allowUnsafeBunWindows) {
+    return {
+        event: async () => { },
+        tool: {
+            lcm_status: tool({
+                description: 'Show archived LCM capture stats',
+                args: {},
+                async execute() {
+                    return buildSafeModeStatus(allowUnsafeBunWindows);
+                },
+            }),
+        },
+        'experimental.chat.messages.transform': async () => { },
+        'experimental.chat.system.transform': async () => { },
+        'experimental.session.compacting': async () => { },
+    };
+}
 export const OpencodeLcmPlugin = async (ctx, rawOptions) => {
     const options = resolveOptions(rawOptions);
+    const allowUnsafeBunWindows = resolveAllowUnsafeBunWindows(options);
+    if (isUnsafeBunWindowsRuntime() && !allowUnsafeBunWindows) {
+        return createSafeModeHooks(allowUnsafeBunWindows);
+    }
     const store = new SqliteLcmStore(ctx.directory, options);
     await store.init();
     return {
@@ -49,6 +100,7 @@ export const OpencodeLcmPlugin = async (ctx, rawOptions) => {
                         `fresh_tail_messages=${options.freshTailMessages}`,
                         `min_messages_for_transform=${options.minMessagesForTransform}`,
                         `large_content_threshold=${options.largeContentThreshold}`,
+                        `runtime_safety_allow_unsafe_bun_windows=${allowUnsafeBunWindows}`,
                         `binary_preview_providers=${options.binaryPreviewProviders.join(',')}`,
                         `preview_byte_peek=${options.previewBytePeek}`,
                         `privacy_exclude_tool_prefixes=${options.privacy.excludeToolPrefixes.join(',')}`,

package/dist/options.js

@@ -40,6 +40,9 @@ export const DEFAULT_SUMMARY_V2 = {
     strategy: 'deterministic-v2',
     perMessageBudget: 110,
 };
+const DEFAULT_RUNTIME_SAFETY = {
+    allowUnsafeBunWindows: false,
+};
 export const DEFAULT_OPTIONS = {
     interop: DEFAULT_INTEROP,
     scopeDefaults: DEFAULT_SCOPE_DEFAULTS,
@@ -65,6 +68,7 @@ export const DEFAULT_OPTIONS = {
     ],
     previewBytePeek: 16,
     summaryV2: DEFAULT_SUMMARY_V2,
+    runtimeSafety: DEFAULT_RUNTIME_SAFETY,
 };
 function asRecord(value) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
@@ -199,6 +203,12 @@ function asSummaryV2Options(value, fallback) {
         perMessageBudget: asNumber(record?.perMessageBudget, fallback.perMessageBudget),
     };
 }
+function asRuntimeSafetyOptions(value, fallback) {
+    const record = asRecord(value);
+    return {
+        allowUnsafeBunWindows: asBoolean(record?.allowUnsafeBunWindows, fallback.allowUnsafeBunWindows),
+    };
+}
 export function resolveOptions(raw) {
     const options = asRecord(raw);
     const interop = asRecord(options?.interop);
@@ -229,5 +239,6 @@ export function resolveOptions(raw) {
         binaryPreviewProviders: asStringArray(options?.binaryPreviewProviders, DEFAULT_OPTIONS.binaryPreviewProviders),
         previewBytePeek: asNumber(options?.previewBytePeek, DEFAULT_OPTIONS.previewBytePeek),
         summaryV2: asSummaryV2Options(options?.summaryV2, DEFAULT_SUMMARY_V2),
+        runtimeSafety: asRuntimeSafetyOptions(options?.runtimeSafety, DEFAULT_RUNTIME_SAFETY),
     };
 }

package/dist/types.d.ts

@@ -50,6 +50,9 @@ export type SummaryV2Options = {
     strategy: SummaryStrategyName;
     perMessageBudget: number;
 };
+export type RuntimeSafetyOptions = {
+    allowUnsafeBunWindows: boolean;
+};
 export type OpencodeLcmOptions = {
     interop: InteropOptions;
     scopeDefaults: ScopeDefaults;
@@ -70,6 +73,7 @@ export type OpencodeLcmOptions = {
     binaryPreviewProviders: string[];
     previewBytePeek: number;
     summaryV2: SummaryV2Options;
+    runtimeSafety: RuntimeSafetyOptions;
 };
 export type CapturedEvent = {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-lcm",
-  "version": "0.13.5",
+  "version": "0.13.6",
   "description": "Long-memory plugin for OpenCode with context-mode interop",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -2,11 +2,75 @@ import { type Hooks, type PluginInput, tool } from '@opencode-ai/plugin';
 
 import { resolveOptions } from './options.js';
 import { SqliteLcmStore } from './store.js';
+import type { OpencodeLcmOptions } from './types.js';
 
 type PluginWithOptions = (ctx: PluginInput, rawOptions?: unknown) => Promise<Hooks>;
 
+const ALLOW_UNSAFE_BUN_WINDOWS_ENV = 'OPENCODE_LCM_ALLOW_UNSAFE_BUN_WINDOWS';
+
+function isTruthyEnvFlag(value: string | undefined): boolean {
+  if (!value) return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+}
+
+function isBunRuntime(): boolean {
+  return typeof globalThis === 'object' && globalThis !== null && 'Bun' in globalThis;
+}
+
+function isUnsafeBunWindowsRuntime(): boolean {
+  return isBunRuntime() && process.platform === 'win32';
+}
+
+function resolveAllowUnsafeBunWindows(options: OpencodeLcmOptions): boolean {
+  return (
+    options.runtimeSafety.allowUnsafeBunWindows ||
+    isTruthyEnvFlag(process.env[ALLOW_UNSAFE_BUN_WINDOWS_ENV])
+  );
+}
+
+function buildSafeModeStatus(allowUnsafeBunWindows: boolean): string {
+  return [
+    'status=disabled',
+    'reason=bun_windows_runtime_guard',
+    'available_tools=lcm_status',
+    `platform=${process.platform}`,
+    `bun_runtime=${isBunRuntime()}`,
+    `runtime_safety_allow_unsafe_bun_windows=${allowUnsafeBunWindows}`,
+    'override_config=runtimeSafety.allowUnsafeBunWindows=true',
+    `override_env=${ALLOW_UNSAFE_BUN_WINDOWS_ENV}=1`,
+    'message=opencode-lcm disabled itself before opening SQLite because Bun on Windows has reported native crashes in this path',
+  ].join('\n');
+}
+
+function createSafeModeHooks(allowUnsafeBunWindows: boolean): Hooks {
+  return {
+    event: async () => {},
+
+    tool: {
+      lcm_status: tool({
+        description: 'Show archived LCM capture stats',
+        args: {},
+        async execute() {
+          return buildSafeModeStatus(allowUnsafeBunWindows);
+        },
+      }),
+    },
+
+    'experimental.chat.messages.transform': async () => {},
+    'experimental.chat.system.transform': async () => {},
+    'experimental.session.compacting': async () => {},
+  };
+}
+
 export const OpencodeLcmPlugin: PluginWithOptions = async (ctx, rawOptions) => {
   const options = resolveOptions(rawOptions);
+  const allowUnsafeBunWindows = resolveAllowUnsafeBunWindows(options);
+
+  if (isUnsafeBunWindowsRuntime() && !allowUnsafeBunWindows) {
+    return createSafeModeHooks(allowUnsafeBunWindows);
+  }
+
   const store = new SqliteLcmStore(ctx.directory, options);
 
   await store.init();
@@ -56,6 +120,7 @@ export const OpencodeLcmPlugin: PluginWithOptions = async (ctx, rawOptions) => {
             `fresh_tail_messages=${options.freshTailMessages}`,
             `min_messages_for_transform=${options.minMessagesForTransform}`,
             `large_content_threshold=${options.largeContentThreshold}`,
+            `runtime_safety_allow_unsafe_bun_windows=${allowUnsafeBunWindows}`,
             `binary_preview_providers=${options.binaryPreviewProviders.join(',')}`,
             `preview_byte_peek=${options.previewBytePeek}`,
             `privacy_exclude_tool_prefixes=${options.privacy.excludeToolPrefixes.join(',')}`,

package/src/options.ts

@@ -6,6 +6,7 @@ import type {
   OpencodeLcmOptions,
   PrivacyOptions,
   RetentionPolicyOptions,
+  RuntimeSafetyOptions,
   ScopeDefaults,
   ScopeName,
   ScopeProfile,
@@ -61,6 +62,10 @@ export const DEFAULT_SUMMARY_V2: SummaryV2Options = {
   perMessageBudget: 110,
 };
 
+const DEFAULT_RUNTIME_SAFETY: RuntimeSafetyOptions = {
+  allowUnsafeBunWindows: false,
+};
+
 export const DEFAULT_OPTIONS: OpencodeLcmOptions = {
   interop: DEFAULT_INTEROP,
   scopeDefaults: DEFAULT_SCOPE_DEFAULTS,
@@ -86,6 +91,7 @@ export const DEFAULT_OPTIONS: OpencodeLcmOptions = {
   ],
   previewBytePeek: 16,
   summaryV2: DEFAULT_SUMMARY_V2,
+  runtimeSafety: DEFAULT_RUNTIME_SAFETY,
 };
 
 function asRecord(value: unknown): Record<string, unknown> | undefined {
@@ -258,6 +264,16 @@ function asSummaryV2Options(value: unknown, fallback: SummaryV2Options): Summary
   };
 }
 
+function asRuntimeSafetyOptions(
+  value: unknown,
+  fallback: RuntimeSafetyOptions,
+): RuntimeSafetyOptions {
+  const record = asRecord(value);
+  return {
+    allowUnsafeBunWindows: asBoolean(record?.allowUnsafeBunWindows, fallback.allowUnsafeBunWindows),
+  };
+}
+
 export function resolveOptions(raw: unknown): OpencodeLcmOptions {
   const options = asRecord(raw);
   const interop = asRecord(options?.interop);
@@ -314,5 +330,6 @@ export function resolveOptions(raw: unknown): OpencodeLcmOptions {
     ),
     previewBytePeek: asNumber(options?.previewBytePeek, DEFAULT_OPTIONS.previewBytePeek),
     summaryV2: asSummaryV2Options(options?.summaryV2, DEFAULT_SUMMARY_V2),
+    runtimeSafety: asRuntimeSafetyOptions(options?.runtimeSafety, DEFAULT_RUNTIME_SAFETY),
   };
 }

package/src/types.ts

@@ -62,6 +62,10 @@ export type SummaryV2Options = {
   perMessageBudget: number;
 };
 
+export type RuntimeSafetyOptions = {
+  allowUnsafeBunWindows: boolean;
+};
+
 export type OpencodeLcmOptions = {
   interop: InteropOptions;
   scopeDefaults: ScopeDefaults;
@@ -82,6 +86,7 @@ export type OpencodeLcmOptions = {
   binaryPreviewProviders: string[];
   previewBytePeek: number;
   summaryV2: SummaryV2Options;
+  runtimeSafety: RuntimeSafetyOptions;
 };
 
 export type CapturedEvent = {