@savvy-web/cli 3.2.8 → 3.3.0

package/commands/commit/init.js

@@ -1,3 +1,4 @@
+import { Output } from "../../internal/output.js";
 import { HUSKY_HOOK_PATH, POST_CHECKOUT_HOOK_PATH, POST_COMMIT_HOOK_PATH, POST_MERGE_HOOK_PATH } from "./constants.js";
 import { dirname } from "node:path";
 import { SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyToolSection, savvyToolchainCheck } from "@savvy-web/silk-effects";
@@ -89,13 +90,13 @@ function runCommitInit(opts) {
 		const fs = yield* FileSystem.FileSystem;
 		const ms = yield* ManagedSection;
 		if (config.startsWith("/")) yield* Effect.fail(/* @__PURE__ */ new Error("Config path must be relative to repository root, not absolute"));
-		yield* Effect.log("Initializing commitlint configuration...\n");
+		yield* Output.heading("commitlint");
 		yield* fs.makeDirectory(".husky", { recursive: true });
 		if (force) yield* fs.writeFileString(HUSKY_HOOK_PATH, COMMIT_MSG_HEADER);
 		else yield* ensureHookFile(HUSKY_HOOK_PATH, COMMIT_MSG_HEADER);
 		const commitResults = yield* ms.syncAll(HUSKY_HOOK_PATH, [SavvyBaseSection.section(savvyBasePreamble()), savvyCommitBlock(config)]);
 		yield* makeExecutable(HUSKY_HOOK_PATH);
-		yield* Effect.log(`${"✓"} ${force ? "Replaced" : "Synced"} ${HUSKY_HOOK_PATH} (${commitResults.map((r) => r._tag).join(", ")})`);
+		yield* Output.ok(`${force ? "Replaced" : "Synced"} ${HUSKY_HOOK_PATH} (${commitResults.map((r) => r._tag).join(", ")})`);
 		for (const [hookPath, installHook] of HYGIENE_HOOKS) {
 			yield* ensureHookFile(hookPath, HYGIENE_HEADER);
 			const sections = [SavvyHooksSection.section(savvyHooksHygiene())];
@@ -105,16 +106,17 @@ function runCommitInit(opts) {
 			}
 			yield* ms.syncAll(hookPath, sections);
 			yield* makeExecutable(hookPath);
-			yield* Effect.log(`${"✓"} Synced ${hookPath}`);
+			yield* Output.ok(`Synced ${hookPath}`);
 		}
-		if ((yield* fs.exists(config)) && !force) yield* Effect.log(`${"⚠"} ${config} already exists (use --force to overwrite)`);
+		if ((yield* fs.exists(config)) && !force) yield* Output.warn(`${config} already exists (use --force to overwrite)`);
 		else {
 			const configDir = dirname(config);
 			if (configDir && configDir !== ".") yield* fs.makeDirectory(configDir, { recursive: true });
 			yield* fs.writeFileString(config, CONFIG_CONTENT);
-			yield* Effect.log(`${"✓"} Created ${config}`);
+			yield* Output.ok(`Created ${config}`);
 		}
-		yield* Effect.log("\nDone! Install @commitlint/cli if not already installed.");
+		yield* Output.line("");
+		yield* Output.ok("Install @commitlint/cli if it is not already installed");
 	});
 }
 

package/commands/commit/lint.js

@@ -1,3 +1,4 @@
+import { Output } from "../../internal/output.js";
 import { buildCommitlintInvocation } from "./commitlint-invocation.js";
 import { Argument, CliError, Command } from "effect/unstable/cli";
 import { Commitlint } from "@savvy-web/silk-effects";
@@ -75,7 +76,7 @@ function runCommitLint(file) {
 		if (stdout.length > 0) yield* Effect.sync(() => process.stdout.write(stdout));
 		if (stderr.length > 0) yield* Effect.sync(() => process.stderr.write(stderr));
 		if (!passed) return yield* Effect.fail(new CliError.UserError({ cause: `Commit message at ${file} failed commitlint validation` }));
-		yield* Effect.log("Commit message passes the Silk commitlint preset.");
+		yield* Output.ok("Commit message passes the Silk commitlint preset");
 	});
 }
 /* v8 ignore next */

package/commands/lint/check.js

@@ -1,3 +1,4 @@
+import { Output } from "../../internal/output.js";
 import { BIOME_VERSION } from "./biome-version.js";
 import { ConfigDiscovery, Lint, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyOkfBlock, savvyToolchainCheck } from "@savvy-web/silk-effects";
 import { Effect, FileSystem, Option } from "effect";
@@ -12,14 +13,8 @@ import { Tool, ToolDiscovery } from "@effected/commands";
 *
 * @internal
 */
-/** Unicode checkmark symbol. */
-const CHECK_MARK = "✓";
-/** Unicode cross symbol. */
-const CROSS_MARK = "✗";
-/** Unicode warning symbol. */
+/** Unicode warning symbol, for the quiet-mode warning lines. */
 const WARNING = "⚠";
-/** Unicode bullet symbol. */
-const BULLET = "•";
 /** Paths to search for config files. */
 const CONFIG_SEARCH_PATHS = [
 	"lib/configs/lint-staged.config.ts",
@@ -285,42 +280,43 @@ function runLintCheck(opts) {
 			if (!markdownlintStatus.configMatches) warnings.push(`${WARNING}  ${Lint.MARKDOWNLINT_CONFIG_PATH}: config rules differ from template.\n   Run 'savvy init --force' to overwrite.`);
 		}
 		if (quiet) {
-			if (warnings.length > 0) for (const warning of warnings) yield* Effect.log(warning);
+			if (warnings.length > 0) for (const warning of warnings) yield* Output.line(warning);
 			return;
 		}
-		yield* Effect.log("Checking lint-staged configuration...\n");
-		if (foundConfig) yield* Effect.log(`${CHECK_MARK} Config file: ${foundConfig}`);
-		else yield* Effect.log(`${CROSS_MARK} No lint-staged config file found`);
-		if (hasHuskyHook) yield* Effect.log(`${CHECK_MARK} Husky hook: ${Lint.HUSKY_HOOK_PATH}`);
-		else yield* Effect.log(`${CROSS_MARK} No husky pre-commit hook found`);
+		yield* Output.heading("lint-staged configuration");
+		if (foundConfig) yield* Output.ok(`Config file: ${foundConfig}`);
+		else yield* Output.fail(`No lint-staged config file found`);
+		if (hasHuskyHook) yield* Output.ok(`Husky hook: ${Lint.HUSKY_HOOK_PATH}`);
+		else yield* Output.fail(`No husky pre-commit hook found`);
 		if (hasHuskyHook) {
-			if (baseStatusLabel === "up-to-date") yield* Effect.log(`${CHECK_MARK} Base section: up-to-date`);
-			else if (baseStatusLabel === "outdated") yield* Effect.log(`${WARNING} Base section: outdated (run 'savvy init' to update)`);
-			else yield* Effect.log(`${BULLET} Base section: not found (run 'savvy init' to add)`);
+			if (baseStatusLabel === "up-to-date") yield* Output.ok(`Base section: up-to-date`);
+			else if (baseStatusLabel === "outdated") yield* Output.warn(`Base section: outdated (run 'savvy init' to update)`);
+			else yield* Output.skip(`Base section: not found (run 'savvy init' to add)`);
 			const lintLabel = detectedConfigPath ? ` (config: ${detectedConfigPath})` : "";
-			if (lintStatusLabel === "up-to-date") yield* Effect.log(`${CHECK_MARK} Lint section: up-to-date${lintLabel}`);
-			else if (lintStatusLabel === "outdated") yield* Effect.log(`${WARNING} Lint section: outdated (run 'savvy init' to update)`);
-			else yield* Effect.log(`${BULLET} Lint section: not found (run 'savvy init' to add)`);
-			if (okfStatusLabel === "up-to-date") yield* Effect.log(`${CHECK_MARK} OKF section: up-to-date`);
-			else if (okfStatusLabel === "outdated") yield* Effect.log(`${WARNING} OKF section: outdated (run 'savvy init' to update)`);
-			else yield* Effect.log(`${BULLET} OKF section: not found (run 'savvy init' to add)`);
+			if (lintStatusLabel === "up-to-date") yield* Output.ok(`Lint section: up-to-date${lintLabel}`);
+			else if (lintStatusLabel === "outdated") yield* Output.warn(`Lint section: outdated (run 'savvy init' to update)`);
+			else yield* Output.skip(`Lint section: not found (run 'savvy init' to add)`);
+			if (okfStatusLabel === "up-to-date") yield* Output.ok(`OKF section: up-to-date`);
+			else if (okfStatusLabel === "outdated") yield* Output.warn(`OKF section: outdated (run 'savvy init' to update)`);
+			else yield* Output.skip(`OKF section: not found (run 'savvy init' to add)`);
 		}
-		for (const status of shellHookStatuses) if (!status.found) yield* Effect.log(`${BULLET} ${status.path}: savvy-hooks section not found`);
-		else if (status.isUpToDate) yield* Effect.log(`${CHECK_MARK} ${status.path}: up-to-date`);
-		else yield* Effect.log(`${WARNING} ${status.path}: outdated (run 'savvy init' to update)`);
-		for (const status of installStatuses) if (!status.found) yield* Effect.log(`${BULLET} ${status.path}: savvy-install section not found`);
-		else if (status.isUpToDate) yield* Effect.log(`${CHECK_MARK} ${status.path}: savvy-install up-to-date`);
-		else yield* Effect.log(`${WARNING} ${status.path}: savvy-install outdated (run 'savvy init' to update)`);
-		for (const status of toolchainStatuses) if (!status.found) yield* Effect.log(`${BULLET} ${status.path}: savvy-toolchain section not found`);
-		else if (status.isUpToDate) yield* Effect.log(`${CHECK_MARK} ${status.path}: savvy-toolchain up-to-date`);
-		else yield* Effect.log(`${WARNING} ${status.path}: savvy-toolchain outdated (run 'savvy init' to update)`);
-		yield* Effect.log("\nTool availability:");
+		for (const status of shellHookStatuses) if (!status.found) yield* Output.skip(`${status.path}: savvy-hooks section not found`);
+		else if (status.isUpToDate) yield* Output.ok(`${status.path}: up-to-date`);
+		else yield* Output.warn(`${status.path}: outdated (run 'savvy init' to update)`);
+		for (const status of installStatuses) if (!status.found) yield* Output.skip(`${status.path}: savvy-install section not found`);
+		else if (status.isUpToDate) yield* Output.ok(`${status.path}: savvy-install up-to-date`);
+		else yield* Output.warn(`${status.path}: savvy-install outdated (run 'savvy init' to update)`);
+		for (const status of toolchainStatuses) if (!status.found) yield* Output.skip(`${status.path}: savvy-toolchain section not found`);
+		else if (status.isUpToDate) yield* Output.ok(`${status.path}: savvy-toolchain up-to-date`);
+		else yield* Output.warn(`${status.path}: savvy-toolchain outdated (run 'savvy init' to update)`);
+		yield* Output.line("");
+		yield* Output.heading("Tool availability");
 		const biomeAvailable = yield* td.isAvailable(Tool.named("biome"));
 		const biomeConfig = yield* findConfig(discovery, ["biome.jsonc", "biome.json"]);
 		if (biomeAvailable) {
 			const configInfo = biomeConfig ? ` (config: ${biomeConfig})` : "";
-			yield* Effect.log(`  ${CHECK_MARK} Biome${configInfo}`);
-		} else yield* Effect.log(`  ${BULLET} Biome: not installed`);
+			yield* Output.ok(`Biome${configInfo}`);
+		} else yield* Output.skip(`Biome: not installed`);
 		const markdownAvailable = yield* td.isAvailable(Tool.named("markdownlint-cli2"));
 		const markdownConfig = yield* findConfig(discovery, [
 			".markdownlint-cli2.jsonc",
@@ -333,29 +329,29 @@ function runLintCheck(opts) {
 		]);
 		if (markdownAvailable) {
 			const configInfo = markdownConfig ? ` (config: ${markdownConfig})` : "";
-			yield* Effect.log(`  ${CHECK_MARK} markdownlint-cli2${configInfo}`);
-		} else yield* Effect.log(`  ${BULLET} markdownlint-cli2: not installed`);
+			yield* Output.ok(`markdownlint-cli2${configInfo}`);
+		} else yield* Output.skip(`markdownlint-cli2: not installed`);
 		const tscAvailable = yield* td.isAvailable(Tool.named("tsc"));
 		const tsgoAvailable = yield* td.isAvailable(Tool.named("tsgo"));
-		if (tscAvailable) yield* Effect.log(`  ${CHECK_MARK} TypeScript (tsc)`);
-		else if (tsgoAvailable) yield* Effect.log(`  ${CHECK_MARK} TypeScript (tsgo)`);
-		else yield* Effect.log(`  ${BULLET} TypeScript: not installed`);
+		if (tscAvailable) yield* Output.ok(`TypeScript (tsc)`);
+		else if (tsgoAvailable) yield* Output.ok(`TypeScript (tsgo)`);
+		else yield* Output.skip(`TypeScript: not installed`);
 		if (hasMarkdownlintConfig) {
-			if (markdownlintStatus.isUpToDate) yield* Effect.log(`  ${CHECK_MARK} ${Lint.MARKDOWNLINT_CONFIG_PATH}: up-to-date`);
+			if (markdownlintStatus.isUpToDate) yield* Output.ok(`${Lint.MARKDOWNLINT_CONFIG_PATH}: up-to-date`);
 			else {
 				const issues = [];
 				if (!markdownlintStatus.schemaMatches) issues.push("$schema");
 				if (!markdownlintStatus.configMatches) issues.push("config");
-				yield* Effect.log(`  ${WARNING} ${Lint.MARKDOWNLINT_CONFIG_PATH}: ${issues.join(", ")} differ from template`);
+				yield* Output.warn(`${Lint.MARKDOWNLINT_CONFIG_PATH}: ${issues.join(", ")} differ from template`);
 			}
-		} else yield* Effect.log(`  ${BULLET} ${Lint.MARKDOWNLINT_CONFIG_PATH}: not found`);
-		for (const status of biomeSchemaStatus.statuses) if (status.matches) yield* Effect.log(`  ${CHECK_MARK} ${status.path}: biome $schema up-to-date`);
-		else yield* Effect.log(`  ${WARNING} ${status.path}: biome $schema outdated (run 'savvy init' to update)`);
-		yield* Effect.log("");
+		} else yield* Output.skip(`${Lint.MARKDOWNLINT_CONFIG_PATH}: not found`);
+		for (const status of biomeSchemaStatus.statuses) if (status.matches) yield* Output.ok(`${status.path}: biome $schema up-to-date`);
+		else yield* Output.warn(`${status.path}: biome $schema outdated (run 'savvy init' to update)`);
+		yield* Output.line("");
 		const hasMarkdownlintIssues = hasMarkdownlintConfig && !markdownlintStatus.isUpToDate;
 		const hasBiomeSchemaIssues = biomeSchemaStatus.statuses.some((s) => !s.matches);
-		if (!foundConfig || !hasHuskyHook || !sectionsHealthy || hasMarkdownlintIssues || hasBiomeSchemaIssues) yield* Effect.log(`${WARNING} Some issues found. Run 'savvy init' to fix.`);
-		else yield* Effect.log(`${CHECK_MARK} Lint-staged is configured correctly.`);
+		if (!foundConfig || !hasHuskyHook || !sectionsHealthy || hasMarkdownlintIssues || hasBiomeSchemaIssues) yield* Output.warn(`Some issues found. Run 'savvy init' to fix.`);
+		else yield* Output.ok(`Lint-staged is configured correctly.`);
 	});
 }
 

package/commands/lint/init.js

@@ -1,3 +1,4 @@
+import { Output } from "../../internal/output.js";
 import { BIOME_VERSION } from "./biome-version.js";
 import { dirname, join } from "node:path";
 import { BiomeSchemaSync, LIFECYCLE_SCRIPTS_CONFIG_KEY, Lint, SavvyBaseSection, SavvyHooksSection, SavvyToolchainSection, publishesBuiltLinkDirectory, savvyBasePreamble, savvyHooksHygiene, savvyInstallBlock, savvyOkfBlock, savvyToolchainCheck } from "@savvy-web/silk-effects";
@@ -14,10 +15,6 @@ import { isDeepStrictEqual } from "node:util";
 *
 * @internal
 */
-/** Unicode checkmark symbol. */
-const CHECK_MARK = "✓";
-/** Unicode warning symbol. */
-const WARNING = "⚠";
 /** Executable file permission mode. */
 const EXECUTABLE_MODE = 493;
 /** Formatting options for jsonc-effect surgical edits. */
@@ -85,16 +82,16 @@ function writeMarkdownlintConfig(fs, preset, force) {
 		if (!configExists) {
 			yield* fs.makeDirectory("lib/configs", { recursive: true });
 			yield* fs.writeFileString(Lint.MARKDOWNLINT_CONFIG_PATH, `${fullTemplate}\n`);
-			yield* Effect.log(`${CHECK_MARK} Created ${Lint.MARKDOWNLINT_CONFIG_PATH}`);
+			yield* Output.ok(`Created ${Lint.MARKDOWNLINT_CONFIG_PATH}`);
 			return;
 		}
 		if (preset !== "silk") {
-			yield* Effect.log(`${CHECK_MARK} ${Lint.MARKDOWNLINT_CONFIG_PATH}: exists (not managed by ${preset} preset)`);
+			yield* Output.ok(`${Lint.MARKDOWNLINT_CONFIG_PATH}: exists (not managed by ${preset} preset)`);
 			return;
 		}
 		if (force) {
 			yield* fs.writeFileString(Lint.MARKDOWNLINT_CONFIG_PATH, `${fullTemplate}\n`);
-			yield* Effect.log(`${CHECK_MARK} Replaced ${Lint.MARKDOWNLINT_CONFIG_PATH} (--force)`);
+			yield* Output.ok(`Replaced ${Lint.MARKDOWNLINT_CONFIG_PATH} (--force)`);
 			return;
 		}
 		const existingText = yield* fs.readFileString(Lint.MARKDOWNLINT_CONFIG_PATH);
@@ -116,11 +113,11 @@ function writeMarkdownlintConfig(fs, preset, force) {
 		}
 		const existingConfig = existingParsed.config;
 		const configMatches = existingConfig !== void 0 && isDeepStrictEqual(existingConfig, Lint.MARKDOWNLINT_CONFIG);
-		if (!configMatches) yield* Effect.log(`${WARNING} ${Lint.MARKDOWNLINT_CONFIG_PATH}: config rules differ from template (use --force to overwrite)`);
+		if (!configMatches) yield* Output.warn(`${Lint.MARKDOWNLINT_CONFIG_PATH}: config rules differ from template (use --force to overwrite)`);
 		if (applied.length > 0) {
 			yield* fs.writeFileString(Lint.MARKDOWNLINT_CONFIG_PATH, updatedText);
-			yield* Effect.log(`${CHECK_MARK} Updated ${applied.join(", ")} in ${Lint.MARKDOWNLINT_CONFIG_PATH}`);
-		} else if (configMatches) yield* Effect.log(`${CHECK_MARK} ${Lint.MARKDOWNLINT_CONFIG_PATH}: up-to-date`);
+			yield* Output.ok(`Updated ${applied.join(", ")} in ${Lint.MARKDOWNLINT_CONFIG_PATH}`);
+		} else if (configMatches) yield* Output.ok(`${Lint.MARKDOWNLINT_CONFIG_PATH}: up-to-date`);
 	});
 }
 /**
@@ -151,7 +148,7 @@ function writeMarkdownlintConfig(fs, preset, force) {
 */
 function biomeConfigRoots() {
 	return Effect.gen(function* () {
-		return yield* (yield* WorkspaceDiscovery).listPackages().pipe(Effect.map((packages) => packages.map((pkg) => pkg.path)), Effect.catchTag("WorkspaceRootNotFoundError", () => Effect.succeed([])), Effect.catch((e) => Effect.as(Effect.log(`${WARNING} Only syncing biome $schema in the current directory: ${e.message}`), [])));
+		return yield* (yield* WorkspaceDiscovery).listPackages().pipe(Effect.map((packages) => packages.map((pkg) => pkg.path)), Effect.catchTag("WorkspaceRootNotFoundError", () => Effect.succeed([])), Effect.catch((e) => Effect.as(Effect.logWarning(`Only syncing biome $schema in the current directory: ${e.message}`), [])));
 	});
 }
 /**
@@ -179,8 +176,8 @@ function noticeLifecycleScripts() {
 		for (const root of roots) {
 			const manifest = yield* fs.readFileString(join(root, "package.json")).pipe(Effect.map((raw) => JSON.parse(raw)), Effect.catch(() => Effect.succeed(void 0)));
 			if (publishesBuiltLinkDirectory(manifest)) {
-				yield* Effect.log(`${WARNING} This workspace publishes through built link directories, so a hook-time install must run lifecycle scripts.`);
-				yield* Effect.log(`   Allow them with: git config --local ${LIFECYCLE_SCRIPTS_CONFIG_KEY} true`);
+				yield* Output.warn("This workspace publishes through built link directories, so a hook-time install must run lifecycle scripts.");
+				yield* Output.detail(`Allow them with: git config --local ${LIFECYCLE_SCRIPTS_CONFIG_KEY} true`);
 				return;
 			}
 		}
@@ -210,9 +207,9 @@ function syncBiomeSchemas() {
 		const roots = yield* biomeConfigRoots();
 		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}`);
-		})), Effect.catchTag("BiomeSyncError", (e) => Effect.log(`${WARNING} Could not sync biome $schema: ${e.message}`)));
+			for (const configPath of result.current) yield* Output.ok(`${configPath}: biome $schema up-to-date`);
+			for (const configPath of result.updated) yield* Output.ok(`Updated $schema in ${configPath}`);
+		})), Effect.catchTag("BiomeSyncError", (e) => Output.warn(`Could not sync biome $schema: ${e.message}`)));
 	});
 }
 /** Make a file executable. */
@@ -246,7 +243,7 @@ function runLintInit(opts) {
 		const fs = yield* FileSystem.FileSystem;
 		const ms = yield* ManagedSection;
 		if (config.startsWith("/")) yield* Effect.fail(/* @__PURE__ */ new Error("Config path must be relative to repository root, not absolute"));
-		yield* Effect.log("Initializing lint-staged configuration...\n");
+		yield* Output.heading("lint-staged");
 		yield* fs.makeDirectory(".husky", { recursive: true });
 		if (force) yield* fs.writeFileString(Lint.HUSKY_HOOK_PATH, PRE_COMMIT_HEADER);
 		else yield* ensureHookFile(Lint.HUSKY_HOOK_PATH, PRE_COMMIT_HEADER);
@@ -256,7 +253,7 @@ function runLintInit(opts) {
 			savvyOkfBlock()
 		]);
 		yield* makeExecutable(Lint.HUSKY_HOOK_PATH);
-		yield* Effect.log(`${CHECK_MARK} ${force ? "Replaced" : "Synced"} ${Lint.HUSKY_HOOK_PATH} (${preCommitResults.map((r) => r._tag).join(", ")})`);
+		yield* Output.ok(`${force ? "Replaced" : "Synced"} ${Lint.HUSKY_HOOK_PATH} (${preCommitResults.map((r) => r._tag).join(", ")})`);
 		if (presetIncludesShellScripts(preset)) for (const [hookPath, installHook] of HYGIENE_HOOKS) {
 			yield* ensureHookFile(hookPath, HYGIENE_HEADER);
 			yield* ms.remove(hookPath, Lint.LegacySavvyLintHygieneDef);
@@ -267,19 +264,20 @@ function runLintInit(opts) {
 			}
 			yield* ms.syncAll(hookPath, sections);
 			yield* makeExecutable(hookPath);
-			yield* Effect.log(`${CHECK_MARK} Synced ${hookPath}`);
+			yield* Output.ok(`Synced ${hookPath}`);
 		}
 		if (presetIncludesShellScripts(preset)) yield* noticeLifecycleScripts();
 		if (presetIncludesMarkdown(preset)) yield* writeMarkdownlintConfig(fs, preset, force);
 		yield* syncBiomeSchemas();
-		if ((yield* fs.exists(config)) && !force) yield* Effect.log(`${WARNING} ${config} already exists (use --force to overwrite)`);
+		if ((yield* fs.exists(config)) && !force) yield* Output.warn(`${config} already exists (use --force to overwrite)`);
 		else {
 			const configDir = dirname(config);
 			if (configDir && configDir !== ".") yield* fs.makeDirectory(configDir, { recursive: true });
 			yield* fs.writeFileString(config, generateConfigContent(preset));
-			yield* Effect.log(`${CHECK_MARK} Created ${config} (preset: ${preset})`);
+			yield* Output.ok(`Created ${config} (preset: ${preset})`);
 		}
-		yield* Effect.log("\nDone! Lint-staged is ready to use.");
+		yield* Output.line("");
+		yield* Output.ok("lint-staged is ready to use");
 	});
 }
 

package/commands/repos/commands/add.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect, Option } from "effect";
 
@@ -43,18 +45,15 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposAdd = (cwd, opts) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).add(cwd, opts);
-	yield* Effect.log(`${result.name} @ ${result.ref} -> ${result.path}`);
-	yield* Effect.log("staged — review and commit");
+	yield* Output.ok(`${result.name} @ ${result.ref} -> ${result.path}`);
+	yield* Output.detail("staged — review and commit");
 }).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 runReposAdd */
 const addCommand = Command.make("add", {

package/commands/repos/commands/deregister.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -46,15 +48,13 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposDeregister = (cwd, section) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).deregister(cwd, section);
-	yield* Effect.log(`${result.section}: deregistered (${result.removedKeys.length} config keys removed)`);
-	for (const key of result.removedKeys) yield* Effect.log(`  removed ${key}`);
-	yield* Effect.log("local git config only — nothing to commit");
+	yield* Output.ok(`${result.section}: deregistered (${result.removedKeys.length} config keys removed)`);
+	for (const key of result.removedKeys) yield* Output.detail(`removed ${key}`);
+	yield* Output.detail("local git config only — nothing to commit");
 }).pipe(Effect.catchTag("ReposConfigError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	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)));
 }));
 /* v8 ignore start -- CLI registration; handler tested via runReposDeregister */
 const deregisterCommand = Command.make("deregister", {

package/commands/repos/commands/note.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -39,17 +41,14 @@ import { Effect } from "effect";
 */
 const runReposNote = (cwd, name, op) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).note(cwd, name, op);
-	yield* Effect.log(`${result.name}: ${result.op} note ${result.id} (${result.noteCount} notes)`);
+	yield* Output.ok(`${result.name}: ${result.op} note ${result.id} (${result.noteCount} notes)`);
 }).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("RepoNotFoundError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	return CliExit.set(1).pipe(Effect.andThen(Effect.logError(error.message)));
 }), Effect.catchTag("NoteNotFoundError", (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 runReposNote */
 const nameArg = Argument.String("name");

package/commands/repos/commands/pin.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -39,23 +41,19 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposPin = (cwd, name, ref) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).pin(cwd, name, ref);
-	yield* Effect.log(`${result.name}: ${result.oldCommit ?? "unknown"} -> ${result.newCommit}`);
-	yield* Effect.log(result.commitMessage);
-	yield* Effect.log("staged — review and commit");
-	for (const staleId of result.staleNoteIds) yield* Effect.log(`warning: note ${staleId} is now stale against ${ref}`);
+	yield* Output.ok(`${result.name}: ${result.oldCommit ?? "unknown"} -> ${result.newCommit}`);
+	yield* Output.detail(result.commitMessage);
+	yield* Output.detail("staged — review and commit");
+	for (const staleId of result.staleNoteIds) yield* Output.warn(`note ${staleId} is now stale against ${ref}`);
 }).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("RepoNotFoundError", (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 runReposPin */
 const pinCommand = Command.make("pin", {

package/commands/repos/commands/remove.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -43,27 +45,23 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposRemove = (cwd, name) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).remove(cwd, name);
-	yield* Effect.log(`${result.name}: removed (${result.path})`);
-	yield* Effect.log(result.commitMessage);
-	yield* Effect.log("staged — review and commit");
-	for (const note of result.removedNotes) yield* Effect.log(`warning: note ${note.id} (${note.ref}) was removed with the entry — promote first if durable`);
+	yield* Output.ok(`${result.name}: removed (${result.path})`);
+	yield* Output.detail(result.commitMessage);
+	yield* Output.detail("staged — review and commit");
+	for (const note of result.removedNotes) yield* Output.warn(`note ${note.id} (${note.ref}) was removed with the entry — promote first if durable`);
 	if (result.removedEntry.orientation) {
-		yield* Effect.log(`warning: the orientation block for ${result.name} was removed with the entry and add will NOT restore it — re-vendoring? capture it now:`);
-		yield* Effect.log(JSON.stringify(result.removedEntry.orientation, null, 2));
+		yield* Output.warn(`the orientation block for ${result.name} was removed with the entry and add will NOT restore it — re-vendoring? capture it now:`);
+		yield* Output.line(JSON.stringify(result.removedEntry.orientation, null, 2));
 	}
 }).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("RepoNotFoundError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	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 runReposRemove */
 const removeCommand = Command.make("remove", {

package/commands/repos/commands/rename.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -45,22 +47,18 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposRename = (cwd, oldName, newName) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).rename(cwd, oldName, newName);
-	yield* Effect.log(`${result.oldName}: renamed to ${result.newName} (${result.path})`);
-	yield* Effect.log(result.commitMessage);
-	yield* Effect.log("staged — review and commit");
+	yield* Output.ok(`${result.oldName}: renamed to ${result.newName} (${result.path})`);
+	yield* Output.detail(result.commitMessage);
+	yield* Output.detail("staged — review and commit");
 }).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("RepoNotFoundError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	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 runReposRename */
 const renameCommand = Command.make("rename", {

package/commands/repos/commands/restore.js

@@ -1,4 +1,6 @@
+import { Output } from "../../../internal/output.js";
 import { Argument, Command, Flag } from "effect/unstable/cli";
+import { CliExit } from "@effected/cli";
 import { Repos } from "@savvy-web/silk-effects";
 import { Effect } from "effect";
 
@@ -50,24 +52,20 @@ const cwdOption = Flag.Directory("cwd").pipe(Flag.withDescription("Repo root to
 */
 const runReposRestore = (cwd, names) => Effect.gen(function* () {
 	const result = yield* (yield* Repos.ReposManager).restore(cwd, names.length > 0 ? names : void 0);
-	for (const entry of result.restored) yield* Effect.log(`${entry.name}: restored to ${entry.commit}`);
-	for (const name of result.skippedClean) yield* Effect.log(`${name}: clean — skipped`);
-	for (const name of result.stillDirty) yield* Effect.log(`${name}: WARNING — reset ran but the worktree is STILL dirty; run \`savvy repos status --drift\``);
-	if (result.stillDirty.length > 0) process.exitCode = 1;
-	if (result.restored.length === 0 && result.skippedClean.length === 0) yield* Effect.log("nothing to restore");
+	for (const entry of result.restored) yield* Output.ok(`${entry.name}: restored to ${entry.commit}`);
+	for (const name of result.skippedClean) yield* Output.skip(`${name}: clean — skipped`);
+	for (const name of result.stillDirty) yield* Output.fail(`${name}: reset ran but the worktree is STILL dirty; run \`savvy repos status --drift\``);
+	if (result.stillDirty.length > 0) yield* CliExit.set(1);
+	if (result.restored.length === 0 && result.skippedClean.length === 0) yield* Output.ok("nothing to restore");
 }).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("RepoNotFoundError", (error) => {
-	process.exitCode = 1;
-	return Effect.log(error.message);
+	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 runReposRestore */
 const restoreCommand = Command.make("restore", {