@mstar-harness/cli 0.3.0 → 0.4.0

package/dist/mstar-harness.js

@@ -2344,8 +2344,8 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/index.ts
-import fs3 from "fs";
-import path6 from "path";
+import fs5 from "fs";
+import path7 from "path";
 import { fileURLToPath } from "url";
 
 // ../../node_modules/@inquirer/core/dist/lib/key.js
@@ -4240,13 +4240,13 @@ function buildModelAssignments(selections) {
   return { ...assignments, ...pickRandom(others, selections.others) };
 }
 
-// src/adapters/cursor.ts
-import fs from "node:fs";
+// src/adapters/codex.ts
+import fs2 from "node:fs";
 import os from "node:os";
 import path3 from "node:path";
-import { execFileSync } from "node:child_process";
 
 // src/utils.ts
+import fs from "node:fs";
 import path2 from "node:path";
 function normalizeModelList(raw) {
   return raw.split(`
@@ -4257,6 +4257,25 @@ function ensureObject(value) {
     return value;
   return {};
 }
+function readJson(filePath) {
+  if (!fs.existsSync(filePath))
+    return {};
+  const content = fs.readFileSync(filePath, "utf8").trim();
+  if (!content)
+    return {};
+  try {
+    return JSON.parse(content);
+  } catch (error) {
+    throw new Error(`Invalid JSON in ${filePath}: ${error.message}`);
+  }
+}
+function writeJson(filePath, value) {
+  const parent = path2.dirname(filePath);
+  if (!fs.existsSync(parent))
+    fs.mkdirSync(parent, { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+`, "utf8");
+}
 function resolveProjectRoot() {
   const candidate = process.env.MSTAR_CLI_PROJECT_ROOT || process.env.INIT_CWD || process.env.PWD;
   if (candidate && candidate.trim())
@@ -4264,21 +4283,132 @@ function resolveProjectRoot() {
   return process.cwd();
 }
 
+// src/adapters/codex.ts
+var MARKETPLACE_NAME = "personal";
+var MARKETPLACE_DISPLAY_NAME = "Personal";
+var MARKETPLACE_PATH = path3.join(os.homedir(), ".agents", "plugins", "marketplace.json");
+var PLUGIN_NAME = "morning-star-harness";
+var PLUGIN_URL = "https://github.com/btspoony/mstar-harness.git";
+var PLUGIN_REF = "main";
+var PLUGIN_CATEGORY = "Productivity";
+function mstarEntry() {
+  return {
+    name: PLUGIN_NAME,
+    source: {
+      source: "url",
+      url: PLUGIN_URL,
+      ref: PLUGIN_REF
+    },
+    policy: {
+      installation: "AVAILABLE",
+      authentication: "ON_INSTALL"
+    },
+    category: PLUGIN_CATEGORY
+  };
+}
+function normalizeMarketplace(raw) {
+  const next = ensureObject(raw);
+  next.name = MARKETPLACE_NAME;
+  const iface = ensureObject(next.interface);
+  if (typeof iface.displayName !== "string" || !iface.displayName.trim()) {
+    iface.displayName = MARKETPLACE_DISPLAY_NAME;
+  }
+  next.interface = iface;
+  if (!Array.isArray(next.plugins)) {
+    next.plugins = [];
+  }
+  return next;
+}
+function upsertEntry(raw) {
+  const next = normalizeMarketplace(raw);
+  const plugins = next.plugins.filter((entry) => {
+    return !(entry && typeof entry === "object" && !Array.isArray(entry) && entry.name === PLUGIN_NAME);
+  });
+  plugins.push(mstarEntry());
+  next.plugins = plugins;
+  return next;
+}
+function findEntry(raw) {
+  const plugins = Array.isArray(raw.plugins) ? raw.plugins : [];
+  return plugins.find((entry) => {
+    return entry && typeof entry === "object" && !Array.isArray(entry) && entry.name === PLUGIN_NAME;
+  });
+}
+function validateEntryShape(entry) {
+  const errors2 = [];
+  if (!entry) {
+    errors2.push(`Missing ${PLUGIN_NAME} entry in ${MARKETPLACE_PATH}.`);
+    return errors2;
+  }
+  const source = ensureObject(entry.source);
+  if (source.source !== "url")
+    errors2.push("Codex marketplace entry source.source must be `url`.");
+  if (source.url !== PLUGIN_URL)
+    errors2.push(`Codex marketplace entry source.url must be ${PLUGIN_URL}.`);
+  if (source.ref !== PLUGIN_REF)
+    errors2.push(`Codex marketplace entry source.ref must be ${PLUGIN_REF}.`);
+  const policy = ensureObject(entry.policy);
+  if (policy.installation !== "AVAILABLE")
+    errors2.push("Codex marketplace entry policy.installation must be AVAILABLE.");
+  if (policy.authentication !== "ON_INSTALL")
+    errors2.push("Codex marketplace entry policy.authentication must be ON_INSTALL.");
+  if (entry.category !== PLUGIN_CATEGORY)
+    errors2.push(`Codex marketplace entry category must be ${PLUGIN_CATEGORY}.`);
+  return errors2;
+}
+function runInit(dryRun) {
+  const current = readJson(MARKETPLACE_PATH);
+  const next = upsertEntry(current);
+  const existingEntry = findEntry(current);
+  if (!dryRun)
+    writeJson(MARKETPLACE_PATH, next);
+  return {
+    location: MARKETPLACE_PATH,
+    notes: [
+      existingEntry ? `Updated ${PLUGIN_NAME} entry in personal Codex marketplace.` : `Added ${PLUGIN_NAME} entry to personal Codex marketplace.`,
+      `Source URL: ${PLUGIN_URL}#${PLUGIN_REF}`,
+      `Install after init: codex plugin add ${PLUGIN_NAME} --marketplace ${String(next.name)}`
+    ]
+  };
+}
+function runDoctor() {
+  const errors2 = [];
+  if (!fs2.existsSync(MARKETPLACE_PATH)) {
+    return { location: MARKETPLACE_PATH, errors: [`Missing Codex personal marketplace: ${MARKETPLACE_PATH}`] };
+  }
+  const marketplace = readJson(MARKETPLACE_PATH);
+  if (marketplace.name !== MARKETPLACE_NAME) {
+    errors2.push(`Codex personal marketplace name must be ${MARKETPLACE_NAME}.`);
+  }
+  errors2.push(...validateEntryShape(findEntry(marketplace)));
+  return { location: MARKETPLACE_PATH, errors: errors2 };
+}
+var codexAdapter = {
+  target: "codex",
+  mode: "install",
+  runInstallInit: (_scope, dryRun) => runInit(dryRun),
+  runInstallDoctor: () => runDoctor()
+};
+
 // src/adapters/cursor.ts
+import fs3 from "node:fs";
+import os2 from "node:os";
+import path4 from "node:path";
+import { execFileSync } from "node:child_process";
 var REPO_URL = "https://github.com/btspoony/mstar-harness.git";
 var CURSOR_PLUGIN_NAME = "mstar-harness";
 var CURSOR_PLUGIN_MARKER = ".cursor-plugin/plugin.json";
 function globalInstallPath() {
-  return path3.join(os.homedir(), ".cursor", "plugins", "local", CURSOR_PLUGIN_NAME);
+  return path4.join(os2.homedir(), ".cursor", "plugins", "local", CURSOR_PLUGIN_NAME);
 }
 function projectInstallPath() {
-  return path3.join(resolveProjectRoot(), ".cursor", "plugins", CURSOR_PLUGIN_NAME);
+  return path4.join(resolveProjectRoot(), ".cursor", "plugins", CURSOR_PLUGIN_NAME);
 }
 function ensureDir(dirPath, dryRun) {
   if (dryRun)
     return;
-  if (!fs.existsSync(dirPath))
-    fs.mkdirSync(dirPath, { recursive: true });
+  if (!fs3.existsSync(dirPath))
+    fs3.mkdirSync(dirPath, { recursive: true });
 }
 function runCommand(command, cwd, dryRun) {
   if (dryRun)
@@ -4288,12 +4418,12 @@ function runCommand(command, cwd, dryRun) {
 function globalInit(dryRun) {
   const location = globalInstallPath();
   const notes = [];
-  if (fs.existsSync(location)) {
+  if (fs3.existsSync(location)) {
     notes.push(`Plugin already exists at ${location}`);
     return { location, notes };
   }
-  ensureDir(path3.dirname(location), dryRun);
-  runCommand(["git", "clone", REPO_URL, location], path3.dirname(location), dryRun);
+  ensureDir(path4.dirname(location), dryRun);
+  runCommand(["git", "clone", REPO_URL, location], path4.dirname(location), dryRun);
   notes.push(`Cloned ${REPO_URL} to ${location}`);
   return { location, notes };
 }
@@ -4301,12 +4431,12 @@ function projectInit(dryRun) {
   const projectRoot = resolveProjectRoot();
   const location = projectInstallPath();
   const notes = [];
-  if (fs.existsSync(location)) {
+  if (fs3.existsSync(location)) {
     notes.push(`Submodule path already exists at ${location}`);
     return { location, notes };
   }
   runCommand(["git", "rev-parse", "--is-inside-work-tree"], projectRoot, dryRun);
-  ensureDir(path3.join(projectRoot, ".cursor", "plugins"), dryRun);
+  ensureDir(path4.join(projectRoot, ".cursor", "plugins"), dryRun);
   runCommand(["git", "submodule", "add", REPO_URL, ".cursor/plugins/mstar-harness"], projectRoot, dryRun);
   notes.push("Added mstar-harness as git submodule at .cursor/plugins/mstar-harness");
   return { location, notes };
@@ -4314,12 +4444,12 @@ function projectInit(dryRun) {
 function globalDoctor() {
   const location = globalInstallPath();
   const errors2 = [];
-  if (!fs.existsSync(location)) {
+  if (!fs3.existsSync(location)) {
     errors2.push(`Missing plugin directory: ${location}`);
     return { location, errors: errors2 };
   }
-  const marker = path3.join(location, CURSOR_PLUGIN_MARKER);
-  if (!fs.existsSync(marker)) {
+  const marker = path4.join(location, CURSOR_PLUGIN_MARKER);
+  if (!fs3.existsSync(marker)) {
     errors2.push(`Missing Cursor plugin marker file: ${marker}`);
   }
   return { location, errors: errors2 };
@@ -4328,15 +4458,15 @@ function projectDoctor() {
   const projectRoot = resolveProjectRoot();
   const location = projectInstallPath();
   const errors2 = [];
-  if (!fs.existsSync(location)) {
+  if (!fs3.existsSync(location)) {
     errors2.push(`Missing submodule directory: ${location}`);
   }
-  const gitmodulesPath = path3.join(projectRoot, ".gitmodules");
-  if (!fs.existsSync(gitmodulesPath)) {
+  const gitmodulesPath = path4.join(projectRoot, ".gitmodules");
+  if (!fs3.existsSync(gitmodulesPath)) {
     errors2.push("Missing .gitmodules (expected cursor plugin submodule entry).");
     return { location, errors: errors2 };
   }
-  const gitmodules = fs.readFileSync(gitmodulesPath, "utf8");
+  const gitmodules = fs3.readFileSync(gitmodulesPath, "utf8");
   if (!gitmodules.includes("path = .cursor/plugins/mstar-harness")) {
     errors2.push("Missing .cursor/plugins/mstar-harness entry in .gitmodules.");
   }
@@ -4358,8 +4488,8 @@ var cursorAdapter = {
 };
 
 // src/adapters/opencode.ts
-import os2 from "node:os";
-import path4 from "node:path";
+import os3 from "node:os";
+import path5 from "node:path";
 import { execFileSync as execFileSync2 } from "node:child_process";
 var OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
 var MSTAR_OPENCODE_PLUGIN = "@mstar-harness/opencode@latest";
@@ -4388,11 +4518,11 @@ function getOpencodeModels() {
 function resolveOpencodeConfigPath(scope, outputPath) {
   if (outputPath && outputPath.trim()) {
     const raw = outputPath.trim();
-    return path4.isAbsolute(raw) ? raw : path4.join(resolveProjectRoot(), raw);
+    return path5.isAbsolute(raw) ? raw : path5.join(resolveProjectRoot(), raw);
   }
   if (scope === "global")
-    return path4.join(os2.homedir(), ".config", "opencode", "opencode.json");
-  return path4.join(resolveProjectRoot(), "opencode.json");
+    return path5.join(os3.homedir(), ".config", "opencode", "opencode.json");
+  return path5.join(resolveProjectRoot(), "opencode.json");
 }
 function ensureConfigSchema(config) {
   const next = ensureObject(config);
@@ -4486,7 +4616,8 @@ var opencodeAdapter = {
 // src/adapters/index.ts
 var adapters = {
   opencode: opencodeAdapter,
-  cursor: cursorAdapter
+  cursor: cursorAdapter,
+  codex: codexAdapter
 };
 function getAdapter(target) {
   const adapter = adapters[target];
@@ -4496,20 +4627,20 @@ function getAdapter(target) {
 }
 
 // src/types.ts
-var SUPPORTED_TARGETS = ["opencode", "cursor"];
+var SUPPORTED_TARGETS = ["opencode", "cursor", "codex"];
 
 // src/utils.ts
-import fs2 from "node:fs";
-import path5 from "node:path";
+import fs4 from "node:fs";
+import path6 from "node:path";
 function parseCsv(raw) {
   if (!raw)
     return;
   return raw.split(",").map((item) => item.trim()).filter(Boolean);
 }
-function readJson(filePath) {
-  if (!fs2.existsSync(filePath))
+function readJson2(filePath) {
+  if (!fs4.existsSync(filePath))
     return {};
-  const content = fs2.readFileSync(filePath, "utf8").trim();
+  const content = fs4.readFileSync(filePath, "utf8").trim();
   if (!content)
     return {};
   try {
@@ -4518,19 +4649,19 @@ function readJson(filePath) {
     throw new Error(`Invalid JSON in ${filePath}: ${error.message}`);
   }
 }
-function writeJson(filePath, value) {
-  const parent = path5.dirname(filePath);
-  if (!fs2.existsSync(parent))
-    fs2.mkdirSync(parent, { recursive: true });
-  fs2.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
+function writeJson2(filePath, value) {
+  const parent = path6.dirname(filePath);
+  if (!fs4.existsSync(parent))
+    fs4.mkdirSync(parent, { recursive: true });
+  fs4.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}
 `, "utf8");
 }
 
 // src/index.ts
-var packageJsonPath = path6.resolve(path6.dirname(fileURLToPath(import.meta.url)), "../package.json");
+var packageJsonPath = path7.resolve(path7.dirname(fileURLToPath(import.meta.url)), "../package.json");
 var packageVersion = (() => {
   try {
-    const parsed = JSON.parse(fs3.readFileSync(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(fs5.readFileSync(packageJsonPath, "utf8"));
     return parsed.version || "0.0.0";
   } catch {
     return "0.0.0";
@@ -4609,7 +4740,7 @@ async function resolveSelections(options, models) {
     })
   };
 }
-async function runInit(options) {
+async function runInit2(options) {
   const target = options.target || (options.yes ? "opencode" : await pickTargetInteractive());
   const scope = options.scope || "project";
   const adapter = getAdapter(target);
@@ -4641,7 +4772,7 @@ async function runInit(options) {
   const configPath = adapter.resolveConfigPath?.(scope, options.output);
   if (!configPath)
     throw new Error(`Adapter ${target} does not implement config path resolution.`);
-  const current = readJson(configPath);
+  const current = readJson2(configPath);
   const updated = adapter.mutateConfigForInit?.(current, assignments);
   if (!updated)
     throw new Error(`Adapter ${target} does not implement init mutation.`);
@@ -4653,8 +4784,8 @@ async function runInit(options) {
 - `)}`);
   }
   if (!options.dryRun) {
-    writeJson(configPath, updated);
-    const persistedErrors = adapter.validateConfig?.(readJson(configPath)) || [];
+    writeJson2(configPath, updated);
+    const persistedErrors = adapter.validateConfig?.(readJson2(configPath)) || [];
     if (persistedErrors.length) {
       throw new Error(`Post-write verification failed:
 - ${persistedErrors.join(`
@@ -4671,7 +4802,7 @@ async function runInit(options) {
     console.log(`  - ${roleId}: ${modelId}`);
   }
 }
-function runDoctor(options) {
+function runDoctor2(options) {
   const target = options.target || "opencode";
   const adapter = getAdapter(target);
   const scope = options.scope || "project";
@@ -4696,7 +4827,7 @@ function runDoctor(options) {
   if (!configPath) {
     throw new Error(`Adapter ${target} does not implement config doctor flow.`);
   }
-  const config = readJson(configPath);
+  const config = readJson2(configPath);
   const errors2 = adapter.validateConfig?.(config) || [];
   console.log(`Config file: ${configPath}`);
   if (!errors2.length) {
@@ -4716,10 +4847,10 @@ function runDoctor(options) {
 }
 program2.name("mstar-harness").description("Morning Star harness CLI for target-based agent bootstrap").version(packageVersion);
 program2.command("init").description("Interactive/non-interactive setup for target agent bootstrap").option("-y, --yes", "Non-interactive mode").option("--target <target>", "Install target", "opencode").option("--scope <scope>", "Config scope: global|project (default: project)").option("--output <path>", "Config file path override, relative to project root").option("--dry-run", "Preview result without writing config").option("--pm-model <model>", "Model for project-manager").option("--strategic-models <a,b,c>", "Models for architect/product-manager/prompt-engineer").option("--dev-models <a,b,c>", "Models for fullstack-dev/fullstack-dev-2/frontend-dev").option("--qc-models <a,b,c>", "Models for qc trio").option("--other-models <a,b,c>", "Models for random assignment to remaining roles").action(async (options) => {
-  await runInit(options);
+  await runInit2(options);
 });
 program2.command("doctor").description("Validate Morning Star setup for a target agent config").option("--target <target>", "Target agent for doctor checks", "opencode").option("--scope <scope>", "Config scope: global|project", "project").option("--output <path>", "Config file path override, relative to project root").action((options) => {
-  runDoctor(options);
+  runDoctor2(options);
 });
 program2.parseAsync(process.argv).catch((error) => {
   console.error(import_picocolors.default.red(`Setup failed: ${error.message}`));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mstar-harness/cli",
-  "version": "0.3.0",
-  "description": "Morning Star harness installer CLI (OpenCode, Cursor).",
+  "version": "0.4.0",
+  "description": "Morning Star harness installer CLI (OpenCode, Cursor, Codex).",
   "license": "MIT",
   "repository": {
     "type": "git",