completions/_muse · gabriel/muse

1

#compdef muse

2

# Zsh completion for the Muse CLI.

3

#

4

# Installation (pick one):

5

# 1. Symlink into a directory already on $fpath:

6

# ln -sf /path/to/muse/completions/_muse ~/.zsh/completions/_muse

7

# 2. Oh-My-Zsh users — copy or symlink into the custom completions dir:

8

# ln -sf /path/to/muse/completions/_muse \

9

# ~/.oh-my-zsh/completions/_muse

10

# 3. Add the completions directory directly to $fpath in ~/.zshrc:

11

# fpath=(/path/to/muse/completions $fpath)

12

# autoload -Uz compinit && compinit

13

#

14

# After installing, reload completions:

15

# exec zsh OR autoload -Uz compinit && compinit -u

16

17

# ---------------------------------------------------------------------------

18

# Helpers

19

# ---------------------------------------------------------------------------

20

21

# Emit branch names from the nearest Muse repo, or nothing if not in one.

22

_muse_branches() {

23

local -a branches

24

if muse plumbing show-ref &>/dev/null; then

25

branches=(${(f)"$(muse plumbing show-ref 2>/dev/null \

26

| python3 -c \

27

'import sys,json; d=json.load(sys.stdin); [print(r["ref"].replace("refs/heads/","")) for r in d["refs"]]' \

28

2>/dev/null)"})

29

_describe 'branches' branches

fi

}

# Emit remote names from the Muse config.

_muse_remotes() {

local -a remotes

local cfg

cfg="$(muse remote 2>/dev/null | awk '{print $1}')"

38

if [[ -n $cfg ]]; then

39

remotes=(${(f)cfg})

40

_describe 'remotes' remotes

41

else

42

# Always offer the built-in special remotes.

43

_values 'remote' 'origin' 'local'

fi

}

# ---------------------------------------------------------------------------

48

# Command lists (kept in sync with muse/cli/app.py)

49

# ---------------------------------------------------------------------------

50

51

local -a _muse_top_cmds=(

52

'plumbing:Tier 1 machine-readable plumbing commands'

53

'init:Initialise a new Muse repository'

54

'status:Show working-tree drift against HEAD'

55

'log:Display commit history'

56

'commit:Record the current state as a new version'

57

'diff:Compare working tree against HEAD or two commits'

58

'show:Inspect a commit'

59

'branch:List, create, or delete branches'

60

'checkout:Switch branches or restore from a commit'

61

'merge:Three-way merge a branch into HEAD'

62

'reset:Move HEAD to a prior commit'

63

'revert:Undo a prior commit'

64

'cherry-pick:Apply a specific commit on top of HEAD'

65

'stash:Shelve uncommitted changes'

66

'tag:Attach and query semantic tags'

67

'push:Upload commits and objects to a remote'

68

'pull:Fetch from a remote and merge'

69

'fetch:Download commits from a remote'

70

'clone:Create a local copy of a remote repository'

71

'remote:Manage remote connections'

72

'auth:Identity management'

73

'hub:MuseHub fabric connection'

74

'config:Local repository configuration'

75

'domains:Domain plugin dashboard'

76

'attributes:Display .museattributes rules'

77

'annotate:Attach CRDT annotations to a commit'

78

'blame:Show per-line commit provenance'

79

'reflog:History of HEAD and branch-ref movements'

80

'rerere:Reuse recorded conflict resolutions'

81

'gc:Remove unreachable objects'

82

'archive:Export a historical snapshot'

83

'bisect:Binary search commit history'

84

'worktree:Manage multiple branch checkouts'

85

'workspace:Compose multiple Muse repositories'

86

'rebase:Replay commits onto a new base'

87

'clean:Remove untracked files'

88

'describe:Label a commit by its nearest tag'

89

'shortlog:Summarise history by author or agent'

90

'verify:Check repository integrity'

91

'snapshot:Explicit snapshot management'

92

'bundle:Pack commits into a portable bundle'

93

'content-grep:Search tracked file content'

94

'whoami:Show current identity'

95

'check:Run domain invariant checks'

96

'cat:Print a single tracked symbol'

97

'midi:MIDI domain semantic commands'

98

'code:Code domain semantic commands'

99

'coord:Multi-agent coordination commands'

100

)

101

102

local -a _muse_plumbing_cmds=(

103

'hash-object:SHA-256 a file and optionally store it'

104

'cat-object:Emit raw bytes of a stored object'

105

'rev-parse:Resolve branch or HEAD to a commit ID'

106

'ls-files:List tracked files and object IDs'

107

'read-commit:Emit full commit JSON'

108

'read-snapshot:Emit full snapshot JSON'

109

'commit-tree:Create a commit from an explicit snapshot ID'

110

'update-ref:Move a branch HEAD to a specific commit'

111

'commit-graph:Emit the commit DAG as JSON'

112

'pack-objects:Build a PackBundle to stdout'

113

'unpack-objects:Read a PackBundle from stdin'

114

'ls-remote:List remote branch heads'

115

'merge-base:Find the lowest common ancestor of two commits'

116

'snapshot-diff:Diff two snapshot manifests'

117

'domain-info:Inspect the active domain plugin'

118

'show-ref:List all refs and their commit IDs'

119

'check-ignore:Test paths against .museignore rules'

120

'check-attr:Query merge-strategy attributes for paths'

121

'verify-object:Re-hash stored objects to detect corruption'

122

'symbolic-ref:Read or write HEAD symbolic reference'

123

'for-each-ref:Iterate all refs with rich commit metadata'

124

'name-rev:Map commit IDs to descriptive names'

125

'check-ref-format:Validate branch or ref names'

126

'verify-pack:Verify the integrity of a PackBundle'

127

)

128

129

local -a _muse_midi_cmds=(

130

'notes:List notes in a MIDI track'

131

'note-log:Show note-level history'

132

'note-blame:Show per-note commit provenance'

133

'harmony:Analyse harmonic content'

134

'piano-roll:Render a piano-roll view'

135

'note-hotspots:Find most-changed note regions'

136

'velocity-profile:Plot velocity distribution'

137

'transpose:Shift pitches by semitones'

138

'mix:Merge MIDI tracks'

139

'query:Query note events'

140

'check:Run MIDI domain checks'

141

'rhythm:Analyse rhythmic patterns'

142

'scale:Detect active scales'

143

'contour:Analyse melodic contour'

144

'density:Compute note density over time'

145

'tension:Compute harmonic tension'

146

'cadence:Detect cadence points'

147

'motif:Find recurring motifs'

148

'voice-leading:Analyse voice-leading quality'

149

'instrumentation:List instrumentation per track'

150

'tempo:Display tempo map'

151

'compare:Compare two MIDI commits'

152

'quantize:Snap notes to a rhythmic grid'

153

'humanize:Add expressive timing variation'

154

'invert:Invert intervals around an axis'

155

'retrograde:Reverse note sequence'

156

'arpeggiate:Spread chords into arpeggios'

157

'normalize:Normalise velocity levels'

158

'shard:Split a MIDI file into shards'

159

'agent-map:Show which agents modified which notes'

160

'find-phrase:Search for a melodic phrase'

161

)

162

163

local -a _muse_code_cmds=(

164

'cat:Print a symbol'\''s source'

165

'symbols:List symbols in the snapshot'

166

'symbol-log:Show per-symbol commit history'

167

'detect-refactor:Detect renames and extractions'

168

'grep:Search symbol names and bodies'

169

'blame:Show per-symbol commit provenance'

170

'hotspots:Find most-changed symbols'

171

'stable:Find stable (rarely changed) symbols'

172

'coupling:Show frequently co-changed symbol pairs'

173

'compare:Compare two code commits'

174

'languages:List languages in the snapshot'

175

'patch:Apply a delta patch to symbols'

176

'query:Query the symbol graph'

177

'query-history:Query across commit history'

178

'deps:Show dependency graph'

179

'find-symbol:Search for a symbol by name'

180

'impact:Estimate change impact'

181

'dead:Find unreachable symbols'

182

'coverage:Show test coverage mapping'

183

'lineage:Trace a symbol'\''s ancestry'

184

'api-surface:Enumerate public API symbols'

185

'codemap:Render the module dependency map'

186

'clones:Detect duplicate code'

187

'checkout-symbol:Restore a symbol to a prior version'

188

'semantic-cherry-pick:Apply a symbol-level change'

189

'index:Rebuild the symbol index'

190

'breakage:Detect breaking changes'

191

'invariants:Run symbol invariant checks'

192

'add:Stage files for commit'

193

'reset:Unstage files'

194

'code-check:Run code-domain checks'

195

'code-query:Run a structured code query'

196

)

197

198

local -a _muse_coord_cmds=(

199

'reserve:Reserve a symbol for exclusive editing'

200

'intent:Declare editing intent'

201

'forecast:Forecast merge conflicts'

202

'plan-merge:Plan a coordinated merge'

203

'shard:Partition work across agents'

204

'reconcile:Reconcile diverged agent branches'

205

)

206

207

# ---------------------------------------------------------------------------

208

# Main dispatcher

209

# ---------------------------------------------------------------------------

210

211

_muse() {

212

local curcontext="$curcontext" state line

typeset -A opt_args

_arguments -C \

'(-h --help)'{-h,--help}'[Show help]' \

217

'(-V --version)'{-V,--version}'[Show version]' \

'1: :->command' \

'*:: :->args' \

&& return 0

case $state in

command)

_describe 'muse commands' _muse_top_cmds

;;

args)

case $words[1] in

# --- sub-namespaces -----------------------------------------

231

plumbing)

232

_arguments '1: :->sub' '*:: :->plumbing_args'

233

case $state in

234

sub) _describe 'plumbing commands' _muse_plumbing_cmds ;;

esac

;;

midi)

_arguments '1: :->sub'

240

case $state in

241

sub) _describe 'midi commands' _muse_midi_cmds ;;

esac

;;

code)

_arguments '1: :->sub' '*:: :->code_args'

247

case $state in

248

sub) _describe 'code commands' _muse_code_cmds ;;

code_args)

case $words[1] in

add|reset) _files ;;

esac

;;

esac

;;

coord)

_arguments '1: :->sub'

259

case $state in

260

sub) _describe 'coord commands' _muse_coord_cmds ;;

esac

;;

# --- branch-aware commands -----------------------------------

265

checkout)

266

_arguments \

267

'(-b --branch)'{-b,--branch}'[Create new branch]:branch:_muse_branches' \

268

'(-f --force)'{-f,--force}'[Force checkout]' \

'1: :_muse_branches'

;;

merge)

_arguments \

'--no-commit[Do not auto-commit after merge]' \

275

'--squash[Squash into a single commit]' \

276

'--strategy[Merge strategy]:strategy:(ours theirs union)' \

'1: :_muse_branches'

;;

branch)

_arguments \

'(-d --delete)'{-d,--delete}'[Delete a branch]:branch:_muse_branches' \

283

'(-D --force-delete)'{-D,--force-delete}'[Force-delete a branch]:branch:_muse_branches' \

284

'(-m --move)'{-m,--move}'[Rename a branch]:branch:_muse_branches' \

285

'1:: :_muse_branches'

;;

cherry-pick)

_arguments \

'(-n --no-commit)'{-n,--no-commit}'[Stage without committing]' \

'1: :_muse_branches'

;;

rebase)

_arguments \

'--onto[New base branch]:branch:_muse_branches' \

'1: :_muse_branches'

;;

# --- remote-aware commands -----------------------------------

301

push)

302

_arguments \

303

'(-b --branch)'{-b,--branch}'[Branch to push]:branch:_muse_branches' \

304

'(-u --set-upstream)'{-u,--set-upstream}'[Set upstream tracking]' \

305

'--force[Force push even if remote diverged]' \

306

'1:: :_muse_remotes' \

307

'2:: :_muse_branches'

;;

pull)

_arguments \

'(-b --branch)'{-b,--branch}'[Branch to pull into]:branch:_muse_branches' \

313

'--rebase[Rebase instead of merge]' \

314

'--no-commit[Do not auto-commit after merge]' \

315

'1:: :_muse_remotes' \

316

'2:: :_muse_branches'

;;

fetch)

_arguments \

'(-b --branch)'{-b,--branch}'[Specific branch to fetch]:branch:_muse_branches' \

322

'--all[Fetch from all configured remotes]' \

'1:: :_muse_remotes'

;;

clone)

_arguments \

'(-b --branch)'{-b,--branch}'[Branch to check out after clone]:branch' \

329

'--name[Override repo directory name]:name' \

'1: :_urls'

;;

# --- simple flag commands ------------------------------------

334

commit)

335

_arguments \

336

'(-m --message)'{-m,--message}'[Commit message]:message' \

337

'--allow-empty[Allow a commit with no changes]' \

338

'--sign[Sign the commit]' \

339

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)'

;;

status)

_arguments \

'(-s --short)'{-s,--short}'[Condensed output]' \

345

'--porcelain[Machine-readable output]' \

346

'(-b --branch)'{-b,--branch}'[Show branch only]' \

347

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)'

;;

log)

_arguments \

'(-n --max-count)'{-n,--max-count}'[Limit number of commits]:count' \

353

'--oneline[Compact one-line output]' \

354

'--graph[Show commit graph]' \

355

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)'

;;

diff)

_arguments \

'--stat[Show diffstat summary]' \

361

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)' \

362

'1:: :_muse_branches' \

363

'2:: :_muse_branches'

;;

show)

_arguments \

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)' \

369

'1:: :_muse_branches'

;;

reset)

_arguments \

'--hard[Discard working tree changes]' \

375

'--soft[Keep working tree changes staged]' \

376

'1:: :_muse_branches'

;;

tag)

_arguments \

'(-d --delete)'{-d,--delete}'[Delete a tag]' \

382

'(-l --list)'{-l,--list}'[List tags]' \

383

'(-f --format)'{-f,--format}'[Output format]:fmt:(text json)'

;;

stash)

_arguments \

'1:: :(push pop list drop show apply)'

;;

remote)

_arguments \

'1:: :(add remove list rename set-url show)'

;;

auth)

_arguments \

'1:: :(login logout whoami)'

;;

hub)

_arguments \

'1:: :(connect disconnect status ping)'

;;

config)

_arguments \

'1:: :(show get set edit)'

;;

esac

;;

esac

}

_muse "$@"