@nm-lang/cli 0.4.0 → 0.6.0

package/bin/project-create.mjs

@@ -0,0 +1,122 @@
+import * as nativeFS from "node:fs";
+import path from "node:path";
+
+export class NMProjectCreationError extends Error {
+  constructor(code, message, filePath) {
+    super(`${code}: ${message}${filePath ? ` (${filePath})` : ""}`);
+    this.name = "NMProjectCreationError";
+    this.code = code;
+    this.path = filePath;
+  }
+}
+const failure = (code, message, filePath) => new NMProjectCreationError(code, message, filePath);
+const unsafe = /[\u0000-\u001f\u007f\u202a-\u202e\u2066-\u2069]/u;
+const portableSegment = value => value && value !== "." && value !== ".." && !/[<>:"|?*\\/]/u.test(value) && !/[. ]$/u.test(value) && !/^(?:con|prn|aux|nul|com[1-9¹²³]|lpt[1-9¹²³]|conin\$|conout\$)$/iu.test(value.split(".")[0].trimEnd());
+const aliasKey = value => value.normalize("NFC").toLowerCase();
+const sameIdentity = (first, second) => Boolean(first && second && first.dev === second.dev && first.ino === second.ino && !second.isSymbolicLink());
+function inspect(fs, filePath) {
+  try { return fs.lstatSync(filePath); }
+  catch (error) { if (error.code === "ENOENT") return undefined; throw error; }
+}
+function ancestors(directory) {
+  const items = [];
+  for (let current = directory; ; current = path.dirname(current)) {
+    items.unshift(current);
+    if (path.dirname(current) === current) return items;
+  }
+}
+function checkDirectories(fs, directories, identities = new Map()) {
+  for (const directory of directories) {
+    const item = inspect(fs, directory);
+    if (item?.isSymbolicLink()) throw failure("NM-PROJECT-LINK-001", "Symbolic links and junctions are not project destinations.", directory);
+    if (item && !item.isDirectory()) throw failure("NM-PROJECT-CONFLICT-001", "A project directory is occupied by a file.", directory);
+    if (identities.has(directory) && !sameIdentity(identities.get(directory), item)) throw failure("NM-PROJECT-CONFLICT-001", "A directory changed during project creation.", directory);
+  }
+}
+function checkAlias(fs, directory) {
+  const parent = path.dirname(directory);
+  if (!inspect(fs, parent)) return;
+  const name = path.basename(directory);
+  if (fs.readdirSync(parent).some(entry => entry !== name && aliasKey(entry) === aliasKey(name))) throw failure("NM-PROJECT-PATH-001", "Destination aliases an existing path by case or Unicode normalization.", directory);
+}
+function readPlan(plan, directory) {
+  if (!plan || plan.format !== "nm-project-plan" || plan.version !== "0.1" || plan.entry !== "src/main.nm" || !Array.isArray(plan.files) || plan.files.length !== 5) throw failure("NM-PROJECT-PLAN-001", "Expected a complete N/M project plan.");
+  const expected = new Set(["nm-workspace.json", "src/main.nm", "src/helper.nm", "tests/main.test.nm", "README.md"]);
+  const files = plan.files.map(file => {
+    if (!file || typeof file.path !== "string" || typeof file.content !== "string" || unsafe.test(file.path) || !file.path.split("/").every(portableSegment) || !expected.delete(file.path)) throw failure("NM-PROJECT-PLAN-001", "Project files must have unique, portable, contained paths.");
+    const target = path.resolve(directory, file.path);
+    const relative = path.relative(directory, target);
+    if (!relative || relative.startsWith(`..${path.sep}`) || relative === ".." || path.isAbsolute(relative)) throw failure("NM-PROJECT-PATH-001", "Project file escapes its destination.", target);
+    return { path: target, content: Buffer.from(file.content, "utf8") };
+  });
+  if (expected.size) throw failure("NM-PROJECT-PLAN-001", "Project plan is incomplete.");
+  return files;
+}
+
+/**
+ * Sync Node host for the pure Core plan. It never overwrites files. A complete
+ * preflight precedes mutation; rollback removes only the files/directories this
+ * call created, with matching identities and unchanged content, without recursion.
+ * fileSystem is an injectable Node-fs-compatible adapter for host failure tests.
+ */
+export function createNMProject(destination, plan, { fileSystem: fs = nativeFS } = {}) {
+  if (typeof destination !== "string" || !destination || unsafe.test(destination) || /^[\\/]{2}[?.][\\/]/u.test(destination) || destination.replace(/\\/gu, "/").split("/").some(segment => segment === "..") || /^[a-z]:(?![\\/])/iu.test(destination)) throw failure("NM-PROJECT-PATH-001", "Expected a safe project directory.");
+  const directory = path.resolve(destination);
+  if (!directory.slice(path.parse(directory).root.length).split(path.sep).every(portableSegment)) throw failure("NM-PROJECT-PATH-001", "Project directory has an unsafe or aliased component.", directory);
+  const files = readPlan(plan, directory);
+  const directories = [...new Set([directory, ...files.map(file => path.dirname(file.path))].flatMap(ancestors))].sort((a, b) => ancestors(a).length - ancestors(b).length || a.localeCompare(b));
+  const identities = new Map(), createdDirectories = [], createdFiles = [];
+  try {
+    // Validate every ancestor, planned file, conflict, and normalization alias
+    // before the first mkdir/open, including broken links (lstat, not exists).
+    checkDirectories(fs, directories);
+    for (const item of directories) {
+      checkAlias(fs, item);
+      const stat = inspect(fs, item);
+      if (stat) identities.set(item, stat);
+    }
+    if (inspect(fs, directory) && fs.readdirSync(directory).length) throw failure("NM-PROJECT-CONFLICT-001", "Project destination must be empty.", directory);
+    for (const file of files) if (inspect(fs, file.path)) throw failure("NM-PROJECT-CONFLICT-001", "A project file already exists.", file.path);
+    for (const item of directories) {
+      checkDirectories(fs, ancestors(item), identities);
+      if (identities.has(item)) continue;
+      checkAlias(fs, item);
+      fs.mkdirSync(item);
+      const stat = fs.lstatSync(item);
+      if (stat.isSymbolicLink() || !stat.isDirectory()) throw failure("NM-PROJECT-LINK-001", "A created directory changed into a link.", item);
+      identities.set(item, stat);
+      createdDirectories.push({ path: item, stat });
+    }
+    for (const file of files) {
+      checkDirectories(fs, directories, identities);
+      const descriptor = fs.openSync(file.path, "wx");
+      try {
+        const stat = fs.fstatSync(descriptor);
+        const owned = { ...file, stat, completed: false };
+        createdFiles.push(owned);
+        fs.writeFileSync(descriptor, file.content);
+        owned.completed = true;
+      } finally { fs.closeSync(descriptor); }
+    }
+    return { directory, entryPath: path.join(directory, plan.entry), files: files.map(file => file.path) };
+  } catch (error) {
+    for (const file of createdFiles.reverse()) {
+      try {
+        checkDirectories(fs, ancestors(path.dirname(file.path)), identities);
+        if (!sameIdentity(file.stat, inspect(fs, file.path))) continue;
+        const current = fs.readFileSync(file.path);
+        const unchanged = file.completed ? current.equals(file.content) : current.length <= file.content.length && current.equals(file.content.subarray(0, current.length));
+        if (unchanged) fs.unlinkSync(file.path);
+      } catch { /* Preserve anything whose ownership or contents cannot be verified. */ }
+    }
+    for (const item of createdDirectories.reverse()) {
+      try {
+        checkDirectories(fs, ancestors(path.dirname(item.path)), identities);
+        if (sameIdentity(item.stat, inspect(fs, item.path))) fs.rmdirSync(item.path);
+      } catch { /* Nonempty or changed directories belong to the caller. */ }
+    }
+    if (error instanceof NMProjectCreationError) throw error;
+    const code = error.code === "EEXIST" || error.code === "ENOTEMPTY" ? "NM-PROJECT-CONFLICT-001" : "NM-PROJECT-WRITE-001";
+    throw failure(code, error instanceof Error ? error.message : "Unable to create project.", directory);
+  }
+}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { NM_DOCTOR_REPORT_FORMAT, NM_DOCTOR_REPORT_VERSION, createNMDoctorReport, formatNMDoctorReport, nmDoctorExpectedVersions, getNMWorkspaceModuleName, evaluateNMLanguagePreviewReadiness, NM_CLI_CONTRACT_VERSION, NM_LANGUAGE_PREVIEW_READINESS_FORMAT, NM_LANGUAGE_PREVIEW_READINESS_VERSION, NM_WORKSPACE_MAX_DOCUMENTS, NM_WORKSPACE_MAX_SOURCE_BYTES, nmCliCommandContracts, nmCliCommands, nmCliExitCodeContract, nmLanguagePreviewReadiness, nmLanguageReleaseChangelog, nmVersionManifest, nmWorkspaceDiagnosticCodes, runNMCLI, validateNMWorkspaceManifestJsonText } from "@nm-lang/core/cli";
-export type { NMDoctorCheck, NMDoctorComponentId, NMDoctorObservation, NMDoctorReport, NMDoctorRuntimeObservation, NMCapabilityStatus, NMCLICommand, NMCLICommandContract, NMCLIDeterminism, NMCLIExportTarget, NMCLIOptions, NMCLIOutputKind, NMCLIResult, NMLanguagePreviewReadiness, NMLanguageReleaseChange, NMVersionManifest } from "@nm-lang/core/cli";
+export { NMProjectTemplateError, createNMProjectPlan, isNMProjectName, nmProjectTemplates, NM_DOCTOR_REPORT_FORMAT, NM_DOCTOR_REPORT_VERSION, createNMDoctorReport, formatNMDoctorReport, nmDoctorExpectedVersions, getNMWorkspaceModuleName, evaluateNMLanguagePreviewReadiness, NM_CLI_CONTRACT_VERSION, NM_LANGUAGE_PREVIEW_READINESS_FORMAT, NM_LANGUAGE_PREVIEW_READINESS_VERSION, NM_WORKSPACE_MAX_DOCUMENTS, NM_WORKSPACE_MAX_SOURCE_BYTES, nmCliCommandContracts, nmCliCommands, nmCliExitCodeContract, nmLanguagePreviewReadiness, nmLanguageReleaseChangelog, nmVersionManifest, nmWorkspaceDiagnosticCodes, runNMCLI, validateNMWorkspaceManifestJsonText } from "@nm-lang/core/cli";
+export type { NMProjectTemplateId, NMProjectLocale, NMProjectTemplate, NMProjectPlan, NMProjectCreationResult, NMProjectTemplateErrorCode, NMDoctorCheck, NMDoctorComponentId, NMDoctorObservation, NMDoctorReport, NMDoctorRuntimeObservation, NMCapabilityStatus, NMCLICommand, NMCLICommandContract, NMCLIDeterminism, NMCLIExportTarget, NMCLIOptions, NMCLIOutputKind, NMCLIResult, NMLanguagePreviewReadiness, NMLanguageReleaseChange, NMVersionManifest } from "@nm-lang/core/cli";