Comprehensive documentation for LaunchQL deployment system

[pyramation]

Comprehensive documentation for LaunchQL deployment system

Summary

Added three comprehensive markdown documentation files to packages/core/ that document the current state and capabilities of the LaunchQL deployment system:

• DEPLOY.md (290 lines) - Documents deployment operations, including module-level, project-level, and orchestration-level deployment with tag support analysis
• REVERT.md (286 lines) - Documents revert operations with emphasis on reverse dependency processing and safety mechanisms
• VERIFY.md (353 lines) - Documents verification operations and highlights missing tag support compared to deploy/revert

Each file includes:

• Current behavior documentation for all operation levels
• Capability checklists with ✅/❌ checkboxes showing what's implemented vs missing
• Missing capabilities analysis with implementation complexity assessments ("Easy", "Non-trivial", "Blocked")
• Internal method documentation (deployModule/Project/Modules, revertModule/Project/Modules, etc.)
• Tag support capabilities and recursive behavior documentation
• Architecture notes explaining dependency resolution, transaction control, and safety mechanisms

Review & Testing Checklist for Human

• Verify documentation accuracy - Spot check that documented behaviors match actual code implementation, especially for complex features like tag resolution and dependency processing
• Validate capability checklists - Confirm the ✅/❌ markings are correct by testing a few key features (e.g., verify that tag-based deployment works but tag-based verification doesn't)
• Check implementation complexity assessments - Review whether "Easy"/"Non-trivial" judgments for missing features seem reasonable based on codebase familiarity
• Test recursive behaviors - Verify that the documented recursive flows (forward for deploy/verify, reverse for revert) match actual system behavior
• Validate internal method references - Ensure cited file paths, line numbers, and function signatures are accurate

Recommended test plan: Try deploying, reverting, and verifying a multi-module project with tags to validate the documented workflows actually work as described.

---

Diagram

%%{ init : { "theme" : "default" }}%%
graph TB
    subgraph "New Documentation Files"
        DEPLOY["DEPLOY.md<br/>(290 lines)"]:::major-edit
        REVERT["REVERT.md<br/>(286 lines)"]:::major-edit  
        VERIFY["VERIFY.md<br/>(353 lines)"]:::major-edit
    end
    
    subgraph "Core System Components"
        deployModule["src/modules/deploy.ts<br/>deployModule()"]:::context
        revertModule["src/modules/revert.ts<br/>revertModule()"]:::context
        verifyModule["src/modules/verify.ts<br/>verifyModule()"]:::context
        migration["src/migrate/migration.ts<br/>deployModules()"]:::context
        client["src/migrate/client.ts<br/>LaunchQLMigrate"]:::context
        resolve["src/resolution/resolve.ts<br/>resolveTagToChangeName()"]:::context
    end
    
    DEPLOY --> deployModule
    DEPLOY --> migration
    DEPLOY --> client
    DEPLOY --> resolve
    
    REVERT --> revertModule
    REVERT --> migration
    REVERT --> client
    REVERT --> resolve
    
    VERIFY --> verifyModule
    VERIFY --> migration
    VERIFY --> client
    
    subgraph Legend
        L1[Major Edit]:::major-edit
        L2[Minor Edit]:::minor-edit
        L3[Context/No Edit]:::context
    end
    
    classDef major-edit fill:#90EE90
    classDef minor-edit fill:#87CEEB
    classDef context fill:#FFFFFF

Loading

Notes

This documentation provides a comprehensive audit of the LaunchQL deployment system's current capabilities and plans for next steps. The analysis reveals that while deploy and revert operations have full tag support, verification operations are missing tag integration entirely. The recursive behaviors are well-documented, showing how dependency resolution works across modules and the critical reverse processing for safe reverts.

Link to Devin run: https://app.devin.ai/sessions/e1038737cb4f4244be832149f7ad19bd
Requested by: Dan Lynch (@pyramation)

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring