@longtable/cli 0.1.10 → 0.1.11

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync, statSync } from "node:fs";
-import { mkdtemp, rm } from "node:fs/promises";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { execSync } from "node:child_process";
 import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
@@ -39,6 +39,10 @@ const ANSI = {
     cyan: "\u001B[36m",
     green: "\u001B[32m"
 };
+const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.11";
+const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
+const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
     return `${prefix}${text}${ANSI.reset}`;
 }
@@ -80,6 +84,7 @@ function usage() {
         "  longtable roles [--json]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
+        "  longtable mcp install [--provider codex|claude|all] [--write] [--json] [--codex-config <path>] [--claude-settings <path>] [--package <spec>]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
         "  longtable question --prompt <decision-context> [--title <text>] [--text <question>] [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json]",
         "  longtable panel [--prompt <text>] [--role <role[,role]>] [--mode review|critique|draft|commit] [--visibility synthesis_only|show_on_conflict|always_visible] [--print] [--json] [--setup <path>] [--cwd <path>]",
@@ -94,6 +99,7 @@ function usage() {
         "  longtable claude install-skills [--dir <path>]",
         "  longtable claude remove-skills [--dir <path>]",
         "  longtable claude status [--dir <path>] [--json]",
+        "  longtable mcp install --provider all",
         "",
         "Examples:",
         "  longtable init --flow interview --provider codex --install-skills",
@@ -113,13 +119,13 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "start", "resume", "doctor", "status", "roles", "show", "install", "codex", "claude", "ask", "question", "panel", "decide"].includes(command);
+    const directCommand = command && ["init", "start", "resume", "doctor", "status", "roles", "show", "install", "mcp", "codex", "claude", "ask", "question", "panel", "decide"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
         startIndex = 1;
     }
-    else if (command === "codex" || command === "claude") {
+    else if (command === "codex" || command === "claude" || command === "mcp") {
         startIndex = 2;
     }
     else if (directCommand) {
@@ -778,6 +784,147 @@ async function runInstall(args) {
     }
     console.log(renderInstallSummary(result));
 }
+function resolveMcpProviders(value) {
+    if (value === "codex" || value === "claude") {
+        return [value];
+    }
+    return ["codex", "claude"];
+}
+function resolveMcpPackageSpec(args) {
+    return typeof args.package === "string" && args.package.trim()
+        ? args.package.trim()
+        : `@longtable/mcp@${LONGTABLE_MCP_PACKAGE_VERSION}`;
+}
+function resolveCodexMcpConfigPath(args) {
+    return resolve(normalizeUserPath(typeof args["codex-config"] === "string" && args["codex-config"].trim()
+        ? args["codex-config"].trim()
+        : "~/.codex/config.toml"));
+}
+function resolveClaudeMcpSettingsPath(args) {
+    return resolve(normalizeUserPath(typeof args["claude-settings"] === "string" && args["claude-settings"].trim()
+        ? args["claude-settings"].trim()
+        : "~/.claude/settings.json"));
+}
+function escapeTomlString(value) {
+    return JSON.stringify(value);
+}
+function renderCodexMcpBlock(serverName, command, mcpArgs) {
+    return [
+        LONGTABLE_MCP_MARKER_START,
+        `[mcp_servers.${serverName}]`,
+        `command = ${escapeTomlString(command)}`,
+        `args = [${mcpArgs.map((arg) => escapeTomlString(arg)).join(", ")}]`,
+        LONGTABLE_MCP_MARKER_END
+    ].join("\n");
+}
+function replaceMarkedCodexMcpBlock(existing, block, serverName) {
+    const markerPattern = new RegExp(`${LONGTABLE_MCP_MARKER_START.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${LONGTABLE_MCP_MARKER_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`, "m");
+    const serverPattern = new RegExp(`\\n?\\[mcp_servers\\.${serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\][\\s\\S]*?(?=\\n\\[|$)`, "m");
+    const trimmed = existing.replace(markerPattern, "").replace(serverPattern, "").trimEnd();
+    return trimmed ? `${trimmed}\n\n${block}\n` : `${block}\n`;
+}
+async function writeCodexMcpConfig(path, block, serverName) {
+    const existing = existsSync(path) ? await readFile(path, "utf8") : "";
+    const updated = replaceMarkedCodexMcpBlock(existing, block, serverName);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, updated, "utf8");
+    return updated;
+}
+function renderClaudeMcpJson(serverName, command, mcpArgs) {
+    return JSON.stringify({
+        mcpServers: {
+            [serverName]: {
+                command,
+                args: mcpArgs
+            }
+        }
+    }, null, 2);
+}
+async function writeClaudeMcpSettings(path, serverName, command, mcpArgs) {
+    let settings = {};
+    if (existsSync(path)) {
+        const raw = await readFile(path, "utf8");
+        settings = raw.trim() ? JSON.parse(raw) : {};
+    }
+    const existingServers = typeof settings.mcpServers === "object" && settings.mcpServers !== null && !Array.isArray(settings.mcpServers)
+        ? settings.mcpServers
+        : {};
+    settings.mcpServers = {
+        ...existingServers,
+        [serverName]: {
+            command,
+            args: mcpArgs
+        }
+    };
+    const updated = JSON.stringify(settings, null, 2);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${updated}\n`, "utf8");
+    return `${updated}\n`;
+}
+function renderMcpInstallSummary(result) {
+    const lines = [
+        "LongTable MCP transport",
+        `- server: ${result.serverName}`,
+        `- package: ${result.packageSpec}`,
+        `- command: ${result.command} ${result.args.join(" ")}`,
+        `- mode: ${result.write ? "wrote provider config" : "printed config only"}`,
+        ""
+    ];
+    for (const target of result.targets) {
+        lines.push(`${target.provider} (${target.path})`);
+        lines.push("```" + target.format);
+        lines.push(target.content.trimEnd());
+        lines.push("```");
+        lines.push("");
+    }
+    if (!result.write) {
+        lines.push("Run again with `--write` to update these provider config files.");
+    }
+    return lines.join("\n").trimEnd();
+}
+async function runMcpSubcommand(subcommand, args) {
+    if (!subcommand || subcommand === "install" || subcommand === "print-config") {
+        const serverName = typeof args.name === "string" && args.name.trim()
+            ? args.name.trim()
+            : LONGTABLE_MCP_SERVER_NAME;
+        const packageSpec = resolveMcpPackageSpec(args);
+        const command = typeof args.command === "string" && args.command.trim() ? args.command.trim() : "npx";
+        const mcpArgs = command === "npx" ? ["-y", packageSpec] : [packageSpec];
+        const providers = resolveMcpProviders(args.provider);
+        const write = args.write === true;
+        const targets = [];
+        for (const provider of providers) {
+            if (provider === "codex") {
+                const path = resolveCodexMcpConfigPath(args);
+                const block = renderCodexMcpBlock(serverName, command, mcpArgs);
+                const content = write ? await writeCodexMcpConfig(path, block, serverName) : block;
+                targets.push({ provider, path, format: "toml", content });
+            }
+            if (provider === "claude") {
+                const path = resolveClaudeMcpSettingsPath(args);
+                const content = write
+                    ? await writeClaudeMcpSettings(path, serverName, command, mcpArgs)
+                    : renderClaudeMcpJson(serverName, command, mcpArgs);
+                targets.push({ provider, path, format: "json", content });
+            }
+        }
+        const result = {
+            serverName,
+            packageSpec,
+            command,
+            args: mcpArgs,
+            write,
+            targets
+        };
+        if (args.json === true) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(renderMcpInstallSummary(result));
+        return;
+    }
+    throw new Error("Unknown mcp subcommand.");
+}
 function commandOnPath(command) {
     try {
         execSync(`command -v ${command}`, { stdio: "ignore" });
@@ -1728,6 +1875,10 @@ async function main() {
         await runInstall(values);
         return;
     }
+    if (command === "mcp") {
+        await runMcpSubcommand(subcommand, values);
+        return;
+    }
     if (command === "ask") {
         await runAsk(values);
         return;

package/dist/index.d.ts

@@ -2,3 +2,4 @@ export * from "./prompt-aliases.js";
 export * from "./personas.js";
 export * from "./persona-router.js";
 export * from "./panel.js";
+export * from "./project-session.js";

package/dist/index.js

@@ -2,3 +2,4 @@ export * from "./prompt-aliases.js";
 export * from "./personas.js";
 export * from "./persona-router.js";
 export * from "./panel.js";
+export * from "./project-session.js";

package/dist/project-session.d.ts

@@ -99,6 +99,7 @@ export interface LongTableWorkspaceInspection {
         timestamp: string;
     }>;
 }
+export declare function loadWorkspaceState(context: LongTableProjectContext): Promise<ResearchState>;
 export declare function syncCurrentWorkspaceView(context: LongTableProjectContext): Promise<string>;
 export declare function appendInvocationRecordToWorkspace(context: LongTableProjectContext, invocation: InvocationRecord, questions?: QuestionRecord[]): Promise<ResearchState>;
 export declare function listBlockingWorkspaceQuestions(context: LongTableProjectContext): Promise<QuestionRecord[]>;

package/dist/project-session.js

@@ -205,6 +205,9 @@ async function loadResearchState(stateFilePath) {
         ...(parsed.studyContract ? { studyContract: parsed.studyContract } : {})
     };
 }
+export async function loadWorkspaceState(context) {
+    return loadResearchState(context.stateFilePath);
+}
 function recentInvocationRecords(state, limit = 3) {
     return (state.invocationLog ?? []).slice(-limit).reverse();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -28,12 +28,12 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.10",
-    "@longtable/core": "0.1.10",
-    "@longtable/memory": "0.1.10",
-    "@longtable/provider-claude": "0.1.10",
-    "@longtable/provider-codex": "0.1.10",
-    "@longtable/setup": "0.1.10"
+    "@longtable/checkpoints": "0.1.11",
+    "@longtable/core": "0.1.11",
+    "@longtable/memory": "0.1.11",
+    "@longtable/provider-claude": "0.1.11",
+    "@longtable/provider-codex": "0.1.11",
+    "@longtable/setup": "0.1.11"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",