@mseep/clawdcursor 1.5.5

package/scripts/smoke-mcp.ps1

@@ -0,0 +1,119 @@
+param([int]$Port = 3847, [int]$TimeoutSec = 30)
+
+$token = (Get-Content "$env:USERPROFILE\.clawdcursor\token" -Raw).Trim()
+$base = "http://127.0.0.1:$Port/mcp"
+$hdrs = @{
+  "Authorization" = "Bearer $token"
+  "Accept" = "application/json, text/event-stream"
+}
+
+$global:jsonRpcId = 0
+function Call-Tool {
+  param([string]$Name, [hashtable]$Arguments = @{})
+  $global:jsonRpcId++
+  $body = @{
+    jsonrpc = "2.0"
+    id      = $global:jsonRpcId
+    method  = "tools/call"
+    params  = @{ name = $Name; arguments = $Arguments }
+  } | ConvertTo-Json -Depth 10 -Compress
+  try {
+    $r = Invoke-WebRequest -Uri $base -Method POST -Headers $hdrs -ContentType "application/json" -Body $body -TimeoutSec $TimeoutSec -UseBasicParsing
+    $content = $r.Content
+    if ($content -match '(?ms)^data:\s*(\{.*?\})\s*$') {
+      return ($matches[1] | ConvertFrom-Json)
+    }
+    return ($content | ConvertFrom-Json)
+  } catch {
+    return @{ error = @{ message = $_.Exception.Message } }
+  }
+}
+
+function Tool-Text {
+  param($Result)
+  if ($Result.error) { return "ERROR: $($Result.error.message)" }
+  if ($Result.result.content) {
+    return ($Result.result.content | ForEach-Object { $_.text }) -join "`n"
+  }
+  return ($Result | ConvertTo-Json -Depth 5 -Compress)
+}
+
+Write-Host ""
+Write-Host "========================================="
+Write-Host " Smoke 1: Calculator (Win32 a11y)"
+Write-Host "========================================="
+
+$r1 = Call-Tool open_app @{ name = "Calculator" }
+Write-Host "open_app Calculator: $(Tool-Text $r1)"
+Start-Sleep -Seconds 2
+
+$r2 = Call-Tool read_screen @{}
+$tree = Tool-Text $r2
+$hasButtons = ($tree -match 'One|Two|Three|Plus|Equals|Button')
+Write-Host "read_screen lines: $($tree.Split([char]10).Count); named buttons: $hasButtons"
+
+$r3 = Call-Tool invoke_element @{ name = "Two" }
+Write-Host "invoke Two: $(Tool-Text $r3)"
+Start-Sleep -Milliseconds 200
+$null = Call-Tool invoke_element @{ name = "Plus" }
+Start-Sleep -Milliseconds 200
+$null = Call-Tool invoke_element @{ name = "Three" }
+Start-Sleep -Milliseconds 200
+$null = Call-Tool invoke_element @{ name = "Equals" }
+Start-Sleep -Milliseconds 600
+
+$r4 = Call-Tool read_screen @{}
+$treeAfter = Tool-Text $r4
+$saysFive = ($treeAfter -match 'Display is 5|\b5\b')
+Write-Host "Result tree mentions 5: $saysFive"
+if ($saysFive) { Write-Host "PASS  Calculator 2+3=5 via a11y" } else { Write-Host "FAIL  result not in tree" }
+
+Write-Host ""
+Write-Host "========================================="
+Write-Host " Smoke 2: Notepad (Win32 typing)"
+Write-Host "========================================="
+
+$r5 = Call-Tool open_app @{ name = "Notepad" }
+Write-Host "open_app Notepad: $(Tool-Text $r5)"
+Start-Sleep -Seconds 2
+
+$r6 = Call-Tool focus_element @{ name = "Text editor" }
+Write-Host "focus_element Text editor: $(Tool-Text $r6)"
+
+$stamp = (Get-Date -Format 'HHmmss')
+$payload = "clawdcursor v0.9 smoke at $stamp"
+$r7 = Call-Tool type_text @{ text = $payload }
+Write-Host "type_text: $(Tool-Text $r7)"
+Start-Sleep -Milliseconds 500
+
+$r8 = Call-Tool read_screen @{}
+$treeNotepad = Tool-Text $r8
+$contains = ($treeNotepad -match [regex]::Escape($payload.Substring(0, 20)))
+Write-Host "Notepad tree contains typed prefix: $contains"
+if ($contains) { Write-Host "PASS  Notepad type_text via a11y" } else { Write-Host "FAIL  typed text not in tree" }
+
+Write-Host ""
+Write-Host "========================================="
+Write-Host " Smoke 3: Outlook webview detection"
+Write-Host "========================================="
+
+$r9 = Call-Tool open_app @{ name = "Outlook" }
+Write-Host "open_app Outlook: $(Tool-Text $r9)"
+Start-Sleep -Seconds 3
+
+$r10 = Call-Tool detect_webview_apps @{}
+Write-Host "detect_webview_apps: $(Tool-Text $r10)"
+
+$r11 = Call-Tool read_screen @{}
+$outlookTree = Tool-Text $r11
+$emptyTree = ($outlookTree.Length -lt 400 -or $outlookTree -match 'empty a11y tree|custom-canvas|app may be custom')
+Write-Host "Outlook a11y tree size: $($outlookTree.Length) chars; sparse/empty: $emptyTree"
+if ($emptyTree) {
+  Write-Host "REPRO  Outlook a11y is sparse/empty (matches your failed run)"
+  Write-Host "       Agent should have used detect_webview_apps + relaunch_with_cdp"
+} else {
+  Write-Host "NEW    Outlook surfaced a real tree (webview hint may not be needed)"
+}
+
+Write-Host ""
+Write-Host "=== SMOKE TESTS DONE ==="

package/scripts/sync-version.ts

@@ -0,0 +1,178 @@
+/**
+ * Propagate package.json version to every other place it appears.
+ *
+ * Why: SKILL.md frontmatter, the marketing site (docs/index.html), and the
+ * install scripts (docs/install.{sh,ps1}) all carry the version as a
+ * literal. Hand-syncing them on every release is exactly the kind of
+ * task that gets forgotten — leading to a site that advertises the wrong
+ * version or an MCP host registry that lies about which version is in
+ * the npm package.
+ *
+ * Wired into npm's `version` lifecycle hook (see package.json scripts).
+ * `npm version <bump>` flow:
+ *   1. npm bumps package.json
+ *   2. THIS script runs — propagates the new version to all other files
+ *   3. npm stages the version-bump commit (we git-add the propagated files)
+ *   4. npm creates the tag
+ *
+ * Can also be invoked directly as `tsx scripts/sync-version.ts` to verify
+ * everything is in sync without bumping (exits 0 if no changes needed).
+ *
+ * Adding new sites: append a SyncTarget below. Each target uses an
+ * intent-anchored regex (e.g. matched against the surrounding HTML
+ * attribute or YAML key) rather than a global "find any v0.x.y" — this
+ * avoids accidentally rewriting historical version markers in the
+ * CHANGELOG / "What's new" sections.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+const REPO_ROOT = path.resolve(__dirname, '..');
+const PKG = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'package.json'), 'utf-8'));
+const VERSION: string = PKG.version;
+
+if (!/^\d+\.\d+\.\d+/.test(VERSION)) {
+  console.error(`✗ package.json version "${VERSION}" is not a valid semver`);
+  process.exit(1);
+}
+
+interface SyncTarget {
+  file: string;
+  pattern: RegExp;
+  replacement: string;
+  /** Human-readable description of what this target represents. */
+  desc: string;
+  /** When true, a non-matching pattern is NOT an error (illustrative examples
+   *  that may be absent depending on the marketing-site layout). */
+  optional?: boolean;
+}
+
+const TARGETS: SyncTarget[] = [
+  // SKILL.md frontmatter — the version field MCP hosts read for skill metadata.
+  {
+    file: 'SKILL.md',
+    pattern: /^(version:\s*)\d+\.\d+\.\d+([^\d.]|$)/m,
+    replacement: `$1${VERSION}$2`,
+    desc: 'SKILL frontmatter `version:` field',
+  },
+
+  // server.json — the MCP registry manifest (added 2026-06-11). Carries the
+  // version TWICE: the server entry and the npm package pin. A stale value
+  // here makes the official registry advertise an old release.
+  {
+    file: 'server.json',
+    pattern: /("version":\s*")\d+\.\d+\.\d+(")/g,
+    replacement: `$1${VERSION}$2`,
+    desc: 'server.json registry manifest versions (server + npm package)',
+  },
+
+  // .claude-plugin/plugin.json — the Claude Code plugin manifest. Wraps the
+  // same npm release; a stale version here makes the plugin advertise the
+  // wrong version to plugin hosts.
+  {
+    file: '.claude-plugin/plugin.json',
+    pattern: /("version":\s*")\d+\.\d+\.\d+(")/,
+    replacement: `$1${VERSION}$2`,
+    desc: 'Claude Code plugin manifest version',
+  },
+
+  // docs/index.html — marketing site. Several places, all distinct contexts.
+  {
+    file: 'docs/index.html',
+    pattern: /(AGENT-READABLE SUMMARY \(v)\d+\.\d+\.\d+(\))/,
+    replacement: `$1${VERSION}$2`,
+    desc: 'index.html agent-readable summary header',
+  },
+  // NOTE: the <title>, meta description, and og:title are intentionally
+  // VERSION-FREE (clean branding, 2026-06-14 reframe) — the visible version
+  // lives in the hero badge / footer / agent-summary, which ARE synced below.
+  {
+    file: 'docs/index.html',
+    pattern: /(<div class="hero-badge"><div class="pulse"><\/div>\s*v)\d+\.\d+\.\d+/,
+    replacement: `$1${VERSION}`,
+    desc: 'index.html hero badge',
+  },
+  {
+    file: 'docs/index.html',
+    pattern: /(clawd<strong>cursor<\/strong> v)\d+\.\d+\.\d+/,
+    replacement: `$1${VERSION}`,
+    desc: 'index.html footer brand',
+  },
+  // The installer-pin examples — PowerShell + bash. These are illustrative and
+  // the marketing site may render only one (or neither) depending on layout, so
+  // the PowerShell example is OPTIONAL: update it if present, don't error if not.
+  {
+    file: 'docs/index.html',
+    pattern: /(\$env:VERSION='v)\d+\.\d+\.\d+(')/g,
+    replacement: `$1${VERSION}$2`,
+    desc: 'index.html PowerShell install-pin example',
+    optional: true,
+  },
+  {
+    file: 'docs/index.html',
+    pattern: /(\bVERSION=v)\d+\.\d+\.\d+(\b)/g,
+    replacement: `$1${VERSION}$2`,
+    desc: 'index.html bash install-pin example',
+    // Optional for the same reason as the PowerShell example above: the
+    // npm-first install section may render only one pin example (or neither).
+    optional: true,
+  },
+
+  // Installer scripts — header comments that document the example pin.
+  // The runtime VERSION="${VERSION:-main}" default below is intentionally
+  // dynamic (defaults to main branch) and is NOT touched.
+  {
+    file: 'docs/install.sh',
+    pattern: /(# Specify version: VERSION=v)\d+\.\d+\.\d+/,
+    replacement: `$1${VERSION}`,
+    desc: 'install.sh header pin example',
+  },
+  {
+    file: 'docs/install.ps1',
+    pattern: /(# Specify version: \$env:VERSION='v)\d+\.\d+\.\d+(')/,
+    replacement: `$1${VERSION}$2`,
+    desc: 'install.ps1 header pin example',
+  },
+];
+
+let changed = 0;
+const touchedFiles = new Set<string>();
+const errors: string[] = [];
+
+for (const t of TARGETS) {
+  const fp = path.join(REPO_ROOT, t.file);
+  if (!fs.existsSync(fp)) {
+    errors.push(`✗ missing file: ${t.file} (target: ${t.desc})`);
+    continue;
+  }
+  const before = fs.readFileSync(fp, 'utf-8');
+  const after = before.replace(t.pattern, t.replacement);
+  if (before === after) {
+    // Either already at the right version, or the pattern didn't match — both
+    // are non-fatal but the second case is interesting. We can't distinguish
+    // cleanly without re-scanning, so just print a quiet status line.
+    if (!t.pattern.test(after) && !t.optional) {
+      errors.push(`✗ ${t.desc} pattern did not match in ${t.file}`);
+    }
+    continue;
+  }
+  fs.writeFileSync(fp, after);
+  changed++;
+  touchedFiles.add(t.file);
+  console.log(`  ✓ ${t.desc}  →  ${t.file}`);
+}
+
+if (errors.length > 0) {
+  console.error('\nErrors:');
+  for (const e of errors) console.error(`  ${e}`);
+  process.exit(1);
+}
+
+if (changed === 0) {
+  console.log(`All version literals already match v${VERSION}.`);
+  process.exit(0);
+}
+
+console.log(`\nUpdated ${changed} site(s) in ${touchedFiles.size} file(s) to v${VERSION}.`);
+console.log('Files: ' + Array.from(touchedFiles).join(', '));

package/scripts/verify-install.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+/**
+ * verify-install.js — Lightweight post-install verification.
+ *
+ * Checks Node.js version and critical native dependencies.
+ * Runs after `npm install` and before `npm run setup`.
+ * Non-blocking: prints warnings but never fails the install.
+ */
+
+const MIN_NODE_MAJOR = 20;
+
+function check() {
+  let ok = true;
+
+  // ── Node.js version check ──
+  const major = parseInt(process.versions.node.split('.')[0], 10);
+  if (major < MIN_NODE_MAJOR) {
+    console.error(`\n❌ Node.js ${MIN_NODE_MAJOR}+ required (found ${process.versions.node})`);
+    console.error(`   Download: https://nodejs.org/\n`);
+    process.exit(1); // Hard fail — nothing will work
+  }
+  console.log(`✅ Node.js ${process.versions.node}`);
+
+  // ── Critical native dependencies ──
+  const deps = [
+    { name: '@nut-tree-fork/nut-js', label: 'nut-js (desktop automation)' },
+    { name: 'sharp', label: 'sharp (image processing)' },
+  ];
+
+  for (const dep of deps) {
+    try {
+      require(dep.name);
+      console.log(`✅ ${dep.label}`);
+    } catch (err) {
+      ok = false;
+      console.warn(`⚠️  ${dep.label} — failed to load`);
+      if (process.platform === 'win32') {
+        console.warn(`   Fix: npm install --global windows-build-tools`);
+        console.warn(`   Or: Install Visual C++ Build Tools from https://visualstudio.microsoft.com/visual-cpp-build-tools/`);
+      } else if (process.platform === 'darwin') {
+        console.warn(`   Fix: xcode-select --install`);
+      } else {
+        console.warn(`   Fix: sudo apt-get install build-essential libx11-dev`);
+      }
+    }
+  }
+
+  // ── Optional dependencies ──
+  try {
+    require('playwright');
+    console.log(`✅ playwright (browser automation)`);
+  } catch {
+    console.warn(`⚠️  playwright — not installed (browser/CDP features will be limited)`);
+    console.warn(`   Fix: npx playwright install chromium`);
+  }
+
+  // ── macOS native build check ──
+  if (process.platform === 'darwin') {
+    const path = require('path');
+    const fs = require('fs');
+    const appDir = path.join(__dirname, '..', 'native', 'ClawdCursor.app', 'Contents', 'MacOS');
+    const requiredBinaries = ['ClawdCursorHost', 'clawdcursor-helper', 'screenshot-helper', 'permission-check'];
+    const missing = requiredBinaries.filter(b => !fs.existsSync(path.join(appDir, b)));
+    if (missing.length > 0) {
+      console.warn(`⚠️  Native macOS binaries not built: ${missing.join(', ')}`);
+      console.warn(`   Fix: cd native && chmod +x build.sh && ./build.sh`);
+      ok = false;
+    } else {
+      console.log(`✅ Native macOS binaries (ClawdCursor.app)`);
+    }
+  }
+
+  if (ok) {
+    console.log(`\n🐾 All dependencies verified. Run: npm run setup\n`);
+  } else {
+    console.warn(`\n⚠️  Some dependencies have issues. clawdcursor may still work with reduced functionality.`);
+    console.warn(`   Run: npm run setup\n`);
+  }
+}
+
+check();