appydave-tools 0.42.0 → 0.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f44cb8148a1bcc045a23b0f4b88a1b76c9a609756572bffa4c5796d6d003df3
-  data.tar.gz: 20125e106e76f74440295f46e50d2e7b413776c9424811d1552383a0f278541b
+  metadata.gz: '048d2c3c2d7794aedd8dc635545cf6d8d25839fc53ef961493eea00f01b190d1'
+  data.tar.gz: 0aaa8b8a8ac1bf2dac8fa820c77393c0d064560eef8a24a5cd244fe3d35f947e
 SHA512:
-  metadata.gz: 3dccf3450efdd0d9b62dcc181b4d8e46144ddbc7eac989949efc777be721f9160facfcde563c72839791330f9b467e705bc0fc9fee166ee5ee6dfcd6b613fbfe
-  data.tar.gz: 24ad562b73095c83a79c8d51b3d35aa0ab027d724fb2e03059c0c4d41e078321d47c5d271f7c7e96fa52c226d08ede3b9e8eaa7992baad2dfc6c352e83befcdb
+  metadata.gz: c2d7411b7b375d2245af75ec9c4195704b99e77fb6f0df3e8713c0a07f060894b4f79c971eb15b8206a9ca0dd0bbb82c5e7c86cf35c3e77acbb4678abcc299a2
+  data.tar.gz: 2070d581ea14c80dac4f11b3a4ec3f0a0fde2b8f17ce08d99ead29cd06358b11ef05b7d285bc83f66d09f4a444c2c7d2109db394a46cc6fb5fc29f639e7122ba

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.43.0](https://github.com/appydave/appydave-tools/compare/v0.42.0...v0.43.0) (2025-11-21)
+
+
+### Features
+
+* improve DAM error messages with helpful hints and match counts ([bb4e71e](https://github.com/appydave/appydave-tools/commit/bb4e71ea064b131b7df05e61e98eefc858cbb610))
+
+# [0.42.0](https://github.com/appydave/appydave-tools/compare/v0.41.0...v0.42.0) (2025-11-21)
+
+
+### Features
+
+* enhance DAM CLI with version flag, improved help system, and better error messages ([086ee99](https://github.com/appydave/appydave-tools/commit/086ee99dca632c797a2783880b5eb038f7a2d6ed))
+
 # [0.41.0](https://github.com/appydave/appydave-tools/compare/v0.40.0...v0.41.0) (2025-11-21)
 
 

data/lib/appydave/tools/dam/project_listing.rb

@@ -61,6 +61,12 @@ module Appydave
 
           if projects.empty?
             puts "⚠️  No projects found for brand: #{brand}"
+            puts ''
+            puts '   This could mean:'
+            puts '   - The brand exists but has no project directories'
+            puts '   - The manifest needs updating'
+            puts ''
+            puts "   Try: dam manifest #{brand_arg}"
             return
           end
 
@@ -74,22 +80,25 @@ module Appydave
               name: project,
               path: project_path,
               size: size,
-              modified: modified
+              modified: modified,
+              age: format_age(modified),
+              stale: stale?(modified)
             }
           end
 
           # Print table header
           puts "Projects in #{brand}:"
-          puts 'PROJECT                                               SIZE        LAST MODIFIED    PATH'
+          puts 'PROJECT                                               SIZE             AGE    PATH'
           puts '-' * 120
 
           # Print table rows
           project_data.each do |data|
+            age_display = data[:stale] ? "#{data[:age]} ⚠️" : data[:age]
             puts format(
-              '%-45s %12s %20s    %s',
+              '%-45s %12s %15s    %s',
               data[:name],
               format_size(data[:size]),
-              format_date(data[:modified]),
+              age_display,
               shorten_path(data[:path])
             )
           end
@@ -105,6 +114,13 @@ module Appydave
 
           if matches.empty?
             puts "⚠️  No projects found matching pattern: #{pattern}"
+            puts ''
+            puts '   Pattern tips:'
+            puts '   - Use * for wildcards: b6* matches b60-b69'
+            puts '   - Use ? for single character: b6? matches b60-b69'
+            puts '   - Patterns are case-insensitive'
+            puts ''
+            puts "   Try: dam list #{brand_arg}  # See all projects"
             return
           end
 
@@ -118,22 +134,26 @@ module Appydave
               name: project,
               path: project_path,
               size: size,
-              modified: modified
+              modified: modified,
+              age: format_age(modified),
+              stale: stale?(modified)
             }
           end
 
           # Print table header
-          puts "Projects matching '#{pattern}' in #{brand}:"
-          puts 'PROJECT                                               SIZE        LAST MODIFIED    PATH'
+          match_count = matches.size
+          puts "#{match_count} project#{'s' if match_count != 1} matching '#{pattern}' in #{brand}:"
+          puts 'PROJECT                                               SIZE             AGE    PATH'
           puts '-' * 120
 
           # Print table rows
           project_data.each do |data|
+            age_display = data[:stale] ? "#{data[:age]} ⚠️" : data[:age]
             puts format(
-              '%-45s %12s %20s    %s',
+              '%-45s %12s %15s    %s',
               data[:name],
               format_size(data[:size]),
-              format_date(data[:modified]),
+              age_display,
               shorten_path(data[:path])
             )
           end
@@ -169,6 +189,40 @@ module Appydave
           time.strftime('%Y-%m-%d %H:%M')
         end
 
+        # Format age as relative time (e.g., "3 days", "2 weeks")
+        def self.format_age(time)
+          return 'N/A' if time.nil?
+
+          seconds = Time.now - time
+          return 'just now' if seconds < 60
+
+          minutes = seconds / 60
+          return "#{minutes.round}m" if minutes < 60
+
+          hours = minutes / 60
+          return "#{hours.round}h" if hours < 24
+
+          days = hours / 24
+          return "#{days.round}d" if days < 7
+
+          weeks = days / 7
+          return "#{weeks.round}w" if weeks < 4
+
+          months = days / 30
+          return "#{months.round}mo" if months < 12
+
+          years = days / 365
+          "#{years.round}y"
+        end
+
+        # Check if project is stale (>90 days old)
+        def self.stale?(time)
+          return false if time.nil?
+
+          days = (Time.now - time) / 86_400 # seconds in a day
+          days > 90
+        end
+
         # Shorten path by replacing home directory with ~
         def self.shorten_path(path)
           path.sub(Dir.home, '~')

data/lib/appydave/tools/dam/project_resolver.rb

@@ -67,7 +67,10 @@ module Appydave
                          .map { |path| File.basename(path) }
                          .sort
 
-            raise "❌ No projects found matching pattern '#{pattern}' in #{projects_dir}" if matches.empty?
+            if matches.empty?
+              raise "❌ No projects found matching pattern '#{pattern}'\n   " \
+                    "Try: dam list #{brand}  # See all available projects"
+            end
 
             matches
           end

data/lib/appydave/tools/dam/s3_operations.rb

@@ -444,6 +444,8 @@ module Appydave
 
           unless Dir.exist?(project_dir)
             puts "❌ Project not found: #{project_dir}"
+            puts ''
+            puts "   Try: dam list #{brand}  # See available projects"
             return
           end
 

data/lib/appydave/tools/dam/status.rb

@@ -48,7 +48,11 @@ module Appydave
 
           unless project_entry
             puts '❌ Project not found in manifest'
-            puts "   Run: dam manifest #{brand}"
+            puts ''
+            puts '   This project exists locally but is not in the manifest.'
+            puts ''
+            puts "   Try: dam manifest #{brand}  # Regenerate manifest"
+            puts "   Or:  dam list #{brand}      # See tracked projects"
             return
           end
 

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.42.0'
+    VERSION = '0.44.0'
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.42.0",
+  "version": "0.44.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.42.0
+  version: 0.44.0
 platform: ruby
 authors:
 - David Cruwys