@opensassi/opencode 0.1.0

package/scripts/check-artifacts.js

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import path from 'path';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+
+function getReviewPath(specPath) {
+  const rel = path.relative(ROOT, specPath);
+  const dir = path.dirname(rel);
+  const basename = path.basename(rel);
+
+  if (rel === 'technical-specification.md') {
+    return path.join(ROOT, '.artifacts', 'review.md');
+  }
+
+  return path.join(ROOT, dir, '.artifacts', basename, 'review.md');
+}
+
+function getReviewStatus(specPath) {
+  const reviewPath = getReviewPath(specPath);
+
+  if (!fs.existsSync(reviewPath)) return { reviewFile: null, reviewMtime: null, reviewStatus: "MISSING" };
+
+  const reviewMtime = fs.statSync(reviewPath).mtimeMs;
+  const specMtime = fs.statSync(specPath).mtimeMs;
+  const status = reviewMtime < specMtime ? "STALE" : "OK";
+
+  return {
+    reviewFile: path.relative(ROOT, reviewPath),
+    reviewMtime: Math.floor(reviewMtime),
+    reviewStatus: status,
+  };
+}
+
+function getAllSpecFiles() {
+  const files = [];
+
+  const rootSpec = path.join(ROOT, 'technical-specification.md');
+  if (fs.existsSync(rootSpec)) files.push(rootSpec);
+
+  const srcDir = path.join(ROOT, 'src');
+  if (!fs.existsSync(srcDir)) return files;
+
+  for (const entry of fs.readdirSync(srcDir)) {
+    const moduleDir = path.join(srcDir, entry);
+    if (!fs.statSync(moduleDir).isDirectory()) continue;
+
+    for (const file of fs.readdirSync(moduleDir)) {
+      if (file.endsWith('.spec.md')) {
+        files.push(path.join(moduleDir, file));
+      }
+    }
+  }
+
+  return files;
+}
+
+function getModuleSpecFiles(name) {
+  const moduleDir = path.join(ROOT, 'src', name);
+  if (!fs.existsSync(moduleDir) || !fs.statSync(moduleDir).isDirectory()) {
+    console.error(`ERROR: No such module: "${name}" (not found at src/${name}/)`);
+    process.exit(1);
+  }
+
+  const files = [];
+  for (const file of fs.readdirSync(moduleDir)) {
+    if (file.endsWith('.spec.md')) {
+      files.push(path.join(moduleDir, file));
+    }
+  }
+
+  return files;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const issuesOnly = args.includes('--errors');
+  const subModuleIdx = args.indexOf('--sub-module');
+  const fileIdx = args.indexOf('--file');
+
+  let specFiles;
+
+  if (subModuleIdx !== -1) {
+    const moduleName = args[subModuleIdx + 1];
+    if (!moduleName) {
+      console.error('Usage: node scripts/check-artifacts.js --sub-module <name>');
+      process.exit(1);
+    }
+    specFiles = getModuleSpecFiles(moduleName);
+  } else if (fileIdx !== -1) {
+    const filePath = args[fileIdx + 1];
+    if (!filePath) {
+      console.error('Usage: node scripts/check-artifacts.js --file <path>');
+      process.exit(1);
+    }
+    const resolvedPath = path.resolve(process.cwd(), filePath);
+    if (!fs.existsSync(resolvedPath)) {
+      console.error(`ERROR: File not found: ${filePath}`);
+      process.exit(1);
+    }
+    if (!resolvedPath.endsWith('.spec.md')) {
+      console.error(`ERROR: Not a .spec.md file: ${filePath}`);
+      process.exit(1);
+    }
+    specFiles = [resolvedPath];
+  } else {
+    specFiles = getAllSpecFiles();
+  }
+
+  const results = specFiles.map(specPath => {
+    const relSpecPath = path.relative(ROOT, specPath);
+    const specMtime = fs.statSync(specPath).mtimeMs;
+    const review = getReviewStatus(specPath);
+
+    return {
+      specFile: relSpecPath,
+      specMtime: Math.floor(specMtime),
+      reviewFile: review.reviewFile,
+      reviewMtime: review.reviewMtime,
+      reviewStatus: review.reviewStatus,
+    };
+  });
+
+  const output = issuesOnly ? results.filter(r => r.reviewStatus !== "OK") : results;
+
+  console.log(JSON.stringify(output, null, 2));
+}
+
+main();

package/scripts/extract-artifacts.js

@@ -0,0 +1,204 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import path from 'path';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const ROOT = path.resolve(__dirname, '..');
+const SPEC_FILE = 'technical-specification.md';
+
+function parseModuleReference() {
+  const content = fs.readFileSync(path.join(ROOT, SPEC_FILE), 'utf-8');
+  const lines = content.split('\n');
+
+  let inTable = false;
+  const rows = [];
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('|') || !trimmed.endsWith('|')) {
+      if (inTable) break;
+      continue;
+    }
+
+    const cells = trimmed.split('|').map(c => c.trim()).filter(c => c.length > 0);
+
+    if (!inTable) {
+      inTable = true;
+      continue;
+    }
+
+    if (cells.every(c => /^[-:` ]+$/.test(c))) continue;
+
+    rows.push(cells);
+  }
+
+  const modules = {};
+  for (const row of rows) {
+    if (row.length < 4) continue;
+    const name = row[0];
+    const dir = row[1].replace(/`/g, '').trim();
+    const specRaw = row[3];
+
+    if (dir === '—' || dir === '-') continue;
+
+    const specFiles = specRaw
+      .split(',')
+      .map(s => {
+        const cleaned = s.replace(/`/g, '').trim();
+        const parenIdx = cleaned.indexOf('(');
+        return parenIdx !== -1 ? cleaned.substring(0, parenIdx).trim() : cleaned;
+      })
+      .filter(s => s.endsWith('.spec.md') && s.length > 0);
+
+    modules[name.toLowerCase()] = { name, dir, specFiles };
+  }
+
+  return modules;
+}
+
+function extractCodeBlocks(content) {
+  const blocks = [];
+  const regex = /```(mermaid|html)\s*\n([\s\S]*?)```/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    const code = match[2].trim();
+    if (code.length > 0) {
+      blocks.push({ lang: match[1], code });
+    }
+  }
+  return blocks;
+}
+
+function getDiagramName(code, lang, index) {
+  if (lang === 'html') return 'd3-animation.html';
+  const firstLine = code.trim().split('\n')[0].trim();
+  if (/^graph\s+(TB|LR|RL|BT|TD)/.test(firstLine)) return 'architecture.mmd';
+  if (/^sequenceDiagram/.test(firstLine)) return 'sequence.mmd';
+  return `diagram-${index + 1}.mmd`;
+}
+
+function processSpecFile(specPath, outputDir, extraFiles) {
+  const content = fs.readFileSync(specPath, 'utf-8');
+  const blocks = extractCodeBlocks(content);
+
+  const specName = path.basename(specPath);
+  const specOutputDir = path.join(outputDir, specName);
+  fs.mkdirSync(specOutputDir, { recursive: true });
+
+  const usedNames = new Set();
+  for (let i = 0; i < blocks.length; i++) {
+    const { lang, code } = blocks[i];
+    let filename = getDiagramName(code, lang, i);
+    if (usedNames.has(filename)) {
+      const base = filename.replace(/\.(mmd|html)$/, '');
+      const ext = filename.match(/\.(mmd|html)$/)[0];
+      let counter = 2;
+      while (usedNames.has(`${base}-${counter}${ext}`)) counter++;
+      filename = `${base}-${counter}${ext}`;
+    }
+    usedNames.add(filename);
+    fs.writeFileSync(path.join(specOutputDir, filename), code + '\n');
+    console.log(`  extracted ${specName}/${filename}`);
+  }
+
+  if (extraFiles) {
+    for (const { src, dest } of extraFiles) {
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, path.join(specOutputDir, dest));
+        console.log(`  copied ${dest} from project root`);
+      }
+    }
+  }
+
+  const hasMermaid = blocks.some(b => b.lang === 'mermaid');
+  if (blocks.length === 0 && !extraFiles?.some(e => fs.existsSync(e.src))) {
+    console.error(`ERROR: No artifacts found in ${specPath}`);
+    console.error(`HINT: Run system-design skill to regenerate spec with diagrams.`);
+    process.exit(1);
+  }
+  if (!hasMermaid && blocks.length > 0) {
+    console.log(`  (no mermaid diagrams in this spec file — HTML only)`);
+  }
+}
+
+function processSubModule(mod) {
+  const outputDir = path.join(ROOT, mod.dir, '.artifacts');
+  fs.mkdirSync(outputDir, { recursive: true });
+  console.log(`\nProcessing ${mod.name} module → ${path.join(mod.dir, '.artifacts/')}`);
+  for (const specFile of mod.specFiles) {
+    const specPath = path.join(ROOT, mod.dir, specFile);
+    if (fs.existsSync(specPath)) {
+      processSpecFile(specPath, outputDir);
+    } else {
+      console.error(`  WARNING: ${path.join(mod.dir, specFile)} not found, skipping`);
+    }
+  }
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const subModuleIdx = args.indexOf('--sub-module');
+  const allFlag = args.includes('--all');
+  const fileIdx = args.indexOf('--file');
+
+  if (fileIdx !== -1) {
+    const filePath = args[fileIdx + 1];
+    if (!filePath) {
+      console.error('Usage: node scripts/extract-artifacts.js --file <relative-path>');
+      process.exit(1);
+    }
+    const absPath = path.resolve(ROOT, filePath);
+    if (!fs.existsSync(absPath)) {
+      console.error(`ERROR: File not found: ${absPath}`);
+      process.exit(1);
+    }
+    const outputDir = path.join(path.dirname(absPath), '.artifacts');
+    fs.mkdirSync(outputDir, { recursive: true });
+    console.log(`Processing ${filePath} → ${path.join(path.dirname(filePath), '.artifacts/')}`);
+    processSpecFile(absPath, outputDir);
+    console.log('\nDone. Run `npm run test-artifacts` to validate.');
+    return;
+  }
+
+  const modules = parseModuleReference();
+
+  if (subModuleIdx !== -1) {
+    const moduleName = args[subModuleIdx + 1];
+    if (!moduleName) {
+      console.error('Usage: node scripts/extract-artifacts.js --sub-module <name>');
+      console.error(`Available modules: ${Object.keys(modules).join(', ')}`);
+      process.exit(1);
+    }
+    const mod = modules[moduleName.toLowerCase()];
+    if (!mod) {
+      console.error(`Unknown sub-module: "${moduleName}". Available: ${Object.keys(modules).join(', ')}`);
+      process.exit(1);
+    }
+    processSubModule(mod);
+    return;
+  }
+
+  if (allFlag) {
+    console.log(`Processing ${SPEC_FILE} → .artifacts/`);
+    const rootD3 = path.join(ROOT, 'd3-animation.html');
+    const rootExtra = fs.existsSync(rootD3) ? [{ src: rootD3, dest: 'd3-animation.html' }] : [];
+    processSpecFile(path.join(ROOT, SPEC_FILE), path.join(ROOT, '.artifacts'), rootExtra);
+    console.log('Extracting artifacts from all modules...');
+    for (const mod of Object.values(modules)) {
+      processSubModule(mod);
+    }
+    console.log('\nDone. Run `npm run test-artifacts` to validate.');
+    return;
+  }
+
+  const outputDir = path.join(ROOT, '.artifacts');
+  fs.mkdirSync(outputDir, { recursive: true });
+  console.log(`Processing ${SPEC_FILE} → .artifacts/`);
+  const rootD3 = path.join(ROOT, 'd3-animation.html');
+  const extraFiles = fs.existsSync(rootD3) ? [{ src: rootD3, dest: 'd3-animation.html' }] : [];
+  processSpecFile(path.join(ROOT, SPEC_FILE), outputDir, extraFiles);
+  console.log('\nDone. Run `npm run test-artifacts` to validate.');
+}
+
+main();

package/scripts/install/linux/ubuntu-noble-24.04/install.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Ubuntu 24.04.2 LTS (noble) — full development environment for opencode projects
+# Usage: bash scripts/install/linux/ubuntu-noble-24.04/install.sh
+UBUNTU_CODENAME="$(lsb_release -c -s 2>/dev/null || echo 'noble')"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+PACKAGES=(
+  # ---- Build toolchain ----
+  build-essential
+  cmake
+  nasm
+  git
+
+  # ---- Artifact pipeline ----
+  nodejs
+  npm
+
+  # ---- Code search & navigation ----
+  ripgrep
+  fd-find
+  bat
+  fzf
+
+  # ---- System monitoring ----
+  htop
+  duf
+
+  # ---- Performance & benchmarking ----
+  hyperfine
+  linux-tools-common
+  linux-tools-generic
+
+  # ---- Network tools ----
+  httpie
+  whois
+  net-tools
+  dnsutils
+  traceroute
+  nmap
+  mtr
+
+  # ---- Development utilities ----
+  tmux
+  parallel
+  pv
+  entr
+  tree
+  strace
+  ltrace
+  jq
+  zip
+  unzip
+  pigz
+  rsync
+  curl
+  wget
+  ssh
+
+  # ---- Debugging ----
+  gdb
+  python3-pip
+)
+
+echo "==> opencode: installing ${#PACKAGES[@]} packages for Ubuntu $UBUNTU_CODENAME..."
+
+sudo apt update
+sudo apt install -y "${PACKAGES[@]}"
+
+echo "==> Installing gdb-mcp-server (structured GDB interface for agents)..."
+pip3 install gdb-mcp-server
+
+if [ -f "$REPO_ROOT/package.json" ]; then
+  echo "==> Installing npm dependencies..."
+  cd "$REPO_ROOT" && npm install
+fi
+
+echo ""
+echo "=============================="
+echo "  Toolchain Verification"
+echo "=============================="
+printf "%-20s %s\n" "g++"      "$(g++ --version | head -1)"
+printf "%-20s %s\n" "cmake"    "$(cmake --version | head -1)"
+printf "%-20s %s\n" "nasm"     "$(nasm --version | head -1)"
+printf "%-20s %s\n" "node"     "$(node --version)"
+printf "%-20s %s\n" "perf"     "$(perf --version | head -1)"
+printf "%-20s %s\n" "gdb"      "$(gdb --version | head -1)"
+printf "%-20s %s\n" "rg"       "$(rg --version | head -1)"
+printf "%-20s %s\n" "gdb-mcp"  "$(pip3 show gdb-mcp-server 2>/dev/null | grep Version || echo 'not found')"
+echo ""
+echo "Installation complete."
+echo "Run 'gh auth login' for GitHub CLI (issue management)."

package/scripts/install/osx/macos-sequoia-15.0/install.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# macOS — full development environment for opencode projects
+# Usage: bash scripts/install/osx/macos-sequoia-15.0/install.sh
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+
+# ---- Version detection ----
+OS_NAME="macos"
+OS_VERSION=$(sw_vers -productVersion 2>/dev/null || echo "0.0")
+
+# Codename lookup (newest → oldest)
+if [[ $OS_VERSION == 15.* ]]; then   OS_CODENAME="sequoia"
+elif [[ $OS_VERSION == 14.* ]]; then OS_CODENAME="sonoma"
+elif [[ $OS_VERSION == 13.* ]]; then OS_CODENAME="ventura"
+elif [[ $OS_VERSION == 12.* ]]; then OS_CODENAME="monterey"
+elif [[ $OS_VERSION == 11.* ]]; then OS_CODENAME="big-sur"
+else                                 OS_CODENAME="unknown"
+fi
+
+echo "==> opencode: installing for macOS ${OS_VERSION} (${OS_CODENAME})..."
+
+# ---- 1. Xcode Command Line Tools ----
+if ! xcode-select -p &>/dev/null; then
+  echo "==> Installing Xcode Command Line Tools..."
+  xcode-select --install
+  echo "   Please complete the installation dialog, then re-run this script."
+  exit 0
+fi
+echo "  ✓ Xcode Command Line Tools found"
+
+# ---- 2. Homebrew ----
+if ! command -v brew &>/dev/null; then
+  echo "==> Installing Homebrew..."
+  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+fi
+echo "  ✓ Homebrew found"
+
+# ---- 3. Install packages ----
+BREW_PACKAGES=(
+  # Build toolchain
+  cmake
+  nasm
+  git
+  node
+
+  # Code search & navigation
+  ripgrep
+  fd
+  bat
+  fzf
+
+  # System monitoring
+  htop
+  duf
+
+  # Performance & benchmarking
+  hyperfine
+
+  # Network tools
+  httpie
+  whois
+  nmap
+  mtr
+
+  # Development utilities
+  tmux
+  parallel
+  pv
+  entr
+  tree
+  jq
+  pigz
+  wget
+
+  # Debugging
+  python
+)
+
+echo "==> Installing ${#BREW_PACKAGES[@]} Homebrew packages..."
+brew install "${BREW_PACKAGES[@]}"
+
+# ---- 4. Python + GDB MCP ----
+echo "==> Installing gdb-mcp-server..."
+pip3 install gdb-mcp-server
+
+# ---- 5. npm ----
+if [ -f "$REPO_ROOT/package.json" ]; then
+  echo "==> Installing npm dependencies..."
+  cd "$REPO_ROOT" && npm install
+fi
+
+# ---- 6. Verification ----
+echo ""
+echo "=============================="
+echo "  Toolchain Verification"
+echo "=============================="
+printf "%-20s %s\n" "clang++"  "$(clang++ --version | head -1)"
+printf "%-20s %s\n" "cmake"    "$(cmake --version | head -1)"
+printf "%-20s %s\n" "nasm"     "$(nasm --version | head -1)"
+printf "%-20s %s\n" "node"     "$(node --version)"
+printf "%-20s %s\n" "lldb"     "$(lldb --version | head -1)"
+printf "%-20s %s\n" "rg"       "$(rg --version | head -1)"
+printf "%-20s %s\n" "gdb-mcp"  "$(pip3 show gdb-mcp-server 2>/dev/null | grep Version || echo 'not found')"
+echo ""
+echo "Installation complete."
+echo ""
+echo "Notes:"
+echo "  - perf/strace/ltrace are Linux-specific and not available on macOS."
+echo "  - Use Xcode Instruments.app for profiling."
+echo "  - Use lldb for debugging (Xcode CLT provides it)."
+echo "  - Run 'gh auth login' for GitHub CLI (issue management)."
+echo ""

package/scripts/install/windows/wsl2/install.ps1

@@ -0,0 +1,98 @@
+#Requires -RunAsAdministrator
+
+# WSL2 — full development environment for opencode projects
+# Usage (as Administrator):
+#   powershell -ExecutionPolicy Bypass -File scripts\install\windows\wsl2\install.ps1
+
+$ErrorActionPreference = "Stop"
+$SCRIPT_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
+$REPO_ROOT = Resolve-Path "$SCRIPT_DIR\..\..\..\.."
+
+Write-Host "==> opencode: installing for Windows (WSL2)..."
+
+# ---- 1. Check if WSL feature is enabled ----
+$wslFeature = Get-WindowsOptionalFeature -Online -FeatureName "Microsoft-Windows-Subsystem-Linux"
+$vmpFeature = Get-WindowsOptionalFeature -Online -FeatureName "VirtualMachinePlatform"
+
+if ($wslFeature.State -ne "Enabled" -or $vmpFeature.State -ne "Enabled") {
+    Write-Host "==> Enabling WSL and Virtual Machine Platform..."
+    Enable-WindowsOptionalFeature -Online -FeatureName "Microsoft-Windows-Subsystem-Linux" -NoRestart
+    Enable-WindowsOptionalFeature -Online -FeatureName "VirtualMachinePlatform" -NoRestart
+    Write-Host ""
+    Write-Host "WARNING: A system reboot is required before continuing."
+    Write-Host "After rebooting, run this script again to complete setup."
+    Write-Host ""
+    pause
+    exit
+}
+Write-Host "  ✓ WSL feature is enabled"
+
+# ---- 2. Install/update WSL2 kernel ----
+Write-Host "==> Updating WSL2 kernel..."
+wsl --update
+
+# ---- 3. Set WSL2 as default ----
+Write-Host "==> Setting WSL2 as default..."
+wsl --set-default-version 2
+
+# ---- 4. Install Ubuntu distro if not present ----
+$distros = wsl --list --quiet
+if ($distros -notcontains "Ubuntu") {
+    Write-Host "==> Installing Ubuntu distribution..."
+    wsl --install -d Ubuntu
+    Write-Host ""
+    Write-Host "Ubuntu installed. It will start automatically to complete setup."
+    Write-Host "Create a Linux username/password when prompted, then re-run this script."
+    Write-Host ""
+    pause
+    exit
+}
+Write-Host "  ✓ Ubuntu distribution found"
+
+# ---- 5. Set up the repo inside WSL ----
+$WSL_HOME = "~"
+$WSL_REPO_DIR = Split-Path -Leaf $REPO_ROOT
+
+# Check if the repo already exists in WSL
+$repoExists = wsl -d Ubuntu -e bash -c "test -d $WSL_HOME/$WSL_REPO_DIR && echo 'exists' || echo ''"
+if (-not $repoExists) {
+    # Check if we're inside a git repo (clone scenario)
+    if (Test-Path "$REPO_ROOT\.git") {
+        $repoUrl = (git -C $REPO_ROOT remote get-url origin 2>$null)
+        if ($repoUrl) {
+            Write-Host "==> Cloning existing repository inside WSL..."
+            wsl -d Ubuntu -e bash -c "cd $WSL_HOME && git clone $repoUrl $WSL_REPO_DIR"
+        } else {
+            Write-Host "==> Copying files to WSL (no remote origin)..."
+            wsl -d Ubuntu -e bash -c "mkdir -p $WSL_HOME/$WSL_REPO_DIR"
+            # Copy files from current directory into WSL (excluding node_modules, .git, etc.)
+            wsl -d Ubuntu -e bash -c "rsync -a --exclude='node_modules' --exclude='.git' '$REPO_ROOT/' '$WSL_HOME/$WSL_REPO_DIR/'"
+        }
+    } else {
+        # Starter scenario — create directory structure
+        Write-Host "==> Creating project structure inside WSL..."
+        wsl -d Ubuntu -e bash -c "mkdir -p $WSL_HOME/$WSL_REPO_DIR"
+        if (Test-Path $REPO_ROOT) {
+            wsl -d Ubuntu -e bash -c "rsync -a '$REPO_ROOT/' '$WSL_HOME/$WSL_REPO_DIR/'"
+        }
+    }
+}
+Write-Host "  ✓ Repository set up at ~/$WSL_REPO_DIR inside WSL"
+
+# ---- 6. Run the Ubuntu install script inside WSL ----
+Write-Host "==> Running Ubuntu install script inside WSL..."
+wsl -d Ubuntu -e bash -c "
+    cd ~/$WSL_REPO_DIR
+    bash scripts/install/linux/ubuntu-noble-24.04/install.sh
+"
+
+# ---- 7. Done ----
+Write-Host ""
+Write-Host "=============================="
+Write-Host "  WSL2 Setup Complete"
+Write-Host "=============================="
+Write-Host "  Enter WSL:        wsl -d Ubuntu"
+Write-Host "  Project path:     ~/$WSL_REPO_DIR"
+Write-Host ""
+Write-Host "  Run 'gh auth login' inside WSL for GitHub CLI access."
+Write-Host ""

package/scripts/install.ps1

@@ -0,0 +1,32 @@
+#Requires -RunAsAdministrator
+
+# deepenc environment installer — Windows detection and dispatch
+# Usage (as Administrator):
+#   powershell -ExecutionPolicy Bypass -File scripts\install.ps1
+
+$ErrorActionPreference = "Stop"
+$SCRIPT_DIR = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+Write-Host "==> deepenc: detected Windows"
+
+# Check if WSL is available
+$wslFeature = Get-WindowsOptionalFeature -Online -FeatureName "Microsoft-Windows-Subsystem-Linux" -ErrorAction SilentlyContinue
+$hasWsl = ($wslFeature -and $wslFeature.State -eq "Enabled")
+
+if (-not $hasWsl) {
+    Write-Host "==> WSL is not installed. Running WSL2 installer..."
+    & "$SCRIPT_DIR\install\windows\wsl2\install.ps1"
+} else {
+    # WSL is already enabled — check if Ubuntu distro exists
+    $distros = wsl --list --quiet 2>$null
+    if ($distros -contains "Ubuntu") {
+        Write-Host "==> WSL2 + Ubuntu detected. Running Ubuntu installer inside WSL..."
+        wsl -d Ubuntu -e bash -c "
+            cd ~/deepenc 2>/dev/null || mkdir -p ~/deepenc
+            bash scripts/install/linux/ubuntu-noble-24.04/install.sh
+        "
+    } else {
+        Write-Host "==> WSL enabled but Ubuntu not installed. Running WSL2 installer..."
+        & "$SCRIPT_DIR\install\windows\wsl2\install.ps1"
+    }
+}