conductor-4-all 0.0.12 → 0.0.14

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/templates/code_styleguides/cpp.md

@@ -0,0 +1,113 @@
+# Google C++ Style Guide Summary
+
+## 1. Naming
+- **General:** Optimize for readability. Be descriptive but concise. Use inclusive language.
+- **Files:** `.h` (headers), `.cc` (source). Lowercase with underscores (`_`) or dashes (`-`). Be consistent.
+- **Types:** PascalCase (`MyClass`, `MyEnum`). Use `int` by default; use `<cstdint>` (`int32_t`) if size matters.
+- **Concepts:** PascalCase (`MyConcept`).
+- **Variables:** snake_case (`my_var`). Class members end with underscore (`my_member_`), struct members do not.
+- **Constants/Enumerators:** `k` + PascalCase (`kDays`, `kOk`).
+- **Template Parameters:** PascalCase for types (`T`, `MyType`), snake_case/kPascalCase for non-types (`N`, `kLimit`).
+- **Functions:** PascalCase (`GetValue()`).
+- **Accessors/Mutators:** snake_case. `count()` (not `GetCount`), `set_count(v)`.
+- **Namespaces:** lowercase (`web_search`).
+- **Macros:** ALL_CAPS (`MY_MACRO`).
+
+## 2. Header Files
+- **General:** Every `.cc` usually has a `.h`. Headers must be self-contained.
+- **Guards:** Use `#define <PROJECT>_<PATH>_<FILE>_H_`.
+- **IWYU:** Direct includes only. Do not rely on transitive includes.
+- **Forward Decls:** Avoid. Include headers instead. **Never** forward declare `std::` symbols.
+- **Inline Definitions:** Only short functions (<10 lines) in headers. Must be ODR-safe (`inline` or templates).
+- **Include Order:**
+  1. Related header (`foo.h`)
+  2. C system (`<unistd.h>`)
+  3. C++ standard (`<vector>`)
+  4. Other libraries (`<Python.h>`)
+  5. Project headers (`"base/logging.h"`)
+  *Separate groups with blank lines. Alphabetical within groups.*
+
+## 3. Formatting
+- **Indentation:** 2 spaces. **Line Length:** 80 chars.
+- **Non-ASCII:** Rare, use UTF-8. Avoid `u8` prefix if possible.
+- **Braces:** `if (cond) { ... }`. **Exception:** Function definition open brace goes on the **next line**.
+- **Switch:** Always include `default`. Use `[[fallthrough]]` for explicit fallthrough.
+- **Literals:** Floating-point must have radix point (`1.0f`).
+- **Calls:** Wrap arguments at paren or 4-space indent.
+- **Init Lists:** Colon on new line, indent 4 spaces.
+- **Namespaces:** No indentation.
+- **Vertical Whitespace:** Use sparingly. Separate related chunks, not code blocks.
+- **Loops/Branching:** Use braces (optional if single line). No space after `(`, space before `{`.
+- **Return:** No parens `return result;`.
+- **Preprocessor:** `#` always at line start.
+- **Pointers:** `char* c` (attached to type).
+- **Templates:** No spaces inside `< >` (`vector<int>`).
+- **Operators:** Space around assignment/binary, no space for unary.
+- **Class Order:** `public`, `protected`, `private`.
+- **Parameter Wrapping:** Wrap parameter lists that don't fit. Use 4-space indent for wrapped parameters.
+
+## 4. Classes
+- **Constructors:** `explicit` for single-arg and conversion operators. **Exception:** `std::initializer_list`. No virtual calls in ctors. Use factories for fallible init.
+- **Structs:** Only for passive data. Prefer `struct` over `std::pair` or `std::tuple`.
+- **Copy/Move:** Explicitly `= default` or `= delete`. **Rule of 5:** If defining one, declare all.
+- **Inheritance:** `public` only. Composition > Inheritance. Use `override` (omit `virtual`). No multiple implementation inheritance.
+- **Operator Overloading:** Judicious use only. Binary ops as non-members. Never overload `&&`, `||`, `,`, or unary `&`. No User-Defined Literals.
+- **Access:** Data members `private` (except structs/constants).
+- **Declaration Order:** `public` before `protected` before `private`. Within sections: Types, Constants, Factory, Constructors, Destructor, Methods, Data Members.
+
+## 5. Functions
+- **Params:** Inputs (`const T&`, `std::string_view`, `std::span` or value) first, then outputs. **Ordering:** Inputs before outputs.
+- **Outputs:** Prefer return values/`std::optional`. For non-optional outputs, use references. For optional outputs, use pointers.
+- **Optional Inputs:** Use `std::optional` for by-value, `const T*` for reference.
+- **Nonmember vs Static:** Prefer nonmember functions in namespaces over static member functions.
+- **Length:** Prefer small (<40 lines).
+- **Overloading:** Use only when behavior is obvious. Document overload sets with a single umbrella comment.
+- **Default Args:** Allowed on non-virtual functions only (value must be fixed/constant).
+- **Trailing Return:** Only when necessary (lambdas).
+
+## 6. Scoping
+- **Namespaces:** No `using namespace`. Use `using std::string`. Never add to `namespace std`.
+- **Internal:** Use anonymous namespaces or `static` in `.cc` files. Avoid in headers.
+- **Locals:** Narrowest scope. Initialize at declaration. **Exception:** Declare complex objects outside loops.
+- **Static/Global:** Must be **trivially destructible** (e.g., `constexpr`, raw pointers, arrays). No global `std::string`, `std::map`, smart pointers. Dynamic initialization allowed only for function-static variables.
+- **Thread Local:** `thread_local` must be `constinit` if global. Prefer `thread_local` over other mechanisms.
+
+## 7. Modern C++ Features
+- **Version:** Target **C++20**. Do not use C++23. Consider portability for C++17/20 features. No non-standard extensions.
+- **Modules:** Do not use C++20 Modules.
+- **Coroutines:** Use approved libraries only. Do not roll your own promise or awaitable types.
+- **Concepts:** Prefer C++20 Concepts (`requires`) over `std::enable_if`. Use `requires(Concept<T>)`, not `template<Concept T>`.
+- **R-Value References:** Use only for move ctors/assignment, perfect forwarding, or consuming `*this`.
+- **Smart Pointers:** `std::unique_ptr` (exclusive), `std::shared_ptr` (shared). No `std::auto_ptr`.
+- **Auto:** Use when type is obvious (`make_unique`, iterators). Avoid for public APIs.
+- **CTAD:** Use only if explicitly supported (deduction guides exist).
+- **Structured Bindings:** Use for pairs/tuples. Comment aliased field names.
+- **Nullptr:** Use `nullptr`, never `NULL` or `0`.
+- **Constexpr:** Use `constexpr`/`consteval` for constants/functions whenever possible. Use `constinit` for static initialization.
+- **Noexcept:** Specify when useful/correct. Prefer unconditional `noexcept` if exceptions are disabled.
+- **Lambdas:** Prefer explicit captures (`[&x]`) if escaping scope. Avoid `std::bind`.
+- **Initialization:** Prefer brace init. **Designated Initializers:** Allowed (C++20 ordered form only).
+- **Casts:** Use C++ casts (`static_cast`). Use `std::bit_cast` for type punning.
+- **Loops:** Prefer range-based `for`.
+
+## 8. Best Practices
+- **Const:** Mark methods/variables `const` whenever possible. `const` methods must be thread-safe.
+- **Exceptions:** **Forbidden**.
+- **RTTI:** Avoid `dynamic_cast`/`typeid`. Allowed in unit tests. Do not hand-implement workarounds.
+- **Macros:** Avoid. Use `constexpr`/`inline`. If needed, define close to use and `#undef` immediately. Do not define in headers.
+- **0 and nullptr:** Use `nullptr` for pointers, `\0` for chars, not `0`.
+- **Streams:** Use streams primarily for logging. Prefer printf-style formatting or absl::StrCat.
+- **Types:** Avoid `unsigned` for non-negativity. No `long double`.
+- **Pre-increment:** Prefer `++i` over `i++`.
+- **Sizeof:** Prefer `sizeof(varname)` over `sizeof(type)`.
+- **Friends:** Allowed, usually defined in the same file.
+- **Boost:** Use only approved libraries (e.g., Call Traits, Compressed Pair, BGL, Property Map, Iterator, etc.).
+- **Aliases:** Use `using` instead of `typedef`. Public aliases must be documented.
+- **Ownership:** Single fixed owner. Transfer via smart pointers.
+- **Aliases:** Document intent. Don't use in public API for convenience. `using` > `typedef`.
+- **Switch:** Always include `default`. Use `[[fallthrough]]` for explicit fallthrough.
+- **Comments:** Document File, Class, Function (params/return). Use `//` or `/* */`. Implementation comments for tricky code. `TODO(user):` format.
+
+**BE CONSISTENT.** Follow existing code style.
+
+*Source: [Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html)*

package/package.json

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