@longtable/cli 0.1.30 → 0.1.31

package/dist/project-session.d.ts

@@ -1,6 +1,24 @@
 import type { DecisionRecord, InvocationRecord, ProviderKind, QuestionOption, QuestionSurface, QuestionRecord, ResearchState } from "@longtable/core";
 import type { SetupPersistedOutput } from "@longtable/setup";
 export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
+export type StartInterviewSignal = "phenomenon" | "audience" | "artifact" | "evidence" | "assumption" | "decision_risk" | "voice";
+export interface StartInterviewTurn {
+    index: number;
+    question: string;
+    answer: string;
+    signal: StartInterviewSignal;
+    purpose: string;
+}
+export interface StartInterviewSession {
+    mode: "adaptive";
+    openingStyle: "scene_problem";
+    createdAt: string;
+    completedAt: string;
+    turnCount: number;
+    turns: StartInterviewTurn[];
+    inferredSignals: StartInterviewSignal[];
+    summary: string;
+}
 export interface LongTableProjectRecord {
     schemaVersion: 1;
     product: "LongTable";
@@ -33,6 +51,7 @@ export interface LongTableSessionRecord {
     protectedDecision?: string;
     nextAction?: string;
     openQuestions?: string[];
+    startInterview?: StartInterviewSession;
     requestedPerspectives: string[];
     disagreementPreference: ProjectDisagreementPreference;
     activeModes?: string[];
@@ -159,6 +178,7 @@ export declare function createOrUpdateProjectWorkspace(options: {
     researchObject?: string;
     gapRisk?: string;
     protectedDecision?: string;
+    startInterview?: StartInterviewSession;
     requestedPerspectives: string[];
     disagreementPreference: ProjectDisagreementPreference;
     setup: SetupPersistedOutput;

package/dist/project-session.js

@@ -55,15 +55,21 @@ function resolveUserLocale() {
 }
 function buildFirstQuestion(session) {
     return session.currentBlocker
-        ? `What would reduce the uncertainty around "${session.currentBlocker}" first?`
-        : `What is the first concrete question that would move "${session.currentGoal}" forward?`;
+        ? `Where does "${session.currentBlocker}" show up most concretely in the scene, material, or evidence?`
+        : `What scene, case, text, data, or draft would make "${session.currentGoal}" easiest to inspect first?`;
 }
 function buildOpenQuestions(session) {
     const firstQuestion = buildFirstQuestion(session);
+    if (session.startInterview) {
+        return [
+            firstQuestion,
+            `What would a reader need to understand differently if "${session.currentGoal}" becomes a strong research project?`
+        ];
+    }
     return session.currentBlocker
         ? [
             firstQuestion,
-            `What evidence would let you decide whether "${session.currentBlocker}" is a knowledge gap, a coding rule gap, or a data gap?`
+            `What would a reader need to understand differently if "${session.currentBlocker}" becomes a strong research problem?`
         ]
         : [
             firstQuestion,
@@ -71,11 +77,21 @@ function buildOpenQuestions(session) {
         ];
 }
 function buildNextAction(session) {
+    if (session.startInterview) {
+        return session.currentBlocker
+            ? `Begin from the start-interview brief, then make "${session.currentBlocker}" concrete with one scene, source, case, or dataset.`
+            : "Begin from the start-interview brief, then choose one concrete scene, source, case, or dataset to inspect first.";
+    }
     return session.currentBlocker
-        ? `Open with the blocker, then ask LongTable to surface the first high-leverage uncertainty around "${session.currentBlocker}".`
+        ? `Open with the blocker, then make "${session.currentBlocker}" concrete with one scene, source, case, or dataset.`
         : "Open with your current goal in one sentence, then ask LongTable for the first concrete research move.";
 }
 function buildResumeHint(session) {
+    if (session.startInterview) {
+        return session.currentBlocker
+            ? `I want to continue from the LongTable start interview. The first unresolved issue is ${session.currentBlocker}.`
+            : `I want to continue from the LongTable start interview for ${session.currentGoal}.`;
+    }
     return session.currentBlocker
         ? `I want to continue ${session.currentGoal}. The unresolved blocker is ${session.currentBlocker}.`
         : `I want to continue ${session.currentGoal}.`;
@@ -102,6 +118,7 @@ function buildCurrentGuide(project, session, recentInvocations = [], pendingQues
             ...(session.researchObject ? [`- 연구 객체: ${session.researchObject}`] : []),
             ...(session.gapRisk ? [`- 공백/암묵지 위험: ${session.gapRisk}`] : []),
             ...(session.protectedDecision ? [`- 보호할 결정: ${session.protectedDecision}`] : []),
+            ...(session.startInterview ? [`- start interview: ${session.startInterview.summary}`] : []),
             `- 다음 액션: ${nextAction}`,
             `- 관점: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
             `- disagreement: ${session.disagreementPreference}`,
@@ -154,6 +171,7 @@ function buildCurrentGuide(project, session, recentInvocations = [], pendingQues
         ...(session.researchObject ? [`- Research object: ${session.researchObject}`] : []),
         ...(session.gapRisk ? [`- Gap/tacit risk: ${session.gapRisk}`] : []),
         ...(session.protectedDecision ? [`- Protected decision: ${session.protectedDecision}`] : []),
+        ...(session.startInterview ? [`- Start interview: ${session.startInterview.summary}`] : []),
         `- Next action: ${nextAction}`,
         `- Perspectives: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
         `- Disagreement: ${session.disagreementPreference}`,
@@ -344,6 +362,7 @@ function buildProjectAgentsMd(project, session) {
         ...(session.researchObject ? [`- Research object: ${session.researchObject}`] : []),
         ...(session.gapRisk ? [`- Gap/tacit risk: ${session.gapRisk}`] : []),
         ...(session.protectedDecision ? [`- Protected decision: ${session.protectedDecision}`] : []),
+        ...(session.startInterview ? [`- Start interview summary: ${session.startInterview.summary}`] : []),
         `- Requested perspectives: ${session.requestedPerspectives.length > 0 ? session.requestedPerspectives.join(", ") : "auto"}`,
         `- Disagreement visibility: ${session.disagreementPreference}`,
         "- These instructions apply to this directory and its children."
@@ -368,6 +387,7 @@ function buildStateSeed(project, session, setup) {
         ...(session.nextAction ? { nextAction: session.nextAction } : {}),
         openQuestions: session.openQuestions ?? [],
         activeModes: session.activeModes ?? [],
+        ...(session.startInterview ? { startInterview: session.startInterview } : {}),
         ...(session.resumeHint ? { resumeHint: session.resumeHint } : {})
     };
     if (session.currentBlocker) {
@@ -414,6 +434,25 @@ function buildStateSeed(project, session, setup) {
             importance: "high"
         });
     }
+    if (session.startInterview) {
+        state.narrativeTraces.push({
+            id: "project-session-start-interview",
+            timestamp: nowIso(),
+            source: "longtable-start",
+            traceType: "experience",
+            summary: session.startInterview.summary,
+            visibility: "explicit",
+            importance: "high"
+        });
+        if (session.startInterview.inferredSignals.length > 0) {
+            state.inferredHypotheses.push({
+                hypothesis: `Start interview suggests these early lenses: ${session.startInterview.inferredSignals.join(", ")}.`,
+                confidence: 0.65,
+                evidence: session.startInterview.turns.map((turn) => turn.answer).filter(Boolean),
+                status: "unconfirmed"
+            });
+        }
+    }
     return JSON.stringify(state, null, 2);
 }
 async function removeLegacyRootFiles(projectPath) {
@@ -1008,6 +1047,7 @@ export async function createOrUpdateProjectWorkspace(options) {
         ...(options.researchObject ? { researchObject: options.researchObject } : {}),
         ...(options.gapRisk ? { gapRisk: options.gapRisk } : {}),
         ...(options.protectedDecision ? { protectedDecision: options.protectedDecision } : {}),
+        ...(options.startInterview ? { startInterview: options.startInterview } : {}),
         nextAction: buildNextAction({
             schemaVersion: 1,
             id: sessionId,
@@ -1019,6 +1059,7 @@ export async function createOrUpdateProjectWorkspace(options) {
             ...(options.researchObject ? { researchObject: options.researchObject } : {}),
             ...(options.gapRisk ? { gapRisk: options.gapRisk } : {}),
             ...(options.protectedDecision ? { protectedDecision: options.protectedDecision } : {}),
+            ...(options.startInterview ? { startInterview: options.startInterview } : {}),
             requestedPerspectives: options.requestedPerspectives,
             disagreementPreference: options.disagreementPreference
         }),
@@ -1033,6 +1074,7 @@ export async function createOrUpdateProjectWorkspace(options) {
             ...(options.researchObject ? { researchObject: options.researchObject } : {}),
             ...(options.gapRisk ? { gapRisk: options.gapRisk } : {}),
             ...(options.protectedDecision ? { protectedDecision: options.protectedDecision } : {}),
+            ...(options.startInterview ? { startInterview: options.startInterview } : {}),
             requestedPerspectives: options.requestedPerspectives,
             disagreementPreference: options.disagreementPreference
         }),
@@ -1050,6 +1092,7 @@ export async function createOrUpdateProjectWorkspace(options) {
             ...(options.researchObject ? { researchObject: options.researchObject } : {}),
             ...(options.gapRisk ? { gapRisk: options.gapRisk } : {}),
             ...(options.protectedDecision ? { protectedDecision: options.protectedDecision } : {}),
+            ...(options.startInterview ? { startInterview: options.startInterview } : {}),
             requestedPerspectives: options.requestedPerspectives,
             disagreementPreference: options.disagreementPreference
         }),
@@ -1123,13 +1166,18 @@ export async function inspectProjectWorkspace(startPath) {
 }
 export function renderProjectWorkspaceSummary(context) {
     return [
-        "┌──────────────────────────────────────────────┐",
-        "│ LongTable Project Workspace               │",
-        "└──────────────────────────────────────────────┘",
+        "┌─ LongTable Project Workspace ─────────────────────────┐",
+        "└───────────────────────────────────────────────────────┘",
         `Project: ${context.project.projectName}`,
         `Path: ${context.project.projectPath}`,
+        "",
+        "┌─ Current Research Shape ──────────────────────────────┐",
         `Goal: ${context.session.currentGoal}`,
         ...(context.session.currentBlocker ? [`Blocker: ${context.session.currentBlocker}`] : []),
+        ...(context.session.researchObject ? [`Working object: ${context.session.researchObject}`] : []),
+        ...(context.session.startInterview ? [`Start interview: ${context.session.startInterview.summary}`] : []),
+        "└───────────────────────────────────────────────────────┘",
+        "",
         `Perspectives: ${context.session.requestedPerspectives.length > 0 ? context.session.requestedPerspectives.join(", ") : "auto"}`,
         `Disagreement: ${context.session.disagreementPreference}`,
         "",

package/dist/prompt-renderer.d.ts

@@ -0,0 +1,11 @@
+import type { SetupChoice } from "@longtable/setup";
+export interface PromptRenderer {
+    text(prompt: string, options?: {
+        required?: boolean;
+        placeholder?: string;
+    }): Promise<string | undefined>;
+    select(prompt: string, choices: SetupChoice[]): Promise<string>;
+    multiselect(prompt: string, choices: SetupChoice[]): Promise<string[]>;
+    note(message: string, title?: string): void;
+}
+export declare function createPromptRenderer(): PromptRenderer;

package/dist/prompt-renderer.js

@@ -0,0 +1,130 @@
+import { readFileSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { cancel, isCancel, multiselect, note, select, text } from "@clack/prompts";
+function isInteractiveTerminal() {
+    return Boolean(input.isTTY && output.isTTY);
+}
+function guardCancel(value) {
+    if (isCancel(value)) {
+        cancel("LongTable cancelled.");
+        throw new Error("LongTable cancelled.");
+    }
+    return value;
+}
+function renderChoices(choices) {
+    return choices
+        .map((choice, index) => `${index + 1}. ${choice.label} - ${choice.description}`)
+        .join("\n");
+}
+let fallbackReadline;
+let fallbackInputLines;
+function getFallbackReadline() {
+    fallbackReadline ??= createInterface({ input, output });
+    return fallbackReadline;
+}
+async function askLine(prompt) {
+    if (!input.isTTY) {
+        output.write(prompt);
+        fallbackInputLines ??= readFileSync(0, "utf8").split(/\r?\n/);
+        return fallbackInputLines.shift() ?? "";
+    }
+    return getFallbackReadline().question(prompt);
+}
+async function promptChoiceByNumber(prompt, choices) {
+    while (true) {
+        const answer = await askLine(`${prompt}\n${renderChoices(choices)}\nSelect one number: `);
+        const numeric = Number(answer.trim());
+        if (!Number.isInteger(numeric) || numeric < 1 || numeric > choices.length) {
+            console.log("Invalid selection. Enter one of the listed numbers.");
+            continue;
+        }
+        const choice = choices[numeric - 1];
+        if (choice.fallbackToText) {
+            const freeText = await askLine("Type your custom value: ");
+            if (!freeText.trim()) {
+                console.log("Custom value cannot be empty.");
+                continue;
+            }
+            return freeText.trim();
+        }
+        return choice.id;
+    }
+}
+async function promptTextLine(prompt, required) {
+    while (true) {
+        const answer = (await askLine(`${prompt}\n> `)).trim();
+        if (!required) {
+            return answer || undefined;
+        }
+        if (answer) {
+            return answer;
+        }
+        console.log("This answer cannot be empty.");
+    }
+}
+export function createPromptRenderer() {
+    return {
+        async text(prompt, options) {
+            const required = options?.required ?? false;
+            if (!isInteractiveTerminal()) {
+                return promptTextLine(prompt, required);
+            }
+            return guardCancel(await text({
+                message: prompt,
+                placeholder: options?.placeholder,
+                validate: required
+                    ? (value) => value?.trim() ? undefined : "This answer cannot be empty."
+                    : undefined
+            }))?.trim() || undefined;
+        },
+        async select(prompt, choices) {
+            if (!isInteractiveTerminal()) {
+                return promptChoiceByNumber(prompt, choices);
+            }
+            const selected = guardCancel(await select({
+                message: prompt,
+                options: choices.map((choice) => ({
+                    value: choice.id,
+                    label: choice.label,
+                    hint: choice.description
+                })),
+                maxItems: 7
+            }));
+            const choice = choices.find((candidate) => candidate.id === selected);
+            if (choice?.fallbackToText) {
+                return guardCancel(await text({
+                    message: "Type your custom value",
+                    validate: (value) => value?.trim() ? undefined : "This answer cannot be empty."
+                })).trim();
+            }
+            return selected;
+        },
+        async multiselect(prompt, choices) {
+            if (!isInteractiveTerminal()) {
+                const answer = await askLine(`${prompt}\nType comma-separated ids or leave blank for auto.\n> `);
+                return answer
+                    .split(",")
+                    .map((part) => part.trim())
+                    .filter(Boolean);
+            }
+            return guardCancel(await multiselect({
+                message: prompt,
+                options: choices.map((choice) => ({
+                    value: choice.id,
+                    label: choice.label,
+                    hint: choice.description
+                })),
+                required: false,
+                maxItems: 7
+            }));
+        },
+        note(message, title) {
+            if (isInteractiveTerminal()) {
+                note(message, title);
+                return;
+            }
+            console.log(title ? `${title}\n${message}` : message);
+        }
+    };
+}

package/dist/search/publisher-access.js

@@ -151,7 +151,7 @@ export async function discoverCrossrefTdm(doi, env = process.env, httpFetch = de
     const response = await httpFetch(url, {
         headers: {
             accept: "application/json",
-            "user-agent": "LongTable/0.1.30 (https://github.com/HosungYou/LongTable)"
+            "user-agent": "LongTable/0.1.31 (https://github.com/HosungYou/LongTable)"
         }
     });
     if (!response.ok) {

package/dist/search/sources.js

@@ -155,7 +155,7 @@ async function fetchJson(context, url) {
     const response = await context.fetch(url, {
         headers: {
             "accept": "application/json",
-            "user-agent": "LongTable/0.1.30 (https://github.com/HosungYou/LongTable)"
+            "user-agent": "LongTable/0.1.31 (https://github.com/HosungYou/LongTable)"
         }
     });
     if (!response.ok) {
@@ -167,7 +167,7 @@ async function fetchText(context, url) {
     const response = await context.fetch(url, {
         headers: {
             "accept": "application/xml, text/xml, application/atom+xml, text/plain",
-            "user-agent": "LongTable/0.1.30 (https://github.com/HosungYou/LongTable)"
+            "user-agent": "LongTable/0.1.31 (https://github.com/HosungYou/LongTable)"
         }
     });
     if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -28,12 +28,13 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@longtable/checkpoints": "0.1.30",
-    "@longtable/core": "0.1.30",
-    "@longtable/memory": "0.1.30",
-    "@longtable/provider-claude": "0.1.30",
-    "@longtable/provider-codex": "0.1.30",
-    "@longtable/setup": "0.1.30"
+    "@clack/prompts": "^1.2.0",
+    "@longtable/checkpoints": "0.1.31",
+    "@longtable/core": "0.1.31",
+    "@longtable/memory": "0.1.31",
+    "@longtable/provider-claude": "0.1.31",
+    "@longtable/provider-codex": "0.1.31",
+    "@longtable/setup": "0.1.31"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",