fix: sha256:ec1d0e0022a4b70b9f777e4a7036296debc6def576324d13de627e76bdf0eb31 · gabriel/muse

fix: move agent-config canonical source outside .muse/ to .museagent.md (issue #78)

agent_md_path() returned .muse/agent.md -- .muse/ is unconditionally excluded from every snapshot (_ALWAYS_IGNORE_DIRS), regardless of .museignore, so the canonical agent-config source could never be tracked. This defeated the entire premise of muse agent-config: clone the repo, run sync, get your tool's adapter -- the source itself never survived a clone. Confirmed live: editing ~/ecosystem/.muse/agent.md produced zero change in muse status, and the file was absent from muse ls-files.

Fixed by moving agent_md_path() to <root>/.museagent.md -- a normal tracked file, outside .muse/ entirely, at the repo/workspace root. Chosen over AGENT.md to avoid confusion with AGENTS.md (the Codex adapter's generated output, not the source).

Added ACFG_01-03 in tests/test_cmd_agent_config.py: the path is no longer inside .muse/, a real init+add+commit+ls-files round-trip proves the file is genuinely tracked (not just a path-string assertion), and generated CLAUDE.md references @.museagent.md. Fixed two pre-existing tests that hardcoded the old path literal. Updated docs/agent-guide.md and a stale code_stage.py comment/test docstring that implied agent.md still lives inside .muse/.

No migration logic for existing .muse/agent.md files in this commit -- this workspace's own files (muse, musehub, ~/ecosystem, other members) are migrated separately in a follow-up, per the ticket's phased plan.

symbols added

~40

symbols modified

dead code introduced

Semantic Changes 44 symbols

~ docs/agent-guide.md .md 19 symbols modified

~ code[bash]@L1127

~ code[bash]@L1135

~ code[bash]@L1144

~ code[bash]@L1150

~ code[bash]@L1349

~ code[bash]@L1358

~ code[bash]@L1369

~ code[bash]@L1384

~ code[bash]@L1400

~ code[bash]@L1409

~ code[bash]@L1418

~ code[bash]@L1428

~ code[bash]@L1440

~ Muse Ecosystem — Agent Guide

~ Agent Config

~ Adapter files generated

~ code

~ Keeping adapters in sync

~ code

~ muse/cli/commands/agent_config.py .py 7 symbols modified

~ _WORKSPACE_MEMBER_TEMPLATE

~ _WORKSPACE_ROOT_TEMPLATE

~ register

~ run_init

~ run_inspect

~ run_status

~ run_sync

~ muse/cli/commands/code_stage.py .py

~ muse/core/paths.py .py 1 symbol modified

~ agent_md_path

~ tests/test_cmd_agent_config.py .py 4 symbols added, 11 symbols modified

+ TestCanonicalPathIsTracked class class TestCanonicalPathIsTracked L301–344

+ test_ACFG_01_agent_md_path_not_inside_dot_muse method method test_ACFG_01_agent_md_path_not_inside_dot_muse L302–309

+ test_ACFG_02_created_file_survives_add_and_commit method method test_ACFG_02_created_file_survives_add_and_commit L311–336

+ test_ACFG_03_claude_md_references_new_path method method test_ACFG_03_claude_md_references_new_path L338–344

~ TestE2EFullWorkflow

~ test_workspace_e2e

~ TestInitWorkspaceMember

~ test_member_agent_md_references_workspace

~ TestRenderAdapter

~ test_embed_adapter_contains_content

~ test_embed_adapter_with_workspace_prepends_ws_content

~ test_include_adapter_uses_at_syntax

~ test_include_adapter_with_workspace

~ TestSync

~ test_claude_md_uses_include_syntax

~ tests/test_cmd_code_add.py .py 2 symbols modified

~ TestSecurityI

~ test_I8_muse_dir_file_not_staged_when_explicit

← Older Oldest on fix/agent-config-canonical-path

All commits Newer feat: auto-migrate legacy .muse/agent.md to .museagent.md on init/sync sha256:8adda2b05fc89cbb8e81ab3d2104cbbd23ff35a5b1908f0eb534680077f7ac97

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:ec1d0e0022a4b70b9f777e4a7036296debc6def576324d13de627e76bdf0eb31 --body "your comment"