@jstn-sdk/ma 0.1.5 → 0.1.7

package/bin/ma.js

@@ -1,14 +1,11 @@
 #!/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,
@@ -17,81 +14,37 @@ 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,
   runFlow,
   runIdea,
   runInit,
+  runMaestro,
   runSage,
   runVet,
   runVibe,
 } 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() {
-  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 };
+  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 $maestro|$arch|$sage|$flow|$vet|$vibe|$build");
+  console.error("  ma merge <source-branch> <target-branch>");
+  console.error("  ma release <origin-branch> <target-branch>");
 }
 
 function printStatus(releaseState) {
@@ -123,13 +76,18 @@ 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: ".omx/release.json",
+          path: ".ma/release.json",
         },
       ],
       blockers,
@@ -144,6 +102,13 @@ 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",
@@ -152,7 +117,7 @@ async function runBuild(releaseState) {
     evidence: [
       {
         kind: "release-state",
-        path: ".omx/release.json",
+        path: ".ma/release.json",
       },
       {
         branches: ["feature/ui", "feature/api"],
@@ -166,8 +131,8 @@ async function runBuild(releaseState) {
 
   console.log("Build gate is green.");
   console.log("Suggested branches:");
-  console.log("- feature/ui");
-  console.log("- feature/api");
+  console.log(`- ${suggestedBranches[0]}`);
+  console.log(`- ${suggestedBranches[1]}`);
   console.log("Optional worktree commands:");
   console.log("git worktree add ../ui feature/ui");
   console.log("git worktree add ../api feature/api");
@@ -235,52 +200,38 @@ 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;
   }
 
-  const { remaining, targetRoot } = parseRootOption(rest);
-  if (targetRoot) {
-    process.env.MA_ROOT = targetRoot;
-  }
-
-  if (command === "setup" || command === "init") {
+  if (command === "setup") {
     const created = await runInit();
-    console.log(command === "setup" ? "meta-architect setup" : "meta-architect init");
-    console.log(command === "setup" ? "====================" : "===================");
+    console.log("meta-architect setup");
+    console.log("====================");
     for (const item of created) {
       console.log(`ready: ${item}`);
     }
     return;
   }
 
-  if (command === "doctor") {
-    process.exitCode = runDoctor();
+  if (command === "init") {
+    const created = await runInit();
+    console.log("meta-architect init");
+    console.log("===================");
+    for (const item of created) {
+      console.log(`ready: ${item}`);
+    }
     return;
   }
 
   if (command === "idea") {
-    const idea = remaining.join(" ").trim();
+    const idea = rest.join(" ").trim();
     await runIdea(idea);
     console.log("Idea recorded.");
     return;
@@ -293,6 +244,11 @@ async function main() {
     return;
   }
 
+  if (command === "sdk-path") {
+    process.stdout.write(`${getSupportBundleRoot()}\n`);
+    return;
+  }
+
   if (command === "status") {
     const releaseState = await loadReleaseState();
     printStatus(releaseState);
@@ -300,17 +256,23 @@ async function main() {
   }
 
   if (command === "merge") {
-    const [sourceBranch, targetBranch] = remaining;
+    const [sourceBranch, targetBranch] = rest;
     await runMerge(sourceBranch, targetBranch);
     return;
   }
 
   if (command === "release") {
-    const [originBranch, targetBranch] = remaining;
+    const [originBranch, targetBranch] = rest;
     await runRelease(originBranch, targetBranch);
     return;
   }
 
+  if (command === "run" && arg === "$maestro") {
+    await runMaestro();
+    console.log("$maestro complete");
+    return;
+  }
+
   if (command === "run" && arg === "$build") {
     const releaseState = await loadReleaseState();
     await runBuild(releaseState);
@@ -342,11 +304,7 @@ async function main() {
   }
 
   if (command === "run" && arg === "$vibe") {
-    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 });
+    await runVibe();
     console.log("$vibe complete");
     return;
   }

package/docs/README.md

@@ -7,6 +7,7 @@ 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
 
@@ -16,7 +17,7 @@ Meta-Architect documentation is organized by operator task.
 
 ## QA and readiness
 
-- [Release Readiness 0.1.5](./qa/release-readiness-0.1.5.md)
+- [Release Readiness 0.1.7](./qa/release-readiness-0.1.7.md)
 
 ## Repo structure references