myaidev-method 0.2.12 → 0.2.16

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 (32) hide show
  1. package/.env.example +40 -0
  2. package/CHANGELOG.md +96 -0
  3. package/CONTENT_CREATION_GUIDE.md +3399 -0
  4. package/DEVELOPER_USE_CASES.md +2085 -0
  5. package/README.md +209 -2
  6. package/VISUAL_GENERATION_FILE_ORGANIZATION.md +105 -0
  7. package/bin/cli.js +46 -0
  8. package/package.json +18 -3
  9. package/src/lib/asset-management.js +532 -0
  10. package/src/lib/visual-config-utils.js +424 -0
  11. package/src/lib/visual-generation-utils.js +880 -0
  12. package/src/scripts/configure-visual-apis.js +413 -0
  13. package/src/scripts/generate-visual-cli.js +279 -0
  14. package/src/templates/claude/agents/content-production-coordinator.md +111 -0
  15. package/src/templates/claude/agents/content-writer.md +209 -4
  16. package/src/templates/claude/agents/proprietary-content-verifier.md +96 -0
  17. package/src/templates/claude/agents/visual-content-generator.md +520 -0
  18. package/src/templates/claude/commands/myai-content-writer.md +33 -8
  19. package/src/templates/claude/commands/myai-coordinate-content.md +136 -0
  20. package/src/templates/claude/commands/myai-generate-visual.md +318 -0
  21. package/src/templates/codex/commands/myai-generate-visual.md +307 -0
  22. package/src/templates/gemini/commands/myai-generate-visual.md +200 -0
  23. package/.claude/CLAUDE.md +0 -52
  24. package/.claude/agents/content-writer.md +0 -155
  25. package/.claude/agents/wordpress-admin.md +0 -271
  26. package/.claude/commands/myai-configure.md +0 -44
  27. package/.claude/commands/myai-content-writer.md +0 -78
  28. package/.claude/commands/myai-wordpress-publish.md +0 -120
  29. package/.claude/mcp/gutenberg-converter.js +0 -447
  30. package/.claude/mcp/mcp-config.json +0 -184
  31. package/.claude/mcp/wordpress-server-simple.js +0 -182
  32. package/.claude/settings.local.json +0 -12
package/.env.example CHANGED
@@ -26,3 +26,43 @@ ASTRO_PROJECT_PATH=./path-to-astro-project
26
26
  DEFAULT_WORD_COUNT=800
27
27
  DEFAULT_POST_STATUS=draft
28
28
  DEFAULT_TONE=professional
29
+
30
+ # ═══════════════════════════════════════════════════════
31
+ # Visual Content Generation APIs (Optional)
32
+ # Supported platforms: Claude Code, Gemini CLI, Codex CLI
33
+ # ═══════════════════════════════════════════════════════
34
+
35
+ # Google AI API (for Gemini 2.5 Flash Image)
36
+ # Get simple API key from: https://ai.google.dev/
37
+ # This key starts with "AIza..." and is 39 characters long
38
+ GOOGLE_API_KEY=
39
+
40
+ # Google Cloud Vertex AI (for Imagen 4)
41
+ # Required for premium Imagen 4 image generation
42
+ # Requires: Google Cloud Project with billing enabled
43
+ # Setup: https://cloud.google.com/vertex-ai/docs/start/cloud-environment
44
+ GOOGLE_CLOUD_PROJECT_ID=your-project-id
45
+ GOOGLE_CLOUD_LOCATION=us-central1
46
+ # Path to your service account JSON key file
47
+ GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
48
+
49
+ # OpenAI API (for DALL-E 3, GPT-Image-1)
50
+ # Get API key: https://platform.openai.com/api-keys
51
+ OPENAI_API_KEY=
52
+
53
+ # Fal.ai API (for FLUX, Veo 3, and premium models) - OPTIONAL
54
+ # Get API key: https://fal.ai/dashboard/keys
55
+ # Hybrid Strategy: Use direct APIs (Google/OpenAI) for cost savings
56
+ # Use Fal.ai for exclusive models (FLUX, Veo 3) or fallback
57
+ # Pricing: FLUX Pro $0.06/image, Veo 3 $0.40/second
58
+ FAL_KEY=
59
+
60
+ # Visual Generation Preferences
61
+ VISUAL_DEFAULT_SERVICE=gemini # gemini|imagen|dalle|veo|flux|veo3
62
+ VISUAL_DEFAULT_QUALITY=standard # standard|hd
63
+ VISUAL_ASSETS_PATH=./content-assets # Where to save generated files
64
+
65
+ # Budget Controls (Optional)
66
+ VISUAL_DAILY_BUDGET=5.00 # Max USD per day
67
+ VISUAL_MONTHLY_BUDGET=50.00 # Max USD per month
68
+ VISUAL_WARN_THRESHOLD=0.80 # Warn at 80% budget usage
package/CHANGELOG.md CHANGED
@@ -5,6 +5,102 @@ All notable changes to the MyAIDev Method package will be documented in this fil
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [0.2.16] - 2025-11-19
9
+
10
+ ### Fixed
11
+ - **Package Publishing**: Removed `.claude/` from published npm package
12
+ - `.claude/` folder is for local development/testing only
13
+ - Users get proper setup via `npx myaidev-method@latest init --claude`
14
+ - Reduces package size and prevents settings.local.json from being distributed
15
+ - Templates correctly published from `src/templates/claude/`
16
+
17
+ ### Added
18
+ - **Fal.ai Integration**: Hybrid provider strategy for premium models
19
+ - Added `@fal-ai/client` dependency for Fal.ai API access
20
+ - `generateImageFal()` function for FLUX models (Pro v1.1 Ultra, Dev)
21
+ - `generateVideoFal()` function for Veo 3 video generation
22
+ - Auto-provider selection (uses direct APIs when cheaper, Fal.ai for exclusives)
23
+ - Support for FLUX Pro ($0.06/image), FLUX Dev ($0.025/MP)
24
+ - Support for Veo 3 ($0.40/second), Veo 3 Fast
25
+ - FAL_KEY environment variable configuration
26
+
27
+ ### Changed
28
+ - **Visual Generation**: Enhanced provider ecosystem
29
+ - Updated pricing constants with Fal.ai models
30
+ - Enhanced `getServiceInfo()` with FLUX and Veo 3 details
31
+ - Updated `generateImage()` to support FLUX services
32
+ - `.env.example` updated with FAL_KEY and hybrid strategy documentation
33
+ - Hybrid strategy: Direct APIs primary (cost-effective), Fal.ai for premium/exclusive models
34
+
35
+ ### Strategy
36
+ - **Cost Optimization**: Use direct APIs for better pricing (Gemini $0.02 vs Fal $0.0398)
37
+ - **Premium Access**: Use Fal.ai for FLUX (artistic) and Veo 3 (latest video)
38
+ - **Fallback**: Fal.ai available when direct APIs are rate-limited
39
+
40
+ ## [0.2.15] - 2025-11-19
41
+
42
+ ### Added
43
+ - **Vertex AI Integration**: Full OAuth2 support for Google Cloud Vertex AI
44
+ - Implemented OAuth2 Bearer token authentication with `google-auth-library`
45
+ - Added `getVertexAIToken()` function for automatic token management
46
+ - Updated Imagen 4 integration to use Vertex AI endpoints
47
+ - Support for both service account and Application Default Credentials (ADC)
48
+ - Comprehensive setup documentation in GOOGLE_API_ENDPOINTS.md
49
+
50
+ ### Changed
51
+ - **Visual Generation**: Enhanced Google API support
52
+ - Imagen now uses Vertex AI (imagen-4.0-generate-001) with OAuth2 authentication
53
+ - Updated Gemini Nanobanana (Gemini 2.5 Flash Image) endpoint
54
+ - Veo 2 video generation support
55
+ - Updated .env.example with Vertex AI configuration options
56
+
57
+ ### Dependencies
58
+ - Added `google-auth-library` for OAuth2 authentication (36 packages)
59
+
60
+ ### Documentation
61
+ - Created GOOGLE_API_ENDPOINTS.md with complete Vertex AI setup guide
62
+ - Updated .env.example with clear instructions for both Google AI API and Vertex AI
63
+ - Documented service account creation and API enablement steps
64
+ - Added alternative ADC setup instructions for development workflows
65
+
66
+ ## [0.2.13] - 2025-11-13
67
+
68
+ ### Added
69
+ - **Content Production Workflow**: Complete batch content processing system
70
+ - `content-production-coordinator` agent - Orchestrates verification and publishing workflow
71
+ - `proprietary-content-verifier` agent - Validates content uniqueness and quality
72
+ - `/myai-coordinate-content` command - CLI command for coordinated content production
73
+ - Parallel processing for verification and publishing (dramatic efficiency gains)
74
+ - Automated content categorization (Ready for Publishing / Needs Review)
75
+ - Timestamped reports for audit trail and review
76
+ - User confirmation checkpoints before verification and publishing
77
+ - **Content Quality Gates**: Systematic verification before publishing
78
+ - Knowledge redundancy assessment (High/Medium/Low/Minimal)
79
+ - AI-generated content detection
80
+ - Unique value identification
81
+ - Actionable recommendations for improvement
82
+ - **Coordinator Pattern**: First agent that orchestrates other agents
83
+ - Foundation for future multi-agent workflows
84
+ - Enables complex multi-step automated processes
85
+ - Maintains clear separation of concerns
86
+
87
+ ### Changed
88
+ - CLAUDE.md template updated with content production workflow documentation
89
+ - bin/cli.js updated with new agents and commands in installation template
90
+ - Enhanced agent architecture with coordinator pattern
91
+
92
+ ### Documentation
93
+ - Added comprehensive feature analysis in claudedocs/content-production-feature-analysis.md
94
+ - Updated CLAUDE.md with Content Production Workflow section
95
+ - Documented use cases: content marketing agencies, SEO production, documentation teams
96
+ - Migration path guidance for existing users
97
+
98
+ ### Technical
99
+ - Zero new dependencies required
100
+ - Compatible with existing infrastructure
101
+ - Works with all existing publishing platforms (WordPress, PayloadCMS, etc.)
102
+ - Package size impact: +3 files (~2.5KB markdown)
103
+
8
104
  ## [0.2.12] - 2025-11-10
9
105
 
10
106
  ### Added