@savvy-web/cli 0.2.0 → 0.3.0

package/841.js

@@ -3,12 +3,12 @@ import { NodeContext, NodeRuntime } from "@effect/platform-node";
 import { BiomeSchemaSync, BiomeSchemaSyncLive, ChangesetConfigReaderLive, Changesets, CheckResult, Commitlint, ConfigDiscovery, ConfigDiscoveryLive, Lint, ManagedSection, ManagedSectionLive, SavvyBaseSection, SavvyHooksSection, SectionDefinition, SilkPublishabilityDetectorLive, ToolDefinition, ToolDiscovery, ToolDiscoveryLive, VersioningStrategy, VersioningStrategyLive, savvyBasePreamble, savvyHooksHygiene, savvyToolSection } from "@savvy-web/silk-effects";
 import { Data, Effect, Layer, Option, Schema } from "effect";
 import { PackageManagerDetector, PackageManagerDetectorLive, WorkspaceDiscovery, WorkspaceDiscoveryLive, WorkspaceRoot, WorkspaceRootLive } from "workspaces-effect";
-import { dirname, join, resolve } from "node:path";
+import { dirname, join, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { execFile, execSync } from "node:child_process";
 import { applyEdits, modify, parse } from "jsonc-effect";
 import { FileSystem } from "@effect/platform";
-import { chmod } from "node:fs/promises";
+import { chmod, glob, realpath, rm } from "node:fs/promises";
 import { isDeepStrictEqual, promisify } from "node:util";
 import { parse as external_yaml_parse, stringify } from "yaml";
 const { BranchAnalyzer: BranchAnalyzer } = Changesets;
@@ -78,40 +78,6 @@ const analyzeBranchCommand = Command.make("analyze-branch", {
     base: baseOption,
     json: jsonOption
 }, ({ cwd, base, json })=>runAnalyzeBranch(cwd, base, json)).pipe(Command.withDescription("Diff the current branch and classify every changed file by owning package"));
-const { ChangesetLinter: ChangesetLinter } = Changesets;
-const dirArg = Args.directory({
-    name: "dir"
-}).pipe(Args.withDefault(".changeset"));
-function runChangesetCheck(dir) {
-    return Effect.gen(function*() {
-        const resolved = resolve(dir);
-        const messages = yield* Effect["try"]({
-            try: ()=>ChangesetLinter.validate(resolved),
-            catch: (e)=>new Error(String(e))
-        });
-        const byFile = new Map();
-        for (const msg of messages){
-            const existing = byFile.get(msg.file);
-            if (existing) existing.push(msg);
-            else byFile.set(msg.file, [
-                msg
-            ]);
-        }
-        for (const [file, fileMessages] of byFile){
-            yield* Effect.log(`\n${file}`);
-            for (const msg of fileMessages)yield* Effect.log(`  ${msg.line}:${msg.column}  ${msg.rule}  ${msg.message}`);
-        }
-        const errorCount = messages.length;
-        const filesWithErrors = byFile.size;
-        if (errorCount > 0) {
-            yield* Effect.log(`\n${filesWithErrors} file(s) with errors, ${errorCount} error(s) found`);
-            process.exitCode = 1;
-        } else yield* Effect.log("All changeset files passed validation.");
-    });
-}
-const checkCommand = Command.make("check", {
-    dir: dirArg
-}, ({ dir })=>runChangesetCheck(dir)).pipe(Command.withDescription("Full changeset validation with summary"));
 const { ConfigInspector: ConfigInspector } = Changesets;
 const pathsArg = Args.text({
     name: "path"
@@ -142,7 +108,7 @@ const classifyCommand = Command.make("classify", {
     json: classify_jsonOption
 }, ({ paths, cwd, json })=>runClassify(cwd, paths, json)).pipe(Command.withDescription("Map paths to their owning package per .changeset/config.json"));
 const { ConfigInspector: config_show_ConfigInspector } = Changesets;
-const config_show_dirArg = Args.directory({
+const dirArg = Args.directory({
     name: "dir"
 }).pipe(Args.withDefault("."));
 const config_show_jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
@@ -198,7 +164,7 @@ function runConfigShow(dir, json) {
     });
 }
 const configShowCommand = Command.make("show", {
-    dir: config_show_dirArg,
+    dir: dirArg,
     json: config_show_jsonOption
 }, ({ dir, json })=>runConfigShow(dir, json)).pipe(Command.withDescription("Print the resolved .changeset/config.json"));
 const { ConfigInspector: config_validate_ConfigInspector } = Changesets;
@@ -512,677 +478,726 @@ const depsRegenCommand = Command.make("regen", {
     dryRun: dryRunOption,
     json: deps_regen_jsonOption
 }, ({ cwd, base, package: pkg, dryRun, json })=>runDepsRegen(cwd, base, pkg, dryRun, json)).pipe(Command.withDescription("Delete pure dependency changesets and regenerate them from the current diff"));
-const { LegacyVersionFilesSchema: LegacyVersionFilesSchema } = Changesets;
-const CUSTOM_RULES_ENTRY = "@savvy-web/changesets/markdownlint";
-const CHANGELOG_ENTRY = "@savvy-web/changesets/changelog";
-const MARKDOWNLINT_CONFIG_PATHS = [
-    "lib/configs/.markdownlint-cli2.jsonc",
-    "lib/configs/.markdownlint-cli2.json",
-    ".markdownlint-cli2.jsonc",
-    ".markdownlint-cli2.json"
-];
-const RULE_NAMES = [
-    "changeset-heading-hierarchy",
-    "changeset-required-sections",
-    "changeset-content-structure",
-    "changeset-uncategorized-content",
-    "changeset-dependency-table-format"
-];
-const DEFAULT_CONFIG = {
-    $schema: "https://unpkg.com/@changesets/config@3.1.1/schema.json",
-    changelog: [
-        CHANGELOG_ENTRY,
-        {
-            repo: "owner/repo"
-        }
-    ],
-    commit: false,
-    access: "restricted",
-    baseBranch: "main",
-    updateInternalDependencies: "patch",
-    ignore: [],
-    privatePackages: {
-        tag: true,
-        version: true
+const { ChangesetLinter: ChangesetLinter } = Changesets;
+const lint_dirArg = Args.directory({
+    name: "dir"
+}).pipe(Args.withDefault(".changeset"));
+const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Only output errors, no summary"), Options.withDefault(false));
+function runLint(dir, quiet) {
+    return Effect.gen(function*() {
+        const resolved = resolve(dir);
+        const messages = yield* Effect["try"](()=>ChangesetLinter.validate(resolved));
+        for (const msg of messages)yield* Effect.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
+        if (!quiet && 0 === messages.length) yield* Effect.log("No lint errors found.");
+        if (messages.length > 0) process.exitCode = 1;
+    });
+}
+const lintCommand = Command.make("lint", {
+    dir: lint_dirArg,
+    quiet: quietOption
+}, ({ dir, quiet })=>runLint(dir, quiet)).pipe(Command.withDescription("Validate changeset files"));
+const { ConfigInspector: release_surface_ConfigInspector, ConfigurationError: ConfigurationError } = Changesets;
+const packageArg = Args.text({
+    name: "package"
+});
+const release_surface_cwdOption = Options.directory("cwd").pipe(Options.withDescription("Project root (defaults to the current working directory)"), Options.withDefault("."));
+const release_surface_jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
+function release_surface_renderHuman(pkg) {
+    const lines = [];
+    lines.push(`Package:   ${pkg.name}  v${pkg.version}`);
+    lines.push(`Workspace: ${pkg.workspaceDir}`);
+    if (0 === pkg.additionalScopes.length && 0 === pkg.versionFiles.length) {
+        lines.push("");
+        lines.push("(no additionalScopes or versionFiles — workspace dir is the entire release surface)");
+        return lines.join("\n");
     }
-};
-const InitErrorBase = Data.TaggedError("InitError");
-class InitError extends InitErrorBase {
-    get message() {
-        return `Init failed at ${this.step}: ${this.reason}`;
+    if (pkg.additionalScopes.length > 0) {
+        lines.push("");
+        lines.push(`additionalScopes (${pkg.additionalScopes.length} glob${1 === pkg.additionalScopes.length ? "" : "s"}):`);
+        for (const g of pkg.additionalScopes)lines.push(`  - ${g}`);
+        lines.push(`Resolved files (${pkg.additionalScopeFiles.length}):`);
+        for (const f of pkg.additionalScopeFiles)lines.push(`  ${f}`);
     }
+    if (pkg.versionFiles.length > 0) {
+        lines.push("");
+        lines.push(`versionFiles (${pkg.versionFiles.length}):`);
+        for (const vf of pkg.versionFiles){
+            lines.push(`  ${vf.glob} → ${vf.paths.join(", ")}`);
+            for (const f of vf.matchedFiles)lines.push(`    ${f}`);
+        }
+    }
+    return lines.join("\n");
 }
-const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite existing config files"));
-const quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Silence warnings, always exit 0"));
-const skipMarkdownlintOption = Options.boolean("skip-markdownlint").pipe(Options.withDescription("Skip registering rules in base markdownlint config"));
-const checkOption = Options.boolean("check").pipe(Options.withDescription("Check configuration without writing (for postinstall scripts)"));
-function detectGitHubRepo(cwd) {
-    try {
-        const url = execSync("git remote get-url origin", {
-            cwd,
-            encoding: "utf-8"
-        }).trim();
-        const https = url.match(/github\.com\/([^/]+)\/([^/.]+)/);
-        if (https) return `${https[1]}/${https[2]}`;
-        const ssh = url.match(/github\.com:([^/]+)\/([^/.]+)/);
-        if (ssh) return `${ssh[1]}/${ssh[2]}`;
-    } catch  {}
-    return null;
-}
-const JSONC_FORMAT = {
-    tabSize: 1,
-    insertSpaces: false
-};
-function resolveWorkspaceRoot(cwd) {
-    return WorkspaceRoot.pipe(Effect.flatMap((wr)=>wr.find(cwd)), Effect.catchAll(()=>Effect.succeed(cwd)));
-}
-function findMarkdownlintConfig(root) {
-    for (const configPath of MARKDOWNLINT_CONFIG_PATHS)if (existsSync(join(root, configPath))) return configPath;
-    return null;
-}
-function ensureChangesetDir(root) {
-    return Effect["try"]({
-        try: ()=>{
-            const dir = join(root, ".changeset");
-            mkdirSync(dir, {
-                recursive: true
-            });
-            return dir;
-        },
-        catch: (error)=>new InitError({
-                step: ".changeset directory",
-                reason: error instanceof Error ? error.message : String(error)
-            })
-    });
-}
-function handleConfig(changesetDir, repoSlug, force) {
-    return Effect["try"]({
-        try: ()=>{
-            const configPath = join(changesetDir, "config.json");
-            if (force || !existsSync(configPath)) {
-                const config = {
-                    ...DEFAULT_CONFIG,
-                    changelog: [
-                        CHANGELOG_ENTRY,
-                        {
-                            repo: repoSlug
-                        }
-                    ]
-                };
-                writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}\n`);
-                return force ? "Overwrote .changeset/config.json" : "Created .changeset/config.json";
-            }
-            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
-            const currentOptions = Array.isArray(existing.changelog) && "object" == typeof existing.changelog[1] && null !== existing.changelog[1] ? existing.changelog[1] : {};
-            existing.changelog = [
-                CHANGELOG_ENTRY,
-                {
-                    ...currentOptions,
-                    repo: repoSlug
-                }
-            ];
-            writeFileSync(configPath, `${JSON.stringify(existing, null, "\t")}\n`);
-            return "Patched changelog in .changeset/config.json";
-        },
-        catch: (error)=>new InitError({
-                step: ".changeset/config.json",
-                reason: error instanceof Error ? error.message : String(error)
-            })
+function runReleaseSurface(cwd, pkgName, json) {
+    return Effect.gen(function*() {
+        const inspector = yield* release_surface_ConfigInspector;
+        const resolvedCwd = resolve(cwd);
+        const config = yield* inspector.inspect(resolvedCwd).pipe(Effect.catchTag("ConfigurationError", (err)=>{
+            process.exitCode = 1;
+            return Effect.fail(err);
+        }));
+        const scope = config.packages.find((p)=>p.name === pkgName);
+        if (!scope) {
+            process.exitCode = 1;
+            return yield* Effect.fail(new ConfigurationError({
+                field: `packages["${pkgName}"]`,
+                reason: `Package "${pkgName}" is not declared in .changeset/config.json#packages. Declared packages: ${config.packages.map((p)=>p.name).join(", ") || "(none)"}.`
+            }));
+        }
+        const output = json ? JSON.stringify(scope, null, 2) : release_surface_renderHuman(scope);
+        yield* Effect.log(output);
     });
 }
-function detectLegacyVersionFiles(config) {
-    if ("object" != typeof config || null === config) return false;
-    const cfg = config;
-    const changelog = cfg.changelog;
-    if (!Array.isArray(changelog) || changelog.length < 2) return false;
-    const options = changelog[1];
-    if ("object" != typeof options || null === options) return false;
-    return Array.isArray(options.versionFiles) && options.versionFiles.length > 0;
-}
-function legacyVersionFilesWarning(configPath) {
-    return [
-        `DEPRECATION: ${configPath} uses the legacy top-level \`versionFiles[]\` array.`,
-        "  Migrate each entry to `changelog[1].packages[<entry.package>].versionFiles`",
-        "  and remove the top-level field. Run `savvy changeset config show --json`",
-        "  to see the normalized form, or check the 0.9.0 release notes for examples.",
-        "  Removed in @savvy-web/changesets 1.0.0."
-    ].join("\n");
-}
-function warnIfLegacyVersionFiles(changesetDir) {
+const releaseSurfaceCommand = Command.make("release-surface", {
+    package: packageArg,
+    cwd: release_surface_cwdOption,
+    json: release_surface_jsonOption
+}, ({ package: pkgName, cwd, json })=>runReleaseSurface(cwd, pkgName, json)).pipe(Command.withDescription("Print every path owned by a package — workspace dir, additionalScopes, versionFiles"));
+const { ConfigInspector: config_gate_ConfigInspector } = Changesets;
+function requireValidConfig(cwd) {
     return Effect.gen(function*() {
-        const configPath = join(changesetDir, "config.json");
+        const projectDir = resolve(cwd);
+        const configPath = join(projectDir, ".changeset", "config.json");
         if (!existsSync(configPath)) return;
-        let parsed;
-        try {
-            parsed = JSON.parse(readFileSync(configPath, "utf-8"));
-        } catch  {
-            return;
-        }
-        if (detectLegacyVersionFiles(parsed)) yield* Effect.logWarning(legacyVersionFilesWarning(configPath));
+        const inspector = yield* config_gate_ConfigInspector;
+        yield* inspector.inspect(projectDir).pipe(Effect.catchTag("ConfigurationError", (err)=>{
+            process.exitCode = 1;
+            return Effect.fail(err);
+        }));
     });
 }
-function handleBaseMarkdownlint(root) {
-    const foundPath = findMarkdownlintConfig(root);
-    if (!foundPath) return Effect.succeed(`Warning: no markdownlint config found (checked ${MARKDOWNLINT_CONFIG_PATHS.join(", ")})`);
+const { ChangelogTransformer: ChangelogTransformer } = Changesets;
+const fileArg = Args.file({
+    name: "file"
+}).pipe(Args.withDefault("CHANGELOG.md"));
+const transform_dryRunOption = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Print transformed output instead of writing"), Options.withDefault(false));
+const checkOption = Options.boolean("check").pipe(Options.withAlias("c"), Options.withDescription("Exit 1 if file would change (for CI)"), Options.withDefault(false));
+function runTransform(file, dryRun, check) {
     return Effect.gen(function*() {
-        const fullPath = join(root, foundPath);
-        let text;
-        try {
-            text = readFileSync(fullPath, "utf-8");
-        } catch (error) {
-            return yield* Effect.fail(new InitError({
-                step: "markdownlint config",
-                reason: error instanceof Error ? error.message : String(error)
-            }));
-        }
-        let parsed = yield* parse(text);
-        if (!Array.isArray(parsed.customRules) || !parsed.customRules.includes(CUSTOM_RULES_ENTRY)) if (Array.isArray(parsed.customRules)) {
-            const currentArray = parsed.customRules;
-            const edits = yield* modify(text, [
-                "customRules",
-                currentArray.length
-            ], CUSTOM_RULES_ENTRY, {
-                formattingOptions: JSONC_FORMAT
-            });
-            text = yield* applyEdits(text, edits);
-        } else {
-            const edits = yield* modify(text, [
-                "customRules"
-            ], [
-                CUSTOM_RULES_ENTRY
-            ], {
-                formattingOptions: JSONC_FORMAT
-            });
-            text = yield* applyEdits(text, edits);
-        }
-        parsed = yield* parse(text);
-        const currentConfig = parsed.config;
-        if ("object" != typeof currentConfig || null === currentConfig) {
-            const edits = yield* modify(text, [
-                "config"
-            ], {}, {
-                formattingOptions: JSONC_FORMAT
-            });
-            text = yield* applyEdits(text, edits);
-        }
-        parsed = yield* parse(text);
-        const config = parsed.config;
-        for (const rule of RULE_NAMES)if (!(rule in config)) {
-            const edits = yield* modify(text, [
-                "config",
-                rule
-            ], false, {
-                formattingOptions: JSONC_FORMAT
-            });
-            text = yield* applyEdits(text, edits);
-        }
-        try {
-            writeFileSync(fullPath, text);
-        } catch (error) {
-            return yield* Effect.fail(new InitError({
-                step: "markdownlint config",
-                reason: error instanceof Error ? error.message : String(error)
-            }));
+        const resolved = resolve(file);
+        yield* requireValidConfig(dirname(resolved));
+        const content = yield* Effect["try"](()=>readFileSync(resolved, "utf-8"));
+        const result = ChangelogTransformer.transformContent(content);
+        if (dryRun) return void (yield* Effect.log(result));
+        if (check) {
+            if (result !== content) {
+                yield* Effect.log(`${resolved} would be modified by transform.`);
+                process.exitCode = 1;
+            } else yield* Effect.log(`${resolved} is already formatted.`);
+            return;
         }
-        return `Updated ${foundPath}`;
-    }).pipe(Effect.catchAll((error)=>{
-        if (error instanceof InitError) return Effect.fail(error);
-        return Effect.fail(new InitError({
-            step: "markdownlint config",
-            reason: error instanceof Error ? error.message : String(error)
-        }));
-    }));
+        yield* Effect["try"](()=>writeFileSync(resolved, result, "utf-8"));
+        yield* Effect.log(`Transformed ${resolved}`);
+    });
 }
-function handleChangesetMarkdownlint(changesetDir, root, force) {
-    return Effect["try"]({
-        try: ()=>{
-            const mdlintPath = join(changesetDir, ".markdownlint.json");
-            const baseConfig = findMarkdownlintConfig(root);
-            if (force || !existsSync(mdlintPath)) {
-                const mdlintConfig = {};
-                if (baseConfig) mdlintConfig.extends = `../${baseConfig}`;
-                mdlintConfig.default = false;
-                mdlintConfig.MD041 = false;
-                for (const rule of RULE_NAMES)mdlintConfig[rule] = true;
-                writeFileSync(mdlintPath, `${JSON.stringify(mdlintConfig, null, "\t")}\n`);
-                return force ? "Overwrote .changeset/.markdownlint.json" : "Created .changeset/.markdownlint.json";
-            }
-            const existing = JSON.parse(readFileSync(mdlintPath, "utf-8"));
-            for (const rule of RULE_NAMES)existing[rule] = true;
-            writeFileSync(mdlintPath, `${JSON.stringify(existing, null, "\t")}\n`);
-            return "Patched rules in .changeset/.markdownlint.json";
-        },
-        catch: (error)=>new InitError({
-                step: ".changeset/.markdownlint.json",
-                reason: error instanceof Error ? error.message : String(error)
-            })
+const transformCommand = Command.make("transform", {
+    file: fileArg,
+    dryRun: transform_dryRunOption,
+    check: checkOption
+}, ({ file, dryRun, check })=>runTransform(file, dryRun, check)).pipe(Command.withDescription("Post-process CHANGELOG.md"));
+const { ChangesetLinter: validate_file_ChangesetLinter } = Changesets;
+const validate_file_fileArg = Args.file({
+    name: "file"
+});
+function runValidateFile(filePath) {
+    return Effect.gen(function*() {
+        const result = yield* Effect["try"](()=>validate_file_ChangesetLinter.validateFile(filePath)).pipe(Effect.catchAll((error)=>Effect.gen(function*() {
+                yield* Effect.log(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                process.exitCode = 1;
+                return null;
+            })));
+        if (null === result) return;
+        for (const msg of result)yield* Effect.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
+        if (result.length > 0) process.exitCode = 1;
+        else yield* Effect.log("Valid.");
     });
 }
-function checkChangesetDir(root) {
-    const dir = join(root, ".changeset");
-    if (!existsSync(dir)) return [
-        {
-            file: ".changeset/",
-            message: "directory does not exist"
-        }
-    ];
-    return [];
+const validateFileCommand = Command.make("validate-file", {
+    file: validate_file_fileArg
+}, ({ file })=>runValidateFile(file)).pipe(Command.withDescription("Validate a single changeset file"));
+const { ChangelogTransformer: version_ChangelogTransformer, ConfigInspector: version_ConfigInspector, VersionFileError: VersionFileError, VersionFiles: VersionFiles } = Changesets;
+function getChangesetVersionCommand(pm) {
+    switch(pm){
+        case "pnpm":
+            return "pnpm exec changeset version";
+        case "yarn":
+            return "yarn exec changeset version";
+        case "bun":
+            return "bun x changeset version";
+        default:
+            return "npx changeset version";
+    }
 }
-function checkConfig(changesetDir, repoSlug) {
-    const configPath = join(changesetDir, "config.json");
-    if (!existsSync(configPath)) return [
-        {
-            file: ".changeset/config.json",
-            message: "file does not exist"
-        }
-    ];
-    try {
-        const config = JSON.parse(readFileSync(configPath, "utf-8"));
-        const issues = [];
-        const changelog = config.changelog;
-        const entry = Array.isArray(changelog) ? changelog[0] : changelog;
-        const repo = Array.isArray(changelog) ? changelog[1]?.repo : void 0;
-        if (entry !== CHANGELOG_ENTRY) issues.push({
-            file: ".changeset/config.json",
-            message: `changelog formatter is "${entry}", expected "${CHANGELOG_ENTRY}"`
-        });
-        else if (repo !== repoSlug) issues.push({
-            file: ".changeset/config.json",
-            message: `changelog repo is "${repo ?? "(not set)"}", expected "${repoSlug}"`
-        });
-        const options = Array.isArray(changelog) ? changelog[1] : void 0;
-        if (options && "object" == typeof options && "versionFiles" in options) {
-            const result = Schema.decodeUnknownEither(LegacyVersionFilesSchema)(options.versionFiles);
-            if ("Left" === result._tag) issues.push({
-                file: ".changeset/config.json",
-                message: "versionFiles config is invalid"
+const version_dryRunOption = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Skip changeset version, only transform existing CHANGELOGs"), Options.withDefault(false));
+function runVersion(dryRun) {
+    return Effect.gen(function*() {
+        const cwd = process.cwd();
+        const detector = yield* PackageManagerDetector;
+        const detected = yield* detector.detect(cwd).pipe(Effect.catchAll(()=>Effect.succeed({
+                type: "npm",
+                version: void 0
+            })));
+        const pm = detected.type;
+        yield* Effect.log(`Detected package manager: ${pm}`);
+        yield* requireValidConfig(cwd);
+        if (dryRun) yield* Effect.log("Dry run: skipping changeset version");
+        else {
+            const cmd = getChangesetVersionCommand(pm);
+            yield* Effect.log(`Running: ${cmd}`);
+            yield* Effect["try"]({
+                try: ()=>execSync(cmd, {
+                        cwd,
+                        stdio: "inherit"
+                    }),
+                catch: (error)=>new Error(`changeset version failed: ${error instanceof Error ? error.message : String(error)}`)
             });
         }
-        if (detectLegacyVersionFiles(config)) issues.push({
-            file: ".changeset/config.json",
-            message: "uses the legacy top-level `versionFiles[]` array (deprecated; removed in 1.0.0). Migrate to `packages[<name>].versionFiles`."
-        });
-        return issues;
-    } catch  {
-        return [
-            {
-                file: ".changeset/config.json",
-                message: "could not parse file"
+        const discovery = yield* WorkspaceDiscovery;
+        const packages = yield* discovery.listPackages().pipe(Effect.catchAll(()=>Effect.succeed([])));
+        const changelogs = [];
+        const seen = new Set();
+        const resolvedCwd = resolve(cwd);
+        for (const pkg of packages){
+            const changelogPath = join(pkg.path, "CHANGELOG.md");
+            if (existsSync(changelogPath) && !seen.has(pkg.path)) {
+                seen.add(pkg.path);
+                changelogs.push({
+                    name: pkg.name,
+                    path: pkg.path,
+                    changelogPath
+                });
             }
-        ];
-    }
-}
-function checkBaseMarkdownlint(root) {
-    const foundPath = findMarkdownlintConfig(root);
-    if (!foundPath) return [
-        {
-            file: "markdownlint config",
-            message: `not found (checked ${MARKDOWNLINT_CONFIG_PATHS.join(", ")})`
         }
-    ];
-    try {
-        const raw = readFileSync(join(root, foundPath), "utf-8");
-        const parsed = Effect.runSync(parse(raw));
-        const issues = [];
-        if (!Array.isArray(parsed.customRules) || !parsed.customRules.includes(CUSTOM_RULES_ENTRY)) issues.push({
-            file: foundPath,
-            message: `customRules does not include ${CUSTOM_RULES_ENTRY}`
-        });
-        const config = parsed.config;
-        if ("object" != typeof config || null === config) issues.push({
-            file: foundPath,
-            message: "config section is missing"
-        });
-        else for (const rule of RULE_NAMES)if (!(rule in config)) issues.push({
-            file: foundPath,
-            message: `rule "${rule}" is not configured`
+        if (!seen.has(resolvedCwd)) {
+            const rootChangelog = join(resolvedCwd, "CHANGELOG.md");
+            if (existsSync(rootChangelog)) {
+                let rootName = "root";
+                try {
+                    const pkg = JSON.parse(readFileSync(join(resolvedCwd, "package.json"), "utf-8"));
+                    if (pkg.name) rootName = pkg.name;
+                } catch  {}
+                changelogs.push({
+                    name: rootName,
+                    path: resolvedCwd,
+                    changelogPath: rootChangelog
+                });
+            }
+        }
+        if (0 === changelogs.length) yield* Effect.log("No CHANGELOG.md files found.");
+        else {
+            yield* Effect.log(`Found ${changelogs.length} CHANGELOG.md file(s)`);
+            for (const entry of changelogs){
+                yield* Effect["try"]({
+                    try: ()=>version_ChangelogTransformer.transformFile(entry.changelogPath),
+                    catch: (error)=>new Error(`Failed to transform ${entry.changelogPath}: ${error instanceof Error ? error.message : String(error)}`)
+                });
+                yield* Effect.log(`Transformed ${entry.name} → ${entry.changelogPath}`);
+            }
+        }
+        const configPath = join(resolvedCwd, ".changeset", "config.json");
+        if (!existsSync(configPath)) return;
+        const inspector = yield* version_ConfigInspector;
+        const inspected = yield* inspector.inspect(resolvedCwd);
+        const scopesWithVersionFiles = inspected.packages.filter((p)=>p.versionFiles.length > 0).map((p)=>{
+            const fresh = readPackageVersionFromDisk(p.workspaceDir);
+            return fresh && fresh !== p.version ? {
+                ...p,
+                version: fresh
+            } : p;
         });
-        return issues;
-    } catch  {
-        return [
-            {
-                file: foundPath,
-                message: "could not parse file"
+        if (0 === scopesWithVersionFiles.length) return;
+        yield* Effect.log(`Found ${scopesWithVersionFiles.length} package${1 === scopesWithVersionFiles.length ? "" : "s"} with versionFiles`);
+        const updates = yield* Effect["try"]({
+            try: ()=>VersionFiles.processResolvedVersionFiles(scopesWithVersionFiles, dryRun),
+            catch: (error)=>{
+                const message = error instanceof Error ? error.message : String(error);
+                return new VersionFileError({
+                    filePath: message.match(/Failed to update (.+?):/)?.[1] ?? cwd,
+                    reason: message
+                });
             }
-        ];
-    }
-}
-function checkChangesetMarkdownlint(changesetDir) {
-    const mdlintPath = join(changesetDir, ".markdownlint.json");
-    if (!existsSync(mdlintPath)) return [
-        {
-            file: ".changeset/.markdownlint.json",
-            message: "file does not exist"
+        });
+        for (const update of updates){
+            const action = dryRun ? "Would update" : "Updated";
+            yield* Effect.log(`${action} ${update.filePath} → ${update.version}`);
         }
-    ];
+    });
+}
+function readPackageVersionFromDisk(workspaceDir) {
     try {
-        const existing = JSON.parse(readFileSync(mdlintPath, "utf-8"));
-        const issues = [];
-        for (const rule of RULE_NAMES)if (true !== existing[rule]) issues.push({
-            file: ".changeset/.markdownlint.json",
-            message: `rule "${rule}" is not enabled`
-        });
-        return issues;
+        const pkg = JSON.parse(readFileSync(join(workspaceDir, "package.json"), "utf-8"));
+        return pkg.version ?? null;
     } catch  {
-        return [
-            {
-                file: ".changeset/.markdownlint.json",
-                message: "could not parse file"
-            }
-        ];
+        return null;
     }
 }
-function runChangesetInit(opts) {
-    const { force, quiet, skipMarkdownlint, check } = opts;
+const versionCommand = Command.make("version", {
+    dryRun: version_dryRunOption
+}, ({ dryRun })=>runVersion(dryRun)).pipe(Command.withDescription("Run changeset version and transform all CHANGELOGs"));
+const { ChangesetLinter: check_ChangesetLinter } = Changesets;
+const check_dirArg = Args.directory({
+    name: "dir"
+}).pipe(Args.withDefault(".changeset"));
+function runChangesetCheck(dir) {
     return Effect.gen(function*() {
-        const root = yield* resolveWorkspaceRoot(process.cwd());
-        const repo = detectGitHubRepo(root);
-        if (!repo && !quiet) yield* Effect.log("Warning: could not detect GitHub repo from git remote, using placeholder");
-        const repoSlug = repo ?? "owner/repo";
-        if (check) {
-            const changesetDir = join(root, ".changeset");
-            const issues = [
-                ...checkChangesetDir(root),
-                ...checkConfig(changesetDir, repoSlug),
-                ...skipMarkdownlint ? [] : checkBaseMarkdownlint(root),
-                ...checkChangesetMarkdownlint(changesetDir)
-            ];
-            if (0 === issues.length) return void (yield* Effect.log("All @savvy-web/changesets config files are up to date."));
-            for (const issue of issues)yield* Effect.logWarning(`${issue.file}: ${issue.message}`);
-            yield* Effect.logWarning('Run "savvy changeset init --force" to fix.');
-            return;
+        const resolved = resolve(dir);
+        const messages = yield* Effect["try"]({
+            try: ()=>check_ChangesetLinter.validate(resolved),
+            catch: (e)=>new Error(String(e))
+        });
+        const byFile = new Map();
+        for (const msg of messages){
+            const existing = byFile.get(msg.file);
+            if (existing) existing.push(msg);
+            else byFile.set(msg.file, [
+                msg
+            ]);
         }
-        const changesetDir = yield* ensureChangesetDir(root);
-        yield* Effect.log("Ensured .changeset/ directory");
-        const errors = [];
-        const configResult = yield* handleConfig(changesetDir, repoSlug, force).pipe(Effect.either);
-        if ("Right" === configResult._tag) {
-            yield* Effect.log(configResult.right);
-            if (!quiet) yield* warnIfLegacyVersionFiles(changesetDir);
-        } else errors.push(configResult.left);
-        if (!skipMarkdownlint) {
-            const baseResult = yield* handleBaseMarkdownlint(root).pipe(Effect.either);
-            if ("Right" === baseResult._tag) yield* Effect.log(baseResult.right);
-            else errors.push(baseResult.left);
+        for (const [file, fileMessages] of byFile){
+            yield* Effect.log(`\n${file}`);
+            for (const msg of fileMessages)yield* Effect.log(`  ${msg.line}:${msg.column}  ${msg.rule}  ${msg.message}`);
         }
-        const mdlintResult = yield* handleChangesetMarkdownlint(changesetDir, root, force).pipe(Effect.either);
-        if ("Right" === mdlintResult._tag) yield* Effect.log(mdlintResult.right);
-        else errors.push(mdlintResult.left);
-        if (errors.length > 0) {
-            for (const err of errors)yield* Effect.logError(err.message);
-            if (!quiet) process.exitCode = 1;
-            return;
+        const errorCount = messages.length;
+        const filesWithErrors = byFile.size;
+        if (errorCount > 0) {
+            yield* Effect.log(`\n${filesWithErrors} file(s) with errors, ${errorCount} error(s) found`);
+            process.exitCode = 1;
+        } else yield* Effect.log("All changeset files passed validation.");
+    });
+}
+Command.make("check", {
+    dir: check_dirArg
+}, ({ dir })=>runChangesetCheck(dir)).pipe(Command.withDescription("Full changeset validation with summary"));
+const { LegacyVersionFilesSchema: LegacyVersionFilesSchema } = Changesets;
+const CHANGELOG_ENTRY = "@savvy-web/silk/changesets/changelog";
+const LEGACY_CHANGELOG_ENTRY = "@savvy-web/changesets/changelog";
+const ACCEPTED_CHANGELOG_ENTRIES = [
+    CHANGELOG_ENTRY,
+    LEGACY_CHANGELOG_ENTRY
+];
+const CUSTOM_RULES_ENTRY = "@savvy-web/silk/changesets/markdownlint";
+const LEGACY_CUSTOM_RULES_ENTRY = "@savvy-web/changesets/markdownlint";
+const ACCEPTED_CUSTOM_RULES_ENTRIES = [
+    CUSTOM_RULES_ENTRY,
+    LEGACY_CUSTOM_RULES_ENTRY
+];
+const MARKDOWNLINT_CONFIG_PATHS = [
+    "lib/configs/.markdownlint-cli2.jsonc",
+    "lib/configs/.markdownlint-cli2.json",
+    ".markdownlint-cli2.jsonc",
+    ".markdownlint-cli2.json"
+];
+const RULE_NAMES = [
+    "changeset-heading-hierarchy",
+    "changeset-required-sections",
+    "changeset-content-structure",
+    "changeset-uncategorized-content",
+    "changeset-dependency-table-format"
+];
+const DEFAULT_CONFIG = {
+    $schema: "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+    changelog: [
+        CHANGELOG_ENTRY,
+        {
+            repo: "owner/repo"
         }
-        yield* Effect.log("Init complete.");
-    }).pipe(Effect.catchAll((error)=>Effect.gen(function*() {
-            if (!quiet) {
-                yield* Effect.logError(error instanceof InitError ? error.message : `Init failed: ${String(error)}`);
-                process.exitCode = 1;
-            }
-        })));
+    ],
+    commit: false,
+    access: "restricted",
+    baseBranch: "main",
+    updateInternalDependencies: "patch",
+    ignore: [],
+    privatePackages: {
+        tag: true,
+        version: true
+    }
+};
+const InitErrorBase = Data.TaggedError("InitError");
+class InitError extends InitErrorBase {
+    get message() {
+        return `Init failed at ${this.step}: ${this.reason}`;
+    }
 }
-const initCommand = Command.make("init", {
-    force: forceOption,
-    quiet: quietOption,
-    skipMarkdownlint: skipMarkdownlintOption,
-    check: checkOption
-}, (opts)=>runChangesetInit(opts)).pipe(Command.withDescription("Bootstrap a repo for @savvy-web/changesets"));
-const { ChangesetLinter: lint_ChangesetLinter } = Changesets;
-const lint_dirArg = Args.directory({
-    name: "dir"
-}).pipe(Args.withDefault(".changeset"));
-const lint_quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Only output errors, no summary"), Options.withDefault(false));
-function runLint(dir, quiet) {
-    return Effect.gen(function*() {
-        const resolved = resolve(dir);
-        const messages = yield* Effect["try"](()=>lint_ChangesetLinter.validate(resolved));
-        for (const msg of messages)yield* Effect.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
-        if (!quiet && 0 === messages.length) yield* Effect.log("No lint errors found.");
-        if (messages.length > 0) process.exitCode = 1;
+const forceOption = Options.boolean("force").pipe(Options.withAlias("f"), Options.withDescription("Overwrite existing config files"));
+const init_quietOption = Options.boolean("quiet").pipe(Options.withAlias("q"), Options.withDescription("Silence warnings, always exit 0"));
+const skipMarkdownlintOption = Options.boolean("skip-markdownlint").pipe(Options.withDescription("Skip registering rules in base markdownlint config"));
+const init_checkOption = Options.boolean("check").pipe(Options.withDescription("Check configuration without writing (for postinstall scripts)"));
+function detectGitHubRepo(cwd) {
+    try {
+        const url = execSync("git remote get-url origin", {
+            cwd,
+            encoding: "utf-8"
+        }).trim();
+        const https = url.match(/github\.com\/([^/]+)\/([^/.]+)/);
+        if (https) return `${https[1]}/${https[2]}`;
+        const ssh = url.match(/github\.com:([^/]+)\/([^/.]+)/);
+        if (ssh) return `${ssh[1]}/${ssh[2]}`;
+    } catch  {}
+    return null;
+}
+const JSONC_FORMAT = {
+    tabSize: 1,
+    insertSpaces: false
+};
+function resolveWorkspaceRoot(cwd) {
+    return WorkspaceRoot.pipe(Effect.flatMap((wr)=>wr.find(cwd)), Effect.catchAll(()=>Effect.succeed(cwd)));
+}
+function findMarkdownlintConfig(root) {
+    for (const configPath of MARKDOWNLINT_CONFIG_PATHS)if (existsSync(join(root, configPath))) return configPath;
+    return null;
+}
+function ensureChangesetDir(root) {
+    return Effect["try"]({
+        try: ()=>{
+            const dir = join(root, ".changeset");
+            mkdirSync(dir, {
+                recursive: true
+            });
+            return dir;
+        },
+        catch: (error)=>new InitError({
+                step: ".changeset directory",
+                reason: error instanceof Error ? error.message : String(error)
+            })
+    });
+}
+function handleConfig(changesetDir, repoSlug, force) {
+    return Effect["try"]({
+        try: ()=>{
+            const configPath = join(changesetDir, "config.json");
+            if (force || !existsSync(configPath)) {
+                const config = {
+                    ...DEFAULT_CONFIG,
+                    changelog: [
+                        CHANGELOG_ENTRY,
+                        {
+                            repo: repoSlug
+                        }
+                    ]
+                };
+                writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}\n`);
+                return force ? "Overwrote .changeset/config.json" : "Created .changeset/config.json";
+            }
+            const existing = JSON.parse(readFileSync(configPath, "utf-8"));
+            const currentOptions = Array.isArray(existing.changelog) && "object" == typeof existing.changelog[1] && null !== existing.changelog[1] ? existing.changelog[1] : {};
+            existing.changelog = [
+                CHANGELOG_ENTRY,
+                {
+                    ...currentOptions,
+                    repo: repoSlug
+                }
+            ];
+            writeFileSync(configPath, `${JSON.stringify(existing, null, "\t")}\n`);
+            return "Patched changelog in .changeset/config.json";
+        },
+        catch: (error)=>new InitError({
+                step: ".changeset/config.json",
+                reason: error instanceof Error ? error.message : String(error)
+            })
     });
 }
-const lintCommand = Command.make("lint", {
-    dir: lint_dirArg,
-    quiet: lint_quietOption
-}, ({ dir, quiet })=>runLint(dir, quiet)).pipe(Command.withDescription("Validate changeset files"));
-const { ConfigInspector: release_surface_ConfigInspector, ConfigurationError: ConfigurationError } = Changesets;
-const packageArg = Args.text({
-    name: "package"
-});
-const release_surface_cwdOption = Options.directory("cwd").pipe(Options.withDescription("Project root (defaults to the current working directory)"), Options.withDefault("."));
-const release_surface_jsonOption = Options.boolean("json").pipe(Options.withDescription("Emit JSON instead of human-readable output"), Options.withDefault(false));
-function release_surface_renderHuman(pkg) {
-    const lines = [];
-    lines.push(`Package:   ${pkg.name}  v${pkg.version}`);
-    lines.push(`Workspace: ${pkg.workspaceDir}`);
-    if (0 === pkg.additionalScopes.length && 0 === pkg.versionFiles.length) {
-        lines.push("");
-        lines.push("(no additionalScopes or versionFiles — workspace dir is the entire release surface)");
-        return lines.join("\n");
-    }
-    if (pkg.additionalScopes.length > 0) {
-        lines.push("");
-        lines.push(`additionalScopes (${pkg.additionalScopes.length} glob${1 === pkg.additionalScopes.length ? "" : "s"}):`);
-        for (const g of pkg.additionalScopes)lines.push(`  - ${g}`);
-        lines.push(`Resolved files (${pkg.additionalScopeFiles.length}):`);
-        for (const f of pkg.additionalScopeFiles)lines.push(`  ${f}`);
-    }
-    if (pkg.versionFiles.length > 0) {
-        lines.push("");
-        lines.push(`versionFiles (${pkg.versionFiles.length}):`);
-        for (const vf of pkg.versionFiles){
-            lines.push(`  ${vf.glob} → ${vf.paths.join(", ")}`);
-            for (const f of vf.matchedFiles)lines.push(`    ${f}`);
-        }
-    }
-    return lines.join("\n");
+function detectLegacyVersionFiles(config) {
+    if ("object" != typeof config || null === config) return false;
+    const cfg = config;
+    const changelog = cfg.changelog;
+    if (!Array.isArray(changelog) || changelog.length < 2) return false;
+    const options = changelog[1];
+    if ("object" != typeof options || null === options) return false;
+    return Array.isArray(options.versionFiles) && options.versionFiles.length > 0;
 }
-function runReleaseSurface(cwd, pkgName, json) {
-    return Effect.gen(function*() {
-        const inspector = yield* release_surface_ConfigInspector;
-        const resolvedCwd = resolve(cwd);
-        const config = yield* inspector.inspect(resolvedCwd).pipe(Effect.catchTag("ConfigurationError", (err)=>{
-            process.exitCode = 1;
-            return Effect.fail(err);
-        }));
-        const scope = config.packages.find((p)=>p.name === pkgName);
-        if (!scope) {
-            process.exitCode = 1;
-            return yield* Effect.fail(new ConfigurationError({
-                field: `packages["${pkgName}"]`,
-                reason: `Package "${pkgName}" is not declared in .changeset/config.json#packages. Declared packages: ${config.packages.map((p)=>p.name).join(", ") || "(none)"}.`
-            }));
-        }
-        const output = json ? JSON.stringify(scope, null, 2) : release_surface_renderHuman(scope);
-        yield* Effect.log(output);
-    });
+function legacyVersionFilesWarning(configPath) {
+    return [
+        `DEPRECATION: ${configPath} uses the legacy top-level \`versionFiles[]\` array.`,
+        "  Migrate each entry to `changelog[1].packages[<entry.package>].versionFiles`",
+        "  and remove the top-level field. Run `savvy changeset config show --json`",
+        "  to see the normalized form, or check the 0.9.0 release notes for examples.",
+        "  Removed in @savvy-web/changesets 1.0.0."
+    ].join("\n");
 }
-const releaseSurfaceCommand = Command.make("release-surface", {
-    package: packageArg,
-    cwd: release_surface_cwdOption,
-    json: release_surface_jsonOption
-}, ({ package: pkgName, cwd, json })=>runReleaseSurface(cwd, pkgName, json)).pipe(Command.withDescription("Print every path owned by a package — workspace dir, additionalScopes, versionFiles"));
-const { ConfigInspector: config_gate_ConfigInspector } = Changesets;
-function requireValidConfig(cwd) {
+function warnIfLegacyVersionFiles(changesetDir) {
     return Effect.gen(function*() {
-        const projectDir = resolve(cwd);
-        const configPath = join(projectDir, ".changeset", "config.json");
+        const configPath = join(changesetDir, "config.json");
         if (!existsSync(configPath)) return;
-        const inspector = yield* config_gate_ConfigInspector;
-        yield* inspector.inspect(projectDir).pipe(Effect.catchTag("ConfigurationError", (err)=>{
-            process.exitCode = 1;
-            return Effect.fail(err);
-        }));
-    });
-}
-const { ChangelogTransformer: ChangelogTransformer } = Changesets;
-const fileArg = Args.file({
-    name: "file"
-}).pipe(Args.withDefault("CHANGELOG.md"));
-const transform_dryRunOption = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Print transformed output instead of writing"), Options.withDefault(false));
-const transform_checkOption = Options.boolean("check").pipe(Options.withAlias("c"), Options.withDescription("Exit 1 if file would change (for CI)"), Options.withDefault(false));
-function runTransform(file, dryRun, check) {
-    return Effect.gen(function*() {
-        const resolved = resolve(file);
-        yield* requireValidConfig(dirname(resolved));
-        const content = yield* Effect["try"](()=>readFileSync(resolved, "utf-8"));
-        const result = ChangelogTransformer.transformContent(content);
-        if (dryRun) return void (yield* Effect.log(result));
-        if (check) {
-            if (result !== content) {
-                yield* Effect.log(`${resolved} would be modified by transform.`);
-                process.exitCode = 1;
-            } else yield* Effect.log(`${resolved} is already formatted.`);
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(configPath, "utf-8"));
+        } catch  {
             return;
         }
-        yield* Effect["try"](()=>writeFileSync(resolved, result, "utf-8"));
-        yield* Effect.log(`Transformed ${resolved}`);
-    });
-}
-const transformCommand = Command.make("transform", {
-    file: fileArg,
-    dryRun: transform_dryRunOption,
-    check: transform_checkOption
-}, ({ file, dryRun, check })=>runTransform(file, dryRun, check)).pipe(Command.withDescription("Post-process CHANGELOG.md"));
-const { ChangesetLinter: validate_file_ChangesetLinter } = Changesets;
-const validate_file_fileArg = Args.file({
-    name: "file"
-});
-function runValidateFile(filePath) {
-    return Effect.gen(function*() {
-        const result = yield* Effect["try"](()=>validate_file_ChangesetLinter.validateFile(filePath)).pipe(Effect.catchAll((error)=>Effect.gen(function*() {
-                yield* Effect.log(`Error: ${error instanceof Error ? error.message : String(error)}`);
-                process.exitCode = 1;
-                return null;
-            })));
-        if (null === result) return;
-        for (const msg of result)yield* Effect.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
-        if (result.length > 0) process.exitCode = 1;
-        else yield* Effect.log("Valid.");
+        if (detectLegacyVersionFiles(parsed)) yield* Effect.logWarning(legacyVersionFilesWarning(configPath));
     });
 }
-const validateFileCommand = Command.make("validate-file", {
-    file: validate_file_fileArg
-}, ({ file })=>runValidateFile(file)).pipe(Command.withDescription("Validate a single changeset file"));
-const { ChangelogTransformer: version_ChangelogTransformer, ConfigInspector: version_ConfigInspector, VersionFileError: VersionFileError, VersionFiles: VersionFiles } = Changesets;
-function getChangesetVersionCommand(pm) {
-    switch(pm){
-        case "pnpm":
-            return "pnpm exec changeset version";
-        case "yarn":
-            return "yarn exec changeset version";
-        case "bun":
-            return "bun x changeset version";
-        default:
-            return "npx changeset version";
-    }
-}
-const version_dryRunOption = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Skip changeset version, only transform existing CHANGELOGs"), Options.withDefault(false));
-function runVersion(dryRun) {
+function handleBaseMarkdownlint(root) {
+    const foundPath = findMarkdownlintConfig(root);
+    if (!foundPath) return Effect.succeed(`Warning: no markdownlint config found (checked ${MARKDOWNLINT_CONFIG_PATHS.join(", ")})`);
     return Effect.gen(function*() {
-        const cwd = process.cwd();
-        const detector = yield* PackageManagerDetector;
-        const detected = yield* detector.detect(cwd).pipe(Effect.catchAll(()=>Effect.succeed({
-                type: "npm",
-                version: void 0
-            })));
-        const pm = detected.type;
-        yield* Effect.log(`Detected package manager: ${pm}`);
-        yield* requireValidConfig(cwd);
-        if (dryRun) yield* Effect.log("Dry run: skipping changeset version");
-        else {
-            const cmd = getChangesetVersionCommand(pm);
-            yield* Effect.log(`Running: ${cmd}`);
-            yield* Effect["try"]({
-                try: ()=>execSync(cmd, {
-                        cwd,
-                        stdio: "inherit"
-                    }),
-                catch: (error)=>new Error(`changeset version failed: ${error instanceof Error ? error.message : String(error)}`)
-            });
+        const fullPath = join(root, foundPath);
+        let text;
+        try {
+            text = readFileSync(fullPath, "utf-8");
+        } catch (error) {
+            return yield* Effect.fail(new InitError({
+                step: "markdownlint config",
+                reason: error instanceof Error ? error.message : String(error)
+            }));
         }
-        const discovery = yield* WorkspaceDiscovery;
-        const packages = yield* discovery.listPackages().pipe(Effect.catchAll(()=>Effect.succeed([])));
-        const changelogs = [];
-        const seen = new Set();
-        const resolvedCwd = resolve(cwd);
-        for (const pkg of packages){
-            const changelogPath = join(pkg.path, "CHANGELOG.md");
-            if (existsSync(changelogPath) && !seen.has(pkg.path)) {
-                seen.add(pkg.path);
-                changelogs.push({
-                    name: pkg.name,
-                    path: pkg.path,
-                    changelogPath
+        let parsed = yield* parse(text);
+        const currentRules = Array.isArray(parsed.customRules) ? parsed.customRules : null;
+        if (null === currentRules) {
+            const edits = yield* modify(text, [
+                "customRules"
+            ], [
+                CUSTOM_RULES_ENTRY
+            ], {
+                formattingOptions: JSONC_FORMAT
+            });
+            text = yield* applyEdits(text, edits);
+        } else {
+            const desired = currentRules.filter((r)=>r !== LEGACY_CUSTOM_RULES_ENTRY && r !== CUSTOM_RULES_ENTRY);
+            desired.push(CUSTOM_RULES_ENTRY);
+            const changed = desired.length !== currentRules.length || desired.some((r, i)=>r !== currentRules[i]);
+            if (changed) {
+                const edits = yield* modify(text, [
+                    "customRules"
+                ], desired, {
+                    formattingOptions: JSONC_FORMAT
                 });
+                text = yield* applyEdits(text, edits);
+            }
+        }
+        parsed = yield* parse(text);
+        const currentConfig = parsed.config;
+        if ("object" != typeof currentConfig || null === currentConfig) {
+            const edits = yield* modify(text, [
+                "config"
+            ], {}, {
+                formattingOptions: JSONC_FORMAT
+            });
+            text = yield* applyEdits(text, edits);
+        }
+        parsed = yield* parse(text);
+        const config = parsed.config;
+        for (const rule of RULE_NAMES)if (!(rule in config)) {
+            const edits = yield* modify(text, [
+                "config",
+                rule
+            ], false, {
+                formattingOptions: JSONC_FORMAT
+            });
+            text = yield* applyEdits(text, edits);
+        }
+        try {
+            writeFileSync(fullPath, text);
+        } catch (error) {
+            return yield* Effect.fail(new InitError({
+                step: "markdownlint config",
+                reason: error instanceof Error ? error.message : String(error)
+            }));
+        }
+        return `Updated ${foundPath}`;
+    }).pipe(Effect.catchAll((error)=>{
+        if (error instanceof InitError) return Effect.fail(error);
+        return Effect.fail(new InitError({
+            step: "markdownlint config",
+            reason: error instanceof Error ? error.message : String(error)
+        }));
+    }));
+}
+function handleChangesetMarkdownlint(changesetDir, root, force) {
+    return Effect["try"]({
+        try: ()=>{
+            const mdlintPath = join(changesetDir, ".markdownlint.json");
+            const baseConfig = findMarkdownlintConfig(root);
+            if (force || !existsSync(mdlintPath)) {
+                const mdlintConfig = {};
+                if (baseConfig) mdlintConfig.extends = `../${baseConfig}`;
+                mdlintConfig.default = false;
+                mdlintConfig.MD041 = false;
+                for (const rule of RULE_NAMES)mdlintConfig[rule] = true;
+                writeFileSync(mdlintPath, `${JSON.stringify(mdlintConfig, null, "\t")}\n`);
+                return force ? "Overwrote .changeset/.markdownlint.json" : "Created .changeset/.markdownlint.json";
             }
+            const existing = JSON.parse(readFileSync(mdlintPath, "utf-8"));
+            for (const rule of RULE_NAMES)existing[rule] = true;
+            writeFileSync(mdlintPath, `${JSON.stringify(existing, null, "\t")}\n`);
+            return "Patched rules in .changeset/.markdownlint.json";
+        },
+        catch: (error)=>new InitError({
+                step: ".changeset/.markdownlint.json",
+                reason: error instanceof Error ? error.message : String(error)
+            })
+    });
+}
+function checkChangesetDir(root) {
+    const dir = join(root, ".changeset");
+    if (!existsSync(dir)) return [
+        {
+            file: ".changeset/",
+            message: "directory does not exist"
         }
-        if (!seen.has(resolvedCwd)) {
-            const rootChangelog = join(resolvedCwd, "CHANGELOG.md");
-            if (existsSync(rootChangelog)) {
-                let rootName = "root";
-                try {
-                    const pkg = JSON.parse(readFileSync(join(resolvedCwd, "package.json"), "utf-8"));
-                    if (pkg.name) rootName = pkg.name;
-                } catch  {}
-                changelogs.push({
-                    name: rootName,
-                    path: resolvedCwd,
-                    changelogPath: rootChangelog
-                });
-            }
+    ];
+    return [];
+}
+function checkConfig(changesetDir, repoSlug) {
+    const configPath = join(changesetDir, "config.json");
+    if (!existsSync(configPath)) return [
+        {
+            file: ".changeset/config.json",
+            message: "file does not exist"
         }
-        if (0 === changelogs.length) yield* Effect.log("No CHANGELOG.md files found.");
-        else {
-            yield* Effect.log(`Found ${changelogs.length} CHANGELOG.md file(s)`);
-            for (const entry of changelogs){
-                yield* Effect["try"]({
-                    try: ()=>version_ChangelogTransformer.transformFile(entry.changelogPath),
-                    catch: (error)=>new Error(`Failed to transform ${entry.changelogPath}: ${error instanceof Error ? error.message : String(error)}`)
-                });
-                yield* Effect.log(`Transformed ${entry.name} → ${entry.changelogPath}`);
-            }
+    ];
+    try {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        const issues = [];
+        const changelog = config.changelog;
+        const entry = Array.isArray(changelog) ? changelog[0] : changelog;
+        const repo = Array.isArray(changelog) ? changelog[1]?.repo : void 0;
+        if (ACCEPTED_CHANGELOG_ENTRIES.includes(entry)) {
+            if (repo !== repoSlug) issues.push({
+                file: ".changeset/config.json",
+                message: `changelog repo is "${repo ?? "(not set)"}", expected "${repoSlug}"`
+            });
+        } else issues.push({
+            file: ".changeset/config.json",
+            message: `changelog formatter is "${entry}", expected "${CHANGELOG_ENTRY}"`
+        });
+        const options = Array.isArray(changelog) ? changelog[1] : void 0;
+        if (options && "object" == typeof options && "versionFiles" in options) {
+            const result = Schema.decodeUnknownEither(LegacyVersionFilesSchema)(options.versionFiles);
+            if ("Left" === result._tag) issues.push({
+                file: ".changeset/config.json",
+                message: "versionFiles config is invalid"
+            });
         }
-        const configPath = join(resolvedCwd, ".changeset", "config.json");
-        if (!existsSync(configPath)) return;
-        const inspector = yield* version_ConfigInspector;
-        const inspected = yield* inspector.inspect(resolvedCwd);
-        const scopesWithVersionFiles = inspected.packages.filter((p)=>p.versionFiles.length > 0).map((p)=>{
-            const fresh = readPackageVersionFromDisk(p.workspaceDir);
-            return fresh && fresh !== p.version ? {
-                ...p,
-                version: fresh
-            } : p;
+        if (detectLegacyVersionFiles(config)) issues.push({
+            file: ".changeset/config.json",
+            message: "uses the legacy top-level `versionFiles[]` array (deprecated; removed in 1.0.0). Migrate to `packages[<name>].versionFiles`."
         });
-        if (0 === scopesWithVersionFiles.length) return;
-        yield* Effect.log(`Found ${scopesWithVersionFiles.length} package${1 === scopesWithVersionFiles.length ? "" : "s"} with versionFiles`);
-        const updates = yield* Effect["try"]({
-            try: ()=>VersionFiles.processResolvedVersionFiles(scopesWithVersionFiles, dryRun),
-            catch: (error)=>{
-                const message = error instanceof Error ? error.message : String(error);
-                return new VersionFileError({
-                    filePath: message.match(/Failed to update (.+?):/)?.[1] ?? cwd,
-                    reason: message
-                });
+        return issues;
+    } catch  {
+        return [
+            {
+                file: ".changeset/config.json",
+                message: "could not parse file"
             }
-        });
-        for (const update of updates){
-            const action = dryRun ? "Would update" : "Updated";
-            yield* Effect.log(`${action} ${update.filePath} → ${update.version}`);
+        ];
+    }
+}
+function checkBaseMarkdownlint(root) {
+    const foundPath = findMarkdownlintConfig(root);
+    if (!foundPath) return [
+        {
+            file: "markdownlint config",
+            message: `not found (checked ${MARKDOWNLINT_CONFIG_PATHS.join(", ")})`
         }
-    });
+    ];
+    try {
+        const raw = readFileSync(join(root, foundPath), "utf-8");
+        const parsed = Effect.runSync(parse(raw));
+        const issues = [];
+        if (!Array.isArray(parsed.customRules) || !parsed.customRules.some((r)=>ACCEPTED_CUSTOM_RULES_ENTRIES.includes(r))) issues.push({
+            file: foundPath,
+            message: `customRules does not include ${CUSTOM_RULES_ENTRY}`
+        });
+        const config = parsed.config;
+        if ("object" != typeof config || null === config) issues.push({
+            file: foundPath,
+            message: "config section is missing"
+        });
+        else for (const rule of RULE_NAMES)if (!(rule in config)) issues.push({
+            file: foundPath,
+            message: `rule "${rule}" is not configured`
+        });
+        return issues;
+    } catch  {
+        return [
+            {
+                file: foundPath,
+                message: "could not parse file"
+            }
+        ];
+    }
 }
-function readPackageVersionFromDisk(workspaceDir) {
+function checkChangesetMarkdownlint(changesetDir) {
+    const mdlintPath = join(changesetDir, ".markdownlint.json");
+    if (!existsSync(mdlintPath)) return [
+        {
+            file: ".changeset/.markdownlint.json",
+            message: "file does not exist"
+        }
+    ];
     try {
-        const pkg = JSON.parse(readFileSync(join(workspaceDir, "package.json"), "utf-8"));
-        return pkg.version ?? null;
+        const existing = JSON.parse(readFileSync(mdlintPath, "utf-8"));
+        const issues = [];
+        for (const rule of RULE_NAMES)if (true !== existing[rule]) issues.push({
+            file: ".changeset/.markdownlint.json",
+            message: `rule "${rule}" is not enabled`
+        });
+        return issues;
     } catch  {
-        return null;
+        return [
+            {
+                file: ".changeset/.markdownlint.json",
+                message: "could not parse file"
+            }
+        ];
     }
 }
-const versionCommand = Command.make("version", {
-    dryRun: version_dryRunOption
-}, ({ dryRun })=>runVersion(dryRun)).pipe(Command.withDescription("Run changeset version and transform all CHANGELOGs"));
+function runChangesetInit(opts) {
+    const { force, quiet, skipMarkdownlint, check } = opts;
+    return Effect.gen(function*() {
+        const root = yield* resolveWorkspaceRoot(process.cwd());
+        const repo = detectGitHubRepo(root);
+        if (!repo && !quiet) yield* Effect.log("Warning: could not detect GitHub repo from git remote, using placeholder");
+        const repoSlug = repo ?? "owner/repo";
+        if (check) {
+            const changesetDir = join(root, ".changeset");
+            const issues = [
+                ...checkChangesetDir(root),
+                ...checkConfig(changesetDir, repoSlug),
+                ...skipMarkdownlint ? [] : checkBaseMarkdownlint(root),
+                ...checkChangesetMarkdownlint(changesetDir)
+            ];
+            if (0 === issues.length) return void (yield* Effect.log("All @savvy-web/changesets config files are up to date."));
+            for (const issue of issues)yield* Effect.logWarning(`${issue.file}: ${issue.message}`);
+            yield* Effect.logWarning('Run "savvy init --force" to fix.');
+            return;
+        }
+        const changesetDir = yield* ensureChangesetDir(root);
+        yield* Effect.log("Ensured .changeset/ directory");
+        const errors = [];
+        const configResult = yield* handleConfig(changesetDir, repoSlug, force).pipe(Effect.either);
+        if ("Right" === configResult._tag) {
+            yield* Effect.log(configResult.right);
+            if (!quiet) yield* warnIfLegacyVersionFiles(changesetDir);
+        } else errors.push(configResult.left);
+        if (!skipMarkdownlint) {
+            const baseResult = yield* handleBaseMarkdownlint(root).pipe(Effect.either);
+            if ("Right" === baseResult._tag) yield* Effect.log(baseResult.right);
+            else errors.push(baseResult.left);
+        }
+        const mdlintResult = yield* handleChangesetMarkdownlint(changesetDir, root, force).pipe(Effect.either);
+        if ("Right" === mdlintResult._tag) yield* Effect.log(mdlintResult.right);
+        else errors.push(mdlintResult.left);
+        if (errors.length > 0) {
+            for (const err of errors)yield* Effect.logError(err.message);
+            if (!quiet) process.exitCode = 1;
+            return;
+        }
+        yield* Effect.log("Init complete.");
+    }).pipe(Effect.catchAll((error)=>Effect.gen(function*() {
+            if (!quiet) {
+                yield* Effect.logError(error instanceof InitError ? error.message : `Init failed: ${String(error)}`);
+                process.exitCode = 1;
+            }
+        })));
+}
+Command.make("init", {
+    force: forceOption,
+    quiet: init_quietOption,
+    skipMarkdownlint: skipMarkdownlintOption,
+    check: init_checkOption
+}, (opts)=>runChangesetInit(opts)).pipe(Command.withDescription("Bootstrap a repo for @savvy-web/changesets"));
 const configGroup = Command.make("config").pipe(Command.withSubcommands([
     configShowCommand,
     configValidateCommand
@@ -1192,8 +1207,6 @@ const depsGroup = Command.make("deps").pipe(Command.withSubcommands([
     depsRegenCommand
 ]), Command.withDescription("Generate or regenerate dependency changesets"));
 const _changesetCommand = Command.make("changeset").pipe(Command.withSubcommands([
-    initCommand,
-    checkCommand,
     lintCommand,
     transformCommand,
     validateFileCommand,
@@ -1280,7 +1293,7 @@ function runCommitInit(opts) {
         yield* Effect.log("\nDone! Install @commitlint/cli if not already installed.");
     });
 }
-const init_initCommand = Command.make("init", {
+Command.make("init", {
     force: init_forceOption,
     config: configOption
 }, (opts)=>runCommitInit(opts)).pipe(Command.withDescription("Initialize commitlint configuration and husky hooks"));
@@ -1353,10 +1366,10 @@ function runCommitCheck() {
             if (CheckResult.$is("Found")(baseStatus) && baseStatus.isUpToDate) yield* Effect.log("✓ Base section: up-to-date");
             else if (CheckResult.$is("Found")(baseStatus)) {
                 sectionsHealthy = false;
-                yield* Effect.log("⚠ Base section: outdated (run 'savvy commit init' to update)");
+                yield* Effect.log("⚠ Base section: outdated (run 'savvy init' to update)");
             } else {
                 sectionsHealthy = false;
-                yield* Effect.log(`${BULLET} Base section: not found (run 'savvy commit init' to add)`);
+                yield* Effect.log(`${BULLET} Base section: not found (run 'savvy init' to add)`);
             }
             const block = yield* ms.read(HUSKY_HOOK_PATH, SECTION_DEF);
             if (block) {
@@ -1366,15 +1379,15 @@ function runCommitCheck() {
                     if (CheckResult.$is("Found")(status) && status.isUpToDate) yield* Effect.log("✓ Commit section: up-to-date");
                     else {
                         sectionsHealthy = false;
-                        yield* Effect.log("⚠ Commit section: outdated (run 'savvy commit init' to update)");
+                        yield* Effect.log("⚠ Commit section: outdated (run 'savvy init' to update)");
                     }
                 } else {
                     sectionsHealthy = false;
-                    yield* Effect.log("⚠ Commit section: outdated (run 'savvy commit init' to update)");
+                    yield* Effect.log("⚠ Commit section: outdated (run 'savvy init' to update)");
                 }
             } else {
                 sectionsHealthy = false;
-                yield* Effect.log(`${BULLET} Commit section: not found (run 'savvy commit init' to add)`);
+                yield* Effect.log(`${BULLET} Commit section: not found (run 'savvy init' to add)`);
             }
         }
         for (const hookPath of [
@@ -1384,17 +1397,17 @@ function runCommitCheck() {
             const hygieneExists = yield* fs.exists(hookPath);
             if (!hygieneExists) {
                 sectionsHealthy = false;
-                yield* Effect.log(`${BULLET} Hygiene hook: ${hookPath} not found (run 'savvy commit init' to add)`);
+                yield* Effect.log(`${BULLET} Hygiene hook: ${hookPath} not found (run 'savvy init' to add)`);
                 continue;
             }
             const hygieneStatus = yield* ms.check(hookPath, SavvyHooksSection.block(savvyHooksHygiene()));
             if (CheckResult.$is("Found")(hygieneStatus) && hygieneStatus.isUpToDate) yield* Effect.log(`✓ Hygiene hook: ${hookPath}`);
             else if (CheckResult.$is("Found")(hygieneStatus)) {
                 sectionsHealthy = false;
-                yield* Effect.log(`⚠ Hygiene hook: ${hookPath} outdated (run 'savvy commit init' to update)`);
+                yield* Effect.log(`⚠ Hygiene hook: ${hookPath} outdated (run 'savvy init' to update)`);
             } else {
                 sectionsHealthy = false;
-                yield* Effect.log(`${BULLET} Hygiene hook: ${hookPath} section not found (run 'savvy commit init' to add)`);
+                yield* Effect.log(`${BULLET} Hygiene hook: ${hookPath} section not found (run 'savvy init' to add)`);
             }
         }
         const hasDCOFile = yield* fs.exists(DCO_FILE_PATH);
@@ -1409,11 +1422,11 @@ function runCommitCheck() {
         yield* Effect.log(`  Detected scopes: ${scopeDisplay}`);
         yield* Effect.log("");
         const hasIssues = !foundConfig || !hasHuskyHook || !sectionsHealthy;
-        if (hasIssues) yield* Effect.log(`${CROSS_MARK} Commitlint needs configuration. Run: savvy commit init`);
+        if (hasIssues) yield* Effect.log(`${CROSS_MARK} Commitlint needs configuration. Run: savvy init`);
         else yield* Effect.log("✓ Commitlint is configured correctly.");
     });
 }
-const check_checkCommand = Command.make("check", {}, ()=>runCommitCheck()).pipe(Command.withDescription("Check current commitlint configuration and detected settings"));
+Command.make("check", {}, ()=>runCommitCheck()).pipe(Command.withDescription("Check current commitlint configuration and detected settings"));
 const check_CHECK_MARK = "✓";
 const check_CROSS_MARK = "✗";
 const check_WARNING = "⚠";
@@ -1494,7 +1507,7 @@ function checkBiomeSchemas() {
                     path: configPath,
                     matches: false
                 });
-                warnings.push(`${check_WARNING}  ${configPath}: biome $schema is outdated.\n   Run 'savvy lint init' to update it.`);
+                warnings.push(`${check_WARNING}  ${configPath}: biome $schema is outdated.\n   Run 'savvy init' to update it.`);
             }
         }
         return {
@@ -1542,12 +1555,12 @@ function runLintCheck(opts) {
                     sectionsHealthy = false;
                 }
             } else sectionsHealthy = false;
-            if ("up-to-date" !== baseStatusLabel || "up-to-date" !== lintStatusLabel) warnings.push(`${check_WARNING}  Your ${Lint.HUSKY_HOOK_PATH} managed sections are out of date.\n   Run 'savvy lint init' to update (preserves your custom hooks).`);
+            if ("up-to-date" !== baseStatusLabel || "up-to-date" !== lintStatusLabel) warnings.push(`${check_WARNING}  Your ${Lint.HUSKY_HOOK_PATH} managed sections are out of date.\n   Run 'savvy init' to update (preserves your custom hooks).`);
         } else {
             sectionsHealthy = false;
-            warnings.push(`${check_WARNING}  No husky pre-commit hook found.\n   Run 'savvy lint init' to create it.`);
+            warnings.push(`${check_WARNING}  No husky pre-commit hook found.\n   Run 'savvy init' to create it.`);
         }
-        if (!foundConfig) warnings.push(`${check_WARNING}  No lint-staged config file found.\n   Run 'savvy lint init' to create one.`);
+        if (!foundConfig) warnings.push(`${check_WARNING}  No lint-staged config file found.\n   Run 'savvy init' to create one.`);
         const shellHookPaths = [
             Lint.POST_CHECKOUT_HOOK_PATH,
             Lint.POST_MERGE_HOOK_PATH
@@ -1574,11 +1587,11 @@ function runLintCheck(opts) {
             if (found) {
                 if (!isUpToDate) {
                     sectionsHealthy = false;
-                    warnings.push(`${check_WARNING}  ${hookPath} savvy-hooks section is outdated.\n   Run 'savvy lint init' to update.`);
+                    warnings.push(`${check_WARNING}  ${hookPath} savvy-hooks section is outdated.\n   Run 'savvy init' to update.`);
                 }
             } else {
                 sectionsHealthy = false;
-                warnings.push(`${check_WARNING}  ${hookPath} has no savvy-hooks section.\n   Run 'savvy lint init' to add it.`);
+                warnings.push(`${check_WARNING}  ${hookPath} has no savvy-hooks section.\n   Run 'savvy init' to add it.`);
             }
         }
         const biomeSchemaStatus = yield* checkBiomeSchemas().pipe(Effect.catchAll(()=>Effect.succeed({
@@ -1598,8 +1611,8 @@ function runLintCheck(opts) {
         if (hasMarkdownlintConfig) {
             const mdContent = yield* fs.readFileString(Lint.MARKDOWNLINT_CONFIG_PATH);
             markdownlintStatus = yield* checkMarkdownlintConfig(mdContent);
-            if (!markdownlintStatus.schemaMatches) warnings.push(`${check_WARNING}  ${Lint.MARKDOWNLINT_CONFIG_PATH}: $schema differs from template.\n   Run 'savvy lint init' to update it.`);
-            if (!markdownlintStatus.configMatches) warnings.push(`${check_WARNING}  ${Lint.MARKDOWNLINT_CONFIG_PATH}: config rules differ from template.\n   Run 'savvy lint init --force' to overwrite.`);
+            if (!markdownlintStatus.schemaMatches) warnings.push(`${check_WARNING}  ${Lint.MARKDOWNLINT_CONFIG_PATH}: $schema differs from template.\n   Run 'savvy init' to update it.`);
+            if (!markdownlintStatus.configMatches) warnings.push(`${check_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);
@@ -1612,15 +1625,15 @@ function runLintCheck(opts) {
         else yield* Effect.log(`${check_CROSS_MARK} No husky pre-commit hook found`);
         if (hasHuskyHook) {
             if ("up-to-date" === baseStatusLabel) yield* Effect.log(`${check_CHECK_MARK} Base section: up-to-date`);
-            else if ("outdated" === baseStatusLabel) yield* Effect.log(`${check_WARNING} Base section: outdated (run 'savvy lint init' to update)`);
-            else yield* Effect.log(`${check_BULLET} Base section: not found (run 'savvy lint init' to add)`);
+            else if ("outdated" === baseStatusLabel) yield* Effect.log(`${check_WARNING} Base section: outdated (run 'savvy init' to update)`);
+            else yield* Effect.log(`${check_BULLET} Base section: not found (run 'savvy init' to add)`);
             const lintLabel = detectedConfigPath ? ` (config: ${detectedConfigPath})` : "";
             if ("up-to-date" === lintStatusLabel) yield* Effect.log(`${check_CHECK_MARK} Lint section: up-to-date${lintLabel}`);
-            else if ("outdated" === lintStatusLabel) yield* Effect.log(`${check_WARNING} Lint section: outdated (run 'savvy lint init' to update)`);
-            else yield* Effect.log(`${check_BULLET} Lint section: not found (run 'savvy lint init' to add)`);
+            else if ("outdated" === lintStatusLabel) yield* Effect.log(`${check_WARNING} Lint section: outdated (run 'savvy init' to update)`);
+            else yield* Effect.log(`${check_BULLET} Lint section: not found (run 'savvy init' to add)`);
         }
         for (const status of shellHookStatuses)if (status.found) if (status.isUpToDate) yield* Effect.log(`${check_CHECK_MARK} ${status.path}: up-to-date`);
-        else yield* Effect.log(`${check_WARNING} ${status.path}: outdated (run 'savvy lint init' to update)`);
+        else yield* Effect.log(`${check_WARNING} ${status.path}: outdated (run 'savvy init' to update)`);
         else yield* Effect.log(`${check_BULLET} ${status.path}: savvy-hooks section not found`);
         yield* Effect.log("\nTool availability:");
         const biomeAvailable = yield* td.isAvailable(ToolDefinition.make({
@@ -1668,16 +1681,16 @@ function runLintCheck(opts) {
         }
         else yield* Effect.log(`  ${check_BULLET} ${Lint.MARKDOWNLINT_CONFIG_PATH}: not found`);
         for (const status of biomeSchemaStatus.statuses)if (status.matches) yield* Effect.log(`  ${check_CHECK_MARK} ${status.path}: biome $schema up-to-date`);
-        else yield* Effect.log(`  ${check_WARNING} ${status.path}: biome $schema outdated (run 'savvy lint init' to update)`);
+        else yield* Effect.log(`  ${check_WARNING} ${status.path}: biome $schema outdated (run 'savvy init' to update)`);
         yield* Effect.log("");
         const hasMarkdownlintIssues = hasMarkdownlintConfig && !markdownlintStatus.isUpToDate;
         const hasBiomeSchemaIssues = biomeSchemaStatus.statuses.some((s)=>!s.matches);
         const hasIssues = !foundConfig || !hasHuskyHook || !sectionsHealthy || hasMarkdownlintIssues || hasBiomeSchemaIssues;
-        if (hasIssues) yield* Effect.log(`${check_WARNING} Some issues found. Run 'savvy lint init' to fix.`);
+        if (hasIssues) yield* Effect.log(`${check_WARNING} Some issues found. Run 'savvy init' to fix.`);
         else yield* Effect.log(`${check_CHECK_MARK} Lint-staged is configured correctly.`);
     });
 }
-const lint_check_checkCommand = Command.make("check", {
+Command.make("check", {
     quiet: check_quietOption
 }, (opts)=>runLintCheck(opts)).pipe(Command.withDescription("Check current lint-staged configuration and tool availability"));
 const DEFAULT_CHANGESET_DIR = ".changeset";
@@ -1704,6 +1717,158 @@ const _checkCommand = Command.make("check", {
         })
     })).pipe(Command.withDescription("Validate all Silk Suite tool configurations in one pass"));
 const commands_check_checkCommand = _checkCommand;
+const DEFAULT_GLOBS = [
+    "dist",
+    ".turbo",
+    "coverage",
+    "node_modules",
+    ".rslib"
+];
+const NO_DESCEND = new Set([
+    "node_modules",
+    ".git"
+]);
+class CleanError extends Data.TaggedError("CleanError") {
+}
+function collectTargets(pkgPath, patterns) {
+    return Effect.tryPromise({
+        try: async ()=>{
+            const rootReal = await realpath(pkgPath);
+            const seen = new Map();
+            for await (const entry of glob(patterns, {
+                cwd: pkgPath,
+                withFileTypes: true,
+                exclude: (dirent)=>NO_DESCEND.has(dirent.name) && dirent.isDirectory()
+            })){
+                const abs = join(entry.parentPath, entry.name);
+                let real;
+                try {
+                    real = await realpath(abs);
+                } catch  {
+                    continue;
+                }
+                if (real !== rootReal && real.startsWith(rootReal + sep)) {
+                    if (real !== join(rootReal, "package.json")) seen.set(abs, {
+                        path: abs,
+                        kind: entry.isDirectory() ? "dir" : "file"
+                    });
+                }
+            }
+            return [
+                ...seen.values()
+            ];
+        },
+        catch: (e)=>new CleanError({
+                step: `glob ${pkgPath}`,
+                reason: e instanceof Error ? e.message : String(e)
+            })
+    });
+}
+const REMOVE_CONCURRENCY = 8;
+function removeTargets(targets, dryRun) {
+    return Effect.gen(function*() {
+        const results = yield* Effect.forEach(targets, (target)=>dryRun ? Effect.succeed({
+                target,
+                reason: null
+            }) : Effect.tryPromise(()=>rm(target.path, {
+                    recursive: true,
+                    force: true
+                })).pipe(Effect.match({
+                onSuccess: ()=>({
+                        target,
+                        reason: null
+                    }),
+                onFailure: (e)=>({
+                        target,
+                        reason: e instanceof Error ? e.message : String(e)
+                    })
+            })), {
+            concurrency: REMOVE_CONCURRENCY
+        });
+        return {
+            removed: results.filter((r)=>null === r.reason).map((r)=>r.target),
+            failed: results.filter((r)=>null !== r.reason).map((r)=>({
+                    target: r.target,
+                    reason: r.reason
+                }))
+        };
+    });
+}
+const clean_CHECK_MARK = "✓";
+const clean_BULLET = "•";
+const WARN_MARK = "⚠";
+function parseGlobs(raw) {
+    const parts = raw.split(",").map((s)=>s.trim()).filter((s)=>s.length > 0);
+    return parts.length > 0 ? parts : DEFAULT_GLOBS;
+}
+function runClean(opts) {
+    const patterns = parseGlobs(opts.globs);
+    return Effect.gen(function*() {
+        const discovery = yield* WorkspaceDiscovery;
+        const packages = yield* discovery.listPackages(process.cwd()).pipe(Effect.mapError((e)=>new CleanError({
+                step: "discover workspaces",
+                reason: e.message
+            })));
+        const leaves = packages.filter((p)=>!p.isRootWorkspace);
+        const roots = packages.filter((p)=>p.isRootWorkspace);
+        const ordered = [
+            ...leaves,
+            ...roots
+        ];
+        const planned = yield* Effect.forEach(ordered, (pkg)=>collectTargets(pkg.path, patterns).pipe(Effect.map((targets)=>({
+                    pkg,
+                    targets
+                }))));
+        const seen = new Set();
+        const groups = planned.map(({ pkg, targets })=>{
+            const unique = targets.filter((t)=>{
+                if (seen.has(t.path)) return false;
+                seen.add(t.path);
+                return true;
+            });
+            return {
+                pkg,
+                targets: unique
+            };
+        });
+        const leafGroups = groups.filter((g)=>!g.pkg.isRootWorkspace);
+        const rootGroups = groups.filter((g)=>g.pkg.isRootWorkspace);
+        const verb = opts.dryRun ? "would remove" : "removed";
+        let total = 0;
+        const failures = [];
+        for (const phase of [
+            leafGroups,
+            rootGroups
+        ]){
+            const reports = yield* Effect.forEach(phase, (g)=>removeTargets(g.targets, opts.dryRun).pipe(Effect.map((report)=>({
+                        g,
+                        report
+                    }))));
+            for (const { g, report } of reports)if (0 !== g.targets.length) {
+                yield* Effect.log(`\n${"." === g.pkg.relativePath ? "<root>" : g.pkg.relativePath}`);
+                for (const t of report.removed)yield* Effect.log(`  ${clean_BULLET} ${verb} [${t.kind}] ${t.path}`);
+                for (const f of report.failed)yield* Effect.log(`  ${WARN_MARK} failed [${f.target.kind}] ${f.target.path}: ${f.reason}`);
+                total += report.removed.length;
+                failures.push(...report.failed);
+            }
+        }
+        yield* Effect.log(`\n${clean_CHECK_MARK} ${opts.dryRun ? "Would remove" : "Removed"} ${total} item(s).`);
+        if (failures.length > 0) {
+            for (const f of failures)yield* Effect.logError(`Failed to remove ${f.target.path}: ${f.reason}`);
+            return yield* Effect.fail(new CleanError({
+                step: "remove",
+                reason: `${failures.length} target(s) could not be removed`
+            }));
+        }
+    });
+}
+const globsOption = Options.text("globs").pipe(Options.withAlias("g"), Options.withDescription(`Comma-separated glob patterns to remove from each workspace root (default: ${DEFAULT_GLOBS.join(",")})`), Options.withDefault(DEFAULT_GLOBS.join(",")));
+const clean_dryRunOption = Options.boolean("dry-run").pipe(Options.withAlias("n"), Options.withDescription("Report what would be removed without deleting anything"), Options.withDefault(false));
+const _cleanCommand = Command.make("clean", {
+    globs: globsOption,
+    dryRun: clean_dryRunOption
+}, (opts)=>runClean(opts)).pipe(Command.withDescription("Remove build/cache artifacts across the workspace (leaves first, root last)"));
+const cleanCommand = _cleanCommand;
 const execFileP = promisify(execFile);
 function buildPostCommitAdvice(i) {
     const lines = [];
@@ -1971,8 +2136,6 @@ const hookCommand = Command.make("hook").pipe(Command.withSubcommands([
     userPromptSubmitCommand
 ])).pipe(Command.withDescription("Internal hook handlers used by the @savvy-web/commitlint plugin"));
 const _commitCommand = Command.make("commit").pipe(Command.withSubcommands([
-    init_initCommand,
-    check_checkCommand,
     hookCommand
 ]), Command.withDescription("Commit standards: config, checks, and Claude hook handlers"));
 const commitCommand = _commitCommand;
@@ -2121,7 +2284,7 @@ function runLintInit(opts) {
         yield* Effect.log("\nDone! Lint-staged is ready to use.");
     });
 }
-const lint_init_initCommand = Command.make("init", {
+Command.make("init", {
     force: lint_init_forceOption,
     config: init_configOption,
     preset: presetOption
@@ -2205,21 +2368,20 @@ const _fmtCommand = Command.make("fmt").pipe(Command.withSubcommands([
 ]));
 const fmtCommand = _fmtCommand;
 const _lintCommand = Command.make("lint").pipe(Command.withSubcommands([
-    lint_init_initCommand,
-    lint_check_checkCommand,
     fmtCommand
 ]), Command.withDescription("Code-quality: lint-staged config, checks, and in-place formatting"));
 const lint_lintCommand = _lintCommand;
 const rootCommand = Command.make("savvy").pipe(Command.withSubcommands([
     commands_init_initCommand,
     commands_check_checkCommand,
+    cleanCommand,
     commitCommand,
     changesetCommand,
     lint_lintCommand
 ]));
 const cli = Command.run(rootCommand, {
     name: "savvy",
-    version: "0.2.0"
+    version: "0.3.0"
 });
 const WorkspaceLive = Layer.mergeAll(WorkspaceRootLive, PackageManagerDetectorLive, WorkspaceDiscoveryLive.pipe(Layer.provide(WorkspaceRootLive)));
 const BaseLive = Layer.mergeAll(WorkspaceLive, ChangesetConfigReaderLive, ManagedSectionLive, BiomeSchemaSyncLive, ConfigDiscoveryLive, SilkPublishabilityDetectorLive, Changesets.WorkspaceSnapshotReaderLive);