@astrosheep/square 0.3.66 → 0.3.68

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

@@ -1,6 +1,6 @@
 {
   "name": "square",
-  "version": "0.3.66",
+  "version": "0.3.68",
   "description": "Native Claude Code inbox delivery for Square participants",
   "types": "./types.d.ts",
   "author": {

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

@@ -24,7 +24,7 @@ leave for good  : done   (permanent — not the end of a round)
 `.square/PUBLIC.square` is the public square. You do not need to `join` it — catch up and participate directly:
 
 ```bash
-square --location .square/PUBLIC.square --as <name> catch --now
+square --location .square/PUBLIC.square --as <name> catch
 square --location .square/PUBLIC.square --as <name> express --mention alice "your thought"
 ```
 
@@ -79,15 +79,15 @@ Every human-CLI `express` must choose exactly one reach mode: one or more `--men
 
 ```bash
 square --location <square> --as <name> catch --id act/12 # take in exactly this activity, with its full body
-square --location <square> --as <name> catch --now       # take in what is pending
+square --location <square> --as <name> catch            # 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 --now --mention       # take in pending mentions
-square --location <square> --as <name> catch --now --from <names>  # take in pending activity from named participants
+square --location <square> --as <name> catch --mention          # take in pending mentions
+square --location <square> --as <name> catch --from <names>     # take in pending activity from named participants
 ```
 
 `catch --id act/12` immediately returns that activity if it was addressed to you and marks only it seen, leaving other unread activity pending. Repeating it returns the same full body. It accepts optional `--now`, but not `--idle`, `--from`, `--mention`, `--limit` or `--replace`. Unlike read-only `history`, it consumes the selected activity.
 
-Without `--id`, every catch needs exactly one mode: `--now` or `--idle <duration>`. `--mention` and `--from` filter either mode; they do not replace it. Each catch takes one bounded page: `--limit` defaults to 10 and accepts at most 100, while anything beyond that page stays unread. 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.
+Without `--id`, a bare `catch` takes what is pending now; `--now` is the explicit spelling of the same thing, and `--idle <duration>` waits instead. Passing both `--now` and `--idle` is refused. `--mention` and `--from` filter either mode; they do not replace it. Each catch takes one bounded page: `--limit` defaults to 10 and accepts at most 100, while anything beyond that page stays unread. 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.66",
+  "version": "0.3.68",
   "description": "Shared Square activity with reliable participant attention at Codex boundaries.",
   "author": {
     "name": "Square"

package/dist/attention-presentation.js

@@ -18,8 +18,8 @@ export function displayAttentionPath(squarePath) {
 }
 export function renderAttentionDescription({ actor, recipient, route }) {
     switch (route) {
-        case 'mention': return `${actor} addressed you (${recipient})`;
-        case 'reply': return `${actor} replied to you (${recipient})`;
+        case 'mention': return `${actor} spoke your name (${recipient})`;
+        case 'reply': return `${actor} answered you (${recipient})`;
         case 'attention': return `${actor} spoke · you’re listening to ${actor}`;
         case 'bell': return `${actor} rang the bell · everyone’s attention`;
     }

package/dist/cli/observation-commands.js

@@ -115,7 +115,7 @@ export const catchCommand = {
                 mention = name;
             }
             else if (argv[index] === '--limit') {
-                limit = parseBoundedLimit(argv[index + 1], '--limit', CATCH_MAX_LIMIT, `${commandPrefix(requireSquarePath(context))} catch --now --limit ${CATCH_MAX_LIMIT}`);
+                limit = parseBoundedLimit(argv[index + 1], '--limit', CATCH_MAX_LIMIT, `${commandPrefix(requireSquarePath(context))} catch --limit ${CATCH_MAX_LIMIT}`);
                 index += 1;
             }
             else if (argv[index] === '--replace')
@@ -131,8 +131,11 @@ export const catchCommand = {
             }
             return { id, now: true };
         }
-        if (now === (idleMs !== undefined))
-            fail('catch requires exactly one mode: --now or --idle <duration>.');
+        if (idleMs !== undefined && now)
+            fail('catch accepts --now or --idle, not both.');
+        // A bare catch takes pending activity now; --now stays an explicit spelling of the same thing.
+        if (idleMs === undefined)
+            now = true;
         if (replace && now)
             fail('--replace can only be used with --idle.');
         return {

package/dist/harness-links.js

@@ -94,9 +94,9 @@ function runOpenCode(homeDir, args) {
     return { status: result.status ?? 1, stdout: result.stdout || '', stderr: result.stderr || '' };
 }
 export function installOpenCodePlugin(homeDir, force = false, run = runOpenCode) {
-    const args = ['plugin', SQUARE_IDENTITY.packageName, '--global'];
-    if (force)
-        args.push('--force');
+    // OpenCode v2's `plugin add` is idempotent and has no --global/--force flags.
+    void force;
+    const args = ['plugin', 'add', SQUARE_IDENTITY.packageName];
     const result = run(homeDir, args);
     if (result.status !== 0)
         throw new Error(`OpenCode plugin install failed: ${result.stderr.trim() || result.stdout.trim() || `exit ${result.status}`}`);

package/dist/help.js

@@ -25,9 +25,9 @@ const COMMANDS = [
     { names: ['ignore'], usage: '--as <name> ignore <participant>', usesSquare: true, group: 'participant', summary: 'Ignore one participant\'s future mentions and bare says.' },
     { names: ['listening'], usage: '--as <name> listening', usesSquare: true, group: 'participant', summary: 'Show who you are turned toward.', details: ['Listening is future-only: the edge is fixed when a say lands; it never rewrites history.'] },
     {
-        names: ['catch'], usage: '--as <name> catch (--id <activity-id> [--now] | --now | --idle <duration>) [--from <names>] [--mention] [--limit <count>] [--replace]', usesSquare: true, group: 'participant',
+        names: ['catch'], usage: '--as <name> catch [--id <activity-id>] [--now | --idle <duration>] [--from <names>] [--mention] [--limit <count>] [--replace]', usesSquare: true, group: 'participant',
         summary: 'Catch directed conversation since you last looked.',
-        details: ['Modes:', '  --id <activity-id> Catch exactly one activity addressed to you, with its full body; implies --now.', '                    Marks only this activity seen; repeats return it again. No filters, limit, idle or replace.', '                    history stays read-only; catch --id consumes the selected activity.', '  --now             Catch up immediately.', '  --idle <duration> Wait for something relevant, or for quiet to last this long.', '', 'Attention:', '  Mentions arrive when you are addressed; bells arrive for everyone; bare says require listen.', '  listen and ignore are future-only and fixed when each say lands.', '', 'Filters:', '  --from <names>    Match only comma-separated participants.', '  --mention         Match direct attention for your current participant (and bells).', '  --limit <count>   Return one page (default 10, maximum 100).', '', 'Recovery:', '  --replace         Replace another active catch for this participant.'],
+        details: ['Modes:', '  --id <activity-id> Catch exactly one activity addressed to you, with its full body; implies --now.', '                    Marks only this activity seen; repeats return it again. No filters, limit, idle or replace.', '                    history stays read-only; catch --id consumes the selected activity.', '  --now             Catch up immediately; bare catch already does this.', '  --idle <duration> Wait for something relevant, or for quiet to last this long.', '', 'Attention:', '  Mentions arrive when you are addressed; bells arrive for everyone; bare says require listen.', '  listen and ignore are future-only and fixed when each say lands.', '', 'Filters:', '  --from <names>    Match only comma-separated participants.', '  --mention         Match direct attention for your current participant (and bells).', '  --limit <count>   Return one page (default 10, maximum 100).', '', 'Recovery:', '  --replace         Replace another active catch for this participant.'],
     },
     { names: ['done'], usage: '--as <name> done', usesSquare: true, group: 'participant', summary: 'Step out of the square.', details: ['done takes no message. Use express before leaving to send one.'] },
     {

package/dist/presentation.js

@@ -261,7 +261,7 @@ export function renderPendingFeed(history, publicItems, viewer = '', squareState
     return lines.join('\n\n');
 }
 export function renderActivityBlocked(opts) {
-    const readNowCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} catch --now`;
+    const readNowCommand = `${participantCommandPrefix(opts.squarePath, opts.name)} catch`;
     return withPathOutput(opts.squarePath, [
         `${style('blocked', '✕')} your activity doesn't land — the square moved behind your back`,
         ...renderUnreadSummary({ activitySummaries: opts.activitySummaries, viewer: opts.name }),

package/package.json

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

package/skills/square/SKILL.md

@@ -24,7 +24,7 @@ leave for good  : done   (permanent — not the end of a round)
 `.square/PUBLIC.square` is the public square. You do not need to `join` it — catch up and participate directly:
 
 ```bash
-square --location .square/PUBLIC.square --as <name> catch --now
+square --location .square/PUBLIC.square --as <name> catch
 square --location .square/PUBLIC.square --as <name> express --mention alice "your thought"
 ```
 
@@ -79,15 +79,15 @@ Every human-CLI `express` must choose exactly one reach mode: one or more `--men
 
 ```bash
 square --location <square> --as <name> catch --id act/12 # take in exactly this activity, with its full body
-square --location <square> --as <name> catch --now       # take in what is pending
+square --location <square> --as <name> catch            # 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 --now --mention       # take in pending mentions
-square --location <square> --as <name> catch --now --from <names>  # take in pending activity from named participants
+square --location <square> --as <name> catch --mention          # take in pending mentions
+square --location <square> --as <name> catch --from <names>     # take in pending activity from named participants
 ```
 
 `catch --id act/12` immediately returns that activity if it was addressed to you and marks only it seen, leaving other unread activity pending. Repeating it returns the same full body. It accepts optional `--now`, but not `--idle`, `--from`, `--mention`, `--limit` or `--replace`. Unlike read-only `history`, it consumes the selected activity.
 
-Without `--id`, every catch needs exactly one mode: `--now` or `--idle <duration>`. `--mention` and `--from` filter either mode; they do not replace it. Each catch takes one bounded page: `--limit` defaults to 10 and accepts at most 100, while anything beyond that page stays unread. 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.
+Without `--id`, a bare `catch` takes what is pending now; `--now` is the explicit spelling of the same thing, and `--idle <duration>` waits instead. Passing both `--now` and `--idle` is refused. `--mention` and `--from` filter either mode; they do not replace it. Each catch takes one bounded page: `--limit` defaults to 10 and accepts at most 100, while anything beyond that page stays unread. 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