@savvy-web/cli 0.2.0 → 0.2.1

package/841.js

@@ -2219,7 +2219,7 @@ const rootCommand = Command.make("savvy").pipe(Command.withSubcommands([
 ]));
 const cli = Command.run(rootCommand, {
     name: "savvy",
-    version: "0.2.0"
+    version: "0.2.1"
 });
 const WorkspaceLive = Layer.mergeAll(WorkspaceRootLive, PackageManagerDetectorLive, WorkspaceDiscoveryLive.pipe(Layer.provide(WorkspaceRootLive)));
 const BaseLive = Layer.mergeAll(WorkspaceLive, ChangesetConfigReaderLive, ManagedSectionLive, BiomeSchemaSyncLive, ConfigDiscoveryLive, SilkPublishabilityDetectorLive, Changesets.WorkspaceSnapshotReaderLive);

package/README.md

@@ -0,0 +1,72 @@
+# @savvy-web/cli
+
+[![npm](https://img.shields.io/npm/v/@savvy-web%2Fcli?label=npm&color=cb3837)](https://www.npmjs.com/package/@savvy-web/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-4caf50.svg)](https://opensource.org/licenses/MIT)
+
+The `savvy` binary — one command for the everyday dev tooling in a [Silk Suite](https://github.com/savvy-web/systems) project. It sets up changeset, commit and lint conventions, checks them and runs the git hooks behind them, replacing the three separate `savvy-changesets`, `savvy-commit` and `savvy-lint` bins.
+
+## Install
+
+```bash
+npm install --save-dev @savvy-web/cli
+# or
+pnpm add -D @savvy-web/cli
+```
+
+Most projects install [`@savvy-web/silk`](https://www.npmjs.com/package/@savvy-web/silk) instead, which pulls in `@savvy-web/cli` along with the matching suite versions and the config files the `savvy` commands expect.
+
+## Quick start
+
+Set up a project, then check it:
+
+```bash
+npx savvy init
+# initializes changeset, commit and lint conventions in one pass
+
+npx savvy check
+# runs the changeset, commit and lint checks; exits non-zero on the first failure
+```
+
+The command groups map to the tools they manage:
+
+```bash
+npx savvy commit check
+# validates the staged commit message against the conventional-commit rules
+
+npx savvy changeset version
+# applies pending changesets and bumps package versions
+
+npx savvy lint fmt package-json
+# formats package.json files to the Silk Suite conventions
+```
+
+## Commands
+
+- `savvy init` — orchestrator that runs changeset, commit and lint setup in one pass.
+- `savvy check` — orchestrator that runs all three checks and short-circuits on the first failure.
+- `savvy commit` — commit-message validation plus the husky hook handlers (session-start, pre-commit-message, post-commit-verify, user-prompt-submit).
+- `savvy changeset` — changeset init, check, lint, transform, version, classify, branch analysis, release-surface and config inspection.
+- `savvy lint` — lint setup, check and formatters for package.json, the pnpm workspace file and YAML.
+
+Each group also exposes per-tool `init` and `check` subcommands under its namespace. Run any command with `--help` to see its full surface:
+
+```bash
+npx savvy changeset --help
+# lists the changeset subcommands and their options
+```
+
+## Programmatic API
+
+The package also exports the assembled command tree and its handlers for embedding `savvy` in another program:
+
+```ts
+import { runCli } from "@savvy-web/cli";
+
+await runCli(process.argv);
+```
+
+The individual command groups (`changesetCommand`, `commitCommand`, `lintCommand`) and their named handlers are exported from the package root.
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@savvy-web/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "description": "The savvy CLI — unified commit, changeset, and lint commands for the Silk Suite",
   "homepage": "https://github.com/savvy-web/systems/tree/main/packages/cli",
@@ -43,6 +43,7 @@
     "!tsconfig.json",
     "!tsdoc.json",
     "841.js",
+    "README.md",
     "bin/savvy.js",
     "index.d.ts",
     "index.js",