appydave-tools 0.71.1 → 0.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff2949280923d4d700c79c676aff2969cc95a0808fe857bee5a20c14f33e8524
-  data.tar.gz: 4d8616d22c94aae3316c310ed07da76cf5739d39c10771b43f09362d77eff70b
+  metadata.gz: 53447fe92cfd604234875affe143a083bc07b267ccf92ad11782e6640e440fa6
+  data.tar.gz: 74ed454547b2f4a3a5d859ca1bc41228b7efc340dc31c8f3a174b6ff4e1774dd
 SHA512:
-  metadata.gz: 16b926b801da0246092980d859729ce9c408a92644881877e54ccf1fc8a2ef43141ba0b78cc32fb31c0c3d2eaa41d53d224b4552fd63f49a798c52ad5a70a3d6
-  data.tar.gz: 5a21ef6d3d0629ca756527210b9e1f208a01aa752f0c93229d1cd3f7bd1c7116ab72cc83357c069984976061f15b2ffe17fd0cbbf784cc60d4fb5b3f1a073c4a
+  metadata.gz: 61ab02e5529f5a95be3aeeb85674e2f92d9db9d13571aafefc6569cec9f30f967a5d79b48885ad2f636816b50380c39ecdaf67d05b3d403c25ce06517efb8761
+  data.tar.gz: db15735eb6b14e5060a9f533231067222402edff360e5034e997c03483b8755692751ce54e95628eea2893e2f649c75a7f9af6e625c7c1be661c8f392d2908e9

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.72.0](https://github.com/appydave/appydave-tools/compare/v0.71.1...v0.72.0) (2025-12-18)
+
+
+### Features
+
+* add ah-help generate target for aliases-help.zsh format ([874fde9](https://github.com/appydave/appydave-tools/commit/874fde982a2b66ba7d9ec8f8078d79fcde7db4f6))
+
+## [0.71.1](https://github.com/appydave/appydave-tools/compare/v0.71.0...v0.71.1) (2025-12-15)
+
+
+### Bug Fixes
+
+* resolve jump get/remove returning 'No locations found' by making Search#get return results array consistent with search/list ([8ea39b5](https://github.com/appydave/appydave-tools/commit/8ea39b5fdd9bb9fe55c22f9cb86c8b66782c0f09))
+
 # [0.71.0](https://github.com/appydave/appydave-tools/compare/v0.70.0...v0.71.0) (2025-12-14)
 
 

data/docs/backlog.md

@@ -129,7 +129,7 @@ When `get agent-workflow-build` failed, it suggested: "Did you mean: test-minima
 - Personal skill at `~/.claude/skills/jump/SKILL.md`
 - Description includes brand names (appydave, voz, supportsignal, joy, aitldr, kiros), products (flivideo, storyline, klueless, dam), and trigger keywords
 - Primary mode: Jump CLI commands (`jump search`, `jump get`, `jump list`)
-- Fallback mode: Direct JSON read from `/ad/brains/brand-david/data-systems/collections/jump/current.json`
+- Fallback mode: Direct JSON read from `/ad/brains/brand-dave/data-systems/collections/jump/current.json`
 - Tool restrictions: `allowed-tools: Read, Bash, Grep, Glob`
 - Includes natural language examples and key location reference table
 

data/lib/appydave/tools/jump/cli.rb

@@ -245,7 +245,7 @@ module Appydave
 
           unless target
             output.puts 'Usage: jump generate <target> [--output <file>] [--output-dir <dir>]'
-            output.puts 'Targets: aliases, help, all'
+            output.puts 'Targets: aliases, help, ah-help, all'
             return EXIT_INVALID_INPUT
           end
 
@@ -542,16 +542,18 @@ module Appydave
             Targets:
               aliases     Generate shell alias file (aliases-jump.zsh)
               help        Generate help content for fzf (jump-help.txt)
-              all         Generate both files
+              ah-help     Generate content for aliases-help.zsh (ah function format)
+              all         Generate both aliases and help files
 
             Options:
-              --output <file>       Write to specific file (for aliases, help)
+              --output <file>       Write to specific file (for aliases, help, ah-help)
               --output-dir <dir>    Write to directory (for all)
 
             Examples:
               jump generate aliases
               jump generate aliases --output ~/.oh-my-zsh/custom/aliases-jump.zsh
               jump generate help --output ~/.oh-my-zsh/custom/data/jump-help.txt
+              jump generate ah-help --output ~/.oh-my-zsh/custom/aliases-help.zsh
               jump generate all --output-dir ~/.oh-my-zsh/custom/
           HELP
         end

data/lib/appydave/tools/jump/commands/generate.rb

@@ -6,7 +6,19 @@ module Appydave
       module Commands
         # Generate command creates shell aliases and help content
         class Generate < Base
-          VALID_TARGETS = %w[aliases help all].freeze
+          VALID_TARGETS = %w[aliases help ah-help all].freeze
+          MAX_BACKUPS = 10
+
+          TITLE_MAPPINGS = {
+            'appydave' => 'Appy Dave',
+            'supportsignal' => 'SupportSignal',
+            'beauty-and-joy' => 'Beauty & Joy',
+            'david-cruwys' => 'David Cruwys',
+            'guy-monroe' => 'Guy Monroe',
+            'voz' => 'VOZ',
+            'kiros' => 'Kiros',
+            'aitldr' => 'AITLDR'
+          }.freeze
 
           attr_reader :target, :output_path, :output_dir
 
@@ -28,7 +40,9 @@ module Appydave
               )
             end
 
-            send("generate_#{target}")
+            # Convert hyphenated targets to underscored method names
+            method_name = "generate_#{target.tr('-', '_')}"
+            send(method_name)
           end
 
           private
@@ -43,6 +57,11 @@ module Appydave
             write_or_return(content, output_path, 'jump-help.txt')
           end
 
+          def generate_ah_help
+            content = build_ah_help_content
+            write_or_return(content, output_path, 'aliases-help.zsh')
+          end
+
           def generate_all
             aliases_content = build_aliases_content
             help_content = build_help_content
@@ -75,20 +94,25 @@ module Appydave
             lines << "# Generated by: jump generate aliases (#{Time.now.strftime('%Y-%m-%d %H:%M')})"
             lines << '# Source: ~/.config/appydave/locations.json'
             lines << ''
-            lines << '# Usage: source this file in your .zshrc'
-            lines << '#   source ~/.oh-my-zsh/custom/aliases-jump.zsh'
-            lines << ''
 
-            # Group by brand/client
-            grouped = group_locations_for_aliases
+            # Build grouped sections using smart logic
+            sections = build_smart_alias_sections
 
-            grouped.each do |group_name, locations|
-              lines << "# #{group_name}"
-              locations.each do |loc|
-                path = path_validator.expand(loc.path)
-                desc = loc.description ? "  # #{loc.description}" : ''
-                lines << "alias #{loc.jump}=\"cd '#{path}'\"#{desc}"
+            sections.each do |section|
+              # Add major section separator if needed
+              if section[:major]
+                lines << '# ========================================'
+                lines << "# #{section[:title]}"
+                lines << '# ========================================'
+              else
+                lines << "# #{section[:title]}"
               end
+
+              section[:locations].each do |loc|
+                path = format_display_path(loc.path)
+                lines << "alias #{loc.jump}=\"cd #{path}\""
+              end
+
               lines << ''
             end
 
@@ -115,6 +139,99 @@ module Appydave
             lines.join("\n")
           end
 
+          def build_ah_help_content
+            lines = []
+
+            # Group locations into logical sections
+            sections = group_locations_for_ah_help
+
+            sections.each do |section_name, locations|
+              lines << "## #{section_name}"
+
+              locations.each do |loc|
+                path = format_display_path(loc.path)
+                tags = build_ah_tags(loc)
+
+                # Format: alias (24 chars) + path + tags
+                alias_col = loc.jump.ljust(24)
+                path_with_tags = "#{path}#{' ' * [1, 48 - path.length].max}#{tags}"
+
+                lines << "#{alias_col}#{path_with_tags}"
+              end
+
+              lines << ''
+            end
+
+            lines.join("\n")
+          end
+
+          def format_display_path(path)
+            # Collapse home directory to ~
+            expanded = path_validator.expand(path)
+            home = Dir.home
+            expanded.start_with?(home) ? expanded.sub(home, '~') : expanded
+          end
+
+          def build_ah_tags(loc)
+            tags = [loc.type, loc.brand, loc.client].compact.reject(&:empty?)
+            tags.concat(loc.tags) if loc.tags
+            tags.uniq.map { |t| "##{t}" }.join(' ')
+          end
+
+          def group_locations_for_ah_help
+            sections = {
+              'Base Directories' => [],
+              'Brand Projects - AppyDave' => [],
+              'Brand Projects - Other' => [],
+              'Client Projects' => [],
+              'Video Projects' => [],
+              'Ruby Gems' => [],
+              'Reference & Archives' => [],
+              'Other' => []
+            }
+
+            config.locations.each do |loc|
+              section = determine_ah_section(loc)
+              sections[section] << loc
+            end
+
+            # Remove empty sections and sort locations within each
+            sections.reject { |_, locs| locs.empty? }.transform_values do |locs|
+              locs.sort_by(&:jump)
+            end
+          end
+
+          # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+          def determine_ah_section(loc)
+            type = loc.type&.downcase
+            brand = loc.brand&.downcase
+
+            case type
+            when 'monorepo', 'config'
+              return 'Base Directories' if loc.client.nil? && loc.brand.nil?
+            when 'video'
+              return 'Video Projects'
+            when 'gem'
+              return 'Ruby Gems'
+            when 'client'
+              return 'Client Projects'
+            when 'archive', 'reference'
+              return 'Reference & Archives'
+            end
+
+            return 'Client Projects' if loc.client
+
+            case brand
+            when 'appydave'
+              'Brand Projects - AppyDave'
+            when 'beauty-and-joy', 'david-cruwys', 'aitldr'
+              'Brand Projects - Other'
+            else
+              'Other'
+            end
+          end
+          # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
           def group_locations_for_aliases
             grouped = {}
 
@@ -130,15 +247,132 @@ module Appydave
             end
           end
 
+          # rubocop:disable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+          def build_smart_alias_sections
+            sections = []
+            locations = config.locations.dup
+
+            # 1. JUMPS - Base directories (monorepo/config without brand/client)
+            jumps = locations.select { |l| %w[monorepo config].include?(l.type) && l.brand.nil? && l.client.nil? }
+            add_section(sections, 'JUMPS', jumps) unless jumps.empty?
+            locations -= jumps
+
+            # 2. Brain / Second Brain (only non-client brains)
+            brains = locations.select { |l| l.type == 'brain' && l.client.nil? }
+            add_section(sections, 'Brain / Second Brain', brains) unless brains.empty?
+            locations -= brains
+
+            # 3. Appy Dave (including david-cruwys ecosystem docs, excluding video, archive, and subprojects)
+            appydave_all = locations.select do |l|
+              %w[appydave david-cruwys].include?(l.brand) && !%w[video archive brain].include?(l.type)
+            end
+
+            # Extract subgroups
+            flivideo = appydave_all.select { |l| l.key.start_with?('flivideo') }
+            storyline = appydave_all.select { |l| l.key.start_with?('storyline') }
+            awb = appydave_all.select { |l| l.key.start_with?('agent-workflow', 'awb') }
+            klueless = appydave_all.select { |l| l.key == 'klueless' }
+
+            appydave_main = appydave_all - flivideo - storyline - awb - klueless
+
+            add_section(sections, 'Appy Dave', appydave_main) unless appydave_main.empty?
+            add_section(sections, 'KlueLess', klueless) unless klueless.empty?
+            add_section(sections, 'FliVideo', flivideo) unless flivideo.empty?
+            add_section(sections, 'Storyline App', storyline) unless storyline.empty?
+            add_section(sections, 'Agent Workflow Builder', awb) unless awb.empty?
+
+            locations -= appydave_all
+
+            # 4. CLIENT WORK (major section)
+            clients = locations.select { |l| l.client && l.type != 'video' }
+            unless clients.empty?
+              # Add major separator
+              sections << { title: 'CLIENT WORK', major: true, locations: [] }
+
+              # Group by client
+              clients.group_by(&:client).sort.each do |client_name, client_locs|
+                title = format_title(client_name, 'Client')
+                add_section(sections, title, client_locs)
+              end
+            end
+            locations -= clients
+
+            # 5. VIDEO PROJECTS (major section)
+            videos = locations.select { |l| l.type == 'video' }
+            unless videos.empty?
+              sections << { title: 'VIDEO PROJECTS', major: true, locations: [] }
+
+              # Split into brand and client videos
+              brand_videos = videos.select(&:brand)
+              client_videos = videos.select(&:client)
+              other_videos = videos - brand_videos - client_videos
+
+              add_section(sections, 'Brand Video Projects', brand_videos) unless brand_videos.empty?
+              add_section(sections, 'Client Video Projects', client_videos) unless client_videos.empty?
+              add_section(sections, 'Video Projects', other_videos) unless other_videos.empty?
+            end
+            locations -= videos
+
+            # 6. Beauty & Joy (non-video)
+            joy = locations.select { |l| l.brand == 'beauty-and-joy' }
+            add_section(sections, 'Beauty & Joy', joy, major: true) unless joy.empty?
+            locations -= joy
+
+            # 7. Archive
+            archives = locations.select { |l| l.type == 'archive' }
+            add_section(sections, 'Archive', archives) unless archives.empty?
+            locations -= archives
+
+            # 8. GEMs
+            gems = locations.select { |l| l.type == 'gem' }
+            add_section(sections, 'GEMs', gems) unless gems.empty?
+            locations -= gems
+
+            # 9. Reference / 3rd Party
+            refs = locations.select { |l| l.type == 'reference' }
+            add_section(sections, 'Reference / 3rd Party', refs) unless refs.empty?
+            locations -= refs
+
+            # 10. Experiments
+            experiments = locations.select { |l| l.type == 'experiments' }
+            add_section(sections, 'Experiments', experiments) unless experiments.empty?
+            locations -= experiments
+
+            # 11. Other (anything remaining)
+            add_section(sections, 'Other', locations) unless locations.empty?
+
+            sections.reject { |s| s[:locations].empty? && !s[:major] }
+          end
+          # rubocop:enable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+          def add_section(sections, title, locations, major: false)
+            return if locations.empty?
+
+            sections << {
+              title: title,
+              major: major,
+              locations: locations.sort_by(&:jump)
+            }
+          end
+
+          def format_title(name, suffix = nil)
+            title = TITLE_MAPPINGS[name] || name.split('-').map(&:capitalize).join(' ')
+            suffix ? "#{title} #{suffix}" : title
+          end
+
           def write_or_return(content, path, default_filename)
             if path
+              backup_result = backup_existing_file(path)
               FileUtils.mkdir_p(File.dirname(path))
               File.write(path, content)
-              success_result(
+
+              result = success_result(
                 message: "Generated #{default_filename}",
                 path: path,
                 lines: content.lines.count
               )
+              result[:backup] = backup_result if backup_result
+              result
             else
               success_result(
                 content: content,
@@ -146,6 +380,36 @@ module Appydave
               )
             end
           end
+
+          def backup_existing_file(path)
+            return nil unless File.exist?(path)
+
+            # Create backup directory
+            dir = File.dirname(path)
+            filename = File.basename(path, '.*')
+            backup_dir = File.join(dir, 'backups', filename)
+            FileUtils.mkdir_p(backup_dir)
+
+            # Generate timestamped backup filename
+            timestamp = Time.now.strftime('%Y-%m-%d-%H%M%S')
+            ext = File.extname(path)
+            backup_path = File.join(backup_dir, "#{timestamp}#{ext}")
+
+            # Copy existing file to backup
+            FileUtils.cp(path, backup_path)
+
+            # Clean up old backups (keep last N)
+            cleanup_old_backups(backup_dir, ext)
+
+            backup_path
+          end
+
+          def cleanup_old_backups(backup_dir, ext)
+            backups = Dir.glob(File.join(backup_dir, "*#{ext}")).sort.reverse
+            return if backups.length <= MAX_BACKUPS
+
+            backups[MAX_BACKUPS..].each { |f| File.delete(f) }
+          end
         end
       end
     end

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.71.1'
+    VERSION = '0.73.0'
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.71.1",
+  "version": "0.73.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.71.1
+  version: 0.73.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-15 00:00:00.000000000 Z
+date: 2025-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel