@quolu/lattice 0.36.1 → 0.38.0

package/README.ja.md

@@ -43,6 +43,21 @@ planを再コンパイルします。共有面が共有でなくなるので、
 
 人が手で切ったのではありません。**工程を並列化するために製品が切りました。**
 
+### 作業記憶はToDoと一緒に渡る
+
+AIは、次の担当が作業を続けるために必要な方針、棄却案、調査結果、注意、未解決事項をToDoへ追記できます。
+通常の`lattice todo show`と、成功するすべての`lattice todo start`は、元version／元task、訂正状態、
+note chain head、overflow、全履歴コマンドを含む最新のbounded `note_context`を自動で返します。
+次のAIが別のnote読取コマンドを知っている必要はありません。
+
+```bash
+lattice todo note --plan <key> --task <id> --message "既存parserを使い、fallbackは追加しない"
+lattice todo show --plan <key> --task <id> --json
+```
+
+ローカルGanttでは、選択したToDoの右ペインへ同じ作業記録を表示します。公開Gantt／dashboardは契約として
+note本文を含めません。
+
 ### 変換の受入五条件
 
 **5つすべて**を満たしたときだけ採用します。1つでも欠ければ棄却です。
@@ -213,6 +228,20 @@ lattice todo phase review --plan <key> --phase terminal-audit --reason <text>
 lattice todo phase accept --plan <key> --phase terminal-audit --input <file>
 ```
 
+**過去の工程は監査できません。** 監査対象のコードが既に変化しているためです。そこで
+「監査なしで閉じた」という状態を別に持ちます——`accepted`（監査を通った）へは絶対に化けず、
+記録は永久に区別できます。工程図では畳まれるので監査待ちの札は外れます。
+
+```bash
+lattice todo phase close-unaudited --plan <key> --phase terminal-audit --reason <text>
+lattice todo phase baseline --reason <text> --except <監査したいplan_key>   # 一括
+```
+
+一括の入口は、現在監査待ちで一度も監査に触れていないPhaseだけを対象にします。**自動では
+実行しません**——どれを監査し、どれを歴史として畳むかは人が決め、Latticeは宣言を受け取って
+記録するだけです。`--except`は「最近の作業でコードも生きているので本当に監査したい」planを
+残すための口です。規約は[ADR 0148](docs/adr/0148-history-closes-unaudited-not-audited.md)が正です。
+
 誤ってphase無しで作ったplanへ後からPhaseを被せる場合は、`revise-phase`の
 `state_policy: acquire_phase`でdone状態を保ったまま獲得できます（未割当→割当の向きだけを許し、
 既にphaseを持つtaskの付け替えは拒否します）。

package/README.md

@@ -58,6 +58,22 @@ the same parallel group.
 
 Nobody hand-refactored that file. The product cut it so the work could parallelize.
 
+### Task memory travels with the task
+
+An agent can append the decisions, rejected approaches, findings, cautions, and open questions needed
+to continue a ToDo. A normal `lattice todo show` and every successful `lattice todo start` return the
+latest bounded `note_context` automatically, including origin, correction state, chain head, overflow,
+and the full-history command. The next agent does not need to discover or remember a separate note
+lookup command.
+
+```bash
+lattice todo note --plan <key> --task <id> --message "Use the existing parser; do not add a fallback"
+lattice todo show --plan <key> --task <id> --json
+```
+
+The same context appears in the selected ToDo's detail pane in a local Gantt. Public Gantt and
+dashboard rendering exclude note bodies by contract.
+
 ### The five acceptance conditions
 
 A transform is adopted only when **all five** hold. One missing condition rejects it:
@@ -158,6 +174,15 @@ rejected over it; the requirement is reported instead. And the audit gate never
 phases order reviews, the ToDo DAG orders work
 ([ADR 0147](docs/adr/0147-audit-is-on-by-default.md)).
 
+**History closes unaudited, never audited.** Work that finished long ago cannot be audited — the
+code under review has already moved. Demanding an audit there produces either a false finding
+(pointing at a later, intentional change) or a rubber stamp. So there is a third terminal state,
+`closed_unaudited`: recorded with a reason, folded away like finished work, and **structurally
+incapable of passing as `accepted`** — phase-accept dependencies unlock on `accepted` alone. The
+bulk entry point never runs by itself, and the machine never infers "old enough to skip"; a human
+decides what gets audited and what becomes history
+([ADR 0148](docs/adr/0148-history-closes-unaudited-not-audited.md)).
+
 ## Patent
 
 The design in this repository is the subject of a Japanese patent application:

package/bin/lattice-dashboard.mjs

@@ -5,7 +5,7 @@ import path from 'node:path';
 
 import { readTodoStoreStable } from '../src/todo-store.mjs';
 import { projectTodoStatus } from '../src/todo-status.mjs';
-import { ganttLiveHeadDigest, renderTodoGanttForProject } from '../src/todo-cli.mjs';
+import { ganttLiveHeadDigest, renderPublicTodoGanttForProject } from '../src/todo-cli.mjs';
 import {
   readVisibleTodoDashboardProjects,
   writeTodoDashboardDaemonDescriptor,
@@ -87,7 +87,7 @@ async function synchronize() {
       displayName: entry.display_name,
       render: async ({ displayName }) => {
         const store = await readCachedStore(entry.repo_root);
-        const result = await renderTodoGanttForProject({ repoRoot: entry.repo_root,
+        const result = await renderPublicTodoGanttForProject({ repoRoot: entry.repo_root,
           stable: true, displayName, readModel: store });
         return {
           html: result.rendered.html,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.36.1",
+  "version": "0.38.0",
   "description": "Schedulability compiler for multi-agent development: observe real code boundaries, refactor the conflicting seam, recompile the plan for parallel execution",
   "author": {
     "name": "Quo / クオ at kitepon.dev",

package/src/cli-help.mjs

@@ -61,6 +61,8 @@ Commands:
 
 Read commands:
   status [--json]
+  show --plan <key> --task <id> --json  # 個別ToDoと最新bounded note contextを追加操作なしで返す
+  note list --plan <key> [--task <id>] --json  # note全履歴の診断面（通常read/startでは不要）
   bindings [--plan <key>] [--json]   # compile_binding付きTaskをTODO identityつきで投影する
   independence [--plan <key>] [--json]  # readyを検証済み並列・要直列・未検査へ分けて投影する
   seam-profile --plan <key> --file <path> [--json]  # 係争fileの切断コスト内訳を投影する（read-only）
@@ -73,6 +75,8 @@ Read commands:
   phase status --plan <key>
 
 Write commands:
+  note --plan <key> --task <id> (--message <text>|--input <file>)
+      # ToDoへ作業継続に必要な方針・調査結果・注意をappend-onlyで追記する
   migrate --input <extraction.json> [--serialization-reviewed]
       # 既存storeへplanを追加する（plan createは空store初期化専用）。
       # 依存グラフがほぼ一直線なら一度突き返し、再考後の --serialization-reviewed で通す
@@ -98,6 +102,12 @@ Write commands:
   phase review --plan <key> --phase <id> --reason <text>
   phase <accept|reject> --plan <key> --phase <id> --input <file>
   phase reopen --plan <key> --phase <id> --reason <text> [--override-reason <text>]
+  phase close-unaudited --plan <key> --phase <id> --reason <text>
+      # 監査せず「監査なしで閉じた」として明示的に閉じる(ADR 0148)。前提はgate_readyで、
+      # acceptedへは化けない(phase_accept_dependenciesを解錠しない)
+  phase baseline --reason <text> [--except <plan_key>]...
+      # 現在gate_readyかつphase eventを1つも持たないPhaseを一括でclosed_unauditedへ宣言する。
+      # 自動実行はしない(明示コマンドのみ)。--exceptで指定したplanは対象から除外する
 
 Write commands require LATTICE_TODO_ACTOR_HOST, LATTICE_TODO_ACTOR_SESSION,
 and LATTICE_TODO_ACTOR_AGENT.
@@ -162,6 +172,9 @@ const SUBCOMMAND_USAGE = Object.freeze({
   'run seam resolve': 'run seam resolve --run .lattice/runs/<id> --finding <digest> --input <seam-request.json>',
   'event verify': 'event verify --run .lattice/runs/<id>',
   'todo status': 'todo status [--json]',
+  'todo show': 'todo show --plan <key> --task <id> --json',
+  'todo note': 'todo note --plan <key> --task <id> (--message <text>|--input <file>) | list --plan <key> [--task <id>] --json',
+  'todo note list': 'todo note list --plan <key> [--task <id>] --json',
   'todo bindings': 'todo bindings [--plan <key>] [--json]',
   'todo independence': 'todo independence [--plan <key>] [--json] | compile --plan <key> --input <file> | witness migrate --plan <key>',
   'todo seam-profile': 'todo seam-profile --plan <key> --file <path> [--json]',
@@ -169,12 +182,15 @@ const SUBCOMMAND_USAGE = Object.freeze({
   'todo verify': 'todo verify [--plan <key>] [--json]',
   'todo snapshot': 'todo snapshot --rebuild --plan <key>',
   'todo gantt': 'todo gantt [--out <file>] [--scope live|all] | status [--out <file>] | serve --port <port> [--scope live|all]',
-  'todo phase': 'todo phase <status|review|accept|reject|reopen> --plan <key> [options]',
+  'todo phase': 'todo phase <status|review|accept|reject|reopen|close-unaudited> --plan <key> [options]'
+    + ' | baseline --reason <text> [--except <plan_key>]...',
   'todo phase status': 'todo phase status --plan <key>',
   'todo phase review': 'todo phase review --plan <key> --phase <id> --reason <text>',
   'todo phase accept': 'todo phase accept --plan <key> --phase <id> --input <file>',
   'todo phase reject': 'todo phase reject --plan <key> --phase <id> --input <file>',
   'todo phase reopen': 'todo phase reopen --plan <key> --phase <id> --reason <text> [--override-reason <text>]',
+  'todo phase close-unaudited': 'todo phase close-unaudited --plan <key> --phase <id> --reason <text>',
+  'todo phase baseline': 'todo phase baseline --reason <text> [--except <plan_key>]...',
   'todo start': 'todo start --plan <key> --task <id> [--parallel-frontier|--override-reason <text>]',
   'todo block': 'todo block --plan <key> --task <id> --reason <text>',
   'todo unblock': 'todo unblock --plan <key> --task <id>',