@volter/supercode-orchestrator 0.4.127 → 0.4.128

package/board/ztrack.mjs

@@ -19,6 +19,14 @@ const CARD_MAIN = new Set(['id', 'title', 'body', 'status', 'assignee', 'priorit
 const EPHEMERAL = new Set(['tasks', 'supercode_cards', 'task_links', 'sqlite_sequence']);
 const atomic = (path, text) => { const tmp = `${path}.${process.pid}.tmp`; writeFileSync(tmp, text, { mode: 0o600 }); renameSync(tmp, path); };
 
+// Only SQLite's actual contention codes retry. Rule refusals can contain words
+// such as "blocked" or "busy" and must reach the caller unchanged.
+const sqliteContention = error => [5, 6].includes(Number(error?.errcode) & 255)
+  || ['SQLITE_BUSY', 'SQLITE_LOCKED'].includes(error?.code)
+  || /^database (?:table |schema )?is locked$/i.test(error?.message ?? '');
+const exportConflict = error => error?.message === 'Hermes wrote during board export; retained its events for the next read';
+const recoveryConflict = error => error?.message === 'document changed during recovery; retry';
+
 export function openZtrackBoard(marker, { create = false, document = null, seed = null, init, root, slug, compatPath }) {
   if (!existsSync(marker)) {
     if (!create) throw new Error(`no ztrack board ${marker}`);
@@ -60,7 +68,7 @@ class ZtrackBoard {
     const fileStamp = (path) => { try { const s = statSync(path); return `${s.ino}:${s.size}:${s.mtimeMs}`; } catch { return 'missing'; } };
     return [fileStamp(this.path), fileStamp(this.archive), fileStamp(this.compatPath), this.get('version', '')].join('|');
   }
-  readOnly(fn) { for (;;) { try { return fn(); } catch(error) { if(!/busy|locked/i.test(error.message))throw error; } } }
+  readOnly(fn) { for (;;) { try { return fn(); } catch(error) { if(!sqliteContention(error))throw error; } } }
   access(fn, reading = false) {
     if (reading && !this.reading) { this.reading=true; try {return this.readOnly(()=>this.access(fn,true));}finally{this.reading=false;} }
     if (this.active || (reading && this.mem && this.loadedStamp === this.stamp())) return fn();
@@ -112,7 +120,7 @@ class ZtrackBoard {
     this.readOnly(()=>{ if(this.runtime.prepare('PRAGMA journal_mode').get().journal_mode!=='wal')this.runtime.exec('PRAGMA journal_mode=WAL'); });
     for (;;) {
       try { this.runtime.exec('BEGIN'); }
-      catch (error) { if (!/busy|locked/i.test(error.message)) throw error; continue; }
+      catch (error) { if (!sqliteContention(error)) throw error; continue; }
       this.active = true;
       let committed = false;
       try {
@@ -173,14 +181,14 @@ class ZtrackBoard {
         this.put('export_pending', [...this.get('export_pending', []), ...changes]);
         this.put('version', randomBytes(8).toString('hex'));
         this.runtime.exec('COMMIT');
-        try { this.flushExport(); } catch (error) { if (!/busy|locked|Hermes wrote/i.test(error.message)) throw error; }
+        try { this.flushExport(); } catch (error) { if (!sqliteContention(error) && !exportConflict(error)) throw error; }
         this.loadedStamp = this.stamp();
         this.seed = null;
         return result;
       } catch (error) {
         try { this.runtime.exec('ROLLBACK'); } catch { /* intent already durable */ }
         this.invalidate();
-        if (/busy|locked|Hermes wrote|document changed during recovery/i.test(error.message)) continue;
+        if (sqliteContention(error) || exportConflict(error) || recoveryConflict(error)) continue;
         if (committed) error.message += ' (the operation reached its durable intent; inspect its recorded outcome before retrying)';
         throw error;
       } finally { this.active = false; this.computing = false; this.pendingValues = null; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter/supercode-orchestrator",
-  "version": "0.4.127",
+  "version": "0.4.128",
   "type": "module",
   "description": "The orchestrator runtime over the Volter Harness ontology: one typed operational model whose folder is its serialization, read and written through the harness orchestration doors (docs/ORCHESTRATOR-IR.md)",
   "exports": {