@longtable/cli 0.1.5 → 0.1.6

package/README.md

@@ -72,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([
@@ -803,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;
@@ -811,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;
     }

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

@@ -60,6 +60,15 @@ function buildStartHereGuide(project, session) {
             ? `"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}`] : []),
@@ -88,6 +97,10 @@ 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.",
@@ -100,6 +113,7 @@ function buildProjectAgentsMd(project, session) {
         "- 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."

package/package.json

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