appydave-tools 0.41.0 → 0.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d87056ef6a0201fc1d722295aec17a46fa2c53a7581e9236db94369c8425ea9d
-  data.tar.gz: 24eadac450c656d2c4f0e38b36a0683a2fa096c02df913d97c580d6c7e109c34
+  metadata.gz: abc6dfb0d67bcfeae2ed2bd59c51e5926b35948c57957226975a19f02ab835b1
+  data.tar.gz: dfb7b9e5a59260a87a9741edee11d2eb91cde891bf724ab7e312d40cdce78d7d
 SHA512:
-  metadata.gz: 4390b2ec24eda2540a79fcb9dc0edea9c40d9d50e2cbf9720c56fa624071677a1e97f15be23f1cc63a7dbcb56c2a453bd28722154f0fbe0376689f6992110a79
-  data.tar.gz: fc43acf77aeb8c132cc1ed02172366b4eadfee12b50bcbe138694cfc4ff1e00fd6fbfb847a12046ee0b81576fdb9a18214a9a88d341e7fb05d65b95407d77517
+  metadata.gz: 494ba66d882da3ed30f0ae7adb93a1459d45b550aca1f04d15d636b2fac16dc423f2a94125dbf0489cb42b662d859d7da915a110adb2a61248f9728d8f1e273f
+  data.tar.gz: b3d7dae675807d99fe02c612eb25fc6d0627e4eb34af4da153c4e7c56b242b23589b0711e0ba15120be4afb1eb7c797716fdfdbb4c92776e43680a70dff28478

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Features
+
+* improve DAM UX - better error messages, timestamps, and status display ([cba0cc7](https://github.com/appydave/appydave-tools/commit/cba0cc70851005a57331956df6b648c173bc0846))
+
 # [0.40.0](https://github.com/appydave/appydave-tools/compare/v0.39.0...v0.40.0) (2025-11-21)
 
 

data/bin/dam

@@ -34,12 +34,29 @@ class VatCLI
     }
   end
 
+  # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
   def run
     command, *args = ARGV
 
+    # Handle --version and -v flags
+    if ['--version', '-v'].include?(command)
+      puts "DAM (Digital Asset Management) v#{Appydave::Tools::VERSION}"
+      puts 'Part of appydave-tools gem'
+      exit
+    end
+
     if command.nil?
       puts 'DAM - Video Asset Tools'
+      puts "Version: #{Appydave::Tools::VERSION}"
+      puts ''
       puts 'Usage: dam [command] [options]'
+      puts ''
+      puts 'Common commands:'
+      puts '  dam list                    # List all brands'
+      puts '  dam list <brand>            # List projects for a brand'
+      puts '  dam status <brand>          # Show brand status'
+      puts '  dam s3-up <brand> <project> # Upload to S3'
+      puts ''
       puts "Run 'dam help' for more information."
       exit
     end
@@ -47,20 +64,31 @@ class VatCLI
     if @commands.key?(command)
       @commands[command].call(args)
     else
-      puts "Unknown command: #{command}"
-      puts "Run 'dam help' for available commands."
+      puts "❌ Unknown command: #{command}"
+      puts ''
+      puts 'Available commands:'
+      puts '  list, status, manifest'
+      puts '  s3-up, s3-down, s3-status, s3-cleanup-remote, s3-cleanup-local'
+      puts '  archive, sync-ssd'
+      puts '  repo-status, repo-sync, repo-push'
+      puts '  s3-share, s3-discover, s3-scan'
+      puts ''
+      puts "Run 'dam help' for detailed information."
       exit 1
     end
   end
+  # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
 
   private
 
   # Show help information
-  # rubocop:disable Metrics/CyclomaticComplexity
+  # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
   def help_command(args)
     topic = args[0]
 
     case topic
+    when 'help'
+      show_help_about_help
     when 'brands'
       show_brands_help
     when 'workflows'
@@ -80,11 +108,24 @@ class VatCLI
       puts "⚠️  '#{topic}' is deprecated. Use the new command name instead:\n\n"
       new_name = topic == 's3-cleanup' ? 's3-cleanup-remote' : 's3-cleanup-local'
       show_s3_help(new_name)
-    else
+    when nil
       show_main_help
+    else
+      puts "❌ Unknown help topic: #{topic}"
+      puts ''
+      puts 'Available help topics:'
+      puts '  dam help brands      # Brand shortcuts and configuration'
+      puts '  dam help workflows   # FliVideo and Storyline workflows'
+      puts '  dam help config      # Configuration setup'
+      puts '  dam help list        # List command usage'
+      puts '  dam help s3-up       # S3 upload command'
+      puts '  dam help s3-down     # S3 download command'
+      puts '  dam help s3-status   # S3 status command'
+      puts ''
+      puts "Run 'dam help' for general help."
     end
   end
-  # rubocop:enable Metrics/CyclomaticComplexity
+  # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
 
   # List brands and projects
   def list_command(args)
@@ -729,6 +770,39 @@ class VatCLI
     HELP
   end
 
+  def show_help_about_help
+    puts <<~HELP
+      DAM Help System
+
+      The DAM CLI provides contextual help for all commands and concepts.
+
+      Usage:
+        dam help                Show general help (all commands)
+        dam help <topic>        Show help for specific topic
+
+      Available Help Topics:
+        brands     Brand shortcuts and naming (appydave, voz, aitldr, etc.)
+        workflows  FliVideo vs Storyline workflows explained
+        config     Configuration file setup and paths
+        list       List command usage and pattern matching
+        s3-up      S3 upload command details
+        s3-down    S3 download command details
+        s3-status  S3 sync status command details
+
+      Tips:
+        - Most commands support --dry-run to preview actions
+        - Brand shortcuts are case-insensitive (ad, AD, Ad all work)
+        - Use patterns like 'b6*' to match multiple projects
+        - Run 'dam --version' to check your installed version
+
+      Examples:
+        dam help brands          # Learn about brand configuration
+        dam help workflows       # Understand video workflows
+        dam help config          # Setup configuration files
+        dam help s3-up           # S3 upload command help
+    HELP
+  end
+
   def show_brands_help
     puts <<~HELP
       Available Brands

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
 
@@ -105,6 +111,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
 
@@ -123,7 +136,8 @@ module Appydave
           end
 
           # Print table header
-          puts "Projects matching '#{pattern}' in #{brand}:"
+          match_count = matches.size
+          puts "#{match_count} project#{'s' if match_count != 1} matching '#{pattern}' in #{brand}:"
           puts 'PROJECT                                               SIZE        LAST MODIFIED    PATH'
           puts '-' * 120
 

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.41.0'
+    VERSION = '0.43.0'
   end
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.41.0",
+  "version": "0.43.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.41.0
+  version: 0.43.0
 platform: ruby
 authors:
 - David Cruwys