@flydocs/cli 0.5.0-beta.1 → 0.5.0-beta.10

package/dist/cli.js

@@ -15,7 +15,7 @@ var CLI_VERSION, CLI_NAME, PACKAGE_NAME;
 var init_constants = __esm({
   "src/lib/constants.ts"() {
     "use strict";
-    CLI_VERSION = "0.5.0-beta.1";
+    CLI_VERSION = "0.5.0-beta.10";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
   }
@@ -136,6 +136,9 @@ var init_template = __esm({
 
 // src/lib/ui.ts
 import pc2 from "picocolors";
+function hyperlink(text3, url) {
+  return `\x1B]8;;${url}\x1B\\${text3}\x1B]8;;\x1B\\`;
+}
 function printStatus(message) {
   console.log(`${pc2.green("\u2714")} ${message}`);
 }
@@ -148,25 +151,27 @@ function printError(message) {
 function printInfo(message) {
   console.log(`${pc2.cyan("\u2139")} ${message}`);
 }
-function printStub(command) {
-  printWarning(`${pc2.bold(command)} is not yet implemented in the Node CLI.`);
-  console.log(`  Use ${pc2.cyan("bash install.sh")} for now.`);
-}
 function printBanner(version) {
-  const pink = pc2.magenta;
-  const purple = (t) => pc2.cyan(t);
+  const pink = (t) => pc2.bold(pc2.magenta(t));
+  const purple = (t) => pc2.bold(pc2.cyan(t));
   const dim = pc2.dim;
   const bold = pc2.bold;
+  const pinkBlock12 = pink("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588");
+  const pinkBlock4 = pink("\u2588\u2588\u2588\u2588");
+  const purpleBlock12 = purple("\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588");
+  const purpleBlock4 = purple("\u2588\u2588\u2588\u2588");
   console.log();
-  console.log(`  ${bold(pink("\u2588\u2588\u2588\u2588\u2588\u2588"))}`);
+  console.log(`  ${pinkBlock12}`);
+  console.log(`  ${pinkBlock12}`);
+  console.log(`  ${pinkBlock4}`);
   console.log(
-    `  ${bold(pink("\u2588\u2588"))}      ${bold(purple("\u2588\u2588\u2588\u2588\u2588\u2588"))}  ${bold(pink("Fly"))}${bold(purple("Docs"))} ${bold(pink("Core"))}`
+    `  ${pinkBlock4}  ${purpleBlock12}  ${bold("FlyDocs")} ${dim("(Beta)")}`
   );
   console.log(
-    `        ${bold(purple("\u2588\u2588\u2588\u2588\u2588\u2588"))}  ${dim("Context-as-a-Service Platform Built for Engineering at Altitude")}`
+    `        ${purpleBlock12}  ${dim("Spec-Driven Context That Helps Engineers Fly")}`
   );
-  console.log(`        ${bold(purple("\u2588\u2588"))}`);
-  console.log(`        ${bold(purple("\u2588\u2588"))}      ${dim(`v${version}`)}`);
+  console.log(`        ${purpleBlock4}`);
+  console.log(`        ${purpleBlock4}          ${dim(`v${version}`)}`);
   console.log();
 }
 function printCompletionBox(title, lines) {
@@ -187,17 +192,16 @@ function printCompletionBox(title, lines) {
 }
 function printBetaCta() {
   const dim = pc2.dim;
+  const url = "https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta";
   console.log(
     dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")
   );
   console.log();
   console.log(`  ${pc2.bold("Join the FlyDocs Closed Beta")}`);
   console.log(
-    `  ${dim("Early access to cloud features, priority support, and more.")}`
-  );
-  console.log(
-    `  ${pc2.cyan("https://www.flydocs.ai?utm_source=cli&utm_medium=install&utm_campaign=beta")}`
+    `  ${dim("Early access to cloud features, web portal, and more.")}`
   );
+  console.log(`  ${pc2.cyan(hyperlink("flydocs.ai", url))}`);
   console.log();
 }
 var init_ui = __esm({
@@ -237,7 +241,6 @@ function extractPreservedValues(config) {
     issueLabels: config.issueLabels ?? {},
     statusMapping: config.statusMapping ?? {},
     detectedStack: config.detectedStack ?? {},
-    mcp: config.mcp ?? {},
     skills: config.skills ?? {},
     designSystem: config.designSystem ?? null,
     aiLabor: config.aiLabor ?? {}
@@ -270,9 +273,6 @@ async function mergeConfig(templateDir, version, tierFlag, preserved) {
   if (Object.keys(preserved.detectedStack).length > 0) {
     config.detectedStack = preserved.detectedStack;
   }
-  if (Object.keys(preserved.mcp).length > 0) {
-    config.mcp = preserved.mcp;
-  }
   if (Object.keys(preserved.skills).length > 0) {
     config.skills = preserved.skills;
   }
@@ -317,12 +317,6 @@ async function installOwnedSkills(templateDir, targetDir, tier) {
       await replaceDirectory(src, join4(skillsDir, skill));
     }
   }
-  for (const skill of SUPPORTING_SKILLS) {
-    const src = join4(templateSkillsDir, skill);
-    if (await pathExists(src)) {
-      await replaceDirectory(src, join4(skillsDir, skill));
-    }
-  }
   const readmeSrc = join4(templateSkillsDir, "README.md");
   if (await pathExists(readmeSrc)) {
     await copyFile(readmeSrc, join4(skillsDir, "README.md"));
@@ -331,7 +325,7 @@ async function installOwnedSkills(templateDir, targetDir, tier) {
 async function replaceOwnedSkills(templateDir, targetDir, tier) {
   const skillsDir = join4(targetDir, ".claude", "skills");
   const templateSkillsDir = join4(templateDir, ".claude", "skills");
-  for (const skill of [...OWNED_SKILLS, ...SUPPORTING_SKILLS]) {
+  for (const skill of OWNED_SKILLS) {
     const src = join4(templateSkillsDir, skill);
     if (await pathExists(src)) {
       await replaceDirectory(src, join4(skillsDir, skill));
@@ -379,20 +373,18 @@ async function copyCursorRules(targetDir) {
       await copyFile(mechRule, join4(rulesDir, "flydocs-mechanism.mdc"));
     }
   }
-  for (const skill of PREMIUM_CURSOR_RULES) {
-    const skillRule = join4(
-      targetDir,
-      ".claude",
-      "skills",
-      skill,
-      "cursor-rule.mdc"
-    );
-    if (await pathExists(skillRule)) {
-      await copyFile(skillRule, join4(rulesDir, `${skill}.mdc`));
-    }
+  const context7Rule = join4(
+    targetDir,
+    ".claude",
+    "skills",
+    "flydocs-context7",
+    "cursor-rule.mdc"
+  );
+  if (await pathExists(context7Rule)) {
+    await copyFile(context7Rule, join4(rulesDir, "flydocs-context7.mdc"));
   }
 }
-var OWNED_SKILLS, SUPPORTING_SKILLS, MECHANISM_SKILLS, PREMIUM_CURSOR_RULES;
+var OWNED_SKILLS, MECHANISM_SKILLS;
 var init_skills = __esm({
   "src/lib/skills.ts"() {
     "use strict";
@@ -401,24 +393,64 @@ var init_skills = __esm({
       "flydocs-workflow",
       "flydocs-figma",
       "flydocs-estimates",
-      "flydocs-context-graph"
-    ];
-    SUPPORTING_SKILLS = [
-      "implementation-flow",
-      "review-workflow",
-      "spec-templates"
+      "flydocs-context-graph",
+      "flydocs-context7"
     ];
     MECHANISM_SKILLS = {
       local: "flydocs-local",
       cloud: "flydocs-cloud"
     };
-    PREMIUM_CURSOR_RULES = ["flydocs-figma", "flydocs-estimates"];
   }
 });
 
 // src/lib/stack.ts
 import { readFile as readFile3 } from "fs/promises";
 import { join as join5 } from "path";
+async function parseProjectMdStack(targetDir) {
+  const detected = /* @__PURE__ */ new Set();
+  const projectMdPath = join5(targetDir, "flydocs", "context", "project.md");
+  try {
+    const content = await readFile3(projectMdPath, "utf-8");
+    const stackMatch = content.match(/## Stack\n([\s\S]*?)(?=\n## |\n---|\z)/);
+    if (!stackMatch) return detected;
+    const stackSection = stackMatch[1].toLowerCase();
+    const keywordMap = {
+      "next.js": ["nextjs", "react"],
+      nextjs: ["nextjs", "react"],
+      react: ["react"],
+      vue: ["vue"],
+      nuxt: ["nuxt", "vue"],
+      angular: ["angular"],
+      svelte: ["svelte"],
+      sveltekit: ["svelte"],
+      expo: ["expo", "react"],
+      typescript: ["typescript"],
+      tailwind: ["tailwind"],
+      convex: ["convex"],
+      prisma: ["prisma"],
+      postgresql: ["prisma"],
+      clerk: ["clerk"],
+      python: ["python"],
+      django: ["python"],
+      flask: ["python"],
+      fastapi: ["python"],
+      golang: ["go"],
+      " go ": ["go"],
+      rust: ["rust"],
+      vitest: ["vitest"],
+      jest: ["jest"]
+    };
+    for (const [keyword, triggers] of Object.entries(keywordMap)) {
+      if (stackSection.includes(keyword)) {
+        for (const trigger of triggers) {
+          detected.add(trigger);
+        }
+      }
+    }
+  } catch {
+  }
+  return detected;
+}
 async function detectStack(targetDir) {
   const detected = /* @__PURE__ */ new Set();
   const pkgPath = join5(targetDir, "package.json");
@@ -433,6 +465,12 @@ async function detectStack(targetDir) {
     if ("next" in allDeps) detected.add("nextjs");
     if ("expo" in allDeps) detected.add("expo");
     if ("react" in allDeps) detected.add("react");
+    if ("vue" in allDeps) detected.add("vue");
+    if ("nuxt" in allDeps) detected.add("nuxt");
+    if (Object.keys(allDeps).some((k) => k.startsWith("@angular/")))
+      detected.add("angular");
+    if ("svelte" in allDeps || "@sveltejs/kit" in allDeps)
+      detected.add("svelte");
     if ("convex" in allDeps) detected.add("convex");
     if ("prisma" in allDeps) detected.add("prisma");
     if (Object.keys(allDeps).some((k) => k.startsWith("@clerk")))
@@ -462,14 +500,43 @@ async function detectStack(targetDir) {
   if (await pathExists(join5(targetDir, "tsconfig.json"))) {
     detected.add("typescript");
   }
+  if (await pathExists(join5(targetDir, "nuxt.config.ts")) || await pathExists(join5(targetDir, "nuxt.config.js"))) {
+    detected.add("nuxt");
+    detected.add("vue");
+  }
+  if (await pathExists(join5(targetDir, "angular.json"))) {
+    detected.add("angular");
+  }
+  if (await pathExists(join5(targetDir, "svelte.config.js")) || await pathExists(join5(targetDir, "svelte.config.ts"))) {
+    detected.add("svelte");
+  }
+  if (await pathExists(join5(targetDir, "pyproject.toml")) || await pathExists(join5(targetDir, "requirements.txt")) || await pathExists(join5(targetDir, "setup.py"))) {
+    detected.add("python");
+  }
+  if (await pathExists(join5(targetDir, "go.mod"))) {
+    detected.add("go");
+  }
+  if (await pathExists(join5(targetDir, "Cargo.toml"))) {
+    detected.add("rust");
+  }
+  const projectMdStack = await parseProjectMdStack(targetDir);
+  for (const item of projectMdStack) {
+    detected.add(item);
+  }
   const raw = Array.from(detected);
   return {
     raw,
-    frameworks: raw.filter((s) => ["nextjs", "react", "expo"].includes(s)),
+    frameworks: raw.filter(
+      (s) => ["nextjs", "react", "expo", "vue", "nuxt", "angular", "svelte"].includes(
+        s
+      )
+    ),
     database: raw.filter((s) => ["convex", "prisma"].includes(s)),
     auth: raw.filter((s) => ["clerk", "workos"].includes(s)),
     styling: raw.filter((s) => ["tailwind"].includes(s)),
-    language: raw.filter((s) => ["typescript"].includes(s)),
+    language: raw.filter(
+      (s) => ["typescript", "python", "go", "rust"].includes(s)
+    ),
     testing: raw.filter(
       (s) => ["vitest", "jest", "testing-library"].includes(s)
     )
@@ -494,7 +561,7 @@ var init_stack = __esm({
 });
 
 // src/lib/post-install.ts
-import { execSync } from "child_process";
+import { execFileSync } from "child_process";
 import { join as join6 } from "path";
 async function runManifestGeneration(targetDir) {
   const scriptPath = join6(
@@ -505,7 +572,7 @@ async function runManifestGeneration(targetDir) {
   );
   if (!await pathExists(scriptPath)) return;
   try {
-    execSync(`python3 "${scriptPath}"`, {
+    execFileSync("python3", [scriptPath], {
       cwd: targetDir,
       stdio: "pipe"
     });
@@ -525,7 +592,7 @@ async function runContextGraphBuild(targetDir) {
   );
   if (!await pathExists(scriptPath)) return;
   try {
-    execSync(`python3 "${scriptPath}"`, {
+    execFileSync("python3", [scriptPath], {
       cwd: targetDir,
       stdio: "pipe"
     });
@@ -908,6 +975,7 @@ var init_skill_manager = __esm({
 });
 
 // src/lib/community-skills.ts
+import { join as join8 } from "path";
 import { multiselect, isCancel, cancel } from "@clack/prompts";
 import pc4 from "picocolors";
 function suggestSkills(stack) {
@@ -926,7 +994,14 @@ function suggestSkills(stack) {
 }
 async function promptCommunitySkills(targetDir, stack, autoYes) {
   const suggestions = suggestSkills(stack);
-  if (suggestions.length === 0) {
+  const skillsDir = join8(targetDir, ".claude", "skills");
+  const filtered = [];
+  for (const skill of suggestions) {
+    if (!await pathExists(join8(skillsDir, skill.name))) {
+      filtered.push(skill);
+    }
+  }
+  if (filtered.length === 0) {
     printInfo("No community skills suggested for detected stack.");
     console.log(`  Browse more at: ${pc4.cyan("https://skills.sh/")}`);
     return;
@@ -941,18 +1016,20 @@ async function promptCommunitySkills(targetDir, stack, autoYes) {
   console.log();
   let selected;
   if (autoYes) {
-    selected = suggestions;
+    selected = filtered;
     console.log("  Auto-accepting all (--yes)");
   } else {
-    const options = suggestions.map((s) => ({
+    const options = filtered.map((s) => ({
       value: s,
       label: s.name,
-      hint: s.description
+      hint: s.description,
+      initialValue: true
     }));
     const result = await multiselect({
-      message: "Select community skills to install",
+      message: "Select community skills to install (space to toggle, enter to confirm)",
       options,
-      required: false
+      required: false,
+      initialValues: filtered
     });
     if (isCancel(result)) {
       cancel("Skipped community skills");
@@ -988,9 +1065,11 @@ var COMMUNITY_SKILLS_MAP;
 var init_community_skills = __esm({
   "src/lib/community-skills.ts"() {
     "use strict";
+    init_fs_ops();
     init_ui();
     init_skill_manager();
     COMMUNITY_SKILLS_MAP = [
+      // React / Next.js (Vercel official)
       {
         stackTrigger: "nextjs",
         repo: "vercel-labs/agent-skills",
@@ -1009,6 +1088,34 @@ var init_community_skills = __esm({
         name: "react-best-practices",
         description: "React performance optimization (40+ rules from Vercel)"
       },
+      // Vue / Nuxt
+      {
+        stackTrigger: "nuxt",
+        repo: "onmax/nuxt-skills",
+        name: "nuxt",
+        description: "Nuxt framework patterns and best practices"
+      },
+      {
+        stackTrigger: "vue",
+        repo: "onmax/nuxt-skills",
+        name: "vue",
+        description: "Vue.js composition API and component patterns"
+      },
+      // Angular
+      {
+        stackTrigger: "angular",
+        repo: "Jeffallan/claude-skills",
+        name: "angular-architect",
+        description: "Angular architecture, modules, and component patterns"
+      },
+      // Svelte / SvelteKit
+      {
+        stackTrigger: "svelte",
+        repo: "spences10/svelte-skills-kit",
+        name: "svelte-skills",
+        description: "Svelte 5 runes, SvelteKit routing, and component patterns"
+      },
+      // Convex
       {
         stackTrigger: "convex",
         repo: "waynesutton/convexskills",
@@ -1021,17 +1128,26 @@ var init_community_skills = __esm({
         name: "convex-functions",
         description: "Convex query/mutation/action patterns"
       },
+      // Python
       {
-        stackTrigger: "tailwind",
-        repo: "blencorp/claude-code-kit",
-        name: "tailwind-v4",
-        description: "Tailwind CSS v4 patterns and configuration"
+        stackTrigger: "python",
+        repo: "wdm0006/python-skills",
+        name: "python-skills",
+        description: "Python library quality, packaging, and testing patterns"
       },
+      // Go
       {
-        stackTrigger: "clerk",
-        repo: "blencorp/claude-code-kit",
-        name: "clerk-auth",
-        description: "Clerk authentication patterns"
+        stackTrigger: "go",
+        repo: "saisudhir14/golang-agent-skill",
+        name: "golang",
+        description: "Go concurrency, error handling, and testing patterns"
+      },
+      // Rust
+      {
+        stackTrigger: "rust",
+        repo: "leonardomso/rust-skills",
+        name: "rust-skills",
+        description: "Rust ownership, concurrency, and safety patterns (179 rules)"
       }
     ];
   }
@@ -1039,47 +1155,47 @@ var init_community_skills = __esm({
 
 // src/lib/deprecated.ts
 import { readdir as readdir2, mkdir as mkdir3, rename, rm as rm3 } from "fs/promises";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 import { confirm, isCancel as isCancel2 } from "@clack/prompts";
 async function scanDeprecated(targetDir) {
   const found = [];
   for (const item of [...DEPRECATED_DIRS, ...DEPRECATED_FILES]) {
-    if (await pathExists(join8(targetDir, item))) {
+    if (await pathExists(join9(targetDir, item))) {
       found.push(item);
     }
   }
   for (const skill of DEPRECATED_SKILLS) {
-    const p = join8(targetDir, ".claude", "skills", skill);
+    const p = join9(targetDir, ".claude", "skills", skill);
     if (await pathExists(p)) {
       found.push(`.claude/skills/${skill}`);
     }
   }
   for (const dir of DEPRECATED_RULES_DIR) {
-    if (await pathExists(join8(targetDir, dir))) {
+    if (await pathExists(join9(targetDir, dir))) {
       found.push(dir);
     }
   }
   for (const hook of DEPRECATED_HOOKS) {
-    const p = join8(targetDir, ".flydocs", "hooks", hook);
+    const p = join9(targetDir, ".flydocs", "hooks", hook);
     if (await pathExists(p)) {
       found.push(`.flydocs/hooks/${hook}`);
     }
   }
   for (const rule of DEPRECATED_CURSOR_RULES) {
-    const p = join8(targetDir, ".cursor", "rules", rule);
+    const p = join9(targetDir, ".cursor", "rules", rule);
     if (await pathExists(p)) {
       found.push(`.cursor/rules/${rule}`);
     }
   }
   for (const dir of DEPRECATED_CURSOR_RULE_DIRS) {
-    const p = join8(targetDir, ".cursor", "rules", dir);
+    const p = join9(targetDir, ".cursor", "rules", dir);
     if (await pathExists(p)) {
       found.push(`.cursor/rules/${dir}`);
     }
   }
   for (const cmd of DEPRECATED_COMMANDS) {
     for (const prefix of [".cursor/commands", ".claude/commands"]) {
-      const p = join8(targetDir, prefix, cmd);
+      const p = join9(targetDir, prefix, cmd);
       if (await pathExists(p)) {
         found.push(`${prefix}/${cmd}`);
       }
@@ -1088,12 +1204,12 @@ async function scanDeprecated(targetDir) {
   return found;
 }
 async function handleLegacyContext(targetDir) {
-  const contextDir = join8(targetDir, "flydocs", "context");
-  const legacyDir = join8(contextDir, "legacy");
+  const contextDir = join9(targetDir, "flydocs", "context");
+  const legacyDir = join9(contextDir, "legacy");
   const oldFiles = ["overview.md", "stack.md", "standards.md"];
   let hasOld = false;
   for (const f of oldFiles) {
-    if (await pathExists(join8(contextDir, f))) {
+    if (await pathExists(join9(contextDir, f))) {
       hasOld = true;
       break;
     }
@@ -1101,9 +1217,9 @@ async function handleLegacyContext(targetDir) {
   if (hasOld) {
     await mkdir3(legacyDir, { recursive: true });
     for (const f of oldFiles) {
-      const src = join8(contextDir, f);
+      const src = join9(contextDir, f);
       if (await pathExists(src)) {
-        await rename(src, join8(legacyDir, f));
+        await rename(src, join9(legacyDir, f));
         printStatus(`Moved flydocs/context/${f} \u2192 legacy/`);
       }
     }
@@ -1113,7 +1229,7 @@ async function handleLegacyContext(targetDir) {
   }
 }
 async function checkLegacyFolder(targetDir) {
-  const legacyDir = join8(targetDir, "flydocs", "context", "legacy");
+  const legacyDir = join9(targetDir, "flydocs", "context", "legacy");
   if (!await pathExists(legacyDir)) return null;
   try {
     const entries = await readdir2(legacyDir);
@@ -1143,7 +1259,7 @@ async function promptCleanup(targetDir, paths) {
     return;
   }
   for (const p of paths) {
-    await rm3(join8(targetDir, p), { recursive: true, force: true });
+    await rm3(join9(targetDir, p), { recursive: true, force: true });
     printStatus(`Deleted: ${p}`);
   }
 }
@@ -1154,19 +1270,20 @@ var init_deprecated = __esm({
     init_fs_ops();
     init_ui();
     DEPRECATED_DIRS = [".docflow", "docflow"];
-    DEPRECATED_FILES = ["AGENTS.md.bak"];
+    DEPRECATED_FILES = ["AGENTS.md.bak", ".cursor/mcp.json"];
     DEPRECATED_SKILLS = [
       "linear-workflow",
       "session-workflow",
       "ai-labor-estimate",
       "component-workflow",
-      "figma-mcp",
-      "implementation-flow",
-      "review-workflow",
-      "spec-templates"
+      "figma-mcp"
     ];
     DEPRECATED_RULES_DIR = [".flydocs/rules"];
-    DEPRECATED_HOOKS = ["linear-auto-approve.py", "session-end.py"];
+    DEPRECATED_HOOKS = [
+      "linear-auto-approve.py",
+      "session-end.py",
+      "prefer-scripts.py"
+    ];
     DEPRECATED_CURSOR_RULES = [
       "designer-agent.mdc",
       "docflow-core.mdc",
@@ -1194,9 +1311,9 @@ var init_deprecated = __esm({
 
 // src/lib/gitignore.ts
 import { readFile as readFile5, writeFile as writeFile3, appendFile } from "fs/promises";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 async function ensureGitignore(targetDir) {
-  const gitignorePath = join9(targetDir, ".gitignore");
+  const gitignorePath = join10(targetDir, ".gitignore");
   if (await pathExists(gitignorePath)) {
     const content = await readFile5(gitignorePath, "utf-8");
     if (!content.includes("# FlyDocs")) {
@@ -1210,7 +1327,7 @@ async function ensureGitignore(targetDir) {
   }
 }
 async function migrateGitignore(targetDir) {
-  const gitignorePath = join9(targetDir, ".gitignore");
+  const gitignorePath = join10(targetDir, ".gitignore");
   if (!await pathExists(gitignorePath)) return;
   const content = await readFile5(gitignorePath, "utf-8");
   if (!content.includes("flydocs/context/graph.json")) {
@@ -1294,8 +1411,10 @@ __pycache__/
 // src/lib/version.ts
 import { readFile as readFile6 } from "fs/promises";
 function compareVersions(v1, v2) {
-  const parts1 = v1.split(".").map(Number);
-  const parts2 = v2.split(".").map(Number);
+  const [core1, pre1] = v1.split("-", 2);
+  const [core2, pre2] = v2.split("-", 2);
+  const parts1 = core1.split(".").map(Number);
+  const parts2 = core2.split(".").map(Number);
   const len = Math.max(parts1.length, parts2.length);
   for (let i = 0; i < len; i++) {
     const a = parts1[i] ?? 0;
@@ -1303,6 +1422,27 @@ function compareVersions(v1, v2) {
     if (a < b) return "older";
     if (a > b) return "newer";
   }
+  if (!pre1 && pre2) return "newer";
+  if (pre1 && !pre2) return "older";
+  if (!pre1 && !pre2) return "equal";
+  const preParts1 = pre1.split(".");
+  const preParts2 = pre2.split(".");
+  const preLen = Math.max(preParts1.length, preParts2.length);
+  for (let i = 0; i < preLen; i++) {
+    const a = preParts1[i];
+    const b = preParts2[i];
+    if (a === void 0) return "older";
+    if (b === void 0) return "newer";
+    const numA = Number(a);
+    const numB = Number(b);
+    if (!Number.isNaN(numA) && !Number.isNaN(numB)) {
+      if (numA < numB) return "older";
+      if (numA > numB) return "newer";
+      continue;
+    }
+    if (a < b) return "older";
+    if (a > b) return "newer";
+  }
   return "equal";
 }
 async function getWhatsNew(changelogPath, fromVersion, toVersion) {
@@ -1315,7 +1455,7 @@ async function getWhatsNew(changelogPath, fromVersion, toVersion) {
   const sections = content.split(/^## \[/m);
   const relevant = [];
   for (const section of sections.slice(1)) {
-    const match = section.match(/^([\d.]+)\]/);
+    const match = section.match(/^([\d.]+(?:-[\w.]+)?)\]/);
     if (!match) continue;
     const ver = match[1];
     if (compareVersions(ver, fromVersion) !== "older" && compareVersions(ver, fromVersion) !== "equal" && (compareVersions(ver, toVersion) === "older" || compareVersions(ver, toVersion) === "equal")) {
@@ -1338,7 +1478,7 @@ var init_version = __esm({
 
 // src/lib/update-check.ts
 import { readFile as readFile7, writeFile as writeFile4, mkdir as mkdir4 } from "fs/promises";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import { homedir } from "os";
 import pc5 from "picocolors";
 async function readCache() {
@@ -1355,7 +1495,7 @@ async function readCache() {
 }
 async function writeCache(cache) {
   try {
-    await mkdir4(join10(homedir(), ".flydocs"), { recursive: true });
+    await mkdir4(join11(homedir(), ".flydocs"), { recursive: true });
     await writeFile4(CACHE_FILE, JSON.stringify(cache), "utf-8");
   } catch {
   }
@@ -1414,7 +1554,7 @@ function printUpdateNotice(result) {
     `  ${pc5.dim("Update available:")} ${pc5.cyan(result.currentVersion)} ${pc5.dim("->")} ${pc5.cyan(result.latestVersion)}`
   );
   console.log(
-    `  ${pc5.dim("Run:")} ${pc5.yellow(`npm update -g ${PACKAGE_NAME}`)}`
+    `  ${pc5.dim("Run:")} ${pc5.yellow(`npm install -g ${PACKAGE_NAME}@beta`)}`
   );
   console.log();
 }
@@ -1424,7 +1564,7 @@ var init_update_check = __esm({
     "use strict";
     init_constants();
     init_version();
-    CACHE_FILE = join10(homedir(), ".flydocs", "update-check.json");
+    CACHE_FILE = join11(homedir(), ".flydocs", "update-check.json");
     CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
     FETCH_TIMEOUT_MS = 5e3;
   }
@@ -1437,8 +1577,8 @@ __export(install_exports, {
 });
 import { defineCommand } from "citty";
 import { resolve as resolve2 } from "path";
-import { join as join11 } from "path";
-import { select, isCancel as isCancel3, cancel as cancel2 } from "@clack/prompts";
+import { join as join12 } from "path";
+import { confirm as confirm2, select, isCancel as isCancel3, cancel as cancel2 } from "@clack/prompts";
 var install_default;
 var init_install = __esm({
   "src/commands/install.ts"() {
@@ -1515,7 +1655,7 @@ var init_install = __esm({
           }
           tier = args.tier;
           printInfo(`Tier set via flag: ${tier}`);
-        } else if (await pathExists(join11(targetDir, ".flydocs", "config.json"))) {
+        } else if (await pathExists(join12(targetDir, ".flydocs", "config.json"))) {
           try {
             const existing = await readConfig(targetDir);
             if (existing.tier) {
@@ -1526,62 +1666,48 @@ var init_install = __esm({
           }
         }
         if (!tier) {
-          const tierChoice = await select({
-            message: "Select your tier",
-            options: [
-              {
-                value: "local",
-                label: "local",
-                hint: "File-based issues. No accounts, no API keys, works offline."
-              },
-              {
-                value: "cloud",
-                label: "cloud",
-                hint: "Linear integration. Real-time sync with your team."
-              }
-            ]
+          const shouldInstall = await confirm2({
+            message: `Install FlyDocs here? (local tier)
+  Directory: ${targetDir}`
           });
-          if (isCancel3(tierChoice)) {
+          if (isCancel3(shouldInstall) || !shouldInstall) {
             cancel2("Installation cancelled.");
             process.exit(0);
           }
-          tier = tierChoice;
+          tier = "local";
           console.log();
         }
-        if (!await pathExists(join11(targetDir, ".git"))) {
-          printError(
-            "Not in a git repository. Please run from the root of your project."
-          );
-          process.exit(1);
+        if (!await pathExists(join12(targetDir, ".git"))) {
+          printWarning("No git repository detected. Run git init when ready.");
         }
         await ensureDirectories(targetDir, tier);
         console.log("Installing framework files...");
         await replaceDirectory(
-          join11(templateDir, ".flydocs", "templates"),
-          join11(targetDir, ".flydocs", "templates")
+          join12(templateDir, ".flydocs", "templates"),
+          join12(targetDir, ".flydocs", "templates")
         );
         await replaceDirectory(
-          join11(templateDir, ".flydocs", "hooks"),
-          join11(targetDir, ".flydocs", "hooks")
+          join12(templateDir, ".flydocs", "hooks"),
+          join12(targetDir, ".flydocs", "hooks")
         );
         await replaceDirectory(
-          join11(templateDir, ".flydocs", "scripts"),
-          join11(targetDir, ".flydocs", "scripts")
+          join12(templateDir, ".flydocs", "scripts"),
+          join12(targetDir, ".flydocs", "scripts")
         );
         await copyFile(
-          join11(templateDir, ".flydocs", "version"),
-          join11(targetDir, ".flydocs", "version")
+          join12(templateDir, ".flydocs", "version"),
+          join12(targetDir, ".flydocs", "version")
         );
-        const manifestSrc = join11(templateDir, "manifest.json");
+        const manifestSrc = join12(templateDir, "manifest.json");
         if (await pathExists(manifestSrc)) {
-          await copyFile(manifestSrc, join11(targetDir, ".flydocs", "manifest.json"));
+          await copyFile(manifestSrc, join12(targetDir, ".flydocs", "manifest.json"));
         }
-        const changelogSrc = join11(templateDir, "CHANGELOG.md");
+        const changelogSrc = join12(templateDir, "CHANGELOG.md");
         if (await pathExists(changelogSrc)) {
-          await copyFile(changelogSrc, join11(targetDir, ".flydocs", "CHANGELOG.md"));
+          await copyFile(changelogSrc, join12(targetDir, ".flydocs", "CHANGELOG.md"));
         }
         printStatus(".flydocs/templates, hooks, version, manifest, changelog");
-        const configPath = join11(targetDir, ".flydocs", "config.json");
+        const configPath = join12(targetDir, ".flydocs", "config.json");
         if (!await pathExists(configPath)) {
           const config = await createFreshConfig(templateDir, version, tier);
           await writeConfig(targetDir, config);
@@ -1607,56 +1733,47 @@ var init_install = __esm({
         printStatus(`Skills installed (tier: ${tier})`);
         console.log();
         console.log("Installing agents and commands...");
-        const claudeAgentsSrc = join11(templateDir, ".claude", "agents");
+        const claudeAgentsSrc = join12(templateDir, ".claude", "agents");
         if (await pathExists(claudeAgentsSrc)) {
           await copyDirectoryContents(
             claudeAgentsSrc,
-            join11(targetDir, ".claude", "agents")
+            join12(targetDir, ".claude", "agents")
           );
         }
         await copyDirectoryContents(
-          join11(templateDir, ".claude", "commands"),
-          join11(targetDir, ".claude", "commands")
+          join12(templateDir, ".claude", "commands"),
+          join12(targetDir, ".claude", "commands")
         );
         await copyFile(
-          join11(templateDir, ".claude", "CLAUDE.md"),
-          join11(targetDir, ".claude", "CLAUDE.md")
+          join12(templateDir, ".claude", "CLAUDE.md"),
+          join12(targetDir, ".claude", "CLAUDE.md")
         );
         await copyFile(
-          join11(templateDir, ".claude", "settings.json"),
-          join11(targetDir, ".claude", "settings.json")
+          join12(templateDir, ".claude", "settings.json"),
+          join12(targetDir, ".claude", "settings.json")
         );
         printStatus(".claude/ (agents, commands, CLAUDE.md, settings)");
-        const cursorAgentsSrc = join11(templateDir, ".cursor", "agents");
+        const cursorAgentsSrc = join12(templateDir, ".cursor", "agents");
         if (await pathExists(cursorAgentsSrc)) {
           await copyDirectoryContents(
             cursorAgentsSrc,
-            join11(targetDir, ".cursor", "agents")
+            join12(targetDir, ".cursor", "agents")
           );
         }
         await copyDirectoryContents(
-          join11(templateDir, ".claude", "commands"),
-          join11(targetDir, ".cursor", "commands")
+          join12(templateDir, ".claude", "commands"),
+          join12(targetDir, ".cursor", "commands")
         );
         await copyFile(
-          join11(templateDir, ".cursor", "hooks.json"),
-          join11(targetDir, ".cursor", "hooks.json")
+          join12(templateDir, ".cursor", "hooks.json"),
+          join12(targetDir, ".cursor", "hooks.json")
         );
         printStatus(".cursor/ (agents, commands, hooks)");
         await copyCursorRules(targetDir);
         printStatus(".cursor/rules/");
-        const mcpResult = await copyFileIfNotExists(
-          join11(templateDir, ".cursor", "mcp.json"),
-          join11(targetDir, ".cursor", "mcp.json")
-        );
-        if (mcpResult === "created") {
-          printStatus(".cursor/mcp.json (new)");
-        } else {
-          printWarning(".cursor/mcp.json exists, preserving");
-        }
         await copyFile(
-          join11(templateDir, "AGENTS.md"),
-          join11(targetDir, "AGENTS.md")
+          join12(templateDir, "AGENTS.md"),
+          join12(targetDir, "AGENTS.md")
         );
         printStatus("AGENTS.md");
         await runManifestGeneration(targetDir);
@@ -1665,40 +1782,40 @@ var init_install = __esm({
         console.log("Installing project templates...");
         const userFiles = [
           {
-            src: join11(templateDir, "flydocs", "context", "project.md"),
-            dest: join11(targetDir, "flydocs", "context", "project.md"),
+            src: join12(templateDir, "flydocs", "context", "project.md"),
+            dest: join12(targetDir, "flydocs", "context", "project.md"),
             label: "flydocs/context/project.md"
           },
           {
-            src: join11(templateDir, "flydocs", "knowledge", "INDEX.md"),
-            dest: join11(targetDir, "flydocs", "knowledge", "INDEX.md"),
+            src: join12(templateDir, "flydocs", "knowledge", "INDEX.md"),
+            dest: join12(targetDir, "flydocs", "knowledge", "INDEX.md"),
             label: "flydocs/knowledge/INDEX.md"
           },
           {
-            src: join11(templateDir, "flydocs", "knowledge", "README.md"),
-            dest: join11(targetDir, "flydocs", "knowledge", "README.md"),
+            src: join12(templateDir, "flydocs", "knowledge", "README.md"),
+            dest: join12(targetDir, "flydocs", "knowledge", "README.md"),
             label: "flydocs/knowledge/README.md"
           },
           {
-            src: join11(
+            src: join12(
               templateDir,
               "flydocs",
               "knowledge",
               "product",
               "personas.md"
             ),
-            dest: join11(targetDir, "flydocs", "knowledge", "product", "personas.md"),
+            dest: join12(targetDir, "flydocs", "knowledge", "product", "personas.md"),
             label: "flydocs/knowledge/product/personas.md"
           },
           {
-            src: join11(
+            src: join12(
               templateDir,
               "flydocs",
               "knowledge",
               "product",
               "user-flows.md"
             ),
-            dest: join11(
+            dest: join12(
               targetDir,
               "flydocs",
               "knowledge",
@@ -1708,18 +1825,18 @@ var init_install = __esm({
             label: "flydocs/knowledge/product/user-flows.md"
           },
           {
-            src: join11(templateDir, "flydocs", "design-system", "README.md"),
-            dest: join11(targetDir, "flydocs", "design-system", "README.md"),
+            src: join12(templateDir, "flydocs", "design-system", "README.md"),
+            dest: join12(targetDir, "flydocs", "design-system", "README.md"),
             label: "flydocs/design-system/README.md"
           },
           {
-            src: join11(
+            src: join12(
               templateDir,
               "flydocs",
               "design-system",
               "component-patterns.md"
             ),
-            dest: join11(
+            dest: join12(
               targetDir,
               "flydocs",
               "design-system",
@@ -1728,13 +1845,13 @@ var init_install = __esm({
             label: "flydocs/design-system/component-patterns.md"
           },
           {
-            src: join11(templateDir, "flydocs", "design-system", "token-mapping.md"),
-            dest: join11(targetDir, "flydocs", "design-system", "token-mapping.md"),
+            src: join12(templateDir, "flydocs", "design-system", "token-mapping.md"),
+            dest: join12(targetDir, "flydocs", "design-system", "token-mapping.md"),
             label: "flydocs/design-system/token-mapping.md"
           },
           {
-            src: join11(templateDir, "flydocs", "README.md"),
-            dest: join11(targetDir, "flydocs", "README.md"),
+            src: join12(templateDir, "flydocs", "README.md"),
+            dest: join12(targetDir, "flydocs", "README.md"),
             label: "flydocs/README.md"
           }
         ];
@@ -1748,14 +1865,10 @@ var init_install = __esm({
             }
           }
         }
-        const envExampleSrc = join11(templateDir, ".env.example");
+        const envExampleSrc = join12(templateDir, ".env.example");
         if (await pathExists(envExampleSrc)) {
-          const hasEnv = await pathExists(join11(targetDir, ".env"));
-          const hasEnvExample = await pathExists(join11(targetDir, ".env.example"));
-          if (!hasEnv && !hasEnvExample) {
-            await copyFile(envExampleSrc, join11(targetDir, ".env.example"));
-            printStatus(".env.example (new)");
-          }
+          await copyFile(envExampleSrc, join12(targetDir, ".env.example"));
+          printStatus(".env.example");
         }
         await ensureGitignore(targetDir);
         console.log();
@@ -1797,8 +1910,116 @@ var init_install = __esm({
           "",
           "Documentation: flydocs/README.md"
         ];
+        let copiedToClipboard = false;
+        try {
+          const clipboard = await import("clipboardy");
+          await clipboard.default.write("/flydocs-setup");
+          copiedToClipboard = true;
+        } catch {
+        }
+        if (copiedToClipboard) {
+          const localSteps = nextSteps.findIndex(
+            (l) => l.includes("/flydocs-setup")
+          );
+          if (localSteps !== -1) {
+            nextSteps[localSteps] = nextSteps[localSteps] + "  (copied to clipboard)";
+          }
+        }
         printCompletionBox("Installation Complete!", nextSteps);
         printBetaCta();
+        try {
+          const { execSync: execSync2, spawn } = await import("child_process");
+          const isInstalled = (cmd) => {
+            try {
+              execSync2(`which ${cmd}`, { stdio: "pipe" });
+              return true;
+            } catch {
+              return false;
+            }
+          };
+          const ideOptions = [];
+          if (isInstalled("claude")) {
+            ideOptions.push({
+              cmd: "claude",
+              label: "Claude Code",
+              hint: "Opens and runs /flydocs-setup automatically",
+              passCommand: true
+            });
+          }
+          if (isInstalled("cursor")) {
+            ideOptions.push({
+              cmd: "cursor",
+              label: "Cursor",
+              hint: copiedToClipboard ? "Opens project \u2014 paste /flydocs-setup from clipboard" : "Opens project \u2014 run /flydocs-setup in chat",
+              passCommand: false
+            });
+          }
+          if (isInstalled("code")) {
+            ideOptions.push({
+              cmd: "code",
+              label: "VS Code",
+              hint: copiedToClipboard ? "Opens project \u2014 paste /flydocs-setup from clipboard" : "Opens project \u2014 run /flydocs-setup in chat",
+              passCommand: false
+            });
+          }
+          if (ideOptions.length === 1) {
+            const ide = ideOptions[0];
+            const launchConfirm = await confirm2({
+              message: ide.passCommand ? `Open ${ide.label} and run /flydocs-setup now?` : `Open ${ide.label}?`
+            });
+            if (!isCancel3(launchConfirm) && launchConfirm) {
+              if (ide.passCommand) {
+                spawn(ide.cmd, ["/flydocs-setup"], {
+                  cwd: targetDir,
+                  stdio: "inherit"
+                });
+                return;
+              } else {
+                spawn(ide.cmd, [targetDir], {
+                  stdio: "ignore",
+                  detached: true
+                }).unref();
+                printInfo(
+                  `${ide.label} opening \u2014 paste /flydocs-setup in the chat panel`
+                );
+              }
+            }
+          } else if (ideOptions.length > 1) {
+            const options = [
+              ...ideOptions.map((ide) => ({
+                value: ide.cmd,
+                label: ide.label,
+                hint: ide.hint
+              })),
+              { value: "skip", label: "Skip", hint: "I'll open my IDE manually" }
+            ];
+            const choice = await select({
+              message: "Open an IDE to run /flydocs-setup?",
+              options
+            });
+            if (!isCancel3(choice) && choice !== "skip") {
+              const ide = ideOptions.find((o) => o.cmd === choice);
+              if (ide) {
+                if (ide.passCommand) {
+                  spawn(ide.cmd, ["/flydocs-setup"], {
+                    cwd: targetDir,
+                    stdio: "inherit"
+                  });
+                  return;
+                } else {
+                  spawn(ide.cmd, [targetDir], {
+                    stdio: "ignore",
+                    detached: true
+                  }).unref();
+                  printInfo(
+                    `${ide.label} opening \u2014 paste /flydocs-setup in the chat panel`
+                  );
+                }
+              }
+            }
+          }
+        } catch {
+        }
         try {
           const updateResult = await checkForUpdate();
           if (updateResult) {
@@ -1817,9 +2038,9 @@ __export(update_exports, {
   default: () => update_default
 });
 import { defineCommand as defineCommand2 } from "citty";
-import { resolve as resolve3, join as join12 } from "path";
+import { resolve as resolve3, join as join13 } from "path";
 import { mkdir as mkdir5, cp as cp2, readFile as readFile8, readdir as readdir3, rm as rm4 } from "fs/promises";
-import { select as select2, text, confirm as confirm2, isCancel as isCancel4, cancel as cancel3 } from "@clack/prompts";
+import { select as select2, text, confirm as confirm3, isCancel as isCancel4, cancel as cancel3 } from "@clack/prompts";
 import pc6 from "picocolors";
 var update_default;
 var init_update = __esm({
@@ -1923,9 +2144,9 @@ var init_update = __esm({
         }
         targetDir = resolve3(targetDir);
         process.chdir(targetDir);
-        const hasVersion = await pathExists(join12(targetDir, ".flydocs", "version"));
+        const hasVersion = await pathExists(join13(targetDir, ".flydocs", "version"));
         const hasConfig = await pathExists(
-          join12(targetDir, ".flydocs", "config.json")
+          join13(targetDir, ".flydocs", "config.json")
         );
         if (!hasVersion && !hasConfig) {
           printError(`Not a FlyDocs project: ${targetDir}`);
@@ -1937,7 +2158,7 @@ var init_update = __esm({
         let currentVersion = "0.1.0";
         if (hasVersion) {
           const vContent = await readFile8(
-            join12(targetDir, ".flydocs", "version"),
+            join13(targetDir, ".flydocs", "version"),
             "utf-8"
           );
           currentVersion = vContent.trim();
@@ -1956,7 +2177,7 @@ var init_update = __esm({
           printWarning(
             `Project version (${currentVersion}) is newer than installer (${version})`
           );
-          const shouldContinue = await confirm2({
+          const shouldContinue = await confirm3({
             message: "Continue anyway?"
           });
           if (isCancel4(shouldContinue) || !shouldContinue) {
@@ -1965,7 +2186,7 @@ var init_update = __esm({
         }
         console.log(`Updating: v${currentVersion} \u2192 v${version}`);
         console.log();
-        const changelogPath = join12(templateDir, "CHANGELOG.md");
+        const changelogPath = join13(templateDir, "CHANGELOG.md");
         const whatsNew = await getWhatsNew(changelogPath, currentVersion, version);
         if (whatsNew.length > 0) {
           console.log(pc6.cyan("What's new:"));
@@ -1977,23 +2198,23 @@ var init_update = __esm({
         }
         const now = /* @__PURE__ */ new Date();
         const ts = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}-${String(now.getHours()).padStart(2, "0")}${String(now.getMinutes()).padStart(2, "0")}${String(now.getSeconds()).padStart(2, "0")}`;
-        const backupDir = join12(targetDir, ".flydocs", `backup-${ts}`);
+        const backupDir = join13(targetDir, ".flydocs", `backup-${ts}`);
         await mkdir5(backupDir, { recursive: true });
         if (hasConfig) {
           await cp2(
-            join12(targetDir, ".flydocs", "config.json"),
-            join12(backupDir, "config.json")
+            join13(targetDir, ".flydocs", "config.json"),
+            join13(backupDir, "config.json")
           );
           printStatus(`Config backed up to .flydocs/backup-${ts}/`);
         }
         try {
-          const flydocsDir = join12(targetDir, ".flydocs");
+          const flydocsDir = join13(targetDir, ".flydocs");
           const entries = await readdir3(flydocsDir);
           const backups = entries.filter((e) => e.startsWith("backup-")).sort();
           if (backups.length > 3) {
             const toRemove = backups.slice(0, backups.length - 3);
             for (const old of toRemove) {
-              await rm4(join12(flydocsDir, old), { recursive: true, force: true });
+              await rm4(join13(flydocsDir, old), { recursive: true, force: true });
             }
           }
         } catch {
@@ -2006,7 +2227,6 @@ var init_update = __esm({
           issueLabels: {},
           statusMapping: {},
           detectedStack: {},
-          mcp: {},
           skills: {},
           designSystem: null,
           aiLabor: {}
@@ -2031,74 +2251,79 @@ var init_update = __esm({
         }
         console.log("Replacing framework directories...");
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "templates"),
-          join12(targetDir, ".flydocs", "templates")
+          join13(templateDir, ".flydocs", "templates"),
+          join13(targetDir, ".flydocs", "templates")
         );
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "hooks"),
-          join12(targetDir, ".flydocs", "hooks")
+          join13(templateDir, ".flydocs", "hooks"),
+          join13(targetDir, ".flydocs", "hooks")
         );
         await replaceDirectory(
-          join12(templateDir, ".flydocs", "scripts"),
-          join12(targetDir, ".flydocs", "scripts")
+          join13(templateDir, ".flydocs", "scripts"),
+          join13(targetDir, ".flydocs", "scripts")
         );
         printStatus(".flydocs/templates, hooks, scripts");
-        const claudeAgentsSrc = join12(templateDir, ".claude", "agents");
+        const claudeAgentsSrc = join13(templateDir, ".claude", "agents");
         if (await pathExists(claudeAgentsSrc)) {
           await copyDirectoryContents(
             claudeAgentsSrc,
-            join12(targetDir, ".claude", "agents")
+            join13(targetDir, ".claude", "agents")
           );
         }
         printStatus(".claude/agents");
         await replaceOwnedSkills(templateDir, targetDir, effectiveTier);
         printStatus(`.claude/skills (tier: ${effectiveTier})`);
-        const cursorAgentsSrc = join12(templateDir, ".cursor", "agents");
+        const cursorAgentsSrc = join13(templateDir, ".cursor", "agents");
         if (await pathExists(cursorAgentsSrc)) {
           await copyDirectoryContents(
             cursorAgentsSrc,
-            join12(targetDir, ".cursor", "agents")
+            join13(targetDir, ".cursor", "agents")
           );
         }
         printStatus(".cursor/agents");
         console.log();
         console.log("Replacing framework files...");
         await copyFile(
-          join12(templateDir, ".claude", "CLAUDE.md"),
-          join12(targetDir, ".claude", "CLAUDE.md")
+          join13(templateDir, ".claude", "CLAUDE.md"),
+          join13(targetDir, ".claude", "CLAUDE.md")
         );
         await copyFile(
-          join12(templateDir, ".claude", "settings.json"),
-          join12(targetDir, ".claude", "settings.json")
+          join13(templateDir, ".claude", "settings.json"),
+          join13(targetDir, ".claude", "settings.json")
         );
         printStatus(".claude/CLAUDE.md, settings.json");
         await copyDirectoryContents(
-          join12(templateDir, ".claude", "commands"),
-          join12(targetDir, ".claude", "commands")
+          join13(templateDir, ".claude", "commands"),
+          join13(targetDir, ".claude", "commands")
         );
         await copyDirectoryContents(
-          join12(templateDir, ".claude", "commands"),
-          join12(targetDir, ".cursor", "commands")
+          join13(templateDir, ".claude", "commands"),
+          join13(targetDir, ".cursor", "commands")
         );
         printStatus(".claude/commands, .cursor/commands");
-        const skillsReadmeSrc = join12(templateDir, ".claude", "skills", "README.md");
+        const skillsReadmeSrc = join13(templateDir, ".claude", "skills", "README.md");
         if (await pathExists(skillsReadmeSrc)) {
           await copyFile(
             skillsReadmeSrc,
-            join12(targetDir, ".claude", "skills", "README.md")
+            join13(targetDir, ".claude", "skills", "README.md")
           );
         }
         printStatus(".claude/skills/README.md");
         await copyFile(
-          join12(templateDir, ".cursor", "hooks.json"),
-          join12(targetDir, ".cursor", "hooks.json")
+          join13(templateDir, ".cursor", "hooks.json"),
+          join13(targetDir, ".cursor", "hooks.json")
         );
         printStatus(".cursor/hooks.json");
         await copyFile(
-          join12(templateDir, "AGENTS.md"),
-          join12(targetDir, "AGENTS.md")
+          join13(templateDir, "AGENTS.md"),
+          join13(targetDir, "AGENTS.md")
         );
         printStatus("AGENTS.md");
+        const envExampleSrc = join13(templateDir, ".env.example");
+        if (await pathExists(envExampleSrc)) {
+          await copyFile(envExampleSrc, join13(targetDir, ".env.example"));
+          printStatus(".env.example");
+        }
         await runManifestGeneration(targetDir);
         await runContextGraphBuild(targetDir);
         console.log();
@@ -2121,18 +2346,18 @@ var init_update = __esm({
           printWarning("Config merge failed \u2014 config.json preserved as-is");
         }
         await copyFile(
-          join12(templateDir, ".flydocs", "version"),
-          join12(targetDir, ".flydocs", "version")
+          join13(templateDir, ".flydocs", "version"),
+          join13(targetDir, ".flydocs", "version")
         );
         printStatus(`.flydocs/version \u2192 ${version}`);
-        const clSrc = join12(templateDir, "CHANGELOG.md");
+        const clSrc = join13(templateDir, "CHANGELOG.md");
         if (await pathExists(clSrc)) {
-          await copyFile(clSrc, join12(targetDir, ".flydocs", "CHANGELOG.md"));
+          await copyFile(clSrc, join13(targetDir, ".flydocs", "CHANGELOG.md"));
           printStatus(".flydocs/CHANGELOG.md");
         }
-        const mfSrc = join12(templateDir, "manifest.json");
+        const mfSrc = join13(templateDir, "manifest.json");
         if (await pathExists(mfSrc)) {
-          await copyFile(mfSrc, join12(targetDir, ".flydocs", "manifest.json"));
+          await copyFile(mfSrc, join13(targetDir, ".flydocs", "manifest.json"));
           printStatus(".flydocs/manifest.json");
         }
         console.log();
@@ -2186,18 +2411,32 @@ __export(setup_exports, {
   default: () => setup_default
 });
 import { defineCommand as defineCommand3 } from "citty";
+import pc7 from "picocolors";
 var setup_default;
 var init_setup = __esm({
   "src/commands/setup.ts"() {
     "use strict";
-    init_ui();
     setup_default = defineCommand3({
       meta: {
         name: "setup",
         description: "Configure FlyDocs settings for this project"
       },
       run() {
-        printStub("flydocs setup");
+        console.log();
+        console.log(`  ${pc7.bold("FlyDocs Setup")}`);
+        console.log();
+        console.log(`  Setup runs inside your IDE as an interactive AI command.`);
+        console.log();
+        console.log(
+          `  ${pc7.cyan("Claude Code:")}  Type ${pc7.bold("/flydocs-setup")} in chat`
+        );
+        console.log(
+          `  ${pc7.cyan("Cursor:")}      Type ${pc7.bold("/flydocs-setup")} in chat`
+        );
+        console.log();
+        console.log(`  This configures your project context, detects your stack,`);
+        console.log(`  and installs community skills tailored to your codebase.`);
+        console.log();
       }
     });
   }
@@ -2209,7 +2448,7 @@ __export(skills_exports, {
   default: () => skills_default
 });
 import { defineCommand as defineCommand4 } from "citty";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 var list, search, add, remove, skills_default;
 var init_skills2 = __esm({
   "src/commands/skills.ts"() {
@@ -2231,19 +2470,19 @@ var init_skills2 = __esm({
         console.log(`${total} skill(s) installed:`);
         if (result.platform.length > 0) {
           console.log();
-          console.log(pc7.bold("Platform"));
+          console.log(pc8.bold("Platform"));
           for (const skill of result.platform) {
             console.log(
-              `  ${skill.name} ${pc7.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
         if (result.community.length > 0) {
           console.log();
-          console.log(pc7.bold("Community"));
+          console.log(pc8.bold("Community"));
           for (const skill of result.community) {
             console.log(
-              `  ${skill.name} ${pc7.dim(`(${skill.triggers} triggers)`)}`
+              `  ${skill.name} ${pc8.dim(`(${skill.triggers} triggers)`)}`
             );
           }
         }
@@ -2266,18 +2505,18 @@ var init_skills2 = __esm({
         const results = await searchCatalog(args.keyword);
         if (results.length === 0) {
           console.log(`No skills found for "${args.keyword}".`);
-          console.log(`  Browse the catalog at: ${pc7.cyan("https://skills.sh/")}`);
+          console.log(`  Browse the catalog at: ${pc8.cyan("https://skills.sh/")}`);
           return;
         }
         console.log();
         console.log(`${results.length} skill(s) matching "${args.keyword}":`);
         console.log();
         for (const skill of results) {
-          console.log(`  ${pc7.bold(skill.name)}`);
+          console.log(`  ${pc8.bold(skill.name)}`);
           console.log(`  ${skill.description}`);
-          console.log(`  ${pc7.dim(skill.repo)}`);
+          console.log(`  ${pc8.dim(skill.repo)}`);
           if (skill.tags.length > 0) {
-            console.log(`  ${pc7.dim(skill.tags.join(", "))}`);
+            console.log(`  ${pc8.dim(skill.tags.join(", "))}`);
           }
           console.log();
         }
@@ -2336,11 +2575,10 @@ __export(connect_exports, {
   default: () => connect_default
 });
 import { defineCommand as defineCommand5 } from "citty";
-import { text as text2, confirm as confirm3, isCancel as isCancel5, cancel as cancel4 } from "@clack/prompts";
-import pc8 from "picocolors";
+import { text as text2, confirm as confirm4, isCancel as isCancel5, cancel as cancel4 } from "@clack/prompts";
+import pc9 from "picocolors";
 import { readFile as readFile9, writeFile as writeFile5, appendFile as appendFile2 } from "fs/promises";
-import { join as join13 } from "path";
-import { execSync as execSync2 } from "child_process";
+import { join as join14 } from "path";
 var connect_default;
 var init_connect = __esm({
   "src/commands/connect.ts"() {
@@ -2374,11 +2612,11 @@ var init_connect = __esm({
       },
       async run({ args }) {
         const targetDir = args.path ?? process.cwd();
-        const configPath = join13(targetDir, ".flydocs", "config.json");
+        const configPath = join14(targetDir, ".flydocs", "config.json");
         if (!await pathExists(configPath)) {
           printError("Not a FlyDocs project (.flydocs/config.json not found).");
           console.log(
-            `  Run ${pc8.cyan("flydocs")} first to install FlyDocs in this project.`
+            `  Run ${pc9.cyan("flydocs")} first to install FlyDocs in this project.`
           );
           process.exit(1);
         }
@@ -2386,7 +2624,7 @@ var init_connect = __esm({
         if (config.tier === "cloud") {
           printInfo("This project is already connected to the cloud tier.");
           console.log();
-          const reconnect = await confirm3({
+          const reconnect = await confirm4({
             message: "Want to update your API key?"
           });
           if (isCancel5(reconnect) || !reconnect) {
@@ -2395,10 +2633,10 @@ var init_connect = __esm({
           }
         }
         console.log();
-        console.log(`  ${pc8.bold("Connect to Linear")}`);
+        console.log(`  ${pc9.bold("Connect to Linear")}`);
         console.log();
         console.log(
-          `  ${pc8.dim("Get your API key from: Linear \u2192 Settings \u2192 API \u2192 Personal API keys")}`
+          `  ${pc9.dim("Get your API key from: Linear \u2192 Settings \u2192 API \u2192 Personal API keys")}`
         );
         console.log();
         let apiKey = args.key ?? "";
@@ -2421,27 +2659,31 @@ var init_connect = __esm({
         }
         printInfo("Validating API key...");
         try {
-          const result = execSync2(
-            `python3 -c "
-import urllib.request, json
-req = urllib.request.Request('https://api.linear.app/graphql',
-    data=json.dumps({'query': '{ viewer { id name email } }'}).encode(),
-    headers={'Authorization': '${apiKey}', 'Content-Type': 'application/json'})
-res = urllib.request.urlopen(req)
-data = json.loads(res.read())
-print(json.dumps(data['data']['viewer']))
-"`,
-            { encoding: "utf-8", timeout: 15e3 }
-          );
-          const viewer = JSON.parse(result.trim());
-          printStatus(`Authenticated as ${pc8.bold(viewer.name)} (${viewer.email})`);
+          const response = await fetch("https://api.linear.app/graphql", {
+            method: "POST",
+            headers: {
+              Authorization: apiKey,
+              "Content-Type": "application/json"
+            },
+            body: JSON.stringify({ query: "{ viewer { id name email } }" }),
+            signal: AbortSignal.timeout(15e3)
+          });
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}`);
+          }
+          const data = await response.json();
+          if (!data.data?.viewer) {
+            throw new Error("Invalid response");
+          }
+          const viewer = data.data.viewer;
+          printStatus(`Authenticated as ${pc9.bold(viewer.name)} (${viewer.email})`);
         } catch {
           printError("Invalid API key or network error.");
           console.log(`  Check your key and try again.`);
           process.exit(1);
         }
-        const envPath = join13(targetDir, ".env");
-        const envLocalPath = join13(targetDir, ".env.local");
+        const envPath = join14(targetDir, ".env");
+        const envLocalPath = join14(targetDir, ".env.local");
         const targetEnvPath = await pathExists(envLocalPath) ? envLocalPath : envPath;
         if (await pathExists(targetEnvPath)) {
           const envContent = await readFile9(targetEnvPath, "utf-8");
@@ -2461,7 +2703,7 @@ LINEAR_API_KEY=${apiKey}
 `, "utf-8");
         }
         printStatus(
-          `API key stored in ${pc8.dim(targetEnvPath === envLocalPath ? ".env.local" : ".env")}`
+          `API key stored in ${pc9.dim(targetEnvPath === envLocalPath ? ".env.local" : ".env")}`
         );
         const wasLocal = config.tier === "local";
         config.tier = "cloud";
@@ -2474,14 +2716,14 @@ LINEAR_API_KEY=${apiKey}
             const templateDir = await resolveTemplatePath(
               args["local-source"] || void 0
             );
-            const templateSkillsDir = join13(templateDir, ".claude", "skills");
-            const skillsDir = join13(targetDir, ".claude", "skills");
+            const templateSkillsDir = join14(templateDir, ".claude", "skills");
+            const skillsDir = join14(targetDir, ".claude", "skills");
             await replaceDirectory(
-              join13(templateSkillsDir, "flydocs-cloud"),
-              join13(skillsDir, "flydocs-cloud")
+              join14(templateSkillsDir, "flydocs-cloud"),
+              join14(skillsDir, "flydocs-cloud")
             );
             const { rm: rm5 } = await import("fs/promises");
-            const localSkillDir = join13(skillsDir, "flydocs-local");
+            const localSkillDir = join14(skillsDir, "flydocs-local");
             if (await pathExists(localSkillDir)) {
               await rm5(localSkillDir, { recursive: true, force: true });
             }
@@ -2494,14 +2736,14 @@ LINEAR_API_KEY=${apiKey}
         }
         console.log();
         console.log(
-          `  ${pc8.bold("Connected!")} Your project now syncs with Linear.`
+          `  ${pc9.bold("Connected!")} Your project now syncs with Linear.`
         );
         console.log();
         console.log(`  Next steps:`);
         console.log(
-          `    1. Run ${pc8.cyan("/flydocs-setup")} in your IDE to configure your Linear project`
+          `    1. Run ${pc9.cyan("/flydocs-setup")} in your IDE to configure your Linear project`
         );
-        console.log(`    2. Run ${pc8.cyan("/start-session")} to begin working`);
+        console.log(`    2. Run ${pc9.cyan("/start-session")} to begin working`);
         console.log();
       }
     });
@@ -2514,7 +2756,7 @@ __export(upgrade_exports, {
   default: () => upgrade_default
 });
 import { defineCommand as defineCommand6 } from "citty";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 var upgrade_default;
 var init_upgrade = __esm({
   "src/commands/upgrade.ts"() {
@@ -2550,37 +2792,37 @@ var init_upgrade = __esm({
         console.log();
         if (currentTier === "cloud") {
           console.log(
-            `  ${pc9.green("\u2713")} You're already on the ${pc9.bold("cloud")} tier.`
+            `  ${pc10.green("\u2713")} You're already on the ${pc10.bold("cloud")} tier.`
           );
           console.log();
           console.log(
             `  Your issues sync with Linear via the cloud mechanism skill.`
           );
           console.log(
-            `  Run ${pc9.cyan("flydocs connect")} to update your connection settings.`
+            `  Run ${pc10.cyan("flydocs connect")} to update your connection settings.`
           );
           console.log();
           return;
         }
-        console.log(`  ${pc9.bold("FlyDocs Cloud Tier")}`);
+        console.log(`  ${pc10.bold("FlyDocs Cloud Tier")}`);
         console.log();
-        console.log(`  You're currently on the ${pc9.yellow("local")} tier.`);
+        console.log(`  You're currently on the ${pc10.yellow("local")} tier.`);
         console.log(`  Upgrade to cloud for:`);
         console.log();
         console.log(
-          `    ${pc9.cyan("\u2192")} Issue sync with Linear (Jira coming soon)`
+          `    ${pc10.cyan("\u2192")} Issue sync with Linear (Jira coming soon)`
         );
-        console.log(`    ${pc9.cyan("\u2192")} Project milestones and cycle management`);
-        console.log(`    ${pc9.cyan("\u2192")} Team assignment and priority tracking`);
-        console.log(`    ${pc9.cyan("\u2192")} Project health updates and dashboards`);
-        console.log(`    ${pc9.cyan("\u2192")} Cross-project issue linking`);
+        console.log(`    ${pc10.cyan("\u2192")} Project milestones and cycle management`);
+        console.log(`    ${pc10.cyan("\u2192")} Team assignment and priority tracking`);
+        console.log(`    ${pc10.cyan("\u2192")} Project health updates and dashboards`);
+        console.log(`    ${pc10.cyan("\u2192")} Cross-project issue linking`);
         console.log();
-        console.log(`  ${pc9.bold("How to upgrade:")}`);
+        console.log(`  ${pc10.bold("How to upgrade:")}`);
         console.log();
-        console.log(`    1. Sign up at ${pc9.cyan("https://www.flydocs.ai")}`);
+        console.log(`    1. Sign up at ${pc10.cyan("https://www.flydocs.ai")}`);
         console.log(`    2. Get your Linear API key from Linear \u2192 Settings \u2192 API`);
         console.log(
-          `    3. Run ${pc9.cyan("flydocs connect")} to connect your project`
+          `    3. Run ${pc10.cyan("flydocs connect")} to connect your project`
         );
         console.log();
       }
@@ -2594,8 +2836,8 @@ __export(self_update_exports, {
   default: () => self_update_default
 });
 import { defineCommand as defineCommand7 } from "citty";
-import { execSync as execSync3 } from "child_process";
-import pc10 from "picocolors";
+import { execSync } from "child_process";
+import pc11 from "picocolors";
 var self_update_default;
 var init_self_update = __esm({
   "src/commands/self-update.ts"() {
@@ -2609,17 +2851,19 @@ var init_self_update = __esm({
       },
       async run() {
         console.log();
-        console.log(`  Updating ${pc10.cyan(PACKAGE_NAME)}...`);
+        console.log(`  Updating ${pc11.cyan(PACKAGE_NAME)}...`);
         console.log();
         try {
-          execSync3(`npm update -g ${PACKAGE_NAME}`, {
+          execSync(`npm install -g ${PACKAGE_NAME}@beta`, {
             stdio: "inherit",
             timeout: 6e4
           });
           console.log();
           printStatus("FlyDocs CLI updated successfully");
         } catch {
-          printError(`Update failed. Try manually: npm update -g ${PACKAGE_NAME}`);
+          printError(
+            `Update failed. Try manually: npm install -g ${PACKAGE_NAME}@beta`
+          );
           process.exit(1);
         }
       }
@@ -2640,8 +2884,11 @@ var SUB_COMMANDS = /* @__PURE__ */ new Set([
   "self-update"
 ]);
 var userArgs = process.argv.slice(2);
+var hasMetaFlag = userArgs.some(
+  (a) => a === "--version" || a === "--help" || a === "-h"
+);
 var firstPositional = userArgs.find((a) => !a.startsWith("-"));
-if (!firstPositional || !SUB_COMMANDS.has(firstPositional)) {
+if (!hasMetaFlag && (!firstPositional || !SUB_COMMANDS.has(firstPositional))) {
   process.argv.splice(2, 0, "install");
 }
 var main = defineCommand8({