@savvy-web/cli 0.5.0 → 1.1.0

package/README.md

@@ -53,7 +53,7 @@ npx savvy clean --globs dist,.turbo,coverage
 - `savvy check` — orchestrator that runs all three checks and reports every failure (it does not short-circuit).
 - `savvy clean` — removes build and cache artifacts (`dist`, `.turbo`, `coverage`, `node_modules`, `.rslib` by default) from every workspace package (leaves first) and the repo root (last); `--globs` to customize, `--dry-run` to preview.
 - `savvy commit` — the husky/Claude hook handlers (session-start, pre-commit-message, post-commit-verify, user-prompt-submit).
-- `savvy changeset` — changeset lint, transform, version, classify, branch analysis, release-surface and config inspection.
+- `savvy changeset` — changeset lint, check, transform, version, config validation, and dependency changesets.
 - `savvy lint` — formatters for package.json, the pnpm workspace file and YAML.
 
 Run any command with `--help` to see its full surface:

package/cli/index.js

@@ -56,7 +56,7 @@ const rootCommand = Command.make("savvy").pipe(Command.withSubcommands([
 ]));
 const cli = Command.run(rootCommand, {
 	name: "savvy",
-	version: "0.5.0"
+	version: "1.1.0"
 });
 /**
 * Shared base layer: workspace services, the changeset config reader, and the
@@ -91,14 +91,14 @@ const BaseLive = Layer.mergeAll(WorkspaceLive, ChangesetConfigReaderLive, Manage
 * `ToolDiscoveryLive` needs `WorkspaceRoot`, `PackageManagerDetector`, and
 * `CommandExecutor`; `VersioningStrategyLive` needs `ChangesetConfigReader`;
 * `Changesets.ConfigInspectorLive` needs `ChangesetConfigReader`,
-* `WorkspaceDiscovery`, and `FileSystem` (the last for its release-surface
+* `WorkspaceDiscovery`, and `FileSystem` (the last for its publishConfig-driven
 * fallback when no explicit `packages` record is configured);
 * `Changesets.BranchAnalyzerLive` needs `ConfigInspector`.
 *
 * `ConfigInspectorLive` is built once via {@link Layer.provideMerge}: the merge
 * feeds that single `ConfigInspector` instance into `BranchAnalyzerLive` AND
-* re-exposes it for the `classify` / `config` handlers that yield it directly,
-* so it is never constructed twice per run.
+* re-exposes it for the surviving `config validate` handler that yields it
+* directly, so it is never constructed twice per run.
 *
 * `provideMerge(BaseLive)` feeds the remaining deps and re-exposes the base
 * services for handlers that yield them directly. `provideMerge(NodeContext.layer)`

package/commands/changeset/commands/check.js

@@ -68,4 +68,4 @@ function runChangesetCheck(dir) {
 const checkCommand = Command.make("check", { dir: dirArg }, ({ dir }) => runChangesetCheck(dir)).pipe(Command.withDescription("Full changeset validation with summary"));
 
 //#endregion
-export { runChangesetCheck };
+export { checkCommand, runChangesetCheck };

package/commands/changeset/commands/deps-detect.js

@@ -1,6 +1,6 @@
 import { Command, Options } from "@effect/cli";
 import { Changesets } from "@savvy-web/silk-effects";
-import { Effect, Option } from "effect";
+import { Console, Effect, Option } from "effect";
 import { WorkspaceDiscovery } from "workspaces-effect";
 import { resolve } from "node:path";
 
@@ -15,8 +15,8 @@ import { resolve } from "node:path";
 *
 * Defaults:
 * - `--from` → `git merge-base <baseBranch> HEAD`
-* - `--to`   → working tree (i.e., `HEAD` plus staged + unstaged + untracked,
-*   matching `analyze-branch`'s coverage). Passed as the special value
+* - `--to`   → working tree (i.e., `HEAD` plus staged + unstaged + untracked).
+*   Passed as the special value
 *   `WORKTREE` to {@link WorkspaceSnapshotReader} — implementations resolve
 *   this against the live working tree rather than `git show`.
 *
@@ -86,7 +86,7 @@ function runDepsDetect(cwd, from, to, pkg, json, markdown) {
 			yield* Effect.log(renderMarkdownBlocks(diffs));
 			return;
 		}
-		yield* Effect.log(JSON.stringify(diffs, null, 2));
+		yield* Console.log(JSON.stringify(diffs, null, 2));
 	});
 }
 /* v8 ignore next 7 */

package/commands/changeset/commands/deps-regen.js

@@ -1,6 +1,6 @@
 import { Command, Options } from "@effect/cli";
 import { Changesets } from "@savvy-web/silk-effects";
-import { Effect, Option } from "effect";
+import { Console, Effect, Option } from "effect";
 import { WorkspaceDiscovery } from "workspaces-effect";
 import { join, resolve } from "node:path";
 import { existsSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
@@ -231,7 +231,7 @@ function runDepsRegen(cwd, base, pkg, dryRun, json) {
 			skippedMixed
 		};
 		if (dryRun) {
-			if (json) yield* Effect.log(JSON.stringify(plan, null, 2));
+			if (json) yield* Console.log(JSON.stringify(plan, null, 2));
 			else yield* renderHumanPlan(plan);
 			return;
 		}
@@ -241,7 +241,7 @@ function runDepsRegen(cwd, base, pkg, dryRun, json) {
 			yield* Effect.logWarning(`Failed to delete ${entry.file}: ${error instanceof Error ? error.message : String(error)}`);
 		}
 		for (const entry of toWrite) writeFileSync(entry.file, renderChangesetContent(entry.diff));
-		if (json) yield* Effect.log(JSON.stringify(plan, null, 2));
+		if (json) yield* Console.log(JSON.stringify(plan, null, 2));
 		else yield* renderHumanPlan(plan);
 	});
 }

package/commands/changeset/commands/init.js

@@ -1,4 +1,3 @@
-import { Command, Options } from "@effect/cli";
 import { Changesets } from "@savvy-web/silk-effects";
 import { Data, Effect, Schema } from "effect";
 import { WorkspaceRoot } from "workspaces-effect";
@@ -33,8 +32,7 @@ import { applyEdits, modify, parse } from "jsonc-effect";
 *
 * @remarks
 * `runChangesetInit` backs the changeset step of the unified `savvy init`
-* orchestrator; there is no standalone `savvy changeset init` subcommand. The
-* exported `initCommand` is retained only as a direct test entry point.
+* orchestrator; there is no standalone `savvy changeset init` subcommand.
 *
 * @example
 * ```bash
@@ -105,12 +103,6 @@ var InitError = class extends InitErrorBase {
 		return `Init failed at ${this.step}: ${this.reason}`;
 	}
 };
-/* v8 ignore start -- CLI option definitions; handler functions tested individually */
-const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite existing config files"));
-const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Silence warnings, always exit 0"));
-const skipMarkdownlintOption = Options.boolean("skip-markdownlint").pipe(Options.withDescription("Skip registering rules in base markdownlint config"));
-const checkOption = Options.boolean("check").pipe(Options.withDescription("Check configuration without writing (for postinstall scripts)"));
-/* v8 ignore stop */
 /**
 * Detect the `owner/repo` slug from the git remote origin URL.
 *
@@ -621,14 +613,6 @@ function runChangesetInit(opts) {
 		}
 	})));
 }
-/* v8 ignore start -- CLI orchestration; individual functions tested separately */
-const initCommand = Command.make("init", {
-	force: forceOption,
-	quiet: quietOption,
-	skipMarkdownlint: skipMarkdownlintOption,
-	check: checkOption
-}, (opts) => runChangesetInit(opts)).pipe(Command.withDescription("Bootstrap a repo for @savvy-web/changesets"));
-/* v8 ignore stop */
 
 //#endregion
 export { runChangesetInit };

package/commands/changeset/commands/lint.js

@@ -1,6 +1,6 @@
 import { Args, Command, Options } from "@effect/cli";
 import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
+import { Console, Effect } from "effect";
 import { resolve } from "node:path";
 
 //#region src/commands/changeset/commands/lint.ts
@@ -47,8 +47,8 @@ function runLint(dir, quiet) {
 	return Effect.gen(function* () {
 		const resolved = resolve(dir);
 		const messages = yield* Effect.try(() => ChangesetLinter.validate(resolved));
-		for (const msg of messages) yield* Effect.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
-		if (!quiet && messages.length === 0) yield* Effect.log("No lint errors found.");
+		for (const msg of messages) yield* Console.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
+		if (!quiet && messages.length === 0) yield* Console.log("No lint errors found.");
 		if (messages.length > 0) process.exitCode = 1;
 	});
 }

package/commands/changeset/index.js

@@ -1,30 +1,24 @@
-import { analyzeBranchCommand } from "./commands/analyze-branch.js";
-import { classifyCommand } from "./commands/classify.js";
-import { configShowCommand } from "./commands/config-show.js";
+import { checkCommand, runChangesetCheck } from "./commands/check.js";
 import { configValidateCommand } from "./commands/config-validate.js";
 import { depsDetectCommand } from "./commands/deps-detect.js";
 import { depsRegenCommand } from "./commands/deps-regen.js";
 import { lintCommand } from "./commands/lint.js";
-import { releaseSurfaceCommand } from "./commands/release-surface.js";
 import { transformCommand } from "./commands/transform.js";
 import { validateFileCommand } from "./commands/validate-file.js";
 import { versionCommand } from "./commands/version.js";
-import { runChangesetCheck } from "./commands/check.js";
 import { runChangesetInit } from "./commands/init.js";
 import { Command } from "@effect/cli";
 
 //#region src/commands/changeset/index.ts
 /* v8 ignore start -- CLI registration; each command tested via exported handler */
-const configGroup = Command.make("config").pipe(Command.withSubcommands([configShowCommand, configValidateCommand]), Command.withDescription("Inspect or validate .changeset/config.json"));
+const configGroup = Command.make("config").pipe(Command.withSubcommands([configValidateCommand]), Command.withDescription("Inspect or validate .changeset/config.json"));
 const depsGroup = Command.make("deps").pipe(Command.withSubcommands([depsDetectCommand, depsRegenCommand]), Command.withDescription("Generate or regenerate dependency changesets"));
 const _changesetCommand = Command.make("changeset").pipe(Command.withSubcommands([
 	lintCommand,
+	checkCommand,
 	transformCommand,
 	validateFileCommand,
 	versionCommand,
-	classifyCommand,
-	analyzeBranchCommand,
-	releaseSurfaceCommand,
 	configGroup,
 	depsGroup
 ]), Command.withDescription("Section-aware changeset tooling"));

package/commands/commit/check.js

@@ -1,6 +1,5 @@
-import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
+import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
 import { SECTION_DEF, savvyCommitBlock } from "./init.js";
-import { Command } from "@effect/cli";
 import { CheckResult, Commitlint, ManagedSection, SavvyBaseSection, SavvyHooksSection, VersioningStrategy, savvyBasePreamble, savvyHooksHygiene } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 import { WorkspaceDiscovery } from "workspaces-effect";
@@ -133,7 +132,11 @@ function runCommitCheck() {
 				yield* Effect.log(`${BULLET} Commit section: not found (run 'savvy init' to add)`);
 			}
 		}
-		for (const hookPath of [POST_CHECKOUT_HOOK_PATH, POST_MERGE_HOOK_PATH]) {
+		for (const hookPath of [
+			POST_CHECKOUT_HOOK_PATH,
+			POST_MERGE_HOOK_PATH,
+			POST_COMMIT_HOOK_PATH
+		]) {
 			if (!(yield* fs.exists(hookPath))) {
 				sectionsHealthy = false;
 				yield* Effect.log(`${BULLET} Hygiene hook: ${hookPath} not found (run 'savvy init' to add)`);
@@ -163,8 +166,6 @@ function runCommitCheck() {
 		else yield* Effect.log(`${"✓"} Commitlint is configured correctly.`);
 	});
 }
-/* v8 ignore next 3 -- CLI registration; handler tested via runCommitCheck */
-const checkCommand = Command.make("check", {}, () => runCommitCheck()).pipe(Command.withDescription("Check current commitlint configuration and detected settings"));
 
 //#endregion
 export { runCommitCheck };

package/commands/commit/constants.js

@@ -5,6 +5,8 @@ const HUSKY_HOOK_PATH = ".husky/commit-msg";
 const POST_CHECKOUT_HOOK_PATH = ".husky/post-checkout";
 /** Husky post-merge hook path (savvy-hooks hygiene). */
 const POST_MERGE_HOOK_PATH = ".husky/post-merge";
+/** Husky post-commit hook path (savvy-hooks hygiene). */
+const POST_COMMIT_HOOK_PATH = ".husky/post-commit";
 
 //#endregion
-export { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_MERGE_HOOK_PATH };
+export { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH };

package/commands/commit/init.js

@@ -1,5 +1,4 @@
-import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
-import { Command, Options } from "@effect/cli";
+import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
 import { ManagedSection, SavvyBaseSection, SavvyHooksSection, SectionDefinition, savvyBasePreamble, savvyHooksHygiene, savvyToolSection } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 import { dirname } from "node:path";
@@ -14,13 +13,11 @@ import { chmod } from "node:fs/promises";
 */
 /** Executable file permission mode. */
 const EXECUTABLE_MODE = 493;
-/** Default path for the commitlint config file. */
-const DEFAULT_CONFIG_PATH = "lib/configs/commitlint.config.ts";
 /** Section definition for the savvy-commit tool section (identity for read/check/remove). */
 const SECTION_DEF = SectionDefinition.make({ toolName: "savvy-commit" });
 /** Header written when creating a fresh commit-msg hook. */
 const COMMIT_MSG_HEADER = "#!/usr/bin/env sh\n# Commit-msg hook with savvy managed sections\n# Custom hooks can go above, below, or between the managed sections\n\n";
-/** Header written when creating a fresh hygiene hook (post-checkout / post-merge). */
+/** Header written when creating a fresh hygiene hook (post-checkout / post-merge / post-commit). */
 const HYGIENE_HEADER = "#!/usr/bin/env sh\n# Managed by savvy-hooks\n# Custom hooks can go above or below the managed section\n\n";
 /**
 * Build the commitlint command run inside the savvy-commit tool section.
@@ -49,10 +46,6 @@ function ensureHookFile(path, header) {
 		if (!(yield* fs.exists(path))) yield* fs.writeFileString(path, header);
 	});
 }
-/* v8 ignore start -- CLI option definitions; handler tested individually */
-const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite the commit-msg hook and config file entirely (managed sections in post-checkout/post-merge are never force-reset)"), Options.withDefault(false));
-const configOption = Options.text("config").pipe(Options.withAlias("c"), Options.withDescription("Relative path for the commitlint config file (from repo root)"), Options.withDefault(DEFAULT_CONFIG_PATH));
-/* v8 ignore stop */
 /** Content for the commitlint config file. */
 const CONFIG_CONTENT = `import { CommitlintConfig } from "@savvy-web/silk/commitlint";
 
@@ -89,7 +82,11 @@ function runCommitInit(opts) {
 		const commitResults = yield* ms.syncMany(HUSKY_HOOK_PATH, [SavvyBaseSection.block(savvyBasePreamble()), savvyCommitBlock(config)]);
 		yield* makeExecutable(HUSKY_HOOK_PATH);
 		yield* Effect.log(`${"✓"} ${force ? "Replaced" : "Synced"} ${HUSKY_HOOK_PATH} (${commitResults.map((r) => r._tag).join(", ")})`);
-		for (const hookPath of [POST_CHECKOUT_HOOK_PATH, POST_MERGE_HOOK_PATH]) {
+		for (const hookPath of [
+			POST_CHECKOUT_HOOK_PATH,
+			POST_MERGE_HOOK_PATH,
+			POST_COMMIT_HOOK_PATH
+		]) {
 			yield* ensureHookFile(hookPath, HYGIENE_HEADER);
 			yield* ms.sync(hookPath, SavvyHooksSection.block(savvyHooksHygiene()));
 			yield* makeExecutable(hookPath);
@@ -105,23 +102,6 @@ function runCommitInit(opts) {
 		yield* Effect.log("\nDone! Install @commitlint/cli if not already installed.");
 	});
 }
-/**
-* Init command implementation.
-*
-* @remarks
-* Writes:
-* - `.husky/commit-msg` — savvy-base preamble + savvy-commit tool section.
-* - `.husky/post-checkout` and `.husky/post-merge` — savvy-hooks hygiene
-*   (co-owned with `@savvy-web/lint-staged`; idempotent).
-* - The commitlint config file.
-*
-* Users may add custom commands above, below, or between the managed sections.
-*/
-/* v8 ignore next 3 -- CLI registration; handler tested via runCommitInit */
-const initCommand = Command.make("init", {
-	force: forceOption,
-	config: configOption
-}, (opts) => runCommitInit(opts)).pipe(Command.withDescription("Initialize commitlint configuration and husky hooks"));
 
 //#endregion
 export { SECTION_DEF, runCommitInit, savvyCommitBlock };

package/commands/lint/check.js

@@ -1,4 +1,3 @@
-import { Command, Options } from "@effect/cli";
 import { CheckResult, ConfigDiscovery, Lint, ManagedSection, SavvyBaseSection, SavvyHooksSection, ToolDefinition, ToolDiscovery, savvyBasePreamble, savvyHooksHygiene } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 import { parse } from "jsonc-effect";
@@ -133,9 +132,6 @@ function checkBiomeSchemas() {
 		};
 	});
 }
-/* v8 ignore start -- CLI option definition; handler tested individually */
-const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Only output warnings (for postinstall usage)"), Options.withDefault(false));
-/* v8 ignore stop */
 /**
 * Run the lint check validation pipeline.
 *
@@ -191,7 +187,11 @@ function runLintCheck(opts) {
 			warnings.push(`${WARNING}  No husky pre-commit hook found.\n   Run 'savvy init' to create it.`);
 		}
 		if (!foundConfig) warnings.push(`${WARNING}  No lint-staged config file found.\n   Run 'savvy init' to create one.`);
-		const shellHookPaths = [Lint.POST_CHECKOUT_HOOK_PATH, Lint.POST_MERGE_HOOK_PATH];
+		const shellHookPaths = [
+			Lint.POST_CHECKOUT_HOOK_PATH,
+			Lint.POST_MERGE_HOOK_PATH,
+			Lint.POST_COMMIT_HOOK_PATH
+		];
 		const shellHookStatuses = [];
 		for (const hookPath of shellHookPaths) {
 			if (!(yield* fs.exists(hookPath))) {
@@ -299,8 +299,6 @@ function runLintCheck(opts) {
 		else yield* Effect.log(`${CHECK_MARK} Lint-staged is configured correctly.`);
 	});
 }
-/* v8 ignore next 3 -- CLI registration; handler tested via runLintCheck */
-const checkCommand = Command.make("check", { quiet: quietOption }, (opts) => runLintCheck(opts)).pipe(Command.withDescription("Check current lint-staged configuration and tool availability"));
 
 //#endregion
 export { runLintCheck };

package/commands/lint/init.js

@@ -1,4 +1,3 @@
-import { Command, Options } from "@effect/cli";
 import { BiomeSchemaSync, Lint, ManagedSection, SavvyBaseSection, SavvyHooksSection, savvyBasePreamble, savvyHooksHygiene } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 import { dirname } from "node:path";
@@ -26,7 +25,7 @@ const JSONC_FORMAT = {
 };
 /** Header written when creating a fresh pre-commit hook. */
 const PRE_COMMIT_HEADER = "#!/usr/bin/env sh\n# Pre-commit hook with savvy managed sections\n# Custom hooks can go above, below, or between the managed sections\n\n";
-/** Header written when creating a fresh hygiene hook (post-checkout / post-merge). */
+/** Header written when creating a fresh hygiene hook (post-checkout / post-merge / post-commit). */
 const HYGIENE_HEADER = "#!/usr/bin/env sh\n# Managed by savvy-hooks\n# Custom hooks can go above or below the managed section\n\n";
 /**
 * Check if a preset includes the ShellScripts handler.
@@ -127,15 +126,6 @@ function syncBiomeSchemas() {
 		for (const configPath of result.updated) yield* Effect.log(`${CHECK_MARK} Updated $schema in ${configPath}`);
 	});
 }
-/* v8 ignore start -- CLI option definitions; handler tested individually */
-const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite the pre-commit hook and config file entirely (managed sections in post-checkout/post-merge are never force-reset)"), Options.withDefault(false));
-const configOption = Options.text("config").pipe(Options.withAlias("c"), Options.withDescription("Relative path for the lint-staged config file (from repo root)"), Options.withDefault(Lint.DEFAULT_CONFIG_PATH));
-const presetOption = Options.choice("preset", [
-	"minimal",
-	"standard",
-	"silk"
-]).pipe(Options.withAlias("p"), Options.withDescription("Preset to use: minimal, standard, or silk"), Options.withDefault("silk"));
-/* v8 ignore stop */
 /** Make a file executable. */
 function makeExecutable(path) {
 	return Effect.tryPromise({
@@ -174,7 +164,11 @@ function runLintInit(opts) {
 		const preCommitResults = yield* ms.syncMany(Lint.HUSKY_HOOK_PATH, [SavvyBaseSection.block(savvyBasePreamble()), Lint.savvyLintBlock(config)]);
 		yield* makeExecutable(Lint.HUSKY_HOOK_PATH);
 		yield* Effect.log(`${CHECK_MARK} ${force ? "Replaced" : "Synced"} ${Lint.HUSKY_HOOK_PATH} (${preCommitResults.map((r) => r._tag).join(", ")})`);
-		if (presetIncludesShellScripts(preset)) for (const hookPath of [Lint.POST_CHECKOUT_HOOK_PATH, Lint.POST_MERGE_HOOK_PATH]) {
+		if (presetIncludesShellScripts(preset)) for (const hookPath of [
+			Lint.POST_CHECKOUT_HOOK_PATH,
+			Lint.POST_MERGE_HOOK_PATH,
+			Lint.POST_COMMIT_HOOK_PATH
+		]) {
 			yield* ensureHookFile(hookPath, HYGIENE_HEADER);
 			yield* ms.remove(hookPath, Lint.LegacySavvyLintHygieneDef);
 			yield* ms.sync(hookPath, SavvyHooksSection.block(savvyHooksHygiene()));
@@ -193,29 +187,6 @@ function runLintInit(opts) {
 		yield* Effect.log("\nDone! Lint-staged is ready to use.");
 	});
 }
-/**
-* Init command implementation.
-*
-* @remarks
-* Writes:
-* - `.husky/pre-commit` — `savvy-base` preamble + `savvy-lint` tool section, in order
-*   (via `ManagedSection.syncMany`).
-* - `.husky/post-checkout` and `.husky/post-merge` — co-owned `savvy-hooks` hygiene
-*   (idempotent, shared with `@savvy-web/commitlint`). Migrates legacy `SAVVY-LINT`
-*   hygiene blocks by removing them before writing the new section.
-* - `lib/configs/.markdownlint-cli2.jsonc` config (when preset includes Markdown).
-* - lint-staged config at the specified path.
-*
-* Users may add custom commands above, below, or between the managed sections.
-* `--force` resets only the pre-commit hook and the config file; the hygiene sections
-* are always reconciled with `sync`.
-*/
-/* v8 ignore next 3 -- CLI registration; handler tested via runLintInit */
-const initCommand = Command.make("init", {
-	force: forceOption,
-	config: configOption,
-	preset: presetOption
-}, (opts) => runLintInit(opts)).pipe(Command.withDescription("Initialize lint-staged configuration and husky hooks"));
 
 //#endregion
 export { runLintInit };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/cli",
-	"version": "0.5.0",
+	"version": "1.1.0",
 	"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",
@@ -31,9 +31,12 @@
 	},
 	"dependencies": {
 		"@effect/cli": "^0.75.2",
+		"@effect/cluster": "^0.59.0",
 		"@effect/platform": "^0.96.1",
 		"@effect/platform-node": "^0.107.0",
-		"@savvy-web/silk-effects": "1.1.0",
+		"@effect/rpc": "^0.75.1",
+		"@effect/sql": "^0.51.1",
+		"@savvy-web/silk-effects": "1.2.0",
 		"effect": "^3.21.3",
 		"jsonc-effect": "^0.2.1",
 		"workspaces-effect": "^1.2.0",

package/commands/changeset/commands/analyze-branch.js

@@ -1,108 +0,0 @@
-import { Command, Options } from "@effect/cli";
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect, Option } from "effect";
-import { resolve } from "node:path";
-
-//#region src/commands/changeset/commands/analyze-branch.ts
-/**
-* `analyze-branch` command -- diff the current branch and classify every
-* changed file.
-*
-* @remarks
-* Wraps {@link BranchAnalyzer.analyzeBranch}. Returns the merge-base SHA,
-* the per-file classification, the deduped package list affected by the
-* branch, and the list of paths that didn't map to any release surface
-* (candidates for an AskUserQuestion in agent workflows).
-*
-* @example
-* ```bash
-* savvy changeset analyze-branch
-* savvy changeset analyze-branch --base main --json
-* savvy changeset analyze-branch --cwd ./project --base develop
-* ```
-*
-* @internal
-*/
-const { BranchAnalyzer } = Changesets;
-/* v8 ignore start -- CLI option definitions */
-const cwdOption = Options.directory("cwd").pipe(Options.withDescription("Project root (defaults to the current working directory)"), Options.withDefault("."));
-const baseOption = Options.text("base").pipe(Options.withDescription("Override the base branch (defaults to config baseBranch or origin/HEAD)"), Options.optional);
-const jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
-/* v8 ignore stop */
-/**
-* Render a {@link BranchAnalysis} as human-readable text.
-*
-* @internal
-*/
-function renderHuman(analysis) {
-	const lines = [];
-	lines.push(`Base branch:    ${analysis.baseBranch}`);
-	lines.push(`Merge base SHA: ${analysis.mergeBaseSha}`);
-	lines.push("");
-	if (analysis.packagesAffected.length > 0) {
-		lines.push(`Packages affected (${analysis.packagesAffected.length}):`);
-		for (const p of analysis.packagesAffected) lines.push(`  ${p}`);
-	} else lines.push("Packages affected: (none)");
-	lines.push("");
-	if (analysis.files.length === 0) lines.push("Changes: (no files changed)");
-	else {
-		lines.push(`Changes (${analysis.files.length}):`);
-		const statusGlyph = {
-			added: "A",
-			modified: "M",
-			deleted: "D",
-			renamed: "R",
-			copied: "C",
-			typechange: "T",
-			unmerged: "U",
-			unknown: "?"
-		};
-		for (const f of analysis.files) {
-			const glyph = statusGlyph[f.status] ?? "?";
-			const owner = f.package ?? "<unmapped>";
-			const reason = f.reason === "workspace" ? "workspace" : f.reason !== null ? `${f.reason.kind}: ${f.reason.glob}` : "—";
-			lines.push(`  ${glyph}  ${f.path}\t${owner}\t${reason}`);
-		}
-	}
-	if (analysis.unmappedFiles.length > 0) {
-		lines.push("");
-		lines.push(`Unmapped (${analysis.unmappedFiles.length}):`);
-		for (const p of analysis.unmappedFiles) lines.push(`  ${p}`);
-	}
-	return lines.join("\n");
-}
-/**
-* Resolve cwd + base branch, invoke `BranchAnalyzer.analyzeBranch`, and
-* render the result. Sets `process.exitCode = 1` on `ConfigurationError`
-* or `GitError`.
-*
-* @internal
-*/
-function runAnalyzeBranch(cwd, base, json) {
-	return Effect.gen(function* () {
-		const analyzer = yield* BranchAnalyzer;
-		const resolvedCwd = resolve(cwd);
-		const baseBranch = Option.getOrUndefined(base);
-		const analysis = yield* analyzer.analyzeBranch(resolvedCwd, baseBranch ? { baseBranch } : void 0).pipe(Effect.catchTags({
-			ConfigurationError: (err) => {
-				process.exitCode = 1;
-				return Effect.fail(err);
-			},
-			GitError: (err) => {
-				process.exitCode = 1;
-				return Effect.fail(err);
-			}
-		}));
-		const output = json ? JSON.stringify(analysis, null, 2) : renderHuman(analysis);
-		yield* Effect.log(output);
-	});
-}
-/* v8 ignore next 6 -- CLI registration */
-const analyzeBranchCommand = Command.make("analyze-branch", {
-	cwd: cwdOption,
-	base: baseOption,
-	json: jsonOption
-}, ({ cwd, base, json }) => runAnalyzeBranch(cwd, base, json)).pipe(Command.withDescription("Diff the current branch and classify every changed file by owning package"));
-
-//#endregion
-export { analyzeBranchCommand };

package/commands/changeset/commands/classify.js

@@ -1,69 +0,0 @@
-import { Args, Command, Options } from "@effect/cli";
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
-import { resolve } from "node:path";
-
-//#region src/commands/changeset/commands/classify.ts
-/**
-* `classify` command -- map one or more paths to their owning package.
-*
-* @remarks
-* Wraps {@link ConfigInspector.classify}. Each path resolves to a package
-* via (in order): workspace match → `additionalScopes` glob → `versionFiles`
-* glob → `null` (unmapped).
-*
-* @example
-* ```bash
-* savvy changeset classify packages/foo/src/index.ts plugin/SKILL.md
-* savvy changeset classify --cwd ./monorepo plugin/x.md --json
-* ```
-*
-* @internal
-*/
-const { ConfigInspector } = Changesets;
-/* v8 ignore start -- CLI option definitions */
-const pathsArg = Args.text({ name: "path" }).pipe(Args.repeated);
-const cwdOption = Options.directory("cwd").pipe(Options.withDescription("Project root (defaults to the current working directory)"), Options.withDefault("."));
-const jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
-/* v8 ignore stop */
-/**
-* Format a single {@link Classification} as a human-readable line.
-*
-* @internal
-*/
-function renderClassificationLine(c) {
-	if (c.package === null) return `${c.path}\t<unmapped>`;
-	if (c.reason === "workspace") return `${c.path}\t${c.package}\tworkspace`;
-	if (c.reason !== null) return `${c.path}\t${c.package}\t${c.reason.kind}: ${c.reason.glob}`;
-	return `${c.path}\t${c.package}`;
-}
-/**
-* Resolve the cwd, invoke `ConfigInspector.classify`, and render the result.
-* Sets `process.exitCode = 1` on `ConfigurationError`.
-*
-* @internal
-*/
-function runClassify(cwd, paths, json) {
-	return Effect.gen(function* () {
-		const inspector = yield* ConfigInspector;
-		const resolvedCwd = resolve(cwd);
-		const classifications = yield* inspector.classify(resolvedCwd, paths).pipe(Effect.catchTag("ConfigurationError", (err) => {
-			process.exitCode = 1;
-			return Effect.fail(err);
-		}));
-		if (json) {
-			yield* Effect.log(JSON.stringify(classifications, null, 2));
-			return;
-		}
-		for (const c of classifications) yield* Effect.log(renderClassificationLine(c));
-	});
-}
-/* v8 ignore next 6 -- CLI registration */
-const classifyCommand = Command.make("classify", {
-	paths: pathsArg,
-	cwd: cwdOption,
-	json: jsonOption
-}, ({ paths, cwd, json }) => runClassify(cwd, paths, json)).pipe(Command.withDescription("Map paths to their owning package per .changeset/config.json"));
-
-//#endregion
-export { classifyCommand };

package/commands/changeset/commands/config-show.js

@@ -1,100 +0,0 @@
-import { Args, Command, Options } from "@effect/cli";
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
-import { resolve } from "node:path";
-
-//#region src/commands/changeset/commands/config-show.ts
-/**
-* `config show` command -- emit the resolved `.changeset/config.json`.
-*
-* @remarks
-* Wraps {@link ConfigInspector.inspect} and renders either human-readable
-* output (default) or JSON (`--json` / `--format=json`). The same data shape
-* the agent consumes is what the user sees, so debugging an unexpected
-* classification result becomes a single `savvy changeset config show --json`
-* invocation.
-*
-* @example
-* ```bash
-* savvy changeset config show
-* savvy changeset config show --json
-* savvy changeset config show ./path/to/project --json
-* ```
-*
-* @internal
-*/
-const { ConfigInspector } = Changesets;
-/* v8 ignore start -- CLI option definitions */
-const dirArg = Args.directory({ name: "dir" }).pipe(Args.withDefault("."));
-const jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
-/* v8 ignore stop */
-/**
-* Render an {@link InspectedConfig} as human-readable text.
-*
-* @internal
-*/
-function renderHuman(config) {
-	const lines = [];
-	lines.push(`Config:    ${config.configPath}`);
-	lines.push(`Project:   ${config.projectDir}`);
-	lines.push(`Changelog: ${config.changelog ?? "(none)"}`);
-	lines.push(`Base:      ${config.baseBranch}`);
-	lines.push(`Access:    ${config.access}`);
-	if (config.ignore.length > 0) lines.push(`Ignore:    ${config.ignore.join(", ")}`);
-	if (config.legacyVersionFilesUsed) {
-		lines.push("");
-		lines.push("⚠ This config still uses the deprecated top-level `versionFiles[]`.");
-		lines.push("  Migrate to `packages[<name>].versionFiles` — required for 1.0.0.");
-	}
-	lines.push("");
-	if (config.packages.length === 0) {
-		lines.push("Packages: (none declared)");
-		return lines.join("\n");
-	}
-	lines.push(`Packages (${config.packages.length}):`);
-	for (const pkg of config.packages) {
-		lines.push("");
-		lines.push(`  ${pkg.name}  v${pkg.version}`);
-		lines.push(`    workspace: ${pkg.workspaceDir}`);
-		if (pkg.additionalScopes.length > 0) {
-			lines.push(`    additionalScopes (${pkg.additionalScopes.length}):`);
-			for (const g of pkg.additionalScopes) lines.push(`      - ${g}`);
-			lines.push(`    additionalScopeFiles (${pkg.additionalScopeFiles.length}):`);
-			for (const f of pkg.additionalScopeFiles) lines.push(`      ${f}`);
-		}
-		if (pkg.versionFiles.length > 0) {
-			lines.push(`    versionFiles (${pkg.versionFiles.length}):`);
-			for (const vf of pkg.versionFiles) {
-				lines.push(`      ${vf.glob} → ${vf.paths.join(", ")}  (${vf.matchedFiles.length} file${vf.matchedFiles.length === 1 ? "" : "s"} matched)`);
-				for (const f of vf.matchedFiles) lines.push(`        ${f}`);
-			}
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Resolve the project dir, invoke `ConfigInspector.inspect`, and render the
-* result. Sets `process.exitCode = 1` on `ConfigurationError`.
-*
-* @internal
-*/
-function runConfigShow(dir, json) {
-	return Effect.gen(function* () {
-		const inspector = yield* ConfigInspector;
-		const resolved = resolve(dir);
-		const config = yield* inspector.inspect(resolved).pipe(Effect.catchTag("ConfigurationError", (err) => {
-			process.exitCode = 1;
-			return Effect.fail(err);
-		}));
-		const output = json ? JSON.stringify(config, null, 2) : renderHuman(config);
-		yield* Effect.log(output);
-	});
-}
-/* v8 ignore next 6 -- CLI registration */
-const configShowCommand = Command.make("show", {
-	dir: dirArg,
-	json: jsonOption
-}, ({ dir, json }) => runConfigShow(dir, json)).pipe(Command.withDescription("Print the resolved .changeset/config.json"));
-
-//#endregion
-export { configShowCommand };

package/commands/changeset/commands/release-surface.js

@@ -1,96 +0,0 @@
-import { Args, Command, Options } from "@effect/cli";
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
-import { resolve } from "node:path";
-
-//#region src/commands/changeset/commands/release-surface.ts
-/**
-* `release-surface` command -- list every path owned by a named package.
-*
-* @remarks
-* For a given package name, emits the workspace directory, every
-* `additionalScopes` glob and its materialized files, and every
-* `versionFiles` entry and its targets. Useful for debugging "why is this
-* path attributed to this package?" or "what's actually in this package's
-* release surface right now?"
-*
-* @example
-* ```bash
-* savvy changeset release-surface @savvy-web/changesets
-* savvy changeset release-surface @scope/foo --json
-* ```
-*
-* @internal
-*/
-const { ConfigInspector, ConfigurationError } = Changesets;
-/* v8 ignore start -- CLI option definitions */
-const packageArg = Args.text({ name: "package" });
-const cwdOption = Options.directory("cwd").pipe(Options.withDescription("Project root (defaults to the current working directory)"), Options.withDefault("."));
-const jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
-/* v8 ignore stop */
-/**
-* Render a single package's resolved scope as human-readable text.
-*
-* @internal
-*/
-function renderHuman(pkg) {
-	const lines = [];
-	lines.push(`Package:   ${pkg.name}  v${pkg.version}`);
-	lines.push(`Workspace: ${pkg.workspaceDir}`);
-	if (pkg.additionalScopes.length === 0 && pkg.versionFiles.length === 0) {
-		lines.push("");
-		lines.push("(no additionalScopes or versionFiles — workspace dir is the entire release surface)");
-		return lines.join("\n");
-	}
-	if (pkg.additionalScopes.length > 0) {
-		lines.push("");
-		lines.push(`additionalScopes (${pkg.additionalScopes.length} glob${pkg.additionalScopes.length === 1 ? "" : "s"}):`);
-		for (const g of pkg.additionalScopes) lines.push(`  - ${g}`);
-		lines.push(`Resolved files (${pkg.additionalScopeFiles.length}):`);
-		for (const f of pkg.additionalScopeFiles) lines.push(`  ${f}`);
-	}
-	if (pkg.versionFiles.length > 0) {
-		lines.push("");
-		lines.push(`versionFiles (${pkg.versionFiles.length}):`);
-		for (const vf of pkg.versionFiles) {
-			lines.push(`  ${vf.glob} → ${vf.paths.join(", ")}`);
-			for (const f of vf.matchedFiles) lines.push(`    ${f}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* Resolve cwd, invoke `ConfigInspector.inspect`, find the named package's
-* scope, and render it. Sets `process.exitCode = 1` on any error.
-*
-* @internal
-*/
-function runReleaseSurface(cwd, pkgName, json) {
-	return Effect.gen(function* () {
-		const inspector = yield* ConfigInspector;
-		const resolvedCwd = resolve(cwd);
-		const config = yield* inspector.inspect(resolvedCwd).pipe(Effect.catchTag("ConfigurationError", (err) => {
-			process.exitCode = 1;
-			return Effect.fail(err);
-		}));
-		const scope = config.packages.find((p) => p.name === pkgName);
-		if (!scope) {
-			process.exitCode = 1;
-			return yield* Effect.fail(new ConfigurationError({
-				field: `packages["${pkgName}"]`,
-				reason: `Package "${pkgName}" is not declared in .changeset/config.json#packages. Declared packages: ${config.packages.map((p) => p.name).join(", ") || "(none)"}.`
-			}));
-		}
-		const output = json ? JSON.stringify(scope, null, 2) : renderHuman(scope);
-		yield* Effect.log(output);
-	});
-}
-/* v8 ignore next 6 -- CLI registration */
-const releaseSurfaceCommand = Command.make("release-surface", {
-	package: packageArg,
-	cwd: cwdOption,
-	json: jsonOption
-}, ({ package: pkgName, cwd, json }) => runReleaseSurface(cwd, pkgName, json)).pipe(Command.withDescription("Print every path owned by a package — workspace dir, additionalScopes, versionFiles"));
-
-//#endregion
-export { releaseSurfaceCommand };