codex-genesis-harness 0.1.1 → 0.1.4

package/.codex/skills/genesis-harness/scripts/compact-context.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# ==============================================================================
+# Genesis Codex Harness — Context Compaction Engine
+# ==============================================================================
+# Summarizes active project planning files, active tasks, and logs into a single
+# .planning/CONTEXT_SUMMARY.md file to safely offload context before compacting.
+# Reduces context window usage and prevents Context Rot.
+# ==============================================================================
+
+set -euo pipefail
+
+PLANNING_DIR="${1:-.planning}"
+SUMMARY_FILE="$PLANNING_DIR/CONTEXT_SUMMARY.md"
+
+if [ ! -d "$PLANNING_DIR" ]; then
+  echo "Error: Planning directory '$PLANNING_DIR' does not exist." >&2
+  exit 1
+fi
+
+echo "==> Compacting active context..."
+
+{
+  echo "# Context Compaction Summary"
+  echo "Generated: $(date +'%Y-%m-%d %H:%M:%S')"
+  echo ""
+  echo "## 📊 Active State Summary"
+  if [ -f "$PLANNING_DIR/STATE.md" ]; then
+    grep -E "^- (Current Phase|Active Feature|Last Completed Task|Next Task|Blockers):" "$PLANNING_DIR/STATE.md" || true
+  else
+    echo "State file not found. Project initialized but state unpopulated."
+  fi
+  echo ""
+  echo "## 🎯 Key Architectural Invariants"
+  if [ -f "$PLANNING_DIR/ARCHITECTURE.md" ]; then
+    head -n 25 "$PLANNING_DIR/ARCHITECTURE.md"
+  else
+    echo "Architecture file not found."
+  fi
+  echo ""
+  echo "## 📝 Active Task Progress"
+  # Find all task lists in active features or bugs
+  find "$PLANNING_DIR/features" "$PLANNING_DIR/bugs" -name "TASKS.md" 2>/dev/null | while read -r task_file; do
+    echo "### Tasks for: $(basename "$(dirname "$task_file")")"
+    grep -E "^- \[[x~ ]\]" "$task_file" | tail -n 15 || true
+    echo ""
+  done
+  echo ""
+  echo "## ⚠️ Fragile Areas & Lessons Learned"
+  if [ -f "$PLANNING_DIR/PITFALLS.md" ]; then
+    head -n 15 "$PLANNING_DIR/PITFALLS.md"
+  fi
+} > "$SUMMARY_FILE"
+
+echo "==> Context compaction complete! Summary saved to: file://$(pwd)/$SUMMARY_FILE"

package/.codex/skills/genesis-harness/scripts/create-adr.sh

@@ -1,74 +1,74 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  echo "Usage: $0 <slug> [title] [root]" >&2
-  exit 2
-}
-
-slug="${1:-}"
-title="${2:-$slug}"
-root="${3:-.}"
-[ -n "$slug" ] || usage
-
-case "$slug" in
-  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
-esac
-
-cd "$root"
-mkdir -p .planning/decisions
-
-next="$(
-  find .planning/decisions -maxdepth 1 -type f -name 'ADR-[0-9][0-9][0-9]-*.md' 2>/dev/null \
-    | sed -E 's#.*/ADR-([0-9]{3})-.*#\1#' \
-    | sort -n \
-    | tail -1
-)"
-if [ -z "$next" ]; then
-  number="001"
-else
-  number="$(printf '%03d' "$((10#$next + 1))")"
-fi
-
-file=".planning/decisions/ADR-${number}-${slug}.md"
-if [ -e "$file" ]; then
-  echo "ADR already exists: $file" >&2
-  exit 1
-fi
-
-cat > "$file" <<EOF
-# ADR-${number}: $title
-
-Status: Proposed
-Date: $(date +%Y-%m-%d)
-
-## Context
-
-TBD
-
-## Decision
-
-TBD
-
-## Alternatives Considered
-
-- [ ] TBD
-
-## Consequences
-
-- [ ] TBD
-
-## Risks
-
-- [ ] TBD
-
-## Mitigation
-
-- [ ] TBD
-
-## Verification Evidence
-
-TBD
-EOF
-
-echo "$file"
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $0 <slug> [title] [root]" >&2
+  exit 2
+}
+
+slug="${1:-}"
+title="${2:-$slug}"
+root="${3:-.}"
+[ -n "$slug" ] || usage
+
+case "$slug" in
+  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
+esac
+
+cd "$root"
+mkdir -p .planning/decisions
+
+next="$(
+  find .planning/decisions -maxdepth 1 -type f -name 'ADR-[0-9][0-9][0-9]-*.md' 2>/dev/null \
+    | sed -E 's#.*/ADR-([0-9]{3})-.*#\1#' \
+    | sort -n \
+    | tail -1
+)"
+if [ -z "$next" ]; then
+  number="001"
+else
+  number="$(printf '%03d' "$((10#$next + 1))")"
+fi
+
+file=".planning/decisions/ADR-${number}-${slug}.md"
+if [ -e "$file" ]; then
+  echo "ADR already exists: $file" >&2
+  exit 1
+fi
+
+cat > "$file" <<EOF
+# ADR-${number}: $title
+
+Status: Proposed
+Date: $(date +%Y-%m-%d)
+
+## Context
+
+TBD
+
+## Decision
+
+TBD
+
+## Alternatives Considered
+
+- [ ] TBD
+
+## Consequences
+
+- [ ] TBD
+
+## Risks
+
+- [ ] TBD
+
+## Mitigation
+
+- [ ] TBD
+
+## Verification Evidence
+
+TBD
+EOF
+
+echo "$file"

package/.codex/skills/genesis-harness/scripts/create-bug.sh

@@ -1,160 +1,160 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  echo "Usage: $0 <slug> [summary] [root]" >&2
-  exit 2
-}
-
-slug="${1:-}"
-summary="${2:-TBD}"
-root="${3:-.}"
-[ -n "$slug" ] || usage
-
-case "$slug" in
-  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
-esac
-
-cd "$root"
-mkdir -p .planning/bugs
-
-next="$(
-  find .planning/bugs -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
-    | sed -E 's#.*/([0-9]{3})-.*#\1#' \
-    | sort -n \
-    | tail -1
-)"
-if [ -z "$next" ]; then
-  number="001"
-else
-  number="$(printf '%03d' "$((10#$next + 1))")"
-fi
-
-dir=".planning/bugs/${number}-${slug}"
-if [ -e "$dir" ]; then
-  echo "Bug directory already exists: $dir" >&2
-  exit 1
-fi
-
-mkdir -p "$dir"
-
-cat > "$dir/REPORT.md" <<EOF
-# Bug Report: $summary
-
-## Summary
-
-$summary
-
-## Expected Behavior
-
-- [ ] TBD
-
-## Actual Behavior
-
-- [ ] TBD
-
-## Reproduction Steps
-
-- [ ] TBD
-
-## Environment
-
-TBD
-EOF
-
-cat > "$dir/ROOT_CAUSE.md" <<'EOF'
-# Root Cause
-
-## Evidence
-
-- [ ] TBD
-
-## Root Cause
-
-TBD
-
-## Failed Assumption
-
-TBD
-
-## Correct Pattern
-
-TBD
-EOF
-
-cat > "$dir/PLAN.md" <<'EOF'
-# Plan
-
-## Files To Change
-
-### File: `path/to/file`
-
-Change:
-Why:
-Risk:
-Test:
-Docs impact:
-
-## Fix Steps
-
-- [ ] TBD
-
-## Rollback Plan
-
-- [ ] TBD
-EOF
-
-cat > "$dir/TEST_CONTRACT.md" <<'EOF'
-# Test Contract
-
-- [ ] Reproduction fails before fix
-- [ ] Regression test or verification fails before fix
-- [ ] Regression test or verification passes after fix
-- [ ] Related edge case is covered
-EOF
-
-cat > "$dir/TASKS.md" <<'EOF'
-# Tasks
-
-- [ ] Read PITFALLS.md
-- [ ] Read LESSONS_LEARNED.md
-- [ ] Reproduce bug
-- [ ] Identify root cause
-- [ ] Write regression test or verification
-- [ ] Fix bug
-- [ ] Run verification
-- [ ] Update LESSONS_LEARNED.md
-- [ ] Update docs if behavior changed
-- [ ] Review changed files
-- [ ] Update STATE.md
-- [ ] Update SPEC_CHANGELOG.md if needed
-EOF
-
-cat > "$dir/VERIFICATION.md" <<'EOF'
-# Verification
-
-- [ ] Define reproduction command
-- [ ] Run failing verification before fix
-- [ ] Run passing verification after fix
-
-| Command | Result | Evidence |
-|---|---|---|
-| TBD | TBD | TBD |
-EOF
-
-cat > "$dir/REVIEW.md" <<'EOF'
-# Review
-
-- [ ] Changed files reviewed
-- [ ] Regression coverage checked
-- [ ] Docs impact checked
-- [ ] Debug logs removed
-
-## Findings
-
-| Severity | File | Issue | Follow-Up |
-|---|---|---|---|
-| TBD | TBD | TBD | TBD |
-EOF
-
-echo "$dir"
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $0 <slug> [summary] [root]" >&2
+  exit 2
+}
+
+slug="${1:-}"
+summary="${2:-TBD}"
+root="${3:-.}"
+[ -n "$slug" ] || usage
+
+case "$slug" in
+  *[!a-z0-9-]*|'') echo "Slug must use lowercase letters, numbers, and hyphens." >&2; exit 2 ;;
+esac
+
+cd "$root"
+mkdir -p .planning/bugs
+
+next="$(
+  find .planning/bugs -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
+    | sed -E 's#.*/([0-9]{3})-.*#\1#' \
+    | sort -n \
+    | tail -1
+)"
+if [ -z "$next" ]; then
+  number="001"
+else
+  number="$(printf '%03d' "$((10#$next + 1))")"
+fi
+
+dir=".planning/bugs/${number}-${slug}"
+if [ -e "$dir" ]; then
+  echo "Bug directory already exists: $dir" >&2
+  exit 1
+fi
+
+mkdir -p "$dir"
+
+cat > "$dir/REPORT.md" <<EOF
+# Bug Report: $summary
+
+## Summary
+
+$summary
+
+## Expected Behavior
+
+- [ ] TBD
+
+## Actual Behavior
+
+- [ ] TBD
+
+## Reproduction Steps
+
+- [ ] TBD
+
+## Environment
+
+TBD
+EOF
+
+cat > "$dir/ROOT_CAUSE.md" <<'EOF'
+# Root Cause
+
+## Evidence
+
+- [ ] TBD
+
+## Root Cause
+
+TBD
+
+## Failed Assumption
+
+TBD
+
+## Correct Pattern
+
+TBD
+EOF
+
+cat > "$dir/PLAN.md" <<'EOF'
+# Plan
+
+## Files To Change
+
+### File: `path/to/file`
+
+Change:
+Why:
+Risk:
+Test:
+Docs impact:
+
+## Fix Steps
+
+- [ ] TBD
+
+## Rollback Plan
+
+- [ ] TBD
+EOF
+
+cat > "$dir/TEST_CONTRACT.md" <<'EOF'
+# Test Contract
+
+- [ ] Reproduction fails before fix
+- [ ] Regression test or verification fails before fix
+- [ ] Regression test or verification passes after fix
+- [ ] Related edge case is covered
+EOF
+
+cat > "$dir/TASKS.md" <<'EOF'
+# Tasks
+
+- [ ] Read PITFALLS.md
+- [ ] Read LESSONS_LEARNED.md
+- [ ] Reproduce bug
+- [ ] Identify root cause
+- [ ] Write regression test or verification
+- [ ] Fix bug
+- [ ] Run verification
+- [ ] Update LESSONS_LEARNED.md
+- [ ] Update docs if behavior changed
+- [ ] Review changed files
+- [ ] Update STATE.md
+- [ ] Update SPEC_CHANGELOG.md if needed
+EOF
+
+cat > "$dir/VERIFICATION.md" <<'EOF'
+# Verification
+
+- [ ] Define reproduction command
+- [ ] Run failing verification before fix
+- [ ] Run passing verification after fix
+
+| Command | Result | Evidence |
+|---|---|---|
+| TBD | TBD | TBD |
+EOF
+
+cat > "$dir/REVIEW.md" <<'EOF'
+# Review
+
+- [ ] Changed files reviewed
+- [ ] Regression coverage checked
+- [ ] Docs impact checked
+- [ ] Debug logs removed
+
+## Findings
+
+| Severity | File | Issue | Follow-Up |
+|---|---|---|---|
+| TBD | TBD | TBD | TBD |
+EOF
+
+echo "$dir"