project-loop-harness 0.3.1__tar.gz → 0.4.0__tar.gz

{project_loop_harness-0.3.1/src/project_loop_harness.egg-info → project_loop_harness-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: project-loop-harness
-Version: 0.3.1
+Version: 0.4.0
 Summary: Local control plane for agentic project development loops
 Author: Project Loop Harness Contributors
 License: MIT
@@ -28,6 +28,8 @@ Requires-Dist: pytest>=8; extra == "dev"
 Requires-Dist: ruff>=0.6; extra == "dev"
 Requires-Dist: setuptools>=69; extra == "dev"
 Requires-Dist: wheel; extra == "dev"
+Provides-Extra: mcp-test
+Requires-Dist: mcp==1.28.1; extra == "mcp-test"
 Dynamic: license-file
 
 # Project Loop Harness
@@ -95,7 +97,7 @@ The important separation is:
 Skill          = instructions for agents
 pcl CLI        = runtime that mutates state, validates, renders, and routes work
 project.db     = current normalized loop memory
-events.jsonl   = append-only audit log
+events.jsonl   = derived append-only projection of authoritative SQLite events
 dashboard.html = generated human-readable view, not agent context
 Plugin         = Codex distribution wrapper
 MCP            = optional read/local-render bridge
@@ -204,7 +206,7 @@ path is:
 
 ```bash
 pcl workflow verify --root /tmp/pcl-demo --template executor_smoke
-pcl workflow sandbox --root /tmp/pcl-demo --template executor_smoke --json
+pcl workflow guard --root /tmp/pcl-demo --template executor_smoke --json
 pcl loop execute --root /tmp/pcl-demo executor_smoke --json
 ```
 
@@ -480,7 +482,7 @@ The current local runtime supports:
 - complete CSV export for reviewable loop state;
 - optional local stdio MCP server;
 - Codex plugin packaging scaffold with package inventory and reusable GitHub Action for local validation;
-- workflow proposal mode, guarded human approval, static verifier checks, limited sandbox planning/execution, guarded automatic workflow execution with explicit retry/resume, and a bundled `executor_smoke` workflow for dogfooding the executor.
+- workflow proposal mode, guarded human approval, static verifier checks, guarded host-process planning/execution, guarded automatic workflow execution with explicit retry/resume, and a bundled `executor_smoke` workflow for dogfooding the executor.
 
 ## Implementation Task Order
 

{project_loop_harness-0.3.1 → project_loop_harness-0.4.0}/README.md

@@ -63,7 +63,7 @@ The important separation is:
 Skill          = instructions for agents
 pcl CLI        = runtime that mutates state, validates, renders, and routes work
 project.db     = current normalized loop memory
-events.jsonl   = append-only audit log
+events.jsonl   = derived append-only projection of authoritative SQLite events
 dashboard.html = generated human-readable view, not agent context
 Plugin         = Codex distribution wrapper
 MCP            = optional read/local-render bridge
@@ -172,7 +172,7 @@ path is:
 
 ```bash
 pcl workflow verify --root /tmp/pcl-demo --template executor_smoke
-pcl workflow sandbox --root /tmp/pcl-demo --template executor_smoke --json
+pcl workflow guard --root /tmp/pcl-demo --template executor_smoke --json
 pcl loop execute --root /tmp/pcl-demo executor_smoke --json
 ```
 
@@ -448,7 +448,7 @@ The current local runtime supports:
 - complete CSV export for reviewable loop state;
 - optional local stdio MCP server;
 - Codex plugin packaging scaffold with package inventory and reusable GitHub Action for local validation;
-- workflow proposal mode, guarded human approval, static verifier checks, limited sandbox planning/execution, guarded automatic workflow execution with explicit retry/resume, and a bundled `executor_smoke` workflow for dogfooding the executor.
+- workflow proposal mode, guarded human approval, static verifier checks, guarded host-process planning/execution, guarded automatic workflow execution with explicit retry/resume, and a bundled `executor_smoke` workflow for dogfooding the executor.
 
 ## Implementation Task Order
 

project_loop_harness-0.4.0/agent-tasks/0123-master-trace-intent-index-contract.md

@@ -0,0 +1,94 @@
+# 0123: Master Trace / Intent Index v0 contract formalization
+
+Milestone: v0.3.2 Master Trace / Intent Index
+Priority: P1
+Area: docs/contracts/handoff
+Origin: M0 master-trace dogfood, `docs/growth-plan-v0.2.4-v0.5.md`, and
+2026-07-09 AI-PLC upstream-design intake discussion. Sakamoto approved moving
+ahead after migrating the local control-plane DB to schema 7.
+
+## Problem
+
+Project Loop Harness already has a working M0 pull-context handoff runbook:
+the master transcript is copied as evidence, an external agent creates an
+intent index over that transcript, and the worker starts from `pcl next` plus a
+task context pack. That flow proved useful, but the contract is still
+runbook-shaped rather than product-shaped.
+
+The AI-PLC proposal adds a larger upstream layer: collection, intent, option
+generation, replan, maker/checker separation, and knowledge propagation. PLH
+should not import that as slash commands or Markdown state. The first safe
+translation is narrower: formalize master traces and intent indexes as
+evidence-backed, claims-not-facts handoff contracts that can later support
+first-class `pcl intent` / `pcl option` work if dogfood proves the shape.
+
+## Scope
+
+Docs/contract first. No schema migration and no new state-changing CLI command
+in this slice.
+
+1. Add a contract document, preferably `docs/master-trace-intent-index.md`,
+   covering:
+   - `master-trace/v0`: a transcript or trace artifact recorded as copied
+     evidence, with stable line references after indexing.
+   - `intent-index/v0`: a model-derived JSON index whose items are pointers into
+     the master trace, not verified facts.
+   - `master-trace-context/v0`: the future context-pack section shape, listing
+     evidence ids, manifest/member paths, copied stored paths, and source-ref
+     discipline without inlining raw transcript contents.
+2. Update `docs/master-trace-handoff.md` so M0 is clearly a historical dogfood
+   runbook and points to the new contract for future runs.
+3. Document the recommended current command sequence using existing surfaces:
+   `pcl evidence add --copy`, `pcl evidence add --task T-XXXX --copy`,
+   `pcl context check`, and `pcl context pack --task ...`.
+4. Define the precise trust model:
+   - the intent index is model output and must be treated as claims, not facts;
+   - a worker must verify every actionable item against copied trace lines before
+     acting;
+   - PLH records evidence and links, but does not claim the index is correct,
+     complete, safe, or semantically sufficient.
+5. Add an explicit "future promotion gates" section:
+   - optional `master_trace_context` in `context-pack/v1` is a follow-up only
+     after this contract is accepted;
+   - first-class `pcl intent` / `pcl collect` requires separate design and human
+     approval because it adds product semantics and likely schema;
+   - `pcl option`, `pcl replan`, and knowledge ledger are later phases, not part
+     of v0.3.2.
+
+## Invariants
+
+- No LLM call in `pcl` core. External agents may produce an intent index; PLH
+  stores and routes the artifact as evidence.
+- No new source of truth. SQLite + JSONL events remain authoritative; Markdown
+  docs and future wiki exports are review surfaces.
+- No raw transcript inline in context packs or dashboard data. Use evidence ids,
+  manifest paths, member paths, and copied `stored_path` references.
+- No cognition or go/no-go vocabulary: avoid `safe_to_continue`,
+  `verified_relevant`, `agent_read`, `ready_for_handoff`, or similar claims.
+- Existing `linked_evidence` task-pack behavior remains unchanged in this slice.
+- Do not add `pcl intent`, `pcl collect`, `pcl option`, `pcl replan`, or
+  `pcl knowledge` commands in this task.
+
+## Non-scope
+
+- Schema changes or migrations.
+- `pcl evidence link` / arbitrary link-role CLI.
+- Context-pack implementation of `master_trace_context`.
+- Dynamic workflow generation.
+- Hosted backend, telemetry, cloud sync, or plugin marketplace work.
+- Automatic GitHub writes or any external-service dependency.
+
+## Acceptance
+
+- The new contract doc defines valid `master-trace/v0`, `intent-index/v0`, and
+  future `master-trace-context/v0` payload examples.
+- `docs/master-trace-handoff.md` points future readers to the contract while
+  preserving the M0 evidence/runbook history.
+- The current command sequence is executable with existing commands and does not
+  require direct DB edits or generated dashboard parsing.
+- The docs state that intent-index items are navigation pointers, not verified
+  facts, and that workers must verify source refs against copied trace lines.
+- The docs explicitly defer first-class `pcl intent` / `pcl option` / `pcl
+  replan` / knowledge ledger work to later roadmap phases.
+- `ruff check .` and full `pytest` remain green unless the orchestrator marks
+  the task docs-only and records why test execution was intentionally skipped.

project_loop_harness-0.4.0/agent-tasks/0124-baseline-fixtures-v0-3-1.md

@@ -0,0 +1,90 @@
+# 0124: Freeze the v0.3.1 implementation baseline (fixtures + baseline doc)
+
+- **Status:** Accepted
+- **Milestone:** M0 / v0.3.1 baseline (integrated roadmap Wave A)
+- **Priority:** P0
+- **Estimated size:** S
+- **Dependencies:** None
+- **Origin:** `docs/roadmap/integrated/agent-tasks-proposed/0123-release-v0-3-1-baseline.md`,
+  reduced in scope because v0.3.1 was already released before the bundle was
+  adopted (commits `eb69824` → `73f2290`, pyproject `0.3.1`, tag `v0.3.1`).
+  Only the baseline-freezing portion of that proposal remains.
+
+## Problem
+
+v0.3.1 は既に出荷済みだが、統合ロードマップ Wave A（MCP 仕様準拠化、
+transactional outbox）は挙動を意図的に変更する。比較基準となる snapshot
+fixture と baseline document がないと、後続タスクで意図した差分と回帰を
+区別できない。
+
+## Goal
+
+現在の挙動を「正しい」と無条件に認定するのではなく、再現可能な baseline
+として固定し、後続タスクが差分と互換性を測れる状態にする。リリース作業は
+行わない（済んでいる）。
+
+## Scope
+
+1. `pcl --help` と主要 subcommand help、主要 `--json` 出力の snapshot fixture
+   を保存する。最低限の対象: `pcl --version`, `pcl --help`,
+   `pcl validate --strict --json`, `pcl render --json`, `pcl next --json`,
+   `pcl context check --json`（空 project と代表 fixture project の両方）。
+2. snapshot は timestamp、absolute path、UUID、hash 等の不安定値を normalizer
+   で除外し、2 回連続生成して diff ゼロであることをテストで保証する。
+3. 代表的な fixture DB（v0.3.0 相当 schema）から現行 schema へ migrate する
+   smoke test を追加する。fixture DB に個人情報や実 project content を
+   入れない。
+4. `docs/releases/v0.3.1-baseline.md` を作成し、baseline commit SHA、schema
+   version、migration list、supported Python versions、known limitations、
+   実行した test commands を記録する。
+5. 後続 schema contract test が参照する fixture directory を 1 つに決めて
+   fixture 配置の README に明記する。
+
+## Invariants
+
+- 既存 runtime behavior をこのタスクで変更しない（fixture とテストの追加のみ）。
+- 既存テストを削除・弱体化しない。
+- fixture に機密・個人情報・実 project 内容を含めない。
+- 生成された snapshot を手で編集しない（不安定値は normalizer で対処する）。
+- `.project-loop/` 配下（canonical repo の dogfood 状態）を変更しない。
+
+## Non-goals
+
+- リリース作業、version bump、PyPI 公開（v0.3.1 は出荷済み）。
+- MCP framing 修正（0125）。
+- event outbox 実装（0128）。
+- README 再構成。
+
+## Acceptance criteria
+
+- Snapshot fixture 生成を 2 回実行して diff が空であることをテストが保証する。
+- 代表 fixture DB からの migration smoke がローカルで成功する。
+- `docs/releases/v0.3.1-baseline.md` に commit SHA、schema version、known
+  limitations、実行した test command と exit code が記録されている。
+- `ruff check .` と full `pytest` が green。
+- `pcl init /tmp/pcl-demo` smoke が成功する。
+
+## Evidence required to close
+
+- test command と exit code。
+- baseline commit SHA。
+- snapshot fixture の 2 回生成 diff が空である証拠。
+
+## Agent execution protocol
+
+実装担当エージェントは開始前に次を返す。
+
+1. 対象 commit SHA。
+2. 変更予定 path。
+3. 既存 contract を characterize する test または確認結果。
+4. scope 外に見える問題と、今回は触れない理由。
+
+完了時は次を返す。
+
+1. 変更概要と設計判断。
+2. 実行した全 test command、exit code、失敗・skip。
+3. schema/migration/CLI 互換性への影響。
+4. 未確認事項、残存 risk、rollback 方法。
+5. Acceptance criteria を一項目ずつ満たした根拠。
+
+「実装した」「テストは通るはず」だけでは close しない。

project_loop_harness-0.4.0/agent-tasks/0125-mcp-stdio-framing-negotiation.md

@@ -0,0 +1,109 @@
+# 0125: Make MCP stdio transport and protocol negotiation specification-compliant
+
+- **Status:** Proposed
+- **Milestone:** M1 / Trust Foundation
+- **Priority:** P0
+- **Estimated size:** M
+- **Dependencies:** `0124`
+- **Owner:** TBD
+- **Reviewer:** At least one maintainer not implementing the task
+
+## Problem
+
+現行serverはMCP 2025-06-18を宣言しながらstdioで`Content-Length` framingを使い、initializeで要求されたprotocol versionを対応可否に関係なく返す。自己実装clientとのtestだけでは外部相互運用性を保証できない。
+
+## Goal
+
+MCP stdioを宣言versionの仕様へ合わせ、unsupported versionを正しくnegotiateし、stdoutを純粋なprotocol channelにする。
+
+## Scope
+
+- stdio reader/writerを1 JSON-RPC message per lineへ変更する。
+- message内改行、size limit、invalid JSON、empty line、EOFを明示処理する。
+- supported protocol versionsを定数またはordered setで管理する。
+- client requested versionがunsupportedならserver supported versionを返す。
+- notification、request、responseのID semanticsを既存behaviorと照合する。
+- protocol以外のlog/diagnosticをstderrへ送る。
+- 既存Content-Length fixture/clientを更新または明示的にlegacy扱いする。
+
+## Proposed implementation
+
+- transport parserとMCP method dispatchを分離し、framing testをprocess boundaryで行えるようにする。
+- newline-delimited outputはcompact JSONを使い、payload自身にliteral newlineを出さない。
+- line length上限を設定し、超過時はprotocol errorまたはsafe terminationにする。
+- initialize前に許可されるmethod、initialize後のstate transitionをcharacterizeする。
+- legacy modeを残す場合はhidden/experimental opt-inとし、defaultにしない。
+
+## Likely affected surfaces
+
+- `src/pcl/mcp_server.py`
+- MCP process/transport tests
+- MCP documentation and help
+- any internal MCP client fixture
+
+## Invariants
+
+- runtime dependencyを不要に増やさない。
+- stdoutにbanner、logging、tracebackを混ぜない。
+- unsupported versionをechoしない。
+- MCP修正でPLH core state semanticsを変えない。
+
+## Non-goals
+
+- 新しいMCP toolの追加。
+- remote HTTP transport。
+- agent runtime固有adapter。
+- outbox/recovery変更。
+
+## Acceptance criteria
+
+- Given newline-delimited initialize request, when server reads stdin, then 1行のJSON-RPC responseをstdoutへ返す。
+- Given unsupported requested version, when initialize runs, then serverがsupportするversionを返し、requested versionを無条件にechoしない。
+- Given malformed/oversized line, when processed, then protocol channelを壊さずdocumented errorまたはterminationになる。
+- Given normal session, when stderr logging is enabled, then stdoutの各non-empty lineがvalid JSON-RPC messageである。
+
+## Required tests
+
+- Transport unit tests for LF/CRLF, EOF, malformed JSON, oversized line.
+- Process-level initialize → tools/list → tools/call test.
+- Version negotiation matrix.
+- stdout purity test.
+- Regression test for notifications without response ID.
+
+## Evidence required to close
+
+- official spec sections used。
+- before/after wire transcript。
+- process-level test output。
+- compatibility behavior documented。
+
+## Rollout and rollback
+
+- MCPをexperimental表示している場合は修正後も実client test完了まで維持。
+- breaking legacy framingはrelease noteで明示。
+- rollbackはlegacy flagではなくprevious package versionで可能にする。
+
+## Open questions
+
+- 複数protocol versionを同時supportするか、current oneのみか。
+- legacy Content-Length modeを一releaseだけ残す価値があるか。
+
+## Agent execution protocol
+
+実装担当エージェントは開始前に次を返す。
+
+1. 対象commit SHAと、依存taskがmerge済みである証拠。
+2. 変更予定path。
+3. 既存contractをcharacterizeするtestまたは確認結果。
+4. scope外に見える問題と、今回は触れない理由。
+
+完了時は次を返す。
+
+1. 変更概要と設計判断。
+2. 実行した全test command、exit code、失敗・skip。
+3. schema/migration/CLI互換性への影響。
+4. 生成したEvidenceまたはpacket refs。
+5. 未確認事項、残存risk、rollback方法。
+6. Acceptance criteriaを一項目ずつ満たした根拠。
+
+「実装した」「テストは通るはず」「レビュー済み」という主張だけではcloseしない。

project_loop_harness-0.4.0/agent-tasks/0126-mcp-external-conformance.md

@@ -0,0 +1,105 @@
+# 0126: Add MCP external conformance fixtures and compatibility matrix
+
+- **Status:** Proposed
+- **Milestone:** M1 / Trust Foundation
+- **Priority:** P0
+- **Estimated size:** M
+- **Dependencies:** `0125`
+- **Owner:** TBD
+- **Reviewer:** At least one maintainer not implementing the task
+
+## Problem
+
+内部unit testだけでは外部clientとの接続、process lifecycle、stdout discipline、tool schema互換性の問題を見逃す。相互運用性を製品価値にするには、実clientまたは標準準拠fixtureで継続確認が必要。
+
+## Goal
+
+MCPのsupported surfaceをprocess-levelに検証し、どのclient/versionを確認済みかを公開できるcompatibility matrixを作る。
+
+## Scope
+
+- 独立したJSON-RPC/MCP conformance client fixtureをtest用に用意する。
+- initialize、initialized notification、tools/list、代表的read-only tools/call、shutdown/EOFを検査する。
+- 少なくとも1つの公式SDKまたは外部標準準拠clientをdev/test-onlyで利用する検討を行う。
+- Claude Code、Codex等の対象client向けmanual smoke手順を文書化する。
+- client name、version、OS、result、known limitationをcompatibility matrixへ記録する。
+- protocol schema errorとPLH domain errorを区別する。
+
+## Proposed implementation
+
+- runtime dependencyではなくtest extraまたはsubprocess fixtureを優先する。
+- external client versionをpinし、更新はDependabot等の通常review対象にする。
+- CIでcredentialやGUIを必要とするclient smokeは必須にせず、再現可能なmanual evidence pathを持つ。
+- wire transcriptからproject path、secret、user contentをredactする。
+
+## Likely affected surfaces
+
+- `tests/mcp/`
+- CI workflow
+- `docs/mcp-compatibility.md`
+- test extras / lock metadata
+
+## Invariants
+
+- 内部clientだけを「external conformance」と呼ばない。
+- 未確認clientをsupportedと記載しない。
+- test用SDKをruntime dependencyへ漏らさない。
+
+## Non-goals
+
+- すべてのMCP clientのsupport。
+- HTTP/SSE transport。
+- MCP tool inventory拡張。
+
+## Acceptance criteria
+
+- Conformance fixtureがserver subprocessを起動し、initializeからtools/callまで成功する。
+- Invalid params、unknown method、pre-initialize callのexpected errorがfixtureで固定される。
+- Compatibility matrixにtested date、client version、platform、resultがある。
+- CIがprotocol regressionを検出し、external/manual smoke手順が第三者に再現可能。
+
+## Required tests
+
+- Independent process client test.
+- Official SDK/client test where feasible.
+- Protocol negative matrix.
+- Windows path/stdin handling smoke.
+- No stdout contamination under debug logging.
+
+## Evidence required to close
+
+- wire transcript fixture。
+- CI run link/id。
+- manual client smoke record。
+- compatibility matrix diff。
+
+## Rollout and rollback
+
+- 初期matrixは少数clientでよい。
+- 新clientをsupportedにする前に同じfixtureを追加。
+- failureはknown limitationとして公開し、隠さない。
+
+## Open questions
+
+- CIへofficial SDKを入れるlicense/maintenance cost。
+- 対象clientの最低version。
+
+## Agent execution protocol
+
+実装担当エージェントは開始前に次を返す。
+
+1. 対象commit SHAと、依存taskがmerge済みである証拠。
+2. 変更予定path。
+3. 既存contractをcharacterizeするtestまたは確認結果。
+4. scope外に見える問題と、今回は触れない理由。
+
+完了時は次を返す。
+
+1. 変更概要と設計判断。
+2. 実行した全test command、exit code、失敗・skip。
+3. schema/migration/CLI互換性への影響。
+4. 生成したEvidenceまたはpacket refs。
+5. 未確認事項、残存risk、rollback方法。
+6. Acceptance criteriaを一項目ずつ満たした根拠。
+
+「実装した」「テストは通るはず」「レビュー済み」という主張だけではcloseしない。

project_loop_harness-0.4.0/agent-tasks/0127-transactional-audit-outbox-design.md

@@ -0,0 +1,105 @@
+# 0127: Finalize transactional audit outbox ADR and failure model
+
+- **Status:** Proposed
+- **Milestone:** M1 / Trust Foundation
+- **Priority:** P0
+- **Estimated size:** M
+- **Dependencies:** `0124`
+- **Owner:** TBD
+- **Reviewer:** At least one maintainer not implementing the task
+
+## Problem
+
+SQLite state、event row、JSONL、Evidence fileが複数stepで更新されるため、どの時点をcommitとみなすかが曖昧。実装前にsource of truth、failure semantics、legacy migration、repair保証を決める必要がある。
+
+## Goal
+
+ADR-002を実装可能な詳細へ完成させ、0128〜0129のacceptanceを固定する。
+
+## Scope
+
+- 現行mutation pathを列挙し、state/event/JSONL/Evidenceのwrite orderを図示する。
+- failure pointをcommit前、commit後、projector前後、file rename前後に分類する。
+- SQLiteとJSONLの権威、rebuild direction、retentionを決める。
+- outbox schema、event sequence、idempotency key、retry/backoff、poison record処理を決める。
+- legacy events.jsonlと既存events tableを対応付ける移行案を決める。
+- hash chainをproduct guaranteeに含めるか決める。
+- concurrency、migration lock、busy timeoutの契約を明文化する。
+
+## Proposed implementation
+
+- 実コードの全`append_event` callerとcommit ownershipを調査する。
+- 「DB commit済みだがJSONL pending」はvalid recoverable stateとして定義する。
+- 「JSONLにあるがDBにない」legacy anomalyの扱いを明示する。
+- Evidence content-addressed stagingはoutboxと同じtransactionでは完全原子化できないため、PENDING/READY reconciliationを設計する。
+- operational commandsとexit codeを先に設計する。
+
+## Likely affected surfaces
+
+- `docs/adr/ADR-002-transactional-audit-outbox.md`
+- `src/pcl/events.py` caller inventory
+- `src/pcl/evidence.py` write path
+- migration/recovery docs
+
+## Invariants
+
+- 設計taskでproduction behaviorを変えない。
+- 「append-only」と「tamper-evident」を混同しない。
+- repair不能なcaseを自動修復できると書かない。
+
+## Non-goals
+
+- outbox code実装。
+- CLI repair実装。
+- cloud replication。
+
+## Acceptance criteria
+
+- ADRにsource of truth、transaction boundary、state machine、failure matrix、legacy plan、rollbackがある。
+- 全mutation pathがinventory化され、未調査callerがない。
+- 0127と0128のschema/CLI acceptanceがADRから導ける。
+- Maintainerと少なくとも1名のreviewerがAcceptedまたは明示的な修正要求を記録する。
+
+## Required tests
+
+- No runtime tests required; validate design with executable pseudo-tests or sequence diagrams.
+- Prototype SQL transaction/outbox query if needed.
+- Review existing fixture DB and JSONL anomaly examples.
+
+## Evidence required to close
+
+- caller inventory。
+- failure matrix。
+- ADR decision log。
+- prototype output。
+
+## Rollout and rollback
+
+- Accepted ADRをmerge gateにする。
+- 未決のhash chain等はexplicit deferred decisionにする。
+
+## Open questions
+
+- JSONLからDB完全rebuildをv1で保証するか。
+- event hash chainを今入れるか。
+- projectorを同期flushとbackground retryのどちらで起動するか。
+
+## Agent execution protocol
+
+実装担当エージェントは開始前に次を返す。
+
+1. 対象commit SHAと、依存taskがmerge済みである証拠。
+2. 変更予定path。
+3. 既存contractをcharacterizeするtestまたは確認結果。
+4. scope外に見える問題と、今回は触れない理由。
+
+完了時は次を返す。
+
+1. 変更概要と設計判断。
+2. 実行した全test command、exit code、失敗・skip。
+3. schema/migration/CLI互換性への影響。
+4. 生成したEvidenceまたはpacket refs。
+5. 未確認事項、残存risk、rollback方法。
+6. Acceptance criteriaを一項目ずつ満たした根拠。
+
+「実装した」「テストは通るはず」「レビュー済み」という主張だけではcloseしない。