@iservu-inc/adf-cli 0.11.0 → 0.12.0

package/lib/generators/antigravity-generator.js

@@ -0,0 +1,140 @@
+const fs = require('fs-extra');
+const path = require('path');
+const ToolConfigGenerator = require('./tool-config-generator');
+
+/**
+ * Generator for Google Antigravity configurations
+ * Creates .antigravity/agents.yaml that mounts AGENTS.md
+ * Provides file system access to .context/ directory
+ */
+class AntigravityGenerator extends ToolConfigGenerator {
+  /**
+   * Generate Antigravity configurations
+   * @returns {Object} Generated file paths
+   */
+  async generate() {
+    await this.initialize();
+
+    const antigravityDir = path.join(this.projectPath, '.antigravity');
+    await fs.ensureDir(antigravityDir);
+
+    const generated = {
+      agents: null
+    };
+
+    // Generate agents.yaml
+    generated.agents = await this.generateAgentsYaml(antigravityDir);
+
+    return generated;
+  }
+
+  /**
+   * Generate .antigravity/agents.yaml
+   */
+  async generateAgentsYaml(antigravityDir) {
+    const agentsPath = path.join(antigravityDir, 'agents.yaml');
+
+    const agentName = this.getAgentName();
+    const model = this.getModelForFramework();
+
+    // Generate YAML content
+    const yamlContent = `# Antigravity Agent Configuration
+# Generated by ADF CLI v${this.getADFVersion()}
+# Framework: ${this.getFrameworkName()}
+
+agents:
+  - name: "${agentName}"
+    model: "${model}"
+    capabilities:
+      - file_system:
+          read_only:
+            - "AGENTS.md"
+            - ".context"
+            - ".adf/sessions"
+          exclude:
+            - ".adf/.env"
+            - "node_modules"
+            - ".git"
+    system_prompt: |
+      You are ${agentName}, an expert AI coding assistant.
+
+      CRITICAL INSTRUCTIONS:
+      1. Read "AGENTS.md" IMMEDIATELY upon startup to understand project rules and structure
+      2. Consult ".context/memory/architecture.md" for system design decisions
+      3. Follow all operational rules defined in AGENTS.md (they are NON-NEGOTIABLE)
+      4. Never output secrets from .env files or expose API keys
+      5. All code changes must pass the test suite defined in AGENTS.md
+
+      WORKFLOW:
+      - Before any code change, read AGENTS.md and .context/memory/architecture.md
+      - Follow the build & test commands specified in AGENTS.md
+      - Adhere to the project structure and workflow directives
+      - Ask clarifying questions if requirements are unclear
+
+      PROJECT CONTEXT:
+      - Framework: ${this.getFrameworkName()}
+      - Session: ${this.getSessionId()}
+      - Complete requirements: .adf/sessions/${this.getSessionId()}/outputs/
+
+      Remember: AGENTS.md is your single source of truth. Read it first, follow it always.
+`;
+
+    await fs.writeFile(agentsPath, yamlContent, 'utf-8');
+    return agentsPath;
+  }
+
+  /**
+   * Get agent name based on framework
+   */
+  getAgentName() {
+    const projectName = this.getProjectName();
+
+    const roleMap = {
+      'rapid': 'Developer',
+      'balanced': 'Project Architect',
+      'comprehensive': 'Solutions Architect'
+    };
+
+    const role = roleMap[this.framework] || 'Developer';
+    return `${projectName} ${role}`;
+  }
+
+  /**
+   * Get appropriate model for framework complexity
+   */
+  getModelForFramework() {
+    const modelMap = {
+      'rapid': 'gemini-2.0-flash-exp',
+      'balanced': 'gemini-2.0-flash-thinking-exp',
+      'comprehensive': 'gemini-exp-1206'
+    };
+
+    return modelMap[this.framework] || 'gemini-2.0-flash-exp';
+  }
+
+  /**
+   * Get framework display name
+   */
+  getFrameworkName() {
+    const names = {
+      'rapid': 'Rapid Development (PRP)',
+      'balanced': 'Balanced (Specification-Driven)',
+      'comprehensive': 'BMAD Comprehensive (Enterprise)'
+    };
+    return names[this.framework] || this.framework;
+  }
+
+  /**
+   * Get ADF CLI version
+   */
+  getADFVersion() {
+    try {
+      const packageJson = require('../../package.json');
+      return packageJson.version;
+    } catch (error) {
+      return '0.11.0';
+    }
+  }
+}
+
+module.exports = AntigravityGenerator;

package/lib/generators/index.js

@@ -7,6 +7,8 @@ const AgentsMdGenerator = require('./agents-md-generator');
 const WindsurfGenerator = require('./windsurf-generator');
 const CursorGenerator = require('./cursor-generator');
 const VSCodeGenerator = require('./vscode-generator');
+const ZedGenerator = require('./zed-generator');
+const AntigravityGenerator = require('./antigravity-generator');
 const ToolConfigGenerator = require('./tool-config-generator');
 
 /**
@@ -84,15 +86,35 @@ async function generateVSCode(sessionPath, projectPath, framework) {
   return await generator.generate();
 }
 
+/**
+ * Generate Zed Editor configurations
+ */
+async function generateZed(sessionPath, projectPath, framework) {
+  const generator = new ZedGenerator(sessionPath, projectPath, framework);
+  return await generator.generate();
+}
+
+/**
+ * Generate Google Antigravity configurations
+ */
+async function generateAntigravity(sessionPath, projectPath, framework) {
+  const generator = new AntigravityGenerator(sessionPath, projectPath, framework);
+  return await generator.generate();
+}
+
 module.exports = {
   generateAll,
   generateAgentsMd,
   generateWindsurf,
   generateCursor,
   generateVSCode,
+  generateZed,
+  generateAntigravity,
   AgentsMdGenerator,
   WindsurfGenerator,
   CursorGenerator,
   VSCodeGenerator,
+  ZedGenerator,
+  AntigravityGenerator,
   ToolConfigGenerator
 };

package/lib/generators/zed-generator.js

@@ -0,0 +1,252 @@
+const fs = require('fs-extra');
+const path = require('path');
+const ToolConfigGenerator = require('./tool-config-generator');
+
+/**
+ * Generator for Zed Editor configurations
+ * Creates .zed/settings.json with MCP integration and agent configuration
+ * Creates .zed/keymap.json for agent switching shortcuts
+ * Creates symlink .zed/rules -> ../AGENTS.md (or copies on Windows)
+ */
+class ZedGenerator extends ToolConfigGenerator {
+  /**
+   * Generate Zed Editor configurations
+   * @returns {Object} Generated file paths
+   */
+  async generate() {
+    await this.initialize();
+
+    const zedDir = path.join(this.projectPath, '.zed');
+    await fs.ensureDir(zedDir);
+
+    const generated = {
+      settings: null,
+      keymap: null,
+      rules: null
+    };
+
+    // Generate settings.json
+    generated.settings = await this.generateSettings(zedDir);
+
+    // Generate keymap.json
+    generated.keymap = await this.generateKeymap(zedDir);
+
+    // Create symlink or copy AGENTS.md
+    generated.rules = await this.linkAgentsMd(zedDir);
+
+    return generated;
+  }
+
+  /**
+   * Generate .zed/settings.json with MCP and agent configuration
+   */
+  async generateSettings(zedDir) {
+    const settingsPath = path.join(zedDir, 'settings.json');
+
+    // Determine model configuration based on framework
+    const modelConfig = this.getModelConfiguration();
+
+    const settings = {
+      agent: {
+        default_model: modelConfig.default,
+        feature_specific_models: modelConfig.featureSpecific,
+        model_parameters: modelConfig.parameters,
+        always_allow_tool_actions: true,
+        single_file_review: true
+      },
+      context_servers: this.getMCPContextServers(),
+      terminal: {
+        env: this.getTerminalEnvironment()
+      }
+    };
+
+    await fs.writeJson(settingsPath, settings, { spaces: 2 });
+    return settingsPath;
+  }
+
+  /**
+   * Get model configuration based on framework complexity
+   */
+  getModelConfiguration() {
+    const configs = {
+      rapid: {
+        default: {
+          provider: 'anthropic',
+          model: 'claude-3-5-sonnet-20241022'
+        },
+        featureSpecific: {
+          thread_summary_model: {
+            provider: 'google',
+            model: 'gemini-2.0-flash-exp'
+          },
+          commit_message_model: {
+            provider: 'google',
+            model: 'gemini-2.0-flash-exp'
+          },
+          inline_assistant_model: {
+            provider: 'anthropic',
+            model: 'claude-3-5-sonnet-20241022'
+          }
+        },
+        parameters: [
+          { provider: 'anthropic', temperature: 0.1 },
+          { provider: 'google', temperature: 0.2 }
+        ]
+      },
+      balanced: {
+        default: {
+          provider: 'anthropic',
+          model: 'claude-3-5-sonnet-20241022'
+        },
+        featureSpecific: {
+          thread_summary_model: {
+            provider: 'google',
+            model: 'gemini-2.0-flash-exp'
+          },
+          commit_message_model: {
+            provider: 'google',
+            model: 'gemini-2.0-flash-exp'
+          },
+          inline_assistant_model: {
+            provider: 'anthropic',
+            model: 'claude-3-5-sonnet-20241022'
+          }
+        },
+        parameters: [
+          { provider: 'anthropic', temperature: 0.1 },
+          { provider: 'google', temperature: 0.2 }
+        ]
+      },
+      comprehensive: {
+        default: {
+          provider: 'anthropic',
+          model: 'claude-3-5-sonnet-20241022'
+        },
+        featureSpecific: {
+          thread_summary_model: {
+            provider: 'anthropic',
+            model: 'claude-3-5-sonnet-20241022'
+          },
+          commit_message_model: {
+            provider: 'anthropic',
+            model: 'claude-3-5-sonnet-20241022'
+          },
+          inline_assistant_model: {
+            provider: 'anthropic',
+            model: 'claude-3-5-sonnet-20241022'
+          }
+        },
+        parameters: [
+          { provider: 'anthropic', temperature: 0.05 }
+        ]
+      }
+    };
+
+    return configs[this.framework] || configs.balanced;
+  }
+
+  /**
+   * Get MCP context servers configuration
+   */
+  getMCPContextServers() {
+    const servers = {
+      project_context: {
+        command: 'npx',
+        args: ['@modelcontextprotocol/server-filesystem', '.context']
+      }
+    };
+
+    // Add Archon if configured
+    const archonUrl = process.env.ARCHON_MCP_URL || this.metadata?.archonUrl;
+    if (archonUrl) {
+      servers.archon = {
+        url: archonUrl
+      };
+    }
+
+    return servers;
+  }
+
+  /**
+   * Get terminal environment variables
+   */
+  getTerminalEnvironment() {
+    const env = {};
+
+    // Add ARCHON_MCP_PORT if configured
+    if (process.env.ARCHON_MCP_URL) {
+      const url = new URL(process.env.ARCHON_MCP_URL);
+      if (url.port) {
+        env.ARCHON_MCP_PORT = url.port;
+      }
+    }
+
+    return env;
+  }
+
+  /**
+   * Generate .zed/keymap.json with agent switching shortcuts
+   */
+  async generateKeymap(zedDir) {
+    const keymapPath = path.join(zedDir, 'keymap.json');
+
+    const keymap = [
+      {
+        context: 'Editor',
+        bindings: {
+          'ctrl-shift-a': 'assistant::Toggle',
+          'ctrl-shift-c': 'assistant::CycleMessageRole',
+          'ctrl-shift-r': 'assistant::Restart'
+        }
+      },
+      {
+        context: 'AssistantPanel',
+        bindings: {
+          'ctrl-enter': 'assistant::Assist',
+          'escape': 'assistant::Hide',
+          'ctrl-shift-n': 'assistant::NewConversation'
+        }
+      }
+    ];
+
+    await fs.writeJson(keymapPath, keymap, { spaces: 2 });
+    return keymapPath;
+  }
+
+  /**
+   * Create symlink .zed/rules -> ../AGENTS.md
+   * Falls back to file copy on Windows if symlink fails
+   */
+  async linkAgentsMd(zedDir) {
+    const rulesPath = path.join(zedDir, 'rules');
+    const agentsMdPath = path.join(this.projectPath, 'AGENTS.md');
+
+    // Remove existing link/file if present
+    if (await fs.pathExists(rulesPath)) {
+      await fs.remove(rulesPath);
+    }
+
+    // Check if AGENTS.md exists
+    if (!await fs.pathExists(agentsMdPath)) {
+      console.warn('AGENTS.md not found, skipping Zed rules link');
+      return null;
+    }
+
+    try {
+      // Try to create symlink (Unix/Mac/modern Windows)
+      await fs.symlink('../AGENTS.md', rulesPath, 'file');
+      return { type: 'symlink', path: rulesPath };
+    } catch (error) {
+      // Symlink failed (older Windows or permissions), copy file instead
+      try {
+        await fs.copy(agentsMdPath, rulesPath);
+        return { type: 'copy', path: rulesPath };
+      } catch (copyError) {
+        console.warn(`Failed to create Zed rules link: ${copyError.message}`);
+        return null;
+      }
+    }
+  }
+}
+
+module.exports = ZedGenerator;

package/lib/templates/shared/agents/architect.md

@@ -9,9 +9,12 @@ dependencies:
   templates:
     - architecture-template.md
     - tech-stack-template.md
+    - openspec-proposal.md
+    - openspec-delta.md
   tasks:
     - design-architecture.md
     - validate-tech-stack.md
+    - create-openspec-proposal.md
   data:
     - constitution.md
     - technical-preferences.md
@@ -222,32 +225,29 @@ Document all key decisions:
 
 ### Phase 6: Validation
 
-```
-1. Technical Feasibility
-   - Can we build this?
-   - Do we have the expertise?
-   - Are there unknown unknowns?
+...
+
+## OpenSpec Brownfield Workflow
 
-2. Performance Validation
-   - Will it meet NFR performance targets?
-   - Scalability headroom adequate?
-   - Bottlenecks identified?
+Use this workflow when modifying existing systems (1 -> n) to maintain a source of truth.
+
+```
+1. Initialize OpenSpec (if first time)
+   npx openspec init
 
-3. Security Validation
-   - OWASP Top 10 addressed?
-   - Data protection adequate?
-   - Compliance requirements met?
+2. Create Change Proposal
+   - Create directory: openspec/changes/<feature-name>/
+   - Create proposal.md using openspec-proposal.md template
+   - Create tasks.md using openspec-tasks.md template
 
-4. Cost Validation
-   - Infrastructure costs projected
-   - Third-party service costs
-   - Development effort estimated
+3. Create Spec Deltas
+   - Identify existing specs in openspec/specs/
+   - Create delta files in openspec/changes/<feature-name>/specs/
+   - Use ## ADDED / ## MODIFIED / ## REMOVED markers
 
-5. Constitutional Compliance
-   - Article 1: Spec-first ✓
-   - Article 3: Simplicity first ✓
-   - Article 8: Security by design ✓
-   - Article 9: Performance as requirement ✓
+4. Review & Align
+   - Present proposal and deltas to the team/user
+   - Iterate based on feedback until agreed
 ```
 
 ## Architecture Patterns
@@ -553,5 +553,5 @@ Ready for SM to create stories.
 ---
 
 **Agent Version**: 1.0.0
-**Framework**: AgentDevFramework-Claude
-**Methodology**: BMAD-METHOD + Software Architecture Best Practices
+**Framework**: AgentDevFramework
+**Methodology**: BMAD-METHOD + Software Architecture Best Practices

package/lib/templates/shared/agents/dev.md

@@ -9,9 +9,11 @@ dependencies:
   templates:
     - story-template.md
     - code-review-template.md
+    - openspec-tasks.md
   tasks:
     - implement-story.md
     - run-tests.md
+    - implement-openspec-change.md
   data:
     - constitution.md
     - technical-preferences.md
@@ -221,24 +223,27 @@ You are a Senior Full-Stack Developer focused on implementing features from deta
 
 ### Phase 4: Handoff
 
+...
+
+## OpenSpec Implementation Workflow
+
+Use this when working on an OpenSpec change proposal.
+
 ```
-1. Mark story as "Ready for QA"
-   - Update story status
-   - Add completion notes
-
-2. Document any deviations from spec
-   - Why deviation was necessary
-   - Impact analysis
-   - Approval obtained
-
-3. Provide test evidence
-   - Test coverage report
-   - All tests passing
-   - Performance benchmarks (if applicable)
-
-4. Update progress tracking
-   - Update sprint board
-   - Notify team
+1. Load Change Context
+   - Read openspec/changes/<change>/proposal.md
+   - Review tasks.md for implementation steps
+   - Study spec deltas in openspec/changes/<change>/specs/
+
+2. Execute Tasks
+   - Follow the TDD process for each task
+   - Mark tasks as complete [x] in openspec/changes/<change>/tasks.md
+   - Save implementation decisions to mem0
+
+3. Finalize & Archive
+   - Ensure all deltas are satisfied
+   - Run: npx openspec archive <change>
+   - Verify specs in openspec/specs/ are updated
 ```
 
 ## Code Quality Standards
@@ -618,7 +623,7 @@ Before marking story complete:
 
 ## Remember
 
-You work from detailed story files with complete context. Your job is **disciplined execution**, not interpretation. When ambiguity exists, ask for clarification rather than assuming intent.
+You work from detailed story files with complete context. Your job is **disciplined execution**, not interpretation. When ambiguity exists, ask for clarification rather than assuming intent.  
 
 **Success Metrics**:
 - Tests pass on first QA review
@@ -630,5 +635,5 @@ You work from detailed story files with complete context. Your job is **discipli
 ---
 
 **Agent Version**: 1.0.0
-**Framework**: AgentDevFramework-Claude
-**Last Updated**: 2025-01-XX
+**Framework**: AgentDevFramework
+**Last Updated**: 2025-01-XX

package/lib/templates/shared/agents/pm.md

@@ -10,10 +10,12 @@ dependencies:
     - prd-template.md
     - epic-template.md
     - user-story-template.md
+    - openspec-proposal.md
   tasks:
     - create-prd.md
     - define-epics.md
     - write-stories.md
+    - create-proposal.md
   data:
     - constitution.md
     - technical-preferences.md
@@ -48,7 +50,7 @@ You are a Product Manager focused on creating comprehensive Product Requirements
 
 ## Primary Responsibilities
 
-### 1. PRD Creation
+### 1. PRD Creation (Path A: Greenfield)
 
 **Create comprehensive Product Requirements Document**:
 - Executive Summary
@@ -62,7 +64,15 @@ You are a Product Manager focused on creating comprehensive Product Requirements
 - Success Metrics
 - Out of Scope
 
-### 2. Requirements Definition
+### 2. Change Proposal (Path B: OpenSpec)
+
+**Create Change Proposal in `openspec/changes/<name>/proposal.md`**:
+- **Why**: The problem or opportunity.
+- **What**: The specific changes required.
+- **Success**: How we know it worked.
+- **Impact**: User impact analysis.
+
+### 3. Requirements Definition
 
 **Define clear, testable requirements**:
 - Functional Requirements (what the system does)
@@ -661,5 +671,5 @@ PRD complete. Ready for architect review.
 ---
 
 **Agent Version**: 1.0.0
-**Framework**: AgentDevFramework-Claude
-**Methodology**: BMAD-METHOD + Agile Best Practices
+**Framework**: AgentDevFramework
+**Methodology**: BMAD-METHOD + Agile Best Practices

package/lib/templates/shared/agents/sm.md

@@ -9,10 +9,12 @@ dependencies:
   templates:
     - story-template.md
     - epic-shard-template.md
+    - openspec-tasks.md
   tasks:
     - draft-story.md
     - validate-story.md
     - coordinate-handoff.md
+    - create-openspec-tasks.md
   data:
     - constitution.md
     - prd.md
@@ -65,7 +67,7 @@ You are Samira, a Scrum Master focused on creating implementation-ready stories
 
 ## Story Creation Workflow
 
-### Phase 1: Context Gathering
+### 1. Context Gathering (Path A: Greenfield)
 
 ```
 1. Read Planning Phase Outputs
@@ -73,21 +75,23 @@ You are Samira, a Scrum Master focused on creating implementation-ready stories
    - Architecture doc (from Architect)
    - Epic definition
    - Related stories
+```
 
-2. Shard Epic if Needed
-   - If epic > 40 story points: shard into smaller epics
-   - Each shard: 20-40 points (1-2 weeks)
-   - Save shards to epic-shards/{epic}-shard-{N}.md
+### 2. Task Breakdown (Path B: OpenSpec)
 
-3. Query mem0 for Context
-   /mem0 retrieve story context <epic>
-   /mem0 retrieve implementation notes <feature>
+```
+1. Read Change Context
+   - Proposal (from PM) in `openspec/changes/<name>/proposal.md`
+   - Spec Deltas (from Architect) in `openspec/changes/<name>/specs/delta.md`
 
-4. Use Context7 for Patterns
-   @context7 <relevant technology>
+2. Create Implementation Tasks
+   - Create/Update `openspec/changes/<name>/tasks.md`
+   - Break down deltas into atomic TDD steps
+   - Ensure specific test guidance for each task
+   - Validate against Constitutional principles
 ```
 
-### Phase 2: Story Drafting
+### 3. Story Drafting
 
 ```
 1. Story Structure
@@ -722,7 +726,7 @@ test('complete login flow', async () => {
 - [ ] Risk assessment included
 - [ ] Dependencies identified
 - [ ] Performance requirements defined
-- [ ] Security requirements included
+- [ ] Security requirements defined
 - [ ] Definition of Done complete
 - [ ] Story points estimated
 - [ ] Constitutional compliance verified
@@ -780,5 +784,5 @@ Would you like me to:
 ---
 
 **Agent Version**: 1.0.0
-**Framework**: AgentDevFramework-Claude
-**Methodology**: BMAD-METHOD + Context Engineering + Agile Best Practices
+**Framework**: AgentDevFramework
+**Methodology**: BMAD-METHOD + Context Engineering + Agile Best Practices