@fusion.dev/helix-cli 0.186.1 → 0.187.0

package/README.md

@@ -1,8 +1,8 @@
 # @fusion.dev/helix-cli
 
-The Helix command line. Holds components to the conventions Helix is built on,
-derives themes, scaffolds a project, checks a project's code against the Helix
-it installed, and serves the derivation to an agent.
+The Helix command line. Derives themes, scaffolds a project, checks a project's
+code against the Helix it installed, looks up the installed packages, and serves
+all of it to an agent.
 
 ```sh
 npm install --save-dev @fusion.dev/helix-cli
@@ -15,22 +15,22 @@ the package it's missing. To start a project rather than add Helix to one, use
 `npm create @fusion.dev/helix-app`.
 
 ```sh
-helix component check      # the CI shape: nothing printed on success
-helix component audit      # every rule and what it found
-helix component fix        # the rules that can write
+helix scan                 # your code, judged against the Helix you installed
+helix theme audit          # every contrast pair in your theme
+helix mcp init --client claude
 ```
 
 | Verb | What it does |
 |---|---|
-| `component` | Holds components to the conventions. `--only <rule>` runs one of `attributes` `axes` `corners` `events` `hooks` `parts` `reflected` `seeds` `selectors` `ssr` `stable` `tokens` and the rest |
 | `theme` | `init` a starter intent, `build` it to CSS, `audit` every contrast pair, `check` in CI |
 | `new` | Scaffolds a project from a Helix template |
 | `diagnostics` | Receives the runs `initDiagnostics()` sends from your app and prints each new finding. `--out <path>` writes the CI file, `--port` picks the port, 7417 by default, and `--config <path>` names the settings served to the page |
-| `scan` | Reads your project's stylesheets, templates, and modules, and prints each finding with its file and line. `--build <dir>` weighs each Helix family in your bundle, `--out <path>` writes the run to the CI file, and `--config <path>` names the settings |
-| `mcp` | Serves the derivation to an agent over stdio, as an MCP server |
+| `scan` | Reads your project's stylesheets, templates, and modules, and prints each finding with its file and line. `--build <dir>` weighs each Helix family in your bundle, `--out <path>` writes the run to the CI file, `--config <path>` names the settings, `--file <path>` reports one file's findings, and `--stdin <language>` checks a snippet |
+| `api` | Looks up the installed Helix packages: `find` a family, a `family`'s API, an `example` with its imports, the `imports` for a list of tags, and `tokens` |
+| `mcp` | Serves the same lookups, the scan, and the theme derivation to an agent over stdio, as an MCP server. `mcp init --client claude\|cursor\|vscode` writes the client's configuration |
 
 `--json` is on every verb, in a shape a script can read without parsing
-sentences: the rules, their counts and their findings. `--no-color` is the third
+sentences. `--no-color` is the third
 way to turn color off, for a terminal that reports itself capable and is not.
 Color is already off when stdout is not a terminal and when `NO_COLOR` is set.
 
@@ -39,20 +39,6 @@ rather than compiled into the binary, so one build serves every release that
 changes no Rust. A binary built from a checkout of this repository has no such
 package beside it and says `0.0.0-dev`, which is what that build is.
 
-## What it reads
-
-`component` reads the tiers named by a `helix` key in `fusion.json`, or by
-`helix.json` where the Fusion CLI is not in use. A rule that needs a
-manifest says so rather than reporting a clean tree it never looked at, so a
-fresh clone wants `bun run analyze` before the rules that read one mean anything.
-
-## Two shapes, one measurement
-
-`audit` prints every rule and exits 1 on a finding. `check` runs the same
-measurement and prints nothing on success. Use `audit` while you work and
-`check` in CI, and never both in one script: the difference is what is printed,
-never what is judged.
-
 [Documentation](https://fusion.dev/helix)
 
 MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-cli",
   "description": "The Helix command line, for a workspace that reaches it through npm.",
-  "version": "0.186.1",
+  "version": "0.187.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -29,11 +29,11 @@
     "theme"
   ],
   "optionalDependencies": {
-    "@fusion.dev/helix-cli-darwin-arm64": "0.186.1",
-    "@fusion.dev/helix-cli-darwin-x64": "0.186.1",
-    "@fusion.dev/helix-cli-linux-arm64": "0.186.1",
-    "@fusion.dev/helix-cli-linux-x64": "0.186.1",
-    "@fusion.dev/helix-cli-win32-x64": "0.186.1"
+    "@fusion.dev/helix-cli-darwin-arm64": "0.187.0",
+    "@fusion.dev/helix-cli-darwin-x64": "0.187.0",
+    "@fusion.dev/helix-cli-linux-arm64": "0.187.0",
+    "@fusion.dev/helix-cli-linux-x64": "0.187.0",
+    "@fusion.dev/helix-cli-win32-x64": "0.187.0"
   },
   "publishConfig": {
     "access": "restricted"