feat(scaffold): Cursor nudge-uncommitted hook

Cursor 1.7+ ships a hooks system at .cursor/hooks.json. The
afterFileEdit event fires after Cursor's edit/write tools and
accepts a top-level additional_context field (snake_case) to
inject a soft reminder into the agent's context.

Same threshold + message as the Claude Code and Gemini CLI
hooks. Skipped on main/master and outside a git work tree.

Doc reference: https://cursor.com/docs/hooks

Author: vivek7405

packages/cli/lib/create.js

@@ -272,6 +272,9 @@ export async function scaffoldApp(name, cwd, opts = {}) {
     // Gemini CLI config + hooks
     '.gemini/settings.json',
     '.gemini/hooks/nudge-uncommitted.sh',
+    // Cursor config + hooks
+    '.cursor/hooks.json',
+    '.cursor/hooks/nudge-uncommitted.sh',
     // Cross-agent config files
     '.cursorrules',
     '.windsurfrules',
@@ -299,6 +302,10 @@ export async function scaffoldApp(name, cwd, opts = {}) {
     const hookPath = join(appDir, '.gemini', 'hooks', hook);
     if (existsSync(hookPath)) await chmod(hookPath, 0o755);
   }
+  for (const hook of ['nudge-uncommitted.sh']) {
+    const hookPath = join(appDir, '.cursor', 'hooks', hook);
+    if (existsSync(hookPath)) await chmod(hookPath, 0o755);
+  }
   // Make git pre-commit hook executable
   const preCommitPath = join(appDir, '.hooks', 'pre-commit');
   if (existsSync(preCommitPath)) await chmod(preCommitPath, 0o755);

packages/cli/templates/.cursor/hooks.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "hooks": {
+    "afterFileEdit": [
+      { "command": ".cursor/hooks/nudge-uncommitted.sh" }
+    ]
+  }
+}

packages/cli/templates/.cursor/hooks/nudge-uncommitted.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+#
+# Cursor afterFileEdit hook.
+#
+# Counterpart of .claude/hooks/nudge-uncommitted.sh. After each
+# file edit, counts uncommitted changes in the working tree.
+# When the count crosses a threshold (default 4, override with
+# WEBJS_COMMIT_NUDGE_THRESHOLD), injects a reminder via the
+# top-level additional_context field (snake_case, unlike Claude
+# Code's nested hookSpecificOutput.additionalContext).
+#
+# Soft nudge. Exit 0 always. Skipped on main/master and outside
+# a git work tree.
+
+set -e
+
+THRESHOLD="${WEBJS_COMMIT_NUDGE_THRESHOLD:-4}"
+
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+  exit 0
+fi
+
+BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || echo "")
+if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
+  exit 0
+fi
+
+cat /dev/stdin >/dev/null 2>&1 || true
+
+CHANGED=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+
+if [ -z "$CHANGED" ] || [ "$CHANGED" -lt "$THRESHOLD" ]; then
+  exit 0
+fi
+
+REASON="You have ${CHANGED} uncommitted changes on '${BRANCH}'. The webjs convention is small, focused commits per logical unit (one feature, one fix, one rename, one doc rewrite). Before continuing with more edits, group the current changes into a meaningful commit. See AGENTS.md \"Git workflow\" for the rule and the rationale. To raise the threshold for this hook in long-running tasks, set WEBJS_COMMIT_NUDGE_THRESHOLD."
+
+jq -n --arg ctx "$REASON" '{ additional_context: $ctx }'