@longtable/cli 0.1.47 → 0.1.49

package/dist/project-session.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionRecord, ResearchState } from "@longtable/core";
+import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, 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";
@@ -40,6 +40,9 @@ export interface ResearchSpecification {
     createdAt?: string;
     updatedAt?: string;
     sourceHookId?: string;
+    latestRevisionId?: string;
+    sourceEvidenceIds?: string[];
+    sectionEvidence?: Record<string, string[]>;
     researchDirection: {
         question?: string;
         purpose: string;
@@ -121,6 +124,10 @@ export type LongTableWorkspaceState = ResearchState & {
     hooks?: LongTableHookRun[];
     firstResearchShape?: FirstResearchShape;
     researchSpecification?: ResearchSpecification;
+    interviewTurns?: LongTableInterviewTurn[];
+    evidenceRecords?: EvidenceRecord[];
+    specPatches?: ResearchSpecificationPatch[];
+    specRevisions?: ResearchSpecificationRevision[];
 };
 export interface LongTableProjectRecord {
     schemaVersion: 1;
@@ -206,6 +213,10 @@ export interface LongTableWorkspaceInspection {
         pendingObligations: number;
         answeredQuestions: number;
         decisions: number;
+        interviewTurns?: number;
+        evidenceRecords?: number;
+        specPatches?: number;
+        specRevisions?: number;
     };
     recentInvocations?: Array<{
         id: string;
@@ -250,6 +261,25 @@ export interface LongTableWorkspaceInspection {
     }>;
 }
 export declare function loadWorkspaceState(context: LongTableProjectContext): Promise<LongTableWorkspaceState>;
+export declare function diffResearchSpecifications(before: ResearchSpecification | undefined, after: ResearchSpecification): ResearchSpecificationChange[];
+export declare function applyResearchSpecificationAuditUpdate(state: LongTableWorkspaceState, options: {
+    specification: ResearchSpecification;
+    timestamp: string;
+    source: ResearchSpecificationPatchSource;
+    title?: string;
+    rationale?: string;
+    sourceEvidenceIds?: string[];
+    patch?: ResearchSpecificationPatch;
+    questionRecordId?: string;
+    decisionRecordId?: string;
+    createDecisionRecord?: boolean;
+}): {
+    state: LongTableWorkspaceState;
+    specification: ResearchSpecification;
+    patch: ResearchSpecificationPatch;
+    revision: ResearchSpecificationRevision;
+    decision?: DecisionRecord;
+};
 export declare function syncCurrentWorkspaceView(context: LongTableProjectContext): Promise<string>;
 export declare function appendInvocationRecordToWorkspace(context: LongTableProjectContext, invocation: InvocationRecord, questions?: QuestionRecord[]): Promise<LongTableWorkspaceState>;
 export declare function beginLongTableInterview(options: {
@@ -298,6 +328,41 @@ export declare function summarizeLongTableResearchSpecification(options: {
     state: LongTableWorkspaceState;
     session: LongTableSessionRecord;
 }>;
+export declare function proposeResearchSpecificationPatch(options: {
+    context: LongTableProjectContext;
+    specification: ResearchSpecification;
+    source?: ResearchSpecificationPatchSource;
+    rationale?: string;
+    sourceEvidenceIds?: string[];
+}): Promise<{
+    patch: ResearchSpecificationPatch;
+    changes: ResearchSpecificationChange[];
+    state: LongTableWorkspaceState;
+}>;
+export declare function applyResearchSpecificationPatch(options: {
+    context: LongTableProjectContext;
+    patchId?: string;
+    specification?: ResearchSpecification;
+    source?: ResearchSpecificationPatchSource;
+    rationale?: string;
+    sourceEvidenceIds?: string[];
+    questionRecordId?: string;
+    decisionRecordId?: string;
+}): Promise<{
+    patch: ResearchSpecificationPatch;
+    revision: ResearchSpecificationRevision;
+    specification: ResearchSpecification;
+    state: LongTableWorkspaceState;
+    session: LongTableSessionRecord;
+    decision?: DecisionRecord;
+}>;
+export declare function readResearchSpecificationHistory(context: LongTableProjectContext): Promise<{
+    specification?: ResearchSpecification;
+    revisions: ResearchSpecificationRevision[];
+    patches: ResearchSpecificationPatch[];
+    evidenceRecords: EvidenceRecord[];
+}>;
+export declare function findUnincorporatedResearchEvidence(context: LongTableProjectContext): Promise<EvidenceRecord[]>;
 export declare function listBlockingWorkspaceQuestions(context: LongTableProjectContext): Promise<QuestionRecord[]>;
 export declare function listBlockingWorkspaceObligations(context: LongTableProjectContext): Promise<LongTableQuestionObligation[]>;
 export declare function assertWorkspaceNotBlocked(context: LongTableProjectContext): Promise<void>;