@longtable/cli 0.1.58 → 0.1.60

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/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 { execSync, spawnSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
 import { createRequire } from "node:module";
 import { stdin as input, stdout as output, cwd, env, exit } from "node:process";
@@ -10,7 +10,7 @@ import { homedir } from "node:os";
 import { fileURLToPath } from "node:url";
 import { collectHardStopBlockers } from "@longtable/core";
 import { classifyCheckpointTrigger } from "@longtable/checkpoints";
-import { assessSearchSourceCapabilities, buildResearchSearchIntent, parsePublisherTarget, probePublisherAccess, publisherConfigs, runResearchSearch, SEARCH_SOURCES, summarizeConfiguredPublisherAccess } from "./search/index.js";
+import { assessSearchSourceCapabilities, assessScholarResearchReadiness, buildResearchSearchIntent, buildScholarResearchSmokeFixture, parsePublisherTarget, probePublisherAccess, publisherConfigs, runResearchSearch, SEARCH_SOURCES, writeScholarResearchRunScaffold, summarizeConfiguredPublisherAccess } from "./search/index.js";
 import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupOutput, 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";
@@ -154,10 +154,13 @@ function usage() {
         "  longtable access doctor [--doi <doi>] [--publisher auto|elsevier|springer_nature|wiley|taylor_francis|all] [--json]",
         "  longtable access probe --doi <doi> [--publisher auto|elsevier|springer_nature|wiley|taylor_francis] [--json]",
         "  longtable search --query <text> [--intent literature|theory|measurement|citation|metadata|venue] [--field <text>] [--source all|crossref,arxiv,openalex,semantic_scholar,pubmed,eric,doaj,unpaywall] [--must <term[,term]>] [--exclude <term[,term]>] [--limit <n>] [--allow-partial] [--publisher-access] [--record] [--cwd <path>] [--json]",
+        "  longtable scholar-research doctor [--json]",
+        "  longtable scholar-research scaffold [--cwd <path>] [--run-id <id>] [--json]",
+        "  longtable scholar-research smoke-fixture [--json]",
         "  longtable sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
         "  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]",
+        "  longtable question (--prompt <decision-context> | --question <id>) [--title <text>] [--text <question>] [--provider codex|claude] [--required|--advisory] [--surface tmux_popup|terminal_selector|numbered] [--print] [--cwd <path>] [--json]",
         "  longtable clear-question --question <id> --reason <text> [--cwd <path>] [--json]",
         "  longtable panel [--prompt <text>] [--role <role[,role]>] [--mode review|critique|draft|commit] [--visibility synthesis_only|show_on_conflict|always_visible] [--provider codex|claude] [--native-workers|--native-subagents] [--wait [ms]] [--print] [--json] [--setup <path>] [--cwd <path>]",
         "  longtable panel status --run <panel_run_id> [--wait [ms]] [--cwd <path>] [--json]",
@@ -166,7 +169,7 @@ function usage() {
         "  longtable panel resume --run <panel_run_id> [--wait [ms]] [--cwd <path>] [--json]",
         "  longtable panel record [--invocation <id>] --result-file <json> [--surface sequential_fallback|native_subagents|native_workers] [--cwd <path>] [--json]",
         "  longtable handoff [--cwd <path>] [--output <file>] [--print] [--json]",
-        "  longtable decide [--question <id>] --answer <value-or-text> [--rationale <text>] [--provider codex|claude] [--cwd <path>] [--json]",
+        "  longtable decide [--question <id>] --answer <value-or-text> [--rationale <text>] [--provider codex|claude] [--surface tmux_popup|mcp_elicitation|terminal_selector|numbered] [--cwd <path>] [--json]",
         "  longtable explore|review|critique|draft|commit|submit [--prompt <text>] [--role <role[,role]>] [--panel] [--show-conflicts] [--show-deliberation] [--print] [--json] [--stage <stage>] [--setup <path>] [--cwd <path>]",
         "  longtable codex persist-init [--answers-json <json> | --stdin | full setup flags] [--install-skills] [--install-prompts] [--json]",
         "  longtable codex install-skills [--surface compact|full] [--dir <path>]",
@@ -201,7 +204,7 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "prune-questions", "panel", "handoff", "decide", "sentinel", "access", "search", "spec"].includes(command);
+    const directCommand = command && ["init", "setup", "start", "resume", "doctor", "status", "audit", "roles", "show", "install", "mcp", "codex", "claude", "ask", "clarify", "question", "clear-question", "prune-questions", "panel", "handoff", "decide", "sentinel", "access", "search", "scholar-research", "spec"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -210,7 +213,7 @@ function parseArgs(argv) {
     else if (command === "codex" || command === "claude" || command === "mcp") {
         startIndex = 2;
     }
-    else if ((command === "access" || command === "search" || command === "spec" || command === "panel") && maybeSubcommand && !maybeSubcommand.startsWith("--")) {
+    else if ((command === "access" || command === "search" || command === "scholar-research" || command === "spec" || command === "panel") && maybeSubcommand && !maybeSubcommand.startsWith("--")) {
         subcommand = maybeSubcommand;
         startIndex = 2;
     }
@@ -299,6 +302,27 @@ function parseSkillSurface(args) {
     }
     throw new Error("Invalid --surface value. Use compact or full.");
 }
+const QUESTION_SURFACE_VALUES = [
+    "native_structured",
+    "tmux_popup",
+    "mcp_elicitation",
+    "numbered",
+    "terminal_selector",
+    "web_form"
+];
+function parseQuestionSurface(value) {
+    if (value === undefined || value === false) {
+        return undefined;
+    }
+    if (value === true) {
+        throw new Error(`Invalid --surface value. Use one of: ${QUESTION_SURFACE_VALUES.join(", ")}.`);
+    }
+    const normalized = value.trim();
+    if (QUESTION_SURFACE_VALUES.includes(normalized)) {
+        return normalized;
+    }
+    throw new Error(`Invalid --surface value. Use one of: ${QUESTION_SURFACE_VALUES.join(", ")}.`);
+}
 function stripWrappingQuotes(value) {
     const trimmed = value.trim();
     if ((trimmed.startsWith("\"") && trimmed.endsWith("\"")) ||
@@ -970,15 +994,25 @@ async function collectProjectInterview(setup, args) {
         ]));
         console.log("");
     }
-    const projectName = (typeof args.name === "string" && args.name.trim()) ||
+    const projectNameInput = (typeof args.name === "string" && args.name.trim()) ||
         (await promptText(renderQuestionHeader(1, 2, "Workspace", "What should this project be called?"), true));
+    if (!projectNameInput) {
+        throw new Error("LongTable start needs a project name.");
+    }
+    const projectName = projectNameInput;
     const suggestedParentDir = typeof args.path === "string" && args.path.trim()
         ? normalizeUserPath(args.path.trim())
         : homedir();
     const suggestedPath = resolveInteractiveProjectPath(suggestedParentDir, projectName);
-    const projectPath = (typeof args.path === "string" && args.path.trim()
+    const projectPathInput = typeof args.path === "string" && args.path.trim()
         ? normalizeUserPath(args.path.trim())
-        : resolveInteractiveProjectPath((await promptText(renderQuestionHeader(2, 2, "Workspace", `Which parent directory should contain this project?\nLongTable will create this folder:\n${suggestedPath}`), true)), projectName));
+        : await promptText(renderQuestionHeader(2, 2, "Workspace", `Which parent directory should contain this project?\nLongTable will create this folder:\n${suggestedPath}`), true);
+    if (!projectPathInput) {
+        throw new Error("LongTable start needs a project path.");
+    }
+    const projectPath = typeof args.path === "string" && args.path.trim()
+        ? projectPathInput
+        : resolveInteractiveProjectPath(projectPathInput, projectName);
     const adaptive = skipResearchInterview
         ? {}
         : await collectAdaptiveStartInterview({
@@ -1616,6 +1650,7 @@ async function collectDoctorStatus(args) {
     return {
         setupPath,
         setupExists: existsSync(setupPath),
+        scholarResearch: assessScholarResearchReadiness(env),
         providers: {
             codex: {
                 command: "codex",
@@ -1679,6 +1714,8 @@ function renderDoctorStatus(status) {
     const lines = [
         "LongTable doctor",
         `- setup: ${status.setupExists ? "present" : "missing"} (${status.setupPath})`,
+        `- scholar-research connectors: ${status.scholarResearch.connectors.filter((connector) => connector.status === "ready").length}/${status.scholarResearch.connectors.length} ready`,
+        `- scholar-research safety: paywall bypass ${status.scholarResearch.safety.paywallBypassAllowed ? "allowed" : "disabled"}, institution login automation ${status.scholarResearch.safety.institutionLoginAutomationAllowed ? "allowed" : "disabled"}`,
         "",
         ...renderProviderDoctorBlock("Codex", status.providers.codex),
         `- legacy prompt files: ${status.providers.codex.legacyPromptFilesInstalled.length}`,
@@ -2062,12 +2099,14 @@ function buildRoleAuditEntry(provider, spec) {
 }
 function runRoleAudit() {
     const baseSkillNames = new Set([
+        "critical-interview",
         "longtable",
         "longtable-start",
         "longtable-interview",
         "longtable-panel",
         "longtable-explore",
-        "longtable-review"
+        "longtable-review",
+        "scholar-research"
     ]);
     const roles = [
         ...buildCodexSkillSpecs(listRoleDefinitions(), "full")
@@ -2324,6 +2363,149 @@ function commandAvailable(command) {
         return false;
     }
 }
+function isRecord(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function stringArrayValue(value) {
+    if (Array.isArray(value)) {
+        return value.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
+    }
+    return typeof value === "string" && value.trim().length > 0 ? [value] : [];
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+}
+function currentTmuxReturnPane() {
+    const explicit = stringValue(env.OMX_QUESTION_RETURN_PANE);
+    if (explicit) {
+        return explicit;
+    }
+    return stringValue(env.TMUX_PANE);
+}
+function codexTmuxPopupAvailable() {
+    return Boolean(currentTmuxReturnPane() && commandAvailable("omx"));
+}
+function buildOmxQuestionInput(record) {
+    const options = record.prompt.options.map((option) => ({
+        label: option.label,
+        value: option.value,
+        ...(option.description ? { description: option.description } : {})
+    }));
+    const freeText = record.prompt.type === "free_text";
+    const type = record.prompt.type === "multi_choice" ? "multi-answerable" : "single-answerable";
+    return {
+        header: "LongTable",
+        question: record.prompt.question,
+        questions: [{
+                id: record.id,
+                question: record.prompt.question,
+                options,
+                allow_other: freeText ? true : record.prompt.allowOther,
+                other_label: freeText ? "Answer" : record.prompt.otherLabel ?? "Other",
+                type,
+                multi_select: record.prompt.type === "multi_choice"
+            }],
+        options,
+        allow_other: freeText ? true : record.prompt.allowOther,
+        other_label: freeText ? "Answer" : record.prompt.otherLabel ?? "Other",
+        type,
+        multi_select: record.prompt.type === "multi_choice",
+        source: "longtable",
+        session_id: record.id
+    };
+}
+function readOmxAnswerPayload(payload) {
+    const root = isRecord(payload) ? payload : {};
+    const answers = Array.isArray(root.answers) ? root.answers : [];
+    for (const entry of answers) {
+        if (!isRecord(entry)) {
+            continue;
+        }
+        if (entry.answer !== undefined) {
+            return entry.answer;
+        }
+        return entry;
+    }
+    if (root.answer !== undefined) {
+        return root.answer;
+    }
+    return root;
+}
+function questionAnswerFromOmxPayload(record, payload) {
+    const answer = readOmxAnswerPayload(payload);
+    if (typeof answer === "string") {
+        return answer;
+    }
+    if (Array.isArray(answer)) {
+        return stringArrayValue(answer);
+    }
+    if (!isRecord(answer)) {
+        throw new Error("OMX question returned an answer payload LongTable cannot parse.");
+    }
+    if (record.prompt.type === "free_text") {
+        const freeText = [
+            stringValue(answer.other_text),
+            stringValue(answer.otherText),
+            stringValue(answer.text),
+            stringValue(answer.value),
+            stringArrayValue(answer.selected_values).join("\n"),
+            stringArrayValue(answer.selectedValues).join("\n")
+        ].find((entry) => entry && entry.trim().length > 0);
+        if (freeText) {
+            return freeText;
+        }
+    }
+    const selectedValues = [
+        ...stringArrayValue(answer.selected_values),
+        ...stringArrayValue(answer.selectedValues)
+    ];
+    const otherText = stringValue(answer.other_text) ?? stringValue(answer.otherText) ?? stringValue(answer.text);
+    if (answer.kind === "other" && otherText) {
+        return { selectedValues: ["other"], otherText };
+    }
+    if (selectedValues.length > 0) {
+        return otherText
+            ? { selectedValues: selectedValues.includes("other") ? selectedValues : [...selectedValues, "other"], otherText }
+            : selectedValues;
+    }
+    const valueValues = stringArrayValue(answer.value);
+    if (valueValues.length > 0) {
+        return valueValues.length === 1 ? valueValues[0] : valueValues;
+    }
+    if (otherText) {
+        return otherText;
+    }
+    throw new Error("OMX question did not include an answer value.");
+}
+function invokeOmxQuestionPopup(record) {
+    const returnPane = currentTmuxReturnPane();
+    if (!returnPane || !commandAvailable("omx")) {
+        throw new Error("LongTable tmux_popup transport requires an attached tmux pane and the `omx` command.");
+    }
+    const child = spawnSync("omx", ["question", "--input", JSON.stringify(buildOmxQuestionInput(record)), "--json"], {
+        cwd: cwd(),
+        env: {
+            ...env,
+            OMX_QUESTION_RETURN_PANE: returnPane
+        },
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (child.error) {
+        throw child.error;
+    }
+    if (child.status !== 0) {
+        const detail = [String(child.stderr ?? "").trim(), String(child.stdout ?? "").trim()].filter(Boolean).join("\n");
+        throw new Error(`LongTable tmux_popup transport failed${detail ? `: ${detail}` : "."}`);
+    }
+    const raw = String(child.stdout ?? "").trim();
+    try {
+        return raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        throw new Error(`LongTable tmux_popup transport returned non-JSON output: ${raw.slice(0, 200)}`);
+    }
+}
 function parseWaitMs(value) {
     if (value === undefined || value === false) {
         return undefined;
@@ -2665,6 +2847,9 @@ async function runPanelCommand(args) {
     console.log(renderPanelSummary(fallback.plan));
     console.log("");
     if (finalNativeRun) {
+        if (!nativeRunContext) {
+            throw new Error("Native panel worker run finished without a run context.");
+        }
         console.log("LongTable native panel worker run created");
         console.log(`- run: ${finalNativeRun.id}`);
         console.log(`- status: ${finalNativeRun.status}`);
@@ -3291,6 +3476,52 @@ async function runSearch(subcommand, args) {
     }
     console.log(renderEvidenceRunSummary(run, recordedPath));
 }
+async function runScholarResearch(subcommand, args) {
+    const json = args.json === true;
+    if (subcommand === "doctor" || subcommand === "status" || !subcommand) {
+        const readiness = assessScholarResearchReadiness(env);
+        if (json) {
+            console.log(JSON.stringify(readiness, null, 2));
+            return;
+        }
+        console.log("LongTable scholar-research doctor");
+        for (const connector of readiness.connectors) {
+            const missing = connector.missingEnv.length > 0 ? ` (missing ${connector.missingEnv.join(", ")})` : "";
+            console.log(`- ${connector.name}: ${connector.status}${missing}`);
+        }
+        console.log("- safety: paywall bypass disabled; institution-login automation disabled");
+        return;
+    }
+    if (subcommand === "scaffold") {
+        const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
+        const runId = typeof args["run-id"] === "string" ? args["run-id"] : undefined;
+        const scaffold = await writeScholarResearchRunScaffold({
+            cwd: workingDirectory,
+            ...(runId ? { runId } : {})
+        });
+        if (json) {
+            console.log(JSON.stringify(scaffold, null, 2));
+            return;
+        }
+        console.log("LongTable scholar-research scaffold");
+        console.log(`- run: ${scaffold.runId}`);
+        console.log(`- dir: ${scaffold.runDir}`);
+        return;
+    }
+    if (subcommand === "smoke-fixture") {
+        const fixture = buildScholarResearchSmokeFixture();
+        if (json) {
+            console.log(JSON.stringify({ fixture }, null, 2));
+            return;
+        }
+        console.log("LongTable scholar-research smoke fixture");
+        for (const item of fixture) {
+            console.log(`- ${item.id}: ${item.category} - ${item.label}`);
+        }
+        return;
+    }
+    throw new Error(`Unknown scholar-research subcommand: ${subcommand}`);
+}
 async function requireWorkspaceContext(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const context = await loadProjectContextFromDirectory(workingDirectory);
@@ -3393,11 +3624,51 @@ async function runSpec(subcommand, args) {
     }
     throw new Error(`Unknown spec subcommand: ${command}`);
 }
+function questionUsesKorean(record) {
+    return /[가-힣]/.test([
+        record.prompt.title,
+        record.prompt.question,
+        record.prompt.displayReason ?? "",
+        ...record.prompt.options.flatMap((option) => [option.label, option.description ?? ""]),
+        record.prompt.otherLabel ?? ""
+    ].join("\n"));
+}
+function renderQuestionDecisionCard(record) {
+    const korean = questionUsesKorean(record);
+    const lines = [
+        korean ? "LongTable 결정 카드" : "LongTable Decision Card",
+        `${korean ? "체크포인트" : "Checkpoint"}: ${record.prompt.title}`,
+        `${korean ? "무엇이 걸렸나" : "What is blocked"}: ${record.prompt.displayReason ?? record.prompt.rationale[0] ?? record.prompt.title}`,
+        `${korean ? "지금 결정할 것" : "Decision needed"}: ${record.prompt.question}`,
+        korean ? "선택지:" : "Choices:"
+    ];
+    record.prompt.options.forEach((option, index) => {
+        const recommended = option.recommended ? (korean ? " (추천)" : " (recommended)") : "";
+        lines.push(`${index + 1}. ${option.label}${recommended}`);
+        if (option.description) {
+            lines.push(`   ${option.description}`);
+        }
+        lines.push(`   ${korean ? "기록값" : "Record value"}: ${option.value}`);
+    });
+    if (record.prompt.allowOther) {
+        lines.push(`${record.prompt.options.length + 1}. ${record.prompt.otherLabel ?? (korean ? "직접 입력" : "Other")}`);
+        lines.push(`   ${korean ? "기록값" : "Record value"}: other`);
+    }
+    return lines.join("\n");
+}
 async function runQuestion(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 decision context is required. Pass --prompt <text>.");
+    const requestedSurface = parseQuestionSurface(args.surface);
+    if (requestedSurface &&
+        requestedSurface !== "tmux_popup" &&
+        requestedSurface !== "terminal_selector" &&
+        requestedSurface !== "numbered") {
+        throw new Error("The LongTable question CLI can render tmux_popup, terminal_selector, or numbered surfaces. Use the MCP or provider-native runtime for other surfaces.");
+    }
+    const questionId = typeof args.question === "string" ? args.question.trim() : "";
+    const prompt = questionId ? undefined : await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt && !questionId) {
+        throw new Error("A decision context or pending question id is required. Pass --prompt <text> or --question <id>.");
     }
     const context = await loadProjectContextFromDirectory(workingDirectory);
     if (!context) {
@@ -3405,17 +3676,73 @@ async function runQuestion(args) {
     }
     const provider = args.provider === "claude" ? "claude" : args.provider === "codex" ? "codex" : undefined;
     const required = args.required === true ? true : args.advisory === true ? false : undefined;
-    const result = await createWorkspaceQuestion({
-        context,
-        prompt,
-        title: typeof args.title === "string" ? args.title : undefined,
-        question: typeof args.text === "string" ? args.text : undefined,
-        provider,
-        required
-    });
+    let result;
+    if (questionId) {
+        const state = await loadWorkspaceState(context);
+        const question = state.questionLog.find((record) => record.id === questionId && record.status === "pending");
+        if (!question) {
+            throw new Error(`No pending LongTable question found for ${questionId}.`);
+        }
+        result = { question, state };
+    }
+    else {
+        result = await createWorkspaceQuestion({
+            context,
+            prompt: prompt ?? "",
+            title: typeof args.title === "string" ? args.title : undefined,
+            question: typeof args.text === "string" ? args.text : undefined,
+            provider,
+            required
+        });
+    }
     const transport = provider === "claude"
         ? renderQuestionRecordInput(result.question)
         : renderQuestionRecordPrompt(result.question);
+    const shouldTryTmuxPopup = requestedSurface === "tmux_popup" ||
+        (requestedSurface === undefined && provider === "codex" && codexTmuxPopupAvailable() && args.print !== true && args.json !== true);
+    if (shouldTryTmuxPopup) {
+        try {
+            const popupPayload = invokeOmxQuestionPopup(result.question);
+            const answer = questionAnswerFromOmxPayload(result.question, popupPayload);
+            const decision = await answerWorkspaceQuestion({
+                context,
+                questionId: result.question.id,
+                answer,
+                provider,
+                surface: "tmux_popup"
+            });
+            if (args.json === true) {
+                console.log(JSON.stringify({
+                    question: decision.question,
+                    decision: decision.decision,
+                    transport: {
+                        surface: "tmux_popup",
+                        status: "accepted"
+                    },
+                    files: {
+                        state: context.stateFilePath,
+                        current: context.currentFilePath
+                    }
+                }, null, 2));
+                return;
+            }
+            console.log("LongTable checkpoint decision recorded");
+            console.log(`- question: ${decision.question.id}`);
+            console.log(`- decision: ${decision.decision.id}`);
+            console.log(`- surface: tmux_popup`);
+            console.log(`- answer: ${decision.decision.selectedOption ?? "recorded"}`);
+            console.log(`- state: ${context.stateFilePath}`);
+            console.log(`- current: ${context.currentFilePath}`);
+            return;
+        }
+        catch (error) {
+            if (requestedSurface === "tmux_popup") {
+                throw error;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`LongTable tmux_popup transport unavailable; falling back. ${message}`);
+        }
+    }
     if (args.json === true) {
         console.log(JSON.stringify({
             question: result.question,
@@ -3437,7 +3764,7 @@ async function runQuestion(args) {
         }
         return;
     }
-    if (isInteractiveTerminal()) {
+    if ((requestedSurface === undefined || requestedSurface === "terminal_selector") && isInteractiveTerminal()) {
         console.log(renderBrandBanner("LongTable", "Researcher Checkpoint"));
         console.log("");
         const answer = await promptChoice(renderQuestionHeader(1, 1, result.question.prompt.title, result.question.prompt.question), questionRecordToChoices(result.question));
@@ -3457,16 +3784,11 @@ async function runQuestion(args) {
         console.log(`- current: ${context.currentFilePath}`);
         return;
     }
-    const optionValues = [
-        ...result.question.prompt.options.map((option) => option.value),
-        ...(result.question.prompt.allowOther ? ["other"] : [])
-    ];
     console.log(result.question.prompt.required ? "LongTable required Researcher Checkpoint recorded" : "LongTable advisory Researcher Checkpoint recorded");
     console.log(`- question: ${result.question.id}`);
     console.log(`- checkpoint: ${result.question.prompt.checkpointKey ?? "manual"}`);
-    console.log(`- prompt: ${result.question.prompt.question}`);
-    console.log(`- options: ${optionValues.join("/")}`);
-    console.log(`- answer: longtable decide --question ${result.question.id} --answer <value>`);
+    console.log(renderQuestionDecisionCard(result.question));
+    console.log(`- answer: longtable decide --question ${result.question.id} --answer <value> --surface numbered`);
     console.log(`- current: ${context.currentFilePath}`);
 }
 async function runClearQuestion(args) {
@@ -3928,12 +4250,14 @@ async function runDecide(args) {
         throw new Error("No LongTable project workspace was found here. Run this inside a project or pass --cwd.");
     }
     const provider = args.provider === "claude" ? "claude" : args.provider === "codex" ? "codex" : undefined;
+    const surface = parseQuestionSurface(args.surface);
     const result = await answerWorkspaceQuestion({
         context,
         questionId: typeof args.question === "string" ? args.question : undefined,
         answer,
         rationale: typeof args.rationale === "string" ? args.rationale : undefined,
-        provider
+        provider,
+        ...(surface ? { surface } : {})
     });
     if (args.json === true) {
         console.log(JSON.stringify({
@@ -4331,6 +4655,10 @@ async function main() {
         await runSearch(subcommand, values);
         return;
     }
+    if (command === "scholar-research") {
+        await runScholarResearch(subcommand, values);
+        return;
+    }
     if (command === "spec") {
         await runSpec(subcommand, values);
         return;

package/dist/debate.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { buildInvocationIntent, buildPanelPlan } from "./panel.js";
+import { buildInvocationIntent, buildPanelDecisionContext, buildPanelPlan } from "./panel.js";
 import { getPersonaDefinition, parsePersonaKey } from "./personas.js";
 function nowIso() {
     return new Date().toISOString();
@@ -167,6 +167,10 @@ function buildSynthesis(plan, artifactPath, kind) {
     const labels = plan.members.map((member) => member.label);
     const highSensitivity = plan.checkpointSensitivity === "high";
     const runLabel = kind === "debate" ? "panel debate" : "panel review";
+    const decisionContext = buildPanelDecisionContext(plan.prompt);
+    const localizedRunLabel = decisionContext.language === "ko"
+        ? (kind === "debate" ? "패널 토론" : "패널 리뷰")
+        : runLabel;
     return {
         artifactPath,
         summary: `The ${runLabel} completed across ${labels.join(", ")}. It should slow closure by turning role disagreement into an explicit researcher decision.`,
@@ -187,13 +191,16 @@ function buildSynthesis(plan, artifactPath, kind) {
             "Choose whether the debate should affect the current artifact, the research design, or only the decision log."
         ],
         recommendedCheckpoint: highSensitivity
-            ? `The ${runLabel} surfaced high-sensitivity disagreement. What should LongTable treat as the next human decision before closure?`
-            : `The ${runLabel} surfaced role disagreement. Should LongTable revise, verify evidence, proceed, or keep the tension open?`
+            ? (decisionContext.language === "ko"
+                ? `${localizedRunLabel}에서 ${decisionContext.focus}에 대한 높은 민감도의 불일치가 드러났습니다. ${decisionContext.decisionQuestion}`
+                : `The ${runLabel} surfaced high-sensitivity disagreement about ${decisionContext.focus}. ${decisionContext.decisionQuestion}`)
+            : decisionContext.decisionQuestion
     };
 }
 export function createTeamDebateQuestionRecord(run, provider) {
     const createdAt = nowIso();
     const isDebate = run.interactionDepth === "debated";
+    const decisionContext = buildPanelDecisionContext(run.prompt);
     return {
         id: createId("question_record"),
         createdAt,
@@ -202,51 +209,32 @@ export function createTeamDebateQuestionRecord(run, provider) {
         prompt: {
             id: createId("question_prompt"),
             checkpointKey: "panel_debate_next_decision",
-            title: isDebate ? "Panel debate follow-up decision" : "Panel review follow-up decision",
+            title: decisionContext.language === "ko"
+                ? (isDebate ? "패널 토론 후속 결정" : "패널 리뷰 후속 결정")
+                : (isDebate ? "Panel debate follow-up decision" : "Panel review follow-up decision"),
             question: run.synthesis.recommendedCheckpoint,
             type: "single_choice",
-            options: [
-                {
-                    value: "revise",
-                    label: "Revise before proceeding",
-                    description: "Use the debate result to revise the claim, design, or draft first."
-                },
-                {
-                    value: "evidence",
-                    label: "Gather or verify evidence first",
-                    description: "Check source, data, or local artifact support before proceeding."
-                },
-                {
-                    value: "proceed",
-                    label: "Proceed with current direction",
-                    description: "Accept the risk profile and continue with the current direction."
-                },
-                {
-                    value: "defer",
-                    label: "Keep this open",
-                    description: "Do not commit yet; keep the debate issue visible as an open tension."
-                }
-            ],
+            options: decisionContext.options,
             allowOther: true,
-            otherLabel: "Other decision",
+            otherLabel: decisionContext.otherLabel,
             required: run.roles.some((member) => {
                 const key = parsePersonaKey(member.role);
                 return key ? getPersonaDefinition(key).checkpointSensitivity === "high" : false;
             }),
             source: "runtime_guidance",
-            displayReason: isDebate
-                ? "Role rebuttals and convergence should connect to an explicit researcher decision."
-                : "Cross-review created role disagreement that should connect to an explicit researcher decision.",
+            displayReason: decisionContext.displayReason,
             rationale: [
                 "LongTable panel orchestration is a research harness surface, not a substitute for researcher judgment.",
                 isDebate
                     ? "The fixed debate rounds created disagreement that should connect to an explicit researcher decision."
                     : "The cross-review round created disagreement that should connect to an explicit researcher decision.",
+                `Panel decision focus: ${decisionContext.focus}.`,
+                "Panel follow-up choices are compact by default; unlisted decisions should use Other.",
                 `LongTable panel run: ${run.id}.`
             ],
             preferredSurfaces: provider === "claude"
                 ? ["native_structured", "numbered"]
-                : ["mcp_elicitation", "numbered"]
+                : ["tmux_popup", "mcp_elicitation", "numbered"]
         }
     };
 }

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from "./panel.js";
 export * from "./project-session.js";
 export * from "./question-obligations.js";
 export * from "./hard-stop.js";
+export * from "./search/index.js";

package/dist/index.js

@@ -6,3 +6,4 @@ export * from "./panel.js";
 export * from "./project-session.js";
 export * from "./question-obligations.js";
 export * from "./hard-stop.js";
+export * from "./search/index.js";