gabriel / muse public
docs main #51 / 100

docs: comprehensive plumbing and porcelain reference update

Plumbing doc: - read-commit, read-snapshot: document --format text one-liner output - commit-tree: document --format text (bare commit ID), add security note about snapshot/parent ID validation - update-ref: document --format text (silent on success), add security note about branch-name validation preventing path traversal - unpack-objects: document --format text human summary - ls-remote: update from --json/-j to --format json|text (API change) - commit-graph: note 100 000-commit cap on --ancestry-path BFS - Fix composability example to use ls-remote --format text

Porcelain doc: - Add complete --format json flag table and JSON payload schema to every command: commit, status, log, diff, show, branch, checkout, merge, rebase, reset, revert, cherry-pick, stash, tag, blame, reflog, gc, archive, bisect, worktree, describe, shortlog, verify, snapshot, bundle, content-grep, whoami, config - Fix whoami JSON: token_set is boolean; add capabilities field - Fix diff JSON: field is total_changes, not ops - Add rebase JSON: two distinct shapes (squash_rebase vs rebase) - Add config show JSON: full schema with user/hub/remotes/domain sections, blocked namespaces documented - Add flag tables with short flags for all commands - Expand composability patterns section with 3 new examples

G Gabriel Cardona <gabriel@tellurstori.com> · 2d ago Mar 21, 2026 · 51e65168 · parent e8c4265e
2
files changed
426
files in snapshot
Files Changed 426 in snapshot
~2

0 comments

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