opencode-manifold 0.4.7 → 0.4.9

package/README.md

@@ -71,8 +71,10 @@ Open Manifold requires:
 
 1. **Install** using one of the methods above
 2. **Run `/manifold-init`** in the opencode TUI to set up agents, skills, and the Manifold directory
-3. **Create a plan** — any format (markdown, TODO list, email, meeting notes)
-4. **Point the Lead Dev agent** at your plan file and tell it to execute
+3. **(Optional) Run `/manifold-models`** to configure which models each sub-agent uses
+4. **(Optional) Run `/manifold-update`** to clear plugin cache before updating (requires path configuration)
+5. **Create a plan** — any format (markdown, TODO list, email, meeting notes)
+6. **Point the Lead Dev agent** at your plan file and tell it to execute
 
 The Lead Dev will:
 - Extract tasks from your plan
@@ -180,7 +182,13 @@ rm -rf .opencode/agents/ .opencode/skills/ Manifold/
 
 ### Assigning models to agents
 
-Add a `model` field to the agent's frontmatter or your `opencode.json`:
+**Interactive (Recommended):** Run `/manifold-models` in the TUI. You'll be prompted to:
+1. Select a sub-agent (clerk, senior-dev, junior-dev, or debug)
+2. Choose from all available models in your configured providers
+
+This updates the agent's frontmatter automatically.
+
+**Manual:** Add a `model` field to the agent's frontmatter or your `opencode.json`:
 
 ```json
 {
@@ -203,8 +211,8 @@ See the [Example Configurations](#example-configurations) section for model pair
 
 | Budget | Senior Dev | Junior Dev | Debug |
 |--------|-----------|-----------|-------|
-| Cost-effective | MiniMax-2.7 | Qwen-3.5 122B-A10B | GLM 5.1 |
-| Balanced | GLM 5.1 | Minimax-2.7 | GPT 5.4 mini |
+| Self Host | Qwen3.5 27B | Gemma 4 31B | GLM 4.7 Flash |
+| Cost-effective | Qwen3.5 397B A17B | MiniMax-2.7 | GLM 5.1 |
 | Premium | Claude Opus | GPT 5.4 | Gemini 3.1 pro |
 
 Models change frequently. These examples prioritize sr/debug diversity and cost gradient.
@@ -245,6 +253,7 @@ Located at `Manifold/settings.json`:
 | `clerkRetryEnabled` | true | Clerk gets second pass after Debug fails |
 | `timeout` | 300 | Max seconds per agent call |
 | `testCommand` | null | Default test command |
+| `updateCachePaths` | `[]` | Paths to clear when running `/manifold-update` (see [Plugin Updates](#plugin-updates)) |
 
 ---
 
@@ -288,6 +297,62 @@ A: The system is designed around the Clerk's ability to research context via sem
 
 ---
 
+## Plugin Updates
+
+Opencode caches plugins to improve startup performance. When a new version of `opencode-manifold` is published, you may need to clear the cache to receive the update.
+
+### Using `/manifold-update`
+
+1. **Configure cache paths** in `Manifold/settings.json`:
+   ```json
+   {
+     "updateCachePaths": [
+       "~/.cache/opencode/packages/opencode-manifold@latest",
+       "~/node_modules/opencode-manifold"
+     ]
+   }
+   ```
+
+2. **Run `/manifold-update`** in the TUI
+3. **Confirm** the paths to clear
+4. **Restart opencode** to pull the fresh version
+
+### Safety Features
+
+The command includes built-in protections:
+- **Wildcards blocked:** Paths with `*` are rejected
+- **System paths protected:** `/`, `/System`, `/Applications`, home directory, etc. cannot be deleted
+- **Project detection:** Directories containing `.git` + `opencode.json` or `package.json` are treated as projects and blocked
+- **Explicit confirmation:** You must type "yes" to proceed
+
+### Platform-Specific Paths
+
+**macOS:**
+```json
+[
+  "~/.cache/opencode/packages/opencode-manifold@latest",
+  "~/node_modules/opencode-manifold"
+]
+```
+
+**Linux:**
+```json
+[
+  "~/.cache/opencode/packages/opencode-manifold@latest"
+]
+```
+
+**Windows:**
+```json
+[
+  "%LOCALAPPDATA%/opencode/packages/opencode-manifold@latest"
+]
+```
+
+If your cache is stored elsewhere, add the full path to `updateCachePaths`. The command is intentionally conservative — it's safer to manually clear cache than to accidentally delete project files.
+
+---
+
 ## Uninstall
 
 To remove Open Manifold from a project:
@@ -307,26 +372,20 @@ rm -rf ~/.config/opencode/manifold/ ~/.config/opencode/commands/manifold-init.md
 To fully uninstall the plugin, also remove `"opencode-manifold"` from the `plugin` array in your global or project `opencode.json`.
 
 ### Complete Clean Uninstall
-# Mac:
-OpenCode caches plugins in multiple locations. To fully clear all cached versions before reinstalling:
+
+For a full clean reinstall, use `/manifold-update` (see [Plugin Updates](#plugin-updates)) to clear caches, then:
 
 ```bash
-# Remove plugin from all cache locations
-rm -rf ~/node_modules/opencode-manifold
-rm -rf ~/.cache/opencode/packages/opencode-manifold@latest
-rm -rf ~/.config/opencode/manifold/
-rm -rf ~/.config/opencode/commands/manifold-init.md
+# Remove project files
+rm -rf .opencode/agents/ .opencode/skills/ Manifold/
 
-# Then restart opencode and run /manifold-init
+# Remove global templates
+rm -rf ~/.config/opencode/manifold/ ~/.config/opencode/commands/manifold-init.md
 ```
 
-This ensures you're running the latest version after updates.
-
-# Win:
-I have no clue. Use linux.
+Then remove `"opencode-manifold"` from your `opencode.json` plugin array.
 
-# Linux:
-Still have no clue but I know you can handle it. 
+---
 
 ---
 

package/dist/index.js

@@ -4074,7 +4074,8 @@ async function readSettings(directory) {
     recentTaskCount: 3,
     clerkRetryEnabled: true,
     timeout: 300,
-    testCommand: null
+    testCommand: null,
+    updateCachePaths: []
   };
 }
 async function updatePlansRegistry(directory, planFile) {
@@ -4191,6 +4192,484 @@ ${testResult.result.output}`,
   }
 });
 
+// src/tools/set-subagent-model.ts
+import { readFile as readFile5, writeFile as writeFile5, readdir as readdir3 } from "fs/promises";
+import { existsSync as existsSync6 } from "fs";
+import { join as join6 } from "path";
+import { homedir as homedir2 } from "os";
+var MANIFOLD_AGENTS = ["clerk", "senior-dev", "junior-dev", "debug"];
+async function getManifoldAgents(directory) {
+  const agentsDir = join6(directory, ".opencode", "agents");
+  if (!existsSync6(agentsDir)) {
+    return [];
+  }
+  const files = await readdir3(agentsDir);
+  const agents = [];
+  for (const file of files) {
+    if (!file.endsWith(".md"))
+      continue;
+    const name = file.replace(".md", "");
+    if (MANIFOLD_AGENTS.includes(name)) {
+      agents.push(name);
+    }
+  }
+  return agents;
+}
+async function getAvailableModels(client) {
+  try {
+    const result = await client.config.providers();
+    const providers = result.data?.providers || [];
+    const models = [];
+    for (const provider of providers) {
+      if (provider.models) {
+        for (const [modelId, model] of Object.entries(provider.models)) {
+          models.push({
+            id: `${provider.id}/${modelId}`,
+            name: model.name || modelId,
+            providerID: provider.id
+          });
+        }
+      }
+    }
+    return models.sort((a, b) => a.name.localeCompare(b.name));
+  } catch (error) {
+    await client.app.log({
+      body: {
+        service: "opencode-manifold",
+        level: "error",
+        message: `Error fetching models: ${error}`
+      }
+    });
+    return [];
+  }
+}
+async function readAgentFile(agentName, directory) {
+  const agentPath = join6(directory, ".opencode", "agents", `${agentName}.md`);
+  if (!existsSync6(agentPath)) {
+    const globalPath = join6(homedir2(), ".config", "opencode", "manifold", "agents", `${agentName}.md`);
+    if (existsSync6(globalPath)) {
+      const content2 = await readFile5(globalPath, "utf-8");
+      const { frontmatter: frontmatter2, body: body2 } = parseFrontmatter(content2);
+      return { content: content2, frontmatter: frontmatter2, body: body2 };
+    }
+    throw new Error(`Agent file not found for ${agentName}`);
+  }
+  const content = await readFile5(agentPath, "utf-8");
+  const { frontmatter, body } = parseFrontmatter(content);
+  return { content, frontmatter, body };
+}
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { frontmatter: {}, body: content };
+  }
+  const frontmatterYaml = match[1];
+  const body = match[2];
+  const frontmatter = jsYaml.load(frontmatterYaml) || {};
+  return { frontmatter, body };
+}
+function buildAgentFile(frontmatter, body) {
+  const yamlContent = jsYaml.dump(frontmatter, {
+    lineWidth: -1,
+    noCompatMode: true
+  });
+  return `---
+${yamlContent}---
+${body}`;
+}
+async function updateAgentModel(client, agentName, modelId, directory) {
+  const { frontmatter, body } = await readAgentFile(agentName, directory);
+  frontmatter.model = modelId;
+  const newContent = buildAgentFile(frontmatter, body);
+  const agentPath = join6(directory, ".opencode", "agents", `${agentName}.md`);
+  await writeFile5(agentPath, newContent);
+  await client.app.log({
+    body: {
+      service: "opencode-manifold",
+      level: "info",
+      message: `Updated ${agentName} model to ${modelId}`
+    }
+  });
+}
+async function handleSubModelCommand(client, directory) {
+  await client.app.log({
+    body: {
+      service: "opencode-manifold",
+      level: "info",
+      message: "Starting /sub-model command"
+    }
+  });
+  const agents = await getManifoldAgents(directory);
+  if (agents.length === 0) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: "No Manifold agents found. Run /manifold-init first."
+      }
+    });
+    return;
+  }
+  const models = await getAvailableModels(client);
+  if (models.length === 0) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: "No models available. Configure providers first."
+      }
+    });
+    return;
+  }
+  const agentList = agents.map((a) => `${a} (sub-agent)`).join(`
+`);
+  await client.tui.appendPrompt({
+    body: {
+      type: "text",
+      text: `\uD83D\uDCCB Select a Manifold sub-agent to configure:
+
+${agentList}`
+    }
+  });
+  await client.tui.publish({
+    body: {
+      type: "tui.prompt_append",
+      data: {
+        type: "text",
+        text: `
+
+Type the agent name (clerk, senior-dev, junior-dev, or debug): `
+      }
+    }
+  });
+  const agentResponse = await client.tui.control.next();
+  const selectedAgent = agentResponse.data?.input?.trim().toLowerCase();
+  if (!selectedAgent || !MANIFOLD_AGENTS.includes(selectedAgent)) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: `Invalid agent selection. Must be one of: ${MANIFOLD_AGENTS.join(", ")}`
+      }
+    });
+    return;
+  }
+  if (!agents.includes(selectedAgent)) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: `Agent ${selectedAgent} not found in .opencode/agents/`
+      }
+    });
+    return;
+  }
+  const currentModel = await readAgentFile(selectedAgent, directory).then((f) => f.frontmatter.model || "not set");
+  const modelList = models.map((m, i2) => `${i2 + 1}. ${m.name} (${m.id})`).join(`
+`);
+  await client.tui.appendPrompt({
+    body: {
+      type: "text",
+      text: `
+\uD83D\uDCE6 Available models for ${selectedAgent} (current: ${currentModel}):
+
+${modelList}`
+    }
+  });
+  await client.tui.publish({
+    body: {
+      type: "tui.prompt_append",
+      data: {
+        type: "text",
+        text: `
+
+Type the model number or full model ID (e.g., anthropic/claude-sonnet-4-20250514): `
+      }
+    }
+  });
+  const modelResponse = await client.tui.control.next();
+  const selectedModelInput = modelResponse.data?.input?.trim();
+  if (!selectedModelInput) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: "No model selected"
+      }
+    });
+    return;
+  }
+  let selectedModelId;
+  const modelIndex = parseInt(selectedModelInput, 10) - 1;
+  if (!isNaN(modelIndex) && modelIndex >= 0 && modelIndex < models.length) {
+    selectedModelId = models[modelIndex].id;
+  } else {
+    const found = models.find((m) => m.id.toLowerCase() === selectedModelInput.toLowerCase());
+    if (found) {
+      selectedModelId = found.id;
+    }
+  }
+  if (!selectedModelId) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: `Invalid model selection: ${selectedModelInput}`
+      }
+    });
+    return;
+  }
+  await updateAgentModel(client, selectedAgent, selectedModelId, directory);
+  await client.tui.showToast({
+    body: {
+      type: "success",
+      message: `✅ Set ${selectedAgent} to ${selectedModelId}`
+    }
+  });
+  await client.tui.appendPrompt({
+    body: {
+      type: "text",
+      text: `
+✅ Model updated for ${selectedAgent}: ${selectedModelId}
+`
+    }
+  });
+}
+
+// src/tools/clear-cache.ts
+import { rm } from "fs/promises";
+import { existsSync as existsSync7 } from "fs";
+import { join as join7, isAbsolute } from "path";
+import { homedir as homedir3 } from "os";
+var PROTECTED_PATHS = [
+  "/",
+  "/System",
+  "/Applications",
+  "/Users",
+  "/etc",
+  "/bin",
+  "/sbin",
+  "/usr"
+];
+function resolvePath(pathStr) {
+  const expanded = pathStr.startsWith("~") ? join7(homedir3(), pathStr.slice(1)) : pathStr;
+  return isAbsolute(expanded) ? expanded : join7(process.cwd(), expanded);
+}
+function isPathSafe(pathStr) {
+  const normalized = pathStr.toLowerCase();
+  if (normalized.includes("*")) {
+    return { safe: false, reason: "Wildcards are not allowed for safety" };
+  }
+  for (const protectedPath of PROTECTED_PATHS) {
+    if (normalized === protectedPath.toLowerCase() || normalized.startsWith(protectedPath.toLowerCase() + "/") || normalized.startsWith(protectedPath.toLowerCase() + "\\")) {
+      return { safe: false, reason: `Cannot delete protected system path: ${protectedPath}` };
+    }
+  }
+  if (normalized === homedir3().toLowerCase() || normalized.startsWith(homedir3().toLowerCase() + "/") && !normalized.includes("cache") && !normalized.includes("node_modules")) {
+    const parts = normalized.replace(homedir3().toLowerCase(), "").split(/[\/\\]/).filter(Boolean);
+    if (parts.length === 1) {
+      return { safe: false, reason: "Cannot delete directories directly in home folder" };
+    }
+  }
+  return { safe: true };
+}
+async function isProjectDirectory(pathStr) {
+  try {
+    const hasGit = existsSync7(join7(pathStr, ".git"));
+    const hasOpencodeConfig = existsSync7(join7(pathStr, "opencode.json"));
+    const hasPackageJson = existsSync7(join7(pathStr, "package.json"));
+    if (hasGit && (hasOpencodeConfig || hasPackageJson)) {
+      return true;
+    }
+    const entries = await Promise.all([
+      existsSync7(join7(pathStr, ".git")) ? "git" : null,
+      existsSync7(join7(pathStr, "opencode.json")) ? "opencode" : null
+    ].filter(Boolean));
+    return entries.length >= 2;
+  } catch {
+    return false;
+  }
+}
+async function clearCachePaths(paths) {
+  const cleared = [];
+  const skipped = [];
+  const blocked = [];
+  for (const pathStr of paths) {
+    const resolved = resolvePath(pathStr);
+    const safetyCheck = isPathSafe(resolved);
+    if (!safetyCheck.safe) {
+      blocked.push({ path: resolved, reason: safetyCheck.reason || "Failed safety check" });
+      continue;
+    }
+    if (!existsSync7(resolved)) {
+      skipped.push(resolved);
+      continue;
+    }
+    const isProject = await isProjectDirectory(resolved);
+    if (isProject) {
+      blocked.push({ path: resolved, reason: "Appears to be a project directory (contains .git + config files)" });
+      continue;
+    }
+    try {
+      await rm(resolved, { recursive: true, force: true });
+      cleared.push(resolved);
+    } catch (error) {
+      blocked.push({ path: resolved, reason: `Failed to delete: ${error}` });
+    }
+  }
+  return { cleared, skipped, blocked };
+}
+async function handleUpdateCommand(client, directory) {
+  await client.app.log({
+    body: {
+      service: "opencode-manifold",
+      level: "info",
+      message: "Starting /manifold-update command"
+    }
+  });
+  const settings = await readSettings(directory);
+  const configuredPaths = settings.updateCachePaths || [];
+  if (configuredPaths.length === 0) {
+    const examplePaths = [
+      "~/.cache/opencode/packages/opencode-manifold@latest",
+      "~/node_modules/opencode-manifold"
+    ];
+    await client.tui.appendPrompt({
+      body: {
+        type: "text",
+        text: `\uD83D\uDD04 **Manifold Plugin Update**
+
+No cache paths configured in \`Manifold/settings.json\`.
+
+To enable this feature, add cache paths to your settings:
+
+\`\`\`json
+{
+  "updateCachePaths": [
+    "~/.cache/opencode/packages/opencode-manifold@latest",
+    "~/node_modules/opencode-manifold"
+  ]
+}
+\`\`\`
+
+**Safety features:**
+• Wildcards are blocked
+• System directories are protected
+• Project directories (with .git + config) are protected
+
+**macOS users:** The paths above are typical cache locations.
+**Linux/Windows users:** Add your opencode cache paths manually.
+`
+      }
+    });
+    await client.tui.showToast({
+      body: {
+        type: "info",
+        message: "Configure updateCachePaths in Manifold/settings.json"
+      }
+    });
+    return;
+  }
+  const resolvedPaths = configuredPaths.map(resolvePath);
+  await client.tui.appendPrompt({
+    body: {
+      type: "text",
+      text: `\uD83D\uDD04 **Manifold Plugin Update**
+
+The following paths will be cleared:
+
+${resolvedPaths.map((p) => `• ${p}`).join(`
+`)}
+
+⚠️ **This action is irreversible.** These paths are read from \`Manifold/settings.json\`.
+`
+    }
+  });
+  await client.tui.publish({
+    body: {
+      type: "tui.prompt_append",
+      data: {
+        type: "text",
+        text: `
+
+Type 'yes' to confirm and clear cache: `
+      }
+    }
+  });
+  const response = await client.tui.control.next();
+  const answer = response.data?.input?.trim().toLowerCase();
+  if (answer !== "yes" && answer !== "y") {
+    await client.tui.appendPrompt({
+      body: {
+        type: "text",
+        text: `
+❌ Cancelled. No cache cleared.
+`
+      }
+    });
+    return;
+  }
+  const { cleared, skipped, blocked } = await clearCachePaths(configuredPaths);
+  let message = `
+`;
+  if (cleared.length > 0) {
+    message += `✅ **Cleared:**
+${cleared.map((p) => `• ${p}`).join(`
+`)}
+
+`;
+  }
+  if (skipped.length > 0) {
+    message += `⏭️ **Already clean / skipped:**
+${skipped.map((p) => `• ${p}`).join(`
+`)}
+
+`;
+  }
+  if (blocked.length > 0) {
+    message += `\uD83D\uDEAB **Blocked (safety check):**
+`;
+    for (const item of blocked) {
+      message += `• ${item.path}
+  Reason: ${item.reason}
+`;
+    }
+    message += `
+`;
+  }
+  if (cleared.length > 0) {
+    message += `**Next step:** Restart opencode to pull the latest plugin version.
+
+Your project files (.opencode/, Manifold/) are untouched — only the configured cache paths were cleared.
+`;
+  } else if (blocked.length > 0) {
+    message += `⚠️ No paths were cleared. Review the blocked paths above and adjust your settings if needed.
+`;
+  }
+  await client.tui.appendPrompt({
+    body: {
+      type: "text",
+      text: message
+    }
+  });
+  if (cleared.length > 0) {
+    await client.tui.showToast({
+      body: {
+        type: "success",
+        message: `Cache cleared (${cleared.length} paths). Restart opencode to update.`
+      }
+    });
+  } else if (blocked.length > 0) {
+    await client.tui.showToast({
+      body: {
+        type: "error",
+        message: `Cache update blocked (${blocked.length} paths failed safety check)`
+      }
+    });
+  }
+  await client.app.log({
+    body: {
+      service: "opencode-manifold",
+      level: "info",
+      message: `/manifold-update complete: cleared ${cleared.length}, skipped ${skipped.length}, blocked ${blocked.length}`
+    }
+  });
+}
+
 // src/index.ts
 var ManifoldPlugin = async (ctx) => {
   setPluginContext(ctx.client);
@@ -4224,6 +4703,22 @@ var ManifoldPlugin = async (ctx) => {
             }
           ];
         }
+      } else if (input.command === "manifold-models") {
+        await handleSubModelCommand(ctx.client, ctx.directory);
+        output.parts = [
+          {
+            type: "text",
+            text: "Sub-agent model configuration complete."
+          }
+        ];
+      } else if (input.command === "manifold-update") {
+        await handleUpdateCommand(ctx.client, ctx.directory);
+        output.parts = [
+          {
+            type: "text",
+            text: "Plugin cache update complete."
+          }
+        ];
       }
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-manifold",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Multi-agent development system for opencode with persistent knowledge",
   "main": "dist/index.js",
   "type": "module",

package/src/templates/agents/clerk.md

@@ -2,6 +2,7 @@
 description: Researches context, composes scoped prompts, and maintains the project wiki
 mode: subagent
 hidden: true
+model: Kilo-Gateway/Gemini-3-Flash-Preview
 permission:
   edit:
     "*": deny

package/src/templates/commands/manifold-models.md

@@ -0,0 +1,4 @@
+---
+description: Set the model for a Manifold sub-agent (clerk, senior-dev, junior-dev, debug)
+---
+The /manifold-models command is handled by the plugin. It will prompt you to select a sub-agent and then a model.

package/src/templates/commands/manifold-update.md

@@ -0,0 +1,4 @@
+---
+description: Clear opencode-manifold plugin cache and prompt for restart
+---
+The /manifold-update command is handled by the plugin. It clears cached versions and prompts you to restart opencode.

package/src/templates/manifold/settings.json

@@ -5,5 +5,7 @@
   "recentTaskCount": 3,
   "clerkRetryEnabled": true,
   "timeout": 300,
-  "testCommand": null
+  "testCommand": null,
+  "updateCachePaths": [
+  ]
 }