appydave-tools 0.18.3 → 0.18.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 224b91f6d2a3b037091d744166f54b656f408695edd9a3b4d5f8f0599f84c841
-  data.tar.gz: aad4d21145e880dd65b31073e3c83e5165173638d4192a35d1da836d75159d60
+  metadata.gz: 13697577cf21ab548b3ab152ad3a12194cf26c034eeaf2fdf5325b49730fe120
+  data.tar.gz: b1d7ee7daf7b60c00b80b0ec399ca7d5664d38d41cdacec959f8f8ba3f440d64
 SHA512:
-  metadata.gz: bf4d62d414afa97cd91115b7cea9e534d81641da2483528e551d4dcd043338055f8edd6be206ce0e8e0c3a1a8746568c1662110f275956c4b02fd2a201708f46
-  data.tar.gz: 198cf5f25d43543b9cc7861cfde567a3452ae35f5c18c9e525e9958fd3efe8fc2c9fb0af751123f3df2bfd5f40f47e4e943a89a188736e8056df27d7f9d8b71b
+  metadata.gz: 8d6d9643703e76b3946ca0f5923b74972e04b3981a5cd2ca3ebbac315d2d42c98064dc5e6dc12dbc0833073e1b7b36c5b41f1276b38acb5a01dd86802f7aabce
+  data.tar.gz: 390852362fe0ecc9c45bf4c45bfb87ef8fc697051026b89e3f93eacdfd55a8ed9796f2892870e2d661ab4491fc0183ac07d4046ae6051588fe4111b1b0140c21

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.18.3](https://github.com/appydave/appydave-tools/compare/v0.18.2...v0.18.3) (2025-11-10)
+
+
+### Bug Fixes
+
+* resolve archived structure detection and range folder calculation for DAM manifest and sync ([dec1400](https://github.com/appydave/appydave-tools/commit/dec1400c561f11959fb6aecd7761e916ca525082))
+* resolve rubocop violations in manifest_generator (refactor build_project_entry, simplify SSD check) ([ced61be](https://github.com/appydave/appydave-tools/commit/ced61be41c3da352831d46e3486968f5ee55842c))
+
 ## [0.18.2](https://github.com/appydave/appydave-tools/compare/v0.18.1...v0.18.2) (2025-11-10)
 
 

data/docs/dam/usage.md

@@ -561,17 +561,70 @@ dam s3-down
 dam s3-status
 ```
 
-### Dry-Run Mode
+### Command Safety Features
 
-Preview actions without making changes:
+#### Dry-Run Support
+
+All filesystem-modifying commands support `--dry-run` to preview changes before execution:
+
+| Command | Dry-Run Support | Force Flag Required | What It Previews |
+|---------|----------------|---------------------|------------------|
+| **s3-up** | ✅ Yes | No | Files to upload to S3 |
+| **s3-down** | ✅ Yes | No | Files to download from S3 |
+| **s3-cleanup-remote** | ✅ Yes | **Yes (`--force`)** | S3 files to delete |
+| **s3-cleanup-local** | ✅ Yes | **Yes (`--force`)** | Local s3-staging files to delete |
+| **archive** | ✅ Yes | Optional (`--force` = delete local) | Project to copy to SSD |
+| **sync-ssd** | ✅ Yes | No | Light files to restore from SSD |
+
+#### Read-Only Commands (No Dry-Run Needed)
+
+These commands only read data and don't modify files:
+
+| Command | Type | What It Does |
+|---------|------|--------------|
+| **list** | Read-only | List brands/projects |
+| **manifest** | Generates JSON | Generate `projects.json` manifest |
+| **s3-status** | Read-only | Check sync status |
+| **help** | Read-only | Show help information |
+
+#### Safety Workflow Examples
+
+**Always preview destructive operations first:**
 
 ```bash
+# Preview S3 upload
 dam s3-up appydave b65 --dry-run
-dam s3-down voz boy-baker --dry-run
-dam s3-cleanup-remote aitldr movie-posters --dry-run
-dam s3-cleanup-local appydave b65 --dry-run
+# Review output, then execute
+dam s3-up appydave b65
+
+# Preview S3 cleanup (requires --force)
+dam s3-cleanup-remote appydave b65 --force --dry-run
+# Review output, then execute
+dam s3-cleanup-remote appydave b65 --force
+
+# Preview archive (with or without local deletion)
+dam archive appydave b63 --dry-run              # Copy only
+dam archive appydave b63 --force --dry-run      # Copy + delete local
+# Review output, then execute
+dam archive appydave b63                        # Copy only
+dam archive appydave b63 --force                # Copy + delete local
+
+# Preview SSD sync
+dam sync-ssd appydave --dry-run
+# Review output, then execute
+dam sync-ssd appydave
 ```
 
+#### Force Flag Behavior
+
+Commands requiring `--force` provide extra protection for destructive operations:
+
+- **s3-cleanup-remote**: Must use `--force` to delete S3 files (prevents accidental deletion)
+- **s3-cleanup-local**: Must use `--force` to delete local staging files
+- **archive**: Optional `--force` flag deletes local copy after successful SSD backup
+  - Without `--force`: Copies to SSD, keeps local copy intact
+  - With `--force`: Copies to SSD, then deletes local copy (frees disk space)
+
 ### Interactive Selection
 
 When multiple projects match short name:

data/docs/dam/vat-testing-plan.md

@@ -113,6 +113,62 @@ dam list
 
 ---
 
+## Command Safety Features Reference
+
+### Dry-Run and Force Flag Support
+
+All filesystem-modifying commands support `--dry-run` to preview changes before execution:
+
+| Command | Dry-Run Support | Force Flag Required | What It Does |
+|---------|----------------|---------------------|--------------|
+| **s3-up** | ✅ Yes | No | Preview files to upload to S3 |
+| **s3-down** | ✅ Yes | No | Preview files to download from S3 |
+| **s3-cleanup-remote** | ✅ Yes | **Yes (`--force`)** | Preview S3 files to delete |
+| **s3-cleanup-local** | ✅ Yes | **Yes (`--force`)** | Preview local s3-staging files to delete |
+| **archive** | ✅ Yes | Optional (`--force` = delete local) | Preview project copy to SSD |
+| **sync-ssd** | ✅ Yes | No | Preview light files to restore from SSD |
+
+### Read-Only Commands (No Dry-Run Needed)
+
+These commands only read data and don't modify files:
+
+| Command | Type | What It Does |
+|---------|------|--------------|
+| **list** | Read-only | List brands/projects |
+| **manifest** | Generates JSON | Generate `projects.json` manifest |
+| **s3-status** | Read-only | Check sync status |
+| **help** | Read-only | Show help information |
+
+### Force Flag Behavior
+
+Commands requiring `--force` provide extra protection for destructive operations:
+
+- **s3-cleanup-remote**: Must use `--force` to delete S3 files (prevents accidental deletion)
+- **s3-cleanup-local**: Must use `--force` to delete local staging files
+- **archive**: Optional `--force` flag deletes local copy after successful SSD backup
+  - Without `--force`: Copies to SSD, keeps local copy intact
+  - With `--force`: Copies to SSD, then deletes local copy (frees disk space)
+
+### Safety Testing Workflow
+
+**Always test with dry-run first:**
+
+```bash
+# 1. Preview with dry-run
+dam s3-up appydave b65 --dry-run
+dam s3-cleanup-remote appydave b65 --force --dry-run
+dam archive appydave b63 --dry-run
+
+# 2. Review output carefully
+
+# 3. Execute if safe
+dam s3-up appydave b65
+dam s3-cleanup-remote appydave b65 --force
+dam archive appydave b63
+```
+
+---
+
 ## Test Suite
 
 ### Phase 1: Unit Tests (Automated - RSpec)

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.18.3'
+    VERSION = '0.18.4'
   end
 end

data/package.json

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