aidevops 2.74.1 → 2.76.0

package/README.md

@@ -206,6 +206,8 @@ aidevops upgrade-planning --force   # Skip confirmation prompt
 
 This preserves your existing tasks while adding TOON-enhanced parsing, dependency tracking, and better structure.
 
+**Automatic detection:** `aidevops update` now scans all registered projects for outdated planning templates (comparing TOON meta version numbers) and offers to upgrade them in-place with backups.
+
 ### Task Graph Visualization with Beads
 
 [Beads](https://github.com/steveyegge/beads) provides task dependency tracking and graph visualization:
@@ -451,6 +453,7 @@ aidevops includes curated skills imported from external repositories. Skills fro
 |-------|--------|-------------|
 | **cloudflare-platform** | [dmmulroy/cloudflare-skill](https://github.com/dmmulroy/cloudflare-skill) | 60 Cloudflare products: Workers, Pages, D1, R2, KV, Durable Objects, AI, networking, security |
 | **remotion** | [remotion-dev/skills](https://github.com/remotion-dev/skills) | Programmatic video creation with React, animations, rendering |
+| **video-prompt-design** | [snubroot/Veo-3-Meta-Framework](https://github.com/snubroot/Veo-3-Meta-Framework) | AI video prompt engineering - 7-component meta prompt framework for Veo 3 |
 | **animejs** | [animejs.com](https://animejs.com) | JavaScript animation library patterns and API (via Context7) |
 
 **CLI Commands:**
@@ -482,10 +485,12 @@ aidevops implements proven agent design patterns identified by [Lance Martin (La
 |---------|-------------|------------------------|
 | **Give Agents a Computer** | Filesystem + shell for persistent context | `~/.aidevops/.agent-workspace/`, 130+ helper scripts |
 | **Multi-Layer Action Space** | Few tools, push actions to computer | Per-agent MCP filtering (~12-20 tools each) |
-| **Progressive Disclosure** | Load context on-demand | Subagent tables, YAML frontmatter, read-on-demand |
+| **Progressive Disclosure** | Load context on-demand | Subagent routing with content summaries, YAML frontmatter, read-on-demand |
 | **Offload Context** | Write results to filesystem | `.agent-workspace/work/[project]/` for persistence |
 | **Cache Context** | Prompt caching for cost | Stable instruction prefixes |
 | **Isolate Context** | Sub-agents with separate windows | Subagent files with specific tool permissions |
+| **Multi-Agent Orchestration** | Coordinate parallel agents | TOON mailbox, agent registry, stateless coordinator |
+| **Compaction Resilience** | Preserve context across compaction | OpenCode plugin injects dynamic state at compaction time |
 | **Ralph Loop** | Iterative execution until complete | `ralph-loop-helper.sh`, `full-loop-helper.sh` |
 | **Evolve Context** | Learn from sessions | `/remember`, `/recall` with SQLite FTS5 |
 
@@ -493,6 +498,45 @@ aidevops implements proven agent design patterns identified by [Lance Martin (La
 
 See `.agent/aidevops/architecture.md` for detailed implementation notes and references.
 
+### Multi-Agent Orchestration
+
+Run multiple AI agents in parallel on separate branches, coordinated through a lightweight mailbox system. Each agent works independently in its own git worktree while a stateless coordinator manages task distribution and status reporting.
+
+**Architecture:**
+
+```text
+Coordinator (pulse loop)
+├── Agent Registry (TOON format - who's active, what branch, idle/busy)
+├── Mailbox System (file-based, per-agent inbox/outbox)
+│   ├── task_assignment → worker inbox
+│   ├── status_report → coordinator outbox
+│   └── broadcast → all agents
+└── Model Routing (tier-based: haiku/sonnet/opus/flash/pro)
+```
+
+**Key components:**
+
+| Component | Script | Purpose |
+|-----------|--------|---------|
+| Mailbox | `mail-helper.sh` | TOON-based inter-agent messaging (send, check, broadcast, archive) |
+| Coordinator | `coordinator-helper.sh` | Stateless pulse loop: collect reports, dispatch tasks, track idle workers |
+| Registry | `mail-helper.sh register` | Agent registration with role, branch, worktree, heartbeat |
+| Model routing | `generate-opencode-agents.sh` | Maps agent tiers to cost-effective models |
+
+**How it works:**
+
+1. Each agent registers on startup (`mail-helper.sh register --role worker`)
+2. Coordinator runs periodic pulses (`coordinator-helper.sh pulse`)
+3. Pulse collects status reports, dispatches queued tasks to idle workers
+4. Agents send completion reports back via outbox
+5. File locking (`noclobber` + retry) prevents race conditions
+
+**Compaction plugin** (`.agent/plugins/opencode-aidevops/`): When OpenCode compacts context (at ~200K tokens), the plugin injects current session state - agent registry, pending mailbox messages, git context, and relevant memories - ensuring continuity across compaction boundaries.
+
+**Custom system prompt** (`.agent/prompts/build.txt`): Based on upstream OpenCode with aidevops-specific overrides for tool preferences, professional objectivity, and per-model reinforcements for weaker models.
+
+**Subagent index** (`.agent/subagent-index.toon`): Compressed TOON routing table listing all agents, subagents, workflows, and scripts with model tier assignments - enables fast agent discovery without loading full markdown files.
+
 ## **Requirements**
 
 ```bash
@@ -562,6 +606,7 @@ The setup script offers to install these tools automatically.
 ### **Video Creation**
 
 - **[Remotion](https://remotion.dev/)**: Programmatic video creation with React - animations, compositions, media handling, captions
+- **[Video Prompt Design](https://github.com/snubroot/Veo-3-Meta-Framework)**: AI video prompt engineering using the 7-component meta prompt framework for Veo 3 and similar models
 
 ### **WordPress Development**
 
@@ -602,6 +647,7 @@ The setup script offers to install these tools automatically.
 
 - **[Anime.js](https://animejs.com/)**: Lightweight JavaScript animation library for CSS, SVG, DOM attributes, and JS objects
 - **[Remotion](https://remotion.dev/)**: Programmatic video creation with React - create videos using code with 29 specialized rule files
+- **[Video Prompt Design](https://github.com/snubroot/Veo-3-Meta-Framework)**: Structured prompt engineering for AI video generation (Veo 3, 7-component framework, character consistency, audio design)
 
 ### **Performance & Monitoring**
 
@@ -987,7 +1033,7 @@ Call them in your AI assistant conversation with a simple @mention
 
 ### **Main Agents**
 
-Ordered as they appear in OpenCode Tab selector and other AI assistants (14 total):
+Ordered as they appear in OpenCode Tab selector and other AI assistants (15 total):
 
 | Name | File | Purpose | MCPs Enabled |
 |------|------|---------|--------------|
@@ -1004,6 +1050,7 @@ Ordered as they appear in OpenCode Tab selector and other AI assistants (14 tota
 | Research | `research.md` | Research and analysis tasks | context7, augment |
 | Sales | `sales.md` | Sales operations and CRM | augment |
 | SEO | `seo.md` | SEO optimization, Search Console, keyword research | gsc, ahrefs, dataforseo, serper, context7, augment |
+| Video | `video.md` | AI video generation, prompt engineering, programmatic video | augment |
 | WordPress | `wordpress.md` | WordPress ecosystem (dev, admin, MainWP, LocalWP) | localwp, context7, augment |
 
 ### **Example Subagents with MCP Integration**
@@ -1133,7 +1180,17 @@ Plans are tracked in `TODO.md` (all tasks) and `todo/PLANS.md` (complex executio
 | `--plans` | `/list-todo --plans` | Include full plan details |
 | `--compact` | `/list-todo --compact` | One-line per task |
 
-**Time Tracking**: Tasks support time estimates and actuals with the format `~4h (ai:2h test:1h) started:2025-01-15T10:30Z`. Configure per-repo via `.aidevops.json`.
+**Time Tracking**: Tasks support time estimates as active session time (excluding AFK gaps) with the format `~4h started:2025-01-15T10:30Z`. The `session-time-helper.sh` analyses real session data to calibrate estimates vs actuals.
+
+**Risk Levels**: Tasks support `risk:low/med/high` indicating human oversight needed:
+
+| Risk | Oversight | Example |
+|------|-----------|---------|
+| `low` | Autonomous | Docs, formatting, simple refactors |
+| `med` | Supervised | Feature implementation, API changes |
+| `high` | Engaged | Security, data migrations, infrastructure |
+
+Configure time tracking per-repo via `.aidevops.json`.
 
 **Development Workflow** (typical order):
 

package/VERSION

@@ -1 +1 @@
-2.74.1
+2.76.0

package/aidevops.sh

@@ -3,7 +3,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 2.74.1
+# Version: 2.76.0
 
 set -euo pipefail
 
@@ -153,6 +153,48 @@ check_repo_needs_upgrade() {
     return 1  # up to date
 }
 
+# Check if a planning file needs upgrading (version mismatch or missing TOON markers)
+# Usage: check_planning_file_version <file> <template>
+# Returns 0 if upgrade needed, 1 if up to date
+check_planning_file_version() {
+    local file="$1" template="$2"
+    if [[ -f "$file" ]]; then
+        if ! grep -q "TOON:meta" "$file" 2>/dev/null; then
+            return 0
+        fi
+        local current_ver template_ver
+        current_ver=$(grep -A1 "TOON:meta" "$file" 2>/dev/null | tail -1 | cut -d',' -f1)
+        template_ver=$(grep -A1 "TOON:meta" "$template" 2>/dev/null | tail -1 | cut -d',' -f1)
+        if [[ -n "$template_ver" ]] && [[ "$current_ver" != "$template_ver" ]]; then
+            return 0
+        fi
+        return 1
+    else
+        # No file = no upgrade needed (init would create it)
+        return 1
+    fi
+}
+
+# Check if a repo's planning templates need upgrading
+# Returns 0 if any planning file needs upgrade
+check_planning_needs_upgrade() {
+    local repo_path="$1"
+    local todo_file="$repo_path/TODO.md"
+    local plans_file="$repo_path/todo/PLANS.md"
+    local todo_template="$AGENTS_DIR/templates/todo-template.md"
+    local plans_template="$AGENTS_DIR/templates/plans-template.md"
+
+    [[ ! -f "$todo_template" ]] && return 1
+
+    if check_planning_file_version "$todo_file" "$todo_template"; then
+        return 0
+    fi
+    if [[ -f "$plans_template" ]] && check_planning_file_version "$plans_file" "$plans_template"; then
+        return 0
+    fi
+    return 1
+}
+
 # Detect if current directory has aidevops but isn't registered
 detect_unregistered_repo() {
     local project_root
@@ -569,7 +611,7 @@ cmd_update() {
                         features=$(jq -r '[.features | to_entries[] | select(.value == true) | .key] | join(",")' "$repo/.aidevops.json" 2>/dev/null || echo "")
                         register_repo "$repo" "$current_ver" "$features"
                         
-                        print_success "Updated $(basename "$repo")"
+                         print_success "Updated $(basename "$repo")"
                     else
                         print_warning "jq not installed - manual update needed for $repo"
                     fi
@@ -577,6 +619,53 @@ cmd_update() {
             done
         fi
     fi
+    
+    # Check planning templates in registered repos
+    echo ""
+    print_header "Checking Planning Templates"
+    
+    local repos_needing_planning=()
+    while IFS= read -r repo_path; do
+        [[ -z "$repo_path" ]] && continue
+        [[ ! -d "$repo_path" ]] && continue
+        # Only check repos with planning enabled
+        if [[ -f "$repo_path/.aidevops.json" ]]; then
+            local has_planning
+            has_planning=$(grep -o '"planning": *true' "$repo_path/.aidevops.json" 2>/dev/null || true)
+            if [[ -n "$has_planning" ]] && check_planning_needs_upgrade "$repo_path"; then
+                repos_needing_planning+=("$repo_path")
+            fi
+        fi
+    done < <(get_registered_repos)
+    
+    if [[ ${#repos_needing_planning[@]} -eq 0 ]]; then
+        print_success "All planning templates are up to date"
+    else
+        echo ""
+        print_warning "${#repos_needing_planning[@]} project(s) have outdated planning templates:"
+        for repo in "${repos_needing_planning[@]}"; do
+            local repo_name
+            repo_name=$(basename "$repo")
+            local todo_ver
+            todo_ver=$(grep -A1 "TOON:meta" "$repo/TODO.md" 2>/dev/null | tail -1 | cut -d',' -f1)
+            echo "  - $repo_name (v${todo_ver:-none})"
+        done
+        local template_ver
+        template_ver=$(grep -A1 "TOON:meta" "$AGENTS_DIR/templates/todo-template.md" 2>/dev/null | tail -1 | cut -d',' -f1)
+        echo ""
+        echo "  Latest template: v${template_ver} (adds risk field, active session time estimates)"
+        echo ""
+        read -r -p "Upgrade planning templates in these projects? [y/N] " response
+        if [[ "$response" =~ ^[Yy]$ ]]; then
+            for repo in "${repos_needing_planning[@]}"; do
+                print_info "Upgrading $(basename "$repo")..."
+                # Run upgrade-planning in the repo context
+                (cd "$repo" && cmd_upgrade_planning --force) || print_warning "Failed to upgrade $(basename "$repo")"
+            done
+        else
+            print_info "Run 'aidevops upgrade-planning' in each project to upgrade manually"
+        fi
+    fi
 }
 
 # Uninstall command
@@ -1117,35 +1206,47 @@ cmd_upgrade_planning() {
     local plans_needs_upgrade=false
     
     # Check TODO.md
-    if [[ -f "$todo_file" ]]; then
-        # Check if it's using the minimal template (no TOON markers)
-        if ! grep -q "TOON:meta" "$todo_file" 2>/dev/null; then
-            todo_needs_upgrade=true
-            needs_upgrade=true
-            print_warning "TODO.md uses minimal template (missing TOON markers)"
+    if check_planning_file_version "$todo_file" "$todo_template"; then
+        if [[ -f "$todo_file" ]]; then
+            if ! grep -q "TOON:meta" "$todo_file" 2>/dev/null; then
+                print_warning "TODO.md uses minimal template (missing TOON markers)"
+            else
+                local current_ver template_ver
+                current_ver=$(grep -A1 "TOON:meta" "$todo_file" 2>/dev/null | tail -1 | cut -d',' -f1)
+                template_ver=$(grep -A1 "TOON:meta" "$todo_template" 2>/dev/null | tail -1 | cut -d',' -f1)
+                print_warning "TODO.md format version $current_ver -> $template_ver (adds risk field, updated estimates)"
+            fi
         else
-            print_success "TODO.md already has TOON markers"
+            print_info "TODO.md not found - will create from template"
         fi
-    else
-        print_info "TODO.md not found - will create from template"
         todo_needs_upgrade=true
         needs_upgrade=true
+    else
+        local current_ver
+        current_ver=$(grep -A1 "TOON:meta" "$todo_file" 2>/dev/null | tail -1 | cut -d',' -f1)
+        print_success "TODO.md already up to date (v${current_ver})"
     fi
     
     # Check PLANS.md
-    if [[ -f "$plans_file" ]]; then
-        # Check if it's using the minimal template (no TOON markers)
-        if ! grep -q "TOON:meta" "$plans_file" 2>/dev/null; then
-            plans_needs_upgrade=true
-            needs_upgrade=true
-            print_warning "todo/PLANS.md uses minimal template (missing TOON markers)"
+    if check_planning_file_version "$plans_file" "$plans_template"; then
+        if [[ -f "$plans_file" ]]; then
+            if ! grep -q "TOON:meta" "$plans_file" 2>/dev/null; then
+                print_warning "todo/PLANS.md uses minimal template (missing TOON markers)"
+            else
+                local current_plans_ver template_plans_ver
+                current_plans_ver=$(grep -A1 "TOON:meta" "$plans_file" 2>/dev/null | tail -1 | cut -d',' -f1)
+                template_plans_ver=$(grep -A1 "TOON:meta" "$plans_template" 2>/dev/null | tail -1 | cut -d',' -f1)
+                print_warning "todo/PLANS.md format version $current_plans_ver -> $template_plans_ver"
+            fi
         else
-            print_success "todo/PLANS.md already has TOON markers"
+            print_info "todo/PLANS.md not found - will create from template"
         fi
-    else
-        print_info "todo/PLANS.md not found - will create from template"
         plans_needs_upgrade=true
         needs_upgrade=true
+    else
+        local current_plans_ver
+        current_plans_ver=$(grep -A1 "TOON:meta" "$plans_file" 2>/dev/null | tail -1 | cut -d',' -f1)
+        print_success "todo/PLANS.md already up to date (v${current_plans_ver})"
     fi
     
     if [[ "$needs_upgrade" == "false" ]]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "2.74.1",
+  "version": "2.76.0",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "main": "index.js",

package/setup.sh

@@ -3,7 +3,7 @@
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 2.74.1
+# Version: 2.76.0
 #
 # Quick Install (one-liner):
 #   bash <(curl -fsSL https://aidevops.dev/install)
@@ -1449,6 +1449,28 @@ extract_opencode_prompts() {
     return 0
 }
 
+# Check if upstream OpenCode prompts have drifted from our synced version
+check_opencode_prompt_drift() {
+    local drift_script=".agent/scripts/opencode-prompt-drift-check.sh"
+    if [[ -f "$drift_script" ]]; then
+        local output exit_code=0
+        output=$(bash "$drift_script" --quiet 2>/dev/null) || exit_code=$?
+        if [[ "$exit_code" -eq 1 && "$output" == PROMPT_DRIFT* ]]; then
+            local local_hash upstream_hash
+            local_hash=$(echo "$output" | cut -d'|' -f2)
+            upstream_hash=$(echo "$output" | cut -d'|' -f3)
+            print_warning "OpenCode upstream prompt has changed (${local_hash} → ${upstream_hash})"
+            print_info "  Review: https://github.com/anomalyco/opencode/compare/${local_hash}...${upstream_hash}"
+            print_info "  Update .agent/prompts/build.txt if needed"
+        elif [[ "$exit_code" -eq 0 ]]; then
+            print_success "OpenCode prompt in sync with upstream"
+        else
+            print_warning "Could not check prompt drift (network issue or missing dependency)"
+        fi
+    fi
+    return 0
+}
+
 # Deploy aidevops agents to user location
 deploy_aidevops_agents() {
     print_info "Deploying aidevops agents to ~/.aidevops/agents/..."
@@ -2427,6 +2449,14 @@ setup_opencode_plugins() {
         return 0
     fi
     
+    # Setup aidevops compaction plugin (local file plugin)
+    local aidevops_plugin_path="$HOME/.aidevops/agents/plugins/opencode-aidevops/index.mjs"
+    if [[ -f "$aidevops_plugin_path" ]]; then
+        print_info "Setting up aidevops compaction plugin..."
+        add_opencode_plugin "file://$HOME/.aidevops" "file://${aidevops_plugin_path}" "$opencode_config"
+        print_success "aidevops compaction plugin registered (preserves context across compaction)"
+    fi
+
     # Setup Antigravity OAuth plugin (Google OAuth)
     print_info "Setting up Antigravity OAuth plugin..."
     add_opencode_plugin "opencode-antigravity-auth" "opencode-antigravity-auth@latest" "$opencode_config"
@@ -2856,6 +2886,7 @@ main() {
     confirm_step "Migrate loop state from .claude/ to .agent/loop-state/" && migrate_loop_state_directories
     confirm_step "Cleanup deprecated agent paths" && cleanup_deprecated_paths
     confirm_step "Extract OpenCode prompts" && extract_opencode_prompts
+    confirm_step "Check OpenCode prompt drift" && check_opencode_prompt_drift
     confirm_step "Deploy aidevops agents to ~/.aidevops/agents/" && deploy_aidevops_agents
     confirm_step "Generate agent skills (SKILL.md files)" && generate_agent_skills
     confirm_step "Create symlinks for imported skills" && create_skill_symlinks