appydave-tools 0.84.0 → 0.85.0

data/lib/appydave/tools/app_context/app_finder.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Appydave
+  module Tools
+    module AppContext
+      # Queries locations.json to find app files via context.globs.json patterns.
+      #
+      # Follows the same find/find_meta pattern as BrainQuery and OmiQuery.
+      class AppQuery
+        def initialize(options, jump_config: nil)
+          @options = options
+          @jump_config = jump_config
+        end
+
+        # Return absolute file paths matching the query
+        def find
+          return [] unless @options.query?
+
+          apps = resolve_apps
+          return [] if apps.empty?
+
+          apps.flat_map { |app| expand_app(app) }.uniq.sort
+        end
+
+        # Return structured metadata about the query results
+        def find_meta
+          return [] unless @options.query?
+
+          apps = resolve_apps
+          return [] if apps.empty?
+
+          apps.map { |app| build_meta(app) }
+        end
+
+        # List all available glob names for a specific app
+        def list_globs(app_name)
+          location = find_location(app_name)
+          return [] unless location
+
+          loader = build_loader(location)
+          return [] unless loader.available?
+
+          loader.available_names
+        end
+
+        # List all apps that have context.globs.json
+        def list_apps
+          jump_config.locations
+                     .select { |loc| File.exist?(File.join(expand_path(loc.path), 'context.globs.json')) }
+                     .map do |loc|
+                       loader = build_loader(loc)
+                       {
+                         'key' => loc.key,
+                         'path' => expand_path(loc.path),
+                         'pattern' => loader.pattern,
+                         'glob_count' => loader.globs.size
+                       }
+                     end
+        end
+
+        private
+
+        def jump_config
+          @jump_config ||= Jump::Config.new
+        end
+
+        # Resolve app names to Location objects
+        def resolve_apps
+          if @options.pattern_filter
+            resolve_by_pattern(@options.pattern_filter)
+          else
+            @options.app_names.flat_map { |name| resolve_app(name) }.compact.uniq(&:key)
+          end
+        end
+
+        # 4-tier app resolution
+        def resolve_app(name)
+          name_down = name.downcase
+
+          # Tier 1: exact key match
+          loc = jump_config.find(name_down)
+          return [loc] if loc
+
+          # Tier 2: jump alias match
+          loc = jump_config.locations.find { |l| l.jump&.downcase == name_down }
+          return [loc] if loc
+
+          # Tier 3: substring match on key
+          matches = jump_config.locations.select { |l| l.key.downcase.include?(name_down) }
+          return matches unless matches.empty?
+
+          # Tier 4: substring match on description
+          jump_config.locations.select { |l| l.description&.downcase&.include?(name_down) }
+        end
+
+        def resolve_by_pattern(pattern)
+          jump_config.locations.select do |loc|
+            loader = build_loader(loc)
+            loader.available? && loader.pattern&.downcase == pattern.downcase
+          end
+        end
+
+        def expand_app(location)
+          loader = build_loader(location)
+          return [] unless loader.available?
+
+          glob_names = @options.glob_names
+          return [] if glob_names.empty?
+
+          loader.expand(glob_names)
+        end
+
+        def build_meta(location)
+          loader = build_loader(location)
+          glob_names = @options.glob_names
+          file_count = loader.available? && glob_names.any? ? loader.expand(glob_names).size : 0
+
+          resolved_from = glob_names.map { |n| describe_resolution(loader, n) }.join(', ')
+
+          {
+            'app' => location.key,
+            'path' => expand_path(location.path),
+            'pattern' => loader.pattern,
+            'matched_globs' => resolve_glob_names(loader, glob_names),
+            'resolved_from' => resolved_from,
+            'file_count' => file_count
+          }
+        end
+
+        def build_loader(location)
+          GlobsLoader.new(expand_path(location.path))
+        end
+
+        def expand_path(path)
+          File.expand_path(path)
+        end
+
+        def find_location(app_name)
+          results = resolve_app(app_name)
+          results&.first
+        end
+
+        # Describe how a glob name was resolved (for meta output)
+        def describe_resolution(loader, name)
+          name = name.strip.downcase
+          return "#{name} (glob)" if loader.globs.key?(name)
+          return "#{name} (alias)" if loader.aliases.key?(name)
+          return "#{name} (composite)" if loader.composites.key?(name)
+
+          "#{name} (fuzzy)"
+        end
+
+        # Resolve glob names to their constituent direct glob names
+        def resolve_glob_names(loader, names)
+          return [] unless loader.available?
+
+          names.flat_map do |name|
+            name = name.strip.downcase
+            if loader.globs.key?(name)
+              [name]
+            elsif loader.aliases.key?(name)
+              loader.aliases[name]
+            elsif loader.composites.key?(name)
+              members = loader.composites[name]
+              members == ['*'] ? loader.globs.keys : members
+            else # rubocop:disable Lint/DuplicateBranch
+              [name]
+            end
+          end.uniq
+        end
+      end
+    end
+  end
+end

data/lib/appydave/tools/app_context/globs_loader.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Appydave
+  module Tools
+    module AppContext
+      # Loads and resolves named glob patterns from a context.globs.json file.
+      #
+      # Resolution is 3-tier:
+      #   1. Direct glob name  — "services" → globs["services"]
+      #   2. Alias match       — "backend"  → aliases["backend"] → ["services", "routes"]
+      #   3. Composite match   — "understand" → composites["understand"] → ["context", "docs", ...]
+      class GlobsLoader
+        attr_reader :project_path, :data
+
+        def initialize(project_path)
+          @project_path = project_path
+          @data = load_globs_file
+        end
+
+        def available?
+          !data.nil?
+        end
+
+        def globs
+          data&.fetch('globs', {}) || {}
+        end
+
+        def aliases
+          data&.fetch('aliases', {}) || {}
+        end
+
+        def composites
+          data&.fetch('composites', {}) || {}
+        end
+
+        def pattern
+          data&.fetch('pattern', nil)
+        end
+
+        def project_name
+          data&.fetch('project', nil)
+        end
+
+        # List all available glob names (direct + aliases + composites)
+        def available_names
+          names = globs.keys.map { |k| { name: k, type: 'glob' } }
+          names += aliases.keys.map { |k| { name: k, type: 'alias' } }
+          names += composites.keys.map { |k| { name: k, type: 'composite' } }
+          names
+        end
+
+        # Resolve a single name through the 3-tier hierarchy.
+        # Returns an array of raw glob patterns (strings).
+        def resolve(name)
+          name = name.strip.downcase
+
+          # Tier 1: direct glob name
+          return globs[name] if globs.key?(name)
+
+          # Tier 2: alias → list of glob names
+          return aliases[name].flat_map { |glob_name| globs[glob_name] || [] } if aliases.key?(name)
+
+          # Tier 3: composite → list of glob names (or "*" for all)
+          if composites.key?(name)
+            members = composites[name]
+            return globs.values.flatten if members == ['*']
+
+            return members.flat_map { |glob_name| resolve_single_glob(glob_name) }
+          end
+
+          # Tier 4: substring fallback
+          match = find_substring_match(name)
+          return resolve(match) if match
+
+          []
+        end
+
+        # Resolve multiple names, expand globs against the filesystem, return absolute paths.
+        def expand(names)
+          patterns = names.flat_map { |name| resolve(name) }.uniq
+
+          patterns.flat_map { |pat| Dir.glob(File.join(project_path, pat)) }
+                  .select { |f| File.file?(f) }
+                  .uniq
+                  .sort
+        end
+
+        private
+
+        def globs_file_path
+          File.join(project_path, 'context.globs.json')
+        end
+
+        def load_globs_file
+          path = globs_file_path
+          return nil unless File.exist?(path)
+
+          JSON.parse(File.read(path))
+        rescue JSON::ParserError
+          nil
+        end
+
+        def resolve_single_glob(glob_name)
+          globs[glob_name] || []
+        end
+
+        def find_substring_match(name)
+          all_names = globs.keys + aliases.keys + composites.keys
+          all_names.find { |n| n.include?(name) }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Appydave
+  module Tools
+    module AppContext
+      # Options struct for app context query tool
+      class Options
+        attr_accessor :app_names, :glob_names, :pattern_filter,
+                      :meta, :list, :list_apps,
+                      :debug_level
+
+        def initialize
+          @app_names = []
+          @glob_names = []
+          @pattern_filter = nil
+          @meta = false
+          @list = false
+          @list_apps = false
+          @debug_level = 'none'
+        end
+
+        def query?
+          app_names.any? || !pattern_filter.nil?
+        end
+      end
+    end
+  end
+end

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

@@ -34,11 +34,15 @@ module Appydave
         @tokens = false
         @base_dir = Dir.pwd
 
-        @omi_dir = File.expand_path('~/dev/raw-intake/omi')
+        configured_omi = read_setting('omi-directory-path')
+        @omi_dir = configured_omi || File.expand_path('~/dev/raw-intake/omi')
       end
 
       def brains_root
-        @brains_root ||= File.expand_path('~/dev/ad/brains')
+        @brains_root ||= begin
+          configured = read_setting('brains-root-path')
+          configured || File.expand_path('~/dev/ad/brains')
+        end
       end
 
       def brains_index_path
@@ -52,6 +56,19 @@ module Appydave
       def omi_query?
         omi
       end
+
+      private
+
+      # Read a path value from settings config, expanding ~ if set.
+      # Returns nil if config is unavailable or key is absent/blank.
+      def read_setting(key)
+        value = Appydave::Tools::Configuration::Config.settings.get(key)
+        return nil if value.nil? || value.to_s.strip.empty?
+
+        File.expand_path(value)
+      rescue StandardError
+        nil
+      end
     end
   end
 end

data/lib/appydave/tools/configuration/example_installer.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Appydave
+  module Tools
+    module Configuration
+      # Installs bundled example configuration files into the user's config directory.
+      #
+      # Example files live at config/examples/*.example.json inside the gem.
+      # Each file is installed without the `.example` segment in its name so that
+      # `settings.example.json` becomes `settings.json` in the target directory.
+      #
+      # Files are never overwritten — existing files are skipped and reported.
+      #
+      # @example Install all examples
+      #   result = ExampleInstaller.new.install
+      #   result[:installed] #=> ["settings.json", "locations.json"]
+      #   result[:skipped]   #=> []
+      class ExampleInstaller
+        EXAMPLES_PATH = File.expand_path('../../../../config/examples', __dir__)
+
+        # @param target_path [String, nil] Directory to install into.
+        #   Defaults to the active Config.config_path (~/.config/appydave).
+        def initialize(target_path: nil)
+          @target_path = target_path || Config.config_path
+        end
+
+        # Install all bundled example files that do not yet exist.
+        #
+        # @return [Hash] with keys :installed (Array<String>) and :skipped (Array<String>)
+        def install
+          FileUtils.mkdir_p(@target_path)
+          results = { installed: [], skipped: [] }
+
+          example_files.each do |src|
+            dest = destination_for(src)
+            basename = File.basename(dest)
+
+            if File.exist?(dest)
+              results[:skipped] << basename
+            else
+              FileUtils.cp(src, dest)
+              results[:installed] << basename
+            end
+          end
+
+          results
+        end
+
+        # List the filenames that would be installed (target names, not source names).
+        #
+        # @return [Array<String>]
+        def available
+          example_files.map { |f| target_name(f) }
+        end
+
+        private
+
+        def example_files
+          Dir.glob(File.join(EXAMPLES_PATH, '*.example.*')).sort
+        end
+
+        def destination_for(src)
+          File.join(@target_path, target_name(src))
+        end
+
+        def target_name(src)
+          File.basename(src).sub('.example', '')
+        end
+      end
+    end
+  end
+end

data/lib/appydave/tools/configuration/models/settings_config.rb

@@ -42,6 +42,18 @@ module Appydave
             get('current_user')
           end
 
+          # Path to the root brains directory (second-brain knowledge base)
+          # Configure via settings.json key: brains-root-path
+          def brains_root_path
+            get('brains-root-path')
+          end
+
+          # Path to the OMI wearable transcripts directory
+          # Configure via settings.json key: omi-directory-path
+          def omi_directory_path
+            get('omi-directory-path')
+          end
+
           def print
             log.subheading 'Settings Configuration'
 

data/lib/appydave/tools/jump/formatters/table_formatter.rb

@@ -24,11 +24,12 @@ module Appydave
           #
           # @return [String] Formatted table
           def format
-            return format_error unless success?
-            return format_info if info_result?
-            return format_summary if summary_result?
-            return format_groups unless groups.empty?
-            return format_empty if results.empty?
+            return format_error    unless success?
+            return format_info     if info_result?
+            return format_summary  if summary_result?
+            return format_groups   unless groups.empty?
+            return format_mutation if mutation_result?
+            return format_empty    if results.empty?
             return format_definition_report if definition_report?
             return format_count_report if count_report?
             return format_category_report if category_report?
@@ -45,6 +46,16 @@ module Appydave
             lines.join("\n")
           end
 
+          def mutation_result?
+            data.key?(:message) && (data.key?(:location) || data[:message].to_s.match?(/removed|updated|added/i))
+          end
+
+          def format_mutation
+            lines = [colorize(data[:message], :green)]
+            lines << colorize(data[:warning], :yellow) if data[:warning]
+            lines.join("\n")
+          end
+
           def format_empty
             message = case data[:report]
                       when 'brands'

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.84.0'
+    VERSION = '0.85.0'
   end
 end

data/lib/appydave/tools/zsh_history/config.rb

@@ -108,8 +108,8 @@ module Appydave
             ^Finished in \\d
             ^\\d+ examples, \\d+ failures
 
-            # Process listing output
-            ^davidcruwys\\s+\\d+
+            # Process listing output (current user)
+            ^#{ENV.fetch('USER', ENV.fetch('USERNAME', ''))}\\s+\\d+
           PATTERNS
 
           # Create crash-recovery profile

data/lib/appydave/tools/zsh_history/filter.rb

@@ -34,8 +34,7 @@ module Appydave
           '^head ',
           '^tail ',
           '^echo \\$',
-          '^\\[\\d+\\]',              # Output like [1234]
-          '^davidcruwys\\s+\\d+',     # Process listing output
+          '^\\[\\d+\\]', # Output like [1234]
           '^zsh: command not found',
           '^X Process completed',
           '^Coverage report',
@@ -138,9 +137,16 @@ module Appydave
         end
 
         def load_exclude_patterns
-          # Try loading from config, fall back to defaults
+          # Try loading from config, fall back to defaults (with dynamic user pattern appended)
           config_patterns = config.exclude_patterns
-          config_patterns || DEFAULT_EXCLUDE_PATTERNS
+          config_patterns || default_exclude_patterns_with_user
+        end
+
+        def default_exclude_patterns_with_user
+          username = ENV.fetch('USER', ENV.fetch('USERNAME', ''))
+          return DEFAULT_EXCLUDE_PATTERNS if username.empty?
+
+          DEFAULT_EXCLUDE_PATTERNS + ["^#{username}\\s+\\d+"]
         end
 
         def load_include_patterns

data/lib/appydave/tools.rb

@@ -41,6 +41,10 @@ require 'appydave/tools/brain_context/options'
 require 'appydave/tools/brain_context/brain_finder'
 require 'appydave/tools/brain_context/omi_finder'
 
+require 'appydave/tools/app_context/options'
+require 'appydave/tools/app_context/globs_loader'
+require 'appydave/tools/app_context/app_finder'
+
 require 'appydave/tools/random_context/query_entry'
 require 'appydave/tools/random_context/randomizer'
 
@@ -52,6 +56,7 @@ require 'appydave/tools/configuration/models/settings_config'
 require 'appydave/tools/configuration/models/brands_config'
 require 'appydave/tools/configuration/models/channels_config'
 require 'appydave/tools/configuration/models/youtube_automation_config'
+require 'appydave/tools/configuration/example_installer'
 require 'appydave/tools/name_manager/project_name'
 
 require 'appydave/tools/prompt_tools/prompt_completion'

data/package.json

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.84.0
+  version: 0.85.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-05 00:00:00.000000000 Z
+date: 2026-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -190,6 +190,7 @@ executables:
 - jump
 - llm_context
 - prompt_tools
+- query_apps
 - query_brain
 - query_omi
 - subtitle_processor
@@ -231,6 +232,7 @@ files:
 - bin/llm_context.rb
 - bin/move_images.rb
 - bin/prompt_tools.rb
+- bin/query_apps.rb
 - bin/query_brain.rb
 - bin/query_omi.rb
 - bin/random_context.rb
@@ -242,7 +244,10 @@ files:
 - bin/youtube_automation.rb
 - bin/youtube_manager.rb
 - bin/zsh_history.rb
+- config/examples/locations.example.json
+- config/examples/settings.example.json
 - config/random-queries.yml
+- context.globs.json
 - docs/README.md
 - docs/ai-instructions/behavioral-regression-audit.md
 - docs/ai-instructions/code-quality-retrospective.md
@@ -329,8 +334,11 @@ files:
 - docs/planning/micro-cleanup/AGENTS.md
 - docs/planning/micro-cleanup/IMPLEMENTATION_PLAN.md
 - docs/planning/micro-cleanup/assessment.md
+- docs/planning/multi-user-support.md
+- docs/planning/query-apps-design.md
 - docs/planning/query-location-feature/IMPLEMENTATION_PLAN.md
 - docs/planning/query-location-feature/system-context-gap-analysis.md
+- docs/planning/query-skills-plan.md
 - docs/planning/s3-operations-split/AGENTS.md
 - docs/planning/s3-operations-split/IMPLEMENTATION_PLAN.md
 - docs/planning/test-coverage-gaps/AGENTS.md
@@ -338,6 +346,7 @@ files:
 - docs/planning/test-coverage-gaps/assessment.md
 - docs/specs/fr-002-gpt-context-help-system.md
 - docs/specs/fr-003-jump-location-tool.md
+- docs/specs/jump-add-display-fix.md
 - docs/specs/zsh-history-tool.md
 - docs/templates/.env.example
 - docs/templates/channels.example.json
@@ -348,6 +357,7 @@ files:
 - exe/jump
 - exe/llm_context
 - exe/prompt_tools
+- exe/query_apps
 - exe/query_brain
 - exe/query_omi
 - exe/subtitle_processor
@@ -356,6 +366,9 @@ files:
 - exe/zsh_history
 - images.log
 - lib/appydave/tools.rb
+- lib/appydave/tools/app_context/app_finder.rb
+- lib/appydave/tools/app_context/globs_loader.rb
+- lib/appydave/tools/app_context/options.rb
 - lib/appydave/tools/brain_context/brain_finder.rb
 - lib/appydave/tools/brain_context/omi_finder.rb
 - lib/appydave/tools/brain_context/options.rb
@@ -367,6 +380,7 @@ files:
 - lib/appydave/tools/configuration/_doc.md
 - lib/appydave/tools/configuration/config.rb
 - lib/appydave/tools/configuration/configurable.rb
+- lib/appydave/tools/configuration/example_installer.rb
 - lib/appydave/tools/configuration/models/brands_config.rb
 - lib/appydave/tools/configuration/models/channels_config.rb
 - lib/appydave/tools/configuration/models/config_base.rb