@longtable/cli 0.1.2 → 0.1.3

package/README.md

@@ -1,107 +1,101 @@
 # @longtable/cli
 
-Researcher-facing Long Table CLI built on top of the legacy `@diverga/*` package surface.
+Long Table의 researcher-facing CLI입니다.
 
-현재 공개 설치 경로는 `@longtable/cli`입니다.
+이 패키지는 연구자가 아래처럼 시작할 수 있게 만드는 것이 목표입니다.
 
-## Install
-
-공개 설치:
+- `longtable init`
+- `longtable start`
+- `longtable ask --prompt "..."`
 
-```bash
-npm install -g @longtable/cli
-```
+긴 내부 명령이나 legacy package 이름을 알 필요 없이,  
+연구자가 `오늘 무엇이 필요한가`에서 바로 출발할 수 있게 하는 표면입니다.
 
-로컬 preview:
+## Install
 
 ```bash
-npm install
-npm run build
-node packages/longtable/dist/cli.js --help
+npm install -g @longtable/cli
 ```
 
 ## Recommended flow
 
-Run setup once and install Codex prompt aliases:
+### 1. Setup once
 
 ```bash
-longtable init --flow interview --install-prompts
+longtable init --flow interview
 ```
 
-`longtable init` now uses an arrow-key terminal menu instead of plain number-entry prompts and supports:
+이 인터뷰 setup은 연구자의
 
-- `--flow quickstart`
-- `--flow interview`
+- 현재 주제
+- 현재 막힘
+- 선호하는 첫 진입 모드
+- 가장 많이 도전받고 싶은 영역
+- 역할 간 의견 충돌 가시성
 
-Then you can work in two ways.
+까지 저장합니다.
 
-From the terminal:
+### 2. Start from today’s work
 
 ```bash
-longtable ask --prompt "연구를 시작하고 싶어. 지금 어디서부터 좁혀야 할지 모르겠어."
-longtable review --prompt "Review this claim critically."
-longtable review --prompt "BJET 편집자 관점에서 봐줘." --role editor
-longtable review --prompt "방법론적으로 어디가 취약한지 말해줘." --panel --show-conflicts
+longtable start
 ```
 
-Inside Codex after prompt aliases are installed:
-
-- `/prompts:longtable`
-- `/prompts:longtable-init`
-- `/prompts:longtable-explore`
-- `/prompts:longtable-review`
-- `/prompts:longtable-critique`
-- `/prompts:longtable-draft`
-- `/prompts:longtable-commit`
-- `/prompts:longtable-status`
+`longtable start`는 가장 단순한 진입점입니다.  
+오늘 필요한 작업을 먼저 고르고, 그 다음 자연어로 상황을 말하면 됩니다.
 
-## Core commands
+### 3. Or jump straight in
 
 ```bash
-longtable ask --prompt "Help me open this research problem carefully."
-longtable init
-longtable show --json
-longtable install --json
-longtable explore --prompt "Help me stay exploratory."
-longtable review --prompt "Review this claim critically."
-longtable commit --prompt "Help me make this decision carefully."
+longtable ask --prompt "연구를 시작하고 싶은데 어디서부터 좁혀야 할지 모르겠어."
 ```
 
-## Codex overlay
-
-Install Codex prompt aliases:
+## Useful commands
 
 ```bash
-longtable codex install-prompts
+longtable start
+longtable roles
+longtable ask --prompt "이 연구 아이디어를 어디서부터 열어야 할지 모르겠어."
+longtable review --prompt "BJET 편집자 관점에서 봐줘." --role editor
+longtable review --prompt "방법론적으로 어디가 취약한지 말해줘." --role methods_critic
+longtable review --prompt "의견 충돌까지 보여줘." --panel --show-conflicts
+longtable show --json
 ```
 
-If you finish onboarding inside Codex with `/prompts:longtable-init`, you can persist the collected answers with:
+## What `roles` means
 
 ```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
+longtable roles
 ```
 
-Or from a JSON block:
+Long Table이 어떤 관점을 호출할 수 있는지 짧게 보여줍니다.
 
-```bash
-pbpaste | longtable codex persist-init --stdin --install-prompts
-```
+예:
+
+- `editor`
+- `reviewer`
+- `methods_critic`
+- `voice_keeper`
 
-Check whether setup and aliases are present:
+기본값은 하나의 Long Table synthesis이지만, 필요하면 panel과 conflict도 드러낼 수 있습니다.
+
+## Codex integration
+
+Long Table은 Codex prompt file 설치도 지원합니다.
 
 ```bash
+longtable codex install-prompts
 longtable codex status
 ```
 
-Remove the aliases:
+하지만 이 경로는 현재 `실험적`입니다.
 
-```bash
-longtable codex remove-prompts
-```
+- Codex 버전/빌드에 따라 prompt file이 slash command로 바로 노출되지 않을 수 있습니다.
+- 그래서 기본 사용자 경로는 `/prompts:...`가 아니라 `longtable start`와 `longtable ask`입니다.
 
 ## Why this package exists
 
-Long Table is the product name.
-`Diverga` remains an internal compatibility layer for some lower-level packages and runtime paths.
+Long Table은 제품명입니다.  
+`Diverga`는 아직 일부 하위 패키지와 runtime path에서만 남아 있는 호환성 레이어입니다.
 
-This package exists so researchers can install and run `longtable` directly while that compatibility layer remains underneath.
+이 패키지는 연구자가 `longtable`만 알면 되게 하기 위해 존재합니다.

package/dist/cli.js

@@ -7,6 +7,7 @@ import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput,
 import { buildCodexThinWrappedPrompt, runCodexThinWrapper } from "@diverga/provider-codex";
 import { installCodexPromptAliases, listInstalledCodexPromptAliases, removeCodexPromptAliases, resolveCodexPromptsDir } from "./prompt-aliases.js";
 import { buildPersonaGuidance } from "./persona-router.js";
+import { PERSONA_DEFINITIONS } from "./personas.js";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -28,6 +29,8 @@ function usage() {
     return [
         "Usage:",
         "  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 start [--prompt <text>] [--setup <path>] [--cwd <path>] [--print] [--json]",
+        "  longtable roles [--json]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
         "  longtable ask [--prompt <text>] [--print] [--json] [--setup <path>] [--cwd <path>]",
@@ -39,6 +42,8 @@ function usage() {
         "",
         "Examples:",
         "  longtable init --flow interview --install-prompts",
+        "  longtable start",
+        "  longtable roles",
         "  longtable ask --prompt \"연구를 시작하고 싶어. 지금 어디서부터 좁혀야 할지 모르겠어.\"",
         "  longtable review --prompt \"Review this claim critically.\" --panel --show-conflicts",
         "  longtable review --role editor --prompt \"BJET 편집자 관점에서 봐줘.\"",
@@ -51,7 +56,7 @@ function parseArgs(argv) {
     const values = {};
     let subcommand = maybeSubcommand;
     const modeCommand = command && VALID_MODES.has(command);
-    const directCommand = command && ["init", "show", "install", "codex", "ask"].includes(command);
+    const directCommand = command && ["init", "start", "roles", "show", "install", "codex", "ask"].includes(command);
     let startIndex = 1;
     if (modeCommand) {
         subcommand = undefined;
@@ -137,6 +142,9 @@ function questionSection(questionId) {
     }
     return "Authorship and voice";
 }
+function formatModeLabel(mode) {
+    return `${mode[0].toUpperCase()}${mode.slice(1)}`;
+}
 function moveCursorUp(lines) {
     return lines > 0 ? `\u001B[${lines}A` : "";
 }
@@ -252,6 +260,52 @@ async function promptChoiceWithArrows(rl, prompt, choices) {
 async function promptChoice(rl, prompt, choices) {
     return promptChoiceWithArrows(rl, prompt, choices);
 }
+async function promptStartAction(rl, blocker) {
+    return (await promptChoice(rl, blocker?.trim()
+        ? `What do you want to do with this first?\nCurrent blocker: ${blocker.trim()}`
+        : "What do you want Long Table to help you do first?", [
+        {
+            id: "explore",
+            label: "Open the problem",
+            description: "Start with questions, tensions, and a clearer research direction."
+        },
+        {
+            id: "review",
+            label: "Review something",
+            description: "Critically inspect a claim, outline, or draft."
+        },
+        {
+            id: "critique",
+            label: "Challenge me hard",
+            description: "Push back, stress-test assumptions, and surface hidden risks."
+        },
+        {
+            id: "editor",
+            label: "Journal editor view",
+            description: "See how an editor might judge framing, fit, and contribution."
+        },
+        {
+            id: "methods",
+            label: "Methods check",
+            description: "Focus on design fit, defensibility, and methodological weakness."
+        },
+        {
+            id: "panel",
+            label: "Show disagreement",
+            description: "Let multiple roles disagree instead of forcing one answer."
+        },
+        {
+            id: "status",
+            label: "Check my setup",
+            description: "See what Long Table knows and what is installed."
+        },
+        {
+            id: "roles",
+            label: "What roles exist?",
+            description: "See what perspectives Long Table can bring into the conversation."
+        }
+    ]));
+}
 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);
@@ -429,15 +483,18 @@ async function runInit(args) {
     }
     if (installedPrompts.length > 0) {
         console.log("");
-        console.log("Installed Codex prompt aliases:");
+        console.log("Installed Codex prompt files:");
         for (const prompt of installedPrompts) {
             console.log(`- /prompts:${prompt.name}`);
         }
+        console.log("  Note: whether Codex exposes these as slash commands depends on your Codex build.");
     }
     if (provider === "codex") {
         console.log("");
         console.log("Next step:");
-        console.log("- Open Codex and start with `/prompts:longtable`.");
+        console.log("- Start here: `longtable start`.");
+        console.log("- If you want a direct natural-language entry: `longtable ask --prompt \"...\"`.");
+        console.log("- Codex prompt files are available as an experimental integration, not the primary path.");
         if (answers.currentBlocker) {
             console.log(`- Suggested first message: ${answers.currentBlocker}`);
         }
@@ -492,15 +549,18 @@ async function runCodexPersistInit(args) {
     console.log(renderInstallSummary(result));
     if (installedPrompts.length > 0) {
         console.log("");
-        console.log("Installed Codex prompt aliases:");
+        console.log("Installed Codex prompt files:");
         for (const prompt of installedPrompts) {
             console.log(`- /prompts:${prompt.name}`);
         }
+        console.log("  Note: whether Codex exposes these as slash commands depends on your Codex build.");
     }
     if (provider === "codex") {
         console.log("");
         console.log("Next step:");
-        console.log("- Start Codex and use `/prompts:longtable` for the most natural entry.");
+        console.log("- Start here: `longtable start`.");
+        console.log("- If you want a direct natural-language entry: `longtable ask --prompt \"...\"`.");
+        console.log("- Codex prompt files are available as an experimental integration, not the primary path.");
         if (answers.currentBlocker) {
             console.log(`- Suggested first message: ${answers.currentBlocker}`);
         }
@@ -642,11 +702,118 @@ async function runAsk(args) {
     }
     await runModeCommand(mode, delegatedArgs);
 }
+async function runRoles(args) {
+    const payload = PERSONA_DEFINITIONS.map((persona) => ({
+        key: persona.key,
+        label: persona.label,
+        description: persona.shortDescription,
+        triggerMode: persona.triggerMode,
+        exampleTriggers: persona.synonyms.slice(0, 4)
+    }));
+    if (args.json === true) {
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+    }
+    console.log("Long Table roles");
+    console.log("These are perspectives Long Table can consult when relevant.");
+    console.log("");
+    for (const persona of payload) {
+        console.log(`- ${persona.label} (${persona.key})`);
+        console.log(`  ${persona.description}`);
+        console.log(`  Trigger: ${persona.triggerMode === "auto-callable" ? "auto-callable when your language strongly implies it" : "explicit request only"}`);
+        console.log(`  Examples: ${persona.exampleTriggers.join(", ")}`);
+    }
+}
+async function runStart(args) {
+    const setupPath = typeof args.setup === "string" ? args.setup : undefined;
+    const existingSetup = await loadOptionalSetup(setupPath);
+    if (!existingSetup) {
+        console.log("Long Table is not set up yet. Starting the interview flow first.");
+        console.log("");
+        await runInit({
+            ...args,
+            flow: typeof args.flow === "string" ? args.flow : "interview",
+            "install-prompts": true
+        });
+        return;
+    }
+    const directPrompt = typeof args.prompt === "string" ? args.prompt.trim() : "";
+    if (directPrompt) {
+        await runAsk({
+            ...args,
+            prompt: directPrompt,
+            ...(setupPath ? { setup: setupPath } : {})
+        });
+        return;
+    }
+    const rl = createInterface({ input, output });
+    try {
+        const action = await promptStartAction(rl, existingSetup.profileSeed.currentBlocker ?? existingSetup.profileSeed.currentResearchTopic);
+        if (action === "status") {
+            rl.close();
+            await runCodexSubcommand("status", args);
+            return;
+        }
+        if (action === "roles") {
+            rl.close();
+            await runRoles(args);
+            return;
+        }
+        const defaultPrompt = existingSetup.profileSeed.currentBlocker ??
+            existingSetup.profileSeed.currentResearchTopic ??
+            "";
+        const prompt = (await rl.question(defaultPrompt
+            ? `What are you working on today?\nPress Enter to use: ${defaultPrompt}\n> `
+            : "What are you working on today?\n> ")).trim() || defaultPrompt;
+        rl.close();
+        if (!prompt) {
+            throw new Error("A prompt is required.");
+        }
+        if (action === "editor") {
+            await runModeCommand("review", {
+                ...args,
+                prompt,
+                role: "editor",
+                ...(setupPath ? { setup: setupPath } : {})
+            });
+            return;
+        }
+        if (action === "methods") {
+            await runModeCommand("review", {
+                ...args,
+                prompt,
+                role: "methods_critic",
+                ...(setupPath ? { setup: setupPath } : {})
+            });
+            return;
+        }
+        if (action === "panel") {
+            await runModeCommand("review", {
+                ...args,
+                prompt,
+                panel: true,
+                "show-conflicts": true,
+                ...(setupPath ? { setup: setupPath } : {})
+            });
+            return;
+        }
+        const mode = action;
+        await runModeCommand(mode, {
+            ...args,
+            prompt,
+            ...(setupPath ? { setup: setupPath } : {})
+        });
+    }
+    finally {
+        rl.close();
+    }
+}
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;
     if (subcommand === "install-prompts") {
         const installed = await installCodexPromptAliases(customDir);
         console.log(`Installed ${installed.length} Long Table prompt aliases in ${resolveCodexPromptsDir(customDir)}`);
+        console.log("Note: prompt-file discovery depends on the Codex build. Treat this as an experimental integration.");
         for (const prompt of installed) {
             console.log(`- /prompts:${prompt.name}`);
         }
@@ -681,6 +848,7 @@ async function runCodexSubcommand(subcommand, args) {
         console.log(`- setup: ${status.setupExists ? "present" : "missing"} (${setupPath})`);
         console.log(`- codex runtime artifact: ${status.runtimeExists ? "present" : "missing"} (${runtimePath})`);
         console.log(`- prompt aliases dir: ${status.promptsDir}`);
+        console.log("- prompt-file integration: experimental (your Codex build may not expose these as slash commands)");
         if (aliases.length === 0) {
             console.log("- prompt aliases: none");
         }
@@ -705,6 +873,14 @@ async function main() {
         await runInit(values);
         return;
     }
+    if (command === "start") {
+        await runStart(values);
+        return;
+    }
+    if (command === "roles") {
+        await runRoles(values);
+        return;
+    }
     if (command === "show") {
         await runShow(values);
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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.2"
+    "@diverga/setup": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",