appydave-tools 0.17.1 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38c7660b828fc774d089b2c6996e8abdefa7ca12b29cf893f07c93e68115fb15
-  data.tar.gz: c41df72a30ef46aaba2a46c36dc8d859e85863687a93e311c758e2ad0a31fb1b
+  metadata.gz: cd677d964c0e8f3f3262afd01281147aea0c2fd85454cac5898080ffc8eabb82
+  data.tar.gz: f76224ae56fc168d0a09025e5eb63080e4e4da61934ffcba39c7a45d91fdfbc3
 SHA512:
-  metadata.gz: 015d8452747dba5097a398a6071fb5b8853d44efc80bd280f4eacaa22d52d8d47743f41b77fb2555cca685fac958880aa5a4e943616ba5b2b004f6adf88cc612
-  data.tar.gz: 0e2f4710767a849c324b7004101290af9ec64426d6231b54b9d88ec4a325bfa6510bd58d8e25dbeccf7474fb5b39427d1196b21138343bd8159a9834a64b80a2
+  metadata.gz: 45c4fe26c59fb70598ff001513e5f39053967042f06df797ad13b10600cfaa1f6b4002cca6f66d1782e5cee3fd6fa68c175f9f101896b706889ed1838dbf51fe
+  data.tar.gz: 9ed7de2356fffaa3ef7e587a6aa3d0f5db429f352a4f5cc005c00c49ace6e79ef7cfc35ab0e63f4612eba17c6f3043a56f4d6aafd6de00f8979154e432d29306

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [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)
 
 

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.
 
@@ -209,6 +209,9 @@ 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-remote appydave b65 --force
 
@@ -221,7 +224,7 @@ vat s3-cleanup-local 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)
@@ -340,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)