appydave-tools 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa0d28f2da43b19537700a122baaea2401ea5c7b545d687a1bff64150d1c7d88
-  data.tar.gz: 98b8575d8af3b09e0dbc025b076d9b221d0d5b28705ee714a2483f74022c73c6
+  metadata.gz: c9c1294eb12c004bfbf7d5c3af2ad72e70202729867d5b2e1978d6710f573eca
+  data.tar.gz: 4c00d396ba791995706c8caea17eb36b65c0c6142533281ceb83d75e74a90d00
 SHA512:
-  metadata.gz: 2f3c69c161ac3b1ca8642db8d1f6a15317510956ffe396635d6bf2f49e1be6bc6b22c4b5b9e9694b9b40ffbb9214da8487979078740a68a0b2dcec7c07a42ba1
-  data.tar.gz: de05f01bba2420b7c287cd28ac499ca56af5b7277c88522d867280e27be99d821baf2cb9d389beefe0c3e6573b6eee6095c0eafdd1a2806f1e49ec782f0de54f
+  metadata.gz: 9c9e76453f9594c21c6e5a3571369f715eda1c5262fc5e80429776ed1a4e6afc29a6f258c238df3ef68ed3fc6a769dc5186168674aa90c9d0ee8705e2d056da9
+  data.tar.gz: 1dac5dcaa14e3731fff08d6bfb0f3b6128549920503dd6e5869caf89696d40b6e4f745afeade7261d7ccc0a51baa93722b4204b8808b140537c041f393c77703

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.20.1](https://github.com/appydave/appydave-tools/compare/v0.20.0...v0.20.1) (2025-11-10)
+
+
+### Bug Fixes
+
+* remove noisy backup log message from self-healing config saves ([f9dacfd](https://github.com/appydave/appydave-tools/commit/f9dacfd74cce5f991c7f4bafb12d1494aa6ee4ab))
+
+# [0.20.0](https://github.com/appydave/appydave-tools/compare/v0.19.0...v0.20.0) (2025-11-10)
+
+
+### Features
+
+* Phase 2: add unified status and git repo commands (status, repo-status, repo-sync, repo-push) ([c9ff7de](https://github.com/appydave/appydave-tools/commit/c9ff7dee9bd2d60954205df08c23dd673960a524))
+* Phase 2: add unified status and git repo commands (status, repo-status, repo-sync, repo-push) ([b74f343](https://github.com/appydave/appydave-tools/commit/b74f3436e188cfa7dbdff386d35cb96d75f80860))
+
 # [0.19.0](https://github.com/appydave/appydave-tools/compare/v0.18.5...v0.19.0) (2025-11-10)
 
 

data/bin/bank_reconciliation.rb

@@ -3,7 +3,6 @@
 
 $LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 
-require 'pry'
 require 'appydave/tools'
 
 # !/usr/bin/env ruby

data/bin/configuration.rb

@@ -10,7 +10,6 @@
 
 $LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
 
-require 'pry'
 require 'appydave/tools'
 
 options = { keys: [] }

data/bin/dam

@@ -25,6 +25,8 @@ class VatCLI
       'repo-status' => method(:repo_status_command),
       'repo-sync' => method(:repo_sync_command),
       'repo-push' => method(:repo_push_command),
+      's3-share' => method(:s3_share_command),
+      's3-discover' => method(:s3_discover_command),
       # Deprecated aliases (for backward compatibility)
       's3-cleanup' => method(:s3_cleanup_remote_command),
       'cleanup-local' => method(:s3_cleanup_local_command)
@@ -66,6 +68,10 @@ class VatCLI
       show_config_help
     when 'list'
       show_list_help
+    when 's3-share'
+      show_s3_share_help
+    when 's3-discover'
+      show_s3_discover_help
     when 's3-up', 's3-down', 's3-status', 's3-cleanup-remote', 's3-cleanup-local', 'archive', 'manifest', 'sync-ssd'
       show_s3_help(topic)
     when 's3-cleanup', 'cleanup-local'
@@ -151,6 +157,30 @@ class VatCLI
     exit 1
   end
 
+  # Share file via pre-signed URL
+  def s3_share_command(args)
+    options = parse_share_args(args)
+
+    share_ops = Appydave::Tools::Dam::ShareOperations.new(options[:brand], options[:project])
+    share_ops.generate_links(files: options[:file], expires: options[:expires], download: options[:download])
+  rescue StandardError => e
+    puts "❌ Error: #{e.message}"
+    exit 1
+  end
+
+  # Discover files in S3 for a project
+  def s3_discover_command(args)
+    options = parse_discover_args(args)
+    files = fetch_s3_files(options[:brand_key], options[:project_id])
+
+    return if handle_empty_files?(files, options[:brand_key], options[:project_id])
+
+    display_s3_files(files, options[:brand_key], options[:project_id], options[:shareable])
+  rescue StandardError => e
+    puts "❌ Error: #{e.message}"
+    exit 1
+  end
+
   # Archive project to SSD
   def archive_command(args)
     options = parse_s3_args(args, 'archive')
@@ -273,19 +303,14 @@ class VatCLI
     project_arg = args[1]
 
     if brand_arg.nil?
-      # Auto-detect from PWD
-      brand, project_id = Appydave::Tools::Dam::ProjectResolver.detect_from_pwd
-      if brand.nil?
-        puts '❌ Could not auto-detect brand from current directory'
-        puts 'Usage: dam status <brand> [project]'
-        exit 1
-      end
-      brand_key = brand
-    else
-      brand_key = brand_arg
-      project_id = project_arg ? Appydave::Tools::Dam::ProjectResolver.resolve(brand_arg, project_arg) : nil
+      puts '❌ Brand argument required'
+      puts 'Usage: dam status <brand> [project]'
+      exit 1
     end
 
+    brand_key = brand_arg
+    project_id = project_arg ? Appydave::Tools::Dam::ProjectResolver.resolve(brand_arg, project_arg) : nil
+
     status = Appydave::Tools::Dam::Status.new(brand_key, project_id)
     status.show
   rescue StandardError => e
@@ -402,6 +427,113 @@ class VatCLI
     { brand: brand_key, project: project_id, dry_run: dry_run, force: force }
   end
 
+  def parse_share_args(args)
+    # Extract --expires flag
+    expires = '7d' # default
+    if (expires_index = args.index('--expires'))
+      expires = args[expires_index + 1]
+      args.delete_at(expires_index + 1)
+      args.delete_at(expires_index)
+    end
+
+    # Extract --download flag
+    download = args.include?('--download')
+
+    # Remove other flags
+    args = args.reject { |arg| arg.start_with?('--') }
+
+    brand_arg = args[0]
+    project_arg = args[1]
+    file_arg = args[2]
+
+    show_share_usage_and_exit if brand_arg.nil? || project_arg.nil? || file_arg.nil?
+
+    brand_key = brand_arg
+    brand = Appydave::Tools::Dam::Config.expand_brand(brand_arg)
+    project_id = Appydave::Tools::Dam::ProjectResolver.resolve(brand_arg, project_arg)
+
+    # Set ENV for compatibility with ConfigLoader
+    ENV['BRAND_PATH'] = Appydave::Tools::Dam::Config.brand_path(brand)
+
+    { brand: brand_key, project: project_id, file: file_arg, expires: expires, download: download }
+  end
+
+  def show_share_usage_and_exit
+    puts 'Usage: dam s3-share <brand> <project> <file> [--expires 7d] [--download]'
+    puts ''
+    puts 'Options:'
+    puts '  --expires TIME    Expiry time (default: 7d)'
+    puts '  --download        Force download instead of viewing in browser'
+    puts ''
+    puts 'Examples:'
+    puts '  dam s3-share appydave b70 video.mp4'
+    puts '  dam s3-share appydave b70 video.mp4 --expires 24h'
+    puts '  dam s3-share appydave b70 video.mp4 --download'
+    puts '  dam s3-share voz boy-baker final-edit.mov --expires 3d --download'
+    exit 1
+  end
+
+  def parse_discover_args(args)
+    shareable = args.include?('--shareable')
+    args = args.reject { |arg| arg.start_with?('--') }
+
+    brand_arg = args[0]
+    project_arg = args[1]
+
+    if brand_arg.nil? || project_arg.nil?
+      puts 'Usage: dam s3-discover <brand> <project> [--shareable]'
+      puts ''
+      puts 'Examples:'
+      puts '  dam s3-discover appydave b70              # List files'
+      puts '  dam s3-discover appydave b70 --shareable  # Generate share commands'
+      exit 1
+    end
+
+    brand_key = brand_arg
+    brand = Appydave::Tools::Dam::Config.expand_brand(brand_arg)
+    project_id = Appydave::Tools::Dam::ProjectResolver.resolve(brand_arg, project_arg)
+
+    # Set ENV for compatibility with ConfigLoader
+    ENV['BRAND_PATH'] = Appydave::Tools::Dam::Config.brand_path(brand)
+
+    { brand_key: brand_key, project_id: project_id, shareable: shareable }
+  end
+
+  def fetch_s3_files(brand_key, project_id)
+    s3_ops = Appydave::Tools::Dam::S3Operations.new(brand_key, project_id)
+    s3_ops.list_s3_files
+  end
+
+  def handle_empty_files?(files, brand_key, project_id)
+    return false unless files.empty?
+
+    puts "📭 No files found in S3 for #{brand_key}/#{project_id}"
+    puts ''
+    puts 'Upload files first:'
+    puts "  dam s3-up #{brand_key} #{project_id}"
+    true
+  end
+
+  def display_s3_files(files, brand_key, project_id, shareable)
+    puts ''
+    puts "📁 Files in S3: #{brand_key}/#{project_id}"
+    puts ''
+
+    files.each do |file_info|
+      # list_s3_files returns array of hashes with 'Key', 'Size', 'ETag'
+      s3_key = file_info['Key']
+      filename = File.basename(s3_key)
+
+      if shareable
+        puts "dam s3-share #{brand_key} #{project_id} #{filename}"
+      else
+        puts filename
+      end
+    end
+
+    puts ''
+  end
+
   # Help text methods
   # rubocop:disable Metrics/MethodLength
   def show_main_help
@@ -414,6 +546,14 @@ class VatCLI
         help [command]              Show help information
         list [brand] [pattern]      List brands/projects
 
+        Status & Monitoring:
+        status <brand> [project]         Show unified status (local/S3/SSD/git)
+
+        Git Repository Commands:
+        repo-status <brand> [--all]      Check git status for brand repos
+        repo-sync <brand> [--all]        Pull updates for brand repos
+        repo-push <brand> [project]      Push changes for brand repo
+
         S3 Sync Commands:
         s3-up <brand> <project>          Upload to S3 staging
         s3-down <brand> <project>        Download from S3 staging
@@ -421,6 +561,10 @@ class VatCLI
         s3-cleanup-remote <brand> <project>  Delete S3 files
         s3-cleanup-local <brand> <project>   Delete local s3-staging files
 
+        S3 Sharing Commands:
+        s3-discover <brand> <project>    List files available in S3
+        s3-share <brand> <project> <file> Generate shareable pre-signed URL
+
         Archive Commands:
         archive <brand> <project>        Copy project to SSD backup
         manifest <brand> [--all]         Generate project manifest
@@ -438,10 +582,18 @@ class VatCLI
 
       Examples:
         dam list
+        dam status appydave
+        dam status appydave b65
+        dam repo-status appydave
+        dam repo-sync appydave
         dam s3-up appydave b65
         dam s3-down voz boy-baker --dry-run
         dam s3-status appydave b65
-        dam s3-cleanup appydave b65 --force
+        dam s3-discover appydave b70
+        dam s3-discover appydave b70 --shareable
+        dam s3-share appydave b70 video.mp4
+        dam s3-share appydave b70 video.mp4 --expires 24h
+        dam s3-cleanup-remote appydave b65 --force
 
       For more information: https://github.com/appydave/appydave-tools
     HELP
@@ -462,9 +614,9 @@ class VatCLI
         ss        → v-supportsignal    (SupportSignal client)
 
       Usage:
-        dam list                       # Show all brands
-        dam list --summary             # Show brands with project counts
+        dam list                       # Show all brands with counts
         dam list appydave              # List all AppyDave projects
+        dam list appydave 'b6*'        # List AppyDave projects matching pattern
         dam s3-up voz boy-baker        # Upload VOZ project
     HELP
   end
@@ -573,6 +725,108 @@ class VatCLI
     HELP
   end
 
+  def show_s3_share_help
+    puts <<~HELP
+      S3 Share Command - Generate Shareable Pre-Signed URLs
+
+      Generate time-limited secure URLs for sharing video files with clients.
+      Recipients don't need AWS access - just click the link in their browser!
+
+      Usage: dam s3-share <brand> <project> <file> [OPTIONS]
+
+      Options:
+        --expires TIME    Expiry time (default: 7d)
+                         Examples: 24h, 48h, 3d, 7d
+        --download        Force download instead of viewing in browser (default: inline viewing)
+
+      How It Works:
+        1. Generates pre-signed S3 URL (time-limited, secure)
+        2. Copies URL to clipboard automatically
+        3. Shows expiry date/time
+        4. By default: Opens in browser (inline) - perfect for video playback
+        5. With --download: Forces file download
+
+      Examples:
+        dam s3-share appydave b70 video.mp4
+        # → View in browser (default), 7-day expiry
+
+        dam s3-share appydave b70 video.mp4 --download
+        # → Force download, 7-day expiry
+
+        dam s3-share appydave b70 final-edit.mp4 --expires 24h
+        # → View in browser, 24-hour expiry for quick review
+
+        dam s3-share voz boy-baker scene-01.mov --expires 3d --download
+        # → Force download, 3-day expiry for client approval
+
+      Viewing Modes:
+        🎬 Default (inline):  Opens in browser - great for video playback
+        📥 --download flag:   Forces download - better for archiving
+
+      Security:
+        ✅ Time-limited (expires automatically)
+        ✅ Cryptographically signed (can't be tampered with)
+        ✅ No AWS state stored (signature encodes everything)
+        ✅ Revocable (delete S3 file if needed)
+        ⚠️  Anyone with URL can access (don't share publicly)
+
+      Prerequisites:
+        - File must be uploaded to S3 first
+        - Run: dam s3-up <brand> <project>
+
+      Use Cases:
+        - Share videos with clients for review (inline)
+        - Send final files for download (--download)
+        - Provide temporary access to collaborators
+        - Quick video sharing without email attachments
+
+      For more information: https://github.com/appydave/appydave-tools
+    HELP
+  end
+
+  def show_s3_discover_help
+    puts <<~HELP
+      S3 Discover Command - List Files in S3
+
+      Discover what video files exist in S3 for a project.
+      Useful before sharing to see available files.
+
+      Usage: dam s3-discover <brand> <project> [--shareable]
+
+      Modes:
+        Default         List filenames only
+        --shareable     Generate ready-to-run share commands
+
+      Examples:
+        dam s3-discover appydave b70
+        # Output:
+        # xmen.mp4
+        # behind-the-scenes.mov
+
+        dam s3-discover appydave b70 --shareable
+        # Output:
+        # dam s3-share appydave b70 xmen.mp4
+        # dam s3-share appydave b70 behind-the-scenes.mov
+
+      Workflow:
+        1. Upload files: dam s3-up appydave b70
+        2. Discover files: dam s3-discover appydave b70
+        3. Share specific file: dam s3-share appydave b70 xmen.mp4
+
+      Use Cases:
+        - Find files available for sharing
+        - Generate multiple share commands at once
+        - Quick project file listing without downloading
+        - Copy-paste shareable commands for clients
+
+      Prerequisites:
+        - Files must be uploaded to S3 first
+        - Run: dam s3-up <brand> <project>
+
+      For more information: https://github.com/appydave/appydave-tools
+    HELP
+  end
+
   # rubocop:disable Metrics/CyclomaticComplexity
   def show_s3_help(command)
     case command