markupr 2.1.8

package/.claude/commands/review-feedback.md

@@ -0,0 +1,47 @@
+# Review markupr Session
+
+You are reviewing a markupr session -- a structured feedback report with voice transcription and screenshots captured while a developer reviewed their application.
+
+## Instructions
+
+1. **Read the session directory** at: $ARGUMENTS
+   - Read `feedback-report.md` for the full structured feedback with FB-XXX items
+   - Read `metadata.json` for session context (source app, duration, environment)
+   - Read each screenshot in `screenshots/` that is referenced by feedback items -- these are PNG files showing exactly what the user was looking at when they spoke
+   - If `session-recording.webm` exists, note its path (video can't be played in CLI but the screenshots provide the visual context)
+
+2. **Parse each feedback item** (FB-001, FB-002, etc.) and extract:
+   - The severity (Critical / High / Medium / Low) and category (Bug / UX Issue / Suggestion / Performance / Question / General)
+   - The transcribed observation (the blockquote under "What Happened")
+   - Associated screenshot(s) -- READ the image files to see what the user was looking at
+   - The suggested next step from the report
+
+3. **Create an action plan** prioritized by severity:
+   - **Critical/High items first** -- bugs and broken functionality
+   - **Medium items next** -- UX issues and performance problems
+   - **Low items last** -- suggestions and enhancements
+
+4. **For each item, determine the action type:**
+   - Code fix -- identify the file and make the change
+   - UI change -- adjust layout, styling, or component behavior
+   - Documentation -- update docs or add comments
+   - Investigation needed -- reproduce first, then fix
+   - Future enhancement -- note for backlog, no immediate action
+
+5. **Work through items systematically:**
+   - State which FB-XXX item you're addressing
+   - Reference the screenshot to ground your understanding in what the user saw
+   - Make the code change or explain why it should be deferred
+   - After each fix, note: "FB-XXX addressed"
+
+6. **After all items are processed**, provide a summary:
+   - Items addressed with code changes
+   - Items deferred with reasoning
+   - Patterns or architectural concerns noticed across multiple feedback items
+
+## Important Notes
+- Screenshots are visual evidence -- always read them to understand context before acting
+- The user's spoken words (in blockquotes) capture intent and nuance that the severity/category labels alone may miss
+- Treat "Suggested Next Step" as guidance, not a strict instruction -- use your judgment
+- If the report has 0 feedback items, tell the user the session captured no actionable feedback
+- The session directory path is typically copied to the clipboard by markupr when a session ends

package/.eslintrc.json

@@ -0,0 +1,35 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint", "react", "react-hooks"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    }
+  },
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  },
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "react/react-in-jsx-scope": "off",
+    "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn"
+  },
+  "ignorePatterns": ["dist", "node_modules", "release"]
+}

package/.github/CODEOWNERS

@@ -0,0 +1,16 @@
+# =============================================================================
+# CODEOWNERS for markupr (low-noise)
+# =============================================================================
+# Intentionally scoped to runtime/security-critical areas.
+# Dependency/workflow/docs-only PRs are not auto-assigned by CODEOWNERS.
+
+# Core runtime
+/src/main/                  @eddiesanjuan
+/src/renderer/              @eddiesanjuan
+/src/preload/               @eddiesanjuan
+/src/shared/                @eddiesanjuan
+
+# Distribution and security-sensitive files
+electron-builder.yml        @eddiesanjuan
+/build/entitlements*.plist  @eddiesanjuan
+/scripts/notarize.cjs       @eddiesanjuan

package/.github/FUNDING.yml

@@ -0,0 +1 @@
+ko_fi: eddiesanjuan

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,56 @@
+---
+name: Bug Report
+about: Report a bug to help us improve markupr
+title: '[Bug] '
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear and concise description of the bug.
+
+## Steps to Reproduce
+
+1. Go to '...'
+2. Click on '...'
+3. See error '...'
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Screenshots
+
+If applicable, add screenshots to help explain the problem.
+
+## Environment
+
+- **OS**: [e.g., macOS 14.0, Windows 11]
+- **markupr Version**: [e.g., 0.4.0]
+- **Installation Method**: [e.g., DMG, installer, AppImage]
+
+## Logs
+
+<details>
+<summary>Debug Logs</summary>
+
+```
+Paste logs here (Settings > Advanced > Debug Mode to enable)
+```
+
+</details>
+
+## Additional Context
+
+Add any other context about the problem here.
+
+## Checklist
+
+- [ ] I have searched existing issues to ensure this is not a duplicate
+- [ ] I have tried the latest version of markupr
+- [ ] I have included all relevant information above

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,54 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement for markupr
+title: '[Feature] '
+labels: enhancement
+assignees: ''
+---
+
+## Problem Statement
+
+A clear description of the problem you're trying to solve.
+
+**Example**: "I'm always frustrated when I have to manually take screenshots because..."
+
+## Proposed Solution
+
+Describe the feature you'd like to see implemented.
+
+## Alternatives Considered
+
+What other approaches have you thought about?
+
+## Use Case
+
+How would you use this feature in your workflow?
+
+**Example workflow**:
+1. Start recording feedback session
+2. [Your feature would help here]
+3. Export session
+
+## Mockups / Examples
+
+If applicable, add mockups, wireframes, or examples from other tools.
+
+## Additional Context
+
+- How often would you use this feature?
+- Would this benefit other users?
+- Are there any potential downsides?
+
+## Priority
+
+How important is this feature to you?
+
+- [ ] Nice to have - Would improve my workflow
+- [ ] Important - Significantly impacts my productivity
+- [ ] Critical - Can't use markupr effectively without it
+
+## Checklist
+
+- [ ] I have searched existing issues to ensure this is not a duplicate
+- [ ] I have checked the roadmap/documentation for planned features
+- [ ] I am willing to help implement this feature (optional)

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,89 @@
+## Description
+
+Brief description of what this PR does.
+
+## Related Issues
+
+Fixes #(issue number)
+
+<!-- Or use: Closes #, Relates to #, Part of # -->
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Test coverage improvement
+- [ ] Build/CI configuration change
+
+## Changes Made
+
+<!-- List the specific changes made in this PR -->
+
+-
+-
+-
+
+## Screenshots / Videos
+
+<!-- If applicable, add screenshots or videos demonstrating the changes -->
+
+| Before | After |
+|--------|-------|
+|        |       |
+
+## Testing
+
+### How to Test
+
+1.
+2.
+3.
+
+### Test Coverage
+
+- [ ] Unit tests added/updated
+- [ ] Integration tests added/updated
+- [ ] Manual testing completed
+
+### Platforms Tested
+
+- [ ] macOS
+- [ ] Windows
+- [ ] Linux
+
+## Checklist
+
+### Code Quality
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+
+### Testing
+
+- [ ] All tests pass locally (`npm test`)
+- [ ] Linting passes (`npm run lint`)
+- [ ] Type checking passes (`npm run typecheck`)
+- [ ] The app builds successfully (`npm run build`)
+
+### Pre-merge
+
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+- [ ] I have updated the CHANGELOG.md (if applicable)
+
+## Breaking Changes
+
+<!-- If this PR introduces breaking changes, describe them here and what users need to do -->
+
+N/A
+
+## Additional Notes
+
+<!-- Any additional information that reviewers should know -->
+

package/.github/dependabot.yml

@@ -0,0 +1,70 @@
+# =============================================================================
+# Dependabot Configuration for markupr
+# =============================================================================
+# Low-noise defaults:
+# - Monthly cadence
+# - Tight PR caps
+# - Aggressive grouping (minor/patch + majors grouped)
+# =============================================================================
+
+version: 2
+
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      day: "monday"
+      time: "06:00"
+      timezone: "America/Chicago"
+    open-pull-requests-limit: 2
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    labels:
+      - "dependencies"
+      - "npm"
+    allow:
+      - dependency-type: "direct"
+    groups:
+      npm-minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+      npm-major:
+        patterns:
+          - "*"
+        update-types:
+          - "major"
+    ignore:
+      - dependency-name: "electron"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "react"
+        update-types: ["version-update:semver-major"]
+      - dependency-name: "react-dom"
+        update-types: ["version-update:semver-major"]
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      day: "monday"
+      time: "06:00"
+      timezone: "America/Chicago"
+    open-pull-requests-limit: 1
+    commit-message:
+      prefix: "ci"
+      include: "scope"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    groups:
+      github-actions-all:
+        patterns:
+          - "*"
+        update-types:
+          - "major"
+          - "minor"
+          - "patch"

package/.github/workflows/ci.yml

@@ -0,0 +1,184 @@
+# =============================================================================
+# markupr CI Pipeline
+# =============================================================================
+# Runs on every push to main and pull request
+# Matrix build for macOS and Windows with comprehensive validation
+# =============================================================================
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Cancel in-progress runs for the same branch
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  NODE_VERSION: '20'
+
+jobs:
+  # ===========================================================================
+  # Lint & Type Check (fast feedback)
+  # ===========================================================================
+  validate:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Run TypeScript type check
+        run: npm run typecheck
+
+      - name: Audit production dependencies
+        run: npm audit --omit=dev --audit-level=high
+
+  # ===========================================================================
+  # Test Suite
+  # ===========================================================================
+  test:
+    name: Test Suite
+    runs-on: ubuntu-latest
+    needs: validate
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests with coverage
+        run: npm run test:ci
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/lcov.info
+          fail_ci_if_error: false
+          verbose: true
+
+  # ===========================================================================
+  # Build Matrix (macOS & Windows)
+  # ===========================================================================
+  build:
+    name: Build (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-latest, windows-latest]
+        include:
+          - os: macos-latest
+            artifact-name: markupr-macos
+            build-path: release/*.dmg
+          - os: windows-latest
+            artifact-name: markupr-windows
+            build-path: release/*.exe
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      # Cache node_modules for faster builds
+      - name: Cache node_modules
+        uses: actions/cache@v5
+        id: cache-node-modules
+        with:
+          path: node_modules
+          key: ${{ runner.os }}-node-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install dependencies
+        if: steps.cache-node-modules.outputs.cache-hit != 'true'
+        run: npm ci
+
+      # Cache Electron binaries
+      - name: Cache Electron
+        uses: actions/cache@v5
+        with:
+          path: |
+            ~/Library/Caches/electron
+            ~/AppData/Local/electron/Cache
+            ~/.cache/electron
+          key: ${{ runner.os }}-electron-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-electron-
+
+      - name: Build application
+        run: npm run build
+
+      # Build unsigned packages for CI validation (--publish never to skip GH_TOKEN requirement)
+      - name: Package application (unsigned)
+        shell: bash
+        continue-on-error: ${{ matrix.os == 'windows-latest' }}
+        run: |
+          if [ "${{ matrix.os }}" = "macos-latest" ]; then
+            CSC_IDENTITY_AUTO_DISCOVERY=false npx electron-builder --mac --publish never --config electron-builder.yml
+          else
+            npx electron-builder --win --publish never --config electron-builder.yml
+          fi
+        env:
+          CSC_IDENTITY_AUTO_DISCOVERY: false
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v6
+        with:
+          name: ${{ matrix.artifact-name }}
+          path: |
+            release/*.dmg
+            release/*.zip
+            release/*.exe
+            release/*.msi
+          if-no-files-found: warn
+          retention-days: 7
+
+  # ===========================================================================
+  # Build Status Summary
+  # ===========================================================================
+  ci-success:
+    name: CI Success
+    runs-on: ubuntu-latest
+    needs: [validate, test, build]
+    if: always()
+    steps:
+      - name: Check all jobs passed
+        run: |
+          if [ "${{ needs.validate.result }}" != "success" ] || \
+             [ "${{ needs.test.result }}" != "success" ] || \
+             [ "${{ needs.build.result }}" != "success" ]; then
+            echo "One or more jobs failed"
+            exit 1
+          fi
+          echo "All CI jobs passed successfully!"

package/.github/workflows/deploy-landing.yml

@@ -0,0 +1,134 @@
+# GitHub Pages deployment workflow for markupr landing page
+# Automatically deploys site/ to GitHub Pages on push to main
+
+name: Deploy Landing Page
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'site/**'
+      - '.github/workflows/deploy-landing.yml'
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build static site
+        run: |
+          mkdir -p _site
+
+          # Copy current landing page source
+          cp -r site/* _site/
+
+          # Generate sitemap
+          cat > _site/sitemap.xml << 'EOF'
+          <?xml version="1.0" encoding="UTF-8"?>
+          <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+            <url>
+              <loc>https://markupr.com/</loc>
+              <lastmod>$(date +%Y-%m-%d)</lastmod>
+              <changefreq>weekly</changefreq>
+              <priority>1.0</priority>
+            </url>
+          </urlset>
+          EOF
+
+          # Generate robots.txt
+          cat > _site/robots.txt << 'EOF'
+          User-agent: *
+          Allow: /
+          Sitemap: https://markupr.com/sitemap.xml
+          EOF
+
+          # Generate 404 page
+          cat > _site/404.html << 'EOF'
+          <!DOCTYPE html>
+          <html lang="en">
+          <head>
+              <meta charset="UTF-8">
+              <meta name="viewport" content="width=device-width, initial-scale=1.0">
+              <title>404 - Page Not Found | markupr</title>
+              <style>
+                  * { margin: 0; padding: 0; box-sizing: border-box; }
+                  body {
+                      font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
+                      background: #0F0F1A;
+                      color: #E2E8F0;
+                      min-height: 100vh;
+                      display: flex;
+                      align-items: center;
+                      justify-content: center;
+                      text-align: center;
+                      padding: 2rem;
+                  }
+                  .container { max-width: 500px; }
+                  h1 { font-size: 6rem; font-weight: 800; color: #6366F1; margin-bottom: 1rem; }
+                  h2 { font-size: 1.5rem; margin-bottom: 1rem; }
+                  p { color: #94A3B8; margin-bottom: 2rem; }
+                  a {
+                      display: inline-block;
+                      padding: 1rem 2rem;
+                      background: linear-gradient(135deg, #6366F1 0%, #8B5CF6 100%);
+                      color: white;
+                      text-decoration: none;
+                      border-radius: 0.5rem;
+                      font-weight: 600;
+                  }
+                  a:hover { transform: translateY(-2px); box-shadow: 0 4px 14px rgba(99, 102, 241, 0.4); }
+              </style>
+          </head>
+          <body>
+              <div class="container">
+                  <h1>404</h1>
+                  <h2>Page Not Found</h2>
+                  <p>The page you're looking for doesn't exist or has been moved.</p>
+                  <a href="/">Back to Home</a>
+              </div>
+          </body>
+          </html>
+          EOF
+
+          echo "Build completed successfully"
+          ls -la _site/
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: '_site'
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+      - name: Output deployment URL
+        run: |
+          echo "## Deployment Successful! 🚀" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Landing page deployed to: ${{ steps.deployment.outputs.page_url }}" >> $GITHUB_STEP_SUMMARY