strray-ai 1.13.5 → 1.14.2

package/.opencode/AGENTS-consumer.md

@@ -108,12 +108,13 @@ StringRay uses **two reflection folders** for different purposes:
 
 The `@storyteller` agent supports multiple story types:
 
-| Type | Description | Invoke |
-|------|-------------|--------|
-| `reflection` | Technical deep reflections on development process | `@storyteller write a reflection about X` |
-| `saga` | Long-form technical saga spanning multiple sessions | `@storyteller write a saga about X` |
-| `journey` | Investigation/learning journey | `@storyteller write a journey about X` |
-| `narrative` | Technical narrative - telling the story of code | `@storyteller write a narrative about X` |
+| Type | Description | Template Path | Invoke |
+|------|-------------|---------------|--------|
+| `reflection` | Technical deep reflections on development process | `docs/reflections/TEMPLATE.md` | `@storyteller write a reflection about X` |
+| `saga` | Long-form technical saga spanning multiple sessions | `docs/reflections/deep/SAGA_TEMPLATE.md` | `@storyteller write a saga about X` |
+| `journey` | Investigation/learning journey | `docs/reflections/JOURNEY_TEMPLATE.md` | `@storyteller write a journey about X` |
+| `narrative` | Technical narrative - telling the story of code | `docs/reflections/NARRATIVE_TEMPLATE.md` | `@storyteller write a narrative about X` |
+| `deep reflection` | Extended narrative with emotional journey | `docs/reflections/deep/TEMPLATE.md` | `@storyteller write a deep reflection about X` |
 
 **Example:**
 ```
@@ -139,10 +140,10 @@ The `@storyteller` agent supports multiple story types:
 
 StringRay automatically routes tasks based on complexity:
 
-- **Simple (≤20)**: Single agent
-- **Moderate (21-35)**: Single agent with tools
-- **Complex (36-75)**: Multi-agent coordination  
-- **Enterprise (>75)**: Orchestrator-led team
+- **Simple (≤15)**: Single agent
+- **Moderate (≤25)**: Single agent with tools
+- **Complex (≤50)**: Multi-agent coordination  
+- **Enterprise (>50)**: Orchestrator-led team
 
 ## CLI Commands
 
@@ -155,6 +156,7 @@ npx strray-ai capabilities # Show all features
 npx strray-ai report        # Generate reports
 npx strray-ai analytics    # Pattern analytics
 npx strray-ai calibrate    # Calibrate complexity
+npm run test:pipelines     # Pipeline integration tests
 ```
 
 ## Features.json Configuration
@@ -649,4 +651,4 @@ npx strray-ai --version
 - [Troubleshooting](https://github.com/htafolla/stringray/blob/master/docs/TROUBLESHOOTING.md)
 
 ---
-**Version**: 1.7.8 | [GitHub](https://github.com/htafolla/stringray)
+**Version**: 1.14.1 | [GitHub](https://github.com/htafolla/stringray)

package/.opencode/codex.codex

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.0",
+  "version": "1.14.1",
   "terms": [
     1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60
   ],

package/.opencode/enforcer-config.json

@@ -1,6 +1,6 @@
 {
   "framework": "StringRay 1.0.0",
-  "version": "1.10.0",
+  "version": "1.14.1",
   "description": "Codex-compliant framework configuration for Credible UI project",
   "thresholds": {
     "bundleSize": {
@@ -220,7 +220,7 @@
       }
     },
     "codex": {
-      "version": "1.10.0",
+      "version": "1.14.1",
       "terms": [
         1,
         2,

package/.opencode/hooks/post-commit

@@ -97,7 +97,7 @@ fi
 
           await frameworkLogger.log('-git-hook-trigger', '-post-commit-validation-passed-in-result-duration-', 'success', { message: '✅ Post-commit: Validation passed in ' + result.duration + 'ms' });
         } catch (error) {
-          console.error('❌ Post-commit validation failed:', error instanceof Error ? error.message : String(error));
+          await frameworkLogger.log('git-hook-trigger', 'post-commit-validation-failed', 'error', { error: error instanceof Error ? error.message : String(error) });
           process.exit(1);
         }
       })();
@@ -115,16 +115,72 @@ fi
         try {
           // Use dynamic import that works in both dev and consumer
           const basePath = process.env.STRRAY_BASE_PATH || '.';
+          // First archive logs (compress and rotate) before cleanup
+          const { archiveLogFiles } = await import(basePath + '/dist/postprocessor/triggers/GitHookTrigger.js');
+          const archiveResult = await archiveLogFiles({
+            archiveDirectory: 'logs/framework',
+            maxFileSizeMB: 10,  // Archive if > 10MB
+            rotationIntervalHours: 24,  // Archive if > 24 hours old
+            compressionEnabled: true,
+            maxAgeHours: 168,  // Keep archives for 7 days
+            directories: ['logs/framework'],
+            excludePatterns: []
+          });
+          if (archiveResult.archived > 0) {
+            await frameworkLogger.log('-git-hook-trigger', '-archived-log-files-', 'info', { message: `📦 Archived ${archiveResult.archived} log files` });
+          }
+
+          // Then cleanup old files
           const { cleanupLogFiles } = await import(basePath + '/dist/postprocessor/triggers/GitHookTrigger.js');
           const result = await cleanupLogFiles({
             maxAgeHours: 24,
-            excludePatterns: ['logs/framework/activity.log', 'logs/agents/refactoring-log.md', 'current-session.log'],
+            excludePatterns: [
+              // Core inference/logging - NEVER DELETE
+              'activity.log',           
+              'framework-activity-',
+              'strray-plugin-',
+              
+              // Analysis & reflections - Contains inference data
+              'kernel-',
+              'reflection-',
+              
+              // Documentation & plans - Important artifacts
+              '.md',
+              'AUTOMATED_',
+              'REFACTORING-',
+              'release-',
+              
+              // Subdirectories with important data (but test-activity should be cleaned)
+              'deployment/',
+              'monitoring/',
+              'reports/',
+              'reflections/',
+              
+              // Init logs can be cleaned but keep recent
+              'strray-init-2026-01-2',   // Keep Jan 20s
+              'strray-init-2026-01-3',   // Keep Jan 30s
+              
+              // Other important files
+              'current-session.log',
+              'full-test-run.log',
+              'kernel-codex',
+              'kernel-methodology',
+              'kernel-status',
+              'kernel-update',
+              'kernel-v2',
+            ],
             directories: ['logs/'],
             enabled: true
           });
           if (result.cleaned > 0) {
-            await frameworkLogger.log('-git-hook-trigger', '-cleaned-result-cleaned-old-log-files-', 'info', { message: `🧹 Cleaned ${result.cleaned} old log files` });
+            await frameworkLogger.log('-git-hook-trigger', '-cleaned-result-cleaned-old-log-files-', 'info', { message: '🧹 Cleaned ' + result.cleaned + ' old log files' });
           }
+          if (result.errors.length > 0) {
+            await frameworkLogger.log('git-hook-trigger', 'log-cleanup-errors', 'error', { errors: result.errors });
+          }
+        } catch (error) {
+          await frameworkLogger.log('git-hook-trigger', 'log-cleanup-failed', 'error', { error: error instanceof Error ? error.message : String(error) });
+        }
           if (result.errors.length > 0) {
             console.error('Log cleanup errors:', result.errors);
           }

package/.opencode/hooks/post-commit.backup

@@ -1,129 +1,172 @@
 #!/bin/bash
-# StrRay Post-Processor post-commit Hook
-# Automatically triggers post-processor after commit
-# Suggests reflection writing for significant changes
-
-set -e
+# StringRay Post-Processor post-commit Hook
+# Automatically triggers post-processor after post-commit
 
+# Get hook type from script name
 HOOK_NAME=$(basename "$0")
-COMMIT_SHA=$(git rev-parse HEAD)
-BRANCH=$(git rev-parse --abbrev-ref HEAD)
-AUTHOR=$(git log -1 --pretty=format:'%an <%ae>')
+COMMIT_SHA=""
+
+if [ "$HOOK_NAME" = "post-commit" ]; then
+  # Light monitoring for local commits - just basic validation
+  COMMIT_SHA=$(git rev-parse HEAD)
+  MONITORING_LEVEL="basic"
+elif [ "$HOOK_NAME" = "post-push" ]; then
+  # Full monitoring for pushes - comprehensive validation
+  # For push hooks, we need to parse the pushed refs from stdin
+  while read local_ref local_sha remote_ref remote_sha; do
+    if [ "$local_sha" != "0000000000000000000000000000000000000000" ]; then
+      COMMIT_SHA=$local_sha
+      break
+    fi
+  done
+  MONITORING_LEVEL="full"
+else
+  COMMIT_SHA=$(git rev-parse HEAD)
+  MONITORING_LEVEL="basic"
+fi
 
 if [ -z "$COMMIT_SHA" ]; then
+  echo "Warning: Could not determine commit SHA for post-processor"
   exit 0
 fi
 
-# Get changed files
-FILES=$(git diff --name-only HEAD~1 2>/dev/null || git diff --name-only --cached)
-
-# Get commit message for reflection decision
-COMMIT_MSG=$(git log -1 --pretty=format:'%s')
-
-# Check if this commit warrants reflection
-# (debugging, bug fixes, path issues, significant changes)
-REFLECTION_TRIGGERS="debug|fix|bug|path|mcp|consumer|installation|reflection"
-if echo "$COMMIT_MSG" | grep -qiE "$REFLECTION_TRIGGERS"; then
-  echo "📝 Reflection Suggestion: This commit appears to involve debugging, fixes, or significant changes."
-  echo "   Consider writing a reflection using the template at docs/reflections/TEMPLATE.md"
-  echo ""
-fi
-
-# Check for new reflection files and validate them
-NEW_REFLECTIONS=$(git diff --name-only HEAD~1 2>/dev/null | grep "^docs/reflections/.*\.md$" | grep -v "TEMPLATE.md" || true)
-if [ -n "$NEW_REFLECTIONS" ]; then
-  echo "🔍 Validating new reflection files..."
-  for ref in $NEW_REFLECTIONS; do
-    if [ -f "$ref" ]; then
-      if bash scripts/node/reflection-check.sh "$ref" 2>/dev/null; then
-        echo "   ✅ $ref passes template validation"
-      else
-        echo "   ❌ $ref FAILED template validation"
-        echo "   📖 Read the template: docs/reflections/TEMPLATE.md"
-        echo "   ⚠️  Please fix the reflection to match the template before committing"
-      fi
-    fi
-  done
-  echo ""
-fi
+# Get repository info
+REPO="strray-framework/stringray"  # Placeholder for now
+BRANCH=$(git rev-parse --abbrev-ref HEAD)
+AUTHOR=$(git log -1 --pretty=format:'%an <%ae>')
 
-# Check if AGENTS.md was modified and validate it
-AGENTS_MODIFIED=$(git diff --name-only HEAD~1 2>/dev/null | grep "^AGENTS.md$" || true)
-if [ -n "$AGENTS_MODIFIED" ]; then
-  echo "🔍 Validating AGENTS.md..."
-  if [ -f "AGENTS.md" ]; then
-    # Check required sections
-    ERRORS=0
-    for section in "## Available Agents" "## Complexity Routing" "## CLI Commands" "## Codex"; do
-      if grep -q "$section" AGENTS.md; then
-        echo "   ✅ Contains: $section"
-      else
-        echo "   ❌ Missing: $section"
-        ERRORS=$((ERRORS + 1))
-      fi
-    done
-    
-    # Check agent count
-    AGENT_COUNT=$(grep -o '@[a-z-]*' AGENTS.md | wc -l)
-    if [ "$AGENT_COUNT" -ge 15 ]; then
-      echo "   ✅ Agent count: $AGENT_COUNT (recommended: 20+)"
-    else
-      echo "   ⚠️  Agent count: $AGENT_COUNT (recommended: 20+)"
-    fi
-    
-    if [ "$ERRORS" -gt 0 ]; then
-      echo "   ⚠️  AGENTS.md has $ERRORS missing required sections"
-      echo "   📖 See AGENTS.md in root for current format"
-    else
-      echo "   ✅ AGENTS.md validation passed"
-    fi
-  else
-    echo "   ❌ AGENTS.md not found"
-  fi
-  echo ""
+# Get changed files (different logic for commit vs push)
+if [ "$HOOK_NAME" = "post-commit" ]; then
+  FILES=$(git diff --name-only HEAD~1 2>/dev/null || git diff --name-only --cached)
+else
+  FILES=$(git log --name-only --oneline -1 $COMMIT_SHA | tail -n +2)
 fi
 
-# For consumer projects, always use the full node_modules path to avoid symlink issues
-# This ensures imports resolve correctly
-STRRAY_PATH=""
-for pkg in "strray-ai" "strray-framework"; do
-  if [ -d "node_modules/$pkg/dist" ]; then
-    STRRAY_PATH="node_modules/$pkg"
-    break
+# Trigger post-processor asynchronously (don't block git operations)
+(
+  cd "$(dirname "$0")/../.." # Navigate to project root
+
+  # Find the StringRay plugin in node_modules or current project (development)
+  STRRAY_PLUGIN=""
+  if [ -d "node_modules/strray-framework" ]; then
+    STRRAY_PLUGIN="node_modules/strray-framework"
+  elif [ -d "node_modules/@strray/strray-framework" ]; then
+    STRRAY_PLUGIN="node_modules/@strray/strray-framework"
+  elif [ -d "node_modules/OpenCode/plugins/strray-framework" ]; then
+    STRRAY_PLUGIN="node_modules/OpenCode/plugins/strray-framework"
+  elif [ -f "dist/postprocessor/PostProcessor.js" ]; then
+    # Development mode - use current project
+    STRRAY_PLUGIN="."
   fi
-done
 
-if [ -z "$STRRAY_PATH" ]; then
-  # Fallback to local dist for development
-  if [ -d "dist" ]; then
-    STRRAY_PATH="."
+  if command -v node >/dev/null 2>&1 && [ -n "$STRRAY_PLUGIN" ]; then
+    # Call a separate script to avoid bash variable issues
+    export COMMIT_SHA="$COMMIT_SHA"
+    export REPO="$REPO"
+    export BRANCH="$BRANCH"
+    export AUTHOR="$AUTHOR"
+    export STRRAY_PLUGIN="$STRRAY_PLUGIN"
+    export MONITORING_LEVEL="$MONITORING_LEVEL"
+    export IS_FULL_MONITORING="$([ "$MONITORING_LEVEL" = "full" ] && echo "true" || echo "false")"
+
+    # Run appropriate monitoring based on hook type
+    if [ "$HOOK_NAME" = "post-commit" ]; then
+      # LIGHT MONITORING: Quick validation, don't block git workflow
+      # Timeout: 2 seconds max, log metrics for monitoring
+      START_TIME=$(date +%s)
+      timeout 2 node -e "
+      (async () => {
+        try {
+          // Use import resolver to avoid hardcoded dist paths
+          const { importResolver } = await import('./utils/import-resolver.js');
+          const { LightweightValidator } = await importResolver.importModule('postprocessor/validation/LightweightValidator');
+
+          const validator = new LightweightValidator();
+          const result = await validator.validate();
+
+          if (result.warnings.length > 0) {
+            await frameworkLogger.log('-git-hook-trigger', '-result-warnings-length-warning-s-found-', 'info', { message: '⚠️ ' + result.warnings.length + ' warning(s) found:' });
+            result.warnings.forEach(w => await frameworkLogger.log('-git-hook-trigger', '-w-', 'info', { message: '   ' + w) });
+          }
+
+          if (!result.passed) {
+            await frameworkLogger.log('-git-hook-trigger', '-result-errors-length-error-s-found-', 'error', { message: '❌ ' + result.errors.length + ' error(s) found:' });
+            result.errors.forEach(e => await frameworkLogger.log('-git-hook-trigger', '-e-', 'info', { message: '   ' + e) });
+            process.exit(1);
+          }
+
+          await frameworkLogger.log('-git-hook-trigger', '-post-commit-validation-passed-in-result-duration-', 'success', { message: '✅ Post-commit: Validation passed in ' + result.duration + 'ms' });
+        } catch (error) {
+          console.error('❌ Post-commit validation failed:', error instanceof Error ? error.message : String(error));
+          process.exit(1);
+        }
+      })();
+      " 2>/dev/null
+      EXIT_CODE=$?
+      END_TIME=$(date +%s)
+      DURATION=$((END_TIME - START_TIME))
+
+      # Log metrics for monitoring (convert to milliseconds)
+      DURATION_MS=$((DURATION * 1000))
+      # LOG CLEANUP: Remove old log files after validation
+      # Use relative path from CWD - works in both dev and consumer
+      node -e "
+      (async () => {
+        try {
+          // Use dynamic import that works in both dev and consumer
+          const basePath = process.env.STRRAY_BASE_PATH || '.';
+          const { cleanupLogFiles } = await import(basePath + '/dist/postprocessor/triggers/GitHookTrigger.js');
+          const result = await cleanupLogFiles({
+            maxAgeHours: 24,
+            excludePatterns: ['logs/framework/activity.log', 'logs/agents/refactoring-log.md', 'current-session.log'],
+            directories: ['logs/'],
+            enabled: true
+          });
+          if (result.cleaned > 0) {
+            await frameworkLogger.log('-git-hook-trigger', '-cleaned-result-cleaned-old-log-files-', 'info', { message: `🧹 Cleaned ${result.cleaned} old log files` });
+          }
+          if (result.errors.length > 0) {
+            console.error('Log cleanup errors:', result.errors);
+          }
+        } catch (error) {
+          console.error('Log cleanup failed:', error.message);
+        }
+      })();
+      "
+
+      echo "HOOK_METRICS: post-commit duration=${DURATION_MS}ms exit_code=${EXIT_CODE}" >&2
+      collector.recordMetrics('post-commit', ${DURATION_MS}, ${EXIT_CODE});
+      " 2>/dev/null
+      EXIT_CODE=$?
+      END_TIME=$(date +%s)
+      DURATION=$((END_TIME - START_TIME))
+
+      # Log comprehensive metrics for monitoring (convert to milliseconds)
+      DURATION_MS=$((DURATION * 1000))
+      echo "HOOK_METRICS: post-push duration=${DURATION_MS}ms exit_code=${EXIT_CODE}" >&2
+
+      # Record metrics using metrics collector (direct import for reliability)
+      # Use environment variable for base path - works in both dev and consumer
+      node -e "
+      (async () => {
+        try {
+          const basePath = process.env.STRRAY_BASE_PATH || '.';
+          const distPath = process.env.STRRAY_DIST_PATH || 'dist';
+          const { HookMetricsCollector } = await import(basePath + '/' + distPath + '/postprocessor/validation/HookMetricsCollector.js');
+          const collector = new HookMetricsCollector();
+          collector.recordMetrics('post-push', ${DURATION_MS}, ${EXIT_CODE});
+        } catch (error) {
+          // Silently fail if metrics collection fails
+        }
+      })();
+      " 2>/dev/null || true
+
+      [ $EXIT_CODE -eq 0 ] && exit 0 || exit 1
+    fi
   else
-    exit 0
+    echo "Warning: StringRay plugin not found or Node.js not available, skipping post-processor"
   fi
-fi
-
-# Run post-processor in background with Node.js
-node --input-type=module << EOF &>/dev/null || true
-import { PostProcessor } from './$STRRAY_PATH/dist/postprocessor/PostProcessor.js';
-import { StrRayStateManager } from './$STRRAY_PATH/dist/state/state-manager.js';
-
-const stateManager = new StrRayStateManager();
-const postProcessor = new PostProcessor(stateManager, null, { 
-  reporting: { enabled: false } 
-});
-
-const files = \`$FILES\`.split('\n').filter(f => f.endsWith('.ts') && !f.includes('.test.'));
-
-await postProcessor.executePostProcessorLoop({
-  commitSha: '$COMMIT_SHA',
-  repository: 'strray-framework/stringray',
-  branch: '$BRANCH',
-  author: '$AUTHOR',
-  files: files,
-  trigger: 'git-hook'
-});
-
-console.log('Post-processor completed for', files.length, 'files');
-EOF
+)
 
+# Don't wait for background process
 exit 0

package/.opencode/hooks/post-push

@@ -97,7 +97,7 @@ fi
 
           await frameworkLogger.log('-git-hook-trigger', '-post-commit-validation-passed-in-result-duration-', 'success', { message: '✅ Post-commit: Validation passed in ' + result.duration + 'ms' });
         } catch (error) {
-          console.error('❌ Post-commit validation failed:', error instanceof Error ? error.message : String(error));
+          await frameworkLogger.log('git-hook-trigger', 'post-commit-validation-failed', 'error', { error: error instanceof Error ? error.message : String(error) });
           process.exit(1);
         }
       })();
@@ -115,16 +115,72 @@ fi
         try {
           // Use dynamic import that works in both dev and consumer
           const basePath = process.env.STRRAY_BASE_PATH || '.';
+          // First archive logs (compress and rotate) before cleanup
+          const { archiveLogFiles } = await import(basePath + '/dist/postprocessor/triggers/GitHookTrigger.js');
+          const archiveResult = await archiveLogFiles({
+            archiveDirectory: 'logs/framework',
+            maxFileSizeMB: 10,  // Archive if > 10MB
+            rotationIntervalHours: 24,  // Archive if > 24 hours old
+            compressionEnabled: true,
+            maxAgeHours: 168,  // Keep archives for 7 days
+            directories: ['logs/framework'],
+            excludePatterns: []
+          });
+          if (archiveResult.archived > 0) {
+            await frameworkLogger.log('-git-hook-trigger', '-archived-log-files-', 'info', { message: `📦 Archived ${archiveResult.archived} log files` });
+          }
+
+          // Then cleanup old files
           const { cleanupLogFiles } = await import(basePath + '/dist/postprocessor/triggers/GitHookTrigger.js');
           const result = await cleanupLogFiles({
             maxAgeHours: 24,
-            excludePatterns: ['logs/framework/activity.log', 'logs/agents/refactoring-log.md', 'current-session.log'],
+            excludePatterns: [
+              // Core inference/logging - NEVER DELETE
+              'activity.log',           
+              'framework-activity-',
+              'strray-plugin-',
+              
+              // Analysis & reflections - Contains inference data
+              'kernel-',
+              'reflection-',
+              
+              // Documentation & plans - Important artifacts
+              '.md',
+              'AUTOMATED_',
+              'REFACTORING-',
+              'release-',
+              
+              // Subdirectories with important data (but test-activity should be cleaned)
+              'deployment/',
+              'monitoring/',
+              'reports/',
+              'reflections/',
+              
+              // Init logs can be cleaned but keep recent
+              'strray-init-2026-01-2',   // Keep Jan 20s
+              'strray-init-2026-01-3',   // Keep Jan 30s
+              
+              // Other important files
+              'current-session.log',
+              'full-test-run.log',
+              'kernel-codex',
+              'kernel-methodology',
+              'kernel-status',
+              'kernel-update',
+              'kernel-v2',
+            ],
             directories: ['logs/'],
             enabled: true
           });
           if (result.cleaned > 0) {
-            await frameworkLogger.log('-git-hook-trigger', '-cleaned-result-cleaned-old-log-files-', 'info', { message: `🧹 Cleaned ${result.cleaned} old log files` });
+            await frameworkLogger.log('-git-hook-trigger', '-cleaned-result-cleaned-old-log-files-', 'info', { message: '🧹 Cleaned ' + result.cleaned + ' old log files' });
           }
+          if (result.errors.length > 0) {
+            await frameworkLogger.log('git-hook-trigger', 'log-cleanup-errors', 'error', { errors: result.errors });
+          }
+        } catch (error) {
+          await frameworkLogger.log('git-hook-trigger', 'log-cleanup-failed', 'error', { error: error instanceof Error ? error.message : String(error) });
+        }
           if (result.errors.length > 0) {
             console.error('Log cleanup errors:', result.errors);
           }