@longtable/cli 0.1.0 → 0.1.1

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
@@ -32,6 +28,8 @@ Run setup once and install Codex prompt aliases:
 longtable init --install-prompts
 ```
 
+`longtable init` now uses an arrow-key terminal menu instead of plain number-entry prompts.
+
 Then you can work in two ways.
 
 From the terminal:
@@ -71,6 +69,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 --provider codex --field education --career-stage doctoral --experience intermediate --project-type "journal article" --checkpoint balanced --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 +96,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";
@@ -30,6 +31,7 @@ function usage() {
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
         "  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]",
@@ -38,6 +40,7 @@ function usage() {
         "  longtable init --install-prompts",
         "  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");
 }
@@ -88,7 +91,21 @@ function renderChoices(choices) {
         .map((choice, index) => `${index + 1}. ${choice.label} — ${choice.description}`)
         .join("\n");
 }
-async function promptChoice(rl, prompt, choices) {
+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,6 +125,75 @@ async function promptChoice(rl, prompt, choices) {
         return choice.id;
     }
 }
+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);
@@ -158,6 +244,40 @@ async function collectInteractiveAnswers() {
         rl.close();
     }
 }
+function normalizePersistAnswers(raw) {
+    return {
+        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() }
+                : {})
+        }
+    };
+}
+async function readPersistAnswers(args) {
+    if (typeof args["answers-json"] === "string") {
+        return normalizePersistAnswers(JSON.parse(args["answers-json"]));
+    }
+    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 {
+            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;
@@ -216,6 +336,36 @@ async function runInstall(args) {
     }
     console.log(renderInstallSummary(result));
 }
+async function runCodexPersistInit(args) {
+    const { provider, answers } = await readPersistAnswers(args);
+    const outputValue = createPersistedSetupOutput(answers, provider);
+    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}`);
+        }
+    }
+}
 async function resolvePrompt(prompt) {
     if (prompt?.trim()) {
         return prompt.trim();
@@ -278,6 +428,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)}`);

package/dist/prompt-aliases.js

@@ -17,7 +17,8 @@ function promptSpec() {
                 "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.",
+                "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, field, careerStage, experienceLevel, currentProjectType, preferredCheckpointIntensity, and optional humanAuthorshipSignal.",
+                "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.",
                 "Treat any slash-command arguments as context for why setup is being done now."
             ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "description": "Researcher-facing Long Table CLI on top of the legacy Diverga package surface",
   "type": "module",
@@ -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"
   },