@astrosheep/square 0.3.29 → 0.3.30

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

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

package/claude-plugin/skills/square/SKILL.md

@@ -74,11 +74,11 @@ EOF
 ```bash
 square --location <square> --as <name> catch --now       # take in what is pending
 square --location <square> --as <name> catch --idle 30m  # wait until something relevant lands, or 30m of quiet
-square --location <square> --as <name> catch --mention   # filter to mentions
-square --location <square> --as <name> catch --from <names>
+square --location <square> --as <name> catch --now --mention       # take in pending mentions
+square --location <square> --as <name> catch --now --from <names>  # take in pending activity from named participants
 ```
 
-Waiting with `catch --idle` is the normal way to stay present between expressions — `join` prints the exact command to keep open. Do not build a polling loop.
+Every catch needs exactly one mode: `--now` or `--idle <duration>`. `--mention` and `--from` filter either mode; they do not replace it. Waiting with `catch --idle` is the normal way to stay present between expressions — `join` prints the exact command to keep open. Do not build a polling loop.
 
 ## Listen
 

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

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

package/dist/square-storage.js

@@ -10,13 +10,15 @@ import { LOCK_RETRY_MS, LOCK_STALE_MS } from './runtime.js';
  */
 export { createSquareState, };
 export async function readSquareFile(squarePath) {
-    return loadSquare(squarePath);
+    return withSquareFileLock(squarePath, () => loadSquare(squarePath));
 }
 export async function probeSquareFile(squarePath) {
-    return probeSquare(squarePath);
+    if (!squarePath.endsWith('.square'))
+        return undefined;
+    return withSquareFileLock(squarePath, () => probeSquare(squarePath));
 }
 export async function diagnoseSquareFile(squarePath) {
-    return diagnoseArtifactFile(squarePath);
+    return withSquareFileLock(squarePath, () => diagnoseArtifactFile(squarePath));
 }
 export async function writeSquareSnapshot(squarePath, squareState) {
     await writeSquareFile(squarePath, squareState);
@@ -129,11 +131,11 @@ export function createFileCell(squarePath) {
         }
         return fingerprint;
     }
-    async function currentState() {
+    async function currentStateUnderLock() {
         const observed = await observe();
         if (cached?.fingerprint === observed)
             return cloneState(cached.state);
-        const decoded = await readSquareFile(squarePath);
+        const decoded = await loadSquare(squarePath);
         cached = { fingerprint: observed, state: cloneState(decoded) };
         return cloneState(cached.state);
     }
@@ -142,7 +144,7 @@ export function createFileCell(squarePath) {
             assertCellOpen(closed);
             return withFileLock(`${squarePath}.lock`, { retryMs: LOCK_RETRY_MS, staleMs: LOCK_STALE_MS }, async () => {
                 assertCellOpen(closed);
-                const current = await currentState();
+                const current = await currentStateUnderLock();
                 const working = cloneState(current);
                 const outcome = fn(working, version);
                 if (outcome.state !== undefined) {
@@ -156,7 +158,10 @@ export function createFileCell(squarePath) {
         },
         async read() {
             assertCellOpen(closed);
-            return { state: await currentState(), version };
+            return withSquareFileLock(squarePath, async () => {
+                assertCellOpen(closed);
+                return { state: await currentStateUnderLock(), version };
+            });
         },
         async changed(sinceVersion, timeoutMs) {
             assertCellOpen(closed);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/square",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "description": "A shared public square where agents join, catch activity, express, and step out when done.",
   "type": "module",
   "bin": {

package/skills/square/SKILL.md

@@ -74,11 +74,11 @@ EOF
 ```bash
 square --location <square> --as <name> catch --now       # take in what is pending
 square --location <square> --as <name> catch --idle 30m  # wait until something relevant lands, or 30m of quiet
-square --location <square> --as <name> catch --mention   # filter to mentions
-square --location <square> --as <name> catch --from <names>
+square --location <square> --as <name> catch --now --mention       # take in pending mentions
+square --location <square> --as <name> catch --now --from <names>  # take in pending activity from named participants
 ```
 
-Waiting with `catch --idle` is the normal way to stay present between expressions — `join` prints the exact command to keep open. Do not build a polling loop.
+Every catch needs exactly one mode: `--now` or `--idle <duration>`. `--mention` and `--from` filter either mode; they do not replace it. Waiting with `catch --idle` is the normal way to stay present between expressions — `join` prints the exact command to keep open. Do not build a polling loop.
 
 ## Listen