@savvy-web/cli 3.2.8 → 3.3.0

package/commands/repos/commands/status.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Console, Effect } from "effect";
 
@@ -46,11 +48,11 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposStatus = (cwd, json, drift = false) => Effect.gen(function* () {
 	const report = yield* (yield* Repos.ReposManager).status(cwd);
-	if (!report.clean) process.exitCode = 1;
+	if (!report.clean) yield* CliExit.set(1);
 	let driftReport;
 	if (drift) {
 		driftReport = yield* (yield* Repos.ReposDrift).check(cwd);
-		if (!driftReport.clean) process.exitCode = 1;
+		if (!driftReport.clean) yield* CliExit.set(1);
 	}
 	if (json) {
 		const payload = driftReport === void 0 ? report : {
@@ -66,20 +68,26 @@ const runReposStatus = (cwd, json, drift = false) => Effect.gen(function* () {
 			repo.dirty ? "dirty" : void 0,
 			repo.staleNoteIds.length > 0 ? `${repo.staleNoteIds.length} stale notes` : void 0
 		].filter((f) => f !== void 0);
-		yield* Effect.log(`${repo.name} @ ${repo.ref}${flags.length > 0 ? ` [${flags.join(", ")}]` : " [ok]"}`);
+		yield* flags.length > 0 ? Output.warn(`${repo.name} @ ${repo.ref} [${flags.join(", ")}]`) : Output.ok(`${repo.name} @ ${repo.ref}`);
 	}
-	if (driftReport !== void 0) for (const item of driftReport.drifts) yield* Effect.log(`${item.name}: ${item.kind} — ${item.detail}`);
+	if (driftReport !== void 0) for (const item of driftReport.drifts) yield* Output.fail(`${item.name}: ${item.kind} — ${item.detail}`);
 }).pipe(Effect.catchTag("ReposConfigError", (error) => {
 	if (error.kind === "missing") {
 		if (json) return Console.log(JSON.stringify({
 			repos: [],
 			clean: true
 		}, null, 2));
-		return Effect.log("no .repos/config.json — nothing vendored");
+		return Output.skip("no .repos/config.json — nothing vendored");
 	}
-	process.exitCode = 1;
-	return Effect.log(error.message);
-}));
+	const report = json ? Console.log(JSON.stringify({
+		error: error.message,
+		clean: false
+	}, null, 2)) : Effect.void;
+	return CliExit.set(1).pipe(Effect.andThen(report), Effect.andThen(Effect.logError(error.message)));
+}), Effect.catchTag("GitSubmoduleError", (error) => json ? CliExit.set(1).pipe(Effect.andThen(Console.log(JSON.stringify({
+	error: error.message,
+	clean: false
+}, null, 2))), Effect.andThen(Effect.logError(error.message))) : Effect.fail(error)));
 /* v8 ignore start -- CLI registration; handler tested via runReposStatus */
 const statusCommand = Command.make("status", {
 	json: jsonOption,

package/commands/repos/commands/sync.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -37,22 +39,19 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposSync = (cwd) => Effect.gen(function* () {
 	const report = yield* (yield* Repos.ReposManager).sync(cwd);
-	for (const name of report.clearedLocks) yield* Effect.log(`${name}: cleared stale lock`);
-	for (const name of report.initialized) yield* Effect.log(`${name}: initialized`);
-	for (const name of report.sparseApplied) yield* Effect.log(`${name}: sparse-checkout applied`);
-	for (const name of report.urlSynced) yield* Effect.log(`${name}: url reconciled`);
-	for (const name of report.registered) yield* Effect.log(`${name}: registered`);
-	if (report.initialized.length === 0 && report.sparseApplied.length === 0 && report.clearedLocks.length === 0 && report.urlSynced.length === 0 && report.registered.length === 0) yield* Effect.log("all vendored repos up to date");
+	for (const name of report.clearedLocks) yield* Output.ok(`${name}: cleared stale lock`);
+	for (const name of report.initialized) yield* Output.ok(`${name}: initialized`);
+	for (const name of report.sparseApplied) yield* Output.ok(`${name}: sparse-checkout applied`);
+	for (const name of report.urlSynced) yield* Output.ok(`${name}: url reconciled`);
+	for (const name of report.registered) yield* Output.ok(`${name}: registered`);
+	if (report.initialized.length === 0 && report.sparseApplied.length === 0 && report.clearedLocks.length === 0 && report.urlSynced.length === 0 && report.registered.length === 0) yield* Output.ok("all vendored repos up to date");
 }).pipe(Effect.catchTag("ReposConfigError", (error) => {
-	if (error.kind === "missing") return Effect.log("no .repos/config.json — nothing vendored");
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	if (error.kind === "missing") return Output.skip("no .repos/config.json — nothing vendored");
+	return CliExit.set(1).pipe(Effect.andThen(Effect.logError(error.message)));
 }), Effect.catchTag("GitSubmoduleError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	return CliExit.set(1).pipe(Effect.andThen(Effect.logError(error.message)));
 }), Effect.catchTag("ReposLockdownError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	return CliExit.set(1).pipe(Effect.andThen(Effect.logError(error.message)));
 }));
 /* v8 ignore start -- CLI registration; handler tested via runReposSync */
 const syncCommand = Command.make("sync", { cwd: cwdOption }, ({ cwd }) => runReposSync(cwd)).pipe(Command.withDescription("Reconcile vendored submodules with the manifest: init missing, apply sparse, clear locks"));

package/index.d.ts

@@ -1,5 +1,6 @@
+import { CliExit } from "@effected/cli";
 import { BiomeSchemaSync, ChangesetConfigReader, Changesets, ConfigDiscovery, Repos } from "@savvy-web/silk-effects";
-import { Cause, Effect, FileSystem, Path } from "effect";
+import { Cause, Effect, FileSystem, Path, Stdio } from "effect";
 import { Command } from "effect/unstable/cli";
 import { ChildProcessSpawner } from "effect/unstable/process";
 import { Git } from "@effected/git";
@@ -13,14 +14,14 @@ import { JsoncParseError } from "@effected/jsonc";
  * Run the check validation pipeline on all changeset files in `dir`.
  *
  * Groups lint messages by file and logs a human-readable summary. Sets
- * `process.exitCode = 1` when one or more errors are found.
+ * exit code 1 through `CliExit.set` when one or more errors are found.
  *
  * @param dir - Path to the changeset directory (resolved relative to cwd)
  * @returns An Effect that performs validation and logs results
  *
  * @internal
  */
-export declare function runChangesetCheck(dir: string): Effect.Effect<void, Error>;
+export declare function runChangesetCheck(dir: string): Effect.Effect<void, Error, CliExit | Stdio.Stdio>;
 //#endregion
 //#region src/commands/changeset/commands/init.d.ts
 /**
@@ -39,7 +40,7 @@ export declare function runChangesetInit(opts: {
   quiet: boolean;
   skipMarkdownlint: boolean;
   check: boolean;
-}): Effect.Effect<void, never, WorkspaceRoot | Git>;
+}): Effect.Effect<void, never, WorkspaceRoot | Git | CliExit | Stdio.Stdio>;
 //#endregion
 //#region src/commands/changeset/index.d.ts
 /**
@@ -57,7 +58,7 @@ export declare function runChangesetInit(opts: {
  * `Command.withSubcommands` propagates each subcommand's requirements up into
  * the group's `R`, which the root assembly discharges via `AppLive`.
  */
-export declare const changesetCommand: Command.Command<"changeset", Record<string, never>, Record<string, never>, Changesets.ConfigurationError | Error | Changesets.ReleasePlanError | Cause.UnknownError | Changesets.DepsRegenPlanError, ChildProcessSpawner.ChildProcessSpawner | Changesets.ConfigInspector | FileSystem.FileSystem | Path.Path | Changesets.ReleasePlanner>;
+export declare const changesetCommand: Command.Command<"changeset", Record<string, never>, Record<string, never>, Changesets.ConfigurationError | Error | Changesets.ReleasePlanError | Cause.UnknownError | Changesets.DepsRegenPlanError, ChildProcessSpawner.ChildProcessSpawner | Changesets.ConfigInspector | FileSystem.FileSystem | Path.Path | Changesets.ReleasePlanner | CliExit | Stdio.Stdio>;
 //#endregion
 //#region src/commands/check.d.ts
 /**
@@ -88,7 +89,7 @@ export declare function runCheck<EChangeset, RChangeset, ECommit, RCommit, ELint
 export declare const checkCommand: Command.Command<"check", {
   readonly changesetDir: string;
   readonly quiet: boolean;
-}, {}, Error | import("@effected/jsonc").JsoncParseError | import("effect/PlatformError").PlatformError | import("@effected/templates").SectionFileError | import("@effected/templates").SectionParseError, import("@savvy-web/silk-effects").ChangesetConfigReader | import("@savvy-web/silk-effects").ConfigDiscovery | import("effect/FileSystem").FileSystem | import("@effected/templates").ManagedSection | import("@effected/workspaces").PublishabilityDetector | import("@effected/commands").ToolDiscovery | import("@effected/workspaces").WorkspaceDiscovery>;
+}, {}, Error | import("@effected/jsonc").JsoncParseError | import("effect/PlatformError").PlatformError | import("@effected/templates").SectionFileError | import("@effected/templates").SectionParseError, import("@savvy-web/silk-effects").ChangesetConfigReader | import("@effected/cli").CliExit | import("@savvy-web/silk-effects").ConfigDiscovery | import("effect/FileSystem").FileSystem | import("@effected/templates").ManagedSection | import("@effected/workspaces").PublishabilityDetector | import("effect/Stdio").Stdio | import("@effected/commands").ToolDiscovery | import("@effected/workspaces").WorkspaceDiscovery>;
 //#endregion
 //#region src/commands/commit/check.d.ts
 /**
@@ -101,7 +102,7 @@ export declare const checkCommand: Command.Command<"check", {
  *
  * @internal
  */
-export declare function runCommitCheck(): Effect.Effect<void, SectionParseError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | ChangesetConfigReader | PublishabilityDetector | WorkspaceDiscovery>;
+export declare function runCommitCheck(): Effect.Effect<void, SectionParseError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | ChangesetConfigReader | PublishabilityDetector | WorkspaceDiscovery | Stdio.Stdio>;
 //#endregion
 //#region src/commands/commit/init.d.ts
 /**
@@ -118,7 +119,7 @@ export declare function runCommitCheck(): Effect.Effect<void, SectionParseError
 export declare function runCommitInit(opts: {
   force: boolean;
   config: string;
-}): Effect.Effect<void, Error | SectionParseError | SectionRenderError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem>;
+}): Effect.Effect<void, Error | SectionParseError | SectionRenderError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | Stdio.Stdio>;
 //#endregion
 //#region src/commands/commit/index.d.ts
 /**
@@ -129,7 +130,7 @@ export declare function runCommitInit(opts: {
  * errors from Effect's internal types. Task B7 should import and use this directly
  * as `Command.withSubcommands([commitCommand])` — the cast is for declaration emit only.
  */
-export declare const commitCommand: Command.Command<"commit", {}, {}, import("effect/unstable/cli/CliError").UserError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("@effected/git").Git>;
+export declare const commitCommand: Command.Command<"commit", {}, {}, import("effect/unstable/cli/CliError").UserError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("@effected/git").Git | import("effect/Stdio").Stdio>;
 //#endregion
 //#region src/commands/init.d.ts
 /**
@@ -160,7 +161,7 @@ export declare const initCommand: Command.Command<"init", {
   readonly commitConfig: string;
   readonly lintConfig: string;
   readonly lintPreset: "minimal" | "silk" | "standard";
-}, {}, Error | import("effect/PlatformError").PlatformError | import("@effected/templates").SectionFileError | import("@effected/templates").SectionParseError | import("@effected/templates").SectionRenderError, import("@savvy-web/silk-effects").BiomeSchemaSync | import("effect/FileSystem").FileSystem | import("@effected/git").Git | import("@effected/templates").ManagedSection | import("@effected/workspaces").WorkspaceDiscovery | import("@effected/workspaces").WorkspaceRoot>;
+}, {}, Error | import("effect/PlatformError").PlatformError | import("@effected/templates").SectionFileError | import("@effected/templates").SectionParseError | import("@effected/templates").SectionRenderError, import("@savvy-web/silk-effects").BiomeSchemaSync | import("@effected/cli").CliExit | import("effect/FileSystem").FileSystem | import("@effected/git").Git | import("@effected/templates").ManagedSection | import("effect/Stdio").Stdio | import("@effected/workspaces").WorkspaceDiscovery | import("@effected/workspaces").WorkspaceRoot>;
 //#endregion
 //#region src/commands/lint/check.d.ts
 /**
@@ -176,7 +177,7 @@ export declare const initCommand: Command.Command<"init", {
  */
 export declare function runLintCheck(opts: {
   quiet: boolean;
-}): Effect.Effect<void, JsoncParseError | SectionParseError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | ToolDiscovery | ConfigDiscovery>;
+}): Effect.Effect<void, JsoncParseError | SectionParseError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | ToolDiscovery | ConfigDiscovery | Stdio.Stdio>;
 //#endregion
 //#region src/commands/lint/init.d.ts
 /**
@@ -194,7 +195,7 @@ export declare function runLintInit(opts: {
   force: boolean;
   config: string;
   preset: "minimal" | "standard" | "silk";
-}): Effect.Effect<void, Error | SectionParseError | SectionRenderError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | BiomeSchemaSync | WorkspaceDiscovery>;
+}): Effect.Effect<void, Error | SectionParseError | SectionRenderError | SectionFileError | PlatformError, ManagedSection | FileSystem.FileSystem | BiomeSchemaSync | WorkspaceDiscovery | Stdio.Stdio>;
 //#endregion
 //#region src/commands/lint/index.d.ts
 /**
@@ -213,7 +214,7 @@ export declare const lintCommand: Command.Command<"lint", {}, {}, import("@effec
  *
  * @internal
  */
-export declare const runReposStatus: (cwd: string, json: boolean, drift?: boolean) => Effect.Effect<void, Repos.GitSubmoduleError, Repos.ReposDrift | Repos.ReposManager>;
+export declare const runReposStatus: (cwd: string, json: boolean, drift?: boolean) => Effect.Effect<void, Repos.GitSubmoduleError, CliExit | Repos.ReposDrift | Repos.ReposManager | Stdio.Stdio>;
 //#endregion
 //#region src/commands/repos/commands/sync.d.ts
 /**
@@ -221,7 +222,7 @@ export declare const runReposStatus: (cwd: string, json: boolean, drift?: boolea
  *
  * @internal
  */
-export declare const runReposSync: (cwd: string) => Effect.Effect<void, never, Repos.ReposManager>;
+export declare const runReposSync: (cwd: string) => Effect.Effect<void, never, CliExit | Repos.ReposManager | Stdio.Stdio>;
 //#endregion
 //#region src/commands/repos/index.d.ts
 /**
@@ -252,6 +253,6 @@ export declare const runReposSync: (cwd: string) => Effect.Effect<void, never, R
  * or (under `--drift`) `Repos.ReposDrift.check` is the sole channel that
  * escapes uncaught, so it is the only member left in this union.
  */
-export declare const reposCommand: Command.Command<"repos", Record<string, never>, Record<string, never>, Repos.GitSubmoduleError, Repos.ReposManager | Repos.ReposDrift>;
+export declare const reposCommand: Command.Command<"repos", Record<string, never>, Record<string, never>, Repos.GitSubmoduleError, Repos.ReposManager | Repos.ReposDrift | CliExit | Stdio.Stdio>;
 //#endregion
 //# sourceMappingURL=index.d.ts.map

package/internal/failure-line.js

@@ -0,0 +1,39 @@
+//#region src/internal/failure-line.ts
+/**
+* How a failure that reaches `CliRuntime.main` reads on stderr.
+*
+* @packageDocumentation
+*/
+const HIDDEN = /* @__PURE__ */ new Set([
+	"_tag",
+	"message",
+	"name",
+	"stack",
+	"cause"
+]);
+/**
+* Renders a failure for `CliRuntime.main`'s `render` option.
+*
+* @remarks
+* The kit's default is `String(error)`, which prints a `Data.TaggedError`
+* with no `message` as its bare tag and drops the fields that say what went
+* wrong (`CleanError`, with the `reason` lost). This prefers the error's own
+* message, then its tag with its fields, then `String`.
+*
+* @internal
+*/
+var FailureLine = class {
+	constructor() {}
+	static render = (error) => {
+		if (error instanceof Error && error.message !== "") return error.message;
+		if (typeof error === "object" && error !== null && "_tag" in error) {
+			const fields = Object.entries(error).filter(([key]) => !HIDDEN.has(key)).map(([key, value]) => `${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`);
+			const tag = String(error._tag);
+			return fields.length > 0 ? `${tag}: ${fields.join(", ")}` : tag;
+		}
+		return String(error);
+	};
+};
+
+//#endregion
+export { FailureLine };

package/internal/output.js

@@ -0,0 +1,52 @@
+import { CliColor } from "@effected/cli";
+import { Console, Effect } from "effect";
+
+//#region src/internal/output.ts
+/**
+* Human-readable command output.
+*
+* @packageDocumentation
+*/
+const paint = (on, code, text) => on ? `\u001b[${code}m${text}\u001b[0m` : text;
+const glyphLine = (code, glyph, text) => Effect.flatMap(CliColor.enabled, (on) => Console.log(`${paint(on, code, glyph)} ${text}`));
+/**
+* The result a person ran a command to see, written to stdout.
+*
+* @remarks
+* Every line goes through `Console.log`, so stdout carries a command's product
+* and nothing else; progress and diagnostics stay on `Effect.log*`, which the
+* CLI logger sends to stderr. Colour follows `CliColor.enabled` — off when
+* stdout is not a terminal or `NO_COLOR` is set — and only ever tints the
+* glyph or heading, so the text reads the same piped.
+*
+* @internal
+*/
+var Output = class {
+	constructor() {}
+	/** A passing item: `✓ text`. */
+	static ok = (text) => glyphLine("32", "✓", text);
+	/** An item that passed with a caveat: `⚠ text`. */
+	static warn = (text) => glyphLine("33", "⚠", text);
+	/** A finding — still output, not a crash: `✗ text`. */
+	static fail = (text) => glyphLine("31", "✗", text);
+	/** An item that is absent or not applicable — neither a pass nor a finding: `• text`, dimmed. */
+	static skip = (text) => glyphLine("2", "•", text);
+	/** A section title, bold on a terminal. */
+	static heading = (text) => Effect.flatMap(CliColor.enabled, (on) => Console.log(paint(on, "1", text)));
+	/** Supporting detail under the line before it, indented and dimmed on a terminal. */
+	static detail = (text) => Effect.flatMap(CliColor.enabled, (on) => Console.log(`  ${paint(on, "2", text)}`));
+	/** A line printed as given — a blank separator, or a block already formatted. */
+	static line = (text) => Console.log(text);
+	/** `3 ok · 1 warning · 2 failed`, zero parts left out; `nothing to do` when every count is zero. */
+	static summary = (counts) => {
+		const parts = [
+			counts.ok ? `${counts.ok} ok` : void 0,
+			counts.warn ? `${counts.warn} ${counts.warn === 1 ? "warning" : "warnings"}` : void 0,
+			counts.fail ? `${counts.fail} failed` : void 0
+		].filter((part) => part !== void 0);
+		return Console.log(parts.length === 0 ? "nothing to do" : parts.join(" · "));
+	};
+};
+
+//#endregion
+export { Output };

package/internal/version-line.js

@@ -0,0 +1,19 @@
+import { distributionSuffix } from "@effected/engine";
+
+//#region src/internal/version-line.ts
+/**
+* Renders the `savvy --version` line: the same `<name> v<version>` shape
+* `effect/unstable/cli`'s default formatter prints, plus the
+* `" via <carrier> <version>"` suffix when the bin was installed through a
+* carrier such as `@savvy-web/silk`.
+*
+* @internal
+*/
+var VersionLine = class {
+	constructor() {}
+	/** `savvy v1.2.3`, or `savvy v1.2.3 via @savvy-web/silk 4.5.6`. */
+	static format = (name, version, distribution) => `${name} v${version}${distributionSuffix(distribution)}`;
+};
+
+//#endregion
+export { VersionLine };

package/main.d.ts

@@ -1,7 +1,23 @@
+import { Distribution } from "@effected/engine";
 //#region src/main.d.ts
 /**
- * Bootstrap and run the `savvy` CLI application.
+ * Options for {@link main}.
+ *
+ * @public
  */
-export declare const main: () => void;
+export interface MainOptions {
+  /**
+   * The carrier this bin was installed through, for example
+   * `{ name: "@savvy-web/silk", version }`; `--version` names it. Absent for
+   * a direct install.
+   */
+  readonly distribution?: Distribution | undefined;
+}
+/**
+ * Bootstrap and run the `savvy` CLI application. Owns the process.
+ *
+ * @public
+ */
+export declare const main: (options?: MainOptions) => void;
 //#endregion
 //# sourceMappingURL=main.d.ts.map

package/main.js

@@ -1,7 +1,12 @@
-import { AppLive, rootCommand } from "./cli/index.js";
+import { AppLive, CliPlatform, rootCommand } from "./cli/index.js";
+import { FailureLine } from "./internal/failure-line.js";
+import { VersionLine } from "./internal/version-line.js";
+import { CLI_VERSION } from "./version.js";
 import { Command } from "effect/unstable/cli";
-import { Effect } from "effect";
+import { CliColor, CliRuntime } from "@effected/cli";
+import { Effect, Layer, Option } from "effect";
 import { NodeRuntime } from "@effect/platform-node";
+import { CurrentDistribution } from "@effected/engine";
 
 //#region src/main.ts
 /**
@@ -10,24 +15,29 @@ import { NodeRuntime } from "@effect/platform-node";
 *
 * @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.
+* `AppLive` stack and the carrier-aware version formatter, and hands the
+* program to `@effected/cli`'s `CliRuntime.main`, which provides the platform
+* and the kit-default CLI logger (every log line on stderr), reports failures
+* through that logger, applies the `CliExit` code a command set, and exits
+* `64` on a usage error.
+* No type casts: the layer graph is validated by the compiler.
 *
-* @internal
+* @packageDocumentation
 */
-/* v8 ignore start -- bootstrap; commands tested individually */
+/* v8 ignore start -- bootstrap; commands tested individually, the bin by __test__/e2e/bin.e2e.test.ts */
 /**
-* 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.2.8" });
-/**
-* Bootstrap and run the `savvy` CLI application.
+* Bootstrap and run the `savvy` CLI application. Owns the process.
+*
+* @public
 */
-const main = () => {
-	NodeRuntime.runMain(cli.pipe(Effect.provide(AppLive)));
+const main = (options = {}) => {
+	const distribution = Option.fromNullishOr(options.distribution);
+	const VersionFormatterLive = CliColor.formatterLayer({ formatVersion: (name, version) => VersionLine.format(name, version, distribution) });
+	const program = Command.run(rootCommand, { version: CLI_VERSION }).pipe(Effect.provide(Layer.merge(AppLive, VersionFormatterLive)), Effect.provideService(CurrentDistribution, distribution));
+	NodeRuntime.runMain(CliRuntime.main(program, {
+		platform: CliPlatform,
+		render: FailureLine.render
+	}));
 };
 /* v8 ignore stop */
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/cli",
-	"version": "3.2.8",
+	"version": "3.3.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",
@@ -37,7 +37,9 @@
 	},
 	"dependencies": {
 		"@effect/platform-node": "4.0.0-rc.117",
+		"@effected/cli": "^0.8.0",
 		"@effected/commands": "^0.9.0",
+		"@effected/engine": "^0.1.0",
 		"@effected/git": "^0.17.0",
 		"@effected/jsonc": "^0.13.0",
 		"@effected/templates": "^0.8.0",

package/version.js

@@ -0,0 +1,13 @@
+//#region src/version.ts
+/**
+* The package version, replaced at build time by the bundler's
+* `process.env.__PACKAGE_VERSION__` define; `0.0.0` in an unbuilt source run.
+* Kept in its own module so the process read stays at the front end's edge.
+*
+* @packageDocumentation
+*/
+/** @internal */
+const CLI_VERSION = "3.3.0";
+
+//#endregion
+export { CLI_VERSION };