create-m5kdev 0.30.0 → 0.31.0

package/dist/src/doctor.cjs

@@ -0,0 +1,245 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_src_catalog = require("./catalog.cjs");
+const require_src_changes = require("./changes.cjs");
+require("./constants.cjs");
+const require_src_paths = require("./paths.cjs");
+const require_src_template = require("./template.cjs");
+const require_src_state = require("./state.cjs");
+const require_src_diagnostics = require("./diagnostics.cjs");
+const require_src_migrations_registry = require("./migrations/registry.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_runtime.__toESM(node_fs_promises);
+let node_child_process = require("node:child_process");
+let node_util = require("node:util");
+let semver = require("semver");
+semver = require_runtime.__toESM(semver);
+//#region src/doctor.ts
+const execFileAsync = (0, node_util.promisify)(node_child_process.execFile);
+const FULL_COMMAND_TIMEOUT_MS = 600 * 1e3;
+async function exists(filePath) {
+	return node_fs_promises.default.access(filePath).then(() => true).catch(() => false);
+}
+async function diagnoseManagedRepo(options) {
+	const diagnostics = [];
+	let state = options.state;
+	if (!state) try {
+		state = await require_src_state.readManagedState(options.repoRoot);
+	} catch (error) {
+		diagnostics.push({
+			code: "STATE_INVALID",
+			severity: "error",
+			message: error instanceof Error ? error.message : "Unable to read .m5kdev.json.",
+			path: ".m5kdev.json",
+			suggestion: "Run m5kdev init to establish a managed baseline."
+		});
+		return require_src_diagnostics.createDiagnosticReport(diagnostics);
+	}
+	const cliVersion = require_src_state.getCliVersion();
+	if (state.template.name !== "minimal-app") diagnostics.push({
+		code: "STATE_TEMPLATE_UNKNOWN",
+		severity: "error",
+		message: `Unsupported template name: ${state.template.name}`,
+		path: ".m5kdev.json"
+	});
+	if (!semver.default.valid(state.template.version)) diagnostics.push({
+		code: "STATE_VERSION_INVALID",
+		severity: "error",
+		message: `Invalid template version: ${state.template.version}`,
+		path: ".m5kdev.json"
+	});
+	else if (semver.default.gt(state.template.version, cliVersion)) diagnostics.push({
+		code: "CLI_TOO_OLD",
+		severity: "error",
+		message: `This repository is managed by ${state.template.version}, but the running CLI is ${cliVersion}.`,
+		suggestion: `Run pnpm dlx create-m5kdev@${state.template.version} doctor.`
+	});
+	else if (semver.default.lt(state.template.version, cliVersion)) diagnostics.push({
+		code: "UPDATE_AVAILABLE",
+		severity: "warning",
+		message: `Template ${cliVersion} is available; this repository is at ${state.template.version}.`,
+		suggestion: `Preview it with pnpm dlx create-m5kdev@${cliVersion} update --dry-run.`
+	});
+	const manifest = require_src_template.loadTemplateManifest(require_src_paths.getTemplateRoot());
+	const seenFeatures = /* @__PURE__ */ new Set();
+	for (const feature of state.template.features) {
+		if (seenFeatures.has(feature)) diagnostics.push({
+			code: "FEATURE_DUPLICATE",
+			severity: "error",
+			message: `Feature ${feature} is listed more than once.`,
+			path: ".m5kdev.json"
+		});
+		else if (!(feature in manifest.features)) diagnostics.push({
+			code: "FEATURE_UNKNOWN",
+			severity: "error",
+			message: `Unknown managed feature: ${feature}`,
+			path: ".m5kdev.json"
+		});
+		seenFeatures.add(feature);
+	}
+	const requiredPaths = new Set(manifest.requiredPaths);
+	if (state.template.features.includes("webapp")) requiredPaths.add("apps/webapp/package.json");
+	if (state.template.features.includes("expo")) requiredPaths.add("apps/expo/package.json");
+	if (state.template.features.includes("test-harness")) requiredPaths.add("apps/e2e/package.json");
+	for (const relativePath of requiredPaths) {
+		const symlink = await require_src_changes.findRepositorySymlink(options.repoRoot, relativePath);
+		if (symlink) diagnostics.push({
+			code: "MANAGED_PATH_SYMLINK",
+			severity: "error",
+			message: `Required managed path contains symbolic link ${symlink}.`,
+			path: relativePath
+		});
+		else if (!await exists(node_path.default.join(options.repoRoot, relativePath))) diagnostics.push({
+			code: "REQUIRED_PATH_MISSING",
+			severity: "error",
+			message: "Required managed path is missing.",
+			path: relativePath,
+			suggestion: "Restore the path or correct the enabled features before initializing/updating."
+		});
+	}
+	const workspaceRelativePath = "pnpm-workspace.yaml";
+	const workspacePath = node_path.default.join(options.repoRoot, workspaceRelativePath);
+	if (!await require_src_changes.findRepositorySymlink(options.repoRoot, workspaceRelativePath) && await exists(workspacePath)) try {
+		const actualCatalog = require_src_catalog.readCatalog(await node_fs_promises.default.readFile(workspacePath, "utf8"));
+		for (const [name, expected] of Object.entries(state.catalog)) {
+			if (!semver.default.validRange(expected)) diagnostics.push({
+				code: "CATALOG_VERSION_INVALID",
+				severity: "error",
+				message: `${name} has an invalid managed SemVer range: ${expected}.`,
+				path: ".m5kdev.json"
+			});
+			if (!(name in actualCatalog)) diagnostics.push({
+				code: "CATALOG_ENTRY_MISSING",
+				severity: "error",
+				message: `Managed catalog entry ${name} is missing.`,
+				path: "pnpm-workspace.yaml",
+				suggestion: `Restore ${name}: ${expected}.`
+			});
+			else if (actualCatalog[name] !== expected) diagnostics.push({
+				code: "CATALOG_VERSION_MISMATCH",
+				severity: "error",
+				message: `${name} is ${actualCatalog[name]}, expected managed version ${expected}.`,
+				path: "pnpm-workspace.yaml"
+			});
+		}
+		const appsDirectory = node_path.default.join(options.repoRoot, "apps");
+		const packageFiles = [node_path.default.join(options.repoRoot, "package.json")];
+		if (await exists(appsDirectory)) packageFiles.push(...require_src_catalog.walkPackageJsonFiles(appsDirectory));
+		for (const dependency of require_src_catalog.collectConsumerDependencyNames(packageFiles)) if (!(dependency in actualCatalog)) diagnostics.push({
+			code: "CATALOG_REFERENCE_MISSING",
+			severity: "error",
+			message: `${dependency} uses catalog: but has no catalog entry.`,
+			path: "pnpm-workspace.yaml"
+		});
+	} catch (error) {
+		diagnostics.push({
+			code: "CATALOG_INVALID",
+			severity: "error",
+			message: error instanceof Error ? error.message : "Unable to parse the consumer catalog.",
+			path: "pnpm-workspace.yaml"
+		});
+	}
+	for (const [relativePath, baseline] of Object.entries(state.files)) {
+		if (baseline.policy === "ignore") continue;
+		const filePath = node_path.default.join(options.repoRoot, relativePath);
+		const symlink = await require_src_changes.findRepositorySymlink(options.repoRoot, relativePath);
+		if (symlink) {
+			diagnostics.push({
+				code: "MANAGED_PATH_SYMLINK",
+				severity: "error",
+				message: `Managed path contains symbolic link ${symlink}.`,
+				path: relativePath
+			});
+			continue;
+		}
+		const stat = await node_fs_promises.default.lstat(filePath).catch(() => null);
+		if (!stat) {
+			if (baseline.policy === "ensure") diagnostics.push({
+				code: "ENSURED_PATH_MISSING",
+				severity: "error",
+				message: "An ensured template path is missing.",
+				path: relativePath
+			});
+			continue;
+		}
+		if (!stat.isFile()) continue;
+		const content = await node_fs_promises.default.readFile(filePath);
+		if (baseline.sha256 && require_src_state.sha256(content) !== baseline.sha256) diagnostics.push({
+			code: "TEMPLATE_CUSTOMIZED",
+			severity: "info",
+			message: "Managed template content has local customizations.",
+			path: relativePath
+		});
+		if (baseline.kind === "text") {
+			const source = content.toString("utf8");
+			if (/\{\{(?:APP_NAME|APP_DESCRIPTION|APP_SLUG|PACKAGE_SCOPE|BETTER_AUTH_SECRET)\}\}/.test(source)) diagnostics.push({
+				code: "UNRESOLVED_TEMPLATE_TOKEN",
+				severity: "error",
+				message: "Unresolved template token found.",
+				path: relativePath
+			});
+			if (/^(<{7}|={7}|>{7})(?: |$)/m.test(source)) diagnostics.push({
+				code: "MERGE_CONFLICT_MARKER",
+				severity: "error",
+				message: "Unresolved merge conflict marker found.",
+				path: relativePath
+			});
+		}
+	}
+	const pending = require_src_migrations_registry.getPendingMigrations(state, cliVersion);
+	for (const migration of pending) diagnostics.push({
+		code: "MIGRATION_PENDING",
+		severity: "error",
+		message: migration.description,
+		migrationId: migration.id,
+		guide: migration.guide,
+		suggestion: `Run pnpm dlx create-m5kdev@${cliVersion} update.`
+	});
+	diagnostics.push(...await require_src_migrations_registry.runMigrationValidators({
+		repoRoot: options.repoRoot,
+		state,
+		changes: new require_src_changes.ChangeSet(options.repoRoot)
+	}));
+	if (options.full) {
+		const packagePath = node_path.default.join(options.repoRoot, "package.json");
+		let packageManifest;
+		try {
+			packageManifest = JSON.parse(await node_fs_promises.default.readFile(packagePath, "utf8"));
+		} catch (error) {
+			diagnostics.push({
+				code: "PACKAGE_JSON_UNREADABLE",
+				severity: "error",
+				message: error instanceof Error ? `Unable to read package.json: ${error.message}` : "Unable to read package.json.",
+				path: "package.json"
+			});
+		}
+		if (packageManifest) for (const script of [
+			"check-types",
+			"lint",
+			"build"
+		]) {
+			if (!packageManifest.scripts?.[script]) continue;
+			try {
+				await execFileAsync("pnpm", [script], {
+					cwd: options.repoRoot,
+					env: process.env,
+					timeout: FULL_COMMAND_TIMEOUT_MS
+				});
+			} catch (error) {
+				diagnostics.push({
+					code: `COMMAND_${script.replace("-", "_").toUpperCase()}_FAILED`,
+					severity: "error",
+					message: `${script} failed: ${error instanceof Error ? error.message : String(error)}`,
+					path: "package.json"
+				});
+			}
+		}
+	}
+	return require_src_diagnostics.createDiagnosticReport(diagnostics);
+}
+//#endregion
+exports.diagnoseManagedRepo = diagnoseManagedRepo;
+
+//# sourceMappingURL=doctor.cjs.map

package/dist/src/doctor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.cjs","names":["execFile","fs","readManagedState","createDiagnosticReport","getCliVersion","loadTemplateManifest","getTemplateRoot","findRepositorySymlink","path","readCatalog","walkPackageJsonFiles","collectConsumerDependencyNames","sha256","getPendingMigrations","runMigrationValidators","ChangeSet"],"sources":["../../src/doctor.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\r\nimport fs from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { promisify } from \"node:util\";\r\nimport semver from \"semver\";\r\nimport { collectConsumerDependencyNames, readCatalog, walkPackageJsonFiles } from \"./catalog\";\r\nimport { ChangeSet, findRepositorySymlink } from \"./changes\";\r\nimport { TEMPLATE_NAME } from \"./constants\";\r\nimport { createDiagnosticReport, type Diagnostic, type DiagnosticReport } from \"./diagnostics\";\r\nimport { getPendingMigrations, runMigrationValidators } from \"./migrations/registry\";\r\nimport { getTemplateRoot } from \"./paths\";\r\nimport { getCliVersion, type ManagedState, readManagedState, sha256 } from \"./state\";\r\nimport { loadTemplateManifest } from \"./template\";\r\n\r\nconst execFileAsync = promisify(execFile);\r\nconst FULL_COMMAND_TIMEOUT_MS = 10 * 60 * 1000;\r\n\r\nexport interface DoctorOptions {\r\n  repoRoot: string;\r\n  full?: boolean;\r\n  state?: ManagedState;\r\n}\r\n\r\nasync function exists(filePath: string): Promise<boolean> {\r\n  return fs\r\n    .access(filePath)\r\n    .then(() => true)\r\n    .catch(() => false);\r\n}\r\n\r\nexport async function diagnoseManagedRepo(options: DoctorOptions): Promise<DiagnosticReport> {\r\n  const diagnostics: Diagnostic[] = [];\r\n  let state = options.state;\r\n  if (!state) {\r\n    try {\r\n      state = await readManagedState(options.repoRoot);\r\n    } catch (error) {\r\n      diagnostics.push({\r\n        code: \"STATE_INVALID\",\r\n        severity: \"error\",\r\n        message: error instanceof Error ? error.message : \"Unable to read .m5kdev.json.\",\r\n        path: \".m5kdev.json\",\r\n        suggestion: \"Run m5kdev init to establish a managed baseline.\",\r\n      });\r\n      return createDiagnosticReport(diagnostics);\r\n    }\r\n  }\r\n\r\n  const cliVersion = getCliVersion();\r\n  if (state.template.name !== TEMPLATE_NAME) {\r\n    diagnostics.push({\r\n      code: \"STATE_TEMPLATE_UNKNOWN\",\r\n      severity: \"error\",\r\n      message: `Unsupported template name: ${state.template.name}`,\r\n      path: \".m5kdev.json\",\r\n    });\r\n  }\r\n  if (!semver.valid(state.template.version)) {\r\n    diagnostics.push({\r\n      code: \"STATE_VERSION_INVALID\",\r\n      severity: \"error\",\r\n      message: `Invalid template version: ${state.template.version}`,\r\n      path: \".m5kdev.json\",\r\n    });\r\n  } else if (semver.gt(state.template.version, cliVersion)) {\r\n    diagnostics.push({\r\n      code: \"CLI_TOO_OLD\",\r\n      severity: \"error\",\r\n      message: `This repository is managed by ${state.template.version}, but the running CLI is ${cliVersion}.`,\r\n      suggestion: `Run pnpm dlx create-m5kdev@${state.template.version} doctor.`,\r\n    });\r\n  } else if (semver.lt(state.template.version, cliVersion)) {\r\n    diagnostics.push({\r\n      code: \"UPDATE_AVAILABLE\",\r\n      severity: \"warning\",\r\n      message: `Template ${cliVersion} is available; this repository is at ${state.template.version}.`,\r\n      suggestion: `Preview it with pnpm dlx create-m5kdev@${cliVersion} update --dry-run.`,\r\n    });\r\n  }\r\n\r\n  const manifest = loadTemplateManifest(getTemplateRoot());\r\n  const seenFeatures = new Set<string>();\r\n  for (const feature of state.template.features) {\r\n    if (seenFeatures.has(feature)) {\r\n      diagnostics.push({\r\n        code: \"FEATURE_DUPLICATE\",\r\n        severity: \"error\",\r\n        message: `Feature ${feature} is listed more than once.`,\r\n        path: \".m5kdev.json\",\r\n      });\r\n    } else if (!(feature in manifest.features)) {\r\n      diagnostics.push({\r\n        code: \"FEATURE_UNKNOWN\",\r\n        severity: \"error\",\r\n        message: `Unknown managed feature: ${feature}`,\r\n        path: \".m5kdev.json\",\r\n      });\r\n    }\r\n    seenFeatures.add(feature);\r\n  }\r\n  const requiredPaths = new Set(manifest.requiredPaths);\r\n  if (state.template.features.includes(\"webapp\")) requiredPaths.add(\"apps/webapp/package.json\");\r\n  if (state.template.features.includes(\"expo\")) requiredPaths.add(\"apps/expo/package.json\");\r\n  if (state.template.features.includes(\"test-harness\")) requiredPaths.add(\"apps/e2e/package.json\");\r\n  for (const relativePath of requiredPaths) {\r\n    const symlink = await findRepositorySymlink(options.repoRoot, relativePath);\r\n    if (symlink) {\r\n      diagnostics.push({\r\n        code: \"MANAGED_PATH_SYMLINK\",\r\n        severity: \"error\",\r\n        message: `Required managed path contains symbolic link ${symlink}.`,\r\n        path: relativePath,\r\n      });\r\n    } else if (!(await exists(path.join(options.repoRoot, relativePath)))) {\r\n      diagnostics.push({\r\n        code: \"REQUIRED_PATH_MISSING\",\r\n        severity: \"error\",\r\n        message: \"Required managed path is missing.\",\r\n        path: relativePath,\r\n        suggestion:\r\n          \"Restore the path or correct the enabled features before initializing/updating.\",\r\n      });\r\n    }\r\n  }\r\n\r\n  const workspaceRelativePath = \"pnpm-workspace.yaml\";\r\n  const workspacePath = path.join(options.repoRoot, workspaceRelativePath);\r\n  const workspaceSymlink = await findRepositorySymlink(options.repoRoot, workspaceRelativePath);\r\n  if (!workspaceSymlink && (await exists(workspacePath))) {\r\n    try {\r\n      const actualCatalog = readCatalog(await fs.readFile(workspacePath, \"utf8\"));\r\n      for (const [name, expected] of Object.entries(state.catalog)) {\r\n        if (!semver.validRange(expected)) {\r\n          diagnostics.push({\r\n            code: \"CATALOG_VERSION_INVALID\",\r\n            severity: \"error\",\r\n            message: `${name} has an invalid managed SemVer range: ${expected}.`,\r\n            path: \".m5kdev.json\",\r\n          });\r\n        }\r\n        if (!(name in actualCatalog)) {\r\n          diagnostics.push({\r\n            code: \"CATALOG_ENTRY_MISSING\",\r\n            severity: \"error\",\r\n            message: `Managed catalog entry ${name} is missing.`,\r\n            path: \"pnpm-workspace.yaml\",\r\n            suggestion: `Restore ${name}: ${expected}.`,\r\n          });\r\n        } else if (actualCatalog[name] !== expected) {\r\n          diagnostics.push({\r\n            code: \"CATALOG_VERSION_MISMATCH\",\r\n            severity: \"error\",\r\n            message: `${name} is ${actualCatalog[name]}, expected managed version ${expected}.`,\r\n            path: \"pnpm-workspace.yaml\",\r\n          });\r\n        }\r\n      }\r\n\r\n      const appsDirectory = path.join(options.repoRoot, \"apps\");\r\n      const packageFiles = [path.join(options.repoRoot, \"package.json\")];\r\n      if (await exists(appsDirectory)) packageFiles.push(...walkPackageJsonFiles(appsDirectory));\r\n      for (const dependency of collectConsumerDependencyNames(packageFiles)) {\r\n        if (!(dependency in actualCatalog)) {\r\n          diagnostics.push({\r\n            code: \"CATALOG_REFERENCE_MISSING\",\r\n            severity: \"error\",\r\n            message: `${dependency} uses catalog: but has no catalog entry.`,\r\n            path: \"pnpm-workspace.yaml\",\r\n          });\r\n        }\r\n      }\r\n    } catch (error) {\r\n      diagnostics.push({\r\n        code: \"CATALOG_INVALID\",\r\n        severity: \"error\",\r\n        message: error instanceof Error ? error.message : \"Unable to parse the consumer catalog.\",\r\n        path: \"pnpm-workspace.yaml\",\r\n      });\r\n    }\r\n  }\r\n\r\n  for (const [relativePath, baseline] of Object.entries(state.files)) {\r\n    if (baseline.policy === \"ignore\") continue;\r\n    const filePath = path.join(options.repoRoot, relativePath);\r\n    const symlink = await findRepositorySymlink(options.repoRoot, relativePath);\r\n    if (symlink) {\r\n      diagnostics.push({\r\n        code: \"MANAGED_PATH_SYMLINK\",\r\n        severity: \"error\",\r\n        message: `Managed path contains symbolic link ${symlink}.`,\r\n        path: relativePath,\r\n      });\r\n      continue;\r\n    }\r\n    const stat = await fs.lstat(filePath).catch(() => null);\r\n    if (!stat) {\r\n      if (baseline.policy === \"ensure\") {\r\n        diagnostics.push({\r\n          code: \"ENSURED_PATH_MISSING\",\r\n          severity: \"error\",\r\n          message: \"An ensured template path is missing.\",\r\n          path: relativePath,\r\n        });\r\n      }\r\n      continue;\r\n    }\r\n    if (!stat.isFile()) continue;\r\n    const content = await fs.readFile(filePath);\r\n    if (baseline.sha256 && sha256(content) !== baseline.sha256) {\r\n      diagnostics.push({\r\n        code: \"TEMPLATE_CUSTOMIZED\",\r\n        severity: \"info\",\r\n        message: \"Managed template content has local customizations.\",\r\n        path: relativePath,\r\n      });\r\n    }\r\n    if (baseline.kind === \"text\") {\r\n      const source = content.toString(\"utf8\");\r\n      if (\r\n        /\\{\\{(?:APP_NAME|APP_DESCRIPTION|APP_SLUG|PACKAGE_SCOPE|BETTER_AUTH_SECRET)\\}\\}/.test(\r\n          source\r\n        )\r\n      ) {\r\n        diagnostics.push({\r\n          code: \"UNRESOLVED_TEMPLATE_TOKEN\",\r\n          severity: \"error\",\r\n          message: \"Unresolved template token found.\",\r\n          path: relativePath,\r\n        });\r\n      }\r\n      if (/^(<{7}|={7}|>{7})(?: |$)/m.test(source)) {\r\n        diagnostics.push({\r\n          code: \"MERGE_CONFLICT_MARKER\",\r\n          severity: \"error\",\r\n          message: \"Unresolved merge conflict marker found.\",\r\n          path: relativePath,\r\n        });\r\n      }\r\n    }\r\n  }\r\n\r\n  const pending = getPendingMigrations(state, cliVersion);\r\n  for (const migration of pending) {\r\n    diagnostics.push({\r\n      code: \"MIGRATION_PENDING\",\r\n      severity: \"error\",\r\n      message: migration.description,\r\n      migrationId: migration.id,\r\n      guide: migration.guide,\r\n      suggestion: `Run pnpm dlx create-m5kdev@${cliVersion} update.`,\r\n    });\r\n  }\r\n  diagnostics.push(\r\n    ...(await runMigrationValidators({\r\n      repoRoot: options.repoRoot,\r\n      state,\r\n      changes: new ChangeSet(options.repoRoot),\r\n    }))\r\n  );\r\n\r\n  if (options.full) {\r\n    const packagePath = path.join(options.repoRoot, \"package.json\");\r\n    let packageManifest: { scripts?: Record<string, string> } | undefined;\r\n    try {\r\n      packageManifest = JSON.parse(await fs.readFile(packagePath, \"utf8\")) as {\r\n        scripts?: Record<string, string>;\r\n      };\r\n    } catch (error) {\r\n      diagnostics.push({\r\n        code: \"PACKAGE_JSON_UNREADABLE\",\r\n        severity: \"error\",\r\n        message:\r\n          error instanceof Error\r\n            ? `Unable to read package.json: ${error.message}`\r\n            : \"Unable to read package.json.\",\r\n        path: \"package.json\",\r\n      });\r\n    }\r\n    if (packageManifest) {\r\n      for (const script of [\"check-types\", \"lint\", \"build\"] as const) {\r\n        if (!packageManifest.scripts?.[script]) continue;\r\n        try {\r\n          await execFileAsync(\"pnpm\", [script], {\r\n            cwd: options.repoRoot,\r\n            env: process.env,\r\n            timeout: FULL_COMMAND_TIMEOUT_MS,\r\n          });\r\n        } catch (error) {\r\n          diagnostics.push({\r\n            code: `COMMAND_${script.replace(\"-\", \"_\").toUpperCase()}_FAILED`,\r\n            severity: \"error\",\r\n            message: `${script} failed: ${error instanceof Error ? error.message : String(error)}`,\r\n            path: \"package.json\",\r\n          });\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  return createDiagnosticReport(diagnostics);\r\n}\r\n"],"mappings":"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"}

package/dist/src/doctor.d.cts

@@ -0,0 +1,13 @@
+import { DiagnosticReport } from "./diagnostics.cjs";
+import { ManagedState } from "./state.cjs";
+
+//#region src/doctor.d.ts
+interface DoctorOptions {
+  repoRoot: string;
+  full?: boolean;
+  state?: ManagedState;
+}
+declare function diagnoseManagedRepo(options: DoctorOptions): Promise<DiagnosticReport>;
+//#endregion
+export { DoctorOptions, diagnoseManagedRepo };
+//# sourceMappingURL=doctor.d.cts.map

package/dist/src/fs.cjs

@@ -3,9 +3,9 @@ const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
 const require_src_strings = require("./strings.cjs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
-let node_child_process = require("node:child_process");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_runtime.__toESM(node_fs_promises);
+let node_child_process = require("node:child_process");
 //#region src/fs.ts
 const execFileAsync = (0, require("node:util").promisify)(node_child_process.execFile);
 const TEXT_EXTENSIONS = new Set([
@@ -32,14 +32,62 @@ const TEXT_BASENAMES = new Set([
 ]);
 /** Feature marker blocks: lines between `// m5k:<feature>:start` and `// m5k:<feature>:end`. */
 const MARKER_PATTERN = /^[ \t]*\/\/ m5k:([a-z-]+):(start|end)[ \t]*$/;
+async function collectTemplateFiles(templateDirectory, context, options = {}, relativeBase = "") {
+	const entries = await node_fs_promises.default.readdir(templateDirectory, { withFileTypes: true });
+	const excludePrefixes = options.excludePrefixes ?? [];
+	const enabledFeatures = options.enabledFeatures ?? /* @__PURE__ */ new Set();
+	const files = [];
+	for (const entry of entries) {
+		const sourcePath = node_path.default.join(templateDirectory, entry.name);
+		const targetName = require_src_strings.renderTemplate(entry.name.endsWith(".tpl") ? entry.name.slice(0, -4) : entry.name, context);
+		const relativePath = relativeBase ? `${relativeBase}/${targetName}` : targetName;
+		if (relativePath === "template.manifest.json") continue;
+		const asDirPrefix = `${relativePath}/`;
+		if (excludePrefixes.some((prefix) => relativePath === prefix || asDirPrefix === prefix || relativePath.startsWith(prefix))) continue;
+		if (entry.isDirectory()) {
+			files.push(...await collectTemplateFiles(sourcePath, context, options, relativePath));
+			continue;
+		}
+		if (entry.isSymbolicLink()) throw new Error(`Template symlinks are not supported: ${relativePath}`);
+		if (!entry.isFile()) continue;
+		if (options.ignoreContentFor?.(relativePath)) {
+			files.push({
+				content: Buffer.alloc(0),
+				kind: isTextFile(entry.name) ? "text" : "binary",
+				relativePath
+			});
+			continue;
+		}
+		if (!isTextFile(entry.name)) {
+			files.push({
+				content: await node_fs_promises.default.readFile(sourcePath),
+				kind: "binary",
+				relativePath
+			});
+			continue;
+		}
+		const content = await node_fs_promises.default.readFile(sourcePath, "utf8");
+		files.push({
+			content: Buffer.from(applyFeatureMarkers(require_src_strings.renderTemplate(content, context), enabledFeatures).replace(/\r\n?/g, "\n"), "utf8"),
+			kind: "text",
+			relativePath
+		});
+	}
+	return files;
+}
+/**
+* Ensures the target directory exists and may be written.
+* Returns true when this call created the directory (safe to remove on failure).
+*/
 async function ensureDirectoryState(targetDirectory, force) {
 	const stat = await node_fs_promises.default.stat(targetDirectory).catch(() => null);
 	if (!stat) {
 		await node_fs_promises.default.mkdir(targetDirectory, { recursive: true });
-		return;
+		return true;
 	}
 	if (!stat.isDirectory()) throw new Error(`Target path is not a directory: ${targetDirectory}`);
 	if ((await node_fs_promises.default.readdir(targetDirectory)).length > 0 && !force) throw new Error(`Target directory is not empty: ${targetDirectory}. Re-run with --force to overwrite.`);
+	return false;
 }
 function isTextFile(fileName) {
 	const withoutTpl = fileName.endsWith(".tpl") ? fileName.slice(0, -4) : fileName;
@@ -67,31 +115,12 @@ function applyFeatureMarkers(content, enabledFeatures) {
 	}
 	return out.join("\n");
 }
-async function copyTemplateDirectory(templateDirectory, targetDirectory, context, options = {}, relativeBase = "") {
-	const entries = await node_fs_promises.default.readdir(templateDirectory, { withFileTypes: true });
-	const excludePrefixes = options.excludePrefixes ?? [];
-	const enabledFeatures = options.enabledFeatures ?? /* @__PURE__ */ new Set();
-	for (const entry of entries) {
-		const sourcePath = node_path.default.join(templateDirectory, entry.name);
-		const targetName = require_src_strings.renderTemplate(entry.name.endsWith(".tpl") ? entry.name.slice(0, -4) : entry.name, context);
-		const relativePath = relativeBase ? `${relativeBase}/${targetName}` : targetName;
-		if (relativePath === "template.manifest.json") continue;
-		const asDirPrefix = `${relativePath}/`;
-		if (excludePrefixes.some((p) => relativePath === p || asDirPrefix === p || relativePath.startsWith(p))) continue;
-		const targetPath = node_path.default.join(targetDirectory, targetName);
-		if (entry.isDirectory()) {
-			await node_fs_promises.default.mkdir(targetPath, { recursive: true });
-			await copyTemplateDirectory(sourcePath, targetPath, context, options, relativePath);
-			continue;
-		}
-		if (!entry.isFile()) continue;
+async function copyTemplateDirectory(templateDirectory, targetDirectory, context, options = {}) {
+	const files = await collectTemplateFiles(templateDirectory, context, options);
+	for (const file of files) {
+		const targetPath = node_path.default.join(targetDirectory, file.relativePath);
 		await node_fs_promises.default.mkdir(node_path.default.dirname(targetPath), { recursive: true });
-		if (!isTextFile(entry.name)) {
-			await node_fs_promises.default.copyFile(sourcePath, targetPath);
-			continue;
-		}
-		const rendered = applyFeatureMarkers(require_src_strings.renderTemplate(await node_fs_promises.default.readFile(sourcePath, "utf8"), context), enabledFeatures).replace(/\r\n?/g, "\n");
-		await node_fs_promises.default.writeFile(targetPath, rendered, "utf8");
+		await node_fs_promises.default.writeFile(targetPath, file.content);
 	}
 }
 async function runInstall(targetDirectory) {
@@ -108,6 +137,7 @@ async function runGitInit(targetDirectory) {
 }
 //#endregion
 exports.applyFeatureMarkers = applyFeatureMarkers;
+exports.collectTemplateFiles = collectTemplateFiles;
 exports.copyTemplateDirectory = copyTemplateDirectory;
 exports.ensureDirectoryState = ensureDirectoryState;
 exports.runGitInit = runGitInit;

package/dist/src/fs.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fs.cjs","names":["execFile","fs","path","renderTemplate"],"sources":["../../src/fs.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { promisify } from \"node:util\";\nimport type { TemplateContext } from \"./types\";\nimport { renderTemplate } from \"./strings\";\n\nconst execFileAsync = promisify(execFile);\n\nconst TEXT_EXTENSIONS = new Set([\n  \".ts\", \".tsx\", \".js\", \".mjs\", \".cjs\", \".json\", \".md\", \".css\", \".html\",\n  \".svg\", \".yaml\", \".yml\", \".txt\", \".mdc\",\n]);\nconst TEXT_BASENAMES = new Set([\".gitignore\", \".env\", \".env.example\", \".npmrc\"]);\n\n/** Feature marker blocks: lines between `// m5k:<feature>:start` and `// m5k:<feature>:end`. */\nconst MARKER_PATTERN = /^[ \\t]*\\/\\/ m5k:([a-z-]+):(start|end)[ \\t]*$/;\n\nexport interface CopyTemplateOptions {\n  /** Repo-root-relative path prefixes to skip entirely (disabled features). */\n  excludePrefixes?: readonly string[];\n  /** Features whose marker blocks should be kept (markers removed, content kept). */\n  enabledFeatures?: ReadonlySet<string>;\n}\n\nexport async function ensureDirectoryState(\n  targetDirectory: string,\n  force: boolean\n): Promise<void> {\n  const stat = await fs.stat(targetDirectory).catch(() => null);\n\n  if (!stat) {\n    await fs.mkdir(targetDirectory, { recursive: true });\n    return;\n  }\n\n  if (!stat.isDirectory()) {\n    throw new Error(`Target path is not a directory: ${targetDirectory}`);\n  }\n\n  const entries = await fs.readdir(targetDirectory);\n  if (entries.length > 0 && !force) {\n    throw new Error(\n      `Target directory is not empty: ${targetDirectory}. Re-run with --force to overwrite.`\n    );\n  }\n}\n\nfunction isTextFile(fileName: string): boolean {\n  const withoutTpl = fileName.endsWith(\".tpl\") ? fileName.slice(0, -4) : fileName;\n  if (TEXT_BASENAMES.has(withoutTpl)) return true;\n  return TEXT_EXTENSIONS.has(path.extname(withoutTpl));\n}\n\n/**\n * Removes feature marker lines. Blocks for disabled features are dropped with\n * their content; blocks for enabled features keep the content, lose the markers.\n */\nexport function applyFeatureMarkers(content: string, enabledFeatures: ReadonlySet<string>): string {\n  const lines = content.split(\"\\n\");\n  const out: string[] = [];\n  let skippingFeature: string | undefined;\n\n  for (const line of lines) {\n    const match = line.match(MARKER_PATTERN);\n    if (!match) {\n      if (skippingFeature === undefined) out.push(line);\n      continue;\n    }\n\n    const [, feature, edge] = match;\n    if (edge === \"start\") {\n      if (!enabledFeatures.has(feature)) skippingFeature = feature;\n    } else if (skippingFeature === feature) {\n      skippingFeature = undefined;\n    }\n    // marker lines themselves are never emitted\n  }\n\n  return out.join(\"\\n\");\n}\n\nexport async function copyTemplateDirectory(\n  templateDirectory: string,\n  targetDirectory: string,\n  context: TemplateContext,\n  options: CopyTemplateOptions = {},\n  relativeBase = \"\"\n): Promise<void> {\n  const entries = await fs.readdir(templateDirectory, { withFileTypes: true });\n  const excludePrefixes = options.excludePrefixes ?? [];\n  const enabledFeatures = options.enabledFeatures ?? new Set<string>();\n\n  for (const entry of entries) {\n    const sourcePath = path.join(templateDirectory, entry.name);\n    const targetName = renderTemplate(\n      entry.name.endsWith(\".tpl\") ? entry.name.slice(0, -4) : entry.name,\n      context\n    );\n    const relativePath = relativeBase ? `${relativeBase}/${targetName}` : targetName;\n\n    if (relativePath === \"template.manifest.json\") {\n      continue;\n    }\n\n    const asDirPrefix = `${relativePath}/`;\n    if (excludePrefixes.some((p) => relativePath === p || asDirPrefix === p || relativePath.startsWith(p))) {\n      continue;\n    }\n\n    const targetPath = path.join(targetDirectory, targetName);\n\n    if (entry.isDirectory()) {\n      await fs.mkdir(targetPath, { recursive: true });\n      await copyTemplateDirectory(sourcePath, targetPath, context, options, relativePath);\n      continue;\n    }\n\n    if (!entry.isFile()) {\n      continue;\n    }\n\n    await fs.mkdir(path.dirname(targetPath), { recursive: true });\n\n    if (!isTextFile(entry.name)) {\n      await fs.copyFile(sourcePath, targetPath);\n      continue;\n    }\n\n    const content = await fs.readFile(sourcePath, \"utf8\");\n    const rendered = applyFeatureMarkers(\n      renderTemplate(content, context),\n      enabledFeatures\n    ).replace(/\\r\\n?/g, \"\\n\");\n    await fs.writeFile(targetPath, rendered, \"utf8\");\n  }\n}\n\nexport async function runInstall(targetDirectory: string): Promise<void> {\n  await execFileAsync(\"pnpm\", [\"install\"], {\n    cwd: targetDirectory,\n    env: process.env,\n  });\n}\n\nexport async function runGitInit(targetDirectory: string): Promise<void> {\n  await execFileAsync(\"git\", [\"init\"], {\n    cwd: targetDirectory,\n    env: process.env,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"fs.cjs","names":["execFile","fs","path","renderTemplate"],"sources":["../../src/fs.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\r\nimport fs from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { promisify } from \"node:util\";\r\nimport { renderTemplate } from \"./strings\";\r\nimport type { RenderedTemplateFile, TemplateContext } from \"./types\";\r\n\r\nconst execFileAsync = promisify(execFile);\r\n\r\nconst TEXT_EXTENSIONS = new Set([\r\n  \".ts\",\r\n  \".tsx\",\r\n  \".js\",\r\n  \".mjs\",\r\n  \".cjs\",\r\n  \".json\",\r\n  \".md\",\r\n  \".css\",\r\n  \".html\",\r\n  \".svg\",\r\n  \".yaml\",\r\n  \".yml\",\r\n  \".txt\",\r\n  \".mdc\",\r\n]);\r\nconst TEXT_BASENAMES = new Set([\".gitignore\", \".env\", \".env.example\", \".npmrc\"]);\r\n\r\n/** Feature marker blocks: lines between `// m5k:<feature>:start` and `// m5k:<feature>:end`. */\r\nconst MARKER_PATTERN = /^[ \\t]*\\/\\/ m5k:([a-z-]+):(start|end)[ \\t]*$/;\r\n\r\nexport interface CopyTemplateOptions {\r\n  /** Repo-root-relative path prefixes to skip entirely (disabled features). */\r\n  excludePrefixes?: readonly string[];\r\n  /** Features whose marker blocks should be kept (markers removed, content kept). */\r\n  enabledFeatures?: ReadonlySet<string>;\r\n  /** Update inspection can retain ignored-file metadata without rendering secret content. */\r\n  ignoreContentFor?: (relativePath: string) => boolean;\r\n}\r\n\r\nexport async function collectTemplateFiles(\r\n  templateDirectory: string,\r\n  context: TemplateContext,\r\n  options: CopyTemplateOptions = {},\r\n  relativeBase = \"\"\r\n): Promise<RenderedTemplateFile[]> {\r\n  const entries = await fs.readdir(templateDirectory, { withFileTypes: true });\r\n  const excludePrefixes = options.excludePrefixes ?? [];\r\n  const enabledFeatures = options.enabledFeatures ?? new Set<string>();\r\n  const files: RenderedTemplateFile[] = [];\r\n\r\n  for (const entry of entries) {\r\n    const sourcePath = path.join(templateDirectory, entry.name);\r\n    const targetName = renderTemplate(\r\n      entry.name.endsWith(\".tpl\") ? entry.name.slice(0, -4) : entry.name,\r\n      context\r\n    );\r\n    const relativePath = relativeBase ? `${relativeBase}/${targetName}` : targetName;\r\n\r\n    if (relativePath === \"template.manifest.json\") continue;\r\n\r\n    const asDirPrefix = `${relativePath}/`;\r\n    if (\r\n      excludePrefixes.some(\r\n        (prefix) =>\r\n          relativePath === prefix || asDirPrefix === prefix || relativePath.startsWith(prefix)\r\n      )\r\n    ) {\r\n      continue;\r\n    }\r\n\r\n    if (entry.isDirectory()) {\r\n      files.push(...(await collectTemplateFiles(sourcePath, context, options, relativePath)));\r\n      continue;\r\n    }\r\n    if (entry.isSymbolicLink()) {\r\n      throw new Error(`Template symlinks are not supported: ${relativePath}`);\r\n    }\r\n    if (!entry.isFile()) continue;\r\n\r\n    if (options.ignoreContentFor?.(relativePath)) {\r\n      files.push({\r\n        content: Buffer.alloc(0),\r\n        kind: isTextFile(entry.name) ? \"text\" : \"binary\",\r\n        relativePath,\r\n      });\r\n      continue;\r\n    }\r\n\r\n    if (!isTextFile(entry.name)) {\r\n      files.push({\r\n        content: await fs.readFile(sourcePath),\r\n        kind: \"binary\",\r\n        relativePath,\r\n      });\r\n      continue;\r\n    }\r\n\r\n    const content = await fs.readFile(sourcePath, \"utf8\");\r\n    files.push({\r\n      content: Buffer.from(\r\n        applyFeatureMarkers(renderTemplate(content, context), enabledFeatures).replace(\r\n          /\\r\\n?/g,\r\n          \"\\n\"\r\n        ),\r\n        \"utf8\"\r\n      ),\r\n      kind: \"text\",\r\n      relativePath,\r\n    });\r\n  }\r\n\r\n  return files;\r\n}\r\n\r\n/**\r\n * Ensures the target directory exists and may be written.\r\n * Returns true when this call created the directory (safe to remove on failure).\r\n */\r\nexport async function ensureDirectoryState(\r\n  targetDirectory: string,\r\n  force: boolean\r\n): Promise<boolean> {\r\n  const stat = await fs.stat(targetDirectory).catch(() => null);\r\n\r\n  if (!stat) {\r\n    await fs.mkdir(targetDirectory, { recursive: true });\r\n    return true;\r\n  }\r\n\r\n  if (!stat.isDirectory()) {\r\n    throw new Error(`Target path is not a directory: ${targetDirectory}`);\r\n  }\r\n\r\n  const entries = await fs.readdir(targetDirectory);\r\n  if (entries.length > 0 && !force) {\r\n    throw new Error(\r\n      `Target directory is not empty: ${targetDirectory}. Re-run with --force to overwrite.`\r\n    );\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\nfunction isTextFile(fileName: string): boolean {\r\n  const withoutTpl = fileName.endsWith(\".tpl\") ? fileName.slice(0, -4) : fileName;\r\n  if (TEXT_BASENAMES.has(withoutTpl)) return true;\r\n  return TEXT_EXTENSIONS.has(path.extname(withoutTpl));\r\n}\r\n\r\n/**\r\n * Removes feature marker lines. Blocks for disabled features are dropped with\r\n * their content; blocks for enabled features keep the content, lose the markers.\r\n */\r\nexport function applyFeatureMarkers(content: string, enabledFeatures: ReadonlySet<string>): string {\r\n  const lines = content.split(\"\\n\");\r\n  const out: string[] = [];\r\n  let skippingFeature: string | undefined;\r\n\r\n  for (const line of lines) {\r\n    const match = line.match(MARKER_PATTERN);\r\n    if (!match) {\r\n      if (skippingFeature === undefined) out.push(line);\r\n      continue;\r\n    }\r\n\r\n    const [, feature, edge] = match;\r\n    if (edge === \"start\") {\r\n      if (!enabledFeatures.has(feature)) skippingFeature = feature;\r\n    } else if (skippingFeature === feature) {\r\n      skippingFeature = undefined;\r\n    }\r\n    // marker lines themselves are never emitted\r\n  }\r\n\r\n  return out.join(\"\\n\");\r\n}\r\n\r\nexport async function copyTemplateDirectory(\r\n  templateDirectory: string,\r\n  targetDirectory: string,\r\n  context: TemplateContext,\r\n  options: CopyTemplateOptions = {}\r\n): Promise<void> {\r\n  const files = await collectTemplateFiles(templateDirectory, context, options);\r\n  for (const file of files) {\r\n    const targetPath = path.join(targetDirectory, file.relativePath);\r\n    await fs.mkdir(path.dirname(targetPath), { recursive: true });\r\n    await fs.writeFile(targetPath, file.content);\r\n  }\r\n}\r\n\r\nexport async function runInstall(targetDirectory: string): Promise<void> {\r\n  await execFileAsync(\"pnpm\", [\"install\"], {\r\n    cwd: targetDirectory,\r\n    env: process.env,\r\n  });\r\n}\r\n\r\nexport async function runGitInit(targetDirectory: string): Promise<void> {\r\n  await execFileAsync(\"git\", [\"init\"], {\r\n    cwd: targetDirectory,\r\n    env: process.env,\r\n  });\r\n}\r\n"],"mappings":";;;;;;;;;AAOA,MAAM,iBAAA,wBAAA,WAA0BA,mBAAAA,SAAS;AAEzC,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AACF,MAAM,iBAAiB,IAAI,IAAI;CAAC;CAAc;CAAQ;CAAgB;CAAS,CAAC;;AAGhF,MAAM,iBAAiB;AAWvB,eAAsB,qBACpB,mBACA,SACA,UAA+B,EAAE,EACjC,eAAe,IACkB;CACjC,MAAM,UAAU,MAAMC,iBAAAA,QAAG,QAAQ,mBAAmB,EAAE,eAAe,MAAM,CAAC;CAC5E,MAAM,kBAAkB,QAAQ,mBAAmB,EAAE;CACrD,MAAM,kBAAkB,QAAQ,mCAAmB,IAAI,KAAa;CACpE,MAAM,QAAgC,EAAE;AAExC,MAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,aAAaC,UAAAA,QAAK,KAAK,mBAAmB,MAAM,KAAK;EAC3D,MAAM,aAAaC,oBAAAA,eACjB,MAAM,KAAK,SAAS,OAAO,GAAG,MAAM,KAAK,MAAM,GAAG,GAAG,GAAG,MAAM,MAC9D,QACD;EACD,MAAM,eAAe,eAAe,GAAG,aAAa,GAAG,eAAe;AAEtE,MAAI,iBAAiB,yBAA0B;EAE/C,MAAM,cAAc,GAAG,aAAa;AACpC,MACE,gBAAgB,MACb,WACC,iBAAiB,UAAU,gBAAgB,UAAU,aAAa,WAAW,OAAO,CACvF,CAED;AAGF,MAAI,MAAM,aAAa,EAAE;AACvB,SAAM,KAAK,GAAI,MAAM,qBAAqB,YAAY,SAAS,SAAS,aAAa,CAAE;AACvF;;AAEF,MAAI,MAAM,gBAAgB,CACxB,OAAM,IAAI,MAAM,wCAAwC,eAAe;AAEzE,MAAI,CAAC,MAAM,QAAQ,CAAE;AAErB,MAAI,QAAQ,mBAAmB,aAAa,EAAE;AAC5C,SAAM,KAAK;IACT,SAAS,OAAO,MAAM,EAAE;IACxB,MAAM,WAAW,MAAM,KAAK,GAAG,SAAS;IACxC;IACD,CAAC;AACF;;AAGF,MAAI,CAAC,WAAW,MAAM,KAAK,EAAE;AAC3B,SAAM,KAAK;IACT,SAAS,MAAMF,iBAAAA,QAAG,SAAS,WAAW;IACtC,MAAM;IACN;IACD,CAAC;AACF;;EAGF,MAAM,UAAU,MAAMA,iBAAAA,QAAG,SAAS,YAAY,OAAO;AACrD,QAAM,KAAK;GACT,SAAS,OAAO,KACd,oBAAoBE,oBAAAA,eAAe,SAAS,QAAQ,EAAE,gBAAgB,CAAC,QACrE,UACA,KACD,EACD,OACD;GACD,MAAM;GACN;GACD,CAAC;;AAGJ,QAAO;;;;;;AAOT,eAAsB,qBACpB,iBACA,OACkB;CAClB,MAAM,OAAO,MAAMF,iBAAAA,QAAG,KAAK,gBAAgB,CAAC,YAAY,KAAK;AAE7D,KAAI,CAAC,MAAM;AACT,QAAMA,iBAAAA,QAAG,MAAM,iBAAiB,EAAE,WAAW,MAAM,CAAC;AACpD,SAAO;;AAGT,KAAI,CAAC,KAAK,aAAa,CACrB,OAAM,IAAI,MAAM,mCAAmC,kBAAkB;AAIvE,MADgB,MAAMA,iBAAAA,QAAG,QAAQ,gBAAgB,EACrC,SAAS,KAAK,CAAC,MACzB,OAAM,IAAI,MACR,kCAAkC,gBAAgB,qCACnD;AAGH,QAAO;;AAGT,SAAS,WAAW,UAA2B;CAC7C,MAAM,aAAa,SAAS,SAAS,OAAO,GAAG,SAAS,MAAM,GAAG,GAAG,GAAG;AACvE,KAAI,eAAe,IAAI,WAAW,CAAE,QAAO;AAC3C,QAAO,gBAAgB,IAAIC,UAAAA,QAAK,QAAQ,WAAW,CAAC;;;;;;AAOtD,SAAgB,oBAAoB,SAAiB,iBAA8C;CACjG,MAAM,QAAQ,QAAQ,MAAM,KAAK;CACjC,MAAM,MAAgB,EAAE;CACxB,IAAI;AAEJ,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,KAAK,MAAM,eAAe;AACxC,MAAI,CAAC,OAAO;AACV,OAAI,oBAAoB,KAAA,EAAW,KAAI,KAAK,KAAK;AACjD;;EAGF,MAAM,GAAG,SAAS,QAAQ;AAC1B,MAAI,SAAS;OACP,CAAC,gBAAgB,IAAI,QAAQ,CAAE,mBAAkB;aAC5C,oBAAoB,QAC7B,mBAAkB,KAAA;;AAKtB,QAAO,IAAI,KAAK,KAAK;;AAGvB,eAAsB,sBACpB,mBACA,iBACA,SACA,UAA+B,EAAE,EAClB;CACf,MAAM,QAAQ,MAAM,qBAAqB,mBAAmB,SAAS,QAAQ;AAC7E,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,aAAaA,UAAAA,QAAK,KAAK,iBAAiB,KAAK,aAAa;AAChE,QAAMD,iBAAAA,QAAG,MAAMC,UAAAA,QAAK,QAAQ,WAAW,EAAE,EAAE,WAAW,MAAM,CAAC;AAC7D,QAAMD,iBAAAA,QAAG,UAAU,YAAY,KAAK,QAAQ;;;AAIhD,eAAsB,WAAW,iBAAwC;AACvE,OAAM,cAAc,QAAQ,CAAC,UAAU,EAAE;EACvC,KAAK;EACL,KAAK,QAAQ;EACd,CAAC;;AAGJ,eAAsB,WAAW,iBAAwC;AACvE,OAAM,cAAc,OAAO,CAAC,OAAO,EAAE;EACnC,KAAK;EACL,KAAK,QAAQ;EACd,CAAC"}

package/dist/src/fs.d.cts

@@ -1,4 +1,4 @@
-import { TemplateContext } from "./types.cjs";
+import { RenderedTemplateFile, TemplateContext } from "./types.cjs";
 
 //#region src/fs.d.ts
 interface CopyTemplateOptions {
@@ -6,16 +6,23 @@ interface CopyTemplateOptions {
   excludePrefixes?: readonly string[];
   /** Features whose marker blocks should be kept (markers removed, content kept). */
   enabledFeatures?: ReadonlySet<string>;
+  /** Update inspection can retain ignored-file metadata without rendering secret content. */
+  ignoreContentFor?: (relativePath: string) => boolean;
 }
-declare function ensureDirectoryState(targetDirectory: string, force: boolean): Promise<void>;
+declare function collectTemplateFiles(templateDirectory: string, context: TemplateContext, options?: CopyTemplateOptions, relativeBase?: string): Promise<RenderedTemplateFile[]>;
+/**
+ * Ensures the target directory exists and may be written.
+ * Returns true when this call created the directory (safe to remove on failure).
+ */
+declare function ensureDirectoryState(targetDirectory: string, force: boolean): Promise<boolean>;
 /**
  * Removes feature marker lines. Blocks for disabled features are dropped with
  * their content; blocks for enabled features keep the content, lose the markers.
  */
 declare function applyFeatureMarkers(content: string, enabledFeatures: ReadonlySet<string>): string;
-declare function copyTemplateDirectory(templateDirectory: string, targetDirectory: string, context: TemplateContext, options?: CopyTemplateOptions, relativeBase?: string): Promise<void>;
+declare function copyTemplateDirectory(templateDirectory: string, targetDirectory: string, context: TemplateContext, options?: CopyTemplateOptions): Promise<void>;
 declare function runInstall(targetDirectory: string): Promise<void>;
 declare function runGitInit(targetDirectory: string): Promise<void>;
 //#endregion
-export { CopyTemplateOptions, applyFeatureMarkers, copyTemplateDirectory, ensureDirectoryState, runGitInit, runInstall };
+export { CopyTemplateOptions, applyFeatureMarkers, collectTemplateFiles, copyTemplateDirectory, ensureDirectoryState, runGitInit, runInstall };
 //# sourceMappingURL=fs.d.cts.map

package/dist/src/init.cjs

@@ -0,0 +1,110 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_src_strings = require("./strings.cjs");
+const require_src_fs = require("./fs.cjs");
+const require_src_paths = require("./paths.cjs");
+const require_src_template = require("./template.cjs");
+const require_src_state = require("./state.cjs");
+const require_src_doctor = require("./doctor.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_runtime.__toESM(node_fs_promises);
+let node_process = require("node:process");
+let node_readline_promises = require("node:readline/promises");
+node_readline_promises = require_runtime.__toESM(node_readline_promises);
+//#region src/init.ts
+async function inferPackageScope(repoRoot, fallbackSlug) {
+	const appsRoot = node_path.default.join(repoRoot, "apps");
+	const scopes = /* @__PURE__ */ new Map();
+	for (const entry of await node_fs_promises.default.readdir(appsRoot, { withFileTypes: true }).catch(() => [])) {
+		if (!entry.isDirectory()) continue;
+		const packagePath = node_path.default.join(appsRoot, entry.name, "package.json");
+		try {
+			const match = JSON.parse(await node_fs_promises.default.readFile(packagePath, "utf8")).name?.match(/^(@[^/]+)\//);
+			if (match) scopes.set(match[1], (scopes.get(match[1]) ?? 0) + 1);
+		} catch {}
+	}
+	return [...scopes.entries()].sort((left, right) => right[1] - left[1])[0]?.[0] ?? require_src_strings.derivePackageScope(fallbackSlug);
+}
+async function inferContext(repoRoot) {
+	const rootPackage = JSON.parse(await node_fs_promises.default.readFile(node_path.default.join(repoRoot, "package.json"), "utf8"));
+	if (!rootPackage.name) throw new Error("Cannot infer the app slug: root package.json has no name.");
+	const appSlug = rootPackage.name.split("/").at(-1);
+	if (!appSlug) throw new Error("Cannot infer the app slug from root package.json.");
+	let appName = require_src_strings.toDisplayName(appSlug.replace(/[-_]+/g, " "));
+	const constantsPath = node_path.default.join(repoRoot, "apps/shared/src/modules/app/app.constants.ts");
+	try {
+		appName = (await node_fs_promises.default.readFile(constantsPath, "utf8")).match(/APP_NAME\s*=\s*["']([^"']+)["']/)?.[1] ?? appName;
+	} catch {}
+	return {
+		appName,
+		appDescription: rootPackage.description ?? `${appName} uses the m5kdev stack.`,
+		appSlug,
+		packageScope: await inferPackageScope(repoRoot, appSlug),
+		betterAuthSecret: "ignored-by-managed-state"
+	};
+}
+async function inferFeatures(repoRoot) {
+	const enabled = /* @__PURE__ */ new Set();
+	const has = (relativePath) => node_fs_promises.default.access(node_path.default.join(repoRoot, relativePath)).then(() => true).catch(() => false);
+	if (await has("apps/webapp")) enabled.add("webapp");
+	if (await has("apps/expo")) enabled.add("expo");
+	if (await has("apps/e2e")) enabled.add("test-harness");
+	return enabled;
+}
+async function confirmInitialization(version, yes) {
+	if (yes) return;
+	if (!process.stdin.isTTY) throw new Error("Initialization requires confirmation. Re-run with --yes in a non-interactive shell.");
+	const prompt = node_readline_promises.default.createInterface({
+		input: node_process.stdin,
+		output: node_process.stdout
+	});
+	try {
+		const answer = await prompt.question(`Record this repository as template ${version} without applying older migrations? y/N: `);
+		if (!/^y(es)?$/i.test(answer.trim())) throw new Error("Initialization cancelled.");
+	} finally {
+		prompt.close();
+	}
+}
+async function initializeManagedRepo(options) {
+	const statePath = node_path.default.join(options.repoRoot, require_src_state.STATE_FILE_NAME);
+	if (!options.force && await node_fs_promises.default.access(statePath).then(() => true).catch(() => false)) throw new Error(`${require_src_state.STATE_FILE_NAME} already exists. Use --force to re-baseline intentionally.`);
+	await node_fs_promises.default.access(node_path.default.join(options.repoRoot, "pnpm-workspace.yaml"));
+	const context = await inferContext(options.repoRoot);
+	const enabledFeatures = await inferFeatures(options.repoRoot);
+	const templateRoot = require_src_paths.getTemplateRoot();
+	const manifest = require_src_template.loadTemplateManifest(templateRoot);
+	const renderedFiles = await require_src_fs.collectTemplateFiles(templateRoot, context, {
+		excludePrefixes: require_src_template.getExcludedFeaturePaths(manifest, enabledFeatures),
+		enabledFeatures
+	});
+	const version = require_src_state.getCliVersion();
+	const state = require_src_state.createManagedState({
+		templateVersion: version,
+		enabledFeatures,
+		context,
+		renderedFiles,
+		manifest
+	});
+	const report = await require_src_doctor.diagnoseManagedRepo({
+		repoRoot: options.repoRoot,
+		state
+	});
+	if (!report.ok) return {
+		initialized: false,
+		state,
+		report
+	};
+	await confirmInitialization(version, options.yes);
+	await require_src_state.writeManagedState(options.repoRoot, state);
+	return {
+		initialized: true,
+		state,
+		report
+	};
+}
+//#endregion
+exports.initializeManagedRepo = initializeManagedRepo;
+
+//# sourceMappingURL=init.cjs.map

package/dist/src/init.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.cjs","names":["path","fs","derivePackageScope","toDisplayName","readline","STATE_FILE_NAME","getTemplateRoot","loadTemplateManifest","collectTemplateFiles","getExcludedFeaturePaths","getCliVersion","createManagedState","diagnoseManagedRepo","writeManagedState"],"sources":["../../src/init.ts"],"sourcesContent":["import fs from \"node:fs/promises\";\r\nimport path from \"node:path\";\r\nimport { stdin as input, stdout as output } from \"node:process\";\r\nimport readline from \"node:readline/promises\";\r\nimport { diagnoseManagedRepo } from \"./doctor\";\r\nimport { collectTemplateFiles } from \"./fs\";\r\nimport { getTemplateRoot } from \"./paths\";\r\nimport { createManagedState, getCliVersion, STATE_FILE_NAME, writeManagedState } from \"./state\";\r\nimport { derivePackageScope, toDisplayName } from \"./strings\";\r\nimport { getExcludedFeaturePaths, loadTemplateManifest } from \"./template\";\r\nimport type { TemplateContext } from \"./types\";\r\n\r\nexport interface InitCommandOptions {\r\n  repoRoot: string;\r\n  yes: boolean;\r\n  force: boolean;\r\n}\r\n\r\nasync function inferPackageScope(repoRoot: string, fallbackSlug: string): Promise<string> {\r\n  const appsRoot = path.join(repoRoot, \"apps\");\r\n  const scopes = new Map<string, number>();\r\n  for (const entry of await fs.readdir(appsRoot, { withFileTypes: true }).catch(() => [])) {\r\n    if (!entry.isDirectory()) continue;\r\n    const packagePath = path.join(appsRoot, entry.name, \"package.json\");\r\n    try {\r\n      const manifest = JSON.parse(await fs.readFile(packagePath, \"utf8\")) as { name?: string };\r\n      const match = manifest.name?.match(/^(@[^/]+)\\//);\r\n      if (match) scopes.set(match[1], (scopes.get(match[1]) ?? 0) + 1);\r\n    } catch {\r\n      // Optional app directories do not all need package manifests.\r\n    }\r\n  }\r\n  return (\r\n    [...scopes.entries()].sort((left, right) => right[1] - left[1])[0]?.[0] ??\r\n    derivePackageScope(fallbackSlug)\r\n  );\r\n}\r\n\r\nasync function inferContext(repoRoot: string): Promise<TemplateContext> {\r\n  const rootPackage = JSON.parse(\r\n    await fs.readFile(path.join(repoRoot, \"package.json\"), \"utf8\")\r\n  ) as {\r\n    name?: string;\r\n    description?: string;\r\n  };\r\n  if (!rootPackage.name)\r\n    throw new Error(\"Cannot infer the app slug: root package.json has no name.\");\r\n  const appSlug = rootPackage.name.split(\"/\").at(-1);\r\n  if (!appSlug) throw new Error(\"Cannot infer the app slug from root package.json.\");\r\n  let appName = toDisplayName(appSlug.replace(/[-_]+/g, \" \"));\r\n  const constantsPath = path.join(repoRoot, \"apps/shared/src/modules/app/app.constants.ts\");\r\n  try {\r\n    const constants = await fs.readFile(constantsPath, \"utf8\");\r\n    appName = constants.match(/APP_NAME\\s*=\\s*[\"']([^\"']+)[\"']/)?.[1] ?? appName;\r\n  } catch {\r\n    // The required-path diagnostic will explain missing shared configuration.\r\n  }\r\n  return {\r\n    appName,\r\n    appDescription: rootPackage.description ?? `${appName} uses the m5kdev stack.`,\r\n    appSlug,\r\n    packageScope: await inferPackageScope(repoRoot, appSlug),\r\n    betterAuthSecret: \"ignored-by-managed-state\",\r\n  };\r\n}\r\n\r\nasync function inferFeatures(repoRoot: string): Promise<Set<string>> {\r\n  const enabled = new Set<string>();\r\n  const has = (relativePath: string) =>\r\n    fs\r\n      .access(path.join(repoRoot, relativePath))\r\n      .then(() => true)\r\n      .catch(() => false);\r\n  if (await has(\"apps/webapp\")) enabled.add(\"webapp\");\r\n  if (await has(\"apps/expo\")) enabled.add(\"expo\");\r\n  if (await has(\"apps/e2e\")) enabled.add(\"test-harness\");\r\n  return enabled;\r\n}\r\n\r\nasync function confirmInitialization(version: string, yes: boolean): Promise<void> {\r\n  if (yes) return;\r\n  if (!process.stdin.isTTY) {\r\n    throw new Error(\r\n      \"Initialization requires confirmation. Re-run with --yes in a non-interactive shell.\"\r\n    );\r\n  }\r\n  const prompt = readline.createInterface({ input, output });\r\n  try {\r\n    const answer = await prompt.question(\r\n      `Record this repository as template ${version} without applying older migrations? y/N: `\r\n    );\r\n    if (!/^y(es)?$/i.test(answer.trim())) throw new Error(\"Initialization cancelled.\");\r\n  } finally {\r\n    prompt.close();\r\n  }\r\n}\r\n\r\nexport async function initializeManagedRepo(options: InitCommandOptions) {\r\n  const statePath = path.join(options.repoRoot, STATE_FILE_NAME);\r\n  if (\r\n    !options.force &&\r\n    (await fs\r\n      .access(statePath)\r\n      .then(() => true)\r\n      .catch(() => false))\r\n  ) {\r\n    throw new Error(`${STATE_FILE_NAME} already exists. Use --force to re-baseline intentionally.`);\r\n  }\r\n  await fs.access(path.join(options.repoRoot, \"pnpm-workspace.yaml\"));\r\n  const context = await inferContext(options.repoRoot);\r\n  const enabledFeatures = await inferFeatures(options.repoRoot);\r\n  const templateRoot = getTemplateRoot();\r\n  const manifest = loadTemplateManifest(templateRoot);\r\n  const excludePrefixes = getExcludedFeaturePaths(manifest, enabledFeatures);\r\n  const renderedFiles = await collectTemplateFiles(templateRoot, context, {\r\n    excludePrefixes,\r\n    enabledFeatures,\r\n  });\r\n  const version = getCliVersion();\r\n  const state = createManagedState({\r\n    templateVersion: version,\r\n    enabledFeatures,\r\n    context,\r\n    renderedFiles,\r\n    manifest,\r\n  });\r\n  const report = await diagnoseManagedRepo({ repoRoot: options.repoRoot, state });\r\n  if (!report.ok) return { initialized: false, state, report };\r\n\r\n  await confirmInitialization(version, options.yes);\r\n  await writeManagedState(options.repoRoot, state);\r\n  return { initialized: true, state, report };\r\n}\r\n"],"mappings":"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"}