appydave-tools 0.72.0 → 0.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 584067a790d262ecf04ab52f20557fc879db4cf968928199ae279438afddc0e9
-  data.tar.gz: c2d31308bd43b6e93e66bbdcff15bcde169fe6cde278de0d03a793c4dc605e1c
+  metadata.gz: 44ca2e425677ffd01f35cbad749a7cf026321e30e8133b2db75b08d3062407e6
+  data.tar.gz: e6555b956b2d404689761382faecf83458eefdb9453fbdfbc7fdb1406f37b585
 SHA512:
-  metadata.gz: 6f8d108fd12581e5e22d1d4125c85794f0df4e94ea8f626dddf1e26bdfcde423bccee1325e4548a5b55c0f33c9f87e7aaaa1d55ead202b8010caa766afdf90ef
-  data.tar.gz: 95b5b25e5b1d6816f271a0a12cb6cfd57ce53652c23fc1fdb34e6eed31eefc5fc63bd5381ea812355184f410d7537f81329ff34fd312cc0b7345727c9dc561ca
+  metadata.gz: 88a430612add3c650c890797874ad17332bbd8c4507bfa2e847e310cbec6b659f719fdfa7db47f2a672e22080ad070cc026fb1fbf66b028b740babac7261502a
+  data.tar.gz: ab498bebd3971c75d7bc222af0c1c5405568c78e2d6fbec47a9d64818f78df8504c720cbd8c25a3ac48356e2e7ba586520f345074d157799d974e789b8a48c8b

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.73.0](https://github.com/appydave/appydave-tools/compare/v0.72.0...v0.73.0) (2025-12-18)
+
+
+### Features
+
+* add smart grouping and auto-backup to jump generate aliases ([aedc533](https://github.com/appydave/appydave-tools/commit/aedc533f9a9fd158de806830f7c495dd4d1b011b))
+
+# [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)
 
 

data/docs/templates/settings.example.json

@@ -2,5 +2,6 @@
   "video-projects-root": "/Users/YOUR_USERNAME/dev/video-projects",
   "ecamm-recording-folder": "/Users/YOUR_USERNAME/ecamm",
   "download-folder": "/Users/YOUR_USERNAME/Downloads",
-  "download-image-folder": "/Users/YOUR_USERNAME/Downloads/images"
+  "download-image-folder": "/Users/YOUR_USERNAME/Downloads/images",
+  "aliases-output-path": "~/.oh-my-zsh/custom/aliases-jump.zsh"
 }

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

@@ -32,6 +32,12 @@ module Appydave
             get('download-image-folder') || download_folder
           end
 
+          # Default output path for jump generate aliases command
+          # Used by auto-regenerate after CRUD operations
+          def aliases_output_path
+            get('aliases-output-path')
+          end
+
           def current_user
             get('current_user')
           end

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

@@ -158,6 +158,7 @@ module Appydave
 
         def run_add(args)
           format = format_option(args)
+          no_generate = args.delete('--no-generate')
           attrs = parse_location_args(args)
 
           if attrs[:key].nil?
@@ -169,11 +170,19 @@ module Appydave
           result = cmd.run
 
           format_output(result, format)
+
+          # Auto-regenerate aliases after successful add
+          if result[:success] && !no_generate
+            regenerate_result = auto_regenerate_aliases
+            output_regenerate_result(regenerate_result) if regenerate_result
+          end
+
           exit_code_for(result)
         end
 
         def run_update(args)
           format = format_option(args)
+          no_generate = args.delete('--no-generate')
           key = args.shift
           attrs = parse_location_args(args)
 
@@ -186,11 +195,19 @@ module Appydave
           result = cmd.run
 
           format_output(result, format)
+
+          # Auto-regenerate aliases after successful update
+          if result[:success] && !no_generate
+            regenerate_result = auto_regenerate_aliases
+            output_regenerate_result(regenerate_result) if regenerate_result
+          end
+
           exit_code_for(result)
         end
 
         def run_remove(args)
           format = format_option(args)
+          no_generate = args.delete('--no-generate')
           force = args.delete('--force')
           key = args.first
 
@@ -203,6 +220,13 @@ module Appydave
           result = cmd.run
 
           format_output(result, format)
+
+          # Auto-regenerate aliases after successful remove
+          if result[:success] && !no_generate
+            regenerate_result = auto_regenerate_aliases
+            output_regenerate_result(regenerate_result) if regenerate_result
+          end
+
           exit_code_for(result)
         end
 
@@ -331,6 +355,36 @@ module Appydave
           value
         end
 
+        # Auto-regenerate helpers
+
+        def auto_regenerate_aliases
+          output_path = aliases_output_path
+          return nil unless output_path
+
+          cmd = Commands::Generate.new(
+            load_config,
+            'aliases',
+            output_path: output_path,
+            path_validator: path_validator
+          )
+          cmd.run
+        end
+
+        def aliases_output_path
+          Configuration::Config.configure
+          Configuration::Config.settings.aliases_output_path
+        rescue StandardError
+          nil
+        end
+
+        def output_regenerate_result(result)
+          return unless result[:success]
+
+          output.puts ''
+          output.puts "Backed up: #{result[:backup]}" if result[:backup]
+          output.puts "Regenerated: #{result[:path]} (#{result[:lines]} lines)"
+        end
+
         # Help display methods
 
         def show_version
@@ -451,10 +505,16 @@ module Appydave
               --type, -t <type>     Location type (tool, gem, brand, etc.)
               --tags <t1,t2>        Comma-separated tags
               --description, -d     Human description
+              --no-generate         Skip auto-regenerating aliases file
+
+            Auto-Regeneration:
+              After a successful add, the aliases file is automatically regenerated
+              if 'aliases-output-path' is set in settings.json.
 
             Examples:
               jump add --key my-project --path ~/dev/my-project
-              jump add -k ad-tools -p ~/dev/ad/appydave-tools --brand appydave --type tool --tags ruby,cli
+              jump add -k ad-tools -p ~/dev/ad/appydave-tools --brand appydave --type tool
+              jump add --key temp-proj --path ~/tmp/proj --no-generate
           HELP
         end
 
@@ -472,10 +532,16 @@ module Appydave
               --type, -t <type>     New type
               --tags <t1,t2>        New tags (replaces existing)
               --description, -d     New description
+              --no-generate         Skip auto-regenerating aliases file
+
+            Auto-Regeneration:
+              After a successful update, the aliases file is automatically regenerated
+              if 'aliases-output-path' is set in settings.json.
 
             Examples:
               jump update my-project --description "Updated description"
               jump update ad-tools --tags ruby,cli,youtube
+              jump update my-project --path ~/new/path --no-generate
           HELP
         end
 
@@ -483,12 +549,19 @@ module Appydave
           output.puts <<~HELP
             jump remove - Remove a location
 
-            Usage: jump remove <key> --force
+            Usage: jump remove <key> --force [--no-generate]
+
+            Options:
+              --force               Required to confirm deletion
+              --no-generate         Skip auto-regenerating aliases file
 
-            The --force flag is required to prevent accidental deletions.
+            Auto-Regeneration:
+              After a successful remove, the aliases file is automatically regenerated
+              if 'aliases-output-path' is set in settings.json.
 
             Examples:
               jump remove old-project --force
+              jump remove temp-project --force --no-generate
           HELP
         end
 

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

@@ -7,6 +7,18 @@ module Appydave
         # Generate command creates shell aliases and help content
         class Generate < Base
           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
 
@@ -82,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
+
+            sections.each do |section|
+              # Add major section separator if needed
+              if section[:major]
+                lines << '# ========================================'
+                lines << "# #{section[:title]}"
+                lines << '# ========================================'
+              else
+                lines << "# #{section[:title]}"
+              end
 
-            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}"
+              section[:locations].each do |loc|
+                path = format_display_path(loc.path)
+                lines << "alias #{loc.jump}=\"cd #{path}\""
               end
+
               lines << ''
             end
 
@@ -230,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,
@@ -246,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.72.0'
+    VERSION = '0.74.0'
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.72.0",
+  "version": "0.74.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.72.0
+  version: 0.74.0
 platform: ruby
 authors:
 - David Cruwys