@bensandee/tooling 0.58.0 → 0.59.1

package/dist/docker-check/index.d.mts

@@ -53,6 +53,12 @@ interface ComposeConfig {
   cwd: string;
   /** Compose files to use (e.g. ["docker-compose.yaml", "docker-compose.check.yaml"]). */
   composeFiles: string[];
+  /**
+   * Project namespace passed to `docker compose --project-name`. Required so a
+   * check run cannot share a project (and thus its named volumes) with another
+   * stack on the same docker daemon. See `deriveProjectName()`.
+   */
+  projectName: string;
   /** Optional env file for compose. */
   envFile?: string;
   /** Service names to monitor for container-level health. */
@@ -125,4 +131,118 @@ declare function getContainerHealth(containers: ContainerInfo[], serviceName: st
 /** Run a single HTTP health check, returning true if the validator passes. */
 declare function checkHttpHealth(executor: DockerCheckExecutor, check: HttpHealthCheck): Promise<boolean>;
 //#endregion
-export { type CheckConfig, type CheckResult, type ComposeConfig, type ContainerInfo, type DockerCheckExecutor, type HttpHealthCheck, checkHttpHealth, composeArgs, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runDockerCheck };
+//#region src/docker-check/project-name.d.ts
+/**
+ * Derive the `docker compose --project-name` value for a check run.
+ *
+ * Always returns a unique, non-colliding namespace so a stray `compose down -v`
+ * during the check cannot target volumes belonging to a long-running stack
+ * sharing the same docker daemon (the failure mode that wiped prod volumes
+ * when a CI runner bind-mounted /var/run/docker.sock and the check overlay
+ * inherited the base file's `name:`).
+ *
+ * Format: `<sanitized-repo>-check-<suffix>` where suffix prefers a CI run id
+ * for traceability and falls back to `process.pid` locally so two concurrent
+ * `bst docker:check` invocations on the same machine don't collide.
+ */
+declare function deriveProjectName(repoName: string, env?: NodeJS.ProcessEnv): string;
+//#endregion
+//#region src/utils/tooling-config.d.ts
+declare const ToolingConfigSchema: z.ZodObject<{
+  $schema: z.ZodOptional<z.ZodString>;
+  structure: z.ZodOptional<z.ZodEnum<{
+    single: "single";
+    monorepo: "monorepo";
+  }>>;
+  useEslintPlugin: z.ZodOptional<z.ZodBoolean>;
+  formatter: z.ZodOptional<z.ZodEnum<{
+    prettier: "prettier";
+    oxfmt: "oxfmt";
+  }>>;
+  setupVitest: z.ZodOptional<z.ZodBoolean>;
+  ci: z.ZodOptional<z.ZodEnum<{
+    github: "github";
+    forgejo: "forgejo";
+    none: "none";
+  }>>;
+  setupRenovate: z.ZodOptional<z.ZodBoolean>;
+  releaseStrategy: z.ZodOptional<z.ZodEnum<{
+    none: "none";
+    "release-it": "release-it";
+    simple: "simple";
+    changesets: "changesets";
+  }>>;
+  publishNpm: z.ZodOptional<z.ZodBoolean>;
+  publishDocker: z.ZodOptional<z.ZodBoolean>;
+  projectType: z.ZodOptional<z.ZodEnum<{
+    default: "default";
+    node: "node";
+    react: "react";
+    library: "library";
+  }>>;
+  detectPackageTypes: z.ZodOptional<z.ZodBoolean>;
+  docker: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    dockerfile: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+    buildArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strip>>>;
+  dockerCheck: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    composeFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    envFile: z.ZodOptional<z.ZodString>;
+    services: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    healthChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      url: z.ZodString;
+      status: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    buildCommand: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    buildCwd: z.ZodOptional<z.ZodString>;
+    smoketest: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    smoketestCwd: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>]>>;
+  registryHost: z.ZodOptional<z.ZodString>;
+  registryNamespace: z.ZodOptional<z.ZodString>;
+  releaseAssets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    file: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  postReleaseHook: z.ZodOptional<z.ZodString>;
+  postReleaseHookSecrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  coverage: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
+    history: z.ZodOptional<z.ZodEnum<{
+      none: "none";
+      "orphan-branch": "orphan-branch";
+    }>>;
+    historyBranch: z.ZodOptional<z.ZodString>;
+    tolerancePp: z.ZodOptional<z.ZodNumber>;
+    gateOnPullRequests: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strict>]>>;
+  pnpmWorkspace: z.ZodOptional<z.ZodLiteral<false>>;
+}, z.core.$strict>;
+type ToolingConfig = z.infer<typeof ToolingConfigSchema>;
+//#endregion
+//#region src/docker-check/compose-lint.d.ts
+interface ComposeLintIssue {
+  kind: "missing-name" | "duplicate-name";
+  /** Repo-relative paths involved in this issue (1 for missing-name, 2+ for duplicate-name). */
+  files: string[];
+  /** Pre-rendered human-readable message ready for `log.error`. */
+  message: string;
+}
+/**
+ * Walk compose files in `targetDir` and report lint violations:
+ *
+ * - Rule A (`missing-name`): every override compose file must declare a
+ *   top-level `name:` directive. Base files (docker-compose.yml etc.) are
+ *   exempt — their default of dir-basename is fine — but overrides without
+ *   `name:` silently inherit the base's project namespace, which is how a
+ *   `compose down -v` against the check overlay wiped the prod-volume project.
+ * - Rule B (`duplicate-name`): no two compose files in a single dir may
+ *   declare the same `name:`. Base files participate in collision detection.
+ */
+declare function lintComposeFiles(targetDir: string, config: ToolingConfig | undefined): ComposeLintIssue[];
+//#endregion
+export { type CheckConfig, type CheckResult, type ComposeConfig, type ComposeLintIssue, type ContainerInfo, type DockerCheckExecutor, type HttpHealthCheck, checkHttpHealth, composeArgs, composeDown, composeLogs, composePs, composeUp, createRealExecutor, deriveProjectName, getContainerHealth, lintComposeFiles, runDockerCheck };

package/dist/docker-check/index.mjs

@@ -1,2 +1,2 @@
-import { a as composeDown, c as composeUp, i as composeArgs, l as createRealExecutor, n as checkHttpHealth, o as composeLogs, r as getContainerHealth, s as composePs, t as runDockerCheck } from "../check-B5DFYJ3x.mjs";
-export { checkHttpHealth, composeArgs, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runDockerCheck };
+import { a as composeArgs, c as composePs, f as lintComposeFiles, i as getContainerHealth, l as composeUp, n as runDockerCheck, o as composeDown, r as checkHttpHealth, s as composeLogs, t as deriveProjectName, u as createRealExecutor } from "../project-name-CAVRoqNy.mjs";
+export { checkHttpHealth, composeArgs, composeDown, composeLogs, composePs, composeUp, createRealExecutor, deriveProjectName, getContainerHealth, lintComposeFiles, runDockerCheck };

package/dist/index.d.mts

@@ -1,119 +1,2 @@
-import { z } from "zod";
-
-//#region src/utils/json.d.ts
-declare const PackageJsonSchema: z.ZodObject<{
-  name: z.ZodOptional<z.ZodString>;
-  version: z.ZodOptional<z.ZodString>;
-  private: z.ZodOptional<z.ZodBoolean>;
-  type: z.ZodOptional<z.ZodString>;
-  scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  bin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
-  exports: z.ZodOptional<z.ZodUnknown>;
-  main: z.ZodOptional<z.ZodString>;
-  types: z.ZodOptional<z.ZodString>;
-  typings: z.ZodOptional<z.ZodString>;
-  engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-  repository: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
-    url: z.ZodString;
-  }, z.core.$loose>]>>;
-  packageManager: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>;
-type PackageJson = z.infer<typeof PackageJsonSchema>;
-//#endregion
-//#region src/types.d.ts
-type CiPlatform = "github" | "forgejo" | "none";
-type ReleaseStrategy = "release-it" | "simple" | "changesets" | "none";
-type Formatter = "oxfmt" | "prettier";
-/** User's answers from the interactive prompt or CLI flags. */
-interface ProjectConfig {
-  /** Project name (from package.json name or user input) */
-  name: string;
-  /** Project structure */
-  structure: "single" | "monorepo";
-  /** Include @bensandee/eslint-plugin oxlint plugin */
-  useEslintPlugin: boolean;
-  /** Formatter choice */
-  formatter: Formatter;
-  /** Set up vitest with a starter test */
-  setupVitest: boolean;
-  /** CI platform choice */
-  ci: CiPlatform;
-  /** Set up Renovate for automated dependency updates */
-  setupRenovate: boolean;
-  /** Release management strategy */
-  releaseStrategy: ReleaseStrategy;
-  /** Opt-in: publish packages to npm registry */
-  publishNpm: boolean;
-  /** Opt-in: publish Docker images to a registry */
-  publishDocker: boolean;
-  /** Project type determines tsconfig base configuration */
-  projectType: "default" | "node" | "react" | "library";
-  /** Auto-detect and configure tsconfig bases for monorepo packages */
-  detectPackageTypes: boolean;
-  /** Target directory (default: cwd) */
-  targetDir: string;
-}
-/** Result from a single generator: what file was written and how. */
-interface GeneratorResult {
-  filePath: string;
-  action: "created" | "updated" | "skipped" | "archived" | "removed";
-  /** Human-readable description of what changed */
-  description: string;
-}
-/** Context passed to each generator function. */
-interface GeneratorContext {
-  config: ProjectConfig;
-  /** Absolute path to target directory */
-  targetDir: string;
-  /** Pre-parsed package.json from the target directory, or undefined if missing/invalid */
-  packageJson: PackageJson | undefined;
-  /** Check whether a file exists in the target directory */
-  exists: (relativePath: string) => boolean;
-  /** Read an existing file from the target directory, returns undefined if not found */
-  read: (relativePath: string) => string | undefined;
-  /** Write a file to the target directory (creating directories as needed) */
-  write: (relativePath: string, content: string) => void;
-  /** Remove a file from the target directory (no-op if not found) */
-  remove: (relativePath: string) => void;
-  /** Prompt user for conflict resolution on non-mergeable files */
-  confirmOverwrite: (relativePath: string) => Promise<"overwrite" | "skip">;
-}
-/** Generator function signature. */
-type Generator = (ctx: GeneratorContext) => Promise<GeneratorResult>;
-/** State detected from an existing project directory. */
-interface DetectedProjectState {
-  hasPackageJson: boolean;
-  hasTsconfig: boolean;
-  hasOxlintConfig: boolean;
-  /** Existing oxlint.config.ts already imports @bensandee/config/oxlint/recommended */
-  oxlintExtendsRecommended: boolean;
-  /** Legacy .oxlintrc.json found (should be migrated to oxlint.config.ts) */
-  hasLegacyOxlintJson: boolean;
-  hasGitignore: boolean;
-  hasVitestConfig: boolean;
-  hasTsdownConfig: boolean;
-  hasPnpmWorkspace: boolean;
-  hasKnipConfig: boolean;
-  hasRenovateConfig: boolean;
-  hasReleaseItConfig: boolean;
-  hasSimpleReleaseConfig: boolean;
-  hasChangesetsConfig: boolean;
-  /** Whether package.json has a repository field (needed for release workflows) */
-  hasRepositoryField: boolean;
-  /** Whether commit-and-tag-version is in root devDependencies (required for simple release strategy) */
-  hasCommitAndTagVersion: boolean;
-  /** Git remote origin URL (for inferring repository field) */
-  gitRemoteUrl: string | null;
-  /** Legacy tooling configs found */
-  legacyConfigs: LegacyConfig[];
-}
-declare const LEGACY_TOOLS: readonly ["eslint", "prettier", "jest", "webpack", "rollup"];
-type LegacyTool = (typeof LEGACY_TOOLS)[number];
-interface LegacyConfig {
-  tool: LegacyTool;
-  files: string[];
-}
-//#endregion
+import { a as LegacyConfig, i as GeneratorResult, n as Generator, o as ProjectConfig, r as GeneratorContext, t as DetectedProjectState } from "./types-DtwkblrK.mjs";
 export { type DetectedProjectState, type Generator, type GeneratorContext, type GeneratorResult, type LegacyConfig, type ProjectConfig };

package/dist/{check-B5DFYJ3x.mjs → project-name-CAVRoqNy.mjs}

@@ -1,6 +1,9 @@
 import * as clack from "@clack/prompts";
+import path from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { execFileSync } from "node:child_process";
 import { z } from "zod";
+import { parse } from "yaml";
 //#region src/utils/log.ts
 const out = (msg) => console.log(msg);
 const isCI = Boolean(process.env["CI"]);
@@ -42,6 +45,148 @@ function debugExec(config, label, result) {
 	log.info(lines.join("\n"));
 }
 //#endregion
+//#region src/docker-check/compose-lint.ts
+const ComposeFileShape = z.looseObject({ name: z.unknown().optional() });
+/**
+* Compose files live by convention in `./` or `docker/`. The lint walks those
+* by default; if `.tooling.json#dockerCheck.composeFiles` overrides the
+* location, each listed file (and its parent dir) is also linted.
+*/
+const COMPOSE_DIR_CANDIDATES = [".", "docker"];
+/** Base compose file names whose project namespace defaults to dir basename. */
+const BASE_COMPOSE_FILES = new Set([
+	"docker-compose.yml",
+	"docker-compose.yaml",
+	"compose.yml",
+	"compose.yaml"
+]);
+const COMPOSE_FILENAME_PATTERN = /^(?:docker-compose|compose).*\.(?:yml|yaml)$/;
+/**
+* Walk compose files in `targetDir` and report lint violations:
+*
+* - Rule A (`missing-name`): every override compose file must declare a
+*   top-level `name:` directive. Base files (docker-compose.yml etc.) are
+*   exempt — their default of dir-basename is fine — but overrides without
+*   `name:` silently inherit the base's project namespace, which is how a
+*   `compose down -v` against the check overlay wiped the prod-volume project.
+* - Rule B (`duplicate-name`): no two compose files in a single dir may
+*   declare the same `name:`. Base files participate in collision detection.
+*/
+function lintComposeFiles(targetDir, config) {
+	const issues = [];
+	const visitedDirs = /* @__PURE__ */ new Set();
+	const standaloneFiles = [];
+	const dockerCheck = config?.dockerCheck;
+	const isObjectConfig = dockerCheck !== void 0 && dockerCheck !== false;
+	for (const candidate of COMPOSE_DIR_CANDIDATES) {
+		const absDir = path.resolve(targetDir, candidate);
+		if (existsSync(absDir)) visitDir(targetDir, absDir, visitedDirs, issues);
+	}
+	if (isObjectConfig && dockerCheck.composeFiles) for (const rel of dockerCheck.composeFiles) {
+		const absFile = path.resolve(targetDir, rel);
+		if (!existsSync(absFile)) continue;
+		const dir = path.dirname(absFile);
+		if (visitedDirs.has(dir)) continue;
+		const basename = path.basename(absFile);
+		standaloneFiles.push({
+			absPath: absFile,
+			relPath: path.relative(targetDir, absFile),
+			basename
+		});
+	}
+	const standaloneByDir = /* @__PURE__ */ new Map();
+	for (const file of standaloneFiles) {
+		const dir = path.dirname(file.absPath);
+		const list = standaloneByDir.get(dir) ?? [];
+		list.push(file);
+		standaloneByDir.set(dir, list);
+	}
+	for (const files of standaloneByDir.values()) {
+		files.sort((a, b) => a.relPath.localeCompare(b.relPath));
+		lintDirFiles(files, issues);
+	}
+	return issues;
+}
+function visitDir(targetDir, absDir, visitedDirs, issues) {
+	if (visitedDirs.has(absDir)) return;
+	visitedDirs.add(absDir);
+	let entries;
+	try {
+		entries = readdirSync(absDir);
+	} catch (_error) {
+		return;
+	}
+	const files = entries.filter((name) => COMPOSE_FILENAME_PATTERN.test(name)).toSorted().map((name) => {
+		const absPath = path.join(absDir, name);
+		return {
+			absPath,
+			relPath: path.relative(targetDir, absPath),
+			basename: name
+		};
+	});
+	if (files.length === 0) return;
+	lintDirFiles(files, issues);
+}
+function lintDirFiles(files, issues) {
+	const namesByFile = /* @__PURE__ */ new Map();
+	for (const file of files) {
+		const declaredName = readTopLevelName(file.absPath);
+		namesByFile.set(file.relPath, declaredName);
+		if (!BASE_COMPOSE_FILES.has(file.basename) && (declaredName === void 0 || declaredName === "")) {
+			const suggested = suggestProjectName(file);
+			issues.push({
+				kind: "missing-name",
+				files: [file.relPath],
+				message: `${file.relPath}: override compose file is missing required top-level 'name:' directive.\n  Add: name: ${suggested}\n  Why: without an explicit name, this override inherits the base file's project namespace.\n  A 'docker compose down -v' against this override would target the base project's volumes\n  — which has caused production volume loss in the past.`
+			});
+		}
+	}
+	const filesByName = /* @__PURE__ */ new Map();
+	for (const [relPath, declaredName] of namesByFile) {
+		if (declaredName === void 0 || declaredName === "") continue;
+		const list = filesByName.get(declaredName) ?? [];
+		list.push(relPath);
+		filesByName.set(declaredName, list);
+	}
+	for (const [declaredName, dupFiles] of filesByName) {
+		if (dupFiles.length < 2) continue;
+		dupFiles.sort();
+		const [first, second, ...rest] = dupFiles;
+		const ext = rest.length > 0 ? `, ${rest.join(", ")}` : "";
+		issues.push({
+			kind: "duplicate-name",
+			files: dupFiles,
+			message: `${String(first)} and ${String(second)}${ext} both declare 'name: ${declaredName}'.\n  Each compose file in the same directory must declare a unique 'name:'.\n  Suggested fix: rename one (e.g. 'name: ${declaredName}-test' in one of them).`
+		});
+	}
+}
+/** Suggest a default name for an override file by stripping the variant from the filename. */
+function suggestProjectName(file) {
+	const parts = file.basename.replace(/\.(yml|yaml)$/, "").split(".");
+	const variant = parts[parts.length - 1];
+	if (parts.length > 1 && variant) return `<project>-${variant}`;
+	return "<project>-check";
+}
+function readTopLevelName(absPath) {
+	let raw;
+	try {
+		raw = readFileSync(absPath, "utf-8");
+	} catch (_error) {
+		return;
+	}
+	let yamlValue;
+	try {
+		yamlValue = parse(raw);
+	} catch (_error) {
+		return;
+	}
+	const parsed = ComposeFileShape.safeParse(yamlValue);
+	if (!parsed.success) return void 0;
+	const value = parsed.data.name;
+	if (typeof value !== "string") return void 0;
+	return value;
+}
+//#endregion
 //#region src/utils/exec.ts
 /** Type guard for `execSync` errors that carry stdout/stderr/status. */
 function isExecSyncError(err) {
@@ -116,7 +261,11 @@ const ContainerInfoSchema = z.object({
 });
 /** Build the `docker compose` base args from config. */
 function composeArgs(config) {
-	const args = ["compose"];
+	const args = [
+		"compose",
+		"--project-name",
+		config.projectName
+	];
 	for (const f of config.composeFiles) args.push("-f", f);
 	if (config.envFile) args.push("--env-file", config.envFile);
 	return args;
@@ -340,4 +489,25 @@ async function runDockerCheck(executor, config) {
 	}
 }
 //#endregion
-export { composeDown as a, composeUp as c, debug as d, debugExec as f, note as g, log as h, composeArgs as i, createRealExecutor as l, redact as m, checkHttpHealth as n, composeLogs as o, isEnvVerbose as p, getContainerHealth as r, composePs as s, runDockerCheck as t, isExecSyncError as u };
+//#region src/docker-check/project-name.ts
+/**
+* Derive the `docker compose --project-name` value for a check run.
+*
+* Always returns a unique, non-colliding namespace so a stray `compose down -v`
+* during the check cannot target volumes belonging to a long-running stack
+* sharing the same docker daemon (the failure mode that wiped prod volumes
+* when a CI runner bind-mounted /var/run/docker.sock and the check overlay
+* inherited the base file's `name:`).
+*
+* Format: `<sanitized-repo>-check-<suffix>` where suffix prefers a CI run id
+* for traceability and falls back to `process.pid` locally so two concurrent
+* `bst docker:check` invocations on the same machine don't collide.
+*/
+function deriveProjectName(repoName, env = process.env) {
+	return `${sanitize(repoName)}-check-${sanitize(env["GITHUB_RUN_ID"] ?? env["CI_RUN_ID"] ?? String(process.pid))}`;
+}
+function sanitize(name) {
+	return name.replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
+}
+//#endregion
+export { log as _, composeArgs as a, composePs as c, isExecSyncError as d, lintComposeFiles as f, redact as g, isEnvVerbose as h, getContainerHealth as i, composeUp as l, debugExec as m, runDockerCheck as n, composeDown as o, debug as p, checkHttpHealth as r, composeLogs as s, deriveProjectName as t, createRealExecutor as u, note as v };

package/dist/types-DtwkblrK.d.mts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+
+//#region src/utils/json.d.ts
+declare const PackageJsonSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  version: z.ZodOptional<z.ZodString>;
+  private: z.ZodOptional<z.ZodBoolean>;
+  type: z.ZodOptional<z.ZodString>;
+  scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  bin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+  exports: z.ZodOptional<z.ZodUnknown>;
+  main: z.ZodOptional<z.ZodString>;
+  types: z.ZodOptional<z.ZodString>;
+  typings: z.ZodOptional<z.ZodString>;
+  engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  repository: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    url: z.ZodString;
+  }, z.core.$loose>]>>;
+  packageManager: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type PackageJson = z.infer<typeof PackageJsonSchema>;
+//#endregion
+//#region src/types.d.ts
+type CiPlatform = "github" | "forgejo" | "none";
+type ReleaseStrategy = "release-it" | "simple" | "changesets" | "none";
+type Formatter = "oxfmt" | "prettier";
+/** User's answers from the interactive prompt or CLI flags. */
+interface ProjectConfig {
+  /** Project name (from package.json name or user input) */
+  name: string;
+  /** Project structure */
+  structure: "single" | "monorepo";
+  /** Include @bensandee/eslint-plugin oxlint plugin */
+  useEslintPlugin: boolean;
+  /** Formatter choice */
+  formatter: Formatter;
+  /** Set up vitest with a starter test */
+  setupVitest: boolean;
+  /** CI platform choice */
+  ci: CiPlatform;
+  /** Set up Renovate for automated dependency updates */
+  setupRenovate: boolean;
+  /** Release management strategy */
+  releaseStrategy: ReleaseStrategy;
+  /** Opt-in: publish packages to npm registry */
+  publishNpm: boolean;
+  /** Opt-in: publish Docker images to a registry */
+  publishDocker: boolean;
+  /** Project type determines tsconfig base configuration */
+  projectType: "default" | "node" | "react" | "library";
+  /** Auto-detect and configure tsconfig bases for monorepo packages */
+  detectPackageTypes: boolean;
+  /** Target directory (default: cwd) */
+  targetDir: string;
+}
+/** Result from a single generator: what file was written and how. */
+interface GeneratorResult {
+  filePath: string;
+  action: "created" | "updated" | "skipped" | "archived" | "removed";
+  /** Human-readable description of what changed */
+  description: string;
+}
+/** Context passed to each generator function. */
+interface GeneratorContext {
+  config: ProjectConfig;
+  /** Absolute path to target directory */
+  targetDir: string;
+  /** Pre-parsed package.json from the target directory, or undefined if missing/invalid */
+  packageJson: PackageJson | undefined;
+  /** Check whether a file exists in the target directory */
+  exists: (relativePath: string) => boolean;
+  /** Read an existing file from the target directory, returns undefined if not found */
+  read: (relativePath: string) => string | undefined;
+  /** Write a file to the target directory (creating directories as needed) */
+  write: (relativePath: string, content: string) => void;
+  /** Remove a file from the target directory (no-op if not found) */
+  remove: (relativePath: string) => void;
+  /** Prompt user for conflict resolution on non-mergeable files */
+  confirmOverwrite: (relativePath: string) => Promise<"overwrite" | "skip">;
+}
+/** Generator function signature. */
+type Generator = (ctx: GeneratorContext) => Promise<GeneratorResult>;
+/** State detected from an existing project directory. */
+interface DetectedProjectState {
+  hasPackageJson: boolean;
+  hasTsconfig: boolean;
+  hasOxlintConfig: boolean;
+  /** Existing oxlint.config.ts already imports @bensandee/config/oxlint/recommended */
+  oxlintExtendsRecommended: boolean;
+  /** Legacy .oxlintrc.json found (should be migrated to oxlint.config.ts) */
+  hasLegacyOxlintJson: boolean;
+  hasGitignore: boolean;
+  hasVitestConfig: boolean;
+  hasTsdownConfig: boolean;
+  hasPnpmWorkspace: boolean;
+  hasKnipConfig: boolean;
+  hasRenovateConfig: boolean;
+  hasReleaseItConfig: boolean;
+  hasSimpleReleaseConfig: boolean;
+  hasChangesetsConfig: boolean;
+  /** Whether package.json has a repository field (needed for release workflows) */
+  hasRepositoryField: boolean;
+  /** Whether commit-and-tag-version is in root devDependencies (required for simple release strategy) */
+  hasCommitAndTagVersion: boolean;
+  /** Git remote origin URL (for inferring repository field) */
+  gitRemoteUrl: string | null;
+  /** Legacy tooling configs found */
+  legacyConfigs: LegacyConfig[];
+}
+declare const LEGACY_TOOLS: readonly ["eslint", "prettier", "jest", "webpack", "rollup"];
+type LegacyTool = (typeof LEGACY_TOOLS)[number];
+interface LegacyConfig {
+  tool: LegacyTool;
+  files: string[];
+}
+//#endregion
+export { LegacyConfig as a, GeneratorResult as i, Generator as n, ProjectConfig as o, GeneratorContext as r, DetectedProjectState as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.58.0",
+  "version": "0.59.1",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "license": "MIT",
   "repository": {
@@ -55,7 +55,7 @@
     "release-it": "20.0.1",
     "tsdown": "0.22.0",
     "@bensandee/claude-hooks": "0.7.4",
-    "@bensandee/config": "0.11.1"
+    "@bensandee/config": "0.11.2"
   },
   "scripts": {
     "build": "tsdown",