@astrosheep/square 0.3.38 → 0.3.39

package/claude-plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "description": "Native Claude Code turn-boundary delivery for Square participants",
   "author": {
     "name": "Square"

package/codex-plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "description": "Shared Square activity with reliable participant attention at Codex boundaries.",
   "author": {
     "name": "Square"

package/dist/attention-presentation.js

@@ -6,7 +6,7 @@ export const ATTENTION_BODY_MAX = 100;
 export function previewAttentionBody(body) {
     const compact = body.replace(/\r\n/g, '\n');
     if (compact.length <= ATTENTION_BODY_MAX)
-        return compact;
+        return `${compact}\n… preview`;
     return `${compact.slice(0, ATTENTION_BODY_MAX).trimEnd()}\n… preview only`;
 }
 export function displayAttentionPath(squarePath) {

package/dist/boundary-presentation.js

@@ -33,7 +33,7 @@ export function renderPendingAtBoundary(inbox) {
 function renderBoundary(inbox) {
     const count = pendingCount(inbox);
     const noun = count === 1 ? 'notification' : 'notifications';
-    const header = `<system-reminder source="square">You have ${count} unread Square ${noun}.`;
+    const header = `<system-reminder source="square">You have ${count} Square ${noun}.`;
     const footer = ['Read and respond in the square when appropriate.</system-reminder>'];
     const queued = inbox.flatMap((membership) => membership.notifications.map((notification) => ({ membership, notification })));
     const blocks = [];
@@ -58,7 +58,7 @@ function renderBoundary(inbox) {
             ...blocks,
             block,
             ...(omittedAfter > 0
-                ? [`… ${omittedAfter} unread ${omittedAfter === 1 ? 'notification' : 'notifications'} omitted.`]
+                ? [`… ${omittedAfter} ${omittedAfter === 1 ? 'notification' : 'notifications'} omitted.`]
                 : []),
             duplicateHint,
             ...footer,
@@ -79,7 +79,7 @@ function renderBoundary(inbox) {
             header,
             ...blocks,
             ...(omitted > 0
-                ? [`… ${omitted} unread ${omitted === 1 ? 'notification' : 'notifications'} omitted.`]
+                ? [`… ${omitted} ${omitted === 1 ? 'notification' : 'notifications'} omitted.`]
                 : []),
             duplicateHint,
             ...footer,

package/dist/file-lock.js

@@ -1,7 +1,11 @@
+import { DatabaseSync } from 'node:sqlite';
 import { randomUUID } from 'node:crypto';
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { setTimeout as sleep } from 'node:timers/promises';
+function isBusy(error) {
+    return error instanceof Error && /database is locked|SQLITE_BUSY/i.test(error.message);
+}
 async function ownerState(lockPath) {
     let pid;
     try {
@@ -20,7 +24,7 @@ async function ownerState(lockPath) {
         return error.code === 'ESRCH' ? 'dead' : 'alive';
     }
 }
-async function createLock(lockPath) {
+async function createLegacyLock(lockPath) {
     let fd;
     try {
         fd = await fs.open(lockPath, 'wx', 0o600);
@@ -43,35 +47,38 @@ async function createLock(lockPath) {
         await fd.close();
     }
 }
-async function reclaimLock(lockPath, staleMs) {
+async function reclaimLegacyLock(lockPath, staleMs) {
+    const quarantinePath = `${lockPath}.reclaim-${randomUUID()}`;
     try {
         const stale = Date.now() - (await fs.stat(lockPath)).mtimeMs > staleMs;
-        if (await ownerState(lockPath) !== 'dead' && !stale)
+        const owner = await ownerState(lockPath);
+        if (owner === 'alive' || (owner !== 'dead' && !stale))
             return false;
-        await fs.unlink(lockPath);
+        await fs.rename(lockPath, quarantinePath);
+        await fs.unlink(quarantinePath).catch(() => undefined);
         return true;
     }
     catch (error) {
+        await fs.unlink(quarantinePath).catch(() => undefined);
         return error.code === 'ENOENT';
     }
 }
-async function releaseLock(lockPath, token) {
+async function releaseLegacyLock(lockPath, token) {
     try {
         if (await fs.readFile(lockPath, 'utf8') === token)
             await fs.unlink(lockPath);
     }
     catch { }
 }
-export async function withFileLock(lockPath, options, fn) {
-    await fs.mkdir(path.dirname(lockPath), { recursive: true });
+async function withLegacyFileLock(lockPath, options, fn) {
     let token;
     while (token === undefined) {
         if (options.signal?.aborted)
             throw options.signal.reason ?? new Error('File lock acquisition aborted');
-        token = await createLock(lockPath);
+        token = await createLegacyLock(lockPath);
         if (token !== undefined)
             break;
-        if (await reclaimLock(lockPath, options.staleMs))
+        if (await reclaimLegacyLock(lockPath, options.staleMs))
             continue;
         await sleep(options.retryMs, undefined, { signal: options.signal });
     }
@@ -79,6 +86,52 @@ export async function withFileLock(lockPath, options, fn) {
         return await fn();
     }
     finally {
-        await releaseLock(lockPath, token);
+        await releaseLegacyLock(lockPath, token);
+    }
+}
+async function withSqliteLock(lockPath, options, fn) {
+    while (true) {
+        if (options.signal?.aborted)
+            throw options.signal.reason ?? new Error('File lock acquisition aborted');
+        let database;
+        try {
+            database = new DatabaseSync(lockPath);
+            database.exec(`PRAGMA busy_timeout = 0;
+        BEGIN EXCLUSIVE;
+        CREATE TABLE IF NOT EXISTS __square_file_lock (id INTEGER PRIMARY KEY CHECK (id = 1));`);
+        }
+        catch (error) {
+            try {
+                database?.close();
+            }
+            catch { }
+            if (isBusy(error)) {
+                await sleep(options.retryMs, undefined, { signal: options.signal });
+                continue;
+            }
+            if (error instanceof Error && /not a database|file is not a database/i.test(error.message)) {
+                return withLegacyFileLock(lockPath, options, fn);
+            }
+            throw error;
+        }
+        try {
+            const result = await fn();
+            database.exec('COMMIT;');
+            return result;
+        }
+        catch (error) {
+            try {
+                database.exec('ROLLBACK;');
+            }
+            catch { }
+            throw error;
+        }
+        finally {
+            database.close();
+        }
     }
 }
+export async function withFileLock(lockPath, options, fn) {
+    await fs.mkdir(path.dirname(lockPath), { recursive: true });
+    return withSqliteLock(lockPath, options, fn);
+}

package/dist/host-ledger-file-adapter.js

@@ -112,15 +112,7 @@ export class FileHostLedgerPort {
         return false;
     } }); if (current === undefined)
         return false; const next = { v: 1, ts: at, attention_key: key, leaseId: i.leaseId, expiresAt: at + i.leaseMs, phase: i.phase, ownerPid: current.ownerPid, ...(i.routeKind === undefined ? {} : { routeKind: i.routeKind }), ...(i.attemptN === undefined ? {} : { attemptN: i.attemptN }), ...(i.session === undefined ? {} : { session: i.session }) }; await writeClaims(this.claims, [...rows.filter((row) => row !== current), next]); return true; }); }
-    async releaseWakeDispatch(i) { const location = await canon(i.attention.squarePath), key = JSON.stringify([location, nameKey(i.attention.recipient), i.attention.actIndex, i.session ?? null, 'wake']), at = i.at ?? this.clock(); await withFileLock(`${this.claims}.lock`, LOCK, async () => { const rows = await readClaims(this.claims, at); await writeClaims(this.claims, rows.filter((row) => { if (row.attention_key === key)
-        return false; if (row.leaseId !== i.leaseId)
-        return true; try {
-        const parts = JSON.parse(row.attention_key);
-        return parts[0] !== location || parts[1] !== nameKey(i.attention.recipient) || parts[2] !== i.attention.actIndex || (i.session !== undefined && parts[3] !== i.session);
-    }
-    catch {
-        return true;
-    } })); }); }
+    async releaseWakeDispatch(i) { const location = await canon(i.attention.squarePath), key = JSON.stringify([location, nameKey(i.attention.recipient), i.attention.actIndex, i.session ?? null, 'wake']), at = i.at ?? this.clock(); await withFileLock(`${this.claims}.lock`, LOCK, async () => { const rows = await readClaims(this.claims, at); await writeClaims(this.claims, rows.filter((row) => row.attention_key !== key || row.leaseId !== i.leaseId)); }); }
     async listWakeAttempts(i = {}) { const attention = i.attention; return this.listEvidence({ kind: 'wake', ...(attention === undefined ? {} : { location: await canon(attention.squarePath), participant: attention.recipient, activity: `act/${attention.actIndex}` }), ...(i.session === undefined ? {} : { session: i.session }), now: i.now }); }
     async appendWakeAttempt(i) { if (i.kind !== 'wake')
         throw new Error('Wake attempt rows require wake evidence kind'); return this.appendEvidence(i); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/square",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "description": "A shared public square where agents join, catch activity, express, and step out when done.",
   "type": "module",
   "bin": {
@@ -36,6 +36,9 @@
   ],
   "author": "astrosheep",
   "license": "MIT",
+  "engines": {
+    "node": ">=22.5.0"
+  },
   "devDependencies": {
     "@getpaseo/client": "^0.3.1",
     "@types/cross-spawn": "^6.0.6",