@gethmy/mcp 2.0.0 → 2.1.1

package/dist/cli.js

@@ -8828,7 +8828,7 @@ function hasLocalConfig(cwd) {
 function getApiKey() {
   const config = loadConfig();
   if (!config.apiKey) {
-    throw new Error(`Not configured. Run "harmony-mcp configure" to set your API key.
+    throw new Error(`Not configured. Run "npx @gethmy/mcp setup" to set your API key.
 ` + "You can generate an API key at https://gethmy.com → Settings → API Keys.");
   }
   return config.apiKey;
@@ -26301,6 +26301,8 @@ class HarmonyApiClient {
       params.set("summary", "true");
     if (options?.includeArchived)
       params.set("include_archived", "true");
+    if (options?.labelName)
+      params.set("label_name", options.labelName);
     const query = params.toString() ? `?${params.toString()}` : "";
     return this.request("GET", `/board/${projectId}${query}`);
   }
@@ -29409,7 +29411,7 @@ function registerHandlers(server, deps) {
 async function handleToolCall(name, args, deps) {
   const unauthenticatedTools = ["harmony_signup", "harmony_onboard"];
   if (!unauthenticatedTools.includes(name) && !deps.isConfigured()) {
-    throw new Error(`Not configured. Run "harmony-mcp configure" to set your API key.
+    throw new Error(`Not configured. Run "npx @gethmy/mcp setup" to set your API key.
 ` + `You can generate an API key at https://gethmy.com → Settings → API Keys.
 ` + 'Or use "harmony_onboard" to create an account and configure automatically.');
   }
@@ -30704,7 +30706,7 @@ function createConfigDeps() {
 class HarmonyMCPServer {
   server;
   constructor() {
-    this.server = new Server({ name: "harmony-mcp", version: "1.0.0" }, { capabilities: { tools: {}, resources: {} } });
+    this.server = new Server({ name: "@gethmy/mcp", version: "2.0.0" }, { capabilities: { tools: {}, resources: {} } });
     registerHandlers(this.server, createConfigDeps());
   }
   async run() {
@@ -30745,14 +30747,14 @@ class HarmonyMCPServer {
 
 // src/tui/setup.ts
 import {
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   lstatSync,
   mkdirSync as mkdirSync4,
   symlinkSync,
   unlinkSync
 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname2, join as join4 } from "node:path";
+import { dirname as dirname2, join as join5 } from "node:path";
 
 // ../../node_modules/@clack/core/dist/index.mjs
 var import_sisteransi = __toESM(require_src(), 1);
@@ -31519,6 +31521,10 @@ function detectAgents(cwd = process.cwd()) {
   });
 }
 
+// src/tui/docs.ts
+import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "node:fs";
+import { isAbsolute, join as join4, resolve, sep as sep2 } from "node:path";
+
 // src/tui/theme.ts
 var pc = __toESM(require_picocolors(), 1);
 var symbols = {
@@ -31583,17 +31589,654 @@ function formatPath(path, homeDir) {
   return path;
 }
 
+// src/tui/docs.ts
+var IGNORED_DIRS = new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".next",
+  ".nuxt",
+  ".output",
+  ".vercel",
+  ".turbo",
+  ".cache",
+  "coverage",
+  ".harmony-worktrees",
+  "__pycache__",
+  "target",
+  "vendor"
+]);
+function readJson(filePath) {
+  try {
+    return JSON.parse(readFileSync3(filePath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function readText(filePath) {
+  try {
+    return readFileSync3(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function listDirs(dirPath) {
+  try {
+    return readdirSync2(dirPath).filter((entry) => {
+      if (IGNORED_DIRS.has(entry) || entry.startsWith("."))
+        return false;
+      try {
+        return statSync(join4(dirPath, entry)).isDirectory();
+      } catch {
+        return false;
+      }
+    });
+  } catch {
+    return [];
+  }
+}
+var DIR_DESCRIPTIONS = {
+  components: "UI components",
+  pages: "Route-level pages",
+  routes: "Route-level pages",
+  views: "Route-level pages",
+  hooks: "Custom hooks",
+  lib: "Utilities",
+  utils: "Utilities",
+  api: "API / server code",
+  server: "API / server code",
+  contexts: "State management",
+  store: "State management",
+  stores: "State management",
+  types: "Type definitions",
+  styles: "Stylesheets",
+  public: "Static assets",
+  static: "Static assets",
+  assets: "Static assets",
+  supabase: "Supabase backend",
+  functions: "Edge functions",
+  packages: "Monorepo packages",
+  apps: "Monorepo applications",
+  src: "Source code",
+  test: "Tests",
+  tests: "Tests",
+  __tests__: "Tests",
+  scripts: "Build / utility scripts",
+  config: "Configuration",
+  docs: "Documentation",
+  migrations: "Database migrations",
+  prisma: "Prisma schema & migrations",
+  e2e: "End-to-end tests",
+  cypress: "Cypress tests"
+};
+function describeDir(name) {
+  return DIR_DESCRIPTIONS[name.toLowerCase()] ?? name;
+}
+function scanProject(cwd) {
+  let packageManager = null;
+  if (existsSync4(join4(cwd, "bun.lock")) || existsSync4(join4(cwd, "bun.lockb"))) {
+    packageManager = "bun";
+  } else if (existsSync4(join4(cwd, "pnpm-lock.yaml"))) {
+    packageManager = "pnpm";
+  } else if (existsSync4(join4(cwd, "yarn.lock"))) {
+    packageManager = "yarn";
+  } else if (existsSync4(join4(cwd, "package.json"))) {
+    packageManager = "npm";
+  }
+  const pkg = readJson(join4(cwd, "package.json"));
+  const scripts = pkg && typeof pkg.scripts === "object" && pkg.scripts !== null ? pkg.scripts : {};
+  let language = "unknown";
+  if (existsSync4(join4(cwd, "tsconfig.json"))) {
+    language = "typescript";
+  } else if (existsSync4(join4(cwd, "go.mod"))) {
+    language = "go";
+  } else if (existsSync4(join4(cwd, "Cargo.toml"))) {
+    language = "rust";
+  } else if (existsSync4(join4(cwd, "setup.py")) || existsSync4(join4(cwd, "pyproject.toml"))) {
+    language = "python";
+  } else if (pkg) {
+    language = "javascript";
+  }
+  let framework = null;
+  if (pkg) {
+    const deps = {
+      ...typeof pkg.dependencies === "object" ? pkg.dependencies : {},
+      ...typeof pkg.devDependencies === "object" ? pkg.devDependencies : {}
+    };
+    if (deps.next) {
+      framework = "next";
+    } else if (deps.react && deps.vite) {
+      framework = "react+vite";
+    } else if (deps.react) {
+      framework = "react";
+    } else if (deps.vue && deps.vite) {
+      framework = "vue+vite";
+    } else if (deps.vue && deps.nuxt) {
+      framework = "nuxt";
+    } else if (deps.vue) {
+      framework = "vue";
+    } else if (deps.astro) {
+      framework = "astro";
+    } else if (deps.svelte) {
+      framework = "svelte";
+    } else if (deps.express) {
+      framework = "express";
+    } else if (deps.fastify) {
+      framework = "fastify";
+    } else if (deps.hono) {
+      framework = "hono";
+    }
+  }
+  let linter = null;
+  if (existsSync4(join4(cwd, "biome.json")) || existsSync4(join4(cwd, "biome.jsonc"))) {
+    linter = "biome";
+  } else {
+    const eslintFiles = [
+      ".eslintrc",
+      ".eslintrc.js",
+      ".eslintrc.cjs",
+      ".eslintrc.json",
+      ".eslintrc.yml",
+      ".eslintrc.yaml",
+      "eslint.config.js",
+      "eslint.config.mjs",
+      "eslint.config.cjs",
+      "eslint.config.ts"
+    ];
+    if (eslintFiles.some((f) => existsSync4(join4(cwd, f)))) {
+      linter = "eslint";
+    } else {
+      const prettierFiles = [
+        ".prettierrc",
+        ".prettierrc.js",
+        ".prettierrc.json",
+        ".prettierrc.yml",
+        ".prettierrc.yaml",
+        "prettier.config.js",
+        "prettier.config.mjs"
+      ];
+      if (prettierFiles.some((f) => existsSync4(join4(cwd, f)))) {
+        linter = "prettier";
+      }
+    }
+  }
+  let indentStyle = null;
+  const biome = readJson(join4(cwd, "biome.json")) ?? readJson(join4(cwd, "biome.jsonc"));
+  if (biome) {
+    const formatter = biome.formatter;
+    if (formatter) {
+      const type = formatter.indentStyle === "tab" ? "tab" : "space";
+      const width = typeof formatter.indentWidth === "number" ? formatter.indentWidth : 2;
+      indentStyle = { type, width };
+    }
+  }
+  if (!indentStyle) {
+    const editorConfig = readText(join4(cwd, ".editorconfig"));
+    if (editorConfig) {
+      const styleMatch = editorConfig.match(/indent_style\s*=\s*(space|tab)/);
+      const sizeMatch = editorConfig.match(/indent_size\s*=\s*(\d+)/);
+      if (styleMatch) {
+        indentStyle = {
+          type: styleMatch[1],
+          width: sizeMatch ? Number.parseInt(sizeMatch[1], 10) : 2
+        };
+      }
+    }
+  }
+  const dirs = listDirs(cwd);
+  const srcDirs = existsSync4(join4(cwd, "src")) ? listDirs(join4(cwd, "src")) : [];
+  const monorepo = existsSync4(join4(cwd, "packages")) || existsSync4(join4(cwd, "apps"));
+  const existingDocs = {
+    agentsMd: existsSync4(join4(cwd, "AGENTS.md")),
+    claudeMd: existsSync4(join4(cwd, "CLAUDE.md")),
+    docsDir: existsSync4(join4(cwd, "docs")),
+    architectureMd: existsSync4(join4(cwd, "docs", "architecture.md"))
+  };
+  return {
+    packageManager,
+    scripts,
+    language,
+    framework,
+    linter,
+    indentStyle,
+    dirs,
+    srcDirs,
+    monorepo,
+    existingDocs
+  };
+}
+function runCmd(pm) {
+  if (pm === "bun")
+    return "bun run";
+  if (pm === "pnpm")
+    return "pnpm run";
+  if (pm === "yarn")
+    return "yarn";
+  return "npm run";
+}
+function describeScript(name) {
+  const map3 = {
+    dev: "Dev server",
+    start: "Start server",
+    build: "Production build",
+    lint: "Lint",
+    "lint:fix": "Lint + autofix",
+    format: "Format code",
+    test: "Run tests",
+    "test:watch": "Run tests (watch)",
+    "test:e2e": "End-to-end tests",
+    typecheck: "Type-check",
+    "type-check": "Type-check",
+    preview: "Preview production build",
+    deploy: "Deploy",
+    generate: "Code generation",
+    migrate: "Run migrations",
+    seed: "Seed database",
+    clean: "Clean build artifacts",
+    prepare: "Prepare (husky, etc.)"
+  };
+  return map3[name] ?? "";
+}
+function generateAgentsMd(info, _cwd) {
+  const lang = info.language === "typescript" ? "TypeScript" : info.language === "javascript" ? "JavaScript" : info.language;
+  const frameworkLabel = info.framework ? `${info.framework} ` : "";
+  const monoLabel = info.monorepo ? " (monorepo)" : "";
+  const lines = [];
+  lines.push("# AGENTS.md");
+  lines.push("");
+  lines.push(`${frameworkLabel}${lang} project${monoLabel}.`);
+  lines.push("");
+  const scriptEntries = Object.entries(info.scripts);
+  if (scriptEntries.length > 0 && info.packageManager) {
+    const prefix = runCmd(info.packageManager);
+    lines.push("## Commands");
+    lines.push("");
+    lines.push("```bash");
+    const commands = scriptEntries.map(([name]) => `${prefix} ${name}`);
+    const maxLen = Math.max(...commands.map((c) => c.length));
+    for (let i = 0;i < scriptEntries.length; i++) {
+      const [name] = scriptEntries[i];
+      const cmd = commands[i];
+      const desc = describeScript(name);
+      if (desc) {
+        lines.push(`${cmd}${" ".repeat(maxLen - cmd.length + 4)}# ${desc}`);
+      } else {
+        lines.push(cmd);
+      }
+    }
+    lines.push("```");
+    lines.push("");
+  }
+  lines.push("## Code Standards");
+  lines.push("");
+  const langLabel = info.language === "typescript" ? "TypeScript" : "JavaScript";
+  if (info.language === "typescript" || info.language === "javascript") {
+    lines.push(`- ${langLabel} with ES modules`);
+  }
+  if (info.indentStyle) {
+    const unit = info.indentStyle.type === "tab" ? "tab" : "space";
+    lines.push(`- ${info.indentStyle.width}-${unit} indentation`);
+  }
+  if (info.linter) {
+    lines.push(`- Linted with ${info.linter}`);
+  }
+  lines.push("");
+  lines.push("## Architecture");
+  lines.push("");
+  for (const dir of info.dirs) {
+    lines.push(`- \`${dir}/\` — ${describeDir(dir)}`);
+  }
+  if (info.srcDirs.length > 0) {
+    for (const sub of info.srcDirs) {
+      lines.push(`  - \`src/${sub}/\` — ${describeDir(sub)}`);
+    }
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function generateClaudeMd(info) {
+  const lines = [];
+  lines.push("# CLAUDE.md");
+  lines.push("");
+  lines.push("@AGENTS.md");
+  if (info.existingDocs.architectureMd || info.dirs.includes("docs")) {
+    lines.push("@docs/architecture.md");
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+function generateArchitectureMd(info, _cwd) {
+  const lines = [];
+  lines.push("# Architecture");
+  lines.push("");
+  lines.push("## Directory Structure");
+  lines.push("");
+  for (const dir of info.dirs) {
+    lines.push(`- \`${dir}/\` — ${describeDir(dir)}`);
+  }
+  if (info.srcDirs.length > 0) {
+    lines.push("");
+    lines.push("### `src/`");
+    lines.push("");
+    for (const sub of info.srcDirs) {
+      lines.push(`- \`src/${sub}/\` — ${describeDir(sub)}`);
+    }
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
+var VAGUE_STANDARDS = [
+  "follow best practices",
+  "use best practices",
+  "keep it clean",
+  "write clean code",
+  "maintain code quality",
+  "ensure quality",
+  "use proper naming",
+  "follow conventions",
+  "be consistent"
+];
+function verifyDocs(cwd) {
+  const issues = [];
+  const claudeMd = readText(join4(cwd, "CLAUDE.md"));
+  const agentsMd = readText(join4(cwd, "AGENTS.md"));
+  const pkg = readJson(join4(cwd, "package.json"));
+  const pkgScripts = pkg && typeof pkg.scripts === "object" && pkg.scripts !== null ? pkg.scripts : {};
+  const projectRoot = resolve(cwd);
+  if (claudeMd) {
+    const importedFiles = [];
+    for (const line of claudeMd.split(`
+`)) {
+      const match = line.match(/^@(.+)$/);
+      if (match) {
+        const refPath = match[1].trim();
+        if (isAbsolute(refPath)) {
+          issues.push({
+            severity: "error",
+            file: "CLAUDE.md",
+            message: `@ reference uses an absolute path: ${refPath}`,
+            fix: "Use a project-relative path under the repository root"
+          });
+          continue;
+        }
+        const resolvedPath = resolve(projectRoot, refPath);
+        if (resolvedPath !== projectRoot && !resolvedPath.startsWith(projectRoot + sep2)) {
+          issues.push({
+            severity: "error",
+            file: "CLAUDE.md",
+            message: `@ reference escapes project root: ${refPath}`,
+            fix: "Remove traversal segments (../) and keep references inside the repo"
+          });
+          continue;
+        }
+        importedFiles.push({ ref: refPath, resolved: resolvedPath });
+        if (!existsSync4(resolvedPath)) {
+          issues.push({
+            severity: "error",
+            file: "CLAUDE.md",
+            message: `Referenced file does not exist: ${refPath}`,
+            fix: `Remove the @${refPath} line or create the file`
+          });
+        }
+      }
+    }
+    const claudeLines = claudeMd.split(`
+`).length;
+    if (claudeLines > 100) {
+      issues.push({
+        severity: "warning",
+        file: "CLAUDE.md",
+        message: `CLAUDE.md is ${claudeLines} lines (recommended: under 100)`,
+        fix: "Move detailed content to AGENTS.md or docs/ files and use @imports"
+      });
+    }
+    if (importedFiles.length > 0) {
+      const claudeHeadings = extractHeadings(claudeMd);
+      for (const { ref: refPath, resolved: resolvedPath } of importedFiles) {
+        const refContent = readText(resolvedPath);
+        if (!refContent)
+          continue;
+        const refHeadings = extractHeadings(refContent);
+        for (const heading of claudeHeadings) {
+          if (refHeadings.has(heading)) {
+            issues.push({
+              severity: "warning",
+              file: "CLAUDE.md",
+              message: `Section "${heading}" duplicates content from @${refPath}`,
+              fix: `Remove the "${heading}" section — it's already included via @import`
+            });
+          }
+        }
+      }
+    }
+  }
+  if (agentsMd) {
+    const agentsLines = agentsMd.split(`
+`);
+    const contextLines = [];
+    let pastFirstHeading = false;
+    let hitNextSection = false;
+    for (const line of agentsLines) {
+      if (!pastFirstHeading) {
+        if (line.startsWith("# ")) {
+          pastFirstHeading = true;
+        }
+        continue;
+      }
+      if (line.startsWith("## ")) {
+        hitNextSection = true;
+        break;
+      }
+      const trimmed = line.trim();
+      if (trimmed)
+        contextLines.push(trimmed);
+    }
+    if (pastFirstHeading && !hitNextSection && contextLines.length === 0) {
+      issues.push({
+        severity: "warning",
+        file: "AGENTS.md",
+        message: "Missing project context line after the title heading",
+        fix: "Add a single-line description: stack + what the project does"
+      });
+    } else if (contextLines.length > 1) {
+      issues.push({
+        severity: "warning",
+        file: "AGENTS.md",
+        message: `Project context should be exactly 1 line, found ${contextLines.length}`,
+        fix: "Condense to a single line: stack + what the project does"
+      });
+    }
+    const codeBlockRe = /```[\s\S]*?```/g;
+    let blockMatch;
+    while ((blockMatch = codeBlockRe.exec(agentsMd)) !== null) {
+      const block = blockMatch[0];
+      const cmdRe = /(?:bun|npm|pnpm|yarn)\s+(?:run\s+)?(\S+)/g;
+      let cmdMatch;
+      while ((cmdMatch = cmdRe.exec(block)) !== null) {
+        const scriptName = cmdMatch[1];
+        const builtins = new Set([
+          "install",
+          "init",
+          "create",
+          "exec",
+          "dlx",
+          "x",
+          "test",
+          "start"
+        ]);
+        if (builtins.has(scriptName))
+          continue;
+        if (Object.keys(pkgScripts).length > 0 && !(scriptName in pkgScripts)) {
+          issues.push({
+            severity: "warning",
+            file: "AGENTS.md",
+            message: `Command references script "${scriptName}" which is not in package.json`,
+            fix: `Update the command or add "${scriptName}" to package.json scripts`
+          });
+        }
+      }
+    }
+    const standardsSection = extractSection(agentsMd, "Code Standards");
+    if (standardsSection) {
+      const lower = standardsSection.toLowerCase();
+      for (const phrase of VAGUE_STANDARDS) {
+        if (lower.includes(phrase)) {
+          issues.push({
+            severity: "warning",
+            file: "AGENTS.md",
+            message: `Code Standards contains vague phrase: "${phrase}"`,
+            fix: "Replace with specific, verifiable conventions derived from config files"
+          });
+        }
+      }
+    }
+    if (Object.keys(pkgScripts).length > 0) {
+      const hasTestScript = Object.keys(pkgScripts).some((k3) => k3 === "test" || k3.startsWith("test:"));
+      if (!hasTestScript) {
+        const mentionsNoTest = agentsMd.toLowerCase().includes("no test");
+        if (!mentionsNoTest) {
+          issues.push({
+            severity: "warning",
+            file: "AGENTS.md",
+            message: "No test script in package.json and AGENTS.md doesn't mention it",
+            fix: 'Add a note like "No test framework. Verify changes with `bun run build`."'
+          });
+        }
+      }
+    }
+    checkBacktickPaths(agentsMd, "AGENTS.md", cwd, issues);
+  }
+  const archMd = readText(join4(cwd, "docs", "architecture.md"));
+  if (archMd) {
+    checkBacktickPaths(archMd, "docs/architecture.md", cwd, issues);
+  }
+  return issues;
+}
+function extractHeadings(content) {
+  const headings = new Set;
+  for (const line of content.split(`
+`)) {
+    const match = line.match(/^#{2,3}\s+(.+)$/);
+    if (match) {
+      headings.add(match[1].trim());
+    }
+  }
+  return headings;
+}
+function extractSection(content, heading) {
+  const lines = content.split(`
+`);
+  let capturing = false;
+  const result = [];
+  for (const line of lines) {
+    if (capturing) {
+      if (line.match(/^#{1,2}\s/))
+        break;
+      result.push(line);
+    } else if (line.match(new RegExp(`^##\\s+${heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`, "i"))) {
+      capturing = true;
+    }
+  }
+  return result.length > 0 ? result.join(`
+`) : null;
+}
+function checkBacktickPaths(content, file2, cwd, issues) {
+  const pathRe = /`((?:src\/|packages\/|apps\/|supabase\/|docs\/)[^`]+)`/g;
+  let match;
+  const checked = new Set;
+  const root = resolve(cwd);
+  while ((match = pathRe.exec(content)) !== null) {
+    const refPath = match[1].replace(/\/$/, "");
+    if (checked.has(refPath))
+      continue;
+    checked.add(refPath);
+    const resolvedRef = resolve(root, refPath);
+    if (resolvedRef !== root && !resolvedRef.startsWith(root + sep2))
+      continue;
+    if (!existsSync4(resolvedRef)) {
+      issues.push({
+        severity: "warning",
+        file: file2,
+        message: `Referenced path does not exist: ${refPath}`,
+        fix: `Update or remove the \`${refPath}\` reference`
+      });
+    }
+  }
+}
+async function runDocsStep(cwd) {
+  const info = scanProject(cwd);
+  const hasDocs = info.existingDocs.agentsMd || info.existingDocs.claudeMd;
+  if (!hasDocs) {
+    const shouldGenerate = await ye({
+      message: "No project docs found. Generate AGENTS.md and CLAUDE.md?",
+      initialValue: true
+    });
+    if (pD(shouldGenerate) || !shouldGenerate) {
+      return { files: [], issues: [], skipped: true };
+    }
+    const files = [];
+    files.push({
+      path: join4(cwd, "AGENTS.md"),
+      content: generateAgentsMd(info, cwd),
+      type: "text"
+    });
+    files.push({
+      path: join4(cwd, "CLAUDE.md"),
+      content: generateClaudeMd(info),
+      type: "text"
+    });
+    if (info.dirs.includes("docs") || info.srcDirs.length > 0) {
+      files.push({
+        path: join4(cwd, "docs", "architecture.md"),
+        content: generateArchitectureMd(info, cwd),
+        type: "text"
+      });
+    }
+    M2.success(`Generated ${files.length} doc file(s): ${files.map((f) => f.path.replace(cwd + "/", "")).join(", ")}`);
+    return { files, issues: [], skipped: false };
+  }
+  const shouldVerify = await ye({
+    message: "Project docs found. Verify for issues?",
+    initialValue: false
+  });
+  if (pD(shouldVerify) || !shouldVerify) {
+    return { files: [], issues: [], skipped: true };
+  }
+  const issues = verifyDocs(cwd);
+  if (issues.length === 0) {
+    M2.success("No issues found in project docs.");
+  } else {
+    for (const issue2 of issues) {
+      const prefix = `${colors.bold(issue2.file)}:`;
+      if (issue2.severity === "error") {
+        M2.error(`${prefix} ${issue2.message}`);
+      } else {
+        M2.warning(`${prefix} ${issue2.message}`);
+      }
+      if (issue2.fix) {
+        M2.message(`  ${symbols.arrow} ${colors.dim(issue2.fix)}`);
+      }
+    }
+    M2.info(`Found ${issues.length} issue(s) (${issues.filter((i) => i.severity === "error").length} errors, ${issues.filter((i) => i.severity === "warning").length} warnings)`);
+  }
+  return { files: [], issues, skipped: false };
+}
+
 // src/tui/writer.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { dirname } from "node:path";
 function ensureDir(dirPath) {
-  if (!existsSync4(dirPath)) {
+  if (!existsSync5(dirPath)) {
     mkdirSync3(dirPath, { recursive: true, mode: 493 });
   }
 }
 function writeFile(filePath, content, options = {}) {
-  const exists = existsSync4(filePath);
+  const exists = existsSync5(filePath);
   if (exists && !options.force) {
     return { path: filePath, action: "skip" };
   }
@@ -31611,7 +32254,7 @@ function writeFile(filePath, content, options = {}) {
   }
 }
 function mergeJsonFile(filePath, updates, options = {}) {
-  const exists = existsSync4(filePath);
+  const exists = existsSync5(filePath);
   if (!exists) {
     try {
       ensureDir(dirname(filePath));
@@ -31628,7 +32271,7 @@ function mergeJsonFile(filePath, updates, options = {}) {
     }
   }
   try {
-    const existing = JSON.parse(readFileSync3(filePath, "utf-8"));
+    const existing = JSON.parse(readFileSync4(filePath, "utf-8"));
     if (updates.mcpServers && existing.mcpServers) {
       const existingServers = existing.mcpServers;
       const updateServers = updates.mcpServers;
@@ -31661,7 +32304,7 @@ function mergeJsonFile(filePath, updates, options = {}) {
   }
 }
 function appendToToml(filePath, section, content, options = {}) {
-  const exists = existsSync4(filePath);
+  const exists = existsSync5(filePath);
   if (!exists) {
     try {
       ensureDir(dirname(filePath));
@@ -31676,7 +32319,7 @@ function appendToToml(filePath, section, content, options = {}) {
     }
   }
   try {
-    const existing = readFileSync3(filePath, "utf-8");
+    const existing = readFileSync4(filePath, "utf-8");
     if (existing.includes(section)) {
       if (options.force) {
         const updated = existing.replace(new RegExp(`\\[${section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\][\\s\\S]*?(?=\\[|$)`), content.trim() + `
@@ -31714,7 +32357,7 @@ async function writeFilesWithProgress(files, options = {}) {
       result = writeFile(file2.path, file2.content, options);
     }
     results.push(result);
-    await new Promise((resolve) => setTimeout(resolve, 50));
+    await new Promise((resolve2) => setTimeout(resolve2, 50));
   }
   spinner.stop("Files written");
   for (const result of results) {
@@ -31737,7 +32380,7 @@ function getWriteSummary(files, options = {}) {
   const home = homedir3();
   for (const file2 of files) {
     const displayPath = formatPath(file2.path, home);
-    const exists = existsSync4(file2.path);
+    const exists = existsSync5(file2.path);
     if (exists && !options.force) {
       toSkip.push(displayPath);
     } else if (exists) {
@@ -31750,7 +32393,7 @@ function getWriteSummary(files, options = {}) {
 }
 
 // src/tui/setup.ts
-var GLOBAL_SKILLS_DIR = join4(homedir4(), ".agents", "skills");
+var GLOBAL_SKILLS_DIR = join5(homedir4(), ".agents", "skills");
 var API_URL = "https://gethmy.com/api";
 var HARMONY_WORKFLOW_PROMPT = `# Harmony Card Workflow
 
@@ -32043,7 +32686,7 @@ Report the result:
 async function registerMcpServer() {
   try {
     const { execSync } = await import("node:child_process");
-    execSync("claude mcp add --transport stdio harmony -- npx -y harmony-mcp@latest serve", {
+    execSync("claude mcp add --transport stdio harmony -- npx -y @gethmy/mcp@latest serve", {
       stdio: "pipe"
     });
     return true;
@@ -32052,22 +32695,22 @@ async function registerMcpServer() {
   }
 }
 async function writeMcpConfigFallback(home) {
-  const { readFileSync: readFileSync4, writeFileSync: writeFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync6 } = await import("node:fs");
-  const settingsPath = join4(home, ".claude", "settings.json");
+  const { readFileSync: readFileSync5, writeFileSync: writeFileSync4, mkdirSync: mkdirSync5, existsSync: existsSync7 } = await import("node:fs");
+  const settingsPath = join5(home, ".claude", "settings.json");
   const settingsDir = dirname2(settingsPath);
-  if (!existsSync6(settingsDir)) {
+  if (!existsSync7(settingsDir)) {
     mkdirSync5(settingsDir, { recursive: true });
   }
   let settings = {};
-  if (existsSync6(settingsPath)) {
+  if (existsSync7(settingsPath)) {
     try {
-      settings = JSON.parse(readFileSync4(settingsPath, "utf-8"));
+      settings = JSON.parse(readFileSync5(settingsPath, "utf-8"));
     } catch {}
   }
   const mcpServers = settings.mcpServers || {};
   mcpServers.harmony = {
     command: "npx",
-    args: ["-y", "harmony-mcp@latest", "serve"]
+    args: ["-y", "@gethmy/mcp@latest", "serve"]
   };
   settings.mcpServers = mcpServers;
   writeFileSync4(settingsPath, JSON.stringify(settings, null, 2));
@@ -32159,31 +32802,31 @@ ${HARMONY_PLAN_PROMPT.replace("$ARGUMENTS", "$ARGUMENTS")}
 `;
       if (installMode === "global") {
         files.push({
-          path: join4(GLOBAL_SKILLS_DIR, "hmy", "SKILL.md"),
+          path: join5(GLOBAL_SKILLS_DIR, "hmy", "SKILL.md"),
           content: skillContent,
           type: "text"
         });
         symlinks.push({
-          target: join4(GLOBAL_SKILLS_DIR, "hmy"),
-          link: join4(home, ".claude", "skills", "hmy")
+          target: join5(GLOBAL_SKILLS_DIR, "hmy"),
+          link: join5(home, ".claude", "skills", "hmy")
         });
         files.push({
-          path: join4(GLOBAL_SKILLS_DIR, "hmy-plan", "SKILL.md"),
+          path: join5(GLOBAL_SKILLS_DIR, "hmy-plan", "SKILL.md"),
           content: planSkillContent,
           type: "text"
         });
         symlinks.push({
-          target: join4(GLOBAL_SKILLS_DIR, "hmy-plan"),
-          link: join4(home, ".claude", "skills", "hmy-plan")
+          target: join5(GLOBAL_SKILLS_DIR, "hmy-plan"),
+          link: join5(home, ".claude", "skills", "hmy-plan")
         });
       } else {
         files.push({
-          path: join4(cwd, ".claude", "skills", "hmy", "SKILL.md"),
+          path: join5(cwd, ".claude", "skills", "hmy", "SKILL.md"),
           content: skillContent,
           type: "text"
         });
         files.push({
-          path: join4(cwd, ".claude", "skills", "hmy-plan", "SKILL.md"),
+          path: join5(cwd, ".claude", "skills", "hmy-plan", "SKILL.md"),
           content: planSkillContent,
           type: "text"
         });
@@ -32218,7 +32861,7 @@ When given a card reference (e.g., #42 or a card name), follow this workflow:
 - \`harmony_generate_prompt\` - Get role-based guidance and focus areas for the card
 `;
       files.push({
-        path: join4(cwd, "AGENTS.md"),
+        path: join5(cwd, "AGENTS.md"),
         content: agentsContent,
         type: "text"
       });
@@ -32235,17 +32878,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "{{card}}").replace("Your agent
 `;
       if (installMode === "global") {
         files.push({
-          path: join4(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
+          path: join5(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
           content: promptContent,
           type: "text"
         });
         symlinks.push({
-          target: join4(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
-          link: join4(home, ".codex", "prompts", "hmy.md")
+          target: join5(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
+          link: join5(home, ".codex", "prompts", "hmy.md")
         });
       } else {
         files.push({
-          path: join4(home, ".codex", "prompts", "hmy.md"),
+          path: join5(home, ".codex", "prompts", "hmy.md"),
           content: promptContent,
           type: "text"
         });
@@ -32254,10 +32897,10 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "{{card}}").replace("Your agent
 # Harmony MCP Server
 [mcp_servers.harmony]
 command = "npx"
-args = ["-y", "harmony-mcp@latest", "serve"]
+args = ["-y", "@gethmy/mcp@latest", "serve"]
 `;
       files.push({
-        path: join4(home, ".codex", "config.toml"),
+        path: join5(home, ".codex", "config.toml"),
         content: tomlContent,
         type: "toml",
         tomlSection: "mcp_servers.harmony"
@@ -32266,12 +32909,12 @@ args = ["-y", "harmony-mcp@latest", "serve"]
     }
     case "cursor": {
       files.push({
-        path: join4(cwd, ".cursor", "mcp.json"),
+        path: join5(cwd, ".cursor", "mcp.json"),
         content: JSON.stringify({
           mcpServers: {
             harmony: {
               command: "npx",
-              args: ["-y", "harmony-mcp@latest", "serve"]
+              args: ["-y", "@gethmy/mcp@latest", "serve"]
             }
           }
         }, null, 2),
@@ -32292,17 +32935,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
 `;
       if (installMode === "global") {
         files.push({
-          path: join4(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
+          path: join5(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
           content: ruleContent,
           type: "text"
         });
         symlinks.push({
-          target: join4(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
-          link: join4(home, ".cursor", "rules", "harmony.mdc")
+          target: join5(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
+          link: join5(home, ".cursor", "rules", "harmony.mdc")
         });
       } else {
         files.push({
-          path: join4(cwd, ".cursor", "rules", "harmony.mdc"),
+          path: join5(cwd, ".cursor", "rules", "harmony.mdc"),
           content: ruleContent,
           type: "text"
         });
@@ -32311,12 +32954,12 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
     }
     case "windsurf": {
       files.push({
-        path: join4(home, ".codeium", "windsurf", "mcp_config.json"),
+        path: join5(home, ".codeium", "windsurf", "mcp_config.json"),
         content: JSON.stringify({
           mcpServers: {
             harmony: {
               command: "npx",
-              args: ["-y", "harmony-mcp@latest", "serve"],
+              args: ["-y", "@gethmy/mcp@latest", "serve"],
               disabled: false,
               alwaysAllow: []
             }
@@ -32337,17 +32980,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
 `;
       if (installMode === "global") {
         files.push({
-          path: join4(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
+          path: join5(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
           content: ruleContent,
           type: "text"
         });
         symlinks.push({
-          target: join4(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
-          link: join4(home, ".codeium", "windsurf", "rules", "harmony.md")
+          target: join5(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
+          link: join5(home, ".codeium", "windsurf", "rules", "harmony.md")
         });
       } else {
         files.push({
-          path: join4(cwd, ".windsurf", "rules", "harmony.md"),
+          path: join5(cwd, ".windsurf", "rules", "harmony.md"),
           content: ruleContent,
           type: "text"
         });
@@ -32548,6 +33191,14 @@ async function runSetup(options = {}) {
       type: "text"
     });
   }
+  if (!options.skipDocs) {
+    const docsResult = await runDocsStep(cwd);
+    if (!docsResult.skipped) {
+      for (const file2 of docsResult.files) {
+        allFiles.push(file2);
+      }
+    }
+  }
   if (needsSkills && selectedAgents.length > 0) {
     for (const agentId of selectedAgents) {
       const { files, symlinks } = getAgentFiles(agentId, cwd, installMode);
@@ -32623,7 +33274,7 @@ async function runSetup(options = {}) {
     for (const symlink of allSymlinks) {
       try {
         const linkDir = dirname2(symlink.link);
-        if (!existsSync5(linkDir)) {
+        if (!existsSync6(linkDir)) {
           mkdirSync4(linkDir, { recursive: true });
         }
         let linkExists = false;
@@ -32652,9 +33303,9 @@ async function runSetup(options = {}) {
     } else {
       try {
         await writeMcpConfigFallback(home);
-        console.log(`  ${colors.success("✓")} ${colors.dim(formatPath(join4(home, ".claude", "settings.json"), home))} ${colors.dim("(updated)")}`);
+        console.log(`  ${colors.success("✓")} ${colors.dim(formatPath(join5(home, ".claude", "settings.json"), home))} ${colors.dim("(updated)")}`);
       } catch {
-        M2.warning("Could not register MCP server. Run manually: claude mcp add --transport stdio harmony -- npx -y harmony-mcp@latest serve");
+        M2.warning("Could not register MCP server. Run manually: claude mcp add --transport stdio harmony -- npx -y @gethmy/mcp@latest serve");
       }
     }
   }
@@ -32690,7 +33341,7 @@ async function runSetup(options = {}) {
     console.log(`    ${colors.brand("Cursor/Windsurf:")} MCP tools available automatically`);
   }
   console.log("");
-  console.log(`  ${colors.dim("Add to new project: npx harmony-mcp setup")}`);
+  console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
   console.log(`  ${colors.dim("Need help? Visit https://gethmy.com/docs/mcp")}`);
   console.log("");
 }
@@ -32698,7 +33349,7 @@ async function runSetup(options = {}) {
 // src/cli.ts
 var require2 = createRequire2(import.meta.url);
 var { version: version2 } = require2("../package.json");
-program.name("harmony-mcp").description("MCP server for Harmony Kanban board").version(version2);
+program.name("@gethmy/mcp").description("MCP server for Harmony Kanban board").version(version2);
 program.command("serve").description("Start the MCP server (stdio transport)").action(async () => {
   const server = new HarmonyMCPServer;
   await server.run();
@@ -32730,7 +33381,7 @@ Skills:`);
       }
     } else {
       console.log("  Installed: No");
-      console.log("  Run: npx harmony-mcp setup");
+      console.log("  Run: npx @gethmy/mcp setup");
     }
     console.log(`
 Context:`);
@@ -32753,7 +33404,7 @@ Context:`);
   } else {
     console.log(`Status: Not configured
 `);
-    console.log("Run: npx harmony-mcp setup");
+    console.log("Run: npx @gethmy/mcp setup");
     console.log("Get an API key at: https://gethmy.com/user/keys");
   }
 });
@@ -32766,9 +33417,9 @@ program.command("reset").description("Remove stored configuration").action(() =>
   });
   console.log("Configuration reset successfully");
   console.log(`
-To reconfigure, run: npx harmony-mcp setup`);
+To reconfigure, run: npx @gethmy/mcp setup`);
 });
-program.command("setup").description("Smart setup wizard for Harmony MCP (recommended)").option("-f, --force", "Overwrite existing configuration files").option("-k, --api-key <key>", "API key (skips prompt)").option("-e, --email <email>", "Your email for auto-assignment").option("-a, --agents <agents...>", "Agents to configure: claude, codex, cursor, windsurf").option("-l, --local", "Install skills locally in project directory").option("-g, --global", "Install skills globally (recommended)").option("-w, --workspace <id>", "Set workspace context").option("-p, --project <id>", "Set project context").option("--skip-context", "Skip workspace/project selection").action(async (options) => {
+program.command("setup").description("Smart setup wizard for Harmony MCP (recommended)").option("-f, --force", "Overwrite existing configuration files").option("-k, --api-key <key>", "API key (skips prompt)").option("-e, --email <email>", "Your email for auto-assignment").option("-a, --agents <agents...>", "Agents to configure: claude, codex, cursor, windsurf").option("-l, --local", "Install skills locally in project directory").option("-g, --global", "Install skills globally (recommended)").option("-w, --workspace <id>", "Set workspace context").option("-p, --project <id>", "Set project context").option("--skip-context", "Skip workspace/project selection").option("--skip-docs", "Skip project docs scaffold/verification").action(async (options) => {
   await runSetup({
     force: options.force,
     apiKey: options.apiKey,
@@ -32777,7 +33428,8 @@ program.command("setup").description("Smart setup wizard for Harmony MCP (recomm
     installMode: options.global ? "global" : options.local ? "local" : undefined,
     workspaceId: options.workspace,
     projectId: options.project,
-    skipContext: options.skipContext
+    skipContext: options.skipContext,
+    skipDocs: options.skipDocs
   });
 });
 program.parse();