appydave-tools 0.79.0 → 0.80.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec01667ec40e9b0b051f2e834800cd458c736f27107df033ddebeaf7de413823
-  data.tar.gz: 6627f68aefaf25f40cd7d55ba87e8470bd8e5c5a99146927424149b84a31b3b6
+  metadata.gz: cb0b711e430f2082be55712eb0c3e630726bcc77628dc8ab144d72f27fc05bd7
+  data.tar.gz: 8fc9be5413601f6da5cccd649d324578df676efb842b138623998a1f6dd7b676
 SHA512:
-  metadata.gz: 8e745ed73fc0f812a6275edb827df2901e5eb0b41c060b4ac68fdc27c9eff750b60b84d2244e21f2b6afb2cda98eacacc3895b6c82502673162202cb31075ddb
-  data.tar.gz: 1814d3250ecf2aebf1ccb9cf50e117fc7b9f220334c263b5b1677336848db1cd7e37f9b684df2903aba96ecc69bbad96368c1acc87fbd6addfed4086eeffe00a
+  metadata.gz: d7527c25930ba5fb35206e6321fea074f12593a9188ed4b7d51f1f832f01f60a9929336b8670bf48bea0f68eeba0df150ecb542ea244be899334781ef432a7a1
+  data.tar.gz: 051f6c24d48fa6caa2ac342436a1105403d7524e871ee248996b772e0e16aafde612cd33386d4b6bba92b5f1f0c2e2f6cf61406e9f76db5a42e55d367031c642

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.79.0](https://github.com/appydave/appydave-tools/compare/v0.78.0...v0.79.0) (2026-04-03)
+
+
+### Features
+
+* add --stdin support to llm_context for piping file paths ([8890cfe](https://github.com/appydave/appydave-tools/commit/8890cfebb80cfda81b679da3e52a185bbb1c9141))
+
 # [0.78.0](https://github.com/appydave/appydave-tools/compare/v0.77.7...v0.78.0) (2026-04-03)
 
 

data/bin/query_brain.rb

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'appydave/tools'
+
+options = Appydave::Tools::BrainContextOptions.new
+
+def setup_options(options)
+  OptionParser.new do |opts| # rubocop:disable Metrics/BlockLength
+    opts.banner = 'Usage: query_brain [options]'
+
+    opts.on('--brain NAME', 'Query brain by name, alias, or fuzzy match') do |name|
+      options.brain_names << name
+    end
+
+    opts.on('--tag TAG', 'Query brains by tag') do |tag|
+      options.tags << tag
+    end
+
+    opts.on('--category CAT', 'Query all brains in category') do |cat|
+      options.categories << cat
+    end
+
+    opts.on('--activity-min LEVEL', %w[high medium low none],
+            'Filter brains by minimum activity level') do |level|
+      options.activity_levels << level
+    end
+
+    opts.on('--status STATUS', %w[active stable deprecated],
+            'Filter brains by status (default: exclude deprecated)') do |status|
+      options.status = status
+    end
+
+    opts.on('--files-only', 'Exclude INDEX.md, only include content files') do
+      options.include_index = false
+    end
+
+    opts.on('-d', '--debug [MODE]', %w[none info params debug],
+            'Debug output level') do |level|
+      options.debug_level = level || 'info'
+    end
+
+    opts.on('-v', '--version', 'Show version') do
+      puts "query_brain v#{Appydave::Tools::VERSION}"
+      exit 0
+    end
+
+    opts.on('-h', '--help', 'Show this message') do
+      puts opts
+      exit 0
+    end
+  end.parse!
+end
+
+setup_options(options)
+
+# Query
+finder = Appydave::Tools::BrainQuery.new(options)
+paths = finder.find
+
+# Output file paths, one per line
+paths.each { |p| puts p }
+
+exit 0

data/bin/query_omi.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'appydave/tools'
+
+options = Appydave::Tools::BrainContextOptions.new
+options.omi = true
+
+def setup_options(options)
+  OptionParser.new do |opts| # rubocop:disable Metrics/BlockLength
+    opts.banner = 'Usage: query_omi [options]'
+
+    opts.on('--signal SIGNAL', %w[work life ambient],
+            'Filter by signal') do |signal|
+      options.omi_signals << signal
+    end
+
+    opts.on('--routing ROUTING',
+            'Filter by routing (brain-update, todo-item, personal, til, archive; pipe-delimited)') do |routing|
+      options.omi_routings.concat(routing.split('|').map(&:strip))
+    end
+
+    opts.on('--activity ACTIVITY',
+            'Filter by activity (planning, reviewing, learning, debugging, etc.; pipe-delimited)') do |activity|
+      options.omi_activities.concat(activity.split('|').map(&:strip))
+    end
+
+    opts.on('--date-from DATE', 'Include files from date (YYYY-MM-DD)') do |date|
+      options.date_from = date
+    end
+
+    opts.on('--date-to DATE', 'Include files up to date (YYYY-MM-DD)') do |date|
+      options.date_to = date
+    end
+
+    opts.on('--enriched-only', 'Skip raw (non-enriched) transcripts') do
+      options.enriched_only = true
+    end
+
+    opts.on('--brain NAME', 'Find OMI files mentioning this brain') do |name|
+      options.brain_names << name
+    end
+
+    opts.on('-d', '--debug [MODE]', %w[none info params debug],
+            'Debug output level') do |level|
+      options.debug_level = level || 'info'
+    end
+
+    opts.on('-v', '--version', 'Show version') do
+      puts "query_omi v#{Appydave::Tools::VERSION}"
+      exit 0
+    end
+
+    opts.on('-h', '--help', 'Show this message') do
+      puts opts
+      exit 0
+    end
+  end.parse!
+end
+
+setup_options(options)
+
+# Query
+finder = Appydave::Tools::OmiQuery.new(options)
+paths = finder.find
+
+# Output file paths, one per line
+paths.each { |p| puts p }
+
+exit 0

data/exe/query_brain

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'appydave/tools'
+
+load File.expand_path('../bin/query_brain.rb', __dir__)

data/exe/query_omi

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'appydave/tools'
+
+load File.expand_path('../bin/query_omi.rb', __dir__)

data/lib/appydave/tools/brain_context/brain_finder.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Appydave
+  module Tools
+    # Queries brains-index.json to find brain files
+    class BrainQuery
+      def initialize(options)
+        @options = options
+        @index = nil
+        @alias_map = nil
+      end
+
+      def find
+        return [] unless @options.brain_query?
+
+        load_index!
+        paths = []
+
+        # Handle brain name queries
+        @options.brain_names.each do |name|
+          paths.concat(find_by_name(name))
+        end
+
+        # Handle tag queries
+        @options.tags.each do |tag|
+          paths.concat(find_by_tag(tag))
+        end
+
+        # Handle category queries
+        @options.categories.each do |category|
+          paths.concat(find_by_category(category))
+        end
+
+        # Handle activity level filters
+        paths.select! { |p| matches_activity_level?(p) } if @options.activity_levels.any?
+
+        # Remove duplicates and return
+        paths.uniq.sort
+      end
+
+      private
+
+      def load_index!
+        return if @index
+
+        index_path = @options.brains_index_path
+        unless File.exist?(index_path)
+          raise "brains-index.json not found at #{index_path}. Run: python ~/dev/ad/brains/.claude/skills/brain-librarian/scripts/build_brain_index.py build --all ~/dev/ad/brains"
+        end
+
+        @index = JSON.parse(File.read(index_path))
+        build_alias_map!
+      end
+
+      def build_alias_map!
+        @alias_map = {}
+        @index['alias_index']&.each { |alias_name, brain_name| @alias_map[alias_name.downcase] = brain_name }
+      end
+
+      def find_by_name(name)
+        load_index!
+
+        # Step 1: Exact match on brain key
+        brain_entry = find_brain_in_index(name)
+        return brain_entries_to_paths([brain_entry]) if brain_entry
+
+        # Step 2: Alias match
+        if @alias_map && @alias_map[name.downcase]
+          brain_name = @alias_map[name.downcase]
+          brain_entry = find_brain_in_index(brain_name)
+          return brain_entries_to_paths([brain_entry]) if brain_entry
+        end
+
+        # Step 3: Substring match on brain key (case-insensitive)
+        matches = []
+        @index['categories'].each_value do |category_data|
+          category_data['brains'].each do |brain_name, brain_data|
+            matches << brain_data if brain_name.downcase.include?(name.downcase)
+          end
+        end
+        return brain_entries_to_paths(matches) if matches.length == 1
+        return brain_entries_to_paths(matches) if matches.any?
+
+        # Not found
+        []
+      end
+
+      def find_by_tag(tag)
+        load_index!
+        tag = tag.downcase.gsub('_', '-')
+
+        brain_names = @index['tag_index']&.[](tag) || []
+        brain_entries = []
+
+        brain_names.each do |brain_name|
+          entry = find_brain_in_index(brain_name)
+          brain_entries << entry if entry
+        end
+
+        brain_entries_to_paths(brain_entries)
+      end
+
+      def find_by_category(category)
+        load_index!
+        category_data = @index['categories'][category] || @index['categories'][category.downcase]
+
+        return [] unless category_data
+
+        brain_entries = category_data['brains'].values
+        brain_entries_to_paths(brain_entries)
+      end
+
+      def find_brain_in_index(brain_name)
+        @index['categories'].each_value do |category_data|
+          return category_data['brains'][brain_name] if category_data['brains'][brain_name]
+        end
+        nil
+      end
+
+      def brain_entries_to_paths(brain_entries)
+        paths = []
+
+        brain_entries.each do |entry|
+          next unless entry
+
+          # Add files from files[] array
+          entry['files']&.each do |file|
+            # File entry is relative to the brain directory
+            brain_name = extract_brain_name(entry)
+            full_path = File.join(@options.brains_root, brain_name, file)
+            paths << full_path if File.exist?(full_path)
+          end
+
+          # Add INDEX.md if requested
+          if @options.include_index
+            index_path = File.join(@options.brains_root, entry['index_path'])
+            paths << index_path if File.exist?(index_path)
+          end
+        end
+
+        paths
+      end
+
+      def extract_brain_name(entry)
+        # index_path is like "brain-name/INDEX.md"
+        entry['index_path'].split('/')[0]
+      end
+
+      def matches_activity_level?(file_path)
+        # Extract brain name from path
+        brain_name = file_path.match(%r{#{Regexp.escape(@options.brains_root)}/([^/]+)})&.[](1)
+        return false unless brain_name
+
+        # Find the brain entry
+        entry = find_brain_in_index(brain_name)
+        return false unless entry
+
+        # Check if activity level matches filter
+        @options.activity_levels.include?(entry['activity_level'])
+      end
+    end
+  end
+end

data/lib/appydave/tools/brain_context/omi_finder.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+require 'date'
+
+module Appydave
+  module Tools
+    # Queries OMI transcript directory by enriched frontmatter
+    class OmiQuery
+      def initialize(options)
+        @options = options
+      end
+
+      def find
+        return [] unless @options.omi_query?
+
+        paths = []
+
+        Dir.glob(File.join(@options.omi_dir, '*.md')).each do |file_path|
+          next unless include_file?(file_path)
+
+          paths << file_path
+        end
+
+        paths.sort
+      end
+
+      private
+
+      def include_file?(file_path)
+        frontmatter = extract_frontmatter(file_path)
+        return false unless frontmatter
+
+        # If enriched-only requested, skip raw files
+        return false if @options.enriched_only && (!frontmatter['signal'] || !frontmatter['extraction_summary'])
+
+        # Apply filters
+        return false unless signal_matches?(frontmatter)
+        return false unless routing_matches?(frontmatter)
+        return false unless activity_matches?(frontmatter)
+        return false unless date_matches?(frontmatter)
+        return false unless brain_matches?(frontmatter)
+
+        true
+      end
+
+      def extract_frontmatter(file_path)
+        content = File.read(file_path, encoding: 'utf-8')
+        lines = content.split("\n")
+
+        return nil unless lines[0] == '---'
+
+        frontmatter = {}
+        i = 1
+        while i < lines.length
+          line = lines[i]
+          break if line == '---'
+
+          # Parse YAML-like: key: value
+          if line.match?(/^[a-z_]+:/)
+            key, value = parse_yaml_line(line)
+            frontmatter[key] = value
+          end
+
+          i += 1
+        end
+
+        frontmatter.empty? ? nil : frontmatter
+      end
+
+      def parse_yaml_line(line)
+        # Handle simple cases: key: value, key: [a, b, c]
+        match = line.match(/^([a-z_]+):\s*(.*)$/)
+        return [nil, nil] unless match
+
+        key = match[1]
+        value_str = match[2].strip
+
+        # Parse array [a, b, c]
+        if value_str.start_with?('[') && value_str.end_with?(']')
+          array_content = value_str[1..-2]
+          value = array_content.split(',').map { |v| v.strip.gsub(/^["']|["']$/, '') }
+        # Parse quoted string
+        elsif (value_str.start_with?('"') && value_str.end_with?('"')) ||
+              (value_str.start_with?("'") && value_str.end_with?("'"))
+          value = value_str[1..-2]
+        # Parse date (YYYY-MM-DD) or other values as-is
+        else
+          value = value_str
+        end
+
+        [key, value]
+      end
+
+      def signal_matches?(frontmatter)
+        return true if @options.omi_signals.empty?
+
+        signal = frontmatter['signal']
+        return false unless signal
+
+        @options.omi_signals.include?(signal)
+      end
+
+      def routing_matches?(frontmatter)
+        return true if @options.omi_routings.empty?
+
+        routing = frontmatter['routing']
+        return false unless routing
+
+        # routing can be pipe-delimited
+        routings = routing.split('|').map(&:strip)
+        routings.any? { |r| @options.omi_routings.include?(r) }
+      end
+
+      def activity_matches?(frontmatter)
+        return true if @options.omi_activities.empty?
+
+        activity = frontmatter['activity']
+        return false unless activity
+
+        # activity can be pipe-delimited
+        activities = activity.split('|').map(&:strip)
+        activities.any? { |a| @options.omi_activities.include?(a) }
+      end
+
+      def date_matches?(frontmatter)
+        extracted_at = frontmatter['extracted_at']
+        return true if extracted_at.nil? # No date field = include
+
+        begin
+          date = Date.parse(extracted_at)
+        rescue StandardError
+          return true # Can't parse = include
+        end
+
+        from_ok = @options.date_from.nil? || date >= Date.parse(@options.date_from)
+        to_ok = @options.date_to.nil? || date <= Date.parse(@options.date_to)
+
+        from_ok && to_ok
+      end
+
+      def brain_matches?(frontmatter)
+        return true if @options.brain_names.empty?
+
+        matched_brains = frontmatter['matched_brains']
+        return false unless matched_brains
+
+        # matched_brains is an array
+        matched_brains_list = matched_brains.is_a?(Array) ? matched_brains : [matched_brains]
+        matched_brains_list.any? { |brain| @options.brain_names.include?(brain) }
+      end
+    end
+  end
+end

data/lib/appydave/tools/brain_context/options.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Appydave
+  module Tools
+    # Options struct for brain/OMI query tools
+    class BrainContextOptions
+      attr_accessor :brain_names, :tags, :categories, :activity_levels, :status,
+                    :omi, :omi_signals, :omi_routings, :omi_activities,
+                    :date_from, :date_to, :enriched_only,
+                    :include_index, :output_targets, :formats, :line_limit,
+                    :debug_level, :dry_run, :tokens, :base_dir, :omi_dir
+
+      def initialize
+        @brain_names = []
+        @tags = []
+        @categories = []
+        @activity_levels = []
+        @status = 'active' # default: exclude deprecated
+
+        @omi = false
+        @omi_signals = []
+        @omi_routings = []
+        @omi_activities = []
+        @date_from = nil
+        @date_to = nil
+        @enriched_only = false
+
+        @include_index = true
+        @output_targets = ['clipboard'] # default to clipboard
+        @formats = ['content']
+        @line_limit = nil
+        @debug_level = 'none'
+        @dry_run = false
+        @tokens = false
+        @base_dir = Dir.pwd
+
+        @omi_dir = File.expand_path('~/dev/raw-intake/omi')
+      end
+
+      def brains_root
+        @brains_root ||= File.expand_path('~/dev/ad/brains')
+      end
+
+      def brains_index_path
+        File.join(brains_root, 'audit', 'brains-index.json')
+      end
+
+      def brain_query?
+        brain_names.any? || tags.any? || categories.any? || activity_levels.any?
+      end
+
+      def omi_query?
+        omi
+      end
+    end
+  end
+end

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.79.0'
+    VERSION = '0.80.0'
   end
 end

data/lib/appydave/tools.rb

@@ -37,6 +37,10 @@ require 'appydave/tools/llm_context/options'
 require 'appydave/tools/llm_context/file_collector'
 require 'appydave/tools/llm_context/output_handler'
 
+require 'appydave/tools/brain_context/options'
+require 'appydave/tools/brain_context/brain_finder'
+require 'appydave/tools/brain_context/omi_finder'
+
 require 'appydave/tools/configuration/openai'
 require 'appydave/tools/configuration/configurable'
 require 'appydave/tools/configuration/config'

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.79.0",
+  "version": "0.80.0",
   "description": "AppyDave YouTube Automation Tools",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.79.0
+  version: 0.80.0
 platform: ruby
 authors:
 - David Cruwys
@@ -190,6 +190,8 @@ executables:
 - jump
 - llm_context
 - prompt_tools
+- query_brain
+- query_omi
 - subtitle_processor
 - youtube_automation
 - youtube_manager
@@ -229,6 +231,8 @@ files:
 - bin/llm_context.rb
 - bin/move_images.rb
 - bin/prompt_tools.rb
+- bin/query_brain.rb
+- bin/query_omi.rb
 - bin/setup
 - bin/subtitle_manager-old.rb
 - bin/subtitle_manager.rb
@@ -338,12 +342,17 @@ files:
 - exe/jump
 - exe/llm_context
 - exe/prompt_tools
+- exe/query_brain
+- exe/query_omi
 - exe/subtitle_processor
 - exe/youtube_automation
 - exe/youtube_manager
 - exe/zsh_history
 - images.log
 - lib/appydave/tools.rb
+- lib/appydave/tools/brain_context/brain_finder.rb
+- lib/appydave/tools/brain_context/omi_finder.rb
+- lib/appydave/tools/brain_context/options.rb
 - lib/appydave/tools/cli_actions/_doc.md
 - lib/appydave/tools/cli_actions/base_action.rb
 - lib/appydave/tools/cli_actions/get_video_action.rb