appydave-tools 0.40.0 → 0.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9610c23fa022740f9082e2bd0086bf7727cfe96437309b099a1bc5fbe55f58ea
-  data.tar.gz: d556ee4ced131cfc9f7b8244edf9c2c464d5d3692a669cb0f7102831fccf1689
+  metadata.gz: 1f44cb8148a1bcc045a23b0f4b88a1b76c9a609756572bffa4c5796d6d003df3
+  data.tar.gz: 20125e106e76f74440295f46e50d2e7b413776c9424811d1552383a0f278541b
 SHA512:
-  metadata.gz: f337f930defe037888a8ebc8dd19f6562519b39170b33a8944e68cc050059a65902d41c788d6cafa2c6132b2d2ee6f408ad54a420ce68c1bb74fb392ab9dc716
-  data.tar.gz: f7f0933afa44c8e3a79aa3ceb6b53db950d0acb9e3b5ba17daf3acc46eafc97afd19071c0e335485d3345c08c9218c2285f5dcc0f74332bd87a3bf136a7dc210
+  metadata.gz: 3dccf3450efdd0d9b62dcc181b4d8e46144ddbc7eac989949efc777be721f9160facfcde563c72839791330f9b467e705bc0fc9fee166ee5ee6dfcd6b613fbfe
+  data.tar.gz: 24ad562b73095c83a79c8d51b3d35aa0ab027d724fb2e03059c0c4d41e078321d47c5d271f7c7e96fa52c226d08ede3b9e8eaa7992baad2dfc6c352e83befcdb

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Features
+
+* add S3 overwrite warnings with timestamp comparison to prevent data loss ([e922891](https://github.com/appydave/appydave-tools/commit/e922891d9ae87328f5a7cffe5e827f08232c90cc))
+
 # [0.39.0](https://github.com/appydave/appydave-tools/compare/v0.38.0...v0.39.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

@@ -150,7 +150,7 @@ module Appydave
 
         # Find the most recent modification time across all projects
         def self.find_last_modified(brand, projects)
-          return Time.at(0) if projects.empty?
+          return nil if projects.empty?
 
           projects.map do |project|
             File.mtime(Config.project_path(brand, project))

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

@@ -271,10 +271,21 @@ module Appydave
 
           if s3_files.empty? && local_files.empty?
             puts "❌ No files found in S3 or locally for #{brand}/#{project_id}"
+            puts '   This project has no heavy files in s3-staging/ or S3.'
+            puts "   Tip: Add files to #{File.basename(staging_dir)}/ folder, then run: dam s3-up"
             return
           end
 
           puts "📊 S3 Sync Status for #{brand}/#{project_id}"
+
+          # Show last sync time
+          if s3_files.any?
+            most_recent = s3_files.map { |f| f['LastModified'] }.compact.max
+            if most_recent
+              time_ago = format_time_ago(Time.now - most_recent)
+              puts "   Last synced: #{time_ago} ago (#{most_recent.strftime('%Y-%m-%d %H:%M')})"
+            end
+          end
           puts ''
 
           # Combine all file paths (S3 + local)
@@ -563,6 +574,28 @@ module Appydave
           end
         end
 
+        def format_time_ago(seconds)
+          return 'just now' if seconds < 60
+
+          minutes = seconds / 60
+          return "#{minutes.round} minute#{'s' if minutes > 1}" if minutes < 60
+
+          hours = minutes / 60
+          return "#{hours.round} hour#{'s' if hours > 1}" if hours < 24
+
+          days = hours / 24
+          return "#{days.round} day#{'s' if days > 1}" if days < 7
+
+          weeks = days / 7
+          return "#{weeks.round} week#{'s' if weeks > 1}" if weeks < 4
+
+          months = days / 30
+          return "#{months.round} month#{'s' if months > 1}" if months < 12
+
+          years = days / 365
+          "#{years.round} year#{'s' if years > 1}"
+        end
+
         def detect_content_type(filename)
           ext = File.extname(filename).downcase
           case ext

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

@@ -60,15 +60,6 @@ module Appydave
           puts "📊 Brand Status: v-#{brand}"
           puts ''
 
-          # Show git remote (with self-healing)
-          remote = Config.git_remote(brand)
-          if remote
-            puts "📡 Git Remote: #{remote}"
-          else
-            puts '📡 Git Remote: Not configured (not a git repository)'
-          end
-          puts ''
-
           # Show git status
           if git_repo?
             show_brand_git_status
@@ -108,7 +99,7 @@ module Appydave
           local = project_entry[:storage][:local]
 
           if local[:exists]
-            puts "  📁 Local: ✓ exists (#{local[:structure]} structure)"
+            puts '  📁 Local: ✓ exists'
             puts "     Heavy files: #{local[:has_heavy_files] ? 'yes' : 'no'}"
             puts "     Light files: #{local[:has_light_files] ? 'yes' : 'no'}"
           else

data/lib/appydave/tools/version.rb

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

data/package.json

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