@wpro-eng/opencode-config 1.0.2 → 1.1.2

package/instruction/orchestration-runtime.md

@@ -0,0 +1,79 @@
+# Wpromote Orchestration Runtime
+
+Use the wpromote orchestration control surface for long-running and delegated work.
+
+## Core Controls
+
+- `/continue` enables continuous loop mode for the session.
+- `/stop` halts loop and queue processing immediately, then waits for further instruction.
+- `/tasks` shows active/recent subagent tasks.
+- `/task <id>` shows one task record.
+- `/diagnostics` runs full orchestration diagnostics.
+
+## Delegation Discipline
+
+When using delegated execution:
+
+1. Provide a short, specific task title.
+2. Include expected outcome and verification criteria.
+3. Prefer bounded retries with backoff.
+4. Keep updates concise and state-driven: started, retrying, completed, failed, stopped.
+
+## Provider Routing
+
+- Default provider mode is `copilot`.
+- If service quality or budget requires it, switch to `native` in `wpromote.json`:
+
+```json
+{
+  "orchestration": {
+    "providerMode": "native",
+    "categories": {
+      "routing": {
+        "quick": "native"
+      },
+      "maxConcurrent": {
+        "quick": 1
+      }
+    }
+  }
+}
+```
+
+## Recovery
+
+- Startup recovery is enabled by default (`orchestration.recovery.autoResumeOnStart = true`).
+- On startup, queued/running/retrying task records from prior sessions are moved back to queued state so they remain visible and can be re-dispatched.
+
+```json
+{
+  "orchestration": {
+    "recovery": {
+      "autoResumeOnStart": true
+    }
+  }
+}
+```
+
+## Tmux Runtime
+
+- Enable tmux pane management with `orchestration.tmux.enabled`.
+- Recommended defaults:
+
+```json
+{
+  "orchestration": {
+    "tmux": {
+      "enabled": true,
+      "layout": "main-vertical",
+      "mainPaneSize": 60,
+      "mainPaneMinWidth": 120,
+      "agentPaneMinWidth": 40,
+      "sessionPrefix": "wpo"
+    }
+  }
+}
+```
+
+- `/tasks` reports tmux pane attachment state and deferred queue health.
+- `/diagnostics` checks tmux wiring, binary availability, queue health, and pane reconciliation.

package/instruction/team-conventions.md

@@ -0,0 +1,17 @@
+# Wpromote Team Conventions
+
+## Code Style
+
+- Use TypeScript for all new code
+- Follow existing patterns in the codebase
+- Write tests for new functionality
+
+## Git Workflow
+
+- Create feature branches from main
+- Write descriptive commit messages
+- Request code review before merging
+
+## Adding New Configs
+
+See CONTRIBUTING.md for how to add new skills, agents, and commands.

package/manifest.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "./manifest.schema.json",
+  "instructions": [
+    "instruction/getting-started.md",
+    "instruction/team-conventions.md",
+    "instruction/orchestration-runtime.md"
+  ]
+}

package/mcp/chrome-devtools/mcp.json

@@ -0,0 +1,4 @@
+{
+  "type": "local",
+  "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
+}

package/mcp/context7/mcp.json

@@ -0,0 +1,4 @@
+{
+  "type": "remote",
+  "url": "https://mcp.context7.com/mcp"
+}

package/mcp/exa/mcp.json

@@ -0,0 +1,4 @@
+{
+  "type": "remote",
+  "url": "https://mcp.exa.ai/mcp"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpro-eng/opencode-config",
-  "version": "1.0.2",
+  "version": "1.1.2",
   "description": "Wpromote OpenCode plugin to sync team config assets on startup",
   "repository": {
     "type": "git",
@@ -14,7 +14,14 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "skill",
+    "agent",
+    "command",
+    "plugin",
+    "mcp",
+    "instruction",
+    "manifest.json"
   ],
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target bun",
@@ -27,9 +34,7 @@
     "opencode",
     "plugin",
     "wpromote",
-    "config",
-    "git",
-    "sync"
+    "config"
   ],
   "author": "Wpromote",
   "license": "UNLICENSED",

package/plugin/wpromote-look-at.ts

@@ -0,0 +1,33 @@
+import { tool, type Plugin } from "@opencode-ai/plugin"
+
+const lookAtTool = tool({
+  description:
+    "Wrapper guidance for multimodal analysis workflows. Use this tool to normalize goal text before invoking native look_at.",
+  args: {
+    file_path: tool.schema.string().optional(),
+    goal: tool.schema.string(),
+  },
+  execute: async (args) => {
+    const filePath = args.file_path ? `\n- file_path: ${args.file_path}` : ""
+    return [
+      "Use native look_at for multimodal analysis with this normalized request:",
+      filePath,
+      `- goal: ${args.goal}`,
+      "",
+      "Recommended follow-up:",
+      "1) Run look_at with the same goal and file path.",
+      "2) Return extracted findings with concrete evidence.",
+      "3) If uncertain, call out ambiguity and request a sharper goal.",
+    ].join("\n")
+  },
+})
+
+const WpromoteLookAtPlugin: Plugin = async () => {
+  return {
+    tool: {
+      wpromote_look_at: lookAtTool,
+    },
+  }
+}
+
+export default WpromoteLookAtPlugin