diogenes 0.1.7 → 0.1.8

data/lib/diogenes/targets/base.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require "fileutils"
+
+module Diogenes
+  module Targets
+    class Base
+      #: (cwd: String, out: IO) -> void
+      def initialize(cwd:, out:)
+        @cwd = cwd #: String
+        @out = out #: IO
+      end
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        raise NotImplementedError, "#{self.class}#build must be implemented"
+      end
+
+      protected
+
+      #: (String, String) -> String
+      def write(relative_path, content)
+        full = File.join(@cwd, relative_path)
+        FileUtils.mkdir_p(File.dirname(full))
+        File.write(full, content)
+        relative_path
+      end
+
+      #: (String) -> String
+      def generated_banner(target_name)
+        "Generated by `diogenes build --target #{target_name}`. " \
+          "Edit sources in `.diogenes/` and rebuild. Do not edit directly."
+      end
+
+      #: (Array[DSL::Skill], skills_dir: String) -> Array[String]
+      def write_skill_files(skills, skills_dir:)
+        skills.map do |skill|
+          slug = skill.command.to_s.sub(/\A\//, "")
+          write(File.join(skills_dir, slug, "SKILL.md"), skill_file_content(skill))
+        end
+      end
+
+      #: (DSL::Skill) -> String
+      def skill_file_content(skill)
+        <<~MD.strip
+          # #{skill.command}
+
+          #{skill.description}
+
+          ## Prompt
+
+          #{skill.prompt}
+        MD
+      end
+    end
+  end
+end

data/lib/diogenes/targets/claude_code.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    class ClaudeCode < Base
+      OUTPUT_PATH = "CLAUDE.md" #: String
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        skill_files = write_skill_files(sources.skills, skills_dir: ".claude/skills")
+        [write(OUTPUT_PATH, render(sources))] + skill_files
+      end
+
+      private
+
+      #: (untyped) -> String
+      def render(sources)
+        parts = [header]
+        parts << skills_section(sources.skills) unless sources.skills.empty?
+        parts << rules_section(sources.rules) unless sources.rules.empty?
+        parts << hooks_section(sources.hooks) unless sources.hooks.empty?
+        parts.join("\n\n")
+      end
+
+      #: () -> String
+      def header
+        <<~HEADER.strip
+          # Agent Configuration
+
+          > #{generated_banner("claude-code")}
+        HEADER
+      end
+
+      #: (Array[DSL::Skill]) -> String
+      def skills_section(skills)
+        lines = ["## Available Skills", ""]
+        skills.each do |skill|
+          lines << "### #{skill.command}"
+          lines << ""
+          lines << skill.description
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Rule]) -> String
+      def rules_section(rules)
+        lines = ["## Active Rules", ""]
+        rules.each do |rule|
+          lines << "### #{rule.name}"
+          lines << ""
+          lines << rule.content
+          lines << ""
+          lines << "---"
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Hook]) -> String
+      def hooks_section(hooks)
+        lines = ["## Hooks", ""]
+        hooks.each do |hook|
+          lines << "### #{hook.name}"
+          lines << ""
+          lines << "**Trigger:** #{hook.trigger}"
+          lines << ""
+          lines << hook.prompt
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+    end
+  end
+end

data/lib/diogenes/targets/codex.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    class Codex < Base
+      OUTPUT_PATH = "AGENTS.md" #: String
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        skill_files = write_skill_files(sources.skills, skills_dir: ".agents/skills")
+        [write(OUTPUT_PATH, render(sources))] + skill_files
+      end
+
+      private
+
+      #: (untyped) -> String
+      def render(sources)
+        parts = [header]
+        parts << rules_section(sources.rules) unless sources.rules.empty?
+        parts << skills_section(sources.skills) unless sources.skills.empty?
+        parts.join("\n\n")
+      end
+
+      #: () -> String
+      def header
+        <<~HEADER.strip
+          # Agent Instructions
+
+          > #{generated_banner("codex")}
+        HEADER
+      end
+
+      #: (Array[DSL::Rule]) -> String
+      def rules_section(rules)
+        lines = ["## Rules", ""]
+        rules.each do |rule|
+          lines << "### #{rule.name}"
+          lines << ""
+          lines << rule.content
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Skill]) -> String
+      def skills_section(skills)
+        lines = ["## Available commands", ""]
+        skills.each do |skill|
+          lines << "### #{skill.command}"
+          lines << ""
+          lines << skill.description
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+    end
+  end
+end

data/lib/diogenes/targets/copilot.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    class Copilot < Base
+      OUTPUT_PATH = ".github/copilot-instructions.md" #: String
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        skill_files = write_skill_files(sources.skills, skills_dir: ".agents/skills")
+        [write(OUTPUT_PATH, render(sources))] + skill_files
+      end
+
+      private
+
+      #: (untyped) -> String
+      def render(sources)
+        parts = [header]
+        parts << rules_section(sources.rules) unless sources.rules.empty?
+        parts << skills_section(sources.skills) unless sources.skills.empty?
+        parts.join("\n\n")
+      end
+
+      #: () -> String
+      def header
+        "<!-- #{generated_banner("copilot")} -->"
+      end
+
+      #: (Array[DSL::Rule]) -> String
+      def rules_section(rules)
+        lines = ["## Always apply these rules", ""]
+        rules.each do |rule|
+          lines << rule.content
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Skill]) -> String
+      def skills_section(skills)
+        lines = ["## Available slash commands", ""]
+        skills.each do |skill|
+          lines << "- **#{skill.command}**: #{skill.description}"
+        end
+        lines.join("\n").strip
+      end
+    end
+  end
+end

data/lib/diogenes/targets/cursor.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    class Cursor < Base
+      OUTPUT_PATH = ".cursor/rules/diogenes.mdc" #: String
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        skill_files = write_skill_files(sources.skills, skills_dir: ".agents/skills")
+        [write(OUTPUT_PATH, render(sources))] + skill_files
+      end
+
+      private
+
+      #: (untyped) -> String
+      def render(sources)
+        parts = []
+        parts << frontmatter
+        parts << "<!-- #{generated_banner("cursor")} -->"
+        parts << rules_block(sources.rules) unless sources.rules.empty?
+        parts << skills_block(sources.skills) unless sources.skills.empty?
+        parts.join("\n\n")
+      end
+
+      #: () -> String
+      def frontmatter
+        <<~YAML.strip
+          ---
+          description: Diogenes AI feature decision framework
+          alwaysApply: true
+          ---
+        YAML
+      end
+
+      #: (Array[DSL::Rule]) -> String
+      def rules_block(rules)
+        lines = ["## Rules", ""]
+        rules.each do |rule|
+          lines << "### #{rule.name}"
+          lines << ""
+          lines << rule.content
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Skill]) -> String
+      def skills_block(skills)
+        lines = ["## Skills", ""]
+        skills.each do |skill|
+          lines << "- **#{skill.command}** — #{skill.description}"
+        end
+        lines.join("\n").strip
+      end
+    end
+  end
+end

data/lib/diogenes/targets/gemini.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    class Gemini < Base
+      OUTPUT_PATH = ".gemini/instructions.md" #: String
+
+      #: (sources: untyped) -> Array[String]
+      def build(sources:)
+        skill_files = write_skill_files(sources.skills, skills_dir: ".agents/skills")
+        [write(OUTPUT_PATH, render(sources))] + skill_files
+      end
+
+      private
+
+      #: (untyped) -> String
+      def render(sources)
+        parts = [header]
+        parts << rules_section(sources.rules) unless sources.rules.empty?
+        parts << skills_section(sources.skills) unless sources.skills.empty?
+        parts.join("\n\n")
+      end
+
+      #: () -> String
+      def header
+        <<~HEADER.strip
+          # Agent Instructions
+
+          > #{generated_banner("gemini")}
+        HEADER
+      end
+
+      #: (Array[DSL::Rule]) -> String
+      def rules_section(rules)
+        lines = ["## Rules", ""]
+        rules.each do |rule|
+          lines << "### #{rule.name}"
+          lines << ""
+          lines << rule.content
+          lines << ""
+        end
+        lines.join("\n").strip
+      end
+
+      #: (Array[DSL::Skill]) -> String
+      def skills_section(skills)
+        lines = ["## Skills", ""]
+        skills.each do |skill|
+          lines << "- **#{skill.command}**: #{skill.description}"
+        end
+        lines.join("\n").strip
+      end
+    end
+  end
+end

data/lib/diogenes/targets.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Targets
+    KNOWN = %i[claude_code cursor copilot codex gemini].freeze #: Array[Symbol]
+
+    #: (Symbol, cwd: String, out: IO) -> Targets::Base
+    def self.for(key, cwd:, out:)
+      case key
+      when :claude_code then ClaudeCode.new(cwd:, out:)
+      when :cursor then Cursor.new(cwd:, out:)
+      when :copilot then Copilot.new(cwd:, out:)
+      when :codex then Codex.new(cwd:, out:)
+      when :gemini then Gemini.new(cwd:, out:)
+      else raise UserError, "Unknown target: #{key}. Known targets: #{KNOWN.join(", ")}"
+      end
+    end
+  end
+end

data/lib/diogenes/version.rb

@@ -2,5 +2,5 @@
 # rbs_inline: enabled
 
 module Diogenes
-  VERSION = "0.1.7" #: String
+  VERSION = "0.1.8" #: String
 end

data/lib/diogenes.rb

@@ -37,6 +37,18 @@ module Diogenes
       VERSION
     end
 
+    #: () { () -> void } -> Configuration
+    def configure(&block)
+      @configuration ||= Configuration.new
+      @configuration.instance_eval(&block) if block
+      @configuration
+    end
+
+    #: () -> Configuration
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
     #: (String) { () -> void } -> DSL::Skill
     def skill(name, &block)
       @skills[name] = DSL::Skill.new(name, &block)
@@ -75,6 +87,7 @@ module Diogenes
       @rules = {}
       @hooks = {}
       @artifacts = {}
+      @configuration = nil
     end
   end
 end

data/sig/generated/diogenes/cli/build.rbs

@@ -0,0 +1,40 @@
+# Generated from lib/diogenes/cli/build.rb with RBS::Inline
+
+module Diogenes
+  class Cli
+    class Build
+      DIOGENES_DIR: String
+
+      SOURCE_SUBDIRS: Array[String]
+
+      # : (argv: Array[String], cwd: String, out: IO, err: IO, **untyped) -> Integer
+      def self.run: (argv: Array[String], cwd: String, out: IO, err: IO, **untyped) -> Integer
+
+      # : (argv: Array[String], cwd: String, out: IO, err: IO) -> void
+      def initialize: (argv: Array[String], cwd: String, out: IO, err: IO) -> void
+
+      # : () -> Integer
+      def run: () -> Integer
+
+      private
+
+      # : () -> void
+      def parse_options: () -> void
+
+      # : () -> Integer
+      def usage_error: () -> Integer
+
+      # : (String) -> void
+      def load_config: (String) -> void
+
+      # : (String) -> void
+      def load_sources: (String) -> void
+
+      # : (Array[Symbol], untyped) -> Array[Hash[Symbol, untyped]]
+      def build_targets: (Array[Symbol], untyped) -> Array[Hash[Symbol, untyped]]
+
+      # : (Array[Hash[Symbol, untyped]]) -> void
+      def print_summary: (Array[Hash[Symbol, untyped]]) -> void
+    end
+  end
+end

data/sig/generated/diogenes/configuration.rbs

@@ -0,0 +1,22 @@
+# Generated from lib/diogenes/configuration.rb with RBS::Inline
+
+module Diogenes
+  class Configuration
+    DEFAULT_ARTIFACTS_DIR: String
+
+    # : () -> void
+    def initialize: () -> void
+
+    # : (?String?) -> String?
+    def name: (?String?) -> String?
+
+    # : (?String?) -> String?
+    def description: (?String?) -> String?
+
+    # : (*Symbol) -> Array[Symbol]
+    def targets: (*Symbol) -> Array[Symbol]
+
+    # : (?String?) -> String
+    def artifacts_dir: (?String?) -> String
+  end
+end

data/sig/generated/diogenes/targets/base.rbs

@@ -0,0 +1,25 @@
+# Generated from lib/diogenes/targets/base.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class Base
+      # : (cwd: String, out: IO) -> void
+      def initialize: (cwd: String, out: IO) -> void
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      # : (String, String) -> String
+      def write: (String, String) -> String
+
+      # : (String) -> String
+      def generated_banner: (String) -> String
+
+      # : (Array[DSL::Skill], skills_dir: String) -> Array[String]
+      def write_skill_files: (Array[DSL::Skill], skills_dir: String) -> Array[String]
+
+      # : (DSL::Skill) -> String
+      def skill_file_content: (DSL::Skill) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets/claude_code.rbs

@@ -0,0 +1,29 @@
+# Generated from lib/diogenes/targets/claude_code.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class ClaudeCode < Base
+      OUTPUT_PATH: String
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      private
+
+      # : (untyped) -> String
+      def render: (untyped) -> String
+
+      # : () -> String
+      def header: () -> String
+
+      # : (Array[DSL::Skill]) -> String
+      def skills_section: (Array[DSL::Skill]) -> String
+
+      # : (Array[DSL::Rule]) -> String
+      def rules_section: (Array[DSL::Rule]) -> String
+
+      # : (Array[DSL::Hook]) -> String
+      def hooks_section: (Array[DSL::Hook]) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets/codex.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/diogenes/targets/codex.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class Codex < Base
+      OUTPUT_PATH: String
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      private
+
+      # : (untyped) -> String
+      def render: (untyped) -> String
+
+      # : () -> String
+      def header: () -> String
+
+      # : (Array[DSL::Rule]) -> String
+      def rules_section: (Array[DSL::Rule]) -> String
+
+      # : (Array[DSL::Skill]) -> String
+      def skills_section: (Array[DSL::Skill]) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets/copilot.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/diogenes/targets/copilot.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class Copilot < Base
+      OUTPUT_PATH: String
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      private
+
+      # : (untyped) -> String
+      def render: (untyped) -> String
+
+      # : () -> String
+      def header: () -> String
+
+      # : (Array[DSL::Rule]) -> String
+      def rules_section: (Array[DSL::Rule]) -> String
+
+      # : (Array[DSL::Skill]) -> String
+      def skills_section: (Array[DSL::Skill]) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets/cursor.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/diogenes/targets/cursor.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class Cursor < Base
+      OUTPUT_PATH: String
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      private
+
+      # : (untyped) -> String
+      def render: (untyped) -> String
+
+      # : () -> String
+      def frontmatter: () -> String
+
+      # : (Array[DSL::Rule]) -> String
+      def rules_block: (Array[DSL::Rule]) -> String
+
+      # : (Array[DSL::Skill]) -> String
+      def skills_block: (Array[DSL::Skill]) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets/gemini.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/diogenes/targets/gemini.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    class Gemini < Base
+      OUTPUT_PATH: String
+
+      # : (sources: untyped) -> Array[String]
+      def build: (sources: untyped) -> Array[String]
+
+      private
+
+      # : (untyped) -> String
+      def render: (untyped) -> String
+
+      # : () -> String
+      def header: () -> String
+
+      # : (Array[DSL::Rule]) -> String
+      def rules_section: (Array[DSL::Rule]) -> String
+
+      # : (Array[DSL::Skill]) -> String
+      def skills_section: (Array[DSL::Skill]) -> String
+    end
+  end
+end

data/sig/generated/diogenes/targets.rbs

@@ -0,0 +1,10 @@
+# Generated from lib/diogenes/targets.rb with RBS::Inline
+
+module Diogenes
+  module Targets
+    KNOWN: Array[Symbol]
+
+    # : (Symbol, cwd: String, out: IO) -> Targets::Base
+    def self.for: (Symbol, cwd: String, out: IO) -> Targets::Base
+  end
+end

data/sig/generated/diogenes.rbs

@@ -24,6 +24,12 @@ module Diogenes
   # : () -> String
   def self.version: () -> String
 
+  # : () { () -> void } -> Configuration
+  def self.configure: () { () -> void } -> Configuration
+
+  # : () -> Configuration
+  def self.configuration: () -> Configuration
+
   # : (String) { () -> void } -> DSL::Skill
   def self.skill: (String) { () -> void } -> DSL::Skill