opencode-rag-plugin 1.19.1 → 1.19.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -7,7 +7,7 @@
7
7
  import path from "node:path";
8
8
  import os from "node:os";
9
9
  import fs from "node:fs";
10
- import { c, resolveCliContext, cleanupContext, logCliError, logCliInfo, formatTimestamp } from "../format.js";
10
+ import { c, resolveCliContext, logCliError, logCliInfo, formatTimestamp } from "../format.js";
11
11
  import { getIndexStatusSummary } from "../../indexer.js";
12
12
  import { getPackageMetadata } from "../helpers.js";
13
13
  import { checkForUpdate } from "../../core/version-check.js";
@@ -156,7 +156,9 @@ export function registerStatusCommand(program) {
156
156
  }
157
157
  }).catch(() => { });
158
158
  }
159
- await cleanupContext(ctx);
159
+ // Force exit — avoid LanceDB close() hanging on Windows native bindings.
160
+ // Status is read-only so there's no state to lose.
161
+ process.exit(0);
160
162
  }
161
163
  catch (err) {
162
164
  const message = err.message || String(err);
@@ -1,3 +1,4 @@
1
+ #!/usr/bin/env node
1
2
  /**
2
3
  * @fileoverview CLI entry point creating the Commander program, wiring all command modules, and handling auto-run detection.
3
4
  */
package/dist/cli/index.js CHANGED
@@ -1,3 +1,4 @@
1
+ #!/usr/bin/env node
1
2
  /**
2
3
  * @fileoverview CLI entry point creating the Commander program, wiring all command modules, and handling auto-run detection.
3
4
  */
@@ -266,14 +266,14 @@ export const DEFAULT_CONFIG = {
266
266
  },
267
267
  memory: {
268
268
  enabled: true,
269
- autoInject: false,
269
+ autoInject: true,
270
270
  minConfidence: 0.5,
271
- recallMinScore: 0.72,
272
- autoInjectMinScore: 0.6,
271
+ recallMinScore: 0.6,
272
+ autoInjectMinScore: 0.5,
273
273
  autoInjectLatencyBudgetMs: 2000,
274
274
  autoInjectTopK: 2,
275
275
  autoInjectMinTokenOverlap: 1,
276
- passiveCapture: false,
276
+ passiveCapture: true,
277
277
  promptEnforcement: true,
278
278
  sessionEndExtraction: true,
279
279
  autoCaptureMaxPerTurn: 2,
@@ -10,6 +10,19 @@ export declare function l2Normalize(vec: number[]): number[];
10
10
  * @returns True if the error matches a known corruption pattern.
11
11
  */
12
12
  export declare function isCorruptionError(err: unknown): boolean;
13
+ /**
14
+ * Check whether an error is a LanceDB transient transaction conflict
15
+ * (e.g. "Incompatible transaction: This Append transaction is incompatible
16
+ * with concurrent transaction Restore at version ...").
17
+ *
18
+ * These are recoverable by retrying after the conflicting transaction finishes.
19
+ * Cross-process writes are the primary source; in-process writes are serialized
20
+ * by the write lock.
21
+ *
22
+ * @param err - The error to inspect.
23
+ * @returns True if the error matches a transient transaction conflict.
24
+ */
25
+ export declare function isTransientConflictError(err: unknown): boolean;
13
26
  /**
14
27
  * Atomically replace one LanceDB store directory with another.
15
28
  * Swaps the real directory with a temporary one that was built during a rebuild.
@@ -31,6 +44,23 @@ export declare class LanceDbStore implements VectorStore {
31
44
  private table;
32
45
  private tableInit;
33
46
  private writeLock;
47
+ /**
48
+ * Execute an async function under an exclusive write lock.
49
+ *
50
+ * All write operations (addChunks, deleteByFilePath, optimize, tryRepair) must
51
+ * go through this helper to prevent concurrent LanceDB transactions from
52
+ * conflicting (e.g. Append vs Restore, which produces the "Incompatible
53
+ * transaction" error).
54
+ *
55
+ * The lock is a Promise chain: each caller chains onto `this.writeLock` and
56
+ * sets it to a new promise that resolves only when its operation finishes
57
+ * (or throws). This guarantees FIFO serialization without any busy-waiting
58
+ * or timers.
59
+ *
60
+ * @param fn - The async function to execute under the lock.
61
+ * @returns The result of `fn`.
62
+ */
63
+ private withWriteLock;
34
64
  /**
35
65
  * @param dbPath - Filesystem path to the LanceDB database directory.
36
66
  * @param vectorDimension - Dimension of the embedding vectors. Default: 384.
@@ -191,4 +221,10 @@ export declare class LanceDbStore implements VectorStore {
191
221
  */
192
222
  private withCorruptionRecovery;
193
223
  private tryRepair;
224
+ /**
225
+ * Drop the existing chunks table and let getTable() create a fresh one.
226
+ * All indexed data is lost — callers should detect the empty table and
227
+ * trigger a re-index if needed.
228
+ */
229
+ private tryRebuildTable;
194
230
  }
@@ -27,9 +27,32 @@ export function l2Normalize(vec) {
27
27
  */
28
28
  export function isCorruptionError(err) {
29
29
  if (err instanceof Error) {
30
- return (err.message.includes("Not found") &&
30
+ return ((err.message.includes("Not found") &&
31
31
  err.message.includes(".lance") &&
32
- err.message.includes("lance error"));
32
+ err.message.includes("lance error")) ||
33
+ // Database has an incompatible transaction (e.g. a Restore from a prior
34
+ // version that conflicts with new Appends). This is a recoverable
35
+ // corruption — tryRepair() iterates prior versions to find a consistent one.
36
+ (err.message.includes("Incompatible transaction") &&
37
+ err.message.includes("version")));
38
+ }
39
+ return false;
40
+ }
41
+ /**
42
+ * Check whether an error is a LanceDB transient transaction conflict
43
+ * (e.g. "Incompatible transaction: This Append transaction is incompatible
44
+ * with concurrent transaction Restore at version ...").
45
+ *
46
+ * These are recoverable by retrying after the conflicting transaction finishes.
47
+ * Cross-process writes are the primary source; in-process writes are serialized
48
+ * by the write lock.
49
+ *
50
+ * @param err - The error to inspect.
51
+ * @returns True if the error matches a transient transaction conflict.
52
+ */
53
+ export function isTransientConflictError(err) {
54
+ if (err instanceof Error) {
55
+ return err.message.includes("Incompatible transaction");
33
56
  }
34
57
  return false;
35
58
  }
@@ -76,6 +99,43 @@ export class LanceDbStore {
76
99
  table = null;
77
100
  tableInit = null;
78
101
  writeLock = Promise.resolve(void 0);
102
+ /**
103
+ * Execute an async function under an exclusive write lock.
104
+ *
105
+ * All write operations (addChunks, deleteByFilePath, optimize, tryRepair) must
106
+ * go through this helper to prevent concurrent LanceDB transactions from
107
+ * conflicting (e.g. Append vs Restore, which produces the "Incompatible
108
+ * transaction" error).
109
+ *
110
+ * The lock is a Promise chain: each caller chains onto `this.writeLock` and
111
+ * sets it to a new promise that resolves only when its operation finishes
112
+ * (or throws). This guarantees FIFO serialization without any busy-waiting
113
+ * or timers.
114
+ *
115
+ * @param fn - The async function to execute under the lock.
116
+ * @returns The result of `fn`.
117
+ */
118
+ async withWriteLock(fn) {
119
+ const prev = this.writeLock;
120
+ let release = () => { };
121
+ this.writeLock = new Promise((resolve) => { release = resolve; });
122
+ await prev;
123
+ try {
124
+ return await fn();
125
+ }
126
+ catch (err) {
127
+ // Cross-process transient conflict (e.g. CLI vs plugin):
128
+ // wait briefly and retry once, still under the same lock hold.
129
+ if (isTransientConflictError(err)) {
130
+ await new Promise((resolve) => setTimeout(resolve, 100));
131
+ return await fn();
132
+ }
133
+ throw err;
134
+ }
135
+ finally {
136
+ release();
137
+ }
138
+ }
79
139
  /**
80
140
  * @param dbPath - Filesystem path to the LanceDB database directory.
81
141
  * @param vectorDimension - Dimension of the embedding vectors. Default: 384.
@@ -242,21 +302,18 @@ export class LanceDbStore {
242
302
  async addChunks(chunks) {
243
303
  if (chunks.length === 0)
244
304
  return;
245
- const done = this.writeLock.then(() => this.addChunksInternal(chunks));
246
- this.writeLock = done.catch(() => { });
247
- try {
248
- await done;
249
- }
250
- catch (err) {
251
- this.writeLock = Promise.resolve();
252
- if (isCorruptionError(err) && await this.tryRepair()) {
253
- const retry = this.addChunksInternal(chunks);
254
- this.writeLock = retry.catch(() => { });
255
- await retry;
256
- return;
305
+ await this.withWriteLock(async () => {
306
+ try {
307
+ await this.addChunksInternal(chunks);
257
308
  }
258
- throw err;
259
- }
309
+ catch (err) {
310
+ if (isCorruptionError(err) && await this.tryRepair()) {
311
+ await this.addChunksInternal(chunks);
312
+ return;
313
+ }
314
+ throw err;
315
+ }
316
+ });
260
317
  }
261
318
  async addChunksInternal(chunks) {
262
319
  const table = await this.getTable();
@@ -343,7 +400,7 @@ export class LanceDbStore {
343
400
  }
344
401
  catch (err) {
345
402
  if (isCorruptionError(err)) {
346
- const repaired = await this.tryRepair();
403
+ const repaired = await this.withWriteLock(() => this.tryRepair());
347
404
  if (repaired) {
348
405
  return this.searchInternal(embedding, topK, filter);
349
406
  }
@@ -577,19 +634,21 @@ export class LanceDbStore {
577
634
  * Should be called at the end of a successful index pass.
578
635
  */
579
636
  async optimize() {
580
- try {
581
- const table = await this.getTable();
582
- // Clean up versions older than 1 hour — not "right now" — so in-flight
583
- // queries (e.g. Web UI search, background auto-index) can finish before
584
- // their data files are reclaimed. Using new Date() here caused data-file
585
- // race conditions where a reader got "Not found: .lance" because the
586
- // GC deleted fragments that the current version still referenced.
587
- const threshold = new Date(Date.now() - 60 * 60 * 1000);
588
- await table.optimize({ cleanupOlderThan: threshold, deleteUnverified: false });
589
- }
590
- catch {
591
- // Optimize is best-effort — must not break indexing.
592
- }
637
+ await this.withWriteLock(async () => {
638
+ try {
639
+ const table = await this.getTable();
640
+ // Clean up versions older than 1 hour �?" not "right now" �?" so in-flight
641
+ // queries (e.g. Web UI search, background auto-index) can finish before
642
+ // their data files are reclaimed. Using new Date() here caused data-file
643
+ // race conditions where a reader got "Not found: �?� .lance" because the
644
+ // GC deleted fragments that the current version still referenced.
645
+ const threshold = new Date(Date.now() - 60 * 60 * 1000);
646
+ await table.optimize({ cleanupOlderThan: threshold, deleteUnverified: false });
647
+ }
648
+ catch {
649
+ // Optimize is best-effort �?" must not break indexing.
650
+ }
651
+ });
593
652
  }
594
653
  /**
595
654
  * Return all unique file paths currently stored in the index.
@@ -727,16 +786,18 @@ export class LanceDbStore {
727
786
  * @param filePath - The file path whose chunks should be deleted.
728
787
  */
729
788
  async deleteByFilePath(filePath) {
730
- try {
731
- await this.deleteByFilePathInternal(filePath);
732
- }
733
- catch (err) {
734
- if (isCorruptionError(err) && await this.tryRepair()) {
789
+ await this.withWriteLock(async () => {
790
+ try {
735
791
  await this.deleteByFilePathInternal(filePath);
736
- return;
737
792
  }
738
- throw err;
739
- }
793
+ catch (err) {
794
+ if (isCorruptionError(err) && await this.tryRepair()) {
795
+ await this.deleteByFilePathInternal(filePath);
796
+ return;
797
+ }
798
+ throw err;
799
+ }
800
+ });
740
801
  }
741
802
  async deleteByFilePathInternal(filePath) {
742
803
  const db = await this.getDb();
@@ -791,8 +852,13 @@ export class LanceDbStore {
791
852
  return await fn();
792
853
  }
793
854
  catch (err) {
794
- if (isCorruptionError(err) && await this.tryRepair()) {
795
- return fn();
855
+ if (isCorruptionError(err)) {
856
+ // Repair must be under writeLock to prevent Restore from conflicting
857
+ // with concurrent Append transactions (addChunks / deleteByFilePath).
858
+ const repaired = await this.withWriteLock(() => this.tryRepair());
859
+ if (repaired) {
860
+ return fn();
861
+ }
796
862
  }
797
863
  throw err;
798
864
  }
@@ -823,7 +889,7 @@ export class LanceDbStore {
823
889
  return false;
824
890
  }
825
891
  if (versions.length <= 1) {
826
- return false;
892
+ return this.tryRebuildTable(db);
827
893
  }
828
894
  const sorted = [...versions].sort((a, b) => b.version - a.version);
829
895
  for (const ver of sorted.slice(1)) {
@@ -839,10 +905,29 @@ export class LanceDbStore {
839
905
  continue;
840
906
  }
841
907
  }
842
- console.error("[lancedb] All version-restore attempts failed. " +
843
- "Run 'opencode-rag index --force' to rebuild the index.");
908
+ // All version-restore attempts failed (likely corrupted version graph
909
+ // with incompatible Restore transactions). Drop and recreate the table.
910
+ console.warn("[lancedb] Version restore failed. Dropping and recreating table to recover from corrupt version graph.");
911
+ return this.tryRebuildTable(db);
912
+ }
913
+ catch {
844
914
  return false;
845
915
  }
916
+ }
917
+ /**
918
+ * Drop the existing chunks table and let getTable() create a fresh one.
919
+ * All indexed data is lost — callers should detect the empty table and
920
+ * trigger a re-index if needed.
921
+ */
922
+ async tryRebuildTable(db) {
923
+ try {
924
+ await db.dropTable(TABLE_NAME).catch(() => { });
925
+ this.table = null;
926
+ // Re-create fresh via getTable → initTable
927
+ await this.getTable();
928
+ console.warn("[lancedb] Table recreated from scratch after corruption recovery.");
929
+ return true;
930
+ }
846
931
  catch {
847
932
  return false;
848
933
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opencode-rag-plugin",
3
- "version": "1.19.1",
3
+ "version": "1.19.2",
4
4
  "description": "OpenCode plugin for local-first RAG-based semantic code search",
5
5
  "type": "module",
6
6
  "main": "./dist/plugin-entry.js",