@danielbaars/anthracite 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +17 -9
  2. package/cli.cjs +12680 -10171
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  A CLI for stacked Git branches and GitHub pull requests. Use **`an`** or **`anthracite`**.
4
4
 
5
- Anthracite builds on [Charcoal](https://github.com/danerwilliams/charcoal) and the formerly open-source Graphite CLI. See [credits and provenance](https://github.com/danielbaars/anthracite/blob/v0.4.0/CREDITS.md). It supports local stacks and GitHub PRs through `gh`; it does not implement every current Graphite feature or require a Graphite subscription.
5
+ Anthracite builds on [Charcoal](https://github.com/danerwilliams/charcoal) and the formerly open-source Graphite CLI. See [credits and provenance](https://github.com/danielbaars/anthracite/blob/v0.5.1/CREDITS.md). It supports local stacks and GitHub PRs through `gh`; it does not implement every current Graphite feature or require a Graphite subscription.
6
+
7
+ See the [0.4.0 Graphite parity register](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/graphite-parity.md) for shipped work, remaining interfaces, deliberate differences and evidence limits.
6
8
 
7
9
  ## Install
8
10
 
@@ -13,7 +15,7 @@ npm install --global @danielbaars/anthracite
13
15
  an --version
14
16
  ```
15
17
 
16
- Git is required; GitHub workflows also require an installed, authenticated [GitHub CLI](https://cli.github.com/). npm installs both `an` and `anthracite`. It does not modify shell configuration. See [completion and migration from the standalone installer](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/installation.md).
18
+ Git is required; GitHub workflows also require an installed, authenticated [GitHub CLI](https://cli.github.com/). npm installs both `an` and `anthracite`. It does not modify shell configuration. See [completion and migration from the standalone installer](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/installation.md).
17
19
 
18
20
  Standalone binaries for macOS ARM64, macOS x64 and Linux x64 are also available from [GitHub Releases](https://github.com/danielbaars/anthracite/releases). They do not require Node.js or Bun. From a clone, run `sh scripts/install.sh 0.1.1` to install that standalone release with checksum verification and zsh completion.
19
21
 
@@ -27,22 +29,28 @@ an log short --stack
27
29
  an submit --stack --draft
28
30
  ```
29
31
 
30
- For a shared prerequisite below selected branches, see [targeted insertion](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/targeted-insertion.md).
32
+ For a shared prerequisite below selected branches, see [targeted insertion](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/targeted-insertion.md).
31
33
 
32
34
  Stage changes with Git before `create` or `modify`, or choose the command's staging options deliberately. Use `an <command> --help` for details.
33
35
 
34
- Use `an split --by-file 'path/**'` or `an sp -f path` to extract selected committed files into a prerequisite while retaining the original branch. See [file splitting, history and recovery](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/split.md).
36
+ Use `an split --by-file 'path/**'` or `an sp -f path` to extract selected committed files into a prerequisite while retaining the original branch. See [file splitting, history and recovery](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/split.md).
37
+
38
+ Use `an submit --reviewers alice --assignees @me --roles-branch my-change` to add roles only to one selected PR while retaining the usual submission scope. See [reviewers, assignees and submission scope](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/submit.md).
39
+
40
+ Use `an pr [branch]` for fresh GitHub PR information, `--stack` for its connected stack, or `--web` to explicitly open the selected PR. See [PR inspection and preserved local state](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/pr.md).
41
+
42
+ Use `an review [branch]` to inspect its diff or submit one explicit review bound to `--head`; see [review actions and uncertain responses](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/review.md).
35
43
 
36
- Use `an submit --reviewers alice --assignees @me --roles-branch my-change` to add roles only to one selected PR while retaining the usual submission scope. See [reviewers, assignees and submission scope](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/submit.md).
44
+ Use `an land [branch] --dry-run` to preview scoped bottom-up rebase landing, mandatory surviving-branch maintenance and readiness blockers. Apply the selected trunk-to-target chain with `--yes`; necessary surviving arms are replayed and their existing heads/PRs maintained. Conflicts continue locally with `an continue`, then require explicit `an land` resumption for remote work. See [scoped landing](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/land.md).
37
45
 
38
- To uninstall an npm installation, run `npm uninstall --global @danielbaars/anthracite`. For a standalone installation, remove the command links and managed completion block using `sh scripts/uninstall.sh` from a clone. Version directories and preferences are retained for rollback. See [installation and upgrades](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/installation.md), the [command reference](https://github.com/danielbaars/anthracite/blob/v0.4.0/DOCUMENTATION.md), and [compatibility](https://github.com/danielbaars/anthracite/blob/v0.4.0/COMPATIBILITY.md).
46
+ To uninstall an npm installation, run `npm uninstall --global @danielbaars/anthracite`. For a standalone installation, remove the command links and managed completion block using `sh scripts/uninstall.sh` from a clone. Version directories and preferences are retained for rollback. See [installation and upgrades](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/installation.md), the [command reference](https://github.com/danielbaars/anthracite/blob/v0.5.1/DOCUMENTATION.md), and [compatibility](https://github.com/danielbaars/anthracite/blob/v0.5.1/COMPATIBILITY.md).
39
47
 
40
48
  ## MCP
41
49
 
42
- Coding agents can use `an mcp` or `anthracite mcp` as a local stdio server. See [MCP configuration, tools and recovery](https://github.com/danielbaars/anthracite/blob/v0.4.0/docs/mcp.md) for a generic client configuration, explicit request arguments, execution limits and interruption behavior.
50
+ Coding agents can use `an mcp` or `anthracite mcp` as a local stdio server. See [MCP configuration, tools and recovery](https://github.com/danielbaars/anthracite/blob/v0.5.1/docs/mcp.md) for a generic client configuration, explicit request arguments, execution limits and interruption behavior.
43
51
 
44
52
  ## Development
45
53
 
46
- See [CONTRIBUTING.md](https://github.com/danielbaars/anthracite/blob/v0.4.0/CONTRIBUTING.md) for pinned build tools, tests and release preparation. Source code, documentation, commit messages, issues and pull requests in this repository are written in English.
54
+ See [CONTRIBUTING.md](https://github.com/danielbaars/anthracite/blob/v0.5.1/CONTRIBUTING.md) for pinned build tools, tests and release preparation. Source code, documentation, commit messages, issues and pull requests in this repository are written in English.
47
55
 
48
- Licensed under the GNU Affero General Public License version 3; see [LICENSE](https://github.com/danielbaars/anthracite/blob/v0.4.0/LICENSE) and [CREDITS.md](https://github.com/danielbaars/anthracite/blob/v0.4.0/CREDITS.md).
56
+ Licensed under the GNU Affero General Public License version 3; see [LICENSE](https://github.com/danielbaars/anthracite/blob/v0.5.1/LICENSE) and [CREDITS.md](https://github.com/danielbaars/anthracite/blob/v0.5.1/CREDITS.md).