Skip to content

Commit 554d88d

Browse files
committed
docs: DS-11/12 adapter-boundary sprint complete; three-adapter brake holds; supervisor stopped
1 parent a44bc0d commit 554d88d

1 file changed

Lines changed: 35 additions & 45 deletions

File tree

HANDOFF.md

Lines changed: 35 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -3,51 +3,41 @@
33
Last Updated: 2026-06-14
44

55
## Current Status
6-
DS-11b IMPLEMENTED, UNSTAGED (2026-06-14, branch
7-
`codex/ds11b-jsonl-adapter`): Agent Report Protocol v0 +
8-
AgentReportJsonlAdapter + board merge.
9-
10-
What changed:
11-
- Added neutral wire protocol models in
12-
`src/conductor/protocols/agent_report_v0.py`.
13-
- Added `src/conductor/adapters/agent_report_jsonl.py` with local JSONL
14-
transport, config loading, offset checkpoint, rotation reset, event_id
15-
dedupe, bad-line/unknown-schema diagnostics, upsert/resolve state, persisted
16-
current state, heartbeat TTL downgrade, canonical `ConductorEvent` output,
17-
and read-only capabilities (`can_poll=True`, `can_send_response=False`).
18-
- Wired JSONL-reported sessions into `/api/overview.windows` and JSONL
19-
attention requests into `/api/decisions` via canonical `AttentionRequest`;
20-
JSONL does not imitate Orbit vault IDs or legacy `source_path` /
21-
`context_link` shape.
22-
- Added config/scaffold paths for `.conductor/agent-report/events.jsonl` and
23-
`.conductor/agent-report/checkpoint.json`.
24-
- Added `docs/reference/agent-report-protocol-v0.md` and repository-only
25-
`/conductor-report` skill template at `docs/skills/conductor-report/SKILL.md`.
26-
27-
Verification:
28-
- RED: focused DS-11b test failed on missing protocol/adapter/board merge.
29-
- RED: rotation assertion failed before the transport reset fix.
30-
- Focused GREEN:
31-
`/opt/homebrew/bin/python3 -m pytest -q tests/test_agent_report_jsonl_adapter.py tests/test_source_adapters.py tests/test_decision_api.py tests/test_init.py`
32-
-> 77 passed.
33-
- Full suite:
34-
`/opt/homebrew/bin/python3 -m pytest -q` -> 596 passed.
35-
- Full suite using documented `.venv/bin/python` with local dependency cache:
36-
`PYTHONPATH=/Users/caoyuqi/miniconda3-clean-20260428-161522/lib/python3.13/site-packages:. .venv/bin/python -m pytest -q`
37-
-> 596 passed.
38-
- `.venv/bin/conductor verify .` -> passed.
39-
- `.venv/bin/conductor verify --json . | .venv/bin/python -m json.tool` ->
40-
parsed.
41-
- `git diff --check` -> passed.
42-
43-
Known verification caveat: `.venv/bin/python -m pytest -q` without the local
44-
dependency `PYTHONPATH` fails at collection because this `.venv` lacks
45-
`pydantic`. No environment mutation was made.
46-
47-
Next: supervisor review + real smoke owned by supervisor per task card
48-
(non-tmux writer appends JSONL -> board session visible; attention upsert then
49-
resolve appears in Open/Resolved). Then Claude/Sonnet review gate or approved
50-
supervisor-only fallback if Claude is unavailable. Work remains unstaged.
6+
DS-11/12 ADAPTER-BOUNDARY SPRINT COMPLETE (2026-06-14): all four milestones
7+
merged to main; supervisor stopped per the sprint contract.
8+
9+
Sprint results (docs/plans/2026-06-14-ds11-12-adapter-boundary-plan.md):
10+
- DS-11a-1 (`6aa617e`): canonical model + ADR-0007 + dead-module cleanup.
11+
- DS-11a-2 (`79da79f`): orbit/tmux as adapters, UI eats canonical, zero
12+
behavior change. PGE-gated (code+regression+architect).
13+
- DS-12 (`b6d50f5`): canonical AgeInfo + Open/Stale/Unknown age/Resolved
14+
zones. [plan-补丁 awaiting orbit ratification: basis→zone mapping].
15+
- DS-11b (`0d45a0e`, merge `a44bc0d`): AgentReportJsonlAdapter + Agent
16+
Report Protocol v0 — the third adapter. PGE-gated (security+code+python
17+
+architect), 3 fix rounds (untrusted-input hardening F1-F11 + graceful
18+
disable on path-escape).
19+
20+
THREE-ADAPTER BRAKE: PASSES. architect confirmed tmux/orbit/jsonl all flow
21+
through one canonical ConductorEvent; jsonl needed no special shape and did
22+
not imitate orbit; the DS-11a-2 classifier coupling is dissolved to a
23+
neutral age_info path. The abstraction holds — per GPT review the boundary
24+
is real, not over-engineered.
25+
26+
Final state: 608 tests pass; conductor verify . passes; real smoke covers
27+
non-tmux jsonl session in the live view + attention upsert/resolve +
28+
untrusted-input stability (naive ts / oversize / path traversal / bad
29+
lines) + security headers.
30+
31+
Open items:
32+
1. Push: main ahead of origin by 12. Say "push" literally.
33+
2. [plan-补丁] DS-12 basis→zone mapping awaits orbit-window ratification.
34+
3. /conductor-report skill (docs/skills/conductor-report/SKILL.md) install
35+
into ~/.claude/skills is a supervisor/user step (not done by the worker).
36+
4. 中枢窗 registration (user option A, pending the tmux move).
37+
5. Deferred (future, not scheduled): a writeback-capable 4th adapter would
38+
still need the /api/decide source-branch generalized (architect note;
39+
jsonl is read-only so unaffected now).
40+
5141

5242
DS-12 MERGED (2026-06-14, `b6d50f5`, merge `3f61512`): canonical AgeInfo +
5343
UI four zones Open/Stale/Unknown age/Resolved.

0 commit comments

Comments
 (0)