feat: redesign .museignore as TOML with domain-scoped sections (#100)

* feat: redesign .museignore as TOML with domain-scoped sections

Replace the flat gitignore-style .museignore with a TOML format that has [global] and [domain.<name>] sections. Global patterns apply to every domain; domain-specific sections are loaded only when the active plugin matches, keeping each plugin's ignore rules isolated from every other. The is_ignored() and _matches() functions are unchanged — callers now use load_ignore_config() + resolve_patterns(config, domain) instead of load_patterns().

Also adds from __future__ import annotations to all muse/ modules that were missing it, fixing pre-existing forward-reference NameErrors in TypedDicts (PatchOp/DomainOp, MapSchema/ElementSchema) and dataclasses (AWMap, GCounter, TreeNode, etc.) that broke test collection.

* feat: complete .museignore TOML integration across codebase

- muse init now generates a domain-aware .museignore TOML template alongside .museattributes; template includes [global] + [domain.<name>] sections pre-filled for the chosen domain (midi/code/genomics/simulation/ spatial; generic stub for unknown domains).

- ScaffoldPlugin.snapshot() now honours .museignore via load_ignore_config + resolve_patterns — the reference template for new plugin authors now demonstrates the correct ignore contract.

- Docstrings updated in provenance.py, manifest.py, entity.py to reference the TOML format and correct sections ([global] for keys, [domain.midi] for rebuildable caches).

- Docs updated: architecture/muse-vcs.md, reference/type-contracts.md, reference/muse-attributes.md, agent-provenance.md, entity-identity.md all now describe the TOML format and include concrete examples.

- Tests: 8 new init tests (valid TOML, global section, domain section for midi/code, no-overwrite on reinit, parseable by load_ignore_config); 8 new scaffold plugin snapshot tests (global ignore, domain-specific, cross-domain isolation, negation, domain negation overrides global).

---------

Co-authored-by: Gabriel Cardona <gabriel@tellurstori.com>

G Gabriel Cardona <cgcardona@gmail.com> · 1d ago Mar 19, 2026 · bda49bdb · parent 8d1c0847

oldest

newest 61%

Snapshot Diff

214 files in tree

+1 ~128

tests/test_scaffold_plugin.py .py

docs/agent-provenance.md .md

docs/architecture/muse-vcs.md .md

docs/entity-identity.md .md

docs/reference/muse-attributes.md .md

docs/reference/museignore.md .md

docs/reference/type-contracts.md .md

muse/cli/app.py .py

muse/cli/commands/annotate.py .py

muse/cli/commands/api_surface.py .py

muse/cli/commands/attributes.py .py

muse/cli/commands/blame.py .py

muse/cli/commands/branch.py .py

muse/cli/commands/breakage.py .py

muse/cli/commands/check.py .py

muse/cli/commands/checkout.py .py

muse/cli/commands/checkout_symbol.py .py

muse/cli/commands/cherry_pick.py .py

muse/cli/commands/clones.py .py

muse/cli/commands/code_check.py .py

muse/cli/commands/code_query.py .py

muse/cli/commands/codemap.py .py

muse/cli/commands/commit.py .py

muse/cli/commands/compare.py .py

muse/cli/commands/coupling.py .py

muse/cli/commands/coverage.py .py

muse/cli/commands/dead.py .py

muse/cli/commands/deps.py .py

muse/cli/commands/detect_refactor.py .py

muse/cli/commands/diff.py .py

muse/cli/commands/domains.py .py

muse/cli/commands/find_symbol.py .py

muse/cli/commands/forecast.py .py

muse/cli/commands/grep.py .py

muse/cli/commands/harmony.py .py

muse/cli/commands/hotspots.py .py

muse/cli/commands/impact.py .py

muse/cli/commands/index_rebuild.py .py

muse/cli/commands/init.py .py

muse/cli/commands/intent.py .py

muse/cli/commands/invariants.py .py

muse/cli/commands/languages.py .py

muse/cli/commands/lineage.py .py

muse/cli/commands/log.py .py

muse/cli/commands/merge.py .py

muse/cli/commands/midi_check.py .py

muse/cli/commands/midi_query.py .py

muse/cli/commands/mix.py .py

muse/cli/commands/note_blame.py .py

muse/cli/commands/note_hotspots.py .py

muse/cli/commands/note_log.py .py

muse/cli/commands/notes.py .py

muse/cli/commands/patch.py .py

muse/cli/commands/piano_roll.py .py

muse/cli/commands/plan_merge.py .py

muse/cli/commands/query.py .py

muse/cli/commands/query_history.py .py

muse/cli/commands/reconcile.py .py

muse/cli/commands/reserve.py .py

muse/cli/commands/reset.py .py

muse/cli/commands/revert.py .py

muse/cli/commands/semantic_cherry_pick.py .py

muse/cli/commands/shard.py .py

muse/cli/commands/show.py .py

muse/cli/commands/stable.py .py

muse/cli/commands/stash.py .py

muse/cli/commands/status.py .py

muse/cli/commands/symbol_log.py .py

muse/cli/commands/symbols.py .py

muse/cli/commands/tag.py .py

muse/cli/commands/transpose.py .py

muse/cli/commands/velocity_profile.py .py

muse/cli/config.py .py

muse/cli/midi_parser.py .py

muse/cli/models.py .py

muse/core/attributes.py .py

muse/core/coordination.py .py

muse/core/crdts/__init__.py .py

muse/core/crdts/aw_map.py .py

muse/core/crdts/g_counter.py .py

muse/core/crdts/lww_register.py .py

muse/core/crdts/or_set.py .py

muse/core/crdts/rga.py .py

muse/core/crdts/vclock.py .py

muse/core/diff_algorithms/__init__.py .py

muse/core/diff_algorithms/lcs.py .py

muse/core/diff_algorithms/numerical.py .py

muse/core/diff_algorithms/set_ops.py .py

muse/core/diff_algorithms/tree_edit.py .py

muse/core/errors.py .py

muse/core/ignore.py .py

muse/core/indices.py .py

muse/core/invariants.py .py

muse/core/merge_engine.py .py

muse/core/object_store.py .py

muse/core/op_log.py .py

muse/core/op_transform.py .py

muse/core/provenance.py .py

muse/core/query_engine.py .py

muse/core/repo.py .py

muse/core/schema.py .py

muse/core/snapshot.py .py

muse/core/store.py .py

muse/domain.py .py

muse/plugins/code/_callgraph.py .py

muse/plugins/code/_code_query.py .py

muse/plugins/code/_invariants.py .py

muse/plugins/code/_op_log_integration.py .py

muse/plugins/code/_predicate.py .py

muse/plugins/code/_query.py .py

muse/plugins/code/_refactor_classify.py .py

muse/plugins/code/ast_parser.py .py

muse/plugins/code/manifest.py .py

muse/plugins/code/plugin.py .py

muse/plugins/code/symbol_diff.py .py

muse/plugins/midi/_crdt_notes.py .py

muse/plugins/midi/_invariants.py .py

muse/plugins/midi/_midi_query.py .py

muse/plugins/midi/_query.py .py

muse/plugins/midi/entity.py .py

muse/plugins/midi/manifest.py .py

muse/plugins/midi/midi_diff.py .py

muse/plugins/midi/midi_merge.py .py

muse/plugins/midi/plugin.py .py

muse/plugins/registry.py .py

muse/plugins/scaffold/plugin.py .py

tests/test_cli_workflow.py .py

tests/test_code_plugin.py .py

tests/test_core_ignore.py .py

Older fix: escape backslash-n in JS split() call inside Python templat… a62ee920 All commits Newer feat: add remote sync commands (remote, clone, fetch, pull, push… 99c4ff79

Comments

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