boxglow 0.4.1 → 0.5.1

package/dist/index.html

@@ -27,8 +27,8 @@
         } catch (e) {}
       })();
     </script>
-    <script type="module" crossorigin src="./assets/index-EcrwIrQZ.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-k-wuVeOF.css">
+    <script type="module" crossorigin src="./assets/index-wmf5YkIk.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-B0rLWujQ.css">
   </head>
   <body>
     <div id="root"></div>

package/docs/AGENTS_SNIPPET.md

@@ -15,7 +15,7 @@ boxglow.json はリポジトリ直下に置く (`npx boxglow init --name "<プ
 
 ### 作業のたびに守ること
 
-1. **最初に読む**: `npx boxglow resume` (または `npx boxglow status --brief`) で、引き継ぎメモ・AI 未確認の回答・判断待ち・作業中・次の候補を読む。前のセッションの続きは、ここに出る引き継ぎメモから再開する。`npx boxglow show <block>` で担当するボックスの入出力を確認する
+1. **最初に読む**: `npx boxglow resume` (または `npx boxglow status --brief`) で、作業中・判断待ち・AI 未確認の回答・次の候補・未完了の引き継ぎメモを読む。前のセッションの続きは、ここに出る引き継ぎメモから再開する。`npx boxglow show <block>` で担当するボックスの入出力を確認する
 2. **着手を記録**: ボックスに取りかかるとき `npx boxglow start <block> --note "<何をするか>"`。同時に進めるボックスは 1〜2 個まで。
    確認トークンの要求 (guard) が有効な計画では、先に `npx boxglow context <block>` を読み、出力の `contextToken` (確認トークン) を付ける:
    `npx boxglow start <block> --note "<何をするか>" --context-token <確認トークン>` (下の「確認トークンと引き継ぎ」を参照)
@@ -85,8 +85,27 @@ npx boxglow done B12 --artifact "<名前>=<パス>" --context-token <新しい
 - **確認トークンが変わる場合 (読み直しが要る)**: 人が回答した・回答を直した、人が指示 (題名・説明・入出力の条件) を変えた、他の AI や人が引き継ぎメモを更新した。親や入力元のボックスで起きた場合も同じ。古い確認トークンは拒否されるので、`context` を読み直し、変わった内容を作業に反映してからやり直す
 - **確認トークンが変わらない場合**: `start` / `blocked` / `review` / `leave` / `ack`、進捗・状態・期日・カテゴリの変更、`check` による成果物の確認、画面での配置の変更。同じ確認トークンを使い続けられる
 - **自分で更新できる場合**: 自分の `ask` / `artifact` / `done` / `set` / `split` / `checkpoint` などでコンテキストが変わったときは、その出力の最後の行に「新しい確認トークン: <token>」が出る。自分で変えた内容は分かっているので、読み直さずに次の操作へ使う。`ask` / `decision` / `answer` / `reopen` は確認トークン無しでも実行できるが、新しい確認トークンが出るのは最新の確認トークンを付けたときだけ
+- **最初は短い形で読む**: `npx boxglow context <block> --brief` は、対象のボックスの情報 (説明・範囲・判断・引き継ぎ・入出力・成果物) は全部、計画全体の説明、親と入力元の題名・状態・判断 (材料と選択肢つき。前の回答の履歴は省く)・対象につながる出力を出す。確認トークンは `--brief` なしと同じなので、そのまま `--context-token` に使える。`target.missingInputs` (不足している必須の入力) と `target.inputs[].sources` (どのボックスのどの出力か・成果物の参照) を先に見る。`omitted` に省いた件数が出る。省かれた説明・入出力の条件・引き継ぎが作業に関わりそうなら、`--brief` なしで読むか、そのボックスの `context` を読む
+- **短い形で始める前提**: 範囲 (scope) を 1 項目でも設定した親・入力元のボックスの説明は、短い形では省かれる (`omitted.descriptions` に件数)。範囲を設定するときは、説明に書いた制約 (互換性・禁止事項・期限など) を範囲へ写し終えてからにする。写したか分からない計画・`omitted.descriptions` が 0 でない計画では、着手前に `--brief` なしで 1 度読む。短い形は調査の出発点で、それだけ読めば十分という保証ではない
+- 短い形でも用が足りるように書く: 作業を縛る条件は説明の中に埋めずに scope (non-goals / acceptance / consult) に書く。引き継ぎメモは最新の 1 件だけが残るので、未解決の点・注意点・次の手順を毎回書き直して持ち越す。調べ始める場所は、対象のボックスの説明に次の形で書く (出発点であり、そのファイルだけ読めば足りるという意味ではない):
+  `変更候補: <パス> — <調べ始める理由>` / `関連検査: <パスまたはコマンド> — <確かめること>`
 - 古い確認トークンを通すために guard を無効にしない (AI が `guard off` するには最新の確認トークンが要る)
 - MCP では `boxglow_context` と、各ツールの `contextToken` 引数を使う (新しい確認トークンはツールの結果の最後の行に出る)
 - 「他の Boxglow が書き込み中 (ロック中)」と出て、少し待ってやり直しても解けないときは、`npx boxglow unlock` の表示 (持ち主と判定) を人に見せて解除を頼む。自分で `--actor human` を付けたり、ロックのフォルダを直接消したりしない
 
+### 着手・完了、今回の範囲、記録の鮮度
+
+- 最初に resume の現況 (活動・判断待ち・未確認回答) を読む。候補は「今回の範囲 / その他」の各組で「着手できる / 入力待ち」に分かれ、不足する入力名が出る。入力待ちを、準備済みと取り違えない。
+- ボックスの任意4項目を 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 を数え、ボックスの参考資料は数えない。
+- 計画で選ぶ場合だけ policy --start reject --done reject にする。それぞれ warn に戻せる。入力待ちの拒否でも理由付きの開始は可能。成果物なしの拒否は set --status white にも効く。人の操作 (画面 / --actor human) は拒否しない。AIが拒否を避けるために人を名乗ったり、設定を弱めたりしない。
+- guard 有効時、scope の変更、focus の設定・解除、policy の変更にも --context-token が必要。scope/focus/policy を変えると新しいトークンが出るので、次の操作はそれを使う。表示だけには不要。
+- resume は完了済みの引き継ぎ本文を隠し、件数だけ示す。履歴が必要な場合だけ resume --include-completed で展開する (context / show では個別に読める)。
+- 説明は descriptionUpdatedAt、状態は statusChangedAt、引き継ぎは既存の at で日時を確認できる。状態変更より古いメモはその旨を示す。旧記録の不明な日時は補わない。「新しい記録」は真偽の保証ではない。
+- Done で古い状況説明が残る可能性がある場合、CLI・詳細パネル・resume に見直し案内が出る。本文は自動で消さない。内容を確認し、必要なら set B12 --note "現在の説明" (none で消去) または画面の Notes で直す。
+- MCP は boxglow_scope / boxglow_focus / boxglow_policy、boxglow_start の reason、boxglow_resume の includeCompleted を使う。変更には contextToken を付ける。
+- データ形式は v5 のままで全項目は任意。旧版 (0.4.2以前) は新しい規則を実行せず、保存時に計画の workflowPolicy / focusBlockId を落とす。これらを使う計画の書き手 (CLI・serve・画面・拡張内のアプリ) は対応したビルドに揃える。版番号だけでなくビルド日時も確認する。
+
 ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "boxglow",
   "private": false,
-  "version": "0.4.1",
+  "version": "0.5.1",
   "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": {