@chanom/cli 0.1.0 → 0.2.0

package/README.md

@@ -46,7 +46,7 @@ Based on your answers, `brew` will:
 
 - Initialize a git repo if one doesn't exist yet (with a `.gitignore`)
 - Detect your package manager (`pnpm`, `npm`, `yarn`, or `bun`) - the `packageManager` field in `package.json` wins over the invoking user agent, falling back to `pnpm`
-- Install the packages needed for your selected toppings as dev dependencies
+- Install the packages needed for your selected toppings as dev dependencies - when run at a workspace root (a `pnpm-workspace.yaml` or a `workspaces` field in `package.json`), the install gets the flag your package manager needs: `-w` for pnpm, `-W` for yarn classic, none for npm, bun, and yarn berry
 - Write config files and wire up `package.json` scripts
 - If `medium` sweetness is selected, run `husky init` and add `pre-commit` / `commit-msg` hooks
 - Stage and commit the changes it made

package/dist/index.js

@@ -102,20 +102,82 @@ var Git = class extends Effect.Service()("cli/Git", { effect: Effect.gen(functio
 			"--quiet"
 		], cwd).pipe(Effect.map((clean) => !clean)),
 		isRepo: (cwd) => fs.exists(path.join(cwd, ".git")),
-		writeGitignore: (cwd, contents = "node_modules\n") => fs.writeFileString(path.join(cwd, ".gitignore"), contents)
+		writeGitignore: (cwd, contents = "node_modules\n") => fs.writeFileString(path.join(cwd, ".gitignore"), contents),
+		readGitignore: (cwd) => fs.readFileString(path.join(cwd, ".gitignore"))
 	};
 }) }) {};
 //#endregion
+//#region src/domain/package-manager.ts
+/** How to run a locally installed binary with each package manager. */
+const PM_EXEC = {
+	pnpm: ["pnpm", "exec"],
+	npm: [
+		"npx",
+		"--no",
+		"--"
+	],
+	yarn: ["yarn"],
+	bun: ["bunx"]
+};
+const KNOWN_PMS = [
+	"pnpm",
+	"yarn",
+	"bun",
+	"npm"
+];
+/** Parses the `packageManager` field of package.json, e.g. `pnpm@11.9.0`. */
+function parsePmField(field) {
+	if (!field) return void 0;
+	const name = field.split("@")[0];
+	return KNOWN_PMS.find((pm) => pm === name);
+}
+/** Parses the `npm_config_user_agent` environment variable, e.g. `pnpm/11.9.0 npm/? node/v22`. */
+function parsePmUserAgent(agent) {
+	if (!agent) return void 0;
+	return KNOWN_PMS.find((pm) => agent.startsWith(pm));
+}
+/**
+* Extra `add` flags needed when installing at a workspace root: pnpm and yarn
+* classic refuse root installs without `-w` / `-W`. npm, bun, and yarn berry
+* install to the root with no flag (npm's `-w` targets a child workspace instead).
+*/
+function workspaceRootFlags(pm, hints) {
+	switch (pm) {
+		case "pnpm": return hints.hasPnpmWorkspaceFile ? ["-w"] : [];
+		case "yarn": return hints.hasWorkspacesField && !hints.hasYarnBerryConfig ? ["-W"] : [];
+		case "npm":
+		case "bun": return [];
+	}
+}
+/** The `packageManager` field wins over the user agent, which wins over the fallback. */
+function resolvePm(hints) {
+	return parsePmField(hints.packageManagerField) ?? parsePmUserAgent(hints.userAgent) ?? hints.fallback ?? "pnpm";
+}
+//#endregion
 //#region src/services/package-installer.ts
 var InstallFailed = class extends Data.TaggedError("InstallFailed") {};
-/** Installs npm packages with the detected package manager. */
+/**
+* Installs npm packages with the detected package manager, adding the
+* workspace-root flag (pnpm `-w`, yarn classic `-W`) when the target
+* directory is a workspace root.
+*/
 var PackageInstaller = class extends Effect.Service()("cli/PackageInstaller", { effect: Effect.gen(function* () {
 	const runner = yield* CommandRunner;
-	return { installDev: (pm, cwd, packages) => runner.execInherit(pm, [
+	const fs = yield* FileSystem.FileSystem;
+	const path = yield* Path.Path;
+	const has = (cwd, file) => fs.exists(path.join(cwd, file)).pipe(Effect.orElseSucceed(() => false));
+	const hasWorkspacesField = (cwd) => fs.readFileString(path.join(cwd, "package.json")).pipe(Effect.flatMap((contents) => Effect.try(() => JSON.parse(contents).workspaces !== void 0)), Effect.orElseSucceed(() => false));
+	const workspaceHints = (cwd) => Effect.all({
+		hasPnpmWorkspaceFile: has(cwd, "pnpm-workspace.yaml"),
+		hasWorkspacesField: hasWorkspacesField(cwd),
+		hasYarnBerryConfig: has(cwd, ".yarnrc.yml")
+	}, { concurrency: 3 });
+	return { installDev: (pm, cwd, packages) => workspaceHints(cwd).pipe(Effect.flatMap((hints) => runner.execInherit(pm, [
 		"add",
 		"-D",
+		...workspaceRootFlags(pm, hints),
 		...packages
-	], cwd).pipe(Effect.filterOrFail((code) => code === 0, () => new InstallFailed({ pm })), Effect.asVoid) };
+	], cwd)), Effect.filterOrFail((code) => code === 0, () => new InstallFailed({ pm })), Effect.asVoid) };
 }) }) {};
 //#endregion
 //#region src/services/prompter.ts
@@ -147,40 +209,6 @@ var Prompter = class extends Effect.Service()("cli/Prompter", { succeed: {
 	})
 } }) {};
 //#endregion
-//#region src/domain/package-manager.ts
-/** How to run a locally installed binary with each package manager. */
-const PM_EXEC = {
-	pnpm: ["pnpm", "exec"],
-	npm: [
-		"npx",
-		"--no",
-		"--"
-	],
-	yarn: ["yarn"],
-	bun: ["bunx"]
-};
-const KNOWN_PMS = [
-	"pnpm",
-	"yarn",
-	"bun",
-	"npm"
-];
-/** Parses the `packageManager` field of package.json, e.g. `pnpm@11.9.0`. */
-function parsePmField(field) {
-	if (!field) return void 0;
-	const name = field.split("@")[0];
-	return KNOWN_PMS.find((pm) => pm === name);
-}
-/** Parses the `npm_config_user_agent` environment variable, e.g. `pnpm/11.9.0 npm/? node/v22`. */
-function parsePmUserAgent(agent) {
-	if (!agent) return void 0;
-	return KNOWN_PMS.find((pm) => agent.startsWith(pm));
-}
-/** The `packageManager` field wins over the user agent, which wins over the fallback. */
-function resolvePm(hints) {
-	return parsePmField(hints.packageManagerField) ?? parsePmUserAgent(hints.userAgent) ?? hints.fallback ?? "pnpm";
-}
-//#endregion
 //#region src/utils/detect-pm.ts
 const detectPm = (cwd, userAgent = process.env["npm_config_user_agent"], fallback = "pnpm") => Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
@@ -285,7 +313,7 @@ function commitMsgHook(pm) {
 }
 //#endregion
 //#region src/commands/add-commitlint/index.ts
-const apply$5 = (cwd, pm) => Effect.gen(function* () {
+const apply$5 = Effect.fn("add-commitlint.apply")(function* (cwd, pm) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -298,7 +326,7 @@ const apply$5 = (cwd, pm) => Effect.gen(function* () {
 		if (yield* fs.exists(hookPath)) yield* prompter.warn("`.husky/commit-msg` already exists - skipping");
 		else yield* fs.writeFileString(hookPath, commitMsgHook(pm));
 	}
-}).pipe(Effect.withSpan("add-commitlint.apply"));
+});
 //#endregion
 //#region src/commands/add-husky/logic.ts
 function getPackages$4(pkg) {
@@ -307,7 +335,7 @@ function getPackages$4(pkg) {
 //#endregion
 //#region src/commands/add-husky/index.ts
 var HuskyInitFailed = class extends Data.TaggedError("HuskyInitFailed") {};
-const apply$4 = (cwd, pm) => Effect.gen(function* () {
+const apply$4 = Effect.fn("add-husky.apply")(function* (cwd, pm) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -324,7 +352,7 @@ const apply$4 = (cwd, pm) => Effect.gen(function* () {
 		"init"
 	], cwd);
 	if (exitCode !== 0) return yield* new HuskyInitFailed({ exitCode });
-}).pipe(Effect.withSpan("add-husky.apply"));
+});
 //#endregion
 //#region src/domain/scripts.ts
 /**
@@ -363,7 +391,7 @@ function getScriptPlan$2(scripts) {
 //#endregion
 //#region src/commands/add-knip/index.ts
 /** Returns a copy of `pkg` with missing scripts added; the caller owns writing package.json. */
-const apply$3 = (cwd, esm, pkg) => Effect.gen(function* () {
+const apply$3 = Effect.fn("add-knip.apply")(function* (cwd, esm, pkg) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -379,7 +407,7 @@ const apply$3 = (cwd, esm, pkg) => Effect.gen(function* () {
 		...pkg,
 		scripts: plan.scripts
 	};
-}).pipe(Effect.withSpan("add-knip.apply"));
+});
 //#endregion
 //#region src/commands/add-lint-staged/logic.ts
 function getPackages$2(pkg) {
@@ -400,7 +428,7 @@ function buildConfig(linters, formatters) {
 }
 //#endregion
 //#region src/commands/add-lint-staged/index.ts
-const apply$2 = (cwd, linters = [], formatters = [], overwritePreCommit = false) => Effect.gen(function* () {
+const apply$2 = Effect.fn("add-lint-staged.apply")(function* (cwd, linters = [], formatters = [], overwritePreCommit = false) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -413,7 +441,7 @@ const apply$2 = (cwd, linters = [], formatters = [], overwritePreCommit = false)
 		if ((yield* fs.exists(hookPath)) && !overwritePreCommit) yield* prompter.warn("`.husky/pre-commit` already exists - skipping");
 		else yield* fs.writeFileString(hookPath, "lint-staged\n");
 	}
-}).pipe(Effect.withSpan("add-lint-staged.apply"));
+});
 //#endregion
 //#region src/commands/add-oxfmt/logic.ts
 function getPackages$1(pkg, versions) {
@@ -434,7 +462,7 @@ function getScriptPlan$1(scripts) {
 //#endregion
 //#region src/commands/add-oxfmt/index.ts
 /** Returns a copy of `pkg` with missing scripts added; the caller owns writing package.json. */
-const apply$1 = (cwd, esm, pkg) => Effect.gen(function* () {
+const apply$1 = Effect.fn("add-oxfmt.apply")(function* (cwd, esm, pkg) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -450,7 +478,7 @@ const apply$1 = (cwd, esm, pkg) => Effect.gen(function* () {
 		...pkg,
 		scripts: plan.scripts
 	};
-}).pipe(Effect.withSpan("add-oxfmt.apply"));
+});
 //#endregion
 //#region src/commands/add-oxlint/logic.ts
 function getPackages(pkg, versions) {
@@ -471,7 +499,7 @@ function getScriptPlan(scripts) {
 //#endregion
 //#region src/commands/add-oxlint/index.ts
 /** Returns a copy of `pkg` with missing scripts added; the caller owns writing package.json. */
-const apply = (cwd, esm, pkg) => Effect.gen(function* () {
+const apply = Effect.fn("add-oxlint.apply")(function* (cwd, esm, pkg) {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	const prompter = yield* Prompter;
@@ -487,7 +515,7 @@ const apply = (cwd, esm, pkg) => Effect.gen(function* () {
 		...pkg,
 		scripts: plan.scripts
 	};
-}).pipe(Effect.withSpan("add-oxlint.apply"));
+});
 //#endregion
 //#region src/commands/brew/logic.ts
 /** Deduplicated list of packages to install for the chosen toppings and sweetness. */
@@ -499,6 +527,21 @@ function planPackages(pkg, toppings, sweetness, versions) {
 	if (sweetness === "medium") packages.push(...getPackages$4(pkg), ...getPackages$2(pkg), ...getPackages$5(pkg));
 	return [...new Set(packages)];
 }
+/** True when the .gitignore content already has the entry as its own line. */
+function hasGitignoreEntry(content, entry) {
+	const forms = /* @__PURE__ */ new Set([
+		entry,
+		`${entry}/`,
+		`/${entry}`,
+		`/${entry}/`
+	]);
+	return content.split(/\r?\n/).some((line) => forms.has(line.trim()));
+}
+/** .gitignore content with the entry appended, preserving existing lines and newline termination. */
+function appendGitignoreEntry(content, entry) {
+	if (content === "") return `${entry}\n`;
+	return content.endsWith("\n") ? `${content}${entry}\n` : `${content}\n${entry}\n`;
+}
 function selectedLinters(toppings) {
 	return toppings.filter((t) => t === "oxlint");
 }
@@ -507,7 +550,7 @@ function selectedFormatters(toppings) {
 }
 //#endregion
 //#region src/commands/brew/index.ts
-const ensureGitRepo = (cwd) => Effect.gen(function* () {
+const ensureGitRepo = Effect.fn("brew.ensureGitRepo")(function* (cwd) {
 	const git = yield* Git;
 	if (yield* git.isRepo(cwd)) {
 		yield* Effect.logDebug("git repository already present");
@@ -515,10 +558,21 @@ const ensureGitRepo = (cwd) => Effect.gen(function* () {
 	}
 	const s = yield* (yield* Prompter).spinner("Git not found, initializing repository...");
 	yield* git.init(cwd);
-	yield* git.writeGitignore(cwd);
 	yield* s.stop("Git initialized");
-}).pipe(Effect.withSpan("brew.ensureGitRepo"));
-const askRecipe = () => Effect.gen(function* () {
+});
+const ensureGitIgnore = Effect.fn("brew.ensureGitIgnore")(function* (cwd) {
+	const git = yield* Git;
+	const prompter = yield* Prompter;
+	const existing = yield* git.readGitignore(cwd).pipe(Effect.catchTag("SystemError", (e) => e.reason === "NotFound" ? Effect.succeed(void 0) : Effect.fail(e)));
+	if (existing !== void 0 && hasGitignoreEntry(existing, "node_modules")) {
+		yield* Effect.logDebug("node_modules already present in .gitignore");
+		return;
+	}
+	const s = yield* prompter.spinner(existing === void 0 ? "Creating .gitignore..." : "Adding node_modules to .gitignore...");
+	yield* git.writeGitignore(cwd, appendGitignoreEntry(existing ?? "", "node_modules")).pipe(Effect.tapError(() => s.stop(pc.red("Could not update .gitignore"))));
+	yield* s.stop(existing === void 0 ? ".gitignore created" : "node_modules added to .gitignore");
+});
+const askRecipe = Effect.fn("brew.askRecipe")(function* () {
 	const prompter = yield* Prompter;
 	return {
 		toppings: yield* prompter.multiselect({
@@ -555,8 +609,8 @@ const askRecipe = () => Effect.gen(function* () {
 			}]
 		})
 	};
-}).pipe(Effect.withSpan("brew.askRecipe"));
-const installPackages = (pm, cwd, packages) => Effect.gen(function* () {
+});
+const installPackages = Effect.fn("brew.installPackages")(function* (pm, cwd, packages) {
 	if (packages.length === 0) {
 		yield* Effect.logDebug("no packages to install");
 		return;
@@ -566,21 +620,22 @@ const installPackages = (pm, cwd, packages) => Effect.gen(function* () {
 	const s = yield* prompter.spinner(`Installing ${packages.join(", ")}...`);
 	yield* installer.installDev(pm, cwd, packages).pipe(Effect.tapError(() => s.stop(pc.red("Package installation failed"))));
 	yield* s.stop("Packages installed");
-}).pipe(Effect.withSpan("brew.installPackages"));
-const applyToppings = (cwd, esm, pkg, toppings) => Effect.gen(function* () {
+});
+const applyToppings = Effect.fn("brew.applyToppings")(function* (cwd, esm, pkg, toppings) {
 	let updated = pkg;
 	if (toppings.includes("oxlint")) updated = yield* apply(cwd, esm, updated);
 	if (toppings.includes("oxfmt")) updated = yield* apply$1(cwd, esm, updated);
 	if (toppings.includes("knip")) updated = yield* apply$3(cwd, esm, updated);
 	return updated;
-}).pipe(Effect.withSpan("brew.applyToppings"));
-const persistScripts = (pkgPath, pkg, updated) => Effect.gen(function* () {
-	if (JSON.stringify(updated.scripts ?? {}) !== JSON.stringify(pkg.scripts ?? {})) {
+});
+const persistScripts = Effect.fn("brew.persistScripts")(function* (pkgPath, pkg, updated) {
+	if (JSON.stringify(updated.scripts ?? {}) === JSON.stringify(pkg.scripts ?? {})) yield* Effect.logDebug("scripts unchanged, skipping package.json write");
+	else {
 		yield* Effect.logDebug(`writing updated scripts to ${pkgPath}`);
 		yield* writePkg(pkgPath, updated);
-	} else yield* Effect.logDebug("scripts unchanged, skipping package.json write");
-}).pipe(Effect.withSpan("brew.persistScripts"));
-const setupCommitGate = (cwd, pm, toppings, sweetness) => Effect.gen(function* () {
+	}
+});
+const setupCommitGate = Effect.fn("brew.setupCommitGate")(function* (cwd, pm, toppings, sweetness) {
 	if (sweetness !== "medium") return;
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
@@ -588,8 +643,8 @@ const setupCommitGate = (cwd, pm, toppings, sweetness) => Effect.gen(function* (
 	yield* apply$4(cwd, pm);
 	yield* apply$2(cwd, selectedLinters(toppings), selectedFormatters(toppings), !huskyExisted);
 	yield* apply$5(cwd, pm);
-}).pipe(Effect.withSpan("brew.setupCommitGate"));
-const commitChanges = (cwd) => Effect.gen(function* () {
+});
+const commitChanges = Effect.fn("brew.commitChanges")(function* (cwd) {
 	const git = yield* Git;
 	const prompter = yield* Prompter;
 	const s = yield* prompter.spinner("Committing changes...");
@@ -607,11 +662,12 @@ const commitChanges = (cwd) => Effect.gen(function* () {
 	yield* s.stop(pc.yellow("Could not commit changes automatically"));
 	const detail = result.stderr || result.stdout;
 	yield* prompter.warn(`${detail ? detail + "\n" : ""}Your files are staged - commit them manually when ready.`);
-}).pipe(Effect.withSpan("brew.commitChanges"));
+});
 const brew = (cwd = process.cwd()) => Effect.gen(function* () {
 	const prompter = yield* Prompter;
 	yield* prompter.intro(pc.magenta("🧋 Chanom - Let's brew your project!"));
 	yield* ensureGitRepo(cwd);
+	yield* ensureGitIgnore(cwd);
 	const pm = yield* detectPm(cwd);
 	yield* Effect.logDebug(`detected package manager: ${pm}`);
 	const { pkg, pkgPath } = yield* readPkg(cwd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chanom/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "",
   "keywords": [],
   "repository": {
@@ -28,6 +28,7 @@
     "@tsconfig/node-lts": "24.0.0",
     "@tsconfig/node-ts": "23.6.4",
     "@types/node": "26.0.1",
+    "@vitest/coverage-v8": "3.2.6",
     "tsdown": "0.22.3",
     "typescript": "6.0.3",
     "vitest": "3.2.6",
@@ -37,6 +38,7 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest"
   }
 }