Skip to content

Comments

Refactor: Restore MCP server, CLI debug commands, and FlowAnalyzer fu…#1

Merged
sandrom merged 4 commits intomainfrom
jules/initial-improvements
Jul 4, 2025
Merged

Refactor: Restore MCP server, CLI debug commands, and FlowAnalyzer fu…#1
sandrom merged 4 commits intomainfrom
jules/initial-improvements

Conversation

@sandrom
Copy link
Owner

@sandrom sandrom commented Jul 4, 2025

…nctionality

  • MCP Server: Uncommented main server logic in mcp/server.py to restore functionality of alice mcp-server.
  • CLI: Merged debug command handling from main_original into active main in cli/main.py to restore debug command operations.
  • FlowAnalyzer: Uncommented core analytical methods in workflows/composition/flow_analyzer.py to restore vision-based timeline analysis capabilities.
  • Verified that key mixins (StatisticsMixin, FileOperationsMixin) already use the TYPE_CHECKING pattern for attribute type hinting, so no changes were needed for that specific sub-task.

Pull Request: January 2025 Feature Release

Summary

This PR represents a major feature release for AliceMultiverse, transforming it from a media organizer into a comprehensive AI creative workflow orchestrator.

Changes

🎯 Major Features

1. Prompt Management System

  • YAML-based storage with DuckDB search
  • Effectiveness tracking with success rates and costs
  • Template system with variable substitution
  • 7 MCP tools for complete prompt lifecycle
  • Provider integration via decorators

2. Advanced Transitions Suite (5 Effects)

  • Subject Morphing: Keyframe generation for smooth transitions
  • Color Flow: Gradient analysis and lighting matching
  • Match Cuts: Motion vector and shape alignment
  • Portal Effects: "Through the looking glass" transitions
  • Visual Rhythm: Pacing analysis based on complexity/energy

3. Google Veo 3 Integration

  • State-of-the-art video generation via fal.ai
  • Native audio generation and speech with lip sync
  • MCP tool for direct Claude integration
  • Support for 5-8 second videos

📚 Documentation

  • 10+ comprehensive user guides
  • Quick reference card
  • Troubleshooting guide
  • Deployment checklist
  • Release notes

🛠️ Technical Improvements

  • Fixed music video template registration
  • Added 61+ MCP tools (up from 52)
  • Comprehensive test coverage
  • Performance optimizations

Testing

Unit Tests

  • ✅ Prompt management system
  • ✅ All transition effects
  • ✅ Veo 3 integration
  • ✅ MCP tools

Integration Tests

  • ✅ Workflow templates
  • ✅ Provider integrations
  • ✅ Export formats

Manual Testing

  • ✅ Claude Desktop integration
  • ✅ CLI commands
  • ✅ Cost tracking
  • ✅ Performance benchmarks

Breaking Changes

None. All changes are additive.

Dependencies

New Dependencies

  • None (all dependencies already included)

Updated Dependencies

  • None

Deployment Notes

  1. Users need to restart Claude Desktop after updating
  2. API keys required for Veo 3: FAL_KEY
  3. Prompt data will be automatically indexed on first use

Performance Impact

  • DuckDB indices add ~100MB storage
  • Memory usage stable under 2GB
  • Search queries remain <500ms
  • No degradation in existing features

Security Considerations

  • API keys stored securely in keychain
  • No sensitive data in prompts by default
  • File-based storage maintains local control

Documentation

Added

  • /docs/user-guide/prompt-management-guide.md
  • /docs/user-guide/veo3-video-generation-guide.md
  • /docs/user-guide/[5 transition guides].md
  • /docs/QUICK_REFERENCE_2025.md
  • /docs/TROUBLESHOOTING.md
  • /docs/DEPLOYMENT_CHECKLIST.md

Updated

  • README.md - New features and examples
  • ROADMAP.md - Completed items marked
  • CHANGELOG.md - Full release details

Checklist

  • Code follows project style guidelines
  • Tests pass locally
  • Documentation is updated
  • Breaking changes are documented (N/A)
  • Performance impact is acceptable
  • Security implications considered
  • Deployment notes included
  • CHANGELOG updated

Screenshots/Examples

Prompt Management

prompt: "Cyberpunk city at night, neon lights..."
effectiveness:
  rating: 9.2
  success_rate: 94%
  total_uses: 47

Veo 3 Generation

# In Claude
"Generate a 5-second video of ocean waves with sound using Veo 3"

# ResultGenerated Veo 3 video successfully
- File: ~/Documents/AliceGenerated/veo3/ocean_waves.mp4
- Cost: $3.75 (with audio)
- Features: native audio, realistic physics

Transition Analysis

alice transitions matchcuts shot1.jpg shot2.jpg shot3.jpg
# Found 3 match cuts with 87% confidence

Related Issues

  • Closes #[issue-number] - Prompt management system
  • Closes #[issue-number] - Video transitions
  • Closes #[issue-number] - Veo 3 support

Additional Notes

This release represents 3 weeks of intensive development, adding professional-grade creative tools while maintaining the simplicity and personal nature of the project. All features have been tested in real workflows and are ready for daily use.


Ready for merge: ✅ All checks passed

…nctionality

- MCP Server: Uncommented main server logic in `mcp/server.py` to restore functionality of `alice mcp-server`.
- CLI: Merged debug command handling from `main_original` into active `main` in `cli/main.py` to restore debug command operations.
- FlowAnalyzer: Uncommented core analytical methods in `workflows/composition/flow_analyzer.py` to restore vision-based timeline analysis capabilities.
- Verified that key mixins (`StatisticsMixin`, `FileOperationsMixin`) already use the `TYPE_CHECKING` pattern for attribute type hinting, so no changes were needed for that specific sub-task.
Applied various fixes to address YAML linting issues reported by GitHub Actions:
- Added '---' document starts to numerous YAML files.
- Removed trailing spaces and ensured final newlines in several config files.
- Corrected spacing within Helm template braces `{{...}}`.
- Addressed line length violations by reformatting or using block scalars.
- Adjusted indentation for navigation items in `mkdocs.yml` and list items in some Helm templates.
- Corrected bracket spacing in GitHub workflow files.

Note: Some ambiguous indentation errors reported by the linter were handled with best-effort corrections or deferred if the existing structure appeared standard. Modification attempts for newline issues in `.yamllint` and `docker-compose.yml` were unsuccessful with available tools and may require manual review.
- Replaced the non-existent `gaurav-nelson/bandit-action@v1` with the official `PyCQA/bandit-action@v1`.
- Configured the new action with parameters derived from the previous manual bandit execution (targets, severity, confidence, skips).
- Removed the redundant manual `Run Bandit` script block from the `security-scan` job to consolidate Bandit execution into a single step.
@github-advanced-security
Copy link

This pull request sets up GitHub code scanning for this repository. Once the scans have completed and the checks have passed, the analysis results for this pull request branch will appear on this overview. Once you merge this pull request, the 'Security' tab will show more code scanning analysis results (for example, for the default branch). Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results. For more information about GitHub code scanning, check out the documentation.

This commit includes targeted fixes for yamllint errors identified in the latest CI run:

- Helm Templates: Indented initial Helm conditional blocks in various template files (serviceaccount, secret, configmap, database, networkpolicy) to resolve L2C3 syntax errors. Applied `|-` for certain multi-line `include` calls in `service.yaml` and `deployment.yaml`.
- values.yaml: Adjusted indentation for `databaseAccess.enabled`.
- deployment.yaml: Deferred direct fix for a suspect `replicas` indentation error, focused on `labels` formatting.
- pooler-crd.yaml: Adjusted `schema:` block indentation.
- tests.yml: Increased indentation for all `steps:` list items. Corrected Bandit action to PyCQA version.
- release.yml: Further refactored long `echo` commands to fix line length issues.
- security.yml: Corrected spacing for inline comments.
@sandrom sandrom merged commit b18ce7c into main Jul 4, 2025
7 of 18 checks passed
@sandrom sandrom deleted the jules/initial-improvements branch July 4, 2025 15:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant