@jeiemgi/cckit 0.1.6

package/docs/media/kit-onboarding.cast

@@ -0,0 +1,148 @@
+{"version":2,"width":98,"height":38,"env":{"TERM":"xterm-256color","SHELL":"/bin/zsh"}}
+[0.00, "o", "\u001b[1;36m➜ claude-kit\u001b[0m "]
+[0.40, "o", "c"]
+[0.44, "o", "l"]
+[0.47, "o", "a"]
+[0.51, "o", "u"]
+[0.55, "o", "d"]
+[0.59, "o", "e"]
+[0.62, "o", " "]
+[0.66, "o", "-"]
+[0.70, "o", "p"]
+[0.73, "o", " "]
+[0.77, "o", "'"]
+[0.81, "o", "r"]
+[0.85, "o", "u"]
+[0.89, "o", "n"]
+[0.93, "o", " "]
+[0.97, "o", "i"]
+[1.00, "o", "n"]
+[1.03, "o", "i"]
+[1.06, "o", "t"]
+[1.09, "o", "."]
+[1.12, "o", "s"]
+[1.16, "o", "h"]
+[1.19, "o", " "]
+[1.22, "o", "-"]
+[1.25, "o", "-"]
+[1.28, "o", "p"]
+[1.31, "o", "r"]
+[1.34, "o", "o"]
+[1.38, "o", "f"]
+[1.41, "o", "i"]
+[1.44, "o", "l"]
+[1.47, "o", "e"]
+[1.50, "o", " "]
+[1.53, "o", "a"]
+[1.56, "o", "u"]
+[1.59, "o", "t"]
+[1.62, "o", "o"]
+[1.66, "o", "m"]
+[1.69, "o", "a"]
+[1.72, "o", "t"]
+[1.75, "o", "i"]
+[1.78, "o", "o"]
+[1.81, "o", "n"]
+[1.84, "o", " "]
+[1.88, "o", "-"]
+[1.91, "o", "-"]
+[1.94, "o", "n"]
+[1.97, "o", "a"]
+[2.00, "o", "m"]
+[2.04, "o", "e"]
+[2.08, "o", " "]
+[2.12, "o", "\""]
+[2.16, "o", "A"]
+[2.20, "o", "c"]
+[2.24, "o", "m"]
+[2.28, "o", "e"]
+[2.31, "o", " "]
+[2.35, "o", "B"]
+[2.39, "o", "o"]
+[2.43, "o", "t"]
+[2.47, "o", "\""]
+[2.51, "o", " "]
+[2.54, "o", "-"]
+[2.58, "o", "-"]
+[2.62, "o", "m"]
+[2.66, "o", "e"]
+[2.70, "o", "m"]
+[2.74, "o", "o"]
+[2.78, "o", "r"]
+[2.81, "o", "y"]
+[2.85, "o", " "]
+[2.89, "o", "o"]
+[2.93, "o", "n"]
+[2.97, "o", " "]
+[3.01, "o", "-"]
+[3.04, "o", "-"]
+[3.08, "o", "d"]
+[3.12, "o", "r"]
+[3.16, "o", "y"]
+[3.20, "o", "-"]
+[3.24, "o", "r"]
+[3.28, "o", "u"]
+[3.31, "o", "n"]
+[3.35, "o", " "]
+[3.39, "o", "a"]
+[3.43, "o", "n"]
+[3.47, "o", "d"]
+[3.51, "o", " "]
+[3.54, "o", "s"]
+[3.58, "o", "h"]
+[3.62, "o", "o"]
+[3.66, "o", "w"]
+[3.70, "o", " "]
+[3.74, "o", "t"]
+[3.78, "o", "h"]
+[3.81, "o", "e"]
+[3.85, "o", " "]
+[3.89, "o", "o"]
+[3.93, "o", "u"]
+[3.97, "o", "t"]
+[4.00, "o", "p"]
+[4.04, "o", "u"]
+[4.08, "o", "t"]
+[4.12, "o", "'"]
+[4.16, "o", "\r\n"]
+[4.51, "o", "\u001b[90m✳ Working…\u001b[0m"]
+[5.71, "o", "\r\u001b[K"]
+[5.91, "o", "Here's the raw output of the command:\r\n"]
+[5.96, "o", "\r\n"]
+[6.01, "o", "→ DRY RUN — nothing will be written. Plan for /var/folders/9m/bx78tc212xd_08yq3phm8sjr0000gn/T/tmp.BDfMtWiTgB:\r\n"]
+[6.06, "o", "\r\n"]
+[6.11, "o", "  Profile : automation\r\n"]
+[6.16, "o", "  Project : Acme Bot (tmp-bdfmtwitgb)\r\n"]
+[6.21, "o", "  Repo    : acme/bot\r\n"]
+[6.26, "o", "  Board   : off (gh issues only)\r\n"]
+[6.31, "o", "  Memory  : true   Plans: markdown   Lang: English\r\n"]
+[6.36, "o", "  Spec Kit: false   Pre-push gate: false\r\n"]
+[6.41, "o", "\r\n"]
+[6.46, "o", "  Would write:\r\n"]
+[6.51, "o", "    CLAUDE.md\r\n"]
+[6.56, "o", "    .claude/kit.config.json\r\n"]
+[6.61, "o", "    .claude/settings.local.json\r\n"]
+[6.66, "o", "    .claude/rules/communication-style.md\r\n"]
+[6.71, "o", "    .claude/rules/task-management.md\r\n"]
+[6.76, "o", "    .claude/rules/plan-output-format.md\r\n"]
+[6.81, "o", "    .claude/rules/mempalace.md\r\n"]
+[6.86, "o", "    .claude/agents/pm/AGENT.md\r\n"]
+[6.91, "o", "    .claude/agents/n8n/AGENT.md\r\n"]
+[6.96, "o", "    .claude/agents/generalist/AGENT.md\r\n"]
+[7.01, "o", "    .claude/skills/task-new/SKILL.md\r\n"]
+[7.06, "o", "    .claude/skills/task-start/SKILL.md\r\n"]
+[7.11, "o", "    .claude/skills/task-pr/SKILL.md\r\n"]
+[7.16, "o", "    .claude/skills/task-pr-merge/SKILL.md\r\n"]
+[7.21, "o", "    .claude/skills/task-sync/SKILL.md\r\n"]
+[7.26, "o", "    .claude/skills/task-close/SKILL.md\r\n"]
+[7.31, "o", "    .claude/skills/morning-briefing/SKILL.md\r\n"]
+[7.36, "o", "    .claude\r\n"]
+[7.41, "o", "/skills/karpathy-guidelines/SKILL.md\r\n"]
+[7.46, "o", "    scripts/ (kit-config.sh, gh-project.sh, setup-labels.sh, setup-milestones.sh, capture-project-ids.sh, task-sync.sh)\r\n"]
+[7.51, "o", "    .claude/hooks/mempal_session_start.sh + mempal_save.sh + mempal_precompact.sh   (SessionStart / Stop / PreCompact)\r\n"]
+[7.56, "o", "\r\n"]
+[7.61, "o", "  Onboarding would offer (opt-in): gh auth · MemPalace (mempalace-mcp) · gws (if you use Google Workspace)\r\n"]
+[7.66, "o", "\r\n"]
+[7.71, "o", "Re-run without --dry-run to write these files.\r\n"]
+[8.26, "o", "\u001b[1;36m➜ claude-kit\u001b[0m "]
+[10.06, "o", " "]

package/githooks/pre-commit

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# cckit pre-commit — block secrets / keys / env / private data before they enter history.
+# Agnostic: ships with cckit, works in any repo. Wire it: git config core.hooksPath githooks
+set -uo pipefail
+root="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+guard="$root/scripts/lib/secret-guard.sh"
+[ -f "$guard" ] || guard="$(dirname "$0")/../scripts/lib/secret-guard.sh"
+# shellcheck source=/dev/null
+. "$guard" 2>/dev/null || { echo "cckit pre-commit: secret-guard not found, skipping" >&2; exit 0; }
+staged=()
+while IFS= read -r line; do staged+=("$line"); done < <(git diff --cached --name-only --diff-filter=ACM 2>/dev/null)
+[ "${#staged[@]}" -eq 0 ] && exit 0
+if ! secret_guard_scan "${staged[@]}"; then
+  echo "cckit pre-commit: commit blocked by secret-guard. Fix the findings above," >&2
+  echo "or (if a true false positive) bypass once by re-committing with the --no-verify flag." >&2
+  exit 1
+fi
+exit 0

package/kit.config.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/tuempresadigital/claude-kit/kit.config.schema.json",
+  "title": "claude-kit project config (v2)",
+  "description": "Identity layer of a kit project. Resolved in cascade workspace -> project -> island by scripts/lib/kit-config-resolve.sh; the nearest layer wins. The $schema reference in kit.config.json points here so editors validate + autocomplete.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema": { "type": "string" },
+    "kitVersion": {
+      "type": "string",
+      "description": "Kit version that last wrote/wired this config. Drives self-heal: when it differs from the installed plugin, kit-wire re-converges."
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["draft", "guided", "enforced"],
+      "default": "guided",
+      "description": "How strict the kit is HERE. draft = guardrails off (explore freely); guided = warnings, never block; enforced = guardrails block (worktree-only, PR-per-issue). Set per cascade level — an island can be enforced while its parent workspace is guided."
+    },
+    "workspace": {
+      "type": "object",
+      "description": "Present only in kit.workspace.json (the workspace-root marker). Holds settings shared across every project under the workspace.",
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string" },
+        "commons": {
+          "type": "string",
+          "description": "Path (relative to the workspace root) of the promoted skills/agents commons. Default .claude/."
+        }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "name": { "type": "string" },
+        "slug": { "type": "string" },
+        "owner": { "type": "string" },
+        "language": { "type": "string", "description": "Comms language, e.g. en, es, mixed." },
+        "path": { "type": "string" }
+      }
+    },
+    "profile": { "type": "string", "description": "Active role profile (minimal, software, content, research, automation, ...)." },
+    "skillPrefix": { "type": "string", "description": "Namespace prepended to kit-namespaced workflow skills on scaffold/upgrade (e.g. \"kit-\" -> kit-task-close). Empty = bare names. See templates/skills/NAMESPACED." },
+    "modules": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Stackable modules added on top of the profile (e.g. \"software\"). Empty/absent = base project."
+    },
+    "roles": { "type": "array", "items": { "type": "string" } },
+    "github": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "repo": { "type": "string" },
+        "owner": { "type": "string" },
+        "baseBranch": { "type": "string", "description": "Integration branch the lifecycle skills branch from and merge into (default: main; e.g. develop)." },
+        "projectsV2": { "type": "boolean" },
+        "projectNumber": { "type": ["integer", "null"] },
+        "projectTitle": { "type": ["string", "null"] }
+      }
+    },
+    "milestones": { "type": "array", "items": { "type": "string" } },
+    "plans": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "format": { "type": "string", "description": "none | markdown | mdx" },
+        "dir": { "type": "string" }
+      }
+    },
+    "memory": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "provider": { "type": "string" },
+        "wing": { "type": "string" },
+        "claudeProjectSlug": { "type": "string" }
+      }
+    },
+    "routines": {
+      "type": "array",
+      "description": "Opt-in scheduled routines accepted by the user (briefing, board sweep, gc, ...). The kit SUGGESTS; the user accepts; nothing is created without opt-in.",
+      "items": { "type": "string" }
+    },
+    "upgrade": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Tells `init.sh --upgrade` which scaffolded paths the project deleted/renamed ON PURPOSE so they are never re-added (#334). Paths are repo-relative (e.g. \".claude/skills/task-new\"); a directory entry covers everything beneath it.",
+      "properties": {
+        "removed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Scaffolded paths the project deleted on purpose — the upgrade will not re-create them."
+        },
+        "renamed": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Map of original scaffolded path -> the project's new name. The original (key) is treated as removed (never re-added); the value documents where it went."
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@jeiemgi/cckit",
+  "version": "0.1.6",
+  "private": false,
+  "license": "MIT OR Apache-2.0",
+  "description": "cckit — a project operating system for coding agents (CLI + Claude Code plugin).",
+  "homepage": "https://cckit.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jeiemgi/cckit.git"
+  },
+  "bin": {
+    "cckit": "bin/cckit"
+  },
+  "files": [
+    ".claude-plugin",
+    "bin",
+    "scripts",
+    "commands",
+    "skills",
+    "profiles",
+    "templates",
+    "docs",
+    "githooks",
+    "cckit.config.json",
+    "kit.config.schema.json",
+    "privacy-denylist.example",
+    "AGENTS.md",
+    "SECURITY.md",
+    "LICENSE-MIT",
+    "LICENSE-APACHE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agents",
+    "claude-code",
+    "cli",
+    "github",
+    "workflow",
+    "worktree",
+    "orchestration",
+    "bash",
+    "developer-tools"
+  ],
+  "author": "jeiemgi",
+  "bugs": {
+    "url": "https://github.com/jeiemgi/cckit/issues"
+  },
+  "engines": {
+    "bash": ">=4"
+  }
+}

package/privacy-denylist.example

@@ -0,0 +1,8 @@
+# cckit privacy denylist — terms that must NEVER appear in anything cckit publishes.
+# Copy to .cckit/privacy-denylist (gitignored) and add YOUR private terms, one per line.
+# The guard fails the commit/gate if any term is found in a tracked file. Examples of what to add:
+#   your-company.com
+#   your-org-name
+#   you@example.com
+#   internal-host.example
+# cckit ships this list EMPTY by design — it is agnostic; you declare what is yours.

package/profiles/automation.json

@@ -0,0 +1,36 @@
+{
+  "name": "automation",
+  "label": "Automation / n8n",
+  "description": "Workflow-automation org: a product manager, an n8n automation specialist, and a generalist.",
+  "agents": [
+    "pm",
+    "n8n",
+    "generalist"
+  ],
+  "skills": [
+    "morning-briefing",
+    "karpathy-guidelines"
+  ],
+  "rules": [
+    "branch-naming",
+    "communication-style",
+    "knowledge-base",
+    "mempalace",
+    "plan-output-format",
+    "task-management"
+  ],
+  "roles": [
+    "PM",
+    "Automation",
+    "Generalist"
+  ],
+  "milestones": [
+    "Backlog",
+    "Building",
+    "Live"
+  ],
+  "defaults": {
+    "plans_format": "markdown",
+    "memory": "off"
+  }
+}

package/profiles/content.json

@@ -0,0 +1,41 @@
+{
+  "name": "content",
+  "label": "Content / editorial",
+  "description": "Writing, publishing, and brand work: planning, editing, design, and research.",
+  "agents": [
+    "pm",
+    "editor",
+    "designer",
+    "researcher"
+  ],
+  "skills": [
+    "morning-briefing",
+    "copywriting",
+    "karpathy-guidelines"
+  ],
+  "rules": [
+    "branch-naming",
+    "communication-style",
+    "design-routing",
+    "knowledge-base",
+    "mempalace",
+    "plan-output-format",
+    "task-management"
+  ],
+  "roles": [
+    "PM",
+    "Editor",
+    "Designer",
+    "Researcher"
+  ],
+  "milestones": [
+    "Outline",
+    "Draft",
+    "Review",
+    "Publish"
+  ],
+  "defaults": {
+    "plans_format": "markdown",
+    "memory": "off"
+  }
+}

package/profiles/minimal.json

@@ -0,0 +1,31 @@
+{
+  "name": "minimal",
+  "label": "Minimal",
+  "description": "Lean setup: a project manager plus a generalist that flexes to any task.",
+  "agents": [
+    "pm",
+    "generalist"
+  ],
+  "skills": [
+    "karpathy-guidelines"
+  ],
+  "rules": [
+    "communication-style",
+    "task-management",
+    "mempalace",
+    "branch-naming"
+  ],
+  "roles": [
+    "PM",
+    "Generalist"
+  ],
+  "milestones": [
+    "Backlog",
+    "Doing",
+    "Done"
+  ],
+  "defaults": {
+    "plans_format": "none",
+    "memory": "off"
+  }
+}

package/profiles/research.json

@@ -0,0 +1,37 @@
+{
+  "name": "research",
+  "label": "Research / analysis",
+  "description": "Investigation and synthesis: planning, primary research, and data analysis.",
+  "agents": [
+    "pm",
+    "researcher",
+    "analyst"
+  ],
+  "skills": [
+    "morning-briefing",
+    "karpathy-guidelines"
+  ],
+  "rules": [
+    "branch-naming",
+    "communication-style",
+    "knowledge-base",
+    "mempalace",
+    "plan-output-format",
+    "task-management"
+  ],
+  "roles": [
+    "PM",
+    "Researcher",
+    "Analyst"
+  ],
+  "milestones": [
+    "Scope",
+    "Gather",
+    "Analyze",
+    "Report"
+  ],
+  "defaults": {
+    "plans_format": "markdown",
+    "memory": "off"
+  }
+}

package/profiles/software.json

@@ -0,0 +1,32 @@
+{
+  "name": "software",
+  "label": "Software product",
+  "description": "Full engineering org: product, architecture, design, infra, backend, frontend, QA, security.",
+  "agents": ["pm", "tech-lead", "designer", "devops", "backend", "frontend", "qa", "security"],
+  "skills": [
+    "morning-briefing",
+    "speckit",
+    "feature-build-refine",
+    "supabase-patterns",
+    "karpathy-guidelines"
+  ],
+  "rules": [
+    "branch-naming",
+    "communication-style",
+    "design-routing",
+    "knowledge-base",
+    "mempalace",
+    "plan-output-format",
+    "effort-model",
+    "delegation-brief",
+    "skill-gaps",
+    "task-management"
+  ],
+  "roles": ["PM", "Tech Lead", "Designer", "DevOps", "Backend", "Frontend", "QA", "Security"],
+  "milestones": ["Foundation", "MVP", "Beta", "GA"],
+  "defaults": {
+    "plans_format": "markdown",
+    "memory": "off",
+    "speckit": "off"
+  }
+}

package/scripts/annotate-setup.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# claude-kit — wire Agentation (in-app visual UI annotation) into a React project, for Claude Code.
+# Installs the third-party `agentation` dev dependency, registers the `agentation-mcp` MCP server
+# for Claude, writes the react-annotate rule, and records the choice in .claude/kit.config.json.
+# It PRINTS the dev-only provider snippet to add to the app entry — the /kit-annotate skill applies
+# that source edit with your confirmation (layouts vary too much for a safe blind sed).
+#
+# Agentation is PolyForm Shield 1.0.0, source-available. This installs it as YOUR project's own dev
+# dependency (npm fetches it at your direction); the kit vendors none of its code.
+#
+# Usage: scripts/annotate-setup.sh [--target DIR] [--framework next|vite|react-router] [--dry-run]
+set -euo pipefail
+
+KIT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+command -v jq   >/dev/null 2>&1 || { echo "✗ jq is required."   >&2; exit 1; }
+command -v perl >/dev/null 2>&1 || { echo "✗ perl is required." >&2; exit 1; }
+
+TARGET="$PWD"; FRAMEWORK_OVERRIDE=""; DRY_RUN=0
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target)    TARGET="$2"; shift 2 ;;
+    --framework) FRAMEWORK_OVERRIDE="$2"; shift 2 ;;
+    --dry-run)   DRY_RUN=1; shift ;;
+    -h|--help)   sed -n '2,12p' "$0"; exit 0 ;;
+    *) echo "✗ unknown flag: $1" >&2; exit 1 ;;
+  esac
+done
+TARGET="$(cd "$TARGET" && pwd)"
+
+# shellcheck source=/dev/null
+source "$KIT_ROOT/scripts/lib/react-detect.sh"
+react_detect "$TARGET"
+[[ -n "$FRAMEWORK_OVERRIDE" ]] && REACT_FRAMEWORK="$FRAMEWORK_OVERRIDE"
+
+if [[ "$REACT_DETECTED" != "true" ]]; then
+  echo "✗ No React app detected in $TARGET (no 'react' in package.json)." >&2
+  echo "  /kit-annotate targets React apps (Next.js, Vite, React Router). Skipping." >&2
+  exit 2
+fi
+
+CFG="$TARGET/.claude/kit.config.json"
+WING=""; MEMORY_BOOL="false"; PROJECT_NAME="$(basename "$TARGET")"; HTTP_PORT=4747
+if [[ -f "$CFG" ]]; then
+  WING="$(jq -r '.memory.wing // .project.slug // ""' "$CFG" 2>/dev/null || echo "")"
+  MEMORY_BOOL="$(jq -r '.memory.enabled // false'      "$CFG" 2>/dev/null || echo false)"
+  PROJECT_NAME="$(jq -r '.project.name // ""'          "$CFG" 2>/dev/null || echo "$PROJECT_NAME")"
+  HTTP_PORT="$(jq -r '.annotate.mcp.httpPort // 4747'  "$CFG" 2>/dev/null || echo 4747)"
+fi
+[[ -z "$WING" || "$WING" == "null" ]] && WING="$(basename "$TARGET" | tr '[:upper:]' '[:lower:]')"
+[[ -z "$HTTP_PORT" || "$HTTP_PORT" == "null" ]] && HTTP_PORT=4747
+
+case "$REACT_PKG_MANAGER" in
+  pnpm) INSTALL_CMD="pnpm add -D agentation" ;;
+  yarn) INSTALL_CMD="yarn add -D agentation" ;;
+  bun)  INSTALL_CMD="bun add -d agentation"  ;;
+  *)    INSTALL_CMD="npm install -D agentation" ;;
+esac
+MCP_ADD_CMD='claude mcp add agentation -- npx -y agentation-mcp server'
+ENDPOINT="http://localhost:${HTTP_PORT}"
+
+# Dev gate differs by framework: Next reads NODE_ENV; Vite/RR (Vite-based) use import.meta.env.DEV.
+case "$REACT_FRAMEWORK" in
+  next) GATE='process.env.NODE_ENV === "development"' ;;
+  *)    GATE='import.meta.env.DEV' ;;
+esac
+# The `endpoint` prop is REQUIRED. Without it the toolbar boots `disconnected`, writes only to the
+# browser's localStorage, and annotations never reach the MCP receiver on :$HTTP_PORT — so Claude
+# sees 0 sessions even while the user is annotating (the bug behind issue #157). Wire it everywhere.
+SNIPPET="import { Agentation } from \"agentation\";
+// …then, inside your root component's returned JSX, alongside the app:
+{ ${GATE} && <Agentation endpoint=\"${ENDPOINT}\" /> }"
+
+emit_rule() {  # resolve <!-- IF:FLAG --> blocks + {{VARS}} exactly like scripts/init.sh
+  local src="$1" dest="$2"
+  mkdir -p "$(dirname "$dest")"
+  KIT_FLAGS_ON="$([[ "$MEMORY_BOOL" == "true" ]] && echo MEMORY || true)" \
+  WING="$WING" PROJECT_NAME="$PROJECT_NAME" \
+  perl -0777 -pe '
+    my %on = map { $_=>1 } grep { length } split /,/, ($ENV{KIT_FLAGS_ON}//"");
+    1 while s{<!-- IF:(\w+) -->(.*?)<!-- /IF:\1 -->}{ $on{$1} ? $2 : "" }gse;
+    s/\{\{(\w+)\}\}/ exists $ENV{$1} ? $ENV{$1} : "{{$1}}" /ge;
+  ' "$src" > "$dest"
+}
+
+if [[ $DRY_RUN -eq 1 ]]; then
+  echo "→ DRY RUN — /kit-annotate setup plan for $TARGET"
+  echo ""
+  echo "  React        : yes (v${REACT_VERSION:-?})"
+  echo "  Framework    : $REACT_FRAMEWORK"
+  echo "  Entry file   : ${REACT_ENTRY_FILE:-"(not auto-found — the skill will ask)"}"
+  echo "  Pkg manager  : $REACT_PKG_MANAGER"
+  echo "  Memory/wing  : $MEMORY_BOOL / $WING"
+  echo ""
+  echo "  Would:"
+  echo "    1. $INSTALL_CMD"
+  echo "    2. $MCP_ADD_CMD"
+  echo "         # Agentation's MCP: HTTP :4747 (browser toolbar → store) + MCP stdio (→ Claude)"
+  echo "    3. write .claude/rules/react-annotate.md   (memory block: $MEMORY_BOOL)"
+  echo "    4. merge .annotate into .claude/kit.config.json"
+  echo "    5. (skill applies, with your OK) wire the dev-only toolbar into ${REACT_ENTRY_FILE:-<entry>}:"
+  printf '%s\n' "$SNIPPET" | sed 's/^/           /'
+  echo ""
+  echo "Re-run without --dry-run to apply steps 1–4."
+  exit 0
+fi
+
+echo "→ Installing agentation (dev dependency, $REACT_PKG_MANAGER)…"
+( cd "$TARGET" && eval "$INSTALL_CMD" )
+
+if claude mcp list 2>/dev/null | grep -qi 'agentation'; then
+  echo "  ✓ agentation MCP already registered for Claude"
+else
+  echo "→ Registering the agentation MCP for Claude…"
+  ( cd "$TARGET" && eval "$MCP_ADD_CMD" ) \
+    || echo "  ⚠ could not auto-register — run it yourself: $MCP_ADD_CMD"
+fi
+
+emit_rule "$KIT_ROOT/templates/rules/react-annotate.md" "$TARGET/.claude/rules/react-annotate.md"
+echo "  ✓ .claude/rules/react-annotate.md"
+
+if [[ -f "$CFG" ]]; then
+  tmp="$(mktemp)"
+  jq --arg fw "$REACT_FRAMEWORK" --arg ver "$REACT_VERSION" --arg entry "$REACT_ENTRY_FILE" \
+     --argjson port "$HTTP_PORT" \
+     '.annotate = {
+        enabled: true,
+        backend: "agentation",
+        framework: $fw,
+        reactVersion: $ver,
+        entryFile: $entry,
+        package: "agentation",
+        mcp: { name: "agentation", server: "agentation-mcp", httpPort: $port }
+      }' "$CFG" > "$tmp" && mv "$tmp" "$CFG"
+  echo "  ✓ .claude/kit.config.json (.annotate)"
+else
+  echo "  ⚠ no .claude/kit.config.json — run /kit-init first to persist annotate config (rule still written if .claude/ exists)"
+fi
+
+echo ""
+echo "✓ Agentation wired for Claude — framework: $REACT_FRAMEWORK"
+echo ""
+echo "Next:"
+echo "  • Add the dev-only toolbar to ${REACT_ENTRY_FILE:-your app entry} — keep the endpoint prop:"
+printf '%s\n' "$SNIPPET" | sed 's/^/      /'
+echo "  • Restart Claude Code so it loads the agentation MCP."
+echo "  • Start your dev server, then verify:  npx agentation-mcp doctor"
+echo "  • Preflight: with the toolbar open + a note left, the receiver on :$HTTP_PORT should list a"
+echo "    session. Connected but 0 sessions ⇒ the endpoint prop is missing or the tab is stale."
+exit 0