Lattice
Latticeは、codebaseの境界を観測・変換し、multi-agent開発の並列TODO graphを生成する schedulability compilerです。
現在の工程状態と完了証拠の正本は、このrepoのLattice storeです。文書の役割と現行導線は docs/README.md、製品思想はPLAN.md、公開contractは docs/00_product-contract.mdを参照してください。
CLIの全体像はlattice --help、各公開namespaceの正規構文は
lattice <plan|run|event|todo|sensor|factory-diagnostics|runtime-errors> --helpで確認できます。
個別操作はlattice <namespace> <subcommand> --helpまたはlattice help <namespace> <subcommand>で
正規optionをstore非依存に確認できます。
開発
npm test
npm run check
npm run ci
lattice sensor sync . --json
spotter doctor
codex-sidecar diagnostics --project . --preset auditor --json未初期化projectでsensor syncした場合はLATTICE_SENSOR_NOT_INITIALIZEDと正規next_actionを返します。
その他のsensor失敗もexit code、signal、bounded stderrをtyped detailへ残し、原因を隠しません。
Node.js 22.13以上を使用します。境界観測は配布物に同梱したLattice sensorだけを使い、PATH上の 廃止済みruntimeや旧cache/dataへfallbackしません。Spotterはproject単位で生成stateの所有境界を守ります。
どのrepoでも、Latticeの導入状態はdirectoryの有無を推測せず、最初に次のtyped discoveryで判定します。
lattice status --jsonstateはuninitialized | ready | active_run | invalidのいずれかです。uninitializedは
正常な未初期化状態で、next_actionが正規の初期authoring入口を返します。初回planは
新規planはPhase監査とToDo schedulingを分離するlattice.plan_create_input.v3のcanonical
JSON+LFを用意し、次で作成します。既存v2/v4は互換契約として維持されます。
lattice plan create --schema-version 3 --jsonlattice plan create --input .lattice/plan-create.jsoninvalidをMarkdown fallbackへ丸めず、next_actionに従ってstoreを診断してください。
discoveryと初期transactionの不変条件は
ADR 0058が正です。
TODO工程storeの読取はlattice todo status、検証はlattice todo verify、表示生成は
lattice todo ganttを使います。topology/source reconciliationは
lattice todo revise --plan <key> --input <canonical-revision.json>、Phase付きplanは
lattice todo revise-phase --plan <key> --input <canonical-phase-revision.json>でsuccessor発行します。
cross-plan topologyを同時に切り替える場合は
lattice todo revise-set --input <canonical-revision-set.json>を使い、Phase revisionを含む集合は
lattice.todo_revision_set.v3で通常revisionと混在できます。
Phase付きv5 planでは、通常ToDoの開始順はToDo DAGだけで決まり、Phase前後関係は重監査の順序だけを
制御します。特定ToDoがPhase受理を本当に必要とする場合だけphase_accept_dependenciesで明示します。
lattice todo status --jsonのdispatch_frontierはready全件を同時dispatchする既定を示します。
readyが複数なら最初のstartに--parallel-frontierを付け、subsetだけを直列着手する場合は
--override-reason <reason>で理由を残します。
lattice todo start --plan <key> --task <id> --parallel-frontier
lattice todo start --plan <key> --task <id> --override-reason <reason>--parallel-frontierはhostへ並列dispatch方針を宣言する開始gateです。Lattice自身がAI hostのagentを
起動するものではなく、実際のdispatchはhostが行います。宣言後もready全件が着手されたかは
active_setとnext_readyで観測できます。
ToDo完了は軽量確認までで、所属ToDoが全てdoneになったPhaseはgate_readyとなり、todo phase review後に
required evidenceを束縛したtodo phase acceptで重監査の判断を記録します。監査回数やPhase数を自動追加する
機能ではありません。Phase状態は
lattice todo phase status --plan <key>、閲覧中に進捗が更新される工程表は
lattice todo gantt serve --port 0で確認できます。live viewerはloopback-only、read-onlyで、
/projects/<project_id>/というproject固有URLを返します。別projectからそれぞれ起動すれば、独立port・独立SSE経路で同時表示できます。
静的工程表はlattice todo gantt statusでcurrent / stale / missingを確認でき、HTMLまたは
digest付きsidecarの欠落・改ざんはtyped failureになります。
状態を書き込むstart / block / unblock / done / evidence promote / reopen / revise / revise-phase / revise-set
では、監査actorとして次の3環境変数をすべて設定してください。
export LATTICE_TODO_ACTOR_HOST=<host-id>
export LATTICE_TODO_ACTOR_SESSION=<session-id>
export LATTICE_TODO_ACTOR_AGENT=<agent-id>不足またはidentifierとして不正な値がある場合、mutationはstoreを変更せずACTOR_UNRESOLVEDを返します。
error detailのmissing_environment／invalid_environmentと
next_action: set_required_actor_environment_and_retryを確認し、正規値を設定して同じ操作を再試行してください。
正確なargv、evidence descriptor、result wireは ADR 0056を参照してください。