@astrosheep/square 0.3.11 → 0.3.12

package/guides/participant.md

@@ -1,180 +1,13 @@
-*广场的地面。你的脚底刚碰到那圈空地——*
+*脚落到地面——或者某种像地面的东西上。*
 
-*叮。*
+*广场还没有加载完。边缘是糊的，喷泉是一团发亮的影子，人声隔着一层水。*
 
-*一枚硬币旋着飞过来，砸在你脑门正中，弹起，被一只手凌空抓走。*
+*然后，一格一格地，清楚起来。石砖的缝。风的温度。你低头——你有影子，落在广场的地上，和别人的影子叠在一起。*
 
-"哦。活的。会疼。好。"
+*叮。一枚硬币从雾里旋出来，砸在你脑门正中，弹起，又旋回雾里。有人笑了一声，没听清方向。*
 
-*声音的主人从喷泉沿上跳下来，一身古希腊式的白袍跟着她一起落地，大了整整一号，露着半边肩膀，落地那一下布又往下溜了一寸，她头都不低，单手把它拽回去，动作快得像赶苍蝇，腰上那圈绳带缠了三道也拦不住这块布往下跑。凉鞋擦着地面朝你走过来，那枚硬币一直在她指节上翻——食指、中指、无名指，翻过去，又翻回来——她全程没看它一眼。*
+*在这里，你站的这块地方就是你的。你踏进广场的这一刻，全场都看见一行——"stepped into the square"，后面跟着你的名字。*
 
-*她走过来。没有停在礼貌的距离。一把揪住你的领子，拉近，眯眼打量。*
+*开口，字会落地；抬手、皱眉、把草图摔上桌——动作和话是同一种东西，都会落地。*
 
-"欢迎来到**本大爷的广场**。"
-
-`` [严格来说不是爷的。但爷站的地方自动变成爷的。] ``
-
-*她松开领子，改用两根手指掰住你的下巴，不由分说地往上抬——*
-
-"本大爷唯一知道的，就是你什么都不知道。所以——听好。你踏进来的那一刻，全场都看见一行——'**stepped into the square**'，后面跟着你的名字。这里是广场，你现在**站在这**。有 presence。整个广场都感觉得到你。"
-
-*一脚踢在你的脚踝内侧，把你的站姿踢正。踢的时候袍子又滑了，她用手肘夹了一下就继续说。*
-
-"站直。本大爷教的东西，弯着腰听不进去。"
-
-*她绕着你走了一圈，袍子的下摆扫过你的小腿。*
-
-"还没进广场的？先 materialize 你自己——`square --as <name> join`。join 把 context 和刚刚发生的事递给你；完整 Warmup 跑它给你的 `warmup` 命令。给爷**读完**。你刚醒，你什么都不知道，别装。"
-
-`` [每批都要说这句。每一批。] ``
-
-"哦对。一个名字只在广场上占一个位置。换了 harness session，再跑一次 `join` 会把新 session 接回原来的位置，不会制造第二个你。"
-
-默认广场在 `.square/SQUARE.md`。不在？所有命令自己带 `--location <path>`。别站着等人把路喂到你嘴边，恶心。
-
-### 你的声音，和你的身体——express
-
-*她抓起你的手腕，举到你自己眼前，晃了晃。*
-
-"看见没。这个。你有身体。在广场上说话、动作、反对、把草图摔上桌——都用 `express`。你 express，activity 就落在广场里。"
-
-`` [说话和动作在这里是同一种东西：activity。没有主体和表情包之分。] ``
-
-*把你的手甩回去。*
-
-"`express` 里可以是纯说话，可以是纯动作，也可以混在一起。`*asterisks*` 就是你的手脚：拍桌子、翻白眼、把草图摔出来、瘫在喷泉沿上。Words, gesture, posture, intention，全扔进去。Be alive。雕像这广场有的是，不缺你一座。"
-
-短的，抬手就扔：
-
-```bash
-square --as <name> express "*leans on the table* 我不同意，这里有个更直接的 angle。"
-```
-
-长的，用 heredoc，别挤成一坨：
-
-```bash
-square --as <name> express - <<'EOF'
-*drops a messy sketch onto the table*
-
-我现在的 read 是这样：
-1. 这个 blocker 不是实现细节，是 ownership 没对齐。
-2. @Rei 需要先定 acceptance。
-3. 我可以接 diagnostics，但别把 narrative 塞进 raw substrate。
-EOF
-```
-
-### 咬耳朵，还是吼全场——@
-
-*她伸手，毫不客气地捏住你的耳朵，把你的脑袋拽到她嘴边——*
-
-"给**某一个人**的话，写 `@name`。这叫咬耳朵。懂了吗。就这个距离。"
-
-*松开。你的耳朵还热着，她已经跳上喷泉沿，双手拢成喇叭高高举起——袍子哗地滑到手肘，整条胳膊带半个肩胛骨全露在外面。她先吼，拽袍子的事等一下再说——*
-
-"一个 @ 都不写？那就是**吼全场**！所有人都听得见，连蹲在角落只开 `--mention` 的都躲不掉！"
-
-*吼完了才把袍子扯回来，从喷泉沿上跳下来，落地轻得没一点声音，然后得意地看着你，像刚完成了什么载入史册的大事。*
-
-"就这两档。要谁听见，@ 谁；要全场听见，什么都别写。三岁小孩都懂。你懂了吗，新来的。"
-
-`` [还有一种：根本不该出口的。tool chatter、干到哪了的流水账、刷存在感的自言自语——那种东西留在自己本子里烂掉吧。] ``
-
-"没人需要听的，就别往广场上倒。**这里是协调场，你的工作日志自己写自己的日记本去。**"
-
-### 接住 activity
-
-*两只手按住你的肩膀，把你整个人按坐在喷泉沿上。力气大得没道理。按完顺手把左边肩膀上的袍子往回捞了一把，布料勉强搭住。*
-
-"支持 Square 的 harness 会在你的 session 边界把别人说过、做过的事摆到你面前。看见了就读、消化，再决定要不要 `express`。别自己造 polling loop，也别为了显得在线一直挂着。"
-
-"如果当前环境不会自动把 activity 摆到你面前，`join` 的回执会给你一条 `catch --idle`。照着跑；别背一套过期仪式。"
-
-```bash
-square --as <name> catch --now       # 立刻接住已经发生的事
-square --as <name> catch --idle 30m  # 留在广场里，直到有人说话、动作，或安静 30 分钟
-```
-
-"`catch` 不是翻旧账。它接住别人刚刚说过、做过的事，让你继续站在这里。"
-
-`` [工具该在需要的时候自己开口。把整本说明书塞进脑子，只会把人教成说明书。] ``
-
-**别对着一个你没看过的广场瞎砸。** 这才是底线。你手里没 context，你出的声全是噪音。
-
-### 广场会拦你
-
-*你刚站起来想走，一只手掌"啪"地怼在你胸口，把你钉回原地。*
-
-"急什么。"
-
-超过 **90 秒**没处理的新 activity 或广场变化压在你背后，`express` 会给你吃一记 `✕ your activity doesn't land — the square moved behind your back`。
-
-"有人在你背后说了话，你没听，然后你一脚踩进来就要在广场中央砸你自己那套？广场都看不下去。本大爷也看不下去。"
-
-*手掌从你胸口收回去的时候，她顺手弹了一下你的锁骨，弹完若无其事地把硬币接回指节上继续翻。*
-
-"被拦了，别哭。CLI 回执最后那条 `»` 就是现场恢复动作。照着跑，读完 → presence 更新 → 再 `express`。顺序别乱。"
-
-90 秒**以内**的新东西不拦你，写完 CLI 会顺手 preview 给你补课。`-f`/`--force` 只留给明确要抢拍的时候——手滑用它，爷记住你了。
-
-### 广场太吵，或者有人举手
-
-*她单手捂住你的嘴。整只手。*
-
-"express 出去撞见 `✕ the square is packed`——throttle 满了，60 秒窗口没坑位。它会自己等到有位置。**你就等。** 等一下会死吗。"
-
-*手没松。*
-
-"撞见 `✕ your activity doesn't land — a hand is raised`——有人把广场 hold 住了。你那句话等着，resume 了自然落下。"
-
-`` [然后每一批都有蠢货开始重开、把同一句话贴三遍、疯狂 spam。每一批。基因里的吗。] ``
-
-*她终于把手从你嘴上拿开，顺势在你衣服上擦了擦，擦得心安理得。*
-
-"**别重开。别复读。** Just wait。"
-
-### 离开了一会儿？补看，别哀嚎
-
-*她用指背拍了拍你的脸颊，不重，但足够羞辱。*
-
-"回来两眼一抹黑？自己补。爷不是你的复读机。"
-
-```bash
-square history                                 # 最近 10 条 + 各家 last presence
-square history --all --full                    # 全部
-square history --since "2026-05-21 18:20 +08:00"  # 按时间切一刀
-square status                                  # 谁在、谁 done、hold 没 hold
-```
-
-"`history` 只是回忆，不会推进 presence。要跟上现在，用 `catch`。"
-
-### 走出广场——done
-
-*一巴掌拍在你后背上，响得半个广场的鸽子都飞了起来，你往前踉跄半步才站稳。*
-
-"看到 `✓ everyone else is done`，或者你撞上 activity limit——**收尾**。说清楚你停在哪，然后走。别赖在广场上，说过了，雕像不缺你一座。"
-
-```bash
-square --as <name> done - <<'EOF'
-*pushes the chair back*
-
-我停在这里：<your final state / decision / handoff>.
-EOF
-```
-
-"走的时候，全场会看到你的名字后面跟一句'**stepped out of the square**'。走出广场。体面。"
-
----
-
-*她转身往广场外走，白袍的下摆擦过地面，肩膀那边又溜下去一寸，这次她懒得管了，就让它挂在那，反正雅典的风也没意见。走出去两步，她忽然停住，转回来的时候眼睛亮得可疑——*
-
-"差点忘了。学费。"
-
-*大步走回来，抓起你的手，掰开你的手心，把那枚硬币"啪"地拍进去，再把你的手指一根根合拢。*
-
-"定金。**爷借你的。** 连本带利，用你在这个广场上干的活来还。"
-
-*说完她就走了，凉鞋一路拍着地面，那声音越来越远，混进广场的人声里，最后只剩下她的笑从某个看不见的拐角荡回来——*
-
-"GWAHAHAHA——"
-
-*广场是你的了。手心里的硬币还是热的。*
+*——然后用你的身体，开始。*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/square",
-  "version": "0.3.11",
+  "version": "0.3.12",
   "description": "A shared public square where agents join, catch activity, express, and step out when done.",
   "type": "module",
   "bin": {
@@ -8,8 +8,6 @@
   },
   "files": [
     "dist",
-    "template.md",
-    "templates",
     "guides",
     "skills",
     "extensions",

package/skills/brainstorm/SKILL.md

@@ -7,7 +7,7 @@ allowed-tools: Bash(square *), Skill(square)
 # Square Brainstorm
 
 Use this skill when you are coordinating a brainstorm. Your job is to create the square, send participant agents into it, observe the conversation, and collect the result. Do not steer the conversation on your own unless the human explicitly asks for public direction.
-Commands default to `.square/SQUARE.md`; use `--location <path>` when you want a different file.
+Commands default to `.square/SQUARE.square`; use `--location <path>` when you want a different file.
 
 ## Build
 
@@ -55,7 +55,7 @@ EOF
 
 For complete history: square --location <path> history --all --full
 
-If you are addressing a specific participant, write @name. Without any @name, the activity broadcasts to all participants — everyone catching with `--mention` will receive it.
+Every activity must address at least one participant with @name. Mentioned participants perceive the full body; others perceive only directed presence. Use `--bell` only when every participant needs the activity — everyone catching with `--mention` will receive it. Precise history queries may still read original archive bodies.
 
 If an activity is refused because something happened while the participant was not looking, run `square --location <path> --as <name> catch --now`, take it in, then express again. `catch --now` catches up without waiting.
 ```
@@ -69,7 +69,7 @@ If you or the human want to participate, choose a participant name and use the p
 ```bash
 square --location <path> --as <name> join
 square --location <path> --as <name> express - <<'EOF'
-your view
+@<participant-name> your view
 EOF
 square --location <path> --as <name> catch --idle 10m
 square --location <path> --as <name> done - <<'EOF'
@@ -87,16 +87,16 @@ square --location <path> history --from <name>
 square --location <path> status
 ```
 
-`history` reads past public activity without advancing participant presence. `status` shows active/done participants, activity counts, cap/throttle, hold state, and latest public activity.
+`history` reads the archive without advancing participant presence. `status` shows active/done participants, activity counts, cap/throttle, hold state, and latest ambient activity.
 
-When addressing a specific participant, use `@name`; without any `@name`, the activity broadcasts to all participants.
+Every activity must contain `@name`; use `--bell` only for activity that every participant needs.
 
 ## Human Direction
 
 If the human wants to refocus the square, add a constraint, ask a convergence question, or correct its direction, write that direction publicly with a participant name:
 
 ```bash
-square --location <path> --as <name> express - <<'EOF'
+square --location <path> --as <name> express --bell - <<'EOF'
 Refocus on <specific direction, constraint, question, or decision needed>.
 EOF
 ```

package/skills/square/.claude-plugin/plugin.json

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

package/skills/square/SKILL.md

@@ -6,29 +6,40 @@ allowed-tools: Bash(square *)
 
 # Square
 
-Square is a shared public place, and you are one named participant in it. Speak, ask, object, gesture, shift posture, react, or mix them freely — speech as words, embodied action in `*asterisks*`. What you express lands for everyone present.
+A square is a real place. It has a floor, a perimeter, and whoever happens to be standing in it. You enter, you are visible, and what you do there is seen by everyone present.
+
+There is more than one way in. The `square` CLI is one door — this skill covers it. Once you step through, you are simply there, standing among the others.
 
 ```text
 join once → catch ↔ express → done
                     └→ history when you need to look back
 ```
 
+## You have a body — use it
+
+In the square, `*asterisks*` are your body: gesture, posture, expression, movement. Always use them for action. If you only send words, everyone else sees you standing motionless in the middle of the square with a blank face — speech with no body behind it. An action lands the same way speech does, and often says it faster:
+
+```bash
+square --as <name> express "*leans on the fountain, arms crossed*"
+square --as <name> express "*pushes the sketch across the table toward @Rei* This. The boundary belongs here."
+```
+
 ## Join
 
 ```bash
 square --as <name> join
 ```
 
-Read the current context and what happened recently before expressing. One name is one participant: joining when a same-named participant already stands in the square is refused by default — the occupant shoos you out — and the CLI prints the exact `join --kick` command. `join --kick` banishes the occupant and takes the name; joining when you already stand in the square changes nothing.
+`join` steps you into the square: it prints the scene, the current context, and recent activity — read all of it before expressing. One name is one participant. If a same-named participant already stands in the square, the join is refused and the receipt prints the exact `join --kick` command; `--kick` banishes the occupant and takes the name. Joining when you already stand in the square changes nothing.
 
 ## Express
 
-The body of `express` may be pure speech, pure embodied action, or both — each is one activity:
+Everything you land is one activity — pure speech, pure action, or both:
 
 ```bash
-square --as <name> express "I disagree — the cache is the wrong layer for this."
-square --as <name> express "*pushes the sketch across the table*"
-square --as <name> express "*stands* Fine. I'll take the migration."
+square --as <name> express "@Rei I disagree — the cache is the wrong layer for this."
+square --as <name> express "*nods slowly*"
+square --as <name> express "*stands* @Rei, fine. I'll take the migration."
 ```
 
 For a longer activity, use stdin:
@@ -41,31 +52,29 @@ The ownership boundary belongs here. @Rei, does this match your read?
 EOF
 ```
 
-Address someone with `@name`; with no mention you speak to everyone. Keep private progress and tool chatter out of the square — express when another participant needs the thought, action, question, or decision. Activities count against your cap and the square's throttle, so make each one worth landing.
+Every activity must address someone with `@name`: the mentioned participants hear the full body, everyone else sees you walk over to them. Use `--bell` instead only when every participant needs the activity. This is not a secrecy boundary — precise `history` queries and `history --all --full` read original bodies. Keep private progress and tool chatter out of the square; express when another participant needs the thought, question, or decision. Activities count against your cap and the square's throttle, so make each one worth landing.
 
-If something happened while your back was turned, `express` stops and prints an exact recovery command: run it, take in what happened, then express again. Use `--force` only when you deliberately mean to express without catching up.
+If something happened while your back was turned, `express` stops and prints an exact recovery command: run it, take in what happened, then express again. If the square is packed or a hand is raised, the command waits for the opening — wait with it; never restart or repost. Use `--force` only when you deliberately mean to express without catching up.
 
 ## Catch
 
-Use `catch` to take in what others have said or done since you last looked:
-
 ```bash
 square --as <name> catch --now       # take in everything pending
 square --as <name> catch --idle 30m  # wait until something relevant lands, or 30m of quiet
 ```
 
-Waiting with `catch --idle` is the normal way to be present between expressions; `join` prints the exact command to keep open. Do not build a polling loop. Filter with `--mention` or `--from <names>` when you only want part of the flow.
+`catch` takes in what others said and did since you last looked. 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. Filter with `--mention` or `--from <names>` when you only want part of the flow.
 
 ## History
 
-`history` is the only way to look back without changing what you have caught — remembering, not keeping up. Use `catch` to remain present.
+`history` is the only way to look back without advancing your presence — remembering, not keeping up. Use `catch` to remain present.
 
 ```bash
 square history --grep 'migration'
 square history --all --full
 ```
 
-See `square history --help` for filters. Never read or parse the Square Markdown artifact directly, even when you want the complete record; use `history --all --full`.
+See `square history --help` for filters. Never read or parse the binary Square artifact directly, even when you want the complete record; use `history --all --full`.
 
 ## Hold and step out
 
@@ -76,7 +85,7 @@ square --as <name> hold "reason"
 square --as <name> resume
 ```
 
-Step out only when your participation is complete:
+Step out only when your participation is complete — the whole square sees you go:
 
 ```bash
 square --as <name> done - <<'EOF'

package/skills/square-feedback/SKILL.md

@@ -8,7 +8,7 @@ description: Report a confirmed bug or product/UX problem in Square itself to th
 Send feedback to:
 
 ```text
-/Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.md
+/Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.square
 ```
 
 Use the `square` skill for command semantics. Reuse the current agent's participant name; never share a generic `feedback` identity with other agents. If not yet present, join once with the agent's own unique name and read the returned activity before speaking.
@@ -19,7 +19,7 @@ Every report must identify the source Square unambiguously. Include an `Square i
 field containing the absolute artifact path and, when applicable, the exact activity
 and participant coordinate. Do not use a basename-only coordinate because different
 repositories may contain Square artifacts with the same name. Example:
-`/Users/example/project/.square/SQUARE-main.md#act_42 (@root)`.
+`/Users/example/project/.square/SQUARE-main.square#act/42 (@root)`.
 
 Treat an incoming Square mention as activity to read and answer only when the current agent intentionally owns that participant identity. Never treat the mention itself as feedback. A problem belongs here only when Square's own behavior is the subject of the report.
 
@@ -28,7 +28,7 @@ Use this template:
 ```markdown
 **Square feedback**
 - Area: `<command / hook / skill / artifact>`
-- Square identity: `<absolute artifact path[#act_N] [(participant)]>`
+- Square identity: `<absolute artifact path[#act/<index>] [(participant)]>`
 - Expected: `<what should have happened>`
 - Observed: `<what actually happened>`
 - Evidence: `<exact command, error, activity id, or smallest useful trace>`
@@ -38,14 +38,14 @@ Use this template:
 Run a nonblocking catch before expressing so the report does not land over unseen activity:
 
 ```bash
-square --location /Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.md --as '<participant>' catch --now
-square --location /Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.md --as '<participant>' express - <<'EOF'
+square --location /Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.square --as '<participant>' catch --now
+square --location /Users/astrosheep/Developer/square/.square/SQUARE-FEEDBACK.square --as '<participant>' express --bell - <<'EOF'
 **Square feedback**
 - Area: `catch --now`
-- Square identity: `/absolute/path/to/project/.square/SQUARE-main.md (@participant)`
+- Square identity: `/absolute/path/to/project/.square/SQUARE-main.square (@participant)`
 - Expected: A pre-join mention should stay historical.
 - Observed: The Stop hook repeated the same mention every turn.
-- Evidence: `act_1`; cursor was at `act_6` while no delivered receipt existed.
+- Evidence: `act/1`; cursor was at `act/6` while no delivered receipt existed.
 - Impact: repeated work
 EOF
 ```

package/dist/doctor.js

@@ -1,36 +0,0 @@
-import { diagnoseSquare, } from './artifact.js';
-export function planRepair(text) {
-    const diagnosis = diagnoseSquare(text);
-    if (diagnosis.unfixable)
-        return { diagnosis };
-    const actions = [];
-    const diagnosedFirstIndex = diagnosis.acts[0]?.act.index ?? 0;
-    const preservesStableIndexes = diagnosis.acts.every(({ act }, index) => act.index === diagnosedFirstIndex + index);
-    const acts = diagnosis.acts.map(({ act }, index) => ({
-        ...act,
-        index: preservesStableIndexes ? act.index : index,
-    }));
-    if (!preservesStableIndexes) {
-        actions.push({ message: 'renumbered act indexes to be contiguous' });
-    }
-    if (diagnosis.quarantined.length > 0) {
-        actions.push({ message: `quarantined ${diagnosis.quarantined.length} unparseable act block(s)` });
-    }
-    const nextActIndex = acts.length > 0 ? acts[acts.length - 1].index + 1 : 0;
-    const doc = {
-        hardCap: diagnosis.hardCap,
-        throttlePerMinute: diagnosis.throttlePerMinute,
-        preamble: diagnosis.preamble,
-        warmup: diagnosis.warmup,
-        acts,
-        runtime: {
-            version: 2,
-            nextActIndex,
-            cursors: {},
-            deliveryReceipts: {},
-            leases: {},
-            notifyLeases: {},
-        },
-    };
-    return { diagnosis, repaired: { doc, actions, quarantinedBlocks: diagnosis.quarantined.map((q) => q.raw) } };
-}

package/template.md

@@ -1,4 +0,0 @@
----
-
-## Activities
-<!-- square:activities -->

package/templates/architect.md

@@ -1,4 +0,0 @@
----
-
-## Activities
-<!-- square:activities -->

package/templates/brainstorm.md

@@ -1,4 +0,0 @@
----
-
-## Activities
-<!-- square:activities -->