@flydocs/cli 0.5.0-beta.5 → 0.5.0-beta.7

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.5";
+    CLI_VERSION = "0.5.0-beta.7";
     CLI_NAME = "flydocs";
     PACKAGE_NAME = "@flydocs/cli";
   }
@@ -148,9 +148,6 @@ function printError(message) {
 function printInfo(message) {
   console.log(`${pc2.cyan("\u2139")} ${message}`);
 }
-function printStub(command) {
-  printWarning(`${pc2.bold(command)} is not yet implemented.`);
-}
 function printBanner(version) {
   const pink = (t) => pc2.bold(pc2.magenta(t));
   const purple = (t) => pc2.bold(pc2.cyan(t));
@@ -242,7 +239,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 ?? {}
@@ -275,9 +271,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;
   }
@@ -322,12 +315,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"));
@@ -336,7 +323,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));
@@ -384,20 +371,8 @@ 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`));
-    }
-  }
 }
-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";
@@ -408,22 +383,61 @@ var init_skills = __esm({
       "flydocs-estimates",
       "flydocs-context-graph"
     ];
-    SUPPORTING_SKILLS = [
-      "implementation-flow",
-      "review-workflow",
-      "spec-templates"
-    ];
     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");
@@ -492,6 +506,10 @@ async function detectStack(targetDir) {
   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,
@@ -530,7 +548,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(
@@ -541,7 +559,7 @@ async function runManifestGeneration(targetDir) {
   );
   if (!await pathExists(scriptPath)) return;
   try {
-    execSync(`python3 "${scriptPath}"`, {
+    execFileSync("python3", [scriptPath], {
       cwd: targetDir,
       stdio: "pipe"
     });
@@ -561,7 +579,7 @@ async function runContextGraphBuild(targetDir) {
   );
   if (!await pathExists(scriptPath)) return;
   try {
-    execSync(`python3 "${scriptPath}"`, {
+    execFileSync("python3", [scriptPath], {
       cwd: targetDir,
       stdio: "pipe"
     });
@@ -944,6 +962,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) {
@@ -962,7 +981,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;
@@ -977,10 +1003,10 @@ 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,
@@ -990,7 +1016,7 @@ async function promptCommunitySkills(targetDir, stack, autoYes) {
       message: "Select community skills to install (space to toggle, enter to confirm)",
       options,
       required: false,
-      initialValues: suggestions
+      initialValues: filtered
     });
     if (isCancel(result)) {
       cancel("Skipped community skills");
@@ -1026,6 +1052,7 @@ 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 = [
@@ -1115,47 +1142,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}`);
       }
@@ -1164,12 +1191,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;
     }
@@ -1177,9 +1204,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/`);
       }
     }
@@ -1189,7 +1216,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);
@@ -1219,7 +1246,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}`);
   }
 }
@@ -1230,19 +1257,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",
@@ -1270,9 +1298,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")) {
@@ -1286,7 +1314,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")) {
@@ -1370,8 +1398,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;
@@ -1379,6 +1409,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) {
@@ -1391,7 +1442,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")) {
@@ -1414,7 +1465,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() {
@@ -1431,7 +1482,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 {
   }
@@ -1500,7 +1551,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;
   }
@@ -1513,8 +1564,8 @@ __export(install_exports, {
 });
 import { defineCommand } from "citty";
 import { resolve as resolve2 } from "path";
-import { join as join11 } from "path";
-import { confirm as confirm2, 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"() {
@@ -1591,7 +1642,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) {
@@ -1613,37 +1664,37 @@ var init_install = __esm({
           tier = "local";
           console.log();
         }
-        if (!await pathExists(join11(targetDir, ".git"))) {
+        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);
@@ -1669,56 +1720,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);
@@ -1727,40 +1769,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",
@@ -1770,18 +1812,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",
@@ -1790,13 +1832,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"
           }
         ];
@@ -1810,12 +1852,12 @@ 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"));
+          const hasEnv = await pathExists(join12(targetDir, ".env"));
+          const hasEnvExample = await pathExists(join12(targetDir, ".env.example"));
           if (!hasEnv && !hasEnvExample) {
-            await copyFile(envExampleSrc, join11(targetDir, ".env.example"));
+            await copyFile(envExampleSrc, join12(targetDir, ".env.example"));
             printStatus(".env.example (new)");
           }
         }
@@ -1877,50 +1919,94 @@ var init_install = __esm({
         printCompletionBox("Installation Complete!", nextSteps);
         printBetaCta();
         try {
-          const { execSync: execSync4, spawn } = await import("child_process");
+          const { execSync: execSync2, spawn } = await import("child_process");
           const isInstalled = (cmd) => {
             try {
-              execSync4(`which ${cmd}`, { stdio: "pipe" });
+              execSync2(`which ${cmd}`, { stdio: "pipe" });
               return true;
             } catch {
               return false;
             }
           };
-          const hasClaude = isInstalled("claude");
-          const hasCursor = isInstalled("cursor");
-          const hasCode = isInstalled("code");
-          if (hasClaude) {
-            const launchClaude = await confirm2({
-              message: "Open Claude Code and run /flydocs-setup now?"
+          const ideOptions = [];
+          if (isInstalled("claude")) {
+            ideOptions.push({
+              cmd: "claude",
+              label: "Claude Code",
+              hint: "Opens and runs /flydocs-setup automatically",
+              passCommand: true
             });
-            if (!isCancel3(launchClaude) && launchClaude) {
-              spawn("claude", ["/flydocs-setup"], {
-                cwd: targetDir,
-                stdio: "inherit"
-              });
-              return;
-            }
-          } else if (hasCursor) {
-            const launchCursor = await confirm2({
-              message: copiedToClipboard ? "Open Cursor? (paste /flydocs-setup from clipboard)" : "Open Cursor?"
+          }
+          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 (!isCancel3(launchCursor) && launchCursor) {
-              spawn("cursor", [targetDir], {
-                stdio: "ignore",
-                detached: true
-              }).unref();
-              printInfo("Cursor opening \u2014 paste /flydocs-setup in the chat panel");
+          }
+          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 (hasCode) {
-            const launchCode = await confirm2({
-              message: copiedToClipboard ? "Open VS Code? (paste /flydocs-setup from clipboard)" : "Open VS Code?"
+          } 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(launchCode) && launchCode) {
-              spawn("code", [targetDir], {
-                stdio: "ignore",
-                detached: true
-              }).unref();
-              printInfo("VS Code opening \u2014 paste /flydocs-setup in the chat panel");
+            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 {
@@ -1943,9 +2029,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, text, confirm as confirm3, 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({
@@ -2011,7 +2097,7 @@ var init_update = __esm({
         } else if (args.here) {
           targetDir = process.cwd();
         } else {
-          const choice = await select({
+          const choice = await select2({
             message: "Which project would you like to update?",
             options: [
               {
@@ -2049,9 +2135,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}`);
@@ -2063,7 +2149,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();
@@ -2091,7 +2177,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:"));
@@ -2103,23 +2189,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 {
@@ -2132,7 +2218,6 @@ var init_update = __esm({
           issueLabels: {},
           statusMapping: {},
           detectedStack: {},
-          mcp: {},
           skills: {},
           designSystem: null,
           aiLabor: {}
@@ -2157,72 +2242,72 @@ 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");
         await runManifestGeneration(targetDir);
@@ -2247,18 +2332,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();
@@ -2312,18 +2397,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();
       }
     });
   }
@@ -2335,7 +2434,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"() {
@@ -2357,19 +2456,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)`)}`
             );
           }
         }
@@ -2392,18 +2491,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();
         }
@@ -2463,10 +2562,9 @@ __export(connect_exports, {
 });
 import { defineCommand as defineCommand5 } from "citty";
 import { text as text2, confirm as confirm4, isCancel as isCancel5, cancel as cancel4 } from "@clack/prompts";
-import pc8 from "picocolors";
+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"() {
@@ -2500,11 +2598,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);
         }
@@ -2521,10 +2619,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 ?? "";
@@ -2547,27 +2645,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");
@@ -2587,7 +2689,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";
@@ -2600,14 +2702,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 });
             }
@@ -2620,14 +2722,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();
       }
     });
@@ -2640,7 +2742,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"() {
@@ -2676,37 +2778,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();
       }
@@ -2720,8 +2822,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"() {
@@ -2735,10 +2837,10 @@ 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 install -g ${PACKAGE_NAME}@beta`, {
+          execSync(`npm install -g ${PACKAGE_NAME}@beta`, {
             stdio: "inherit",
             timeout: 6e4
           });