opencode-agenthub 0.1.0

package/dist/skills/agenthub-doctor/interactive.js

@@ -0,0 +1,756 @@
+import readline from "node:readline/promises";
+import { readdir, readFile, access, writeFile } from "node:fs/promises";
+import path from "node:path";
+import {
+  loadNativeOpenCodeConfig,
+  readAgentHubSettings,
+  writeAgentHubSettings
+} from "../../composer/settings.js";
+import {
+  fixMissingGuards,
+  createBundleForSoul,
+  createProfile,
+  resolveDefaultAgentForBundles
+} from "./fix.js";
+const pathExists = async (p) => {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+};
+const readJson = async (filePath) => {
+  const content = await readFile(filePath, "utf-8");
+  return JSON.parse(content);
+};
+const writeJson = async (filePath, data) => {
+  await writeFile(filePath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+};
+async function interactiveDoctor(targetRoot, report) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    while (true) {
+      process.stdout.write("\n");
+      process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+      process.stdout.write("  Agent Hub Doctor - Main Menu\n");
+      process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+      process.stdout.write("What do you want to do?\n\n");
+      process.stdout.write("  1. Create a bundle\n");
+      process.stdout.write("  2. Create a profile\n");
+      process.stdout.write("  3. Assign skills to a bundle\n");
+      process.stdout.write("  4. Add bundle(s) to a profile\n");
+      process.stdout.write("  5. Apply/modify guards\n");
+      process.stdout.write("  6. Fix setup issues\n");
+      process.stdout.write("  7. Show current structure\n");
+      process.stdout.write("  8. Manage agent models\n");
+      process.stdout.write("  9. Exit\n\n");
+      const choice = await rl.question("Select [1-9]: ");
+      const choiceNum = parseInt(choice.trim(), 10);
+      switch (choiceNum) {
+        case 1:
+          await createBundleFlow(rl, targetRoot);
+          break;
+        case 2:
+          await createProfileFlow(rl, targetRoot);
+          break;
+        case 3:
+          await assignSkillsFlow(rl, targetRoot);
+          break;
+        case 4:
+          await addBundleToProfileFlow(rl, targetRoot);
+          break;
+        case 5:
+          await applyGuardsFlow(rl, targetRoot);
+          break;
+        case 6:
+          await fixIssuesFlow(rl, targetRoot, report);
+          break;
+        case 7:
+          await showStructure(targetRoot);
+          break;
+        case 8:
+          await manageAgentModelsFlow(rl, targetRoot);
+          break;
+        case 9:
+          process.stdout.write("\nGoodbye!\n");
+          return;
+        default:
+          process.stdout.write("\nInvalid choice. Please select 1-9.\n");
+      }
+    }
+  } finally {
+    rl.close();
+  }
+}
+async function createBundleFlow(rl, targetRoot) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Create Bundle\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  const souls = await getAvailableSouls(targetRoot);
+  if (souls.length === 0) {
+    process.stdout.write("No souls found. Import or create souls first.\n");
+    return;
+  }
+  process.stdout.write("Available souls:\n");
+  for (const soul of souls) {
+    process.stdout.write(`  - ${soul}
+`);
+  }
+  process.stdout.write("\n");
+  const soulName = await rl.question("Select soul: ");
+  if (!soulName.trim() || !souls.includes(soulName.trim())) {
+    process.stdout.write("Invalid soul selection. Cancelled.\n");
+    return;
+  }
+  process.stdout.write(
+    "\n\u26A0\uFE0F  Note: Skills are globally mounted, not exclusive to this bundle.\n"
+  );
+  const skillsInput = await rl.question(
+    "Skills (comma-separated, or press Enter to skip): "
+  );
+  const additionalSkills = skillsInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  const mcps = await getAvailableMcps(targetRoot);
+  let selectedMcps = [];
+  if (mcps.length > 0) {
+    process.stdout.write("\nAvailable MCP servers:\n");
+    for (const mcp of mcps) {
+      process.stdout.write(`  - ${mcp}
+`);
+    }
+    process.stdout.write("\n");
+    const mcpsInput = await rl.question(
+      "Select MCP servers (comma-separated, or press Enter to skip): "
+    );
+    selectedMcps = mcpsInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  }
+  process.stdout.write(
+    "\n\u2705 Guards are per-agent and will actually restrict this agent's permissions.\n"
+  );
+  process.stdout.write("Available guards:\n");
+  process.stdout.write("  - read_only: Block edit, write, bash\n");
+  process.stdout.write("  - no_task: Block task tool\n");
+  process.stdout.write("  - no_subagent: Legacy alias for no_task\n");
+  process.stdout.write("  - no_omo: Block OMO multi-agent calls\n\n");
+  const guardsInput = await rl.question(
+    "Select guards (comma-separated, or press Enter for none): "
+  );
+  const selectedGuards = guardsInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  process.stdout.write("\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n");
+  process.stdout.write("Agent Configuration\n");
+  process.stdout.write("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n");
+  const agentName = await rl.question(
+    `Agent name [default: ${soulName.trim()}]: `
+  );
+  const finalAgentName = agentName.trim() || soulName.trim();
+  const modeInput = await rl.question("Mode [primary/subagent, default: primary]: ");
+  const mode = modeInput.trim() === "subagent" ? "subagent" : "primary";
+  const modelInput = await rl.question(
+    "Model [default: github-copilot/claude-sonnet-4.5]: "
+  );
+  const model = modelInput.trim() || "github-copilot/claude-sonnet-4.5";
+  const result = await createBundleForSoul(targetRoot, soulName.trim(), {
+    agentName: finalAgentName,
+    mode,
+    skills: additionalSkills,
+    mcp: selectedMcps,
+    guards: selectedGuards,
+    model
+  });
+  process.stdout.write(`
+${result.success ? "\u2713" : "\u2717"} ${result.message}
+`);
+  if (!result.success) return;
+  const addToProfile = await promptBoolean(
+    rl,
+    "\nAdd this bundle to a profile?",
+    true
+  );
+  if (addToProfile) {
+    await addBundleToProfileFlow(rl, targetRoot, soulName.trim());
+  }
+}
+async function createProfileFlow(rl, targetRoot) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Create Profile\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  const bundles = await getAvailableBundles(targetRoot);
+  if (bundles.length === 0) {
+    process.stdout.write("No bundles found. Create bundles first.\n");
+    return;
+  }
+  process.stdout.write("Available bundles:\n");
+  for (const bundle of bundles) {
+    process.stdout.write(`  - ${bundle}
+`);
+  }
+  process.stdout.write("\n");
+  const bundlesInput = await rl.question(
+    "Select bundles (comma-separated): "
+  );
+  const selectedBundles = bundlesInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (selectedBundles.length === 0) {
+    process.stdout.write("No bundles selected. Cancelled.\n");
+    return;
+  }
+  const name = await rl.question("Profile name [default: imported]: ");
+  const profileName = name.trim() || "imported";
+  const description = await rl.question(
+    "Description (optional, press Enter to skip): "
+  );
+  process.stdout.write(`
+Selected bundles: ${selectedBundles.join(", ")}
+`);
+  const suggestedDefaultAgent = await resolveDefaultAgentForBundles(
+    targetRoot,
+    selectedBundles
+  );
+  const defaultAgentInput = await rl.question(
+    `Default agent [default: ${suggestedDefaultAgent}]: `
+  );
+  const defaultAgent = defaultAgentInput.trim() || suggestedDefaultAgent;
+  const result = await createProfile(targetRoot, profileName, {
+    bundleNames: selectedBundles,
+    description: description.trim() || "Auto-generated profile",
+    defaultAgent
+  });
+  process.stdout.write(`
+${result.success ? "\u2713" : "\u2717"} ${result.message}
+`);
+}
+async function assignSkillsFlow(rl, targetRoot) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Assign Skills to Bundle\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  process.stdout.write("\u26A0\uFE0F  Important:\n");
+  process.stdout.write("  Skills are globally mounted to .opencode-agenthub/current/skills/\n");
+  process.stdout.write("  This is NOT 'exclusive' or 'isolated' per-agent.\n");
+  process.stdout.write("  Assignment only writes to the agent's config for organization.\n\n");
+  const profiles = await getAvailableProfiles(targetRoot);
+  if (profiles.length === 0) {
+    process.stdout.write("No profiles found. Create a profile first.\n");
+    return;
+  }
+  process.stdout.write("Available profiles:\n");
+  for (const profile2 of profiles) {
+    process.stdout.write(`  - ${profile2}
+`);
+  }
+  process.stdout.write("\n");
+  const profileName = await rl.question("Select profile: ");
+  if (!profileName.trim() || !profiles.includes(profileName.trim())) {
+    process.stdout.write("Invalid profile. Cancelled.\n");
+    return;
+  }
+  const profilePath = path.join(targetRoot, "profiles", `${profileName.trim()}.json`);
+  const profile = await readJson(profilePath);
+  const agents = profile.bundles || [];
+  if (agents.length === 0) {
+    process.stdout.write("No agents in this profile. Cancelled.\n");
+    return;
+  }
+  process.stdout.write("\nAgents in this profile:\n");
+  for (const agent of agents) {
+    process.stdout.write(`  - ${agent}
+`);
+  }
+  process.stdout.write("\n");
+  const agentName = await rl.question("Select agent: ");
+  if (!agentName.trim() || !agents.includes(agentName.trim())) {
+    process.stdout.write("Invalid agent. Cancelled.\n");
+    return;
+  }
+  const skills = await getAvailableSkills(targetRoot);
+  if (skills.length === 0) {
+    process.stdout.write("No skills found. Import skills first.\n");
+    return;
+  }
+  process.stdout.write("\nAvailable skills:\n");
+  for (const skill of skills) {
+    process.stdout.write(`  - ${skill}
+`);
+  }
+  process.stdout.write("\n");
+  const skillsInput = await rl.question(
+    "Select skills to add (comma-separated): "
+  );
+  const selectedSkills = skillsInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (selectedSkills.length === 0) {
+    process.stdout.write("No skills selected. Cancelled.\n");
+    return;
+  }
+  const bundlePath = path.join(
+    targetRoot,
+    "bundles",
+    `${agentName.trim()}.json`
+  );
+  const bundle = await readJson(bundlePath);
+  bundle.skills = unique([...bundle.skills || [], ...selectedSkills]);
+  await writeJson(bundlePath, bundle);
+  process.stdout.write(`
+\u2713 Updated bundle skills: ${agentName.trim()}
+`);
+}
+async function addBundleToProfileFlow(rl, targetRoot, preselectedBundle) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Add Bundle(s) to Profile\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  const profiles = await getAvailableProfiles(targetRoot);
+  if (profiles.length === 0) {
+    process.stdout.write("No profiles found. Create a profile first.\n");
+    return;
+  }
+  process.stdout.write("Available profiles:\n");
+  for (const profile2 of profiles) {
+    process.stdout.write(`  - ${profile2}
+`);
+  }
+  process.stdout.write("\n");
+  const profileName = await rl.question("Select profile: ");
+  if (!profileName.trim() || !profiles.includes(profileName.trim())) {
+    process.stdout.write("Invalid profile. Cancelled.\n");
+    return;
+  }
+  const bundles = await getAvailableBundles(targetRoot);
+  const profilePath = path.join(targetRoot, "profiles", `${profileName.trim()}.json`);
+  const profile = await readJson(profilePath);
+  const existingBundles = profile.bundles || [];
+  const availableBundles = bundles.filter((b) => !existingBundles.includes(b));
+  if (availableBundles.length === 0) {
+    process.stdout.write("No new bundles to add.\n");
+    return;
+  }
+  process.stdout.write("\nAvailable bundles (not in profile):\n");
+  for (const bundle of availableBundles) {
+    process.stdout.write(`  - ${bundle}
+`);
+  }
+  process.stdout.write("\n");
+  let selectedBundles;
+  if (preselectedBundle) {
+    selectedBundles = [preselectedBundle];
+  } else {
+    const bundlesInput = await rl.question(
+      "Select bundles (comma-separated): "
+    );
+    selectedBundles = bundlesInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  }
+  if (selectedBundles.length === 0) {
+    process.stdout.write("No bundles selected. Cancelled.\n");
+    return;
+  }
+  profile.bundles = unique([...existingBundles, ...selectedBundles]);
+  await writeJson(profilePath, profile);
+  process.stdout.write(
+    `
+\u2713 Added ${selectedBundles.length} bundle(s) to profile: ${profileName.trim()}
+`
+  );
+}
+async function applyGuardsFlow(rl, targetRoot) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Apply / Modify Guards\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  process.stdout.write("\u2705 Guards are per-agent permission controls.\n");
+  process.stdout.write("They will actually restrict what this agent can do.\n\n");
+  const bundles = await getAvailableBundles(targetRoot);
+  if (bundles.length === 0) {
+    process.stdout.write("No bundles found. Create bundles first.\n");
+    return;
+  }
+  process.stdout.write("Available bundles:\n");
+  for (const bundle2 of bundles) {
+    process.stdout.write(`  - ${bundle2}
+`);
+  }
+  process.stdout.write("\n");
+  const bundleName = await rl.question("Select bundle: ");
+  if (!bundleName.trim() || !bundles.includes(bundleName.trim())) {
+    process.stdout.write("Invalid bundle. Cancelled.\n");
+    return;
+  }
+  const bundlePath = path.join(targetRoot, "bundles", `${bundleName.trim()}.json`);
+  const bundle = await readJson(bundlePath);
+  const currentGuards = bundle.guards || [];
+  process.stdout.write(`
+Current guards: ${currentGuards.length > 0 ? currentGuards.join(", ") : "none"}
+
+`);
+  process.stdout.write("Available guards:\n");
+  process.stdout.write("  - read_only: Block edit, write, bash\n");
+  process.stdout.write("  - no_task: Block task tool\n");
+  process.stdout.write("  - no_subagent: Legacy alias for no_task\n");
+  process.stdout.write("  - no_omo: Block OMO multi-agent calls\n\n");
+  process.stdout.write("\u26A0\uFE0F  blockedTools limitation:\n");
+  process.stdout.write("  Currently uses 'union blocking' strategy.\n");
+  process.stdout.write("  If ANY agent blocks a tool, it's blocked for ALL agents.\n");
+  process.stdout.write("  This is because the plugin cannot determine current agent in hooks.\n\n");
+  const guardsInput = await rl.question(
+    "Select guards (comma-separated, or press Enter for none): "
+  );
+  const selectedGuards = guardsInput.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  bundle.guards = selectedGuards.length > 0 ? selectedGuards : void 0;
+  await writeJson(bundlePath, bundle);
+  process.stdout.write(
+    `
+\u2713 Updated guards for bundle: ${bundleName.trim()}
+`
+  );
+}
+async function fixIssuesFlow(rl, targetRoot, report) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Fix Setup Issues\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  if (!report) {
+    const { runDiagnostics } = await import("./diagnose.js");
+    process.stdout.write("Scanning...\n\n");
+    report = await runDiagnostics(targetRoot);
+  }
+  if (report.issues.length === 0) {
+    process.stdout.write("\u2705 No issues found!\n");
+    return;
+  }
+  process.stdout.write("Issues found:\n");
+  for (const issue of report.issues) {
+    const icon = issue.severity === "error" ? "\u274C" : issue.severity === "warning" ? "\u26A0\uFE0F " : "\u2139\uFE0F ";
+    process.stdout.write(`  ${icon} ${issue.message}
+`);
+  }
+  process.stdout.write("\n");
+  const shouldFix = await promptBoolean(rl, "Fix these issues?", true);
+  if (!shouldFix) {
+    process.stdout.write("No fixes applied.\n");
+    return;
+  }
+  process.stdout.write("\n");
+  const missingGuardsIssue = report.issues.find(
+    (i) => i.type === "missing_guards"
+  );
+  if (missingGuardsIssue) {
+    const guards = missingGuardsIssue.details.guards;
+    const result = await fixMissingGuards(targetRoot, guards);
+    process.stdout.write(`${result.success ? "\u2713" : "\u2717"} ${result.message}
+`);
+  }
+  const orphanedSoulsIssue = report.issues.find(
+    (i) => i.type === "orphaned_souls"
+  );
+  if (orphanedSoulsIssue) {
+    const souls = orphanedSoulsIssue.details.souls;
+    for (const soul of souls) {
+      const result = await createBundleForSoul(targetRoot, soul);
+      process.stdout.write(`${result.success ? "\u2713" : "\u2717"} ${result.message}
+`);
+    }
+  }
+  const noProfilesIssue = report.issues.find((i) => i.type === "no_profiles");
+  if (noProfilesIssue) {
+    const bundles = await getAvailableBundles(targetRoot);
+    if (bundles.length > 0) {
+      const result = await createProfile(targetRoot, "imported", {
+        bundleNames: bundles
+      });
+      process.stdout.write(
+        `${result.success ? "\u2713" : "\u2717"} ${result.message}
+`
+      );
+    }
+  }
+  process.stdout.write("\n\u2705 Fixes applied!\n");
+}
+async function showStructure(targetRoot) {
+  process.stdout.write("\n\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n");
+  process.stdout.write("  Current Structure\n");
+  process.stdout.write("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\n\n");
+  const souls = await getAvailableSouls(targetRoot);
+  process.stdout.write(`\u{1F4C1} Souls (${souls.length}):
+`);
+  for (const soul of souls) {
+    process.stdout.write(`   - ${soul}.md
+`);
+  }
+  process.stdout.write("\n");
+  const skills = await getAvailableSkills(targetRoot);
+  process.stdout.write(
+    `\u{1F4C1} Skills (${skills.length}) [globally mounted, no per-agent isolation]:
+`
+  );
+  process.stdout.write(`   - ${skills.join(", ")}
+
+`);
+  const bundles = await getAvailableBundles(targetRoot);
+  process.stdout.write(`\u{1F4C1} Bundles (${bundles.length}):
+`);
+  for (const bundleName of bundles) {
+    const bundlePath = path.join(targetRoot, "bundles", `${bundleName}.json`);
+    try {
+      const bundle = await readJson(bundlePath);
+      const soul = bundle.soul || "none";
+      const skills2 = bundle.skills?.join(", ") || "none";
+      const guards = bundle.guards?.join(", ") || "none";
+      const runtime = bundle.runtime || "native";
+      process.stdout.write(
+        `   - ${bundleName}: soul=${soul}, skills=${skills2}, guards=${guards}, runtime=${runtime}
+`
+      );
+    } catch {
+      process.stdout.write(`   - ${bundleName}: (error reading)
+`);
+    }
+  }
+  process.stdout.write("\n");
+  const profiles = await getAvailableProfiles(targetRoot);
+  process.stdout.write(`\u{1F4C1} Profiles (${profiles.length}):
+`);
+  for (const profileName of profiles) {
+    const profilePath = path.join(
+      targetRoot,
+      "profiles",
+      `${profileName}.json`
+    );
+    try {
+      const profile = await readJson(profilePath);
+      const bundles2 = profile.bundles?.join(", ") || "none";
+      const defaultAgent = profile.defaultAgent || "none";
+      process.stdout.write(
+        `   - ${profileName}: [${bundles2}], default=${defaultAgent}
+`
+      );
+    } catch {
+      process.stdout.write(`   - ${profileName}: (error reading)
+`);
+    }
+  }
+  process.stdout.write("\n");
+  const nativeAgents = await getNativeAgentMap(targetRoot);
+  const unmanagedNativeAgents = Object.entries(nativeAgents).filter(
+    ([name, details]) => !details.managedByBundle
+  );
+  process.stdout.write(
+    `\u{1F4C1} Native Agents (${unmanagedNativeAgents.length}) [available via native OpenCode config]:
+`
+  );
+  if (unmanagedNativeAgents.length === 0) {
+    process.stdout.write("   - none\n\n");
+  } else {
+    for (const [name, details] of unmanagedNativeAgents) {
+      const override = details.overrideModel ? `, overrideModel=${details.overrideModel}` : "";
+      const model = details.model || "none";
+      process.stdout.write(`   - ${name}: model=${model}${override}
+`);
+    }
+    process.stdout.write("\n");
+  }
+  process.stdout.write("\u{1F4C1} Guards (per-agent permission controls):\n");
+  process.stdout.write("   - read_only: Block edit, write, bash\n");
+  process.stdout.write("   - no_task: Block task tool\n");
+  process.stdout.write("   - no_subagent: Legacy alias for no_task\n");
+  process.stdout.write("   - no_omo: Block OMO multi-agent calls\n\n");
+  process.stdout.write("\u26A0\uFE0F  Important Notes:\n");
+  process.stdout.write("   - Skills are globally mounted, not per-agent exclusive\n");
+  process.stdout.write("   - blockedTools uses union blocking (any block = all blocked)\n");
+  process.stdout.write("   - Guards/Permission are true per-agent controls\n");
+}
+async function promptBoolean(rl, question, defaultValue) {
+  const suffix = defaultValue ? "[Y/n]" : "[y/N]";
+  while (true) {
+    const answer = (await rl.question(`${question} ${suffix}: `)).trim().toLowerCase();
+    if (!answer) return defaultValue;
+    if (answer === "y" || answer === "yes") return true;
+    if (answer === "n" || answer === "no") return false;
+    process.stdout.write("Please answer y or n.\n");
+  }
+}
+function unique(arr) {
+  return [...new Set(arr)];
+}
+async function getAvailableSouls(targetRoot) {
+  const soulsDir = path.join(targetRoot, "souls");
+  if (!await pathExists(soulsDir)) return [];
+  const entries = await readdir(soulsDir, { withFileTypes: true });
+  return entries.filter((e) => e.isFile() && e.name.endsWith(".md")).map((e) => e.name.replace(/\.md$/, ""));
+}
+async function getAvailableSkills(targetRoot) {
+  const skillsDir = path.join(targetRoot, "skills");
+  if (!await pathExists(skillsDir)) return [];
+  const entries = await readdir(skillsDir, { withFileTypes: true });
+  return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+}
+async function getAvailableBundles(targetRoot) {
+  const bundlesDir = path.join(targetRoot, "bundles");
+  if (!await pathExists(bundlesDir)) return [];
+  const entries = await readdir(bundlesDir, { withFileTypes: true });
+  return entries.filter((e) => e.isFile() && e.name.endsWith(".json")).map((e) => e.name.replace(/\.json$/, ""));
+}
+async function getAvailableProfiles(targetRoot) {
+  const profilesDir = path.join(targetRoot, "profiles");
+  if (!await pathExists(profilesDir)) return [];
+  const entries = await readdir(profilesDir, { withFileTypes: true });
+  return entries.filter((e) => e.isFile() && e.name.endsWith(".json")).map((e) => e.name.replace(/\.json$/, ""));
+}
+async function getAvailableMcps(targetRoot) {
+  const mcpDir = path.join(targetRoot, "mcp");
+  if (!await pathExists(mcpDir)) return [];
+  const entries = await readdir(mcpDir, { withFileTypes: true });
+  return entries.filter((e) => e.isFile() && e.name.endsWith(".json")).map((e) => e.name.replace(/\.json$/, ""));
+}
+async function getBundleAgentNames(targetRoot) {
+  const bundles = await getAvailableBundles(targetRoot);
+  const names = [];
+  for (const bundleName of bundles) {
+    const bundlePath = path.join(targetRoot, "bundles", `${bundleName}.json`);
+    try {
+      const bundle = await readJson(bundlePath);
+      if (bundle.agent?.name) names.push(bundle.agent.name);
+    } catch {
+    }
+  }
+  return unique(names);
+}
+async function getNativeAgentMap(targetRoot) {
+  const nativeConfig = await loadNativeOpenCodeConfig();
+  const settings = await readAgentHubSettings(targetRoot);
+  const bundleAgentNames = new Set(await getBundleAgentNames(targetRoot));
+  const agentEntries = Object.entries(nativeConfig?.agent || {}).filter(
+    ([, agent]) => agent && typeof agent === "object"
+  );
+  return Object.fromEntries(
+    agentEntries.map(([name, agent]) => [
+      name,
+      {
+        model: typeof agent.model === "string" && agent.model.trim().length > 0 ? agent.model : void 0,
+        overrideModel: settings?.agents?.[name]?.model,
+        managedByBundle: bundleAgentNames.has(name)
+      }
+    ])
+  );
+}
+async function manageAgentModelsFlow(rl, targetRoot) {
+  const settings = await readAgentHubSettings(targetRoot) || {};
+  const nativeAgents = await getNativeAgentMap(targetRoot);
+  const bundleAgentNames = await getBundleAgentNames(targetRoot);
+  const allAgentNames = unique([
+    ...bundleAgentNames,
+    ...Object.keys(nativeAgents),
+    ...Object.keys(settings.agents || {})
+  ]);
+  if (allAgentNames.length === 0) {
+    process.stdout.write("\nNo agents available to manage.\n");
+    return;
+  }
+  process.stdout.write("\nAvailable agents:\n");
+  for (const [index, name] of allAgentNames.entries()) {
+    const native = nativeAgents[name];
+    const source = bundleAgentNames.includes(name) ? native ? "managed + native" : "managed" : native ? "native unmanaged" : "settings-only";
+    const currentModel2 = settings.agents?.[name]?.model || native?.model || "none";
+    process.stdout.write(
+      `  ${index + 1}. ${name} (${source}, model=${currentModel2})
+`
+    );
+  }
+  const answer = await rl.question(
+    "\nSelect agent number to update model (or Enter to cancel): "
+  );
+  if (!answer.trim()) return;
+  const selectedIndex = Number.parseInt(answer.trim(), 10);
+  if (!Number.isFinite(selectedIndex) || selectedIndex < 1 || selectedIndex > allAgentNames.length) {
+    process.stdout.write("Invalid selection.\n");
+    return;
+  }
+  const agentName = allAgentNames[selectedIndex - 1];
+  const currentModel = settings.agents?.[agentName]?.model || nativeAgents[agentName]?.model || "";
+  const nextModel = await rl.question(
+    `New model for '${agentName}' (current: ${currentModel || "none"}; blank clears override): `
+  );
+  process.stdout.write(`${await updateAgentModelOverride(targetRoot, agentName, nextModel)}
+`);
+}
+async function updateAgentModelOverride(targetRoot, agentName, model) {
+  const settings = await readAgentHubSettings(targetRoot) || {};
+  const trimmed = model.trim();
+  settings.agents = settings.agents || {};
+  const existing = settings.agents[agentName] || {};
+  if (!trimmed) {
+    const { model: _ignored, ...rest } = existing;
+    if (Object.keys(rest).length > 0) {
+      settings.agents[agentName] = rest;
+    } else {
+      delete settings.agents[agentName];
+    }
+    if (Object.keys(settings.agents).length === 0) {
+      delete settings.agents;
+    }
+    await writeAgentHubSettings(targetRoot, settings);
+    return `Cleared model override for '${agentName}'.`;
+  }
+  settings.agents[agentName] = {
+    ...existing,
+    model: trimmed
+  };
+  await writeAgentHubSettings(targetRoot, settings);
+  return `Updated model for '${agentName}' to '${trimmed}'.`;
+}
+async function updateAgentPromptOverride(targetRoot, agentName, prompt) {
+  const settings = await readAgentHubSettings(targetRoot) || {};
+  const trimmed = prompt.trim();
+  settings.agents = settings.agents || {};
+  const existing = settings.agents[agentName] || {};
+  if (!trimmed) {
+    const { prompt: _ignored, ...rest } = existing;
+    if (Object.keys(rest).length > 0) {
+      settings.agents[agentName] = rest;
+    } else {
+      delete settings.agents[agentName];
+    }
+    if (Object.keys(settings.agents).length === 0) {
+      delete settings.agents;
+    }
+    await writeAgentHubSettings(targetRoot, settings);
+    return `Cleared prompt override for '${agentName}'.`;
+  }
+  settings.agents[agentName] = {
+    ...existing,
+    prompt: trimmed
+  };
+  await writeAgentHubSettings(targetRoot, settings);
+  return `Updated prompt override for '${agentName}'.`;
+}
+async function interactiveAssembly(targetRoot, report, options = {}) {
+  if (report.issues.length === 0) {
+    if (options.continueToMenu === false) return;
+    await interactiveDoctor(targetRoot, report);
+    return;
+  }
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  try {
+    process.stdout.write("\n\u26A0\uFE0F  Issues Found:\n");
+    for (const issue of report.issues) {
+      const icon = issue.severity === "error" ? "\u274C" : issue.severity === "warning" ? "\u26A0\uFE0F " : "\u2139\uFE0F ";
+      process.stdout.write(`  ${icon} ${issue.message}
+`);
+    }
+    process.stdout.write("\n");
+    await fixIssuesFlow(rl, targetRoot, report);
+    if (options.continueToMenu === false) return;
+    const continueToMenu = await promptBoolean(rl, "\nContinue to main menu?", true);
+    if (continueToMenu) {
+      rl.close();
+      await interactiveDoctor(targetRoot);
+    }
+  } finally {
+    rl.close();
+  }
+}
+export {
+  getAvailableBundles,
+  interactiveAssembly,
+  interactiveDoctor,
+  updateAgentModelOverride,
+  updateAgentPromptOverride
+};