domainforge 0.13.0

package/schemas/sea-registry.schema.json

@@ -0,0 +1,45 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "title": "SEA Registry Schema",
+    "type": "object",
+    "required": [
+        "version",
+        "namespaces"
+    ],
+    "properties": {
+        "version": {
+            "type": "integer",
+            "enum": [
+                1
+            ]
+        },
+        "default_namespace": {
+            "type": "string"
+        },
+        "namespaces": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "required": [
+                    "namespace",
+                    "patterns"
+                ],
+                "properties": {
+                    "namespace": {
+                        "type": "string"
+                    },
+                    "patterns": {
+                        "type": "array",
+                        "minItems": 1,
+                        "items": {
+                            "type": "string"
+                        }
+                    }
+                },
+                "additionalProperties": false
+            }
+        }
+    },
+    "additionalProperties": false
+}

package/scripts/build-python.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -e
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+echo "==> Building Python bindings..."
+
+# Create virtual environment if it doesn't exist
+if [ ! -d ".venv" ]; then
+    echo "Creating virtual environment..."
+    python3 -m venv .venv
+fi
+
+# Activate virtual environment
+source .venv/bin/activate
+
+# Check if maturin is available
+if ! command -v maturin &> /dev/null; then
+    echo "Installing maturin..."
+    pip install maturin
+fi
+
+# Install pytest if not available
+if ! python -c "import pytest" 2>/dev/null; then
+    echo "Installing pytest..."
+    pip install pytest
+fi
+
+# Build Python bindings in development mode.
+# pyproject.toml lives in domainforge-python/ and references domainforge-core/Cargo.toml via a
+# relative path, so maturin must be invoked from domainforge-python/.
+echo "Building with maturin develop (pyproject in domainforge-python/)..."
+cd domainforge-python && maturin develop
+
+echo "✓ Python bindings built successfully"
+echo "✓ Virtual environment activated at $ROOT_DIR/.venv"

package/scripts/build-release.sh

@@ -0,0 +1,279 @@
+#!/usr/bin/env bash
+# build-release.sh - Build release artifacts for current platform
+# Usage: ./scripts/build-release.sh [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
+SKIP_CLI=false
+SKIP_PYTHON=false
+SKIP_WASM=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") [OPTIONS]
+
+Build release artifacts for the current platform.
+
+OPTIONS:
+    --dry-run       Show what would be built without building
+    --skip-cli      Skip CLI binary build
+    --skip-python   Skip Python wheel build
+    --skip-wasm     Skip WASM bundle build
+    -h, --help      Show this help message
+
+ARTIFACTS:
+    - CLI binary (sea or sea.exe)
+    - Python wheel (.whl)
+    - WASM bundle (pkg/)
+    - SHA256 checksums
+
+OUTPUT:
+    All artifacts placed in dist/ directory
+
+EXAMPLES:
+    $(basename "$0")                  # Build all artifacts
+    $(basename "$0") --dry-run        # Preview build commands
+    $(basename "$0") --skip-wasm      # Build CLI and Python only
+EOF
+}
+
+get_current_version() {
+    grep -m1 '^version = ' "$PROJECT_ROOT/domainforge-core/Cargo.toml" | sed 's/version = "\(.*\)"/\1/'
+}
+
+detect_platform() {
+    case "$(uname -s)" in
+        Linux*)     echo "linux" ;;
+        Darwin*)    echo "darwin" ;;
+        CYGWIN*|MINGW*|MSYS*) echo "windows" ;;
+        *)          echo "unknown" ;;
+    esac
+}
+
+detect_arch() {
+    case "$(uname -m)" in
+        x86_64|amd64)   echo "x86_64" ;;
+        aarch64|arm64)  echo "aarch64" ;;
+        *)              echo "unknown" ;;
+    esac
+}
+
+# ============================================================================
+# Parse Arguments
+# ============================================================================
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --skip-cli)
+            SKIP_CLI=true
+            shift
+            ;;
+        --skip-python)
+            SKIP_PYTHON=true
+            shift
+            ;;
+        --skip-wasm)
+            SKIP_WASM=true
+            shift
+            ;;
+        -h|--help)
+            usage
+            exit 0
+            ;;
+        *)
+            log_error "Unknown option: $1"
+            usage
+            exit 1
+            ;;
+    esac
+done
+
+# ============================================================================
+# Main
+# ============================================================================
+cd "$PROJECT_ROOT"
+
+echo ""
+echo "=============================================="
+echo "  DomainForge Release Build"
+echo "=============================================="
+echo ""
+
+if $DRY_RUN; then
+    log_warn "DRY RUN MODE - No builds will be executed"
+    echo ""
+fi
+
+VERSION=$(get_current_version)
+PLATFORM=$(detect_platform)
+ARCH=$(detect_arch)
+
+log_info "Version:  $VERSION"
+log_info "Platform: $PLATFORM"
+log_info "Arch:     $ARCH"
+echo ""
+
+# Clean/create dist directory
+DIST_DIR="$PROJECT_ROOT/dist"
+if $DRY_RUN; then
+    log_info "Would clean/create: $DIST_DIR"
+else
+    rm -rf "$DIST_DIR"
+    mkdir -p "$DIST_DIR"
+    log_success "Created dist directory"
+fi
+
+# Build CLI
+if ! $SKIP_CLI; then
+    log_info "Building CLI binary..."
+    if $DRY_RUN; then
+        log_info "Would run: cargo build -p domainforge-core --release --features cli"
+    else
+        cargo build -p domainforge-core --release --features cli
+        
+        # Find and copy binary
+        if [[ "$PLATFORM" == "windows" ]]; then
+            CLI_BIN="target/release/domainforge.exe"
+            CLI_OUT="$DIST_DIR/sea-$VERSION-$PLATFORM-$ARCH.exe"
+        else
+            CLI_BIN="target/release/domainforge"
+            CLI_OUT="$DIST_DIR/sea-$VERSION-$PLATFORM-$ARCH"
+        fi
+        
+        if [[ -f "$CLI_BIN" ]]; then
+            cp "$CLI_BIN" "$CLI_OUT"
+            chmod +x "$CLI_OUT"
+            log_success "Built CLI: $CLI_OUT"
+            
+            # Create compressed archive
+            ARCHIVE_NAME="sea-$VERSION-$PLATFORM-$ARCH.tar.gz"
+            if [[ "$PLATFORM" == "windows" ]]; then
+                ARCHIVE_NAME="sea-$VERSION-$PLATFORM-$ARCH.zip"
+            fi
+            
+            cd "$DIST_DIR"
+            if [[ "$PLATFORM" == "windows" ]]; then
+                # Use zip on Windows
+                if command -v zip &>/dev/null; then
+                    zip "$ARCHIVE_NAME" "$(basename "$CLI_OUT")"
+                else
+                    log_warn "zip not found, skipping archive"
+                fi
+            else
+                tar czf "$ARCHIVE_NAME" "$(basename "$CLI_OUT")"
+            fi
+            cd "$PROJECT_ROOT"
+            log_success "Created archive: $ARCHIVE_NAME"
+        else
+            log_error "CLI binary not found at $CLI_BIN"
+        fi
+    fi
+else
+    log_info "Skipping CLI build (--skip-cli)"
+fi
+
+# Build Python wheel
+if ! $SKIP_PYTHON; then
+    log_info "Building Python wheel..."
+    if $DRY_RUN; then
+        log_info "Would run: maturin build --release --features python --out dist"
+    else
+        if command -v maturin &>/dev/null; then
+            maturin build --release --features python --out "$DIST_DIR"
+            log_success "Built Python wheel in dist/"
+        else
+            log_warn "maturin not found, skipping Python wheel"
+            log_info "Install with: pip install maturin"
+        fi
+    fi
+else
+    log_info "Skipping Python build (--skip-python)"
+fi
+
+# Build WASM
+if ! $SKIP_WASM; then
+    log_info "Building WASM bundle..."
+    if $DRY_RUN; then
+        log_info "Would run: wasm-pack build --target web --release --features wasm"
+    else
+        if command -v wasm-pack &>/dev/null; then
+            cd domainforge-core
+            wasm-pack build --target web --release --features wasm
+            
+            # Package WASM artifacts
+            WASM_ARCHIVE="$DIST_DIR/domainforge-core-wasm-$VERSION.tar.gz"
+            cd pkg
+            tar czf "$WASM_ARCHIVE" *
+            cd "$PROJECT_ROOT"
+            log_success "Built WASM: $WASM_ARCHIVE"
+        else
+            log_warn "wasm-pack not found, skipping WASM build"
+            log_info "Install with: cargo install wasm-pack"
+        fi
+    fi
+else
+    log_info "Skipping WASM build (--skip-wasm)"
+fi
+
+# Generate checksums
+if ! $DRY_RUN && [[ -d "$DIST_DIR" ]]; then
+    log_info "Generating checksums..."
+    cd "$DIST_DIR"
+    
+    # Generate SHA256 checksums
+    CHECKSUM_FILE="SHA256SUMS.txt"
+    rm -f "$CHECKSUM_FILE"
+    
+    for file in *; do
+        if [[ -f "$file" && "$file" != "$CHECKSUM_FILE" ]]; then
+            if command -v sha256sum &>/dev/null; then
+                sha256sum "$file" >> "$CHECKSUM_FILE"
+            elif command -v shasum &>/dev/null; then
+                shasum -a 256 "$file" >> "$CHECKSUM_FILE"
+            fi
+        fi
+    done
+    
+    cd "$PROJECT_ROOT"
+    
+    if [[ -f "$DIST_DIR/$CHECKSUM_FILE" ]]; then
+        log_success "Generated checksums: $CHECKSUM_FILE"
+    fi
+fi
+
+# Summary
+echo ""
+echo "=============================================="
+log_success "Build complete"
+echo ""
+if ! $DRY_RUN; then
+    log_info "Artifacts in $DIST_DIR:"
+    ls -lh "$DIST_DIR" 2>/dev/null || true
+fi
+echo "=============================================="

package/scripts/build-typescript.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+echo "==> Building TypeScript bindings..."
+
+# package.json with the napi build config lives in domainforge-typescript/.
+# The build script there uses --cargo-cwd ../domainforge-core to locate the Rust crate.
+cd domainforge-typescript && npm run build
+
+echo "✓ TypeScript bindings built successfully"

package/scripts/build-wasm.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+
+set -e
+
+echo "Building SEA Core WASM bindings..."
+
+if ! command -v wasm-pack &> /dev/null; then
+    echo "ERROR: wasm-pack is not installed"
+    echo "Install it with: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh"
+    exit 1
+fi
+
+if ! command -v wasm-opt &> /dev/null; then
+    echo "WARNING: wasm-opt is not installed (optional but recommended for size optimization)"
+    echo "Install it from: https://github.com/WebAssembly/binaryen"
+fi
+
+PKG_DIR="target/wasm-pkg"
+VERSION=$(grep '^version =' domainforge-core/Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
+
+if [ -z "$VERSION" ]; then
+    echo "ERROR: Failed to extract version from domainforge-core/Cargo.toml: VERSION is empty" >&2
+    exit 1
+fi
+
+echo "Building wasm-pack (version=${VERSION})..."
+cd domainforge-core
+wasm-pack build --target web --release --out-dir ../${PKG_DIR} --features wasm
+cd ..
+
+if command -v wasm-opt &> /dev/null; then
+    echo "Optimizing WASM binary with wasm-opt..."
+    wasm-opt -Oz -o ${PKG_DIR}/domainforge_core_bg_opt.wasm ${PKG_DIR}/domainforge_core_bg.wasm
+    mv ${PKG_DIR}/domainforge_core_bg_opt.wasm ${PKG_DIR}/domainforge_core_bg.wasm
+fi
+
+echo "Patching package.json (name=@godspeedai/domainforge-wasm, version=${VERSION})..."
+cd "${PKG_DIR}"
+if command -v python3 &> /dev/null; then
+    python3 -c "
+import json, sys
+with open('package.json', 'r') as f:
+    pkg = json.load(f)
+pkg['name'] = '@godspeedai/domainforge-wasm'
+pkg['version'] = '${VERSION}'
+pkg['description'] = 'WebAssembly bindings for SEA DSL - Semantic Enterprise Architecture'
+pkg['author'] = 'DomainForge Contributors'
+pkg['license'] = 'Apache-2.0'
+pkg['repository'] = {'type': 'git', 'url': 'https://github.com/GodSpeedAI/DomainForge.git'}
+pkg['homepage'] = 'https://github.com/GodSpeedAI/DomainForge'
+pkg['keywords'] = ['wasm', 'domainforge', 'domainforge', 'enterprise-architecture']
+pkg['files'] = ['domainforge_core.js', 'domainforge_core.d.ts', 'domainforge_core_bg.wasm', 'domainforge_core_bg.wasm.d.ts']
+with open('package.json', 'w') as f:
+    json.dump(pkg, f, indent=2)
+    f.write('\n')
+"
+elif command -v node &> /dev/null; then
+    node -e "
+const fs = require('fs');
+const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+pkg.name = '@godspeedai/domainforge-wasm';
+pkg.version = '${VERSION}';
+pkg.description = 'WebAssembly bindings for SEA DSL - Semantic Enterprise Architecture';
+pkg.author = 'DomainForge Contributors';
+pkg.license = 'Apache-2.0';
+pkg.repository = {type: 'git', url: 'https://github.com/GodSpeedAI/DomainForge.git'};
+pkg.homepage = 'https://github.com/GodSpeedAI/DomainForge';
+pkg.keywords = ['wasm', 'domainforge', 'domainforge', 'enterprise-architecture'];
+pkg.files = ['domainforge_core.js', 'domainforge_core.d.ts', 'domainforge_core_bg.wasm', 'domainforge_core_bg.wasm.d.ts'];
+fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+"
+else
+    echo "WARNING: Could not patch package.json (need python3 or node)"
+fi
+cd ..
+
+echo "Creating gzipped version for size check..."
+gzip -k -f ${PKG_DIR}/domainforge_core_bg.wasm
+
+WASM_SIZE=$(stat -c%s ${PKG_DIR}/domainforge_core_bg.wasm 2>/dev/null || stat -f%z ${PKG_DIR}/domainforge_core_bg.wasm 2>/dev/null)
+GZIP_SIZE=$(stat -c%s ${PKG_DIR}/domainforge_core_bg.wasm.gz 2>/dev/null || stat -f%z ${PKG_DIR}/domainforge_core_bg.wasm.gz 2>/dev/null)
+WASM_SIZE_KB=$((WASM_SIZE / 1024))
+GZIP_SIZE_KB=$((GZIP_SIZE / 1024))
+
+echo "Build complete!"
+echo ""
+echo "Bundle sizes:"
+echo "   WASM (uncompressed): ${WASM_SIZE_KB} KB"
+echo "   WASM (gzipped):      ${GZIP_SIZE_KB} KB"
+echo ""
+
+if [ $GZIP_SIZE_KB -lt 500 ]; then
+    echo "Size target met: ${GZIP_SIZE_KB} KB < 500 KB"
+else
+    echo "WARNING: Size target exceeded: ${GZIP_SIZE_KB} KB >= 500 KB"
+fi
+
+echo ""
+echo "Package contents:"
+ls -lh ${PKG_DIR}/
+
+echo ""
+echo "To test the package:"
+echo "   cd ${PKG_DIR}"
+echo "   npm link"
+echo "   cd ../examples"
+echo "   python3 -m http.server 8000"
+echo "   # Open http://localhost:8000/browser.html in your browser"
+
+echo ""
+echo "To publish to npm:"
+echo "   cd ${PKG_DIR}"
+echo "   npm publish --access public"