domainforge 0.13.0

package/scripts/clear_debug_test.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+DEST="target/debug/deps/sea_debug_test"
+if [ -L "$DEST" ] || [ -f "$DEST" ]; then
+  rm -f "$DEST"
+  echo "Removed debug test link: $DEST"
+else
+  echo "No debug test link found: $DEST"
+fi
+exit 0

package/scripts/create-github-release.sh

@@ -0,0 +1,262 @@
+#!/usr/bin/env bash
+# create-github-release.sh - Create GitHub release using gh CLI
+# Usage: ./scripts/create-github-release.sh [VERSION] [OPTIONS]
+
+set -euo pipefail
+
+# ============================================================================
+# Configuration
+# ============================================================================
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Flags
+DRY_RUN=false
+DRAFT=false
+
+# ============================================================================
+# Helper Functions
+# ============================================================================
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[✓]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[✗]${NC} $1"; }
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [VERSION] [OPTIONS]
+
+Create a GitHub release using the GitHub CLI.
+
+ARGUMENTS:
+    VERSION         Version number (e.g., 0.7.0)
+                    If not provided, reads from domainforge-core/Cargo.toml
+
+OPTIONS:
+    --dry-run       Show what would be done without creating release
+    --draft         Create as draft release
+    -h, --help      Show this help message
+
+REQUIREMENTS:
+    - GitHub CLI (gh) must be installed and authenticated
+    - Tag must exist: v{VERSION}
+    - RELEASE_NOTES.md should exist for release body
+
+BEHAVIOR:
+    - Creates release from existing tag
+    - Uploads all artifacts from dist/ directory
+    - Marks as pre-release if version contains alpha/beta/rc
+    - Generates additional notes via --generate-notes
+
+EXAMPLES:
+    $(basename "$0")              # Create release for current version
+    $(basename "$0") 0.7.0        # Create for specific version
+    $(basename "$0") --dry-run    # Preview without creating
+    $(basename "$0") --draft      # Create as draft
+EOF
+}
+
+get_current_version() {
+    grep -m1 '^version = ' "$PROJECT_ROOT/domainforge-core/Cargo.toml" | sed 's/version = "\(.*\)"/\1/'
+}
+
+is_prerelease() {
+    local version="$1"
+    [[ "$version" =~ (alpha|beta|rc|pre) ]]
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+VERSION=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --draft)
+            DRAFT=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        -*)
+            log_error "Unknown option: $1"
+            usage
+            exit 1
+            ;;
+        *)
+            if [[ -z "$VERSION" ]]; then
+                VERSION="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+if [[ -z "$VERSION" ]]; then
+    VERSION=$(get_current_version)
+fi
+
+TAG_NAME="v$VERSION"
+TAG_NAME="${TAG_NAME//vv/v}"
+
+# ============================================================================
+# Main
+# ============================================================================
+cd "$PROJECT_ROOT"
+
+echo ""
+echo "=============================================="
+echo "  DomainForge GitHub Release"
+echo "=============================================="
+echo ""
+
+if $DRY_RUN; then
+    log_warn "DRY RUN MODE - No release will be created"
+    echo ""
+fi
+
+# Check prerequisites
+log_info "Checking prerequisites..."
+
+# Check gh CLI
+if ! command -v gh &>/dev/null; then
+    log_error "GitHub CLI (gh) is not installed"
+    log_info "Install with: https://cli.github.com/"
+    exit 1
+fi
+log_success "GitHub CLI found"
+
+# Check authentication
+if ! gh auth status &>/dev/null; then
+    log_error "GitHub CLI is not authenticated"
+    log_info "Authenticate with: gh auth login"
+    exit 1
+fi
+log_success "GitHub CLI authenticated"
+
+# Check tag exists
+if ! git rev-parse "$TAG_NAME" &>/dev/null; then
+    log_error "Tag $TAG_NAME does not exist"
+    log_info "Create with: git tag -a $TAG_NAME -m 'Release $TAG_NAME'"
+    exit 1
+fi
+log_success "Tag $TAG_NAME exists"
+
+log_info "Version: $VERSION"
+log_info "Tag: $TAG_NAME"
+
+# Build gh release command
+GH_CMD="gh release create $TAG_NAME"
+GH_CMD+=" --title \"Release $TAG_NAME\""
+
+# Add release notes if available
+if [[ -f "RELEASE_NOTES.md" ]]; then
+    log_info "Using RELEASE_NOTES.md for release body"
+    GH_CMD+=" --notes-file RELEASE_NOTES.md"
+else
+    log_info "No RELEASE_NOTES.md, using auto-generated notes"
+    GH_CMD+=" --generate-notes"
+fi
+
+# Check for pre-release
+if is_prerelease "$VERSION"; then
+    log_info "Marking as pre-release (version contains alpha/beta/rc)"
+    GH_CMD+=" --prerelease"
+fi
+
+# Draft flag
+if $DRAFT; then
+    log_info "Creating as draft release"
+    GH_CMD+=" --draft"
+fi
+
+# Add artifacts
+DIST_DIR="$PROJECT_ROOT/dist"
+if [[ -d "$DIST_DIR" ]]; then
+    ARTIFACT_COUNT=0
+    for artifact in "$DIST_DIR"/*; do
+        if [[ -f "$artifact" ]]; then
+            GH_CMD+=" \"$artifact\""
+            ARTIFACT_COUNT=$((ARTIFACT_COUNT + 1))
+        fi
+    done
+    
+    if [[ $ARTIFACT_COUNT -gt 0 ]]; then
+        log_info "Will upload $ARTIFACT_COUNT artifacts from dist/"
+    else
+        log_warn "No artifacts found in dist/"
+    fi
+else
+    log_warn "dist/ directory not found, no artifacts to upload"
+fi
+
+# Execute or preview
+echo ""
+log_info "Command:"
+echo "  $GH_CMD"
+echo ""
+
+if $DRY_RUN; then
+    log_info "Would execute the above command"
+else
+    log_info "Creating GitHub release..."
+    
+    # Build and execute the command properly
+    RELEASE_CMD="gh release create $TAG_NAME --title \"Release $TAG_NAME\""
+    
+    if [[ -f "RELEASE_NOTES.md" ]]; then
+        RELEASE_CMD+=" --notes-file RELEASE_NOTES.md"
+    else
+        RELEASE_CMD+=" --generate-notes"
+    fi
+    
+    if is_prerelease "$VERSION"; then
+        RELEASE_CMD+=" --prerelease"
+    fi
+    
+    if $DRAFT; then
+        RELEASE_CMD+=" --draft"
+    fi
+    
+    # Add artifacts to the command
+    if [[ -d "$DIST_DIR" ]]; then
+        for artifact in "$DIST_DIR"/*; do
+            if [[ -f "$artifact" ]]; then
+                RELEASE_CMD+=" \"$artifact\""
+            fi
+        done
+    fi
+    
+    # Execute using eval
+    if eval "$RELEASE_CMD"; then
+        log_success "GitHub release created successfully"
+        
+        # Show release URL
+        RELEASE_URL=$(gh release view "$TAG_NAME" --json url -q '.url' 2>/dev/null || true)
+        if [[ -n "$RELEASE_URL" ]]; then
+            echo ""
+            log_info "Release URL: $RELEASE_URL"
+        fi
+    else
+        log_error "Failed to create GitHub release"
+        exit 1
+    fi
+fi
+
+echo ""
+echo "=============================================="
+log_success "GitHub release process complete"
+echo "=============================================="

package/scripts/create-tag.sh

@@ -0,0 +1,203 @@
+#!/usr/bin/env bash
+# create-tag.sh - Create annotated git tag for release
+# Usage: ./scripts/create-tag.sh [VERSION] [OPTIONS]
+
+set -euo pipefail
+
+# ============================================================================
+# Configuration
+# ============================================================================
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Flags
+DRY_RUN=false
+FORCE=false
+
+# ============================================================================
+# Helper Functions
+# ============================================================================
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[✓]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[✗]${NC} $1"; }
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [VERSION] [OPTIONS]
+
+Create an annotated git tag for a release.
+
+ARGUMENTS:
+    VERSION         Version number (e.g., 0.7.0 or v0.7.0)
+                    If not provided, reads from domainforge-core/Cargo.toml
+
+OPTIONS:
+    --dry-run       Show what would be done without creating tag
+    --force         Overwrite existing tag
+    -h, --help      Show this help message
+
+BEHAVIOR:
+    - Creates annotated tag with format: v{VERSION}
+    - Uses RELEASE_NOTES.md as tag message (if exists)
+    - Uses GPG signing if configured
+    - Does NOT push the tag
+
+EXAMPLES:
+    $(basename "$0")              # Tag with current version
+    $(basename "$0") 0.7.0        # Tag specific version
+    $(basename "$0") --dry-run    # Preview without creating
+    $(basename "$0") --force      # Overwrite existing tag
+EOF
+}
+
+get_current_version() {
+    grep -m1 '^version = ' "$PROJECT_ROOT/domainforge-core/Cargo.toml" | sed 's/version = "\(.*\)"/\1/'
+}
+
+has_gpg_signing() {
+    git config --get user.signingkey &>/dev/null
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+VERSION=""
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --force)
+            FORCE=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        -*)
+            log_error "Unknown option: $1"
+            usage
+            exit 1
+            ;;
+        *)
+            if [[ -z "$VERSION" ]]; then
+                VERSION="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+if [[ -z "$VERSION" ]]; then
+    VERSION=$(get_current_version)
+fi
+
+# Ensure version has v prefix for tag
+TAG_NAME="v$VERSION"
+TAG_NAME="${TAG_NAME//vv/v}"  # Remove double v if already prefixed
+
+# ============================================================================
+# Main
+# ============================================================================
+cd "$PROJECT_ROOT"
+
+echo ""
+echo "=============================================="
+echo "  DomainForge Git Tagging"
+echo "=============================================="
+echo ""
+
+if $DRY_RUN; then
+    log_warn "DRY RUN MODE - No tag will be created"
+    echo ""
+fi
+
+log_info "Tag name: $TAG_NAME"
+
+# Check if tag already exists
+if git rev-parse "$TAG_NAME" &>/dev/null; then
+    if $FORCE; then
+        log_warn "Tag $TAG_NAME exists, will be overwritten (--force)"
+        if ! $DRY_RUN; then
+            git tag -d "$TAG_NAME" 2>/dev/null || true
+        fi
+    else
+        log_error "Tag $TAG_NAME already exists. Use --force to overwrite."
+        exit 1
+    fi
+fi
+
+# Determine tag message source
+if [[ -f "RELEASE_NOTES.md" ]]; then
+    log_info "Using RELEASE_NOTES.md for tag message"
+    TAG_MSG_FILE="RELEASE_NOTES.md"
+else
+    log_info "RELEASE_NOTES.md not found, using default message"
+    TAG_MSG_FILE=""
+fi
+
+# Check for GPG signing
+USE_GPG=false
+if has_gpg_signing; then
+    log_info "GPG signing key configured"
+    USE_GPG=true
+else
+    log_info "No GPG signing key configured (unsigned tag)"
+fi
+
+# Create the tag
+if $DRY_RUN; then
+    log_info "Would create tag: $TAG_NAME"
+    if $USE_GPG; then
+        log_info "Would use: git tag -s $TAG_NAME"
+    else
+        log_info "Would use: git tag -a $TAG_NAME"
+    fi
+    if [[ -n "$TAG_MSG_FILE" ]]; then
+        log_info "Would use message from: $TAG_MSG_FILE"
+    fi
+else
+    if $USE_GPG; then
+        if [[ -n "$TAG_MSG_FILE" ]]; then
+            git tag -s "$TAG_NAME" -F "$TAG_MSG_FILE"
+        else
+            git tag -s "$TAG_NAME" -m "Release $TAG_NAME"
+        fi
+    else
+        if [[ -n "$TAG_MSG_FILE" ]]; then
+            git tag -a "$TAG_NAME" -F "$TAG_MSG_FILE"
+        else
+            git tag -a "$TAG_NAME" -m "Release $TAG_NAME"
+        fi
+    fi
+    
+    log_success "Created tag: $TAG_NAME"
+    
+    # Verify tag
+    if git rev-parse "$TAG_NAME" &>/dev/null; then
+        log_success "Tag verified successfully"
+        git show "$TAG_NAME" --quiet --format="Commit: %H%nDate: %ci%nTagger: %an <%ae>"
+    else
+        log_error "Tag verification failed"
+        exit 1
+    fi
+fi
+
+echo ""
+echo "=============================================="
+log_success "Tagging complete"
+echo ""
+log_info "To push the tag:"
+echo "    git push origin $TAG_NAME"
+echo "=============================================="

package/scripts/find_and_link_test_binary.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -o errexit
+set -o nounset
+set -o pipefail
+# Build the requested test binary, locate the hashed executable, and ensure
+# a stable path (`target/debug/deps/sea_debug_test`) exists for codelldb.
+
+if [ "$#" -lt 1 ]; then
+  echo "Usage: $0 <test-file-stem-or-binary-name>"
+  echo "Example: $0 aggregation_eval_tests"
+  exit 2
+fi
+
+PYTHON_BIN="${PYTHON_BIN:-python3}"
+if ! command -v "${PYTHON_BIN}" >/dev/null 2>&1; then
+  if command -v python >/dev/null 2>&1; then
+    PYTHON_BIN="python"
+  else
+    echo "python3 (or python) is required to locate the test binary" >&2
+    exit 1
+  fi
+fi
+
+TEST_NAME="$1"
+CRATE_PATH="domainforge-core"
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+SCRIPTS_DIR="${ROOT_DIR}/scripts"
+STABLE_DEST_DIR="${ROOT_DIR}/target/debug/deps"
+DEST="${STABLE_DEST_DIR}/sea_debug_test"
+
+echo "Building test binaries for crate: ${CRATE_PATH}"
+pushd "${ROOT_DIR}" >/dev/null
+cargo test -p "${CRATE_PATH}" --no-run
+
+echo "Locating compiled binary for: ${TEST_NAME}"
+FOUND_BIN="$(
+  "${PYTHON_BIN}" "${SCRIPTS_DIR}/resolve_rust_binary.py" \
+    --workspace "${ROOT_DIR}" \
+    --name "${TEST_NAME}" \
+    --profile debug \
+    --match-mode prefix \
+    --fallback-mode contains \
+    --deps-subdir deps \
+    --require-executable
+)"
+popd >/dev/null
+
+if [ -z "${FOUND_BIN}" ]; then
+  echo "Error: resolver did not return a binary path" >&2
+  exit 1
+fi
+
+echo "Found binary: ${FOUND_BIN}"
+mkdir -p "${STABLE_DEST_DIR}"
+if [ -e "${DEST}" ] || [ -L "${DEST}" ]; then
+  rm -f "${DEST}"
+fi
+
+echo "Linking ${FOUND_BIN} -> ${DEST}"
+if ln -s "${FOUND_BIN}" "${DEST}" 2>/dev/null; then
+  echo "Created symlink: ${DEST} -> ${FOUND_BIN}"
+else
+  cp "${FOUND_BIN}" "${DEST}"
+  chmod +x "${DEST}"
+  echo "Copied binary to: ${DEST}"
+fi
+
+echo "Prepared debug binary: ${DEST}"
+printf '%s\n' "${DEST}"
+exit 0