aidp 0.1.0 → 0.3.0

data/lib/aidp/util.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "fileutils"
+
+module Aidp
+  # Utility functions shared between execute and analyze modes
+  class Util
+    def self.which(cmd)
+      exts = ENV["PATHEXT"] ? ENV["PATHEXT"].split(";") : [""]
+      ENV["PATH"].split(File::PATH_SEPARATOR).each do |path|
+        exts.each do |ext|
+          exe = File.join(path, "#{cmd}#{ext}")
+          return exe if File.executable?(exe) && !File.directory?(exe)
+        end
+      end
+      nil
+    end
+
+    def self.ensure_dirs(output_files, project_dir)
+      output_files.each do |file|
+        dir = File.dirname(File.join(project_dir, file))
+        FileUtils.mkdir_p(dir) unless dir == "."
+      end
+    end
+
+    def self.safe_file_write(path, content)
+      FileUtils.mkdir_p(File.dirname(path))
+      File.write(path, content)
+    end
+
+    def self.project_root?(dir = Dir.pwd)
+      File.exist?(File.join(dir, ".git")) ||
+        File.exist?(File.join(dir, "package.json")) ||
+        File.exist?(File.join(dir, "Gemfile")) ||
+        File.exist?(File.join(dir, "pom.xml")) ||
+        File.exist?(File.join(dir, "build.gradle"))
+    end
+  end
+end

data/lib/aidp/{shared/version.rb → version.rb}

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
 module Aidp
-  module Shared
-    VERSION = "0.1.0"
-  end
+  VERSION = "0.3.0"
 end

data/lib/aidp/workspace.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "digest"
+
+module Aidp
+  # Workspace management utilities
+  class Workspace
+    def self.current
+      Dir.pwd
+    end
+
+    def self.ensure_project_root
+      unless Aidp::Util.project_root?
+        raise "Not in a project root directory. Please run from a directory with .git, package.json, Gemfile, etc."
+      end
+    end
+  end
+end

data/lib/aidp.rb

@@ -1,18 +1,18 @@
 # frozen_string_literal: true
 
 # Shared modules
-require "aidp/shared/version"
-require "aidp/shared/config"
-require "aidp/shared/workspace"
-require "aidp/shared/util"
-require "aidp/shared/cli"
-require "aidp/shared/project_detector"
-require "aidp/shared/sync"
-require "aidp/shared/providers/base"
-require "aidp/shared/providers/cursor"
-require "aidp/shared/providers/anthropic"
-require "aidp/shared/providers/gemini"
-require "aidp/shared/providers/macos_ui"
+require "aidp/version"
+require "aidp/config"
+require "aidp/workspace"
+require "aidp/util"
+require "aidp/cli"
+require "aidp/project_detector"
+require "aidp/sync"
+require "aidp/providers/base"
+require "aidp/providers/cursor"
+require "aidp/providers/anthropic"
+require "aidp/providers/gemini"
+require "aidp/providers/macos_ui"
 
 # Execute mode modules
 require "aidp/execute/steps"
@@ -49,5 +49,5 @@ require "aidp/analyze/performance_optimizer"
 require "aidp/analyze/error_handler"
 
 module Aidp
-  VERSION = Aidp::Shared::VERSION
+  class Error < StandardError; end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aidp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Bart Agapinan
 bindir: bin
 cert_chain: []
-date: 2025-08-16 00:00:00.000000000 Z
+date: 2025-08-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colorize
@@ -69,16 +69,22 @@ dependencies:
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -191,8 +197,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-description: Portable CLI to run a markdown-based AI dev workflow without copying
-  prompts into projects.
+description: The AI-Dev-Pipeline (AIDP) CLI provides a powerful, markdown-driven workflow
+  for software development. It supports in-depth project analysis to understand existing
+  codebases and an execution mode to systematically implement new features.
 email:
 - bart@sonic.next
 executables:
@@ -231,21 +238,21 @@ files:
 - lib/aidp/analyze/storage.rb
 - lib/aidp/analyze/tool_configuration.rb
 - lib/aidp/analyze/tool_modernization.rb
+- lib/aidp/cli.rb
+- lib/aidp/config.rb
 - lib/aidp/execute/progress.rb
 - lib/aidp/execute/runner.rb
 - lib/aidp/execute/steps.rb
-- lib/aidp/shared/cli.rb
-- lib/aidp/shared/config.rb
-- lib/aidp/shared/project_detector.rb
-- lib/aidp/shared/providers/anthropic.rb
-- lib/aidp/shared/providers/base.rb
-- lib/aidp/shared/providers/cursor.rb
-- lib/aidp/shared/providers/gemini.rb
-- lib/aidp/shared/providers/macos_ui.rb
-- lib/aidp/shared/sync.rb
-- lib/aidp/shared/util.rb
-- lib/aidp/shared/version.rb
-- lib/aidp/shared/workspace.rb
+- lib/aidp/project_detector.rb
+- lib/aidp/providers/anthropic.rb
+- lib/aidp/providers/base.rb
+- lib/aidp/providers/cursor.rb
+- lib/aidp/providers/gemini.rb
+- lib/aidp/providers/macos_ui.rb
+- lib/aidp/sync.rb
+- lib/aidp/util.rb
+- lib/aidp/version.rb
+- lib/aidp/workspace.rb
 - templates/ANALYZE/01_REPOSITORY_ANALYSIS.md
 - templates/ANALYZE/02_ARCHITECTURE_ANALYSIS.md
 - templates/ANALYZE/03_TEST_ANALYSIS.md
@@ -277,7 +284,7 @@ files:
 - templates/EXECUTE/13_DELIVERY_ROLLOUT.md
 - templates/EXECUTE/14_DOCS_PORTAL.md
 - templates/EXECUTE/15_POST_RELEASE.md
-homepage: https://github.com/viamin/ai-scaffold
+homepage: https://github.com/viamin/aidp
 licenses:
 - MIT
 metadata: {}
@@ -297,5 +304,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.2
 specification_version: 4
-summary: AI Dev Pipeline CLI that drives prompts via Cursor/Claude/Gemini
+summary: A CLI for AI-driven software development, from analysis to execution.
 test_files: []

data/lib/aidp/shared/cli.rb

@@ -1,117 +0,0 @@
-# frozen_string_literal: true
-
-require "thor"
-
-module Aidp
-  module Shared
-    # CLI interface for both execute and analyze modes
-    class CLI < Thor
-      desc "execute [STEP]", "Run execute mode step(s)"
-      option :force, type: :boolean, desc: "Force execution even if dependencies are not met"
-      option :rerun, type: :boolean, desc: "Re-run a completed step"
-      def execute(project_dir = Dir.pwd, step_name = nil, custom_options = {})
-        if step_name
-          runner = Aidp::Execute::Runner.new(project_dir)
-          # Merge Thor options with custom options
-          all_options = options.merge(custom_options)
-          runner.run_step(step_name, all_options)
-        else
-          puts "Available execute steps:"
-          Aidp::Execute::Steps::SPEC.keys.each { |step| puts "  - #{step}" }
-          progress = Aidp::Execute::Progress.new(project_dir)
-          next_step = progress.next_step
-          {status: "success", message: "Available steps listed", next_step: next_step}
-        end
-      end
-
-      desc "analyze [STEP]", "Run analyze mode step(s)"
-      option :force, type: :boolean, desc: "Force execution even if dependencies are not met"
-      option :rerun, type: :boolean, desc: "Re-run a completed step"
-      def analyze(project_dir = Dir.pwd, step_name = nil, custom_options = {})
-        if step_name
-          runner = Aidp::Analyze::Runner.new(project_dir)
-          # Merge Thor options with custom options
-          all_options = options.merge(custom_options)
-          runner.run_step(step_name, all_options)
-        else
-          puts "Available analyze steps:"
-          Aidp::Analyze::Steps::SPEC.keys.each { |step| puts "  - #{step}" }
-          progress = Aidp::Analyze::Progress.new(project_dir)
-          next_step = progress.next_step
-          {status: "success", message: "Available steps listed", next_step: next_step,
-           completed_steps: progress.completed_steps}
-        end
-      end
-
-      desc "analyze-approve STEP", "Approve a completed analyze gate step"
-      def analyze_approve(project_dir = Dir.pwd, step_name = nil)
-        progress = Aidp::Analyze::Progress.new(project_dir)
-        progress.mark_step_completed(step_name)
-        puts "✅ Approved analyze step: #{step_name}"
-        {status: "success", step: step_name}
-      end
-
-      desc "analyze-reset", "Reset analyze mode progress"
-      def analyze_reset(project_dir = Dir.pwd)
-        progress = Aidp::Analyze::Progress.new(project_dir)
-        progress.reset
-        puts "🔄 Reset analyze mode progress"
-        {status: "success", message: "Progress reset"}
-      end
-
-      desc "execute-approve STEP", "Approve a completed execute gate step"
-      def execute_approve(project_dir = Dir.pwd, step_name = nil)
-        progress = Aidp::Execute::Progress.new(project_dir)
-        progress.mark_step_completed(step_name)
-        puts "✅ Approved execute step: #{step_name}"
-        {status: "success", step: step_name}
-      end
-
-      desc "execute-reset", "Reset execute mode progress"
-      def execute_reset(project_dir = Dir.pwd)
-        progress = Aidp::Execute::Progress.new(project_dir)
-        progress.reset
-        puts "🔄 Reset execute mode progress"
-        {status: "success", message: "Progress reset"}
-      end
-
-      # Backward compatibility aliases
-      desc "approve STEP", "Approve a completed execute gate step (alias for execute-approve)"
-      def approve(project_dir = Dir.pwd, step_name = nil)
-        execute_approve(project_dir, step_name)
-      end
-
-      desc "reset", "Reset execute mode progress (alias for execute-reset)"
-      def reset(project_dir = Dir.pwd)
-        execute_reset(project_dir)
-      end
-
-      desc "status", "Show current progress for both modes"
-      def status
-        puts "\n📊 AI Dev Pipeline Status"
-        puts "=" * 50
-
-        # Execute mode status
-        execute_progress = Aidp::Execute::Progress.new(Dir.pwd)
-        puts "\n🔧 Execute Mode:"
-        Aidp::Execute::Steps::SPEC.keys.each do |step|
-          status = execute_progress.step_completed?(step) ? "✅" : "⏳"
-          puts "  #{status} #{step}"
-        end
-
-        # Analyze mode status
-        analyze_progress = Aidp::Analyze::Progress.new(Dir.pwd)
-        puts "\n🔍 Analyze Mode:"
-        Aidp::Analyze::Steps::SPEC.keys.each do |step|
-          status = analyze_progress.step_completed?(step) ? "✅" : "⏳"
-          puts "  #{status} #{step}"
-        end
-      end
-
-      desc "version", "Show version information"
-      def version
-        puts "Aidp version #{Aidp::Shared::VERSION}"
-      end
-    end
-  end
-end

data/lib/aidp/shared/config.rb

@@ -1,35 +0,0 @@
-# frozen_string_literal: true
-
-require "yaml"
-
-module Aidp
-  module Shared
-    # Configuration management for both execute and analyze modes
-    class Config
-      def self.load(project_dir = Dir.pwd)
-        config_file = File.join(project_dir, ".aidp.yml")
-        if File.exist?(config_file)
-          YAML.load_file(config_file) || {}
-        else
-          {}
-        end
-      end
-
-      def self.templates_root
-        File.join(Dir.pwd, "templates")
-      end
-
-      def self.analyze_templates_root
-        File.join(Dir.pwd, "templates", "ANALYZE")
-      end
-
-      def self.execute_templates_root
-        File.join(Dir.pwd, "templates", "EXECUTE")
-      end
-
-      def self.common_templates_root
-        File.join(Dir.pwd, "templates", "COMMON")
-      end
-    end
-  end
-end

data/lib/aidp/shared/project_detector.rb

@@ -1,119 +0,0 @@
-# frozen_string_literal: true
-
-require "json"
-require "yaml"
-
-module Aidp
-  module Shared
-    # Detects project type, language, framework, and other characteristics
-    class ProjectDetector
-      attr_reader :project_dir
-
-      def initialize(project_dir = Dir.pwd)
-        @project_dir = project_dir
-      end
-
-      def detect
-        {
-          language: detect_language,
-          framework: detect_framework,
-          build_system: detect_build_system,
-          package_manager: detect_package_manager,
-          static_analysis_tools: detect_static_analysis_tools,
-          test_framework: detect_test_framework,
-          database: detect_database,
-          deployment: detect_deployment
-        }
-      end
-
-      private
-
-      def detect_language
-        return "ruby" if File.exist?(File.join(@project_dir, "Gemfile"))
-        return "javascript" if File.exist?(File.join(@project_dir, "package.json"))
-        return "python" if File.exist?(File.join(@project_dir, "requirements.txt")) || File.exist?(File.join(@project_dir, "pyproject.toml"))
-        return "java" if File.exist?(File.join(@project_dir, "pom.xml")) || File.exist?(File.join(@project_dir, "build.gradle"))
-        return "go" if File.exist?(File.join(@project_dir, "go.mod"))
-        return "rust" if File.exist?(File.join(@project_dir, "Cargo.toml"))
-        return "csharp" if File.exist?(File.join(@project_dir, "*.csproj"))
-        "unknown"
-      end
-
-      def detect_framework
-        case detect_language
-        when "ruby"
-          return "rails" if File.exist?(File.join(@project_dir, "config", "application.rb"))
-          return "sinatra" if File.exist?(File.join(@project_dir, "app.rb")) && File.read(File.join(@project_dir, "app.rb")).include?("Sinatra")
-        when "javascript"
-          return "react" if File.exist?(File.join(@project_dir, "package.json")) && File.read(File.join(@project_dir, "package.json")).include?("react")
-          return "vue" if File.exist?(File.join(@project_dir, "package.json")) && File.read(File.join(@project_dir, "package.json")).include?("vue")
-          return "angular" if File.exist?(File.join(@project_dir, "angular.json"))
-          return "express" if File.exist?(File.join(@project_dir, "package.json")) && File.read(File.join(@project_dir, "package.json")).include?("express")
-        when "python"
-          return "django" if File.exist?(File.join(@project_dir, "manage.py"))
-          return "flask" if File.exist?(File.join(@project_dir, "app.py")) && File.read(File.join(@project_dir, "app.py")).include?("Flask")
-        when "java"
-          return "spring" if File.exist?(File.join(@project_dir, "pom.xml")) && File.read(File.join(@project_dir, "pom.xml")).include?("spring-boot")
-        end
-        "unknown"
-      end
-
-      def detect_build_system
-        return "maven" if File.exist?(File.join(@project_dir, "pom.xml"))
-        return "gradle" if File.exist?(File.join(@project_dir, "build.gradle"))
-        return "npm" if File.exist?(File.join(@project_dir, "package.json"))
-        return "bundler" if File.exist?(File.join(@project_dir, "Gemfile"))
-        return "pip" if File.exist?(File.join(@project_dir, "requirements.txt"))
-        return "cargo" if File.exist?(File.join(@project_dir, "Cargo.toml"))
-        return "go" if File.exist?(File.join(@project_dir, "go.mod"))
-        "unknown"
-      end
-
-      def detect_package_manager
-        detect_build_system
-      end
-
-      def detect_static_analysis_tools
-        tools = []
-        tools << "rubocop" if File.exist?(File.join(@project_dir, ".rubocop.yml"))
-        tools << "eslint" if File.exist?(File.join(@project_dir, ".eslintrc"))
-        tools << "flake8" if File.exist?(File.join(@project_dir, ".flake8"))
-        tools << "checkstyle" if File.exist?(File.join(@project_dir, "checkstyle.xml"))
-        tools << "clippy" if File.exist?(File.join(@project_dir, "Cargo.toml"))
-        tools
-      end
-
-      def detect_test_framework
-        case detect_language
-        when "ruby"
-          return "rspec" if File.exist?(File.join(@project_dir, "spec"))
-          return "minitest" if File.exist?(File.join(@project_dir, "test"))
-        when "javascript"
-          return "jest" if File.exist?(File.join(@project_dir, "package.json")) && File.read(File.join(@project_dir, "package.json")).include?("jest")
-          return "mocha" if File.exist?(File.join(@project_dir, "package.json")) && File.read(File.join(@project_dir, "package.json")).include?("mocha")
-        when "python"
-          return "pytest" if File.exist?(File.join(@project_dir, "pytest.ini"))
-          return "unittest" if Dir.exist?(File.join(@project_dir, "tests"))
-        when "java"
-          return "junit" if File.exist?(File.join(@project_dir, "src", "test"))
-        end
-        "unknown"
-      end
-
-      def detect_database
-        return "postgresql" if File.exist?(File.join(@project_dir, "config", "database.yml")) && File.read(File.join(@project_dir, "config", "database.yml")).include?("postgresql")
-        return "mysql" if File.exist?(File.join(@project_dir, "config", "database.yml")) && File.read(File.join(@project_dir, "config", "database.yml")).include?("mysql")
-        return "sqlite" if File.exist?(File.join(@project_dir, "config", "database.yml")) && File.read(File.join(@project_dir, "config", "database.yml")).include?("sqlite")
-        "unknown"
-      end
-
-      def detect_deployment
-        return "docker" if File.exist?(File.join(@project_dir, "Dockerfile"))
-        return "kubernetes" if File.exist?(File.join(@project_dir, "k8s")) || File.exist?(File.join(@project_dir, "kubernetes"))
-        return "heroku" if File.exist?(File.join(@project_dir, "Procfile"))
-        return "aws" if File.exist?(File.join(@project_dir, "serverless.yml")) || File.exist?(File.join(@project_dir, "template.yaml"))
-        "unknown"
-      end
-    end
-  end
-end

data/lib/aidp/shared/providers/anthropic.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Aidp
-  module Shared
-    module Providers
-      class Anthropic < Base
-        def self.available?
-          !!Aidp::Shared::Util.which("claude")
-        end
-
-        def name = "anthropic"
-
-        def send(prompt:, session: nil)
-          raise "claude CLI not available" unless self.class.available?
-
-          # Use Claude CLI for non-interactive mode
-          cmd = ["claude", "compose", "--prompt", prompt]
-          system(*cmd)
-          :ok
-        end
-      end
-    end
-  end
-end

data/lib/aidp/shared/providers/base.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Aidp
-  module Shared
-    module Providers
-      class Base
-        def name = raise(NotImplementedError)
-
-        # Send a composed prompt string to the provider.
-        # Return :ok when command completed successfully,
-        # Return :interactive when starting an interactive session (for gate steps),
-        # or return a string if we captured output and the caller should write to a file.
-        def send(prompt:, session: nil) = raise(NotImplementedError)
-      end
-    end
-  end
-end

data/lib/aidp/shared/providers/cursor.rb

@@ -1,102 +0,0 @@
-# frozen_string_literal: true
-
-require "open3"
-require "timeout"
-require_relative "base"
-require_relative "../util"
-
-module Aidp
-  module Shared
-    module Providers
-      class Cursor < Base
-        def self.available?
-          !!Aidp::Shared::Util.which("cursor-agent")
-        end
-
-        def name = "cursor"
-
-        def send(prompt:, session: nil)
-          raise "cursor-agent not available" unless self.class.available?
-
-          # Always use non-interactive mode with -p flag
-          cmd = ["cursor-agent", "-p"]
-          puts "📝 Sending prompt to cursor-agent"
-
-          # Enable debug output if requested
-          if ENV["AIDP_DEBUG"]
-            puts "🔍 Debug mode enabled - showing cursor-agent output"
-          end
-
-          # Setup logging if log file is specified
-          log_file = ENV["AIDP_LOG_FILE"]
-          if log_file
-            puts "📝 Logging to: #{log_file}"
-          end
-
-          Open3.popen3(*cmd) do |stdin, stdout, stderr, wait|
-            # Send the prompt to stdin
-            stdin.puts prompt
-            stdin.close
-
-            # Log the prompt if debugging
-            if ENV["AIDP_DEBUG"] || log_file
-              prompt_log = "📝 Sending prompt to cursor-agent:\n#{prompt}"
-              puts prompt_log if ENV["AIDP_DEBUG"]
-              File.write(log_file, "#{Time.now.iso8601} #{prompt_log}\n", mode: "a") if log_file
-            end
-
-            # Handle debug output and logging
-            if ENV["AIDP_DEBUG"] || log_file
-              # Start threads to capture and display output in real-time
-              stdout_thread = Thread.new do
-                stdout.each_line do |line|
-                  output = "📤 cursor-agent: #{line.chomp}"
-                  puts output if ENV["AIDP_DEBUG"]
-                  File.write(log_file, "#{Time.now.iso8601} #{output}\n", mode: "a") if log_file
-                end
-              end
-
-              stderr_thread = Thread.new do
-                stderr.each_line do |line|
-                  output = "❌ cursor-agent error: #{line.chomp}"
-                  puts output if ENV["AIDP_DEBUG"]
-                  File.write(log_file, "#{Time.now.iso8601} #{output}\n", mode: "a") if log_file
-                end
-              end
-            end
-
-            # Wait for completion with a reasonable timeout
-            begin
-              Timeout.timeout(300) do # 5 minutes timeout
-                result = wait.value
-
-                # Stop debug threads
-                if ENV["AIDP_DEBUG"]
-                  stdout_thread&.kill
-                  stderr_thread&.kill
-                end
-
-                return :ok if result.success?
-                raise "cursor-agent failed with exit code #{result.exitstatus}"
-              end
-            rescue Timeout::Error
-              # Stop debug threads
-              if ENV["AIDP_DEBUG"]
-                stdout_thread&.kill
-                stderr_thread&.kill
-              end
-
-              # Kill the process if it's taking too long
-              begin
-                Process.kill("TERM", wait.pid)
-              rescue
-                nil
-              end
-              raise Timeout::Error, "cursor-agent timed out after 5 minutes"
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/aidp/shared/providers/gemini.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Aidp
-  module Shared
-    module Providers
-      class Gemini < Base
-        def self.available?
-          !!Aidp::Shared::Util.which("gemini")
-        end
-
-        def name = "gemini"
-
-        def send(prompt:, session: nil)
-          raise "gemini CLI not available" unless self.class.available?
-
-          # Use Gemini CLI for non-interactive mode
-          cmd = ["gemini", "chat", "--prompt", prompt]
-          system(*cmd)
-          :ok
-        end
-      end
-    end
-  end
-end