conductor-4-all 0.0.12 → 0.0.13

package/dist/index.cjs

@@ -176,11 +176,13 @@ var opencodeConfig = {
   agentType: "opencode",
   agentDir: ".opencode",
   commandsDir: "commands",
-  displayName: "OpenCode"
+  displayName: "OpenCode",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/ConfigurableGenerator.ts
 var import_path3 = require("path");
+var import_select2 = __toESM(require("@inquirer/select"), 1);
 var import_fs_extra2 = __toESM(require("fs-extra"), 1);
 var { existsSync, ensureDir, writeFile: writeFile2, copy } = import_fs_extra2.default;
 var ConfigurableGenerator = class {
@@ -217,6 +219,30 @@ var ConfigurableGenerator = class {
     } catch (e) {
       console.warn("Failed to copy templates directory:", e);
     }
+    const { protocolFilename } = this.config;
+    if (protocolFilename) {
+      try {
+        const protocolSource = (0, import_path3.join)(templateRoot, "GEMINI.md");
+        const protocolDest = (0, import_path3.join)(targetDir, protocolFilename);
+        if (existsSync(protocolSource)) {
+          let shouldCopy = true;
+          if (existsSync(protocolDest)) {
+            shouldCopy = await (0, import_select2.default)({
+              message: `The protocol file '${protocolFilename}' already exists. Do you want to overwrite it?`,
+              choices: [
+                { value: true, name: "Overwrite" },
+                { value: false, name: "Skip" }
+              ]
+            });
+          }
+          if (shouldCopy) {
+            await copy(protocolSource, protocolDest);
+          }
+        }
+      } catch (e) {
+        console.warn("Failed to handle protocol file:", e);
+      }
+    }
     const commands = ["setup", "newTrack", "implement", "status", "revert"];
     const extension = this.config.extension || ".md";
     const fixedAgent = this.config.fixedAgent;
@@ -269,7 +295,8 @@ var claudeCodeConfig = {
   agentType: "claude-code",
   agentDir: ".claude",
   commandsDir: "commands",
-  displayName: "Claude Code"
+  displayName: "Claude Code",
+  protocolFilename: "CLAUDE.md"
 };
 
 // src/generators/claude-code/generator.ts
@@ -288,7 +315,8 @@ var antigravityConfig = {
   agentType: "antigravity",
   agentDir: ".agent",
   commandsDir: "workflows",
-  displayName: "Antigravity"
+  displayName: "Antigravity",
+  protocolFilename: "GEMINI.md"
 };
 
 // src/generators/antigravity/generator.ts
@@ -307,7 +335,8 @@ var cursorConfig = {
   agentType: "cursor",
   agentDir: ".cursor",
   commandsDir: "commands",
-  displayName: "Cursor"
+  displayName: "Cursor",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/cursor/generator.ts
@@ -348,6 +377,7 @@ var vscodeCopilotConfig = {
   agentDir: ".github",
   commandsDir: "prompts",
   displayName: "VS Code Copilot",
+  protocolFilename: "AGENTS.md",
   extension: ".prompt.md",
   fixedAgent: "agent",
   strategy: {
@@ -372,6 +402,7 @@ var codexConfig = {
   agentDir: ".codex",
   commandsDir: "prompts",
   displayName: "Codex",
+  protocolFilename: "AGENTS.md",
   extension: ".md"
 };
 
@@ -398,7 +429,8 @@ var windsurfConfig = {
   agentType: "windsurf",
   agentDir: ".windsurf",
   commandsDir: "workflows",
-  displayName: "Windsurf"
+  displayName: "Windsurf",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/windsurf/generator.ts
@@ -436,6 +468,7 @@ var clineConfig = {
   agentDir: ".clinerules",
   commandsDir: "workflows",
   displayName: "Cline",
+  protocolFilename: "AGENTS.md",
   strategy: {
     content: clineContentStrategy
   }
@@ -484,6 +517,7 @@ var geminiConfig = {
   agentDir: ".gemini",
   commandsDir: "commands/conductor",
   displayName: "Gemini CLI",
+  protocolFilename: "GEMINI.md",
   extension: ".toml",
   strategy: {
     content: geminiContentStrategy,
@@ -577,7 +611,17 @@ var cli = (0, import_yargs.default)((0, import_helpers.hideBin)(process.argv)).s
       alias: "a",
       describe: "Specify the coding agent",
       type: "string",
-      choices: ["opencode", "claude-code", "antigravity", "cursor", "vscode-copilot", "codex"]
+      choices: [
+        "opencode",
+        "claude-code",
+        "antigravity",
+        "cursor",
+        "vscode-copilot",
+        "codex",
+        "windsurf",
+        "cline",
+        "gemini"
+      ]
     });
   },
   installHandler

package/dist/index.js

@@ -149,11 +149,13 @@ var opencodeConfig = {
   agentType: "opencode",
   agentDir: ".opencode",
   commandsDir: "commands",
-  displayName: "OpenCode"
+  displayName: "OpenCode",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/ConfigurableGenerator.ts
 import { join as join3 } from "path";
+import select2 from "@inquirer/select";
 import fs2 from "fs-extra";
 var { existsSync, ensureDir, writeFile: writeFile2, copy } = fs2;
 var ConfigurableGenerator = class {
@@ -190,6 +192,30 @@ var ConfigurableGenerator = class {
     } catch (e) {
       console.warn("Failed to copy templates directory:", e);
     }
+    const { protocolFilename } = this.config;
+    if (protocolFilename) {
+      try {
+        const protocolSource = join3(templateRoot, "GEMINI.md");
+        const protocolDest = join3(targetDir, protocolFilename);
+        if (existsSync(protocolSource)) {
+          let shouldCopy = true;
+          if (existsSync(protocolDest)) {
+            shouldCopy = await select2({
+              message: `The protocol file '${protocolFilename}' already exists. Do you want to overwrite it?`,
+              choices: [
+                { value: true, name: "Overwrite" },
+                { value: false, name: "Skip" }
+              ]
+            });
+          }
+          if (shouldCopy) {
+            await copy(protocolSource, protocolDest);
+          }
+        }
+      } catch (e) {
+        console.warn("Failed to handle protocol file:", e);
+      }
+    }
     const commands = ["setup", "newTrack", "implement", "status", "revert"];
     const extension = this.config.extension || ".md";
     const fixedAgent = this.config.fixedAgent;
@@ -242,7 +268,8 @@ var claudeCodeConfig = {
   agentType: "claude-code",
   agentDir: ".claude",
   commandsDir: "commands",
-  displayName: "Claude Code"
+  displayName: "Claude Code",
+  protocolFilename: "CLAUDE.md"
 };
 
 // src/generators/claude-code/generator.ts
@@ -261,7 +288,8 @@ var antigravityConfig = {
   agentType: "antigravity",
   agentDir: ".agent",
   commandsDir: "workflows",
-  displayName: "Antigravity"
+  displayName: "Antigravity",
+  protocolFilename: "GEMINI.md"
 };
 
 // src/generators/antigravity/generator.ts
@@ -280,7 +308,8 @@ var cursorConfig = {
   agentType: "cursor",
   agentDir: ".cursor",
   commandsDir: "commands",
-  displayName: "Cursor"
+  displayName: "Cursor",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/cursor/generator.ts
@@ -321,6 +350,7 @@ var vscodeCopilotConfig = {
   agentDir: ".github",
   commandsDir: "prompts",
   displayName: "VS Code Copilot",
+  protocolFilename: "AGENTS.md",
   extension: ".prompt.md",
   fixedAgent: "agent",
   strategy: {
@@ -345,6 +375,7 @@ var codexConfig = {
   agentDir: ".codex",
   commandsDir: "prompts",
   displayName: "Codex",
+  protocolFilename: "AGENTS.md",
   extension: ".md"
 };
 
@@ -371,7 +402,8 @@ var windsurfConfig = {
   agentType: "windsurf",
   agentDir: ".windsurf",
   commandsDir: "workflows",
-  displayName: "Windsurf"
+  displayName: "Windsurf",
+  protocolFilename: "AGENTS.md"
 };
 
 // src/generators/windsurf/generator.ts
@@ -409,6 +441,7 @@ var clineConfig = {
   agentDir: ".clinerules",
   commandsDir: "workflows",
   displayName: "Cline",
+  protocolFilename: "AGENTS.md",
   strategy: {
     content: clineContentStrategy
   }
@@ -457,6 +490,7 @@ var geminiConfig = {
   agentDir: ".gemini",
   commandsDir: "commands/conductor",
   displayName: "Gemini CLI",
+  protocolFilename: "GEMINI.md",
   extension: ".toml",
   strategy: {
     content: geminiContentStrategy,
@@ -550,7 +584,17 @@ var cli = yargs(hideBin(process.argv)).scriptName("conductor").usage("$0 <cmd> [
       alias: "a",
       describe: "Specify the coding agent",
       type: "string",
-      choices: ["opencode", "claude-code", "antigravity", "cursor", "vscode-copilot", "codex"]
+      choices: [
+        "opencode",
+        "claude-code",
+        "antigravity",
+        "cursor",
+        "vscode-copilot",
+        "codex",
+        "windsurf",
+        "cline",
+        "gemini"
+      ]
     });
   },
   installHandler

package/dist/templates/GEMINI.md

@@ -0,0 +1,41 @@
+# Conductor Context
+
+If a user mentions a "plan" or asks about the plan, and they have used the conductor extension in the current session, they are likely referring to the `conductor/tracks.md` file or one of the track plans (`conductor/tracks/<track_id>/plan.md`).
+
+## Universal File Resolution Protocol
+
+**PROTOCOL: How to locate files.**
+To find a file (e.g., "**Product Definition**") within a specific context (Project Root or a specific Track):
+
+1.  **Identify Index:** Determine the relevant index file:
+    -   **Project Context:** `conductor/index.md`
+    -   **Track Context:**
+        a. Resolve and read the **Tracks Registry** (via Project Context).
+        b. Find the entry for the specific `<track_id>`.
+        c. Follow the link provided in the registry to locate the track's folder. The index file is `<track_folder>/index.md`.
+        d. **Fallback:** If the track is not yet registered (e.g., during creation) or the link is broken:
+            1. Resolve the **Tracks Directory** (via Project Context).
+            2. The index file is `<Tracks Directory>/<track_id>/index.md`.
+
+2.  **Check Index:** Read the index file and look for a link with a matching or semantically similar label.
+
+3.  **Resolve Path:** If a link is found, resolve its path **relative to the directory containing the `index.md` file**.
+    -   *Example:* If `conductor/index.md` links to `./workflow.md`, the full path is `conductor/workflow.md`.
+
+4.  **Fallback:** If the index file is missing or the link is absent, use the **Default Path** keys below.
+
+5.  **Verify:** You MUST verify the resolved file actually exists on the disk.
+
+**Standard Default Paths (Project):**
+- **Product Definition**: `conductor/product.md`
+- **Tech Stack**: `conductor/tech-stack.md`
+- **Workflow**: `conductor/workflow.md`
+- **Product Guidelines**: `conductor/product-guidelines.md`
+- **Tracks Registry**: `conductor/tracks.md`
+- **Tracks Directory**: `conductor/tracks/`
+
+**Standard Default Paths (Track):**
+- **Specification**: `conductor/tracks/<track_id>/spec.md`
+- **Implementation Plan**: `conductor/tracks/<track_id>/plan.md`
+- **Metadata**: `conductor/tracks/<track_id>/metadata.json`
+

package/dist/templates/commands/setup.toml

@@ -275,7 +275,7 @@ CRITICAL: When determining model complexity, ALWAYS select the "flash" model, re
 ### 2.4 Select Guides (Interactive)
 1.  **Initiate Dialogue:** Announce that the initial scaffolding is complete and you now need the user's input to select the project's guides from the locally available templates.
 2.  **Select Code Style Guides:**
-    -   List the available style guides by running `ls __$$CODE_AGENT_INSTALL_PATH$$__/templates/code_styleguides/`.
+    -   List the available style guides by running `ls ~/.gemini/extensions/conductor/templates/code_styleguides/`.
     -   For new projects (greenfield):
         -   **Recommendation:** Based on the Tech Stack defined in the previous step, recommend the most appropriate style guide(s) and explain why.
         -   Ask the user how they would like to proceed:
@@ -290,13 +290,13 @@ CRITICAL: When determining model complexity, ALWAYS select the "flash" model, re
             - Ask the user for a simple confirmation to proceed with options like:
                     A) Yes, I want to proceed with the suggested code style guides.
                     B) No, I want to add more code style guides.
-    -   **Action:** Construct and execute a command to create the directory and copy all selected files. For example: `mkdir -p conductor/code_styleguides && cp __$$CODE_AGENT_INSTALL_PATH$$__/templates/code_styleguides/python.md __$$CODE_AGENT_INSTALL_PATH$$__/templates/code_styleguides/javascript.md conductor/code_styleguides/`
+    -   **Action:** Construct and execute a command to create the directory and copy all selected files. For example: `mkdir -p conductor/code_styleguides && cp ~/.gemini/extensions/conductor/templates/code_styleguides/python.md ~/.gemini/extensions/conductor/templates/code_styleguides/javascript.md conductor/code_styleguides/`
     -   **Commit State:** Upon successful completion of the copy command, you MUST immediately write to `conductor/setup_state.json` with the exact content:
         `{"last_successful_step": "2.4_code_styleguides"}`
 
 ### 2.5 Select Workflow (Interactive)
 1.  **Copy Initial Workflow:**
-    -   Copy `__$$CODE_AGENT_INSTALL_PATH$$__/templates/workflow.md` to `conductor/workflow.md`.
+    -   Copy `~/.gemini/extensions/conductor/templates/workflow.md` to `conductor/workflow.md`.
 2.  **Customize Workflow:**
     -   Ask the user: "Do you want to use the default workflow or customize it?"
         The default workflow includes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conductor-4-all",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Conductor spec-driven development CLI - TypeScript/Node.js version",
   "license": "Apache-2.0",
   "repository": {