conductor-init 0.0.1

package/dist/conductor/templates/workflow.md

@@ -0,0 +1,333 @@
+# Project Workflow
+
+## Guiding Principles
+
+1. **The Plan is the Source of Truth:** All work must be tracked in `plan.md`
+2. **The Tech Stack is Deliberate:** Changes to the tech stack must be documented in `tech-stack.md` *before* implementation
+3. **Test-Driven Development:** Write unit tests before implementing functionality
+4. **High Code Coverage:** Aim for >80% code coverage for all modules
+5. **User Experience First:** Every decision should prioritize user experience
+6. **Non-Interactive & CI-Aware:** Prefer non-interactive commands. Use `CI=true` for watch-mode tools (tests, linters) to ensure single execution.
+
+## Task Workflow
+
+All tasks follow a strict lifecycle:
+
+### Standard Task Workflow
+
+1. **Select Task:** Choose the next available task from `plan.md` in sequential order
+
+2. **Mark In Progress:** Before beginning work, edit `plan.md` and change the task from `[ ]` to `[~]`
+
+3. **Write Failing Tests (Red Phase):**
+   - Create a new test file for the feature or bug fix.
+   - Write one or more unit tests that clearly define the expected behavior and acceptance criteria for the task.
+   - **CRITICAL:** Run the tests and confirm that they fail as expected. This is the "Red" phase of TDD. Do not proceed until you have failing tests.
+
+4. **Implement to Pass Tests (Green Phase):**
+   - Write the minimum amount of application code necessary to make the failing tests pass.
+   - Run the test suite again and confirm that all tests now pass. This is the "Green" phase.
+
+5. **Refactor (Optional but Recommended):**
+   - With the safety of passing tests, refactor the implementation code and the test code to improve clarity, remove duplication, and enhance performance without changing the external behavior.
+   - Rerun tests to ensure they still pass after refactoring.
+
+6. **Verify Coverage:** Run coverage reports using the project's chosen tools. For example, in a Python project, this might look like:
+   ```bash
+   pytest --cov=app --cov-report=html
+   ```
+   Target: >80% coverage for new code. The specific tools and commands will vary by language and framework.
+
+7. **Document Deviations:** If implementation differs from tech stack:
+   - **STOP** implementation
+   - Update `tech-stack.md` with new design
+   - Add dated note explaining the change
+   - Resume implementation
+
+8. **Commit Code Changes:**
+   - Stage all code changes related to the task.
+   - Propose a clear, concise commit message e.g, `feat(ui): Create basic HTML structure for calculator`.
+   - Perform the commit.
+
+9. **Attach Task Summary with Git Notes:**
+   - **Step 9.1: Get Commit Hash:** Obtain the hash of the *just-completed commit* (`git log -1 --format="%H"`).
+   - **Step 9.2: Draft Note Content:** Create a detailed summary for the completed task. This should include the task name, a summary of changes, a list of all created/modified files, and the core "why" for the change.
+   - **Step 9.3: Attach Note:** Use the `git notes` command to attach the summary to the commit.
+     ```bash
+     # The note content from the previous step is passed via the -m flag.
+     git notes add -m "<note content>" <commit_hash>
+     ```
+
+10. **Get and Record Task Commit SHA:**
+    - **Step 10.1: Update Plan:** Read `plan.md`, find the line for the completed task, update its status from `[~]` to `[x]`, and append the first 7 characters of the *just-completed commit's* commit hash.
+    - **Step 10.2: Write Plan:** Write the updated content back to `plan.md`.
+
+11. **Commit Plan Update:**
+    - **Action:** Stage the modified `plan.md` file.
+    - **Action:** Commit this change with a descriptive message (e.g., `conductor(plan): Mark task 'Create user model' as complete`).
+
+### Phase Completion Verification and Checkpointing Protocol
+
+**Trigger:** This protocol is executed immediately after a task is completed that also concludes a phase in `plan.md`.
+
+1.  **Announce Protocol Start:** Inform the user that the phase is complete and the verification and checkpointing protocol has begun.
+
+2.  **Ensure Test Coverage for Phase Changes:**
+    -   **Step 2.1: Determine Phase Scope:** To identify the files changed in this phase, you must first find the starting point. Read `plan.md` to find the Git commit SHA of the *previous* phase's checkpoint. If no previous checkpoint exists, the scope is all changes since the first commit.
+    -   **Step 2.2: List Changed Files:** Execute `git diff --name-only <previous_checkpoint_sha> HEAD` to get a precise list of all files modified during this phase.
+    -   **Step 2.3: Verify and Create Tests:** For each file in the list:
+        -   **CRITICAL:** First, check its extension. Exclude non-code files (e.g., `.json`, `.md`, `.yaml`).
+        -   For each remaining code file, verify a corresponding test file exists.
+        -   If a test file is missing, you **must** create one. Before writing the test, **first, analyze other test files in the repository to determine the correct naming convention and testing style.** The new tests **must** validate the functionality described in this phase's tasks (`plan.md`).
+
+3.  **Execute Automated Tests with Proactive Debugging:**
+    -   Before execution, you **must** announce the exact shell command you will use to run the tests.
+    -   **Example Announcement:** "I will now run the automated test suite to verify the phase. **Command:** `CI=true npm test`"
+    -   Execute the announced command.
+    -   If tests fail, you **must** inform the user and begin debugging. You may attempt to propose a fix a **maximum of two times**. If the tests still fail after your second proposed fix, you **must stop**, report the persistent failure, and ask the user for guidance.
+
+4.  **Propose a Detailed, Actionable Manual Verification Plan:**
+    -   **CRITICAL:** To generate the plan, first analyze `product.md`, `product-guidelines.md`, and `plan.md` to determine the user-facing goals of the completed phase.
+    -   You **must** generate a step-by-step plan that walks the user through the verification process, including any necessary commands and specific, expected outcomes.
+    -   The plan you present to the user **must** follow this format:
+
+        **For a Frontend Change:**
+        ```
+        The automated tests have passed. For manual verification, please follow these steps:
+
+        **Manual Verification Steps:**
+        1.  **Start the development server with the command:** `npm run dev`
+        2.  **Open your browser to:** `http://localhost:3000`
+        3.  **Confirm that you see:** The new user profile page, with the user's name and email displayed correctly.
+        ```
+
+        **For a Backend Change:**
+        ```
+        The automated tests have passed. For manual verification, please follow these steps:
+
+        **Manual Verification Steps:**
+        1.  **Ensure the server is running.**
+        2.  **Execute the following command in your terminal:** `curl -X POST http://localhost:8080/api/v1/users -d '{"name": "test"}'`
+        3.  **Confirm that you receive:** A JSON response with a status of `201 Created`.
+        ```
+
+5.  **Await Explicit User Feedback:**
+    -   After presenting the detailed plan, ask the user for confirmation: "**Does this meet your expectations? Please confirm with yes or provide feedback on what needs to be changed.**"
+    -   **PAUSE** and await the user's response. Do not proceed without an explicit yes or confirmation.
+
+6.  **Create Checkpoint Commit:**
+    -   Stage all changes. If no changes occurred in this step, proceed with an empty commit.
+    -   Perform the commit with a clear and concise message (e.g., `conductor(checkpoint): Checkpoint end of Phase X`).
+
+7.  **Attach Auditable Verification Report using Git Notes:**
+    -   **Step 7.1: Draft Note Content:** Create a detailed verification report including the automated test command, the manual verification steps, and the user's confirmation.
+    -   **Step 7.2: Attach Note:** Use the `git notes` command and the full commit hash from the previous step to attach the full report to the checkpoint commit.
+
+8.  **Get and Record Phase Checkpoint SHA:**
+    -   **Step 8.1: Get Commit Hash:** Obtain the hash of the *just-created checkpoint commit* (`git log -1 --format="%H"`).
+    -   **Step 8.2: Update Plan:** Read `plan.md`, find the heading for the completed phase, and append the first 7 characters of the commit hash in the format `[checkpoint: <sha>]`.
+    -   **Step 8.3: Write Plan:** Write the updated content back to `plan.md`.
+
+9. **Commit Plan Update:**
+    - **Action:** Stage the modified `plan.md` file.
+    - **Action:** Commit this change with a descriptive message following the format `conductor(plan): Mark phase '<PHASE NAME>' as complete`.
+
+10.  **Announce Completion:** Inform the user that the phase is complete and the checkpoint has been created, with the detailed verification report attached as a git note.
+
+### Quality Gates
+
+Before marking any task complete, verify:
+
+- [ ] All tests pass
+- [ ] Code coverage meets requirements (>80%)
+- [ ] Code follows project's code style guidelines (as defined in `code_styleguides/`)
+- [ ] All public functions/methods are documented (e.g., docstrings, JSDoc, GoDoc)
+- [ ] Type safety is enforced (e.g., type hints, TypeScript types, Go types)
+- [ ] No linting or static analysis errors (using the project's configured tools)
+- [ ] Works correctly on mobile (if applicable)
+- [ ] Documentation updated if needed
+- [ ] No security vulnerabilities introduced
+
+## Development Commands
+
+**AI AGENT INSTRUCTION: This section should be adapted to the project's specific language, framework, and build tools.**
+
+### Setup
+```bash
+# Example: Commands to set up the development environment (e.g., install dependencies, configure database)
+# e.g., for a Node.js project: npm install
+# e.g., for a Go project: go mod tidy
+```
+
+### Daily Development
+```bash
+# Example: Commands for common daily tasks (e.g., start dev server, run tests, lint, format)
+# e.g., for a Node.js project: npm run dev, npm test, npm run lint
+# e.g., for a Go project: go run main.go, go test ./..., go fmt ./...
+```
+
+### Before Committing
+```bash
+# Example: Commands to run all pre-commit checks (e.g., format, lint, type check, run tests)
+# e.g., for a Node.js project: npm run check
+# e.g., for a Go project: make check (if a Makefile exists)
+```
+
+## Testing Requirements
+
+### Unit Testing
+- Every module must have corresponding tests.
+- Use appropriate test setup/teardown mechanisms (e.g., fixtures, beforeEach/afterEach).
+- Mock external dependencies.
+- Test both success and failure cases.
+
+### Integration Testing
+- Test complete user flows
+- Verify database transactions
+- Test authentication and authorization
+- Check form submissions
+
+### Mobile Testing
+- Test on actual iPhone when possible
+- Use Safari developer tools
+- Test touch interactions
+- Verify responsive layouts
+- Check performance on 3G/4G
+
+## Code Review Process
+
+### Self-Review Checklist
+Before requesting review:
+
+1. **Functionality**
+   - Feature works as specified
+   - Edge cases handled
+   - Error messages are user-friendly
+
+2. **Code Quality**
+   - Follows style guide
+   - DRY principle applied
+   - Clear variable/function names
+   - Appropriate comments
+
+3. **Testing**
+   - Unit tests comprehensive
+   - Integration tests pass
+   - Coverage adequate (>80%)
+
+4. **Security**
+   - No hardcoded secrets
+   - Input validation present
+   - SQL injection prevented
+   - XSS protection in place
+
+5. **Performance**
+   - Database queries optimized
+   - Images optimized
+   - Caching implemented where needed
+
+6. **Mobile Experience**
+   - Touch targets adequate (44x44px)
+   - Text readable without zooming
+   - Performance acceptable on mobile
+   - Interactions feel native
+
+## Commit Guidelines
+
+### Message Format
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+### Types
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation only
+- `style`: Formatting, missing semicolons, etc.
+- `refactor`: Code change that neither fixes a bug nor adds a feature
+- `test`: Adding missing tests
+- `chore`: Maintenance tasks
+
+### Examples
+```bash
+git commit -m "feat(auth): Add remember me functionality"
+git commit -m "fix(posts): Correct excerpt generation for short posts"
+git commit -m "test(comments): Add tests for emoji reaction limits"
+git commit -m "style(mobile): Improve button touch targets"
+```
+
+## Definition of Done
+
+A task is complete when:
+
+1. All code implemented to specification
+2. Unit tests written and passing
+3. Code coverage meets project requirements
+4. Documentation complete (if applicable)
+5. Code passes all configured linting and static analysis checks
+6. Works beautifully on mobile (if applicable)
+7. Implementation notes added to `plan.md`
+8. Changes committed with proper message
+9. Git note with task summary attached to the commit
+
+## Emergency Procedures
+
+### Critical Bug in Production
+1. Create hotfix branch from main
+2. Write failing test for bug
+3. Implement minimal fix
+4. Test thoroughly including mobile
+5. Deploy immediately
+6. Document in plan.md
+
+### Data Loss
+1. Stop all write operations
+2. Restore from latest backup
+3. Verify data integrity
+4. Document incident
+5. Update backup procedures
+
+### Security Breach
+1. Rotate all secrets immediately
+2. Review access logs
+3. Patch vulnerability
+4. Notify affected users (if any)
+5. Document and update security procedures
+
+## Deployment Workflow
+
+### Pre-Deployment Checklist
+- [ ] All tests passing
+- [ ] Coverage >80%
+- [ ] No linting errors
+- [ ] Mobile testing complete
+- [ ] Environment variables configured
+- [ ] Database migrations ready
+- [ ] Backup created
+
+### Deployment Steps
+1. Merge feature branch to main
+2. Tag release with version
+3. Push to deployment service
+4. Run database migrations
+5. Verify deployment
+6. Test critical paths
+7. Monitor for errors
+
+### Post-Deployment
+1. Monitor analytics
+2. Check error logs
+3. Gather user feedback
+4. Plan next iteration
+
+## Continuous Improvement
+
+- Review workflow weekly
+- Update based on pain points
+- Document lessons learned
+- Optimize for user happiness
+- Keep things simple and maintainable

package/dist/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import jt from"yargs";import{hideBin as Ot}from"yargs/helpers";import le from"@inquirer/select";var E={agentType:"opencode",agentDir:".opencode",commandsDir:"commands",displayName:"OpenCode",protocolFilename:"AGENTS.md",description:"The open source AI coding agent"};var N={agentType:"claude-code",agentDir:".claude",commandsDir:"commands",displayName:"Claude Code",protocolFilename:"CLAUDE.md",description:"Anthropic's coding assistant"};var D={agentType:"antigravity",agentDir:".agent",commandsDir:"workflows",displayName:"Antigravity",protocolFilename:"GEMINI.md",description:"Google's agentic coding assistant"};var F={agentType:"cursor",agentDir:".cursor",commandsDir:"commands",displayName:"Cursor",protocolFilename:"AGENTS.md",description:"Cursor IDE's AI agent"};import{parse as ct}from"smol-toml";import{readFile as rt}from"fs/promises";import{join as $e,resolve as Se}from"path";import{fileURLToPath as nt}from"url";import{homedir as it}from"os";import{execSync as ve}from"child_process";import{createHash as st}from"crypto";import $ from"fs-extra";var Ie=nt(new URL(".",import.meta.url)),P="https://github.com/gemini-cli-extensions/conductor",j="main";function Ge(o=P,e=j){let t=st("md5").update(`${o}#${e}`).digest("hex");return $e(it(),".gemini/cache/conductor",t)}async function at(o=P,e=j){let t=Ge(o,e);if($.existsSync(t))try{console.log(`Updating templates from ${o} [${e}]...`),ve("git pull --rebase",{cwd:t,stdio:["ignore","ignore","pipe"]})}catch(r){console.warn(`Failed to update templates (using cached version): ${r instanceof Error?r.message:String(r)}`)}else{await $.ensureDir(t),console.log(`Downloading templates from ${o} [${e}]...`);try{ve(`git clone ${o} --branch ${e} --depth 1 .`,{cwd:t,stdio:["ignore","ignore","pipe"]})}catch(r){throw await $.remove(t),new Error(`Failed to clone templates: ${r instanceof Error?r.message:String(r)}`)}}}function f(o,e){return o.replace(/\{(\w+)\}/g,(t,r)=>Object.prototype.hasOwnProperty.call(e,r)?e[r]:t)}function pt(){let o=Se(Ie,"conductor");return $.existsSync(o)?o:Se(Ie,"../conductor")}async function Te(o,e){if(!o){let t=pt();if(await $.pathExists(t))return console.log("use bundled Conductor templates"),t}return await at(o,e),Ge(o,e)}async function Ee(o,e){let t=$e(e,o);return rt(t,"utf-8")}var ne=class{process(e,t){let{installPath:r,agentType:n,fixedAgent:p}=t,a=ct(e);if(!a.prompt)return null;let c=a.prompt;c=c.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g,r);let g=f(c,{agent_type:n});return`---
+description: ${a.description||""}
+agent: ${p}
+---
+${g}`}},Ne=new ne;var O={agentType:"vscode-copilot",agentDir:".github",commandsDir:"prompts",displayName:"VS Code Copilot",protocolFilename:"AGENTS.md",description:"VS Code Copilot's Prompt Files",extension:".prompt.md",fixedAgent:"agent",strategy:{content:Ne}};var b={agentType:"codex",agentDir:".codex",commandsDir:"prompts",displayName:"Codex",protocolFilename:"AGENTS.md",description:"OpenAI Codex Agent",extension:".md"};var R={agentType:"windsurf",agentDir:".windsurf",commandsDir:"workflows",displayName:"Windsurf",protocolFilename:"AGENTS.md",description:"Windsurf Cascade AI Agent"};import{parse as gt}from"smol-toml";var ie=class{process(e,t){let{installPath:r,agentType:n,commandName:p}=t,a=gt(e);if(!a.prompt)return null;let c=a.prompt;c=c.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g,r);let g=f(c,{agent_type:n});return`# Conductor ${p?p.charAt(0).toUpperCase()+p.slice(1):"Command"}${a.description?`
+
+`+a.description+`
+
+`:`
+
+`}${g}`}},De=new ie;var L={agentType:"cline",agentDir:".clinerules",commandsDir:"workflows",displayName:"Cline",protocolFilename:"AGENTS.md",description:"Cline AI coding assistant",strategy:{content:De}};import{join as mt}from"path";import lt from"fs-extra";import{parse as dt}from"smol-toml";var{writeFile:ft}=lt,se=class{process(e,t){let{installPath:r,agentType:n}=t;if(!dt(e).prompt)return null;let a=e.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g,r);return f(a,{agent_type:n})}},ae=class{async write(e){let{targetDir:t,agentDir:r,commandsDir:n,commandName:p,extension:a,content:c}=e,g=`${p}${a}`;await ft(mt(t,r,n,g),c)}},Fe=new se,Pe=new ae;var k={agentType:"gemini",agentDir:".gemini",commandsDir:"commands/conductor",displayName:"Gemini CLI",protocolFilename:"GEMINI.md",description:"Google Gemini CLI agent",extension:".toml",usesPrefix:!1,strategy:{content:Fe,file:Pe}};import{parse as ut}from"smol-toml";var pe=class{process(e,t){let{installPath:r,agentType:n,commandName:p}=t,a=ut(e);if(!a.prompt)return null;let c=a.prompt;c=c.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g,r);let g=f(c,{agent_type:n});return`# Conductor ${p?p.charAt(0).toUpperCase()+p.slice(1):"Command"}${a.description?`
+
+`+a.description+`
+
+`:`
+
+`}${g}`}},je=new pe;var U={agentType:"kilo-code",agentDir:".kilocode",commandsDir:"workflows",displayName:"Kilo Code",protocolFilename:"AGENTS.md",description:"Kilo Code AI coding assistant",strategy:{content:je}};import{parse as yt}from"smol-toml";var ce=class{process(e,t){let{installPath:r,agentType:n,commandName:p}=t,a=yt(e);if(!a.prompt)return null;let c=a.prompt;c=c.replace("__$$CODE_AGENT_INSTALL_PATH$$__",r);let g=f(c,{agent_type:n});return`# Conductor ${p?p.charAt(0).toUpperCase()+p.slice(1):"Command"}${a.description?`
+
+`+a.description+`
+
+`:`
+
+`}${g}`}},Oe=new ce;var H={agentType:"roo-code",agentDir:".roo",commandsDir:"commands",displayName:"Roo Code",protocolFilename:"AGENTS.md",description:"Roo Code AI coding assistant",strategy:{content:Oe}};import{parse as xt}from"smol-toml";var ge=class{process(e,t){let{installPath:r,agentType:n}=t,p=xt(e);if(!p.prompt)return null;let a=p.prompt;a=a.replace("__$$CODE_AGENT_INSTALL_PATH$$__",r);let c=f(a,{agent_type:n}),g="";return p.description&&(g=`---
+description: "${p.description.replace(/"/g,'\\"')}"
+---
+
+`),`${g}${c}`}},be=new ge;var M={agentType:"qwen-code",agentDir:".qwen",commandsDir:"commands",displayName:"Qwen Code",protocolFilename:"AGENTS.md",description:"Qwen Code AI coding assistant",strategy:{content:be}};import{parse as Ct}from"smol-toml";var me=class{process(e,t){let{installPath:r,agentType:n}=t,p=Ct(e);if(!p.prompt)return null;let a=p.prompt;a=a.replace("__$$CODE_AGENT_INSTALL_PATH$$__",r);let c=f(a,{agent_type:n}),g="";return p.description&&(g=`---
+description: "${p.description.replace(/"/g,'\\"')}"
+---
+
+`),`${g}${c}`}},Re=new me;var V={agentType:"factory-droid",agentDir:".factory",commandsDir:"commands",displayName:"Factory Droid",protocolFilename:"AGENTS.md",description:"Factory Droid AI coding assistant",strategy:{content:Re}};var S=[E,N,D,F,O,b,R,L,U,H,M,V,k];async function Le(o){let e=o==="codex",t=o==="cline";return await le({message:"Select installation method:",choices:e?[{name:"Global (User Home Directory)",value:"global"}]:[{name:"Project (Current Directory)",value:"project"}],default:e?"global":"project"})}async function ke(){let o=S.map(t=>{let{displayName:r,agentType:n,protocolFilename:p,agentDir:a,commandsDir:c,description:g}=t,d=g||`${r} agent`,y=`\x1B[90m(${p}, ${a}/${c})\x1B[0m`;return{name:`${r} ${y}`,value:n,description:d}});return await le({message:"Select your coding agent:",choices:o,default:"opencode",loop:!0})}async function Ue(){return await le({message:"Configure git ignore for Conductor files?",choices:[{name:"Add to .gitignore",value:"gitignore",description:"Add Conductor entries to the project's .gitignore file"},{name:"Add to .git/info/exclude",value:"exclude",description:"Add Conductor entries to .git/info/exclude (local only, not shared)"},{name:"Remove existing entries",value:"none",description:"Remove Conductor entries from both .gitignore and .git/info/exclude"},{name:"Don't configure git ignore",value:void 0,description:"Skip git ignore configuration"}],default:void 0})}import{join as _t}from"path";import At from"fs-extra";import{parse as ht}from"smol-toml";var G="conductor-";var{writeFile:wt}=At,fe=class{process(e,t){let{installPath:r,agentType:n}=t,p=ht(e);if(!p.prompt)return null;let a=p.prompt;a=a.replace(/__\$\$CODE_AGENT_INSTALL_PATH\$\$__/g,r),a=a.replace(/\/conductor:/g,`/${G}`);let c=f(a,{agent_type:n});return p.description?`---
+description: ${p.description}
+---
+${c}`:c}},de=class{async write(e){let{targetDir:t,agentDir:r,commandsDir:n,commandName:p,extension:a,content:c}=e,g=`${G}${p}${a}`;await wt(_t(t,r,n,g),c)}},He=new fe,Me=new de;import{join as u}from"path";import St from"@inquirer/select";import Be from"fs-extra";var{existsSync:w,ensureDir:Ve,copy:ue}=Be,A=class{constructor(e){this.config=e}async validate(e,t){if(!w(e))throw new Error(`Target directory does not exist: ${e}`);let{agentDir:r,commandsDir:n,displayName:p,extension:a,usesPrefix:c}=this.config,y=`${c!==!1?G:""}setup${a||".md"}`,x=u(e,r,n,y),C=u(e,r,"conductor");if(w(C)&&w(x))throw new Error(`Conductor (${p}) is already installed in: ${e}`);return e}async generate(e,t,r,n,p){let{agentDir:a,commandsDir:c,agentType:g}=this.config,d=u(e,a),y=u(d,c),x=u(a,"conductor");t==="global"&&(x=`~/${a}/conductor`),await Ve(y),await Ve(u(d,"conductor"));let C=await Te(r,n);try{let m=u(C,"templates"),_=u(d,"conductor","templates");await ue(m,_)}catch(m){console.warn("Failed to copy templates directory:",m)}let{protocolFilename:v}=this.config;if(v)try{let m=u(C,"GEMINI.md"),_=u(e,v);if(w(m)){let h=!0;w(_)&&!p&&(h=await St({message:`The protocol file '${v}' already exists. Do you want to overwrite it?`,choices:[{value:!0,name:"Overwrite"},{value:!1,name:"Skip"}]})),h&&await ue(m,_)}}catch(m){console.warn("Failed to handle protocol file:",m)}let I=[];try{let m=u(C,"commands/conductor");if(w(m)){let _=await Be.readdir(m);Array.isArray(_)&&(I=_.filter(h=>h.endsWith(".toml")).map(h=>h.replace(/\.toml$/,"")))}}catch(m){console.warn("Failed to discover commands:",m)}I.length===0?(console.log("No commands discovered, using default commands"),I=["setup","newTrack","implement","status","revert","review"]):console.log(`Discovered commands: ${I.join(", ")}`);let tt=this.config.extension||".md",ot=this.config.fixedAgent;for(let m of I)try{let _=await Ee(u("commands","conductor",`${m}.toml`),C),he=(this.config.strategy?.content||He).process(_,{installPath:x,agentType:g,fixedAgent:ot,commandName:m});he&&await(this.config.strategy?.file||Me).write({targetDir:e,agentDir:a,commandsDir:c,commandName:m,extension:tt,content:he})}catch(_){console.warn(`Failed to process ${m}:`,_)}let Ae=u(C,"templates/workflow.md"),we=u(e,"conductor/workflow.md");if(w(we)&&w(Ae))try{await ue(Ae,we),console.log("\u2714 conductor/workflow.md synced")}catch(m){console.warn("Failed to handle workflow file:",m)}else console.warn("Workflow template not found, skipping workflow file sync")}};function l(o){return new A(o)}var B=class{generator=l(E);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var q=class{generator=l(N);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var z=class{generator=l(D);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var W=class{generator=l(F);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var X=class{generator=l(O);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};import{homedir as qe}from"os";var K=class{generator=l(b);validate(e,t){return t==="global"&&(e=qe()),this.generator.validate(e,t)}generate(e,t,r,n){return t==="global"&&(e=qe()),this.generator.generate(e,t,r,n)}};var Q=class{generator=l(R);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var Y=class{generator=l(L);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var J=class{generator=l(k);async validate(e,t){if(t==="global")throw new Error("Gemini CLI agent only supports project-level installation");return this.generator.validate(e,t)}async generate(e,t,r,n){if(t==="global")throw new Error("Gemini CLI agent only supports project-level installation");return this.generator.generate(e,t,r,n)}};var Z=class{generator=l(U);validate(e,t){return this.generator.validate(e,t)}generate(e,t,r,n){return this.generator.generate(e,t,r,n)}};var ee=class extends A{constructor(){super(H)}};var te=class extends A{constructor(){super(M)}};var oe=class extends A{constructor(){super(V)}};function ze(o){switch(o){case"claude-code":return new q;case"antigravity":return new z;case"cursor":return new W;case"vscode-copilot":return new X;case"codex":return new K;case"windsurf":return new Q;case"cline":return new Y;case"kilo-code":return new Z;case"roo-code":return new ee;case"qwen-code":return new te;case"factory-droid":return new oe;case"gemini":return new J;default:return new B}}import{resolve as Nt}from"path";import Dt from"@inquirer/select";import{join as ye}from"path";import{readFile as xe,writeFile as We,access as vt,mkdir as It}from"fs/promises";import{constants as $t}from"fs";var Xe="# Conductor";function Ke(o){let e=S.find(r=>r.agentType===o);if(!e)return[];let t=[];return e.agentDir&&t.push(e.agentDir),e.protocolFilename&&t.push(e.protocolFilename),t}function T(o){return o.replace(/\/+$/,"")}async function Ce(o){try{return await vt(o,$t.F_OK),!0}catch{return!1}}async function Gt(o,e){let t=[],r=[];if(!await Ce(o))return{existing:[],missing:[...e]};let p=(await xe(o,"utf-8")).split(`
+`).map(a=>T(a.trim()));for(let a of e){let c=T(a);p.includes(c)?t.push(a):r.push(a)}return{existing:t,missing:r}}async function Qe(o,e){let{existing:t,missing:r}=await Gt(o,e);if(r.length===0)return{added:[],skipped:t};let n="";await Ce(o)&&(n=await xe(o,"utf-8")),n.length>0&&!n.endsWith(`
+`)&&(n+=`
+`),n+=`
+${Xe}
+`;for(let a of r)n+=`${a}
+`;let p=ye(o,"..");return await It(p,{recursive:!0}),await We(o,n,"utf-8"),{added:r,skipped:t}}async function _e(o,e){if(!await Ce(o))return{removed:[]};let r=(await xe(o,"utf-8")).split(`
+`),n=e.map(T),p=[],a=[];for(let y of r){let x=T(y.trim());if(x!==Xe){if(n.includes(x)){let C=e.find(v=>T(v)===x);C&&!p.includes(C)&&p.push(C);continue}a.push(y)}}let c=[],g=!1;for(let y of a){let x=y.trim()==="";x&&g||(c.push(y),g=x)}for(;c.length>0&&c[c.length-1].trim()==="";)c.pop();let d=c.length>0?c.join(`
+`)+`
+`:"";return await We(o,d,"utf-8"),{removed:p}}function re(o,e){return e==="gitignore"?ye(o,".gitignore"):ye(o,".git","info","exclude")}async function Ye(o,e,t){let r=Ke(t);return r.length===0?{action:"none",entries:[],message:`No git ignore entries found for agent ${t}`}:e==="none"?await Et(o,r):await Tt(o,e,r)}async function Tt(o,e,t){let r=re(o,e),n=await Qe(r,t);if(n.added.length===0)return{action:"skipped",entries:n.skipped,message:"Git ignore entries already present, skipping.",targetFiles:[r]};let p=e==="gitignore"?".gitignore":".git/info/exclude";return{action:"added",entries:n.added,message:`Added ${n.added.length} entries to ${p}: ${n.added.join(", ")}`,targetFiles:[r]}}async function Et(o,e){let t=re(o,"gitignore"),r=re(o,"exclude"),n=await _e(t,e),p=await _e(r,e),a=[...new Set([...n.removed,...p.removed])];if(a.length===0)return{action:"none",entries:[],message:"No Conductor git ignore entries found."};let c=[],g=[];return n.removed.length>0&&(c.push(t),g.push(`.gitignore (${n.removed.length})`)),p.removed.length>0&&(c.push(r),g.push(`.git/info/exclude (${p.removed.length})`)),{action:"removed",entries:a,message:`Removed entries from: ${g.join(", ")}`,targetFiles:c}}async function Je(o){let e=Nt(process.cwd(),o.path),t=o.force??!1;try{console.log(`Initializing Conductor in: ${e}`);let r;o.agent?(r=o.agent,console.log(`Using provided agent: ${r}`)):(console.log("Step 1: Prompting for agent selection..."),r=await ke(),console.log(`\u2714 Selected agent: ${r}`));let n;o.scope?(n=o.scope,console.log(`Using provided scope: ${n}`)):n=await Le(r),console.log(`\u2714 Selected scope: ${n}`);let p=o.gitIgnore;o.gitIgnore&&n==="global"?(console.warn("\u26A0 --git-ignore flag is only supported for project scope. Skipping git ignore configuration."),p=void 0):!o.gitIgnore&&n==="project"&&(p=await Ue());let a=ze(r);console.log(`
+Step 3: Validating project directory...`);let c;try{c=await a.validate(e,n)}catch(g){if(g instanceof Error&&g.message.includes("already installed"))if(t)console.log("\u26A0 Force mode: Overwriting existing installation"),c=e;else if(await Dt({message:`${g.message}
+Do you want to overwrite the existing installation?`,choices:[{value:!0,name:"Yes, overwrite"},{value:!1,name:"No, cancel"}]}))console.log("Overwriting existing installation..."),c=e;else{console.log("Installation cancelled.");return}else throw g}if(console.log(`\u2714 Validation complete: ${c}`),console.log(`
+Step 4: Generating files...`),await a.generate(c,n,o.repo,o.branch,t),console.log("\u2714 Files generated"),p){console.log(`
+Step 5: Configuring git ignore...`);let g=await Ye(c,p,r);console.log(`\u2714 ${g.message}`)}console.log(`
+\u2714 Conductor initialized successfully!`)}catch(r){console.error(`
+\u2718 Installation failed:`,r instanceof Error?r.message:r),process.exit(1)}}import Ft from"gradient-string";var Pt=`
+   __________  _   ______  __  __________________  ____     _____   ____________
+  / ____/ __ \\/ | / / __ \\/ / / / ____/_  __/ __ \\/ __ \\   /  _/ | / /  _/_  __/
+ / /   / / / /  |/ / / / / / / / /     / / / / / / /_/ /   / //  |/ // /  / /   
+/ /___/ /_/ / /|  / /_/ / /_/ / /___  / / / /_/ / _, _/  _/ // /|  // /  / /    
+\\____/\\____/_/ |_/_____/\\____/\\____/ /_/  \\____/_/ |_|  /___/_/ |_/___/ /_/ 
+                                                                                    
+`;function Ze(){console.log(Ft("cyan","green")(Pt))}async function et(){!process.env.CONDUCTOR_NO_BANNER&&!process.argv.includes("completion")&&!process.argv.includes("--get-yargs-completions")&&Ze();let o=await jt(Ot(process.argv)).scriptName("conductor-init").usage("$0 [path] [options]").positional("path",{describe:"Directory to install Conductor",default:".",type:"string"}).option("agent",{alias:"a",describe:"Specify the coding agent",type:"string",choices:S.map(t=>t.agentType)}).option("repo",{alias:"r",describe:"Git repository URL for conductor. If used without value, defaults to official repository.",type:"string"}).coerce("repo",t=>t===""?P:t).option("branch",{alias:"b",describe:"Branch name for conductor repository",type:"string",default:j}).option("scope",{alias:"s",describe:"Installation scope (project or global)",type:"string",choices:["project","global"]}).option("git-ignore",{alias:"g",describe:"Configure git ignore for Conductor files (gitignore: add to .gitignore, exclude: add to .git/info/exclude, none: remove entries)",type:"string",choices:["gitignore","exclude","none"]}).coerce("git-ignore",t=>t===""?"exclude":t).option("force",{alias:"f",describe:"Force overwrite existing installation",type:"boolean",default:!1}).example("$0","Install with interactive prompts").example("$0 --agent claude-code","Install for Claude Code agent").example("$0 --git-ignore gitignore","Add Conductor files to .gitignore").example("$0 --git-ignore exclude","Add Conductor files to .git/info/exclude").example("$0 --git-ignore none","Remove Conductor entries from git ignore").help().alias("h","help").version().alias("v","version").completion("completion",!1).parseAsync(),e=o._[0];process.argv.includes("completion")||process.argv.includes("--get-yargs-completions")||await Je({...o,path:e||o.path||".",gitIgnore:o["git-ignore"],$0:"conductor-init",_:o._})}et().catch(o=>{console.error("Error:",o instanceof Error?o.message:o),process.exit(1)});

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "conductor-init",
+  "version": "0.0.1",
+  "description": "Conductor Scaffolding CLI - Generate spec-driven, portable Gemini Conductor workflows for any coding agent",
+  "license": "Apache-2.0",
+  "keywords": [
+    "conductor",
+    "gemini-conductor",
+    "gemini",
+    "context-driven-development",
+    "spec-driven-development",
+    "slash-commands",
+    "workflows",
+    "opencode",
+    "claude-code",
+    "codex",
+    "antigravity",
+    "cursor",
+    "copilot",
+    "windsurf",
+    "cline",
+    "roo-code",
+    "kilo-code",
+    "qwen-code",
+    "gemini-cli-extensions",
+    "coding-agent",
+    "sdd",
+    "cdd"
+  ],
+  "author": {
+    "name": "Jonkimi",
+    "url": "https://blog.jonkimi.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jonkimi/create-conductor-flow.git"
+  },
+  "homepage": "https://github.com/Jonkimi/create-conductor-flow",
+  "packageManager": "pnpm@10.24.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "conductor-init": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "clean": "tsx scripts/clean.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage",
+    "prebuild": "tsx scripts/bundle-conductor.ts",
+    "update-readme": "tsx scripts/update-readme.ts",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "release": "tsx scripts/double-publish.ts"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/gradient-string": "^1.1.6",
+    "@types/node": "^25.1.0",
+    "@types/yargs": "^17.0.35",
+    "@vitest/coverage-v8": "^4.0.18",
+    "release-it": "^19.2.4",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@inquirer/select": "^5.0.4",
+    "fs-extra": "^11.3.3",
+    "gradient-string": "^3.0.0",
+    "smol-toml": "^1.6.0",
+    "yargs": "^18.0.0"
+  }
+}