@staff0rd/assist 0.133.0 → 0.134.0

package/README.md

@@ -46,6 +46,7 @@ After installation, the `assist` command will be available globally. You can als
 - `/standup` - Summarise recent journal entries as a standup update
 - `/sync` - Sync commands and settings to ~/.claude
 - `/inspect` - Run .NET code inspections on changed files
+- `/screenshot` - Capture a screenshot of a running application window
 - `/seq` - Query Seq logs from a URL or filter expression
 - `/verify` - Run all verification commands in parallel
 - `/transcript-format` - Format meeting transcripts from VTT files
@@ -142,6 +143,7 @@ After installation, the `assist` command will be available globally. You can als
 - `assist seq query <filter> -c <connection>` - Query using a specific connection
 - `assist seq query <filter> --json` - Output raw JSON
 - `assist seq query <filter> -n <count>` - Fetch a specific number of events (default 50)
+- `assist screenshot <process>` - Capture a screenshot of a running application window (e.g. `assist screenshot notepad`). Output directory is configurable via `screenshot.outputDir` (default `./screenshots`)
 - `assist complexity <pattern>` - Analyze a file (all metrics if single match, maintainability if multiple)
 - `assist complexity cyclomatic [pattern]` - Calculate cyclomatic complexity per function
 - `assist complexity halstead [pattern]` - Calculate Halstead metrics per function

package/claude/commands/screenshot.md

@@ -0,0 +1,9 @@
+---
+description: Capture a screenshot of a running application window
+---
+
+Take a screenshot of a running application window. Ask the user which process to capture if not specified.
+
+Run `assist screenshot <process>` where `<process>` is the name of the running process (e.g. notepad, code, chrome).
+
+The screenshot is saved to the configured output directory (default `./screenshots`).

package/claude/settings.json

@@ -46,6 +46,7 @@
 			"Bash(assist ravendb auth list:*)",
 			"Bash(assist seq query:*)",
 			"Bash(assist seq auth list:*)",
+			"Bash(assist screenshot:*)",
 			"Bash(assist roam show-claude-code-icon:*)",
 			"SlashCommand(/next-backlog-item)",
 			"SlashCommand(/verify)",
@@ -83,6 +84,8 @@
 			"SlashCommand(/seq)",
 			"Skill(inspect)",
 			"SlashCommand(/inspect)",
+			"Skill(screenshot)",
+			"SlashCommand(/screenshot)",
 			"WebFetch(domain:staffordwilliams.com)"
 		],
 		"deny": ["Bash(git commit:*)", "Bash(npm run:*)", "Bash(npx assist:*)"]

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.133.0",
+  version: "0.134.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -189,6 +189,9 @@ var assistConfigSchema = z.strictObject({
     ).default([]),
     defaultConnection: z.string().optional()
   }).optional(),
+  screenshot: z.strictObject({
+    outputDir: z.string().default("./screenshots")
+  }).default({ outputDir: "./screenshots" }),
   voice: z.strictObject({
     wakeWords: z.array(z.string()).default(DEFAULT_WAKE_WORDS),
     mic: z.string().optional(),
@@ -1841,14 +1844,14 @@ function flushIfFailed(exitCode, chunks) {
 
 // src/commands/verify/run/runAllEntries.ts
 function runEntry(entry, onComplete) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const child = spawnCommand(entry.fullCommand, entry.cwd, entry.env);
     const chunks = collectOutput(child);
     child.on("close", (code) => {
       const exitCode = code ?? 1;
       flushIfFailed(exitCode, chunks);
       onComplete?.(exitCode);
-      resolve6({ script: entry.name, code: exitCode });
+      resolve7({ script: entry.name, code: exitCode });
     });
   });
 }
@@ -2635,12 +2638,12 @@ function getHtml() {
 
 // src/commands/backlog/web/parseItemBody.ts
 function readBody(req) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     let body = "";
     req.on("data", (chunk) => {
       body += chunk.toString();
     });
-    req.on("end", () => resolve6(body));
+    req.on("end", () => resolve7(body));
     req.on("error", reject);
   });
 }
@@ -3197,12 +3200,12 @@ function hasSubcommands(helpText) {
 // src/commands/permitCliReads/runHelp.ts
 import { exec as exec2 } from "child_process";
 function runHelp(args) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     exec2(
       `${args.join(" ")} --help`,
       { encoding: "utf-8", timeout: 3e4 },
       (_err, stdout, stderr) => {
-        resolve6(stdout || stderr || "");
+        resolve7(stdout || stderr || "");
       }
     );
   });
@@ -6704,7 +6707,7 @@ function getViolations(pattern2, options2 = {}, maxLines = DEFAULT_MAX_LINES) {
 
 // src/commands/refactor/check/index.ts
 function runScript(script, cwd) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const child = spawn3("npm", ["run", script], {
       stdio: "pipe",
       shell: true,
@@ -6718,7 +6721,7 @@ function runScript(script, cwd) {
       output += data.toString();
     });
     child.on("close", (code) => {
-      resolve6({ script, code: code ?? 1, output });
+      resolve7({ script, code: code ?? 1, output });
     });
   });
 }
@@ -7662,9 +7665,9 @@ function createReadlineInterface() {
   });
 }
 function askQuestion(rl, question) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     rl.question(question, (answer) => {
-      resolve6(answer.trim());
+      resolve7(answer.trim());
     });
   });
 }
@@ -8605,7 +8608,7 @@ function extractCode(url, expectedState) {
   return code;
 }
 function waitForCallback(port, expectedState) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const timeout = setTimeout(() => {
       server.close();
       reject(new Error("Authorization timed out after 120 seconds"));
@@ -8622,7 +8625,7 @@ function waitForCallback(port, expectedState) {
         const code = extractCode(url, expectedState);
         respondHtml(res, 200, "Authorization successful!");
         server.close();
-        resolve6(code);
+        resolve7(code);
       } catch (err) {
         respondHtml(res, 400, err.message);
         server.close();
@@ -8953,11 +8956,178 @@ function run2(name, args) {
   );
 }
 
+// src/commands/screenshot/index.ts
+import { execSync as execSync38 } from "child_process";
+import { existsSync as existsSync36, mkdirSync as mkdirSync13, unlinkSync as unlinkSync9, writeFileSync as writeFileSync26 } from "fs";
+import { tmpdir as tmpdir6 } from "os";
+import { join as join37, resolve as resolve5 } from "path";
+import chalk92 from "chalk";
+
+// src/commands/screenshot/captureWindowPs1.ts
+var captureWindowPs1 = `
+param([string]$ProcessName, [string]$OutputPath)
+
+Add-Type -AssemblyName System.Drawing
+
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public class Win32Window {
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool SetProcessDPIAware();
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool IsIconic(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+
+    [DllImport("dwmapi.dll")]
+    public static extern int DwmGetWindowAttribute(
+        IntPtr hwnd, int dwAttribute, out RECT pvAttribute, int cbAttribute);
+
+    [DllImport("user32.dll")]
+    public static extern IntPtr GetDC(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    public static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
+
+    [DllImport("gdi32.dll")]
+    public static extern IntPtr CreateCompatibleDC(IntPtr hdc);
+
+    [DllImport("gdi32.dll")]
+    public static extern IntPtr CreateCompatibleBitmap(IntPtr hdc, int w, int h);
+
+    [DllImport("gdi32.dll")]
+    public static extern IntPtr SelectObject(IntPtr hdc, IntPtr h);
+
+    [DllImport("gdi32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool BitBlt(
+        IntPtr hdc, int x, int y, int cx, int cy,
+        IntPtr hdcSrc, int x1, int y1, uint rop);
+
+    [DllImport("gdi32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool DeleteObject(IntPtr ho);
+
+    [DllImport("gdi32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    public static extern bool DeleteDC(IntPtr hdc);
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct RECT {
+        public int Left;
+        public int Top;
+        public int Right;
+        public int Bottom;
+    }
+}
+"@
+
+# DPI awareness ensures all coordinates are in physical pixels
+[Win32Window]::SetProcessDPIAware() | Out-Null
+
+$procs = Get-Process -Name $ProcessName -ErrorAction SilentlyContinue |
+    Where-Object { $_.MainWindowHandle -ne [IntPtr]::Zero }
+
+if (-not $procs) {
+    Write-Error "No visible window found for process '$ProcessName'"
+    exit 1
+}
+
+$proc = $procs | Select-Object -First 1
+$hwnd = $proc.MainWindowHandle
+
+if ([Win32Window]::IsIconic($hwnd)) {
+    [Win32Window]::ShowWindow($hwnd, 9) | Out-Null   # SW_RESTORE
+    Start-Sleep -Milliseconds 300
+}
+
+# DWMWA_EXTENDED_FRAME_BOUNDS (9) = visible bounds excluding invisible DWM shadow
+$rect = New-Object Win32Window+RECT
+$hr = [Win32Window]::DwmGetWindowAttribute(
+    $hwnd, 9, [ref]$rect,
+    [System.Runtime.InteropServices.Marshal]::SizeOf($rect))
+
+if ($hr -ne 0) {
+    Write-Error "Failed to get window bounds (HRESULT: $hr)"
+    exit 1
+}
+
+$width  = $rect.Right  - $rect.Left
+$height = $rect.Bottom - $rect.Top
+
+if ($width -le 0 -or $height -le 0) {
+    Write-Error "Window has invalid dimensions ($width x $height)"
+    exit 1
+}
+
+# BitBlt from screen DC \u2014 both coords and capture use physical pixels
+$hdcScreen = [Win32Window]::GetDC([IntPtr]::Zero)
+$hdcMem    = [Win32Window]::CreateCompatibleDC($hdcScreen)
+$hBitmap   = [Win32Window]::CreateCompatibleBitmap($hdcScreen, $width, $height)
+$hOld      = [Win32Window]::SelectObject($hdcMem, $hBitmap)
+
+$SRCCOPY = 0x00CC0020
+[Win32Window]::BitBlt($hdcMem, 0, 0, $width, $height,
+    $hdcScreen, $rect.Left, $rect.Top, $SRCCOPY) | Out-Null
+
+$bitmap = [System.Drawing.Image]::FromHbitmap($hBitmap)
+$bitmap.Save($OutputPath, [System.Drawing.Imaging.ImageFormat]::Png)
+$bitmap.Dispose()
+
+[Win32Window]::SelectObject($hdcMem, $hOld) | Out-Null
+[Win32Window]::DeleteObject($hBitmap) | Out-Null
+[Win32Window]::DeleteDC($hdcMem) | Out-Null
+[Win32Window]::ReleaseDC([IntPtr]::Zero, $hdcScreen) | Out-Null
+
+Write-Output $OutputPath
+`;
+
+// src/commands/screenshot/index.ts
+function buildOutputPath(outputDir, processName) {
+  if (!existsSync36(outputDir)) {
+    mkdirSync13(outputDir, { recursive: true });
+  }
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  return resolve5(outputDir, `${processName}-${timestamp}.png`);
+}
+function runPowerShellScript(processName, outputPath) {
+  const scriptPath = join37(tmpdir6(), `assist-screenshot-${Date.now()}.ps1`);
+  writeFileSync26(scriptPath, captureWindowPs1, "utf-8");
+  try {
+    execSync38(
+      `powershell -NoProfile -ExecutionPolicy Bypass -File "${scriptPath}" -ProcessName "${processName}" -OutputPath "${outputPath}"`,
+      { stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8" }
+    );
+  } finally {
+    unlinkSync9(scriptPath);
+  }
+}
+function screenshot(processName) {
+  const config = loadConfig();
+  const outputDir = resolve5(config.screenshot.outputDir);
+  const outputPath = buildOutputPath(outputDir, processName);
+  console.log(chalk92.gray(`Capturing window for process "${processName}" ...`));
+  try {
+    runPowerShellScript(processName, outputPath);
+    console.log(chalk92.green(`Screenshot saved: ${outputPath}`));
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(chalk92.red(`Failed to capture screenshot: ${msg}`));
+    process.exit(1);
+  }
+}
+
 // src/commands/statusLine.ts
-import chalk93 from "chalk";
+import chalk94 from "chalk";
 
 // src/commands/buildLimitsSegment.ts
-import chalk92 from "chalk";
+import chalk93 from "chalk";
 var FIVE_HOUR_SECONDS = 5 * 3600;
 var SEVEN_DAY_SECONDS = 7 * 86400;
 function formatTimeLeft(resetsAt) {
@@ -8980,10 +9150,10 @@ function projectUsage(pct, resetsAt, windowSeconds) {
 function colorizeRateLimit(pct, resetsAt, windowSeconds) {
   const label2 = `${Math.round(pct)}%`;
   const projected = projectUsage(pct, resetsAt, windowSeconds);
-  if (projected == null) return chalk92.green(label2);
-  if (projected > 100) return chalk92.red(label2);
-  if (projected > 75) return chalk92.yellow(label2);
-  return chalk92.green(label2);
+  if (projected == null) return chalk93.green(label2);
+  if (projected > 100) return chalk93.red(label2);
+  if (projected > 75) return chalk93.yellow(label2);
+  return chalk93.green(label2);
 }
 function formatLimit(pct, resetsAt, windowSeconds, fallbackLabel) {
   const timeLabel = resetsAt ? formatTimeLeft(resetsAt) : fallbackLabel;
@@ -9009,14 +9179,14 @@ function buildLimitsSegment(rateLimits) {
 }
 
 // src/commands/statusLine.ts
-chalk93.level = 3;
+chalk94.level = 3;
 function formatNumber(num) {
   return num.toLocaleString("en-US");
 }
 function colorizePercent(pct) {
   const label2 = `${Math.round(pct)}%`;
-  if (pct > 80) return chalk93.red(label2);
-  if (pct > 40) return chalk93.yellow(label2);
+  if (pct > 80) return chalk94.red(label2);
+  if (pct > 40) return chalk94.yellow(label2);
   return label2;
 }
 async function statusLine() {
@@ -9039,7 +9209,7 @@ import { fileURLToPath as fileURLToPath7 } from "url";
 // src/commands/sync/syncClaudeMd.ts
 import * as fs22 from "fs";
 import * as path40 from "path";
-import chalk94 from "chalk";
+import chalk95 from "chalk";
 async function syncClaudeMd(claudeDir, targetBase) {
   const source = path40.join(claudeDir, "CLAUDE.md");
   const target = path40.join(targetBase, "CLAUDE.md");
@@ -9048,12 +9218,12 @@ async function syncClaudeMd(claudeDir, targetBase) {
     const targetContent = fs22.readFileSync(target, "utf-8");
     if (sourceContent !== targetContent) {
       console.log(
-        chalk94.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
+        chalk95.yellow("\n\u26A0\uFE0F  Warning: CLAUDE.md differs from existing file")
       );
       console.log();
       printDiff(targetContent, sourceContent);
       const confirm = await promptConfirm(
-        chalk94.red("Overwrite existing CLAUDE.md?"),
+        chalk95.red("Overwrite existing CLAUDE.md?"),
         false
       );
       if (!confirm) {
@@ -9069,7 +9239,7 @@ async function syncClaudeMd(claudeDir, targetBase) {
 // src/commands/sync/syncSettings.ts
 import * as fs23 from "fs";
 import * as path41 from "path";
-import chalk95 from "chalk";
+import chalk96 from "chalk";
 async function syncSettings(claudeDir, targetBase, options2) {
   const source = path41.join(claudeDir, "settings.json");
   const target = path41.join(targetBase, "settings.json");
@@ -9085,14 +9255,14 @@ async function syncSettings(claudeDir, targetBase, options2) {
     if (mergedContent !== normalizedTarget) {
       if (!options2?.yes) {
         console.log(
-          chalk95.yellow(
+          chalk96.yellow(
             "\n\u26A0\uFE0F  Warning: settings.json differs from existing file"
           )
         );
         console.log();
         printDiff(targetContent, mergedContent);
         const confirm = await promptConfirm(
-          chalk95.red("Overwrite existing settings.json?"),
+          chalk96.red("Overwrite existing settings.json?"),
           false
         );
         if (!confirm) {
@@ -9129,7 +9299,7 @@ function syncCommands(claudeDir, targetBase) {
 }
 
 // src/commands/update.ts
-import { execSync as execSync38 } from "child_process";
+import { execSync as execSync39 } from "child_process";
 import * as path43 from "path";
 function isGlobalNpmInstall(dir) {
   try {
@@ -9137,7 +9307,7 @@ function isGlobalNpmInstall(dir) {
     if (resolved.split(path43.sep).includes("node_modules")) {
       return true;
     }
-    const globalPrefix = execSync38("npm prefix -g", { stdio: "pipe" }).toString().trim();
+    const globalPrefix = execSync39("npm prefix -g", { stdio: "pipe" }).toString().trim();
     return resolved.toLowerCase().startsWith(path43.resolve(globalPrefix).toLowerCase());
   } catch {
     return false;
@@ -9148,18 +9318,18 @@ async function update() {
   console.log(`Assist is installed at: ${installDir}`);
   if (isGitRepo(installDir)) {
     console.log("Detected git repo installation, pulling latest...");
-    execSync38("git pull", { cwd: installDir, stdio: "inherit" });
+    execSync39("git pull", { cwd: installDir, stdio: "inherit" });
     console.log("Installing dependencies...");
-    execSync38("npm i", { cwd: installDir, stdio: "inherit" });
+    execSync39("npm i", { cwd: installDir, stdio: "inherit" });
     console.log("Building...");
-    execSync38("npm run build", { cwd: installDir, stdio: "inherit" });
+    execSync39("npm run build", { cwd: installDir, stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync38("assist sync", { stdio: "inherit" });
+    execSync39("assist sync", { stdio: "inherit" });
   } else if (isGlobalNpmInstall(installDir)) {
     console.log("Detected global npm installation, updating...");
-    execSync38("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
+    execSync39("npm i -g @staff0rd/assist@latest", { stdio: "inherit" });
     console.log("Syncing commands...");
-    execSync38("assist sync", { stdio: "inherit" });
+    execSync39("assist sync", { stdio: "inherit" });
   } else {
     console.error(
       "Could not determine installation method. Expected a git repo or global npm install."
@@ -9196,6 +9366,7 @@ program.command("notify").description(
   "Show notification from Claude Code hook (reads JSON from stdin)"
 ).action(notify);
 program.command("update").description("Update assist to the latest version and sync commands").action(update);
+program.command("screenshot").description("Capture a screenshot of a running application window").argument("<process>", "Name of the running process (e.g. notepad, code)").action(screenshot);
 registerCliHook(program);
 registerJira(program);
 registerPrs(program);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.133.0",
+	"version": "0.134.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {