wogiflow 1.0.0

package/scripts/flow-constants.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+/**
+ * Wogi Flow - Constants
+ *
+ * Centralized magic numbers and configuration constants.
+ * Extracted from various files to improve maintainability.
+ *
+ * Usage:
+ *   const { TIMEOUTS, LIMITS, THRESHOLDS } = require('./flow-constants');
+ */
+
+// ============================================================
+// Timeout Constants (milliseconds)
+// ============================================================
+
+const TIMEOUTS = {
+  // Command execution
+  DEFAULT_COMMAND: 120000,      // 2 minutes - default shell command timeout
+  QUICK_COMMAND: 30000,         // 30 seconds - quick operations
+  LONG_COMMAND: 300000,         // 5 minutes - build/test operations
+
+  // HTTP requests
+  HTTP_DEFAULT: 30000,          // 30 seconds - general HTTP requests
+  HTTP_QUICK: 5000,             // 5 seconds - health checks
+  HTTP_LONG: 60000,             // 1 minute - large requests
+  HTTP_PROVIDER: 120000,        // 2 minutes - LLM provider requests
+
+  // File locking
+  LOCK_STALE: 60000,            // 1 minute - lock considered stale
+  LOCK_CLEANUP_STALE: 30000,    // 30 seconds - cleanup threshold
+  LOCK_RETRY_DELAY: 100,        // 100ms - delay between lock retries
+
+  // LSP/Language Server
+  LSP_DEFAULT: 5000,            // 5 seconds - LSP operations
+  LSP_ENRICH: 2000,             // 2 seconds - LSP enrichment
+
+  // Polling
+  POLL_INTERVAL: 1000,          // 1 second - default polling interval
+  ENDPOINT_CHECK: 3000,         // 3 seconds - endpoint availability check
+
+  // Caching
+  CACHE_TTL: 300000,            // 5 minutes - default cache TTL for integrations
+};
+
+// ============================================================
+// Limit Constants
+// ============================================================
+
+const LIMITS = {
+  // Retries
+  LOCK_MAX_RETRIES: 5,
+  HTTP_MAX_RETRIES: 3,
+  TASK_MAX_RETRIES: 5,
+
+  // History/Storage
+  MAX_SESSION_HISTORY: 50,
+  MAX_RECENT_FILES: 20,
+  MAX_RECENT_DECISIONS: 10,
+  MAX_REQUEST_LOG_ENTRIES: 100,
+  MAX_WORKFLOW_ITERATIONS: 100,
+
+  // Content
+  MAX_REGEX_LENGTH: 100,        // Prevent ReDoS
+  MAX_INPUT_LENGTH: 10000,      // Max string for regex testing
+  MAX_OUTPUT_SIZE: 1024 * 1024, // 1MB output limit
+
+  // File operations
+  MAX_FILE_WALK_DEPTH: 10,
+  MAX_CONCURRENT_TASKS: 5,
+};
+
+// ============================================================
+// Threshold Constants
+// ============================================================
+
+const THRESHOLDS = {
+  // Success rates (percentages)
+  SUCCESS_RATE_HIGH: 90,
+  SUCCESS_RATE_MEDIUM: 70,
+  SUCCESS_RATE_LOW: 50,
+
+  // Confidence scores
+  CONFIDENCE_HIGH: 0.8,
+  CONFIDENCE_MEDIUM: 0.5,
+  CONFIDENCE_LOW: 0.3,
+
+  // Context management
+  CONTEXT_WARN_PERCENT: 70,
+  CONTEXT_CRITICAL_PERCENT: 85,
+
+  // Small fix threshold (files)
+  SMALL_FIX_FILES: 3,
+};
+
+// ============================================================
+// Retry Backoff Constants
+// ============================================================
+
+const BACKOFF = {
+  BASE_DELAY: 1000,             // 1 second base
+  MAX_DELAY: 30000,             // 30 seconds max
+  MULTIPLIER: 2,                // Exponential multiplier
+  JITTER: 0.1,                  // 10% jitter
+};
+
+// ============================================================
+// Known Config Keys (for validation)
+// ============================================================
+
+const KNOWN_CONFIG_KEYS = [
+  'hybrid',
+  'parallel',
+  'worktree',
+  'qualityGates',
+  'testing',
+  'componentRules',
+  'mandatorySteps',
+  'phases',
+  'corrections',
+  'skills',
+  'autoContext',
+  'metrics',
+  'figmaAnalyzer',
+  'learning',
+  'hooks',
+  'project',
+  'projectType',
+  'contextMonitor',
+  'requestLog',
+  'sessionState',
+  'priorities',
+  'morningBriefing',
+  'commits',
+  'enforcement',
+  'damageControl',
+  'storyDecomposition',
+  'specificationMode',
+];
+
+module.exports = {
+  TIMEOUTS,
+  LIMITS,
+  THRESHOLDS,
+  BACKOFF,
+  KNOWN_CONFIG_KEYS,
+
+  // Legacy exports for backwards compatibility
+  DEFAULT_COMMAND_TIMEOUT_MS: TIMEOUTS.DEFAULT_COMMAND,
+  QUICK_COMMAND_TIMEOUT_MS: TIMEOUTS.QUICK_COMMAND,
+  LOCK_STALE_THRESHOLD_MS: TIMEOUTS.LOCK_STALE,
+  CLEANUP_LOCK_STALE_MS: TIMEOUTS.LOCK_CLEANUP_STALE,
+  LOCK_RETRY_DELAY_MS: TIMEOUTS.LOCK_RETRY_DELAY,
+  LOCK_MAX_RETRIES: LIMITS.LOCK_MAX_RETRIES,
+  MAX_SESSION_HISTORY: LIMITS.MAX_SESSION_HISTORY,
+  MAX_WORKFLOW_ITERATIONS: LIMITS.MAX_WORKFLOW_ITERATIONS,
+};

package/scripts/flow-context

@@ -0,0 +1,152 @@
+#!/bin/bash
+
+# Wogi Flow - Load Task Context
+# Gather all context needed to implement a task
+
+set -e
+
+WORKFLOW_DIR=".workflow"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+if [ -z "$1" ]; then
+    echo "Usage: flow context <task-id>"
+    echo ""
+    echo "Loads all context for implementing a task:"
+    echo "  - Task story and acceptance criteria"
+    echo "  - Related request-log entries"
+    echo "  - Referenced component docs"
+    echo "  - Relevant decisions"
+    exit 1
+fi
+
+TASK_ID="$1"
+
+echo -e "${CYAN}═══════════════════════════════════════${NC}"
+echo -e "${CYAN}  Context for: $TASK_ID${NC}"
+echo -e "${CYAN}═══════════════════════════════════════${NC}"
+echo ""
+
+# Find the task story file
+STORY_FILE=""
+for file in "$WORKFLOW_DIR/changes"/*/"$TASK_ID.md" "$WORKFLOW_DIR/changes"/*/*.md; do
+    if [ -f "$file" ] && grep -q "$TASK_ID" "$file" 2>/dev/null; then
+        STORY_FILE="$file"
+        break
+    fi
+done
+
+# 1. Task Story
+echo -e "${GREEN}📋 STORY${NC}"
+echo "─────────────────────────────────────"
+if [ -n "$STORY_FILE" ] && [ -f "$STORY_FILE" ]; then
+    cat "$STORY_FILE"
+else
+    # Try to find in tasks.json
+    for tasks_file in "$WORKFLOW_DIR/changes"/*/tasks.json; do
+        if [ -f "$tasks_file" ]; then
+            task_info=$(python3 -c "
+import json
+with open('$tasks_file') as f:
+    data = json.load(f)
+for task in data.get('tasks', []):
+    if task.get('id') == '$TASK_ID':
+        print(f\"Title: {task.get('title', 'N/A')}\")
+        print(f\"Status: {task.get('status', 'N/A')}\")
+        print(f\"Priority: {task.get('priority', 'N/A')}\")
+        us = task.get('userStory', {})
+        if us:
+            print(f\"\\nUser Story:\")
+            print(f\"  As a {us.get('asA', '?')}\")
+            print(f\"  I want {us.get('iWant', '?')}\")
+            print(f\"  So that {us.get('soThat', '?')}\")
+        print(f\"\\nDescription: {task.get('description', 'N/A')}\")
+        ac = task.get('acceptanceCriteria', [])
+        if ac:
+            print(f\"\\nAcceptance Criteria:\")
+            for c in ac:
+                if isinstance(c, dict):
+                    print(f\"  {c.get('scenario', 'Scenario')}:\")
+                    print(f\"    Given {c.get('given', '?')}\")
+                    print(f\"    When {c.get('when', '?')}\")
+                    print(f\"    Then {c.get('then', '?')}\")
+                else:
+                    print(f\"  - {c}\")
+        break
+" 2>/dev/null || true)
+            if [ -n "$task_info" ]; then
+                echo "$task_info"
+                break
+            fi
+        fi
+    done
+fi
+echo ""
+
+# 2. Related Request Log Entries
+echo -e "${GREEN}📜 RELATED HISTORY${NC}"
+echo "─────────────────────────────────────"
+if [ -f "$WORKFLOW_DIR/state/request-log.md" ]; then
+    # Search for task ID or related tags
+    related=$(grep -B1 -A5 "$TASK_ID" "$WORKFLOW_DIR/state/request-log.md" 2>/dev/null | head -30 || true)
+    if [ -n "$related" ]; then
+        echo "$related"
+    else
+        echo "No related entries found in request-log"
+    fi
+fi
+echo ""
+
+# 3. Referenced Components
+echo -e "${GREEN}🧩 COMPONENTS${NC}"
+echo "─────────────────────────────────────"
+if [ -f "$WORKFLOW_DIR/state/app-map.md" ]; then
+    echo "Available components:"
+    grep "^|" "$WORKFLOW_DIR/state/app-map.md" | grep -v "^| ---" | grep -v "^| Component" | grep -v "^| Screen" | grep -v "^| Modal" | head -15
+fi
+echo ""
+
+# 4. Relevant Decisions
+echo -e "${GREEN}📏 DECISIONS${NC}"
+echo "─────────────────────────────────────"
+if [ -f "$WORKFLOW_DIR/state/decisions.md" ]; then
+    # Show component and coding standards sections
+    head -50 "$WORKFLOW_DIR/state/decisions.md" | tail -40
+fi
+echo ""
+
+# 5. Dependencies
+echo -e "${GREEN}🔗 DEPENDENCIES${NC}"
+echo "─────────────────────────────────────"
+for tasks_file in "$WORKFLOW_DIR/changes"/*/tasks.json; do
+    if [ -f "$tasks_file" ]; then
+        python3 -c "
+import json
+with open('$tasks_file') as f:
+    data = json.load(f)
+for task in data.get('tasks', []):
+    if task.get('id') == '$TASK_ID':
+        deps = task.get('dependencies', [])
+        if deps:
+            print('Depends on:')
+            for d in deps:
+                print(f'  - {d}')
+        else:
+            print('No dependencies')
+        break
+" 2>/dev/null || true
+    fi
+done
+echo ""
+
+echo -e "${CYAN}═══════════════════════════════════════${NC}"
+echo ""
+echo "Ready to implement. Remember to:"
+echo "  1. Follow acceptance criteria exactly"
+echo "  2. Check app-map before creating components"
+echo "  3. Log changes to request-log"