diogenes 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23508c589817a7a8faac15185d7c803745553d4d7789ba279de8c871a6103336
-  data.tar.gz: 21405f813bf767dd43f88bfb554d611201480f1de7f75d73868e0ce65a02d419
+  metadata.gz: ed59a2db9702739e79ab10146a799260ff41fbbe85c0178d9fd5c0976bd4621f
+  data.tar.gz: 2ca1bf8250b1753b059b48ee226eb8b20c122c2adce7ada559bb1047b5c5a03f
 SHA512:
-  metadata.gz: c66d6ecd7165e10aad7db8e036d74060d9e8d32dbaa627711fbd3bcbc490768e074da7042d42dc3dfb6bbe9a7f14d2b874780863ffd57a27d6a2a99d79ab6ac0
-  data.tar.gz: 6be0cb67ee1592d32ff288acf254c7521562c45e860fdd0dd87da5b2ab86b940565810ef30d31d9522b10c09366e81ea552ccff1efad814d18f40406e4fc0b72
+  metadata.gz: 84d21f0c4cf3817bafa44054a479f0c8d91e4a26b19d6835313511c1e5108e0e49f96316391d5b58f5c1f6a569e1432f0481e07b50d59b2fe6401c52d8871f4e
+  data.tar.gz: 2e5a9956eb13f0e19bd86cb71a333822771d4edd302e93c6000981b59ea9c67622a36702b9aee8f4e42b3f848b882b3ed44bcca3500fe2d38137ac4a47322ce6

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-    ".": "0.1.3"
+    ".": "0.1.4"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.1.4](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.3...diogenes/v0.1.4) (2026-06-27)
+
+
+### Features
+
+* **dsl:** implement canonical source format DSL :sparkles: ([#7](https://github.com/meaganewaller/diogenes/issues/7)) ([e8a8f15](https://github.com/meaganewaller/diogenes/commit/e8a8f154a00fa4849d6a8f9b816cc037ad17e63d))
+
 ## [0.1.3](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.2...diogenes/v0.1.3) (2026-06-27)
 
 

data/lib/diogenes/dsl/artifact.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module DSL
+    class Artifact
+      attr_reader :name #: String
+
+      #: (String, ?Proc) -> void
+      def initialize(name, &block)
+        @name = name #: String
+        instance_eval(&block) if block_given?
+        validate!
+      end
+
+      #: (?String?) -> String?
+      def description(value = nil)
+        @description = value unless value.nil?
+        @description
+      end
+
+      #: (?String?) -> String?
+      def template(value = nil)
+        @template = value unless value.nil?
+        @template
+      end
+
+      private
+
+      #: () -> void
+      def validate!
+        missing = %i[description template].reject { |f| instance_variable_get(:"@#{f}") }
+        return if missing.empty?
+
+        raise Diogenes::ConfigurationError,
+          "Artifact #{@name.inspect} is missing required " \
+          "field#{"s" if missing.size > 1}: #{missing.join(", ")}. " \
+          "An artifact requires: description and template."
+      end
+    end
+  end
+end

data/lib/diogenes/dsl/hook.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module DSL
+    class Hook
+      attr_reader :name #: String
+
+      #: (String, ?Proc) -> void
+      def initialize(name, &block)
+        @name = name #: String
+        instance_eval(&block) if block_given?
+        validate!
+      end
+
+      #: (?String?) -> String?
+      def trigger(value = nil)
+        @trigger = value unless value.nil?
+        @trigger
+      end
+
+      #: (?String?) -> String?
+      def prompt(value = nil)
+        @prompt = value unless value.nil?
+        @prompt
+      end
+
+      private
+
+      #: () -> void
+      def validate!
+        missing = %i[trigger prompt].reject { |f| instance_variable_get(:"@#{f}") }
+        return if missing.empty?
+
+        raise Diogenes::ConfigurationError,
+          "Hook #{@name.inspect} is missing required " \
+          "field#{"s" if missing.size > 1}: #{missing.join(", ")}. " \
+          "A hook requires: trigger and prompt."
+      end
+    end
+  end
+end

data/lib/diogenes/dsl/rule.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module DSL
+    class Rule
+      attr_reader :name #: String
+
+      #: (String, ?Proc) -> void
+      def initialize(name, &block)
+        @name = name #: String
+        instance_eval(&block) if block_given?
+        validate!
+      end
+
+      #: (?String?) -> String?
+      def description(value = nil)
+        @description = value unless value.nil?
+        @description
+      end
+
+      #: (?String?) -> String?
+      def content(value = nil)
+        @content = value unless value.nil?
+        @content
+      end
+
+      private
+
+      #: () -> void
+      def validate!
+        missing = %i[description content].reject { |f| instance_variable_get(:"@#{f}") }
+        return if missing.empty?
+
+        raise Diogenes::ConfigurationError,
+          "Rule #{@name.inspect} is missing required " \
+          "field#{"s" if missing.size > 1}: #{missing.join(", ")}. " \
+          "A rule requires: description and content."
+      end
+    end
+  end
+end

data/lib/diogenes/dsl/skill.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module DSL
+    class Skill
+      attr_reader :name #: String
+
+      #: (String, ?Proc) -> void
+      def initialize(name, &block)
+        @name = name #: String
+        instance_eval(&block) if block_given?
+        validate!
+      end
+
+      #: (?String?) -> String?
+      def command(value = nil)
+        @command = value unless value.nil?
+        @command
+      end
+
+      #: (?String?) -> String?
+      def description(value = nil)
+        @description = value unless value.nil?
+        @description
+      end
+
+      #: (?String?) -> String?
+      def prompt(value = nil)
+        @prompt = value unless value.nil?
+        @prompt
+      end
+
+      private
+
+      #: () -> void
+      def validate!
+        missing = %i[command description prompt].reject { |f| instance_variable_get(:"@#{f}") }
+        return if missing.empty?
+
+        raise Diogenes::ConfigurationError,
+          "Skill #{@name.inspect} is missing required " \
+          "field#{"s" if missing.size > 1}: #{missing.join(", ")}. " \
+          "A skill requires: command, description, and prompt."
+      end
+    end
+  end
+end

data/lib/diogenes/version.rb

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

data/lib/diogenes.rb

@@ -7,6 +7,7 @@ require "zeitwerk"
 #
 # Provides configuration, CLI, and runtime library for the Diogenes gem.
 loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect("dsl" => "DSL")
 loader.setup
 
 module Diogenes
@@ -22,12 +23,58 @@ module Diogenes
   # Raised when the user provides invalid arguments to the CLI.
   class UserError < Error; end
 
-  # Returns the version of the Diogenes gem.
-  #
-  # This is managed by the release-please workflow.
-  # --
-  #: () -> String
-  def self.version
-    VERSION
+  # Raised when a DSL definition is missing required fields.
+  class ConfigurationError < Error; end
+
+  @skills = {} #: Hash[String, DSL::Skill]
+  @rules = {} #: Hash[String, DSL::Rule]
+  @hooks = {} #: Hash[String, DSL::Hook]
+  @artifacts = {} #: Hash[String, DSL::Artifact]
+
+  class << self
+    #: () -> String
+    def version
+      VERSION
+    end
+
+    #: (String) { () -> void } -> DSL::Skill
+    def skill(name, &block)
+      @skills[name] = DSL::Skill.new(name, &block)
+    end
+
+    #: (String) { () -> void } -> DSL::Rule
+    def rule(name, &block)
+      @rules[name] = DSL::Rule.new(name, &block)
+    end
+
+    #: (String) { () -> void } -> DSL::Hook
+    def hook(name, &block)
+      @hooks[name] = DSL::Hook.new(name, &block)
+    end
+
+    #: (String) { () -> void } -> DSL::Artifact
+    def artifact(name, &block)
+      @artifacts[name] = DSL::Artifact.new(name, &block)
+    end
+
+    #: () -> Array[DSL::Skill]
+    def skills = @skills.values
+
+    #: () -> Array[DSL::Rule]
+    def rules = @rules.values
+
+    #: () -> Array[DSL::Hook]
+    def hooks = @hooks.values
+
+    #: () -> Array[DSL::Artifact]
+    def artifacts = @artifacts.values
+
+    #: () -> void
+    def reset!
+      @skills = {}
+      @rules = {}
+      @hooks = {}
+      @artifacts = {}
+    end
   end
 end

data/sig/generated/diogenes/dsl/artifact.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/diogenes/dsl/artifact.rb with RBS::Inline
+
+module Diogenes
+  module DSL
+    class Artifact
+      attr_reader name: String
+
+      # : (String, ?Proc) -> void
+      def initialize: (String, ?Proc) -> void
+
+      # : (?String?) -> String?
+      def description: (?String?) -> String?
+
+      # : (?String?) -> String?
+      def template: (?String?) -> String?
+
+      private
+
+      # : () -> void
+      def validate!: () -> void
+    end
+  end
+end

data/sig/generated/diogenes/dsl/hook.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/diogenes/dsl/hook.rb with RBS::Inline
+
+module Diogenes
+  module DSL
+    class Hook
+      attr_reader name: String
+
+      # : (String, ?Proc) -> void
+      def initialize: (String, ?Proc) -> void
+
+      # : (?String?) -> String?
+      def trigger: (?String?) -> String?
+
+      # : (?String?) -> String?
+      def prompt: (?String?) -> String?
+
+      private
+
+      # : () -> void
+      def validate!: () -> void
+    end
+  end
+end

data/sig/generated/diogenes/dsl/rule.rbs

@@ -0,0 +1,23 @@
+# Generated from lib/diogenes/dsl/rule.rb with RBS::Inline
+
+module Diogenes
+  module DSL
+    class Rule
+      attr_reader name: String
+
+      # : (String, ?Proc) -> void
+      def initialize: (String, ?Proc) -> void
+
+      # : (?String?) -> String?
+      def description: (?String?) -> String?
+
+      # : (?String?) -> String?
+      def content: (?String?) -> String?
+
+      private
+
+      # : () -> void
+      def validate!: () -> void
+    end
+  end
+end

data/sig/generated/diogenes/dsl/skill.rbs

@@ -0,0 +1,26 @@
+# Generated from lib/diogenes/dsl/skill.rb with RBS::Inline
+
+module Diogenes
+  module DSL
+    class Skill
+      attr_reader name: String
+
+      # : (String, ?Proc) -> void
+      def initialize: (String, ?Proc) -> void
+
+      # : (?String?) -> String?
+      def command: (?String?) -> String?
+
+      # : (?String?) -> String?
+      def description: (?String?) -> String?
+
+      # : (?String?) -> String?
+      def prompt: (?String?) -> String?
+
+      private
+
+      # : () -> void
+      def validate!: () -> void
+    end
+  end
+end

data/sig/generated/diogenes.rbs

@@ -17,10 +17,37 @@ module Diogenes
   class UserError < Error
   end
 
-  # Returns the version of the Diogenes gem.
-  #
-  # This is managed by the release-please workflow.
-  # --
+  # Raised when a DSL definition is missing required fields.
+  class ConfigurationError < Error
+  end
+
   # : () -> String
   def self.version: () -> String
+
+  # : (String) { () -> void } -> DSL::Skill
+  def self.skill: (String) { () -> void } -> DSL::Skill
+
+  # : (String) { () -> void } -> DSL::Rule
+  def self.rule: (String) { () -> void } -> DSL::Rule
+
+  # : (String) { () -> void } -> DSL::Hook
+  def self.hook: (String) { () -> void } -> DSL::Hook
+
+  # : (String) { () -> void } -> DSL::Artifact
+  def self.artifact: (String) { () -> void } -> DSL::Artifact
+
+  # : () -> Array[DSL::Skill]
+  def self.skills: () -> Array[DSL::Skill]
+
+  # : () -> Array[DSL::Rule]
+  def self.rules: () -> Array[DSL::Rule]
+
+  # : () -> Array[DSL::Hook]
+  def self.hooks: () -> Array[DSL::Hook]
+
+  # : () -> Array[DSL::Artifact]
+  def self.artifacts: () -> Array[DSL::Artifact]
+
+  # : () -> void
+  def self.reset!: () -> void
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: diogenes
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Meagan Waller
@@ -56,6 +56,10 @@ files:
 - lib/diogenes.rb
 - lib/diogenes/cli.rb
 - lib/diogenes/cli/init.rb
+- lib/diogenes/dsl/artifact.rb
+- lib/diogenes/dsl/hook.rb
+- lib/diogenes/dsl/rule.rb
+- lib/diogenes/dsl/skill.rb
 - lib/diogenes/templates/init/artifacts/decision_record.md.erb
 - lib/diogenes/templates/init/diogenes.rb
 - lib/diogenes/templates/init/hooks/README.md
@@ -66,6 +70,10 @@ files:
 - sig/generated/diogenes.rbs
 - sig/generated/diogenes/cli.rbs
 - sig/generated/diogenes/cli/init.rbs
+- sig/generated/diogenes/dsl/artifact.rbs
+- sig/generated/diogenes/dsl/hook.rbs
+- sig/generated/diogenes/dsl/rule.rbs
+- sig/generated/diogenes/dsl/skill.rbs
 - sig/generated/diogenes/version.rbs
 homepage: https://github.com/meaganewaller/diogenes/tree/main/diogenes
 licenses: