@longtable/cli 0.1.4 → 0.1.6

package/README.md

@@ -53,6 +53,7 @@ longtable start
 - 프로젝트 디렉토리 생성
 - `.longtable/` 메모리 파일 생성
 - 프로젝트용 `AGENTS.md` 생성
+- `START-HERE.md` 생성
 
 을 수행합니다.
 
@@ -71,6 +72,16 @@ codex
 
 프로젝트 디렉토리 안에서는 보통 그냥 `codex`를 열고 자연어로 연구를 시작하면 됩니다.
 
+Codex 안에서 더 명시적으로 부르고 싶다면, 아래처럼 짧은 문법도 사용할 수 있습니다.
+
+```text
+lt explore: 연구 질문을 어디서부터 좁혀야 할지 모르겠어.
+lt review: 이 주장 어디가 약한지 봐줘.
+lt panel: 이 방향에 대한 의견 충돌도 같이 보여줘.
+lt editor: BJET 편집자 관점에서 봐줘.
+lt methods: 방법론적으로 어디가 취약한지 말해줘.
+```
+
 CLI를 계속 쓰고 싶다면 아래 명령은 보조 경로입니다.
 
 ## Advanced commands

package/dist/cli.js

@@ -7,7 +7,7 @@ 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 { buildPersonaGuidance, parseInvocationDirective } from "./persona-router.js";
 import { PERSONA_DEFINITIONS } from "./personas.js";
 import { createOrUpdateProjectWorkspace, loadProjectContextFromDirectory, renderProjectWorkspaceSummary } from "./project-session.js";
 const VALID_MODES = new Set([
@@ -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()) ||
@@ -790,7 +803,9 @@ async function runAsk(args) {
     if (!prompt) {
         throw new Error("A prompt is required.");
     }
-    const inferred = inferModeFromPrompt(prompt);
+    const directive = parseInvocationDirective(prompt);
+    const effectivePrompt = directive.cleanedPrompt;
+    const inferred = directive.mode ?? inferModeFromPrompt(effectivePrompt);
     if (inferred === "status") {
         await runCodexSubcommand("status", args);
         return;
@@ -798,9 +813,12 @@ async function runAsk(args) {
     const mode = inferred === "panel" ? "review" : inferred;
     const delegatedArgs = {
         ...args,
-        prompt
+        prompt: effectivePrompt
     };
-    if (inferred === "panel" && delegatedArgs.panel !== true) {
+    if (directive.roles.length > 0 && typeof delegatedArgs.role !== "string") {
+        delegatedArgs.role = directive.roles.join(",");
+    }
+    if ((inferred === "panel" || directive.panel) && delegatedArgs.panel !== true) {
         delegatedArgs.panel = true;
         delegatedArgs["show-conflicts"] = true;
     }
@@ -855,11 +873,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/persona-router.d.ts

@@ -8,8 +8,17 @@ export interface PersonaRoutingResult {
     consultedRoles: CanonicalPersona[];
     ambiguousSignal: string | null;
 }
+export interface LongTableInvocationDirective {
+    explicit: boolean;
+    cleanedPrompt: string;
+    mode?: InteractionMode | "panel" | "status";
+    roles: CanonicalPersona[];
+    panel: boolean;
+    showConflicts: boolean;
+}
 export declare function detectOutputLanguage(input: string): OutputLanguage;
 export declare function parseRoleFlag(value?: string): CanonicalPersona[];
+export declare function parseInvocationDirective(prompt: string): LongTableInvocationDirective;
 export declare function routePersonas(prompt: string, explicitRoleFlag?: string): PersonaRoutingResult;
 export declare function renderDisclosure(roles: CanonicalPersona[], language: OutputLanguage): string | null;
 export declare function buildPersonaGuidance(options: {

package/dist/persona-router.js

@@ -1,5 +1,24 @@
 import { getPersonaDefinition, parsePersonaKey, PERSONA_DEFINITIONS } from "./personas.js";
 const AUTO_CALL_LIMIT = 3;
+const INVOCATION_PREFIX = /^(?:lt|longtable|long table|롱테이블)\s+/i;
+const DIRECTIVE_MAP = [
+    { key: "explore", mode: "explore" },
+    { key: "review", mode: "review" },
+    { key: "critique", mode: "critique" },
+    { key: "draft", mode: "draft" },
+    { key: "commit", mode: "commit" },
+    { key: "panel", mode: "panel", panel: true, showConflicts: true },
+    { key: "status", mode: "status" },
+    { key: "editor", mode: "review", roles: ["editor"] },
+    { key: "reviewer", mode: "review", roles: ["reviewer"] },
+    { key: "methods", mode: "review", roles: ["methods_critic"] },
+    { key: "method", mode: "review", roles: ["methods_critic"] },
+    { key: "theory", mode: "review", roles: ["theory_critic"] },
+    { key: "measurement", mode: "review", roles: ["measurement_auditor"] },
+    { key: "ethics", mode: "review", roles: ["ethics_reviewer"] },
+    { key: "voice", mode: "review", roles: ["voice_keeper"] },
+    { key: "venue", mode: "review", roles: ["venue_strategist"] }
+];
 function unique(items) {
     return [...new Set(items)];
 }
@@ -15,6 +34,49 @@ export function parseRoleFlag(value) {
         .map((part) => parsePersonaKey(part))
         .filter((part) => part !== null));
 }
+export function parseInvocationDirective(prompt) {
+    const trimmed = prompt.trim();
+    if (!INVOCATION_PREFIX.test(trimmed)) {
+        return {
+            explicit: false,
+            cleanedPrompt: prompt,
+            roles: [],
+            panel: false,
+            showConflicts: false
+        };
+    }
+    const withoutPrefix = trimmed.replace(INVOCATION_PREFIX, "");
+    const colonIndex = withoutPrefix.indexOf(":");
+    if (colonIndex === -1) {
+        return {
+            explicit: false,
+            cleanedPrompt: prompt,
+            roles: [],
+            panel: false,
+            showConflicts: false
+        };
+    }
+    const directiveKey = withoutPrefix.slice(0, colonIndex).trim().toLowerCase();
+    const body = withoutPrefix.slice(colonIndex + 1).trim();
+    const directive = DIRECTIVE_MAP.find((entry) => entry.key === directiveKey);
+    if (!directive) {
+        return {
+            explicit: false,
+            cleanedPrompt: body || prompt,
+            roles: [],
+            panel: false,
+            showConflicts: false
+        };
+    }
+    return {
+        explicit: true,
+        cleanedPrompt: body || prompt,
+        mode: directive.mode,
+        roles: directive.roles ?? [],
+        panel: directive.panel === true,
+        showConflicts: directive.showConflicts === true
+    };
+}
 export function routePersonas(prompt, explicitRoleFlag) {
     const normalizedPrompt = prompt.toLowerCase();
     const explicitRoles = parseRoleFlag(explicitRoleFlag);
@@ -60,7 +122,10 @@ export function renderDisclosure(roles, language) {
         : `Long Table consulted: ${labels.join(", ")}`;
 }
 export function buildPersonaGuidance(options) {
-    const routing = routePersonas(options.prompt, options.roleFlag);
+    const directive = parseInvocationDirective(options.prompt);
+    const effectivePrompt = directive.cleanedPrompt;
+    const mergedRoleFlag = [options.roleFlag, directive.roles.join(",")].filter(Boolean).join(",");
+    const routing = routePersonas(effectivePrompt, mergedRoleFlag || undefined);
     const disclosure = renderDisclosure(routing.consultedRoles, routing.outputLanguage);
     const lines = [];
     lines.push(routing.outputLanguage === "ko"
@@ -74,12 +139,12 @@ export function buildPersonaGuidance(options) {
             ? "Ambiguity note: 편집자 관점인지 리뷰어 관점인지 애매합니다. 먼저 둘 중 무엇을 우선할지 짧게 확인하세요."
             : "Ambiguity note: it is unclear whether the user wants an editor view or reviewer view. Ask briefly before closing.");
     }
-    if (options.panel) {
+    if (options.panel || directive.panel) {
         lines.push(routing.outputLanguage === "ko"
             ? "Return format: 1) Long Table synthesis 2) panel opinions by role 3) decision prompt to the researcher."
             : "Return format: 1) Long Table synthesis 2) panel opinions by role 3) decision prompt to the researcher.");
     }
-    if (options.showConflicts) {
+    if (options.showConflicts || directive.showConflicts) {
         lines.push(routing.outputLanguage === "ko"
             ? "If roles disagree, show the conflict explicitly instead of forcing one answer."
             : "If roles disagree, show the conflict explicitly instead of forcing one answer.");
@@ -92,7 +157,7 @@ export function buildPersonaGuidance(options) {
     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());
+    lines.push(effectivePrompt.trim());
     return {
         guidedPrompt: lines.join("\n\n"),
         routing

package/dist/project-session.js

@@ -42,6 +42,46 @@ 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}."`,
+        "",
+        "## Explicit Long Table invocation inside Codex",
+        "- `lt explore: <question>`",
+        "- `lt review: <claim or plan>`",
+        "- `lt panel: <claim or plan>`",
+        "- `lt editor: <draft or positioning question>`",
+        "- `lt reviewer: <claim or section>`",
+        "- `lt methods: <design, measure, or analysis plan>`",
+        "- `lt commit: <decision that needs commitment>`",
+        "",
+        "## 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",
@@ -57,15 +97,23 @@ function buildProjectAgentsMd(project, session) {
         "",
         "## Research-facing behavior",
         "- Treat researcher interaction as the primary task.",
+        "- If the user message starts with `lt `, `longtable `, `long table `, or `롱테이블 ` followed by a directive and `:`, treat it as an explicit Long Table invocation.",
+        "- Supported explicit directives are: explore, review, critique, draft, commit, panel, status, editor, reviewer, methods, theory, measurement, ethics, voice, venue.",
+        "- For explicit Long Table invocations, do not begin by scanning the workspace. Use the current session files first and answer as Long Table immediately.",
+        "- For general research requests in this workspace, prefer Long Table behavior before generic coding behavior.",
         "- 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.",
+        "- Do not recursively search unrelated files unless the researcher explicitly asks for file analysis or code changes.",
         "",
         "## Scope",
         "- These instructions apply to this directory and its children."
@@ -161,6 +209,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 +243,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.6",
   "private": false,
   "description": "Researcher-facing Long Table CLI on top of the legacy Diverga package surface",
   "type": "module",