markupr 2.6.3 → 2.6.5

package/README.md

@@ -2,7 +2,7 @@
   <img src="src/renderer/assets/logo.svg" alt="markupR" width="80" height="80">
 </p>
 
-<h1 align="center">markupr</h1>
+<h1 align="center">markupR</h1>
 
 <p align="center">
   <strong>Record your screen. Say what's wrong. Your AI agent fixes it.</strong>
@@ -18,7 +18,7 @@
 
 <p align="center">
   <a href="#quick-start">Quick Start</a> &middot;
-  <a href="#why-markupr">Why markupr</a> &middot;
+  <a href="#why-markupR">Why markupR</a> &middot;
   <a href="#mcp-server">MCP Server</a> &middot;
   <a href="#cli">CLI</a> &middot;
   <a href="#integrations">Integrations</a> &middot;
@@ -27,7 +27,7 @@
 
 ---
 
-<!-- hero-screenshot: Replace with an actual screenshot or GIF of markupr in action -->
+<!-- hero-screenshot: Replace with an actual screenshot or GIF of markupR in action -->
 
 ## The Problem
 
@@ -35,7 +35,7 @@ AI coding agents can't see your screen. When you find a bug, you context-switch
 
 ## The Solution
 
-markupr records your screen while you narrate what's wrong. When you stop, it runs an intelligent pipeline that correlates your transcript timestamps with the video to extract the right frames at the right moments -- then stitches everything into structured Markdown your AI agent can act on immediately.
+markupR records your screen while you narrate what's wrong. When you stop, it runs an intelligent pipeline that correlates your transcript timestamps with the video to extract the right frames at the right moments -- then stitches everything into structured Markdown your AI agent can act on immediately.
 
 - **Record** -- press a hotkey, talk through what you see
 - **Process** -- Whisper transcribes, ffmpeg extracts frames at the exact moments you described
@@ -65,7 +65,7 @@ Download from [markupr.com](https://markupr.com) or [GitHub Releases](https://gi
 
 No API keys required. Local Whisper transcription works out of the box.
 
-## Why markupr?
+## Why markupR?
 
 **Local-first.** Whisper runs on your device. Your recordings, transcripts, and screenshots never leave your machine. No cloud dependency, no account required.
 
@@ -99,7 +99,7 @@ Each screenshot is extracted from the exact video frame matching your narration
 
 ## MCP Server
 
-Give your AI coding agent eyes and ears. Add markupr as an MCP server and it can capture screenshots, record your screen with voice, and receive structured reports -- all mid-conversation.
+Give your AI coding agent eyes and ears. Add markupR as an MCP server and it can capture screenshots, record your screen with voice, and receive structured reports -- all mid-conversation.
 
 ### Setup
 
@@ -108,7 +108,7 @@ Give your AI coding agent eyes and ears. Add markupr as an MCP server and it can
 ```json
 {
   "mcpServers": {
-    "markupr": {
+    "markupR": {
       "command": "npx",
       "args": ["-y", "markupr-mcp"]
     }
@@ -159,32 +159,32 @@ npm install -g markupr
 
 ### Commands
 
-**`markupr analyze <video>`** -- Process a screen recording into structured Markdown.
+**`markupR analyze <video>`** -- Process a screen recording into structured Markdown.
 
 ```bash
-markupr analyze ./bug-demo.mov
-markupr analyze ./recording.mov --output ./reports
-markupr analyze ./recording.mov --template github-issue
-markupr analyze ./recording.mov --no-frames  # transcript only
+markupR analyze ./bug-demo.mov
+markupR analyze ./recording.mov --output ./reports
+markupR analyze ./recording.mov --template github-issue
+markupR analyze ./recording.mov --no-frames  # transcript only
 ```
 
-**`markupr watch [directory]`** -- Watch for new recordings and auto-process them.
+**`markupR watch [directory]`** -- Watch for new recordings and auto-process them.
 
 ```bash
-markupr watch ~/Desktop --output ./reports
+markupR watch ~/Desktop --output ./reports
 ```
 
-**`markupr push github <report>`** -- Create GitHub issues from a feedback report.
+**`markupR push github <report>`** -- Create GitHub issues from a feedback report.
 
 ```bash
-markupr push github ./report.md --repo myorg/myapp
-markupr push github ./report.md --repo myorg/myapp --dry-run
+markupR push github ./report.md --repo myorg/myapp
+markupR push github ./report.md --repo myorg/myapp --dry-run
 ```
 
-**`markupr push linear <report>`** -- Create Linear issues from a feedback report.
+**`markupR push linear <report>`** -- Create Linear issues from a feedback report.
 
 ```bash
-markupr push linear ./report.md --team ENG
+markupR push linear ./report.md --team ENG
 ```
 
 ### Output Templates
@@ -200,7 +200,7 @@ markupr push linear ./report.md --team ENG
 
 ### GitHub Action
 
-Run markupr in CI to get visual feedback on pull requests:
+Run markupR in CI to get visual feedback on pull requests:
 
 ```yaml
 - uses: eddiesanjuan/markupr-action@v1
@@ -244,7 +244,7 @@ For architecture details, see [CLAUDE.md](CLAUDE.md).
 
 ```bash
 git clone https://github.com/eddiesanjuan/markupr.git
-cd markupr
+cd markupR
 npm install
 npm run dev
 ```

package/dist/cli/index.mjs

@@ -111,7 +111,7 @@ var init_LinearIssueCreator = __esm({
         this.token = token;
       }
       /**
-       * Push a markupr report to Linear, creating one issue per feedback item.
+       * Push a markupR report to Linear, creating one issue per feedback item.
        */
       async pushReport(reportPath, options) {
         const markdown = await readFile3(reportPath, "utf-8");
@@ -275,7 +275,7 @@ var init_LinearIssueCreator = __esm({
        * Build markdown description for a Linear issue from a feedback item.
        */
       buildIssueDescription(item) {
-        let desc = `## markupr Feedback: ${item.id}
+        let desc = `## markupR Feedback: ${item.id}
 
 `;
         desc += `**Severity:** ${item.severity}
@@ -310,7 +310,7 @@ ${item.suggestedAction}
         }
         desc += `
 ---
-*Created by [markupr](https://markupr.com)*`;
+*Created by [markupR](https://markupr.com)*`;
         return desc;
       }
       /**
@@ -363,9 +363,9 @@ var init_types2 = __esm({
       Low: { name: "priority: low", color: "0e8a16", description: "Low priority" }
     };
     MARKUPR_LABEL = {
-      name: "markupr",
+      name: "markupR",
       color: "6f42c1",
-      description: "Created from markupr feedback session"
+      description: "Created from markupR feedback session"
     };
   }
 });
@@ -504,7 +504,7 @@ function formatIssueBody(item, reportPath) {
     body += `### Screenshots
 
 `;
-    body += `_${item.screenshotPaths.length} screenshot(s) captured \u2014 see the markupr report for images._
+    body += `_${item.screenshotPaths.length} screenshot(s) captured \u2014 see the markupR report for images._
 
 `;
   }
@@ -522,7 +522,7 @@ function formatIssueBody(item, reportPath) {
     body += `_Source: \`${reportPath}\`_
 `;
   }
-  body += `_Created by [markupr](https://markupr.com)_
+  body += `_Created by [markupR](https://markupr.com)_
 `;
   return body;
 }
@@ -562,7 +562,7 @@ async function pushToGitHub(options) {
   const markdown = await readFile4(reportPath, "utf-8");
   let items = parseMarkuprReport(markdown);
   if (items.length === 0) {
-    throw new Error("No feedback items found in the report. Is this a valid markupr report?");
+    throw new Error("No feedback items found in the report. Is this a valid markupR report?");
   }
   if (filterIds && filterIds.length > 0) {
     const filterSet = new Set(filterIds.map((id) => id.toUpperCase()));
@@ -1120,13 +1120,13 @@ var MarkdownGeneratorImpl = class {
     const filename = this.generateFilename(projectName, session.startTime);
     if (items.length === 0) {
       const content2 = `# ${projectName} Feedback Report
-> Generated by markupr on ${timestamp}
+> Generated by markupR on ${timestamp}
 > Duration: ${duration}
 
 _No feedback items were captured during this session._
 
 ---
-*Generated by [markupr](https://markupr.com)*
+*Generated by [markupR](https://markupr.com)*
 ${REPORT_SUPPORT_LINE}
 `;
       return {
@@ -1147,7 +1147,7 @@ ${REPORT_SUPPORT_LINE}
     const highImpactCount = (severityCounts.Critical || 0) + (severityCounts.High || 0);
     const platform2 = session.metadata?.os || process?.platform || "Unknown";
     let content = `# ${projectName} Feedback Report
-> Generated by markupr on ${timestamp}
+> Generated by markupR on ${timestamp}
 > Duration: ${duration} | Items: ${items.length} | Screenshots: ${screenshotCount}
 
 ## Session Overview
@@ -1244,7 +1244,7 @@ _No screenshot captured for this item._
 `;
     content += `
 ---
-*Generated by [markupr](https://markupr.com)*
+*Generated by [markupR](https://markupr.com)*
 ${REPORT_SUPPORT_LINE}
 `;
     return {
@@ -1277,7 +1277,7 @@ ${REPORT_SUPPORT_LINE}
     const sessionDuration = transcriptSegments.length > 0 ? this.formatDuration(
       (transcriptSegments[transcriptSegments.length - 1].endTime - transcriptSegments[0].startTime) * 1e3
     ) : "0:00";
-    let md = `# markupr Session \u2014 ${sessionTimestamp}
+    let md = `# markupR Session \u2014 ${sessionTimestamp}
 `;
     md += `> Segments: ${transcriptSegments.length} | Frames: ${extractedFrames.length} | Duration: ${sessionDuration}
 
@@ -1308,11 +1308,17 @@ ${REPORT_SUPPORT_LINE}
           md += `![Frame at ${frameTimestamp}](${relativePath})
 
 `;
+          const contextLine = this.formatCaptureContextLine(frame.captureContext);
+          if (contextLine) {
+            md += `> ${contextLine}
+
+`;
+          }
         }
       }
     }
     md += `---
-*Generated by [markupr](https://markupr.com)*
+*Generated by [markupR](https://markupr.com)*
 ${REPORT_SUPPORT_LINE}
 `;
     return md;
@@ -1359,6 +1365,16 @@ ${REPORT_SUPPORT_LINE}
     }
     return path.relative(sessionDir, framePath);
   }
+  formatCaptureContextLine(context) {
+    if (!context) {
+      return void 0;
+    }
+    const cursor = context.cursor ? `Cursor: ${Math.round(context.cursor.x)}, ${Math.round(context.cursor.y)}` : void 0;
+    const app = context.activeWindow?.appName || context.activeWindow?.sourceName;
+    const focus = context.focusedElement?.textPreview || context.focusedElement?.label || context.focusedElement?.role;
+    const parts = [cursor, app ? `App: ${app}` : void 0, focus ? `Focus: ${focus}` : void 0].filter((part) => Boolean(part));
+    return parts.length ? parts.join(" | ") : void 0;
+  }
   /**
    * Format a timestamp in seconds to M:SS format for post-process output.
    * Examples: 0 -> "0:00", 15.3 -> "0:15", 125 -> "2:05"
@@ -2307,7 +2323,7 @@ var markdownTemplate = {
     const { transcriptSegments, extractedFrames } = result;
     const sessionTimestamp = formatDate(new Date(timestamp ?? Date.now()));
     const sessionDuration = computeSessionDuration(transcriptSegments);
-    let md = `# markupr Session \u2014 ${sessionTimestamp}
+    let md = `# markupR Session \u2014 ${sessionTimestamp}
 `;
     md += `> Segments: ${transcriptSegments.length} | Frames: ${extractedFrames.length} | Duration: ${sessionDuration}
 
@@ -2338,11 +2354,20 @@ var markdownTemplate = {
           md += `![Frame at ${frameTimestamp}](${relativePath})
 
 `;
+          const cursor = frame.captureContext?.cursor ? `Cursor: ${Math.round(frame.captureContext.cursor.x)}, ${Math.round(frame.captureContext.cursor.y)}` : void 0;
+          const app = frame.captureContext?.activeWindow?.appName || frame.captureContext?.activeWindow?.sourceName;
+          const focus = frame.captureContext?.focusedElement?.textPreview || frame.captureContext?.focusedElement?.label || frame.captureContext?.focusedElement?.role;
+          const contextLine = [cursor, app ? `App: ${app}` : void 0, focus ? `Focus: ${focus}` : void 0].filter(Boolean).join(" | ");
+          if (contextLine) {
+            md += `> ${contextLine}
+
+`;
+          }
         }
       }
     }
     md += `---
-*Generated by [markupr](https://markupr.com)*
+*Generated by [markupR](https://markupr.com)*
 ${REPORT_SUPPORT_LINE2}
 `;
     return { content: md, fileExtension: ".md" };
@@ -2360,7 +2385,7 @@ var jsonTemplate = {
     const segmentFrameMap = mapFramesToSegments(transcriptSegments, extractedFrames);
     const output = {
       version: "1.0",
-      generator: "markupr",
+      generator: "markupR",
       timestamp: new Date(timestamp ?? Date.now()).toISOString(),
       summary: {
         segments: transcriptSegments.length,
@@ -2377,7 +2402,8 @@ var jsonTemplate = {
           frames: frames.map((f) => ({
             path: computeRelativeFramePath(f.path, sessionDir),
             timestamp: f.timestamp,
-            reason: f.reason
+            reason: f.reason,
+            captureContext: f.captureContext
           }))
         };
       })
@@ -2402,7 +2428,7 @@ var githubIssueTemplate = {
     let md = `## Feedback Report
 
 `;
-    md += `> Captured by [markupr](https://markupr.com) on ${sessionTimestamp}
+    md += `> Captured by [markupR](https://markupr.com) on ${sessionTimestamp}
 `;
     md += `> ${transcriptSegments.length} segments | ${extractedFrames.length} frames | Duration: ${duration}
 
@@ -2452,7 +2478,7 @@ var githubIssueTemplate = {
 `;
     }
     md += `---
-_Generated by [markupr](https://markupr.com)_
+_Generated by [markupR](https://markupr.com)_
 `;
     return { content: md, fileExtension: ".md" };
   }
@@ -2512,7 +2538,7 @@ var linearTemplate = {
       }
     }
     md += `---
-_Captured by [markupr](https://markupr.com)_
+_Captured by [markupR](https://markupr.com)_
 `;
     return { content: md, fileExtension: ".md" };
   }
@@ -2586,7 +2612,7 @@ ${segment.text}
       }
     }
     content += `----
-_Generated by [markupr|https://markupr.com]_
+_Generated by [markupR|https://markupr.com]_
 `;
     return { content, fileExtension: ".jira" };
   }
@@ -2668,8 +2694,15 @@ var CLIPipeline = class _CLIPipeline {
     const result = {
       transcriptSegments: segments,
       extractedFrames,
-      reportPath: this.options.outputDir
+      reportPath: this.options.outputDir,
+      captureContexts: this.normalizeCaptureContexts(this.options.captureContexts || [])
     };
+    if (result.captureContexts && result.captureContexts.length > 0 && result.extractedFrames.length > 0) {
+      result.extractedFrames = this.attachCaptureContextsToFrames(
+        result.extractedFrames,
+        result.captureContexts
+      );
+    }
     let reportContent;
     let reportExtension = ".md";
     const templateName = this.options.template;
@@ -2755,6 +2788,38 @@ var CLIPipeline = class _CLIPipeline {
       this.activeProcesses.add(child);
     });
   }
+  normalizeCaptureContexts(contexts) {
+    return contexts.filter((context) => Number.isFinite(context.recordedAt)).slice().sort((a, b) => a.recordedAt - b.recordedAt);
+  }
+  attachCaptureContextsToFrames(frames, contexts) {
+    const earliestContext = contexts[0]?.recordedAt;
+    if (!Number.isFinite(earliestContext)) {
+      return frames;
+    }
+    const maxDistanceMs = 5e3;
+    return frames.map((frame) => {
+      const frameAtMs = Number(earliestContext) + Math.round(frame.timestamp * 1e3);
+      let bestMatch;
+      let bestDistance = Number.POSITIVE_INFINITY;
+      for (const context of contexts) {
+        const distance = Math.abs(frameAtMs - context.recordedAt);
+        if (distance < bestDistance) {
+          bestDistance = distance;
+          bestMatch = context;
+        }
+        if (context.recordedAt > frameAtMs && distance > bestDistance) {
+          break;
+        }
+      }
+      if (!bestMatch || bestDistance > maxDistanceMs) {
+        return frame;
+      }
+      return {
+        ...frame,
+        captureContext: bestMatch
+      };
+    });
+  }
   /**
    * Validate the video file is a real, non-empty file with a video stream.
    */
@@ -3304,7 +3369,7 @@ async function checkNodeVersion() {
       name: "Node.js",
       status: "warn",
       message: `Unknown version: ${version}`,
-      hint: "markupr requires Node.js >= 18.0.0"
+      hint: "markupR requires Node.js >= 18.0.0"
     };
   }
   const [major] = parsed;
@@ -3319,7 +3384,7 @@ async function checkNodeVersion() {
     name: "Node.js",
     status: "fail",
     message: `${version} is too old`,
-    hint: "markupr requires Node.js >= 18.0.0. Upgrade at https://nodejs.org"
+    hint: "markupR requires Node.js >= 18.0.0. Upgrade at https://nodejs.org"
   };
 }
 async function checkFfmpeg() {
@@ -3368,7 +3433,7 @@ async function checkWhisperModel() {
       status: "warn",
       message: "No models directory found",
       hint: `Models directory: ${modelsDir}
-Download a model via the markupr desktop app, or manually place a ggml-*.bin file there`
+Download a model via the markupR desktop app, or manually place a ggml-*.bin file there`
     };
   }
   const model = findWhisperModel(modelsDir);
@@ -3378,7 +3443,7 @@ Download a model via the markupr desktop app, or manually place a ggml-*.bin fil
       status: "warn",
       message: "No model files found",
       hint: `Models directory: ${modelsDir}
-Download a model via the markupr desktop app, or manually place a ggml-*.bin file there`
+Download a model via the markupR desktop app, or manually place a ggml-*.bin file there`
     };
   }
   return {
@@ -3444,7 +3509,7 @@ async function checkDiskSpace() {
                   name: "Disk space",
                   status: "warn",
                   message: `${availableGB.toFixed(1)} GB available (low)`,
-                  hint: "markupr recordings and output need disk space. Free up some space if you plan to record long sessions"
+                  hint: "markupR recordings and output need disk space. Free up some space if you plan to record long sessions"
                 };
               }
               return {
@@ -3558,7 +3623,7 @@ async function runInit(options) {
 }
 
 // src/cli/index.ts
-var VERSION = true ? "2.6.3" : "0.0.0-dev";
+var VERSION = true ? "2.6.5" : "0.0.0-dev";
 var SYMBOLS = {
   check: "\u2714",
   // checkmark
@@ -3577,7 +3642,7 @@ var SYMBOLS = {
 };
 function banner() {
   console.log();
-  console.log(`  markupr v${VERSION} ${SYMBOLS.bullet} CLI Mode`);
+  console.log(`  markupR v${VERSION} ${SYMBOLS.bullet} CLI Mode`);
   console.log(`  ${SYMBOLS.line.repeat(40)}`);
   console.log();
 }
@@ -3762,7 +3827,7 @@ program.command("watch").description("Watch a directory for new recordings and a
     process.exit(EXIT_SYSTEM_ERROR);
   }
 });
-program.command("doctor").description("Check your environment for markupr dependencies and configuration").action(async () => {
+program.command("doctor").description("Check your environment for markupR dependencies and configuration").action(async () => {
   banner();
   step("Checking environment...");
   console.log();
@@ -3786,16 +3851,16 @@ program.command("doctor").description("Check your environment for markupr depend
   console.log(`  ${result.passed} passed, ${result.warned} warnings, ${result.failed} failed`);
   console.log();
   if (result.failed > 0) {
-    fail("Some required checks failed. Fix them to use markupr.");
+    fail("Some required checks failed. Fix them to use markupR.");
     process.exit(EXIT_USER_ERROR);
   } else if (result.warned > 0) {
-    success("markupr is ready (some optional features are not configured).");
+    success("markupR is ready (some optional features are not configured).");
   } else {
-    success("markupr is fully configured and ready to go!");
+    success("markupR is fully configured and ready to go!");
   }
   console.log();
 });
-program.command("init").description("Create a .markupr.json config file in the current project").option("--output <dir>", "Output directory for feedback sessions", "./markupr-output").option("--no-gitignore", "Skip updating .gitignore").option("--force", "Overwrite existing config file", false).action(async (options) => {
+program.command("init").description("Create a markupR project config file (.markupr.json) in the current project").option("--output <dir>", "Output directory for feedback sessions", "./markupr-output").option("--no-gitignore", "Skip updating .gitignore").option("--force", "Overwrite existing config file", false).action(async (options) => {
   banner();
   const result = await runInit({
     directory: process.cwd(),
@@ -3811,17 +3876,17 @@ program.command("init").description("Create a .markupr.json config file in the c
   }
   success(`Created ${result.configPath}`);
   if (result.gitignoreUpdated) {
-    success("Updated .gitignore with markupr output directory");
+    success("Updated .gitignore with markupR output directory");
   }
   console.log();
   step("Next steps:");
   console.log("    1. Run `markupr doctor` to verify your environment");
-  console.log("    2. Record a session with the markupr desktop app or screen recorder");
+  console.log("    2. Record a session with the markupR desktop app or screen recorder");
   console.log("    3. Run `markupr analyze <video-file>` to generate a feedback report");
   console.log();
 });
 var pushCmd = program.command("push").description("Push feedback to external services");
-pushCmd.command("linear").description("Create Linear issues from a markupr feedback report").argument("<report>", "Path to the markupr markdown report").requiredOption("--team <key>", "Linear team key (e.g., ENG, DES)").option("--token <token>", "Linear API key (prefer LINEAR_API_KEY env var)").option("--project <name>", "Linear project name to assign issues to").option("--dry-run", "Show what would be created without creating anything", false).action(async (report, options) => {
+pushCmd.command("linear").description("Create Linear issues from a markupR feedback report").argument("<report>", "Path to the markupR markdown report").requiredOption("--team <key>", "Linear team key (e.g., ENG, DES)").option("--token <token>", "Linear API key (prefer LINEAR_API_KEY env var)").option("--project <name>", "Linear project name to assign issues to").option("--dry-run", "Show what would be created without creating anything", false).action(async (report, options) => {
   banner();
   const reportPath = resolve3(report);
   if (!existsSync7(reportPath)) {
@@ -3892,7 +3957,7 @@ pushCmd.command("linear").description("Create Linear issues from a markupr feedb
     process.exit(EXIT_USER_ERROR);
   }
 });
-pushCmd.command("github").description("Create GitHub issues from a markupr feedback report").argument("<report>", "Path to the markupr markdown report").requiredOption("--repo <owner/repo>", "Target GitHub repository (e.g., myorg/myapp)").option("--token <token>", "GitHub token (prefer GITHUB_TOKEN env var or gh auth login)").option("--items <ids...>", "Specific FB-XXX item IDs to push (default: all)").option("--dry-run", "Show what would be created without creating anything", false).action(async (report, options) => {
+pushCmd.command("github").description("Create GitHub issues from a markupR feedback report").argument("<report>", "Path to the markupR markdown report").requiredOption("--repo <owner/repo>", "Target GitHub repository (e.g., myorg/myapp)").option("--token <token>", "GitHub token (prefer GITHUB_TOKEN env var or gh auth login)").option("--items <ids...>", "Specific FB-XXX item IDs to push (default: all)").option("--dry-run", "Show what would be created without creating anything", false).action(async (report, options) => {
   banner();
   const reportPath = resolve3(report);
   if (!existsSync7(reportPath)) {