conductor-4-all 0.0.3 → 0.0.5

package/README.md

@@ -1,6 +1,12 @@
 # Conductor for All
 
-**Conductor for All** is a standalone command-line tool designed to bring the [Conductor](https://github.com/google/labs-prototypes/tree/main/gemini-cli) spec-driven development methodology to *any* coding environment.
+[![npm version](https://badge.fury.io/js/conductor-4-all.svg)](https://badge.fury.io/js/conductor-4-all)
+
+<img src="./conductor_banner.png" height="400" alt="Conductor for All Banner" />
+
+[English](./README.md) | [中文](./README_zh.md) | [日本語](./README_ja.md) | [한국어](./README_ko.md)
+
+**Conductor for All** is a standalone command-line tool designed to bring the [Conductor](https://github.com/gemini-cli-extensions/conductor) spec-driven development methodology to *any* coding environment.
 
 Originally tied to the Gemini CLI extension, this project aims to decouple the methodology, allowing developers to install and initialize Conductor workflows in their projects so they can be leveraged by **any** AI Coding Agent (e.g., Claude Code, Cline, Cursor, Windsurf) or IDE.
 
@@ -12,36 +18,29 @@ Originally tied to the Gemini CLI extension, this project aims to decouple the m
 
 ## 🚀 Usage
 
-### 1. Installation
-
-#### Global Installation via npm (Recommended)
-
-```bash
-npm install -g conductor-4-all
-```
+### 1. Setup Conductor in Your Project
 
-#### From Source
+To initialize Conductor in your project, simply run the following command in your project root:
 
 ```bash
-npm install
-npm run build
+npx conductor-4-all install
 ```
 
-### 2. Setup Conductor in Your Project
+### 2. Alternative: Build from Source
 
-Run the `install` command in the root of your project:
+If you prefer to build from source:
 
 ```bash
-# If installed globally:
-conductor install
-
-# If built from source:
+pnpm install
+pnpm build
 node dist/index.js install
 ```
 
 You will be prompted to select your AI Coding Agent:
 -   **Opencode**
 -   **Claude Code**
+-   **Antigravity**
+-   **Cursor**
 
 This will verify the environment and install the necessary Conductor files:
 -   **Commands:** Agent-specific prompt files (e.g., `.opencode/commands/conductor:setup.md`) that your agent can execute.
@@ -58,19 +57,8 @@ Once installed, you can instruct your AI Agent to perform Conductor tasks using
 
 *Note: The exact invocation syntax depends on your specific agent's slash command or file context capabilities.*
 
-## 🛠️ Contribution Guide
-
-We follow a strict spec-driven development workflow ourselves!
-
--   **Workflow:** Please read [`conductor/workflow.md`](./conductor/workflow.md) for our detailed development protocols (Tasks, TDD, Commits).
--   **Tech Stack:** Check [`conductor/tech-stack.md`](./conductor/tech-stack.md) for approved technologies (TypeScript/Node.js).
--   **Product Guidelines:** See [`conductor/product-guidelines.md`](./conductor/product-guidelines.md) for design philosophy.
 
-To start contributing:
-1.  Read the docs above.
-2.  Pick a task from `conductor/tracks.md` (or propose one).
-3.  Follow the **Conductor Workflow** to implement it.
 
 ## 🙏 Acknowledgements
 
-This project is inspired by and based on the **Conductor** methodology originally developed for the **Gemini CLI**. We aim to extend its benefits to the broader developer ecosystem.
+This project is inspired by and based on the [Conductor](https://github.com/gemini-cli-extensions/conductor) methodology originally developed for the **Gemini CLI**. We aim to extend its benefits to the broader developer ecosystem.

package/dist/index.cjs

@@ -23,7 +23,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// node_modules/tsup/assets/cjs_shims.js
+// node_modules/.pnpm/tsup@8.5.1_postcss@8.5.6_typescript@5.9.3/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
@@ -40,12 +40,22 @@ async function promptForAgent() {
       {
         name: "OpenCode",
         value: "opencode",
-        description: "Gemini-based coding assistant"
+        description: "The open source AI coding agent"
       },
       {
         name: "Claude Code",
         value: "claude-code",
-        description: "Anthropic-based coding assistant"
+        description: "Anthropic's coding assistant"
+      },
+      {
+        name: "Antigravity",
+        value: "antigravity",
+        description: "Google's agentic coding assistant"
+      },
+      {
+        name: "Cursor",
+        value: "cursor",
+        description: "Cursor IDE's AI agent"
       }
     ],
     default: "opencode"
@@ -53,9 +63,9 @@ async function promptForAgent() {
   return answer;
 }
 
-// src/utils/install.ts
-var import_fs_extra = __toESM(require("fs-extra"), 1);
+// src/generators/ConfigurableGenerator.ts
 var import_path2 = require("path");
+var import_fs_extra = __toESM(require("fs-extra"), 1);
 var import_smol_toml = require("smol-toml");
 
 // src/utils/template.ts
@@ -94,56 +104,160 @@ async function loadTemplate(templatePath) {
   return (0, import_promises.readFile)(fullPath, "utf-8");
 }
 
-// src/utils/install.ts
+// src/generators/ConfigurableGenerator.ts
 var { existsSync, ensureDir, writeFile, copy } = import_fs_extra.default;
-async function validateProjectDirectory(targetDir, agentType) {
-  if (!existsSync(targetDir)) {
-    throw new Error(`Target directory does not exist: ${targetDir}`);
-  }
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = (0, import_path2.join)(targetDir, agentDir);
-  const conductorPath = (0, import_path2.join)(agentPath, "conductor");
-  const setupFile = (0, import_path2.join)(agentPath, "commands", "conductor:setup.md");
-  if (existsSync(conductorPath) && existsSync(setupFile)) {
-    throw new Error(`Conductor (${agentType}) is already installed in: ${targetDir}`);
-  }
-  return targetDir;
-}
-async function createConductorDirectories(targetDir, agentType) {
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = (0, import_path2.join)(targetDir, agentDir);
-  await ensureDir((0, import_path2.join)(agentPath, "commands"));
-  await ensureDir((0, import_path2.join)(agentPath, "conductor"));
+function processTemplateContent(tomlContent, installPath, agentType) {
+  const parsed = (0, import_smol_toml.parse)(tomlContent);
+  if (!parsed.prompt) {
+    return null;
+  }
+  let prompt = parsed.prompt;
+  prompt = prompt.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g, installPath);
+  const finalContent = substituteVariables(prompt, { agent_type: agentType });
+  if (parsed.description) {
+    return `---
+description: ${parsed.description}
+---
+${finalContent}`;
+  }
+  return finalContent;
 }
-async function copyTemplateFiles(targetDir, agentType) {
-  const commands = ["setup", "newTrack", "implement", "status", "revert"];
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = (0, import_path2.join)(targetDir, agentDir);
-  const commandsDir = (0, import_path2.join)(agentPath, "commands");
-  const templateRoot = await getTemplateRoot();
-  const installPath = (0, import_path2.join)(targetDir, agentDir, "conductor");
-  try {
-    const templateSource = (0, import_path2.join)(templateRoot, "templates");
-    const templateDest = (0, import_path2.join)(agentPath, "conductor", "templates");
-    await copy(templateSource, templateDest);
-  } catch (e) {
-    console.warn("Failed to copy templates directory:", e);
+var ConfigurableGenerator = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async validate(targetDir) {
+    if (!existsSync(targetDir)) {
+      throw new Error(`Target directory does not exist: ${targetDir}`);
+    }
+    const { agentDir, commandsDir, displayName } = this.config;
+    const setupFile = (0, import_path2.join)(targetDir, agentDir, commandsDir, "conductor:setup.md");
+    const conductorPath = (0, import_path2.join)(targetDir, agentDir, "conductor");
+    if (existsSync(conductorPath) && existsSync(setupFile)) {
+      throw new Error(`Conductor (${displayName}) is already installed in: ${targetDir}`);
+    }
+    return targetDir;
   }
-  for (const cmd of commands) {
+  async generate(targetDir) {
+    const { agentDir, commandsDir, agentType } = this.config;
+    const agentPath = (0, import_path2.join)(targetDir, agentDir);
+    const targetCommandsDir = (0, import_path2.join)(agentPath, commandsDir);
+    const installPath = (0, import_path2.join)(agentDir, "conductor");
+    await ensureDir(targetCommandsDir);
+    await ensureDir((0, import_path2.join)(agentPath, "conductor"));
+    const templateRoot = await getTemplateRoot();
     try {
-      const tomlContent = await loadTemplate(`commands/${cmd}.toml`);
-      const parsed = (0, import_smol_toml.parse)(tomlContent);
-      if (!parsed.prompt) {
-        console.warn(`Warning: No prompt found in ${cmd}.toml`);
-        continue;
-      }
-      let prompt = parsed.prompt;
-      prompt = prompt.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g, installPath);
-      const finalPrompt = substituteVariables(prompt, { agent_type: agentType });
-      await writeFile((0, import_path2.join)(commandsDir, `conductor:${cmd}.md`), finalPrompt);
+      const templateSource = (0, import_path2.join)(templateRoot, "templates");
+      const templateDest = (0, import_path2.join)(agentPath, "conductor", "templates");
+      await copy(templateSource, templateDest);
     } catch (e) {
-      console.warn(`Failed to process ${cmd}:`, e);
+      console.warn("Failed to copy templates directory:", e);
     }
+    const commands = ["setup", "newTrack", "implement", "status", "revert"];
+    for (const cmd of commands) {
+      try {
+        const tomlContent = await loadTemplate(`commands/${cmd}.toml`);
+        const finalContent = processTemplateContent(tomlContent, installPath, agentType);
+        if (finalContent) {
+          const fileName = `conductor:${cmd}.md`;
+          await writeFile((0, import_path2.join)(targetCommandsDir, fileName), finalContent);
+        }
+      } catch (e) {
+        console.warn(`Failed to process ${cmd}:`, e);
+      }
+    }
+  }
+};
+
+// src/generators/factory.ts
+function createGenerator(config) {
+  return new ConfigurableGenerator(config);
+}
+
+// src/generators/config.ts
+var AGENT_CONFIGS = {
+  opencode: {
+    agentType: "opencode",
+    agentDir: ".opencode",
+    commandsDir: "commands",
+    displayName: "OpenCode"
+  },
+  "claude-code": {
+    agentType: "claude-code",
+    agentDir: ".claude",
+    commandsDir: "commands",
+    displayName: "Claude Code"
+  },
+  antigravity: {
+    agentType: "antigravity",
+    agentDir: ".agent",
+    commandsDir: "workflows",
+    displayName: "Antigravity"
+  },
+  cursor: {
+    agentType: "cursor",
+    agentDir: ".cursor",
+    commandsDir: "commands",
+    displayName: "Cursor"
+  }
+};
+
+// src/generators/OpenCodeGenerator.ts
+var OpenCodeGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.opencode);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/ClaudeCodeGenerator.ts
+var ClaudeCodeGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS["claude-code"]);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/AntigravityGenerator.ts
+var AntigravityGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.antigravity);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/CursorGenerator.ts
+var CursorGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.cursor);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/index.ts
+function getGenerator(agentType) {
+  switch (agentType) {
+    case "claude-code":
+      return new ClaudeCodeGenerator();
+    case "antigravity":
+      return new AntigravityGenerator();
+    case "cursor":
+      return new CursorGenerator();
+    case "opencode":
+    default:
+      return new OpenCodeGenerator();
   }
 }
 
@@ -156,15 +270,13 @@ async function installHandler(argv) {
     console.log("Step 1: Prompting for agent selection...");
     const agent = await promptForAgent();
     console.log(`\u2714 Selected agent: ${agent}`);
+    const generator = getGenerator(agent);
     console.log("\nStep 2: Validating project directory...");
-    const validatedPath = await validateProjectDirectory(targetDir, agent);
+    const validatedPath = await generator.validate(targetDir);
     console.log(`\u2714 Validation complete: ${validatedPath}`);
-    console.log("\nStep 3: Creating Conductor directories...");
-    await createConductorDirectories(validatedPath, agent);
-    console.log("\u2714 Directories created");
-    console.log("\nStep 4: Copying template files...");
-    await copyTemplateFiles(validatedPath, agent);
-    console.log("\u2714 Templates copied");
+    console.log("\nStep 3: Generating files...");
+    await generator.generate(validatedPath);
+    console.log("\u2714 Files generated");
     console.log("\n\u2714 Conductor initialized successfully!");
   } catch (err) {
     console.error("\n\u2718 Installation failed:", err instanceof Error ? err.message : err);

package/dist/index.js

@@ -13,12 +13,22 @@ async function promptForAgent() {
       {
         name: "OpenCode",
         value: "opencode",
-        description: "Gemini-based coding assistant"
+        description: "The open source AI coding agent"
       },
       {
         name: "Claude Code",
         value: "claude-code",
-        description: "Anthropic-based coding assistant"
+        description: "Anthropic's coding assistant"
+      },
+      {
+        name: "Antigravity",
+        value: "antigravity",
+        description: "Google's agentic coding assistant"
+      },
+      {
+        name: "Cursor",
+        value: "cursor",
+        description: "Cursor IDE's AI agent"
       }
     ],
     default: "opencode"
@@ -26,9 +36,9 @@ async function promptForAgent() {
   return answer;
 }
 
-// src/utils/install.ts
-import fs from "fs-extra";
+// src/generators/ConfigurableGenerator.ts
 import { join as join2 } from "path";
+import fs from "fs-extra";
 import { parse } from "smol-toml";
 
 // src/utils/template.ts
@@ -67,56 +77,160 @@ async function loadTemplate(templatePath) {
   return readFile(fullPath, "utf-8");
 }
 
-// src/utils/install.ts
+// src/generators/ConfigurableGenerator.ts
 var { existsSync, ensureDir, writeFile, copy } = fs;
-async function validateProjectDirectory(targetDir, agentType) {
-  if (!existsSync(targetDir)) {
-    throw new Error(`Target directory does not exist: ${targetDir}`);
-  }
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = join2(targetDir, agentDir);
-  const conductorPath = join2(agentPath, "conductor");
-  const setupFile = join2(agentPath, "commands", "conductor:setup.md");
-  if (existsSync(conductorPath) && existsSync(setupFile)) {
-    throw new Error(`Conductor (${agentType}) is already installed in: ${targetDir}`);
-  }
-  return targetDir;
-}
-async function createConductorDirectories(targetDir, agentType) {
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = join2(targetDir, agentDir);
-  await ensureDir(join2(agentPath, "commands"));
-  await ensureDir(join2(agentPath, "conductor"));
+function processTemplateContent(tomlContent, installPath, agentType) {
+  const parsed = parse(tomlContent);
+  if (!parsed.prompt) {
+    return null;
+  }
+  let prompt = parsed.prompt;
+  prompt = prompt.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g, installPath);
+  const finalContent = substituteVariables(prompt, { agent_type: agentType });
+  if (parsed.description) {
+    return `---
+description: ${parsed.description}
+---
+${finalContent}`;
+  }
+  return finalContent;
 }
-async function copyTemplateFiles(targetDir, agentType) {
-  const commands = ["setup", "newTrack", "implement", "status", "revert"];
-  const agentDir = agentType === "claude-code" ? ".claude" : ".opencode";
-  const agentPath = join2(targetDir, agentDir);
-  const commandsDir = join2(agentPath, "commands");
-  const templateRoot = await getTemplateRoot();
-  const installPath = join2(targetDir, agentDir, "conductor");
-  try {
-    const templateSource = join2(templateRoot, "templates");
-    const templateDest = join2(agentPath, "conductor", "templates");
-    await copy(templateSource, templateDest);
-  } catch (e) {
-    console.warn("Failed to copy templates directory:", e);
+var ConfigurableGenerator = class {
+  constructor(config) {
+    this.config = config;
   }
-  for (const cmd of commands) {
+  async validate(targetDir) {
+    if (!existsSync(targetDir)) {
+      throw new Error(`Target directory does not exist: ${targetDir}`);
+    }
+    const { agentDir, commandsDir, displayName } = this.config;
+    const setupFile = join2(targetDir, agentDir, commandsDir, "conductor:setup.md");
+    const conductorPath = join2(targetDir, agentDir, "conductor");
+    if (existsSync(conductorPath) && existsSync(setupFile)) {
+      throw new Error(`Conductor (${displayName}) is already installed in: ${targetDir}`);
+    }
+    return targetDir;
+  }
+  async generate(targetDir) {
+    const { agentDir, commandsDir, agentType } = this.config;
+    const agentPath = join2(targetDir, agentDir);
+    const targetCommandsDir = join2(agentPath, commandsDir);
+    const installPath = join2(agentDir, "conductor");
+    await ensureDir(targetCommandsDir);
+    await ensureDir(join2(agentPath, "conductor"));
+    const templateRoot = await getTemplateRoot();
     try {
-      const tomlContent = await loadTemplate(`commands/${cmd}.toml`);
-      const parsed = parse(tomlContent);
-      if (!parsed.prompt) {
-        console.warn(`Warning: No prompt found in ${cmd}.toml`);
-        continue;
-      }
-      let prompt = parsed.prompt;
-      prompt = prompt.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g, installPath);
-      const finalPrompt = substituteVariables(prompt, { agent_type: agentType });
-      await writeFile(join2(commandsDir, `conductor:${cmd}.md`), finalPrompt);
+      const templateSource = join2(templateRoot, "templates");
+      const templateDest = join2(agentPath, "conductor", "templates");
+      await copy(templateSource, templateDest);
     } catch (e) {
-      console.warn(`Failed to process ${cmd}:`, e);
+      console.warn("Failed to copy templates directory:", e);
     }
+    const commands = ["setup", "newTrack", "implement", "status", "revert"];
+    for (const cmd of commands) {
+      try {
+        const tomlContent = await loadTemplate(`commands/${cmd}.toml`);
+        const finalContent = processTemplateContent(tomlContent, installPath, agentType);
+        if (finalContent) {
+          const fileName = `conductor:${cmd}.md`;
+          await writeFile(join2(targetCommandsDir, fileName), finalContent);
+        }
+      } catch (e) {
+        console.warn(`Failed to process ${cmd}:`, e);
+      }
+    }
+  }
+};
+
+// src/generators/factory.ts
+function createGenerator(config) {
+  return new ConfigurableGenerator(config);
+}
+
+// src/generators/config.ts
+var AGENT_CONFIGS = {
+  opencode: {
+    agentType: "opencode",
+    agentDir: ".opencode",
+    commandsDir: "commands",
+    displayName: "OpenCode"
+  },
+  "claude-code": {
+    agentType: "claude-code",
+    agentDir: ".claude",
+    commandsDir: "commands",
+    displayName: "Claude Code"
+  },
+  antigravity: {
+    agentType: "antigravity",
+    agentDir: ".agent",
+    commandsDir: "workflows",
+    displayName: "Antigravity"
+  },
+  cursor: {
+    agentType: "cursor",
+    agentDir: ".cursor",
+    commandsDir: "commands",
+    displayName: "Cursor"
+  }
+};
+
+// src/generators/OpenCodeGenerator.ts
+var OpenCodeGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.opencode);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/ClaudeCodeGenerator.ts
+var ClaudeCodeGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS["claude-code"]);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/AntigravityGenerator.ts
+var AntigravityGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.antigravity);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/CursorGenerator.ts
+var CursorGenerator = class {
+  generator = createGenerator(AGENT_CONFIGS.cursor);
+  validate(targetDir) {
+    return this.generator.validate(targetDir);
+  }
+  generate(targetDir) {
+    return this.generator.generate(targetDir);
+  }
+};
+
+// src/generators/index.ts
+function getGenerator(agentType) {
+  switch (agentType) {
+    case "claude-code":
+      return new ClaudeCodeGenerator();
+    case "antigravity":
+      return new AntigravityGenerator();
+    case "cursor":
+      return new CursorGenerator();
+    case "opencode":
+    default:
+      return new OpenCodeGenerator();
   }
 }
 
@@ -129,15 +243,13 @@ async function installHandler(argv) {
     console.log("Step 1: Prompting for agent selection...");
     const agent = await promptForAgent();
     console.log(`\u2714 Selected agent: ${agent}`);
+    const generator = getGenerator(agent);
     console.log("\nStep 2: Validating project directory...");
-    const validatedPath = await validateProjectDirectory(targetDir, agent);
+    const validatedPath = await generator.validate(targetDir);
     console.log(`\u2714 Validation complete: ${validatedPath}`);
-    console.log("\nStep 3: Creating Conductor directories...");
-    await createConductorDirectories(validatedPath, agent);
-    console.log("\u2714 Directories created");
-    console.log("\nStep 4: Copying template files...");
-    await copyTemplateFiles(validatedPath, agent);
-    console.log("\u2714 Templates copied");
+    console.log("\nStep 3: Generating files...");
+    await generator.generate(validatedPath);
+    console.log("\u2714 Files generated");
     console.log("\n\u2714 Conductor initialized successfully!");
   } catch (err) {
     console.error("\n\u2718 Installation failed:", err instanceof Error ? err.message : err);

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "conductor-4-all",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Conductor spec-driven development CLI - TypeScript/Node.js version",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/hlhr202/Conductor-for-all.git"
   },
   "homepage": "https://github.com/hlhr202/Conductor-for-all",
+  "packageManager": "pnpm@10.24.0",
+  "engines": {
+    "node": ">=18"
+  },
   "type": "module",
   "bin": {
     "conductor": "./dist/index.js",