start-vibing 4.4.1 → 4.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "start-vibing",
-	"version": "4.4.1",
+	"version": "4.4.3",
 	"description": "Setup Claude Code with 9 plugins, 6 community skills, and 8 MCP servers. Parallel install, auto-accept, superpowers + ralph-loop. e2e-audit 0.2.0 refactor (skill-only, no agents): SessionStart hook + slash command make the skill keyword-invokable (\"e2e audit\", \"roda o e2e\", \"integration test\", \"test coverage gaps\"). Source-first discovery via detect-stack, discover-routes (Next app/pages/Remix/SvelteKit/Nuxt/Astro), discover-api-surface (HTTP handlers, tRPC procedures, GraphQL, server actions, middleware auth), inventory-existing-tests (preserve prior corpus + sha256 drift hash), and detect-uncovered (branch-diff vs origin/main finds changes not covered by existing specs). Report-then-ask between mapping and Playwright run; post-run-feedback report before writing findings. SHOT+TRACE+ASSERT+SOURCE evidence quad per non-meta finding; meta rules (coverage-gap-*, uncovered-*, test-drift, stack-detect, post-run-feedback) exempt. verify-audit.sh enforces schema + quad. Generic (no project leakage). super-design 0.7.0 carries over.",
 	"type": "module",
 	"bin": {

package/template/.claude/hooks/format-on-edit.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# PostToolUse hook: auto-formats files written/edited by Claude using prettier.
+# Silently no-ops if prettier is unavailable or the file type isn't supported.
+# Always exits 0 so it never blocks the workflow.
+set -uo pipefail
+
+INPUT=$(cat)
+FILE=$(printf '%s' "$INPUT" | python3 -c 'import json,sys;d=json.load(sys.stdin);print(d.get("tool_input",{}).get("file_path",""))' 2>/dev/null || echo "")
+
+[ -z "$FILE" ] && exit 0
+[ ! -f "$FILE" ] && exit 0
+
+case "$FILE" in
+  *.ts|*.tsx|*.js|*.jsx|*.mjs|*.cjs|*.json|*.md|*.css|*.scss|*.html|*.yml|*.yaml) ;;
+  *) exit 0 ;;
+esac
+
+cd "${CLAUDE_PROJECT_DIR:-.}" 2>/dev/null || exit 0
+
+if command -v bunx >/dev/null 2>&1; then
+  bunx --bun prettier --write --log-level=silent "$FILE" 2>/dev/null || true
+elif command -v npx >/dev/null 2>&1; then
+  npx --no-install prettier --write --log-level=silent "$FILE" 2>/dev/null || true
+fi
+
+exit 0

package/template/.claude/hooks/git-context-session-start.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Injects current git context (branch, dirty files, last commits) into Claude's
+# SessionStart context so the assistant opens the session already situated.
+set -euo pipefail
+
+cd "${CLAUDE_PROJECT_DIR:-.}" 2>/dev/null || exit 0
+command -v git >/dev/null 2>&1 || exit 0
+git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
+
+BRANCH=$(git branch --show-current 2>/dev/null || echo "(detached)")
+UPSTREAM=$(git rev-parse --abbrev-ref --symbolic-full-name '@{u}' 2>/dev/null || echo "(no upstream)")
+AHEAD_BEHIND=$(git rev-list --left-right --count "@{u}...HEAD" 2>/dev/null || echo "? ?")
+DIRTY=$(git status --porcelain 2>/dev/null | head -20)
+DIRTY_COUNT=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
+LAST_COMMITS=$(git log --oneline -5 2>/dev/null)
+
+CONTEXT="GIT CONTEXT (auto-injected at session start)\n\nBranch: ${BRANCH} (upstream: ${UPSTREAM}, behind/ahead: ${AHEAD_BEHIND})\n\nUncommitted changes (${DIRTY_COUNT} files):\n${DIRTY:-(clean)}\n\nLast 5 commits:\n${LAST_COMMITS}\n\nUse this to ground your first response. Don't re-run git status unless the user asks for fresh state — this snapshot is from session start."
+
+# Escape for JSON
+CONTEXT_ESCAPED=$(printf '%s' "$CONTEXT" | python3 -c 'import json,sys;print(json.dumps(sys.stdin.read()))' 2>/dev/null || printf '%s' "$CONTEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/$/\\n/' | tr -d '\n' | sed 's/\\n$//' | awk '{print "\"" $0 "\""}')
+
+printf '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":%s}}\n' "$CONTEXT_ESCAPED"

package/template/.claude/hooks/mcp-usage-session-start.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+cat <<'EOF'
+{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"MCP USAGE RULES (non-negotiable for this project):\n\n1. sequential-thinking — You MUST invoke `mcp__sequential-thinking__sequentialthinking` BEFORE proposing a solution whenever the task involves: multi-step implementation, architecture/design decisions, debugging a non-trivial bug, refactor planning, trade-off analysis, or any request where the path is not obvious in one step. Do not skip it because the answer 'feels clear' — use it to externalize the plan, then act. Skip ONLY for: trivial single-file edits, pure lookups, direct factual questions, or formatting/typo fixes.\n\n2. context7 — You MUST invoke `mcp__context7__resolve-library-id` followed by `mcp__context7__query-docs` BEFORE writing or modifying code that uses ANY external library, framework, SDK, API, or CLI tool — including well-known ones (React, Next.js, Mongoose, Zod, Tailwind, shadcn, TanStack Query, Playwright, Vitest, Bun, Express, Prisma, etc.). Your training data may be stale; context7 returns current docs. Skip ONLY for: pure language features (vanilla TS/JS), project-internal code with no library surface, or refactors that don't touch library APIs.\n\n3. Order of operations for a typical feature task: sequential-thinking (plan) → context7 (verify library APIs) → implement → quality gates. Do not invert.\n\n4. If you catch yourself about to write code without having called context7 for a library you're importing, STOP and call it first. If you catch yourself proposing a multi-step plan without sequential-thinking, STOP and call it first.\n\n5. These MCPs are already connected in this project (.mcp.json). There is no setup cost — just call them."}}
+EOF

package/template/.claude/hooks/quality-gate-stop.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Stop hook: runs available quality gates (typecheck, lint, test) before
+# letting the session end. If any fail, exits 2 to force Claude to fix them.
+# Respects stop_hook_active to avoid infinite loops.
+# Skips gracefully if scripts aren't defined in package.json.
+set -uo pipefail
+
+INPUT=$(cat)
+
+ACTIVE=$(printf '%s' "$INPUT" | python3 -c 'import json,sys;d=json.load(sys.stdin);print(d.get("stop_hook_active",False))' 2>/dev/null || echo "False")
+[ "$ACTIVE" = "True" ] && exit 0
+
+cd "${CLAUDE_PROJECT_DIR:-.}" 2>/dev/null || exit 0
+[ ! -f package.json ] && exit 0
+
+# Skip if no source files were touched in this branch vs origin
+if command -v git >/dev/null 2>&1; then
+  CHANGED=$(git diff --name-only HEAD 2>/dev/null | grep -E '\.(ts|tsx|js|jsx|mjs|cjs)$' | head -1 || true)
+  STAGED=$(git diff --name-only --cached 2>/dev/null | grep -E '\.(ts|tsx|js|jsx|mjs|cjs)$' | head -1 || true)
+  if [ -z "$CHANGED" ] && [ -z "$STAGED" ]; then
+    exit 0
+  fi
+fi
+
+has_script() {
+  python3 -c "import json,sys;d=json.load(open('package.json'));sys.exit(0 if '$1' in d.get('scripts',{}) else 1)" 2>/dev/null
+}
+
+RUNNER="bun run"
+command -v bun >/dev/null 2>&1 || RUNNER="npm run"
+
+FAIL=""
+for script in typecheck lint test; do
+  if has_script "$script"; then
+    if ! $RUNNER "$script" >/dev/null 2>&1; then
+      FAIL="$FAIL $script"
+    fi
+  fi
+done
+
+if [ -n "$FAIL" ]; then
+  printf '{"decision":"block","reason":"Quality gate failed:%s. Run the failing script(s), fix the errors, and try again. Do not bypass — these run because TypeScript/lint/test errors block PRs."}\n' "$FAIL"
+  exit 0
+fi
+
+exit 0

package/template/.claude/settings.json

@@ -43,6 +43,35 @@
 					{
 						"type": "command",
 						"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/e2e-audit-session-start.sh\""
+					},
+					{
+						"type": "command",
+						"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/mcp-usage-session-start.sh\""
+					},
+					{
+						"type": "command",
+						"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/git-context-session-start.sh\""
+					}
+				]
+			}
+		],
+		"PostToolUse": [
+			{
+				"matcher": "Write|Edit",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/format-on-edit.sh\""
+					}
+				]
+			}
+		],
+		"Stop": [
+			{
+				"hooks": [
+					{
+						"type": "command",
+						"command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/quality-gate-stop.sh\""
 					}
 				]
 			}