@longtable/cli 0.1.14 → 0.1.15

package/README.md

@@ -19,6 +19,25 @@ The basic contract is:
 npm install -g @longtable/cli
 ```
 
+For global npm installs, LongTable also bootstraps provider-native skill files:
+
+- Codex skills are written to `~/.codex/skills/`.
+- Claude Code skills are written when the `claude` command is detected.
+- `LONGTABLE_POSTINSTALL_PROVIDERS=all npm install -g @longtable/cli` installs
+  both provider skill sets.
+- `LONGTABLE_SKIP_POSTINSTALL=1 npm install -g @longtable/cli` skips the skill
+  bootstrap.
+
+MCP config writes are intentionally opt-in:
+
+```bash
+longtable mcp install --provider codex --write
+```
+
+During `longtable init --flow interview`, LongTable asks whether to configure
+MCP and whether provider-native team/subagent surfaces should be used when they
+are available. The stable fallback remains LongTable's sequential panel.
+
 ## Primary Flow
 
 ```bash

package/dist/cli.js

@@ -40,7 +40,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.14";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.15";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -76,7 +76,7 @@ function usage() {
         "  Run `longtable ...` in your terminal, not inside the Codex chat box.",
         "  After `longtable start`, move into the created project directory and open `codex` there.",
         "",
-        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--entry-mode explore|review|critique|draft|commit] [--weakest-domain theory|methodology|measurement|analysis|writing] [--panel-preference synthesis_only|show_on_conflict|always_visible] [--json] [--no-install] [--install-skills] [--install-prompts]",
+        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--entry-mode explore|review|critique|draft|commit] [--weakest-domain theory|methodology|measurement|analysis|writing] [--panel-preference synthesis_only|show_on_conflict|always_visible] [--agent-team native_when_available|sequential_panel_only] [--mcp skip|print_config|write_provider|write_all] [--json] [--no-install] [--install-skills] [--install-prompts]",
         "  longtable start [--path <dir>] [--name <project>] [--goal <text>] [--blocker <text>] [--perspectives <role[,role]>] [--disagreement synthesis_only|show_on_conflict|always_visible] [--setup <path>] [--json]",
         "  longtable resume [--cwd <path>] [--json]",
         "  longtable doctor [--cwd <path>] [--fix] [--json] [--codex-dir <path>] [--claude-dir <path>] [--codex-prompts-dir <path>] [--codex-runtime-path <file>] [--claude-runtime-path <file>]",
@@ -197,9 +197,12 @@ function questionSection(questionId) {
     if (questionId === "preferredCheckpointIntensity" || questionId === "preferredEntryMode") {
         return "Interaction style";
     }
-    if (questionId === "weakestDomain" || questionId === "panelPreference") {
+    if (questionId === "weakestDomain" || questionId === "panelPreference" || questionId === "agentTeamPreference") {
         return "How LongTable should challenge you";
     }
+    if (questionId === "mcpPreference") {
+        return "Provider integration";
+    }
     return "Authorship and voice";
 }
 function formatModeLabel(mode) {
@@ -496,6 +499,12 @@ function toSetupAnswers(args) {
             : undefined,
         panelPreference: typeof args["panel-preference"] === "string"
             ? String(args["panel-preference"])
+            : undefined,
+        agentTeamPreference: typeof args["agent-team"] === "string"
+            ? String(args["agent-team"])
+            : undefined,
+        mcpPreference: typeof args.mcp === "string"
+            ? String(args.mcp)
             : undefined
     };
 }
@@ -543,6 +552,11 @@ async function collectInteractiveAnswers(initialFlow) {
                 answers.weakestDomain = value;
             if (question.id === "panelPreference")
                 answers.panelPreference = value;
+            if (question.id === "agentTeamPreference") {
+                answers.agentTeamPreference = value;
+            }
+            if (question.id === "mcpPreference")
+                answers.mcpPreference = value;
         }
         return {
             flow,
@@ -657,6 +671,12 @@ function normalizePersistAnswers(raw) {
                 : {}),
             ...(raw.panelPreference
                 ? { panelPreference: raw.panelPreference }
+                : {}),
+            ...(raw.agentTeamPreference
+                ? { agentTeamPreference: raw.agentTeamPreference }
+                : {}),
+            ...(raw.mcpPreference
+                ? { mcpPreference: raw.mcpPreference }
                 : {})
         }
     };
@@ -685,6 +705,15 @@ async function readPersistAnswers(args) {
     }
     throw new Error("persist-init requires either --answers-json, --stdin, or the full set of setup flags.");
 }
+async function applySetupMcpPreference(provider, preference) {
+    if (!preference || preference === "skip") {
+        return undefined;
+    }
+    return installMcpConfig({
+        provider: preference === "write_all" ? "all" : provider,
+        write: preference === "write_provider" || preference === "write_all"
+    });
+}
 async function runInit(args) {
     const json = args.json === true;
     const installRuntime = args["no-install"] !== true;
@@ -717,15 +746,17 @@ async function runInit(args) {
     if (provider === "claude" && installSkills) {
         installedSkills = await installClaudeSkills(listRoleDefinitions(), skillsDir);
     }
+    const mcpInstall = await applySetupMcpPreference(provider, answers.mcpPreference);
     if (json) {
-        if (installedPrompts.length === 0 && installedSkills.length === 0) {
+        if (installedPrompts.length === 0 && installedSkills.length === 0 && !mcpInstall) {
             console.log(serializeSetupOutput(outputValue));
             return;
         }
         console.log(JSON.stringify({
             setup: outputValue,
             installedPrompts: installedPrompts.map((prompt) => prompt.name),
-            installedSkills: installedSkills.map((skill) => skill.name)
+            installedSkills: installedSkills.map((skill) => skill.name),
+            mcpInstall
         }, null, 2));
         return;
     }
@@ -750,6 +781,10 @@ async function runInit(args) {
         }
         console.log("  Use these by naming LongTable naturally, e.g. `lt panel: ...`.");
     }
+    if (mcpInstall) {
+        console.log("");
+        console.log(renderMcpInstallSummary(mcpInstall));
+    }
     if (provider === "codex") {
         console.log("");
         console.log("Next step:");
@@ -883,40 +918,43 @@ function renderMcpInstallSummary(result) {
     }
     return lines.join("\n").trimEnd();
 }
+async function installMcpConfig(args) {
+    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 });
+        }
+    }
+    return {
+        serverName,
+        packageSpec,
+        command,
+        args: mcpArgs,
+        write,
+        targets
+    };
+}
 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
-        };
+        const result = await installMcpConfig(args);
         if (args.json === true) {
             console.log(JSON.stringify(result, null, 2));
             return;
@@ -1449,7 +1487,8 @@ async function runPanelCommand(args) {
         mode,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
         provider,
-        visibility
+        visibility,
+        agentTeamPreference: setup?.profileSeed.agentTeamPreference
     });
     if (projectAware.projectContextFound) {
         const context = await loadProjectContextFromDirectory(workingDirectory);

package/dist/panel.d.ts

@@ -1,4 +1,4 @@
-import type { CheckpointSensitivity, InteractionMode, InvocationIntent, InvocationRecord, PanelPlan, PanelResult, PanelVisibility, QuestionRecord, ProviderKind, RoleKey } from "@longtable/core";
+import type { CheckpointSensitivity, InteractionMode, InvocationIntent, InvocationSurface, InvocationRecord, PanelPlan, PanelResult, PanelVisibility, QuestionRecord, ProviderKind, RoleKey } from "@longtable/core";
 import { type CanonicalPersona } from "./personas.js";
 export interface BuildPanelPlanOptions {
     prompt: string;
@@ -7,6 +7,7 @@ export interface BuildPanelPlanOptions {
     roles?: CanonicalPersona[];
     provider?: ProviderKind;
     visibility?: PanelVisibility;
+    agentTeamPreference?: "native_when_available" | "sequential_panel_only";
 }
 export interface PanelFallback {
     intent: InvocationIntent;
@@ -22,6 +23,7 @@ export declare function buildInvocationIntent(options: {
     mode?: InteractionMode;
     roles: RoleKey[];
     provider?: ProviderKind;
+    requestedSurface?: InvocationSurface;
     visibility?: PanelVisibility;
     checkpointSensitivity?: CheckpointSensitivity;
     rationale?: string[];

package/dist/panel.js

@@ -67,6 +67,9 @@ export function buildPanelPlan(options) {
     const routedRoles = routePersonas(options.prompt).consultedRoles;
     const roles = resolvePanelRoles(options);
     const createdAt = nowIso();
+    const preferredSurface = options.agentTeamPreference === "native_when_available"
+        ? "native_parallel"
+        : "sequential_fallback";
     return {
         id: createId("panel_plan"),
         createdAt,
@@ -74,12 +77,14 @@ export function buildPanelPlan(options) {
         prompt: options.prompt,
         members: roles.map((role) => memberForRole(role, explicitRoles, routedRoles)),
         visibility: options.visibility ?? "always_visible",
-        preferredSurface: "sequential_fallback",
+        preferredSurface,
         fallbackSurface: "sequential_fallback",
         checkpointSensitivity: highestSensitivity(roles),
         rationale: [
-            "Option A uses provider-neutral panel semantics before native provider orchestration.",
-            "Sequential fallback is the stable execution path for both Claude Code and Codex.",
+            preferredSurface === "native_parallel"
+                ? "Setup prefers native provider team/subagent surfaces when available."
+                : "Setup prefers LongTable's provider-neutral sequential panel surface.",
+            "Sequential fallback remains the stable execution path for both Claude Code and Codex.",
             roles.length === explicitRoles.length && explicitRoles.length > 0
                 ? "The panel is constrained by explicitly requested roles."
                 : "The panel combines default research-review roles with prompt-triggered roles."
@@ -94,7 +99,7 @@ export function buildInvocationIntent(options) {
         prompt: options.prompt,
         roles: options.roles,
         provider: options.provider,
-        requestedSurface: "sequential_fallback",
+        requestedSurface: options.requestedSurface ?? "sequential_fallback",
         visibility: options.visibility ?? "always_visible",
         checkpointSensitivity: options.checkpointSensitivity ?? "medium",
         rationale: options.rationale ?? ["Panel invocation requested."]
@@ -230,6 +235,7 @@ export function buildPanelFallback(options) {
         mode: plan.mode,
         roles: plan.members.map((member) => member.role),
         provider: options.provider,
+        requestedSurface: plan.preferredSurface,
         visibility: plan.visibility,
         checkpointSensitivity: plan.checkpointSensitivity,
         rationale: plan.rationale

package/dist/project-session.d.ts

@@ -17,6 +17,8 @@ export interface LongTableProjectRecord {
         humanAuthorshipSignal?: string;
         weakestDomain?: string;
         defaultPanelPreference?: ProjectDisagreementPreference;
+        agentTeamPreference?: string;
+        mcpPreference?: string;
     };
 }
 export interface LongTableSessionRecord {

package/dist/project-session.js

@@ -917,6 +917,12 @@ export async function createOrUpdateProjectWorkspace(options) {
                     : {}),
                 ...(options.setup.profileSeed.panelPreference
                     ? { defaultPanelPreference: options.setup.profileSeed.panelPreference }
+                    : {}),
+                ...(options.setup.profileSeed.agentTeamPreference
+                    ? { agentTeamPreference: options.setup.profileSeed.agentTeamPreference }
+                    : {}),
+                ...(options.setup.profileSeed.mcpPreference
+                    ? { mcpPreference: options.setup.profileSeed.mcpPreference }
                     : {})
             }
         };

package/dist/prompt-aliases.js

@@ -35,7 +35,7 @@ function promptSpec() {
                 "Do not move to the next question until the researcher answers the current one.",
                 "Quickstart covers: provider, field, career stage, experience level, checkpoint intensity, and human authorship signal.",
                 "Interview also covers: preferred entry mode, weakest domain, and panel visibility preference.",
-                "After collecting all answers, summarize the proposed setup and then output both: 1) the exact `longtable codex persist-init ... --install-skills` command and 2) a strict JSON object with keys provider, flow, field, careerStage, experienceLevel, preferredCheckpointIntensity, and optional humanAuthorshipSignal, preferredEntryMode, weakestDomain, panelPreference.",
+                "After collecting all answers, summarize the proposed setup and then output both: 1) the exact `longtable codex persist-init ... --install-skills` command and 2) a strict JSON object with keys provider, flow, field, careerStage, experienceLevel, preferredCheckpointIntensity, and optional humanAuthorshipSignal, preferredEntryMode, weakestDomain, panelPreference, agentTeamPreference, mcpPreference.",
                 "If the user prefers paste-based setup, tell them they can pipe the JSON into `longtable codex persist-init --stdin --install-skills`.",
                 "If the researcher asks you to stay inside Codex, keep the conversation in numbered form and do not prematurely close.",
                 "Frame the setup like a short researcher interview, not a bare config form.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -21,19 +21,21 @@
   "files": [
     "dist",
     "bin",
+    "scripts/postinstall.mjs",
     "README.md"
   ],
   "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs",
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.14",
-    "@longtable/core": "0.1.14",
-    "@longtable/memory": "0.1.14",
-    "@longtable/provider-claude": "0.1.14",
-    "@longtable/provider-codex": "0.1.14",
-    "@longtable/setup": "0.1.14"
+    "@longtable/checkpoints": "0.1.15",
+    "@longtable/core": "0.1.15",
+    "@longtable/memory": "0.1.15",
+    "@longtable/provider-claude": "0.1.15",
+    "@longtable/provider-codex": "0.1.15",
+    "@longtable/setup": "0.1.15"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",

package/scripts/postinstall.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+
+function envFlag(name) {
+  const value = process.env[name];
+  if (!value) return false;
+  return !["0", "false", "no", "off"].includes(value.toLowerCase());
+}
+
+function isGlobalInstall() {
+  return process.env.npm_config_global === "true" || process.env.npm_config_location === "global";
+}
+
+function commandOnPath(command) {
+  try {
+    execSync(`command -v ${command}`, { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function requestedProviders() {
+  const raw = process.env.LONGTABLE_POSTINSTALL_PROVIDERS?.trim().toLowerCase();
+  if (!raw || raw === "auto") {
+    const providers = ["codex"];
+    if (commandOnPath("claude")) providers.push("claude");
+    return providers;
+  }
+  if (raw === "all") return ["codex", "claude"];
+  return raw
+    .split(",")
+    .map((entry) => entry.trim())
+    .filter((entry) => entry === "codex" || entry === "claude");
+}
+
+async function main() {
+  if (!isGlobalInstall() || envFlag("LONGTABLE_SKIP_POSTINSTALL")) {
+    return;
+  }
+
+  const distEntrypoint = fileURLToPath(new URL("../dist/personas.js", import.meta.url));
+  if (!existsSync(distEntrypoint)) {
+    console.warn("[longtable] Skipped provider skill bootstrap because package build output was not found.");
+    return;
+  }
+
+  const providers = requestedProviders();
+  if (providers.length === 0) {
+    return;
+  }
+
+  const { listRoleDefinitions } = await import("../dist/personas.js");
+  const roles = listRoleDefinitions();
+  const installed = [];
+
+  if (providers.includes("codex")) {
+    const { installCodexSkills, resolveCodexSkillsDir } = await import("@longtable/provider-codex");
+    const skills = await installCodexSkills(roles);
+    installed.push(`Codex skills: ${skills.length} (${resolveCodexSkillsDir()})`);
+  }
+
+  if (providers.includes("claude")) {
+    const { installClaudeSkills, resolveClaudeSkillsDir } = await import("@longtable/provider-claude");
+    const skills = await installClaudeSkills(roles);
+    installed.push(`Claude skills: ${skills.length} (${resolveClaudeSkillsDir()})`);
+  }
+
+  if (installed.length > 0) {
+    console.log("[longtable] Provider skills installed during global npm install:");
+    for (const line of installed) {
+      console.log(`[longtable] - ${line}`);
+    }
+    console.log("[longtable] Run `longtable doctor` to verify setup.");
+    console.log("[longtable] MCP config is opt-in: run `longtable mcp install --provider codex --write` when you want provider config files updated.");
+  }
+}
+
+main().catch((error) => {
+  console.warn(`[longtable] Postinstall provider skill bootstrap failed: ${error instanceof Error ? error.message : String(error)}`);
+  console.warn("[longtable] You can repair this later with `longtable doctor --fix`.");
+});