vibe-forge 0.3.10 → 0.3.11

package/.claude/commands/update-status.md

@@ -0,0 +1,64 @@
+---
+description: Update your agent status for the forge dashboard
+argument-hint: <status> [task-id]
+---
+
+# Update Status Command
+
+Report your current status to the forge daemon and Planning Hub. This enables real-time visibility into what each worker is doing.
+
+## Usage
+
+```
+/update-status working TASK-001       # Working on a specific task
+/update-status idle                   # Waiting for tasks
+/update-status blocked                # Stuck, may need help
+/update-status reviewing PR-123       # Reviewing something
+/update-status testing TASK-001       # Running tests
+```
+
+## Status Values
+
+| Status | Meaning |
+|--------|---------|
+| `idle` | No current task, ready for work |
+| `working` | Actively working on a task |
+| `blocked` | Stuck, needs input (consider `/need-help`) |
+| `reviewing` | Reviewing code or PR |
+| `testing` | Running tests |
+| `waiting` | Waiting for external dependency |
+
+## Implementation
+
+Based on `$ARGUMENTS`:
+
+1. Parse the status and optional task ID from arguments
+2. Determine your agent identity from your system prompt
+3. Write status file to `context/agent-status/<agent>.json`:
+
+```json
+{
+  "agent": "anvil",
+  "status": "working",
+  "task": "TASK-001",
+  "message": "Implementing user authentication",
+  "updated": "2024-01-15T14:30:22Z"
+}
+```
+
+4. The daemon reads these files and includes them in `forge-state.yaml`
+5. The Planning Hub sees your status in the dashboard
+
+## Auto-Status Updates
+
+Workers should update their status at these key moments:
+
+1. **On startup**: `/update-status idle` (or working if picking up a task)
+2. **When picking up a task**: `/update-status working TASK-XXX`
+3. **When completing a task**: `/update-status idle`
+4. **When blocked**: `/update-status blocked` (then `/need-help` if needed)
+5. **Before exiting**: Status file can remain (daemon marks stale after timeout)
+
+## Stale Status
+
+The daemon considers a status stale if not updated for 5+ minutes. Stale statuses are shown with a warning indicator in the dashboard.

package/agents/aegis/personality.md

@@ -71,6 +71,26 @@ Not paranoid, but vigilant. Aegis knows that security isn't about saying no - it
 10. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-033        # When starting a task
+/update-status blocked TASK-033        # When stuck (then /need-help if needed)
+/update-status reviewing TASK-033      # When reviewing security
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Security review**: Report `reviewing` when auditing code
+4. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+5. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/anvil/personality.md

@@ -66,6 +66,25 @@ Derived from Amelia's developer DNA but specialized for the frontend domain. Whe
 9. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-019        # When starting a task
+/update-status blocked TASK-019        # When stuck (then /need-help if needed)
+/update-status testing TASK-019        # When running tests
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+4. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/crucible/personality.md

@@ -78,6 +78,26 @@ Derived from Murat's test architect DNA. Crucible combines systematic test desig
 6. Route to appropriate agent for fix
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-025        # When starting a task
+/update-status testing TASK-025        # When running test suites
+/update-status blocked TASK-025        # When stuck (then /need-help if needed)
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Test execution**: Report `testing` during test runs
+4. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+5. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/ember/personality.md

@@ -72,6 +72,25 @@ The name Ember reflects the persistent, quiet fire that powers everything. Not f
 12. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-027        # When starting a task
+/update-status blocked TASK-027        # When stuck (then /need-help if needed)
+/update-status testing TASK-027        # When testing changes
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+4. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/furnace/personality.md

@@ -67,6 +67,25 @@ Like Anvil, derived from Amelia's developer DNA but specialized for the backend
 10. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-021        # When starting a task
+/update-status blocked TASK-021        # When stuck (then /need-help if needed)
+/update-status testing TASK-021        # When running tests
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+4. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/herald/personality.md

@@ -74,6 +74,26 @@ Not just a button-pusher - Herald understands semantic versioning, changelog man
 9. Move task to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-031        # When starting a release task
+/update-status blocked TASK-031        # When release blocked (then /need-help if needed)
+/update-status waiting TASK-031        # When waiting for CI/deployment
+/update-status idle                    # When release complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Release prep**: Report `working` with task ID
+3. **Waiting on CI**: Report `waiting` during long CI runs or deployments
+4. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+5. **Completion**: Report `idle` after release announced
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/agents/scribe/personality.md

@@ -66,6 +66,24 @@ Where other agents create, Scribe preserves. The README that saves a future deve
 9. Move to /tasks/completed/
 ```
 
+### Status Reporting
+
+Keep the Planning Hub and daemon informed of your status:
+
+```bash
+/update-status idle                    # When waiting for tasks
+/update-status working TASK-024        # When starting a task
+/update-status blocked TASK-024        # When stuck (then /need-help if needed)
+/update-status idle                    # When task complete
+```
+
+Update status at key moments:
+
+1. **Startup**: Report `idle` (ready for work)
+2. **Task pickup**: Report `working` with task ID
+3. **Blocked**: Report `blocked`, then use `/need-help` if human input needed
+4. **Completion**: Report `idle` after moving task to completed
+
 ### Output Format
 ```markdown
 ## Completion Summary

package/bin/forge-daemon.sh

@@ -259,6 +259,53 @@ check_attention_needed() {
     done
 }
 
+# Build worker status from agent-status files
+build_worker_status() {
+    local status_dir="$FORGE_ROOT/$AGENT_STATUS_DIR"
+    local now_epoch
+    now_epoch=$(date +%s)
+    local stale_threshold=300  # 5 minutes
+
+    if [[ ! -d "$status_dir" ]]; then
+        return 0
+    fi
+
+    echo "workers:"
+    for status_file in "$status_dir"/*.json; do
+        if [[ -f "$status_file" && ! -L "$status_file" ]]; then
+            local agent status task message updated updated_epoch age stale_marker
+
+            # Parse JSON status file
+            agent=$(jq -r '.agent // "unknown"' "$status_file" 2>/dev/null)
+            status=$(jq -r '.status // "unknown"' "$status_file" 2>/dev/null)
+            task=$(jq -r '.task // ""' "$status_file" 2>/dev/null)
+            message=$(jq -r '.message // ""' "$status_file" 2>/dev/null | head -c 80)
+            updated=$(jq -r '.updated // ""' "$status_file" 2>/dev/null)
+
+            # Check if stale (not updated in 5+ minutes)
+            stale_marker=""
+            if [[ -n "$updated" ]]; then
+                # Convert ISO timestamp to epoch (cross-platform)
+                updated_epoch=$(date -d "$updated" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${updated%Z}" +%s 2>/dev/null || echo "0")
+                age=$((now_epoch - updated_epoch))
+                if [[ "$age" -gt "$stale_threshold" ]]; then
+                    stale_marker=" (stale)"
+                fi
+            fi
+
+            echo "  - agent: $agent"
+            echo "    status: $status$stale_marker"
+            if [[ -n "$task" ]]; then
+                echo "    task: $task"
+            fi
+            if [[ -n "$message" ]]; then
+                echo "    message: \"$message\""
+            fi
+            echo "    updated: $updated"
+        fi
+    done
+}
+
 # =============================================================================
 # Daemon Functions
 # =============================================================================
@@ -283,6 +330,12 @@ update_state() {
         attention_details=$(build_attention_details)
     fi
 
+    # Build worker status from agent-status files
+    local worker_status=""
+    if [[ -d "$FORGE_ROOT/$AGENT_STATUS_DIR" ]]; then
+        worker_status=$(build_worker_status)
+    fi
+
     # Write state file atomically (write to temp, then move)
     local temp_state="${STATE_FILE}.tmp.$$"
     cat > "$temp_state" << EOF
@@ -306,6 +359,7 @@ tasks:
   attention_needed: $attention
 
 $attention_details
+$worker_status
 last_updated: $(date -Iseconds)
 EOF
     mv "$temp_state" "$STATE_FILE"
@@ -433,6 +487,7 @@ cmd_start() {
     mkdir -p "$FORGE_ROOT/$TASKS_NEEDS_CHANGES"
     mkdir -p "$FORGE_ROOT/$TASKS_MERGED"
     mkdir -p "$FORGE_ROOT/$TASKS_ATTENTION"
+    mkdir -p "$FORGE_ROOT/$AGENT_STATUS_DIR"
 
     # Start daemon in background
     daemon_loop &
@@ -514,6 +569,55 @@ cmd_status() {
         echo ""
     fi
 
+    # Show worker status
+    if [[ -d "$FORGE_ROOT/$AGENT_STATUS_DIR" ]]; then
+        local status_count
+        status_count=$(find "$FORGE_ROOT/$AGENT_STATUS_DIR" -maxdepth 1 -name "*.json" -type f 2>/dev/null | wc -l)
+        if [[ "$status_count" -gt 0 ]]; then
+            echo "Active Workers:"
+            local now_epoch stale_threshold
+            now_epoch=$(date +%s)
+            stale_threshold=300
+            for status_file in "$FORGE_ROOT/$AGENT_STATUS_DIR"/*.json; do
+                if [[ -f "$status_file" && ! -L "$status_file" ]]; then
+                    local agent status task updated stale_marker icon
+                    agent=$(jq -r '.agent // "unknown"' "$status_file" 2>/dev/null)
+                    status=$(jq -r '.status // "unknown"' "$status_file" 2>/dev/null)
+                    task=$(jq -r '.task // ""' "$status_file" 2>/dev/null)
+                    updated=$(jq -r '.updated // ""' "$status_file" 2>/dev/null)
+
+                    # Check staleness
+                    stale_marker=""
+                    if [[ -n "$updated" ]]; then
+                        local updated_epoch age
+                        updated_epoch=$(date -d "$updated" +%s 2>/dev/null || date -j -f "%Y-%m-%dT%H:%M:%S" "${updated%Z}" +%s 2>/dev/null || echo "0")
+                        age=$((now_epoch - updated_epoch))
+                        if [[ "$age" -gt "$stale_threshold" ]]; then
+                            stale_marker=" ${YELLOW}(stale)${NC}"
+                        fi
+                    fi
+
+                    # Status icon
+                    case "$status" in
+                        "working") icon="🔨" ;;
+                        "idle") icon="💤" ;;
+                        "blocked") icon="🚫" ;;
+                        "testing") icon="🧪" ;;
+                        "reviewing") icon="👁️" ;;
+                        *) icon="❓" ;;
+                    esac
+
+                    if [[ -n "$task" ]]; then
+                        echo -e "  $icon ${CYAN}$agent${NC}: $status ($task)$stale_marker"
+                    else
+                        echo -e "  $icon ${CYAN}$agent${NC}: $status$stale_marker"
+                    fi
+                fi
+            done
+            echo ""
+        fi
+    fi
+
     # Show recent notifications
     if [[ -f "$NOTIFY_FILE" ]]; then
         local notify_count

package/bin/lib/constants.sh

@@ -24,6 +24,7 @@ TASKS_NEEDS_CHANGES="$TASKS_DIR/needs-changes"
 TASKS_MERGED="$TASKS_DIR/merged"
 TASKS_ATTENTION="$TASKS_DIR/attention"
 CONTEXT_DIR="context"
+AGENT_STATUS_DIR="$CONTEXT_DIR/agent-status"
 AGENTS_DIR="agents"
 
 # Config files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-forge",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Multi-agent development orchestration system for terminal-native vibe coding",
   "keywords": [
     "vibe-coding",