adamantite 0.39.0 → 0.41.0

package/README.md

@@ -52,7 +52,6 @@ and agent guidance. After setup, use the scripts written to `package.json`:
 ```sh
 bun run check
 bun run fix
-bun run format
 bun run analyze
 ```
 
@@ -62,9 +61,7 @@ scripts:
 ```sh
 adamantite check
 adamantite fix
-adamantite format
 adamantite analyze
-adamantite monorepo
 ```
 
 ## Non-interactive setup
@@ -77,7 +74,6 @@ npx adamantite init \
   --non-interactive \
   --script check \
   --script fix \
-  --script format \
   --script analyze \
   --preset react \
   --editor vscode \
@@ -89,19 +85,20 @@ npx adamantite init \
 
 Available setup values:
 
-- Scripts: `check`, `fix`, `format`, `analyze`, `check:monorepo`, and `fix:monorepo`.
+- Scripts: `check`, `fix`, and `analyze`. In a detected monorepo, `analyze` also installs
+  Sherif. The legacy `check:monorepo` and `fix:monorepo` values are rejected.
 - Presets: `react`, `nextjs`, `vue`, `jest`, `vitest`, and `node`.
 - Editors: `vscode` and `zed`.
 
 Presets and TypeScript require the `check` or `fix` script. Editor extension installation
-requires an editor. Monorepo scripts require a detected monorepo. GitHub Actions requires a
-compatible script and a supported package manager. Omitted boolean flags are disabled.
+requires an editor. GitHub Actions requires a compatible script and a supported package
+manager. Omitted boolean flags are disabled.
 
 Existing package scripts whose commands differ from Adamantite's are kept and reported
 instead of being replaced. The interactive initializer asks before overwriting them; in
 non-interactive mode, pass `--overwrite-scripts` to replace them. To keep custom flags,
 forward them to the Adamantite command after `--`, e.g.
-`adamantite monorepo -- --ignore-dependency tailwindcss`.
+`adamantite analyze -- --directory packages/app`.
 
 In a detected monorepo, TypeScript setup does not write a root `tsconfig.json`, because a
 catch-all root config makes TypeScript treat all packages as one project. Adamantite
@@ -114,7 +111,7 @@ Run `adamantite --help` or `adamantite <command> --help` for the complete CLI re
 
 ### `adamantite check`
 
-Find lint and type errors without changing files:
+Find formatting, lint, and type errors without changing files:
 
 ```sh
 adamantite check
@@ -123,7 +120,7 @@ adamantite check src
 
 ### `adamantite fix`
 
-Apply safe Oxlint fixes. Suggested and dangerous fixes require explicit flags:
+Apply safe Oxlint fixes, then format the files with Oxfmt. Suggested and dangerous fixes require explicit flags:
 
 ```sh
 adamantite fix
@@ -132,35 +129,51 @@ adamantite fix --dangerous
 adamantite fix --all
 ```
 
-### `adamantite format`
+### `adamantite format` (deprecated)
 
-Format files with Oxfmt, or check formatting without writing:
-
-```sh
-adamantite format
-adamantite format src/index.ts
-adamantite format --check
-```
+`adamantite format` is deprecated and prints a warning. The next release removes it. Use
+`adamantite fix` to apply formatting and `adamantite check` to verify formatting.
 
 ### `adamantite analyze`
 
-Find unused dependencies, exports, and files with Knip. The `--fix` option can remove
+Find unused dependencies, exports, and files with Knip. In a detected monorepo, `analyze`
+first finds dependency consistency problems with Sherif. The `--fix` option can remove
 unused files, so review its effect before use.
 
 ```sh
 adamantite analyze
 adamantite analyze --strict
 adamantite analyze --fix
+adamantite analyze --only unused
+adamantite analyze --only monorepo --fix -- --select highest
 ```
 
-### `adamantite monorepo`
-
-Find dependency consistency problems in a monorepo with Sherif:
-
-```sh
-adamantite monorepo
-adamantite monorepo --fix
-```
+- The `monorepo` stage (Sherif) runs first, and only in a detected monorepo. The `unused`
+  stage (Knip) always runs.
+- Without `--fix`, both stages run and the exit code comes from the first failure. With
+  `--fix`, a Sherif failure skips Knip, because Knip must not remove code against a
+  dependency graph that Sherif did not repair.
+- `--fix` applies to each stage that runs. `--strict` applies to Knip only.
+- `--only monorepo` or `--only unused` runs one stage. `--only monorepo` fails outside a
+  monorepo and with `--strict`.
+- Arguments after `--` go to Knip, or to the stage that `--only` selects.
+- `analyze` runs Sherif without flags. Put project exceptions in the `sherif` field of the
+  root `package.json`, which Sherif reads. The keys are the Sherif CLI options in camelCase:
+  `ignoreDependency`, `ignoreRule`, `ignorePackage`, `select`, `noInstall`, and
+  `failOnWarnings`. For example: `"sherif": { "ignoreDependency": ["tailwindcss"] }`.
+- A Sherif fix that must choose between versions prompts in a terminal. Without a terminal,
+  set `"sherif": { "select": "highest" }` in the root `package.json`, or run
+  `adamantite analyze --only monorepo --fix -- --select highest`.
+- Use `--fix` locally, not in CI. Sherif refuses to fix in a CI environment (for example when
+  `CI` is set), so `analyze --fix` fails there in a monorepo. CI runs `adamantite analyze`
+  without `--fix`.
+
+### `adamantite monorepo` (deprecated)
+
+`adamantite monorepo` is deprecated and prints a warning with the replacement command. The
+next release removes it. Use `adamantite analyze`, or `adamantite analyze --only monorepo`
+to run only Sherif. `adamantite doctor` reports the legacy `check:monorepo` and
+`fix:monorepo` scripts and says how to remove them.
 
 ### `adamantite doctor`
 
@@ -207,8 +220,7 @@ Commands that invoke Knip, Oxlint, Oxfmt, or Sherif forward arguments after `--`
 ```sh
 adamantite analyze --strict -- --directory packages/app
 adamantite check src -- --deny-warnings
-adamantite format -- --ignore-path .formatignore
-adamantite monorepo -- --ignore-package package-a
+adamantite analyze --only monorepo -- --ignore-package package-a
 ```
 
 Package managers consume one separator, so package scripts need a second one:
@@ -236,7 +248,7 @@ Adamantite publishes configuration that can also be consumed directly:
 | `adamantite/lint/vitest`   | Vitest rules.                                                                                                                                                                                                                                                           |
 | `adamantite/lint/antislop` | Vendored [anti-slop](https://github.com/dmmulroy/anti-slop) rules that reject low-evidence, low-signal patterns. Also turns off `typescript/consistent-indexed-object-style` and `unicorn/no-immediate-mutation` from the core preset, which conflict with these rules. |
 | `adamantite/format`        | Oxfmt configuration.                                                                                                                                                                                                                                                    |
-| `adamantite/analyze`       | Knip configuration.                                                                                                                                                                                                                                                     |
+| `adamantite/analyze`       | Knip configuration. The `ignoreDependencies` named export groups suggested ignore lists; `init` sets `ignoreDependencies.monorepo` in a monorepo.                                                                                                                       |
 | `adamantite/typescript`    | Strict TypeScript configuration for TS 7+.                                                                                                                                                                                                                              |
 
 When consuming the lint presets directly, hoist the core preset's ignore patterns onto the
@@ -265,8 +277,7 @@ Configs generated by `adamantite init` include this automatically.
   them.
 - Adamantite manages recognized package scripts and supported configuration shapes. It
   reports custom configurations that require manual work instead of overwriting them.
-- `fix`, `format`, `analyze --fix`, `monorepo --fix`, `init`, and `update` can change
-  project files. Doctor is read-only.
+- `fix`, `analyze --fix`, `init`, and `update` can change project files. Doctor is read-only.
 
 ## Agent skill