appydave-tools 0.70.0 → 0.71.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. checksums.yaml +4 -4
  2. data/.claude/commands/brainstorming-agent.md +227 -0
  3. data/.claude/commands/cli-test.md +251 -0
  4. data/.claude/commands/dev.md +234 -0
  5. data/.claude/commands/po.md +227 -0
  6. data/.claude/commands/progress.md +51 -0
  7. data/.claude/commands/uat.md +321 -0
  8. data/.rubocop.yml +9 -0
  9. data/AGENTS.md +43 -0
  10. data/CHANGELOG.md +12 -0
  11. data/CLAUDE.md +26 -3
  12. data/README.md +15 -0
  13. data/bin/dam +21 -1
  14. data/bin/jump.rb +29 -0
  15. data/bin/subtitle_processor.rb +54 -1
  16. data/bin/zsh_history.rb +846 -0
  17. data/docs/README.md +162 -69
  18. data/docs/architecture/cli/exe-bin-convention.md +434 -0
  19. data/docs/architecture/cli-patterns.md +631 -0
  20. data/docs/architecture/gpt-context/gpt-context-architecture.md +325 -0
  21. data/docs/architecture/gpt-context/gpt-context-implementation-guide.md +419 -0
  22. data/docs/architecture/gpt-context/gpt-context-vision.md +179 -0
  23. data/docs/architecture/testing/testing-patterns.md +762 -0
  24. data/docs/backlog.md +120 -0
  25. data/docs/cli-tests/FR-3-jump-location-tool.md +515 -0
  26. data/docs/specs/fr-002-gpt-context-help-system.md +265 -0
  27. data/docs/specs/fr-003-jump-location-tool.md +779 -0
  28. data/docs/specs/zsh-history-tool.md +820 -0
  29. data/docs/uat/FR-3-jump-location-tool.md +741 -0
  30. data/exe/jump +11 -0
  31. data/exe/{subtitle_manager → subtitle_processor} +1 -1
  32. data/exe/zsh_history +11 -0
  33. data/lib/appydave/tools/configuration/openai.rb +1 -1
  34. data/lib/appydave/tools/dam/file_helper.rb +28 -0
  35. data/lib/appydave/tools/dam/project_listing.rb +4 -30
  36. data/lib/appydave/tools/dam/s3_operations.rb +2 -1
  37. data/lib/appydave/tools/dam/ssd_status.rb +226 -0
  38. data/lib/appydave/tools/dam/status.rb +3 -51
  39. data/lib/appydave/tools/jump/cli.rb +561 -0
  40. data/lib/appydave/tools/jump/commands/add.rb +52 -0
  41. data/lib/appydave/tools/jump/commands/base.rb +43 -0
  42. data/lib/appydave/tools/jump/commands/generate.rb +153 -0
  43. data/lib/appydave/tools/jump/commands/remove.rb +58 -0
  44. data/lib/appydave/tools/jump/commands/report.rb +214 -0
  45. data/lib/appydave/tools/jump/commands/update.rb +42 -0
  46. data/lib/appydave/tools/jump/commands/validate.rb +54 -0
  47. data/lib/appydave/tools/jump/config.rb +233 -0
  48. data/lib/appydave/tools/jump/formatters/base.rb +48 -0
  49. data/lib/appydave/tools/jump/formatters/json_formatter.rb +19 -0
  50. data/lib/appydave/tools/jump/formatters/paths_formatter.rb +21 -0
  51. data/lib/appydave/tools/jump/formatters/table_formatter.rb +183 -0
  52. data/lib/appydave/tools/jump/location.rb +134 -0
  53. data/lib/appydave/tools/jump/path_validator.rb +47 -0
  54. data/lib/appydave/tools/jump/search.rb +230 -0
  55. data/lib/appydave/tools/subtitle_processor/transcript.rb +51 -0
  56. data/lib/appydave/tools/version.rb +1 -1
  57. data/lib/appydave/tools/zsh_history/command.rb +37 -0
  58. data/lib/appydave/tools/zsh_history/config.rb +235 -0
  59. data/lib/appydave/tools/zsh_history/filter.rb +184 -0
  60. data/lib/appydave/tools/zsh_history/formatter.rb +75 -0
  61. data/lib/appydave/tools/zsh_history/parser.rb +101 -0
  62. data/lib/appydave/tools.rb +25 -0
  63. data/package.json +1 -1
  64. metadata +51 -4
data/docs/README.md CHANGED
@@ -4,41 +4,140 @@
4
4
 
5
5
  ---
6
6
 
7
- ## 📖 Guides (How To Use)
8
-
9
- ### Tools
10
-
11
- - **[DAM - Digital Asset Management](./guides/tools/dam/)** - Video project storage orchestration
12
- - [Usage Guide](./guides/tools/dam/dam-usage.md) ✅
13
- - [Testing Plan](./guides/tools/dam/dam-testing-plan.md) ✅
14
- - **[VideoFileNamer](./guides/tools/video-file-namer.md)** - Generate structured video segment filenames ✅
15
- - **[GPT Context](./guides/tools/gpt-context.md)** - Gather files for AI context ✅
16
- - **[YouTube Manager](./guides/tools/youtube-manager.md)** - Manage YouTube metadata ✅
17
- - **[Subtitle Processor](./guides/tools/subtitle-processor.md)** - Clean/merge SRT files ✅
18
- - **[Configuration Tool](./guides/tools/configuration.md)** - Manage config files ✅
19
- - **[YouTube Automation](./guides/tools/youtube-automation.md)** - Automation workflows ✅
20
- - **[Prompt Tools](./guides/tools/prompt-tools.md)** - OpenAI completion wrapper ✅
21
- - **[Move Images](./guides/tools/move-images.md)** - Organize video assets ✅
22
- - **[Bank Reconciliation](./guides/tools/bank-reconciliation.md)** - DEPRECATED ✅
23
- - **[Name Manager](./guides/tools/name-manager.md)** - Naming utilities ✅
24
- - **[CLI Actions](./guides/tools/cli-actions.md)** - CLI base actions ✅
7
+ ## Two Major Systems
8
+
9
+ AppyDave Tools contains **two major systems** with comprehensive documentation, plus several smaller utilities:
10
+
11
+ | System | Purpose | Domain | Audience |
12
+ |--------|---------|--------|----------|
13
+ | **[DAM](#-dam-digital-asset-management)** | Video project storage orchestration | Video assets, S3, SSD | Video creators, editors |
14
+ | **[GPT Context](#-gpt-context-gatherer)** | AI context collection from codebases | Source code, AI assistants | Developers, AI users |
15
+
16
+ ### Quick Comparison
17
+
18
+ | Aspect | DAM | GPT Context |
19
+ |--------|-----|-------------|
20
+ | **Input** | Video files (MP4, SRT, MOV) | Source code files |
21
+ | **Output** | Cloud/SSD storage | Text (clipboard/files) |
22
+ | **State** | Stateful (sync tracking) | Stateless |
23
+ | **External services** | AWS S3 | None |
24
+ | **Configuration** | brands.json, settings.json | CLI options only |
25
+ | **Primary command** | `vat` | `gpt_context` |
26
+
27
+ ---
28
+
29
+ ## 🎬 DAM (Digital Asset Management)
30
+
31
+ **Purpose**: Multi-tenant video project storage orchestration for content creators.
32
+
33
+ ### Guides (How to Use)
34
+
35
+ - **[DAM Usage Guide](./guides/tools/dam/dam-usage.md)** ✅ - Complete command reference
36
+ - **[DAM Testing Plan](./guides/tools/dam/dam-testing-plan.md)** ✅ - Verification procedures
37
+ - **[Windows Testing](./guides/platforms/windows/dam-testing-plan-windows-powershell.md)** ✅ - Windows-specific testing
38
+
39
+ ### Architecture (How it Works)
40
+
41
+ - **[Implementation Roadmap](./architecture/dam/implementation-roadmap.md)** ⭐ START HERE
42
+ - **[DAM Vision](./architecture/dam/dam-vision.md)** ✅ - Strategic vision and roadmap
43
+ - **[Data Model](./architecture/dam/dam-data-model.md)** ✅ - Entity schema and relationships
44
+ - **[Visualization Requirements](./architecture/dam/dam-visualization-requirements.md)** ✅ - Astro dashboard spec
45
+ - **[CLI Enhancements](./architecture/dam/dam-cli-enhancements.md)** ✅ - Command requirements
46
+ - **[CLI Implementation Guide](./architecture/dam/dam-cli-implementation-guide.md)** ✅ - Code-level details
47
+ - **[Jan Collaboration Guide](./architecture/dam/jan-collaboration-guide.md)** ✅ - Team workflow
48
+
49
+ ### Design Decisions
50
+
51
+ - **[002 - Client Sharing](./architecture/dam/design-decisions/002-client-sharing.md)** 🔄 IN PROGRESS
52
+ - **[003 - Git Integration](./architecture/dam/design-decisions/003-git-integration.md)** 📋 PLANNED
53
+
54
+ ### Quick Start
55
+
56
+ ```bash
57
+ # List all brands
58
+ vat list
59
+
60
+ # List projects for a brand
61
+ vat list appydave
62
+
63
+ # Upload to S3 for collaboration
64
+ vat s3-up appydave b65
65
+
66
+ # Download from S3
67
+ vat s3-down appydave b65
68
+
69
+ # Check sync status
70
+ vat s3-status appydave b65
71
+
72
+ # Archive to SSD
73
+ vat archive appydave b63
74
+ ```
75
+
76
+ ---
77
+
78
+ ## 🤖 GPT Context Gatherer
79
+
80
+ **Purpose**: Collect and package codebase files for AI assistant context.
81
+
82
+ ### Guides (How to Use)
83
+
84
+ - **[GPT Context Usage Guide](./guides/tools/gpt-context.md)** ✅ - Complete command reference with examples
85
+
86
+ ### Architecture (How it Works)
87
+
88
+ - **[GPT Context Vision](./architecture/gpt-context/gpt-context-vision.md)** ✅ - Strategic vision and philosophy
89
+ - **[GPT Context Architecture](./architecture/gpt-context/gpt-context-architecture.md)** ✅ - Data flow and components
90
+ - **[GPT Context Implementation Guide](./architecture/gpt-context/gpt-context-implementation-guide.md)** ✅ - Code-level details
91
+
92
+ ### Quick Start
93
+
94
+ ```bash
95
+ # Gather Ruby files for AI context (copies to clipboard)
96
+ gpt_context -i '**/*.rb' -e 'spec/**/*' -d
97
+
98
+ # Save to file with tree structure
99
+ gpt_context -i 'lib/**/*.rb' -f tree,content -o context.txt
100
+
101
+ # Generate aider command
102
+ gpt_context -i 'lib/**/*.rb' -f aider -p "Add logging to all methods"
103
+
104
+ # JSON format for structured output
105
+ gpt_context -i 'src/**/*.ts' -f json -o codebase.json
106
+ ```
107
+
108
+ ---
109
+
110
+ ## 📖 Other Tools (Guides)
111
+
112
+ Smaller utilities with usage documentation:
113
+
114
+ | Tool | Purpose | Status |
115
+ |------|---------|--------|
116
+ | **[VideoFileNamer](./guides/tools/video-file-namer.md)** | Generate structured video segment filenames | ✅ |
117
+ | **[YouTube Manager](./guides/tools/youtube-manager.md)** | Manage YouTube video metadata via API | ✅ |
118
+ | **[Subtitle Processor](./guides/tools/subtitle-processor.md)** | Clean and merge SRT subtitle files | ✅ |
119
+ | **[Configuration Tool](./guides/tools/configuration.md)** | Manage JSON config files | ✅ |
120
+ | **[YouTube Automation](./guides/tools/youtube-automation.md)** | Prompt sequence automation | ✅ |
121
+ | **[Prompt Tools](./guides/tools/prompt-tools.md)** | OpenAI completion wrapper (deprecated API) | ✅ |
122
+ | **[Move Images](./guides/tools/move-images.md)** | Organize video asset images | ✅ |
123
+ | **[Name Manager](./guides/tools/name-manager.md)** | Naming utilities and conventions | ✅ |
124
+ | **[CLI Actions](./guides/tools/cli-actions.md)** | Base CLI action patterns | ✅ |
125
+ | **[Bank Reconciliation](./guides/tools/bank-reconciliation.md)** | DEPRECATED | ✅ |
25
126
 
26
127
  ### Platform-Specific
27
128
 
28
- - **[Windows Setup](./guides/platforms/windows/)** - Windows/WSL installation ✅
129
+ - **[Windows Setup](./guides/platforms/windows/)** ✅ - Windows/WSL installation
29
130
  - [Installation Guide](./guides/platforms/windows/installation.md) ✅
30
131
  - [Testing Plan](./guides/platforms/windows/dam-testing-plan-windows-powershell.md) ✅
31
132
 
32
133
  ### Configuration
33
134
 
34
- - **[Configuration Setup Guide](./guides/configuration-setup.md)** - Complete configuration reference ✅
135
+ - **[Configuration Setup Guide](./guides/configuration-setup.md)** ✅ - Complete configuration reference
35
136
  - Quick start, file locations, settings reference
36
137
  - Migration from legacy configs
37
138
  - Backup and recovery
38
139
 
39
- ### Future Configuration Guides
40
-
41
- More detailed configuration guides (not yet created):
140
+ #### Future Configuration Guides
42
141
 
43
142
  - **Settings Deep Dive** 📝 (detailed explanation of each setting)
44
143
  - **Channels System** 📝 (YouTube channel management)
@@ -47,32 +146,18 @@ More detailed configuration guides (not yet created):
47
146
 
48
147
  ---
49
148
 
50
- ## 🏗️ Architecture (Understanding How It Works)
149
+ ## 🏗️ General Architecture
51
150
 
52
- ### DAM (Digital Asset Management)
53
-
54
- **Complete documentation for DAM visualization and CLI system:**
55
-
56
- - **[Implementation Roadmap](./architecture/dam/implementation-roadmap.md)** ⭐ START HERE - Complete development guide ✅
57
- - **[DAM Vision](./architecture/dam/dam-vision.md)** - Strategic vision and roadmap ✅
58
- - **[Data Model](./architecture/dam/dam-data-model.md)** - Complete entity schema and relationships ✅
59
- - **[Visualization Requirements](./architecture/dam/dam-visualization-requirements.md)** - Astro dashboard specification ✅
60
- - **[CLI Enhancements](./architecture/dam/dam-cli-enhancements.md)** - Command requirements specification ✅
61
- - **[CLI Implementation Guide](./architecture/dam/dam-cli-implementation-guide.md)** - Code-level implementation details ✅
62
- - **[Jan Collaboration Guide](./architecture/dam/jan-collaboration-guide.md)** - Team workflow reference ✅
63
-
64
- **DAM Design Decisions:**
65
- - **[002 - Client Sharing](./architecture/dam/design-decisions/002-client-sharing.md)** 🔄 IN PROGRESS
66
- - **[003 - Git Integration](./architecture/dam/design-decisions/003-git-integration.md)** 📋 PLANNED
151
+ Cross-cutting architectural documentation:
67
152
 
68
153
  ### CLI Architecture
69
154
 
70
- - **[CLI Patterns](./architecture/cli/cli-patterns.md)** - CLI architecture patterns ✅
71
- - **[CLI Pattern Comparison](./architecture/cli/cli-pattern-comparison.md)** - Visual pattern guide ✅
155
+ - **[CLI Patterns](./architecture/cli/cli-patterns.md)** ✅ - CLI architecture patterns
156
+ - **[CLI Pattern Comparison](./architecture/cli/cli-pattern-comparison.md)** ✅ - Visual pattern guide
72
157
 
73
158
  ### Configuration Systems
74
159
 
75
- - **[Configuration Systems Analysis](./architecture/configuration/configuration-systems.md)** - How brands/channels/NameManager relate ✅
160
+ - **[Configuration Systems Analysis](./architecture/configuration/configuration-systems.md)** ✅ - How brands/channels/NameManager relate
76
161
 
77
162
  ### Design Decisions (General)
78
163
 
@@ -85,10 +170,10 @@ More detailed configuration guides (not yet created):
85
170
 
86
171
  Ready-to-use configuration templates:
87
172
 
88
- - **[settings.example.json](./templates/settings.example.json)** - Settings template ✅
89
- - **[channels.example.json](./templates/channels.example.json)** - Channels template ✅
90
- - **[.env.example](./templates/.env.example)** - Environment variables template ✅
91
- - **brands.example.json** 📝 (not yet created - should mirror brands.json structure with placeholders)
173
+ - **[settings.example.json](./templates/settings.example.json)** ✅ - Settings template
174
+ - **[channels.example.json](./templates/channels.example.json)** ✅ - Channels template
175
+ - **[.env.example](./templates/.env.example)** ✅ - Environment variables template
176
+ - **brands.example.json** 📝 (not yet created)
92
177
 
93
178
  **To use templates:**
94
179
  ```bash
@@ -109,12 +194,10 @@ ad_config -e
109
194
 
110
195
  Documentation for contributors and developers:
111
196
 
112
- - **[CODEX Recommendations](./development/codex-recommendations.md)** - AI coding guidelines ✅
197
+ - **[CODEX Recommendations](./development/codex-recommendations.md)** ✅ - AI coding guidelines
113
198
 
114
199
  ### Future Development Topics
115
200
 
116
- Planned documentation for contributors:
117
-
118
201
  - **Contributing Guide** 📝 (how to contribute, PR process, coding standards)
119
202
  - **Testing Guide** 📝 (how to run tests, write specs, coverage requirements)
120
203
  - **Release Process** 📝 (semantic versioning, CI/CD, gem publishing)
@@ -126,7 +209,7 @@ Planned documentation for contributors:
126
209
 
127
210
  Historical and deprecated documentation:
128
211
 
129
- - **[Archive](./archive/)** - Deprecated documentation ✅
212
+ - **[Archive](./archive/)** ✅ - Deprecated documentation
130
213
 
131
214
  ---
132
215
 
@@ -141,38 +224,44 @@ docs/
141
224
  │ │ ├── dam/ # DAM-specific guides
142
225
  │ │ │ ├── dam-usage.md
143
226
  │ │ │ └── dam-testing-plan.md
144
- │ │ ├── gpt-context.md
227
+ │ │ ├── gpt-context.md # GPT Context usage
145
228
  │ │ ├── youtube-manager.md
146
229
  │ │ ├── subtitle-processor.md
147
230
  │ │ ├── configuration.md
148
231
  │ │ └── ... (11 tool guides total)
149
232
  │ │
150
233
  │ └── platforms/ # Platform-specific setup
151
- │ └── windows/ # Windows/WSL guides
234
+ │ └── windows/
152
235
  │ ├── README.md
153
236
  │ ├── installation.md
154
237
  │ └── dam-testing-plan-windows-powershell.md
155
238
  │
156
239
  ├── architecture/ # WHY/HOW systems work
157
240
  │ ├── dam/ # DAM system documentation
158
- │ │ ├── implementation-roadmap.md # ⭐ START HERE - Complete dev guide
159
- │ │ ├── dam-vision.md # Strategic vision
160
- │ │ ├── dam-data-model.md # Entity schema
161
- │ │ ├── dam-visualization-requirements.md # Astro dashboard spec
162
- │ │ ├── dam-cli-enhancements.md # CLI implementation
163
- │ │ ├── jan-collaboration-guide.md # Team workflow
164
- │ │ └── design-decisions/ # DAM-specific PRDs
241
+ │ │ ├── implementation-roadmap.md # ⭐ START HERE
242
+ │ │ ├── dam-vision.md
243
+ │ │ ├── dam-data-model.md
244
+ │ │ ├── dam-visualization-requirements.md
245
+ │ │ ├── dam-cli-enhancements.md
246
+ │ │ ├── dam-cli-implementation-guide.md
247
+ │ │ ├── jan-collaboration-guide.md
248
+ │ │ └── design-decisions/
165
249
  │ │ ├── 002-client-sharing.md
166
250
  │ │ └── 003-git-integration.md
167
251
  │ │
252
+ │ ├── gpt-context/ # GPT Context documentation
253
+ │ │ ├── gpt-context-vision.md # Strategic vision
254
+ │ │ ├── gpt-context-architecture.md # Data flow & components
255
+ │ │ └── gpt-context-implementation-guide.md # Code-level details
256
+ │ │
168
257
  │ ├── cli/ # CLI architecture
169
- │ │ ├── cli-patterns.md # CLI patterns
170
- │ │ └── cli-pattern-comparison.md # Pattern guide
258
+ │ │ ├── cli-patterns.md
259
+ │ │ └── cli-pattern-comparison.md
171
260
  │ │
172
261
  │ ├── configuration/ # Configuration system
173
- │ │ └── configuration-systems.md # System overlap analysis
262
+ │ │ └── configuration-systems.md
174
263
  │ │
175
- │ └── design-decisions/ # General PRDs, ADRs, session logs
264
+ │ └── design-decisions/ # General PRDs, ADRs
176
265
  │ ├── 001-unified-brands-config.md
177
266
  │ └── session-2025-11-09.md
178
267
  │
@@ -196,12 +285,14 @@ docs/
196
285
 
197
286
  | Task | Documentation |
198
287
  |------|---------------|
199
- | **DAM development** | [Implementation Roadmap](./architecture/dam/implementation-roadmap.md) ⭐ |
288
+ | **Gather code for AI** | [GPT Context Usage](./guides/tools/gpt-context.md) |
289
+ | **Understand GPT Context design** | [GPT Context Architecture](./architecture/gpt-context/gpt-context-architecture.md) |
290
+ | **Extend GPT Context** | [GPT Context Implementation](./architecture/gpt-context/gpt-context-implementation-guide.md) |
200
291
  | **Video storage management** | [DAM Usage](./guides/tools/dam/dam-usage.md) |
201
292
  | **S3 sync for collaboration** | [DAM Usage](./guides/tools/dam/dam-usage.md) |
202
293
  | **Understand DAM architecture** | [DAM Data Model](./architecture/dam/dam-data-model.md) |
203
294
  | **Build DAM dashboard** | [Visualization Requirements](./architecture/dam/dam-visualization-requirements.md) |
204
- | **Gather AI context** | [GPT Context](./guides/tools/gpt-context.md) |
295
+ | **DAM development** | [Implementation Roadmap](./architecture/dam/implementation-roadmap.md) ⭐ |
205
296
  | **Manage YouTube videos** | [YouTube Manager](./guides/tools/youtube-manager.md) |
206
297
  | **Process subtitles** | [Subtitle Processor](./guides/tools/subtitle-processor.md) |
207
298
  | **Configure tools** | [Configuration Tool](./guides/tools/configuration.md) |
@@ -213,13 +304,15 @@ docs/
213
304
 
214
305
  | Audience | Start Here |
215
306
  |----------|------------|
307
+ | **AI-Assisted Developers** | [GPT Context Usage](./guides/tools/gpt-context.md) |
308
+ | **GPT Context Contributors** | [GPT Context Implementation](./architecture/gpt-context/gpt-context-implementation-guide.md) |
309
+ | **Video Creators** | [DAM Usage](./guides/tools/dam/dam-usage.md) |
216
310
  | **DAM Developers** | [Implementation Roadmap](./architecture/dam/implementation-roadmap.md) ⭐ |
217
- | **End Users** | [Guides](#-guides-how-to-use) - Individual tool documentation |
311
+ | **End Users** | [Guides](#-other-tools-guides) - Individual tool documentation |
218
312
  | **Windows Users** | [Windows Setup](./guides/platforms/windows/) |
219
313
  | **Team Members (Jan)** | [Jan Collaboration Guide](./architecture/dam/jan-collaboration-guide.md) |
220
- | **Developers** | [Development](#%EF%B8%8F-development-contributing) - Contributing guides |
221
314
  | **Contributors** | [CLI Patterns](./architecture/cli/cli-patterns.md) |
222
- | **Architects** | [Architecture](#%EF%B8%8F-architecture-understanding-how-it-works) - System design |
315
+ | **Architects** | [Architecture](#%EF%B8%8F-general-architecture) - System design |
223
316
 
224
317
  ---
225
318
 
@@ -264,4 +357,4 @@ When adding new documentation:
264
357
 
265
358
  ---
266
359
 
267
- **Last updated**: 2025-11-18
360
+ **Last updated**: 2025-12-06