@mutmutco/cli 2.50.0 → 2.51.0

package/dist/main.cjs

@@ -15749,6 +15749,22 @@ function stageRequiredSecrets(stage2, meta) {
 function stageKey(stage2, key) {
   return key.includes("/") ? key : `${stage2}/${key}`;
 }
+function materializedRuntimeSecretName(entry) {
+  return entry.includes(":") ? entry.split(":").pop() : entry;
+}
+function runtimeSecretStreamGap(stage2, meta, presentSecrets) {
+  const streamed = new Set(
+    (contractByStage(meta.requiredRuntimeSecrets)[stage2] ?? []).map(materializedRuntimeSecretName)
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const gap = [];
+  for (const name of stageRequiredSecrets(stage2, meta).map(materializedRuntimeSecretName)) {
+    if (seen.has(name)) continue;
+    seen.add(name);
+    if (!streamed.has(name) && presentSecrets.has(stageKey(stage2, name))) gap.push(name);
+  }
+  return gap;
+}
 function hasRuntimeSecretContract(contract) {
   if (!contract || typeof contract !== "object" || Array.isArray(contract)) return false;
   return ["dev", "rc", "main"].some((stage2) => Array.isArray(contract[stage2]));
@@ -15990,6 +16006,11 @@ async function buildV2Doctor(repoOrSlug, deps) {
     const missing = required.filter((key) => !presentSecrets.has(key));
     return [stage2, { required, present, missing }];
   }));
+  const runtimeSecretStreamWarnings = Object.fromEntries(STAGES.map((stage2) => [
+    stage2,
+    stageInTrack(meta, stage2) ? runtimeSecretStreamGap(stage2, meta, presentSecrets) : []
+  ]));
+  const runtimeSecretStreamWarningRows = STAGES.map((stage2) => ({ stage: stage2, names: runtimeSecretStreamWarnings[stage2] })).filter((row) => row.names.length > 0);
   const metaMissing = ["class", "projectType", "deployModel", "vaultPath", "kbPointer"].filter((key) => meta[key] === void 0).concat(boardRegistryGaps(meta));
   const ok = !secretsError && metaMissing.length === 0 && Object.values(deployCoords).every((v) => v.ok) && Object.values(secrets).every((v) => v.missing.length === 0);
   const edgeDomainWarnings = deps.resolveDns ? await probeEdgeDomains(meta, deps.resolveDns) : [];
@@ -16005,6 +16026,7 @@ async function buildV2Doctor(repoOrSlug, deps) {
     autoHealAvailable: Object.keys(autoHeal.patch),
     appOwnedGaps: autoHeal.appOwnedGaps,
     ...edgeDomainWarnings.length ? { edgeDomainWarnings } : {},
+    ...runtimeSecretStreamWarningRows.length ? { runtimeSecretStreamWarnings: runtimeSecretStreamWarningRows } : {},
     appAttested: appAttestationOf(meta) ?? void 0
   };
 }
@@ -16035,6 +16057,9 @@ function renderReadinessIssueBody(existingBody, report, opts = {}) {
     ...(report.edgeDomainWarnings ?? []).map(
       (w) => `- \u26A0 edge domain does not resolve in DNS (advisory): ${w.stage} \u2192 ${w.host}; verify the registry edgeDomains value against the live public host`
     ),
+    ...(report.runtimeSecretStreamWarnings ?? []).map(
+      (w) => `- \u26A0 required secrets provisioned but not in requiredRuntimeSecrets (advisory): ${w.stage} \u2192 ${w.names.join(", ")}; add them to the registry stream list or they will not be materialized into tenant.env`
+    ),
     "",
     "### Auto-heal applied / available",
     ...opts.healed?.length ? opts.healed.map((x) => `- ${x}`) : report.autoHealAvailable.map((x) => `- ${x}`),
@@ -18044,8 +18069,45 @@ var CLAUDE_RECOVERY = `claude plugin marketplace remove ${LEGACY_MMI_MARKETPLACE
 var CODEX_RECOVERY = `codex plugin marketplace remove ${LEGACY_MMI_MARKETPLACE} && codex plugin marketplace remove mutmutco && codex plugin marketplace add mutmutco/MMI-Hub --ref main && codex plugin add mmi@mutmutco`;
 var OPENCODE_PLUGIN_PACKAGE = "@mutmutco/opencode-mmi";
 var OPENCODE_PLUGIN_SPEC = `${OPENCODE_PLUGIN_PACKAGE}@latest`;
-var OPENCODE_PLUGIN_INSTALL_COMMAND = `opencode plugin ${OPENCODE_PLUGIN_SPEC} --global --force`;
+var OPENCODE_PLUGIN_INSTALL_COMMAND = `mmi-cli doctor --apply`;
 var OPENCODE_RECOVERY = `${OPENCODE_PLUGIN_INSTALL_COMMAND}   # then restart OpenCode to load MMI commands`;
+var OPENCODE_WORKFLOW_COMMANDS = [
+  "mmi",
+  "secrets",
+  "stage",
+  "rcand",
+  "release",
+  "hotfix",
+  "bootstrap",
+  "grind",
+  "build",
+  "handoff",
+  "coop",
+  "browser-automation"
+];
+function opencodeCommandDescription(command) {
+  if (command === "mmi") return "Run the MMI work-board workflow.";
+  if (command === "browser-automation") return "Run the MMI browser automation workflow.";
+  return `Run the MMI ${command} workflow.`;
+}
+function opencodeCommandTemplate(command) {
+  return [
+    `Use the \`${command}\` skill and follow it exactly.`,
+    "",
+    "$ARGUMENTS"
+  ].join("\n");
+}
+function opencodeCommandMarkdown(command) {
+  return [
+    "---",
+    `description: ${opencodeCommandDescription(command)}`,
+    "agent: build",
+    "---",
+    "",
+    opencodeCommandTemplate(command),
+    ""
+  ].join("\n");
+}
 var PLUGIN_SURFACE_HEAL = {
   claude: {
     delivery: "plugin-cli",
@@ -18239,6 +18301,7 @@ function buildOpencodeVersionCheck(input) {
   return { ...base, ok: false, installedVersion: input.installedVersion, releasedVersion: input.releasedVersion };
 }
 var OPENCODE_CONFIG_PLUGIN_LABEL = "OpenCode MMI adapter config wiring";
+var OPENCODE_SURFACE_ASSETS_LABEL = "OpenCode MMI commands and skills";
 function opencodePluginEntryMatches(entry) {
   return entry === OPENCODE_PLUGIN_PACKAGE || entry === OPENCODE_PLUGIN_SPEC || Array.isArray(entry) && (entry[0] === OPENCODE_PLUGIN_PACKAGE || entry[0] === OPENCODE_PLUGIN_SPEC);
 }
@@ -18326,6 +18389,23 @@ function buildOpencodeConfigPluginCheck(input) {
   }
   return { ...base, configPath: input.configPath };
 }
+function buildOpencodeSurfaceAssetsCheck(input) {
+  const base = {
+    ok: true,
+    label: OPENCODE_SURFACE_ASSETS_LABEL,
+    fix: OPENCODE_RECOVERY,
+    configPath: input.configPath,
+    commandsDir: input.commandsDir,
+    skillsPath: input.skillsPath
+  };
+  if (!input.isOrgRepo) return base;
+  const existing = new Set(input.existingCommands.map((c) => c.toLowerCase()));
+  const missingCommands = OPENCODE_WORKFLOW_COMMANDS.filter((c) => !existing.has(c));
+  const normalizedSkillsPath = input.skillsPath?.replace(/\\/g, "/");
+  const hasSkillsPath = Boolean(normalizedSkillsPath && input.configuredSkillsPaths?.some((p) => p.replace(/\\/g, "/") === normalizedSkillsPath));
+  if (!missingCommands.length && hasSkillsPath) return { ...base, hasSkillsPath };
+  return { ...base, ok: false, missingCommands, hasSkillsPath };
+}
 var OPENCODE_DESKTOP_BOOTSTRAP_LABEL = "OpenCode Desktop stale project bootstrap";
 var OPENCODE_DESKTOP_BOOTSTRAP_FIX = "OpenCode Desktop is bootstrapping a deleted MMI worktree; open an existing checkout in OpenCode, remove/select away from the stale project entry, then restart OpenCode";
 function decodeLogUrlDirectory(value) {
@@ -19084,8 +19164,17 @@ function backupAndWriteInstalledPlugins(records, pluginId) {
     return false;
   }
 }
+function opencodeConfigDir() {
+  return (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".config", "opencode");
+}
 function opencodeConfigPath() {
-  return (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".config", "opencode", "opencode.jsonc");
+  return (0, import_node_path22.join)(opencodeConfigDir(), "opencode.jsonc");
+}
+function opencodeCommandsDir() {
+  return (0, import_node_path22.join)(opencodeConfigDir(), "commands");
+}
+function opencodeSkillsPath() {
+  return (0, import_node_path22.join)(opencodeConfigDir(), "node_modules", "@mutmutco", "opencode-mmi", "skills");
 }
 function opencodeConfigSnapshot() {
   const path2 = opencodeConfigPath();
@@ -19094,12 +19183,14 @@ function opencodeConfigSnapshot() {
     const raw = (0, import_node_fs26.readFileSync)(path2, "utf8");
     const parsed = JSON.parse(stripJsonc(raw));
     const hasPluginField = Object.prototype.hasOwnProperty.call(parsed, "plugin");
+    const skillsPaths = Array.isArray(parsed.skills?.paths) ? parsed.skills.paths.filter((p) => typeof p === "string") : void 0;
     return {
       path: path2,
       hasConfig: true,
       hasPluginField,
       parseOk: true,
       raw,
+      ...skillsPaths ? { skillsPaths } : {},
       ...Array.isArray(parsed.plugin) ? { pluginEntries: parsed.plugin } : parsed.plugin === void 0 ? {} : { pluginEntries: void 0 }
     };
   } catch {
@@ -19120,6 +19211,79 @@ function writeOpencodeConfigPlugin(snapshot) {
     return false;
   }
 }
+function writeOpencodeSkillsPath(snapshot, skillsPath) {
+  try {
+    const raw = snapshot.hasConfig ? snapshot.raw : void 0;
+    const parsed = raw ? JSON.parse(stripJsonc(raw)) : { $schema: "https://opencode.ai/config.json" };
+    const skills = parsed.skills && typeof parsed.skills === "object" && !Array.isArray(parsed.skills) ? parsed.skills : {};
+    const paths = Array.isArray(skills.paths) ? skills.paths.filter((p) => typeof p === "string") : [];
+    const normalized = skillsPath.replace(/\\/g, "/");
+    if (!paths.some((p) => p.replace(/\\/g, "/") === normalized)) paths.push(skillsPath.replace(/\\/g, "/"));
+    parsed.skills = { ...skills, paths };
+    (0, import_node_fs26.mkdirSync)((0, import_node_path22.dirname)(snapshot.path), { recursive: true });
+    if (snapshot.hasConfig && (0, import_node_fs26.existsSync)(snapshot.path)) (0, import_node_fs26.copyFileSync)(snapshot.path, `${snapshot.path}.bak`);
+    (0, import_node_fs26.writeFileSync)(snapshot.path, `${JSON.stringify(parsed, null, 2)}
+`, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function opencodeExistingCommands() {
+  try {
+    return (0, import_node_fs26.readdirSync)(opencodeCommandsDir(), { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => entry.name.slice(0, -3).toLowerCase());
+  } catch {
+    return [];
+  }
+}
+function writeOpencodeCommandFiles() {
+  try {
+    const dir = opencodeCommandsDir();
+    (0, import_node_fs26.mkdirSync)(dir, { recursive: true });
+    for (const command of OPENCODE_WORKFLOW_COMMANDS) {
+      (0, import_node_fs26.writeFileSync)((0, import_node_path22.join)(dir, `${command}.md`), opencodeCommandMarkdown(command), "utf8");
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readOpencodeAdapterDiskVersion() {
+  const candidates = [
+    (0, import_node_path22.join)(opencodeConfigDir(), "node_modules", "@mutmutco", "opencode-mmi", "package.json"),
+    (0, import_node_path22.join)((0, import_node_os5.homedir)(), ".cache", "opencode", "node_modules", "@mutmutco", "opencode-mmi", "package.json")
+  ];
+  for (const path2 of candidates) {
+    try {
+      const parsed = JSON.parse((0, import_node_fs26.readFileSync)(path2, "utf8"));
+      if (typeof parsed.version === "string" && parsed.version.trim()) return parsed.version.trim();
+    } catch {
+      continue;
+    }
+  }
+  return void 0;
+}
+function opencodeMmiPluginSpecs(snapshot) {
+  const specs = (snapshot.pluginEntries ?? []).map((entry) => Array.isArray(entry) ? entry[0] : entry).filter((entry) => typeof entry === "string").filter((entry) => entry === OPENCODE_PLUGIN_PACKAGE || entry === OPENCODE_PLUGIN_SPEC || entry.startsWith("@mutmutco/"));
+  return Array.from(new Set(specs.length ? specs : [OPENCODE_PLUGIN_SPEC]));
+}
+async function forceInstallOpencodeMmiPlugins(snapshot, log) {
+  try {
+    const specs = opencodeMmiPluginSpecs(snapshot);
+    log(`  \u21BB force-refreshing OpenCode MMI npm plugin(s): ${specs.join(", ")}\u2026`);
+    (0, import_node_fs26.mkdirSync)(opencodeConfigDir(), { recursive: true });
+    await runHostBin("npm", ["install", "--prefix", opencodeConfigDir(), "--force", ...specs], { timeout: NPM_UPDATE_TIMEOUT_MS });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function opencodeInstalledVersionForDoctor() {
+  return process.env.MMI_OPENCODE_PLUGIN_VERSION || readOpencodeAdapterDiskVersion();
+}
+function opencodePluginVersionsForReport() {
+  return [process.env.MMI_OPENCODE_PLUGIN_VERSION, readOpencodeAdapterDiskVersion()].filter((v) => Boolean(v));
+}
 function opencodeDesktopLogsRoot() {
   if (process.platform === "win32") {
     const base = process.env.APPDATA || (0, import_node_path22.join)((0, import_node_os5.homedir)(), "AppData", "Roaming");
@@ -19598,7 +19762,7 @@ async function runDoctor(opts, io = consoleIo) {
     }
   }
   checks.push(installedVersionCheck);
-  const openCodeConfigSnapshot = opencodeConfigSnapshot();
+  let openCodeConfigSnapshot = opencodeConfigSnapshot();
   const inspectOpenCode = surface === "opencode" || openCodeConfigSnapshot.hasConfig || runExtended;
   if (inspectOpenCode) {
     let opencodeConfigCheck = buildOpencodeConfigPluginCheck({
@@ -19611,14 +19775,14 @@ async function runDoctor(opts, io = consoleIo) {
     });
     if (!opencodeConfigCheck.ok && opencodeConfigCheck.reason !== "unreadable-config" && opencodeConfigCheck.reason !== "invalid-plugin-shape" && repairLocal) {
       if (writeOpencodeConfigPlugin(openCodeConfigSnapshot)) {
-        const refreshed = opencodeConfigSnapshot();
+        openCodeConfigSnapshot = opencodeConfigSnapshot();
         opencodeConfigCheck = buildOpencodeConfigPluginCheck({
           isOrgRepo: Boolean(cfg.sagaApiUrl),
-          configPath: refreshed.path,
-          hasConfig: refreshed.hasConfig,
-          hasPluginField: refreshed.hasPluginField,
-          pluginEntries: refreshed.pluginEntries,
-          parseOk: refreshed.parseOk
+          configPath: openCodeConfigSnapshot.path,
+          hasConfig: openCodeConfigSnapshot.hasConfig,
+          hasPluginField: openCodeConfigSnapshot.hasPluginField,
+          pluginEntries: openCodeConfigSnapshot.pluginEntries,
+          parseOk: openCodeConfigSnapshot.parseOk
         });
         if (opencodeConfigCheck.ok) {
           markPluginReloadRequired();
@@ -19627,11 +19791,55 @@ async function runDoctor(opts, io = consoleIo) {
       }
     }
     checks.push(opencodeConfigCheck);
-    checks.push(buildOpencodeVersionCheck({
+    let opencodeInstalledVersion = opencodeInstalledVersionForDoctor();
+    let opencodeVersionCheck = buildOpencodeVersionCheck({
       isOrgRepo: Boolean(cfg.sagaApiUrl),
-      installedVersion: process.env.MMI_OPENCODE_PLUGIN_VERSION,
+      installedVersion: opencodeInstalledVersion,
       releasedVersion
-    }));
+    });
+    if (!opencodeVersionCheck.ok && repairFull) {
+      if (await forceInstallOpencodeMmiPlugins(openCodeConfigSnapshot, (m) => io.err(m))) {
+        opencodeInstalledVersion = readOpencodeAdapterDiskVersion() ?? opencodeInstalledVersion;
+        opencodeVersionCheck = buildOpencodeVersionCheck({
+          isOrgRepo: Boolean(cfg.sagaApiUrl),
+          installedVersion: opencodeInstalledVersion,
+          releasedVersion
+        });
+        if (opencodeVersionCheck.ok) {
+          markPluginReloadRequired();
+          io.err(`  \u21BB force-refreshed OpenCode MMI plugin \u2192 ${opencodeInstalledVersion ?? releasedVersion ?? "latest"} \u2014 ${reloadAction("opencode")} to load it`);
+        }
+      }
+    }
+    checks.push(opencodeVersionCheck);
+    let surfaceAssetsCheck = buildOpencodeSurfaceAssetsCheck({
+      isOrgRepo: Boolean(cfg.sagaApiUrl),
+      configPath: openCodeConfigSnapshot.path,
+      commandsDir: opencodeCommandsDir(),
+      existingCommands: opencodeExistingCommands(),
+      skillsPath: opencodeSkillsPath(),
+      configuredSkillsPaths: openCodeConfigSnapshot.skillsPaths
+    });
+    if (!surfaceAssetsCheck.ok && repairLocal) {
+      const wroteCommands = surfaceAssetsCheck.missingCommands?.length ? writeOpencodeCommandFiles() : true;
+      const wroteSkills = surfaceAssetsCheck.hasSkillsPath ? true : writeOpencodeSkillsPath(openCodeConfigSnapshot, opencodeSkillsPath());
+      if (wroteCommands || wroteSkills) {
+        openCodeConfigSnapshot = opencodeConfigSnapshot();
+        surfaceAssetsCheck = buildOpencodeSurfaceAssetsCheck({
+          isOrgRepo: Boolean(cfg.sagaApiUrl),
+          configPath: openCodeConfigSnapshot.path,
+          commandsDir: opencodeCommandsDir(),
+          existingCommands: opencodeExistingCommands(),
+          skillsPath: opencodeSkillsPath(),
+          configuredSkillsPaths: openCodeConfigSnapshot.skillsPaths
+        });
+        if (surfaceAssetsCheck.ok) {
+          markPluginReloadRequired();
+          io.err(`  \u21BB materialized OpenCode MMI commands + skills path \u2014 ${reloadAction("opencode")} to load them`);
+        }
+      }
+    }
+    checks.push(surfaceAssetsCheck);
     checks.push(buildOpencodeDesktopBootstrapCheck({
       isOrgRepo: Boolean(cfg.sagaApiUrl),
       surface,
@@ -19885,7 +20093,7 @@ async function runDoctor(opts, io = consoleIo) {
     claudePluginVersions: sourceVersions("claude"),
     codexPluginVersions: sourceVersions("codex"),
     codexCacheVersions: cacheVersionsFor("codex"),
-    opencodePluginVersions: [process.env.MMI_OPENCODE_PLUGIN_VERSION],
+    opencodePluginVersions: opencodePluginVersionsForReport(),
     releasedVersion
   });
   const resources = doctorResourcesForGaps(gaps);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutmutco/cli",
-  "version": "2.50.0",
+  "version": "2.51.0",
   "description": "MMI Future CLI — delivers the org rules (whole-file), plus saga and KB access. The cross-IDE engine the plugin's SessionStart hook drives.",
   "type": "module",
   "license": "UNLICENSED",