appydave-tools 0.72.0 → 0.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 584067a790d262ecf04ab52f20557fc879db4cf968928199ae279438afddc0e9
-  data.tar.gz: c2d31308bd43b6e93e66bbdcff15bcde169fe6cde278de0d03a793c4dc605e1c
+  metadata.gz: 53447fe92cfd604234875affe143a083bc07b267ccf92ad11782e6640e440fa6
+  data.tar.gz: 74ed454547b2f4a3a5d859ca1bc41228b7efc340dc31c8f3a174b6ff4e1774dd
 SHA512:
-  metadata.gz: 6f8d108fd12581e5e22d1d4125c85794f0df4e94ea8f626dddf1e26bdfcde423bccee1325e4548a5b55c0f33c9f87e7aaaa1d55ead202b8010caa766afdf90ef
-  data.tar.gz: 95b5b25e5b1d6816f271a0a12cb6cfd57ce53652c23fc1fdb34e6eed31eefc5fc63bd5381ea812355184f410d7537f81329ff34fd312cc0b7345727c9dc561ca
+  metadata.gz: 61ab02e5529f5a95be3aeeb85674e2f92d9db9d13571aafefc6569cec9f30f967a5d79b48885ad2f636816b50380c39ecdaf67d05b3d403c25ce06517efb8761
+  data.tar.gz: db15735eb6b14e5060a9f533231067222402edff360e5034e997c03483b8755692751ce54e95628eea2893e2f649c75a7f9af6e625c7c1be661c8f392d2908e9

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [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/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.73.0'
   end
 end

data/package.json

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