codex-genesis-harness 0.1.0 → 0.1.4

package/scripts/install.sh

@@ -1,69 +1,103 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-skill_name="project-genesis-harness"
-source_dir="$repo_root/.codex/skills/$skill_name"
-codex_home="${CODEX_HOME:-$HOME/.codex}"
-agents_home="${GENESIS_HARNESS_HOME:-$HOME/.agents}"
-target="both"
-
-usage() {
-  echo "Usage: $0 [--target agents|legacy|both]" >&2
-  echo "  agents: install to ${agents_home}/skills/${skill_name}" >&2
-  echo "  legacy: install to ${codex_home}/skills/${skill_name}" >&2
-  echo "  both: install to both locations" >&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
-
-if [ ! -f "$source_dir/SKILL.md" ]; then
-  echo "Missing skill source: $source_dir/SKILL.md" >&2
-  exit 1
-fi
-
-install_one() {
-  local target_dir="$1"
-  mkdir -p "$(dirname "$target_dir")"
-
-  if [ -e "$target_dir" ]; then
-    backup_dir="${target_dir}.backup.$(date +%Y%m%d%H%M%S)"
-    mv "$target_dir" "$backup_dir"
-    echo "Existing skill backed up to: $backup_dir"
-  fi
-
-  cp -R "$source_dir" "$target_dir"
-  find "$target_dir/scripts" -type f -name '*.sh' -exec chmod +x {} \;
-  echo "Installed $skill_name to: $target_dir"
-}
-
-if [ "$target" = "agents" ] || [ "$target" = "both" ]; then
-  install_one "$agents_home/skills/$skill_name"
-fi
-
-if [ "$target" = "legacy" ] || [ "$target" = "both" ]; then
-  install_one "$codex_home/skills/$skill_name"
-fi
-
-echo "Invoke it in Codex with: Use \$$skill_name"
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+skill_names=(
+  genesis-harness
+  genesis-new-design
+  genesis-upgrade-design
+  genesis-architecture
+  genesis-planning
+  genesis-codebase-map
+  genesis-design-spec
+  genesis-api-contract
+  ui-ux-test-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
+)
+source_root="$repo_root/.codex/skills"
+codex_home="${CODEX_HOME:-$HOME/.codex}"
+agents_home="${GENESIS_HARNESS_HOME:-$HOME/.agents}"
+target="both"
+
+usage() {
+  echo "Usage: $0 [--target agents|legacy|both]" >&2
+  echo "  agents: install to ${agents_home}/skills" >&2
+  echo "  legacy: install to ${codex_home}/skills" >&2
+  echo "  both: install to both locations" >&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
+
+for skill_name in "${skill_names[@]}"; do
+  if [ ! -f "$source_root/$skill_name/SKILL.md" ]; then
+    echo "Missing skill source: $source_root/$skill_name/SKILL.md" >&2
+    exit 1
+  fi
+done
+
+install_one() {
+  local target_root="$1"
+  mkdir -p "$target_root"
+
+  for skill_name in "${skill_names[@]}"; do
+    local source_dir="$source_root/$skill_name"
+    local target_dir="$target_root/$skill_name"
+
+    if [ -e "$target_dir" ]; then
+      backup_dir="${target_dir}.backup.$(date +%Y%m%d%H%M%S)"
+      mv "$target_dir" "$backup_dir"
+      echo "Existing skill backed up to: $backup_dir"
+    fi
+
+    cp -R "$source_dir" "$target_dir"
+    if [ -d "$target_dir/scripts" ]; then
+      find "$target_dir/scripts" -type f -name '*.sh' -exec chmod +x {} \;
+    fi
+    echo "Installed $skill_name to: $target_dir"
+  done
+}
+
+if [ "$target" = "agents" ] || [ "$target" = "both" ]; then
+  install_one "$agents_home/skills"
+fi
+
+if [ "$target" = "legacy" ] || [ "$target" = "both" ]; then
+  install_one "$codex_home/skills"
+fi
+
+echo "Invoke it in Codex with: Use \$genesis-harness"

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,52 +1,118 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-skill_dir="$repo_root/.codex/skills/project-genesis-harness"
-
-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" '"project-genesis-harness"'
-
-for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md; do
-  assert_file "$skill_dir/references/$ref"
-  assert_contains "$skill_dir/SKILL.md" "references/$ref"
-done
-
-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"'
-assert_contains "$repo_root/README.md" '.agents/skills'
-
-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
-[ -f "$tmp/agents/skills/project-genesis-harness/SKILL.md" ] || fail "agents install target missing"
-[ -f "$tmp/codex/skills/project-genesis-harness/SKILL.md" ] || fail "legacy install target missing"
-bash "$repo_root/scripts/verify.sh" "$tmp/agents/skills/project-genesis-harness" >/dev/null
-bash "$repo_root/scripts/verify.sh" "$tmp/codex/skills/project-genesis-harness" >/dev/null
-CODEX_HOME="$tmp/codex" GENESIS_HARNESS_HOME="$tmp/agents" bash "$repo_root/scripts/uninstall.sh" --target both >/dev/null
-[ ! -e "$tmp/agents/skills/project-genesis-harness" ] || fail "agents uninstall target remains"
-[ ! -e "$tmp/codex/skills/project-genesis-harness" ] || fail "legacy uninstall target remains"
-
-echo "evals passed"
+#!/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"
+skill_names=(
+  genesis-harness
+  genesis-new-design
+  genesis-upgrade-design
+  genesis-architecture
+  genesis-planning
+  genesis-codebase-map
+  genesis-design-spec
+  genesis-api-contract
+  ui-ux-test-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/}"
+}
+
+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"'
+
+for ref in workflows.md planning-schema.md research-rubric.md quality-rubric.md; do
+  assert_file "$harness_dir/references/$ref"
+  assert_contains "$harness_dir/SKILL.md" "references/$ref"
+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"
+  
+  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/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"'
+assert_contains "$repo_root/package.json" '".codebase"'
+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" '.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
+
+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"
+  [ -f "$tmp/codex/skills/$skill_name/SKILL.md" ] || fail "legacy install target missing: $skill_name"
+done
+bash "$repo_root/scripts/verify.sh" "$tmp/agents/skills" >/dev/null
+bash "$repo_root/scripts/verify.sh" "$tmp/codex/skills" >/dev/null
+CODEX_HOME="$tmp/codex" GENESIS_HARNESS_HOME="$tmp/agents" bash "$repo_root/scripts/uninstall.sh" --target both >/dev/null
+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"

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,52 +1,81 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-skill_name="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
-
-remove_one() {
-  local target_dir="$1"
-  if [ ! -e "$target_dir" ]; then
-    echo "Skill is not installed at: $target_dir"
-    return
-  fi
-  rm -rf "$target_dir"
-  echo "Removed: $target_dir"
-}
-
-if [ "$target" = "agents" ] || [ "$target" = "both" ]; then
-  remove_one "$agents_home/skills/$skill_name"
-fi
-
-if [ "$target" = "legacy" ] || [ "$target" = "both" ]; then
-  remove_one "$codex_home/skills/$skill_name"
-fi
+#!/usr/bin/env bash
+set -euo pipefail
+
+skill_names=(
+  genesis-harness
+  genesis-new-design
+  genesis-upgrade-design
+  genesis-architecture
+  genesis-planning
+  genesis-codebase-map
+  genesis-design-spec
+  genesis-api-contract
+  ui-ux-test-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
+
+remove_one() {
+  local target_root="$1"
+  for skill_name in "${skill_names[@]}"; do
+    local target_dir="$target_root/$skill_name"
+    if [ ! -e "$target_dir" ]; then
+      echo "Skill is not installed at: $target_dir"
+      continue
+    fi
+    rm -rf "$target_dir"
+    echo "Removed: $target_dir"
+  done
+}
+
+if [ "$target" = "agents" ] || [ "$target" = "both" ]; then
+  remove_one "$agents_home/skills"
+fi
+
+if [ "$target" = "legacy" ] || [ "$target" = "both" ]; then
+  remove_one "$codex_home/skills"
+fi