@codeyam-editor/codeyam-editor 0.1.0 → 0.1.2

package/npm/preflight-guidance.js

@@ -0,0 +1,68 @@
+"use strict";
+
+/**
+ * Launcher-side mirror of `start_preflight` in
+ * `crates/codeyam-editor/src/commands/start.rs`. The Rust side is the source
+ * of truth for the guidance strings; if it changes, update this file in the
+ * same commit and keep the `crates/codeyam-editor/tests/start_preflight_exit_code.rs`
+ * test in sync.
+ *
+ * Mirrors the heuristic in `migration_status::is_legacy_config`: a
+ * `.codeyam/config.json` whose JSON has a top-level `webapps` key marks a
+ * legacy project. Anything else with no `editor.json` is greenfield.
+ */
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+function greenfieldGuidance(projectDir) {
+  return (
+    `No codeyam-editor project detected in ${projectDir}.\n\n` +
+    "Run `codeyam-editor init` to install the agent bundle, then\n" +
+    "open Claude Code and invoke `/codeyam-onboard` to set up this project."
+  );
+}
+
+function legacyGuidance(projectDir) {
+  return (
+    `Detected legacy codeyam project in ${projectDir}.\n\n` +
+    "Run `codeyam-editor init` to install the agent bundle (it will skip\n" +
+    "editor.json creation so the legacy classification is preserved), then\n" +
+    "open Claude Code and invoke `/codeyam-onboard` to migrate."
+  );
+}
+
+function isLegacyConfig(configPath) {
+  let raw;
+  try {
+    raw = fs.readFileSync(configPath, "utf8");
+  } catch {
+    return false;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return false;
+  }
+  return parsed && typeof parsed === "object" && "webapps" in parsed;
+}
+
+/**
+ * Classify a project directory as `modern`, `legacy`, or `none`, mirroring
+ * the Rust `classify` / `start_preflight` pair. `guidance` is the exact
+ * stderr text to print before exiting with code 2.
+ */
+function classifyProject(projectDir) {
+  const editorJson = path.join(projectDir, ".codeyam", "editor.json");
+  if (fs.existsSync(editorJson)) {
+    return { kind: "modern" };
+  }
+  const legacyConfig = path.join(projectDir, ".codeyam", "config.json");
+  if (isLegacyConfig(legacyConfig)) {
+    return { kind: "legacy", guidance: legacyGuidance(projectDir) };
+  }
+  return { kind: "none", guidance: greenfieldGuidance(projectDir) };
+}
+
+module.exports = { classifyProject };