appydave-tools 0.13.0 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17dec612ce270c5ffa25c2173a96b437b85ccd6dfe1e1d2eb913060a4ebc54c1
-  data.tar.gz: 6b280aebe5245dc5c619169aa75638c9be027048736c28f4f8f3baeb33dccc65
+  metadata.gz: 5600c6b83ba9bf32a0954deaf91167a157826b2de2232c21fe51736a2f2e8b29
+  data.tar.gz: 389ac6da8c18a561ff276ebb49d3ef063b9c1965b190333a813e5f620e846b3d
 SHA512:
-  metadata.gz: 143d0c023e0ffd5dd86086e5f34f434216b7f3ed10c129e6971a9e0144eae3a36f631fc2ffbbd4a1b6ad290fdcb9e1ce5032810b65087bcfbc724799a7812c96
-  data.tar.gz: 9a26010a6d0f7936b094e2f1e5b4391e96d0f8a7bb58f686d6e7ca03100f7eb67da342a92f046499240c127d718bfa08ca41e07c1c3909c3fdd83b47827ecdc2
+  metadata.gz: ee9e4ea0e3e8c03c87ad0bcc7cf2af971c11c4f8966fedfa57c1813ac8154546156d70f353c22f607f3d6f8c863932a645503f50d3be67184dff418f7e5f7573
+  data.tar.gz: '08ab2c3240d21b647b2a76d037069e0e79655c3e982da82a48240a2748cb2d7a6cd5f3e76fbfd2db003262437179d657b7073863f1f3b4b14acbc6734865b775'

data/.rubocop.yml

@@ -2,7 +2,7 @@ inherit_mode:
   merge:
     - Exclude # see: https://stackoverflow.com/a/70818366/473923
     - AllowedNames
-require:
+plugins:
   - rubocop-rspec
   - rubocop-rake
 

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+# [0.14.0](https://github.com/appydave/appydave-tools/compare/v0.13.0...v0.14.0) (2025-04-27)
+
+
+### Bug Fixes
+
+* 'cops' ([51bc6f2](https://github.com/appydave/appydave-tools/commit/51bc6f2e7bd08a3aff165e6d488f3f99c4ab7f45))
+* ci ([11e934b](https://github.com/appydave/appydave-tools/commit/11e934b2f4f6be2457dea65c46b37ae350480b91))
+* cops ([94817c6](https://github.com/appydave/appydave-tools/commit/94817c6ecc930dcb79a59fa7d6d977ba2aa197b9))
+* update gem file ([9b0d21d](https://github.com/appydave/appydave-tools/commit/9b0d21d278a3c2bd6669122f33e55f084c76997b))
+
+
+### Features
+
+* update gem file ([b15dbcb](https://github.com/appydave/appydave-tools/commit/b15dbcbb13e0025f82ab54d8a87104d0d0fa4e14))
+
+# [0.13.0](https://github.com/appydave/appydave-tools/compare/v0.12.0...v0.13.0) (2024-12-03)
+
+
+### Features
+
+* move subtitle_master to subtitle_manager ([1c2d968](https://github.com/appydave/appydave-tools/commit/1c2d9680dce943bdfa65ec6ee079b40abdbd3890))
+
 # [0.12.0](https://github.com/appydave/appydave-tools/compare/v0.11.11...v0.12.0) (2024-12-03)
 
 

data/CLAUDE.md

@@ -0,0 +1,152 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Common Commands
+
+### Development Setup
+```bash
+bin/setup           # Install dependencies and setup development environment
+bin/console         # Interactive Ruby console for experimentation
+```
+
+### CLI Tools Usage
+
+#### GPT Context Gatherer
+Collect and organize project files for AI context:
+
+```bash
+# Basic usage - gather files with debug output and file output
+gpt_context -i '**/*.rb' -e 'spec/**/*' -d -o context.txt
+
+# Multiple formats and patterns
+gpt_context -i 'lib/**/*.rb' -i 'bin/**/*.rb' -f tree,content -d
+
+# Advanced web project filtering
+gpt_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -e '**/_generated/**/*' -d -f tree -o typescript.txt
+
+# Tree view only for project structure
+gpt_context -i '**/*' -e '**/node_modules/**/*' -e '.git/**/*' -f tree -d
+
+# Line-limited content gathering  
+gpt_context -i '**/*.rb' -l 20 -f content -d
+
+# Multiple output targets
+gpt_context -i 'docs/**/*' -f tree,content -o clipboard -o docs-context.txt
+```
+
+#### Other CLI Tools
+```bash
+# YouTube video management
+bin/youtube_manager.rb get [options]
+bin/youtube_manager.rb update [options]
+
+# Subtitle processing
+bin/subtitle_manager.rb clean [options]  
+bin/subtitle_manager.rb join [options]
+
+# AI prompt tools
+bin/prompt_tools.rb completion [options]
+
+# YouTube automation workflows  
+bin/youtube_automation.rb [workflow-command]
+```
+
+### Testing & Quality
+```bash
+rake spec           # Run all RSpec tests
+rake                # Default task: compile, spec (clobber compile spec)
+guard               # Watch files and auto-run tests + rubocop on changes
+bundle exec rspec -f doc  # Run tests with detailed documentation format
+```
+
+### Linting & Style
+```bash
+rubocop             # Run RubyGem style checks
+bundle exec rubocop --format clang  # Run with clang format (as used in Guard)
+```
+
+### Build & Release
+```bash
+rake build          # Build the gem
+rake publish        # Build and publish gem to RubyGems.org
+rake clean          # Remove built *.gem files
+gem build           # Build gemspec into .gem file
+```
+
+## Architecture Overview
+
+This is a Ruby gem called `appydave-tools` that provides YouTube automation and content creation tools.
+
+### Core Structure
+- **CLI Tools**: Multiple executable scripts in `bin/` for different functionalities
+- **Modular Design**: Organized into focused modules under `lib/appydave/tools/`
+- **Configuration System**: Flexible config management with channel and project settings
+- **Type System**: Custom type classes for data validation and transformation
+
+### Key Components
+
+#### CLI Actions (`lib/appydave/tools/cli_actions/`)
+- Base action pattern for command-line operations
+- YouTube video management (get, update)
+- AI prompt completion workflows
+
+#### Configuration (`lib/appydave/tools/configuration/`)
+- Multi-channel YouTube setup support
+- Project folder management (content, video, published, abandoned)
+- OpenAI integration configuration
+- Channel-specific settings (code, name, youtube_handle)
+
+#### GPT Context (`lib/appydave/tools/gpt_context/`)
+- File collection for AI context gathering
+- Content filtering and organization
+- Output handling for various formats
+
+#### YouTube Management (`lib/appydave/tools/youtube_manager/`)
+- YouTube API authorization and authentication
+- Video metadata retrieval and updates
+- Caption/subtitle management
+- Detailed reporting capabilities
+
+#### Subtitle Management (`lib/appydave/tools/subtitle_manager/`)
+- SRT file cleaning and normalization
+- Multi-part subtitle joining
+- Timeline synchronization
+
+### Type System (`lib/appydave/tools/types/`)
+- `BaseModel`: Foundation for data models with validation
+- `ArrayType` & `HashType`: Collection type wrappers
+- `IndifferentAccessHash`: Symbol/string key flexibility
+
+## Development Conventions
+
+### Ruby Style
+- All Ruby files must start with `# frozen_string_literal: true`
+- Follow existing code patterns and naming conventions
+- Use the Guard setup for continuous testing during development
+
+### Testing
+- RSpec for all testing
+- No `require` statements needed in spec files (handled by spec_helper)
+- VCR for HTTP request mocking (YouTube API calls)
+- SimpleCov for coverage reporting
+
+### File Organization
+- CLI executables in `bin/`
+- Core library code in `lib/appydave/tools/`
+- Tests mirror lib structure in `spec/`
+- Configuration examples and docs in respective `_doc.md` files
+
+## Key Dependencies
+- `google-api-client`: YouTube API integration
+- `ruby-openai`: OpenAI GPT integration  
+- `activemodel`: Data validation and modeling
+- `clipboard`: System clipboard operations
+- `dotenv`: Environment variable management
+
+## Configuration Files
+The gem uses JSON configuration for:
+- Channel definitions (code, name, youtube_handle)
+- Project folder paths (content, video, published, abandoned)
+- OpenAI API settings
+- YouTube automation workflows

data/README.md

@@ -33,7 +33,52 @@ See all [stories](./STORIES.md)
 
 ## Usage
 
-- [GPT Context Gatherer](./docs/usage/gpt-context.md)
+### CLI Tools
+
+This gem provides several command-line tools for content creation and YouTube automation:
+
+#### GPT Context Gatherer
+Collect and organize project files for AI context analysis:
+
+```bash
+# Basic usage - gather all Ruby files, exclude specs
+gpt_context -i '**/*.rb' -e 'spec/**/*' -d -o context.txt
+
+# Multiple patterns with tree and content output
+gpt_context -i 'lib/**/*.rb' -i 'bin/**/*.rb' -f tree,content -d
+
+# Advanced filtering for web projects  
+gpt_context -i 'apps/**/*.ts' -i 'apps/**/*.tsx' -e '**/node_modules/**/*' -e '**/_generated/**/*' -d -f tree -o typescript-files.txt
+
+# Documentation and config files
+gpt_context -i 'docs/**/*' -i '**/*.json' -i '**/*.config.*' -e '**/node_modules/**/*' -d -f tree
+```
+
+See detailed usage guide: [GPT Context Gatherer](./docs/usage/gpt-context.md)
+
+#### YouTube Manager
+```bash
+# Get video details
+bin/youtube_manager.rb get [options]
+
+# Update video metadata  
+bin/youtube_manager.rb update [options]
+```
+
+#### Subtitle Manager
+```bash
+# Clean subtitle files
+bin/subtitle_manager.rb clean [options]
+
+# Join multiple subtitle parts
+bin/subtitle_manager.rb join [options]
+```
+
+#### Prompt Tools
+```bash
+# Run AI prompt completion
+bin/prompt_tools.rb completion [options]
+```
 
 
 ## Development
@@ -51,8 +96,12 @@ You can also run `bin/console` for an interactive prompt that will allow you to
 ```bash
 bin/console
 
-Aaa::Bbb::Program.execute()
-# => ""
+Appydave::Tools::VERSION
+# => "0.14.0"
+
+# Access configuration
+config = Appydave::Tools::Configuration::Config.new
+# => #<Appydave::Tools::Configuration::Config:...>
 ```
 
 `appydave-tools` is setup with Guard, run `guard`, this will watch development file changes and run tests automatically, if successful, it will then run rubocop for style quality.

data/bin/gpt_context.rb

@@ -52,6 +52,10 @@ OptionParser.new do |opts|
     options.output_target << target
   end
 
+  opts.on('-p', '--prompt MESSAGE', 'Message/prompt to include in aider format output') do |message|
+    options.prompt = message
+  end
+
   opts.on_tail('-h', '--help', 'Show this message') do
     puts opts
     puts "\nExamples:"

data/docs/dam/overview.md

@@ -0,0 +1,28 @@
+# DAM - Digital Asset Management
+
+Digital Asset Management (DAM) is a system that stores, organizes, and retrieves digital assets such as images, videos, and other multimedia files.
+
+DAM systems are used by organizations to manage their digital assets efficiently and effectively.
+
+This document provides an overview of digital asset management (dam) from the point of view of AppyDave and FliVideo.
+
+> This is a preliminary document that needs to be moved to the appropriate file and project location.
+
+## Stories
+
+As a content creator, I want to keep track of the different brands hat I'm running where a business unit represents brand
+As a content creator, I want to manage the types of projects and extra configuration associated with each brand
+As a content creator, I want to be able to find assets associated with a project and brand
+As a contact creator, I may need to split specific projects across multiple drive locations For short and long-term storage and for team sharing
+As a contact creator, I need to be able to easily create a new project for a brand and have it sequentially labelled in an appropriate location
+As a content creator, I need a new project to be initialised based on the brand/project configuration
+As a content creator, I need tools that will automatically transfer files to project folder locations based on source, file type, and naming convention
+As a contact creator, I need to be able to create, remove, rename, update, list, project files
+As a contact creator, I need to be able to archive or reverse archive project files
+As a content creator, I need to be able to work with video transcriptions for use by various AI tools
+As content creator, I need a well-defined project, naming convention.
+As a content creator, I need configurable project structures and rules
+As content creator, I need a well-defined asset, naming Convention
+As a contact creator, I need assets to be stored in various locations within the project using smart rules
+
+

data/lib/appydave/tools/gpt_context/file_collector.rb

@@ -28,6 +28,8 @@ module Appydave
               build_content
             when 'json'
               build_json
+            when 'aider'
+              build_aider
             else
               ''
             end
@@ -122,6 +124,21 @@ module Appydave
           JSON.pretty_generate(json_output)
         end
 
+        def build_aider
+          return '' unless @options.prompt
+
+          files = []
+          @include_patterns.each do |pattern|
+            Dir.glob(pattern).each do |file_path|
+              next if excluded?(file_path) || File.directory?(file_path)
+
+              files << file_path
+            end
+          end
+
+          "aider --message \"#{@options.prompt}\" #{files.join(' ')}"
+        end
+
         def excluded?(file_path)
           @exclude_patterns.any? { |pattern| File.fnmatch(pattern, file_path, File::FNM_PATHNAME | File::FNM_DOTMATCH) }
         end

data/lib/appydave/tools/gpt_context/options.rb

@@ -12,6 +12,7 @@ module Appydave
         :debug,
         :output_target,
         :working_directory,
+        :prompt,
         keyword_init: true
       ) do
         def initialize(**args)
@@ -21,6 +22,7 @@ module Appydave
           self.format ||= 'tree,content'
           self.debug ||= 'none'
           self.output_target ||= []
+          self.prompt ||= nil
         end
       end
     end

data/lib/appydave/tools/version.rb

@@ -2,6 +2,6 @@
 
 module Appydave
   module Tools
-    VERSION = '0.13.0'
+    VERSION = '0.14.1'
   end
 end

data/lib/appydave/tools.rb

@@ -67,7 +67,7 @@ require 'appydave/tools/youtube_manager/reports/video_content_report'
 Appydave::Tools::Configuration::Config.set_default do |config|
   config.config_path = File.expand_path('~/.config/appydave')
   config.register(:settings, Appydave::Tools::Configuration::Models::SettingsConfig)
-  config.register(:bank_reconciliation, Appydave::Tools::Configuration::Models::BankReconciliationConfig)
+  # config.register(:bank_reconciliation, Appydave::Tools::Configuration::Models::BankReconciliationConfig)
   config.register(:channels, Appydave::Tools::Configuration::Models::ChannelsConfig)
   config.register(:youtube_automation, Appydave::Tools::Configuration::Models::YoutubeAutomationConfig)
 end

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appydave-tools",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "description": "AppyDave YouTube Automation Tools",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appydave-tools
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.1
 platform: ruby
 authors:
 - David Cruwys
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-03 00:00:00.000000000 Z
+date: 2025-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: clipboard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
@@ -81,47 +81,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.53'
 - !ruby/object:Gem::Dependency
-  name: k_log
+  name: googleauth
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: ruby-openai
+  name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '1.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7'
+        version: '1.14'
 - !ruby/object:Gem::Dependency
-  name: googleauth
+  name: k_log
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: webrick
   requirement: !ruby/object:Gem::Requirement
@@ -143,6 +157,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".DS_Store"
 - ".builders/_.rb"
 - ".builders/boot.rb"
 - ".builders/generators/01-bootstrap.rb"
@@ -150,6 +165,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - Guardfile
@@ -167,6 +183,7 @@ files:
 - bin/subtitle_manager.rb
 - bin/youtube_automation.rb
 - bin/youtube_manager.rb
+- docs/dam/overview.md
 - docs/usage/gpt-context.md
 - images.log
 - lib/appydave/tools.rb
@@ -219,7 +236,6 @@ files:
 - lib/mj-paste-test/main.rb
 - lib/mj-paste-test/prompts.txt
 - lib/mj-paste-test/readme-leonardo.md
-- package-lock.json
 - package.json
 - sig/appydave/tools.rbs
 homepage: http://appydave.com/gems/appydave-tools
@@ -230,7 +246,7 @@ metadata:
   source_code_uri: https://github.com/appydave/appydave-tools
   changelog_uri: https://github.com/appydave/appydave-tools/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -245,8 +261,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: AppyDave YouTube Automation Tools
 test_files: []