appydave-tools 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0819e2db66666e4729144ba1a8dac0032a5b323f4475f9cdc84459aa9309cd49'
-  data.tar.gz: ce1185ecbf19793175fa91f4a5c3e401df36394349ec454c7c47fa38e2193727
+  metadata.gz: cd677d964c0e8f3f3262afd01281147aea0c2fd85454cac5898080ffc8eabb82
+  data.tar.gz: f76224ae56fc168d0a09025e5eb63080e4e4da61934ffcba39c7a45d91fdfbc3
 SHA512:
-  metadata.gz: d1c6e936fa7d41f160152cf3e037485c9c0e509377f81970df9295cb38bdcc33bfea489da5ab666baa87042d645d609f35048b96826241bc636097c192525015
-  data.tar.gz: b4accc9229eda2cd3777f6828e2a3b6988208033a1a5df55f5c487519321a76845cf908fac1056598231973c26d8a9866ab311307157b30dcac472534d42465f
+  metadata.gz: 45c4fe26c59fb70598ff001513e5f39053967042f06df797ad13b10600cfaa1f6b4002cca6f66d1782e5cee3fd6fa68c175f9f101896b706889ed1838dbf51fe
+  data.tar.gz: 9ed7de2356fffaa3ef7e587a6aa3d0f5db429f352a4f5cc005c00c49ace6e79ef7cfc35ab0e63f4612eba17c6f3043a56f4d6aafd6de00f8979154e432d29306

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [0.17.1](https://github.com/appydave/appydave-tools/compare/v0.17.0...v0.17.1) (2025-11-10)
+
+
+### Bug Fixes
+
+* review and implement codex recomedations ([32811a0](https://github.com/appydave/appydave-tools/commit/32811a0d4e0deda0a7e94c74dacf38c1f67a0e44))
+
+# [0.17.0](https://github.com/appydave/appydave-tools/compare/v0.16.0...v0.17.0) (2025-11-09)
+
+
+### Bug Fixes
+
+* disable RuboCop for standalone bin scripts ([80e0e6a](https://github.com/appydave/appydave-tools/commit/80e0e6ac4a7289707549bc3708d990c6805c17d5))
+* documentation update ([5beb2b6](https://github.com/appydave/appydave-tools/commit/5beb2b65af3c3a256409c7a9067526df2c269851))
+* exclude bin scripts from Naming/PredicateName cop ([1b5d363](https://github.com/appydave/appydave-tools/commit/1b5d3638f8d19a86752792f67e5b7a9ddce91c37))
+
+
+### Features
+
+* add manifest generator ([bc6a4f1](https://github.com/appydave/appydave-tools/commit/bc6a4f14fe90471cd96a1dbc7c5e2900db4f08bb))
+* video asset tools - implement VAT (Digital Asset Management) for multi-brand video projects ([16f29fc](https://github.com/appydave/appydave-tools/commit/16f29fcf48d492747fbf82a203e0d81057385eb0))
+
 # [0.16.0](https://github.com/appydave/appydave-tools/compare/v0.15.0...v0.16.0) (2025-11-08)
 
 

data/CLAUDE.md

@@ -60,7 +60,7 @@ bin/console         # Interactive Ruby console for experimentation
 | **GPT Context** | `gpt_context` | Collect project files for AI context | ⭐ PRIMARY |
 | **YouTube Manager** | `youtube_manager` | CRUD operations on YouTube video metadata | ✅ ACTIVE |
 | **Subtitle Processor** | `subtitle_processor` | Transform SRT files (clean/merge) | ✅ ACTIVE |
-| **VAT (Video Asset Tools)** | `vat` | Multi-tenant video project storage orchestration | ✅ ACTIVE |
+| **DAM (Digital Asset Management)** | `vat` | Multi-tenant video project storage orchestration | ✅ ACTIVE |
 | **Configuration** | `ad_config` | Manage JSON configs (channels, paths, sequences) | ✅ ACTIVE |
 | **Move Images** | N/A (dev only) | Organize video asset images | ✅ ACTIVE |
 | **Prompt Tools** | `prompt_tools` | OpenAI Completion API wrapper | ⚠️ DEPRECATED API |
@@ -143,7 +143,7 @@ bin/subtitle_processor.rb join -d ./subs -f "*.srt" -s inferred -b 200 -o output
 
 **Note:** Renamed from `subtitle_manager` to `subtitle_processor` (accurate - processes files, doesn't manage state)
 
-#### 4. VAT - Video Asset Tools (`bin/vat`)
+#### 4. DAM - Digital Asset Management (`bin/dam`)
 Multi-tenant video project storage orchestration:
 
 ```bash
@@ -205,7 +205,7 @@ vat sync-ssd appydave
 - System: `video-projects-root` in `~/.config/appydave/settings.json` (**required**)
 - Per-brand: `.video-tools.env` (AWS credentials, S3 bucket, SSD path)
 
-**Migration note:** The old `~/.vat-config` file is deprecated. VAT now uses `settings.json`. See [Configuration Management](#configuration-management) section below.
+**Migration note:** The old `~/.vat-config` file is deprecated. DAM now uses `settings.json`. See [Configuration Management](#configuration-management) section below.
 
 See detailed usage guide: [docs/usage/vat.md](./docs/usage/vat.md)
 
@@ -329,6 +329,43 @@ Bank transaction reconciliation tool - **DEPRECATED, DO NOT USE**
 
 **WARNING:** This tool contains deprecated code and should not be used for new work. Code has been moved to `lib/appydave/tools/deprecated/bank_reconciliation/`
 
+### Git Workflow with Semantic Versioning
+
+**⚠️ IMPORTANT: Always use `kfeat` or `kfix` for commits**
+
+This project uses automated semantic versioning with CI/CD integration. **DO NOT use manual `git commit` commands.**
+
+**Commands:**
+```bash
+kfeat "Your feature description"   # Creates commit → CI runs → Minor version bump (0.14.0 → 0.15.0) → git pull
+kfix "Your bug fix description"    # Creates commit → CI runs → Patch version bump (0.14.0 → 0.14.1) → git pull
+```
+
+**How it works:**
+1. **You run:** `kfeat "add DAM migration"` or `kfix "resolve case-sensitivity bug"`
+2. **Creates commit** with semantic commit message format
+3. **Waits for CI** to complete (runs tests, linting, builds gem)
+4. **Version update** happens automatically on GitHub via semantic-release:
+   - `kfeat` → Minor version bump (new feature)
+   - `kfix` → Patch version bump (bug fix)
+5. **Auto git pull** after CI completes (repo was updated remotely)
+
+**Why use these commands:**
+- Ensures proper semantic versioning
+- Waits for CI to validate changes
+- Automatically syncs version updates from GitHub
+- Prevents version conflicts
+
+**Commit Message Guidelines:**
+- Be descriptive but concise (1-2 sentences)
+- Focus on the "why" rather than the "what"
+- Use imperative mood ("add feature" not "added feature")
+- Examples:
+  - `kfeat "migrate VAT to DAM with full rename"`
+  - `kfix "resolve case-insensitive brand resolution"`
+
+**Note:** For breaking changes that require major version bump, see Gem Version Management section below.
+
 ### Testing & Quality
 ```bash
 rake spec           # Run all RSpec tests
@@ -491,7 +528,7 @@ General application settings and paths (non-secret configuration).
 
 | Key | Purpose | Used By | Required |
 |-----|---------|---------|----------|
-| `video-projects-root` | Root directory for all video projects | VAT commands | ✅ For VAT |
+| `video-projects-root` | Root directory for all video projects | DAM commands | ✅ For DAM |
 | `ecamm-recording-folder` | Where Ecamm Live saves recordings | Move Images | Optional |
 | `download-folder` | General downloads directory | Move Images | Optional |
 | `download-image-folder` | Image downloads (defaults to `download-folder`) | Move Images | Optional |
@@ -598,16 +635,16 @@ TOOLS_ENABLED=false
 
 **From `~/.vat-config` (DEPRECATED):**
 
-The old `~/.vat-config` file is no longer used. VAT now uses `settings.json`.
+The old `~/.vat-config` file is no longer used. DAM now uses `settings.json`.
 
 **Migration steps:**
 1. Check your old config: `cat ~/.vat-config`
 2. Add value to settings.json: `ad_config -e`
 3. Add: `"video-projects-root": "/your/path/from/vat/config"`
-4. Test VAT still works: `vat list`
+4. Test DAM still works: `dam list`
 5. Delete old file: `rm ~/.vat-config`
 
-**Note:** The `vat init` command is deprecated. Use `ad_config -c` instead.
+**Note:** The `dam init` command is deprecated. Use `ad_config -c` instead.
 
 ## Git Hooks & Security
 

data/README.md

@@ -30,7 +30,7 @@ gem 'appydave-tools'
 
 ## Quick Start: Configuration
 
-Most tools work out of the box, but some features (VAT, YouTube Manager, OpenAI tools) require configuration.
+Most tools work out of the box, but some features (DAM, YouTube Manager, OpenAI tools) require configuration.
 
 ### First-Time Setup
 
@@ -70,7 +70,7 @@ Opens `~/.config/appydave/` for editing.
 
 Update the configuration files with your specific paths and settings.
 
-**Required for VAT (Video Asset Tools):**
+**Required for DAM (Digital Asset Management):**
 ```json
 {
   "video-projects-root": "/path/to/your/video-projects"
@@ -181,7 +181,7 @@ subtitle_processor join -f "part1.srt,part2.srt" -b 200 -o merged.srt
 
 ---
 
-### 🎬 VAT (Video Asset Tools)
+### 🎬 DAM (Digital Asset Management)
 
 **The problem:** Managing large video files across local storage, cloud collaboration (S3), and archival storage (SSD) is complex and error-prone.
 
@@ -200,11 +200,23 @@ vat s3-up appydave b65
 # Download collaborator's edits from S3
 vat s3-down appydave b65
 
-# Check sync status
+# Check sync status (shows all 4 states: synced, modified, S3 only, local only)
 vat s3-status appydave b65
 
+# Archive completed project to SSD
+vat archive appydave b63
+
+# Generate project manifest (tracks all projects across local + SSD)
+vat manifest appydave
+
+# Restore light files (subtitles, images, docs) from SSD (does NOT copy video files)
+vat sync-ssd appydave
+
 # Clean up S3 after project completion
-vat s3-cleanup appydave b65 --force
+vat s3-cleanup-remote appydave b65 --force
+
+# Clean up local s3-staging directory
+vat s3-cleanup-local appydave b65 --force
 ```
 
 **Configuration required:** Add `video-projects-root` to `settings.json` (see [Quick Start](#quick-start-configuration) above).
@@ -212,7 +224,7 @@ vat s3-cleanup appydave b65 --force
 **Key Features:**
 - **Multi-tenant**: Manages 6 brands (appydave, voz, aitldr, kiros, joy, ss)
 - **Smart sync**: MD5-based file comparison (skip unchanged files)
-- **Pattern matching**: `vat list appydave 'b6*'` (lists b60-b69)
+- **Pattern matching**: `dam list appydave 'b6*'` (lists b60-b69)
 - **Short names**: `b65` → `b65-guy-monroe-marketing-plan` (FliVideo workflow)
 - **Auto-detection**: Run commands from project directory without args
 - **Hybrid storage**: Local → S3 (collaboration) → SSD (archive)
@@ -331,7 +343,7 @@ ad_config -p
 
 **Key Settings:**
 
-- **video-projects-root** - Root directory for all video projects (required for VAT)
+- **video-projects-root** - Root directory for all video projects (required for DAM)
 - **ecamm-recording-folder** - Where Ecamm Live saves recordings
 - **download-folder** - General downloads directory
 - **download-image-folder** - Image downloads (defaults to download-folder)