diogenes 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59e0697472a007da996d52c2c52049bd875d48a06bb4c9747e87d60aeb81977f
-  data.tar.gz: 9802457c4c57f7fbf9aa78a97026c96b862138e2d1f4d00fe07a6ceabf174009
+  metadata.gz: 6afa2ba374311b5556d89936cb4939e408f607fc94c422d79e32198701ed66ca
+  data.tar.gz: e96686ce7eae01d70e95b9a7a816e5d68421358be2636f71c0beaa943996205d
 SHA512:
-  metadata.gz: be715cb566e8eb48fad63ee0a0c4b4c53d5907a45d93b6f8366fd1a5aa2b6966b37f80d88fbe6ab64789d0756b290c82d8b4dfebb00b06568a9d48a15c09d7af
-  data.tar.gz: 743a2837f4d2a4e6f97942d36956dc08f2b69507c04e3ea19e56e33159fb75f65263c0f92e3c8429c14a75b37ba8b8fdf4c1aff1d769e85e04797f5a38915429
+  metadata.gz: 1dc1a3434a2799bdce07985ba7b1084acfa5c11069ed149c65c1d7c7cbe7156a2caed421c9abd923a57951c6878fe602767281233541fc7e2cc8400bafec8167
+  data.tar.gz: b39b504cffdf7788596eecbd62da2b479d9e8f5cb849a1097106415663e490ad3427d3dcfe7e97ddccb925aa583ee466b4e609f2b6508bb427e57295dcad6c3d

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-    ".": "0.1.8"
+    ".": "0.1.9"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.1.9](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.8...diogenes/v0.1.9) (2026-06-27)
+
+
+### Features
+
+* **validate:** add diogenes validate command :mag: ([#17](https://github.com/meaganewaller/diogenes/issues/17)) ([0bbdb93](https://github.com/meaganewaller/diogenes/commit/0bbdb9359c9c6ba3444623dba2d569f294b82988))
+
 ## [0.1.8](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.7...diogenes/v0.1.8) (2026-06-27)
 
 

data/lib/diogenes/cli/validate.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  class Cli
+    class Validate
+      DIOGENES_DIR = ".diogenes" #: String
+
+      #: (argv: Array[String], cwd: String, out: IO, err: IO, **untyped) -> Integer
+      def self.run(argv:, cwd:, out:, err:, **_opts)
+        new(argv:, cwd:, out:, err:).run
+      end
+
+      #: (argv: Array[String], cwd: String, out: IO, err: IO) -> void
+      def initialize(argv:, cwd:, out:, err:)
+        @argv = argv #: Array[String]
+        @cwd = cwd #: String
+        @out = out #: IO
+        @err = err #: IO
+      end
+
+      #: () -> Integer
+      def run
+        diogenes_dir = File.join(@cwd, DIOGENES_DIR)
+        unless Dir.exist?(diogenes_dir)
+          @err.puts "No #{DIOGENES_DIR}/ found. Run `diogenes init` first."
+          return 1
+        end
+
+        @out.puts "Validating #{DIOGENES_DIR}/ sources..."
+        @out.puts
+
+        issues = Diogenes::Validate::Runner.new(diogenes_dir).run
+        errors = issues.select(&:error?)
+        warnings = issues.select(&:warning?)
+
+        if errors.empty? && warnings.empty?
+          @out.puts "✓ All sources valid. Ready to build."
+          return 0
+        end
+
+        issues.each { |issue| @out.puts issue.to_s }
+        @out.puts
+
+        if errors.empty?
+          @out.puts "#{warnings.size} warning#{"s" unless warnings.size == 1} found."
+          0
+        else
+          parts = ["#{errors.size} error#{"s" unless errors.size == 1}"]
+          parts << "#{warnings.size} warning#{"s" unless warnings.size == 1}" if warnings.any?
+          @out.puts "#{parts.join(", ")} found."
+          1
+        end
+      end
+    end
+  end
+end

data/lib/diogenes/cli.rb

@@ -4,13 +4,15 @@
 require_relative "cli/init"
 require_relative "cli/build"
 require_relative "cli/evaluate"
+require_relative "cli/validate"
 
 module Diogenes
   class Cli
     COMMANDS = {
       "init" => Init,
       "build" => Build,
-      "evaluate" => Evaluate
+      "evaluate" => Evaluate,
+      "validate" => Validate
     }.freeze #: Hash[String, Class]
 
     #: (?Array[String] argv, ?out: IO, ?err: IO, **untyped) -> Integer

data/lib/diogenes/validate/issue.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Validate
+    Issue = Struct.new(:severity, :file, :message, keyword_init: true) do
+      #: () -> bool
+      def error? = severity == :error
+
+      #: () -> bool
+      def warning? = severity == :warning
+
+      #: () -> String
+      def to_s
+        tag = error? ? "ERROR" : " WARN"
+        file ? "  #{tag}  #{file} — #{message}" : "  #{tag}  #{message}"
+      end
+    end
+  end
+end

data/lib/diogenes/validate/runner.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+module Diogenes
+  module Validate
+    class Runner
+      SOURCE_SUBDIRS = %w[skills rules hooks].freeze #: Array[String]
+      ARTIFACTS_SUBDIR = "artifacts" #: String
+      TOKENS_PER_CHAR = 4.0 #: Float
+      PROMPT_TOKEN_LIMIT = 2000 #: Integer
+
+      #: (String) -> void
+      def initialize(diogenes_dir)
+        @diogenes_dir = diogenes_dir #: String
+        @issues = [] #: Array[Validate::Issue]
+      end
+
+      #: () -> Array[Validate::Issue]
+      def run
+        Diogenes.reset!
+        load_config
+        load_sources
+        check_artifact_templates
+        check_prompt_lengths
+        @issues
+      end
+
+      private
+
+      #: () -> void
+      def load_config
+        config = File.join(@diogenes_dir, "diogenes.rb")
+        return unless File.exist?(config)
+
+        load_file(config)
+      end
+
+      #: () -> void
+      def load_sources
+        SOURCE_SUBDIRS.each do |subdir|
+          Dir.glob(File.join(@diogenes_dir, subdir, "**/*.rb")).sort.each do |file|
+            load_file(file)
+          end
+        end
+      end
+
+      #: (String) -> void
+      def load_file(path)
+        load path
+      rescue StandardError, SyntaxError => e
+        @issues << Issue.new(severity: :error, file: relative(path), message: e.message)
+      end
+
+      #: () -> void
+      def check_artifact_templates
+        Diogenes.artifacts.each do |artifact|
+          next unless artifact.template
+
+          template_path = File.join(@diogenes_dir, ARTIFACTS_SUBDIR, artifact.template)
+          next if File.exist?(template_path)
+
+          @issues << Issue.new(
+            severity: :error,
+            file: nil,
+            message: "Artifact #{artifact.name.inspect} references template " \
+                     "#{artifact.template.inspect} which does not exist in " \
+                     ".diogenes/#{ARTIFACTS_SUBDIR}/"
+          )
+        end
+      end
+
+      #: () -> void
+      def check_prompt_lengths
+        promptable_items.each do |type, name, prompt|
+          next unless prompt
+
+          estimated = (prompt.length / TOKENS_PER_CHAR).round
+          next unless estimated > PROMPT_TOKEN_LIMIT
+
+          @issues << Issue.new(
+            severity: :warning,
+            file: nil,
+            message: "#{type} #{name.inspect} prompt is ~#{estimated} tokens " \
+                     "(exceeds #{PROMPT_TOKEN_LIMIT} token guideline)"
+          )
+        end
+      end
+
+      #: () -> Array[[String, String, String?]]
+      def promptable_items
+        skills = Diogenes.skills.map { |s| ["Skill", s.name, s.prompt] }
+        hooks = Diogenes.hooks.map { |h| ["Hook", h.name, h.prompt] }
+        skills + hooks
+      end
+
+      #: (String) -> String
+      def relative(path)
+        path.delete_prefix("#{@diogenes_dir}/")
+      end
+    end
+  end
+end

data/lib/diogenes/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: diogenes
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Meagan Waller
@@ -67,6 +67,7 @@ files:
 - lib/diogenes/cli/build.rb
 - lib/diogenes/cli/evaluate.rb
 - lib/diogenes/cli/init.rb
+- lib/diogenes/cli/validate.rb
 - lib/diogenes/configuration.rb
 - lib/diogenes/dsl/artifact.rb
 - lib/diogenes/dsl/hook.rb
@@ -89,6 +90,8 @@ files:
 - lib/diogenes/templates/init/hooks/README.md
 - lib/diogenes/templates/init/rules/five_gates.rb
 - lib/diogenes/templates/init/skills/example_skill.rb
+- lib/diogenes/validate/issue.rb
+- lib/diogenes/validate/runner.rb
 - lib/diogenes/version.rb
 - sig/diogenes.rbs
 - sig/generated/diogenes.rbs