@savvy-web/cli 2.11.3 → 3.0.0

package/README.md

@@ -91,12 +91,12 @@ npx savvy changeset --help
 The package also exports the assembled command tree and its handlers for embedding `savvy` in another program:
 
 ```ts
-import { runCli } from "@savvy-web/cli";
+import { main } from "@savvy-web/cli/main";
 
-await runCli(process.argv);
+main();
 ```
 
-The individual command groups (`changesetCommand`, `commitCommand`, `lintCommand`) and their named handlers are exported from the package root.
+The `.` barrel exports the command groups (`changesetCommand`, `commitCommand`, `lintCommand`) and their named handlers only.
 
 ## License
 

package/bin/savvy.js

@@ -1,18 +1,13 @@
 #!/usr/bin/env node
-import { runCli } from "../cli/index.js";
+import { main } from "../main.js";
 
-//#region src/bin/cli.ts
+//#region src/bin.ts
 /**
-* Binary entry point for the `savvy` CLI.
-*
-* This file is the `bin` target in `package.json`. It delegates immediately
-* to {@link runCli} which assembles the `\@effect/cli` command tree and
-* executes it via `\@effect/platform-node`.
-*
+* The `savvy` bin. Imports `main` and calls it. Nothing else, ever.
 * @internal
 */
-/* v8 ignore start -- CLI bootstrap; commands tested individually */
-runCli();
+/* v8 ignore start -- bin shim; covered by the silk bins e2e */
+main();
 /* v8 ignore stop */
 
 //#endregion

package/cli/index.js

@@ -1,18 +1,18 @@
 import { changesetCommand } from "../commands/changeset/index.js";
 import { checkCommand } from "../commands/check.js";
-import { cleanCommand } from "../commands/clean.js";
 import { commitCommand } from "../commands/commit/index.js";
 import { initCommand } from "../commands/init.js";
 import { lintCommand } from "../commands/lint/index.js";
 import { reposCommand } from "../commands/repos/index.js";
-import { NodeRuntime, NodeServices } from "@effect/platform-node";
-import { ToolDiscovery } from "@effected/commands";
+import { cleanCommand } from "../commands/clean.js";
+import { Command } from "effect/unstable/cli";
+import { BiomeSchemaSync, ChangesetConfigReader, Changesets, ConfigDiscovery, Repos, SilkPublishability } from "@savvy-web/silk-effects";
+import { Layer } from "effect";
 import { Git } from "@effected/git";
-import { ManagedSection } from "@effected/templates";
 import { PackageManagerDetector, WorkspaceDiscovery, WorkspaceRoot, Workspaces } from "@effected/workspaces";
-import { BiomeSchemaSync, ChangesetConfigReader, Changesets, ConfigDiscovery, Repos, SilkPublishability } from "@savvy-web/silk-effects";
-import { Effect, Layer } from "effect";
-import { Command } from "effect/unstable/cli";
+import { ManagedSection } from "@effected/templates";
+import { ToolDiscovery } from "@effected/commands";
+import { NodeServices } from "@effect/platform-node";
 
 //#region src/cli/index.ts
 /**
@@ -73,11 +73,6 @@ const rootCommand = Command.make("savvy").pipe(Command.withSubcommands([
 	reposCommand
 ]));
 /**
-* CLI application: reads argv from the Stdio service provided by NodeServices.
-* (v4's `Command.run` takes only `version` — the name comes from the root command.)
-*/
-const cli = Command.run(rootCommand, { version: "2.11.3" });
-/**
 * Shared workspace services from `@effected/workspaces`, wired as a
 * self-contained unit and built ONCE (layers memoize by reference).
 * `WorkspaceDiscovery.layer()` is root-bound at first use via `WorkspaceRoot`
@@ -125,23 +120,14 @@ const ReposGroupLive = Layer.mergeAll(Repos.ReposManager.layer, Repos.ReposDrift
 */
 const LocalExecLive = Workspaces.localExecLayer();
 const ToolDiscoveryGroupLive = ToolDiscovery.layer.pipe(Layer.provide(LocalExecLive), Layer.provide(WorkspaceLive));
-const AppLive = Layer.mergeAll(ToolDiscoveryGroupLive, InspectorAndAnalyzerLive, ReposGroupLive).pipe(Layer.provideMerge(BaseLive), Layer.provideMerge(NodeServices.layer));
 /**
-* Bootstrap and run the `savvy` CLI application.
-*
-* @remarks
-* `Command.run` returns an Effect reading `process.argv` from the Stdio
-* service; the merged layer stack is provided and execution handed to
-* `NodeRuntime.runMain`, whose default reporting covers defects (the v3
-* `Cause.defects` wrapper is gone). No type casts: the layer graph is
-* validated by the compiler.
-*
-* @internal
+* The merged runtime Layer stack satisfying every command's service
+* requirements. Provided to `rootCommand`'s assembled `Command.run` Effect by
+* `main()` in `../main.js`; this module never calls `NodeRuntime.runMain`
+* itself.
 */
-function runCli() {
-	NodeRuntime.runMain(cli.pipe(Effect.provide(AppLive)));
-}
+const AppLive = Layer.mergeAll(ToolDiscoveryGroupLive, InspectorAndAnalyzerLive, ReposGroupLive).pipe(Layer.provideMerge(BaseLive), Layer.provideMerge(NodeServices.layer));
 /* v8 ignore stop */
 
 //#endregion
-export { runCli };
+export { AppLive, rootCommand };

package/commands/changeset/commands/check.js

@@ -1,7 +1,7 @@
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
 import { Argument, Command } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Effect } from "effect";
 
 //#region src/commands/changeset/commands/check.ts
 /**
@@ -27,7 +27,7 @@ import { resolve } from "node:path";
 */
 const { ChangesetLinter } = Changesets;
 /* v8 ignore next */
-const dirArg = Argument.directory("dir").pipe(Argument.withDefault(".changeset"));
+const dirArg = Argument.Directory("dir").pipe(Argument.withDefault(".changeset"));
 /**
 * Run the check validation pipeline on all changeset files in `dir`.
 *

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

@@ -1,7 +1,7 @@
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
 import { Argument, Command } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Effect } from "effect";
 
 //#region src/commands/changeset/commands/config-validate.ts
 /**
@@ -26,7 +26,7 @@ import { resolve } from "node:path";
 */
 const { ConfigInspector } = Changesets;
 /* v8 ignore next */
-const dirArg = Argument.directory("dir").pipe(Argument.withDefault("."));
+const dirArg = Argument.Directory("dir").pipe(Argument.withDefault("."));
 /**
 * Run validation. Logs a one-line OK on success; logs the error and sets
 * `process.exitCode = 1` on failure.

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

@@ -1,7 +1,7 @@
-import { Changesets } from "@savvy-web/silk-effects";
-import { Console, Effect, Option } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Console, Effect, Option } from "effect";
 
 //#region src/commands/changeset/commands/deps-detect.ts
 /**
@@ -29,12 +29,12 @@ import { resolve } from "node:path";
 */
 const { DepsRegen, serializeDependencyTableToMarkdown } = Changesets;
 /* v8 ignore start -- CLI option definitions */
-const fromOption = Flag.string("from").pipe(Flag.withDescription("Older ref to diff from (defaults to merge-base with base branch)"), Flag.optional);
-const toOption = Flag.string("to").pipe(Flag.withDescription("Newer ref to diff to (defaults to working tree)"), Flag.optional);
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Project root (defaults to the current working directory)"), Flag.withDefault("."));
-const packageOption = Flag.string("package").pipe(Flag.withDescription("Restrict output to a single workspace package"), Flag.optional);
-const jsonOption = Flag.boolean("json").pipe(Flag.withDescription("Emit JSON (default)"), Flag.withDefault(false));
-const markdownOption = Flag.boolean("markdown").pipe(Flag.withDescription("Emit one CSH005 markdown block per workspace package"), Flag.withDefault(false));
+const fromOption = Flag.String("from").pipe(Flag.withDescription("Older ref to diff from (defaults to merge-base with base branch)"), Flag.optional);
+const toOption = Flag.String("to").pipe(Flag.withDescription("Newer ref to diff to (defaults to working tree)"), Flag.optional);
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Project root (defaults to the current working directory)"), Flag.withDefault("."));
+const packageOption = Flag.String("package").pipe(Flag.withDescription("Restrict output to a single workspace package"), Flag.optional);
+const jsonOption = Flag.Boolean("json").pipe(Flag.withDescription("Emit JSON (default)"), Flag.withDefault(false));
+const markdownOption = Flag.Boolean("markdown").pipe(Flag.withDescription("Emit one CSH005 markdown block per workspace package"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Render a per-workspace diff as markdown — one frontmatter+section block

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

@@ -1,7 +1,7 @@
-import { Changesets } from "@savvy-web/silk-effects";
-import { Console, Effect, Option } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Console, Effect, Option } from "effect";
 
 //#region src/commands/changeset/commands/deps-regen.ts
 /**
@@ -48,11 +48,11 @@ import { resolve } from "node:path";
 */
 const { DepsRegen } = Changesets;
 /* v8 ignore start -- CLI option definitions */
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Project root (defaults to the current working directory)"), Flag.withDefault("."));
-const baseOption = Flag.string("base").pipe(Flag.withDescription("Override the base branch (defaults to config baseBranch)"), Flag.optional);
-const packageOption = Flag.string("package").pipe(Flag.withDescription("Restrict regeneration to a single workspace package"), Flag.optional);
-const dryRunOption = Flag.boolean("dry-run").pipe(Flag.withDescription("Print the plan without writing or deleting"), Flag.withDefault(false));
-const jsonOption = Flag.boolean("json").pipe(Flag.withDescription("Emit a structured plan as JSON"), Flag.withDefault(false));
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Project root (defaults to the current working directory)"), Flag.withDefault("."));
+const baseOption = Flag.String("base").pipe(Flag.withDescription("Override the base branch (defaults to config baseBranch)"), Flag.optional);
+const packageOption = Flag.String("package").pipe(Flag.withDescription("Restrict regeneration to a single workspace package"), Flag.optional);
+const dryRunOption = Flag.Boolean("dry-run").pipe(Flag.withDescription("Print the plan without writing or deleting"), Flag.withDefault(false));
+const jsonOption = Flag.Boolean("json").pipe(Flag.withDescription("Emit a structured plan as JSON"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Handler exported for direct invocation in tests.

package/commands/changeset/commands/init.js

@@ -1,10 +1,10 @@
-import { Git } from "@effected/git";
-import { WorkspaceRoot } from "@effected/workspaces";
+import { join } from "node:path";
 import { Changesets } from "@savvy-web/silk-effects";
 import { Data, Effect, Option, Result, Schema } from "effect";
-import { join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { Git } from "@effected/git";
 import { Jsonc, JsoncEdit, JsoncModifier } from "@effected/jsonc";
+import { WorkspaceRoot } from "@effected/workspaces";
 
 //#region src/commands/changeset/commands/init.ts
 /**

package/commands/changeset/commands/lint.js

@@ -1,7 +1,7 @@
-import { Changesets } from "@savvy-web/silk-effects";
-import { Console, Effect } from "effect";
 import { Argument, Command, Flag } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Console, Effect } from "effect";
 
 //#region src/commands/changeset/commands/lint.ts
 /**
@@ -28,8 +28,8 @@ import { resolve } from "node:path";
 */
 const { ChangesetLinter } = Changesets;
 /* v8 ignore start -- CLI option definitions; handler tested via runLint */
-const dirArg = Argument.directory("dir").pipe(Argument.withDefault(".changeset"));
-const quietOption = Flag.boolean("quiet").pipe(Flag.withAlias("q"), Flag.withDescription("Only output errors, no summary"), Flag.withDefault(false));
+const dirArg = Argument.Directory("dir").pipe(Argument.withDefault(".changeset"));
+const quietOption = Flag.Boolean("quiet").pipe(Flag.withAlias("q"), Flag.withDescription("Only output errors, no summary"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Run machine-readable lint validation on all changeset files in `dir`.

package/commands/changeset/commands/transform.js

@@ -1,8 +1,8 @@
 import { requireValidConfig } from "../utils/config-gate.js";
-import { Changesets } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
 import { Argument, Command, Flag } from "effect/unstable/cli";
 import { dirname, resolve } from "node:path";
+import { Changesets } from "@savvy-web/silk-effects";
+import { Effect } from "effect";
 import { readFileSync, writeFileSync } from "node:fs";
 
 //#region src/commands/changeset/commands/transform.ts
@@ -38,9 +38,9 @@ import { readFileSync, writeFileSync } from "node:fs";
 */
 const { ChangelogTransformer } = Changesets;
 /* v8 ignore start -- CLI option definitions; handler tested via runTransform */
-const fileArg = Argument.file("file").pipe(Argument.withDefault("CHANGELOG.md"));
-const dryRunOption = Flag.boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Print transformed output instead of writing"), Flag.withDefault(false));
-const checkOption = Flag.boolean("check").pipe(Flag.withAlias("c"), Flag.withDescription("Exit 1 if file would change (for CI)"), Flag.withDefault(false));
+const fileArg = Argument.File("file").pipe(Argument.withDefault("CHANGELOG.md"));
+const dryRunOption = Flag.Boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Print transformed output instead of writing"), Flag.withDefault(false));
+const checkOption = Flag.Boolean("check").pipe(Flag.withAlias("c"), Flag.withDescription("Exit 1 if file would change (for CI)"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Run the remark transform pipeline on a single changelog file.

package/commands/changeset/commands/validate-file.js

@@ -1,6 +1,6 @@
+import { Argument, Command } from "effect/unstable/cli";
 import { Changesets } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command } from "effect/unstable/cli";
 
 //#region src/commands/changeset/commands/validate-file.ts
 /**
@@ -19,7 +19,7 @@ import { Argument, Command } from "effect/unstable/cli";
 */
 const { ChangesetLinter } = Changesets;
 /* v8 ignore next */
-const fileArg = Argument.file("file");
+const fileArg = Argument.File("file");
 /**
 * Run lint validation on a single changeset file.
 *

package/commands/changeset/commands/version.js

@@ -1,7 +1,7 @@
 import { requireValidConfig } from "../utils/config-gate.js";
+import { Command, Flag } from "effect/unstable/cli";
 import { Changesets } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/changeset/commands/version.ts
 /**
@@ -15,7 +15,7 @@ import { Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option definitions; handler tested via runVersion */
-const dryRunOption = Flag.boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Compute and report the release without writing anything"), Flag.withDefault(false));
+const dryRunOption = Flag.Boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Compute and report the release without writing anything"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Validate config, then natively apply (or dry-run) the release via

package/commands/changeset/utils/config-gate.js

@@ -1,6 +1,6 @@
+import { join, resolve } from "node:path";
 import { Changesets } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { join, resolve } from "node:path";
 import { existsSync } from "node:fs";
 
 //#region src/commands/changeset/utils/config-gate.ts

package/commands/check.js

@@ -2,8 +2,8 @@ import { runChangesetCheck } from "./changeset/commands/check.js";
 import "./changeset/index.js";
 import { runCommitCheck } from "./commit/check.js";
 import { runLintCheck } from "./lint/check.js";
-import { Effect, Result } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
+import { Effect, Result } from "effect";
 
 //#region src/commands/check.ts
 /**
@@ -18,15 +18,15 @@ import { Command, Flag } from "effect/unstable/cli";
 * regardless of individual failures and then surface the full set of errors.
 *
 * Runtime layer provision (ManagedSection, FileSystem, WorkspaceRoot,
-* ToolDiscovery, etc.) is deferred to Task B7 (root `runCli`). The Effect
+* ToolDiscovery, etc.) is deferred to Task B7 (root `main`). The Effect
 * returned by `checkCommand`'s handler therefore carries the full union of the
 * three handlers' requirements in its R channel.
 *
 * @internal
 */
 /* v8 ignore start -- CLI option definitions; orchestration logic tested via runCheck */
-const changesetDirOption = Flag.string("changeset-dir").pipe(Flag.withDescription("Path to the changeset directory"), Flag.withDefault(".changeset"));
-const quietOption = Flag.boolean("quiet").pipe(Flag.withAlias("q"), Flag.withDescription("Only output warnings from lint check"), Flag.withDefault(false));
+const changesetDirOption = Flag.String("changeset-dir").pipe(Flag.withDescription("Path to the changeset directory"), Flag.withDefault(".changeset"));
+const quietOption = Flag.Boolean("quiet").pipe(Flag.withAlias("q"), Flag.withDescription("Only output warnings from lint check"), Flag.withDefault(false));
 /* v8 ignore stop */
 /**
 * Run all three check step Effects without short-circuiting.

package/commands/clean.js

@@ -1,7 +1,7 @@
-import { WorkspaceDiscovery } from "@effected/workspaces";
-import { Data, Effect } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
 import { join, sep } from "node:path";
+import { Data, Effect } from "effect";
+import { WorkspaceDiscovery } from "@effected/workspaces";
 import { glob, realpath, rm } from "node:fs/promises";
 
 //#region src/commands/clean.ts
@@ -165,8 +165,8 @@ function runClean(opts) {
 	});
 }
 /* v8 ignore start -- CLI option/registration; orchestration tested via runClean */
-const globsOption = Flag.string("globs").pipe(Flag.withAlias("g"), Flag.withDescription(`Comma-separated glob patterns to remove from each workspace root (default: ${DEFAULT_GLOBS.join(",")})`), Flag.withDefault(DEFAULT_GLOBS.join(",")));
-const dryRunOption = Flag.boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Report what would be removed without deleting anything"), Flag.withDefault(false));
+const globsOption = Flag.String("globs").pipe(Flag.withAlias("g"), Flag.withDescription(`Comma-separated glob patterns to remove from each workspace root (default: ${DEFAULT_GLOBS.join(",")})`), Flag.withDefault(DEFAULT_GLOBS.join(",")));
+const dryRunOption = Flag.Boolean("dry-run").pipe(Flag.withAlias("n"), Flag.withDescription("Report what would be removed without deleting anything"), Flag.withDefault(false));
 const _cleanCommand = Command.make("clean", {
 	globs: globsOption,
 	dryRun: dryRunOption

package/commands/commit/check.js

@@ -1,9 +1,9 @@
 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 { CheckOutcome, ManagedSection } from "@effected/templates";
-import { VersioningStrategy } from "@effected/workspaces";
 import { ChangesetConfigReader, Commitlint, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyToolchainCheck } from "@savvy-web/silk-effects";
 import { Effect, FileSystem, Option } from "effect";
+import { VersioningStrategy } from "@effected/workspaces";
+import { CheckOutcome, ManagedSection } from "@effected/templates";
 
 //#region src/commands/commit/check.ts
 /** Unicode cross symbol. */

package/commands/commit/hooks/post-commit-verify.js

@@ -1,8 +1,8 @@
 import { buildCommitlintInvocation } from "../commitlint-invocation.js";
-import { Git } from "@effected/git";
+import { Command } from "effect/unstable/cli";
 import { Commitlint } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Command } from "effect/unstable/cli";
+import { Git } from "@effected/git";
 import { promisify } from "node:util";
 import { execFile } from "node:child_process";
 

package/commands/commit/hooks/pre-commit-message.js

@@ -1,7 +1,7 @@
-import { Commitlint } from "@savvy-web/silk-effects";
-import { Effect, Schema } from "effect";
 import { Command } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Commitlint } from "@savvy-web/silk-effects";
+import { Effect, Schema } from "effect";
 
 //#region src/commands/commit/hooks/pre-commit-message.ts
 /**

package/commands/commit/hooks/session-start.js

@@ -1,7 +1,7 @@
-import { Commitlint } from "@savvy-web/silk-effects";
-import { Effect } from "effect";
 import { Command } from "effect/unstable/cli";
 import { resolve } from "node:path";
+import { Commitlint } from "@savvy-web/silk-effects";
+import { Effect } from "effect";
 
 //#region src/commands/commit/hooks/session-start.ts
 /**

package/commands/commit/init.js

@@ -1,8 +1,8 @@
 import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
-import { CommentStyle, ManagedSection, SectionId } from "@effected/templates";
+import { dirname } from "node:path";
 import { SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyToolSection, savvyToolchainCheck } from "@savvy-web/silk-effects";
 import { Effect, FileSystem } from "effect";
-import { dirname } from "node:path";
+import { CommentStyle, ManagedSection, SectionId } from "@effected/templates";
 import { chmod } from "node:fs/promises";
 
 //#region src/commands/commit/init.ts

package/commands/commit/lint.js

@@ -1,8 +1,8 @@
 import { buildCommitlintInvocation } from "./commitlint-invocation.js";
-import { Git } from "@effected/git";
+import { Argument, CliError, Command } from "effect/unstable/cli";
 import { Commitlint } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, CliError, Command } from "effect/unstable/cli";
+import { Git } from "@effected/git";
 import { promisify } from "node:util";
 import { execFile } from "node:child_process";
 
@@ -79,7 +79,7 @@ function runCommitLint(file) {
 	});
 }
 /* v8 ignore next */
-const fileArg = Argument.file("file", { mustExist: true });
+const fileArg = Argument.File("file", { mustExist: true });
 /* v8 ignore next 3 -- CLI registration; handler tested via runCommitLint */
 const lintCommand = Command.make("lint", { file: fileArg }, ({ file }) => runCommitLint(file)).pipe(Command.withDescription("Validate a candidate commit-message file against the Silk commitlint preset"));
 

package/commands/init.js

@@ -2,8 +2,8 @@ import { runChangesetInit } from "./changeset/commands/init.js";
 import "./changeset/index.js";
 import { runCommitInit } from "./commit/init.js";
 import { runLintInit } from "./lint/init.js";
-import { Effect } from "effect";
 import { Command, Flag } from "effect/unstable/cli";
+import { Effect } from "effect";
 
 //#region src/commands/init.ts
 /**
@@ -15,7 +15,7 @@ import { Command, Flag } from "effect/unstable/cli";
 * are injected so the orchestration logic is unit-testable in isolation.
 *
 * Runtime layer provision (ManagedSection, FileSystem, WorkspaceRoot,
-* BiomeSchemaSync, etc.) is deferred to Task B7 (root `runCli`). The Effect
+* BiomeSchemaSync, etc.) is deferred to Task B7 (root `main`). The Effect
 * returned by `initCommand`'s handler therefore carries the full union of the
 * three handlers' requirements in its R channel.
 *
@@ -24,10 +24,10 @@ import { Command, Flag } from "effect/unstable/cli";
 const DEFAULT_COMMIT_CONFIG = "lib/configs/commitlint.config.ts";
 const DEFAULT_LINT_CONFIG = "lib/configs/lint-staged.config.ts";
 /* v8 ignore start -- CLI option definitions; orchestration logic tested via runInit */
-const forceOption = Flag.boolean("force").pipe(Flag.withAlias("f"), Flag.withDescription("Overwrite existing config files and hooks across all tools"), Flag.withDefault(false));
-const commitConfigOption = Flag.string("commit-config").pipe(Flag.withDescription("Relative path for the commitlint config file"), Flag.withDefault(DEFAULT_COMMIT_CONFIG));
-const lintConfigOption = Flag.string("lint-config").pipe(Flag.withDescription("Relative path for the lint-staged config file"), Flag.withDefault(DEFAULT_LINT_CONFIG));
-const lintPresetOption = Flag.choice("lint-preset", [
+const forceOption = Flag.Boolean("force").pipe(Flag.withAlias("f"), Flag.withDescription("Overwrite existing config files and hooks across all tools"), Flag.withDefault(false));
+const commitConfigOption = Flag.String("commit-config").pipe(Flag.withDescription("Relative path for the commitlint config file"), Flag.withDefault(DEFAULT_COMMIT_CONFIG));
+const lintConfigOption = Flag.String("lint-config").pipe(Flag.withDescription("Relative path for the lint-staged config file"), Flag.withDefault(DEFAULT_LINT_CONFIG));
+const lintPresetOption = Flag.Literals("lint-preset", [
 	"minimal",
 	"standard",
 	"silk"

package/commands/lint/biome-version.js

@@ -19,7 +19,7 @@
 *
 * @internal
 */
-const BIOME_VERSION = "2.5.12";
+const BIOME_VERSION = "2.5.13";
 
 //#endregion
 export { BIOME_VERSION };

package/commands/lint/check.js

@@ -1,10 +1,10 @@
 import { BIOME_VERSION } from "./biome-version.js";
-import { Tool, ToolDiscovery } from "@effected/commands";
-import { CheckOutcome, ManagedSection } from "@effected/templates";
 import { ConfigDiscovery, Lint, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyToolchainCheck } from "@savvy-web/silk-effects";
 import { Effect, FileSystem, Option } from "effect";
 import { Jsonc } from "@effected/jsonc";
+import { CheckOutcome, ManagedSection } from "@effected/templates";
 import { isDeepStrictEqual } from "node:util";
+import { Tool, ToolDiscovery } from "@effected/commands";
 
 //#region src/commands/lint/check.ts
 /**
@@ -53,6 +53,10 @@ function findConfigFile(fs) {
 /**
 * Find the first existing config file from a list of candidates using ConfigDiscovery.
 *
+* The engine takes no ambient cwd; this CLI front end owns the process, so the
+* discovery root is the process cwd the rest of `lint check` already resolves
+* its relative paths against.
+*
 * @param discovery - ConfigDiscovery service
 * @param names - Config file names to search for (in priority order)
 * @returns The config file path or null
@@ -60,7 +64,7 @@ function findConfigFile(fs) {
 function findConfig(discovery, names) {
 	return Effect.gen(function* () {
 		for (const name of names) {
-			const result = yield* discovery.find(name);
+			const result = yield* discovery.find(name, { cwd: process.cwd() });
 			if (result) return result.path;
 		}
 		return null;

package/commands/lint/fmt.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Lint } from "@savvy-web/silk-effects";
 import { Effect, Option } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { Yaml } from "@effected/yaml";
 
@@ -16,7 +16,7 @@ import { Yaml } from "@effected/yaml";
 * @internal
 */
 /** Repeated file path arguments. */
-const filesArg = Argument.file("files", { mustExist: true }).pipe(Argument.variadic());
+const filesArg = Argument.File("files", { mustExist: true }).pipe(Argument.variadic());
 /**
 * Formatting options forwarded from `Lint.Yaml.fmtCommand`.
 *
@@ -25,7 +25,7 @@ const filesArg = Argument.file("files", { mustExist: true }).pipe(Argument.varia
 * handler only reach the formatter across this flag. Omitting it would make
 * `fmtCommand({ format })` and `create({ format })` write different bytes.
 */
-const yamlFormatOption = Flag.string("format").pipe(Flag.withDescription("JSON-encoded @effected/yaml formatting options"), Flag.optional);
+const yamlFormatOption = Flag.String("format").pipe(Flag.withDescription("JSON-encoded @effected/yaml formatting options"), Flag.optional);
 /** Sort package.json files with sort-package-json. */
 const packageJsonCommand = Command.make("package-json", { files: filesArg }, ({ files }) => Effect.sync(() => {
 	for (const filepath of files) {

package/commands/lint/init.js

@@ -1,10 +1,10 @@
 import { BIOME_VERSION } from "./biome-version.js";
-import { ManagedSection } from "@effected/templates";
-import { WorkspaceDiscovery } from "@effected/workspaces";
+import { dirname, join } from "node:path";
 import { BiomeSchemaSync, LIFECYCLE_SCRIPTS_CONFIG_KEY, Lint, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, publishesBuiltLinkDirectory, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyToolchainCheck } from "@savvy-web/silk-effects";
 import { Effect, FileSystem } from "effect";
-import { dirname, join } from "node:path";
 import { Jsonc, JsoncEdit, JsoncModifier } from "@effected/jsonc";
+import { WorkspaceDiscovery } from "@effected/workspaces";
+import { ManagedSection } from "@effected/templates";
 import { chmod } from "node:fs/promises";
 import { isDeepStrictEqual } from "node:util";
 
@@ -138,10 +138,10 @@ function writeMarkdownlintConfig(fs, preset, force) {
 * needed on the happy path.
 *
 * Discovery failing yields an EMPTY list, which the caller reads as "no roots
-* to enumerate — scan `BiomeSchemaSync`'s own default directory instead". The
-* cwd is deliberately not named here: resolving it is the sync service's job,
-* and an ambient `process.cwd()` read in this function would be a second,
-* divergent source of truth for the same directory.
+* to enumerate — scan the process cwd instead". The cwd is deliberately not
+* named here: `syncBiomeSchemas` resolves it exactly once for the fallback
+* pass, and an ambient `process.cwd()` read in this function would be a
+* second, divergent source of truth for the same directory.
 *
 * The two ways discovery fails mean different things and are reported differently:
 *
@@ -212,7 +212,7 @@ function syncBiomeSchemas() {
 	return Effect.gen(function* () {
 		const syncer = yield* BiomeSchemaSync;
 		const roots = yield* biomeConfigRoots();
-		const passes = roots.length > 0 ? roots.map((cwd) => ({ cwd })) : [void 0];
+		const passes = roots.length > 0 ? roots.map((cwd) => ({ cwd })) : [{ cwd: process.cwd() }];
 		for (const options of passes) yield* syncer.sync(BIOME_VERSION, options).pipe(Effect.flatMap((result) => Effect.gen(function* () {
 			for (const configPath of result.current) yield* Effect.log(`${CHECK_MARK} ${configPath}: biome $schema up-to-date`);
 			for (const configPath of result.updated) yield* Effect.log(`${CHECK_MARK} Updated $schema in ${configPath}`);

package/commands/repos/commands/add.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect, Option } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/add.ts
 /**
@@ -29,12 +29,12 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const urlArg = Argument.string("url");
-const refOption = Flag.string("ref").pipe(Flag.withDescription("Ref (tag, branch, or commit) to check out"));
-const purposeOption = Flag.string("purpose").pipe(Flag.withDescription("Why this repo is vendored"));
-const nameOption = Flag.string("name").pipe(Flag.withDescription("Vendored directory name; defaults to the URL's last path segment"), Flag.optional);
-const sparseOption = Flag.string("sparse").pipe(Flag.withDescription("Sparse-checkout path; repeatable"), Flag.atLeast(0));
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to add within"), Flag.withDefault("."));
+const urlArg = Argument.String("url");
+const refOption = Flag.String("ref").pipe(Flag.withDescription("Ref (tag, branch, or commit) to check out"));
+const purposeOption = Flag.String("purpose").pipe(Flag.withDescription("Why this repo is vendored"));
+const nameOption = Flag.String("name").pipe(Flag.withDescription("Vendored directory name; defaults to the URL's last path segment"), Flag.optional);
+const sparseOption = Flag.String("sparse").pipe(Flag.withDescription("Sparse-checkout path; repeatable"), Flag.atLeast(0));
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to add within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Add handler; exported for tests.

package/commands/repos/commands/deregister.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/deregister.ts
 /**
@@ -36,8 +36,8 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const sectionArg = Argument.string("section");
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to deregister within"), Flag.withDefault("."));
+const sectionArg = Argument.String("section");
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to deregister within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Deregister handler; exported for tests.

package/commands/repos/commands/note.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/note.ts
 /**
@@ -52,11 +52,11 @@ const runReposNote = (cwd, name, op) => Effect.gen(function* () {
 	return Effect.log(error.message);
 }));
 /* v8 ignore start -- CLI registration; handler tested via runReposNote */
-const nameArg = Argument.string("name");
-const noteTextArg = Argument.string("text");
-const noteIdArg = Argument.string("id");
-const intoOption = Flag.choice("into", ["layout", "startHere"]).pipe(Flag.withDescription("Curated orientation field to promote the note into"));
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root whose manifest holds the notes"), Flag.withDefault("."));
+const nameArg = Argument.String("name");
+const noteTextArg = Argument.String("text");
+const noteIdArg = Argument.String("id");
+const intoOption = Flag.Literals("into", ["layout", "startHere"]).pipe(Flag.withDescription("Curated orientation field to promote the note into"));
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root whose manifest holds the notes"), Flag.withDefault("."));
 const _noteGroup = Command.make("note").pipe(Command.withSharedFlags({ cwd: cwdOption }));
 const addLeaf = Command.make("add", {
 	name: nameArg,

package/commands/repos/commands/pin.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/pin.ts
 /**
@@ -28,9 +28,9 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const nameArg = Argument.string("name");
-const refArg = Argument.string("ref");
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to pin within"), Flag.withDefault("."));
+const nameArg = Argument.String("name");
+const refArg = Argument.String("ref");
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to pin within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Pin handler; exported for tests.

package/commands/repos/commands/remove.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/remove.ts
 /**
@@ -33,8 +33,8 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const nameArg = Argument.string("name");
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to remove within"), Flag.withDefault("."));
+const nameArg = Argument.String("name");
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to remove within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Remove handler; exported for tests.

package/commands/repos/commands/rename.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/rename.ts
 /**
@@ -34,9 +34,9 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const oldNameArg = Argument.string("old-name");
-const newNameArg = Argument.string("new-name");
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to rename within"), Flag.withDefault("."));
+const oldNameArg = Argument.String("old-name");
+const newNameArg = Argument.String("new-name");
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to rename within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Rename handler; exported for tests.

package/commands/repos/commands/restore.js

@@ -1,6 +1,6 @@
+import { Argument, Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Argument, Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/restore.ts
 /**
@@ -40,8 +40,8 @@ import { Argument, Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option/arg definitions */
-const namesArg = Argument.string("name").pipe(Argument.variadic());
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to restore within"), Flag.withDefault("."));
+const namesArg = Argument.String("name").pipe(Argument.variadic());
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to restore within"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Restore handler; exported for tests.

package/commands/repos/commands/status.js

@@ -1,6 +1,6 @@
+import { Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Console, Effect } from "effect";
-import { Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/status.ts
 /**
@@ -35,9 +35,9 @@ import { Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option definitions */
-const jsonOption = Flag.boolean("json").pipe(Flag.withDescription("Emit the structured drift report as JSON"), Flag.withDefault(false));
-const driftOption = Flag.boolean("drift").pipe(Flag.withDescription("Also reconcile the manifest, .gitmodules, worktree, and git submodule status"), Flag.withDefault(false));
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to inspect"), Flag.withDefault("."));
+const jsonOption = Flag.Boolean("json").pipe(Flag.withDescription("Emit the structured drift report as JSON"), Flag.withDefault(false));
+const driftOption = Flag.Boolean("drift").pipe(Flag.withDescription("Also reconcile the manifest, .gitmodules, worktree, and git submodule status"), Flag.withDefault(false));
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to inspect"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Drift report handler; exported for tests.

package/commands/repos/commands/sync.js

@@ -1,6 +1,6 @@
+import { Command, Flag } from "effect/unstable/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
-import { Command, Flag } from "effect/unstable/cli";
 
 //#region src/commands/repos/commands/sync.ts
 /**
@@ -28,7 +28,7 @@ import { Command, Flag } from "effect/unstable/cli";
 * @internal
 */
 /* v8 ignore start -- CLI option definitions */
-const cwdOption = Flag.directory("cwd").pipe(Flag.withDescription("Repo root to sync"), Flag.withDefault("."));
+const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to sync"), Flag.withDefault("."));
 /* v8 ignore stop */
 /**
 * Sync handler; exported for tests.

package/index.d.ts

@@ -8,65 +8,6 @@ import { ManagedSection, SectionFileError, SectionParseError, SectionRenderError
 import { PlatformError } from "effect/PlatformError";
 import { ToolDiscovery } from "@effected/commands";
 import { JsoncParseError } from "@effected/jsonc";
-//#region src/cli/index.d.ts
-/**
- * Root `savvy` CLI entry point using `effect/unstable/cli`.
- *
- * @remarks
- * Assembles the five Phase-B command pieces — the `init` and `check` top-level
- * orchestrators plus the `changeset`, `commit`, and `lint` groups — under a
- * single `savvy` root command, then provides the merged runtime Layer stack
- * that satisfies every command's service requirements.
- *
- * The layer stack wires the silk-effects service layers over their v4
- * requirement channels:
- *
- * - `NodeServices.layer` — `FileSystem`, `Path`, `ChildProcessSpawner`, `Stdio`,
- *   and `Terminal`, consumed by every config reader, workspace service, git
- *   layer, and the CLI framework itself.
- * - `Git.layer` (from `@effected/git`) — the typed git service backing
- *   `BranchAnalyzer`, `ReposManager`, the commit hooks
- *   (`readBranchInfo` / `readSigningDiagnostic`), and `detectGitHubRepo`.
- * - Workspace services from `@effected/workspaces` — `WorkspaceRoot.layer`,
- *   `PackageManagerDetector.layer`, and a single root-bound
- *   `WorkspaceDiscovery.layer()` (the kit resolves the root through
- *   `WorkspaceRoot` from `process.cwd()` lazily on first use, so the CLI's
- *   startup cwd is the discovery root).
- * - Flat silk-effects services — `ChangesetConfigReader.layer`,
- *   `SilkPublishability.layer`, `ManagedSection.layer` (from
- *   `@effected/templates`), `BiomeSchemaSync.layer`,
- *   and `ConfigDiscovery.layer`. Tool resolution is the kit's
- *   `ToolDiscovery.layer` over `ChildProcessSpawner` plus a `LocalExec`, which
- *   `Workspaces.localExecLayer()` supplies from the detected package manager.
- *   Versioning classification
- *   is a pure `@effected/workspaces` value operation over `WorkspaceDiscovery`
- *   and the silk `PublishabilityDetector`, so it needs no layer of its own.
- * - Changesets-namespace services — `Changesets.ConfigInspector.layer`,
- *   `Changesets.ReleasePlanner.layer`, and `Changesets.BranchAnalyzer.layer`
- *   sharing a single `ConfigInspector` via `provideMerge`. `DepsRegen` is NOT
- *   part of AppLive: its graph is root-bound at layer build, so the deps
- *   commands compose `Changesets.makeDepsRegenDefault({ cwd })` per invocation
- *   against their parsed `--cwd` (platform services flow up to
- *   `NodeServices.layer` here).
- *
- * The CLI version is injected at build time via `process.env.__PACKAGE_VERSION__`.
- *
- * @internal
- */
-/**
- * Bootstrap and run the `savvy` CLI application.
- *
- * @remarks
- * `Command.run` returns an Effect reading `process.argv` from the Stdio
- * service; the merged layer stack is provided and execution handed to
- * `NodeRuntime.runMain`, whose default reporting covers defects (the v3
- * `Cause.defects` wrapper is gone). No type casts: the layer graph is
- * validated by the compiler.
- *
- * @internal
- */
-export declare function runCli(): void;
-//#endregion
 //#region src/commands/changeset/commands/check.d.ts
 /**
  * Run the check validation pipeline on all changeset files in `dir`.

package/index.js

@@ -12,6 +12,5 @@ import { lintCommand } from "./commands/lint/index.js";
 import { runReposStatus } from "./commands/repos/commands/status.js";
 import { runReposSync } from "./commands/repos/commands/sync.js";
 import { reposCommand } from "./commands/repos/index.js";
-import { runCli } from "./cli/index.js";
 
-export { changesetCommand, checkCommand, commitCommand, initCommand, lintCommand, reposCommand, runChangesetCheck, runChangesetInit, runCheck, runCli, runCommitCheck, runCommitInit, runInit, runLintCheck, runLintInit, runReposStatus, runReposSync };
+export { changesetCommand, checkCommand, commitCommand, initCommand, lintCommand, reposCommand, runChangesetCheck, runChangesetInit, runCheck, runCommitCheck, runCommitInit, runInit, runLintCheck, runLintInit, runReposStatus, runReposSync };

package/main.d.ts

@@ -0,0 +1,7 @@
+//#region src/main.d.ts
+/**
+ * Bootstrap and run the `savvy` CLI application.
+ */
+export declare const main: () => void;
+//#endregion
+//# sourceMappingURL=main.d.ts.map

package/main.js

@@ -0,0 +1,35 @@
+import { AppLive, rootCommand } from "./cli/index.js";
+import { Command } from "effect/unstable/cli";
+import { Effect } from "effect";
+import { NodeRuntime } from "@effect/platform-node";
+
+//#region src/main.ts
+/**
+* Owns the process. `index.ts` must stay importable without side effects;
+* never import this module from the barrel.
+*
+* @remarks
+* Assembles the `Command.run` Effect over `rootCommand`, provides the merged
+* `AppLive` runtime layer stack from `./cli/index.js`, and hands execution to
+* `NodeRuntime.runMain`, whose default reporting covers defects (the v3
+* `Cause.defects` wrapper is gone). No type casts: the layer graph is
+* validated by the compiler.
+*
+* @internal
+*/
+/* v8 ignore start -- bootstrap; commands tested individually */
+/**
+* CLI application: reads argv from the Stdio service provided by NodeServices.
+* (v4's `Command.run` takes only `version` — the name comes from the root command.)
+*/
+const cli = Command.run(rootCommand, { version: "3.0.0" });
+/**
+* Bootstrap and run the `savvy` CLI application.
+*/
+const main = () => {
+	NodeRuntime.runMain(cli.pipe(Effect.provide(AppLive)));
+};
+/* v8 ignore stop */
+
+//#endregion
+export { main };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/cli",
-	"version": "2.11.3",
+	"version": "3.0.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",
@@ -25,20 +25,25 @@
 			"import": "./index.js",
 			"default": "./index.js"
 		},
+		"./main": {
+			"types": "./main.d.ts",
+			"import": "./main.js",
+			"default": "./main.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"bin": {
 		"savvy": "bin/savvy.js"
 	},
 	"dependencies": {
-		"@effect/platform-node": "4.0.0-rc.112",
-		"@effected/commands": "^0.6.1",
-		"@effected/git": "^0.14.0",
-		"@effected/jsonc": "^0.9.0",
-		"@effected/templates": "^0.5.0",
-		"@effected/workspaces": "^0.20.3",
-		"@effected/yaml": "^0.14.0",
-		"@savvy-web/silk-effects": "7.5.2",
-		"effect": "4.0.0-rc.112"
+		"@effect/platform-node": "4.0.0-rc.115",
+		"@effected/commands": "^0.7.0",
+		"@effected/git": "^0.15.0",
+		"@effected/jsonc": "^0.11.0",
+		"@effected/templates": "^0.6.0",
+		"@effected/workspaces": "^0.21.0",
+		"@effected/yaml": "^0.15.0",
+		"@savvy-web/silk-effects": "8.0.0",
+		"effect": "4.0.0-rc.115"
 	}
 }