@savvy-web/cli 2.11.4 → 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.4" });
-/**
 * 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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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

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
 /**

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
 /**

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,7 +18,7 @@ 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.
 *

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

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";
 

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.
 *

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";
 

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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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
 /**

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.4",
+	"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,6 +25,11 @@
 			"import": "./index.js",
 			"default": "./index.js"
 		},
+		"./main": {
+			"types": "./main.d.ts",
+			"import": "./main.js",
+			"default": "./main.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"bin": {
@@ -38,7 +43,7 @@
 		"@effected/templates": "^0.6.0",
 		"@effected/workspaces": "^0.21.0",
 		"@effected/yaml": "^0.15.0",
-		"@savvy-web/silk-effects": "7.5.3",
+		"@savvy-web/silk-effects": "8.0.0",
 		"effect": "4.0.0-rc.115"
 	}
 }