@felixdotgo/aidlc-kit 0.0.1

package/dist/src/state.d.ts

@@ -0,0 +1,110 @@
+import type { AgenticMemoryEntry, AgenticMemoryRegistry, Diagnostic, Gate, HandoffKind, LessonIndex, LessonIndexEntry, LessonRecord, Phase, TaskState, WorkflowState } from "./model.js";
+export declare const statePath: (root: string) => string;
+export declare const lessonIndexPath: (root: string) => string;
+export declare const memoryRegistryPath: (root: string) => string;
+export declare const stateLockPath: (root: string) => string;
+export declare const emptyState: () => WorkflowState;
+export declare const legacyG2WaitSource = "schema-v4-migration";
+export declare const emptyMemoryRegistry: () => AgenticMemoryRegistry;
+export interface StateLockOptions {
+    timeoutMs?: number;
+    retryMs?: number;
+    staleMs?: number;
+}
+/** Serializes lifecycle script mutations across local Node.js processes. */
+export declare const acquireStateLock: (root: string, options?: StateLockOptions) => (() => void);
+export declare const validateMemoryRegistry: (value: unknown) => AgenticMemoryRegistry;
+export declare const loadMemoryRegistry: (root: string) => AgenticMemoryRegistry;
+export declare const saveMemoryRegistry: (root: string, registry: AgenticMemoryRegistry) => void;
+export declare const selectAgenticMemory: (registry: AgenticMemoryRegistry, areas: string[], phase: Exclude<Phase, "done">, maxChars: number) => AgenticMemoryEntry[];
+export declare const promoteAgenticMemory: (root: string, entry: AgenticMemoryEntry) => AgenticMemoryEntry;
+export declare const retireAgenticMemory: (root: string, id: string, reason: string, retiredBy: string, retiredAt?: string) => AgenticMemoryEntry;
+export declare const validateState: (value: unknown) => WorkflowState;
+/** Marks pre-existing ready G2 waits during migration; the marker is the only exemption from repair-bound enforcement. */
+export declare const stampLegacyG2Waits: (state: WorkflowState) => string[];
+export declare const prepareV4Migration: (value: WorkflowState) => {
+    state: WorkflowState;
+    records: Array<{
+        path: string;
+        content: string;
+    }>;
+    lessonIndex: LessonIndex;
+    stamped: string[];
+};
+export declare const migrateState: (root: string, state?: WorkflowState) => {
+    migrated: boolean;
+    archived: string[];
+    stamped: string[];
+};
+export declare const loadState: (root: string) => WorkflowState;
+export declare const loadTask: (root: string, id: string, state?: WorkflowState) => TaskState | undefined;
+export declare const saveState: (root: string, state: WorkflowState) => string[];
+export declare const latestApproval: (task: TaskState, gate: Gate) => import("./model.js").Evidence | undefined;
+export declare const buildBoundary: (task: TaskState) => number | undefined;
+export declare const hasApproval: (task: TaskState, gate: Gate) => boolean;
+export declare const hasCurrentBuildApproval: (task: TaskState, gate: Gate) => boolean;
+export declare const hasAreaVerification: (task: TaskState, area: string) => boolean;
+export declare const hasVerification: (task: TaskState) => boolean;
+export declare const hasReview: (task: TaskState) => boolean;
+export interface RepairBounds {
+    verifyFailures: Record<string, number>;
+    reviewFailures: number;
+    exhaustedAreas: string[];
+    verifyExhausted: boolean;
+    reviewExhausted: boolean;
+}
+export declare const repairBounds: (task: TaskState) => RepairBounds;
+/** True only for a migration-stamped legacy G2 wait that is still fully ready; the stamp is written exclusively by schema migration. */
+export declare const isLegacyG2Wait: (task: TaskState) => boolean;
+export declare const transitionDiagnostics: (task: TaskState, target: Phase) => Diagnostic[];
+export declare const transitionTask: (state: WorkflowState, id: string, target: Phase) => TaskState;
+export interface NextAction {
+    classification: "await_user" | "run_phase" | "blocked" | "terminal" | "complete";
+    phase: Phase;
+    gate: Gate;
+    command?: string;
+    outcome?: "closed" | "superseded";
+    successorTaskId?: string;
+    itemId?: string;
+    remainingItems?: number;
+    actions?: Array<{
+        id: "reopen_g1" | "create_successor" | "supersede" | "close" | "record_handoff" | "resume";
+        command: string;
+    }>;
+    reason: string;
+}
+export declare const nextAction: (task: TaskState, root?: string) => NextAction;
+export declare const handoffTask: (state: WorkflowState, id: string, kind: HandoffKind, reason: string, source: string, recordedAt?: string) => TaskState;
+export declare const closeTask: (state: WorkflowState, id: string, reason: string, source: string, recordedAt?: string) => TaskState;
+export declare const supersedeTask: (state: WorkflowState, id: string, successorId: string, reason: string, source: string, recordedAt?: string) => TaskState;
+export declare const reopenTask: (state: WorkflowState, id: string, target: "plan", reason: string, source: string, recordedAt?: string) => TaskState;
+export declare const recordLesson: (task: TaskState, lesson: Omit<LessonRecord, "taskId" | "recordedAt">, recordedAt?: string) => LessonRecord;
+export declare const recordNoLessons: (task: TaskState, reason: string, source: string, recordedAt?: string) => void;
+export declare const lessonStateDigest: (state: WorkflowState) => string;
+export declare const createLessonIndex: (lessons: LessonRecord[], sourceDigest?: string) => LessonIndex;
+export declare const rebuildLessonIndex: (root: string, state?: WorkflowState) => LessonIndex;
+export declare const searchLessons: (root: string, state: WorkflowState, query: string, areas?: string[], limit?: number) => LessonIndexEntry[];
+export interface TaskSummary {
+    id: string;
+    title: string;
+    phase: Phase;
+    gate: Gate;
+    status: TaskState["status"];
+    risk: TaskState["risk"];
+    areas: string[];
+    updatedAt: string;
+    source: "active" | "archive";
+}
+export declare const listTaskSummaries: (state: WorkflowState, options?: {
+    includeArchive?: boolean;
+    statuses?: string[];
+    query?: string;
+    limit?: number;
+    cursor?: number;
+}) => {
+    items: TaskSummary[];
+    nextCursor: string | null;
+    total: number;
+};
+export declare const renderWorkplan: (task: TaskState) => string;
+export declare const renderViews: (root: string, state?: WorkflowState, selected?: TaskState[]) => void;