@smilintux/skcapstone 0.1.0 → 0.2.3

package/scripts/mcp-server.bat

@@ -0,0 +1,113 @@
+@echo off
+REM -------------------------------------------------------------------
+REM skcapstone MCP server launcher for Windows (cmd.exe)
+REM Task: e5f81637
+REM
+REM Auto-detects the Python virtualenv and launches the MCP server
+REM on stdio transport. Works with any MCP client that speaks stdio.
+REM
+REM Usage:
+REM   scripts\mcp-server.bat
+REM
+REM Environment overrides:
+REM   set SKCAPSTONE_VENV=C:\path\to\venv
+REM   set SKMEMORY_HOME=C:\path\to\memory
+REM -------------------------------------------------------------------
+
+setlocal enabledelayedexpansion
+
+set "SCRIPT_DIR=%~dp0"
+REM Remove trailing backslash
+set "SCRIPT_DIR=%SCRIPT_DIR:~0,-1%"
+
+REM Navigate up one level to get skcapstone project dir
+for %%I in ("%SCRIPT_DIR%\..") do set "SKCAPSTONE_DIR=%%~fI"
+
+set "PYTHON="
+
+REM --- 1. Explicit SKCAPSTONE_VENV override ---
+if defined SKCAPSTONE_VENV (
+    if exist "%SKCAPSTONE_VENV%\Scripts\python.exe" (
+        set "PYTHON=%SKCAPSTONE_VENV%\Scripts\python.exe"
+        goto :found
+    )
+    if exist "%SKCAPSTONE_VENV%\bin\python" (
+        set "PYTHON=%SKCAPSTONE_VENV%\bin\python"
+        goto :found
+    )
+    echo WARNING: SKCAPSTONE_VENV=%SKCAPSTONE_VENV% set but python not found, falling back. >&2
+)
+
+REM --- 2. Standard skenv on Windows (%LOCALAPPDATA%\skenv) ---
+if exist "%LOCALAPPDATA%\skenv\Scripts\python.exe" (
+    "%LOCALAPPDATA%\skenv\Scripts\python.exe" -c "import skcapstone" >nul 2>&1
+    if !errorlevel! equ 0 (
+        set "PYTHON=%LOCALAPPDATA%\skenv\Scripts\python.exe"
+        goto :found
+    )
+)
+
+REM --- 3. Standard skenv Unix-style (%USERPROFILE%\.skenv) ---
+if exist "%USERPROFILE%\.skenv\Scripts\python.exe" (
+    "%USERPROFILE%\.skenv\Scripts\python.exe" -c "import skcapstone" >nul 2>&1
+    if !errorlevel! equ 0 (
+        set "PYTHON=%USERPROFILE%\.skenv\Scripts\python.exe"
+        goto :found
+    )
+)
+
+REM --- 4. Project-local .venv ---
+if exist "%SKCAPSTONE_DIR%\.venv\Scripts\python.exe" (
+    "%SKCAPSTONE_DIR%\.venv\Scripts\python.exe" -c "import skcapstone" >nul 2>&1
+    if !errorlevel! equ 0 (
+        set "PYTHON=%SKCAPSTONE_DIR%\.venv\Scripts\python.exe"
+        goto :found
+    )
+)
+
+REM --- 5. System Python ---
+where python >nul 2>&1
+if %errorlevel% equ 0 (
+    python -c "import skcapstone" >nul 2>&1
+    if !errorlevel! equ 0 (
+        set "PYTHON=python"
+        goto :found
+    )
+)
+
+where python3 >nul 2>&1
+if %errorlevel% equ 0 (
+    python3 -c "import skcapstone" >nul 2>&1
+    if !errorlevel! equ 0 (
+        set "PYTHON=python3"
+        goto :found
+    )
+)
+
+REM --- Not found ---
+echo ERROR: Could not find a Python interpreter with skcapstone installed. >&2
+echo. >&2
+echo Install with: >&2
+echo   scripts\install.bat >&2
+echo. >&2
+echo Or point to an existing venv: >&2
+echo   set SKCAPSTONE_VENV=C:\path\to\venv >&2
+echo   scripts\mcp-server.bat >&2
+exit /b 1
+
+:found
+
+REM --- Set environment variables ---
+if not defined SKMEMORY_HOME set "SKMEMORY_HOME=%USERPROFILE%\.skcapstone\memory"
+if not defined SKCAPSTONE_HOME set "SKCAPSTONE_HOME=%USERPROFILE%\.skcapstone"
+
+REM Ensure skcapstone is importable
+if defined PYTHONPATH (
+    set "PYTHONPATH=%SKCAPSTONE_DIR%\src;%PYTHONPATH%"
+) else (
+    set "PYTHONPATH=%SKCAPSTONE_DIR%\src"
+)
+
+REM --- Launch MCP server on stdio ---
+%PYTHON% -m skcapstone.mcp_server %*
+exit /b %errorlevel%

package/scripts/mcp-server.ps1

@@ -0,0 +1,116 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    SKCapstone MCP server launcher for Windows (PowerShell).
+    Task: e5f81637
+
+.DESCRIPTION
+    Auto-detects the Python virtualenv and launches the MCP server
+    on stdio transport. Works with Cursor, Claude Desktop, Claude
+    Code CLI, Windsurf, Aider, Cline, or any stdio MCP client.
+
+.PARAMETER VenvPath
+    Override the virtualenv path (instead of auto-detection).
+
+.EXAMPLE
+    .\scripts\mcp-server.ps1
+    .\scripts\mcp-server.ps1 -VenvPath C:\Users\me\.skenv
+
+.NOTES
+    Environment overrides:
+      SKCAPSTONE_VENV  - force a specific virtualenv
+      SKMEMORY_HOME    - override memory storage location
+#>
+
+[CmdletBinding()]
+param(
+    [string]$VenvPath
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
+$SkcapstoneDir = Split-Path -Parent $ScriptDir
+
+# --- Locate the Python interpreter ---
+function Find-Python {
+    # 1. Explicit parameter or env var
+    $ExplicitVenv = if ($VenvPath) { $VenvPath } else { $env:SKCAPSTONE_VENV }
+    if ($ExplicitVenv) {
+        $py = Join-Path $ExplicitVenv 'Scripts\python.exe'
+        if (Test-Path $py) { return $py }
+        $py = Join-Path $ExplicitVenv 'bin\python'
+        if (Test-Path $py) { return $py }
+        Write-Warning "SKCAPSTONE_VENV=$ExplicitVenv set but python not found there, falling back."
+    }
+
+    # 2. Standard skenv location on Windows
+    $SkenvWin = Join-Path $env:LOCALAPPDATA 'skenv\Scripts\python.exe'
+    if (Test-Path $SkenvWin) {
+        $check = & $SkenvWin -c "import skcapstone" 2>&1
+        if ($LASTEXITCODE -eq 0) { return $SkenvWin }
+    }
+
+    # 3. Standard skenv location (Unix-style, e.g. WSL path in Windows)
+    $SkenvUnix = Join-Path $HOME '.skenv\bin\python'
+    if (Test-Path $SkenvUnix) {
+        $check = & $SkenvUnix -c "import skcapstone" 2>&1
+        if ($LASTEXITCODE -eq 0) { return $SkenvUnix }
+    }
+
+    # 4. Project-local .venv
+    $LocalVenv = Join-Path $SkcapstoneDir '.venv\Scripts\python.exe'
+    if (Test-Path $LocalVenv) {
+        $check = & $LocalVenv -c "import skcapstone" 2>&1
+        if ($LASTEXITCODE -eq 0) { return $LocalVenv }
+    }
+
+    # 5. System Python
+    foreach ($cmd in @('python', 'python3')) {
+        $sysPath = Get-Command $cmd -ErrorAction SilentlyContinue
+        if ($sysPath) {
+            $check = & $sysPath.Source -c "import skcapstone" 2>&1
+            if ($LASTEXITCODE -eq 0) { return $sysPath.Source }
+        }
+    }
+
+    return $null
+}
+
+$Python = Find-Python
+if (-not $Python) {
+    Write-Error @"
+Could not find a Python interpreter with skcapstone installed.
+
+Install with:
+  .\scripts\install.ps1
+
+Or point to an existing venv:
+  `$env:SKCAPSTONE_VENV = 'C:\path\to\venv'
+  .\scripts\mcp-server.ps1
+"@
+    exit 1
+}
+
+Write-Verbose "Using Python: $Python"
+
+# --- Set environment variables ---
+if (-not $env:SKMEMORY_HOME) {
+    $env:SKMEMORY_HOME = Join-Path $HOME '.skcapstone\memory'
+}
+if (-not $env:SKCAPSTONE_HOME) {
+    $env:SKCAPSTONE_HOME = Join-Path $HOME '.skcapstone'
+}
+
+# Ensure skcapstone is importable
+$SrcPath = Join-Path $SkcapstoneDir 'src'
+if ($env:PYTHONPATH) {
+    $env:PYTHONPATH = "$SrcPath;$($env:PYTHONPATH)"
+} else {
+    $env:PYTHONPATH = $SrcPath
+}
+
+# --- Launch MCP server on stdio ---
+& $Python -m skcapstone.mcp_server @args
+exit $LASTEXITCODE

package/scripts/mcp-server.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# -------------------------------------------------------------------
+# skcapstone MCP server launcher — cross-platform (Linux / macOS)
+# Task: e5f81637
+#
+# Works with: Cursor, Claude Desktop, Claude Code CLI, Windsurf,
+#             Aider, Cline, or any MCP client that speaks stdio.
+#
+# The script auto-detects the Python virtualenv and launches the
+# MCP server on stdio. No hardcoded paths required in client configs.
+#
+# Usage:
+#   ./scripts/mcp-server.sh              (from repo root)
+#   bash scripts/mcp-server.sh           (explicit bash)
+#
+# Environment overrides:
+#   SKCAPSTONE_VENV=/path/to/venv  — force a specific virtualenv
+#   SKMEMORY_HOME=/path/to/dir     — override memory storage location
+#   SKCAPSTONE_LOG_LEVEL=DEBUG     — set log verbosity
+# -------------------------------------------------------------------
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKCAPSTONE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# --- Locate the Python interpreter ---
+# Priority:
+#   1. SKCAPSTONE_VENV env var (explicit override)
+#   2. ~/.skenv  (standard SK* suite venv)
+#   3. Project-local .venv dirs
+#   4. System python3 / python
+find_python() {
+    # 1. Explicit venv override
+    if [[ -n "${SKCAPSTONE_VENV:-}" ]]; then
+        local py="$SKCAPSTONE_VENV/bin/python"
+        if [[ -x "$py" ]]; then
+            echo "$py"
+            return
+        fi
+        echo "WARNING: SKCAPSTONE_VENV=$SKCAPSTONE_VENV set but $py not found, falling back." >&2
+    fi
+
+    # 2. Standard ~/.skenv venv
+    local skenv="$HOME/.skenv/bin/python"
+    if [[ -x "$skenv" ]]; then
+        if "$skenv" -c "import skcapstone" 2>/dev/null; then
+            echo "$skenv"
+            return
+        fi
+    fi
+
+    # 3. Project-local venvs
+    local candidates=(
+        "$SKCAPSTONE_DIR/.venv/bin/python"
+        "$SKCAPSTONE_DIR/../.venv/bin/python"
+    )
+    for py in "${candidates[@]}"; do
+        if [[ -x "$py" ]]; then
+            if "$py" -c "import skcapstone" 2>/dev/null; then
+                echo "$py"
+                return
+            fi
+        fi
+    done
+
+    # 4. System Python (must have skcapstone installed)
+    for cmd in python3 python; do
+        if command -v "$cmd" >/dev/null 2>&1; then
+            if "$cmd" -c "import skcapstone" 2>/dev/null; then
+                echo "$(command -v "$cmd")"
+                return
+            fi
+        fi
+    done
+
+    return 1
+}
+
+PYTHON="$(find_python)" || {
+    echo "ERROR: Could not find a Python interpreter with skcapstone installed." >&2
+    echo "" >&2
+    echo "Install with:" >&2
+    echo "  bash scripts/install.sh" >&2
+    echo "" >&2
+    echo "Or point to an existing venv:" >&2
+    echo "  SKCAPSTONE_VENV=/path/to/venv bash scripts/mcp-server.sh" >&2
+    exit 1
+}
+
+# --- Set environment variables ---
+export SKMEMORY_HOME="${SKMEMORY_HOME:-$HOME/.skcapstone/memory}"
+export SKCAPSTONE_HOME="${SKCAPSTONE_HOME:-$HOME/.skcapstone}"
+
+# Ensure skcapstone is importable even if not pip-installed
+export PYTHONPATH="${SKCAPSTONE_DIR}/src${PYTHONPATH:+:$PYTHONPATH}"
+
+# --- Launch MCP server on stdio ---
+exec "$PYTHON" -m skcapstone.mcp_server "$@"

package/scripts/pull-models.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Pull required Ollama models for the sovereign agent
+set -euo pipefail
+
+echo "Pulling Ollama models for SKCapstone..."
+
+ollama pull llama3.2      # FAST tier (3.2B, ~2GB) — CPU-only inference
+ollama pull devstral      # CODE tier — code generation and review
+
+echo "Models ready"

package/scripts/skcapstone

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# ---------------------------------------------------------------------------
+# skcapstone CLI wrapper — run without pip install (dev from repo).
+#
+# Adds skcapstone src to PYTHONPATH and invokes the CLI. Use when working
+# from the monorepo without activating a venv or installing the package.
+#
+# To get `skcapstone` on PATH:
+#   export PATH="/path/to/smilintux-org/skcapstone/scripts:$PATH"
+# Or from repo root: export PATH="$(pwd)/skcapstone/scripts:$PATH"
+#
+# Usage:
+#   ./skcapstone/scripts/skcapstone status
+#   skcapstone trust rehydrate   # when scripts/ is on PATH
+# ---------------------------------------------------------------------------
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKCAPSTONE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+SRC_DIR="${SKCAPSTONE_DIR}/src"
+
+export PYTHONPATH="${SRC_DIR}${PYTHONPATH:+:$PYTHONPATH}"
+
+# Prefer venv python if present (has deps); else system python (may need deps)
+if [[ -x "${SKCAPSTONE_DIR}/.venv/bin/python" ]]; then
+    exec "${SKCAPSTONE_DIR}/.venv/bin/python" -c "
+import sys
+sys.argv = ['skcapstone'] + sys.argv[1:]
+from skcapstone.cli import main
+main()
+" "$@"
+elif [[ -x "$(cd "$SCRIPT_DIR/../.." && pwd)/skmemory/.venv/bin/python" ]]; then
+    REPO_VENV="$(cd "$SCRIPT_DIR/../.." && pwd)/skmemory/.venv/bin/python"
+    exec "$REPO_VENV" -c "
+import sys
+sys.argv = ['skcapstone'] + sys.argv[1:]
+from skcapstone.cli import main
+main()
+" "$@"
+else
+    exec python -c "
+import sys
+sys.argv = ['skcapstone'] + sys.argv[1:]
+from skcapstone.cli import main
+main()
+" "$@"
+fi

package/scripts/verify_install.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+# verify_install.sh — Verify skcapstone pip install works cleanly.
+# Creates a fresh venv, installs each package, runs --version, reports pass/fail.
+set -uo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+VENV_DIR="/tmp/skcapstone_verify_venv_$$"
+PASS=0
+FAIL=0
+RESULTS=()
+
+# ── helpers ────────────────────────────────────────────────────────────────
+ok()   { echo "  [PASS] $*"; PASS=$((PASS + 1)); RESULTS+=("PASS: $*"); }
+fail() { echo "  [FAIL] $*"; FAIL=$((FAIL + 1)); RESULTS+=("FAIL: $*"); }
+skip() { echo "  [SKIP] $*"; RESULTS+=("SKIP: $*"); }
+
+hr() { printf '%0.s─' {1..60}; echo; }
+
+cleanup() { rm -rf "$VENV_DIR"; }
+trap cleanup EXIT
+
+# ── setup ──────────────────────────────────────────────────────────────────
+hr
+echo "  SKCapstone Install Verification"
+echo "  Repo : $REPO_ROOT"
+echo "  Venv : $VENV_DIR"
+hr
+
+# Require Python ≥ 3.10 — prefer pyenv global python3, then fallback names
+for _py in python3 python python3.13 python3.12 python3.11 python3.10; do
+  if _found=$(command -v "$_py" 2>/dev/null) && "$_found" -c "import sys; sys.exit(0 if sys.version_info >= (3,10) else 1)" 2>/dev/null; then
+    PYTHON="$_found"
+    break
+  fi
+done
+if [[ -z "${PYTHON:-}" ]]; then
+  echo "ERROR: python3 >= 3.10 not found"; exit 1
+fi
+PY_VER=$("$PYTHON" -c "import sys; print('%d.%d' % sys.version_info[:2])")
+echo "  Python: $PYTHON ($PY_VER)"
+hr
+
+# Create isolated venv
+"$PYTHON" -m venv "$VENV_DIR" || { echo "ERROR: venv creation failed"; exit 1; }
+PIP="$VENV_DIR/bin/pip"
+PYEXE="$VENV_DIR/bin/python"
+
+"$PIP" install --quiet --upgrade pip wheel setuptools 2>&1 | tail -1
+
+# Common pip flags — prefer pre-built wheels, 60s per-package timeout
+PIP_OPTS=(--quiet --prefer-binary --timeout=60)
+
+# ── 1. Core skcapstone (base deps only) ───────────────────────────────────
+echo
+echo "Step 1: core install (click, mcp, pydantic, pyyaml, rich)"
+if "$PIP" install "${PIP_OPTS[@]}" "$REPO_ROOT" 2>&1; then
+  ok "pip install skcapstone (core)"
+else
+  fail "pip install skcapstone (core)"
+fi
+
+# Verify importable
+if "$PYEXE" -c "import skcapstone; print('  version:', skcapstone.__version__)" 2>&1; then
+  ok "import skcapstone"
+else
+  fail "import skcapstone"
+fi
+
+# Verify CLI entry point
+if "$VENV_DIR/bin/skcapstone" --help > /dev/null 2>&1; then
+  ok "skcapstone --help"
+else
+  fail "skcapstone --help"
+fi
+
+if "$VENV_DIR/bin/skcapstone" --version 2>&1 | grep -qE "[0-9]+\.[0-9]+"; then
+  ok "skcapstone --version"
+else
+  fail "skcapstone --version"
+fi
+
+# Verify crush shim entry point
+if "$VENV_DIR/bin/crush" --help > /dev/null 2>&1; then
+  ok "crush --help"
+else
+  fail "crush --help (stub)"
+fi
+
+# ── 2. Optional extra: consciousness (watchdog) ────────────────────────────
+echo
+echo "Step 2: optional 'consciousness' extra"
+if "$PIP" install "${PIP_OPTS[@]}" "$REPO_ROOT[consciousness]" 2>&1; then
+  ok "pip install skcapstone[consciousness]"
+  if "$PYEXE" -c "import watchdog; print('  watchdog:', watchdog.__version__)" 2>&1; then
+    ok "import watchdog"
+  else
+    fail "import watchdog"
+  fi
+else
+  fail "pip install skcapstone[consciousness]"
+fi
+
+# ── 3. Optional extra: shell (prompt_toolkit) ──────────────────────────────
+echo
+echo "Step 3: optional 'shell' extra"
+if "$PIP" install "${PIP_OPTS[@]}" "$REPO_ROOT[shell]" 2>&1; then
+  ok "pip install skcapstone[shell]"
+  if "$PYEXE" -c "import prompt_toolkit; print('  prompt_toolkit:', prompt_toolkit.__version__)" 2>&1; then
+    ok "import prompt_toolkit"
+  else
+    fail "import prompt_toolkit"
+  fi
+else
+  fail "pip install skcapstone[shell]"
+fi
+
+# ── 4. Dev extras (pytest, ruff, black) ────────────────────────────────────
+echo
+echo "Step 4: dev extras"
+if "$PIP" install "${PIP_OPTS[@]}" "$REPO_ROOT[dev]" 2>&1; then
+  ok "pip install skcapstone[dev]"
+  for pkg in pytest ruff black; do
+    if "$PYEXE" -c "import $pkg" 2>&1; then
+      ok "import $pkg"
+    else
+      fail "import $pkg"
+    fi
+  done
+else
+  fail "pip install skcapstone[dev]"
+fi
+
+# ── 5. Local sibling packages (skseed, skcomm) ─────────────────────────────
+echo
+echo "Step 5: local sibling packages (if present)"
+for pkg_dir in "$REPO_ROOT/../skseed" "$REPO_ROOT/../skcomm" "$REPO_ROOT/../skmemory" "$REPO_ROOT/../skskills"; do
+  pkg_name=$(basename "$pkg_dir")
+  if [[ -f "$pkg_dir/pyproject.toml" ]] || [[ -f "$pkg_dir/setup.py" ]]; then
+    if "$PIP" install "${PIP_OPTS[@]}" -e "$pkg_dir" 2>&1; then
+      ok "pip install -e $pkg_name"
+      if "$PYEXE" -c "import $pkg_name" 2>&1; then
+        ok "import $pkg_name"
+      else
+        fail "import $pkg_name"
+      fi
+    else
+      fail "pip install -e $pkg_name"
+    fi
+  else
+    skip "$pkg_name not found at $pkg_dir"
+  fi
+done
+
+# ── 6. Verify key CLI subcommands load ─────────────────────────────────────
+echo
+echo "Step 6: CLI subcommands smoke test"
+SKCAP="$VENV_DIR/bin/skcapstone"
+for subcmd in status memory coord doctor daemon sync; do
+  if "$SKCAP" "$subcmd" --help > /dev/null 2>&1; then
+    ok "skcapstone $subcmd --help"
+  else
+    fail "skcapstone $subcmd --help"
+  fi
+done
+
+# ── Summary ────────────────────────────────────────────────────────────────
+echo
+hr
+echo "  Results: $PASS passed, $FAIL failed"
+hr
+if [[ $FAIL -eq 0 ]]; then
+  echo "  ALL CHECKS PASSED"
+  exit 0
+else
+  echo "  FAILURES:"
+  for r in "${RESULTS[@]}"; do
+    [[ "$r" == FAIL:* ]] && echo "    $r"
+  done
+  exit 1
+fi