create-clicksmith 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ClickSmith contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,48 @@
+# create-clicksmith
+
+The one-command ClickSmith installer.
+
+```bash
+pnpm dlx create-clicksmith        # or: npm create clicksmith
+```
+
+It detects your stack and wires everything up **without clobbering your files**:
+
+1. **Detects** your package manager, bundler, framework, and any stable
+   attributes already in use (`data-testid`, `data-cy`, …).
+2. **Recommends** the hybrid locator strategy `source → attr → behavioral → dom`.
+3. **Wires** the dev-only `@clicksmith/unplugin` into your Vite config (when the
+   stack supports it) so the agent gets exact `file:line` locators.
+4. **Writes** agent instruction files for Claude (`CLAUDE.md`), Cursor
+   (`.cursor/rules/clicksmith.mdc`), Codex (`AGENTS.md`), and a generic agent —
+   using **managed blocks** so your existing content is preserved.
+5. **Merges** `agents.config.json` (defaults + any project overrides) into
+   `.clicksmith/`.
+6. **Registers** the daemon's MCP server in `.mcp.json` (and `.cursor/mcp.json`),
+   merging with any servers you already have.
+7. **Gitignores** ClickSmith's runtime state (`.clicksmith/`).
+
+## Flags
+
+```bash
+create-clicksmith [dir]
+  --dry-run                 # print the plan, write nothing
+  --no-unplugin             # skip the data-loc plugin wiring
+  --agents claude,cursor    # which instruction files to render
+```
+
+## Programmatic API
+
+The CLI is a thin wrapper around testable functions:
+
+```ts
+import { detectProject, planInstall, applyPlan } from 'create-clicksmith';
+
+const info = await detectProject(process.cwd());
+const plan = await planInstall(info, { useUnplugin: info.supportsUnplugin });
+// inspect plan.changes (each has action: create | merge | skip) …
+await applyPlan(process.cwd(), plan);
+```
+
+`planInstall` reads existing files and computes the *final merged contents* up
+front, so it is fully deterministic and easy to test. `applyPlan` only writes.

package/dist/chunk-WEMLICDQ.js

@@ -0,0 +1,295 @@
+// src/detect.ts
+import { readFile, readdir } from "fs/promises";
+import { join } from "path";
+var KNOWN_STABLE_ATTRS = ["data-testid", "data-test", "data-cy", "data-qa"];
+async function detectProject(root) {
+  const pkg = await readJson(join(root, "package.json"));
+  const deps = { ...pkg?.dependencies ?? {}, ...pkg?.devDependencies ?? {} };
+  const packageManager = await detectPackageManager(root);
+  const bundler = detectBundler(deps);
+  const framework = detectFramework(deps);
+  const viteConfig = await findFile(root, ["vite.config.ts", "vite.config.js", "vite.config.mjs"]);
+  const stableAttrs = await scanStableAttrs(root);
+  const supportsUnplugin = framework === "react" && ["vite", "webpack", "rspack", "rollup"].includes(bundler);
+  return {
+    root,
+    packageManager,
+    bundler,
+    framework,
+    stableAttrs,
+    supportsUnplugin,
+    ...viteConfig ? { viteConfig } : {}
+  };
+}
+async function detectPackageManager(root) {
+  if (await fileExists(join(root, "pnpm-lock.yaml"))) return "pnpm";
+  if (await fileExists(join(root, "yarn.lock"))) return "yarn";
+  if (await fileExists(join(root, "bun.lockb"))) return "bun";
+  return "npm";
+}
+function detectBundler(deps) {
+  if (deps.next) return "next";
+  if (deps.vite) return "vite";
+  if (deps["@rspack/core"]) return "rspack";
+  if (deps.webpack) return "webpack";
+  if (deps.rollup) return "rollup";
+  return "unknown";
+}
+function detectFramework(deps) {
+  if (deps["@angular/core"]) return "angular";
+  if (deps.svelte) return "svelte";
+  if (deps.vue) return "vue";
+  if (deps["solid-js"]) return "solid";
+  if (deps.react) return "react";
+  return "unknown";
+}
+async function scanStableAttrs(root) {
+  const found = /* @__PURE__ */ new Set();
+  const dirs = ["src", "app", "components"];
+  for (const dir of dirs) {
+    const files = await listSourceFiles(join(root, dir), 40);
+    for (const file of files) {
+      const content = await safeRead(file);
+      if (!content) continue;
+      for (const attr of KNOWN_STABLE_ATTRS) {
+        if (content.includes(attr)) found.add(attr);
+      }
+      if (found.size === KNOWN_STABLE_ATTRS.length) return [...found];
+    }
+  }
+  return [...found];
+}
+async function listSourceFiles(dir, limit) {
+  const out = [];
+  async function walk(d) {
+    if (out.length >= limit) return;
+    let entries;
+    try {
+      entries = await readdir(d, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (out.length >= limit) return;
+      if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
+      const full = join(d, entry.name);
+      if (entry.isDirectory()) await walk(full);
+      else if (/\.(jsx?|tsx?|vue|svelte)$/.test(entry.name)) out.push(full);
+    }
+  }
+  await walk(dir);
+  return out;
+}
+async function findFile(root, names) {
+  for (const name of names) {
+    if (await fileExists(join(root, name))) return name;
+  }
+  return void 0;
+}
+async function readJson(file) {
+  const raw = await safeRead(file);
+  if (!raw) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+async function safeRead(file) {
+  try {
+    return await readFile(file, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+async function fileExists(file) {
+  return await safeRead(file) !== void 0;
+}
+
+// src/install.ts
+import { mkdir, readFile as readFile2, writeFile } from "fs/promises";
+import { dirname, join as join2 } from "path";
+import {
+  applyManagedBlock,
+  DEFAULT_AGENTS_CONFIG,
+  mergeAgentsConfig,
+  parseAgentsConfig,
+  renderInstructions
+} from "@clicksmith/agent-config";
+import { DEFAULT_DAEMON_PORT } from "@clicksmith/core";
+var DEFAULT_AGENT_TARGETS = ["claude", "cursor", "codex", "generic"];
+async function planInstall(info, options = {}) {
+  const root = info.root;
+  const targets = options.agents ?? DEFAULT_AGENT_TARGETS;
+  const useUnplugin = options.useUnplugin ?? info.supportsUnplugin;
+  const port = options.daemonPort ?? DEFAULT_DAEMON_PORT;
+  const changes = [];
+  const messages = [];
+  const nextSteps = [];
+  for (const target of targets) {
+    const rendered = renderInstructions(target, { stableAttrs: info.stableAttrs, daemonPort: port });
+    const existing = await readText(join2(root, rendered.path));
+    const contents = rendered.shared ? applyManagedBlock(existing, rendered.content) : rendered.content;
+    changes.push({
+      path: rendered.path,
+      action: existing == null ? "create" : "merge",
+      contents
+    });
+  }
+  const configPath = join2(".clicksmith", "agents.config.json");
+  const existingConfigRaw = await readText(join2(root, configPath));
+  let merged = DEFAULT_AGENTS_CONFIG;
+  if (existingConfigRaw) {
+    try {
+      const parsed = parseAgentsConfig(JSON.parse(existingConfigRaw));
+      if (parsed.ok) merged = mergeAgentsConfig(DEFAULT_AGENTS_CONFIG, parsed.config);
+    } catch {
+      messages.push("Existing agents.config.json was invalid JSON; left it untouched.");
+    }
+  }
+  changes.push({
+    path: configPath,
+    action: existingConfigRaw == null ? "create" : "merge",
+    contents: `${JSON.stringify(merged, null, 2)}
+`
+  });
+  const mcp = mcpCommand(info.packageManager);
+  changes.push(await mcpChange(root, ".mcp.json", mcp));
+  if (targets.includes("cursor")) {
+    changes.push(await mcpChange(root, join2(".cursor", "mcp.json"), mcp));
+  }
+  if (useUnplugin && info.viteConfig) {
+    const wired = await wireViteConfig(root, info.viteConfig);
+    if (wired) changes.push(wired);
+    else
+      messages.push(
+        `Could not automatically wire ${info.viteConfig}. Add: import clicksmith from '@clicksmith/unplugin/vite'; and put clicksmith() first in plugins.`
+      );
+  } else if (useUnplugin) {
+    messages.push("No Vite config found \u2014 add the @clicksmith/unplugin plugin to your bundler manually.");
+  } else {
+    messages.push(
+      `Stable source locators via unplugin aren't available for this stack; ClickSmith will use ${info.stableAttrs.length ? `your attributes (${info.stableAttrs.join(", ")})` : "attribute/behavioral/DOM"} as the fallback locator (source \u2192 attr \u2192 behavioral \u2192 dom).`
+    );
+  }
+  changes.push(await packageJsonChange(root, useUnplugin));
+  changes.push(await gitignoreChange(root));
+  nextSteps.push(
+    `${installCmd(info.packageManager)}   # install the new dependencies`,
+    `${runCmd(info.packageManager, "clicksmith daemon")}   # start the localhost daemon`,
+    "Load the ClickSmith extension, toggle AI Mode, and Alt+Click an element."
+  );
+  return { changes, messages, nextSteps };
+}
+async function applyPlan(root, plan) {
+  const written = [];
+  for (const change of plan.changes) {
+    if (change.action === "skip") continue;
+    const full = join2(root, change.path);
+    await mkdir(dirname(full), { recursive: true });
+    await writeFile(full, change.contents, "utf8");
+    written.push(change);
+  }
+  return written;
+}
+function mcpCommand(pm) {
+  switch (pm) {
+    case "pnpm":
+      return { command: "pnpm", args: ["exec", "clicksmith", "mcp"] };
+    case "yarn":
+      return { command: "yarn", args: ["clicksmith", "mcp"] };
+    case "bun":
+      return { command: "bunx", args: ["clicksmith", "mcp"] };
+    case "npm":
+      return { command: "npx", args: ["clicksmith", "mcp"] };
+  }
+}
+async function mcpChange(root, path, spec) {
+  const existingRaw = await readText(join2(root, path));
+  let doc = {};
+  if (existingRaw) {
+    try {
+      doc = JSON.parse(existingRaw);
+    } catch {
+      doc = {};
+    }
+  }
+  doc.mcpServers = { ...doc.mcpServers ?? {}, clicksmith: spec };
+  return {
+    path,
+    action: existingRaw == null ? "create" : "merge",
+    contents: `${JSON.stringify(doc, null, 2)}
+`
+  };
+}
+async function wireViteConfig(root, relPath) {
+  const file = join2(root, relPath);
+  const code = await readText(file);
+  if (code == null) return null;
+  if (code.includes("@clicksmith/unplugin")) {
+    return { path: relPath, action: "skip", contents: code, reason: "already wired" };
+  }
+  const importLine = `import clicksmith from '@clicksmith/unplugin/vite';
+`;
+  const pluginsMatch = code.match(/plugins\s*:\s*\[/);
+  if (!pluginsMatch) return null;
+  const idx = pluginsMatch.index + pluginsMatch[0].length;
+  const next = importLine + code.slice(0, idx) + "clicksmith(), " + code.slice(idx);
+  return { path: relPath, action: "merge", contents: next };
+}
+async function packageJsonChange(root, useUnplugin) {
+  const raw = await readText(join2(root, "package.json"));
+  const pkg = raw ? JSON.parse(raw) : { name: "project", version: "0.0.0" };
+  pkg.devDependencies = { ...pkg.devDependencies ?? {} };
+  pkg.devDependencies["@clicksmith/daemon"] = pkg.devDependencies["@clicksmith/daemon"] ?? "latest";
+  if (useUnplugin) {
+    pkg.devDependencies["@clicksmith/unplugin"] = pkg.devDependencies["@clicksmith/unplugin"] ?? "latest";
+  }
+  return {
+    path: "package.json",
+    action: raw == null ? "create" : "merge",
+    contents: `${JSON.stringify(pkg, null, 2)}
+`
+  };
+}
+async function gitignoreChange(root) {
+  const existing = await readText(join2(root, ".gitignore"));
+  if (existing?.split(/\r?\n/).some((l) => l.trim() === ".clicksmith/" || l.trim() === ".clicksmith")) {
+    return { path: ".gitignore", action: "skip", contents: existing };
+  }
+  const contents = existing ? `${existing.trimEnd()}
+
+# ClickSmith runtime state
+.clicksmith/
+` : "# ClickSmith runtime state\n.clicksmith/\n";
+  return { path: ".gitignore", action: existing == null ? "create" : "merge", contents };
+}
+function installCmd(pm) {
+  return pm === "npm" ? "npm install" : `${pm} install`;
+}
+function runCmd(pm, script) {
+  switch (pm) {
+    case "pnpm":
+      return `pnpm exec ${script}`;
+    case "yarn":
+      return `yarn ${script}`;
+    case "bun":
+      return `bunx ${script}`;
+    case "npm":
+      return `npx ${script}`;
+  }
+}
+async function readText(file) {
+  try {
+    return await readFile2(file, "utf8");
+  } catch {
+    return void 0;
+  }
+}
+
+export {
+  detectProject,
+  planInstall,
+  applyPlan
+};
+//# sourceMappingURL=chunk-WEMLICDQ.js.map

package/dist/chunk-WEMLICDQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/detect.ts","../src/install.ts"],"sourcesContent":["import { readFile, readdir } from 'node:fs/promises';\nimport { join } from 'node:path';\n\nexport type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';\nexport type Bundler = 'vite' | 'webpack' | 'rspack' | 'rollup' | 'next' | 'unknown';\nexport type Framework = 'react' | 'vue' | 'svelte' | 'angular' | 'solid' | 'unknown';\n\nexport interface ProjectInfo {\n  root: string;\n  packageManager: PackageManager;\n  bundler: Bundler;\n  framework: Framework;\n  /** Stable attributes already used in the codebase (e.g. data-testid). */\n  stableAttrs: string[];\n  /** Whether the dev-only data-loc unplugin can be wired up for this stack. */\n  supportsUnplugin: boolean;\n  /** Path to the detected Vite config, if any (relative to root). */\n  viteConfig?: string;\n}\n\nconst KNOWN_STABLE_ATTRS = ['data-testid', 'data-test', 'data-cy', 'data-qa'];\n\n/** Inspect a project directory and infer its stack. Read-only. */\nexport async function detectProject(root: string): Promise<ProjectInfo> {\n  const pkg = await readJson(join(root, 'package.json'));\n  const deps = { ...(pkg?.dependencies ?? {}), ...(pkg?.devDependencies ?? {}) } as Record<string, string>;\n\n  const packageManager = await detectPackageManager(root);\n  const bundler = detectBundler(deps);\n  const framework = detectFramework(deps);\n  const viteConfig = await findFile(root, ['vite.config.ts', 'vite.config.js', 'vite.config.mjs']);\n  const stableAttrs = await scanStableAttrs(root);\n\n  const supportsUnplugin =\n    framework === 'react' && ['vite', 'webpack', 'rspack', 'rollup'].includes(bundler);\n\n  return {\n    root,\n    packageManager,\n    bundler,\n    framework,\n    stableAttrs,\n    supportsUnplugin,\n    ...(viteConfig ? { viteConfig } : {}),\n  };\n}\n\nasync function detectPackageManager(root: string): Promise<PackageManager> {\n  if (await fileExists(join(root, 'pnpm-lock.yaml'))) return 'pnpm';\n  if (await fileExists(join(root, 'yarn.lock'))) return 'yarn';\n  if (await fileExists(join(root, 'bun.lockb'))) return 'bun';\n  return 'npm';\n}\n\nfunction detectBundler(deps: Record<string, string>): Bundler {\n  if (deps.next) return 'next';\n  if (deps.vite) return 'vite';\n  if (deps['@rspack/core']) return 'rspack';\n  if (deps.webpack) return 'webpack';\n  if (deps.rollup) return 'rollup';\n  return 'unknown';\n}\n\nfunction detectFramework(deps: Record<string, string>): Framework {\n  if (deps['@angular/core']) return 'angular';\n  if (deps.svelte) return 'svelte';\n  if (deps.vue) return 'vue';\n  if (deps['solid-js']) return 'solid';\n  if (deps.react) return 'react';\n  return 'unknown';\n}\n\n/** Scan a handful of source files for stable test/id attributes. */\nasync function scanStableAttrs(root: string): Promise<string[]> {\n  const found = new Set<string>();\n  const dirs = ['src', 'app', 'components'];\n  for (const dir of dirs) {\n    const files = await listSourceFiles(join(root, dir), 40);\n    for (const file of files) {\n      const content = await safeRead(file);\n      if (!content) continue;\n      for (const attr of KNOWN_STABLE_ATTRS) {\n        if (content.includes(attr)) found.add(attr);\n      }\n      if (found.size === KNOWN_STABLE_ATTRS.length) return [...found];\n    }\n  }\n  return [...found];\n}\n\nasync function listSourceFiles(dir: string, limit: number): Promise<string[]> {\n  const out: string[] = [];\n  async function walk(d: string) {\n    if (out.length >= limit) return;\n    let entries;\n    try {\n      entries = await readdir(d, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      if (out.length >= limit) return;\n      if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue;\n      const full = join(d, entry.name);\n      if (entry.isDirectory()) await walk(full);\n      else if (/\\.(jsx?|tsx?|vue|svelte)$/.test(entry.name)) out.push(full);\n    }\n  }\n  await walk(dir);\n  return out;\n}\n\nasync function findFile(root: string, names: string[]): Promise<string | undefined> {\n  for (const name of names) {\n    if (await fileExists(join(root, name))) return name;\n  }\n  return undefined;\n}\n\nasync function readJson(file: string): Promise<Record<string, unknown> | undefined> {\n  const raw = await safeRead(file);\n  if (!raw) return undefined;\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function safeRead(file: string): Promise<string | undefined> {\n  try {\n    return await readFile(file, 'utf8');\n  } catch {\n    return undefined;\n  }\n}\n\nasync function fileExists(file: string): Promise<boolean> {\n  return (await safeRead(file)) !== undefined;\n}\n","import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport {\n  applyManagedBlock,\n  DEFAULT_AGENTS_CONFIG,\n  mergeAgentsConfig,\n  parseAgentsConfig,\n  renderInstructions,\n  type InstructionTarget,\n} from '@clicksmith/agent-config';\nimport { DEFAULT_DAEMON_PORT } from '@clicksmith/core';\nimport type { PackageManager, ProjectInfo } from './detect.js';\n\nexport interface InstallOptions {\n  /** Which agents to render instruction files for. */\n  agents?: InstructionTarget[];\n  /** Wire the dev-only data-loc unplugin. Defaults to detection. */\n  useUnplugin?: boolean;\n  daemonPort?: number;\n}\n\nexport interface FileChange {\n  path: string;\n  action: 'create' | 'merge' | 'skip';\n  contents: string;\n  reason?: string;\n}\n\nexport interface InstallPlan {\n  changes: FileChange[];\n  messages: string[];\n  nextSteps: string[];\n}\n\nconst DEFAULT_AGENT_TARGETS: InstructionTarget[] = ['claude', 'cursor', 'codex', 'generic'];\n\n/**\n * Compute every file change needed to install ClickSmith into a project,\n * reading existing files so merges preserve user content. Nothing is written —\n * call {@link applyPlan} for that. This split keeps the installer fully testable.\n */\nexport async function planInstall(info: ProjectInfo, options: InstallOptions = {}): Promise<InstallPlan> {\n  const root = info.root;\n  const targets = options.agents ?? DEFAULT_AGENT_TARGETS;\n  const useUnplugin = options.useUnplugin ?? info.supportsUnplugin;\n  const port = options.daemonPort ?? DEFAULT_DAEMON_PORT;\n\n  const changes: FileChange[] = [];\n  const messages: string[] = [];\n  const nextSteps: string[] = [];\n\n  // 1. Agent instruction files (managed blocks preserve user content).\n  for (const target of targets) {\n    const rendered = renderInstructions(target, { stableAttrs: info.stableAttrs, daemonPort: port });\n    const existing = await readText(join(root, rendered.path));\n    const contents = rendered.shared\n      ? applyManagedBlock(existing, rendered.content)\n      : rendered.content;\n    changes.push({\n      path: rendered.path,\n      action: existing == null ? 'create' : 'merge',\n      contents,\n    });\n  }\n\n  // 2. agents.config.json — merge defaults with any existing project config.\n  const configPath = join('.clicksmith', 'agents.config.json');\n  const existingConfigRaw = await readText(join(root, configPath));\n  let merged = DEFAULT_AGENTS_CONFIG;\n  if (existingConfigRaw) {\n    try {\n      const parsed = parseAgentsConfig(JSON.parse(existingConfigRaw));\n      if (parsed.ok) merged = mergeAgentsConfig(DEFAULT_AGENTS_CONFIG, parsed.config);\n    } catch {\n      messages.push('Existing agents.config.json was invalid JSON; left it untouched.');\n    }\n  }\n  changes.push({\n    path: configPath,\n    action: existingConfigRaw == null ? 'create' : 'merge',\n    contents: `${JSON.stringify(merged, null, 2)}\\n`,\n  });\n\n  // 3. MCP registration for the daemon's stdio server.\n  const mcp = mcpCommand(info.packageManager);\n  changes.push(await mcpChange(root, '.mcp.json', mcp));\n  if (targets.includes('cursor')) {\n    changes.push(await mcpChange(root, join('.cursor', 'mcp.json'), mcp));\n  }\n\n  // 4. Wire the data-loc unplugin (best effort) + record the dependency.\n  if (useUnplugin && info.viteConfig) {\n    const wired = await wireViteConfig(root, info.viteConfig);\n    if (wired) changes.push(wired);\n    else\n      messages.push(\n        `Could not automatically wire ${info.viteConfig}. Add: import clicksmith from '@clicksmith/unplugin/vite'; and put clicksmith() first in plugins.`,\n      );\n  } else if (useUnplugin) {\n    messages.push('No Vite config found — add the @clicksmith/unplugin plugin to your bundler manually.');\n  } else {\n    messages.push(\n      `Stable source locators via unplugin aren't available for this stack; ClickSmith will use ${\n        info.stableAttrs.length ? `your attributes (${info.stableAttrs.join(', ')})` : 'attribute/behavioral/DOM'\n      } as the fallback locator (source → attr → behavioral → dom).`,\n    );\n  }\n\n  // 5. package.json — add the dependencies needed for the bin + plugin.\n  changes.push(await packageJsonChange(root, useUnplugin));\n\n  // 6. Ensure .clicksmith/ is gitignored.\n  changes.push(await gitignoreChange(root));\n\n  nextSteps.push(\n    `${installCmd(info.packageManager)}   # install the new dependencies`,\n    `${runCmd(info.packageManager, 'clicksmith daemon')}   # start the localhost daemon`,\n    'Load the ClickSmith extension, toggle AI Mode, and Alt+Click an element.',\n  );\n\n  return { changes, messages, nextSteps };\n}\n\n/** Apply a plan to disk, writing create/merge changes and skipping the rest. */\nexport async function applyPlan(root: string, plan: InstallPlan): Promise<FileChange[]> {\n  const written: FileChange[] = [];\n  for (const change of plan.changes) {\n    if (change.action === 'skip') continue;\n    const full = join(root, change.path);\n    await mkdir(dirname(full), { recursive: true });\n    await writeFile(full, change.contents, 'utf8');\n    written.push(change);\n  }\n  return written;\n}\n\n/* ------------------------------- helpers ---------------------------------- */\n\ninterface McpServerSpec {\n  command: string;\n  args: string[];\n}\n\nfunction mcpCommand(pm: PackageManager): McpServerSpec {\n  switch (pm) {\n    case 'pnpm':\n      return { command: 'pnpm', args: ['exec', 'clicksmith', 'mcp'] };\n    case 'yarn':\n      return { command: 'yarn', args: ['clicksmith', 'mcp'] };\n    case 'bun':\n      return { command: 'bunx', args: ['clicksmith', 'mcp'] };\n    case 'npm':\n      return { command: 'npx', args: ['clicksmith', 'mcp'] };\n  }\n}\n\nasync function mcpChange(root: string, path: string, spec: McpServerSpec): Promise<FileChange> {\n  const existingRaw = await readText(join(root, path));\n  let doc: { mcpServers?: Record<string, unknown> } = {};\n  if (existingRaw) {\n    try {\n      doc = JSON.parse(existingRaw);\n    } catch {\n      doc = {};\n    }\n  }\n  doc.mcpServers = { ...(doc.mcpServers ?? {}), clicksmith: spec };\n  return {\n    path,\n    action: existingRaw == null ? 'create' : 'merge',\n    contents: `${JSON.stringify(doc, null, 2)}\\n`,\n  };\n}\n\nasync function wireViteConfig(root: string, relPath: string): Promise<FileChange | null> {\n  const file = join(root, relPath);\n  const code = await readText(file);\n  if (code == null) return null;\n  if (code.includes('@clicksmith/unplugin')) {\n    return { path: relPath, action: 'skip', contents: code, reason: 'already wired' };\n  }\n  const importLine = `import clicksmith from '@clicksmith/unplugin/vite';\\n`;\n  // Insert plugin first in the array so it runs before the framework plugin.\n  const pluginsMatch = code.match(/plugins\\s*:\\s*\\[/);\n  if (!pluginsMatch) return null;\n  const idx = pluginsMatch.index! + pluginsMatch[0].length;\n  const next = importLine + code.slice(0, idx) + 'clicksmith(), ' + code.slice(idx);\n  return { path: relPath, action: 'merge', contents: next };\n}\n\nasync function packageJsonChange(root: string, useUnplugin: boolean): Promise<FileChange> {\n  const raw = await readText(join(root, 'package.json'));\n  const pkg = raw ? JSON.parse(raw) : { name: 'project', version: '0.0.0' };\n  pkg.devDependencies = { ...(pkg.devDependencies ?? {}) };\n  pkg.devDependencies['@clicksmith/daemon'] = pkg.devDependencies['@clicksmith/daemon'] ?? 'latest';\n  if (useUnplugin) {\n    pkg.devDependencies['@clicksmith/unplugin'] = pkg.devDependencies['@clicksmith/unplugin'] ?? 'latest';\n  }\n  return {\n    path: 'package.json',\n    action: raw == null ? 'create' : 'merge',\n    contents: `${JSON.stringify(pkg, null, 2)}\\n`,\n  };\n}\n\nasync function gitignoreChange(root: string): Promise<FileChange> {\n  const existing = await readText(join(root, '.gitignore'));\n  if (existing?.split(/\\r?\\n/).some((l) => l.trim() === '.clicksmith/' || l.trim() === '.clicksmith')) {\n    return { path: '.gitignore', action: 'skip', contents: existing };\n  }\n  const contents = existing\n    ? `${existing.trimEnd()}\\n\\n# ClickSmith runtime state\\n.clicksmith/\\n`\n    : '# ClickSmith runtime state\\n.clicksmith/\\n';\n  return { path: '.gitignore', action: existing == null ? 'create' : 'merge', contents };\n}\n\nfunction installCmd(pm: PackageManager): string {\n  return pm === 'npm' ? 'npm install' : `${pm} install`;\n}\n\nfunction runCmd(pm: PackageManager, script: string): string {\n  switch (pm) {\n    case 'pnpm':\n      return `pnpm exec ${script}`;\n    case 'yarn':\n      return `yarn ${script}`;\n    case 'bun':\n      return `bunx ${script}`;\n    case 'npm':\n      return `npx ${script}`;\n  }\n}\n\nasync function readText(file: string): Promise<string | undefined> {\n  try {\n    return await readFile(file, 'utf8');\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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","names":["readFile","join"]}

package/dist/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import {
+  applyPlan,
+  detectProject,
+  planInstall
+} from "./chunk-WEMLICDQ.js";
+
+// src/cli.ts
+var HELP = `create-clicksmith
+
+Usage:
+  create-clicksmith [dir] [--dry-run] [--no-unplugin] [--agents claude,cursor,codex,generic]
+
+Detects your stack, wires stable locators, writes agent instruction files,
+merges agents.config.json, and registers the ClickSmith MCP server. Existing
+files are preserved (managed blocks / JSON merges).
+`;
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    process.stdout.write(HELP);
+    return;
+  }
+  const positional = args.find((a) => !a.startsWith("--"));
+  const root = positional ? resolveDir(positional) : process.cwd();
+  const dryRun = args.includes("--dry-run");
+  const useUnplugin = !args.includes("--no-unplugin");
+  const agentsArg = valueOf(args, "--agents");
+  const agents = agentsArg ? agentsArg.split(",") : void 0;
+  log(`\u2692\uFE0F  ClickSmith installer
+`);
+  const info = await detectProject(root);
+  log(`Detected:`);
+  log(`  package manager : ${info.packageManager}`);
+  log(`  bundler         : ${info.bundler}`);
+  log(`  framework       : ${info.framework}`);
+  log(`  stable attrs    : ${info.stableAttrs.join(", ") || "(none found)"}`);
+  log(`  unplugin        : ${info.supportsUnplugin ? "supported" : "not available for this stack"}`);
+  log("");
+  const plan = await planInstall(info, {
+    ...agents ? { agents } : {},
+    useUnplugin: useUnplugin && info.supportsUnplugin
+  });
+  log(`Planned changes:`);
+  for (const change of plan.changes) {
+    const mark = change.action === "create" ? "+" : change.action === "merge" ? "~" : "\xB7";
+    log(`  ${mark} ${change.path}${change.action === "skip" ? ` (${change.reason ?? "unchanged"})` : ""}`);
+  }
+  log("");
+  if (dryRun) {
+    log("--dry-run: no files written.");
+  } else {
+    const written = await applyPlan(root, plan);
+    log(`Wrote ${written.length} file(s).`);
+  }
+  for (const message of plan.messages) log(`\u2139\uFE0F  ${message}`);
+  log("\nNext steps:");
+  for (const step of plan.nextSteps) log(`  ${step}`);
+}
+function resolveDir(dir) {
+  return dir.startsWith("/") ? dir : `${process.cwd()}/${dir}`;
+}
+function valueOf(args, flag) {
+  const i = args.indexOf(flag);
+  return i !== -1 && args[i + 1] && !args[i + 1].startsWith("--") ? args[i + 1] : void 0;
+}
+function log(line) {
+  process.stdout.write(`${line}
+`);
+}
+main().catch((err) => {
+  process.stderr.write(`create-clicksmith failed: ${err instanceof Error ? err.stack : String(err)}
+`);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { detectProject } from './detect.js';\nimport { applyPlan, planInstall } from './install.js';\n\nconst HELP = `create-clicksmith\n\nUsage:\n  create-clicksmith [dir] [--dry-run] [--no-unplugin] [--agents claude,cursor,codex,generic]\n\nDetects your stack, wires stable locators, writes agent instruction files,\nmerges agents.config.json, and registers the ClickSmith MCP server. Existing\nfiles are preserved (managed blocks / JSON merges).\n`;\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n  if (args.includes('--help') || args.includes('-h')) {\n    process.stdout.write(HELP);\n    return;\n  }\n\n  const positional = args.find((a) => !a.startsWith('--'));\n  const root = positional ? resolveDir(positional) : process.cwd();\n  const dryRun = args.includes('--dry-run');\n  const useUnplugin = !args.includes('--no-unplugin');\n  const agentsArg = valueOf(args, '--agents');\n  const agents = agentsArg ? (agentsArg.split(',') as never) : undefined;\n\n  log(`⚒️  ClickSmith installer\\n`);\n  const info = await detectProject(root);\n  log(`Detected:`);\n  log(`  package manager : ${info.packageManager}`);\n  log(`  bundler         : ${info.bundler}`);\n  log(`  framework       : ${info.framework}`);\n  log(`  stable attrs    : ${info.stableAttrs.join(', ') || '(none found)'}`);\n  log(`  unplugin        : ${info.supportsUnplugin ? 'supported' : 'not available for this stack'}`);\n  log('');\n\n  const plan = await planInstall(info, {\n    ...(agents ? { agents } : {}),\n    useUnplugin: useUnplugin && info.supportsUnplugin,\n  });\n\n  log(`Planned changes:`);\n  for (const change of plan.changes) {\n    const mark = change.action === 'create' ? '+' : change.action === 'merge' ? '~' : '·';\n    log(`  ${mark} ${change.path}${change.action === 'skip' ? ` (${change.reason ?? 'unchanged'})` : ''}`);\n  }\n  log('');\n\n  if (dryRun) {\n    log('--dry-run: no files written.');\n  } else {\n    const written = await applyPlan(root, plan);\n    log(`Wrote ${written.length} file(s).`);\n  }\n\n  for (const message of plan.messages) log(`ℹ️  ${message}`);\n  log('\\nNext steps:');\n  for (const step of plan.nextSteps) log(`  ${step}`);\n}\n\nfunction resolveDir(dir: string): string {\n  return dir.startsWith('/') ? dir : `${process.cwd()}/${dir}`;\n}\n\nfunction valueOf(args: string[], flag: string): string | undefined {\n  const i = args.indexOf(flag);\n  return i !== -1 && args[i + 1] && !args[i + 1]!.startsWith('--') ? args[i + 1] : undefined;\n}\n\nfunction log(line: string): void {\n  process.stdout.write(`${line}\\n`);\n}\n\nmain().catch((err) => {\n  process.stderr.write(`create-clicksmith failed: ${err instanceof Error ? err.stack : String(err)}\\n`);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;;AAIA,IAAM,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUb,eAAe,OAAsB;AACnC,QAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,MAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;AAClD,YAAQ,OAAO,MAAM,IAAI;AACzB;AAAA,EACF;AAEA,QAAM,aAAa,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,IAAI,CAAC;AACvD,QAAM,OAAO,aAAa,WAAW,UAAU,IAAI,QAAQ,IAAI;AAC/D,QAAM,SAAS,KAAK,SAAS,WAAW;AACxC,QAAM,cAAc,CAAC,KAAK,SAAS,eAAe;AAClD,QAAM,YAAY,QAAQ,MAAM,UAAU;AAC1C,QAAM,SAAS,YAAa,UAAU,MAAM,GAAG,IAAc;AAE7D,MAAI;AAAA,CAA4B;AAChC,QAAM,OAAO,MAAM,cAAc,IAAI;AACrC,MAAI,WAAW;AACf,MAAI,uBAAuB,KAAK,cAAc,EAAE;AAChD,MAAI,uBAAuB,KAAK,OAAO,EAAE;AACzC,MAAI,uBAAuB,KAAK,SAAS,EAAE;AAC3C,MAAI,uBAAuB,KAAK,YAAY,KAAK,IAAI,KAAK,cAAc,EAAE;AAC1E,MAAI,uBAAuB,KAAK,mBAAmB,cAAc,8BAA8B,EAAE;AACjG,MAAI,EAAE;AAEN,QAAM,OAAO,MAAM,YAAY,MAAM;AAAA,IACnC,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC3B,aAAa,eAAe,KAAK;AAAA,EACnC,CAAC;AAED,MAAI,kBAAkB;AACtB,aAAW,UAAU,KAAK,SAAS;AACjC,UAAM,OAAO,OAAO,WAAW,WAAW,MAAM,OAAO,WAAW,UAAU,MAAM;AAClF,QAAI,KAAK,IAAI,IAAI,OAAO,IAAI,GAAG,OAAO,WAAW,SAAS,KAAK,OAAO,UAAU,WAAW,MAAM,EAAE,EAAE;AAAA,EACvG;AACA,MAAI,EAAE;AAEN,MAAI,QAAQ;AACV,QAAI,8BAA8B;AAAA,EACpC,OAAO;AACL,UAAM,UAAU,MAAM,UAAU,MAAM,IAAI;AAC1C,QAAI,SAAS,QAAQ,MAAM,WAAW;AAAA,EACxC;AAEA,aAAW,WAAW,KAAK,SAAU,KAAI,iBAAO,OAAO,EAAE;AACzD,MAAI,eAAe;AACnB,aAAW,QAAQ,KAAK,UAAW,KAAI,KAAK,IAAI,EAAE;AACpD;AAEA,SAAS,WAAW,KAAqB;AACvC,SAAO,IAAI,WAAW,GAAG,IAAI,MAAM,GAAG,QAAQ,IAAI,CAAC,IAAI,GAAG;AAC5D;AAEA,SAAS,QAAQ,MAAgB,MAAkC;AACjE,QAAM,IAAI,KAAK,QAAQ,IAAI;AAC3B,SAAO,MAAM,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAG,WAAW,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;AACnF;AAEA,SAAS,IAAI,MAAoB;AAC/B,UAAQ,OAAO,MAAM,GAAG,IAAI;AAAA,CAAI;AAClC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,OAAO,MAAM,6BAA6B,eAAe,QAAQ,IAAI,QAAQ,OAAO,GAAG,CAAC;AAAA,CAAI;AACpG,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { InstructionTarget } from '@clicksmith/agent-config';
+
+type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';
+type Bundler = 'vite' | 'webpack' | 'rspack' | 'rollup' | 'next' | 'unknown';
+type Framework = 'react' | 'vue' | 'svelte' | 'angular' | 'solid' | 'unknown';
+interface ProjectInfo {
+    root: string;
+    packageManager: PackageManager;
+    bundler: Bundler;
+    framework: Framework;
+    /** Stable attributes already used in the codebase (e.g. data-testid). */
+    stableAttrs: string[];
+    /** Whether the dev-only data-loc unplugin can be wired up for this stack. */
+    supportsUnplugin: boolean;
+    /** Path to the detected Vite config, if any (relative to root). */
+    viteConfig?: string;
+}
+/** Inspect a project directory and infer its stack. Read-only. */
+declare function detectProject(root: string): Promise<ProjectInfo>;
+
+interface InstallOptions {
+    /** Which agents to render instruction files for. */
+    agents?: InstructionTarget[];
+    /** Wire the dev-only data-loc unplugin. Defaults to detection. */
+    useUnplugin?: boolean;
+    daemonPort?: number;
+}
+interface FileChange {
+    path: string;
+    action: 'create' | 'merge' | 'skip';
+    contents: string;
+    reason?: string;
+}
+interface InstallPlan {
+    changes: FileChange[];
+    messages: string[];
+    nextSteps: string[];
+}
+/**
+ * Compute every file change needed to install ClickSmith into a project,
+ * reading existing files so merges preserve user content. Nothing is written —
+ * call {@link applyPlan} for that. This split keeps the installer fully testable.
+ */
+declare function planInstall(info: ProjectInfo, options?: InstallOptions): Promise<InstallPlan>;
+/** Apply a plan to disk, writing create/merge changes and skipping the rest. */
+declare function applyPlan(root: string, plan: InstallPlan): Promise<FileChange[]>;
+
+export { type Bundler, type FileChange, type Framework, type InstallOptions, type InstallPlan, type PackageManager, type ProjectInfo, applyPlan, detectProject, planInstall };

package/dist/index.js

@@ -0,0 +1,11 @@
+import {
+  applyPlan,
+  detectProject,
+  planInstall
+} from "./chunk-WEMLICDQ.js";
+export {
+  applyPlan,
+  detectProject,
+  planInstall
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "create-clicksmith",
+  "version": "0.1.0",
+  "description": "Project installer for ClickSmith: detect your stack, wire stable locators, write agent instructions, merge agents.config.json, and register the MCP server.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "create-clicksmith": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clicksmith/agent-config": "0.1.0",
+    "@clicksmith/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rimraf dist .turbo"
+  }
+}