@mindees/cli 0.1.0

package/dist/cli.js

@@ -0,0 +1,194 @@
+import { runAiCommand } from "./ai.js";
+import { buildProject } from "./build.js";
+import { quoteShellPath, resolveCreateTarget } from "./create-target.js";
+import { doctorSummary, renderDoctor, runDoctor } from "./doctor.js";
+import { templateNames } from "./templates.js";
+import { naturalLanguageToTemplate } from "./nl.js";
+import { scaffold } from "./scaffold.js";
+import { parseArgs } from "node:util";
+//#region src/cli.ts
+/**
+* Forge CLI dispatch — `mindees <command> [args]`.
+*
+* `runCli` is a pure function of (argv, context) → exit code, writing structured
+* output through an injected {@link Writer}. All side-effecting capabilities
+* (filesystem, env probe) are injected via {@link CliContext}, so the entire CLI
+* is deterministically testable; the thin `bin` entrypoint wires real adapters.
+*
+* @module
+*/
+const HELP = `mindees — the MindeesNative CLI (Forge)
+
+Usage: mindees <command> [options]
+
+Commands:
+  create <name>     Scaffold a new app   (--template <name>, --force)
+  build             Type-check + compile the project   (--out-dir <dir>)
+  dev               Build and rebuild on change (developer preview)
+  doctor            Diagnose your environment
+  info              Show CLI + environment info
+  ai explain <err>  Explain an error with AI   (needs MINDEES_AI_* env)
+  help              Show this help
+
+Run \`mindees create --help\` style flags inline. Templates: ${templateNames().join(", ")}.`;
+const CREATE_HELP = `Usage: mindees create <name-or-path> [options]
+
+Options:
+  -t, --template <name>  Template to scaffold (${templateNames().join(", ")})
+  -p, --prompt <text>    Pick a template from a short prompt
+      --force            Overwrite a non-empty target directory
+  -h, --help             Show this help`;
+function out(write, text) {
+	write({
+		stream: "out",
+		text
+	});
+}
+function err(write, text) {
+	write({
+		stream: "err",
+		text
+	});
+}
+/**
+* Run the CLI. Returns a {@link CommandResult} with the process exit code.
+* Never throws for expected failures — it reports them and returns non-zero.
+*/
+function runCli(argv, ctx) {
+	const [command, ...rest] = argv;
+	if (!command || command === "help" || command === "--help" || command === "-h") {
+		out(ctx.write, HELP);
+		return { exitCode: 0 };
+	}
+	if (command === "--version" || command === "-v" || command === "version") {
+		out(ctx.write, ctx.version);
+		return { exitCode: 0 };
+	}
+	switch (command) {
+		case "create": return cmdCreate(rest, ctx);
+		case "build": return cmdBuild(rest, ctx);
+		case "dev": return cmdDev(ctx);
+		case "doctor": return cmdDoctor(ctx);
+		case "info": return cmdInfo(ctx);
+		default:
+			err(ctx.write, `Unknown command "${command}". Run \`mindees help\`.`);
+			return { exitCode: 1 };
+	}
+}
+/**
+* The async CLI entry. Handles the model-calling `ai` command (which is asynchronous) and
+* delegates every synchronous command to {@link runCli}. The `bin` calls this; tests can call
+* either (sync commands stay testable through `runCli`).
+*/
+function runCliAsync(argv, ctx) {
+	const [command, ...rest] = argv;
+	if (command === "ai") return runAiCommand(rest, {
+		write: ctx.write,
+		...ctx.aiBackend ? { backend: ctx.aiBackend } : {}
+	});
+	return Promise.resolve(runCli(argv, ctx));
+}
+function cmdCreate(args, ctx) {
+	const { values, positionals } = parseArgs({
+		args: [...args],
+		allowPositionals: true,
+		strict: false,
+		options: {
+			help: {
+				type: "boolean",
+				short: "h"
+			},
+			template: {
+				type: "string",
+				short: "t"
+			},
+			force: { type: "boolean" },
+			prompt: {
+				type: "string",
+				short: "p"
+			}
+		}
+	});
+	if (values.help === true || positionals[0] === "help") {
+		out(ctx.write, CREATE_HELP);
+		return { exitCode: 0 };
+	}
+	const name = positionals[0];
+	if (!name) {
+		err(ctx.write, "create: missing app name or target path. Usage: mindees create <name-or-path>");
+		return { exitCode: 1 };
+	}
+	const explicitTemplate = typeof values.template === "string" && values.template.length > 0 ? values.template : void 0;
+	let template = explicitTemplate ?? "blank";
+	if (explicitTemplate === void 0 && typeof values.prompt === "string" && values.prompt.length > 0) {
+		const picked = naturalLanguageToTemplate(values.prompt);
+		template = picked.template;
+		out(ctx.write, `Interpreted prompt → "${picked.template}" template (${picked.reason}).`);
+	}
+	const target = resolveCreateTarget(name, ctx.cwd);
+	if (!target.ok) {
+		err(ctx.write, target.error);
+		return { exitCode: 1 };
+	}
+	const result = scaffold(ctx.fs, {
+		appName: target.packageName,
+		targetDir: target.targetDir,
+		template,
+		force: values.force === true
+	});
+	if (!result.ok) {
+		err(ctx.write, result.error ?? "create failed");
+		return { exitCode: 1 };
+	}
+	out(ctx.write, `Created "${target.packageName}" from the ${result.template} template (${result.written.length} files).`);
+	out(ctx.write, `Next: cd ${quoteShellPath(target.displayDir)} && pnpm install && mindees dev`);
+	return { exitCode: 0 };
+}
+function cmdBuild(args, ctx) {
+	const { values } = parseArgs({
+		args: [...args],
+		allowPositionals: true,
+		strict: false,
+		options: {
+			"out-dir": { type: "string" },
+			"no-source-map": { type: "boolean" }
+		}
+	});
+	const result = buildProject(ctx.fs, {
+		root: ctx.cwd,
+		outDir: typeof values["out-dir"] === "string" ? values["out-dir"] : `${ctx.cwd}/dist`,
+		sourceMap: values["no-source-map"] !== true
+	});
+	for (const d of result.diagnostics) {
+		const where = d.file ? `${d.file}${d.position ? `:${d.position.line}` : ""}: ` : "";
+		err(ctx.write, `${d.severity} ${d.code} ${where}${d.message}`);
+	}
+	if (!result.ok) {
+		err(ctx.write, "Build failed: fix the type errors above.");
+		return { exitCode: 1 };
+	}
+	out(ctx.write, `Built ${result.compiled.length} module(s); flattened ${result.stats.flattenedNodes}/${result.stats.totalElements} elements.`);
+	return { exitCode: 0 };
+}
+function cmdDev(ctx) {
+	out(ctx.write, "mindees dev — developer preview.");
+	out(ctx.write, "The rebuild-on-change orchestrator is available via startDev(); the");
+	out(ctx.write, "HTTP/HMR transport is being finalized. Use `mindees build` for now.");
+	return { exitCode: 0 };
+}
+function cmdDoctor(ctx) {
+	const checks = runDoctor(ctx.env);
+	for (const line of renderDoctor(checks)) out(ctx.write, line);
+	return { exitCode: doctorSummary(checks) === "fail" ? 1 : 0 };
+}
+function cmdInfo(ctx) {
+	out(ctx.write, `mindees CLI ${ctx.version}`);
+	out(ctx.write, `Node ${ctx.env.nodeVersion}`);
+	out(ctx.write, `Package manager: ${ctx.env.packageManager ? `${ctx.env.packageManager.name} ${ctx.env.packageManager.version}` : "none"}`);
+	out(ctx.write, `Templates: ${templateNames().join(", ")}`);
+	return { exitCode: 0 };
+}
+//#endregion
+export { runCli, runCliAsync };
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["/**\n * Forge CLI dispatch — `mindees <command> [args]`.\n *\n * `runCli` is a pure function of (argv, context) → exit code, writing structured\n * output through an injected {@link Writer}. All side-effecting capabilities\n * (filesystem, env probe) are injected via {@link CliContext}, so the entire CLI\n * is deterministically testable; the thin `bin` entrypoint wires real adapters.\n *\n * @module\n */\n\nimport { parseArgs } from 'node:util'\nimport type { AiBackend } from '@mindees/ai'\nimport { runAiCommand } from './ai'\nimport { buildProject } from './build'\nimport { quoteShellPath, resolveCreateTarget } from './create-target'\nimport { doctorSummary, renderDoctor, runDoctor } from './doctor'\nimport type { FileSystem } from './fs'\nimport { naturalLanguageToTemplate } from './nl'\nimport { scaffold } from './scaffold'\nimport { DEFAULT_TEMPLATE, templateNames } from './templates'\nimport type { CommandResult, EnvProbe, Writer } from './types'\n\n/** Everything the CLI needs from the outside world (injected for testability). */\nexport interface CliContext {\n  fs: FileSystem\n  env: EnvProbe\n  /** Working directory (where `create` writes, what `build` reads). */\n  cwd: string\n  /** CLI version string (from package metadata). */\n  version: string\n  /** Output sink. */\n  write: Writer\n  /** AI backend for `ai` commands (wired from `MINDEES_AI_*` env in `bin`). */\n  aiBackend?: AiBackend\n}\n\nconst HELP = `mindees — the MindeesNative CLI (Forge)\n\nUsage: mindees <command> [options]\n\nCommands:\n  create <name>     Scaffold a new app   (--template <name>, --force)\n  build             Type-check + compile the project   (--out-dir <dir>)\n  dev               Build and rebuild on change (developer preview)\n  doctor            Diagnose your environment\n  info              Show CLI + environment info\n  ai explain <err>  Explain an error with AI   (needs MINDEES_AI_* env)\n  help              Show this help\n\nRun \\`mindees create --help\\` style flags inline. Templates: ${templateNames().join(', ')}.`\n\nconst CREATE_HELP = `Usage: mindees create <name-or-path> [options]\n\nOptions:\n  -t, --template <name>  Template to scaffold (${templateNames().join(', ')})\n  -p, --prompt <text>    Pick a template from a short prompt\n      --force            Overwrite a non-empty target directory\n  -h, --help             Show this help`\n\nfunction out(write: Writer, text: string): void {\n  write({ stream: 'out', text })\n}\nfunction err(write: Writer, text: string): void {\n  write({ stream: 'err', text })\n}\n\n/**\n * Run the CLI. Returns a {@link CommandResult} with the process exit code.\n * Never throws for expected failures — it reports them and returns non-zero.\n */\nexport function runCli(argv: readonly string[], ctx: CliContext): CommandResult {\n  const [command, ...rest] = argv\n\n  if (!command || command === 'help' || command === '--help' || command === '-h') {\n    out(ctx.write, HELP)\n    return { exitCode: 0 }\n  }\n\n  if (command === '--version' || command === '-v' || command === 'version') {\n    out(ctx.write, ctx.version)\n    return { exitCode: 0 }\n  }\n\n  switch (command) {\n    case 'create':\n      return cmdCreate(rest, ctx)\n    case 'build':\n      return cmdBuild(rest, ctx)\n    case 'dev':\n      return cmdDev(ctx)\n    case 'doctor':\n      return cmdDoctor(ctx)\n    case 'info':\n      return cmdInfo(ctx)\n    default:\n      err(ctx.write, `Unknown command \"${command}\". Run \\`mindees help\\`.`)\n      return { exitCode: 1 }\n  }\n}\n\n/**\n * The async CLI entry. Handles the model-calling `ai` command (which is asynchronous) and\n * delegates every synchronous command to {@link runCli}. The `bin` calls this; tests can call\n * either (sync commands stay testable through `runCli`).\n */\nexport function runCliAsync(argv: readonly string[], ctx: CliContext): Promise<CommandResult> {\n  const [command, ...rest] = argv\n  if (command === 'ai') {\n    return runAiCommand(rest, {\n      write: ctx.write,\n      ...(ctx.aiBackend ? { backend: ctx.aiBackend } : {}),\n    })\n  }\n  return Promise.resolve(runCli(argv, ctx))\n}\n\nfunction cmdCreate(args: readonly string[], ctx: CliContext): CommandResult {\n  const { values, positionals } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: false,\n    options: {\n      help: { type: 'boolean', short: 'h' },\n      template: { type: 'string', short: 't' },\n      force: { type: 'boolean' },\n      prompt: { type: 'string', short: 'p' },\n    },\n  })\n\n  if (values.help === true || positionals[0] === 'help') {\n    out(ctx.write, CREATE_HELP)\n    return { exitCode: 0 }\n  }\n\n  const name = positionals[0]\n  if (!name) {\n    err(ctx.write, 'create: missing app name or target path. Usage: mindees create <name-or-path>')\n    return { exitCode: 1 }\n  }\n\n  // NL → template: `--prompt \"a counter app\"` picks a template deterministically\n  // (offline). Real AI generation arrives with Synapse in Phase 10; until then\n  // this is an honest keyword-based mapping that never blocks `create`. An\n  // explicit `--template` always wins; the prompt only resolves a template when\n  // the caller didn't choose one (mirrors `create-mindees`'s runCreate so both\n  // entrypoints agree on precedence).\n  // Treat a present-but-empty `--template \"\"` as \"not chosen\" (defer to prompt/default),\n  // matching create-mindees's runCreate so both entrypoints agree on precedence.\n  const explicitTemplate =\n    typeof values.template === 'string' && values.template.length > 0 ? values.template : undefined\n  let template = explicitTemplate ?? DEFAULT_TEMPLATE\n  if (\n    explicitTemplate === undefined &&\n    typeof values.prompt === 'string' &&\n    values.prompt.length > 0\n  ) {\n    const picked = naturalLanguageToTemplate(values.prompt)\n    template = picked.template\n    out(ctx.write, `Interpreted prompt → \"${picked.template}\" template (${picked.reason}).`)\n  }\n\n  const target = resolveCreateTarget(name, ctx.cwd)\n  if (!target.ok) {\n    err(ctx.write, target.error)\n    return { exitCode: 1 }\n  }\n\n  const result = scaffold(ctx.fs, {\n    appName: target.packageName,\n    targetDir: target.targetDir,\n    template,\n    force: values.force === true,\n  })\n\n  if (!result.ok) {\n    err(ctx.write, result.error ?? 'create failed')\n    return { exitCode: 1 }\n  }\n\n  out(\n    ctx.write,\n    `Created \"${target.packageName}\" from the ${result.template} template (${result.written.length} files).`,\n  )\n  out(ctx.write, `Next: cd ${quoteShellPath(target.displayDir)} && pnpm install && mindees dev`)\n  return { exitCode: 0 }\n}\n\nfunction cmdBuild(args: readonly string[], ctx: CliContext): CommandResult {\n  const { values } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: false,\n    options: { 'out-dir': { type: 'string' }, 'no-source-map': { type: 'boolean' } },\n  })\n\n  const result = buildProject(ctx.fs, {\n    root: ctx.cwd,\n    outDir: typeof values['out-dir'] === 'string' ? values['out-dir'] : `${ctx.cwd}/dist`,\n    sourceMap: values['no-source-map'] !== true,\n  })\n\n  for (const d of result.diagnostics) {\n    const where = d.file ? `${d.file}${d.position ? `:${d.position.line}` : ''}: ` : ''\n    err(ctx.write, `${d.severity} ${d.code} ${where}${d.message}`)\n  }\n\n  if (!result.ok) {\n    err(ctx.write, 'Build failed: fix the type errors above.')\n    return { exitCode: 1 }\n  }\n  out(\n    ctx.write,\n    `Built ${result.compiled.length} module(s); flattened ${result.stats.flattenedNodes}/${result.stats.totalElements} elements.`,\n  )\n  return { exitCode: 0 }\n}\n\nfunction cmdDev(ctx: CliContext): CommandResult {\n  // The dev server transport (HTTP + HMR socket) is a developer-preview layer in\n  // `bin`. The CLI command here reports how to use it; the tested rebuild\n  // orchestrator lives in `dev.ts` (`startDev`).\n  out(ctx.write, 'mindees dev — developer preview.')\n  out(ctx.write, 'The rebuild-on-change orchestrator is available via startDev(); the')\n  out(ctx.write, 'HTTP/HMR transport is being finalized. Use `mindees build` for now.')\n  return { exitCode: 0 }\n}\n\nfunction cmdDoctor(ctx: CliContext): CommandResult {\n  const checks = runDoctor(ctx.env)\n  for (const line of renderDoctor(checks)) out(ctx.write, line)\n  const summary = doctorSummary(checks)\n  return { exitCode: summary === 'fail' ? 1 : 0 }\n}\n\nfunction cmdInfo(ctx: CliContext): CommandResult {\n  out(ctx.write, `mindees CLI ${ctx.version}`)\n  out(ctx.write, `Node ${ctx.env.nodeVersion}`)\n  out(\n    ctx.write,\n    `Package manager: ${ctx.env.packageManager ? `${ctx.env.packageManager.name} ${ctx.env.packageManager.version}` : 'none'}`,\n  )\n  out(ctx.write, `Templates: ${templateNames().join(', ')}`)\n  return { exitCode: 0 }\n}\n"],"mappings":"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"}

package/dist/create-target.d.ts

@@ -0,0 +1,36 @@
+//#region src/create-target.d.ts
+/** Resolved create target metadata shared by `mindees create` and `create-mindees`. */
+interface CreateTarget {
+  /** Raw user input after trimming. */
+  input: string;
+  /** Target directory with POSIX separators and normalized `.` / `..` segments. */
+  targetDir: string;
+  /** npm-safe package name derived from the final path segment. */
+  packageName: string;
+  /** Directory string to show in follow-up `cd` guidance. */
+  displayDir: string;
+}
+/** Outcome of create target resolution. */
+type CreateTargetResult = ({
+  ok: true;
+} & CreateTarget) | {
+  ok: false;
+  error: string;
+};
+/**
+ * Quote a path for the `cd <path> && ...` command hints printed by create commands.
+ * Uses POSIX **single quotes**: everything inside is literal, so a directory name
+ * containing `$(...)`, backticks, `$VAR`, or `\` cannot be expanded/executed when the
+ * hint is pasted into a shell (double quotes would still expand those). An embedded
+ * single quote is closed, escaped, and reopened (`'\''`).
+ */
+declare function quoteShellPath(path: string): string;
+/**
+ * Resolve a `create` positional into a real target directory plus an npm-safe
+ * package name. Accepts simple names, relative paths, and absolute Windows/POSIX
+ * paths without letting the package name inherit path separators.
+ */
+declare function resolveCreateTarget(input: string, cwd?: string): CreateTargetResult;
+//#endregion
+export { CreateTarget, CreateTargetResult, quoteShellPath, resolveCreateTarget };
+//# sourceMappingURL=create-target.d.ts.map

package/dist/create-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-target.d.ts","names":[],"sources":["../src/create-target.ts"],"mappings":";;UACiB,YAAA;EAAY;EAE3B,KAAA;EAF2B;EAI3B,SAAA;EAAA;EAEA,WAAA;EAEA;EAAA,UAAA;AAAA;AAIF;AAAA,KAAY,kBAAA;EACL,EAAA;AAAA,IAAa,YAAY;EAE1B,EAAA;EACA,KAAA;AAAA;;;AAAK;AA2EX;;;;iBAAgB,cAAA,CAAe,IAAY;AAS3C;;;;;AAAA,iBAAgB,mBAAA,CAAoB,KAAA,UAAe,GAAA,YAAY,kBAAkB"}

package/dist/create-target.js

@@ -0,0 +1,90 @@
+//#region src/create-target.ts
+const WINDOWS_DRIVE_ROOT = /^([a-zA-Z]:)\//;
+function toPosixPath(path) {
+	return path.replace(/\\/g, "/");
+}
+function hasAbsoluteRoot(path) {
+	return path.startsWith("/") || WINDOWS_DRIVE_ROOT.test(path);
+}
+function normalizeLogicalPath(path) {
+	const normalized = toPosixPath(path);
+	const drive = normalized.match(WINDOWS_DRIVE_ROOT)?.[1];
+	const root = drive ? `${drive}/` : normalized.startsWith("/") ? "/" : "";
+	const body = root ? normalized.slice(root.length) : normalized;
+	const parts = [];
+	for (const segment of body.split("/")) {
+		if (!segment || segment === ".") continue;
+		if (segment === "..") {
+			const previous = parts.at(-1);
+			if (previous && previous !== "..") parts.pop();
+			else if (!root) parts.push(segment);
+			continue;
+		}
+		parts.push(segment);
+	}
+	const suffix = parts.join("/");
+	if (root) return suffix ? `${root}${suffix}` : root;
+	return suffix || ".";
+}
+function pathBasename(path) {
+	const normalized = toPosixPath(path).replace(/\/+$/, "");
+	if (/^[a-zA-Z]:$/.test(normalized)) return "";
+	return normalized.split("/").filter(Boolean).at(-1) ?? "";
+}
+function isPathLike(input) {
+	const normalized = toPosixPath(input);
+	return normalized.includes("/") || normalized === "." || normalized === ".." || normalized.startsWith("./") || normalized.startsWith("../") || hasAbsoluteRoot(normalized);
+}
+function sanitizePackageName(rawName) {
+	return rawName.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 214).replace(/-+$/g, "");
+}
+/**
+* Quote a path for the `cd <path> && ...` command hints printed by create commands.
+* Uses POSIX **single quotes**: everything inside is literal, so a directory name
+* containing `$(...)`, backticks, `$VAR`, or `\` cannot be expanded/executed when the
+* hint is pasted into a shell (double quotes would still expand those). An embedded
+* single quote is closed, escaped, and reopened (`'\''`).
+*/
+function quoteShellPath(path) {
+	return `'${path.replace(/'/g, "'\\''")}'`;
+}
+/**
+* Resolve a `create` positional into a real target directory plus an npm-safe
+* package name. Accepts simple names, relative paths, and absolute Windows/POSIX
+* paths without letting the package name inherit path separators.
+*/
+function resolveCreateTarget(input, cwd = ".") {
+	const trimmed = input.trim();
+	if (!trimmed) return {
+		ok: false,
+		error: "create: missing app name or target path."
+	};
+	if (toPosixPath(trimmed).startsWith("//")) return {
+		ok: false,
+		error: `UNC paths are not supported: "${input}". Use a drive-letter or relative path.`
+	};
+	const basename = pathBasename(trimmed);
+	if (!basename || basename === "." || basename === "..") return {
+		ok: false,
+		error: `Could not derive a package name from "${input}".`
+	};
+	const packageName = sanitizePackageName(basename);
+	if (!packageName) return {
+		ok: false,
+		error: `Could not derive a valid npm package name from "${basename}". Use a name with letters or numbers.`
+	};
+	const targetInput = toPosixPath(trimmed);
+	const cwdPath = normalizeLogicalPath(cwd || ".");
+	const targetDir = hasAbsoluteRoot(targetInput) ? normalizeLogicalPath(targetInput) : normalizeLogicalPath(cwdPath === "." ? targetInput : `${cwdPath}/${targetInput}`);
+	return {
+		ok: true,
+		input: trimmed,
+		targetDir,
+		packageName,
+		displayDir: isPathLike(trimmed) ? targetDir : trimmed
+	};
+}
+//#endregion
+export { quoteShellPath, resolveCreateTarget };
+
+//# sourceMappingURL=create-target.js.map

package/dist/create-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-target.js","names":[],"sources":["../src/create-target.ts"],"sourcesContent":["/** Resolved create target metadata shared by `mindees create` and `create-mindees`. */\nexport interface CreateTarget {\n  /** Raw user input after trimming. */\n  input: string\n  /** Target directory with POSIX separators and normalized `.` / `..` segments. */\n  targetDir: string\n  /** npm-safe package name derived from the final path segment. */\n  packageName: string\n  /** Directory string to show in follow-up `cd` guidance. */\n  displayDir: string\n}\n\n/** Outcome of create target resolution. */\nexport type CreateTargetResult =\n  | ({ ok: true } & CreateTarget)\n  | {\n      ok: false\n      error: string\n    }\n\nconst WINDOWS_DRIVE_ROOT = /^([a-zA-Z]:)\\//\n\nfunction toPosixPath(path: string): string {\n  return path.replace(/\\\\/g, '/')\n}\n\nfunction hasAbsoluteRoot(path: string): boolean {\n  return path.startsWith('/') || WINDOWS_DRIVE_ROOT.test(path)\n}\n\nfunction normalizeLogicalPath(path: string): string {\n  const normalized = toPosixPath(path)\n  const drive = normalized.match(WINDOWS_DRIVE_ROOT)?.[1]\n  const root = drive ? `${drive}/` : normalized.startsWith('/') ? '/' : ''\n  const body = root ? normalized.slice(root.length) : normalized\n  const parts: string[] = []\n\n  for (const segment of body.split('/')) {\n    if (!segment || segment === '.') continue\n    if (segment === '..') {\n      const previous = parts.at(-1)\n      if (previous && previous !== '..') {\n        parts.pop()\n      } else if (!root) {\n        parts.push(segment)\n      }\n      continue\n    }\n    parts.push(segment)\n  }\n\n  const suffix = parts.join('/')\n  if (root) return suffix ? `${root}${suffix}` : root\n  return suffix || '.'\n}\n\nfunction pathBasename(path: string): string {\n  const normalized = toPosixPath(path).replace(/\\/+$/, '')\n  if (/^[a-zA-Z]:$/.test(normalized)) return ''\n  const parts = normalized.split('/').filter(Boolean)\n  return parts.at(-1) ?? ''\n}\n\nfunction isPathLike(input: string): boolean {\n  const normalized = toPosixPath(input)\n  return (\n    normalized.includes('/') ||\n    normalized === '.' ||\n    normalized === '..' ||\n    normalized.startsWith('./') ||\n    normalized.startsWith('../') ||\n    hasAbsoluteRoot(normalized)\n  )\n}\n\nfunction sanitizePackageName(rawName: string): string {\n  return rawName\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 214)\n    .replace(/-+$/g, '')\n}\n\n/**\n * Quote a path for the `cd <path> && ...` command hints printed by create commands.\n * Uses POSIX **single quotes**: everything inside is literal, so a directory name\n * containing `$(...)`, backticks, `$VAR`, or `\\` cannot be expanded/executed when the\n * hint is pasted into a shell (double quotes would still expand those). An embedded\n * single quote is closed, escaped, and reopened (`'\\''`).\n */\nexport function quoteShellPath(path: string): string {\n  return `'${path.replace(/'/g, \"'\\\\''\")}'`\n}\n\n/**\n * Resolve a `create` positional into a real target directory plus an npm-safe\n * package name. Accepts simple names, relative paths, and absolute Windows/POSIX\n * paths without letting the package name inherit path separators.\n */\nexport function resolveCreateTarget(input: string, cwd = '.'): CreateTargetResult {\n  const trimmed = input.trim()\n  if (!trimmed) {\n    return { ok: false, error: 'create: missing app name or target path.' }\n  }\n\n  // Reject UNC paths (\\\\server\\share) up front: normalizeLogicalPath would collapse\n  // the `//` root to a single `/`, silently retargeting to the wrong location.\n  if (toPosixPath(trimmed).startsWith('//')) {\n    return {\n      ok: false,\n      error: `UNC paths are not supported: \"${input}\". Use a drive-letter or relative path.`,\n    }\n  }\n\n  const basename = pathBasename(trimmed)\n  if (!basename || basename === '.' || basename === '..') {\n    return { ok: false, error: `Could not derive a package name from \"${input}\".` }\n  }\n\n  const packageName = sanitizePackageName(basename)\n  if (!packageName) {\n    return {\n      ok: false,\n      error: `Could not derive a valid npm package name from \"${basename}\". Use a name with letters or numbers.`,\n    }\n  }\n\n  const targetInput = toPosixPath(trimmed)\n  const cwdPath = normalizeLogicalPath(cwd || '.')\n  const targetDir = hasAbsoluteRoot(targetInput)\n    ? normalizeLogicalPath(targetInput)\n    : normalizeLogicalPath(cwdPath === '.' ? targetInput : `${cwdPath}/${targetInput}`)\n\n  return {\n    ok: true,\n    input: trimmed,\n    targetDir,\n    packageName,\n    displayDir: isPathLike(trimmed) ? targetDir : trimmed,\n  }\n}\n"],"mappings":";AAoBA,MAAM,qBAAqB;AAE3B,SAAS,YAAY,MAAsB;CACzC,OAAO,KAAK,QAAQ,OAAO,GAAG;AAChC;AAEA,SAAS,gBAAgB,MAAuB;CAC9C,OAAO,KAAK,WAAW,GAAG,KAAK,mBAAmB,KAAK,IAAI;AAC7D;AAEA,SAAS,qBAAqB,MAAsB;CAClD,MAAM,aAAa,YAAY,IAAI;CACnC,MAAM,QAAQ,WAAW,MAAM,kBAAkB,IAAI;CACrD,MAAM,OAAO,QAAQ,GAAG,MAAM,KAAK,WAAW,WAAW,GAAG,IAAI,MAAM;CACtE,MAAM,OAAO,OAAO,WAAW,MAAM,KAAK,MAAM,IAAI;CACpD,MAAM,QAAkB,CAAC;CAEzB,KAAK,MAAM,WAAW,KAAK,MAAM,GAAG,GAAG;EACrC,IAAI,CAAC,WAAW,YAAY,KAAK;EACjC,IAAI,YAAY,MAAM;GACpB,MAAM,WAAW,MAAM,GAAG,EAAE;GAC5B,IAAI,YAAY,aAAa,MAC3B,MAAM,IAAI;QACL,IAAI,CAAC,MACV,MAAM,KAAK,OAAO;GAEpB;EACF;EACA,MAAM,KAAK,OAAO;CACpB;CAEA,MAAM,SAAS,MAAM,KAAK,GAAG;CAC7B,IAAI,MAAM,OAAO,SAAS,GAAG,OAAO,WAAW;CAC/C,OAAO,UAAU;AACnB;AAEA,SAAS,aAAa,MAAsB;CAC1C,MAAM,aAAa,YAAY,IAAI,EAAE,QAAQ,QAAQ,EAAE;CACvD,IAAI,cAAc,KAAK,UAAU,GAAG,OAAO;CAE3C,OADc,WAAW,MAAM,GAAG,EAAE,OAAO,OAChC,EAAE,GAAG,EAAE,KAAK;AACzB;AAEA,SAAS,WAAW,OAAwB;CAC1C,MAAM,aAAa,YAAY,KAAK;CACpC,OACE,WAAW,SAAS,GAAG,KACvB,eAAe,OACf,eAAe,QACf,WAAW,WAAW,IAAI,KAC1B,WAAW,WAAW,KAAK,KAC3B,gBAAgB,UAAU;AAE9B;AAEA,SAAS,oBAAoB,SAAyB;CACpD,OAAO,QACJ,KAAK,EACL,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE,EACtB,MAAM,GAAG,GAAG,EACZ,QAAQ,QAAQ,EAAE;AACvB;;;;;;;;AASA,SAAgB,eAAe,MAAsB;CACnD,OAAO,IAAI,KAAK,QAAQ,MAAM,OAAO,EAAE;AACzC;;;;;;AAOA,SAAgB,oBAAoB,OAAe,MAAM,KAAyB;CAChF,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,CAAC,SACH,OAAO;EAAE,IAAI;EAAO,OAAO;CAA2C;CAKxE,IAAI,YAAY,OAAO,EAAE,WAAW,IAAI,GACtC,OAAO;EACL,IAAI;EACJ,OAAO,iCAAiC,MAAM;CAChD;CAGF,MAAM,WAAW,aAAa,OAAO;CACrC,IAAI,CAAC,YAAY,aAAa,OAAO,aAAa,MAChD,OAAO;EAAE,IAAI;EAAO,OAAO,yCAAyC,MAAM;CAAI;CAGhF,MAAM,cAAc,oBAAoB,QAAQ;CAChD,IAAI,CAAC,aACH,OAAO;EACL,IAAI;EACJ,OAAO,mDAAmD,SAAS;CACrE;CAGF,MAAM,cAAc,YAAY,OAAO;CACvC,MAAM,UAAU,qBAAqB,OAAO,GAAG;CAC/C,MAAM,YAAY,gBAAgB,WAAW,IACzC,qBAAqB,WAAW,IAChC,qBAAqB,YAAY,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa;CAEpF,OAAO;EACL,IAAI;EACJ,OAAO;EACP;EACA;EACA,YAAY,WAAW,OAAO,IAAI,YAAY;CAChD;AACF"}

package/dist/dev.d.ts

@@ -0,0 +1,32 @@
+import { FileSystem } from "./fs.js";
+import { BuildOptions, BuildResult } from "./build.js";
+
+//#region src/dev.d.ts
+/** A file watcher: registers a listener, returns an unsubscribe function. */
+interface Watcher {
+  /** Subscribe to change events; the returned function stops watching. */
+  onChange(listener: (changedPath: string) => void): () => void;
+}
+/** A running dev session. */
+interface DevSession {
+  /** Number of builds performed (1 initial + one per change). */
+  readonly buildCount: number;
+  /** The most recent build result. */
+  readonly lastResult: BuildResult;
+  /** Stop watching and end the session. */
+  stop(): void;
+}
+/** Options for {@link startDev}. */
+interface DevOptions extends BuildOptions {
+  /** Called after every (re)build, e.g. to push HMR updates. */
+  onRebuild?: (result: BuildResult, changedPath: string | null) => void;
+}
+/**
+ * Start a dev session: build once immediately, then rebuild on each watcher
+ * change. Returns a {@link DevSession} exposing the build count + last result
+ * and a `stop()` that unsubscribes.
+ */
+declare function startDev(fs: FileSystem, watcher: Watcher, options?: DevOptions): DevSession;
+//#endregion
+export { DevOptions, DevSession, Watcher, startDev };
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","names":[],"sources":["../src/dev.ts"],"mappings":";;;;;UAmBiB,OAAA;EAUN;EART,QAAA,CAAS,QAAA,GAAW,WAAA;AAAA;;UAIL,UAAA;EAUA;EAAA,SARN,UAAA;;WAEA,UAAA,EAAY,WAAW;EAME;EAJlC,IAAA;AAAA;;UAIe,UAAA,SAAmB,YAAY;EAEc;EAA5D,SAAA,IAAa,MAAA,EAAQ,WAAA,EAAa,WAAA;AAAA;;;;;;iBAQpB,QAAA,CAAS,EAAA,EAAI,UAAA,EAAY,OAAA,EAAS,OAAA,EAAS,OAAA,GAAS,UAAA,GAAkB,UAAA"}

package/dist/dev.js

@@ -0,0 +1,64 @@
+import { buildProject } from "./build.js";
+//#region src/dev.ts
+/**
+* `mindees dev` — the dev orchestrator.
+*
+* The orchestrator is the deterministic, tested core: it builds once, then
+* rebuilds whenever a {@link Watcher} reports a change, tracking rebuild count
+* and the last result. It is decoupled from any real file watcher or HTTP/HMR
+* transport (those are injected), so it can be unit-tested with a fake watcher.
+*
+* The live HTTP server + browser HMR socket is a thin developer-preview
+* transport layer (in `bin`); the rebuild-on-change behavior proven here is the
+* substance.
+*
+* @module
+*/
+/**
+* Start a dev session: build once immediately, then rebuild on each watcher
+* change. Returns a {@link DevSession} exposing the build count + last result
+* and a `stop()` that unsubscribes.
+*/
+function startDev(fs, watcher, options = {}) {
+	const { onRebuild, ...buildOptions } = options;
+	let buildCount = 0;
+	let lastResult;
+	const rebuild = (changedPath) => {
+		try {
+			lastResult = buildProject(fs, buildOptions);
+		} catch (e) {
+			lastResult = {
+				ok: false,
+				compiled: [],
+				diagnostics: [{
+					severity: "error",
+					code: "MDC_DEV",
+					message: e instanceof Error ? e.message : String(e)
+				}],
+				stats: {
+					flattenedNodes: 0,
+					totalElements: 0
+				}
+			};
+		}
+		buildCount++;
+		onRebuild?.(lastResult, changedPath);
+	};
+	rebuild(null);
+	const unsubscribe = watcher.onChange((path) => rebuild(path));
+	return {
+		get buildCount() {
+			return buildCount;
+		},
+		get lastResult() {
+			return lastResult;
+		},
+		stop() {
+			unsubscribe();
+		}
+	};
+}
+//#endregion
+export { startDev };
+
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","names":[],"sources":["../src/dev.ts"],"sourcesContent":["/**\n * `mindees dev` — the dev orchestrator.\n *\n * The orchestrator is the deterministic, tested core: it builds once, then\n * rebuilds whenever a {@link Watcher} reports a change, tracking rebuild count\n * and the last result. It is decoupled from any real file watcher or HTTP/HMR\n * transport (those are injected), so it can be unit-tested with a fake watcher.\n *\n * The live HTTP server + browser HMR socket is a thin developer-preview\n * transport layer (in `bin`); the rebuild-on-change behavior proven here is the\n * substance.\n *\n * @module\n */\n\nimport { type BuildOptions, type BuildResult, buildProject } from './build'\nimport type { FileSystem } from './fs'\n\n/** A file watcher: registers a listener, returns an unsubscribe function. */\nexport interface Watcher {\n  /** Subscribe to change events; the returned function stops watching. */\n  onChange(listener: (changedPath: string) => void): () => void\n}\n\n/** A running dev session. */\nexport interface DevSession {\n  /** Number of builds performed (1 initial + one per change). */\n  readonly buildCount: number\n  /** The most recent build result. */\n  readonly lastResult: BuildResult\n  /** Stop watching and end the session. */\n  stop(): void\n}\n\n/** Options for {@link startDev}. */\nexport interface DevOptions extends BuildOptions {\n  /** Called after every (re)build, e.g. to push HMR updates. */\n  onRebuild?: (result: BuildResult, changedPath: string | null) => void\n}\n\n/**\n * Start a dev session: build once immediately, then rebuild on each watcher\n * change. Returns a {@link DevSession} exposing the build count + last result\n * and a `stop()` that unsubscribes.\n */\nexport function startDev(fs: FileSystem, watcher: Watcher, options: DevOptions = {}): DevSession {\n  const { onRebuild, ...buildOptions } = options\n\n  let buildCount = 0\n  let lastResult: BuildResult\n\n  const rebuild = (changedPath: string | null): void => {\n    try {\n      lastResult = buildProject(fs, buildOptions)\n    } catch (e) {\n      // A rebuild must never kill the session: in a long-running watch a file can\n      // be removed between readDir() and readFile() (a real FS race), making the\n      // build throw. Turn an unexpected throw into a failed result and keep\n      // watching — mirroring how `mindees build` reports expected failures as\n      // diagnostics rather than throwing.\n      lastResult = {\n        ok: false,\n        compiled: [],\n        diagnostics: [\n          {\n            severity: 'error',\n            code: 'MDC_DEV',\n            message: e instanceof Error ? e.message : String(e),\n          },\n        ],\n        stats: { flattenedNodes: 0, totalElements: 0 },\n      }\n    }\n    buildCount++\n    onRebuild?.(lastResult, changedPath)\n  }\n\n  rebuild(null) // initial build\n  const unsubscribe = watcher.onChange((path) => rebuild(path))\n\n  return {\n    get buildCount() {\n      return buildCount\n    },\n    get lastResult() {\n      return lastResult\n    },\n    stop() {\n      unsubscribe()\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,SAAS,IAAgB,SAAkB,UAAsB,CAAC,GAAe;CAC/F,MAAM,EAAE,WAAW,GAAG,iBAAiB;CAEvC,IAAI,aAAa;CACjB,IAAI;CAEJ,MAAM,WAAW,gBAAqC;EACpD,IAAI;GACF,aAAa,aAAa,IAAI,YAAY;EAC5C,SAAS,GAAG;GAMV,aAAa;IACX,IAAI;IACJ,UAAU,CAAC;IACX,aAAa,CACX;KACE,UAAU;KACV,MAAM;KACN,SAAS,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;IACpD,CACF;IACA,OAAO;KAAE,gBAAgB;KAAG,eAAe;IAAE;GAC/C;EACF;EACA;EACA,YAAY,YAAY,WAAW;CACrC;CAEA,QAAQ,IAAI;CACZ,MAAM,cAAc,QAAQ,UAAU,SAAS,QAAQ,IAAI,CAAC;CAE5D,OAAO;EACL,IAAI,aAAa;GACf,OAAO;EACT;EACA,IAAI,aAAa;GACf,OAAO;EACT;EACA,OAAO;GACL,YAAY;EACd;CACF;AACF"}

package/dist/doctor.d.ts

@@ -0,0 +1,15 @@
+import { DoctorCheck, EnvProbe } from "./types.js";
+
+//#region src/doctor.d.ts
+/**
+ * Run the environment checks against `env`. Pure + deterministic: returns the
+ * structured checks; rendering and `process` access live elsewhere.
+ */
+declare function runDoctor(env: EnvProbe): DoctorCheck[];
+/** Overall status: `fail` if any check failed, else `warn` if any warned, else `ok`. */
+declare function doctorSummary(checks: readonly DoctorCheck[]): 'ok' | 'warn' | 'fail';
+/** Render checks as human-readable lines (for the `doctor` command output). */
+declare function renderDoctor(checks: readonly DoctorCheck[]): string[];
+//#endregion
+export { doctorSummary, renderDoctor, runDoctor };
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","names":[],"sources":["../src/doctor.ts"],"mappings":";;;AA0BqD;AAqErD;;;AArEqD,iBAArC,SAAA,CAAU,GAAA,EAAK,QAAA,GAAW,WAAW;AAqEO;AAAA,iBAA5C,aAAA,CAAc,MAA8B,WAAb,WAAW;;iBAO1C,YAAA,CAAa,MAA8B,WAAb,WAAW"}

package/dist/doctor.js

@@ -0,0 +1,92 @@
+//#region src/doctor.ts
+/** Minimum supported Node.js major (matches the repo's engines floor). */
+const MIN_NODE_MAJOR = 22;
+const PNPM_EXEC_FALLBACK = "npm exec --yes --package=pnpm@11.5.0 -- pnpm";
+function parseMajor(version) {
+	const m = version.match(/^v?(\d+)\./);
+	return m?.[1] ? Number.parseInt(m[1], 10) : null;
+}
+/**
+* Run the environment checks against `env`. Pure + deterministic: returns the
+* structured checks; rendering and `process` access live elsewhere.
+*/
+function runDoctor(env) {
+	const checks = [];
+	const major = parseMajor(env.nodeVersion);
+	if (major === null) checks.push({
+		name: "Node.js",
+		status: "warn",
+		detail: `unrecognized version "${env.nodeVersion}"`,
+		fix: `Install Node.js ${MIN_NODE_MAJOR} LTS or newer.`
+	});
+	else if (major < MIN_NODE_MAJOR) checks.push({
+		name: "Node.js",
+		status: "fail",
+		detail: `${env.nodeVersion} (need >= ${MIN_NODE_MAJOR})`,
+		fix: `Upgrade to Node.js ${MIN_NODE_MAJOR} LTS or newer (see .nvmrc).`
+	});
+	else checks.push({
+		name: "Node.js",
+		status: "ok",
+		detail: env.nodeVersion
+	});
+	if (!env.packageManager) checks.push({
+		name: "Package manager",
+		status: "warn",
+		detail: "none detected",
+		fix: `Enable pnpm via Corepack: \`corepack enable\`. If Windows blocks Corepack shims, use \`${PNPM_EXEC_FALLBACK}\`.`
+	});
+	else if (env.packageManager.name !== "pnpm") checks.push({
+		name: "Package manager",
+		status: "warn",
+		detail: `${env.packageManager.name} ${env.packageManager.version}`,
+		fix: `MindeesNative uses pnpm. Enable it via Corepack: \`corepack enable\`. If Windows blocks Corepack shims, use \`${PNPM_EXEC_FALLBACK}\`.`
+	});
+	else checks.push({
+		name: "Package manager",
+		status: "ok",
+		detail: `pnpm ${env.packageManager.version}`
+	});
+	if (!env.hasPackageJson) checks.push({
+		name: "Project",
+		status: "warn",
+		detail: "no package.json in this directory",
+		fix: "Run `mindees create <name>` to scaffold a new app, or cd into a project."
+	});
+	else if (!env.hasNodeModules) checks.push({
+		name: "Dependencies",
+		status: "warn",
+		detail: "node_modules missing",
+		fix: `Install dependencies: \`pnpm install\` (or \`${PNPM_EXEC_FALLBACK} install\` if the pnpm shim is unavailable).`
+	});
+	else checks.push({
+		name: "Project",
+		status: "ok",
+		detail: "package.json + node_modules present"
+	});
+	return checks;
+}
+/** Overall status: `fail` if any check failed, else `warn` if any warned, else `ok`. */
+function doctorSummary(checks) {
+	if (checks.some((c) => c.status === "fail")) return "fail";
+	if (checks.some((c) => c.status === "warn")) return "warn";
+	return "ok";
+}
+/** Render checks as human-readable lines (for the `doctor` command output). */
+function renderDoctor(checks) {
+	const icon = {
+		ok: "✓",
+		warn: "!",
+		fail: "✗"
+	};
+	const lines = [];
+	for (const c of checks) {
+		lines.push(`${icon[c.status]} ${c.name}: ${c.detail}`);
+		if (c.fix && c.status !== "ok") lines.push(`    → ${c.fix}`);
+	}
+	return lines;
+}
+//#endregion
+export { doctorSummary, renderDoctor, runDoctor };
+
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","names":[],"sources":["../src/doctor.ts"],"sourcesContent":["/**\n * `mindees doctor` — environment diagnostics with actionable fixes.\n *\n * Directly attacks the \"cryptic error\" pain point: instead of a confusing\n * failure later, `doctor` checks the environment up front and tells you exactly\n * what to do. The check logic is pure over an injected {@link EnvProbe}, so it's\n * fully deterministic in tests; the `bin` layer supplies the real probe.\n *\n * @module\n */\n\nimport type { DoctorCheck, EnvProbe } from './types'\n\n/** Minimum supported Node.js major (matches the repo's engines floor). */\nconst MIN_NODE_MAJOR = 22\nconst PNPM_EXEC_FALLBACK = 'npm exec --yes --package=pnpm@11.5.0 -- pnpm'\n\nfunction parseMajor(version: string): number | null {\n  const m = version.match(/^v?(\\d+)\\./)\n  return m?.[1] ? Number.parseInt(m[1], 10) : null\n}\n\n/**\n * Run the environment checks against `env`. Pure + deterministic: returns the\n * structured checks; rendering and `process` access live elsewhere.\n */\nexport function runDoctor(env: EnvProbe): DoctorCheck[] {\n  const checks: DoctorCheck[] = []\n\n  // Node version.\n  const major = parseMajor(env.nodeVersion)\n  if (major === null) {\n    checks.push({\n      name: 'Node.js',\n      status: 'warn',\n      detail: `unrecognized version \"${env.nodeVersion}\"`,\n      fix: `Install Node.js ${MIN_NODE_MAJOR} LTS or newer.`,\n    })\n  } else if (major < MIN_NODE_MAJOR) {\n    checks.push({\n      name: 'Node.js',\n      status: 'fail',\n      detail: `${env.nodeVersion} (need >= ${MIN_NODE_MAJOR})`,\n      fix: `Upgrade to Node.js ${MIN_NODE_MAJOR} LTS or newer (see .nvmrc).`,\n    })\n  } else {\n    checks.push({ name: 'Node.js', status: 'ok', detail: env.nodeVersion })\n  }\n\n  // Package manager.\n  if (!env.packageManager) {\n    checks.push({\n      name: 'Package manager',\n      status: 'warn',\n      detail: 'none detected',\n      fix: `Enable pnpm via Corepack: \\`corepack enable\\`. If Windows blocks Corepack shims, use \\`${PNPM_EXEC_FALLBACK}\\`.`,\n    })\n  } else if (env.packageManager.name !== 'pnpm') {\n    checks.push({\n      name: 'Package manager',\n      status: 'warn',\n      detail: `${env.packageManager.name} ${env.packageManager.version}`,\n      fix: `MindeesNative uses pnpm. Enable it via Corepack: \\`corepack enable\\`. If Windows blocks Corepack shims, use \\`${PNPM_EXEC_FALLBACK}\\`.`,\n    })\n  } else {\n    checks.push({\n      name: 'Package manager',\n      status: 'ok',\n      detail: `pnpm ${env.packageManager.version}`,\n    })\n  }\n\n  // Project presence.\n  if (!env.hasPackageJson) {\n    checks.push({\n      name: 'Project',\n      status: 'warn',\n      detail: 'no package.json in this directory',\n      fix: 'Run `mindees create <name>` to scaffold a new app, or cd into a project.',\n    })\n  } else if (!env.hasNodeModules) {\n    checks.push({\n      name: 'Dependencies',\n      status: 'warn',\n      detail: 'node_modules missing',\n      fix: `Install dependencies: \\`pnpm install\\` (or \\`${PNPM_EXEC_FALLBACK} install\\` if the pnpm shim is unavailable).`,\n    })\n  } else {\n    checks.push({ name: 'Project', status: 'ok', detail: 'package.json + node_modules present' })\n  }\n\n  return checks\n}\n\n/** Overall status: `fail` if any check failed, else `warn` if any warned, else `ok`. */\nexport function doctorSummary(checks: readonly DoctorCheck[]): 'ok' | 'warn' | 'fail' {\n  if (checks.some((c) => c.status === 'fail')) return 'fail'\n  if (checks.some((c) => c.status === 'warn')) return 'warn'\n  return 'ok'\n}\n\n/** Render checks as human-readable lines (for the `doctor` command output). */\nexport function renderDoctor(checks: readonly DoctorCheck[]): string[] {\n  const icon = { ok: '✓', warn: '!', fail: '✗' } as const\n  const lines: string[] = []\n  for (const c of checks) {\n    lines.push(`${icon[c.status]} ${c.name}: ${c.detail}`)\n    if (c.fix && c.status !== 'ok') lines.push(`    → ${c.fix}`)\n  }\n  return lines\n}\n"],"mappings":";;AAcA,MAAM,iBAAiB;AACvB,MAAM,qBAAqB;AAE3B,SAAS,WAAW,SAAgC;CAClD,MAAM,IAAI,QAAQ,MAAM,YAAY;CACpC,OAAO,IAAI,KAAK,OAAO,SAAS,EAAE,IAAI,EAAE,IAAI;AAC9C;;;;;AAMA,SAAgB,UAAU,KAA8B;CACtD,MAAM,SAAwB,CAAC;CAG/B,MAAM,QAAQ,WAAW,IAAI,WAAW;CACxC,IAAI,UAAU,MACZ,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ,yBAAyB,IAAI,YAAY;EACjD,KAAK,mBAAmB,eAAe;CACzC,CAAC;MACI,IAAI,QAAQ,gBACjB,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ,GAAG,IAAI,YAAY,YAAY,eAAe;EACtD,KAAK,sBAAsB,eAAe;CAC5C,CAAC;MAED,OAAO,KAAK;EAAE,MAAM;EAAW,QAAQ;EAAM,QAAQ,IAAI;CAAY,CAAC;CAIxE,IAAI,CAAC,IAAI,gBACP,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,KAAK,0FAA0F,mBAAmB;CACpH,CAAC;MACI,IAAI,IAAI,eAAe,SAAS,QACrC,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ,GAAG,IAAI,eAAe,KAAK,GAAG,IAAI,eAAe;EACzD,KAAK,iHAAiH,mBAAmB;CAC3I,CAAC;MAED,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ,QAAQ,IAAI,eAAe;CACrC,CAAC;CAIH,IAAI,CAAC,IAAI,gBACP,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,KAAK;CACP,CAAC;MACI,IAAI,CAAC,IAAI,gBACd,OAAO,KAAK;EACV,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,KAAK,gDAAgD,mBAAmB;CAC1E,CAAC;MAED,OAAO,KAAK;EAAE,MAAM;EAAW,QAAQ;EAAM,QAAQ;CAAsC,CAAC;CAG9F,OAAO;AACT;;AAGA,SAAgB,cAAc,QAAwD;CACpF,IAAI,OAAO,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,OAAO;CACpD,IAAI,OAAO,MAAM,MAAM,EAAE,WAAW,MAAM,GAAG,OAAO;CACpD,OAAO;AACT;;AAGA,SAAgB,aAAa,QAA0C;CACrE,MAAM,OAAO;EAAE,IAAI;EAAK,MAAM;EAAK,MAAM;CAAI;CAC7C,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,KAAK,GAAG,KAAK,EAAE,QAAQ,GAAG,EAAE,KAAK,IAAI,EAAE,QAAQ;EACrD,IAAI,EAAE,OAAO,EAAE,WAAW,MAAM,MAAM,KAAK,SAAS,EAAE,KAAK;CAC7D;CACA,OAAO;AACT"}

package/dist/fs.d.ts

@@ -0,0 +1,28 @@
+//#region src/fs.d.ts
+/**
+ * A tiny filesystem abstraction so CLI commands are testable without touching
+ * the real disk. The `bin` layer supplies a `node:fs`-backed implementation; the
+ * core (`scaffold`, `buildProject`) takes a {@link FileSystem}.
+ *
+ * @module
+ */
+/** The minimal filesystem surface the CLI core needs. */
+interface FileSystem {
+  /** True if a file or directory exists at `path`. */
+  exists(path: string): boolean;
+  /** Read a UTF-8 file. Throws if missing. */
+  readFile(path: string): string;
+  /** Write a UTF-8 file, creating parent directories as needed. */
+  writeFile(path: string, contents: string): void;
+  /** Create a directory (and parents). No-op if it exists. */
+  mkdir(path: string): void;
+  /** List files (recursively) under `dir`, returned as POSIX-relative paths. */
+  readDir(dir: string): string[];
+}
+/** An in-memory {@link FileSystem} for tests and dry runs. */
+declare function createMemoryFileSystem(initial?: Record<string, string>): FileSystem & {
+  /** Snapshot of all written files (path → contents). */snapshot(): Record<string, string>;
+};
+//#endregion
+export { FileSystem, createMemoryFileSystem };
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","names":[],"sources":["../src/fs.ts"],"mappings":";;AASA;;;;;;;UAAiB,UAAA;EAMf;EAJA,MAAA,CAAO,IAAA;EAIiB;EAFxB,QAAA,CAAS,IAAA;EAIH;EAFN,SAAA,CAAU,IAAA,UAAc,QAAA;EAIhB;EAFR,KAAA,CAAM,IAAA;EAEa;EAAnB,OAAA,CAAQ,GAAA;AAAA;;iBAIM,sBAAA,CAAuB,OAAA,GAAS,MAAA,mBAA8B,UAAA;EAAA,uDAE5E,QAAA,IAAY,MAAA;AAAA"}