@felixdotgo/aidlc-kit 0.1.0 → 0.2.0

package/dist/src/state.d.ts

@@ -1,117 +1,20 @@
-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 readyTaskItems: (task: TaskState) => {
-    ready: string[];
-    blocked: Array<{
-        id: string;
-        waitingOn: 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;
+/**
+ * Facade for the lifecycle-state domain. Behavior-preserving re-export of the
+ * split modules under `src/state/`; import paths from outside remain unchanged.
+ */
+export { stampLegacyG2Waits, prepareV4Migration, migrateState } from "./state/migrate.js";
+export { taskRecordContent, archivedSummary } from "./state/archive-record.js";
+export { emptyState, legacyG2WaitSource, phases, gates, handoffKinds, terminal, phaseGate, digest } from "./state/domain.js";
+export { iso, text, idPattern, audited, tokens, assertTaskArtifactPath } from "./state/guards.js";
+export { assertNoSymlinkPath, writeAtomic, parseJsonText, parseJsonFile } from "./state/io.js";
+export { type NextAction, readyTaskItems, nextAction } from "./state/items.js";
+export { recordLesson, recordNoLessons, lessonStateDigest, createLessonIndex, rebuildLessonIndex, searchLessons } from "./state/lessons.js";
+export { handoffTask, closeTask, supersedeTask, reopenTask } from "./state/lifecycle.js";
+export { type StateLockOptions, acquireStateLock } from "./state/lock.js";
+export { emptyMemoryRegistry, validateMemoryRegistry, loadMemoryRegistry, saveMemoryRegistry, selectAgenticMemory, promoteAgenticMemory, retireAgenticMemory } from "./state/memory.js";
+export { statePath, lessonIndexPath, memoryRegistryPath, stateLockPath, stateLockGuardPath, archiveRecordPath } from "./state/paths.js";
+export { type TaskSummary, listTaskSummaries, renderWorkplan, renderViews } from "./state/render.js";
+export { pathOverlaps, pathsOverlap, concurrentItemPairs, partitionDiagnostics, loopPartitionStrict, workplanScope } from "./state/partition.js";
+export { loadState, loadTask, saveState } from "./state/store.js";
+export { latestApproval, buildBoundary, hasApproval, hasCurrentBuildApproval, hasAreaVerification, hasVerification, hasReview, type RepairBounds, repairBounds, isLegacyG2Wait, transitionDiagnostics, transitionTask } from "./state/transitions.js";
+export { validateLesson, validateTask, validateState } from "./state/validate.js";