fix: add cursor-dev-path.sh for VS Code tasks; link deploy docs

.cursor/skills/local-handbook/.gitignore

@@ -0,0 +1,3 @@
+.DS_Store
+.claude/
+.remember/

.cursor/skills/local-handbook/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: local-handbook
+description: >-
+  Personal playbook (handbook v2, 2026-04). Before substantial edits, debugging,
+  ambiguous scope, or multi-step work: read logic.md then memory.md. User’s
+  explicit Cursor instructions override this skill when they conflict. Append
+  memory.md when the user states a durable preference or corrects a mistake
+  that should persist.
+---
+
+# Local handbook
+
+Companion files turn generic model behavior into **repeatable, verifiable** work on this machine and in mirrored repos.
+
+## Files
+
+| File | Read for |
+|------|-----------|
+| `logic.md` | Reasoning, verification gates, safety, git/MCP habits. |
+| `memory.md` | Facts that should survive across sessions (paths, remotes, prefs). |
+| `config/` | Versioned **MCP** + **Cursor** settings snapshots; see `config/README.md`. |
+| `scripts/apply-machine-config.sh` | Copies `config/mcp*.json` to `~/.claude` and refreshes `~/.cursor/mcp.json` symlink. |
+
+## When this skill applies
+
+- Implementing or refactoring **non-trivial** behavior.
+- Debugging failures, flaky tests, or unclear stack traces.
+- Touching **auth, payments, migrations, deploy**, or anything irreversible without an explicit green light.
+- The user’s ask is **ambiguous** — clarify briefly, then proceed with stated assumptions.
+
+## Boot checklist (do in order)
+
+1. Skim **`memory.md`** for this scope (global vs repo section).
+2. If the repo has **`AGENTS.md`**, **`CLAUDE.md`**, or **`SESSION.md`**, read the relevant one before large edits.
+3. Choose the **narrowest** verify command that matches the change (see repo `memory.md` where listed).
+4. After edits, **run** that command; report failures with evidence, not guesses.
+
+## Progressive disclosure
+
+- **Project rules win** over this handbook when they conflict.
+- Prefer **existing patterns** in the codebase over new abstractions unless the task requires them.
+- Use **MCP tools** when configured and they reduce ambiguity (docs, tickets, CI); handle tool errors without pretending success.
+
+## Maintenance
+
+- Keep `memory.md` **short** (bullets, not essays). Move long narratives to project `CLAUDE.md` / `AGENTS.md`.
+- Keep `logic.md` about **process**, not secrets or one-off ticket dumps.

.cursor/skills/local-handbook/config/README.md

@@ -0,0 +1,25 @@
+# Machine config snapshots
+
+Versioned copies of MCP and Cursor user settings from this machine. Env values use `${VAR}` placeholders only; keep secrets in `~/.env.keys` or provider dashboards.
+
+## Restore MCP (and Cursor symlink)
+
+From the repo root:
+
+```bash
+bash scripts/apply-machine-config.sh
+```
+
+## Cursor settings
+
+`cursor-user-settings.json` is a full export for diffing or manual merge into `~/Library/Application Support/Cursor/User/settings.json`. Prefer merging selective keys in the editor over blind overwrite.
+
+## zsh PATH
+
+Ensure Homebrew precedes user bins (matches live `~/.zshrc`):
+
+```sh
+export PATH="/opt/homebrew/bin:$HOME/bin:$HOME/go/bin:$HOME/.local/bin:$HOME/Library/Python/3.9/bin:$PATH"
+```
+
+Place this in the Path block after the zsh-only guard at the top of `~/.zshrc`.

.cursor/skills/local-handbook/config/cursor-user-settings.json

@@ -0,0 +1,124 @@
+{
+    "python.defaultInterpreterPath": "/opt/homebrew/bin/python3.12",
+    "window.autoDetectColorScheme": true,
+    "git.openRepositoryInParentFolders": "always",
+    "cursor.terminal.usePreviewBox": true,
+    "cursor.cpp.enablePartialAccepts": true,
+    "cursor.composer.shouldChimeAfterChatFinishes": true,
+    "cursor.general.glassShowWarningNotifications": true,
+    "remote.SSH.remotePlatform": {
+        "cortexvps": "linux"
+    },
+    "cursor.mcp.enabled": true,
+    "cursor.tabs.enabled": true,
+    "cursor.sentiment.enabled": true,
+    "cursor.workspace.enabled": true,
+    "cursor.context.clearOnNewConversation": false,
+    "cursor.modelFactory.automatedTaskModel": "claude-4-sonnet",
+    "cursor.codeCompletion.enableCodeSnippets": true,
+    "cursor.docGeneration.enabled": true,
+    "cursor.docGeneration.includeReferences": true,
+    "editor.inlineSuggest.enabled": true,
+    "editor.fontSize": 13,
+    "editor.tabSize": 2,
+    "editor.formatOnSave": true,
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "[typescript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[typescriptreact]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "security.workspace.trust.enabled": true,
+    "security.workspace.trust.startupPrompt": true,
+    "telemetry.telemetryLevel": "off",
+    "updates.check": false,
+    "git.enableSmartCommit": true,
+    "git.conflictDecoration": "dual",
+    "diffEditor.ignoreTrimWhitespace": true,
+    "files.associations": {
+        "*.env.local": "shellscript"
+    },
+    "terminal.integrated.shellIntegration.enabled": true,
+    "terminal.integrated.env.osx": {
+        "FIG_NEW_SESSION": "0",
+        "PATH": "/opt/homebrew/bin:/opt/homebrew/sbin:/Users/adrianstanca/.local/bin:${env:PATH}"
+    },
+    "files.watcherExclude": {
+        "**/.git/objects/**": true,
+        "**/.git/subtree-cache/**": true,
+        "**/node_modules/**": true,
+        "**/dist/**": true,
+        "**/.next/**": true,
+        "**/build/**": true,
+        "**/.venv/**": true,
+        "**/coverage/**": true,
+        "**/.turbo/**": true,
+        "**/.cache/**": true,
+        "**/.pnpm-store/**": true,
+        "**/target/**": true,
+        "**/.parcel-cache/**": true
+    },
+    "search.exclude": {
+        "**/node_modules": true,
+        "**/dist": true,
+        "**/.next": true,
+        "**/build": true,
+        "**/.venv": true,
+        "**/coverage": true,
+        "**/.turbo": true,
+        "**/package-lock.json": true,
+        "**/pnpm-lock.yaml": true,
+        "**/yarn.lock": true,
+        "**/target": true,
+        "**/.pnpm-store": true,
+        "**/.parcel-cache": true
+    },
+    "git.autorefresh": false,
+    "editor.minimap.enabled": false,
+    "editor.smoothScrolling": false,
+    "search.followSymlinks": false,
+    "search.smartCase": true,
+    "files.enableTrash": true,
+    "extensions.autoUpdate": false,
+    "extensions.autoCheckUpdates": false,
+    "workbench.reduceMotion": "on",
+    "editor.stickyScroll.enabled": true,
+    "editor.linkedEditing": true,
+    "editor.suggestSelection": "first",
+    "editor.acceptSuggestionOnCommitCharacter": true,
+    "editor.wordSeparators": "`~!@#$%^&*()-=+[{]}\\|;:'\",.<>/?",
+    "editor.accessibilitySupport": "off",
+    "editor.unicodeHighlight.ambiguousCharacters": false,
+    "editor.unicodeHighlight.invisibleCharacters": false,
+    "typescript.updateImportsOnFileMove.enabled": "always",
+    "javascript.updateImportsOnFileMove.enabled": "always",
+    "typescript.preferences.importModuleSpecifierEnding": "minimal",
+    "typescript.tsserver.maxTsServerMemory": 8192,
+    "workbench.editor.limit.enabled": true,
+    "workbench.editor.limit.value": 12,
+    "workbench.editor.limit.perEditorGroup": true,
+    "workbench.editor.closeEmptyGroups": true,
+    "workbench.editor.highlightModifiedTabs": true,
+    "explorer.autoReveal": false,
+    "explorer.confirmDragAndDrop": false,
+    "scm.diffDecorations": "all",
+    "search.quickOpen.includeSymbols": true,
+    "search.useIgnoreFiles": true,
+    "search.useGlobalIgnoreFiles": true,
+    "terminal.integrated.scrollback": 50000,
+    "terminal.integrated.fastScrollSensitivity": 5,
+    "terminal.integrated.macOptionIsMeta": true,
+    "terminal.integrated.copyOnSelection": false,
+    "problems.decorations.enabled": true,
+    "task.autoDetect": "on",
+    "files.insertFinalNewline": true,
+    "files.trimTrailingWhitespace": false,
+    "window.newWindowDimensions": "inherit",
+    "window.commandCenter": true,
+    "git.showInlineOpenFileAction": true,
+    "git.timeline.enabled": true
+}

.cursor/skills/local-handbook/config/mcp.extra-servers.json

@@ -0,0 +1,3 @@
+{
+  "mcpServers": {}
+}