@longtable/cli 0.1.3 → 0.1.5

package/README.md

@@ -2,14 +2,16 @@
 
 Long Table의 researcher-facing CLI입니다.
 
-이 패키지는 연구자가 아래처럼 시작할 수 있게 만드는 것이 목표입니다.
+이 패키지의 핵심은 명령을 많이 외우게 하는 것이 아니라, 아래 두 단계를 명확하게 만드는 것입니다.
 
-- `longtable init`
-- `longtable start`
-- `longtable ask --prompt "..."`
+1. `longtable init`
+2. `longtable start`
+
+중요한 점:
 
-긴 내부 명령이나 legacy package 이름을 알 필요 없이,  
-연구자가 `오늘 무엇이 필요한가`에서 바로 출발할 수 있게 하는 표면입니다.
+- 이 두 명령은 **터미널에서 실행하는 셸 명령**입니다.
+- Codex 채팅창에 `longtable start`를 입력하는 것이 아닙니다.
+- `longtable start`로 프로젝트 작업공간을 만든 뒤, 그 디렉토리에서 `codex`를 여는 것이 기본 경로입니다.
 
 ## Install
 
@@ -17,59 +19,75 @@ Long Table의 researcher-facing CLI입니다.
 npm install -g @longtable/cli
 ```
 
-## Recommended flow
-
-### 1. Setup once
+## 1. Global setup
 
 ```bash
 longtable init --flow interview
 ```
 
-이 인터뷰 setup은 연구자의
-
-- 현재 주제
-- 현재 막힘
-- 선호하는 첫 진입 모드
-- 가장 많이 도전받고 싶은 영역
-- 역할 간 의견 충돌 가시성
+여기서는 연구자 프로필과 기본 선호를 묻습니다.
 
-까지 저장합니다.
+- 연구 분야
+- 연구자 역할
+- challenge 강도
+- 저자성/서사 관련 기본값
+- Long Table이 보통 어디서부터 시작해야 하는지
 
-### 2. Start from today’s work
+## 2. Project start
 
 ```bash
 longtable start
 ```
 
-`longtable start`는 가장 단순한 진입점입니다.  
-오늘 필요한 작업을 먼저 고르고, 그 다음 자연어로 상황을 말하면 됩니다.
+여기서는 실제 작업공간을 만듭니다.
 
-### 3. Or jump straight in
+- 프로젝트 이름
+- 프로젝트 디렉토리 위치
+- 현재 세션 목표
+- 현재 blocker
+- 필요한 관점
+- disagreement 가시성
+
+그리고 Long Table은:
+
+- 프로젝트 디렉토리 생성
+- `.longtable/` 메모리 파일 생성
+- 프로젝트용 `AGENTS.md` 생성
+- `START-HERE.md` 생성
+
+을 수행합니다.
+
+## Recommended flow
 
 ```bash
-longtable ask --prompt "연구를 시작하고 싶은데 어디서부터 좁혀야 할지 모르겠어."
+longtable init --flow interview
+longtable start
+cd "<project-path>"
+codex
 ```
 
-## Useful commands
+이게 현재 가장 신뢰할 수 있는 Long Table 사용 경로입니다.
+
+## After the project starts
+
+프로젝트 디렉토리 안에서는 보통 그냥 `codex`를 열고 자연어로 연구를 시작하면 됩니다.
+
+CLI를 계속 쓰고 싶다면 아래 명령은 보조 경로입니다.
+
+## Advanced commands
 
 ```bash
-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
+longtable ask --cwd "<project-path>" --prompt "연구 질문을 어디서부터 좁혀야 할지 모르겠어."
+longtable review --cwd "<project-path>" --prompt "방법론적으로 어디가 취약한지 말해줘." --role methods_critic
 ```
 
-## What `roles` means
+## Roles
 
 ```bash
 longtable roles
 ```
 
-Long Table이 어떤 관점을 호출할 수 있는지 짧게 보여줍니다.
-
 예:
 
 - `editor`
@@ -77,25 +95,20 @@ Long Table이 어떤 관점을 호출할 수 있는지 짧게 보여줍니다.
 - `methods_critic`
 - `voice_keeper`
 
-기본값은 하나의 Long Table synthesis이지만, 필요하면 panel과 conflict도 드러낼 수 있습니다.
-
-## Codex integration
-
-Long Table은 Codex prompt file 설치도 지원합니다.
+## Codex prompt-file integration
 
 ```bash
 longtable codex install-prompts
 longtable codex status
 ```
 
-하지만 이 경로는 현재 `실험적`입니다.
+이 경로는 현재 실험적입니다.  
+사용자에게 약속하는 주 경로는 아닙니다.
 
-- Codex 버전/빌드에 따라 prompt file이 slash command로 바로 노출되지 않을 수 있습니다.
-- 그래서 기본 사용자 경로는 `/prompts:...`가 아니라 `longtable start`와 `longtable ask`입니다.
+기본 경로는 여전히:
 
-## Why this package exists
-
-Long Table은 제품명입니다.  
-`Diverga`는 아직 일부 하위 패키지와 runtime path에서만 남아 있는 호환성 레이어입니다.
+- `longtable init`
+- `longtable start`
+- 프로젝트 디렉토리에서 `codex`
 
-이 패키지는 연구자가 `longtable`만 알면 되게 하기 위해 존재합니다.
+입니다.

package/dist/cli.js

@@ -3,11 +3,13 @@ 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 { resolve } from "node:path";
 import { buildProviderChoices, buildQuickSetupFlow, createPersistedSetupOutput, installRuntimeConfigFromStoredSetup, loadSetupOutput, renderInstallSummary, renderSetupSummary, resolveDefaultRuntimeConfigPath, resolveDefaultSetupPath, saveSetupAndRuntimeConfig, serializeSetupOutput } from "@diverga/setup";
 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";
+import { createOrUpdateProjectWorkspace, loadProjectContextFromDirectory, renderProjectWorkspaceSummary } from "./project-session.js";
 const VALID_MODES = new Set([
     "explore",
     "review",
@@ -25,11 +27,32 @@ const VALID_STAGES = new Set([
     "writing",
     "submission"
 ]);
+const ANSI = {
+    reset: "\u001B[0m",
+    bold: "\u001B[1m",
+    dim: "\u001B[2m",
+    cyan: "\u001B[36m",
+    green: "\u001B[32m"
+};
+function style(text, prefix) {
+    return `${prefix}${text}${ANSI.reset}`;
+}
+function renderSectionCard(title, body) {
+    return [
+        "┌──────────────────────────────────────────────┐",
+        `│ ${title.padEnd(44, " ")}│`,
+        "└──────────────────────────────────────────────┘",
+        ...body
+    ].join("\n");
+}
 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]",
+        "  Run `longtable ...` in your terminal, not inside the Codex chat box.",
+        "  After `longtable start`, move into the created project directory and open `codex` there.",
+        "",
+        "  longtable init [--flow quickstart|interview] [--provider codex|claude] [--field <field>] [--career-stage <stage>] [--experience novice|intermediate|advanced] [--checkpoint low|balanced|high] [--authorship-signal <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 [--path <dir>] [--name <project>] [--goal <text>] [--blocker <text>] [--perspectives <role[,role]>] [--disagreement synthesis_only|show_on_conflict|always_visible] [--setup <path>] [--json]",
         "  longtable roles [--json]",
         "  longtable show [--json] [--path <file>]",
         "  longtable install [--json] [--path <file>] [--runtime-path <file>]",
@@ -43,10 +66,10 @@ function usage() {
         "Examples:",
         "  longtable init --flow interview --install-prompts",
         "  longtable start",
+        "  longtable start --path ~/Research/My-Project --name \"AI Adoption Meta-Analysis\" --goal \"Narrow the review question\"",
+        "  cd \"<project-path>\" && codex",
         "  longtable roles",
         "  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");
@@ -115,25 +138,17 @@ function buildSetupFlowChoices() {
 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 ask about your research persona, challenge preferences, and authorship defaults."
         : "We will capture the minimum profile needed to start using Long Table.";
-    return [
-        "┌──────────────────────────────────────────────┐",
-        `│ ${title.padEnd(44, " ")}│`,
-        "└──────────────────────────────────────────────┘",
-        subtitle
-    ].join("\n");
+    return renderSectionCard(title, [subtitle]);
 }
 function renderQuestionHeader(index, total, section, prompt) {
-    return [``, `[${index}/${total}] ${section}`, prompt].join("\n");
+    return [``, style(`[${index}/${total}] ${section}`, `${ANSI.bold}${ANSI.cyan}`), 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";
     }
@@ -152,9 +167,9 @@ function clearLine() {
     return "\u001B[2K\r";
 }
 function renderArrowMenu(prompt, choices, selectedIndex) {
-    const lines = [prompt, "Use ↑/↓ and Enter."];
+    const lines = [style(prompt, ANSI.bold), style("Use ↑/↓ and Enter.", ANSI.dim)];
     for (let index = 0; index < choices.length; index += 1) {
-        const prefix = index === selectedIndex ? ">" : " ";
+        const prefix = index === selectedIndex ? style(">", `${ANSI.bold}${ANSI.green}`) : " ";
         lines.push(`${prefix} ${choices[index].label} - ${choices[index].description}`);
     }
     return lines.join("\n");
@@ -260,54 +275,84 @@ 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."
+async function promptMultiChoice(rl, prompt, choices) {
+    const stream = input;
+    if (!stream.isTTY || !output.isTTY) {
+        const answer = await rl.question(`${prompt}\nType comma-separated ids or leave blank for auto.\n> `);
+        return answer
+            .split(",")
+            .map((part) => part.trim())
+            .filter(Boolean);
+    }
+    const previousRawMode = stream.isRaw;
+    let selectedIndex = 0;
+    const selected = new Set();
+    const renderedLineCount = choices.length + 2;
+    return await new Promise((resolvePromise, reject) => {
+        function draw(first = false) {
+            if (!first) {
+                output.write(moveCursorUp(renderedLineCount));
+            }
+            const lines = [prompt, "Use ↑/↓, Space to toggle, and Enter to confirm."];
+            for (let index = 0; index < choices.length; index += 1) {
+                const choice = choices[index];
+                const pointer = index === selectedIndex ? ">" : " ";
+                const marker = selected.has(choice.id) ? "[x]" : "[ ]";
+                lines.push(`${pointer} ${marker} ${choice.label} - ${choice.description}`);
+            }
+            for (const line of lines) {
+                output.write(clearLine());
+                output.write(`${line}\n`);
+            }
         }
-    ]));
+        function cleanup() {
+            stream.off("keypress", onKeypress);
+            if (stream.isTTY) {
+                stream.setRawMode(previousRawMode ?? false);
+            }
+            output.write("\u001B[?25h");
+        }
+        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 === "space") {
+                const id = choices[selectedIndex].id;
+                if (selected.has(id)) {
+                    selected.delete(id);
+                }
+                else {
+                    selected.add(id);
+                }
+                draw();
+                return;
+            }
+            if (key.name === "return") {
+                cleanup();
+                resolvePromise([...selected]);
+            }
+        }
+        emitKeypressEvents(stream);
+        stream.setRawMode(true);
+        output.write("\u001B[?25l");
+        draw(true);
+        stream.on("keypress", onKeypress);
+    });
 }
 function hasCompleteFlagInput(args) {
-    const required = ["provider", "field", "career-stage", "experience", "project-type", "checkpoint"];
+    const required = ["provider", "field", "career-stage", "experience", "checkpoint"];
     return required.every((key) => typeof args[key] === "string" && String(args[key]).trim().length > 0);
 }
 function resolveSetupFlow(args) {
@@ -318,13 +363,13 @@ function toSetupAnswers(args) {
         field: String(args.field),
         careerStage: String(args["career-stage"]),
         experienceLevel: String(args.experience),
-        currentProjectType: String(args["project-type"]),
+        currentProjectType: typeof args["project-type"] === "string" && args["project-type"].trim().length > 0
+            ? String(args["project-type"])
+            : "unspecified research task",
         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,
@@ -336,15 +381,18 @@ function toSetupAnswers(args) {
             : undefined
     };
 }
-async function collectInteractiveAnswers() {
+async function collectInteractiveAnswers(initialFlow) {
     const rl = createInterface({ input, output });
     try {
-        const flow = (await promptChoice(rl, "How would you like to set up Long Table?", buildSetupFlowChoices()));
+        const flow = initialFlow ??
+            (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 = {};
+        const answers = {
+            currentProjectType: "unspecified research task"
+        };
         const questions = buildQuickSetupFlow(flow);
         for (let index = 0; index < questions.length; index += 1) {
             const question = questions[index];
@@ -365,18 +413,12 @@ async function collectInteractiveAnswers() {
                 answers.careerStage = value;
             if (question.id === "experienceLevel")
                 answers.experienceLevel = value;
-            if (question.id === "currentProjectType")
-                answers.currentProjectType = value;
             if (question.id === "preferredCheckpointIntensity") {
                 answers.preferredCheckpointIntensity = value;
             }
             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")
@@ -394,6 +436,84 @@ async function collectInteractiveAnswers() {
         rl.close();
     }
 }
+function perspectiveChoices() {
+    return PERSONA_DEFINITIONS.map((persona) => ({
+        id: persona.key,
+        label: persona.label,
+        description: persona.shortDescription
+    }));
+}
+function normalizePerspectiveList(value) {
+    if (!value?.trim()) {
+        return [];
+    }
+    return value
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+async function collectProjectInterview(setup, args) {
+    const needsInteractivePrompts = !(typeof args.name === "string" && args.name.trim()) ||
+        !(typeof args.path === "string" && args.path.trim()) ||
+        !(typeof args.goal === "string" && args.goal.trim()) ||
+        typeof args.blocker !== "string" ||
+        normalizePerspectiveList(typeof args.perspectives === "string" ? args.perspectives : undefined).length === 0 ||
+        !(typeof args.disagreement === "string" && args.disagreement.trim());
+    const rl = createInterface({ input, output });
+    try {
+        if (needsInteractivePrompts) {
+            console.log("");
+            console.log(renderSectionCard("Long Table Project Start", [
+                "We will create a project workspace and a session memory seed for today's work.",
+                "At the end, Long Table will tell you exactly which directory to open in Codex."
+            ]));
+            console.log("");
+        }
+        const projectName = (typeof args.name === "string" && args.name.trim()) ||
+            (await promptText(rl, renderQuestionHeader(1, 6, "Project interview", "What should this project be called?"), true));
+        const suggestedPath = typeof args.path === "string" && args.path.trim()
+            ? args.path.trim()
+            : resolve(projectName.replace(/\s+/g, "-"));
+        const projectPath = (typeof args.path === "string" && args.path.trim()) ||
+            (await promptText(rl, renderQuestionHeader(2, 6, "Project interview", `Where should this project live on your machine?\nSuggested path: ${suggestedPath}`), true));
+        const currentGoal = (typeof args.goal === "string" && args.goal.trim()) ||
+            (await promptText(rl, renderQuestionHeader(3, 6, "Current session", "What are you trying to accomplish in this session?"), true));
+        const currentBlocker = (typeof args.blocker === "string" && args.blocker.trim()) ||
+            (await promptText(rl, renderQuestionHeader(4, 6, "Current session", "What is the main blocker or uncertainty right now?"), false));
+        const requestedPerspectives = normalizePerspectiveList(typeof args.perspectives === "string" ? args.perspectives : undefined).length > 0
+            ? normalizePerspectiveList(typeof args.perspectives === "string" ? args.perspectives : undefined)
+            : await promptMultiChoice(rl, renderQuestionHeader(5, 6, "Perspectives", "Which perspectives do you already know you want at the table? Leave everything unchecked for auto."), perspectiveChoices());
+        const disagreementPreference = (typeof args.disagreement === "string" && args.disagreement.trim()) ||
+            (await promptChoice(rl, renderQuestionHeader(6, 6, "Disagreement", "How visible should disagreement between perspectives be in this project by default?"), [
+                {
+                    id: "synthesis_only",
+                    label: "Synthesis only",
+                    description: "Show one Long Table answer unless I ask for more."
+                },
+                {
+                    id: "show_on_conflict",
+                    label: "Show on conflict",
+                    description: "Surface disagreement when the perspectives materially diverge."
+                },
+                {
+                    id: "always_visible",
+                    label: "Always visible",
+                    description: "Keep panel opinions visible by default."
+                }
+            ]));
+        return {
+            projectName: projectName.trim(),
+            projectPath: projectPath.trim(),
+            currentGoal: currentGoal.trim(),
+            ...(currentBlocker?.trim() ? { currentBlocker: currentBlocker.trim() } : {}),
+            requestedPerspectives,
+            disagreementPreference: disagreementPreference
+        };
+    }
+    finally {
+        rl.close();
+    }
+}
 function normalizePersistAnswers(raw) {
     return {
         flow: raw.flow === "interview" ? "interview" : "quickstart",
@@ -402,17 +522,11 @@ function normalizePersistAnswers(raw) {
             field: raw.field,
             careerStage: raw.careerStage,
             experienceLevel: raw.experienceLevel,
-            currentProjectType: raw.currentProjectType,
+            currentProjectType: "unspecified research task",
             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 }
                 : {}),
@@ -462,7 +576,7 @@ async function runInit(args) {
             provider: String(args.provider) === "claude" ? "claude" : "codex",
             answers: toSetupAnswers(args)
         }
-        : await collectInteractiveAnswers();
+        : await collectInteractiveAnswers(typeof args.flow === "string" ? resolveSetupFlow(args) : undefined);
     const outputValue = createPersistedSetupOutput(answers, provider, flow);
     const result = await saveSetupAndRuntimeConfig(outputValue, {
         setupPath: customPath,
@@ -495,15 +609,7 @@ async function runInit(args) {
         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}`);
-        }
-        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.");
-        }
+        console.log("- Suggested next action: create a project workspace and let Long Table interview the current session.");
     }
 }
 async function runShow(args) {
@@ -561,15 +667,7 @@ async function runCodexPersistInit(args) {
         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}`);
-        }
-        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.");
-        }
+        console.log("- Suggested next action: create a project workspace and let Long Table interview the current session.");
     }
 }
 async function resolvePrompt(prompt) {
@@ -638,7 +736,25 @@ async function loadOptionalSetup(path) {
         return null;
     }
 }
+async function buildProjectAwarePrompt(prompt, workingDirectory) {
+    const context = await loadProjectContextFromDirectory(workingDirectory);
+    if (!context) {
+        return { prompt, projectContextFound: false };
+    }
+    const lines = [
+        "Long Table project context",
+        `project: ${context.project.projectName}`,
+        `current session goal: ${context.session.currentGoal}`,
+        ...(context.session.currentBlocker ? [`current blocker: ${context.session.currentBlocker}`] : []),
+        `requested perspectives: ${context.session.requestedPerspectives.length > 0 ? context.session.requestedPerspectives.join(", ") : "auto"}`,
+        `disagreement preference: ${context.session.disagreementPreference}`,
+        "",
+        prompt
+    ];
+    return { prompt: lines.join("\n"), projectContextFound: true };
+}
 async function runModeCommand(mode, 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.");
@@ -648,13 +764,14 @@ async function runModeCommand(mode, args) {
         throw new Error(`Invalid stage: ${stage}`);
     }
     const setup = await loadOptionalSetup(typeof args.setup === "string" ? args.setup : undefined);
+    const projectAware = await buildProjectAwarePrompt(prompt, workingDirectory);
     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,
+        prompt: projectAware.prompt,
         roleFlag: typeof args.role === "string" ? args.role : undefined,
         panel: panelRequested,
         showConflicts: args["show-conflicts"] === true,
@@ -666,7 +783,7 @@ async function runModeCommand(mode, args) {
             mode,
             researchStage: stage,
             setupPath: typeof args.setup === "string" ? args.setup : undefined,
-            workingDirectory: typeof args.cwd === "string" ? args.cwd : cwd()
+            workingDirectory
         });
         console.log(wrapped.wrappedPrompt);
         return;
@@ -676,7 +793,7 @@ async function runModeCommand(mode, args) {
         mode,
         researchStage: stage,
         setupPath: typeof args.setup === "string" ? args.setup : undefined,
-        workingDirectory: typeof args.cwd === "string" ? args.cwd : cwd(),
+        workingDirectory,
         json: args.json === true
     });
     exit(exitCode);
@@ -728,85 +845,38 @@ 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 } : {})
-        });
+        throw new Error("Long Table global setup is missing. Run `longtable init --flow interview` first.");
+    }
+    const interview = await collectProjectInterview(existingSetup, args);
+    const context = await createOrUpdateProjectWorkspace({
+        projectName: interview.projectName,
+        projectPath: interview.projectPath,
+        currentGoal: interview.currentGoal,
+        currentBlocker: interview.currentBlocker,
+        requestedPerspectives: interview.requestedPerspectives,
+        disagreementPreference: interview.disagreementPreference,
+        setup: existingSetup
+    });
+    if (args.json === true) {
+        console.log(JSON.stringify({
+            project: context.project,
+            session: context.session,
+            projectFilePath: context.projectFilePath,
+            sessionFilePath: context.sessionFilePath
+        }, null, 2));
         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();
-    }
+    console.log(renderProjectWorkspaceSummary(context));
+    console.log("");
+    console.log(renderSectionCard("Next Step", [
+        `1. cd "${context.project.projectPath}"`,
+        "2. run `codex` in that directory",
+        "3. begin with your current goal in natural language",
+        "",
+        `Suggested first message: ${context.session.currentBlocker ? `"I want to work on ${context.session.currentGoal}. My current blocker is ${context.session.currentBlocker}."` : `"I want to work on ${context.session.currentGoal}."`}`,
+        "",
+        `Optional CLI path: longtable ask --cwd "${context.project.projectPath}" --prompt "${context.session.currentGoal.replaceAll("\"", "\\\"")}"`
+    ]));
 }
 async function runCodexSubcommand(subcommand, args) {
     const customDir = typeof args.dir === "string" ? args.dir : undefined;

package/dist/project-session.d.ts

@@ -0,0 +1,47 @@
+import type { SetupPersistedOutput } from "@diverga/setup";
+export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
+export interface LongTableProjectRecord {
+    schemaVersion: 1;
+    product: "Long Table";
+    projectName: string;
+    projectPath: string;
+    createdAt: string;
+    globalSetupSummary: {
+        field: string;
+        careerStage: string;
+        experienceLevel: string;
+        checkpointIntensity: string;
+        humanAuthorshipSignal?: string;
+        weakestDomain?: string;
+        defaultPanelPreference?: ProjectDisagreementPreference;
+    };
+}
+export interface LongTableSessionRecord {
+    schemaVersion: 1;
+    id: string;
+    createdAt: string;
+    projectName: string;
+    projectPath: string;
+    currentGoal: string;
+    currentBlocker?: string;
+    requestedPerspectives: string[];
+    disagreementPreference: ProjectDisagreementPreference;
+}
+export interface LongTableProjectContext {
+    project: LongTableProjectRecord;
+    session: LongTableSessionRecord;
+    projectFilePath: string;
+    sessionFilePath: string;
+    metaDir: string;
+}
+export declare function createOrUpdateProjectWorkspace(options: {
+    projectName: string;
+    projectPath: string;
+    currentGoal: string;
+    currentBlocker?: string;
+    requestedPerspectives: string[];
+    disagreementPreference: ProjectDisagreementPreference;
+    setup: SetupPersistedOutput;
+}): Promise<LongTableProjectContext>;
+export declare function loadProjectContextFromDirectory(startPath: string): Promise<LongTableProjectContext | null>;
+export declare function renderProjectWorkspaceSummary(context: LongTableProjectContext): string;

package/dist/project-session.js

@@ -0,0 +1,248 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { createEmptyResearchState } from "@diverga/memory";
+function nowIso() {
+    return new Date().toISOString();
+}
+function slugify(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9가-힣]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+}
+function resolveMetaDir(projectPath) {
+    return join(projectPath, ".longtable");
+}
+function buildWorkspaceGuide(project, session) {
+    const lines = [
+        "# Long Table Workspace",
+        "",
+        "This directory is a Long Table research workspace.",
+        "",
+        "## Current project",
+        `- Project: ${project.projectName}`,
+        `- Goal right now: ${session.currentGoal}`,
+        ...(session.currentBlocker ? [`- Current blocker: ${session.currentBlocker}`] : []),
+        `- Disagreement visibility: ${session.disagreementPreference}`,
+        `- Requested perspectives: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
+        "",
+        "## How Codex should behave here",
+        "- Treat this as a researcher-facing Long Table session, not a generic coding task.",
+        "- Ask clarifying or tension questions before closing too early.",
+        "- If you foreground specific roles, disclose them with `Long Table consulted: ...`.",
+        "- Keep one accountable synthesis, but keep disagreement visible by default when it matters.",
+        "- Do not expose internal tool logs or process commentary in researcher-facing answers.",
+        "",
+        "## Session files",
+        "- `.longtable/project.json` contains project-level metadata.",
+        "- `.longtable/current-session.json` contains the current session goal and blocker."
+    ];
+    return lines.join("\n");
+}
+function buildStartHereGuide(project, session) {
+    const lines = [
+        "# Start Here",
+        "",
+        `Project: ${project.projectName}`,
+        "",
+        "This workspace was created by Long Table for a single research project.",
+        "",
+        "## What to do now",
+        "1. Open Codex in this directory.",
+        "2. Start with your current goal, not a shell command.",
+        "3. Let Long Table keep disagreement visible when it matters.",
+        "",
+        "## Suggested first message",
+        session.currentBlocker
+            ? `"I want to work on ${session.currentGoal}. My current blocker is: ${session.currentBlocker}."`
+            : `"I want to work on ${session.currentGoal}."`,
+        "",
+        "## What Long Table already knows in this directory",
+        `- Current goal: ${session.currentGoal}`,
+        ...(session.currentBlocker ? [`- Current blocker: ${session.currentBlocker}`] : []),
+        `- Requested perspectives: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
+        `- Disagreement visibility: ${session.disagreementPreference}`,
+        "",
+        "## Files",
+        "- `AGENTS.md` tells Codex how to behave in this workspace.",
+        "- `.longtable/current-session.json` stores the current session goal and blocker.",
+        "- `.longtable/project.json` stores the project-level record."
+    ];
+    return lines.join("\n");
+}
+function buildProjectAgentsMd(project, session) {
+    return [
+        "# AGENTS.md",
+        "",
+        "This directory is a Long Table research workspace.",
+        "",
+        "## Purpose",
+        `- Project name: ${project.projectName}`,
+        `- Current goal: ${session.currentGoal}`,
+        ...(session.currentBlocker ? [`- Current blocker: ${session.currentBlocker}`] : []),
+        `- Requested perspectives: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
+        `- Disagreement visibility: ${session.disagreementPreference}`,
+        "",
+        "## Research-facing behavior",
+        "- Treat researcher interaction as the primary task.",
+        "- Begin exploratory work with clarifying or tension questions before recommending a direction.",
+        "- If you foreground role perspectives, disclose them with `Long Table consulted: ...`.",
+        "- Keep one accountable synthesis, but do not hide meaningful disagreement.",
+        ...(session.disagreementPreference === "always_visible"
+            ? ["- In this workspace, panel disagreement should be visible by default rather than hidden behind a single synthesis."]
+            : []),
+        "- Do not expose internal tool logs, file-search traces, or process commentary in the researcher-facing answer.",
+        "",
+        "## Session memory",
+        "- Read `.longtable/current-session.json` before giving substantial guidance.",
+        "- Use `.longtable/project.json` as the project-level context.",
+        "- Prefer the current goal and blocker over generic assumptions.",
+        "",
+        "## Scope",
+        "- These instructions apply to this directory and its children."
+    ].join("\n");
+}
+function buildStateSeed(project, session, setup) {
+    const state = createEmptyResearchState();
+    state.explicitState = {
+        field: setup.profileSeed.field,
+        careerStage: setup.profileSeed.careerStage,
+        experienceLevel: setup.profileSeed.experienceLevel,
+        projectName: project.projectName,
+        currentGoal: session.currentGoal,
+        disagreementPreference: session.disagreementPreference,
+        requestedPerspectives: session.requestedPerspectives
+    };
+    if (session.currentBlocker) {
+        state.explicitState.currentBlocker = session.currentBlocker;
+        state.openTensions.push(session.currentBlocker);
+    }
+    if (setup.profileSeed.humanAuthorshipSignal) {
+        state.explicitState.humanAuthorshipSignal = setup.profileSeed.humanAuthorshipSignal;
+    }
+    state.narrativeTraces.push({
+        id: "project-session-goal",
+        timestamp: nowIso(),
+        source: "longtable-start",
+        traceType: "judgment",
+        summary: `Current session goal: ${session.currentGoal}.`,
+        visibility: "explicit",
+        importance: "high"
+    });
+    if (session.currentBlocker) {
+        state.narrativeTraces.push({
+            id: "project-session-blocker",
+            timestamp: nowIso(),
+            source: "longtable-start",
+            traceType: "tension",
+            summary: `Current session blocker: ${session.currentBlocker}.`,
+            visibility: "explicit",
+            importance: "high"
+        });
+    }
+    return JSON.stringify(state, null, 2);
+}
+export async function createOrUpdateProjectWorkspace(options) {
+    const projectPath = resolve(options.projectPath);
+    const metaDir = resolveMetaDir(projectPath);
+    const sessionsDir = join(metaDir, "sessions");
+    const projectFilePath = join(metaDir, "project.json");
+    const sessionFilePath = join(metaDir, "current-session.json");
+    const sessionId = slugify(`${options.projectName}-${Date.now()}`);
+    await mkdir(projectPath, { recursive: true });
+    await mkdir(metaDir, { recursive: true });
+    await mkdir(sessionsDir, { recursive: true });
+    const project = existsSync(projectFilePath)
+        ? JSON.parse(await readFile(projectFilePath, "utf8"))
+        : {
+            schemaVersion: 1,
+            product: "Long Table",
+            projectName: options.projectName,
+            projectPath,
+            createdAt: nowIso(),
+            globalSetupSummary: {
+                field: options.setup.profileSeed.field,
+                careerStage: options.setup.profileSeed.careerStage,
+                experienceLevel: options.setup.profileSeed.experienceLevel,
+                checkpointIntensity: options.setup.profileSeed.preferredCheckpointIntensity,
+                ...(options.setup.profileSeed.humanAuthorshipSignal
+                    ? { humanAuthorshipSignal: options.setup.profileSeed.humanAuthorshipSignal }
+                    : {}),
+                ...(options.setup.profileSeed.weakestDomain
+                    ? { weakestDomain: options.setup.profileSeed.weakestDomain }
+                    : {}),
+                ...(options.setup.profileSeed.panelPreference
+                    ? { defaultPanelPreference: options.setup.profileSeed.panelPreference }
+                    : {})
+            }
+        };
+    const session = {
+        schemaVersion: 1,
+        id: sessionId,
+        createdAt: nowIso(),
+        projectName: project.projectName,
+        projectPath,
+        currentGoal: options.currentGoal,
+        ...(options.currentBlocker ? { currentBlocker: options.currentBlocker } : {}),
+        requestedPerspectives: options.requestedPerspectives,
+        disagreementPreference: options.disagreementPreference
+    };
+    await writeFile(projectFilePath, JSON.stringify(project, null, 2), "utf8");
+    await writeFile(sessionFilePath, JSON.stringify(session, null, 2), "utf8");
+    await writeFile(join(sessionsDir, `${sessionId}.json`), JSON.stringify(session, null, 2), "utf8");
+    await writeFile(join(metaDir, "state.json"), buildStateSeed(project, session, options.setup), "utf8");
+    await writeFile(join(projectPath, "LONGTABLE.md"), buildWorkspaceGuide(project, session), "utf8");
+    await writeFile(join(projectPath, "START-HERE.md"), buildStartHereGuide(project, session), "utf8");
+    await writeFile(join(projectPath, "AGENTS.md"), buildProjectAgentsMd(project, session), "utf8");
+    return {
+        project,
+        session,
+        projectFilePath,
+        sessionFilePath,
+        metaDir
+    };
+}
+export async function loadProjectContextFromDirectory(startPath) {
+    let current = resolve(startPath);
+    while (true) {
+        const metaDir = resolveMetaDir(current);
+        const projectFilePath = join(metaDir, "project.json");
+        const sessionFilePath = join(metaDir, "current-session.json");
+        if (existsSync(projectFilePath) && existsSync(sessionFilePath)) {
+            return {
+                project: JSON.parse(await readFile(projectFilePath, "utf8")),
+                session: JSON.parse(await readFile(sessionFilePath, "utf8")),
+                projectFilePath,
+                sessionFilePath,
+                metaDir
+            };
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function renderProjectWorkspaceSummary(context) {
+    return [
+        "┌──────────────────────────────────────────────┐",
+        "│ Long Table Project Workspace               │",
+        "└──────────────────────────────────────────────┘",
+        `Project: ${context.project.projectName}`,
+        `Path: ${context.project.projectPath}`,
+        `Goal: ${context.session.currentGoal}`,
+        ...(context.session.currentBlocker ? [`Blocker: ${context.session.currentBlocker}`] : []),
+        `Perspectives: ${context.session.requestedPerspectives.length > 0 ? context.session.requestedPerspectives.join(", ") : "auto"}`,
+        `Disagreement: ${context.session.disagreementPreference}`,
+        "",
+        "Created files:",
+        `- ${context.projectFilePath}`,
+        `- ${context.sessionFilePath}`,
+        `- ${join(context.project.projectPath, "START-HERE.md")}`,
+        `- ${join(context.project.projectPath, "AGENTS.md")}`
+    ].join("\n");
+}

package/dist/prompt-aliases.js

@@ -33,12 +33,13 @@ function promptSpec() {
                 "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.",
-                "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.",
+                "Quickstart covers: provider, field, career stage, experience level, checkpoint intensity, and human authorship signal.",
+                "Interview also covers: 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, preferredCheckpointIntensity, and optional humanAuthorshipSignal, 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.",
+                "Do not pretend that this is the full project-start interview. The real project-start interview happens in `longtable start`.",
                 "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.3",
+  "version": "0.1.5",
   "private": false,
   "description": "Researcher-facing Long Table CLI on top of the legacy Diverga package surface",
   "type": "module",
@@ -25,8 +25,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
+    "@diverga/memory": "0.1.0",
     "@diverga/provider-codex": "0.1.1",
-    "@diverga/setup": "0.1.3"
+    "@diverga/setup": "0.1.4"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",