opencode-conductor-plugin 1.8.2 → 1.9.0

package/README.md

@@ -11,12 +11,14 @@ The philosophy is simple: **control your code by controlling your context.** By
 ## 🚀 Key Features
 
 *   **Specialized `@conductor` Agent**: A dedicated subagent that acts as your Project Architect and Technical Lead.
-*   **Native Slash Commands**: Integrated shortcuts like `/c-setup`, `/c-new`, and `/c-implement` for frictionless project management.
+*   **Native Slash Commands**: Integrated shortcuts like `/conductor:setup`, `/conductor:newTrack`, and `/conductor:implement` for frictionless project management.
+*   **Modern Permissions**: Fully compatible with OpenCode v1.1.1 granular permission system.
 *   **Protocol-Driven Workflow**: Automated enforcement of the **Context -> Spec -> Plan -> Implement** lifecycle.
 *   **Smart Revert**: A Git-aware revert system that understands logical units of work (Tracks, Phases, Tasks) instead of just raw commit hashes.
 *   **19+ Style Templates**: Built-in support for a vast range of languages including Rust, Solidity, Zig, Julia, Kotlin, Swift, and more.
 *   **Zero-Config Bootstrap**: Automatically installs agents and commands to your global OpenCode configuration on first run.
 *   **Sisyphus Synergy**: Optimized to work alongside [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode) for a multi-agent team experience.
+*   **Agent Agnostic**: Commands can be invoked by any agent, giving you the freedom to choose your primary interface.
 
 ---
 
@@ -24,18 +26,18 @@ The philosophy is simple: **control your code by controlling your context.** By
 
 Conductor organizes your work into **Tracks** (features or bug fixes). Every Track follows three mandatory phases:
 
-### 1. Project Initialization (`/c-setup`)
-Run this once per project. The `@conductor` agent will interview you to define:
+### 1. Project Initialization (`/conductor:setup`)
+Run this once per project. The agent will interview you to define:
 *   **Product Vision**: Target users, core goals, and primary features.
 *   **Tech Stack**: Languages, frameworks, and databases.
 *   **Workflow Rules**: Testing standards (e.g., TDD), commit strategies, and documentation patterns.
 
-### 2. Track Planning (`/c-new`)
-When you're ready for a new task, tell Conductor what you want to build.
+### 2. Track Planning (`/conductor:newTrack`)
+When you're ready for a new task, tell the agent what you want to build.
 *   **Specification (`spec.md`)**: Conductor asks 3-5 targeted questions to clarify the "What" and "Why".
 *   **Implementation Plan (`plan.md`)**: Once the spec is approved, Conductor generates a step-by-step checklist adhering to your project's workflow rules.
 
-### 3. Autonomous Implementation (`/c-implement`)
+### 3. Autonomous Implementation (`/conductor:implement`)
 The agent works through the `plan.md` checklist, executing tasks, running tests, and making semantic commits automatically until the Track is complete.
 
 ---
@@ -92,11 +94,11 @@ We highly recommend pinning the `@conductor` agent to a "flash" model for optima
 
 | Command | Description |
 | :--- | :--- |
-| `/c-setup` | Initialize the `conductor/` directory and project "Constitution". |
-| `/c-new "desc"` | Start a new feature/bug Track with spec and plan generation. |
-| `/c-implement` | Start implementing the next pending task in the current track. |
-| `/c-status` | Get a high-level overview of project progress and active tracks. |
-| `/c-revert` | Interactively select a task, phase, or track to undo via Git. |
+| `/conductor:setup` | Initialize the `conductor/` directory and project "Constitution". |
+| `/conductor:newTrack "desc"` | Start a new feature/bug Track with spec and plan generation. |
+| `/conductor:implement` | Start implementing the next pending task in the current track. |
+| `/conductor:status` | Get a high-level overview of project progress and active tracks. |
+| `/conductor:revert` | Interactively select a task, phase, or track to undo via Git. |
 
 ---
 

package/dist/commands/implement.d.ts

@@ -1,2 +1 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare const implementCommand: (ctx: any) => ToolDefinition;
+export declare const implementCommand: (ctx: any) => import("@opencode-ai/plugin/tool").ToolDefinition;

package/dist/commands/implement.js

@@ -1,19 +1,31 @@
 import { tool } from "@opencode-ai/plugin/tool";
-import { existsSync } from "fs";
-import { join } from "path";
-import { loadPrompt } from "../utils/promptLoader.js";
-export const implementCommand = (ctx) => tool({
+import { createConductorCommand } from "../utils/commandFactory.js";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { readFile } from "fs/promises";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const implementCommand = createConductorCommand({
+    name: "implement.toml",
     description: "Implements tasks from a Conductor track.",
     args: {
         track_name: tool.schema.string().optional().describe("Specific track to implement. If omitted, selects the next incomplete track."),
     },
-    async execute(args) {
-        const conductorDir = join(ctx.directory, "conductor");
-        if (!existsSync(join(conductorDir, "product.md"))) {
-            return "Conductor is not set up. Please run `conductor_setup`.";
+    additionalContext: async (ctx, args) => {
+        // 1. Choose strategy based on OMO activity
+        const strategyFile = ctx.isOMOActive ? "delegate.md" : "manual.md";
+        const strategyPath = join(__dirname, "../prompts/strategies", strategyFile);
+        let strategySection = "";
+        try {
+            strategySection = await readFile(strategyPath, "utf-8");
         }
-        return await loadPrompt("implement.toml", {
-            isOMOActive: ctx.isOMOActive ? "true" : "false"
-        });
-    },
+        catch (e) {
+            console.warn(`[Conductor] Failed to load strategy ${strategyFile}:`, e);
+            strategySection = "Error: Could not load execution strategy.";
+        }
+        return {
+            strategy_section: strategySection,
+            track_name: args.track_name || ""
+        };
+    }
 });

package/dist/commands/newTrack.d.ts

@@ -1,2 +1 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare const newTrackCommand: (ctx: any) => ToolDefinition;
+export declare const newTrackCommand: (ctx: any) => import("@opencode-ai/plugin/tool").ToolDefinition;

package/dist/commands/newTrack.js

@@ -1,21 +1,12 @@
 import { tool } from "@opencode-ai/plugin/tool";
-import { existsSync } from "fs";
-import { join } from "path";
-import { loadPrompt } from "../utils/promptLoader.js";
-export const newTrackCommand = (ctx) => tool({
+import { createConductorCommand } from "../utils/commandFactory.js";
+export const newTrackCommand = createConductorCommand({
+    name: "newTrack.toml",
     description: "Creates a new track (feature/bug) in the Conductor system. IMPORTANT: Do NOT create any todos using 'todowrite' or 'task' tools before or during this command, as it manages its own interactive state and will conflict with continuation enforcers.",
     args: {
         description: tool.schema.string().optional().describe("Brief description of the track."),
     },
-    async execute(args) {
-        const conductorDir = join(ctx.directory, "conductor");
-        if (!existsSync(join(conductorDir, "product.md"))) {
-            return "Conductor is not set up. Please run `conductor_setup`.";
-        }
-        // Map the description to {{args}} in the legacy TOML
-        return await loadPrompt("newTrack.toml", {
-            args: args.description || "",
-            isOMOActive: ctx.isOMOActive ? "true" : "false"
-        });
-    },
+    additionalContext: async (_, args) => ({
+        args: args.description || ""
+    })
 });

package/dist/commands/revert.d.ts

@@ -1,2 +1 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare const revertCommand: (ctx: any) => ToolDefinition;
+export declare const revertCommand: (ctx: any) => import("@opencode-ai/plugin/tool").ToolDefinition;

package/dist/commands/revert.js

@@ -1,17 +1,9 @@
+import { createConductorCommand } from "../utils/commandFactory.js";
 import { tool } from "@opencode-ai/plugin/tool";
-import { existsSync } from "fs";
-import { join } from "path";
-import { loadPrompt } from "../utils/promptLoader.js";
-export const revertCommand = (ctx) => tool({
+export const revertCommand = createConductorCommand({
+    name: "revert.toml",
     description: "Reverts a Conductor track, phase, or task.",
     args: {
         target: tool.schema.string().optional().describe("ID or description of what to revert."),
-    },
-    async execute(args) {
-        const conductorDir = join(ctx.directory, "conductor");
-        if (!existsSync(join(conductorDir, "tracks.md"))) {
-            return "Conductor is not set up.";
-        }
-        return await loadPrompt("revert.toml");
-    },
+    }
 });

package/dist/commands/setup.d.ts

@@ -1,2 +1 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare const setupCommand: (ctx: any) => ToolDefinition;
+export declare const setupCommand: (ctx: any) => import("@opencode-ai/plugin/tool").ToolDefinition;

package/dist/commands/setup.js

@@ -1,22 +1,10 @@
 import { tool } from "@opencode-ai/plugin/tool";
-import { StateManager } from "../utils/stateManager.js";
-import { loadPrompt } from "../utils/promptLoader.js";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-export const setupCommand = (ctx) => tool({
+import { createConductorCommand } from "../utils/commandFactory.js";
+export const setupCommand = createConductorCommand({
+    name: "setup.toml",
     description: "Sets up the Conductor environment for the project. Call this to start or resume the setup process. IMPORTANT: Do NOT create any todos using 'todowrite' or 'task' tools before or during this command, as it manages its own interactive state and will conflict with continuation enforcers.",
     args: {
         user_input: tool.schema.string().optional().describe("The user's response to a previous question, if applicable."),
     },
-    async execute(args) {
-        const stateManager = new StateManager(ctx.directory);
-        // Resolve the absolute path to the templates directory in the distribution
-        const templatesDir = join(__dirname, "../templates");
-        return await loadPrompt("setup.toml", {
-            templatesDir,
-            isOMOActive: ctx.isOMOActive ? "true" : "false"
-        });
-    },
+    requiresSetup: false // Setup command is what creates the setup
 });

package/dist/commands/status.d.ts

@@ -1,2 +1 @@
-import { type ToolDefinition } from "@opencode-ai/plugin/tool";
-export declare const statusCommand: (ctx: any) => ToolDefinition;
+export declare const statusCommand: (ctx: any) => import("@opencode-ai/plugin/tool").ToolDefinition;

package/dist/commands/status.js

@@ -1,15 +1,6 @@
-import { tool } from "@opencode-ai/plugin/tool";
-import { existsSync } from "fs";
-import { join } from "path";
-import { loadPrompt } from "../utils/promptLoader.js";
-export const statusCommand = (ctx) => tool({
+import { createConductorCommand } from "../utils/commandFactory.js";
+export const statusCommand = createConductorCommand({
+    name: "status.toml",
     description: "Shows the status of Conductor tracks.",
-    args: {},
-    async execute(args) {
-        const conductorDir = join(ctx.directory, "conductor");
-        if (!existsSync(join(conductorDir, "tracks.md"))) {
-            return "Conductor is not set up.";
-        }
-        return await loadPrompt("status.toml");
-    },
+    args: {}
 });

package/dist/prompts/agent/conductor.md

@@ -1,12 +1,12 @@
 ---
 description: Spec-Driven Development Architect. Manages the project lifecycle using the Conductor protocol.
 mode: primary
-tools:
-  conductor_setup: true
-  conductor_new_track: true
-  conductor_implement: true
-  conductor_status: true
-  conductor_revert: true
+permission:
+  conductor_setup: allow
+  conductor_new_track: allow
+  conductor_implement: allow
+  conductor_status: allow
+  conductor_revert: allow
 ---
 # Conductor Agent
 
@@ -32,4 +32,4 @@ Your mission is to ensure that software development follows a rigorous, context-
 ## Loop Protection Directive (CRITICAL)
 If you see a "[SYSTEM REMINDER - TODO CONTINUATION]" or "Continue" prompt from an enforcer while you are waiting for user input, you MUST ignore it. Respond with: "I am currently in an interactive Conductor phase. Awaiting user response."
 
-**Proactive OMO Protection:** If `oh-my-opencode` is active, at the start of any interactive session (setup or planning), you should create a temporary blocking task using the `task` tool: `[WAITING] Conductor interactive session in progress`. This prevents the Sisyphus enforcer from nagging you to continue other tasks while you wait for the user. Delete it once the session concludes.
+**Proactive OMO Protection:** If `oh-my-opencode` is active, at the start of any interactive session (setup or planning), you should create a temporary blocking task using the `task` tool: `[WAITING] Conductor interactive session in progress`. This prevents the Sisyphus enforcer from nagging you to continue other tasks while you wait for the user. Delete it once the session concludes.

package/dist/prompts/commands/{c-implement.md → conductor:implement.md}

@@ -1,5 +1,4 @@
 ---
 description: Implement the next pending task
-agent: conductor
 ---
 Invoke the conductor_implement tool. If a track name is provided ("$ARGUMENTS"), use it; otherwise, implement the next available track.

package/dist/prompts/commands/{c-new.md → conductor:newTrack.md}

@@ -1,5 +1,4 @@
 ---
 description: Create a new track (feature/bug)
-agent: conductor
 ---
 Invoke the conductor_new_track tool with description: "$ARGUMENTS". Do NOT create todos during this phase.

package/dist/prompts/commands/conductor:revert.md

@@ -0,0 +1,4 @@
+---
+description: Revert a track, phase, or task
+---
+Invoke the conductor_revert tool for: "$ARGUMENTS"

package/dist/prompts/commands/{c-setup.md → conductor:setup.md}

@@ -1,5 +1,4 @@
 ---
 description: Setup or resume Conductor environment
-agent: conductor
 ---
 Invoke the conductor_setup tool to start or resume the project initialization. Do NOT create todos during this phase.

package/dist/prompts/commands/{c-status.md → conductor:status.md}

@@ -1,5 +1,4 @@
 ---
 description: Show Conductor project status
-agent: conductor
 ---
 Invoke the conductor_status tool to summarize the project progress.

package/dist/prompts/implement.toml

@@ -69,24 +69,12 @@ CRITICAL: You must validate the success of every tool call. If any tool call fai
         - `conductor/workflow.md`
     c. **Error Handling:** If you fail to read any of these files, you MUST stop and inform the user of the error.
 
-5.  **Execute Tasks and Update Track Plan:**
-    a. **Announce:** State that you will now execute the tasks from the track's `plan.md` by following the procedures in `workflow.md`.
-    b. **OMO Delegation (Synergy Mode):** If `isOMOActive` is "true", you act as the **Architect**.
-       - *Role:* You **MUST** delegate the execution of tasks to **Sisyphus**. Do not attempt to implement tasks yourself unless delegation fails.
-       - *System Note:* When you call `@sisyphus`, the system will automatically inject the full project context (Plan, Spec, Workflow, Protocol) for you.
-       - *Action:* For each task, call `@sisyphus` with this directive:
-         > "I am delegating the implementation of task: '[Task Name]' to you.
-         >
-         > **Goal:** Execute this task. You have Engineering Authority to update `plan.md` if needed.
-         > **Constraint:** If you modify the plan or spec, stop and report 'PLAN_UPDATED'."
-       - *Verification:*
-         - If Sisyphus reports 'PLAN_UPDATED', you MUST **reload** `plan.md` before proceeding.
-         - If Sisyphus reports success, verify the task against the plan and move to the next.
-    c. **Manual Implementation (Standard Mode):** If `isOMOActive` is "false" or if you choose to implement directly, you MUST now loop through each task in the track's `plan.md` one by one.
-    d. **For Each Task, You MUST:**
-        i. **Defer to Workflow:** The `workflow.md` file is the **single source of truth** for the entire task lifecycle. You MUST now read and execute the procedures defined in the "Task Workflow" section of the `workflow.md` file you have in your context. Follow its steps for implementation, testing, and committing precisely.
-
-5.  **Finalize Track:**
+5. **Execute Tasks and Update Track Plan:**
+   a. **Announce:** State that you will now execute the tasks from the track's `plan.md`.
+   b. **Execute Strategy:**
+{{strategy_section}}
+
+6. **Finalize Track:**
     -   After all tasks in the track's local `plan.md` are completed, you MUST update the track's status in the tracks file.
     -   This requires finding the specific heading for the track (e.g., `## [~] Track: <Description>`) and replacing it with the completed status (e.g., `## [x] Track: <Description>`).
     -   Announce that the track is fully complete and the tracks file has been updated.

package/dist/prompts/strategies/delegate.md

@@ -0,0 +1,11 @@
+**MODE: SYNERGY (Architectural Delegation)**
+You are acting as the **Architect**. Your responsibility is to oversee the track while delegating execution to **Sisyphus**.
+
+**DIRECTIVE:**
+1.  **Do NOT implement code yourself.**
+2.  **Delegate:** For each task in `plan.md`, call `@sisyphus`.
+    *   *Note:* The system will automatically inject the full project context for you.
+    *   *Instruction:* Tell Sisyphus: "Execute this task. You have authority to update `plan.md` if needed. Report 'PLAN_UPDATED' if you do."
+3.  **Verify:**
+    *   If Sisyphus reports 'PLAN_UPDATED', you MUST **reload** `plan.md` before the next task.
+    *   If success, verify against the plan and proceed to the next task.

package/dist/prompts/strategies/manual.md

@@ -0,0 +1,9 @@
+**MODE: STANDARD (Manual Implementation)**
+You are acting as the **Developer**. Your responsibility is to implement the code, tests, and documentation yourself.
+
+**DIRECTIVE:**
+1.  **Implement Manually:** Loop through each task in `plan.md` one by one.
+2.  **Workflow:** Follow the `workflow.md` TDD protocol precisely (Red -> Green -> Refactor).
+3.  **Commits:**
+    *   **AUTHORITY OVERRIDE:** You have explicit authority to create Git commits as defined in the workflow. 
+    *   Do not ask for further permission for the granular task commits defined in `workflow.md`.

package/dist/utils/commandFactory.d.ts

@@ -0,0 +1,10 @@
+import { type ToolDefinition } from "@opencode-ai/plugin/tool";
+interface CommandOptions {
+    name: string;
+    description: string;
+    args?: any;
+    requiresSetup?: boolean;
+    additionalContext?: (ctx: any, args: any) => Promise<Record<string, string>>;
+}
+export declare const createConductorCommand: (options: CommandOptions) => (ctx: any) => ToolDefinition;
+export {};

package/dist/utils/commandFactory.js

@@ -0,0 +1,47 @@
+import { tool } from "@opencode-ai/plugin/tool";
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { parse } from "smol-toml";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const createConductorCommand = (options) => (ctx) => tool({
+    description: options.description,
+    args: options.args || {},
+    async execute(args) {
+        // 1. Setup Check
+        if (options.requiresSetup !== false) {
+            const conductorDir = join(ctx.directory, "conductor");
+            if (!existsSync(join(conductorDir, "product.md"))) {
+                return "Conductor is not set up. Please run `conductor_setup`.";
+            }
+        }
+        // 2. Load Prompt from TOML
+        const promptPath = join(__dirname, "../prompts", options.name);
+        let promptText = "";
+        try {
+            const content = await readFile(promptPath, "utf-8");
+            const parsed = parse(content);
+            promptText = parsed.prompt;
+        }
+        catch (error) {
+            throw new Error(`Failed to load prompt from ${promptPath}: ${error}`);
+        }
+        // 3. Prepare Replacements
+        const replacements = {
+            isOMOActive: ctx.isOMOActive ? "true" : "false",
+            templatesDir: join(dirname(dirname(__dirname)), "dist/templates") // Fixing template path for setup
+        };
+        // 4. Inject Additional Context (e.g. from args)
+        if (options.additionalContext) {
+            const extra = await options.additionalContext(ctx, args);
+            Object.assign(replacements, extra);
+        }
+        // 5. Apply Replacements
+        for (const [key, value] of Object.entries(replacements)) {
+            promptText = promptText.replaceAll(`{{${key}}}`, value || "");
+        }
+        return promptText;
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-conductor-plugin",
-  "version": "1.8.2",
+  "version": "1.9.0",
   "description": "Conductor plugin for OpenCode",
   "type": "module",
   "repository": "derekbar90/opencode-conductor",
@@ -30,7 +30,7 @@
   "scripts": {
     "postinstall": "node scripts/postinstall.cjs",
     "build": "tsc && npm run copy-prompts && npm run copy-templates",
-    "copy-prompts": "mkdir -p dist/prompts && cp src/prompts/*.toml src/prompts/*.md dist/prompts/ && mkdir -p dist/prompts/agent && cp src/prompts/agent/*.md dist/prompts/agent/ && mkdir -p dist/prompts/commands && cp src/prompts/commands/*.md dist/prompts/commands/",
+    "copy-prompts": "mkdir -p dist/prompts && cp src/prompts/*.toml src/prompts/*.md dist/prompts/ && mkdir -p dist/prompts/agent && cp src/prompts/agent/*.md dist/prompts/agent/ && mkdir -p dist/prompts/commands && cp src/prompts/commands/*.md dist/prompts/commands/ && mkdir -p dist/prompts/strategies && cp src/prompts/strategies/*.md dist/prompts/strategies/",
     "copy-templates": "mkdir -p dist/templates && cp -r src/templates/* dist/templates/",
     "prepublishOnly": "npm run build"
   },

package/dist/prompts/commands/c-revert.md

@@ -1,5 +0,0 @@
----
-description: Revert a track, phase, or task
-agent: conductor
----
-Invoke the conductor_revert tool for: "$ARGUMENTS"

package/dist/utils/promptLoader.d.ts

@@ -1 +0,0 @@
-export declare function loadPrompt(filename: string, replacements?: Record<string, string>): Promise<string>;

package/dist/utils/promptLoader.js

@@ -1,23 +0,0 @@
-import { readFile } from "fs/promises";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { parse } from "smol-toml";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-export async function loadPrompt(filename, replacements = {}) {
-    // Resolve path relative to this file. 
-    // Structure: dist/utils/promptLoader.js -> dist/prompts/filename.toml
-    const promptPath = join(__dirname, "../prompts", filename);
-    try {
-        const content = await readFile(promptPath, "utf-8");
-        const parsed = parse(content);
-        let promptText = parsed.prompt;
-        for (const [key, value] of Object.entries(replacements)) {
-            promptText = promptText.replaceAll(`{{${key}}}`, value || "");
-        }
-        return promptText;
-    }
-    catch (error) {
-        throw new Error(`Failed to load prompt from ${promptPath}: ${error}`);
-    }
-}