codeharness 0.6.1

package/ralph/lib/timeout_utils.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# timeout_utils.sh - Cross-platform timeout utility functions for codeharness Ralph loop
+# Vendored from snarktank/ralph
+
+export _TIMEOUT_CMD=""
+
+detect_timeout_command() {
+    if [[ -n "$_TIMEOUT_CMD" ]]; then
+        echo "$_TIMEOUT_CMD"
+        return 0
+    fi
+
+    local os_type
+    os_type=$(uname)
+
+    if [[ "$os_type" == "Darwin" ]]; then
+        if command -v gtimeout &> /dev/null; then
+            _TIMEOUT_CMD="gtimeout"
+        elif command -v timeout &> /dev/null; then
+            _TIMEOUT_CMD="timeout"
+        else
+            _TIMEOUT_CMD=""
+            return 1
+        fi
+    else
+        if command -v timeout &> /dev/null; then
+            _TIMEOUT_CMD="timeout"
+        else
+            _TIMEOUT_CMD=""
+            return 1
+        fi
+    fi
+
+    echo "$_TIMEOUT_CMD"
+    return 0
+}
+
+has_timeout_command() {
+    local cmd
+    cmd=$(detect_timeout_command 2>/dev/null)
+    [[ -n "$cmd" ]]
+}
+
+portable_timeout() {
+    local duration=$1
+    shift
+
+    if [[ -z "$duration" ]]; then
+        echo "Error: portable_timeout requires a duration argument" >&2
+        return 1
+    fi
+
+    if [[ $# -eq 0 ]]; then
+        echo "Error: portable_timeout requires a command to execute" >&2
+        return 1
+    fi
+
+    local timeout_cmd
+    timeout_cmd=$(detect_timeout_command 2>/dev/null)
+
+    if [[ -z "$timeout_cmd" ]]; then
+        echo "Warning: No timeout command available, running without timeout" >&2
+        "$@"
+        return $?
+    fi
+
+    "$timeout_cmd" "$duration" "$@"
+}
+
+reset_timeout_detection() {
+    _TIMEOUT_CMD=""
+}
+
+export -f detect_timeout_command
+export -f has_timeout_command
+export -f portable_timeout
+export -f reset_timeout_detection

package/ralph/onboard.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# onboard.sh — Brownfield Onboarding Scanner (delegates to TypeScript CLI)
+#
+# DEPRECATED: This script is a thin wrapper around `codeharness onboard`.
+# The TypeScript CLI provides comprehensive scanning including:
+# - Per-file coverage analysis (not just file existence)
+# - Verification gap detection (stories without proof documents)
+# - Observability gap detection (OTLP config, Docker stack)
+# - Sprint-status.yaml integration
+# - Beads issue deduplication
+#
+# Usage:
+#   ralph/onboard.sh scan --project-dir DIR [--json]
+#   ralph/onboard.sh coverage --project-dir DIR
+#   ralph/onboard.sh audit --project-dir DIR
+#   ralph/onboard.sh epic --project-dir DIR --output PATH
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+CLI="$PROJECT_ROOT/dist/index.js"
+
+# Ensure CLI is built
+if [[ ! -f "$CLI" ]]; then
+    echo "[WARN] CLI not built — running npm run build" >&2
+    (cd "$PROJECT_ROOT" && npm run build) >&2
+fi
+
+ACTION=""
+PROJECT_DIR=""
+JSON_OUTPUT=false
+OUTPUT_FILE=""
+
+if [[ $# -gt 0 && "$1" != -* ]]; then
+    ACTION="$1"
+    shift
+fi
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help) echo "Usage: onboard.sh {scan|coverage|audit|epic} --project-dir DIR"; exit 0 ;;
+        --project-dir) PROJECT_DIR="$2"; shift 2 ;;
+        --json) JSON_OUTPUT=true; shift ;;
+        --output) OUTPUT_FILE="$2"; shift 2 ;;
+        *) echo "Unknown option: $1" >&2; exit 1 ;;
+    esac
+done
+
+if [[ -z "$PROJECT_DIR" ]]; then
+    echo "Error: --project-dir is required" >&2
+    exit 1
+fi
+
+# Delegate to TypeScript CLI
+cd "$PROJECT_DIR"
+
+case "$ACTION" in
+    scan)
+        if [[ "$JSON_OUTPUT" == "true" ]]; then
+            node "$CLI" onboard scan --json
+        else
+            node "$CLI" onboard scan
+        fi
+        ;;
+    coverage)
+        node "$CLI" onboard coverage
+        ;;
+    audit)
+        node "$CLI" onboard audit
+        ;;
+    epic)
+        node "$CLI" onboard epic --auto-approve
+        ;;
+    "")
+        echo "Error: specify command: scan, coverage, audit, epic" >&2
+        exit 1
+        ;;
+    *)
+        echo "Unknown command: $ACTION" >&2
+        exit 1
+        ;;
+esac