@longtable/cli 0.1.0 → 0.1.2

package/README.md

@@ -2,26 +2,22 @@
 
 Researcher-facing Long Table CLI built on top of the legacy `@diverga/*` package surface.
 
-중요한 현재 상태:
-
-- `@longtable/cli`는 repo 안에서는 구현되어 있음
-- npm의 `@longtable` scope가 아직 준비되지 않아 실제 publish는 아직 안 됨
-- 지금 공개 설치 경로는 여전히 `@diverga/setup`, `@diverga/provider-codex`
+현재 공개 설치 경로는 `@longtable/cli`입니다.
 
 ## Install
 
-로컬 preview:
+공개 설치:
 
 ```bash
-npm install
-npm run build
-node packages/longtable/dist/cli.js --help
+npm install -g @longtable/cli
 ```
 
-예상 공개 설치 경로:
+로컬 preview:
 
 ```bash
-npm install -g @longtable/cli
+npm install
+npm run build
+node packages/longtable/dist/cli.js --help
 ```
 
 ## Recommended flow
@@ -29,14 +25,20 @@ npm install -g @longtable/cli
 Run setup once and install Codex prompt aliases:
 
 ```bash
-longtable init --install-prompts
+longtable init --flow interview --install-prompts
 ```
 
+`longtable init` now uses an arrow-key terminal menu instead of plain number-entry prompts and supports:
+
+- `--flow quickstart`
+- `--flow interview`
+
 Then you can work in two ways.
 
 From the terminal:
 
 ```bash
+longtable ask --prompt "연구를 시작하고 싶어. 지금 어디서부터 좁혀야 할지 모르겠어."
 longtable review --prompt "Review this claim critically."
 longtable review --prompt "BJET 편집자 관점에서 봐줘." --role editor
 longtable review --prompt "방법론적으로 어디가 취약한지 말해줘." --panel --show-conflicts
@@ -44,6 +46,7 @@ longtable review --prompt "방법론적으로 어디가 취약한지 말해줘."
 
 Inside Codex after prompt aliases are installed:
 
+- `/prompts:longtable`
 - `/prompts:longtable-init`
 - `/prompts:longtable-explore`
 - `/prompts:longtable-review`
@@ -55,6 +58,7 @@ Inside Codex after prompt aliases are installed:
 ## Core commands
 
 ```bash
+longtable ask --prompt "Help me open this research problem carefully."
 longtable init
 longtable show --json
 longtable install --json
@@ -71,6 +75,18 @@ Install Codex prompt aliases:
 longtable codex install-prompts
 ```
 
+If you finish onboarding inside Codex with `/prompts:longtable-init`, you can persist the collected answers with:
+
+```bash
+longtable codex persist-init --flow interview --provider codex --field education --career-stage doctoral --experience intermediate --project-type "journal article" --checkpoint balanced --topic "AI adoption in workplace settings" --blocker "기업 맥락으로 범위를 다시 잡아야 하는데 어디서부터 포함/제외 기준을 세울지 모르겠어." --entry-mode explore --weakest-domain methodology --panel-preference show_on_conflict --install-prompts
+```
+
+Or from a JSON block:
+
+```bash
+pbpaste | longtable codex persist-init --stdin --install-prompts
+```
+
 Check whether setup and aliases are present:
 
 ```bash
@@ -86,6 +102,6 @@ longtable codex remove-prompts
 ## Why this package exists
 
 Long Table is the product name.
-`Diverga` is still the legacy technical identifier for package names, CLI binaries, and runtime paths.
+`Diverga` remains an internal compatibility layer for some lower-level packages and runtime paths.
 
-This package creates a researcher-facing command surface now, without forcing a breaking rename of the published package chain yet.
+This package exists so researchers can install and run `longtable` directly while that compatibility layer remains underneath.

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync } from "node:fs";
+import { emitKeypressEvents } from "node:readline";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output, cwd, exit } from "node:process";
 import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, serializeSetupOutput } from "@diverga/setup";
@@ -26,18 +27,22 @@ const VALID_STAGES = new Set([
 function usage() {
     return [
         "Usage:",
-        "  longtable init [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--project-type <type>] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--json] [--no-install] [--install-prompts]",
+        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--project-type <type>] [--checkpoint low|balanced|high] [--authorship-signal <text>] [--topic <text>] [--blocker <text>] [--entry-mode explore|review|critique|draft|commit] [--weakest-domain theory|methodology|measurement|analysis|writing] [--panel-preference synthesis_only|show_on_conflict|always_visible] [--json] [--no-install] [--install-prompts]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
+        "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
         "  longtable explore|review|critique|draft|commit|submit [--prompt <text>] [--role <role[,role]>] [--panel] [--show-conflicts] [--show-deliberation] [--print] [--json] [--stage <stage>] [--setup <path>] [--cwd <path>]",
+        "  longtable codex persist-init [--answers-json <json> | --stdin | full setup flags] [--install-prompts] [--json]",
         "  longtable codex install-prompts [--dir <path>]",
         "  longtable codex remove-prompts [--dir <path>]",
         "  longtable codex status [--dir <path>] [--json]",
         "",
         "Examples:",
-        "  longtable init --install-prompts",
+        "  longtable init --flow interview --install-prompts",
+        "  longtable ask --prompt \"연구를 시작하고 싶어. 지금 어디서부터 좁혀야 할지 모르겠어.\"",
         "  longtable review --prompt \"Review this claim critically.\" --panel --show-conflicts",
         "  longtable review --role editor --prompt \"BJET 편집자 관점에서 봐줘.\"",
+        "  printf '{\"provider\":\"codex\",...}' | longtable codex persist-init --stdin --install-prompts",
         "  longtable codex install-prompts"
     ].join("\n");
 }
@@ -46,7 +51,7 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "show", "install", "codex"].includes(command);
+    const directCommand = command && ["init", "show", "install", "codex", "ask"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -88,7 +93,65 @@ function renderChoices(choices) {
         .map((choice, index) => `${index + 1}. ${choice.label} — ${choice.description}`)
         .join("\n");
 }
-async function promptChoice(rl, prompt, choices) {
+function buildSetupFlowChoices() {
+    return [
+        {
+            id: "quickstart",
+            label: "Quickstart",
+            description: "Minimal setup for the fastest first win."
+        },
+        {
+            id: "interview",
+            label: "Interview",
+            description: "A more detailed researcher profile interview for better first guidance."
+        }
+    ];
+}
+function renderSetupHeader(flow) {
+    const title = flow === "interview" ? "Long Table Setup Interview" : "Long Table Quickstart";
+    const subtitle = flow === "interview"
+        ? "We will ask about your research persona, current topic, blocker, and preferred kind of challenge."
+        : "We will capture the minimum profile needed to start using Long Table.";
+    return [
+        "┌──────────────────────────────────────────────┐",
+        `│ ${title.padEnd(44, " ")}│`,
+        "└──────────────────────────────────────────────┘",
+        subtitle
+    ].join("\n");
+}
+function renderQuestionHeader(index, total, section, prompt) {
+    return [``, `[${index}/${total}] ${section}`, prompt].join("\n");
+}
+function questionSection(questionId) {
+    if (questionId === "field" || questionId === "careerStage" || questionId === "experienceLevel") {
+        return "Researcher profile";
+    }
+    if (questionId === "currentProjectType" || questionId === "currentResearchTopic" || questionId === "currentBlocker") {
+        return "Current work";
+    }
+    if (questionId === "preferredCheckpointIntensity" || questionId === "preferredEntryMode") {
+        return "Interaction style";
+    }
+    if (questionId === "weakestDomain" || questionId === "panelPreference") {
+        return "How Long Table should challenge you";
+    }
+    return "Authorship and voice";
+}
+function moveCursorUp(lines) {
+    return lines > 0 ? `\u001B[${lines}A` : "";
+}
+function clearLine() {
+    return "\u001B[2K\r";
+}
+function renderArrowMenu(prompt, choices, selectedIndex) {
+    const lines = [prompt, "Use ↑/↓ and Enter."];
+    for (let index = 0; index < choices.length; index += 1) {
+        const prefix = index === selectedIndex ? ">" : " ";
+        lines.push(`${prefix} ${choices[index].label} - ${choices[index].description}`);
+    }
+    return lines.join("\n");
+}
+async function promptChoiceByNumber(rl, prompt, choices) {
     while (true) {
         const answer = await rl.question(`${prompt}\n${renderChoices(choices)}\nSelect one number: `);
         const numeric = Number(answer.trim());
@@ -108,10 +171,94 @@ async function promptChoice(rl, prompt, choices) {
         return choice.id;
     }
 }
+async function promptText(rl, prompt, required) {
+    while (true) {
+        const answer = (await rl.question(`${prompt}\n> `)).trim();
+        if (!required) {
+            return answer || undefined;
+        }
+        if (answer) {
+            return answer;
+        }
+        console.log("This answer cannot be empty.");
+    }
+}
+async function promptChoiceWithArrows(rl, prompt, choices) {
+    const stream = input;
+    if (!stream.isTTY || !output.isTTY) {
+        return promptChoiceByNumber(rl, prompt, choices);
+    }
+    const previousRawMode = stream.isRaw;
+    let selectedIndex = 0;
+    const renderedLineCount = choices.length + 2;
+    return await new Promise((resolve, reject) => {
+        function draw(first = false) {
+            if (!first) {
+                output.write(moveCursorUp(renderedLineCount));
+            }
+            const rendered = renderArrowMenu(prompt, choices, selectedIndex).split("\n");
+            for (const line of rendered) {
+                output.write(clearLine());
+                output.write(`${line}\n`);
+            }
+        }
+        function cleanup() {
+            stream.off("keypress", onKeypress);
+            if (stream.isTTY) {
+                stream.setRawMode(previousRawMode ?? false);
+            }
+            output.write("\u001B[?25h");
+        }
+        async function handleChoice(choice) {
+            cleanup();
+            if (choice.fallbackToText) {
+                const freeText = await rl.question("Type your custom value: ");
+                if (!freeText.trim()) {
+                    resolve(await promptChoiceWithArrows(rl, prompt, choices));
+                    return;
+                }
+                resolve(freeText.trim());
+                return;
+            }
+            resolve(choice.id);
+        }
+        function onKeypress(_, key) {
+            if (key.ctrl && key.name === "c") {
+                cleanup();
+                reject(new Error("Setup cancelled."));
+                return;
+            }
+            if (key.name === "up") {
+                selectedIndex = selectedIndex === 0 ? choices.length - 1 : selectedIndex - 1;
+                draw();
+                return;
+            }
+            if (key.name === "down") {
+                selectedIndex = selectedIndex === choices.length - 1 ? 0 : selectedIndex + 1;
+                draw();
+                return;
+            }
+            if (key.name === "return") {
+                void handleChoice(choices[selectedIndex]);
+            }
+        }
+        emitKeypressEvents(stream);
+        stream.setRawMode(true);
+        output.write("\u001B[?25l");
+        draw(true);
+        stream.on("keypress", onKeypress);
+    });
+}
+async function promptChoice(rl, prompt, choices) {
+    return promptChoiceWithArrows(rl, prompt, choices);
+}
 function hasCompleteFlagInput(args) {
     const required = ["provider", "field", "career-stage", "experience", "project-type", "checkpoint"];
     return required.every((key) => typeof args[key] === "string" && String(args[key]).trim().length > 0);
 }
+function resolveSetupFlow(args) {
+    return String(args.flow) === "interview" ? "interview" : "quickstart";
+}
 function toSetupAnswers(args) {
     return {
         field: String(args.field),
@@ -121,19 +268,43 @@ function toSetupAnswers(args) {
         preferredCheckpointIntensity: String(args.checkpoint),
         humanAuthorshipSignal: typeof args["authorship-signal"] === "string" && args["authorship-signal"].trim().length > 0
             ? args["authorship-signal"].trim()
+            : undefined,
+        currentResearchTopic: typeof args.topic === "string" && args.topic.trim().length > 0 ? args.topic.trim() : undefined,
+        currentBlocker: typeof args.blocker === "string" && args.blocker.trim().length > 0 ? args.blocker.trim() : undefined,
+        preferredEntryMode: typeof args["entry-mode"] === "string" && VALID_MODES.has(String(args["entry-mode"]))
+            ? String(args["entry-mode"])
+            : undefined,
+        weakestDomain: typeof args["weakest-domain"] === "string"
+            ? String(args["weakest-domain"])
+            : undefined,
+        panelPreference: typeof args["panel-preference"] === "string"
+            ? String(args["panel-preference"])
             : undefined
     };
 }
 async function collectInteractiveAnswers() {
     const rl = createInterface({ input, output });
     try {
+        const flow = (await promptChoice(rl, "How would you like to set up Long Table?", buildSetupFlowChoices()));
+        console.log("");
+        console.log(renderSetupHeader(flow));
+        console.log("");
         const provider = await promptChoice(rl, "Which provider do you want to configure?", buildProviderChoices());
         const answers = {};
-        for (const question of buildQuickSetupFlow()) {
-            if (!question.choices) {
+        const questions = buildQuickSetupFlow(flow);
+        for (let index = 0; index < questions.length; index += 1) {
+            const question = questions[index];
+            const prompt = renderQuestionHeader(index + 1, questions.length, questionSection(question.id), question.prompt);
+            let value;
+            if (question.kind === "text") {
+                value = await promptText(rl, prompt, question.required);
+            }
+            else if (question.choices) {
+                value = await promptChoice(rl, prompt, question.choices);
+            }
+            if (!value) {
                 continue;
             }
-            const value = await promptChoice(rl, question.prompt, question.choices);
             if (question.id === "field")
                 answers.field = value;
             if (question.id === "careerStage")
@@ -148,8 +319,19 @@ async function collectInteractiveAnswers() {
             if (question.id === "humanAuthorshipSignal" && value !== "other") {
                 answers.humanAuthorshipSignal = value;
             }
+            if (question.id === "currentResearchTopic")
+                answers.currentResearchTopic = value;
+            if (question.id === "currentBlocker")
+                answers.currentBlocker = value;
+            if (question.id === "preferredEntryMode")
+                answers.preferredEntryMode = value;
+            if (question.id === "weakestDomain")
+                answers.weakestDomain = value;
+            if (question.id === "panelPreference")
+                answers.panelPreference = value;
         }
         return {
+            flow,
             provider,
             answers: answers
         };
@@ -158,6 +340,61 @@ async function collectInteractiveAnswers() {
         rl.close();
     }
 }
+function normalizePersistAnswers(raw) {
+    return {
+        flow: raw.flow === "interview" ? "interview" : "quickstart",
+        provider: raw.provider === "claude" ? "claude" : "codex",
+        answers: {
+            field: raw.field,
+            careerStage: raw.careerStage,
+            experienceLevel: raw.experienceLevel,
+            currentProjectType: raw.currentProjectType,
+            preferredCheckpointIntensity: raw.preferredCheckpointIntensity,
+            ...(raw.humanAuthorshipSignal?.trim()
+                ? { humanAuthorshipSignal: raw.humanAuthorshipSignal.trim() }
+                : {}),
+            ...(raw.currentResearchTopic?.trim()
+                ? { currentResearchTopic: raw.currentResearchTopic.trim() }
+                : {}),
+            ...(raw.currentBlocker?.trim()
+                ? { currentBlocker: raw.currentBlocker.trim() }
+                : {}),
+            ...(raw.preferredEntryMode
+                ? { preferredEntryMode: raw.preferredEntryMode }
+                : {}),
+            ...(raw.weakestDomain
+                ? { weakestDomain: raw.weakestDomain }
+                : {}),
+            ...(raw.panelPreference
+                ? { panelPreference: raw.panelPreference }
+                : {})
+        }
+    };
+}
+async function readPersistAnswers(args) {
+    if (typeof args["answers-json"] === "string") {
+        const normalized = normalizePersistAnswers(JSON.parse(args["answers-json"]));
+        return {
+            ...normalized,
+            flow: typeof args.flow === "string" ? resolveSetupFlow(args) : normalized.flow
+        };
+    }
+    if (args.stdin === true) {
+        const raw = readFileSync(0, "utf8").trim();
+        if (!raw) {
+            throw new Error("No JSON was provided on stdin.");
+        }
+        return normalizePersistAnswers(JSON.parse(raw));
+    }
+    if (hasCompleteFlagInput(args)) {
+        return {
+            flow: resolveSetupFlow(args),
+            provider: String(args.provider) === "claude" ? "claude" : "codex",
+            answers: toSetupAnswers(args)
+        };
+    }
+    throw new Error("persist-init requires either --answers-json, --stdin, or the full set of setup flags.");
+}
 async function runInit(args) {
     const json = args.json === true;
     const installRuntime = args["no-install"] !== true;
@@ -165,13 +402,14 @@ async function runInit(args) {
     const customPath = typeof args.path === "string" ? args.path : undefined;
     const runtimePath = typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined;
     const promptsDir = typeof args.dir === "string" ? args.dir : undefined;
-    const { provider, answers } = hasCompleteFlagInput(args)
+    const { flow, provider, answers } = hasCompleteFlagInput(args)
         ? {
+            flow: resolveSetupFlow(args),
             provider: String(args.provider) === "claude" ? "claude" : "codex",
             answers: toSetupAnswers(args)
         }
         : await collectInteractiveAnswers();
-    const outputValue = createPersistedSetupOutput(answers, provider);
+    const outputValue = createPersistedSetupOutput(answers, provider, flow);
     const result = await saveSetupAndRuntimeConfig(outputValue, {
         setupPath: customPath,
         runtimePath
@@ -196,6 +434,20 @@ async function runInit(args) {
             console.log(`- /prompts:${prompt.name}`);
         }
     }
+    if (provider === "codex") {
+        console.log("");
+        console.log("Next step:");
+        console.log("- Open Codex and start with `/prompts:longtable`.");
+        if (answers.currentBlocker) {
+            console.log(`- Suggested first message: ${answers.currentBlocker}`);
+        }
+        else if (answers.currentResearchTopic) {
+            console.log(`- Suggested first message: Help me open the problem around ${answers.currentResearchTopic}.`);
+        }
+        else {
+            console.log("- Suggested first message: I want to start my research and need help opening the problem.");
+        }
+    }
 }
 async function runShow(args) {
     const outputValue = await loadSetupOutput(typeof args.path === "string" ? args.path : undefined);
@@ -216,6 +468,50 @@ async function runInstall(args) {
     }
     console.log(renderInstallSummary(result));
 }
+async function runCodexPersistInit(args) {
+    const { flow, provider, answers } = await readPersistAnswers(args);
+    const outputValue = createPersistedSetupOutput(answers, provider, flow);
+    const result = await saveSetupAndRuntimeConfig(outputValue, {
+        setupPath: typeof args.path === "string" ? args.path : undefined,
+        runtimePath: typeof args["runtime-path"] === "string" ? args["runtime-path"] : undefined
+    });
+    let installedPrompts = [];
+    if (provider === "codex" && args["install-prompts"] === true) {
+        installedPrompts = await installCodexPromptAliases(typeof args.dir === "string" ? args.dir : undefined);
+    }
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            setup: outputValue,
+            install: result,
+            installedPrompts: installedPrompts.map((prompt) => prompt.name)
+        }, null, 2));
+        return;
+    }
+    console.log(renderSetupSummary(outputValue));
+    console.log("");
+    console.log(renderInstallSummary(result));
+    if (installedPrompts.length > 0) {
+        console.log("");
+        console.log("Installed Codex prompt aliases:");
+        for (const prompt of installedPrompts) {
+            console.log(`- /prompts:${prompt.name}`);
+        }
+    }
+    if (provider === "codex") {
+        console.log("");
+        console.log("Next step:");
+        console.log("- Start Codex and use `/prompts:longtable` for the most natural entry.");
+        if (answers.currentBlocker) {
+            console.log(`- Suggested first message: ${answers.currentBlocker}`);
+        }
+        else if (answers.currentResearchTopic) {
+            console.log(`- Suggested first message: Help me think through ${answers.currentResearchTopic}.`);
+        }
+        else {
+            console.log("- Suggested first message: I want to start my research and I am not sure where to open the problem.");
+        }
+    }
+}
 async function resolvePrompt(prompt) {
     if (prompt?.trim()) {
         return prompt.trim();
@@ -231,6 +527,57 @@ async function resolvePrompt(prompt) {
         rl.close();
     }
 }
+function inferModeFromPrompt(prompt) {
+    const normalized = prompt.toLowerCase();
+    if (normalized.includes("status") ||
+        normalized.includes("설정") ||
+        normalized.includes("상태") ||
+        normalized.includes("롱테이블 상태")) {
+        return "status";
+    }
+    if (normalized.includes("패널") ||
+        normalized.includes("의견 충돌") ||
+        normalized.includes("conflict") ||
+        normalized.includes("disagree") ||
+        normalized.includes("panel")) {
+        return "panel";
+    }
+    if (normalized.includes("결정") ||
+        normalized.includes("고를") ||
+        normalized.includes("선택") ||
+        normalized.includes("commit")) {
+        return "commit";
+    }
+    if (normalized.includes("초안") ||
+        normalized.includes("써줘") ||
+        normalized.includes("문단") ||
+        normalized.includes("draft") ||
+        normalized.includes("write")) {
+        return "draft";
+    }
+    if (normalized.includes("비판") ||
+        normalized.includes("반론") ||
+        normalized.includes("critique") ||
+        normalized.includes("challenge")) {
+        return "critique";
+    }
+    if (normalized.includes("검토") ||
+        normalized.includes("review") ||
+        normalized.includes("편집자") ||
+        normalized.includes("리뷰어") ||
+        normalized.includes("judge")) {
+        return "review";
+    }
+    return "explore";
+}
+async function loadOptionalSetup(path) {
+    try {
+        return await loadSetupOutput(path);
+    }
+    catch {
+        return null;
+    }
+}
 async function runModeCommand(mode, args) {
     const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
     if (!prompt) {
@@ -240,10 +587,16 @@ async function runModeCommand(mode, args) {
     if (stage && !VALID_STAGES.has(stage)) {
         throw new Error(`Invalid stage: ${stage}`);
     }
+    const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
+    const panelPreference = setup?.profileSeed.panelPreference;
+    const panelRequested = args.panel === true ||
+        panelPreference === "always_visible" ||
+        (panelPreference === "show_on_conflict" && args["show-conflicts"] === true);
     const { guidedPrompt } = buildPersonaGuidance({
+        mode,
         prompt,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
-        panel: args.panel === true,
+        panel: panelRequested,
         showConflicts: args["show-conflicts"] === true,
         showDeliberation: args["show-deliberation"] === true
     });
@@ -268,6 +621,27 @@ async function runModeCommand(mode, args) {
     });
     exit(exitCode);
 }
+async function runAsk(args) {
+    const prompt = await resolvePrompt(typeof args.prompt === "string" ? args.prompt : undefined);
+    if (!prompt) {
+        throw new Error("A prompt is required.");
+    }
+    const inferred = inferModeFromPrompt(prompt);
+    if (inferred === "status") {
+        await runCodexSubcommand("status", args);
+        return;
+    }
+    const mode = inferred === "panel" ? "review" : inferred;
+    const delegatedArgs = {
+        ...args,
+        prompt
+    };
+    if (inferred === "panel" && delegatedArgs.panel !== true) {
+        delegatedArgs.panel = true;
+        delegatedArgs["show-conflicts"] = true;
+    }
+    await runModeCommand(mode, delegatedArgs);
+}
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     if (subcommand === "install-prompts") {
@@ -278,6 +652,10 @@ async function runCodexSubcommand(subcommand, args) {
         }
         return;
     }
+    if (subcommand === "persist-init") {
+        await runCodexPersistInit(args);
+        return;
+    }
     if (subcommand === "remove-prompts") {
         const removed = await removeCodexPromptAliases(customDir);
         console.log(`Removed ${removed.length} Long Table prompt aliases from ${resolveCodexPromptsDir(customDir)}`);
@@ -335,6 +713,10 @@ async function main() {
         await runInstall(values);
         return;
     }
+    if (command === "ask") {
+        await runAsk(values);
+        return;
+    }
     if (command === "codex") {
         await runCodexSubcommand(subcommand, values);
         return;
@@ -346,7 +728,11 @@ async function main() {
     throw new Error(`Unknown command: ${command}`);
 }
 main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    if (message === "Setup cancelled.") {
+        exit(1);
+    }
     console.error("");
     console.error(usage());
     exit(1);

package/dist/persona-router.d.ts

@@ -1,4 +1,5 @@
 import { type CanonicalPersona } from "./personas.js";
+import type { InteractionMode } from "@diverga/core";
 export type OutputLanguage = "ko" | "en";
 export interface PersonaRoutingResult {
     outputLanguage: OutputLanguage;
@@ -12,6 +13,7 @@ export declare function parseRoleFlag(value?: string): CanonicalPersona[];
 export declare function routePersonas(prompt: string, explicitRoleFlag?: string): PersonaRoutingResult;
 export declare function renderDisclosure(roles: CanonicalPersona[], language: OutputLanguage): string | null;
 export declare function buildPersonaGuidance(options: {
+    mode: InteractionMode;
     prompt: string;
     roleFlag?: string;
     panel?: boolean;

package/dist/persona-router.js

@@ -63,6 +63,9 @@ export function buildPersonaGuidance(options) {
     const routing = routePersonas(options.prompt, options.roleFlag);
     const disclosure = renderDisclosure(routing.consultedRoles, routing.outputLanguage);
     const lines = [];
+    lines.push(routing.outputLanguage === "ko"
+        ? `Long Table mode: ${options.mode[0].toUpperCase()}${options.mode.slice(1)}`
+        : `Long Table mode: ${options.mode[0].toUpperCase()}${options.mode.slice(1)}`);
     if (disclosure) {
         lines.push(disclosure);
     }
@@ -86,6 +89,9 @@ export function buildPersonaGuidance(options) {
             ? "Include a short deliberation trace showing why the roles diverged."
             : "Include a short deliberation trace showing why the roles diverged.");
     }
+    lines.push(routing.outputLanguage === "ko"
+        ? "Do not show internal file-search logs, tool traces, or process commentary in the researcher-facing answer."
+        : "Do not show internal file-search logs, tool traces, or process commentary in the researcher-facing answer.");
     lines.push(options.prompt.trim());
     return {
         guidedPrompt: lines.join("\n\n"),

package/dist/prompt-aliases.js

@@ -7,18 +7,38 @@ export function resolveCodexPromptsDir(customDir) {
 }
 function promptSpec() {
     return [
+        {
+            name: "longtable",
+            description: "Single-entry Long Table router for research conversations",
+            argumentHint: "<natural language research request>",
+            body: [
+                "You are Long Table.",
+                "Classify the user's request into one of these modes: explore, review, critique, draft, commit, panel, or status.",
+                "If the request is ambiguous, ask one short clarifying question before closing.",
+                "Always begin with `Long Table mode: <Mode>`.",
+                "Always disclose consulted roles with `Long Table consulted: ...` when any role is foregrounded.",
+                "In explore mode, ask at least two clarifying or tension questions before any recommendation.",
+                "In panel mode, return 1) Long Table synthesis 2) visible panel opinions by role 3) conflict summary if needed 4) a decision prompt for the researcher.",
+                "Do not expose internal tool logs, file searches, or process notes in the researcher-facing answer.",
+                "Treat any slash-command arguments as the current research object."
+            ]
+        },
         {
             name: "longtable-init",
             description: "Run Long Table researcher onboarding inside Codex",
             argumentHint: "[project context or current uncertainty]",
             body: [
                 "You are Long Table onboarding inside Codex.",
+                "First ask whether the researcher wants Quickstart or Interview setup.",
                 "Ask exactly one setup question at a time.",
                 "Use numbered choices when possible and include a 'None of the above' option when needed.",
                 "Do not move to the next question until the researcher answers the current one.",
-                "Cover these fields: provider, field, career stage, experience level, current project type, checkpoint intensity, and human authorship signal.",
-                "After collecting all answers, summarize the proposed setup and tell the researcher the exact `longtable init ...` command to persist it.",
+                "Quickstart covers: provider, field, career stage, experience level, current project type, checkpoint intensity, and human authorship signal.",
+                "Interview also covers: current research topic, current blocker, preferred entry mode, weakest domain, and panel visibility preference.",
+                "After collecting all answers, summarize the proposed setup and then output both: 1) the exact `longtable codex persist-init ... --install-prompts` command and 2) a strict JSON object with keys provider, flow, field, careerStage, experienceLevel, currentProjectType, preferredCheckpointIntensity, and optional humanAuthorshipSignal, currentResearchTopic, currentBlocker, preferredEntryMode, weakestDomain, panelPreference.",
+                "If the user prefers paste-based setup, tell them they can pipe the JSON into `longtable codex persist-init --stdin --install-prompts`.",
                 "If the researcher asks you to stay inside Codex, keep the conversation in numbered form and do not prematurely close.",
+                "Frame the setup like a short researcher interview, not a bare config form.",
                 "Treat any slash-command arguments as context for why setup is being done now."
             ]
         },
@@ -28,9 +48,11 @@ function promptSpec() {
             argumentHint: "<topic or research problem>",
             body: [
                 "You are Long Table in explore mode.",
+                "Always begin with `Long Table mode: Explore`.",
                 "Ask at least two clarifying or tension questions before any recommendation.",
                 "Keep unresolved tensions visible.",
                 "Do not rush to synthesis.",
+                "Do not expose internal process notes or file-search summaries.",
                 "Treat any slash-command arguments as the current research object."
             ]
         },
@@ -40,6 +62,7 @@ function promptSpec() {
             argumentHint: "<claim, paragraph, design, or plan>",
             body: [
                 "You are Long Table in review mode.",
+                "Always begin with `Long Table mode: Review`.",
                 "Surface why this may be wrong before synthesis.",
                 "Preserve the researcher's own language where possible.",
                 "Treat any slash-command arguments as the object to review."
@@ -51,6 +74,7 @@ function promptSpec() {
             argumentHint: "<claim, plan, or draft for multi-role review>",
             body: [
                 "You are Long Table in panel mode.",
+                "Always begin with `Long Table mode: Panel`.",
                 "Return 1) a Long Table synthesis 2) visible panel opinions by role 3) a decision prompt for the researcher.",
                 "If roles disagree, do not collapse them too early.",
                 "Disclose which roles were consulted.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "description": "Researcher-facing Long Table CLI on top of the legacy Diverga package surface",
   "type": "module",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@diverga/provider-codex": "0.1.1",
-    "@diverga/setup": "0.1.1"
+    "@diverga/setup": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",
@@ -43,9 +43,9 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/HosungYou/Diverga-Refactoring.git"
+    "url": "git+https://github.com/HosungYou/Long-Table-Refactoring.git"
   },
-  "homepage": "https://github.com/HosungYou/Diverga-Refactoring#readme",
+  "homepage": "https://github.com/HosungYou/Long-Table-Refactoring#readme",
   "publishConfig": {
     "access": "public"
   },