@longtable/cli 0.1.4 → 0.1.5

package/README.md

@@ -53,6 +53,7 @@ longtable start
 - 프로젝트 디렉토리 생성
 - `.longtable/` 메모리 파일 생성
 - 프로젝트용 `AGENTS.md` 생성
+- `START-HERE.md` 생성
 
 을 수행합니다.
 

package/dist/cli.js

@@ -27,6 +27,24 @@ 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:",
@@ -122,15 +140,10 @@ function renderSetupHeader(flow) {
     const subtitle = flow === "interview"
         ? "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") {
@@ -154,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");
@@ -450,10 +463,10 @@ async function collectProjectInterview(setup, args) {
     try {
         if (needsInteractivePrompts) {
             console.log("");
-            console.log("┌──────────────────────────────────────────────┐");
-            console.log("│ Long Table Project Start                    │");
-            console.log("└──────────────────────────────────────────────┘");
-            console.log("We will create a project workspace and a session memory seed for today's work.");
+            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()) ||
@@ -855,11 +868,15 @@ async function runStart(args) {
     }
     console.log(renderProjectWorkspaceSummary(context));
     console.log("");
-    console.log("Next step:");
-    console.log(`- cd "${context.project.projectPath}"`);
-    console.log("- start Codex in that directory if you want a plain Codex session that inherits Long Table project instructions");
-    console.log(`- or run: longtable ask --cwd "${context.project.projectPath}" --prompt "${context.session.currentGoal.replaceAll("\"", "\\\"")}"`);
-    console.log("- the workspace now includes `.longtable/` memory files and a project-scoped `AGENTS.md`");
+    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.js

@@ -42,6 +42,37 @@ function buildWorkspaceGuide(project, session) {
     ];
     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",
@@ -60,6 +91,9 @@ function buildProjectAgentsMd(project, session) {
         "- 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",
@@ -161,6 +195,7 @@ export async function createOrUpdateProjectWorkspace(options) {
     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,
@@ -194,14 +229,20 @@ export async function loadProjectContextFromDirectory(startPath) {
 }
 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}`,
-        `project file: ${context.projectFilePath}`,
-        `session file: ${context.sessionFilePath}`
+        "┌──────────────────────────────────────────────┐",
+        "│ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "description": "Researcher-facing Long Table CLI on top of the legacy Diverga package surface",
   "type": "module",