Files
multica/server/cmd
Bohan Jiang 766c7a7fa2 refactor(daemon): retreat deep read semantics to --help, trim BTS prose (MUL-5442) (#6347)
* feat(cli): carry the comment-read contract in comment list --help (MUL-5442)

The --recent flag help gains the MUL-5372 saturation semantics (N caps
threads, not comments; every thread returns uncapped; small issues return
the whole history) and a pointer at the bounded alternative. The --before
help names the stderr cursor labels alongside the response header.

This is the relocation target for the brief's deep read semantics: the
contract follows the flag, and TestIssueCommentListHelpCarriesReadContract
pins it here so the brief-side pointer cannot dangle.

Co-authored-by: multica-agent <github@multica.ai>

* refactor(daemon): retreat deep read semantics to --help and trim BTS prose (MUL-5442)

Unblocked by #6309: the platform no longer recommends --recent anywhere, so
the flag's deep semantics no longer need to ride in every brief.

- Available Commands comment-list entry: keep the signature, the two bounded
  read shapes, and the one-clause saturation warning; per-thread cap detail,
  folding rules, and cursor labels retreat to --help (pinned there by
  TestIssueCommentListHelpCarriesReadContract).
- Workflow step 3: drop the worked examples and the redundant trailing
  pointer; the mandatory two-step read and both motivation pins stay.
- Background Task Safety: tighten connective prose only — every pinned
  phrase and every behavioural constraint is untouched.
- multica-squads SKILL.md quick-start: replace the last remaining --recent
  recommendation on the platform with the bounded scan — same class of fix
  as #6309, found while relocating the warning.

-676 bytes on the standard fixture (16,766 -> 16,090).

Co-authored-by: multica-agent <github@multica.ai>

* fix(cli,daemon): repair the help rendering, restore the BTS orphan scope, complete the squads read (MUL-5442)

Three review catches by Elon on #6347:

1. The --before usage string wrapped the cursor labels in backticks, and
   pflag's UnquoteUsage hijacked the first pair as the flag's value
   placeholder — rendered help showed '--before Next thread cursor' instead
   of '--before string' (same regression class as
   TestLoginTokenHelpOutputRendersCleanly). Labels now use double quotes,
   and the --recent help no longer suggests composing mutually exclusive
   flags ('--roots-only + --thread --tail' -> an explicit two-step read).
   TestIssueCommentListHelpCarriesReadContract now asserts on the RENDERED
   FlagUsages output, pinning '--before string' and the two-step order.

2. The compressed BTS opening said 'anything still running is orphaned',
   which swept externally-owned work (GitHub Actions) into the orphan rule
   the same section later scopes out. Restored: 'any run-owned work still
   active is orphaned', pinned.

3. The squads quick-start's roots-only scan never returns reply bodies,
   where mention triggers and failure reasons usually live. Added the
   bounded drill-down step and the sequence rationale; both reads pinned in
   TestSquadsSkillCoversLeaderRoutingContract, which also guards against a
   regression back to --recent.

Co-authored-by: multica-agent <github@multica.ai>

---------

Co-authored-by: Bohan-J <bohan@devv.ai>
Co-authored-by: multica-agent <github@multica.ai>
2026-08-04 14:22:51 +08:00
..