gabriel / muse public
refactor BREAKING src task/fix-failing-tests #3 / 5
AI Agent gabriel · 135 days ago · May 5, 2026 · Diff

refactor(src): replace all UUID terminology with content-addressed ID language

- muse/core/crdts/aw_map.py, or_set.py: replace uuid.uuid4() tokens with secrets.token_hex(16) — CRDT tokens need randomness, not determinism - muse/core/task_queue.py: replace uuid.uuid4() claim nonces with secrets.token_hex(16); update all docstrings from 'UUID' to 'sha256: content ID' - muse/plugins/midi/_crdt_notes.py: replace uuid.uuid4() op_id with secrets.token_hex(16); update docstrings - muse/plugins/midi/entity.py: replace uuid.uuid4() entity_id with content_hash(note fields + op_id); update all docstrings - All CLI command docstrings/help text: '<uuid>' → '<id>' or '<sha256:...>' depending on whether the ID is server-assigned or content-addressed - All core module docstrings: 'Repository UUID' → 'repository content ID', 'UUID of the reservation' → 'content-addressed ID of the reservation', etc. - coordination.py: security note updated from 'UUID4 string cannot contain' to 'sha256: content ID cannot contain'; all parameter docs updated - dag.py: metavar='UUID' → metavar='ID' in argparse; docstrings updated - intent.py: metavar='UUID' → metavar='ID'; all UUID references removed - harmony.py: audit filename pattern '<uuid4>.json' → '<content-id>.json' - migrate.py: table updated to show 'plain string (pre-sha256)' - snapshot.py: ID derivation note updated

sha256:9c91037e99d96608d3bc875dca93e608dd3aa30594723b92cc4b665bcbc7ea24 sha
sha256:1991fc6d3cb4f74b4c8f0456e7dc3fe0e56b89fce4219f92933a4083749ed5ed parent
+5 ~107 −5 symbols
sha256:3af090d894b3b67231291987dbc00eaee5e13c017fcbb7eeda455f899b6d5ee0 snapshot
+5
symbols added
~107
symbols modified
−5
symbols removed
0
dead code introduced
Semantic Changes 117 symbols
~ muse/cli/commands/auth.py .py 1 symbol modified
~ run_register
~ muse/cli/commands/coord_gc.py .py
~ muse/cli/commands/coord_sync.py .py 2 symbols modified
~ register
~ run_pull
~ muse/cli/commands/dag.py .py 3 symbols modified
~ _run_single
~ register
~ run
~ muse/cli/commands/describe.py .py
~ muse/cli/commands/harmony.py .py
~ muse/cli/commands/heartbeat_coord.py .py 3 symbols modified
~ _HeartbeatJson
~ register
~ run
~ muse/cli/commands/hub/_core.py .py 8 symbols modified
~ _HubApiResponse
~ _LabelEntry
~ _ProposalEntry
~ _RepoEntry
~ _RepoJson
~ _resolve_proposal_id
~ _resolve_repo_id
~ _resolve_repo_id_from_owner_repo
~ muse/cli/commands/hub/issues.py .py 2 symbols modified
~ register
~ run_issue_comment_delete
~ muse/cli/commands/hub/labels.py .py
~ muse/cli/commands/hub/proposals.py .py 2 symbols modified
~ register
~ run_proposal_read
~ muse/cli/commands/hub/releases.py .py 2 symbols modified
~ register
~ run_release_asset_delete
~ muse/cli/commands/hub/repos.py .py 6 symbols modified
~ register
~ run_repo_create
~ run_repo_delete
~ run_repo_list
~ run_repo_read
~ run_repo_transfer_ownership
~ muse/cli/commands/hub/users.py .py 1 symbol modified
~ register
~ muse/cli/commands/hub/webhooks.py .py 3 symbols modified
~ register
~ run_webhook_delivery_list
~ run_webhook_redeliver
~ muse/cli/commands/init.py .py
~ muse/cli/commands/intent.py .py 2 symbols modified
~ register
~ run
~ muse/cli/commands/ls_remote.py .py
~ muse/cli/commands/read_commit.py .py
~ muse/cli/commands/release.py .py 2 symbols modified
~ register
~ run_push
~ muse/cli/commands/release_coord.py .py 3 symbols modified
~ _run_single
~ register
~ run
~ muse/cli/commands/reserve.py .py 2 symbols modified
~ register
~ run
~ muse/cli/commands/shortlog.py .py 1 symbol modified
~ run
~ muse/cli/commands/task_queue.py .py 9 symbols modified
~ register_cancel_task
~ register_complete
~ register_enqueue
~ register_fail_task
~ run_cancel_task
~ run_claim
~ run_complete
~ run_enqueue
~ run_fail_task
~ muse/cli/commands/watch_coord.py .py 6 symbols modified
~ WatchEvent
~ _diff_snapshots
~ _emit_event
~ _scan_dirs
~ _watch_loop
~ run
~ muse/core/coordination.py .py 6 symbols modified
~ CoordGcResult
~ Intent
~ create_heartbeat
~ create_intent
~ create_release
~ create_reservation
~ muse/core/crdts/aw_map.py .py 1 symbol added, 1 symbol removed, 2 symbols modified
− uuid import import uuid L32–32
+ secrets import import secrets L32–32
~ AWMap
~ set
~ muse/core/crdts/or_set.py .py 1 symbol added, 1 symbol removed, 2 symbols modified
− uuid import import uuid L42–42
+ secrets import import secrets L42–42
~ ORSet
~ add
~ muse/core/dag.py .py 4 symbols modified
~ add_dependencies
~ get_blocking
~ is_blocked
~ load_dependencies
~ muse/core/describe.py .py 1 symbol modified
~ describe_commit
~ muse/core/diff_algorithms/tree_edit.py .py 1 symbol modified
~ TreeNode
~ muse/core/doc_extractor.py .py 2 symbols modified
~ build_symbol_doc
~ extract_docs
~ muse/core/doc_history.py .py 2 symbols modified
~ generate_changelog
~ get_symbol_version_events
~ muse/core/migrate.py .py
~ muse/core/op_log.py .py 3 symbols modified
~ OpEntry
~ OpLog
~ make_op_entry
~ muse/core/pack.py .py 1 symbol modified
~ build_mpack
~ muse/core/rebase.py .py 1 symbol modified
~ replay_one
~ muse/core/schema.py .py 1 symbol modified
~ SetSchema
~ muse/core/snapshot.py .py
~ muse/core/store.py .py 1 symbol modified
~ get_commits_for_branch
~ muse/core/task_queue.py .py 1 symbol added, 1 symbol removed, 9 symbols modified
− _uuid_mod import import _uuid_mod L99–99
+ secrets import import secrets L99–99
~ ClaimRecord
~ from_dict
~ TaskRecord
~ _try_excl_claim
~ _try_optimistic_reclaim
~ cancel_task
~ complete_task
~ fail_task
~ heartbeat_claim
~ muse/core/test_history.py .py 1 symbol modified
~ RunRecord
~ muse/core/test_runner.py .py 1 symbol modified
~ RunResult
~ muse/domain.py .py 1 symbol modified
~ EntityProvenance
~ muse/plugins/midi/_crdt_notes.py .py 1 symbol added, 1 symbol removed, 4 symbols modified
− _uuid_mod import import _uuid_mod L65–65
+ secrets import import secrets L65–65
~ MidiRGA
~ insert
~ NotePosition
~ RGANoteEntry
~ muse/plugins/midi/entity.py .py 1 symbol added, 1 symbol removed, 6 symbols modified
− _uuid_mod import import _uuid_mod L55–55
+ content_hash import import content_hash L58–58
~ NoteEntity
~ _new_entity
~ blob_id
~ load_json_file
~ short_id
~ split_id
Older refactor(tests): replace all UUID references with content-addres… sha256:1991fc6d3cb4f74b4c8f0456e7dc3fe0e56b89fce4219f92933a4083749ed5ed All commits Newer docs: replace UUID terminology with content-addressed ID language sha256:47da9e3b8d552144c171448cecd3d330ff405fd0795ff09f4d7f6283f9233530

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