boxglow 0.6.1 → 0.6.2

package/dist/index.html

@@ -32,7 +32,7 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="./assets/index-ujaBGwdT.js"></script>
+    <script type="module" crossorigin src="./assets/index-DmRfg1K8.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-BpZb2sGB.css">
   </head>
   <body>

package/docs/AGENTS_SNIPPET.md

@@ -27,7 +27,7 @@ boxglow.json はリポジトリ直下に置く (`npx boxglow init --name "<プ
    確認トークンの要求 (guard) が有効な計画では、出力の `contextToken` (確認トークン) を付ける:
    `npx boxglow start <block> --note "<何をするか>" --context-token <確認トークン>` (下の「確認トークンと引き継ぎ」を参照)
    要具体化のボックスへの start は既定では警告 (理由と次の一手が出る)。`policy --unprepared reject` の計画では開始できない (`--reason` では通れない。人の操作は通る)。出力を子に任せきりの親も実行するものが無いので、子を start する
-5. **完了を記録**: 出力の成果物ができたら `npx boxglow done <block> --artifact "<名前>=<リポジトリ内のパス>"`。
+5. **完了を記録**: 出力の成果物ができたら `npx boxglow done <block> --artifact "<名前>=<リポジトリ内のパス>" --checked "<実行した検査と結果>"`。検査結果は決まった 3 つで残す: `--checked` (実行した検査と結果。例: "vitest 53 件成功; e2e home 34/34")、`--not-checked` (試していないこと)、`--limits` (残る制限・注意)。コード以外の成果物 (文書など) は「確認したこと」を `--checked` に書く。箱に残り、context と show に出る。
    guard が有効なら `--context-token <確認トークン>` を付ける (直前の自分の操作の出力に「新しい確認トークン: <token>」が出ていれば、それを使う)。
    HEAD にコミット済みで内容が一致するファイルは「コミット + パス + 中身のハッシュ」で記録される (アップロードはしない)。未コミット・未追跡のファイルはローカル参照として残り、コミットした後の `npx boxglow check` で Git の参照に補完される。記録のためだけにコミットしない。全階層が必要なら `npx boxglow status` を読む。PR や外部資料は URL でもよい。
    成果物だけ先に付けるなら `npx boxglow artifact <block> <パス>`。進捗の途中経過は `npx boxglow set <block> --progress 60`
@@ -104,6 +104,10 @@ boxglow.json はリポジトリ直下に置く (`npx boxglow init --name "<プ
 入力の説明は書かない (つながった出力側の説明が使われる)。出力の説明に形式・制約を書く。
 
 
+### 自動で動く仕組み (hooks)
+
+`setup-agent` は Claude Code / Codex の hooks に `boxglow hook` を登録する。セッションの開始・再開・圧縮の後には計画の再開の概要 (resume) が自動で文脈に入る。応答を終えるとき、このセッションで start した箱に引き継ぎ (done か checkpoint) が無ければ「記録してから終える」よう続行が指示される (log は進捗のメモで、引き継ぎの代わりにならない)。boxglow.json を Edit / Write / apply_patch で直接書き換える操作は止められる (CLI か MCP で更新する)。これらは指示の代わりではなく、忘れたときの保険なので、上の手順どおりに自分で記録する。
+
 ### 確認トークンと引き継ぎ
 
 確認トークンの要求 (guard) は、AI が古い指示のまま作業を進めるのを防ぐ仕組み。`setup-agent` が有効にする (それ以外の計画では `npx boxglow guard on`)。
@@ -132,7 +136,7 @@ npx boxglow done B12 --artifact "<名前>=<パス>" --context-token <新しい
 
 - 最初に resume の現況 (活動・判断待ち・未確認回答) を読む。候補は「今回の範囲 / その他」の各組で「着手できる / 要具体化 / 入力待ち」に分かれ、要具体化の理由と不足する入力名が出る。要具体化や入力待ちを、準備済みと取り違えない。
 - 「着手できる」(Ready) は、自身が作る出力があり、その予定成果物 (expect) と完了条件 (acceptance) が書かれ、必須の入力がそろっている、という機械検査の結果。内容が具体的かどうかまでは保証しない (`expect = src/`、`acceptance = 動作する` でも通る)。対象・処理・成果・確認方法を第三者が追えるように書く。
-- ボックスの任意4項目を scope で設定する。goal = 今回達成すること、non-goals = 今回は扱わないこと、acceptance = 完了と判断する条件、consult = 範囲を広げる前に相談する条件。context の先頭で対象と親の範囲を読み、着手前と完了前に照合する。完了条件の本文をAIが満たしたかは自動判定しない。
+- ボックスの任意5項目を scope で設定する。goal = 今回達成すること、non-goals = 今回は扱わないこと、acceptance = 完了と判断する条件、consult = 範囲を広げる前に相談する条件。context の先頭で対象と親の範囲を読み、着手前と完了前に照合する。完了条件の本文をAIが満たしたかは自動判定しない。
 - scope B12 --goal "達成すること" --non-goals "今回扱わないこと" --acceptance "確認する条件" --consult "相談する条件" で設定する。scope B12 は表示だけ。各項目に none または空文字を渡すと消す。画面では詳細パネルの「その他」タブ →「作業範囲を編集」。記入済みの項目だけが「今回の範囲」に出る。
 - focus B12 でこのボックスと配下を次候補の先頭にする。focus は現在の対象の表示、focus none は解除。対象外も別の組に残る。候補に出ること自体は作業範囲の拡大や公開を許可しない。
 - start の必須入力不足は既定で警告するが、従来どおり開始できる。先行作業が必要なら --reason "先に行う理由" を付ける。警告は出ず、理由は活動とログに残る。done の出力成果物なしも既定で警告のみ。既存の出力成果物または --artifact を数え、ボックスの参考資料は数えない。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "boxglow",
   "private": false,
-  "version": "0.6.1",
+  "version": "0.6.2",
   "type": "module",
   "description": "See at a glance what your AI agents and your team are working on: tasks as input/output boxes that go from BlackBox to WhiteBox. Web app + CLI, one boxglow.json in your repo.",
   "scripts": {