@wpro-eng/opencode-config 1.1.2 → 1.3.0

package/command/test-orchestration.md

@@ -19,8 +19,8 @@ C) Config and Schema Consistency
 - List supported wpromote.json fields, defaults, and any dead/unused config keys.
 - Note any mismatch between docs and runtime behavior.
 
-D) Sync Pipeline Trace
-- Trace end-to-end flow across src/index.ts, src/git.ts, src/install.ts, src/disable.ts, src/mcp-install.ts.
+D) Load Pipeline Trace
+- Trace end-to-end flow across src/index.ts, src/assets.ts, src/install.ts, src/disable.ts, src/mcp-install.ts.
 - Produce a step-by-step execution map with key decision points and failure modes.
 - Identify where parallelism/concurrency exists and where it is effectively serialized.
 

package/command/wpromote-cleanup.md

@@ -0,0 +1,72 @@
+---
+description: Remove stale cache files, broken symlinks, and unused plugins from OpenCode's plugin cache
+---
+Clean up stale artifacts left behind by @wpro-eng/opencode-config and OpenCode's plugin cache.
+
+OpenCode's plugin cache (`~/.cache/opencode/package.json`) is append-only: it never removes plugins you've uninstalled from `opencode.json`. This command fixes that, along with other accumulated cruft.
+
+## Instructions
+
+Run each cleanup step below in order. Report what was found and what was removed. Use the Bash tool for filesystem operations.
+
+### 1. Remove old git-clone cache (legacy architecture)
+
+The plugin used to clone the team config repo via git. That was replaced by bundled npm assets. The entire `repos/` directory is inert.
+
+```
+rm -rf ~/.cache/opencode/wpromote-config/repos/
+rm -f ~/.cache/opencode/wpromote-config/opencode-config.sync-status.json
+```
+
+Report the size freed if the directory existed.
+
+### 2. Prune unused plugins from OpenCode's npm cache
+
+Read `~/.config/opencode/opencode.json` to get the active `plugin` list. Then read `~/.cache/opencode/package.json` to get cached dependencies.
+
+Any dependency in the cache that is NOT in the active plugin list AND is NOT `opencode-anthropic-auth` (OpenCode's built-in default plugin) should be removed:
+- Delete the entry from `~/.cache/opencode/package.json`
+- Delete the package directory from `~/.cache/opencode/node_modules/<pkg>/`
+- Delete `~/.cache/opencode/bun.lock` so Bun re-resolves cleanly on next startup
+
+List each removed package by name and version.
+
+**Important**: Also check for project-level `.opencode/opencode.json` plugin entries (in the current working directory) so you don't accidentally prune a plugin that's declared at the project level rather than the user level.
+
+### 3. Fix broken symlinks
+
+Check these locations for symlinks whose targets no longer exist:
+- `~/.config/opencode/skill/_plugins/opencode-config/*/`
+- `~/.config/opencode/plugin/_remote_opencode-config_*`
+- `~/.config/opencode/plugins/_remote_opencode-config_*`
+- `~/.config/opencode/mcp/_plugins/opencode-config/*/`
+
+Remove any broken symlinks. Report each one removed.
+
+### 4. Clean stale orchestration task files
+
+Check `~/.cache/opencode/wpromote-config/orchestration-tasks/` for session files older than 7 days:
+
+```bash
+find ~/.cache/opencode/wpromote-config/orchestration-tasks/ -name "ses_*.json" -mtime +7
+```
+
+Remove them and report the count.
+
+### 5. Rotate plugin log
+
+If `~/.cache/opencode/wpromote-config/plugin.log` is larger than 1MB, truncate it to the last 200 lines.
+
+## Output Format
+
+Present a summary table:
+
+| Category | Found | Cleaned | Details |
+|----------|-------|---------|---------|
+| Git clone cache | ... | ... | ... |
+| Unused cached plugins | ... | ... | ... |
+| Broken symlinks | ... | ... | ... |
+| Stale task files | ... | ... | ... |
+| Plugin log | ... | ... | ... |
+
+End with either "All clean, no restart needed." or "Restart OpenCode to pick up changes." if any cached plugins were removed or symlinks were fixed.

package/command/wpromote-list.md

@@ -1,18 +1,22 @@
 ---
 description: List all team assets from wpromote config
 ---
-List all available team assets from the wpromote opencode-config repository.
+List all available team assets from the installed @wpro-eng/opencode-config plugin.
 
 ## Instructions
 
-1. Read the team config repository at ~/.config/opencode/_plugins/wpromote-opencode-config/
+1. Check the installed asset locations:
+   - Skills: ~/.config/opencode/skill/_plugins/opencode-config/
+   - Plugins: ~/.config/opencode/plugins/ (files matching _remote_opencode-config_*)
+   - MCPs: ~/.config/opencode/mcp/_plugins/opencode-config/
+
 2. For each asset type, list what's available:
 
 ### Skills (skill/ directory)
 - Show each skill name and its description from SKILL.md frontmatter
 - Mark if it's installed or skipped due to local conflict
 
-### Agents (agent/ directory) 
+### Agents (agent/ directory)
 - Show each agent name and description
 - These are injected into OpenCode automatically
 

package/command/wpromote-status.md

@@ -1,23 +1,23 @@
 ---
-description: Show sync status for wpromote team config
+description: Show status for wpromote team config
 ---
-Read the sync status file at ~/.cache/opencode/wpromote-config/opencode-config.sync-status.json and report:
+Read the status file at ~/.cache/opencode/wpromote-config/opencode-config.plugin-status.json and report:
 
-1. **Last Sync Time** - When the team config was last synced
-2. **Current Ref** - The git branch/tag being used
-3. **Installed Assets**:
+1. **Plugin Version** - The installed version of @wpro-eng/opencode-config
+2. **Last Load Time** - When the team config was last loaded
+3. **Installed Assets** (with names):
    - Skills (symlinked to local skill directory)
-   - Plugins (running in OpenCode)
+   - Team Plugins (symlinked into plugins directory)
    - MCPs (configured MCP servers)
    - Agents (team agent definitions)
    - Commands (team slash commands)
    - Instructions (team instructions)
-4. **Issues** (if any):
-   - Skipped conflicts (local skills that blocked team skills)
-   - Disabled assets (explicitly disabled in wpromote.json)
-   - Errors from last sync attempt
-5. **Actions Required** - Any restart needed for plugin changes
+4. **Runtime Plugins** - Plugins injected into config.plugin[] (e.g. @tarquinen/opencode-dcp@latest)
+5. **Issues** (if any):
+   - Skipped conflicts (local skills that blocked team skills, listed by name)
+   - Disabled assets (explicitly disabled in wpromote.json, listed by type:name)
+6. **Actions Required** - Any restart needed for plugin changes
 
-If the file doesn't exist, report that no sync has been performed yet.
+If the file doesn't exist, report that the plugin hasn't loaded yet.
 
 Format the output as a clean, readable summary.

package/dist/index.js

@@ -9842,30 +9842,42 @@ import * as fs7 from "fs";
 import * as path7 from "path";
 var STATUS_BASE = path7.join(process.env.HOME || "~", ".cache", "opencode", "wpromote-config");
 function getStatusFilePath() {
-  return path7.join(STATUS_BASE, `${REPO_SHORT_NAME}.sync-status.json`);
+  return path7.join(STATUS_BASE, `${REPO_SHORT_NAME}.plugin-status.json`);
 }
-function writeSyncStatus(status) {
+function writePluginStatus(status) {
   const statusPath = getStatusFilePath();
   const dir = path7.dirname(statusPath);
   fs7.mkdirSync(dir, { recursive: true });
   fs7.writeFileSync(statusPath, JSON.stringify(status, null, 2));
-  logDebug(`Wrote sync status to ${statusPath}`);
+  logDebug(`Wrote plugin status to ${statusPath}`);
 }
-function updateSyncStatus(data) {
+function getPluginVersion() {
+  try {
+    const pkgPath = path7.resolve(import.meta.dir, "..", "package.json");
+    const content = fs7.readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(content);
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function updatePluginStatus(data) {
   const status = {
-    lastSyncTime: new Date().toISOString(),
-    installedSkills: data.installedSkills,
-    installedPlugins: data.installedPlugins,
-    installedMcps: data.installedMcps,
-    remoteAgents: data.remoteAgents,
-    remoteCommands: data.remoteCommands,
-    remoteInstructions: data.remoteInstructions,
+    lastLoadTime: new Date().toISOString(),
+    pluginVersion: getPluginVersion(),
+    skillNames: data.skillNames,
+    pluginNames: data.pluginNames,
+    runtimePluginNames: data.runtimePluginNames,
+    mcpNames: data.mcpNames,
+    agentNames: data.agentNames,
+    commandNames: data.commandNames,
+    instructionNames: data.instructionNames,
     skippedConflicts: data.skippedConflicts,
     disabledAssets: data.disabledAssets,
     lastError: null,
     pluginsChanged: data.pluginsChanged
   };
-  writeSyncStatus(status);
+  writePluginStatus(status);
 }
 
 // src/index.ts
@@ -9873,9 +9885,9 @@ var PACKAGE_ROOT = path8.resolve(import.meta.dir, "..");
 var initialized = false;
 var REQUIRED_RUNTIME_PLUGINS = ["@tarquinen/opencode-dcp@latest"];
 var DEFAULT_OPENCODE_AGENTS_TO_DISABLE = ["build", "plan"];
-async function performSync(config) {
+async function performLoad(config) {
   const disableMatcher = createDisableMatcher(config.disable);
-  log(config.dryRun ? "[DRY-RUN] Analyzing team configuration..." : "Syncing team configuration...");
+  log(config.dryRun ? "[DRY-RUN] Analyzing team configuration..." : "Loading team configuration...");
   const result = await discoverAssets(PACKAGE_ROOT);
   if (!config.dryRun) {
     const brokenUnmanagedLinks = findBrokenUnmanagedPluginLinks();
@@ -10119,15 +10131,16 @@ async function performSync(config) {
     log(`Cleaned up ${mcpCleanup.removed.length} stale MCP installs`);
   }
   const totalMcps = newMcpInstalls.size;
-  updateSyncStatus({
-    installedSkills: totalSkills,
-    installedPlugins: totalPlugins,
-    installedMcps: totalMcps,
-    remoteAgents: remoteAgents.size,
-    remoteCommands: remoteCommands.size,
-    remoteInstructions: remoteInstructions.length,
-    skippedConflicts: skippedConflicts.length,
-    disabledAssets: disabledAssets.length,
+  updatePluginStatus({
+    skillNames: skillsToInstall.map((s) => s.name),
+    pluginNames: pluginsToInstall.map((p) => p.name),
+    runtimePluginNames: [...REQUIRED_RUNTIME_PLUGINS],
+    mcpNames: [...remoteMcps.keys()],
+    agentNames: [...remoteAgents.keys()],
+    commandNames: [...remoteCommands.keys()],
+    instructionNames: remoteInstructions.map((p) => p.split("/").pop() ?? p),
+    skippedConflicts,
+    disabledAssets,
     pluginsChanged
   });
   return {
@@ -10205,7 +10218,7 @@ var WpromoteConfigPlugin = async (ctx) => {
     pluginsChanged,
     totalPlugins,
     totalMcps
-  } = await performSync(userConfig);
+  } = await performLoad(userConfig);
   if (pluginsChanged) {
     log("\u26A0 Plugin changes detected. Restart OpenCode to apply.");
   }
@@ -10351,7 +10364,7 @@ var WpromoteConfigPlugin = async (ctx) => {
 var RemoteSkillsPlugin = WpromoteConfigPlugin;
 var src_default = WpromoteConfigPlugin;
 export {
-  performSync,
+  performLoad,
   src_default as default,
   WpromoteConfigPlugin,
   RemoteSkillsPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpro-eng/opencode-config",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Wpromote OpenCode plugin to sync team config assets on startup",
   "repository": {
     "type": "git",