@longtable/cli 0.1.16 → 0.1.18

package/README.md

@@ -94,6 +94,7 @@ longtable panel --prompt "..."
 longtable sentinel --prompt "Should I define a new measurement construct?"
 longtable hud --watch
 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
 longtable claude install-skills
 ```
@@ -180,6 +181,11 @@ 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 --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.
+
 ## Evidence And Search Direction
 
 LongTable should not behave like a generic web scraper. Research search should

package/dist/cli.js

@@ -16,6 +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";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -41,7 +42,7 @@ const ANSI = {
     green: "\u001B[32m"
 };
 const LONGTABLE_MCP_SERVER_NAME = "longtable-state";
-const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.14";
+const LONGTABLE_MCP_PACKAGE_VERSION = "0.1.18";
 const LONGTABLE_MCP_MARKER_START = "# LongTable state MCP START";
 const LONGTABLE_MCP_MARKER_END = "# LongTable state MCP END";
 function style(text, prefix) {
@@ -89,7 +90,7 @@ function usage() {
         "  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] [--cwd <path>] [--json]",
+        "  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]",
@@ -1561,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 ||
@@ -1947,6 +1945,25 @@ function localId(prefix) {
 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",
@@ -2084,15 +2101,96 @@ 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 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: "codex",
+        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");

package/dist/debate.d.ts

@@ -0,0 +1,21 @@
+import type { InvocationIntent, InvocationRecord, PanelPlan, PanelVisibility, ProviderKind, QuestionRecord, TeamDebateRun } from "@longtable/core";
+export interface BuildTeamDebateOptions {
+    teamId: string;
+    teamDir: string;
+    prompt: string;
+    roleFlag?: string;
+    provider?: ProviderKind;
+    visibility?: PanelVisibility;
+    roundCount?: number;
+    tmux?: boolean;
+}
+export interface TeamDebateBundle {
+    plan: PanelPlan;
+    run: TeamDebateRun;
+    intent: InvocationIntent;
+    invocationRecord: InvocationRecord;
+    questionRecord: QuestionRecord;
+}
+export declare function createTeamDebateQuestionRecord(run: TeamDebateRun, provider?: ProviderKind): QuestionRecord;
+export declare function buildTeamDebate(options: BuildTeamDebateOptions): TeamDebateBundle;
+export declare function renderTeamDebateSummary(run: TeamDebateRun): string;

package/dist/debate.js

@@ -0,0 +1,380 @@
+import { join } from "node:path";
+import { buildInvocationIntent, buildPanelPlan } from "./panel.js";
+import { getPersonaDefinition, parsePersonaKey } from "./personas.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+function createId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+function signalTags(prompt) {
+    const normalized = prompt.toLowerCase();
+    const tags = [];
+    if (/\bmeasure|\bscale|\bvalid|reliab|측정|척도|타당|신뢰/.test(normalized))
+        tags.push("measurement");
+    if (/\btheor|\bconstruct|\bconcept|이론|개념|구성개념/.test(normalized))
+        tags.push("theory");
+    if (/\bmethod|\bdesign|\bsample|\banalysis|방법|설계|분석|표본/.test(normalized))
+        tags.push("method");
+    if (/\bevidence|\bcitation|\breference|근거|인용|문헌/.test(normalized))
+        tags.push("evidence");
+    if (/\bethic|\birb|consent|윤리|동의/.test(normalized))
+        tags.push("ethics");
+    if (/\bvoice|\bauthor|narrative|저자|서사|문체/.test(normalized))
+        tags.push("authorship");
+    return tags.length > 0 ? tags : ["general"];
+}
+function roleFocus(role) {
+    const key = parsePersonaKey(role);
+    return key ? getPersonaDefinition(key).shortDescription : "Inspect the research decision for hidden risk.";
+}
+function readableSignals(tags) {
+    return tags.join(", ");
+}
+function contribution(options) {
+    return {
+        id: createId("team_contribution"),
+        ...options
+    };
+}
+function independentContribution(roundId, plan, role, label, artifactPath) {
+    const tags = signalTags(plan.prompt);
+    return contribution({
+        roundId,
+        role,
+        label,
+        artifactPath,
+        summary: `${label} independently reviews the prompt for ${readableSignals(tags)} risks before any shared synthesis.`,
+        claims: [
+            `${label} should preserve a separate judgment lane rather than accepting the first synthesis.`,
+            `Primary role focus: ${roleFocus(role)}`
+        ],
+        objections: [
+            "The prompt may hide a commitment that has not yet been named by the researcher.",
+            "A fluent answer could collapse measurement, theory, evidence, and authorship concerns into one premature recommendation."
+        ],
+        openQuestions: [
+            "Which decision would become hard to reverse if LongTable proceeded now?",
+            "What evidence or researcher preference is still missing?"
+        ],
+        evidenceNeeds: [
+            "Local project state, manuscript/data references, or cited literature should be checked before closure.",
+            "If the prompt makes an external claim, attach source links or mark the claim as inference."
+        ],
+        tacitAssumptions: [
+            "The researcher may know constraints not present in the prompt.",
+            "The role's critique may over-weight its own domain unless challenged by other roles."
+        ],
+        checkpointTriggers: tags.map((tag) => `${tag}_commitment`)
+    });
+}
+function crossReviewContribution(roundId, plan, role, label, targetRole, targetLabel, artifactPath) {
+    return contribution({
+        roundId,
+        role,
+        label,
+        targetRole,
+        artifactPath,
+        summary: `${label} challenges ${targetLabel}'s likely blind spot before synthesis.`,
+        claims: [
+            `${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."
+        ],
+        objections: [
+            `${targetLabel} may be treating its own role priority as the main research problem.`,
+            "The prompt still needs a concrete next decision, not only a list of concerns."
+        ],
+        openQuestions: [
+            `What would make ${targetLabel}'s objection decisive rather than advisory?`,
+            `What must the researcher answer before ${label} can accept ${targetLabel}'s framing?`
+        ],
+        evidenceNeeds: [
+            "Compare role objections against project state and available artifacts.",
+            "Separate source-backed objections from inferred risk."
+        ],
+        tacitAssumptions: [
+            "Roles may disagree because they are protecting different commitments.",
+            "The absence of evidence in the prompt is not evidence that the researcher lacks it."
+        ],
+        checkpointTriggers: ["role_disagreement", "unresolved_gap"]
+    });
+}
+function rebuttalContribution(roundId, role, label, artifactPath) {
+    return contribution({
+        roundId,
+        role,
+        label,
+        artifactPath,
+        summary: `${label} revises its position after cross-review while preserving unresolved risk.`,
+        claims: [
+            "Some objections should be accepted as constraints, not treated as blockers.",
+            "The final synthesis should distinguish actionable next steps from background concern."
+        ],
+        objections: [
+            "A role may over-correct after critique and lose the original high-stakes warning.",
+            "Convergence without a checkpoint would turn debate into hidden automation."
+        ],
+        openQuestions: [
+            "Which objection changes the next action?",
+            "Which unresolved disagreement should remain visible to the researcher?"
+        ],
+        evidenceNeeds: [
+            "Record which objections were accepted, rejected, or deferred.",
+            "Preserve references needed to verify the most consequential claim."
+        ],
+        tacitAssumptions: [
+            "A clean synthesis may be less honest than a visible unresolved tension.",
+            "The researcher should own the final prioritization."
+        ],
+        checkpointTriggers: ["synthesis_boundary", "researcher_authority"]
+    });
+}
+function convergenceContribution(roundId, plan, role, label, artifactPath) {
+    const otherRoles = plan.members.filter((member) => member.role !== role).map((member) => member.label);
+    return contribution({
+        roundId,
+        role,
+        label,
+        artifactPath,
+        summary: `${label} states what it can accept and what must remain open.`,
+        claims: [
+            `Can accept synthesis if it preserves ${label}'s domain warning.`,
+            `Must still show disagreement with: ${otherRoles.join(", ") || "no other roles"}.`
+        ],
+        objections: [
+            "Do not convert unresolved disagreement into a single confident recommendation.",
+            "Do not let the coordinator answer the checkpoint on behalf of the researcher."
+        ],
+        openQuestions: [
+            "Which path should LongTable recommend as the next researcher decision?",
+            "Which issue should be logged as an open tension if not answered now?"
+        ],
+        evidenceNeeds: [
+            "Link the synthesis back to role contributions and local artifacts.",
+            "Mark any missing sources as evidence gaps."
+        ],
+        tacitAssumptions: [
+            "A role's agreement may be conditional.",
+            "The researcher may choose to proceed despite unresolved risk."
+        ],
+        checkpointTriggers: ["panel_next_decision"]
+    });
+}
+function buildSynthesis(plan, artifactPath) {
+    const labels = plan.members.map((member) => member.label);
+    const highSensitivity = plan.checkpointSensitivity === "high";
+    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.`,
+        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."
+        ],
+        disagreements: [
+            "Roles may prioritize different first moves: theory framing, method defensibility, measurement validity, evidence verification, or authorship trace.",
+            "The coordinator should not decide which role wins without a researcher checkpoint."
+        ],
+        unresolvedGaps: [
+            "Which role concern is decisive for the next action?",
+            "What source, data, or local project artifact should be checked before closure?"
+        ],
+        researcherDecisionPoints: [
+            "Prioritize revision, evidence gathering, proceeding with risk, or keeping the issue open.",
+            "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?"
+    };
+}
+export function createTeamDebateQuestionRecord(run, provider) {
+    const createdAt = nowIso();
+    return {
+        id: createId("question_record"),
+        createdAt,
+        updatedAt: createdAt,
+        status: "pending",
+        prompt: {
+            id: createId("question_prompt"),
+            checkpointKey: "team_debate_next_decision",
+            title: "Team debate 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."
+                }
+            ],
+            allowOther: true,
+            otherLabel: "Other decision",
+            required: run.roles.some((member) => {
+                const key = parsePersonaKey(member.role);
+                return key ? getPersonaDefinition(key).checkpointSensitivity === "high" : false;
+            }),
+            source: "runtime_guidance",
+            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}.`
+            ],
+            preferredSurfaces: provider === "claude"
+                ? ["native_structured", "numbered"]
+                : ["numbered", "native_structured"]
+        }
+    };
+}
+export function buildTeamDebate(options) {
+    const roundCount = options.roundCount ?? 5;
+    if (roundCount !== 5) {
+        throw new Error("LongTable debate v1 supports fixed 5-round debate only.");
+    }
+    const createdAt = nowIso();
+    const plan = buildPanelPlan({
+        prompt: options.prompt,
+        mode: "review",
+        roleFlag: options.roleFlag,
+        provider: options.provider,
+        visibility: options.visibility ?? "always_visible"
+    });
+    const rounds = [];
+    const round1Id = createId("team_round");
+    rounds.push({
+        id: round1Id,
+        index: 1,
+        kind: "independent_review",
+        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`)))
+    });
+    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`))));
+    rounds.push({
+        id: round2Id,
+        index: 2,
+        kind: "cross_review",
+        title: "Cross-review",
+        status: "completed",
+        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");
+    const run = {
+        id: createId("team_debate_run"),
+        teamId: options.teamId,
+        createdAt,
+        updatedAt: createdAt,
+        prompt: options.prompt,
+        roles: plan.members,
+        status: "completed",
+        surface: options.tmux ? "tmux_console" : "file_backed_debate",
+        roundPolicy: "fixed",
+        roundCount,
+        artifactRoot: options.teamDir,
+        rounds: [
+            ...rounds,
+            {
+                id: createId("team_round"),
+                index: 5,
+                kind: "synthesis",
+                title: "Coordinator synthesis and checkpoint",
+                status: "completed",
+                artifactDir: options.teamDir,
+                contributions: []
+            }
+        ],
+        synthesis,
+        linkedQuestionRecordIds: []
+    };
+    const questionRecord = createTeamDebateQuestionRecord(run, options.provider);
+    run.linkedQuestionRecordIds = [questionRecord.id];
+    const intent = buildInvocationIntent({
+        prompt: options.prompt,
+        mode: "review",
+        roles: plan.members.map((member) => member.role),
+        provider: options.provider,
+        visibility: plan.visibility,
+        checkpointSensitivity: plan.checkpointSensitivity,
+        rationale: [
+            "Autonomous debate requested through LongTable team orchestration.",
+            "File-backed fixed rounds keep disagreement inspectable before researcher closure."
+        ]
+    });
+    intent.kind = "team_debate";
+    intent.requestedSurface = run.surface;
+    const invocationRecord = {
+        id: createId("invocation_record"),
+        createdAt,
+        updatedAt: createdAt,
+        intent,
+        status: "completed",
+        provider: options.provider,
+        surface: run.surface,
+        panelPlan: plan,
+        teamDebateRun: run,
+        degradationReason: options.tmux
+            ? undefined
+            : "Tmux was not requested; file-backed debate artifacts are the canonical execution record."
+    };
+    return {
+        plan,
+        run,
+        intent,
+        invocationRecord,
+        questionRecord
+    };
+}
+export function renderTeamDebateSummary(run) {
+    return [
+        "LongTable Team Debate",
+        `- team: ${run.teamId}`,
+        `- surface: ${run.surface}`,
+        `- rounds: ${run.roundCount} fixed`,
+        `- roles: ${run.roles.map((role) => `${role.label} (${role.role})`).join(", ")}`,
+        `- artifacts: ${run.artifactRoot}`,
+        "",
+        run.synthesis.summary,
+        "",
+        "Researcher checkpoint:",
+        `- ${run.synthesis.recommendedCheckpoint}`
+    ].join("\n");
+}

package/dist/project-session.js

@@ -193,6 +193,7 @@ async function loadResearchState(stateFilePath) {
     }
     const parsed = JSON.parse(await readFile(stateFilePath, "utf8"));
     return {
+        ...parsed,
         explicitState: parsed.explicitState ?? {},
         workingState: parsed.workingState ?? {},
         inferredHypotheses: parsed.inferredHypotheses ?? [],
@@ -893,6 +894,7 @@ export async function createOrUpdateProjectWorkspace(options) {
     const project = existsSync(projectFilePath)
         ? {
             ...JSON.parse(await readFile(projectFilePath, "utf8")),
+            projectPath,
             contractVersion: "workspace-v2",
             locale
         }
@@ -992,8 +994,15 @@ export async function loadProjectContextFromDirectory(startPath) {
         const projectFilePath = join(metaDir, "project.json");
         const sessionFilePath = join(metaDir, "current-session.json");
         if (existsSync(projectFilePath) && existsSync(sessionFilePath)) {
-            const project = JSON.parse(await readFile(projectFilePath, "utf8"));
-            const session = JSON.parse(await readFile(sessionFilePath, "utf8"));
+            const workspaceRoot = current;
+            const project = {
+                ...JSON.parse(await readFile(projectFilePath, "utf8")),
+                projectPath: workspaceRoot
+            };
+            const session = {
+                ...JSON.parse(await readFile(sessionFilePath, "utf8")),
+                projectPath: workspaceRoot
+            };
             return {
                 project,
                 session: {
@@ -1006,8 +1015,8 @@ export async function loadProjectContextFromDirectory(startPath) {
                 },
                 projectFilePath,
                 sessionFilePath,
-                stateFilePath: resolveStateFilePath(project.projectPath),
-                currentFilePath: resolveCurrentFilePath(project.projectPath),
+                stateFilePath: resolveStateFilePath(workspaceRoot),
+                currentFilePath: resolveCurrentFilePath(workspaceRoot),
                 metaDir
             };
         }

package/package.json

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