codex-genesis-harness 0.1.1 → 0.1.4

package/scripts/offload-log.sh

@@ -0,0 +1,72 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# Genesis Codex Harness — Tool Call Offloading Script
+# ==============================================================================
+# Captures standard output & error of any command, saves it to a durable log file,
+# and prints a trimmed head-and-tail summary if it exceeds a line count threshold.
+# Protects the AI context window against Context Rot.
+# ==============================================================================
+
+set -uo pipefail
+
+THRESHOLD_LINES=50
+SCRATCH_DIR="scratch/tool_outputs"
+
+usage() {
+  echo "Usage: $0 [--threshold lines] <command> [args...]" >&2
+  exit 2
+}
+
+if [ "$#" -eq 0 ]; then
+  usage
+fi
+
+if [ "$1" = "--threshold" ]; then
+  THRESHOLD_LINES="$2"
+  shift 2
+fi
+
+if [ "$#" -eq 0 ]; then
+  usage
+fi
+
+mkdir -p "$SCRATCH_DIR"
+
+# Generate unique log file path
+TIMESTAMP="$(date +%Y%m%d_%H%M%S)"
+RAND_ID=$((RANDOM % 10000))
+LOG_FILE="$SCRATCH_DIR/output_${TIMESTAMP}_${RAND_ID}.log"
+
+# Execute command and capture output
+set +e
+"$@" > "$LOG_FILE" 2>&1
+EXIT_CODE=$?
+set -e
+
+# Calculate output size
+LINE_COUNT=$(wc -l < "$LOG_FILE")
+
+if [ "$LINE_COUNT" -le "$THRESHOLD_LINES" ]; then
+  # Print normally if within threshold
+  cat "$LOG_FILE"
+else
+  # Offload and print head/tail summary
+  HEAD_LINES=$((THRESHOLD_LINES / 2))
+  TAIL_LINES=$((THRESHOLD_LINES / 2))
+
+  echo "=============================================================================="
+  echo "==> [OFFLOADED] Command output exceeded threshold ($LINE_COUNT lines > $THRESHOLD_LINES lines)."
+  echo "==> Full log written to disk: file://$(pwd)/$LOG_FILE"
+  echo "=============================================================================="
+  
+  head -n "$HEAD_LINES" "$LOG_FILE"
+  
+  echo ""
+  echo "... [TRUNCATED $(($LINE_COUNT - THRESHOLD_LINES)) LINES] ..."
+  echo "Read file://$LOG_FILE to view the full execution history."
+  echo ""
+  
+  tail -n "$TAIL_LINES" "$LOG_FILE"
+fi
+
+exit $EXIT_CODE

package/scripts/run-evals.sh

@@ -1,6 +1,6 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
+#!/usr/bin/env bash
+set -euo pipefail
+
 repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 skill_root="$repo_root/.codex/skills"
 harness_dir="$skill_root/genesis-harness"
@@ -8,35 +8,44 @@ skill_names=(
   genesis-harness
   genesis-new-design
   genesis-upgrade-design
-  architecture-skill
-  planning-skill
-  codebase-map-skill
-  design-spec-skill
-  api-contract-skill
+  genesis-architecture
+  genesis-planning
+  genesis-codebase-map
+  genesis-design-spec
+  genesis-api-contract
   ui-ux-test-skill
-  harness-engineering-skill
-  ai-provider-skill
-  pipeline-orchestration-skill
-  research-skill
-  docs-skill
-  release-skill
+  genesis-harness-engineering
+  genesis-ai-provider
+  genesis-pipeline-orchestration
+  genesis-research
+  genesis-docs
+  genesis-release
+  genesis-api-sync
+  genesis-debug-guide
+  genesis-docs-automation
+  genesis-spec-propagation
+  genesis-release-orchestration
+  genesis-performance-profiling
+  genesis-observability-automation
+  genesis-research-first
+  spec-impact-engine
 )
-
-fail() {
-  echo "eval failed: $*" >&2
-  exit 1
-}
-
-assert_file() {
-  [ -f "$1" ] || fail "missing file: ${1#$repo_root/}"
-}
-
-assert_contains() {
-  local file="$1"
-  local text="$2"
-  grep -q -- "$text" "$file" || fail "missing '$text' in ${file#$repo_root/}"
-}
-
+
+fail() {
+  echo "eval failed: $*" >&2
+  exit 1
+}
+
+assert_file() {
+  [ -f "$1" ] || fail "missing file: ${1#$repo_root/}"
+}
+
+assert_contains() {
+  local file="$1"
+  local text="$2"
+  grep -q -- "$text" "$file" || fail "missing '$text' in ${file#$repo_root/}"
+}
+
 assert_file "$repo_root/.codex-plugin/plugin.json"
 assert_contains "$repo_root/.codex-plugin/plugin.json" '"skills"'
 assert_contains "$repo_root/.codex-plugin/plugin.json" '"genesis-skill-set"'
@@ -49,10 +58,28 @@ done
 for skill_name in "${skill_names[@]}"; do
   assert_file "$skill_root/$skill_name/SKILL.md"
   assert_file "$skill_root/$skill_name/agents/openai.yaml"
-  assert_contains "$skill_root/$skill_name/SKILL.md" "name: $skill_name"
+  
+  expected_name="$skill_name"
+  case "$skill_name" in
+    genesis-architecture) expected_name="architecture-skill" ;;
+    genesis-planning) expected_name="planning-skill" ;;
+    genesis-codebase-map) expected_name="codebase-map-skill" ;;
+    genesis-design-spec) expected_name="design-spec-skill" ;;
+    genesis-api-contract) expected_name="api-contract-skill" ;;
+    genesis-harness-engineering) expected_name="harness-engineering-skill" ;;
+    genesis-ai-provider) expected_name="ai-provider-skill" ;;
+    genesis-pipeline-orchestration) expected_name="pipeline-orchestration-skill" ;;
+    genesis-research) expected_name="research-skill" ;;
+    genesis-docs) expected_name="docs-skill" ;;
+    genesis-release) expected_name="release-skill" ;;
+    genesis-api-sync) expected_name="api-sync-skill" ;;
+    genesis-debug-guide) expected_name="debug-guide-skill" ;;
+  esac
+
+  assert_contains "$skill_root/$skill_name/SKILL.md" "name: $expected_name"
 done
-
-assert_contains "$repo_root/scripts/install.sh" '--target agents|legacy|both'
+
+assert_contains "$repo_root/scripts/install.sh" '--target agents|legacy|both'
 assert_contains "$repo_root/scripts/uninstall.sh" '--target agents|legacy|both'
 assert_contains "$repo_root/bin/genesis-harness.js" '--target agents|legacy|both'
 assert_contains "$repo_root/package.json" '".codex-plugin"'
@@ -61,20 +88,20 @@ assert_contains "$repo_root/package.json" '"contracts"'
 assert_contains "$repo_root/package.json" '"fixtures"'
 assert_contains "$repo_root/package.json" '"playwright"'
 assert_contains "$repo_root/package.json" '"observability"'
-assert_contains "$repo_root/README.md" '.agents/skills'
+assert_contains "$repo_root/README.md" '.codex/skills/'
 
 for skill_name in "${skill_names[@]}"; do
   assert_contains "$repo_root/bin/genesis-harness.js" "$skill_name"
   assert_contains "$repo_root/scripts/install.sh" "$skill_name"
   assert_contains "$repo_root/scripts/uninstall.sh" "$skill_name"
 done
-
-tmp="$(mktemp -d)"
-cleanup() {
-  rm -rf "$tmp"
-}
-trap cleanup EXIT
-
+
+tmp="$(mktemp -d)"
+cleanup() {
+  rm -rf "$tmp"
+}
+trap cleanup EXIT
+
 CODEX_HOME="$tmp/codex" GENESIS_HARNESS_HOME="$tmp/agents" bash "$repo_root/scripts/install.sh" --target both >/dev/null
 for skill_name in "${skill_names[@]}"; do
   [ -f "$tmp/agents/skills/$skill_name/SKILL.md" ] || fail "agents install target missing: $skill_name"
@@ -87,5 +114,5 @@ for skill_name in "${skill_names[@]}" project-genesis-harness; do
   [ ! -e "$tmp/agents/skills/$skill_name" ] || fail "agents uninstall target remains: $skill_name"
   [ ! -e "$tmp/codex/skills/$skill_name" ] || fail "legacy uninstall target remains: $skill_name"
 done
-
-echo "evals passed"
+
+echo "evals passed"

package/scripts/run-verify-loop.sh

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# Genesis Codex Harness — Ralph Loop (Verify-Fix) Orchestrator
+# ==============================================================================
+# Executes verification commands, tracks iteration counts to prevent infinite loops,
+# and logs diagnostic failure reports to disk for step resumption.
+# Enforces the self-verification safety invariant.
+# ==============================================================================
+
+set -uo pipefail
+
+MAX_ITERATIONS=5
+PLANNING_DIR=".planning"
+LOOP_COUNT_FILE="$PLANNING_DIR/VERIFY_LOOP_COUNT"
+FAILURE_LOG="$PLANNING_DIR/LAST_VERIFICATION_FAILURE.md"
+
+usage() {
+  echo "Usage: $0 [--max-iterations N] <verification_command> [args...]" >&2
+  exit 2
+}
+
+if [ "$#" -eq 0 ]; then
+  usage
+fi
+
+if [ "$1" = "--max-iterations" ]; then
+  MAX_ITERATIONS="$2"
+  shift 2
+fi
+
+if [ "$#" -eq 0 ]; then
+  usage
+fi
+
+mkdir -p "$PLANNING_DIR"
+
+# Initialize loop count
+CURRENT_ITERATION=1
+if [ -f "$LOOP_COUNT_FILE" ]; then
+  CURRENT_ITERATION=$(cat "$LOOP_COUNT_FILE")
+  CURRENT_ITERATION=$((CURRENT_ITERATION + 1))
+fi
+
+echo "$CURRENT_ITERATION" > "$LOOP_COUNT_FILE"
+
+echo "==> [VERIFY LOOP] Iteration $CURRENT_ITERATION of $MAX_ITERATIONS"
+
+if [ "$CURRENT_ITERATION" -gt "$MAX_ITERATIONS" ]; then
+  echo "=============================================================================="
+  echo "==> [BLOCKED] Verify-Fix loop exceeded maximum iteration count ($MAX_ITERATIONS)."
+  echo "==> Potentially stuck in an infinite loop. Halting for human intervention."
+  echo "=============================================================================="
+  rm -f "$LOOP_COUNT_FILE"
+  exit 99
+fi
+
+# Execute verification command
+set +e
+"$@" > "$FAILURE_LOG" 2>&1
+EXIT_CODE=$?
+set -e
+
+if [ $EXIT_CODE -eq 0 ]; then
+  echo "==> [VERIFY LOOP] Pass! Verification completed successfully."
+  rm -f "$LOOP_COUNT_FILE"
+  rm -f "$FAILURE_LOG"
+else
+  echo "=============================================================================="
+  echo "==> [FAILURE] Verification failed with exit code $EXIT_CODE."
+  echo "==> Failure diagnostic written to: file://$(pwd)/$FAILURE_LOG"
+  echo "==> Please inspect the log, fix the root cause, and re-run verification."
+  echo "=============================================================================="
+fi
+
+exit $EXIT_CODE

package/scripts/uninstall.sh

@@ -1,55 +1,64 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
+#!/usr/bin/env bash
+set -euo pipefail
+
 skill_names=(
   genesis-harness
   genesis-new-design
   genesis-upgrade-design
-  architecture-skill
-  planning-skill
-  codebase-map-skill
-  design-spec-skill
-  api-contract-skill
+  genesis-architecture
+  genesis-planning
+  genesis-codebase-map
+  genesis-design-spec
+  genesis-api-contract
   ui-ux-test-skill
-  harness-engineering-skill
-  ai-provider-skill
-  pipeline-orchestration-skill
-  research-skill
-  docs-skill
-  release-skill
+  genesis-harness-engineering
+  genesis-ai-provider
+  genesis-pipeline-orchestration
+  genesis-research
+  genesis-docs
+  genesis-release
+  genesis-api-sync
+  genesis-debug-guide
+  genesis-docs-automation
+  genesis-spec-propagation
+  genesis-release-orchestration
+  genesis-performance-profiling
+  genesis-observability-automation
+  genesis-research-first
+  spec-impact-engine
   project-genesis-harness
 )
 codex_home="${CODEX_HOME:-$HOME/.codex}"
 agents_home="${GENESIS_HARNESS_HOME:-$HOME/.agents}"
-target="both"
-
-usage() {
-  echo "Usage: $0 [--target agents|legacy|both]" >&2
-}
-
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --target)
-      target="${2:-}"
-      [ -n "$target" ] || { usage; exit 2; }
-      shift 2
-      ;;
-    --help|-h)
-      usage
-      exit 0
-      ;;
-    *)
-      usage
-      exit 2
-      ;;
-  esac
-done
-
-case "$target" in
-  agents|legacy|both) ;;
-  *) usage; exit 2 ;;
-esac
-
+target="both"
+
+usage() {
+  echo "Usage: $0 [--target agents|legacy|both]" >&2
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --target)
+      target="${2:-}"
+      [ -n "$target" ] || { usage; exit 2; }
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    *)
+      usage
+      exit 2
+      ;;
+  esac
+done
+
+case "$target" in
+  agents|legacy|both) ;;
+  *) usage; exit 2 ;;
+esac
+
 remove_one() {
   local target_root="$1"
   for skill_name in "${skill_names[@]}"; do