plan_driven 0.1.0

data/lib/plan_driven.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "active_support/core_ext/object/blank"
+require "active_support/core_ext/string/inflections"
+require "active_support/core_ext/string/filters"
+require "pathname"
+require "set"
+
+require_relative "plan_driven/version"
+require_relative "plan_driven/errors"
+require_relative "plan_driven/credentials"
+require_relative "plan_driven/configuration"
+require_relative "plan_driven/template"
+require_relative "plan_driven/schema_context"
+require_relative "plan_driven/workflow"
+require_relative "plan_driven/models"
+require_relative "plan_driven/json_reply"
+require_relative "plan_driven/llm"
+require_relative "plan_driven/cursor_llm"
+require_relative "plan_driven/guards"
+require_relative "plan_driven/gherkin"
+require_relative "plan_driven/drafter"
+require_relative "plan_driven/ticket_generator"
+require_relative "plan_driven/agent_prompt"
+require_relative "plan_driven/http"
+require_relative "plan_driven/github"
+require_relative "plan_driven/cursor_agents"
+require_relative "plan_driven/repository"
+require_relative "plan_driven/renderer"
+require_relative "plan_driven/evidence"
+require_relative "plan_driven/delivery"
+require_relative "plan_driven/railtie" if defined?(Rails::Railtie)
+
+module PlanDriven
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+
+    def reset!
+      @configuration = nil
+    end
+
+    # Names like "Blažević" arrive tagged with the locale's encoding, which under LANG=C is
+    # binary, and binary strings can't be joined with the UTF-8 text of a plan.
+    def actor
+      name = ENV["PLAN_DRIVEN_ACTOR"].presence || git_identity || ENV.fetch("USER", "unknown")
+      utf8(name)
+    end
+
+    def utf8(text)
+      text.to_s.dup.force_encoding(Encoding::UTF_8).scrub
+    end
+
+    private
+
+    def git_identity
+      name = utf8(`git config user.name 2>/dev/null`).strip
+      email = utf8(`git config user.email 2>/dev/null`).strip
+      return if name.empty? && email.empty?
+
+      email.empty? ? name : "#{name} <#{email}>".strip
+    rescue StandardError
+      nil
+    end
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: plan_driven
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ivan Blažević
+bindir: exe
+cert_chain: []
+date: 2026-09-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+description: |
+  plan_driven runs a Rails team's delivery process from the command line. A terminal interview
+  turns an idea into an implementation plan grounded in your real schema; the plan is checked
+  by guards written in Ruby, rendered to PDF and approved. Approved plans become tickets, each
+  ticket is handed to a Cursor cloud agent that opens a pull request, and only pull requests
+  you approve are merged. Acceptance criteria map to Cucumber scenarios, and every phase leaves
+  documentation behind: the plan, the tickets, the pull requests and a delivery report.
+email:
+- ivan.blazevic@rubycode.co
+executables:
+- plan-driven
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/plan-driven
+- lib/generators/plan_driven/install_generator.rb
+- lib/generators/plan_driven/templates/create_plan_driven_tables.rb.tt
+- lib/generators/plan_driven/templates/plan_driven.rb
+- lib/plan_driven.rb
+- lib/plan_driven/agent_prompt.rb
+- lib/plan_driven/cli.rb
+- lib/plan_driven/cli/plan_commands.rb
+- lib/plan_driven/cli/setup_commands.rb
+- lib/plan_driven/cli/ticket_commands.rb
+- lib/plan_driven/cli/ui.rb
+- lib/plan_driven/configuration.rb
+- lib/plan_driven/credentials.rb
+- lib/plan_driven/cursor_agents.rb
+- lib/plan_driven/cursor_llm.mjs
+- lib/plan_driven/cursor_llm.rb
+- lib/plan_driven/delivery.rb
+- lib/plan_driven/drafter.rb
+- lib/plan_driven/errors.rb
+- lib/plan_driven/evidence.rb
+- lib/plan_driven/gherkin.rb
+- lib/plan_driven/github.rb
+- lib/plan_driven/guards.rb
+- lib/plan_driven/guards/migration_guard.rb
+- lib/plan_driven/guards/plan_guard.rb
+- lib/plan_driven/guards/pr_guard.rb
+- lib/plan_driven/guards/ticket_guard.rb
+- lib/plan_driven/guards/ticket_normalizer.rb
+- lib/plan_driven/http.rb
+- lib/plan_driven/json_reply.rb
+- lib/plan_driven/llm.rb
+- lib/plan_driven/models.rb
+- lib/plan_driven/models/approval.rb
+- lib/plan_driven/models/event.rb
+- lib/plan_driven/models/evidence_run.rb
+- lib/plan_driven/models/plan.rb
+- lib/plan_driven/models/record.rb
+- lib/plan_driven/models/ticket.rb
+- lib/plan_driven/railtie.rb
+- lib/plan_driven/renderer.rb
+- lib/plan_driven/renderer/html.rb
+- lib/plan_driven/renderer/markdown.rb
+- lib/plan_driven/renderer/pdf.rb
+- lib/plan_driven/renderer/style.css
+- lib/plan_driven/repository.rb
+- lib/plan_driven/schema_context.rb
+- lib/plan_driven/template.rb
+- lib/plan_driven/ticket_generator.rb
+- lib/plan_driven/version.rb
+- lib/plan_driven/workflow.rb
+homepage: https://github.com/blaz1988/plan-driven
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/blaz1988/plan-driven
+  documentation_uri: https://github.com/blaz1988/plan-driven#readme
+  changelog_uri: https://github.com/blaz1988/plan-driven/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/blaz1988/plan-driven/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.4
+specification_version: 4
+summary: From implementation plan to merged, tested pull requests, driven from the
+  terminal.
+test_files: []