Skip to content

docs: fix stale schema section and mangled fragments in README and COMMANDS - #147

Merged
EthanThatOneKid merged 2 commits into
mainfrom
docs-fixes
Sep 9, 2026
Merged

EthanThatOneKid merged 2 commits into
mainfrom
docs-fixes

Conversation

@EthanThatOneKid

Copy link
Copy Markdown
Contributor

Summary

  • Fix COMMANDS.md (skills/wspace/references/COMMANDS.md): the schema section wrongly claimed workspaces[] was removed in v4 and that path/groups/localFiles/manifest/worktreesDirectory/secretsDirectory are rejected with migration errors — the v4 schema keeps workspaces[] + workspacesDirectory, and the loader ignores all unknown keys except vaultDirectory.
  • Restore the missing Conservative mutation design-principle bullet (its tail had been fused into Provider-agnostic).
  • Fill command-table gaps: missing init, path, workspaces rows; add missing --as-workspace.
  • Remove orphaned fragments (the --no-track/origin/HEAD paragraph, broken Path-rule bullet with empty sh block, dangling sentence tails).
  • Resolve the duplicate-name contradiction: same names across workspaces are fine (README + code agree); only same-checkout-path collisions conflict.
  • README.md: repair the truncated Conservative-mutation bullet and the "Edits are surgical manifests survive." fragment.

Verified against the v4 JSON schema and the CLI source; deno task ci green (172 tests).

Test plan

  • deno task ci passes
  • wspace validate against a manifest with workspaces[] + groups accepts it (unknown keys ignored)

EthanThatOneKid and others added 2 commits September 5, 2026 20:27
…MMANDS

COMMANDS.md claimed workspaces[] was removed in schema v4 and that
legacy keys are rejected; the v4 schema keeps workspaces[] alongside
repositories[], and only vaultDirectory errors (unknown keys are ignored).
Restored the missing Conservative mutation bullet, added the init/path/
workspaces commands and --as-workspace to the reference table, and repaired
several truncated sentences and an empty code block. README's Conservative
mutation bullet and add-command sentence were similarly truncated.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>
@EthanThatOneKid
EthanThatOneKid merged commit 93392b2 into main Sep 9, 2026
1 check passed
@EthanThatOneKid
EthanThatOneKid deleted the docs-fixes branch September 9, 2026 06:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant