@longtable/cli 0.1.23 → 0.1.25

package/README.md

@@ -92,6 +92,7 @@ longtable ask --cwd "<project-path>" --prompt "..."
 longtable panel --prompt "..."
 longtable sentinel --prompt "Should I define a new measurement construct?"
 longtable hud --watch
+longtable team --prompt "Review this measurement plan." --role editor,measurement_auditor --json
 longtable team --tmux --prompt "Review this measurement plan."
 longtable team --debate --prompt "Review this measurement plan." --role editor,measurement_auditor --json
 longtable codex install-skills
@@ -164,7 +165,7 @@ Default panel roles include:
 
 Use `--role` to constrain the panel when the research problem is already clear.
 
-## Sentinel, HUD, And Tmux Team
+## Sentinel, HUD, And Agent Team
 
 `longtable sentinel` is an explicit gap/tacit check for prompts that may contain
 measurement, theory, method, evidence, authorship, or tacit-assumption risks.
@@ -175,16 +176,22 @@ unconfirmed inferred hypothesis.
 blocker, pending checkpoints, recent decisions, and invocation counts.
 `longtable hud --tmux` opens that view in a tmux pane.
 
-`longtable team --tmux` opens role-specific panes for research discussion and
-writes logs under `.longtable/team/<id>/`. This is panel discussion, not merely
-parallel execution: role panes are prompted to state claims, objections, open
-questions, and likely disagreement.
+`longtable team` creates a file-backed agent-team review under
+`.longtable/team/<id>/`: independent review, cross-review, and
+synthesis/checkpoint. Use it when roles should inspect each other's concerns
+before LongTable proposes a researcher decision.
+
+`longtable team --tmux` opens role-specific panes for live discussion. The panes
+can add logs, but the file-backed team artifact remains the source of truth.
 
 `longtable team --debate` creates a fixed five-round debate record under
 `.longtable/team/<id>/`: independent review, cross-review, rebuttal,
 convergence, and synthesis/checkpoint. Tmux can show live role panes, but the
 file-backed artifact directory is the source of truth.
 
+See `docs/AGENT-TEAM-README.md` in the repository for a user-facing guide to
+panel, team, debate, and tmux surfaces.
+
 ## Evidence And Search Direction
 
 LongTable should not behave like a generic web scraper. Research search should

package/dist/cli.js

@@ -16,7 +16,7 @@ import { buildPersonaGuidance, parseInvocationDirective } from "./persona-router
 import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
 import { appendInvocationRecordToWorkspace, assertWorkspaceNotBlocked, answerWorkspaceQuestion, createWorkspaceClarificationCard, createWorkspaceQuestion, createOrUpdateProjectWorkspace, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
-import { buildTeamDebate, renderTeamDebateSummary } from "./debate.js";
+import { buildTeamDebate, buildTeamReview, renderTeamDebateSummary } from "./debate.js";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -42,7 +42,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.23";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.25";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -89,7 +89,7 @@ function usage() {
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
         "  longtable mcp install [--provider codex|claude|all] [--write] [--checkpoint-ui off|interactive|strong] [--json] [--codex-config <path>] [--claude-settings <path>] [--package <spec>]",
         "  longtable sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
-        "  longtable team --prompt <text> [--role <role[,role]>] [--tmux] [--debate] [--rounds 5] [--cwd <path>] [--json]",
+        "  longtable team --prompt <text> [--role <role[,role]>] [--tmux] [--debate] [--rounds 3|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]",
@@ -2305,9 +2305,13 @@ async function runTeam(args) {
     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 isDebate = args.debate === true;
+    const expectedRounds = isDebate ? 5 : 3;
+    const rounds = typeof args.rounds === "string" ? Number(args.rounds) : expectedRounds;
+    if (!Number.isInteger(rounds) || rounds !== expectedRounds) {
+        throw new Error(isDebate
+            ? "LongTable team debate v1 supports `--rounds 5` only."
+            : "LongTable team v1 supports `--rounds 3` cross-review only.");
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
     const projectContext = await loadProjectContextFromDirectory(workingDirectory);
@@ -2315,16 +2319,9 @@ async function runTeam(args) {
         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) {
+    if (isDebate) {
         const debate = buildTeamDebate({
             teamId,
             teamDir,
@@ -2395,17 +2392,42 @@ async function runTeam(args) {
         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");
+    const team = buildTeamReview({
+        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(team, teamDir, prompt);
+    const canRecordWorkspace = projectAware.projectContextFound && projectContext && existsSync(projectContext.stateFilePath);
+    if (canRecordWorkspace) {
+        await appendInvocationRecordToWorkspace(projectContext, team.invocationRecord, [team.questionRecord]);
+    }
     if (args.json === true) {
-        console.log(JSON.stringify({ teamId, teamDir, plan: fallback.plan }, null, 2));
+        console.log(JSON.stringify({
+            teamId,
+            teamDir,
+            plan: team.plan,
+            run: team.run,
+            questionRecord: team.questionRecord,
+            invocationRecord: team.invocationRecord,
+            execution: {
+                status: "completed",
+                surface: team.run.surface,
+                interactionDepth: team.run.interactionDepth,
+                projectContextFound: projectAware.projectContextFound,
+                invocationLogged: canRecordWorkspace
+            }
+        }, 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.");
+        console.log(renderTeamDebateSummary(team.run));
+        console.log(`- checkpoint: ${team.questionRecord.id}`);
         return;
     }
     const sessionName = `longtable-${teamId.replaceAll("_", "-")}`;
@@ -2413,13 +2435,13 @@ async function runTeam(args) {
     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)}`)}`,
+        `echo ${shellEscape(`Artifacts: ${teamDir}`)}`,
+        `echo ${shellEscape("Cross-review artifacts are recorded. Role panes can add live review logs.")}`,
+        `echo ${shellEscape(`Checkpoint: ${team.questionRecord.id}`)}`,
         `exec ${shellEscape(shell)}`
     ].join("; ");
     execFileSync("tmux", ["new-session", "-d", "-s", sessionName, "-c", workingDirectory, leaderCommand], { stdio: "inherit" });
-    for (const member of fallback.plan.members) {
+    for (const member of team.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.",

package/dist/debate.d.ts

@@ -17,5 +17,6 @@ export interface TeamDebateBundle {
     questionRecord: QuestionRecord;
 }
 export declare function createTeamDebateQuestionRecord(run: TeamDebateRun, provider?: ProviderKind): QuestionRecord;
+export declare function buildTeamReview(options: BuildTeamDebateOptions): TeamDebateBundle;
 export declare function buildTeamDebate(options: BuildTeamDebateOptions): TeamDebateBundle;
 export declare function renderTeamDebateSummary(run: TeamDebateRun): string;

package/dist/debate.js

@@ -68,15 +68,18 @@ function independentContribution(roundId, plan, role, label, artifactPath) {
         checkpointTriggers: tags.map((tag) => `${tag}_commitment`)
     });
 }
-function crossReviewContribution(roundId, plan, role, label, targetRole, targetLabel, artifactPath) {
+function crossReviewContribution(roundId, plan, role, label, targetRole, targetLabel, targetContribution, artifactPath) {
     return contribution({
         roundId,
         role,
         label,
         targetRole,
+        respondsToContributionId: targetContribution.id,
+        stance: "conditional",
         artifactPath,
-        summary: `${label} challenges ${targetLabel}'s likely blind spot before synthesis.`,
+        summary: `${label} cross-reviews ${targetLabel}'s independent contribution (${targetContribution.id}) before synthesis.`,
         claims: [
+            `Responds to ${targetLabel}'s claim: ${targetContribution.claims[0]}`,
             `${targetLabel}'s concern is useful only if it does not erase ${label}'s domain-specific risk.`,
             "The debate should expose disagreement as a researcher decision point rather than normalize it away."
         ],
@@ -160,12 +163,13 @@ function convergenceContribution(roundId, plan, role, label, artifactPath) {
         checkpointTriggers: ["panel_next_decision"]
     });
 }
-function buildSynthesis(plan, artifactPath) {
+function buildSynthesis(plan, artifactPath, kind) {
     const labels = plan.members.map((member) => member.label);
     const highSensitivity = plan.checkpointSensitivity === "high";
+    const runLabel = kind === "debate" ? "debate" : "team review";
     return {
         artifactPath,
-        summary: `The debate completed fixed 5-round review across ${labels.join(", ")}. It should slow closure by turning role disagreement into an explicit researcher decision.`,
+        summary: `The ${runLabel} completed across ${labels.join(", ")}. It should slow closure by turning role disagreement into an explicit researcher decision.`,
         consensus: [
             "The researcher should see role disagreement before LongTable drafts, commits, or submits a conclusion.",
             "Evidence gaps and tacit assumptions should remain visible instead of being smoothed into fluent prose."
@@ -183,12 +187,13 @@ function buildSynthesis(plan, artifactPath) {
             "Choose whether the debate should affect the current artifact, the research design, or only the decision log."
         ],
         recommendedCheckpoint: highSensitivity
-            ? "The debate surfaced high-sensitivity disagreement. What should LongTable treat as the next human decision before closure?"
-            : "The debate surfaced role disagreement. Should LongTable revise, verify evidence, proceed, or keep the tension open?"
+            ? `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?`
     };
 }
 export function createTeamDebateQuestionRecord(run, provider) {
     const createdAt = nowIso();
+    const isDebate = run.interactionDepth === "debated";
     return {
         id: createId("question_record"),
         createdAt,
@@ -197,7 +202,7 @@ export function createTeamDebateQuestionRecord(run, provider) {
         prompt: {
             id: createId("question_prompt"),
             checkpointKey: "team_debate_next_decision",
-            title: "Team debate follow-up decision",
+            title: isDebate ? "Team debate follow-up decision" : "Agent team follow-up decision",
             question: run.synthesis.recommendedCheckpoint,
             type: "single_choice",
             options: [
@@ -229,21 +234,29 @@ export function createTeamDebateQuestionRecord(run, provider) {
                 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.",
             rationale: [
-                "Autonomous team debate is a research harness surface, not a substitute for researcher judgment.",
-                "The fixed debate rounds created disagreement that should connect to an explicit researcher decision.",
-                `Team debate run: ${run.id}.`
+                "Agent team 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.",
+                `Agent team run: ${run.id}.`
             ],
             preferredSurfaces: provider === "claude"
                 ? ["native_structured", "numbered"]
-                : ["numbered", "native_structured"]
+                : ["mcp_elicitation", "numbered"]
         }
     };
 }
-export function buildTeamDebate(options) {
-    const roundCount = options.roundCount ?? 5;
-    if (roundCount !== 5) {
-        throw new Error("LongTable debate v1 supports fixed 5-round debate only.");
+function buildTeamBundle(options, kind) {
+    const roundCount = options.roundCount ?? (kind === "debate" ? 5 : 3);
+    const expectedRounds = kind === "debate" ? 5 : 3;
+    if (roundCount !== expectedRounds) {
+        throw new Error(kind === "debate"
+            ? "LongTable debate v1 supports fixed 5-round debate only."
+            : "LongTable team v1 supports fixed 3-round cross-review only.");
     }
     const createdAt = nowIso();
     const plan = buildPanelPlan({
@@ -255,6 +268,7 @@ export function buildTeamDebate(options) {
     });
     const rounds = [];
     const round1Id = createId("team_round");
+    const independentContributions = plan.members.map((member) => independentContribution(round1Id, plan, member.role, member.label, join("round-1-independent", `${member.role}.json`)));
     rounds.push({
         id: round1Id,
         index: 1,
@@ -262,12 +276,12 @@ export function buildTeamDebate(options) {
         title: "Independent review",
         status: "completed",
         artifactDir: join(options.teamDir, "round-1-independent"),
-        contributions: plan.members.map((member) => independentContribution(round1Id, plan, member.role, member.label, join("round-1-independent", `${member.role}.json`)))
+        contributions: independentContributions
     });
     const round2Id = createId("team_round");
     const crossContributions = plan.members.flatMap((member) => plan.members
         .filter((target) => target.role !== member.role)
-        .map((target) => crossReviewContribution(round2Id, plan, member.role, member.label, target.role, target.label, join("round-2-cross-review", `${member.role}-on-${target.role}.json`))));
+        .map((target) => crossReviewContribution(round2Id, plan, member.role, member.label, target.role, target.label, independentContributions.find((contribution) => contribution.role === target.role), join("round-2-cross-review", `${member.role}-on-${target.role}.json`))));
     rounds.push({
         id: round2Id,
         index: 2,
@@ -277,27 +291,29 @@ export function buildTeamDebate(options) {
         artifactDir: join(options.teamDir, "round-2-cross-review"),
         contributions: crossContributions
     });
-    const round3Id = createId("team_round");
-    rounds.push({
-        id: round3Id,
-        index: 3,
-        kind: "rebuttal",
-        title: "Rebuttal and revision",
-        status: "completed",
-        artifactDir: join(options.teamDir, "round-3-rebuttal"),
-        contributions: plan.members.map((member) => rebuttalContribution(round3Id, member.role, member.label, join("round-3-rebuttal", `${member.role}.json`)))
-    });
-    const round4Id = createId("team_round");
-    rounds.push({
-        id: round4Id,
-        index: 4,
-        kind: "convergence",
-        title: "Convergence and unresolved gaps",
-        status: "completed",
-        artifactDir: join(options.teamDir, "round-4-convergence"),
-        contributions: plan.members.map((member) => convergenceContribution(round4Id, plan, member.role, member.label, join("round-4-convergence", `${member.role}.json`)))
-    });
-    const synthesis = buildSynthesis(plan, "synthesis.json");
+    if (kind === "debate") {
+        const round3Id = createId("team_round");
+        rounds.push({
+            id: round3Id,
+            index: 3,
+            kind: "rebuttal",
+            title: "Rebuttal and revision",
+            status: "completed",
+            artifactDir: join(options.teamDir, "round-3-rebuttal"),
+            contributions: plan.members.map((member) => rebuttalContribution(round3Id, member.role, member.label, join("round-3-rebuttal", `${member.role}.json`)))
+        });
+        const round4Id = createId("team_round");
+        rounds.push({
+            id: round4Id,
+            index: 4,
+            kind: "convergence",
+            title: "Convergence and unresolved gaps",
+            status: "completed",
+            artifactDir: join(options.teamDir, "round-4-convergence"),
+            contributions: plan.members.map((member) => convergenceContribution(round4Id, plan, member.role, member.label, join("round-4-convergence", `${member.role}.json`)))
+        });
+    }
+    const synthesis = buildSynthesis(plan, "synthesis.json", kind);
     const run = {
         id: createId("team_debate_run"),
         teamId: options.teamId,
@@ -307,14 +323,15 @@ export function buildTeamDebate(options) {
         roles: plan.members,
         status: "completed",
         surface: options.tmux ? "tmux_console" : "file_backed_debate",
-        roundPolicy: "fixed",
+        interactionDepth: kind === "debate" ? "debated" : "cross_reviewed",
+        roundPolicy: kind === "debate" ? "fixed" : "team_cross_review",
         roundCount,
         artifactRoot: options.teamDir,
         rounds: [
             ...rounds,
             {
                 id: createId("team_round"),
-                index: 5,
+                index: roundCount,
                 kind: "synthesis",
                 title: "Coordinator synthesis and checkpoint",
                 status: "completed",
@@ -335,11 +352,13 @@ export function buildTeamDebate(options) {
         visibility: plan.visibility,
         checkpointSensitivity: plan.checkpointSensitivity,
         rationale: [
-            "Autonomous debate requested through LongTable team orchestration.",
-            "File-backed fixed rounds keep disagreement inspectable before researcher closure."
+            kind === "debate"
+                ? "Autonomous debate requested through LongTable team orchestration."
+                : "Agent team cross-review requested through LongTable team orchestration.",
+            "File-backed rounds keep disagreement inspectable before researcher closure."
         ]
     });
-    intent.kind = "team_debate";
+    intent.kind = kind === "debate" ? "team_debate" : "team";
     intent.requestedSurface = run.surface;
     const invocationRecord = {
         id: createId("invocation_record"),
@@ -349,6 +368,7 @@ export function buildTeamDebate(options) {
         status: "completed",
         provider: options.provider,
         surface: run.surface,
+        interactionDepth: run.interactionDepth,
         panelPlan: plan,
         teamDebateRun: run,
         degradationReason: options.tmux
@@ -363,12 +383,19 @@ export function buildTeamDebate(options) {
         questionRecord
     };
 }
+export function buildTeamReview(options) {
+    return buildTeamBundle(options, "team");
+}
+export function buildTeamDebate(options) {
+    return buildTeamBundle(options, "debate");
+}
 export function renderTeamDebateSummary(run) {
     return [
         "LongTable Team Debate",
         `- team: ${run.teamId}`,
         `- surface: ${run.surface}`,
-        `- rounds: ${run.roundCount} fixed`,
+        `- interaction depth: ${run.interactionDepth}`,
+        `- rounds: ${run.roundCount} ${run.roundPolicy}`,
         `- roles: ${run.roles.map((role) => `${role.label} (${role.role})`).join(", ")}`,
         `- artifacts: ${run.artifactRoot}`,
         "",

package/dist/panel.js

@@ -143,9 +143,10 @@ export function createPlannedPanelQuestionRecord(plan, provider) {
                 "Panel review creates disagreement or risk visibility that should connect to an explicit researcher decision.",
                 `Panel checkpoint sensitivity: ${plan.checkpointSensitivity}.`
             ],
+            displayReason: "Panel review can surface role disagreement that should not be collapsed without researcher approval.",
             preferredSurfaces: provider === "claude"
                 ? ["native_structured", "numbered"]
-                : ["numbered", "native_structured"]
+                : ["mcp_elicitation", "numbered"]
         }
     };
 }
@@ -159,6 +160,7 @@ export function createPlannedPanelResult(plan, provider, linkedQuestionRecordIds
         provider,
         surface: "sequential_fallback",
         status: "planned",
+        interactionDepth: "independent",
         memberResults: plan.members.map((member) => ({
             role: member.role,
             label: member.label,
@@ -178,6 +180,7 @@ export function createPlannedInvocationRecord(options) {
         status: "planned",
         provider: options.provider,
         surface: "sequential_fallback",
+        interactionDepth: "independent",
         panelPlan: options.plan,
         panelResult: options.result,
         degradationReason: "Native provider team execution is optional; sequential fallback is the stable LongTable surface."

package/dist/project-session.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, InvocationRecord, ProviderKind, QuestionSurface, QuestionRecord, ResearchState } from "@longtable/core";
+import type { DecisionRecord, InvocationRecord, ProviderKind, QuestionOption, QuestionSurface, QuestionRecord, ResearchState } from "@longtable/core";
 import type { SetupPersistedOutput } from "@longtable/setup";
 export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
 export interface LongTableProjectRecord {
@@ -130,6 +130,9 @@ export declare function createWorkspaceQuestion(options: {
     prompt: string;
     title?: string;
     question?: string;
+    checkpointKey?: string;
+    questionOptions?: QuestionOption[];
+    displayReason?: string;
     provider?: ProviderKind;
     required?: boolean;
 }): Promise<{

package/dist/project-session.js

@@ -473,6 +473,9 @@ function questionTitleForCheckpoint(family, checkpointKey) {
     if (checkpointKey === "tacit_assumption_probe") {
         return "Tacit-assumption checkpoint";
     }
+    if (checkpointKey === "panel_disagreement_resolution") {
+        return "Panel-disagreement checkpoint";
+    }
     switch (family) {
         case "meta_decision":
             return "Meta-decision checkpoint";
@@ -499,6 +502,9 @@ function questionTextForCheckpoint(family, prompt, checkpointKey) {
     if (checkpointKey === "tacit_assumption_probe") {
         return "What tacit assumption should LongTable surface before treating this direction as acceptable?";
     }
+    if (checkpointKey === "panel_disagreement_resolution") {
+        return "How should LongTable handle the unresolved panel disagreement before turning it into one synthesis?";
+    }
     switch (family) {
         case "meta_decision":
             return "What should LongTable do before treating this platform decision as settled?";
@@ -533,6 +539,14 @@ function optionsForCheckpointTrigger(family, checkpointKey) {
             { value: "defer", label: "Keep the assumption open", description: "Do not treat this framing as settled yet." }
         ];
     }
+    if (checkpointKey === "panel_disagreement_resolution") {
+        return [
+            { value: "surface_disagreement", label: "Surface disagreement first", description: "Show the role conflict before choosing a synthesis." },
+            { value: "compare_frames", label: "Compare candidate framings", description: "Keep alternatives visible before selecting one frame." },
+            { value: "proceed_with_trace", label: "Proceed with an explicit trace", description: "Choose a synthesis, but record the unresolved disagreement." },
+            { value: "defer", label: "Keep disagreement open", description: "Do not collapse the disagreement into one conclusion yet." }
+        ];
+    }
     if (family === "evidence") {
         return [
             { value: "verify", label: "Verify evidence first", description: "Check whether the source supports the specific claim." },
@@ -728,7 +742,7 @@ export async function createWorkspaceClarificationCard(options) {
     const createdAt = nowIso();
     const preferredSurfaces = options.provider === "claude"
         ? ["native_structured", "terminal_selector", "numbered"]
-        : ["terminal_selector", "numbered", "native_structured"];
+        : ["mcp_elicitation", "terminal_selector", "numbered"];
     const questions = buildClarificationQuestionSpecs(options.prompt).map((spec) => ({
         id: createId("question_record"),
         createdAt,
@@ -763,6 +777,7 @@ export async function createWorkspaceQuestion(options) {
         unresolvedTensions: state.openTensions ?? [],
         studyContract: state.studyContract
     });
+    const checkpointKey = options.checkpointKey ?? trigger.signal.checkpointKey;
     const createdAt = nowIso();
     const question = {
         id: createId("question_record"),
@@ -771,15 +786,16 @@ export async function createWorkspaceQuestion(options) {
         status: "pending",
         prompt: {
             id: createId("question_prompt"),
-            checkpointKey: trigger.signal.checkpointKey,
-            title: options.title ?? questionTitleForCheckpoint(trigger.family, trigger.signal.checkpointKey),
-            question: options.question ?? questionTextForCheckpoint(trigger.family, options.prompt, trigger.signal.checkpointKey),
+            checkpointKey,
+            title: options.title ?? questionTitleForCheckpoint(trigger.family, checkpointKey),
+            question: options.question ?? questionTextForCheckpoint(trigger.family, options.prompt, checkpointKey),
             type: "single_choice",
-            options: optionsForCheckpointTrigger(trigger.family, trigger.signal.checkpointKey),
+            options: options.questionOptions ?? optionsForCheckpointTrigger(trigger.family, checkpointKey),
             allowOther: true,
             otherLabel: "Other decision",
             required: options.required ?? trigger.requiresQuestionBeforeClosure,
             source: "checkpoint",
+            displayReason: options.displayReason ?? trigger.rationale[0],
             rationale: [
                 ...trigger.rationale,
                 `Trigger family: ${trigger.family}.`,
@@ -788,7 +804,7 @@ export async function createWorkspaceQuestion(options) {
             ],
             preferredSurfaces: options.provider === "claude"
                 ? ["native_structured", "numbered"]
-                : ["numbered", "native_structured"]
+                : ["mcp_elicitation", "numbered"]
         }
     };
     const updated = appendQuestionRecords(state, [question]);

package/package.json

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