docs: plan stage c iterative receive loop

This commit is contained in:
zhaoyilun
2026-07-09 22:46:16 +08:00
parent 1eed0f62f2
commit de3bb922da
3 changed files with 499 additions and 35 deletions

View File

@@ -47,24 +47,29 @@ N13/N14/N15 are pre-business validation results. They can help identify UI eleme
## Current loop
Current loop: `Stage B1 - source discovery from N12-pre zyl package`.
Current loop: `Stage C / Loop C1 - log decryptor and PacketReader parser`.
Plan file: `docs/superpowers/plans/2026-07-09-mcp-core-source-discovery-loop.md`.
Plan file: `docs/superpowers/plans/2026-07-09-stage-c-log-backed-receive-messages-loop.md`.
Loop output:
Loop rule:
1. Evidence index for downloaded `zyl.rar` package.
2. Capability-source matrix for the four read tools:
- `isphere_search_contacts`
- `isphere_search_groups`
- `isphere_receive_messages`
- `isphere_receive_files`
3. Selected first Stage C implementation slice.
1. Write or update the plan before coding.
2. Implement one loop only.
3. Verify, commit exact paths, then update the next loop based on actual results.
4. Continue automatically while the next step is clear; ask the user only when blocked or when business direction changes.
Current loop output:
1. `internal/isphere/logcodec.DecryptLine` for DES/CBC/PKCS7 Base64 log lines.
2. `internal/isphere/packetlog.ParseMessageLog` for redacted `PacketReader.ProcessPacket` XMPP `<message>` stanzas.
3. Passing unit tests with synthetic/redacted fixtures only.
4. Updated Loop C2 plan before source abstraction starts.
## Next business mainline
1. Complete Stage B1 evidence index and capability-source matrix.
2. Open Stage C with `isphere_receive_messages` as the first likely slice if evidence supports it.
3. Add contact/group/file read tools after their source decisions are recorded.
4. Add `isphere_send_message` and `isphere_send_file` after source discovery and connector selection.
5. Keep UIA selector/report work as fallback support, not as the primary roadmap.
1. Complete Stage C Loop C1: log decryptor + PacketReader parser.
2. Rewrite and execute Loop C2: log-backed `ReceiveMessages` source abstraction.
3. Register `isphere_receive_messages` only after parser/source tests pass.
4. Add contact/group/file read tools after their source decisions are recorded.
5. Add `isphere_send_message` and `isphere_send_file` after source discovery and connector selection.
6. Keep UIA selector/report work as fallback support, not as the primary roadmap.