domainforge 0.13.0

package/scripts/release.sh

@@ -0,0 +1,373 @@
+#!/usr/bin/env bash
+# release.sh - Master release orchestration script for DomainForge
+# Usage: ./scripts/release.sh [major|minor|patch|X.Y.Z] [OPTIONS]
+#
+# Orchestrates the complete release process:
+# 1. Pre-release checks
+# 2. Version bump
+# 3. Changelog generation
+# 4. Release notes generation
+# 5. Git tag creation
+# 6. Build artifacts
+# 7. Push and create GitHub release
+
+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'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Flags
+DRY_RUN=false
+SKIP_TESTS=false
+SKIP_BUILD=false
+AUTO_CONFIRM=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"; }
+log_step() { echo -e "${CYAN}[STEP]${NC} $1"; }
+
+banner() {
+    echo ""
+    echo -e "${CYAN}=============================================="
+    echo "  🚀 DomainForge Release Process"
+    echo "==============================================${NC}"
+    echo ""
+}
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [VERSION_TYPE] [OPTIONS]
+
+Complete release orchestration for DomainForge.
+
+VERSION_TYPE:
+    major           Bump major version (X.0.0)
+    minor           Bump minor version (x.Y.0)
+    patch           Bump patch version (x.y.Z) [default]
+    X.Y.Z           Set explicit version (e.g., 1.2.3)
+
+OPTIONS:
+    --dry-run       Run through all steps without making changes
+    --skip-tests    Skip running test suites (faster, less safe)
+    --skip-build    Skip building release artifacts
+    --yes, -y       Auto-confirm push and release creation
+    -h, --help      Show this help message
+
+RELEASE PROCESS:
+    Run this from main after merging the release changes.
+    1. Run pre-release checks (git status, tests, version sync)
+    2. Bump version in all package files
+    3. Generate changelog from commits
+    4. Generate release notes for GitHub
+    5. Commit version changes
+    6. Create annotated git tag
+    7. Build release artifacts (CLI, Python, WASM)
+    8. Push to remote (with confirmation)
+    9. Create GitHub release with artifacts
+
+EXAMPLES:
+    $(basename "$0")                  # Patch release (0.6.2 -> 0.6.3)
+    $(basename "$0") minor            # Minor release (0.6.2 -> 0.7.0)
+    $(basename "$0") major            # Major release (0.6.2 -> 1.0.0)
+    $(basename "$0") --dry-run        # Preview full release process
+    $(basename "$0") patch --yes      # Patch release with auto-confirm
+
+REQUIREMENTS:
+    - git
+    - cargo (Rust toolchain)
+    - just (optional, for tests)
+    - maturin (for Python wheels)
+    - wasm-pack (for WASM bundle)
+    - gh (GitHub CLI, for release creation)
+
+ROLLBACK:
+    If the release fails after version bump:
+        git reset --hard HEAD~1
+        git tag -d v{VERSION}
+EOF
+}
+
+confirm() {
+    local prompt="$1"
+    local default="${2:-n}"
+
+    if $AUTO_CONFIRM; then
+        return 0
+    fi
+
+    if $DRY_RUN; then
+        log_info "Would prompt: $prompt"
+        return 0
+    fi
+
+    local answer
+    read -r -p "$prompt [y/N] " answer
+    [[ "$answer" =~ ^[Yy]$ ]]
+}
+
+run_script() {
+    local script="$1"
+    shift
+    local args=("$@")
+
+    if $DRY_RUN; then
+        args+=("--dry-run")
+    fi
+
+    if [[ -x "$SCRIPT_DIR/$script" ]]; then
+        "$SCRIPT_DIR/$script" "${args[@]}"
+    else
+        log_error "Script not found or not executable: $script"
+        exit 1
+    fi
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+VERSION_TYPE="patch"
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --skip-tests)
+            SKIP_TESTS=true
+            shift
+            ;;
+        --skip-build)
+            SKIP_BUILD=true
+            shift
+            ;;
+        --yes|-y)
+            AUTO_CONFIRM=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        -*)
+            log_error "Unknown option: $1"
+            usage
+            exit 1
+            ;;
+        *)
+            VERSION_TYPE="$1"
+            shift
+            ;;
+    esac
+done
+
+# ============================================================================
+# Main
+# ============================================================================
+cd "$PROJECT_ROOT"
+
+banner
+
+CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
+
+if [[ "$CURRENT_BRANCH" != "main" ]]; then
+    log_error "Release execution must start from main. Current branch: $CURRENT_BRANCH"
+    log_info "Merge or fast-forward the intended release commit onto main, then rerun this script from main."
+    exit 1
+fi
+
+if $DRY_RUN; then
+    log_warn "DRY RUN MODE - No changes will be made"
+    echo ""
+fi
+
+log_info "Release type: $VERSION_TYPE"
+echo ""
+
+# ============================================================================
+# Step 1: Pre-release checks
+# ============================================================================
+log_step "Step 1/9: Running pre-release checks..."
+echo ""
+
+PRE_CHECK_ARGS=()
+if $SKIP_TESTS; then
+    PRE_CHECK_ARGS+=("--skip-tests")
+fi
+if $DRY_RUN; then
+    PRE_CHECK_ARGS+=("--dry-run")
+fi
+
+if ! "$SCRIPT_DIR/pre-release-check.sh" "${PRE_CHECK_ARGS[@]}"; then
+    log_error "Pre-release checks failed. Fix issues before releasing."
+    exit 1
+fi
+echo ""
+
+# ============================================================================
+# Step 2: Bump version
+# ============================================================================
+log_step "Step 2/9: Bumping version..."
+echo ""
+
+BUMP_ARGS=("$VERSION_TYPE" "--no-commit")
+if $DRY_RUN; then
+    BUMP_ARGS+=("--dry-run")
+fi
+
+# Capture new version from bump script
+NEW_VERSION=$("$SCRIPT_DIR/bump-version.sh" "${BUMP_ARGS[@]}" | tail -1)
+log_success "New version: $NEW_VERSION"
+echo ""
+
+# ============================================================================
+# Step 3: Generate changelog
+# ============================================================================
+log_step "Step 3/9: Generating changelog..."
+echo ""
+
+CHANGELOG_ARGS=("$NEW_VERSION" "--no-commit")
+if $DRY_RUN; then
+    CHANGELOG_ARGS+=("--dry-run")
+fi
+
+"$SCRIPT_DIR/generate-changelog.sh" "${CHANGELOG_ARGS[@]}"
+echo ""
+
+# ============================================================================
+# Step 4: Generate release notes
+# ============================================================================
+log_step "Step 4/9: Generating release notes..."
+echo ""
+
+NOTES_ARGS=("$NEW_VERSION")
+if $DRY_RUN; then
+    NOTES_ARGS+=("--dry-run")
+fi
+
+"$SCRIPT_DIR/generate-release-notes.sh" "${NOTES_ARGS[@]}"
+echo ""
+
+# ============================================================================
+# Step 5: Commit version changes
+# ============================================================================
+log_step "Step 5/9: Committing changes..."
+echo ""
+
+if $DRY_RUN; then
+    log_info "Would commit: chore: release v$NEW_VERSION"
+else
+    git add -A
+    git commit -m "chore: release v$NEW_VERSION" || log_warn "Nothing to commit or commit failed"
+    log_success "Created commit: chore: release v$NEW_VERSION"
+fi
+echo ""
+
+# ============================================================================
+# Step 6: Create git tag
+# ============================================================================
+log_step "Step 6/9: Creating git tag..."
+echo ""
+
+TAG_ARGS=("$NEW_VERSION")
+if $DRY_RUN; then
+    TAG_ARGS+=("--dry-run")
+fi
+
+"$SCRIPT_DIR/create-tag.sh" "${TAG_ARGS[@]}"
+echo ""
+
+# ============================================================================
+# Step 7: Build artifacts
+# ============================================================================
+if ! $SKIP_BUILD; then
+    log_step "Step 7/9: Building release artifacts..."
+    echo ""
+
+    BUILD_ARGS=()
+    if $DRY_RUN; then
+        BUILD_ARGS+=("--dry-run")
+    fi
+
+    "$SCRIPT_DIR/build-release.sh" "${BUILD_ARGS[@]}"
+    echo ""
+else
+    log_step "Step 7/9: Skipping build (--skip-build)"
+    echo ""
+fi
+
+# ============================================================================
+# Step 8: Push to remote
+# ============================================================================
+log_step "Step 8/9: Preparing to push..."
+echo ""
+
+BRANCH="$CURRENT_BRANCH"
+TAG_NAME="v$NEW_VERSION"
+
+log_warn "Ready to push the following:"
+echo "  - Branch: $BRANCH"
+echo "  - Tag: $TAG_NAME"
+echo ""
+
+if $DRY_RUN; then
+    log_info "Would push: git push origin $BRANCH"
+    log_info "Would push: git push origin $TAG_NAME"
+else
+    if confirm "Push to remote and create GitHub release?"; then
+        log_info "Pushing branch..."
+        git push origin "$BRANCH"
+        log_success "Pushed branch: $BRANCH"
+
+        log_info "Pushing tag..."
+        git push origin "$TAG_NAME"
+        log_success "Pushed tag: $TAG_NAME"
+        echo ""
+
+        # ============================================================================
+        # Step 9: Create GitHub release
+        # ============================================================================
+        log_step "Step 9/9: Creating GitHub release..."
+        echo ""
+
+        GH_ARGS=("$NEW_VERSION")
+        "$SCRIPT_DIR/create-github-release.sh" "${GH_ARGS[@]}"
+
+        echo ""
+        echo -e "${GREEN}=============================================="
+        echo "  ✨ Release v$NEW_VERSION completed!"
+        echo "==============================================${NC}"
+        echo ""
+        log_success "All release steps completed successfully"
+        echo ""
+        log_info "Next steps:"
+        echo "  1. Verify GitHub release: https://github.com/GodSpeedAI/DomainForge/releases"
+        echo "  2. Wait for CI to publish to npm, PyPI, and crates.io"
+        echo "  3. Announce the release"
+    else
+        echo ""
+        log_warn "Release cancelled. To undo local changes:"
+        echo "    git reset --hard HEAD~1"
+        echo "    git tag -d $TAG_NAME"
+        exit 1
+    fi
+fi
+
+echo ""
+log_success "Release process complete"

package/scripts/resolve_rust_binary.py

@@ -0,0 +1,230 @@
+#!/usr/bin/env python3
+"""
+Locate a compiled Rust binary under the workspace `target/` directories.
+
+Supports both workspace-level targets (e.g., `target/x86_64-unknown-linux-gnu/release/sea`)
+and crate-local targets (e.g., `domainforge-core/target/release/domainforge`). The script can match
+by exact name, prefix, or substring and falls back to alternate match modes when
+requested. Designed for both CI (finding the built CLI) and editor automation
+(finding hashed test binaries for codelldb).
+"""
+
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+from dataclasses import dataclass
+from typing import Iterable, List, Optional, Sequence, Tuple
+
+MATCH_CHOICES = ("exact", "prefix", "contains")
+DEFAULT_SEARCH_ROOTS = ["target", os.path.join("domainforge-core", "target")]
+
+
+@dataclass(frozen=True)
+class SearchOptions:
+    names: Sequence[str]
+    match_mode: str
+    require_executable: bool
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Find a compiled Rust binary path.")
+    parser.add_argument(
+        "--name", required=True, help="Base name of the binary (stem without hash)."
+    )
+    parser.add_argument(
+        "--profile",
+        choices=["debug", "release"],
+        default="debug",
+        help="Cargo profile directory to search (default: debug).",
+    )
+    parser.add_argument(
+        "--target-triple",
+        help="Optional target triple (searches target/<triple>/<profile>).",
+    )
+    parser.add_argument(
+        "--deps-subdir",
+        help="Optional additional subdirectory (e.g., 'deps' for test binaries).",
+    )
+    parser.add_argument(
+        "--match-mode",
+        choices=MATCH_CHOICES,
+        default="exact",
+        help="Primary match mode for filenames (default: exact).",
+    )
+    parser.add_argument(
+        "--fallback-mode",
+        choices=MATCH_CHOICES,
+        help="Optional secondary match mode if the primary fails.",
+    )
+    parser.add_argument(
+        "--extension",
+        action="append",
+        dest="extensions",
+        help=(
+            "Explicit filename extensions to consider. Provide multiple times for "
+            "multiple extensions. Defaults to ['', '.exe']."
+        ),
+    )
+    parser.add_argument(
+        "--search-root",
+        action="append",
+        dest="search_roots",
+        help=(
+            "Override search roots (relative to workspace). Provide multiple times "
+            "to search several directories. Defaults to workspace 'target/' and "
+            "'domainforge-core/target/'."
+        ),
+    )
+    parser.add_argument(
+        "--workspace",
+        default=".",
+        help="Workspace root (defaults to current working directory).",
+    )
+    parser.add_argument(
+        "--require-executable",
+        action="store_true",
+        help="Only consider paths that are executable.",
+    )
+    return parser.parse_args()
+
+
+def canonical_workspace(path: str) -> str:
+    return os.path.abspath(os.path.expanduser(path))
+
+
+def candidate_directories(
+    workspace: str, roots: Sequence[str], target: Optional[str], profile: str, deps: Optional[str]
+) -> List[str]:
+    seen = set()
+    directories: List[str] = []
+
+    for root in roots:
+        base = os.path.join(workspace, root)
+        targets: Tuple[str, ...]
+        if target:
+            targets = (
+                os.path.join(base, target, profile),
+                os.path.join(base, profile),
+            )
+        else:
+            targets = (os.path.join(base, profile),)
+
+        for target_dir in targets:
+            if deps:
+                target_dir = os.path.join(target_dir, deps)
+            normalized = os.path.normpath(target_dir)
+            if normalized not in seen:
+                seen.add(normalized)
+                directories.append(normalized)
+    return directories
+
+
+def build_candidate_names(name: str, extensions: Sequence[str]) -> List[str]:
+    if extensions:
+        return [f"{name}{ext}" for ext in extensions]
+    return [name, f"{name}.exe"]
+
+
+def iter_sorted_files(directory: str) -> Iterable[str]:
+    try:
+        entries = os.listdir(directory)
+    except FileNotFoundError:
+        return []
+    except NotADirectoryError:
+        return []
+    entries.sort(
+        key=lambda entry: os.path.getmtime(os.path.join(directory, entry)),
+        reverse=True,
+    )
+    return entries
+
+
+def match_entry(entry: str, names: Sequence[str], mode: str) -> bool:
+    entry_cmp = entry.lower()
+    if mode == "exact":
+        lowered = [n.lower() for n in names]
+        return entry_cmp in lowered
+    if mode == "prefix":
+        lowered = [n.lower() for n in names]
+        return any(entry_cmp.startswith(n) for n in lowered)
+    if mode == "contains":
+        lowered = [n.lower() for n in names]
+        return any(n in entry_cmp for n in lowered)
+    raise ValueError(f"Unsupported match mode: {mode}")
+
+
+def find_binary(
+    directories: Sequence[str],
+    options: SearchOptions,
+) -> Optional[str]:
+    for directory in directories:
+        for entry in iter_sorted_files(directory):
+            path = os.path.join(directory, entry)
+            if not os.path.isfile(path):
+                continue
+            if options.require_executable and not os.access(path, os.X_OK):
+                continue
+            if match_entry(entry, options.names, options.match_mode):
+                return os.path.abspath(path)
+    return None
+
+
+def fail_with_diagnostics(
+    name: str, directories: Sequence[str], match_mode: str, fallback_mode: Optional[str]
+) -> None:
+    rel_dirs = [os.path.relpath(d) for d in directories]
+    print(
+        "Unable to locate compiled binary.\n"
+        f"  name: {name}\n"
+        f"  match_mode: {match_mode}\n"
+        f"  fallback_mode: {fallback_mode or 'none'}\n"
+        f"  searched directories:\n    - " + "\n    - ".join(rel_dirs),
+        file=sys.stderr,
+    )
+    sys.exit(1)
+
+
+def main() -> None:
+    args = parse_args()
+    workspace = canonical_workspace(args.workspace)
+    roots = args.search_roots or DEFAULT_SEARCH_ROOTS
+    extensions = args.extensions or ["", ".exe"]
+
+    directories = candidate_directories(
+        workspace=workspace,
+        roots=roots,
+        target=args.target_triple,
+        profile=args.profile,
+        deps=args.deps_subdir,
+    )
+
+    options = SearchOptions(
+        names=build_candidate_names(args.name, extensions),
+        match_mode=args.match_mode,
+        require_executable=args.require_executable,
+    )
+
+    result = find_binary(directories, options)
+    if not result and args.fallback_mode:
+        fallback_options = SearchOptions(
+            names=options.names,
+            match_mode=args.fallback_mode,
+            require_executable=options.require_executable,
+        )
+        result = find_binary(directories, fallback_options)
+
+    if not result:
+        fail_with_diagnostics(
+            name=args.name,
+            directories=directories,
+            match_mode=args.match_mode,
+            fallback_mode=args.fallback_mode,
+        )
+
+    print(result)
+
+
+if __name__ == "__main__":
+    main()

package/scripts/run_commitlint.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env sh
+set -eu
+
+if [ "$#" -ne 1 ]; then
+  echo "Usage: $0 <commit_message_file>" >&2
+  exit 2
+fi
+
+msg_file="$1"
+
+if [ -x "./node_modules/.bin/commitlint" ]; then
+  exec ./node_modules/.bin/commitlint --edit "$msg_file"
+fi
+
+if command -v bunx >/dev/null 2>&1; then
+  exec bunx --yes commitlint --edit "$msg_file"
+fi
+
+if command -v npx >/dev/null 2>&1; then
+  exec npx --yes commitlint --edit "$msg_file"
+fi
+
+if command -v npm >/dev/null 2>&1; then
+  exec npm exec --yes commitlint -- --edit "$msg_file"
+fi
+
+echo "commitlint is required but no compatible runner was found (node_modules/.bin, bunx, npx, npm)." >&2
+echo "Run 'just setup' or install Node.js/Bun, then retry." >&2
+exit 1

package/scripts/test-all.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -e
+
+echo "========================================"
+echo "  DomainForge SEA DSL - Test Suite"
+echo "========================================"
+echo ""
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+FAILED=0
+
+# Rust tests
+echo "==> Running Rust tests..."
+if cargo test --manifest-path domainforge-core/Cargo.toml; then
+    echo -e "${GREEN}✓ Rust tests passed${NC}"
+else
+    echo -e "${RED}✗ Rust tests failed${NC}"
+    FAILED=1
+fi
+echo ""
+
+# Python tests
+echo "==> Running Python tests..."
+if [ -f "tests/test_primitives.py" ]; then
+    # Build Python bindings if not already built
+    if [ ! -d ".venv" ] || ! .venv/bin/python -c "import domainforge" 2>/dev/null; then
+        echo "Building Python bindings..."
+        bash scripts/build-python.sh
+    fi
+
+    # Activate virtual environment and run tests
+    source .venv/bin/activate
+    if pytest tests/ -v; then
+        echo -e "${GREEN}✓ Python tests passed${NC}"
+    else
+        echo -e "${RED}✗ Python tests failed${NC}"
+        FAILED=1
+    fi
+    deactivate
+else
+    echo -e "${YELLOW}⚠ No Python tests found${NC}"
+fi
+echo ""
+
+# TypeScript tests
+echo "==> Running TypeScript tests..."
+if [ -f "vitest.config.ts" ]; then
+    # Build TypeScript bindings if not already built
+    if [ ! -f "domainforge-core.linux-x64-gnu.node" ] && [ ! -f "index.node" ]; then
+        echo "Building TypeScript bindings..."
+        bash scripts/build-typescript.sh
+    fi
+
+    if npm test; then
+        echo -e "${GREEN}✓ TypeScript tests passed${NC}"
+    else
+        echo -e "${RED}✗ TypeScript tests failed${NC}"
+        FAILED=1
+    fi
+else
+    echo -e "${YELLOW}⚠ No TypeScript tests found${NC}"
+fi
+echo ""
+
+echo "========================================"
+if [ $FAILED -eq 0 ]; then
+    echo -e "${GREEN}✓ All tests passed!${NC}"
+    exit 0
+else
+    echo -e "${RED}✗ Some tests failed${NC}"
+    exit 1
+fi