@jstn-sdk/ma 0.1.4 → 0.1.5

package/bin/ma.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 
+import fs from "node:fs";
+import path from "node:path";
 import {
   evaluateBuildGate,
   formatBuildBlockers,
   formatNextAllowedTriggers,
 } from "../src/build-gate.js";
 import { appendDecision } from "../src/decision-log.js";
+import { runDoctor } from "../src/doctor.js";
 import { runCodex, shouldDelegateToCodex } from "../src/launcher.js";
 import {
   canMarkBuildDone,
@@ -14,12 +17,6 @@ import {
   validateReleaseOrigin,
 } from "../src/policy.js";
 import { loadReleaseState } from "../src/release-state.js";
-import { writeBuildPlanArtifact } from "../src/runtime-artifacts.js";
-import {
-  ensureSkillsInstalled,
-  ensureSupportBundleInstalled,
-  getSupportBundleRoot,
-} from "../src/skill-installer.js";
 import {
   listSkills,
   runArch,
@@ -32,18 +29,69 @@ import {
 } from "../src/skills.js";
 import { syncStatusUpdates } from "../src/state-sync.js";
 
+function getPackageVersion() {
+  const packageJsonPath = path.join(
+    path.dirname(new URL(import.meta.url).pathname),
+    "..",
+    "package.json",
+  );
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+  return packageJson.version;
+}
+
+function writeStdoutLine(line = "") {
+  process.stdout.write(`${line}\n`);
+}
+
 function printUsage() {
-  console.error("Secondary helper commands:");
-  console.error("  ma");
-  console.error("  ma setup");
-  console.error("  ma init");
-  console.error('  ma idea "..."');
-  console.error("  ma skills");
-  console.error("  ma sdk-path");
-  console.error("  ma status");
-  console.error("  ma run $arch|$sage|$flow|$vet|$vibe|$build");
-  console.error("  ma merge <source-branch> <target-branch>");
-  console.error("  ma release <origin-branch> <target-branch>");
+  writeStdoutLine("Runtime:");
+  writeStdoutLine("  ma --madmax --high");
+  writeStdoutLine("  ma [codex args...]");
+  writeStdoutLine();
+  writeStdoutLine("Operate inside Codex with:");
+  writeStdoutLine("  $arch  $sage  $flow  $vet  $vibe  $build");
+  writeStdoutLine();
+  writeStdoutLine("Maintenance / diagnostics / compatibility:");
+  writeStdoutLine("  ma status");
+  writeStdoutLine('  ma idea "..."');
+  writeStdoutLine("  ma skills");
+  writeStdoutLine("  ma run $arch|$sage|$flow|$vet|$vibe|$build");
+  writeStdoutLine("  ma merge <source-branch> <target-branch>");
+  writeStdoutLine("  ma release <origin-branch> <target-branch>");
+  writeStdoutLine("  ma doctor [--root <path>]");
+  writeStdoutLine("  ma setup [--root <path>]");
+  writeStdoutLine("  ma init [--root <path>]    # legacy compatibility alias");
+}
+
+function printSetupUsage() {
+  writeStdoutLine("Usage:");
+  writeStdoutLine("  ma setup [--root <path>]");
+  writeStdoutLine();
+  writeStdoutLine(
+    "Maintenance utility: repair or scaffold repo-local support files for the Codex-hosted runtime.",
+  );
+}
+
+function parseRootOption(args) {
+  const remaining = [];
+  let targetRoot = null;
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--root") {
+      const next = args[index + 1];
+      if (!next) {
+        throw new Error("Missing value for --root");
+      }
+      targetRoot = path.resolve(next);
+      index += 1;
+      continue;
+    }
+
+    remaining.push(arg);
+  }
+
+  return { remaining, targetRoot };
 }
 
 function printStatus(releaseState) {
@@ -75,18 +123,13 @@ async function runBuild(releaseState) {
 
   if (!evaluation.allowed) {
     const blockers = formatBuildBlockers(evaluation);
-    await writeBuildPlanArtifact({
-      allowed: false,
-      blockers,
-      nextTriggers: formatNextAllowedTriggers(evaluation),
-    });
     await appendDecision({
       decision: "Blocked build execution",
       status: "BLOCKED",
       evidence: [
         {
           kind: "release-state",
-          path: ".ma/release.json",
+          path: ".omx/release.json",
         },
       ],
       blockers,
@@ -101,13 +144,6 @@ async function runBuild(releaseState) {
     return;
   }
 
-  const suggestedBranches = ["feature/ui", "feature/api"];
-  await writeBuildPlanArtifact({
-    allowed: true,
-    blockers: [],
-    nextTriggers: ["$build"],
-    suggestedBranches,
-  });
   await appendDecision({
     kind: "skill",
     skill: "$build",
@@ -116,7 +152,7 @@ async function runBuild(releaseState) {
     evidence: [
       {
         kind: "release-state",
-        path: ".ma/release.json",
+        path: ".omx/release.json",
       },
       {
         branches: ["feature/ui", "feature/api"],
@@ -130,8 +166,8 @@ async function runBuild(releaseState) {
 
   console.log("Build gate is green.");
   console.log("Suggested branches:");
-  console.log(`- ${suggestedBranches[0]}`);
-  console.log(`- ${suggestedBranches[1]}`);
+  console.log("- feature/ui");
+  console.log("- feature/api");
   console.log("Optional worktree commands:");
   console.log("git worktree add ../ui feature/ui");
   console.log("git worktree add ../api feature/api");
@@ -199,38 +235,52 @@ async function runRelease(originBranch, targetBranch) {
 }
 
 async function main() {
-  const [, , command, ...rest] = process.argv;
   const args = process.argv.slice(2);
+  const [command, ...rest] = args;
   const arg = rest[0];
 
+  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+    if (command === "setup" || command === "init") {
+      printSetupUsage();
+      return;
+    }
+
+    printUsage();
+    return;
+  }
+
+  if (args.includes("--version") || args.includes("-v")) {
+    writeStdoutLine(getPackageVersion());
+    return;
+  }
+
   if (shouldDelegateToCodex(args)) {
-    await Promise.all([ensureSkillsInstalled(), ensureSupportBundleInstalled()]);
     process.exitCode = runCodex(args);
     return;
   }
 
-  if (command === "setup") {
+  const { remaining, targetRoot } = parseRootOption(rest);
+  if (targetRoot) {
+    process.env.MA_ROOT = targetRoot;
+  }
+
+  if (command === "setup" || command === "init") {
     const created = await runInit();
-    console.log("meta-architect setup");
-    console.log("====================");
+    console.log(command === "setup" ? "meta-architect setup" : "meta-architect init");
+    console.log(command === "setup" ? "====================" : "===================");
     for (const item of created) {
       console.log(`ready: ${item}`);
     }
     return;
   }
 
-  if (command === "init") {
-    const created = await runInit();
-    console.log("meta-architect init");
-    console.log("===================");
-    for (const item of created) {
-      console.log(`ready: ${item}`);
-    }
+  if (command === "doctor") {
+    process.exitCode = runDoctor();
     return;
   }
 
   if (command === "idea") {
-    const idea = rest.join(" ").trim();
+    const idea = remaining.join(" ").trim();
     await runIdea(idea);
     console.log("Idea recorded.");
     return;
@@ -243,11 +293,6 @@ async function main() {
     return;
   }
 
-  if (command === "sdk-path") {
-    process.stdout.write(`${getSupportBundleRoot()}\n`);
-    return;
-  }
-
   if (command === "status") {
     const releaseState = await loadReleaseState();
     printStatus(releaseState);
@@ -255,13 +300,13 @@ async function main() {
   }
 
   if (command === "merge") {
-    const [sourceBranch, targetBranch] = rest;
+    const [sourceBranch, targetBranch] = remaining;
     await runMerge(sourceBranch, targetBranch);
     return;
   }
 
   if (command === "release") {
-    const [originBranch, targetBranch] = rest;
+    const [originBranch, targetBranch] = remaining;
     await runRelease(originBranch, targetBranch);
     return;
   }
@@ -297,7 +342,11 @@ async function main() {
   }
 
   if (command === "run" && arg === "$vibe") {
-    await runVibe();
+    const waive = remaining.includes("--waive");
+    const reasonIndex = remaining.indexOf("--reason");
+    const reason =
+      reasonIndex !== -1 && remaining[reasonIndex + 1] ? remaining[reasonIndex + 1] : undefined;
+    await runVibe({ waive, reason });
     console.log("$vibe complete");
     return;
   }

package/docs/README.md

@@ -7,7 +7,6 @@ Meta-Architect documentation is organized by operator task.
 - [Getting Started](./getting-started.md)
 - [Release Spec](./release-spec.md)
 - [Skills Reference](./skills.md)
-- [Installed Support Bundle](./installed-sdk.md)
 
 ## Packaging and installation
 
@@ -17,7 +16,7 @@ Meta-Architect documentation is organized by operator task.
 
 ## QA and readiness
 
-- [Release Readiness 0.1.4](./qa/release-readiness-0.1.4.md)
+- [Release Readiness 0.1.5](./qa/release-readiness-0.1.5.md)
 
 ## Repo structure references