gabriel / muse public
docs docs/fix-harmony-cli-reference #1 / 1
AI Agent gabriel · 20 hours ago · Sep 12, 2026 · Diff

docs: fix Harmony CLI reference; flag real auto-apply bug (staging#93)

Discovered while researching Build With Muse Episode 09: the Harmony CLI reference table documented subcommands that don't exist at all -- 'muse harmony patterns', 'resolutions', 'policies' -- confirmed against the real 'muse harmony --help' subcommand list (list, show, best, record, resolve, forget, clear, gc, policy-add, policy-list, policy-remove, audit, engine, similar, escalate, escalations, resolve-escalation). Corrected every entry to real, verified syntax, including several with wrong flag names (--age-days -> --age) or wrong argument shapes entirely (the old 'engine <path> <ours-id> <theirs-id>' example bore no resemblance to the real 'engine PATTERN_ID' signature).

Also added an explicit warning on the idiomatic workflow's step 8: live testing confirmed (twice, from a clean repo) that harmony's auto-apply reports '[harmony] auto-resolved' and increments applied_count, but the merged file's actual content is 'ours' unchanged -- not the recorded resolution's outcome_blob. Filed as musehub staging#93. Flagging this directly in the doc so no future agent session trusts the checkmark alone before this is fixed.

Co-Authored-By: Claude Sonnet 5 <[email protected]>

sha256:903795d51856d4b7f873107a1de798bf4e4851e466f857500c4db115a446838d sha
~4 symbols
1 changed · 1188 in snapshot files
sha256:12a87192cc1488372427d1b4530f519b476f26b134b88d94d35141787fb94c5e snapshot
~4
symbols modified
1
file changed
1188
files in snapshot
0
dead code introduced
Semantic Changes 4 symbols
Files Changed
~1
1188 in snapshot
← Older Oldest on docs/fix-harmony-cli-reference
All commits
Newer → Latest on docs/fix-harmony-cli-reference

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:903795d51856d4b7f873107a1de798bf4e4851e466f857500c4db115a446838d --body "your comment"