@iservu-inc/adf-cli 0.11.0 → 0.12.9

package/lib/generators/opencode-generator.js

@@ -0,0 +1,153 @@
+const fs = require('fs-extra');
+const path = require('path');
+const ToolConfigGenerator = require('./tool-config-generator');
+
+/**
+ * Generator for OpenCode CLI configurations
+ * Creates .opencode.json with project-specific configuration
+ */
+class OpenCodeGenerator extends ToolConfigGenerator {
+  /**
+   * Generate OpenCode configuration
+   * @returns {Object} Generated file path
+   */
+  async generate() {
+    await this.initialize();
+
+    const configPath = path.join(this.projectPath, '.opencode.json');
+
+    // Generate configuration
+    const config = await this.generateConfig();
+
+    await fs.writeJson(configPath, config, { spaces: 2 });
+
+    return { config: configPath };
+  }
+
+  /**
+   * Generate .opencode.json configuration
+   */
+  async generateConfig() {
+    const projectContext = await this.getProjectContext();
+    const frameworkContext = await this.getFrameworkContext();
+
+    return {
+      data: {
+        directory: ".opencode"
+      },
+      agents: {
+        coder: {
+          model: this.getCoderModel(),
+          maxTokens: 8000
+        },
+        task: {
+          model: this.getTaskModel(),
+          maxTokens: 4000
+        }
+      },
+      systemPrompt: this.generateSystemPrompt(projectContext, frameworkContext),
+      projectContext: {
+        framework: this.getFrameworkName(),
+        session: this.getSessionId(),
+        outputsPath: `.adf/sessions/${this.getSessionId()}/outputs/`
+      },
+      mcpServers: {
+        filesystem: {
+          command: "npx",
+          args: ["-y", "@modelcontextprotocol/server-filesystem", this.projectPath],
+          env: {}
+        }
+      },
+      debug: false,
+      autoCompact: true
+    };
+  }
+
+  /**
+   * Generate system prompt for OpenCode
+   */
+  generateSystemPrompt(projectContext, frameworkContext) {
+    const agentRole = this.getAgentRole();
+
+    return `You are ${agentRole} for the ${projectContext.name} project.
+
+FRAMEWORK: ${this.getFrameworkName()}
+
+PROJECT OVERVIEW:
+${projectContext.overview || 'AI-assisted development project'}
+
+KEY REQUIREMENTS:
+${frameworkContext.keyPoints || '- Follow project structure\n- Maintain code quality\n- Write comprehensive tests'}
+
+OPERATIONAL RULES:
+1. Read project documentation in .adf/sessions/${this.getSessionId()}/outputs/
+2. Follow the workflow level: ${this.framework}
+3. All code changes must pass tests
+4. Never commit secrets or API keys
+5. Follow conventional commits format
+
+BUILD & TEST:
+- Build: ${projectContext.buildCommand || 'npm run build'}
+- Test: ${projectContext.testCommand || 'npm test'}
+- Lint: ${projectContext.lintCommand || 'npm run lint'}
+
+Generated by ADF CLI v${this.getADFVersion()}`;
+  }
+
+  /**
+   * Get agent role based on framework
+   */
+  getAgentRole() {
+    const roles = {
+      'rapid': 'a Rapid Development Engineer',
+      'balanced': 'a Senior Software Engineer',
+      'comprehensive': 'a Principal Solutions Architect'
+    };
+    return roles[this.framework] || 'an AI Coding Assistant';
+  }
+
+  /**
+   * Get model for coder agent based on framework
+   */
+  getCoderModel() {
+    const models = {
+      'rapid': 'anthropic/claude-3-5-sonnet-20241022',
+      'balanced': 'anthropic/claude-sonnet-4-5-20250929',
+      'comprehensive': 'anthropic/claude-opus-4-5-20251101'
+    };
+    return models[this.framework] || 'anthropic/claude-3-5-sonnet-20241022';
+  }
+
+  /**
+   * Get model for task agent
+   */
+  getTaskModel() {
+    return 'anthropic/claude-3-5-haiku-20241022';
+  }
+
+  /**
+   * 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.12.0';
+    }
+  }
+}
+
+module.exports = OpenCodeGenerator;

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

package/lib/templates/shared/templates/openspec-delta.md

@@ -0,0 +1,16 @@
+# OpenSpec Delta: [Spec Name]
+
+## ➕ ADDED Requirements
+### Requirement: [Name]
+Description using SHALL/MUST.
+#### Scenario: [Context]
+- WHEN [Action]
+- THEN [Outcome]
+
+## 🔄 MODIFIED Requirements
+### Requirement: [Name]
+*Original requirement reference*
+Updated description.
+
+## ➖ REMOVED Requirements
+- [Requirement Name]