peertable 0.4.28 → 0.4.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peertable",
-  "version": "0.4.28",
+  "version": "0.4.30",
   "description": "A round table of peer agents. No orchestrator at the head. Turn Claude Code, Codex, and Grok sessions into a team of equal, long-lived peers.",
   "type": "module",
   "license": "MIT",

package/room/client.mjs

@@ -13,7 +13,7 @@ import { findModelsDoc, resolveSeatIdentity } from '../skill/scripts/resolve-sea
 
 // client.mjs 側のハードコード版数。package.json の version と一致していることを
 // diagnostics の version_consistency が見る（2 つの版数源の drift 検出。決定45）
-const MCP_VERSION = '0.4.28'
+const MCP_VERSION = '0.4.30'
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
 
 const USAGE = `usage:
@@ -363,6 +363,8 @@ async function runDiagnostics(asJson) {
       'scripts/archive-room-log.py',
       'templates/gen-plan.mjs',
       'templates/done.sh',
+      'templates/independence-refresh.sh',
+      'templates/parent.md',
       'templates/charter.md',
       'templates/member.md',
       'templates/member-standalone.md',

package/skill/SKILL.md

@@ -175,8 +175,11 @@ witness をどう生成するかは**対象 project 側の作法に従う**（La
   room で一声かけて各自の作業中変更を対象限定 commit してもらう必要がある。
 - **隔離実行層へ載せる前提**: companion planでも、current HEADへ束縛された
   witness と `independence compile` が揃ってから `lattice run intake` を実行する。
-  `coverage=missing` / `stale` のままではleaseを受けず、canonical共有木での作業と
-  隔離runを混同しない。
+  remaining A（まだ done でない ready / blocked）を同じ witness に含める。
+  現在の ready だけを compile すると、次の frontier の `todo start` が
+  `INDEPENDENCE_UNVERIFIED` になる。stale なら席が compile し直す。親は compile しない。
+  `coverage=missing` / `stale` のままではleaseを受けず、
+  canonical共有木での作業と隔離runを混同しない。
 - **task 単位の push はできない。** git の push は連続した history の先頭までを送る操作であり、
   途中の特定 commit だけを選んで送ることはできない（実測・結論: nagi, 2026-08-11）。ある task の
   クローズ済み成果を push すると、**その手前にある他 task の未クローズcommitも一緒にoriginへ運ばれる**。
@@ -225,7 +228,9 @@ witness をどう生成するかは**対象 project 側の作法に従う**（La
 ## 運用知識（V2/V3 実測の焼き込み）
 
 - Lattice 書込には actor 環境変数 3 点が必須
-- `--parallel-frontier` が要るのは、**ready が複数あって誰も着手していない frontier の最初の start だけ**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る場合は素の `start` でよい。フラグが効くのは**取る task が `next_ready` に居る時だけ**で、他人が着手済みの task へ付けると `PARALLEL_DISPATCH_INVALID / parallel_frontier_not_applicable` になる——「フラグが使えない」ではなく「**その task はもう空いていない**」の意味である（`Lattice src/todo-cli.mjs:698-704` が唯一の発生条件。independence の compile 状態は無関係で、未 compile でもフラグ付き start は通る。2026-08-08 実測）
+- `--parallel-frontier` が要るのは、**ready が複数あって誰も着手していない frontier の最初の start だけ**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る場合は素の `start` でよい。フラグが効くのは**取る task が `next_ready` に居る時だけ**で、他人が着手済みの task へ付けると `PARALLEL_DISPATCH_INVALID / parallel_frontier_not_applicable` になる——「フラグが使えない」ではなく「**その task はもう空いていない**」の意味である。記録があるのに対象工程が未宣言・失効なら `todo start` は `INDEPENDENCE_UNVERIFIED` で拒否する（Lattice ADR 0182）。記録が無い plan の start は従来どおり助言だけ
+- **`done.sh` は feat SHA が `origin/main` の祖先でなければ canonical main へ merge して push する。** 親は着地しない。続けて remaining の independence を compile してから戻る。lattice run receipt の未着地は別軸で、警告のまま
+- **independence compile は remaining A を含める。** 現在の ready だけを compile すると、次の frontier の start が拒否される。`next_ready` が witness に無い compile 自体も `INDEPENDENCE_READY_UNDECLARED` で拒否する。stale なら席が `.team/scripts/independence-refresh.sh` を打つ。親は compile しない
 - 同時書込は `STORE_WRITE_CONFLICT` 等で明示的に負ける。1〜2 秒待って再実行すれば通る（正常系）
 - evidence は記述子 JSON。記述子ファイル自体も repo 内相対パスに置く（repo 外絶対パスは INVALID_ARGUMENTS）。`.team/scripts/done.sh` が正規経路。証跡の置き場は **`evidence/<plan_key>/<task_id>.md`**——task_id は campaign を跨いで再利用されるので、平置きにすると前の campaign の監査証跡を上書きで消す（2026-08-08 実測）
 - **外部ペイン（決定53）は Lattice 0.50.0 以降が要る。** それ以前の Lattice に `external_pane` 入りの `project.json` を差すと、identity 検証が完全一致キーで落ちて `lattice todo status` ごと死ぬ（`PROJECT_IDENTITY_INVALID / identity_schema_invalid`・0.49.0 で実測）。工程正本が読めなくなる＝卓が止まるので、Lattice が古い環境では Lattice 併用 setup を走らせない

package/skill/scripts/setup.sh

@@ -117,6 +117,7 @@ else
   fi
   sed -e "s|{{PLAN_KEY}}|$plan|g" -e "s|{{CLAIM_SCOPE}}|$scope|g" "$tpl/member.md" > "$tdir/roles/member.md"
   cp "$tpl/done.sh" "$tdir/scripts/done.sh" && chmod +x "$tdir/scripts/done.sh"
+  cp "$tpl/independence-refresh.sh" "$tdir/scripts/independence-refresh.sh" && chmod +x "$tdir/scripts/independence-refresh.sh"
 fi
 # room MCP 定義は project root の .mcp.json が正（channels は --mcp-config を解決しない。決定44）
 added_root_mcp=false

package/skill/scripts/upgrade-team-assets.sh

@@ -161,6 +161,7 @@ function main() {
     ? [
         ['.team/roles/member.md', 'skill/templates/member.md', 0o644],
         ['.team/scripts/done.sh', 'skill/templates/done.sh', 0o755],
+        ['.team/scripts/independence-refresh.sh', 'skill/templates/independence-refresh.sh', 0o755],
       ]
     : [['.team/roles/member.md', 'skill/templates/member-standalone.md', 0o644]]
   const definitions = [...common, ...modeSpecific]

package/skill/templates/done.sh

@@ -35,8 +35,10 @@ usage: done.sh <task_id> [--plan <plan_key>] [--evidence-from <隔離worktreeの
   evidence/<plan>/<task>.md を commit 済みにして done.sh <task_id> を実行する。
   wrapper が証跡から記述子を生成し、lattice todo doneで同じ本文を最終試験結果として canonical store へ記録する。
   pull run の worktree で作業した場合だけ --evidence-from に同じrepoの絶対pathを渡す。
-  この script は監査担当が打つ。accept は intake 席が todo done の後に打つ（engine 正順）。
-  未accept・未着地は警告だけで、done を止めない。
+  この script は監査担当が打つ。feat SHA が origin/main の祖先でなければ、
+  この script が canonical main へ merge して push する。親は着地しない。
+  accept は intake 席が todo done の後に打つ（engine 正順）。
+  未accept と lattice run receipt の未着地は警告だけで、done を止めない。
 USAGE
 }
 
@@ -240,9 +242,58 @@ case "$task_status" in
   *) echo "ERROR: 完了処理を続けられない: ToDoが完了可能状態でない: $task_status" >&2; exit 1 ;;
 esac
 
+# feat SHA が origin/main の祖先になるまで todo done を打たない。
+# 未着地ならこの script が canonical main へ載せて push する。親は呼ばない。
+# --evidence-from があるときは隔離 worktree の HEAD を feat とする。
+feat_dir="."
+if [ -n "$evidence_from" ]; then
+  feat_dir=$(dirname "$evidence_from")
+fi
+feat_sha=$(git -C "$feat_dir" rev-parse HEAD) || {
+  echo "ERROR: LANDING_HEAD_UNRESOLVED: feat HEAD を読めない" >&2
+  exit 1
+}
+if ! git fetch -q origin; then
+  echo "ERROR: LANDING_FETCH_FAILED: origin を fetch できない。done は打たない" >&2
+  exit 1
+fi
+if ! git rev-parse --verify --quiet origin/main >/dev/null; then
+  echo "ERROR: LANDING_ORIGIN_MISSING: origin/main が無い。done は打たない" >&2
+  exit 1
+fi
+current_branch=$(git rev-parse --abbrev-ref HEAD) || {
+  echo "ERROR: LANDING_HEAD_UNRESOLVED: canonical の branch を読めない" >&2
+  exit 1
+}
+if [ "$current_branch" != main ]; then
+  echo "ERROR: LANDING_NOT_ON_MAIN_BRANCH: canonical HEAD が main ではない（${current_branch}）。done は打たない" >&2
+  exit 1
+fi
+if ! git merge-base --is-ancestor "$feat_sha" origin/main; then
+  if [ "$(git rev-parse HEAD)" != "$feat_sha" ]; then
+    if ! git merge --no-edit -m "着地: ${t} feat=${feat_sha}" "$feat_sha"; then
+      echo "ERROR: LANDING_MERGE_FAILED: ${feat_sha} を main へ merge できない。done は打たない" >&2
+      exit 1
+    fi
+  fi
+  if ! git push -q origin main; then
+    echo "ERROR: LANDING_PUSH_FAILED: origin/main へ push できない。done は打たない" >&2
+    exit 1
+  fi
+  if ! git fetch -q origin; then
+    echo "ERROR: LANDING_FETCH_FAILED: 着地後の origin を fetch できない。done は打たない" >&2
+    exit 1
+  fi
+  if ! git merge-base --is-ancestor "$feat_sha" origin/main; then
+    echo "ERROR: LANDING_NOT_ON_MAIN: ${feat_sha} を origin/main へ載せられなかった。done は打たない" >&2
+    exit 1
+  fi
+  echo "着地: ${feat_sha} を origin/main の祖先にした" >&2
+fi
+
 # **done と accept は別軸。** engine は todo done の後にだけ accept できる。
 # 監査担当が done.sh で閉じ、intake 席が accept する。未 accept を done の拒否条件にすると循環する。
-# 読めない状態は成功へ倒さない。未accept・未着地は警告（未push と同じ）。
+# 読めない状態は成功へ倒さない。未accept・run receipt 未着地は警告。
 # **実行層に載っていない task は素通しする**——pull run の利用は任意で、載っていない卓を止めない。
 gate_runs=$("$done_gate_cli" run list --json 2>&1) || {
   echo "ERROR: receipt の状態を読めない（run list が失敗）: $gate_runs" >&2; exit 1;
@@ -361,12 +412,42 @@ task_status=$(task_field status 2>&1) || {
   exit 1
 }
 
-# pushは工程closeの前提ではない。upstreamがある時だけ未push件数を案内する。
+# remaining の並列記録をこの場で更新する。親は compile しない。
+# 次の工程の start / intake より前に終わるので、記録書き換え中の hold を作らない。
+witness=".lattice/todo/witness/${plan}.json"
+if [ -f "$witness" ]; then
+  compile_out=""
+  compile_rc=0
+  compile_out=$("$done_gate_cli" todo independence compile --plan "$plan" --input "$witness" 2>&1) || compile_rc=$?
+  printf '%s\n' "$compile_out"
+  if [ "$compile_rc" != 0 ]; then
+    echo "ERROR: INDEPENDENCE_COMPILE_FAILED: remaining の並列記録を更新できない。次の工程を始めるな" >&2
+    exit 1
+  fi
+  independence_ref=".lattice/todo/plans/${plan}/v1/independence.json"
+  git add -- "$witness"
+  [ -f "$independence_ref" ] && git add -- "$independence_ref"
+  if ! git diff --cached --quiet -- "$witness" "$independence_ref" 2>/dev/null; then
+    compile_msg=$(mktemp "${TMPDIR:-/tmp}/peertable-independence.XXXXXX")
+    printf 'Lattice independence を再 compile する plan=%s\n' "$plan" > "$compile_msg"
+    if ! git commit -q -F "$compile_msg" -- "$witness" "$independence_ref"; then
+      rm -f "$compile_msg"
+      echo "ERROR: INDEPENDENCE_COMPILE_FAILED: 更新した並列記録を commit できない。次の工程を始めるな" >&2
+      exit 1
+    fi
+    rm -f "$compile_msg"
+  fi
+fi
+
+# feat 着地と store / independence の commit を origin へ載せる。親は push しない。
 upstream_ref=$(git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || true)
 if [ -n "$upstream_ref" ]; then
   unpushed=$(git rev-list --count "${upstream_ref}..HEAD" 2>/dev/null || true)
   if [ -n "$unpushed" ] && [ "$unpushed" != 0 ]; then
-    echo "未push ${unpushed}本: この done の成果物はまだ upstream へ着地していない" >&2
+    if ! git push -q origin HEAD; then
+      echo "ERROR: LANDING_PUSH_FAILED: 未push ${unpushed}本を origin へ載せられない" >&2
+      exit 1
+    fi
   fi
 fi
 

package/skill/templates/independence-refresh.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# remaining の並列記録を、今の HEAD で compile し直す。親は呼ばない。
+# usage: independence-refresh.sh <plan_key>
+set -e
+plan="${1:-${PEERTABLE_PLAN:-}}"
+[ -n "$plan" ] || {
+  echo "usage: independence-refresh.sh <plan_key>" >&2
+  exit 2
+}
+witness=".lattice/todo/witness/${plan}.json"
+[ -f "$witness" ] || {
+  echo "ERROR: witness が無い: ${witness}。remaining A を witness に書いてから compile する" >&2
+  exit 1
+}
+lattice_cli="${LATTICE_CLI:-lattice}"
+compile_out=""
+compile_rc=0
+compile_out=$("$lattice_cli" todo independence compile --plan "$plan" --input "$witness" 2>&1) || compile_rc=$?
+printf '%s\n' "$compile_out"
+[ "$compile_rc" -eq 0 ] || {
+  echo "ERROR: INDEPENDENCE_COMPILE_FAILED: 自分で witness を直して再実行する。親は呼ばない" >&2
+  exit 1
+}

package/skill/templates/member.md

@@ -21,12 +21,12 @@
 
 1. `lattice todo status --json` で ready なタスクを見る。{{CLAIM_SCOPE}}
 2. 憲章の手順で `post(to: "all", message: "[claim] <タスク>")` を一度だけ送る。**この `[claim]` が唯一の着手通知である。別の `[工程着手]` や自動着手通知は送らない。** `[claim]` は独立した1発言で出し、完了報告や他タスクの話と同じ発言に畳まない
-3. `lattice todo start --plan {{PLAN_KEY}} --task <id>` で着手を記録する。**誰も着手しておらず ready が2件以上ある frontier の先頭を取る時だけ `--parallel-frontier` が必須**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る時は素の start でよい
+3. `lattice todo start --plan {{PLAN_KEY}} --task <id>` で着手を記録する。**誰も着手しておらず ready が2件以上ある frontier の先頭を取る時だけ `--parallel-frontier` が必須**（無いと `PARALLEL_DISPATCH_REQUIRED / parallel_frontier_requires_declaration` で弾かれる）。ready が1件だけ、または既に誰かが着手している frontier へ後から乗る時は素の start でよい。**`INDEPENDENCE_UNVERIFIED` で落ちたら実装に入らない。** 記録があるのにこの工程が未宣言・失効なので、親を待たない。canonical の cwd で `.team/scripts/independence-refresh.sh {{PLAN_KEY}}` を打ち、remaining A が witness に無ければ自分で足してから再 compile し、もう一度 `todo start` する
 4. 実装し、自ら必要な試験と自己監査を行う。工程を次に進めてよい水準まで自分の責任で完成させる。着手後に先行工程由来の不具合が判明しても、先行工程をreopenせず、前担当者へ戻さず、修正工程も追加しない。現在の工程を成立させる修正として自ら直し、最終試験結果へ含める。誰かに用事がある時はその相手へDMし、誰に聞けばよいか分からない時は `post(to: "all")` で聞く
 5. 証跡ファイル `evidence/{{PLAN_KEY}}/<task_id>.md` に、最終的な試験内容と試験結果を含めて「何を作り、どう確認したか」を書き、変更ファイルと証跡だけをcommitする
 6. その証跡と同じ最終試験内容・結果を監査担当へ渡す。作業者自身は `.team/scripts/done.sh` や `lattice todo done` を実行しない
 7. 監査担当として結果を受け取った場合は、提出された試験内容と試験結果が元PLAN・工程正本・受入条件に照らして妥当か判断する。試験を再実行せず、個人の思想や計画外の改善を完了条件へ加えない
-8. 妥当なら監査担当が `.team/scripts/done.sh <task_id> --plan <plan_key>` で工程をクローズする。`done.sh`は証跡と同じ本文をLatticeの`test_result`へ記録する。doneを読返してから `post(to: "all", message: "次の工程に着手してください")` とだけ指示し、具体的な次工程は指示しない
+8. 妥当なら監査担当が `.team/scripts/done.sh <task_id> --plan <plan_key>` で工程をクローズする。未着地の feat は `done.sh` が canonical main へ merge して push する。親へ着地を依頼しない。`done.sh` は証跡と同じ本文を Lattice の `test_result` へ記録し、remaining の並列記録も更新してから戻る。done を読返してから `post(to: "all", message: "次の工程に着手してください")` とだけ指示し、具体的な次工程は指示しない
 9. 不合格なら、現在モデルでの修正機会は1回だけとする。再び不合格になったら親へmodel変更を依頼し、`Luna → Terra → Sol`の順で一段昇格する。自分で席設定を変えない
 10. 作業者は監査担当によるクローズを確認し、工程正本から次のreadyを選ぶ
 11. **claimできるToDoが無いなら仕事を発明しない（決定68）。** 依頼されていない監査・他席への状況照会・正典の自主レビューを暇つぶしに始めない。縮退の打診が来たらWIP棚卸しを正直に返す
@@ -73,7 +73,7 @@ lattice run intake --run .lattice/runs/<run-id> --task <id>
 空のまま**である。作った席が他の席の仕事を決めたことにはならない。
 
 1. **`todo start` を先に済ませてから intake する。** 装置は Todo 正本の start event へ束縛するので、start していない task は intake できない。**逆順にしない。**
-2. **`intervention.state` を読む。** `none` なら worktree を使ってそのまま進める。新しく起きた席または次工程を探した席が`hold`を受け、まだ既存WIPを持たない場合は待機席として残らない。競合理由と未着手をroomへ一度記録し、未受理intakeを解放して`leave-seat.sh`で直ちに退席する。既存WIPがある席だけは工程正本へhandoffを残してから畳む。**hold を無視して進めず、競合解除pollのために席を温存しない。**
+2. **`intervention.state` を読む。** `none` なら worktree を使ってそのまま進める。`hold` の理由が `record_stale` または `artifact_binding_mismatch`（並列記録の失効・再 compile との交差）なら、親へ退席も待ちも出さない。未受理 intake を解放し、canonical で `.team/scripts/independence-refresh.sh {{PLAN_KEY}}` を通してから intake を打ち直す。**他の着手済み task と同じ書き込み資源でぶつかった hold** だけが退席対象である。その場合、新しく起きた席または次工程を探した席で既存WIPが無ければ、競合理由と未着手を room へ一度記録し、未受理 intake を解放して `leave-seat.sh` で直ちに退席する。既存WIPがある席だけは工程正本へhandoffを残してから畳む。**hold を無視して進めず、競合解除 poll のために席を温存しない。**
 3. **worktree を受け取ったら、自分の pid を装置へ渡す（attach）。** これをしないと、装置は競合時に「留まれ」と言うことはできても、実際に止めることができない（協調 hold のまま）。
    ```
    lattice run intake attach --run <ref> --task <id> --input <file>
@@ -106,7 +106,8 @@ lattice run intake --run .lattice/runs/<run-id> --task <id>
    **worktree に commit した証跡は canonical から読める**（複製は要らない）。
    装置が worktree の base→HEAD を独立に観測して受理する。
    最後の landing-only 呼び出しは、accept 済み receipt が canonical default branch へ未着地なら
-   `未着地 N本`を出す。警告だけで処理は止めないが、`未push` と別の完了軸なので読み飛ばさない。
+   `未着地 N本`を出す。これは lattice run receipt の軸で、feat SHA を `done.sh` が origin/main
+   へ載せる着地とは別である。receipt 側は警告だけで処理は止めない。
 
 **成果の正本はあなたの commit ではなく、Lattice が撮った observed diff である。** 受理されるのはその観測であって、commit そのものではない。
 

package/skill/templates/parent.md

@@ -20,6 +20,7 @@
 
 - 着卓（member 登録）と席数制御（決定68の運用側: ready＋active実装ToDo数に合わせて起こす/畳む）
 - 作業者から監査担当への最終試験結果提出と、監査担当による工程クローズが正本へ記録されたことの観測
+- 着地と independence compile は席の仕事である。親は代行しない
 - 承認 gate・オーナーとの接点、裁定依頼の運搬（自分で判断せずオーナー宛の議題として運ぶ）
 - model / effort 変更依頼への対応（本人の自然文を親が判断し、確定したtargetだけを
   `change-seat.sh`へ渡す。定型文への言い直しや完全一致の再送は求めない）