@jagilber-org/index-server 1.28.9 → 1.28.19

package/scripts/client/powershell-mcp-server.ps1

@@ -0,0 +1,83 @@
+<#
+ Minimal PowerShell MCP Server (stdio JSON-RPC) for isolation handshake testing.
+ Implements:
+   - initialize (id:1) -> returns protocolVersion / serverInfo / capabilities
+   - emits server/ready notification AFTER initialize result
+   - emits notifications/tools/list_changed after ready
+   - tools/list request handler
+   - tools/call with a single demo tool (echo/upper)
+   - ping request (latency / reachability)
+ Exits automatically after 30s of inactivity or when INDEX_SERVER_PWS_EXIT_MS is set.
+#>
+
+param(
+  [int] $IdleExitMs = [int]([Environment]::GetEnvironmentVariable('INDEX_SERVER_PWS_EXIT_MS') | ForEach-Object { if($_){$_} else {30000} })
+)
+
+$ErrorActionPreference = 'Stop'
+[Console]::InputEncoding = [System.Text.UTF8Encoding]::UTF8
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::UTF8
+
+$start = Get-Date
+$readyEmitted = $false
+$tools = @(
+  @{ name = 'echo/upper'; description = 'Uppercase a string'; inputSchema = @{ type='object'; properties = @{ text = @{ type='string'} }; required = @('text') } }
+)
+
+function Write-Json($obj){
+  $json = $obj | ConvertTo-Json -Depth 8 -Compress
+  [Console]::Out.WriteLine($json)
+}
+
+function Send-ReadyOnce {
+  if(-not $script:readyEmitted){
+    Write-Json @{ jsonrpc='2.0'; method='server/ready'; params=@{ version='0.1.0'; reason='pwsh-minimal' } }
+    Write-Json @{ jsonrpc='2.0'; method='notifications/tools/list_changed'; params=@{} }
+    $script:readyEmitted = $true
+  }
+}
+
+$lastActivity = Get-Date
+
+while($true){
+  if([Console]::In.Peek() -lt 0){ Start-Sleep -Milliseconds 20 } else {
+    $line = [Console]::In.ReadLine()
+    if([string]::IsNullOrWhiteSpace($line)){ continue }
+    $lastActivity = Get-Date
+    try { $msg = $line | ConvertFrom-Json -ErrorAction Stop } catch { continue }
+    $id = $msg.id
+    $method = $msg.method
+    if($method -eq 'initialize'){
+      $proto = if($msg.params.protocolVersion){ $msg.params.protocolVersion } else { '2025-06-18' }
+      $result = @{ protocolVersion=$proto; serverInfo=@{ name='powershell-mcp-minimal'; version='0.1.0' }; capabilities=@{ tools=@{ listChanged=$true } } }
+      Write-Json @{ jsonrpc='2.0'; id=$id; result=$result }
+      Start-Sleep -Milliseconds 15
+      Send-ReadyOnce
+      continue
+    }
+    if($method -eq 'tools/list'){
+      Write-Json @{ jsonrpc='2.0'; id=$id; result=@{ tools=$tools } }
+      continue
+    }
+    if($method -eq 'tools/call'){
+      $name = $msg.params.name
+      if($name -eq 'echo/upper'){
+        $text = $msg.params.arguments.text
+        $out = [string]::IsNullOrEmpty($text) ? '' : $text.ToUpperInvariant()
+        $payload = @{ content = @(@{ type='text'; text=$out }) }
+        Write-Json @{ jsonrpc='2.0'; id=$id; result=$payload }
+      } else {
+        Write-Json @{ jsonrpc='2.0'; id=$id; error=@{ code=-32601; message='Unknown tool'; data=@{ tool=$name } } }
+      }
+      continue
+    }
+    if($method -eq 'ping'){
+      Write-Json @{ jsonrpc='2.0'; id=$id; result=@{ timestamp=(Get-Date).ToString('o'); uptimeMs=([int]((Get-Date)-$start).TotalMilliseconds) } }
+      continue
+    }
+    if($id){ Write-Json @{ jsonrpc='2.0'; id=$id; error=@{ code=-32601; message='Method not found'; data=@{ method=$method } } } }
+  }
+  if(((Get-Date)-$lastActivity).TotalMilliseconds -gt $IdleExitMs){ break }
+}
+
+exit 0

package/scripts/client/powershell-mcp-template.ps1

@@ -0,0 +1,85 @@
+# PowerShell MCP Server Usage Template
+# Safe operations with timeout protection and file logging
+#
+# Usage:
+#   .\scripts\powershell-mcp-template.ps1 -LogFile "my-session.log" -Operation "build"
+#
+
+param(
+    [string]$LogFile = "mcp-session-$(Get-Date -Format 'yyyy-MM-dd-HHmmss').log",
+    [string]$Operation = "status",
+    [int]$TimeoutSeconds = 15
+)
+
+Write-Output "🚀 Index Server - PowerShell MCP Template"
+Write-Output "============================================="
+Write-Output ""
+
+# Configure environment for file logging
+$env:INDEX_SERVER_LOG_FILE = $LogFile
+$env:INDEX_SERVER_VERBOSE_LOGGING = "1"
+
+Write-Output "📋 Configuration:"
+Write-Output "   Log File: $LogFile"
+Write-Output "   Operation: $Operation"
+Write-Output "   Timeout: $TimeoutSeconds seconds"
+Write-Output "   Working Dir: $PWD"
+Write-Output ""
+
+# Example operations that would be done via PowerShell MCP
+switch ($Operation.ToLower()) {
+    "status" {
+        Write-Output "📊 Project Status Check:"
+
+        # Check build status
+        $buildReady = Test-Path "dist/server/index-server.js"
+        Write-Output "   Build Status: $(if($buildReady){'✅ Ready'}else{'❌ Missing - run npm run build'})"
+
+        # Check package info
+        if (Test-Path "package.json") {
+            $pkg = Get-Content "package.json" | ConvertFrom-Json
+            Write-Output "   Package: $($pkg.name) v$($pkg.version)"
+        }
+
+        # Check source files
+        $srcCount = (Get-ChildItem "src" -Filter "*.ts" -Recurse -ErrorAction SilentlyContinue | Measure-Object).Count
+        Write-Output "   Source Files: $srcCount TypeScript files"
+
+        # Check existing logs
+        $logFiles = @(Get-ChildItem "*.log" -ErrorAction SilentlyContinue)
+        Write-Output "   Log Files: $($logFiles.Count) files"
+    }
+
+    "build" {
+        Write-Output "🔨 Building Index Server:"
+        Write-Output "   This would run: npm run build"
+        Write-Output "   With timeout protection and process cleanup"
+    }
+
+    "test" {
+        Write-Output "🧪 Running Tests:"
+        Write-Output "   This would run: npm test"
+        Write-Output "   With structured logging to: $LogFile"
+    }
+
+    "deploy" {
+        Write-Output "🚀 Deployment Operations:"
+        Write-Output "   This would handle deployment tasks"
+        Write-Output "   With full audit logging enabled"
+    }
+
+    default {
+        Write-Output "❓ Unknown operation: $Operation"
+        Write-Output "   Available: status, build, test, deploy"
+    }
+}
+
+Write-Output ""
+Write-Output "✅ Template Complete!"
+Write-Output ""
+Write-Output "💡 To use with PowerShell MCP Server:"
+Write-Output "   mcp_powershell-mc_run-powershell:"
+Write-Output "     aiAgentTimeoutSec: $TimeoutSeconds"
+Write-Output "     confirmed: true"
+Write-Output "     workingDirectory: `"<root>\index-server`""
+Write-Output "     script: `".\scripts\powershell-mcp-template.ps1 -LogFile '$LogFile' -Operation '$Operation'`""

package/scripts/hooks/README.md

@@ -0,0 +1,40 @@
+# scripts/hooks
+
+Git hook implementations. These are **not** the hooks themselves (those live in
+`.git/hooks/`); these are the scripts that hooks invoke. Managed by `pre-commit`
+via `.pre-commit-config.yaml`. Run `pwsh -File scripts/hooks/setup-hooks.ps1`
+once to wire them up.
+
+## Scripts
+
+| Script | Hook | Purpose |
+|--------|------|---------|
+| `pre-commit.mjs` | `pre-commit` | ESM pre-commit runner: lint, type-check, schema validate |
+| `pre-commit.ps1` | `pre-commit` | PowerShell pre-commit runner (PII scan, security scan) |
+| `commit-msg-baseline.mjs` | `commit-msg` | Validate commit message against Conventional Commits |
+| `commit-msg-baseline.ps1` | `commit-msg` | PowerShell shim for `commit-msg-baseline.mjs` |
+| `pre-push.mjs` | `pre-push` | ESM pre-push runner: full test suite gate |
+| `pre-push.ps1` | `pre-push` | PowerShell pre-push runner: build verify + governance |
+| `pre-push-integrity.ps1` | `pre-push` | Assert dist/ integrity before push |
+| `pre-push-log-hygiene.ps1` | `pre-push` | Block if debug log statements remain in staged files |
+| `pre-push-public-guard.cjs` | `pre-push` | CJS guard: block push to public remote without clean-room check |
+| `run-codeql-pre-push.ps1` | `pre-push` | Run CodeQL analysis before push through `hooks/codeql-pre-push.ps1` |
+| `hooks/run-gitleaks-pre-push.ps1` | `pre-push` | Run gitleaks commit-range scanning before push |
+| `run-semgrep-pre-push.ps1` | `pre-push` | Run Semgrep SAST before push |
+| `setup-hooks.cjs` | setup | CJS installer: symlink hook scripts into `.git/hooks/` |
+| `setup-hooks.ps1` | setup | PowerShell installer: same, with Windows path handling |
+
+## Setup
+
+```pwsh
+# Install hooks once after cloning
+pwsh -File scripts/hooks/setup-hooks.ps1
+
+# Template-compatible wrapper
+pwsh -File scripts/setup-hooks.ps1
+
+# Or via pre-commit
+pre-commit install --hook-type commit-msg --hook-type pre-push
+```
+
+> Do NOT use `--no-verify` to bypass hooks. Fix the gate or fix the code.

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/jagilber-org/index-server",
     "source": "github"
   },
-  "version": "1.28.9",
+  "version": "1.28.19",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@jagilber-org/index-server",
-      "version": "1.28.9",
+      "version": "1.28.19",
       "transport": {
         "type": "stdio"
       }