appydave-tools 0.69.0 → 0.70.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a24c15bc4b23513bde2a68019a63077e627f4a32908dedc8c2af882892809984
-  data.tar.gz: 8c77419c2ce675ac8340ee450a02f7e530d2c59dbbd06c7573e5ec27a8069d6e
+  metadata.gz: de41c00a018f0a3d86bbcd55b61be1fb13dc29b64f9c8a17fb814ba232ae253f
+  data.tar.gz: 823c49af94f5f79d1e9187682fd2d0c7060bc9f5062633f1c7e08a95241f697e
 SHA512:
-  metadata.gz: cb2f7b0f3828607d232a98164058fb1d5c01a90782dcb110a9ac34ed884035482503ae97a57f8ae8850bd23857475fb74fb3788ee48783170c9c6090cdec83ea
-  data.tar.gz: f9cb457726c269bdeee39113683ac60f75c0931425bf7dbd79539e7c4ca784b55d2ef3ab9337ca377d01086a58f965f97bb7fbc12bbbfdf87b91dde10dcde47d
+  metadata.gz: 64de9b070797bfff4451d3f87843c95eeb9e91eb63dfceae8ff3767d482d42b1a6b0313bcaae0225562562f59d245d14604becf9b5d73a433895e7f318fe085c
+  data.tar.gz: e427734ec01fdad21b17c78208b2a85899f382dde7ee6a04ae5e5cf38a51e08ebd671e671d1953458d839db548d3e99d9def1b6ea5ee70514cf482beb25ff1db

data/.rubocop.yml

@@ -21,6 +21,7 @@ Metrics/BlockLength:
     - "**/spec/**/*"
     - "*.gemspec"
     - "bin/gpt_context.rb"
+    - "lib/appydave/tools/dam/project_listing.rb"
   AllowedMethods:
     - configure
     - context
@@ -73,6 +74,7 @@ Naming/VariableNumber:
 Naming/MethodParameterName:
   AllowedNames:
     - as
+    - s3
 Style/EmptyMethod:    
   Exclude:
     - "**/spec/**/*"

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [0.69.0](https://github.com/appydave/appydave-tools/compare/v0.68.0...v0.69.0) (2025-11-22)
+
+
+### Bug Fixes
+
+* disable RedundantFormat cop for intentional header formatting ([e4f03be](https://github.com/appydave/appydave-tools/commit/e4f03be70e101e704a617cc9d0f5bf5df9474070))
+
+
+### Features
+
+* add fuzzy brand matching and improve table alignment ([bce8309](https://github.com/appydave/appydave-tools/commit/bce83093b3834b2f6a3c70d2fa5854b88f88d48b))
+
 # [0.68.0](https://github.com/appydave/appydave-tools/compare/v0.67.0...v0.68.0) (2025-11-22)
 
 

data/CLAUDE.md

@@ -48,6 +48,76 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 - **Shareable individually** - Tools can be featured in standalone videos
 - **Language flexible** - Currently Ruby, could be rewritten if needed
 
+## Documentation Discovery Protocol
+
+**CRITICAL: When user asks about recent changes, work completed, or project history:**
+
+### 1. ALWAYS Check Existing Documentation FIRST
+
+**Check in this order:**
+
+1. **CHANGELOG.md** (PRIMARY SOURCE for recent changes)
+   - Location: `/CHANGELOG.md`
+   - Contains: Complete version history (v0.0.2 → current)
+   - Organized by: Semantic version with Features/Fixes categorized
+   - Updated: Automatically via semantic-release on every release
+   - **Use this for:** "What changed recently?", "What work was done?", "Sprint summary"
+
+2. **Git log** (SECONDARY - only if CHANGELOG lacks detail)
+   - Use for: Commit-level detail, specific date ranges, author information
+   - Command: `git log --since="1 week ago" --oneline`
+
+3. **docs/ folders** (TERTIARY - for architecture/design decisions)
+   - `docs/code-quality/` - Audit reports, retrospectives, UAT plans
+   - `docs/dam/` - DAM-specific requirements and architecture
+   - `docs/usage/` - Tool usage guides
+
+### 2. Before Creating New Documentation
+
+**ALWAYS verify:**
+- ✅ Does it already exist in CHANGELOG.md?
+- ✅ Does it exist in docs/ folders?
+- ✅ Does it exist in existing markdown files?
+- ✅ Is it redundant with automated changelogs?
+
+**Only create new documentation if:**
+- ❌ Information doesn't exist anywhere
+- ❌ Existing docs have gaps
+- ❌ New perspective/format is genuinely needed
+
+### 3. Common Mistakes to Avoid
+
+**DON'T:**
+- ❌ Jump straight to `git log` without checking CHANGELOG.md
+- ❌ Suggest creating new changelogs when CHANGELOG.md exists
+- ❌ Recreate information that's already in automated systems
+- ❌ Ignore existing documentation
+
+**DO:**
+- ✅ Trust CHANGELOG.md as source of truth for version history
+- ✅ Use existing docs before creating new ones
+- ✅ Reference existing documentation in responses
+- ✅ Supplement (not replace) existing docs
+
+### Example: User Asks "What work was done recently?"
+
+**Correct approach:**
+```
+1. Read CHANGELOG.md
+2. Summarize recent versions (e.g., v0.60.0 → v0.69.0)
+3. Group features by theme
+4. Reference specific versions/commits
+5. Supplement with git log if more detail needed
+```
+
+**Incorrect approach:**
+```
+❌ Run git log first
+❌ Manually count commits
+❌ Suggest creating new changelog
+❌ Ignore existing CHANGELOG.md
+```
+
 ## Common Commands
 
 ### Development Setup

data/bin/dam

@@ -130,6 +130,7 @@ class VatCLI
   # List brands and projects
   def list_command(args)
     detailed = args.include?('--detailed')
+    s3 = args.include?('--s3')
     args = args.reject { |arg| arg.start_with?('--') || arg.start_with?('-') }
 
     brand_arg = args[0]
@@ -137,13 +138,13 @@ class VatCLI
 
     if brand_arg.nil?
       # List all brands with summary
-      Appydave::Tools::Dam::ProjectListing.list_brands_with_counts(detailed: detailed)
+      Appydave::Tools::Dam::ProjectListing.list_brands_with_counts(detailed: detailed, s3: s3)
     elsif pattern_arg
       # Pattern matching
       Appydave::Tools::Dam::ProjectListing.list_with_pattern(brand_arg, pattern_arg)
     else
       # Specific brand
-      Appydave::Tools::Dam::ProjectListing.list_brand_projects(brand_arg, detailed: detailed)
+      Appydave::Tools::Dam::ProjectListing.list_brand_projects(brand_arg, detailed: detailed, s3: s3)
     end
   rescue StandardError => e
     puts "❌ Error: #{e.message}"
@@ -956,7 +957,7 @@ class VatCLI
     puts <<~HELP
       List Command
 
-      Usage: dam list [brand] [pattern]
+      Usage: dam list [brand] [pattern] [--s3] [--detailed]
 
       Modes:
         1. List all brands with summary:
@@ -969,10 +970,21 @@ class VatCLI
            dam list appydave 'b6*'       # All projects b60-b69
            dam list appydave 'b4*'       # All projects b40-b49
 
+      Options:
+        --s3          Show S3 sync status (slower, makes AWS API calls)
+        --detailed    Show extended metadata (PATH, SSD, file counts)
+
       Examples:
-        dam list                         # Tabular: brand, project count, size, modified
-        dam list voz                     # Tabular: all VOZ projects with size/date
-        dam list appydave 'b6*'          # Tabular: b60-b69 projects with size/date
+        dam list                         # Fast: brand, project count, size, modified, git
+        dam list --s3                    # Slower: adds S3 SYNC column
+        dam list voz                     # Fast: all VOZ projects (no S3 column)
+        dam list voz --s3                # Slower: VOZ projects with S3 sync status
+        dam list appydave 'b6*'          # Fast: b60-b69 projects
+        dam list appydave --detailed --s3  # Comprehensive: all columns including S3
+
+      Performance Note:
+        The --s3 flag makes AWS API calls for each project, which can be slow.
+        Default view omits S3 status for faster performance.
     HELP
   end
 

data/docs/README.md

@@ -11,6 +11,7 @@
 - **[DAM - Digital Asset Management](./guides/tools/dam/)** - Video project storage orchestration
   - [Usage Guide](./guides/tools/dam/dam-usage.md) ✅
   - [Testing Plan](./guides/tools/dam/dam-testing-plan.md) ✅
+- **[VideoFileNamer](./guides/tools/video-file-namer.md)** - Generate structured video segment filenames ✅
 - **[GPT Context](./guides/tools/gpt-context.md)** - Gather files for AI context ✅
 - **[YouTube Manager](./guides/tools/youtube-manager.md)** - Manage YouTube metadata ✅
 - **[Subtitle Processor](./guides/tools/subtitle-processor.md)** - Clean/merge SRT files ✅