rubyn-code 0.1.0 → 0.2.0

data/lib/rubyn_code/hooks/user_hooks.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "yaml"
+require 'yaml'
 
 module RubynCode
   module Hooks
@@ -26,8 +26,8 @@ module RubynCode
       # @return [void]
       def self.load!(registry, project_root:)
         paths = [
-          File.join(project_root, ".rubyn-code", "hooks.yml"),
-          File.join(Config::Defaults::HOME_DIR, "hooks.yml")
+          File.join(project_root, '.rubyn-code', 'hooks.yml'),
+          File.join(Config::Defaults::HOME_DIR, 'hooks.yml')
         ]
 
         paths.each do |path|
@@ -42,8 +42,8 @@ module RubynCode
         private
 
         def register_hooks(registry, config)
-          register_pre_tool_use_hooks(registry, config["pre_tool_use"] || [])
-          register_post_tool_use_hooks(registry, config["post_tool_use"] || [])
+          register_pre_tool_use_hooks(registry, config['pre_tool_use'] || [])
+          register_post_tool_use_hooks(registry, config['post_tool_use'] || [])
         end
 
         def register_pre_tool_use_hooks(registry, hook_configs)
@@ -51,9 +51,9 @@ module RubynCode
             registry.on(:pre_tool_use) do |tool_name:, tool_input:, **|
               next unless matches?(hook_config, tool_name, tool_input)
 
-              case hook_config["action"]
-              when "deny"
-                { deny: true, reason: hook_config["reason"] || "Blocked by hooks.yml" }
+              case hook_config['action']
+              when 'deny'
+                { deny: true, reason: hook_config['reason'] || 'Blocked by hooks.yml' }
               end
             end
           end
@@ -62,12 +62,12 @@ module RubynCode
         def register_post_tool_use_hooks(registry, hook_configs)
           hook_configs.each do |hook_config|
             registry.on(:post_tool_use) do |tool_name:, result:, **|
-              next result unless hook_config["tool"].nil? || hook_config["tool"] == tool_name
+              next result unless hook_config['tool'].nil? || hook_config['tool'] == tool_name
 
-              if hook_config["action"] == "log"
-                log_dir = ".rubyn-code"
-                FileUtils.mkdir_p(log_dir) unless Dir.exist?(log_dir)
-                File.open(File.join(log_dir, "audit.log"), "a") do |f|
+              if hook_config['action'] == 'log'
+                log_dir = '.rubyn-code'
+                FileUtils.mkdir_p(log_dir)
+                File.open(File.join(log_dir, 'audit.log'), 'a') do |f|
                   f.puts "[#{Time.now}] #{tool_name}: #{result.to_s[0..200]}"
                 end
               end
@@ -78,9 +78,9 @@ module RubynCode
         end
 
         def matches?(config, tool_name, params)
-          return false if config["tool"] && config["tool"] != tool_name
-          return false if config["match"] && !params.to_s.include?(config["match"])
-          return false if config["path"] && !File.fnmatch?(config["path"], params[:path].to_s)
+          return false if config['tool'] && config['tool'] != tool_name
+          return false if config['match'] && !params.to_s.include?(config['match'])
+          return false if config['path'] && !File.fnmatch?(config['path'], params[:path].to_s)
 
           true
         end

data/lib/rubyn_code/learning/RUBYN.md

@@ -0,0 +1,16 @@
+# Layer 16: Learning
+
+Continuous learning from session patterns with confidence decay.
+
+## Classes
+
+- **`Extractor`** — Post-session analysis using a cheaper LLM (Haiku). Scans the last 30
+  messages for patterns: error resolutions, user corrections, workarounds, debugging
+  techniques, project-specific conventions. Persists as instincts.
+
+- **`Instinct`** — A learned pattern with a confidence score that decays over time.
+  Stored in the `instincts` SQLite table. Higher confidence = more likely to be injected
+  into future prompts.
+
+- **`Injector`** — Selects relevant instincts (confidence >= 0.3, max 10) and injects
+  them into the system prompt for the current session. Filters by project context.

data/lib/rubyn_code/learning/extractor.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-require "json"
-require "securerandom"
+require 'json'
+require 'securerandom'
 
 module RubynCode
   module Learning
@@ -23,7 +23,7 @@ module RubynCode
         project_specific
       ].freeze
 
-      EXTRACTION_PROMPT = <<~PROMPT
+      EXTRACTION_PROMPT = <<~PROMPT.freeze
         Analyze the following conversation between a developer and an AI coding assistant.
         Extract reusable patterns that could help in future sessions for this project.
 
@@ -75,22 +75,22 @@ module RubynCode
         def request_extraction(messages, llm_client)
           # Serialize conversation into a single user message to avoid
           # "must end with user message" errors
-          transcript = messages.map { |m|
-            role = (m[:role] || m["role"] || "unknown").capitalize
-            content = m[:content] || m["content"]
+          transcript = messages.map do |m|
+            role = (m[:role] || m['role'] || 'unknown').capitalize
+            content = m[:content] || m['content']
             text = case content
                    when String then content
                    when Array
-                     content.filter_map { |b|
-                       b.respond_to?(:text) ? b.text : (b[:text] || b["text"])
-                     }.join("\n")
+                     content.filter_map do |b|
+                       b.respond_to?(:text) ? b.text : (b[:text] || b['text'])
+                     end.join("\n")
                    else content.to_s
                    end
             "#{role}: #{text}"
-          }.join("\n\n")
+          end.join("\n\n")
 
           llm_client.chat(
-            messages: [{ role: "user", content: "#{EXTRACTION_PROMPT}\n\nConversation:\n#{transcript}" }],
+            messages: [{ role: 'user', content: "#{EXTRACTION_PROMPT}\n\nConversation:\n#{transcript}" }],
             max_tokens: 2000
           )
         rescue StandardError => e
@@ -104,7 +104,7 @@ module RubynCode
 
           instincts.each do |inst|
             db.execute(
-              "INSERT INTO instincts (id, project_path, pattern, context_tags, confidence, decay_rate, times_applied, times_helpful, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
+              'INSERT INTO instincts (id, project_path, pattern, context_tags, confidence, decay_rate, times_applied, times_helpful, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
               [
                 SecureRandom.uuid,
                 inst[:project_path],
@@ -147,15 +147,15 @@ module RubynCode
             block = response.content.find { |b| b.respond_to?(:text) }
             block&.text
           elsif response.is_a?(Hash)
-            response.dig("content", 0, "text")
+            response.dig('content', 0, 'text')
           end
         end
 
         def normalize_pattern(raw, project_path)
-          type = raw["type"].to_s
-          pattern = raw["pattern"].to_s.strip
-          context_tags = Array(raw["context_tags"]).map(&:to_s)
-          confidence = raw["confidence"].to_f
+          type = raw['type'].to_s
+          pattern = raw['pattern'].to_s.strip
+          context_tags = Array(raw['context_tags']).map(&:to_s)
+          confidence = raw['confidence'].to_f
 
           return nil if pattern.empty?
           return nil unless VALID_TYPES.include?(type)
@@ -177,11 +177,11 @@ module RubynCode
         # Project-specific knowledge decays slower; workarounds decay faster.
         def decay_rate_for_type(type)
           case type
-          when "project_specific"     then 0.02
-          when "error_resolution"     then 0.03
-          when "debugging_technique"  then 0.04
-          when "user_correction"      then 0.05
-          when "workaround"           then 0.07
+          when 'project_specific'     then 0.02
+          when 'error_resolution'     then 0.03
+          when 'debugging_technique'  then 0.04
+          when 'user_correction'      then 0.05
+          when 'workaround'           then 0.07
           else 0.05
           end
         end

data/lib/rubyn_code/learning/injector.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require "json"
-require "time"
-require "set"
+require 'json'
+require 'time'
 
 module RubynCode
   module Learning
@@ -15,7 +14,7 @@ module RubynCode
       # Default maximum number of instincts to inject.
       DEFAULT_MAX_INSTINCTS = 10
 
-      INSTINCTS_TABLE = "instincts"
+      INSTINCTS_TABLE = 'instincts'
 
       class << self
         # Queries and formats relevant instincts for system prompt injection.
@@ -27,7 +26,7 @@ module RubynCode
         # @return [String] formatted instincts block, or empty string if none found
         def call(db:, project_path:, context_tags: [], max_instincts: DEFAULT_MAX_INSTINCTS)
           rows = fetch_instincts(db, project_path)
-          return "" if rows.empty?
+          return '' if rows.empty?
 
           instincts = rows.map { |row| row_to_instinct(row) }
 
@@ -46,7 +45,7 @@ module RubynCode
                       .sort_by { |inst| -inst.confidence }
                       .first(max_instincts)
 
-          return "" if instincts.empty?
+          return '' if instincts.empty?
 
           format_instincts(instincts)
         end
@@ -65,16 +64,16 @@ module RubynCode
 
         def row_to_instinct(row)
           Instinct.new(
-            id: row["id"],
-            project_path: row["project_path"],
-            pattern: row["pattern"],
-            context_tags: parse_tags(row["context_tags"]),
-            confidence: row["confidence"].to_f,
-            decay_rate: row["decay_rate"].to_f,
-            times_applied: row["times_applied"].to_i,
-            times_helpful: row["times_helpful"].to_i,
-            created_at: parse_time(row["created_at"]),
-            updated_at: parse_time(row["updated_at"])
+            id: row['id'],
+            project_path: row['project_path'],
+            pattern: row['pattern'],
+            context_tags: parse_tags(row['context_tags']),
+            confidence: row['confidence'].to_f,
+            decay_rate: row['decay_rate'].to_f,
+            times_applied: row['times_applied'].to_i,
+            times_helpful: row['times_helpful'].to_i,
+            created_at: parse_time(row['created_at']),
+            updated_at: parse_time(row['updated_at'])
           )
         end
 
@@ -84,7 +83,7 @@ module RubynCode
             begin
               JSON.parse(tags)
             rescue JSON::ParserError
-              tags.split(",").map(&:strip)
+              tags.split(',').map(&:strip)
             end
           when Array
             tags
@@ -111,7 +110,7 @@ module RubynCode
         # @param tags [Array<String>] required context tags
         # @return [Array<Instinct>] filtered instincts
         def filter_by_tags(instincts, tags)
-          tag_set = tags.map(&:downcase).to_set
+          tag_set = tags.to_set(&:downcase)
 
           instincts.select do |inst|
             inst_tags = inst.context_tags.map(&:downcase)

data/lib/rubyn_code/learning/instinct.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "time"
+require 'time'
 
 module RubynCode
   module Learning
@@ -44,10 +44,10 @@ module RubynCode
 
       # Confidence label thresholds, checked in descending order.
       CONFIDENCE_LABELS = [
-        [0.9, "near-certain"],
-        [0.7, "confident"],
-        [0.5, "moderate"],
-        [0.3, "tentative"]
+        [0.9, 'near-certain'],
+        [0.7, 'confident'],
+        [0.5, 'moderate'],
+        [0.3, 'tentative']
       ].freeze
 
       class << self
@@ -105,7 +105,7 @@ module RubynCode
             return label if score >= threshold
           end
 
-          "unreliable"
+          'unreliable'
         end
 
         # Reinforces an instinct in the database by updating confidence
@@ -120,7 +120,7 @@ module RubynCode
 
           if helpful
             db.execute(
-              "UPDATE instincts SET confidence = MIN(1.0, confidence + 0.1 * (1.0 - confidence)), times_applied = times_applied + 1, times_helpful = times_helpful + 1, updated_at = ? WHERE id = ?",
+              'UPDATE instincts SET confidence = MIN(1.0, confidence + 0.1 * (1.0 - confidence)), times_applied = times_applied + 1, times_helpful = times_helpful + 1, updated_at = ? WHERE id = ?',
               [now, instinct_id]
             )
           else
@@ -141,25 +141,29 @@ module RubynCode
         # @return [void]
         def decay_all(db, project_path:)
           rows = db.query(
-            "SELECT id, confidence, decay_rate, updated_at FROM instincts WHERE project_path = ?",
+            'SELECT id, confidence, decay_rate, updated_at FROM instincts WHERE project_path = ?',
             [project_path]
           ).to_a
 
           now = Time.now
           rows.each do |row|
-            updated_at = Time.parse(row["updated_at"].to_s) rescue Time.now
+            updated_at = begin
+              Time.parse(row['updated_at'].to_s)
+            rescue StandardError
+              Time.now
+            end
             elapsed_days = (now - updated_at).to_f / 86_400
             next if elapsed_days <= 0
 
-            decay_factor = Math.exp(-row["decay_rate"].to_f * elapsed_days)
-            new_confidence = (row["confidence"].to_f * decay_factor).clamp(MIN_CONFIDENCE, 1.0)
+            decay_factor = Math.exp(-row['decay_rate'].to_f * elapsed_days)
+            new_confidence = (row['confidence'].to_f * decay_factor).clamp(MIN_CONFIDENCE, 1.0)
 
             if new_confidence <= MIN_CONFIDENCE
-              db.execute("DELETE FROM instincts WHERE id = ?", [row["id"]])
+              db.execute('DELETE FROM instincts WHERE id = ?', [row['id']])
             else
               db.execute(
-                "UPDATE instincts SET confidence = ? WHERE id = ?",
-                [new_confidence, row["id"]]
+                'UPDATE instincts SET confidence = ? WHERE id = ?',
+                [new_confidence, row['id']]
               )
             end
           end

data/lib/rubyn_code/llm/RUBYN.md

@@ -0,0 +1,15 @@
+# LLM Layer
+
+Faraday-based Claude API client with streaming support.
+
+## Classes
+
+- **`Client`** — Sends messages to the Claude API. Handles auth headers (OAuth bearer or API key),
+  model selection, system prompts, and tool definitions. Returns parsed response or streams.
+
+- **`Streaming`** — SSE stream parser for Claude's streaming API. Buffers partial events,
+  emits content blocks and tool_use blocks as they arrive. Feeds into `CLI::StreamFormatter`.
+
+- **`MessageBuilder`** — Constructs the messages array for the API. Handles system prompt
+  injection, tool result formatting, and context window limits. Knows about Claude's
+  message format (role/content pairs, tool_use/tool_result blocks).