@longtable/cli 0.1.15 → 0.1.17

package/dist/cli.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { execSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output, cwd, exit } from "node:process";
-import { dirname, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
+import { classifyCheckpointTrigger } from "@longtable/checkpoints";
 import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, serializeSetupOutput, writeRuntimeConfig } from "@longtable/setup";
 import { buildCodexSkillSpecs, buildCodexThinWrappedPrompt, installCodexSkills, listInstalledCodexSkills, renderQuestionRecordPrompt, removeCodexSkills, resolveCodexSkillsDir, runCodexThinWrapper } from "@longtable/provider-codex";
 import { buildClaudeSkillSpecs, installClaudeSkills, listInstalledClaudeSkills, renderQuestionRecordInput, removeClaudeSkills, resolveClaudeSkillsDir } from "@longtable/provider-claude";
@@ -14,7 +15,8 @@ import { installCodexPromptAliases, listInstalledCodexPromptAliases, removeCodex
 import { buildPersonaGuidance, parseInvocationDirective } from "./persona-router.js";
 import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
-import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, createWorkspaceClarificationCard, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadProjectContextFromDirectory, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
+import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, createWorkspaceClarificationCard, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
+import { buildTeamDebate, renderTeamDebateSummary } from "./debate.js";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -40,7 +42,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.15";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.17";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -76,7 +78,8 @@ 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] [--agent-team native_when_available|sequential_panel_only] [--mcp skip|print_config|write_provider|write_all] [--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] [--json] [--no-install] [--install-skills] [--install-prompts]",
+        "  longtable setup [--provider codex|claude] [--json] [--dir <path>] [--skills-dir <path>] [--runtime-path <file>] [--setup-path <file>]",
         "  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>]",
@@ -85,6 +88,9 @@ function usage() {
         "  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 hud [--watch] [--tmux] [--preset minimal|full] [--cwd <path>] [--json]",
+        "  longtable sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
+        "  longtable team --prompt <text> [--role <role[,role]>] [--tmux] [--debate] [--rounds 5] [--cwd <path>] [--json]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
         "  longtable clarify --prompt <task-context> [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json] [--force]",
         "  longtable question --prompt <decision-context> [--title <text>] [--text <question>] [--provider codex|claude] [--required|--advisory] [--print] [--cwd <path>] [--json]",
@@ -120,7 +126,7 @@ 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", "mcp", "codex", "claude", "ask", "clarify", "question", "panel", "decide"].includes(command);
+    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "panel", "decide", "hud", "sentinel", "team"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -197,12 +203,9 @@ function questionSection(questionId) {
     if (questionId === "preferredCheckpointIntensity" || questionId === "preferredEntryMode") {
         return "Interaction style";
     }
-    if (questionId === "weakestDomain" || questionId === "panelPreference" || questionId === "agentTeamPreference") {
+    if (questionId === "weakestDomain" || questionId === "panelPreference") {
         return "How LongTable should challenge you";
     }
-    if (questionId === "mcpPreference") {
-        return "Provider integration";
-    }
     return "Authorship and voice";
 }
 function formatModeLabel(mode) {
@@ -499,12 +502,6 @@ 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
     };
 }
@@ -552,11 +549,6 @@ 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,
@@ -568,6 +560,172 @@ async function collectInteractiveAnswers(initialFlow) {
         rl.close();
     }
 }
+function buildPermissionSetupChoices() {
+    return {
+        surfaces: [
+            {
+                id: "cli_only",
+                label: "CLI only",
+                description: "Why: least invasive. Tradeoff: no natural in-provider LongTable entrypoints."
+            },
+            {
+                id: "skills",
+                label: "Skills",
+                description: "Why: enables natural LongTable skill routing. Tradeoff: writes provider skill files."
+            },
+            {
+                id: "skills_mcp",
+                label: "Skills + MCP",
+                description: "Why: adds structured state access. Tradeoff: writes provider config for MCP transport."
+            },
+            {
+                id: "skills_mcp_sentinel",
+                label: "Skills + MCP + Sentinel",
+                description: "Why: prepares advisory gap/tacit monitoring. Tradeoff: LongTable may nudge research turns."
+            }
+        ],
+        intervention: [
+            {
+                id: "advisory",
+                label: "Advisory",
+                description: "Why: notices gaps without blocking. Tradeoff: you may still miss hard commitments."
+            },
+            {
+                id: "balanced",
+                label: "Balanced",
+                description: "Why: blocks clear theory, measurement, method, or evidence commitments. Tradeoff: occasional stops."
+            },
+            {
+                id: "strong",
+                label: "Strong",
+                description: "Why: maximizes judgment protection. Tradeoff: more interruption before closure."
+            }
+        ],
+        tmux: [
+            {
+                id: "standard",
+                label: "Standard chat",
+                description: "Why: portable default. Tradeoff: checkpoints and gaps are less persistently visible."
+            },
+            {
+                id: "hud",
+                label: "Research HUD",
+                description: "Why: keeps goals, blockers, and pending checkpoints visible. Requires tmux."
+            },
+            {
+                id: "console",
+                label: "Research console",
+                description: "Why: enables a richer tmux layout for HUD and team discussion. Requires tmux."
+            }
+        ],
+        team: [
+            {
+                id: "off",
+                label: "Off",
+                description: "Why: simplest. Tradeoff: panel disagreement stays inside one LongTable response."
+            },
+            {
+                id: "panel",
+                label: "Structured panel",
+                description: "Why: role disagreement is visible without tmux. Tradeoff: not parallel."
+            },
+            {
+                id: "tmux_team",
+                label: "Tmux team discussion",
+                description: "Why: opens role panes for parallel debate. Tradeoff: terminal complexity and cleanup."
+            }
+        ]
+    };
+}
+function checkpointIntensityFromIntervention(choice) {
+    if (choice === "strong")
+        return "high";
+    if (choice === "advisory")
+        return "low";
+    return "balanced";
+}
+async function runSetup(args) {
+    const json = args.json === true;
+    const rl = createInterface({ input, output });
+    try {
+        const provider = (typeof args.provider === "string"
+            ? (args.provider === "claude" ? "claude" : "codex")
+            : await promptChoice(rl, "Which provider should LongTable configure?", buildProviderChoices()));
+        const choices = buildPermissionSetupChoices();
+        const surfaces = await promptChoice(rl, [
+            "Which LongTable runtime surfaces should be enabled?",
+            "This is a permission choice because skills, MCP, and sentinel support write provider-facing runtime files."
+        ].join("\n"), choices.surfaces);
+        const intervention = await promptChoice(rl, "How strongly may LongTable interrupt research decisions?", choices.intervention);
+        const tmuxMode = await promptChoice(rl, "Should LongTable recommend a tmux-based research interface?", choices.tmux);
+        const teamMode = await promptChoice(rl, "Should LongTable enable agent/team discussion mode?", choices.team);
+        const outputValue = createPersistedSetupOutput({
+            field: "unspecified",
+            careerStage: "unspecified",
+            experienceLevel: "advanced",
+            preferredCheckpointIntensity: checkpointIntensityFromIntervention(intervention),
+            preferredEntryMode: "explore",
+            panelPreference: teamMode === "off" ? "show_on_conflict" : "always_visible"
+        }, provider, "quickstart");
+        outputValue.initialState.explicitState = {
+            ...outputValue.initialState.explicitState,
+            runtimeSurfaces: surfaces,
+            interventionPosture: intervention,
+            tmuxMode,
+            teamMode
+        };
+        if (surfaces === "skills_mcp_sentinel") {
+            outputValue.initialState.inferredHypotheses.push({
+                hypothesis: "Researcher approved advisory Gap/Tacit Sentinel setup.",
+                confidence: 0.95,
+                evidence: ["Selected Skills + MCP + Sentinel during permission-first setup."],
+                status: "confirmed"
+            });
+        }
+        const result = await saveSetupAndRuntimeConfig(outputValue, {
+            setupPath: typeof args["setup-path"] === "string" ? args["setup-path"] : undefined,
+            runtimePath: typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined
+        });
+        const installedSkills = surfaces === "cli_only"
+            ? []
+            : provider === "codex"
+                ? await installCodexSkills(listRoleDefinitions(), typeof args["skills-dir"] === "string" ? args["skills-dir"] : typeof args.dir === "string" ? args.dir : undefined)
+                : await installClaudeSkills(listRoleDefinitions(), typeof args["skills-dir"] === "string" ? args["skills-dir"] : typeof args.dir === "string" ? args.dir : undefined);
+        const mcpRequested = surfaces === "skills_mcp" || surfaces === "skills_mcp_sentinel";
+        if (mcpRequested && !json) {
+            console.log("");
+            console.log("MCP setup is approved. To write provider config now, run:");
+            console.log(`- longtable mcp install --provider ${provider} --write`);
+        }
+        if (json) {
+            console.log(JSON.stringify({
+                setup: outputValue,
+                runtime: result,
+                installedSkills: installedSkills.map((skill) => skill.name),
+                mcpRequested,
+                tmuxMode,
+                teamMode
+            }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log(renderSetupSummary(outputValue));
+        console.log("");
+        console.log(renderInstallSummary(result));
+        console.log(`Installed skills: ${installedSkills.length}`);
+        if (tmuxMode !== "standard") {
+            console.log("");
+            console.log("Tmux recommendation:");
+            console.log("- macOS: brew install tmux");
+            console.log("- Ubuntu/Debian: sudo apt install tmux");
+            console.log("- Start HUD in an existing tmux session: longtable hud --tmux");
+            console.log("- Start a discussion team: longtable team --tmux --prompt \"...\"");
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
 function perspectiveChoices() {
     return PERSONA_DEFINITIONS.map((persona) => ({
         id: persona.key,
@@ -671,12 +829,6 @@ function normalizePersistAnswers(raw) {
                 : {}),
             ...(raw.panelPreference
                 ? { panelPreference: raw.panelPreference }
-                : {}),
-            ...(raw.agentTeamPreference
-                ? { agentTeamPreference: raw.agentTeamPreference }
-                : {}),
-            ...(raw.mcpPreference
-                ? { mcpPreference: raw.mcpPreference }
                 : {})
         }
     };
@@ -705,15 +857,6 @@ 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;
@@ -746,17 +889,15 @@ 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 && !mcpInstall) {
+        if (installedPrompts.length === 0 && installedSkills.length === 0) {
             console.log(serializeSetupOutput(outputValue));
             return;
         }
         console.log(JSON.stringify({
             setup: outputValue,
             installedPrompts: installedPrompts.map((prompt) => prompt.name),
-            installedSkills: installedSkills.map((skill) => skill.name),
-            mcpInstall
+            installedSkills: installedSkills.map((skill) => skill.name)
         }, null, 2));
         return;
     }
@@ -781,10 +922,6 @@ 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:");
@@ -918,43 +1055,40 @@ 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 result = await 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 });
+            }
+        }
+        const result = {
+            serverName,
+            packageSpec,
+            command,
+            args: mcpArgs,
+            write,
+            targets
+        };
         if (args.json === true) {
             console.log(JSON.stringify(result, null, 2));
             return;
@@ -1428,9 +1562,6 @@ async function runModeCommand(mode, args) {
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
     const projectContext = await loadProjectContextFromDirectory(workingDirectory);
-    if (projectContext) {
-        await assertWorkspaceNotBlocked(projectContext);
-    }
     const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
     const panelPreference = setup?.profileSeed.panelPreference;
     const panelRequested = args.panel === true ||
@@ -1487,8 +1618,7 @@ async function runPanelCommand(args) {
         mode,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
         provider,
-        visibility,
-        agentTeamPreference: setup?.profileSeed.agentTeamPreference
+        visibility
     });
     if (projectAware.projectContextFound) {
         const context = await loadProjectContextFromDirectory(workingDirectory);
@@ -1809,6 +1939,302 @@ async function runAsk(args) {
     }
     await runModeCommand(mode, delegatedArgs);
 }
+function localId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function shellEscape(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+async function writeJsonFile(path, value) {
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function writeTeamDebateArtifacts(bundle, teamDir, prompt) {
+    await mkdir(teamDir, { recursive: true });
+    await writeFile(join(teamDir, "prompt.txt"), prompt, "utf8");
+    await writeJsonFile(join(teamDir, "plan.json"), bundle.plan);
+    await writeJsonFile(join(teamDir, "run.json"), bundle.run);
+    for (const round of bundle.run.rounds) {
+        await mkdir(round.artifactDir, { recursive: true });
+        await writeJsonFile(join(round.artifactDir, "round.json"), round);
+        for (const contribution of round.contributions) {
+            await writeJsonFile(join(teamDir, contribution.artifactPath), contribution);
+        }
+    }
+    await writeJsonFile(join(teamDir, "synthesis.json"), bundle.run.synthesis);
+    await writeJsonFile(join(teamDir, "checkpoint.json"), bundle.questionRecord);
+    await writeJsonFile(join(teamDir, "invocation.json"), bundle.invocationRecord);
+}
+function sentinelSummary(prompt, workingDirectory) {
+    const trigger = classifyCheckpointTrigger(prompt, {
+        fallbackMode: "explore",
+        unresolvedTensions: []
+    });
+    const normalized = prompt.toLowerCase();
+    const signals = [];
+    if (/measure|measurement|scale|validity|reliability|측정|척도|타당도|신뢰도/.test(normalized)) {
+        signals.push("measurement gap or commitment");
+    }
+    if (/theory|theoretical|framework|construct|이론|프레임워크|개념/.test(normalized)) {
+        signals.push("theory or construct commitment");
+    }
+    if (/method|design|sample|participant|방법|설계|표본|참여자/.test(normalized)) {
+        signals.push("method/design gap");
+    }
+    if (/citation|reference|source|evidence|doi|문헌|인용|근거|출처/.test(normalized)) {
+        signals.push("evidence gap");
+    }
+    if (/voice|authorship|narrative|저자성|서사|문체|목소리/.test(normalized)) {
+        signals.push("authorship or narrative-trace risk");
+    }
+    if (/assumption|implicit|tacit|암묵|전제|가정/.test(normalized)) {
+        signals.push("tacit assumption risk");
+    }
+    return {
+        cwd: workingDirectory,
+        checkpoint: trigger.signal.checkpointKey,
+        family: trigger.family,
+        confidence: trigger.confidence,
+        requiresQuestionBeforeClosure: trigger.requiresQuestionBeforeClosure,
+        signals: signals.length > 0 ? signals : ["no specific gap/tacit signal beyond checkpoint classifier"],
+        rationale: trigger.rationale
+    };
+}
+async function runSentinel(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt) {
+        throw new Error("A prompt is required.");
+    }
+    const summary = sentinelSummary(prompt, workingDirectory);
+    const context = await loadProjectContextFromDirectory(workingDirectory);
+    if (args.record === true && context) {
+        const state = await loadWorkspaceState(context);
+        state.inferredHypotheses.push({
+            hypothesis: `Sentinel detected: ${summary.signals.join(", ")}.`,
+            confidence: summary.confidence === "high" ? 0.85 : summary.confidence === "medium" ? 0.65 : 0.4,
+            evidence: [`Prompt: ${prompt}`],
+            status: "unconfirmed"
+        });
+        if (summary.requiresQuestionBeforeClosure) {
+            state.openTensions.push(`Pending sentinel risk: ${summary.checkpoint}`);
+        }
+        await writeFile(context.stateFilePath, JSON.stringify(state, null, 2), "utf8");
+        await syncCurrentWorkspaceView(context);
+    }
+    if (args.json === true) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    console.log("LongTable Sentinel");
+    console.log(`- checkpoint: ${summary.checkpoint}`);
+    console.log(`- family: ${summary.family}`);
+    console.log(`- confidence: ${summary.confidence}`);
+    console.log(`- question before closure: ${summary.requiresQuestionBeforeClosure ? "yes" : "no"}`);
+    console.log("- detected signals:");
+    for (const signal of summary.signals) {
+        console.log(`  - ${signal}`);
+    }
+    if (args.record === true) {
+        console.log(context ? `- recorded in: ${context.stateFilePath}` : "- record skipped: no LongTable workspace found");
+    }
+}
+function renderHudText(inspection, preset) {
+    if (!inspection.found) {
+        return [
+            "LongTable HUD",
+            "- workspace: not found",
+            "- run `longtable start` for durable research state"
+        ].join("\n");
+    }
+    const lines = [
+        "LongTable HUD",
+        `- project: ${inspection.project?.name}`,
+        `- goal: ${inspection.session?.currentGoal}`,
+        ...(inspection.session?.currentBlocker ? [`- blocker: ${inspection.session.currentBlocker}`] : []),
+        `- questions: ${inspection.counts?.pendingQuestions ?? 0} pending / ${inspection.counts?.questions ?? 0} total`,
+        `- decisions: ${inspection.counts?.decisions ?? 0}`,
+        `- invocations: ${inspection.counts?.invocations ?? 0}`
+    ];
+    if (preset !== "minimal") {
+        lines.push("- pending checkpoints:");
+        for (const question of inspection.pendingQuestions ?? []) {
+            lines.push(`  - ${question.required ? "required" : "advisory"}: ${question.question}`);
+        }
+        lines.push("- recent decisions:");
+        for (const decision of inspection.recentDecisions ?? []) {
+            lines.push(`  - ${decision.summary}`);
+        }
+    }
+    return lines.join("\n");
+}
+async function runHud(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const preset = typeof args.preset === "string" ? args.preset : "full";
+    if (args.tmux === true) {
+        if (!process.env.TMUX) {
+            throw new Error("`longtable hud --tmux` must be run inside an existing tmux session.");
+        }
+        const launcher = process.argv[1] ?? "longtable";
+        const command = `node ${shellEscape(launcher)} hud --watch --preset ${shellEscape(preset)} --cwd ${shellEscape(workingDirectory)}`;
+        execFileSync("tmux", ["split-window", "-v", "-l", "10", command], { stdio: "inherit" });
+        return;
+    }
+    while (true) {
+        const inspection = await inspectProjectWorkspace(workingDirectory);
+        if (args.json === true) {
+            console.log(JSON.stringify(inspection, null, 2));
+            return;
+        }
+        if (args.watch === true) {
+            process.stdout.write("\u001Bc");
+        }
+        console.log(renderHudText(inspection, preset));
+        if (args.watch !== true) {
+            return;
+        }
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, 1500));
+    }
+}
+async function runTeam(args) {
+    const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+    const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt) {
+        throw new Error("A prompt is required.");
+    }
+    const rounds = typeof args.rounds === "string" ? Number(args.rounds) : 5;
+    if (!Number.isInteger(rounds) || rounds !== 5) {
+        throw new Error("LongTable team debate v1 supports `--rounds 5` only.");
+    }
+    const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
+    const projectContext = await loadProjectContextFromDirectory(workingDirectory);
+    if (projectContext) {
+        await assertWorkspaceNotBlocked(projectContext);
+    }
+    const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
+    const fallback = buildPanelFallback({
+        prompt,
+        mode: "review",
+        roleFlag: typeof args.role === "string" ? args.role : undefined,
+        provider: setup?.providerSelection.provider,
+        visibility: "always_visible"
+    });
+    const teamId = localId("team");
+    const teamDir = join(workingDirectory, ".longtable", "team", teamId);
+    if (args.debate === true) {
+        const debate = buildTeamDebate({
+            teamId,
+            teamDir,
+            prompt: projectAware.prompt,
+            roleFlag: typeof args.role === "string" ? args.role : undefined,
+            provider: setup?.providerSelection.provider,
+            visibility: "always_visible",
+            roundCount: rounds,
+            tmux: args.tmux === true
+        });
+        await writeTeamDebateArtifacts(debate, teamDir, prompt);
+        const canRecordWorkspace = projectAware.projectContextFound && projectContext && existsSync(projectContext.stateFilePath);
+        if (canRecordWorkspace) {
+            await appendInvocationRecordToWorkspace(projectContext, debate.invocationRecord, [debate.questionRecord]);
+        }
+        if (args.json === true) {
+            console.log(JSON.stringify({
+                teamId,
+                teamDir,
+                plan: debate.plan,
+                run: debate.run,
+                questionRecord: debate.questionRecord,
+                invocationRecord: debate.invocationRecord,
+                execution: {
+                    status: "completed",
+                    surface: debate.run.surface,
+                    projectContextFound: projectAware.projectContextFound,
+                    invocationLogged: canRecordWorkspace
+                }
+            }, null, 2));
+            return;
+        }
+        if (args.tmux === true) {
+            const sessionName = `longtable-${teamId.replaceAll("_", "-")}`;
+            const shell = process.env.SHELL || "/bin/sh";
+            const launcher = process.argv[1] ?? "longtable";
+            const leaderCommand = [
+                `echo ${shellEscape(`LongTable debate ${teamId}`)}`,
+                `echo ${shellEscape(`Artifacts: ${teamDir}`)}`,
+                `echo ${shellEscape("Fixed rounds are recorded. Role panes can add live review logs.")}`,
+                `echo ${shellEscape(`Checkpoint: ${debate.questionRecord.id}`)}`,
+                `exec ${shellEscape(shell)}`
+            ].join("; ");
+            execFileSync("tmux", ["new-session", "-d", "-s", sessionName, "-c", workingDirectory, leaderCommand], { stdio: "inherit" });
+            for (const member of debate.plan.members) {
+                const rolePrompt = [
+                    `LongTable autonomous debate role: ${member.label} (${member.role}).`,
+                    "Use the fixed debate artifacts as the shared record. Add live notes only; do not answer the researcher checkpoint.",
+                    `Artifacts: ${teamDir}`,
+                    "",
+                    projectAware.prompt
+                ].join("\n");
+                const logPath = join(teamDir, `${member.role}.debate.log`);
+                const command = [
+                    `node ${shellEscape(launcher)} review --role ${shellEscape(member.role)} --prompt ${shellEscape(rolePrompt)} --cwd ${shellEscape(workingDirectory)} 2>&1 | tee ${shellEscape(logPath)}`,
+                    `echo ${shellEscape(`Debate role log written to ${logPath}`)}`,
+                    `exec ${shellEscape(shell)}`
+                ].join("; ");
+                execFileSync("tmux", ["split-window", "-t", sessionName, "-c", workingDirectory, command], { stdio: "inherit" });
+                execFileSync("tmux", ["select-layout", "-t", sessionName, "tiled"], { stdio: "ignore" });
+            }
+            console.log(`LongTable tmux debate launched: ${sessionName}`);
+            console.log(`Attach with: tmux attach -t ${sessionName}`);
+            console.log(`Artifacts: ${teamDir}`);
+            return;
+        }
+        console.log(renderTeamDebateSummary(debate.run));
+        console.log(`- checkpoint: ${debate.questionRecord.id}`);
+        return;
+    }
+    await mkdir(teamDir, { recursive: true });
+    await writeFile(join(teamDir, "prompt.txt"), prompt, "utf8");
+    await writeFile(join(teamDir, "plan.json"), JSON.stringify(fallback.plan, null, 2), "utf8");
+    if (args.json === true) {
+        console.log(JSON.stringify({ teamId, teamDir, plan: fallback.plan }, null, 2));
+        return;
+    }
+    if (args.tmux !== true) {
+        console.log(renderPanelSummary(fallback.plan));
+        console.log("");
+        console.log("Run with `--tmux` to launch role panes for parallel discussion.");
+        return;
+    }
+    const sessionName = `longtable-${teamId.replaceAll("_", "-")}`;
+    const shell = process.env.SHELL || "/bin/sh";
+    const launcher = process.argv[1] ?? "longtable";
+    const leaderCommand = [
+        `echo ${shellEscape(`LongTable team ${teamId}`)}`,
+        `echo ${shellEscape(`Logs: ${teamDir}`)}`,
+        "echo 'Role panes are running. Review logs, then run:'",
+        `echo ${shellEscape(`longtable panel --role ${fallback.plan.members.map((member) => member.role).join(",")} --prompt ${JSON.stringify(prompt)}`)}`,
+        `exec ${shellEscape(shell)}`
+    ].join("; ");
+    execFileSync("tmux", ["new-session", "-d", "-s", sessionName, "-c", workingDirectory, leaderCommand], { stdio: "inherit" });
+    for (const member of fallback.plan.members) {
+        const rolePrompt = [
+            `LongTable team discussion role: ${member.label} (${member.role}).`,
+            "Give claims, objections, open questions, and evidence needs. Address likely disagreement with other roles.",
+            "",
+            prompt
+        ].join("\n");
+        const logPath = join(teamDir, `${member.role}.log`);
+        const command = [
+            `node ${shellEscape(launcher)} review --role ${shellEscape(member.role)} --prompt ${shellEscape(rolePrompt)} --cwd ${shellEscape(workingDirectory)} 2>&1 | tee ${shellEscape(logPath)}`,
+            `echo ${shellEscape(`Role log written to ${logPath}`)}`,
+            `exec ${shellEscape(shell)}`
+        ].join("; ");
+        execFileSync("tmux", ["split-window", "-t", sessionName, "-c", workingDirectory, command], { stdio: "inherit" });
+        execFileSync("tmux", ["select-layout", "-t", sessionName, "tiled"], { stdio: "ignore" });
+    }
+    console.log(`LongTable tmux team launched: ${sessionName}`);
+    console.log(`Attach with: tmux attach -t ${sessionName}`);
+    console.log(`Logs: ${teamDir}`);
+}
 async function runDecide(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const answer = typeof args.answer === "string" ? args.answer.trim() : "";
@@ -2095,6 +2521,10 @@ async function main() {
         await runInit(values);
         return;
     }
+    if (command === "setup") {
+        await runSetup(values);
+        return;
+    }
     if (command === "start") {
         await runStart(values);
         return;
@@ -2139,6 +2569,18 @@ async function main() {
         await runPanelCommand(values);
         return;
     }
+    if (command === "hud") {
+        await runHud(values);
+        return;
+    }
+    if (command === "sentinel") {
+        await runSentinel(values);
+        return;
+    }
+    if (command === "team") {
+        await runTeam(values);
+        return;
+    }
     if (command === "decide") {
         await runDecide(values);
         return;