@popoverai/dotrequirements 0.26.1 → 0.27.0

package/dist/commands/ai-setup.js

@@ -1,5 +1,5 @@
-import { execSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import prompts from "prompts";
@@ -14,8 +14,8 @@ function loadContextFileSection() {
 }
 /**
  * Install workflow guidance to the appropriate context file for a platform.
- * With `yes` (the non-interactive --assistant path, AISETUP-1.0), both
- * confirmations are auto-accepted — matching their interactive defaults.
+ * With `yes` (the non-interactive --assistant path, AISETUP-1.0), the
+ * confirmation is auto-accepted — matching its interactive default.
  */
 async function installContextFileSection(platform, yes = false) {
     const fileName = getContextFileName(platform);
@@ -82,28 +82,164 @@ async function installContextFileSection(platform, yes = false) {
     catch (error) {
         console.error(`❌ Failed to update ${fileName}`);
         console.log(`   Error: ${error instanceof Error ? error.message : String(error)}\n`);
+        // AISETUP-3: writing the guidance is the whole of setup — a CI/agent
+        // caller must not see a failed write as success.
+        process.exitCode = 1;
+    }
+}
+/**
+ * Remove the dotrequirements entry from a JSON MCP config file an earlier
+ * ai-setup version wrote (Cursor's `.cursor/mcp.json`, Antigravity's
+ * `mcp_config.json`). Only our entry is deleted; every other configured
+ * server is preserved (AISETUP-2.2). Unusable files are skipped with their
+ * path shown (AISETUP-2.4); an absent file or a config with no dotrequirements
+ * entry is a silent no-op (AISETUP-2.3).
+ */
+async function cleanupJsonMcpConfig(configPath, yes) {
+    if (!existsSync(configPath)) {
+        return; // AISETUP-2.3: nothing an earlier version left here
+    }
+    let raw;
+    try {
+        raw = readFileSync(configPath, "utf-8");
+    }
+    catch {
+        // AISETUP-2.4: unreadable (e.g. a directory) — skip, but keep going
+        console.log(`ℹ️  Skipped MCP cleanup: could not read ${configPath}`);
+        return;
+    }
+    if (!raw.trim()) {
+        return;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        // AISETUP-2.4: invalid JSON — we won't guess at its structure
+        console.log(`ℹ️  Skipped MCP cleanup: invalid JSON in ${configPath}`);
+        return;
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        // AISETUP-2.4: a non-object root
+        console.log(`ℹ️  Skipped MCP cleanup: ${configPath} is not a JSON object`);
+        return;
+    }
+    const mcpServers = parsed.mcpServers;
+    if (mcpServers == null ||
+        typeof mcpServers !== "object" ||
+        Array.isArray(mcpServers)) {
+        return; // no usable server map → nothing of ours to remove
+    }
+    const servers = mcpServers;
+    if (!("dotrequirements" in servers)) {
+        return; // AISETUP-2.3: our entry isn't here
+    }
+    if (!yes) {
+        const { remove } = await prompts({
+            type: "confirm",
+            name: "remove",
+            message: `Remove the retired dotrequirements MCP server from ${configPath}?`,
+            initial: true,
+        });
+        if (!remove) {
+            return;
+        }
+    }
+    delete servers.dotrequirements;
+    writeFileSync(configPath, JSON.stringify(parsed, null, 2), "utf-8");
+    console.log(`✅ Removed the retired dotrequirements MCP server from ${configPath}`);
+}
+/**
+ * Remove the dotrequirements MCP server from a host that manages its own MCP
+ * config through a CLI (Claude Code, Codex). Detection via `<bin> mcp get`;
+ * removal via `<bin> mcp remove`. A missing entry — or a host CLI that isn't
+ * installed — is a silent no-op; the host CLI guarantees only our entry is
+ * touched (AISETUP-2.2).
+ */
+async function cleanupHostCliMcp(bin, yes) {
+    let present = false;
+    try {
+        execFileSync(bin, ["mcp", "get", "dotrequirements"], { stdio: "pipe" });
+        present = true;
+    }
+    catch {
+        // Exit non-zero → not configured, or the host CLI isn't on PATH. Either
+        // way there is nothing for us to clean up (AISETUP-2.3).
+        return;
+    }
+    if (!present) {
+        return;
+    }
+    if (!yes) {
+        const { remove } = await prompts({
+            type: "confirm",
+            name: "remove",
+            message: `Remove the retired dotrequirements MCP server from ${bin}?`,
+            initial: true,
+        });
+        if (!remove) {
+            return;
+        }
+    }
+    try {
+        execFileSync(bin, ["mcp", "remove", "dotrequirements"], { stdio: "pipe" });
+        console.log(`✅ Removed the retired dotrequirements MCP server from ${bin}`);
+    }
+    catch {
+        console.log(`⚠️  Could not remove the dotrequirements MCP server automatically.\n` +
+            `   Remove it manually: ${bin} mcp remove dotrequirements`);
+    }
+}
+/**
+ * Clean up any MCP configuration an earlier ai-setup version wrote for this
+ * assistant. The local MCP server is retired (AISETUP-2.0: setup writes no MCP
+ * config); this leaves the entries prior versions created ready to remove.
+ */
+async function cleanupStaleMcpConfig(platform, yes) {
+    switch (platform) {
+        case "claude-code":
+            await cleanupHostCliMcp("claude", yes);
+            return;
+        case "codex":
+            await cleanupHostCliMcp("codex", yes);
+            return;
+        case "cursor": {
+            const root = (await findGitRoot()) ?? process.cwd();
+            await cleanupJsonMcpConfig(join(root, ".cursor", "mcp.json"), yes);
+            return;
+        }
+        case "antigravity":
+            await cleanupJsonMcpConfig(join(homedir(), ".gemini", "antigravity", "mcp_config.json"), yes);
+            return;
+        // github-copilot never had ai-setup write MCP config — nothing to clean.
     }
 }
 /**
  * Assistant identifiers accepted by the non-interactive --assistant flag
  * (AISETUP-1). "other" is interactive-only: it prompts for a custom path.
+ *
+ * Claude Desktop was dropped: it consumed only the retired local MCP server
+ * (no terminal, no context file), so setup has nothing to install for it. Its
+ * path forward is the remote MCP connector.
  */
 export const SUPPORTED_ASSISTANTS = [
     "claude-code",
-    "claude-desktop",
     "cursor",
     "antigravity",
     "codex",
     "github-copilot",
 ];
 /**
- * AI setup command - configures the MCP server for AI assistants
+ * AI setup command — installs the requirements-driven workflow guidance into
+ * the assistant's context file, and removes any MCP configuration an earlier
+ * version wrote (the local MCP server is retired).
  *
  * AISETUP-1: with --assistant <id>, setup runs without any interactive prompt
  * (an AI assistant configuring itself knows which assistant it is).
  */
 export async function aiSetupCommand(options = {}) {
-    console.log(`🔧 Setting up ${brand} MCP server\n`);
+    console.log(`🔧 Setting up ${brand} workflow guidance\n`);
     if (options.assistant) {
         const id = options.assistant.toLowerCase();
         if (!SUPPORTED_ASSISTANTS.includes(id)) {
@@ -121,7 +257,6 @@ export async function aiSetupCommand(options = {}) {
         message: "Which AI assistant are you using?",
         choices: [
             { title: "Claude Code", value: "claude-code" },
-            { title: "Claude Desktop", value: "claude-desktop" },
             { title: "Cursor", value: "cursor" },
             { title: "Google Antigravity", value: "antigravity" },
             { title: "OpenAI Codex", value: "codex" },
@@ -137,311 +272,26 @@ export async function aiSetupCommand(options = {}) {
     await dispatchSetup(response.client);
 }
 async function dispatchSetup(client, yes = false) {
-    switch (client) {
-        case "claude-code":
-            await setupClaudeCode(yes);
-            break;
-        case "claude-desktop":
-            await setupClaudeDesktop();
-            break;
-        case "cursor":
-            await setupCursor(yes);
-            break;
-        case "antigravity":
-            await setupAntigravity(yes);
-            break;
-        case "codex":
-            await setupCodex(yes);
-            break;
-        case "github-copilot":
-            await setupGitHubCopilot(yes);
-            break;
-        case "other":
-            await setupOther();
-            break;
-        default:
-            console.log(`\n❌ ${client} is not yet supported.`);
-            console.log("Please refer to the documentation for manual setup.");
-    }
-}
-async function setupClaudeCode(yes = false) {
-    console.log("\n📦 Configuring MCP for Claude Code...\n");
-    const command = `claude mcp add-json dotrequirements '{"type":"stdio","command":"npx","args":["-y","@popoverai/dotrequirements","mcp"]}'`;
-    let mcpConfigured = false;
-    try {
-        execSync(command, { stdio: "pipe" });
-        console.log("✅ MCP configured successfully for Claude Code!");
-        mcpConfigured = true;
-    }
-    catch (error) {
-        const execError = error;
-        const stderr = execError.stderr?.toString() || "";
-        const errorMessage = execError.message || "";
-        const combinedError = stderr + errorMessage;
-        if (combinedError.includes("already exists")) {
-            console.log("✅ MCP server already configured for Claude Code");
-            mcpConfigured = true;
-        }
-        else {
-            console.error("❌ Failed to configure MCP automatically.");
-            console.log("\nYou can manually run:");
-            console.log(`  ${command}`);
-            if (stderr) {
-                console.log(`\nError: ${stderr}`);
-            }
-        }
-    }
-    if (mcpConfigured) {
-        console.log("\n⚠️  Important: Restart Claude Code for changes to take effect.");
-        console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("claude-code", yes);
-    }
-}
-async function setupClaudeDesktop() {
-    console.log("\n📦 Configuring MCP for Claude Desktop...\n");
-    // Determine config path based on OS
-    const platform = process.platform;
-    let configPath;
-    let configDir;
-    if (platform === "darwin") {
-        configDir = join(homedir(), "Library", "Application Support", "Claude");
-        configPath = join(configDir, "claude_desktop_config.json");
-    }
-    else if (platform === "win32") {
-        const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
-        configDir = join(appData, "Claude");
-        configPath = join(configDir, "claude_desktop_config.json");
-    }
-    else {
-        console.error("❌ Claude Desktop is only supported on macOS and Windows.");
-        console.log("\nFor Linux, please manually configure the MCP server.");
+    if (client === "other") {
+        await setupOther();
         return;
     }
-    const mcpServerConfig = {
-        command: "npx",
-        args: ["-y", "@popoverai/dotrequirements", "mcp"],
-        env: {
-            REQUIREMENTS_DIR: process.cwd(),
-        },
-    };
-    try {
-        if (!existsSync(configDir)) {
-            console.log("Creating Claude Desktop config directory...");
-            mkdirSync(configDir, { recursive: true });
-        }
-        let config = {};
-        if (existsSync(configPath)) {
-            try {
-                const existingContent = readFileSync(configPath, "utf-8");
-                if (existingContent.trim()) {
-                    config = JSON.parse(existingContent);
-                }
-            }
-            catch {
-                console.log("⚠️  Existing config file is invalid, creating fresh config...");
-                config = {};
-            }
-        }
-        if (!config.mcpServers) {
-            config.mcpServers = {};
-        }
-        config.mcpServers.dotrequirements = mcpServerConfig;
-        writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-        console.log(`✅ MCP configured successfully!`);
-        console.log(`   Config file: ${configPath}`);
-        console.log(`   REQUIREMENTS_DIR: ${process.cwd()}\n`);
-        console.log("⚠️  Important: Quit and restart Claude Desktop for changes to take effect.");
-        console.log("              (Cmd+Q on macOS, not just close the window)\n");
-        console.log("You can now ask Claude Desktop to help write requirements!\n");
-        // Claude Desktop doesn't use skills like Claude Code, so we skip that step
-    }
-    catch (error) {
-        console.error("❌ Failed to configure MCP automatically.");
-        console.log(`\nError: ${error instanceof Error ? error.message : String(error)}`);
-        console.log("\nYou can manually edit the config file at:");
-        console.log(`  ${configPath}\n`);
-        console.log("Add the following configuration:");
-        const manualConfig = {
-            mcpServers: {
-                dotrequirements: mcpServerConfig,
-            },
-        };
-        console.log(JSON.stringify(manualConfig, null, 2));
-    }
-}
-async function setupCursor(yes = false) {
-    console.log("\n📦 Configuring MCP for Cursor (project-specific)...\n");
-    const configPath = join(process.cwd(), ".cursor", "mcp.json");
-    const configDir = join(process.cwd(), ".cursor");
-    const mcpServerConfig = {
-        command: "npx",
-        args: ["-y", "@popoverai/dotrequirements", "mcp"],
-    };
-    try {
-        if (!existsSync(configDir)) {
-            console.log("Creating Cursor config directory...");
-            mkdirSync(configDir, { recursive: true });
-        }
-        let config = {};
-        if (existsSync(configPath)) {
-            try {
-                const existingContent = readFileSync(configPath, "utf-8");
-                if (existingContent.trim()) {
-                    config = JSON.parse(existingContent);
-                }
-            }
-            catch {
-                console.log("⚠️  Existing config file is invalid, creating fresh config...");
-                config = {};
-            }
-        }
-        if (!config.mcpServers) {
-            config.mcpServers = {};
-        }
-        config.mcpServers.dotrequirements = mcpServerConfig;
-        writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-        console.log(`✅ MCP configured successfully!`);
-        console.log(`   Config file: ${configPath}\n`);
-        console.log("⚠️  Important: Reload or restart Cursor for changes to take effect.");
-        console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("cursor", yes);
-    }
-    catch (error) {
-        console.error("❌ Failed to configure MCP automatically.");
-        console.log(`\nError: ${error instanceof Error ? error.message : String(error)}`);
-        console.log("\nYou can manually edit the config file at:");
-        console.log(`  ${configPath}\n`);
-        console.log("Add the following configuration:");
-        const manualConfig = {
-            mcpServers: {
-                dotrequirements: mcpServerConfig,
-            },
-        };
-        console.log(JSON.stringify(manualConfig, null, 2));
-    }
-}
-async function setupAntigravity(yes = false) {
-    console.log("\n📦 Configuring MCP for Google Antigravity...\n");
-    const configPath = join(homedir(), ".gemini", "antigravity", "mcp_config.json");
-    const configDir = join(homedir(), ".gemini", "antigravity");
-    // Check if we're in a dotrequirements project directory
-    const envLocalPath = join(process.cwd(), ".env.local");
-    let projectId = null;
-    let projectPath = null;
-    if (existsSync(envLocalPath)) {
-        try {
-            const envContent = readFileSync(envLocalPath, "utf-8");
-            const lines = envContent.split("\n");
-            for (const line of lines) {
-                const trimmed = line.trim();
-                if (trimmed.startsWith("DOTREQUIREMENTS_PROJECT_ID=")) {
-                    projectId = trimmed.split("=")[1]?.trim().replace(/['"]/g, "");
-                    projectPath = process.cwd();
-                    break;
-                }
-            }
-        }
-        catch {
-            // .env.local exists but couldn't read it - continue with global setup
-        }
-    }
-    try {
-        if (!existsSync(configDir)) {
-            console.log("Creating Antigravity config directory...");
-            mkdirSync(configDir, { recursive: true });
-        }
-        let config = {};
-        if (existsSync(configPath)) {
-            try {
-                const existingContent = readFileSync(configPath, "utf-8");
-                if (existingContent.trim()) {
-                    config = JSON.parse(existingContent);
-                }
-            }
-            catch {
-                console.log("⚠️  Existing config file is invalid, creating fresh config...");
-                config = {};
-            }
-        }
-        if (!config.mcpServers) {
-            config.mcpServers = {};
-        }
-        if (!config.mcpServers.dotrequirements) {
-            config.mcpServers.dotrequirements = {
-                command: "npx",
-                args: ["-y", "@popoverai/dotrequirements", "mcp"],
-                env: {},
-            };
-        }
-        // biome-ignore lint/suspicious/noExplicitAny: `config` is parsed JSON from a user-owned MCP config file; its shape isn't ours to type fully. We only need the `env` bag, which we narrow ad-hoc here.
-        const dotreqServer = config.mcpServers.dotrequirements;
-        if (!dotreqServer.env) {
-            dotreqServer.env = {};
-        }
-        if (projectId && projectPath) {
-            const envKey = `PROJ_${projectId}`;
-            dotreqServer.env[envKey] = projectPath;
-            console.log(`✅ Added project to MCP config: ${envKey}`);
-            console.log(`   Path: ${projectPath}\n`);
-        }
-        else {
-            console.log(`ℹ️  Not in a ${brand} project directory (no .env.local with DOTREQUIREMENTS_PROJECT_ID found)`);
-            console.log("   Setting up global MCP server only.\n");
-        }
-        writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-        console.log(`✅ MCP configured successfully!`);
-        console.log(`   Config file: ${configPath}\n`);
-        console.log("⚠️  Important: Reload or restart Google Antigravity for changes to take effect.");
-        console.log("\nYou can now ask your AI assistant to help write requirements!");
-        if (projectId) {
-            console.log(`\n💡 To add more projects, run \`dotreq ai-setup\` from each project directory.\n`);
-        }
-        else {
-            console.log("");
-        }
-        await installContextFileSection("antigravity", yes);
-    }
-    catch (error) {
-        console.error("❌ Failed to configure MCP automatically.");
-        console.log(`\nError: ${error instanceof Error ? error.message : String(error)}`);
-        console.log("\nYou can manually edit the config file at:");
-        console.log(`  ${configPath}`);
-    }
-}
-async function setupCodex(yes = false) {
-    console.log("\n📦 Configuring MCP for OpenAI Codex...\n");
-    const command = `codex mcp add dotrequirements -- npx -y @popoverai/dotrequirements mcp`;
-    try {
-        execSync(command, { stdio: "inherit" });
-        console.log("\n✅ MCP configured successfully for Codex!");
-        console.log("\n⚠️  Important: Restart Codex for changes to take effect.");
-        console.log("\nYou can now ask your AI assistant to help write requirements!\n");
-        await installContextFileSection("codex", yes);
-    }
-    catch {
-        console.error("\n❌ Failed to configure MCP automatically.");
-        console.log("\nYou can manually run:");
-        console.log(`  ${command}`);
-        console.log("\nOr manually edit ~/.codex/config.toml and add:");
-        console.log("[mcp_servers.dotrequirements]");
-        console.log('command = "npx"');
-        console.log('args = ["-y", "@popoverai/dotrequirements", "mcp"]');
+    if (!SUPPORTED_ASSISTANTS.includes(client)) {
+        console.log(`\n❌ ${client} is not yet supported.`);
+        console.log("Please refer to the documentation for manual setup.");
+        return;
     }
-}
-async function setupGitHubCopilot(yes = false) {
-    console.log("\n📦 Configuring skills for GitHub Copilot...\n");
-    console.log("ℹ️  GitHub Copilot discovers MCP servers from your IDE configuration.");
-    console.log("   Please configure the MCP server in VS Code settings or GitHub settings.\n");
-    console.log("   MCP server command: npx -y @popoverai/dotrequirements mcp\n");
-    await installContextFileSection("github-copilot", yes);
+    // AISETUP-2: remove any MCP config an earlier version wrote, then install
+    // the workflow guidance (the whole of setup now).
+    await cleanupStaleMcpConfig(client, yes);
+    await installContextFileSection(client, yes);
 }
 async function setupOther() {
     console.log("\n📦 Custom Context File Setup\n");
     console.log("ℹ️  Workflow guidance is added to a context file at your project root.");
     console.log("   Common file names by platform:");
     console.log("   - CLAUDE.md   (Claude Code)");
-    console.log("   - AGENTS.md   (Cursor, Codex, GitHub Copilot)");
-    console.log("   - GEMINI.md   (Antigravity)\n");
+    console.log("   - AGENTS.md   (Cursor, Codex, Antigravity, GitHub Copilot)\n");
     const response = await prompts({
         type: "select",
         name: "file",
@@ -449,7 +299,6 @@ async function setupOther() {
         choices: [
             { title: "AGENTS.md (most compatible)", value: "AGENTS.md" },
             { title: "CLAUDE.md", value: "CLAUDE.md" },
-            { title: "GEMINI.md", value: "GEMINI.md" },
         ],
         initial: 0,
     });
@@ -457,15 +306,10 @@ async function setupOther() {
         console.log("\nSetup cancelled.");
         return;
     }
-    console.log("\n📝 MCP Server Setup\n");
-    console.log("Configure your AI assistant to run the MCP server:");
-    console.log("   Command: npx");
-    console.log("   Args: -y @popoverai/dotrequirements mcp\n");
     // Determine platform based on file choice for the install function
     const platformMap = {
         "CLAUDE.md": "claude-code",
         "AGENTS.md": "cursor", // Any AGENTS.md platform works
-        "GEMINI.md": "antigravity",
     };
     const platform = platformMap[response.file];
     await installContextFileSection(platform);

package/dist/commands/get.js

@@ -1,10 +1,14 @@
 import { glob } from "glob";
-import { formatRequirementTree, getRequirementTree, loadAllRequirements, } from "../requirements/index.js";
+import { formatRequirementTree, loadAllRequirements, } from "../requirements/index.js";
 import { findFilesWithRequirement, findTestCodeForRequirement, } from "../requirements/testCodeExtractor.js";
 export async function getCommand(id) {
     const workspaceRoot = process.cwd();
     const { flattened } = await loadAllRequirements(workspaceRoot);
-    const tree = getRequirementTree(flattened, id);
+    // Match the node itself plus all of its descendants by id prefix (mirrors
+    // the #46 MCP get fix). The shared getRequirementTree only matches on
+    // rootId/id equality, which drops grandchildren (e.g. REQ-123.0.0) when a
+    // child id (REQ-123.0) is requested.
+    const tree = flattened.filter((r) => r.id === id || r.id.startsWith(`${id}.`));
     // CLI-FIND-GET-1.2: missing ID → error + non-zero exit
     if (tree.length === 0) {
         throw new Error(`Requirement "${id}" not found`);

package/dist/commands/init.js

@@ -147,11 +147,10 @@ async function authenticatedFlow(cwd, options) {
     }
     if (projectChoice === "create") {
         await createNewProjectFlow(cwd, client, selectedTeam, options);
+        return true;
     }
-    else {
-        await connectExistingProjectFlow(cwd, client, selectedTeam);
-    }
-    return true;
+    // INIT-12: a cancelled project selection means init did not complete
+    return await connectExistingProjectFlow(cwd, client, selectedTeam);
 }
 /**
  * INIT-18: Prompt user to select a team after OAuth
@@ -268,13 +267,15 @@ async function createNewProjectFlow(cwd, client, team, options) {
 }
 /**
  * INIT-6, INIT-16: Connect to an existing project
+ * Returns true if connected successfully, false if the user cancelled
+ * (INIT-12: cancellation must not read as a successful init)
  */
 async function connectExistingProjectFlow(cwd, client, team) {
     // INIT-6.0, INIT-16.0: Select project from team
     const selectedProject = await selectProject(client, team.teamId);
     if (!selectedProject) {
         console.log("Initialization cancelled.");
-        return;
+        return false;
     }
     // AUTHZ-3: Prompt for secret expiry (paid tier only, if creating new secret)
     const expiryDays = await promptExpiryDays(team.tier);
@@ -306,6 +307,7 @@ async function connectExistingProjectFlow(cwd, client, team) {
     console.log("\nNext steps:");
     console.log("  1. Review the requirements in .requirements/");
     console.log("  2. Add the test harness to your test setup (see README)");
+    return true;
 }
 /**
  * MEMBERSHIP-18: Invite flow - join a team using an invite token
@@ -349,7 +351,7 @@ async function inviteFlow(cwd, token) {
     // MEMBERSHIP-18.1: Accept invite (joins team, marks token used)
     // MEMBERSHIP-18.2: If already a member, continue gracefully
     try {
-        await client.action(api.polar.acceptTeamInvite, { token });
+        await client.mutation(api.teamInvites.mutations.acceptInvite, { token });
         console.log(`✓ Joined team "${inviteInfo.teamName}"`);
     }
     catch (err) {

package/dist/commands/link-resolution.d.ts

@@ -29,7 +29,9 @@ export interface LinkFlags {
     json?: boolean;
 }
 /**
- * LINK-12.3: any deviation flag implies non-interactive mode.
+ * LINK-12.3: any deviation flag implies non-interactive mode. The JSON
+ * output flag does too — machine-readable output only exists on the
+ * non-interactive path, so `link --json` alone must not run interactively.
  */
 export declare function isNonInteractive(flags: LinkFlags): boolean;
 export declare function hasCapacity(team: TeamOption): boolean;

package/dist/commands/link-resolution.js

@@ -6,10 +6,12 @@
  * assistant needs to ask the user and retry with a deviation flag.
  */
 /**
- * LINK-12.3: any deviation flag implies non-interactive mode.
+ * LINK-12.3: any deviation flag implies non-interactive mode. The JSON
+ * output flag does too — machine-readable output only exists on the
+ * non-interactive path, so `link --json` alone must not run interactively.
  */
 export function isNonInteractive(flags) {
-    return Boolean(flags.yes || flags.team || flags.connect || flags.create);
+    return Boolean(flags.yes || flags.team || flags.connect || flags.create || flags.json);
 }
 export function hasCapacity(team) {
     return team.projectLimit === -1 || team.projectCount < team.projectLimit;

package/dist/commands/mcp.d.ts

@@ -1,6 +1,12 @@
 /**
- * MCP command - starts the Model Context Protocol server
- * This allows AI assistants to query requirements data
+ * MCP command — retired stub.
+ *
+ * The local stdio MCP server was retired with the MCP surface migration:
+ * coding agents use the CLI verbs directly (discovered via the workflow
+ * guidance ai-setup installs), and conversational agents use the remote
+ * dotrequirements connector. Configured assistants still invoking
+ * `npx @popoverai/dotrequirements mcp` land here, so this failure explains
+ * itself at the moment someone investigates.
  */
 export declare function mcpCommand(): Promise<void>;
 //# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.js

@@ -1,11 +1,22 @@
 /**
- * MCP command - starts the Model Context Protocol server
- * This allows AI assistants to query requirements data
+ * MCP command — retired stub.
+ *
+ * The local stdio MCP server was retired with the MCP surface migration:
+ * coding agents use the CLI verbs directly (discovered via the workflow
+ * guidance ai-setup installs), and conversational agents use the remote
+ * dotrequirements connector. Configured assistants still invoking
+ * `npx @popoverai/dotrequirements mcp` land here, so this failure explains
+ * itself at the moment someone investigates.
  */
 export async function mcpCommand() {
-    // Import and start the MCP server
-    // The server handles stdio transport and runs until process termination
-    const { main } = await import("../mcp/index.js");
-    await main();
+    throw new Error([
+        "The local MCP server was retired — coding agents now use the dotrequirements CLI directly.",
+        "",
+        "To update this machine's configuration:",
+        "  dotreq ai-setup",
+        "",
+        "It removes stale MCP registrations and installs the current workflow guidance.",
+        "For chat apps (Claude, ChatGPT), use the dot•requirements remote connector instead.",
+    ].join("\n"));
 }
 //# sourceMappingURL=mcp.js.map