diogenes 0.1.5 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00c7fad965257b62e461fbd2ae43db54c10bb7cc6c93d454cb2563ae1c6eb6a8
-  data.tar.gz: 69e47cf048ce0a2d31036ad803ebefcb0cf66bb6d6417ca517d2dc6cc52343d5
+  metadata.gz: a7437b70a7659349d8486c0f1e5c6cf7a6735b120e1710cb94d3dacf05ba85b8
+  data.tar.gz: ffeee3838b29625af1f2f07f55459fd96d1678cfa2e161160433d818c36826fb
 SHA512:
-  metadata.gz: f3a0ad8ca1f41be1e4edfe1fe38552d954ecdf1d5d2dc6e417c713be956673c2ae67b0781fdb5720b693c9aab999b8a31c9b0eac55ccec5e16a3eb392c0decec
-  data.tar.gz: 42b1551a1bb754c6252d9fa0d04cdc0894251ac76f38656c9c1ae003d5854d59e816f4de3823fca4f2056a97d6a7b8b41026e112be6fa1b3a8ffbb8ecdac2164
+  metadata.gz: 8c533c33b568af4710da44f2ca825710bfed3c6d7ccfa4956303183817b36aca7facb46b469e3081998ce0ca4b21a01f61e12dcaaace3f711db5d2feb4721faa
+  data.tar.gz: 10ab65d16346cd75fb17f1c6e9a1fbbae742ce12a62255eb5e2845a2d65840c58510f15a5da9df6c439c29f02a66b5aae00d7ae768180c7d800d0f5b271235d5

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-    ".": "0.1.5"
+    ".": "0.1.6"
 }

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## [Unreleased]
 
+## [0.1.6](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.5...diogenes/v0.1.6) (2026-06-27)
+
+
+### Features
+
+* **evaluate:** generate decision record artifact after gate evaluation :rocket: ([#11](https://github.com/meaganewaller/diogenes/issues/11)) ([14d9ac2](https://github.com/meaganewaller/diogenes/commit/14d9ac2a12d4c61378c442a833d878bdf62ebc0b))
+
 ## [0.1.5](https://github.com/meaganewaller/diogenes/compare/diogenes/v0.1.4...diogenes/v0.1.5) (2026-06-27)
 
 

data/lib/diogenes/evaluation/decision_record.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+# rbs_inline: enabled
+
+require "erb"
+require "date"
+require "fileutils"
+
+module Diogenes
+  module Evaluation
+    class DecisionRecord
+      DEFAULT_OUTPUT_DIR = "docs/decisions" #: String
+      BUNDLED_TEMPLATE = File.expand_path("../templates/init/artifacts/decision_record.md.erb", __dir__).freeze #: String
+      PROJECT_TEMPLATE = ".diogenes/artifacts/decision_record.md.erb" #: String
+
+      #: (description: String, results: Array[untyped], evaluator: String, ?output_dir: String) -> void
+      def initialize(description:, results:, evaluator:, output_dir: DEFAULT_OUTPUT_DIR)
+        @description = description
+        @results = results
+        @evaluator = evaluator
+        @output_dir = output_dir
+        @alternative = "" #: String
+        @conditions = "" #: String
+        @notes = "" #: String
+      end
+
+      attr_writer :alternative #: String
+      attr_writer :conditions #: String
+      attr_writer :notes #: String
+
+      #: () -> String
+      def verdict
+        @verdict ||= @results.all?(&:passed?) ? "PROCEED" : "REJECT"
+      end
+
+      #: (String) -> void
+      attr_writer :verdict
+
+      #: () -> String
+      def filename
+        "#{slugify(@description)}_decision.md"
+      end
+
+      #: (cwd: String) -> String
+      def write(cwd:)
+        dir = File.join(cwd, @output_dir)
+        FileUtils.mkdir_p(dir)
+        path = File.join(dir, filename)
+        File.write(path, render(cwd:))
+        path
+      end
+
+      private
+
+      #: (cwd: String) -> String
+      def render(cwd:)
+        ctx = RenderContext.new(
+          feature_name: @description,
+          evaluator: @evaluator,
+          verdict: verdict,
+          results: @results,
+          alternative: @alternative,
+          conditions: @conditions,
+          notes: @notes
+        )
+        ERB.new(read_template(cwd:), trim_mode: "-").result(ctx.get_binding)
+      end
+
+      #: (cwd: String) -> String
+      def read_template(cwd:)
+        project = File.join(cwd, PROJECT_TEMPLATE)
+        File.read(File.exist?(project) ? project : BUNDLED_TEMPLATE)
+      end
+
+      #: (String) -> String
+      def slugify(text)
+        text.strip.downcase.gsub(/[^a-z0-9]+/, "_").gsub(/\A_+|_+\z/, "")
+      end
+
+      class RenderContext
+        #: (feature_name: String, evaluator: String, verdict: String, results: Array[untyped], alternative: String, conditions: String, notes: String) -> void
+        def initialize(feature_name:, evaluator:, verdict:, results:, alternative:, conditions:, notes:)
+          @feature_name = feature_name
+          @evaluator = evaluator
+          @verdict = verdict
+          @results = results
+          @alternative = alternative
+          @conditions = conditions
+          @notes = notes
+        end
+
+        attr_reader :feature_name
+        def feature_slug = @feature_name.strip.downcase.gsub(/[^a-z0-9]+/, "_").gsub(/\A_+|_+\z/, "")
+        attr_reader :evaluator
+        attr_reader :verdict
+        attr_reader :alternative
+        attr_reader :conditions
+        attr_reader :notes
+
+        #: (Symbol) -> String
+        def gate_result(key)
+          r = @results.find { |res| res.gate.key == key }
+          return "not evaluated" unless r
+          r.passed? ? "PASS" : "FAIL"
+        end
+
+        #: (Symbol) -> String
+        def gate_reason(key)
+          r = @results.find { |res| res.gate.key == key }
+          return "not evaluated" unless r
+          r.passed? ? "Confirmed" : "Not confirmed"
+        end
+
+        def get_binding = binding
+      end
+    end
+  end
+end

data/lib/diogenes/evaluation/session.rb

@@ -17,6 +17,7 @@ module Diogenes
         @out = out
         @err = err
         @in = opts.fetch(:in, $stdin)
+        @cwd = opts.fetch(:cwd, Dir.pwd) #: String
         @results = [] #: Array[untyped]
       end
 
@@ -82,11 +83,48 @@ module Diogenes
 
       #: () -> void
       def prompt_decision_record
-        if ask_yes_no("Generate a decision record? (Y/n)")
-          @out.puts "  Decision record generation is coming in the next release."
+        return unless ask_yes_no("Generate a decision record?")
+
+        record = DecisionRecord.new(
+          description: @description,
+          results: @results,
+          evaluator: detect_evaluator
+        )
+
+        collect_failure_details(record) if @results.any?(&:failed?)
+
+        path = record.write(cwd: @cwd)
+        @out.puts "  Decision record written to #{path}"
+      end
+
+      #: (DecisionRecord) -> void
+      def collect_failure_details(record)
+        @out.puts
+        @out.puts "  One or more gates failed. How should this be recorded?"
+        @out.puts "    [1] REJECT — this feature should not use AI"
+        @out.puts "    [2] PROCEED WITH CONDITIONS — proceeding with documented mitigations"
+        @out.print "  Your choice (default: 1): "
+        choice = @in.gets&.strip
+
+        if choice == "2"
+          record.verdict = "PROCEED WITH CONDITIONS"
+          @out.print "  Describe the conditions or mitigations: "
+          record.conditions = @in.gets&.strip || ""
+        else
+          record.verdict = "REJECT"
+          @out.print "  Describe the recommended software alternative: "
+          record.alternative = @in.gets&.strip || ""
         end
       end
 
+      #: () -> String
+      def detect_evaluator
+        name = `git config user.name 2>/dev/null`.strip
+        name.empty? ? ENV.fetch("USER", "Unknown") : name
+      rescue Errno::ENOENT
+        ENV.fetch("USER", "Unknown")
+      end
+
       #: (String) -> bool
       def ask_yes_no(question)
         @out.print "  #{question} "

data/lib/diogenes/templates/init/artifacts/decision_record.md.erb

@@ -1,53 +1,44 @@
-# frozen_string_literal: true
+# AI Feature Decision Record
 
-Diogenes.artifact "decision_record" do
-  description "Decision record produced by gate evaluation"
-  filename "<%= feature_slug %>_decision.md"
+**Feature:** <%= feature_name %>
+**Date:** <%= Date.today.strftime("%Y-%m-%d") %>
+**Evaluator:** <%= evaluator %>
+**Verdict:** <%= verdict %>
 
-  template <<~TEMPLATE
-    # AI Feature Decision Record
+---
 
-    **Feature:** <%= feature_name %>
-    **Date:** <%= Date.today.strftime("%Y-%m-%d") %>
-    **Evaluator:** <%= evaluator %>
-    **Verdict:** <%= verdict %>
+## Gate Results
 
-    ---
+| Gate | Principle | Result | Reason |
+|------|-----------|--------|--------|
+| Failure Mode | Least surprise at scale | <%= gate_result(:failure_mode) %> | <%= gate_reason(:failure_mode) %> |
+| User Verifiable | Trust requires verification | <%= gate_result(:user_verifiable) %> | <%= gate_reason(:user_verifiable) %> |
+| Human in the Loop | Human-centered design, genuinely | <%= gate_result(:human_in_loop) %> | <%= gate_reason(:human_in_loop) %> |
+| Observability | Craftsmanship — you wouldn't ship blind | <%= gate_result(:observability) %> | <%= gate_reason(:observability) %> |
+| Right Tool | Convention over configuration | <%= gate_result(:right_tool) %> | <%= gate_reason(:right_tool) %> |
 
-    ## Gate Results
+---
 
-    | Gate | Principle | Result | Reason |
-    |------|-----------|--------|--------|
-    | 1. Failure Mode | Least surprise at scale | <%= gate_result(:failure_mode) %> | <%= gate_reason(:failure_mode) %> |
-    | 2. User Verifiable | Trust requires verification | <%= gate_result(:user_verifiable) %> | <%= gate_reason(:user_verifiable) %> |
-    | 3. Human in Loop | Human-centered, genuinely | <%= gate_result(:human_in_loop) %> | <%= gate_reason(:human_in_loop) %> |
-    | 4. Observability | Craftsmanship | <%= gate_result(:observability) %> | <%= gate_reason(:observability) %> |
-    | 5. Right Tool | Convention over configuration | <%= gate_result(:right_tool) %> | <%= gate_reason(:right_tool) %> |
+## Verdict: <%= verdict %>
 
-    ---
+<% if verdict == "REJECT" || verdict == "PROCEED WITH CONDITIONS" -%>
+### Recommended Alternative or Mitigation
 
-    ## Verdict: <%= verdict %>
+<%= alternative.empty? ? "_No alternative or mitigation described._" : alternative %>
 
-    <% if verdict == "REJECT" || verdict == "PROCEED WITH CONDITIONS" %>
-    ## Recommended Alternative or Mitigation
+<% end -%>
+<% if verdict == "PROCEED WITH CONDITIONS" -%>
+### Conditions for Proceeding
 
-    <%= alternative %>
-    <% end %>
+<%= conditions.empty? ? "_No conditions specified._" : conditions %>
 
-    <% if verdict == "PROCEED" || verdict == "PROCEED WITH CONDITIONS" %>
-    ## Conditions for Proceeding
+<% end -%>
+---
 
-    <%= conditions.empty? ? "None — all gates passed." : conditions %>
-    <% end %>
+## Notes
 
-    ---
+<%= notes.empty? ? "_No additional notes._" : notes %>
 
-    ## Notes
+---
 
-    <%= notes.empty? ? "_No additional notes._" : notes %>
-
-    ---
-
-    *Generated by [Diogenes](https://github.com/meaganewaller/diogenes)*
-  TEMPLATE
-end
+*Generated by [Diogenes](https://github.com/meaganewaller/diogenes)*

data/lib/diogenes/version.rb

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

data/sig/generated/diogenes/evaluation/decision_record.rbs

@@ -0,0 +1,72 @@
+# Generated from lib/diogenes/evaluation/decision_record.rb with RBS::Inline
+
+module Diogenes
+  module Evaluation
+    class DecisionRecord
+      DEFAULT_OUTPUT_DIR: String
+
+      BUNDLED_TEMPLATE: String
+
+      PROJECT_TEMPLATE: String
+
+      # : (description: String, results: Array[untyped], evaluator: String, ?output_dir: String) -> void
+      def initialize: (description: String, results: Array[untyped], evaluator: String, ?output_dir: String) -> void
+
+      attr_writer alternative: String
+
+      attr_writer conditions: String
+
+      attr_writer notes: String
+
+      # : () -> String
+      def verdict: () -> String
+
+      # : (String) -> void
+      attr_writer verdict: untyped
+
+      # : () -> String
+      def filename: () -> String
+
+      # : (cwd: String) -> String
+      def write: (cwd: String) -> String
+
+      private
+
+      # : (cwd: String) -> String
+      def render: (cwd: String) -> String
+
+      # : (cwd: String) -> String
+      def read_template: (cwd: String) -> String
+
+      # : (String) -> String
+      def slugify: (String) -> String
+
+      class RenderContext
+        # : (feature_name: String, evaluator: String, verdict: String, results: Array[untyped], alternative: String, conditions: String, notes: String) -> void
+        def initialize: (feature_name: String, evaluator: String, verdict: String, results: Array[untyped], alternative: String, conditions: String, notes: String) -> void
+
+        attr_reader feature_name: untyped
+
+        def feature_slug: () -> untyped
+
+        attr_reader evaluator: untyped
+
+        attr_reader verdict: untyped
+
+        attr_reader alternative: untyped
+
+        attr_reader conditions: untyped
+
+        attr_reader notes: untyped
+
+        # : (Symbol) -> String
+        def gate_result: (Symbol) -> String
+
+        # : (Symbol) -> String
+        def gate_reason: (Symbol) -> String
+
+        def get_binding: () -> untyped
+      end
+    end
+  end
+end

data/sig/generated/diogenes/evaluation/session.rbs

@@ -34,6 +34,12 @@ module Diogenes
       # : () -> void
       def prompt_decision_record: () -> void
 
+      # : (DecisionRecord) -> void
+      def collect_failure_details: (DecisionRecord) -> void
+
+      # : () -> String
+      def detect_evaluator: () -> String
+
       # : (String) -> bool
       def ask_yes_no: (String) -> bool
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: diogenes
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors:
 - Meagan Waller
@@ -61,6 +61,7 @@ files:
 - lib/diogenes/dsl/hook.rb
 - lib/diogenes/dsl/rule.rb
 - lib/diogenes/dsl/skill.rb
+- lib/diogenes/evaluation/decision_record.rb
 - lib/diogenes/evaluation/gate.rb
 - lib/diogenes/evaluation/gates.rb
 - lib/diogenes/evaluation/session.rb
@@ -79,6 +80,7 @@ files:
 - sig/generated/diogenes/dsl/hook.rbs
 - sig/generated/diogenes/dsl/rule.rbs
 - sig/generated/diogenes/dsl/skill.rbs
+- sig/generated/diogenes/evaluation/decision_record.rbs
 - sig/generated/diogenes/evaluation/gate.rbs
 - sig/generated/diogenes/evaluation/gates.rbs
 - sig/generated/diogenes/evaluation/session.rbs