@longtable/cli 0.1.31 → 0.1.33

package/dist/project-session.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, InvocationRecord, ProviderKind, QuestionOption, QuestionSurface, QuestionRecord, ResearchState } from "@longtable/core";
+import type { DecisionRecord, InvocationRecord, LongTableQuestionObligation, 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";
@@ -19,6 +19,53 @@ export interface StartInterviewSession {
     inferredSignals: StartInterviewSignal[];
     summary: string;
 }
+export type InterviewTurnQuality = "thin" | "usable" | "rich";
+export type InterviewDepth = "gathering_context" | "forming_first_handle" | "ready_to_summarize";
+export interface FirstResearchShape {
+    handle: string;
+    currentGoal: string;
+    currentBlocker?: string;
+    researchObject?: string;
+    gapRisk?: string;
+    protectedDecision?: string;
+    openQuestions: string[];
+    nextAction: string;
+    confidence: "low" | "medium" | "high";
+    sourceHookId?: string;
+    confirmedAt?: string;
+}
+export interface LongTableInterviewTurn {
+    id: string;
+    index: number;
+    createdAt: string;
+    question: string;
+    answer: string;
+    reflection?: string;
+    quality: InterviewTurnQuality;
+    needsFollowUp: boolean;
+    followUpQuestion?: string;
+    rationale?: string[];
+}
+export interface LongTableHookRun {
+    id: string;
+    kind: "longtable_interview" | "quality_probe" | "checkpoint" | "panel_decision";
+    status: "pending" | "active" | "ready_to_confirm" | "confirmed" | "deferred" | "cancelled";
+    createdAt: string;
+    updatedAt: string;
+    targetOutcome?: "first_research_handle" | string;
+    depth?: InterviewDepth;
+    provider?: ProviderKind;
+    turns?: LongTableInterviewTurn[];
+    firstResearchShape?: FirstResearchShape;
+    qualityNotes?: string[];
+    rationale?: string[];
+    linkedQuestionRecordIds?: string[];
+    linkedDecisionRecordIds?: string[];
+}
+export type LongTableWorkspaceState = ResearchState & {
+    hooks?: LongTableHookRun[];
+    firstResearchShape?: FirstResearchShape;
+};
 export interface LongTableProjectRecord {
     schemaVersion: 1;
     product: "LongTable";
@@ -52,6 +99,7 @@ export interface LongTableSessionRecord {
     nextAction?: string;
     openQuestions?: string[];
     startInterview?: StartInterviewSession;
+    firstResearchShape?: FirstResearchShape;
     requestedPerspectives: string[];
     disagreementPreference: ProjectDisagreementPreference;
     activeModes?: string[];
@@ -93,6 +141,7 @@ export interface LongTableWorkspaceInspection {
         invocations: number;
         questions: number;
         pendingQuestions: number;
+        pendingObligations: number;
         answeredQuestions: number;
         decisions: number;
     };
@@ -113,6 +162,13 @@ export interface LongTableWorkspaceInspection {
         options: string[];
         required: boolean;
     }>;
+    pendingObligations?: Array<{
+        id: string;
+        kind: string;
+        prompt: string;
+        reason: string;
+        questionId?: string;
+    }>;
     recentDecisions?: Array<{
         id: string;
         checkpointKey: string;
@@ -127,10 +183,45 @@ export interface LongTableWorkspaceInspection {
         suggestion?: string;
     }>;
 }
-export declare function loadWorkspaceState(context: LongTableProjectContext): Promise<ResearchState>;
+export declare function loadWorkspaceState(context: LongTableProjectContext): Promise<LongTableWorkspaceState>;
 export declare function syncCurrentWorkspaceView(context: LongTableProjectContext): Promise<string>;
-export declare function appendInvocationRecordToWorkspace(context: LongTableProjectContext, invocation: InvocationRecord, questions?: QuestionRecord[]): Promise<ResearchState>;
+export declare function appendInvocationRecordToWorkspace(context: LongTableProjectContext, invocation: InvocationRecord, questions?: QuestionRecord[]): Promise<LongTableWorkspaceState>;
+export declare function beginLongTableInterview(options: {
+    context: LongTableProjectContext;
+    provider?: ProviderKind;
+    openingQuestion?: string;
+    seedAnswer?: string;
+}): Promise<{
+    hook: LongTableHookRun;
+    state: LongTableWorkspaceState;
+}>;
+export declare function appendLongTableInterviewTurn(options: {
+    context: LongTableProjectContext;
+    hookId?: string;
+    question: string;
+    answer: string;
+    reflection?: string;
+    quality?: InterviewTurnQuality;
+    needsFollowUp?: boolean;
+    followUpQuestion?: string;
+    rationale?: string[];
+}): Promise<{
+    hook: LongTableHookRun;
+    turn: NonNullable<LongTableHookRun["turns"]>[number];
+    state: LongTableWorkspaceState;
+}>;
+export declare function summarizeLongTableInterview(options: {
+    context: LongTableProjectContext;
+    hookId?: string;
+    shape: FirstResearchShape;
+}): Promise<{
+    hook: LongTableHookRun;
+    shape: FirstResearchShape;
+    state: LongTableWorkspaceState;
+    session: LongTableSessionRecord;
+}>;
 export declare function listBlockingWorkspaceQuestions(context: LongTableProjectContext): Promise<QuestionRecord[]>;
+export declare function listBlockingWorkspaceObligations(context: LongTableProjectContext): Promise<LongTableQuestionObligation[]>;
 export declare function assertWorkspaceNotBlocked(context: LongTableProjectContext): Promise<void>;
 export declare function createWorkspaceFollowUpQuestions(options: {
     context: LongTableProjectContext;
@@ -170,6 +261,20 @@ export declare function answerWorkspaceQuestion(options: {
     decision: DecisionRecord;
     state: ResearchState;
 }>;
+export declare function clearWorkspaceQuestion(options: {
+    context: LongTableProjectContext;
+    questionId: string;
+    reason: string;
+}): Promise<{
+    question: QuestionRecord;
+    state: ResearchState;
+}>;
+export declare function repairWorkspaceStateConsistency(options: {
+    context: LongTableProjectContext;
+}): Promise<{
+    state: ResearchState;
+    repaired: string[];
+}>;
 export declare function createOrUpdateProjectWorkspace(options: {
     projectName: string;
     projectPath: string;