@longtable/cli 0.1.52 → 0.1.54

package/README.md

@@ -4,7 +4,8 @@ Researcher-facing CLI for LongTable.
 
 LongTable keeps scholarly project state in `.longtable/` and exposes generated
 provider skills for Codex and Claude Code. The CLI installs setup, state,
-checkpoint, search, and diagnostic tooling. It does not replace the provider.
+checkpoint, search, panel, and diagnostic tooling. It does not replace the
+provider.
 
 ## Install
 
@@ -74,11 +75,34 @@ longtable question --prompt "<decision context>"
 longtable decide --question <id> --answer <value>
 longtable spec read --cwd "<project-path>"
 longtable search --query "<topic>"
+longtable panel --prompt "review this measurement plan" --json
 ```
 
 `longtable start` remains available for scripted workspace creation with
 `--no-interview --json`, but it is not the primary research-start surface.
 
+## Panel Orchestration
+
+Panel orchestration is for moments where disagreement matters: methods risk,
+measurement validity, theory fit, literature positioning, and claims that need
+challenge before they become project memory.
+
+The CLI creates a provider-neutral `PanelPlan` and returns a planned
+`PanelResult`. When native subagents are unavailable, LongTable uses a stable
+sequential fallback prompt. That keeps the same research semantics available in
+Codex and Claude Code without making either provider's native question or agent
+tool the source of truth.
+
+```bash
+longtable panel --prompt "Review this measurement plan." --role editor,measurement_auditor --json
+longtable panel --visibility always_visible --prompt "Keep unresolved disagreement visible." --json
+longtable ask --prompt "lt debate: Review this design before I commit it." --json
+```
+
+Team-style requests route through panel. Explicit debate-language requests write
+panel debate records under `.longtable/panel/`; LongTable team execution is
+disabled for new work.
+
 ## Development
 
 ```bash

package/dist/cli.js

@@ -20,7 +20,7 @@ import { PERSONA_DEFINITIONS, listRoleDefinitions } from "./personas.js";
 import { buildPanelFallback, renderPanelSummary } from "./panel.js";
 import { LONGTABLE_MANAGED_HOOK_EVENTS, codexHooksEnabled, enableCodexHooksFeature, getMissingManagedCodexHookEvents, getMissingManagedCodexHookTrustState, mergeCodexHookTrustState, mergeManagedCodexHooksConfig, removeCodexHookTrustState, removeManagedCodexHooks } from "./codex-hooks.js";
 import { appendInvocationRecordToWorkspace, applyResearchSpecificationPatch, assertWorkspaceNotBlocked, answerWorkspaceQuestion, buildQuestionOpportunitySpecs, clearWorkspaceQuestion, createWorkspaceFollowUpQuestions, createWorkspaceQuestion, createOrUpdateProjectWorkspace, diffResearchSpecifications, inspectProjectWorkspace, loadWorkspaceState, loadProjectContextFromDirectory, findUnincorporatedResearchEvidence, proposeResearchSpecificationPatch, pruneWorkspaceQuestions, readResearchSpecificationHistory, repairWorkspaceStateConsistency, renderProjectWorkspaceSummary, syncCurrentWorkspaceView } from "./project-session.js";
-import { buildTeamDebate, buildTeamReview, renderTeamDebateSummary } from "./debate.js";
+import { buildTeamDebate } from "./debate.js";
 import { createPromptRenderer } from "./prompt-renderer.js";
 const VALID_MODES = new Set([
     "explore",
@@ -154,7 +154,6 @@ function usage() {
         "  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 sentinel --prompt <text> [--cwd <path>] [--json] [--record]",
-        "  longtable team --prompt <text> [--role <role[,role]>] [--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]",
@@ -2264,10 +2263,10 @@ function inferCollaborationRoute(prompt) {
     if (explicitDebate) {
         return "debate";
     }
-    const explicitTeam = /\bagent team\b|\bresearch team\b|\bteam review\b|\bteam-style\b|\buse a team\b/i.test(prompt) ||
+    const explicitPanelTeam = /\bagent team\b|\bresearch team\b|\bteam review\b|\bteam-style\b|\buse a team\b/i.test(prompt) ||
         /에이전트\s*팀|연구\s*팀|팀\s*(리뷰|검토)|팀으로/.test(prompt);
-    if (explicitTeam) {
-        return "team";
+    if (explicitPanelTeam) {
+        return "panel";
     }
     const panelCue = /\bpanel\b|\bmulti[- ]?role\b|\bmultiple perspectives\b|\brole disagreement\b|\bdisagreement\b|\bconflict\b/i.test(prompt) ||
         /패널|여러\s*관점|복수\s*관점|역할.*불일치|불일치|충돌/.test(prompt);
@@ -2282,10 +2281,10 @@ function inferCollaborationRoute(prompt) {
         trigger.signal.artifactStakes === "study_protocol" ||
         trigger.requiresQuestionBeforeClosure;
     if (panelCue && trigger.signal.artifactStakes === "external_submission") {
-        return "debate";
+        return "panel";
     }
     if (highStakes) {
-        return "team";
+        return "panel";
     }
     return "panel";
 }
@@ -3386,10 +3385,10 @@ async function runAsk(args) {
         (directive.panel || delegatedArgs.panel === true
             ? "panel"
             : inferCollaborationRoute(effectivePrompt) ?? (inferred === "panel" ? "panel" : null));
-    if (collaborationRoute === "team" || collaborationRoute === "debate") {
-        await runTeam({
+    if (collaborationRoute === "debate") {
+        await runPanelDebateCommand({
             ...delegatedArgs,
-            debate: collaborationRoute === "debate"
+            debate: true
         });
         return;
     }
@@ -3408,21 +3407,21 @@ function localId(prefix) {
 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);
+async function writePanelDebateArtifacts(bundle, panelDir, prompt) {
+    await mkdir(panelDir, { recursive: true });
+    await writeFile(join(panelDir, "prompt.txt"), prompt, "utf8");
+    await writeJsonFile(join(panelDir, "plan.json"), bundle.plan);
+    await writeJsonFile(join(panelDir, "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(panelDir, 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);
+    await writeJsonFile(join(panelDir, "synthesis.json"), bundle.run.synthesis);
+    await writeJsonFile(join(panelDir, "checkpoint.json"), bundle.questionRecord);
+    await writeJsonFile(join(panelDir, "invocation.json"), bundle.invocationRecord);
 }
 function sentinelSummary(prompt, workingDirectory) {
     const trigger = classifyCheckpointTrigger(prompt, {
@@ -3501,19 +3500,15 @@ async function runSentinel(args) {
         console.log(context ? `- recorded in: ${context.stateFilePath}` : "- record skipped: no LongTable workspace found");
     }
 }
-async function runTeam(args) {
+async function runPanelDebateCommand(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
     const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
     if (!prompt) {
         throw new Error("A prompt is required.");
     }
-    const 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 rounds = typeof args.rounds === "string" ? Number(args.rounds) : 5;
+    if (!Number.isInteger(rounds) || rounds !== 5) {
+        throw new Error("LongTable panel debate v1 supports `--rounds 5` only.");
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
     const projectContext = await loadProjectContextFromDirectory(workingDirectory);
@@ -3521,78 +3516,47 @@ async function runTeam(args) {
         await assertWorkspaceNotBlocked(projectContext);
     }
     const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
-    const teamId = localId("team");
-    const teamDir = join(workingDirectory, ".longtable", "team", teamId);
-    if (isDebate) {
-        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
-        });
-        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;
-        }
-        console.log(renderTeamDebateSummary(debate.run));
-        console.log(`- checkpoint: ${debate.questionRecord.id}`);
-        return;
-    }
-    const team = buildTeamReview({
-        teamId,
-        teamDir,
+    const panelId = localId("panel_debate");
+    const panelDir = join(workingDirectory, ".longtable", "panel", panelId);
+    const debate = buildTeamDebate({
+        teamId: panelId,
+        teamDir: panelDir,
         prompt: projectAware.prompt,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
         provider: setup?.providerSelection.provider,
         visibility: "always_visible",
         roundCount: rounds
     });
-    await writeTeamDebateArtifacts(team, teamDir, prompt);
+    await writePanelDebateArtifacts(debate, panelDir, prompt);
     const canRecordWorkspace = projectAware.projectContextFound && projectContext && existsSync(projectContext.stateFilePath);
     if (canRecordWorkspace) {
-        await appendInvocationRecordToWorkspace(projectContext, team.invocationRecord, [team.questionRecord]);
+        await appendInvocationRecordToWorkspace(projectContext, debate.invocationRecord, [debate.questionRecord]);
     }
     if (args.json === true) {
         console.log(JSON.stringify({
-            teamId,
-            teamDir,
-            plan: team.plan,
-            run: team.run,
-            questionRecord: team.questionRecord,
-            invocationRecord: team.invocationRecord,
+            panelId,
+            panelDir,
+            plan: debate.plan,
+            run: debate.run,
+            questionRecord: debate.questionRecord,
+            invocationRecord: debate.invocationRecord,
             execution: {
                 status: "completed",
-                surface: team.run.surface,
-                interactionDepth: team.run.interactionDepth,
+                surface: debate.run.surface,
                 projectContextFound: projectAware.projectContextFound,
                 invocationLogged: canRecordWorkspace
             }
         }, null, 2));
         return;
     }
-    console.log(renderTeamDebateSummary(team.run));
-    console.log(`- checkpoint: ${team.questionRecord.id}`);
+    console.log("LongTable Panel Debate");
+    console.log(`- panel: ${panelId}`);
+    console.log(`- interaction depth: ${debate.run.interactionDepth}`);
+    console.log(`- rounds: ${debate.run.roundCount}`);
+    console.log(`- checkpoint: ${debate.questionRecord.id}`);
+}
+function disabledTeamCommandError() {
+    return new Error("`longtable team` is disabled. Use `longtable panel --prompt <text>` for visible multi-role review, or `longtable ask --prompt \"lt debate: <text>\"` when debate is explicitly requested.");
 }
 async function runDecide(args) {
     const workingDirectory = typeof args.cwd === "string" ? args.cwd : cwd();
@@ -4037,8 +4001,7 @@ async function main() {
         return;
     }
     if (command === "team") {
-        await runTeam(values);
-        return;
+        throw disabledTeamCommandError();
     }
     if (command === "decide") {
         await runDecide(values);

package/dist/debate.js

@@ -166,7 +166,7 @@ function convergenceContribution(roundId, plan, role, label, 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";
+    const runLabel = kind === "debate" ? "panel debate" : "panel review";
     return {
         artifactPath,
         summary: `The ${runLabel} completed across ${labels.join(", ")}. It should slow closure by turning role disagreement into an explicit researcher decision.`,
@@ -201,8 +201,8 @@ export function createTeamDebateQuestionRecord(run, provider) {
         status: "pending",
         prompt: {
             id: createId("question_prompt"),
-            checkpointKey: "team_debate_next_decision",
-            title: isDebate ? "Team debate follow-up decision" : "Agent team follow-up decision",
+            checkpointKey: "panel_debate_next_decision",
+            title: isDebate ? "Panel debate follow-up decision" : "Panel review follow-up decision",
             question: run.synthesis.recommendedCheckpoint,
             type: "single_choice",
             options: [
@@ -238,11 +238,11 @@ export function createTeamDebateQuestionRecord(run, provider) {
                 ? "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: [
-                "Agent team orchestration is a research harness surface, not a substitute for researcher judgment.",
+                "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.",
-                `Agent team run: ${run.id}.`
+                `LongTable panel run: ${run.id}.`
             ],
             preferredSurfaces: provider === "claude"
                 ? ["native_structured", "numbered"]
@@ -255,8 +255,8 @@ function buildTeamBundle(options, kind) {
     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.");
+            ? "LongTable panel debate v1 supports fixed 5-round debate only."
+            : "LongTable panel review v1 supports fixed 3-round cross-review only.");
     }
     const createdAt = nowIso();
     const plan = buildPanelPlan({
@@ -267,7 +267,7 @@ function buildTeamBundle(options, kind) {
         visibility: options.visibility ?? "always_visible"
     });
     const rounds = [];
-    const round1Id = createId("team_round");
+    const round1Id = createId("panel_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,
@@ -278,7 +278,7 @@ function buildTeamBundle(options, kind) {
         artifactDir: join(options.teamDir, "round-1-independent"),
         contributions: independentContributions
     });
-    const round2Id = createId("team_round");
+    const round2Id = createId("panel_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, independentContributions.find((contribution) => contribution.role === target.role), join("round-2-cross-review", `${member.role}-on-${target.role}.json`))));
@@ -292,7 +292,7 @@ function buildTeamBundle(options, kind) {
         contributions: crossContributions
     });
     if (kind === "debate") {
-        const round3Id = createId("team_round");
+        const round3Id = createId("panel_round");
         rounds.push({
             id: round3Id,
             index: 3,
@@ -302,7 +302,7 @@ function buildTeamBundle(options, kind) {
             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");
+        const round4Id = createId("panel_round");
         rounds.push({
             id: round4Id,
             index: 4,
@@ -315,22 +315,22 @@ function buildTeamBundle(options, kind) {
     }
     const synthesis = buildSynthesis(plan, "synthesis.json", kind);
     const run = {
-        id: createId("team_debate_run"),
+        id: createId("panel_debate_run"),
         teamId: options.teamId,
         createdAt,
         updatedAt: createdAt,
         prompt: options.prompt,
         roles: plan.members,
         status: "completed",
-        surface: "file_backed_debate",
+        surface: "file_backed_panel_debate",
         interactionDepth: kind === "debate" ? "debated" : "cross_reviewed",
-        roundPolicy: kind === "debate" ? "fixed" : "team_cross_review",
+        roundPolicy: kind === "debate" ? "fixed" : "panel_cross_review",
         roundCount,
         artifactRoot: options.teamDir,
         rounds: [
             ...rounds,
             {
-                id: createId("team_round"),
+                id: createId("panel_round"),
                 index: roundCount,
                 kind: "synthesis",
                 title: "Coordinator synthesis and checkpoint",
@@ -353,12 +353,12 @@ function buildTeamBundle(options, kind) {
         checkpointSensitivity: plan.checkpointSensitivity,
         rationale: [
             kind === "debate"
-                ? "Autonomous debate requested through LongTable team orchestration."
-                : "Agent team cross-review requested through LongTable team orchestration.",
+                ? "Autonomous debate requested through LongTable panel orchestration."
+                : "Cross-role review requested through LongTable panel orchestration.",
             "File-backed rounds keep disagreement inspectable before researcher closure."
         ]
     });
-    intent.kind = kind === "debate" ? "team_debate" : "team";
+    intent.kind = kind === "debate" ? "panel_debate" : "panel";
     intent.requestedSurface = run.surface;
     const invocationRecord = {
         id: createId("invocation_record"),
@@ -371,7 +371,7 @@ function buildTeamBundle(options, kind) {
         interactionDepth: run.interactionDepth,
         panelPlan: plan,
         teamDebateRun: run,
-        degradationReason: "File-backed team artifacts are the canonical execution record."
+        degradationReason: "File-backed panel artifacts are the canonical execution record."
     };
     return {
         plan,
@@ -389,8 +389,8 @@ export function buildTeamDebate(options) {
 }
 export function renderTeamDebateSummary(run) {
     return [
-        "LongTable Team Debate",
-        `- team: ${run.teamId}`,
+        "LongTable Panel Debate",
+        `- panel: ${run.teamId}`,
         `- surface: ${run.surface}`,
         `- interaction depth: ${run.interactionDepth}`,
         `- rounds: ${run.roundCount} ${run.roundPolicy}`,

package/dist/longtable-codex-native-hook.js

@@ -1,5 +1,5 @@
 import { pathToFileURL } from "node:url";
-import { collectHardStopBlockers } from "@longtable/core";
+import { collectHardStopBlockers, evaluateResearchSpecificationReadiness } from "@longtable/core";
 import { createWorkspaceFollowUpQuestions, loadProjectContextFromDirectory, loadWorkspaceState, pendingQuestionObligations } from "./index.js";
 function safeString(value) {
     return typeof value === "string" ? value : "";
@@ -225,7 +225,7 @@ function mutatesLongTableResearchState(command) {
         return false;
     }
     return /\.longtable(?:\/|\b)|\bCURRENT\.md\b/.test(normalized)
-        || /\blongtable\s+(?:start|question|clear-question|prune-questions|ask|clarify|panel|team)\b/.test(normalized);
+        || /\blongtable\s+(?:start|question|clear-question|prune-questions|ask|clarify|panel)\b/.test(normalized);
 }
 async function loadLongTableRuntime(startPath) {
     const context = await loadProjectContextFromDirectory(startPath);
@@ -237,13 +237,22 @@ async function loadLongTableRuntime(startPath) {
 }
 function buildWorkspaceSummary(runtime, detail = "compact") {
     const { context, state } = runtime;
+    const readiness = evaluateResearchSpecificationReadiness({
+        firstResearchShape: state.firstResearchShape ?? context.session.firstResearchShape,
+        researchSpecification: state.researchSpecification ?? context.session.researchSpecification,
+        questionLog: state.questionLog,
+        questionObligations: state.questionObligations
+    });
     if (detail === "compact") {
-        const primaryContext = state.firstResearchShape
-            ? `First research shape: ${compactContextValue(state.firstResearchShape.handle, 96)}.`
-            : `Current goal: ${compactContextValue(context.session.currentGoal, 120)}.`;
+        const primaryContext = state.researchSpecification
+            ? `Research Specification: ${compactContextValue(state.researchSpecification.title, 96)} (${readiness.status}).`
+            : state.firstResearchShape
+                ? `First research shape: ${compactContextValue(state.firstResearchShape.handle, 96)}.`
+                : `Current goal: ${compactContextValue(context.session.currentGoal, 120)}.`;
         return [
             "LongTable workspace detected; research context restored.",
             primaryContext,
+            readiness.usableForInterview || readiness.status === "no_spec" ? "" : `Research Specification readiness: ${readiness.status}; next action: ${readiness.nextAction}.`,
             context.session.nextAction ? `Next action: ${compactContextValue(context.session.nextAction)}.` : "",
             context.session.protectedDecision ? "Protected decision: active; full text is in `.longtable/` and `CURRENT.md`." : ""
         ].filter(Boolean);
@@ -254,6 +263,8 @@ function buildWorkspaceSummary(runtime, detail = "compact") {
         context.session.currentBlocker ? `Current blocker: ${context.session.currentBlocker}.` : "",
         context.session.protectedDecision ? `Protected decision: ${context.session.protectedDecision}.` : "",
         state.firstResearchShape ? `First research shape: ${state.firstResearchShape.handle}.` : "",
+        state.researchSpecification ? `Research Specification: ${state.researchSpecification.title} (${readiness.status}).` : "",
+        readiness.usableForInterview || readiness.status === "no_spec" ? "" : `Research Specification readiness: ${readiness.status}; next action: ${readiness.nextAction}; gaps: ${readiness.blockingGaps.join("; ")}.`,
         context.session.nextAction ? `Next action: ${context.session.nextAction}.` : ""
     ].filter(Boolean);
     return lines;
@@ -339,7 +350,7 @@ function buildActiveInterviewContext(hook) {
         "A LongTable interview is currently active.",
         `Interview status: ${hook.status}.`,
         `Turns recorded: ${turnCount}.`,
-        "Do not finalize the research direction until the interview is either summarized into a First Research Shape or explicitly cleared."
+        "Do not finalize the research direction until the interview has created a Research Specification and either confirmed it or left an explicit pending/deferred confirmation."
     ].join("\n");
 }
 function sessionStartContext(runtime) {

package/dist/panel.js

@@ -183,7 +183,7 @@ export function createPlannedInvocationRecord(options) {
         interactionDepth: "independent",
         panelPlan: options.plan,
         panelResult: options.result,
-        degradationReason: "Native provider team execution is optional; sequential fallback is the stable LongTable surface."
+        degradationReason: "Sequential fallback is the stable LongTable panel surface."
     };
 }
 function roleInstruction(member) {

package/dist/persona-router.d.ts

@@ -12,7 +12,7 @@ export interface LongTableInvocationDirective {
     explicit: boolean;
     cleanedPrompt: string;
     mode?: InteractionMode | "panel" | "status";
-    collaboration?: "panel" | "team" | "debate";
+    collaboration?: "panel" | "debate";
     roles: CanonicalPersona[];
     panel: boolean;
     showConflicts: boolean;

package/dist/persona-router.js

@@ -8,8 +8,8 @@ const DIRECTIVE_MAP = [
     { key: "draft", mode: "draft" },
     { key: "commit", mode: "commit" },
     { key: "panel", mode: "panel", collaboration: "panel", panel: true, showConflicts: true },
-    { key: "team", mode: "review", collaboration: "team", panel: true, showConflicts: true },
-    { key: "debate", mode: "review", collaboration: "debate", panel: true, showConflicts: true },
+    { key: "team", mode: "panel", collaboration: "panel", panel: true, showConflicts: true },
+    { key: "debate", mode: "panel", collaboration: "debate", panel: true, showConflicts: true },
     { key: "status", mode: "status" },
     { key: "editor", mode: "review", roles: ["editor"] },
     { key: "reviewer", mode: "review", roles: ["reviewer"] },

package/dist/project-session.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, HardStopScope, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionPromptType, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
+import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, HardStopScope, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionPromptType, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationReadiness, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
 import type { SetupPersistedOutput } from "@longtable/setup";
 import { type HardStopVerdict } from "@longtable/core";
 export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
@@ -222,6 +222,7 @@ export interface LongTableWorkspaceInspection {
         specRevisions?: number;
     };
     hardStop?: HardStopVerdict;
+    researchSpecificationReadiness?: ResearchSpecificationReadiness;
     recentInvocations?: Array<{
         id: string;
         kind: string;

package/dist/project-session.js

@@ -4,7 +4,7 @@ import { execSync } from "node:child_process";
 import { dirname, join, resolve } from "node:path";
 import { appendDecisionRecord as appendDecisionToResearchState, appendInvocationRecord as appendInvocationToResearchState, appendQuestionRecords, createEmptyResearchState } from "@longtable/memory";
 import { classifyCheckpointTrigger } from "@longtable/checkpoints";
-import { collectHardStopBlockers } from "@longtable/core";
+import { collectHardStopBlockers, evaluateResearchSpecificationReadiness, requiredResearchSpecificationGaps } from "@longtable/core";
 import { ensureRequiredQuestionObligation, pendingQuestionObligations, resolveQuestionObligationByQuestionId } from "./question-obligations.js";
 const CURRENT_FILE_NAME = "CURRENT.md";
 const LEGACY_ROOT_FILES = ["LONGTABLE.md", "START-HERE.md", "NEXT-STEPS.md", "SESSION-SNAPSHOT.md"];
@@ -165,11 +165,15 @@ function renderResearchSpecificationSummary(specification, locale) {
     return lines;
 }
 function renderResearchSpecificationStatus(session, locale) {
-    if (!session.firstResearchShape && !session.researchSpecification) {
+    const readiness = evaluateResearchSpecificationReadiness({
+        firstResearchShape: session.firstResearchShape,
+        researchSpecification: session.researchSpecification
+    });
+    if (readiness.status === "no_spec") {
         return [];
     }
     const korean = locale === "ko";
-    if (!session.researchSpecification) {
+    if (readiness.status === "shape_only") {
         return [
             "",
             korean ? "## Research Specification 상태" : "## Research Specification Status",
@@ -184,21 +188,27 @@ function renderResearchSpecificationStatus(session, locale) {
                 : "- Next protocol: when enough detail exists, run `summarize_research_specification` to create the preview, then `confirm_research_specification` to confirm, ask one more question, revise a section, or keep it open."
         ];
     }
-    const status = session.researchSpecification.confirmedAt
-        ? "confirmed"
-        : session.researchSpecification.status ?? "draft";
-    if (status === "confirmed") {
+    if (readiness.status === "confirmed") {
         return [];
     }
     return [
         "",
         korean ? "## Research Specification 상태" : "## Research Specification Status",
         korean
-            ? `- 상태: ${status}. Research Specification은 저장되어 있지만 아직 확정된 종료 지점이 아닙니다.`
-            : `- Status: ${status}. Research Specification exists, but it is not a confirmed closure point yet.`,
+            ? `- 상태: ${readiness.status}. Research Specification은 저장되어 있지만 아직 확정된 종료 지점이 아닙니다.`
+            : `- Status: ${readiness.status}. Research Specification exists, but it is not a confirmed closure point yet.`,
+        ...(readiness.blockingGaps.length > 0
+            ? [korean
+                    ? `- 남은 gap: ${readiness.blockingGaps.join("; ")}.`
+                    : `- Remaining gaps: ${readiness.blockingGaps.join("; ")}.`]
+            : []),
         korean
-            ? "- 다음 프로토콜: 명세를 업데이트한 뒤 `confirm_research_specification`으로 다시 preview 확인을 받아야 합니다."
-            : "- Next protocol: update the specification, then return to `confirm_research_specification` for another preview confirmation."
+            ? readiness.nextAction === "start"
+                ? "- 다음 프로토콜: `$longtable-start`에서 빠진 섹션을 더 묻고 Research Specification을 업데이트해야 합니다."
+                : "- 다음 프로토콜: `confirm_research_specification`으로 preview 확인을 받아야 합니다."
+            : readiness.nextAction === "start"
+                ? "- Next protocol: stay in `$longtable-start`, ask for the missing sections, and update the Research Specification."
+                : "- Next protocol: return to `confirm_research_specification` for preview confirmation."
     ];
 }
 function renderResearchSpecificationAudit(state, locale) {
@@ -563,35 +573,6 @@ function cloneResearchSpecification(specification) {
 function mergeStringLists(...lists) {
     return [...new Set(lists.flatMap((list) => list ?? []).filter(Boolean))];
 }
-function requiredResearchSpecificationGaps(specification) {
-    const gaps = [];
-    if (!specification.researchDirection.question?.trim()) {
-        gaps.push("research question");
-    }
-    if (specification.constructOntology.coreConstructs.length === 0) {
-        gaps.push("construct map/core constructs");
-    }
-    if (specification.researchDirection.inclusionCriteria?.length === 0 &&
-        specification.researchDirection.exclusionCriteria?.length === 0) {
-        gaps.push("inclusion/exclusion rule");
-    }
-    if (specification.evidenceAccess.requiredSources?.length === 0 &&
-        specification.evidenceAccess.evidenceStandards?.length === 0) {
-        gaps.push("evidence boundary");
-    }
-    if (!specification.methodAnalysis.design?.trim() &&
-        specification.methodAnalysis.analysisOptions.length === 0) {
-        gaps.push("method commitment");
-    }
-    if (specification.openQuestions.length === 0 && specification.protectedDecisions.length === 0) {
-        gaps.push("unresolved decisions/protected decisions");
-    }
-    if (specification.evidenceAccess.accessRequirements?.length === 0 &&
-        specification.evidenceAccess.requiredSources?.length === 0) {
-        gaps.push("search/access assumptions");
-    }
-    return gaps;
-}
 function buildResearchSpecificationGapQuestion(gaps, timestamp, sourceEvidenceIds) {
     return {
         id: createId("question"),
@@ -767,6 +748,12 @@ function summarizeWorkspaceInspection(context, state) {
     const answeredQuestions = questions.filter((record) => record.status === "answered");
     const pendingObligations = visiblePendingObligations(state);
     const hardStop = collectHardStopBlockers(state);
+    const researchSpecificationReadiness = evaluateResearchSpecificationReadiness({
+        firstResearchShape: state.firstResearchShape ?? context.session.firstResearchShape,
+        researchSpecification: state.researchSpecification ?? context.session.researchSpecification,
+        questionLog: state.questionLog,
+        questionObligations: state.questionObligations
+    });
     return {
         found: true,
         rootPath: context.project.projectPath,
@@ -815,6 +802,7 @@ function summarizeWorkspaceInspection(context, state) {
             specRevisions: (state.specRevisions ?? []).length
         },
         hardStop,
+        researchSpecificationReadiness,
         recentInvocations: recentInvocationRecords(state, 5).map((record) => ({
             id: record.id,
             kind: record.intent.kind,
@@ -2275,7 +2263,7 @@ const COMMITMENT_FAMILY_BY_CHECKPOINT = [
     [/research_question|research_direction|scope|boundary|inclusion|exclusion/, "scope"],
     [/theory|construct|conceptual/, "construct"],
     [/measurement|coding|codebook|extraction/, "coding"],
-    [/method|analysis|panel_disagreement|team_debate|review/, "method"],
+    [/method|analysis|panel_disagreement|panel_debate|team_debate|review/, "method"],
     [/evidence|scholarly_access|source_authority/, "evidence"],
     [/knowledge_gap|tacit_assumption|epistemic/, "epistemic_authority"]
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@longtable/checkpoints": "0.1.52",
-    "@longtable/core": "0.1.52",
-    "@longtable/memory": "0.1.52",
-    "@longtable/provider-claude": "0.1.52",
-    "@longtable/provider-codex": "0.1.52",
-    "@longtable/setup": "0.1.52"
+    "@longtable/checkpoints": "0.1.54",
+    "@longtable/core": "0.1.54",
+    "@longtable/memory": "0.1.54",
+    "@longtable/provider-claude": "0.1.54",
+    "@longtable/provider-codex": "0.1.54",
+    "@longtable/setup": "0.1.54"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",