opencode-manifold 0.4.8 → 0.4.9

package/README.md

@@ -72,8 +72,9 @@ 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. **(Optional) Run `/manifold-models`** to configure which models each sub-agent uses
-4. **Create a plan** — any format (markdown, TODO list, email, meeting notes)
-5. **Point the Lead Dev agent** at your plan file and tell it to execute
+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
@@ -252,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)) |
 
 ---
 
@@ -295,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:
@@ -314,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) {
@@ -4429,6 +4430,246 @@ Type the model number or full model ID (e.g., anthropic/claude-sonnet-4-20250514
   });
 }
 
+// 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);
@@ -4470,6 +4711,14 @@ var ManifoldPlugin = async (ctx) => {
             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.8",
+  "version": "0.4.9",
   "description": "Multi-agent development system for opencode with persistent knowledge",
   "main": "dist/index.js",
   "type": "module",

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": [
+  ]
 }