@ornexus/neocortex 4.60.71 → 4.60.73

package/packages/client/dist/git/epic-operational-state.d.ts

@@ -0,0 +1,198 @@
+import type { YoloopPersistedCounters, YoloopPersistedLock, YoloopPersistenceCapability, YoloopStateOperation } from '../yoloop/shared-yoloop-types.js';
+import { type GitLifecycleRuntimeDocument } from './git-lifecycle-store.js';
+export declare const EPIC_OPERATIONAL_SOURCE_LIMIT_BYTES: number;
+export declare const EPIC_OPERATIONAL_PAYLOAD_LIMIT_BYTES: number;
+export declare const EPIC_OPERATIONAL_RECEIPT_CAP = 64;
+export declare const EPIC_OPERATIONAL_IDENTITY_CAP = 2048;
+export type EpicOperationalJournalKind = 'backfill' | 'cross-epic-reconcile' | 'rollback';
+export type EpicOperationalJournalPhase = 'prepared' | 'authority-applied' | 'projections-applied' | 'committed' | 'aborted-before-authority';
+export interface EpicOperationalIdentityV1 {
+    readonly schemaVersion: 'EpicOperationalIdentity/1.0';
+    readonly epicId: string;
+    readonly executionBranch: string;
+    readonly graphRevision: string;
+    readonly originBindingDigest: string;
+    readonly repositoryFingerprint: string;
+    readonly identityHash: string;
+}
+export interface CommonYoloopAuthorityV1 {
+    readonly schemaVersion: 'CommonYoloopAuthority/1.0';
+    readonly lock: YoloopPersistedLock | null;
+    readonly state: YoloopPersistedCounters;
+    readonly capabilities: readonly YoloopPersistenceCapability[];
+}
+export interface EpicOperationalProjectionBindingV1 {
+    readonly status: 'bound' | 'unbound' | 'unavailable';
+    readonly sourceDigest: string | null;
+    readonly authorityRevision: number;
+    readonly reasonCodes: readonly string[];
+}
+export interface EpicOperationalProjectionBindingsV1 {
+    readonly schemaVersion: 'EpicOperationalProjectionBindings/1.0';
+    readonly trackedState: EpicOperationalProjectionBindingV1;
+    readonly sqlite: EpicOperationalProjectionBindingV1;
+}
+export interface EpicOperationalJournalV1 {
+    readonly schemaVersion: 'EpicOperationalJournal/1.0';
+    readonly kind: EpicOperationalJournalKind;
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly payloadHash: string;
+    readonly identityHash: string;
+    readonly expectedRevision: number;
+    readonly expectedWriterEpoch: number;
+    readonly preimageDigest: string;
+    readonly backupManifestRef: string;
+    readonly phase: EpicOperationalJournalPhase;
+    readonly projectionStatuses: {
+        readonly trackedState: 'pending' | 'applied' | 'not-applicable';
+        readonly sqlite: 'pending' | 'applied' | 'unavailable' | 'not-applicable';
+    };
+    readonly reasonCodes: readonly string[];
+}
+export interface YoloopCrossEpicReconciliationReceiptV1 {
+    readonly schemaVersion: 'YoloopCrossEpicReconciliationReceipt/1.0';
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly payloadHash: string;
+    readonly sourceEpicId: string;
+    readonly sourceGraphRevision: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly runId: string;
+    readonly previousSessionHash: string;
+    readonly nextSessionHash: string;
+    readonly retiredAuthorityHash: string;
+    readonly retiredAuthorityCount: 0 | 1;
+    readonly outcome: 'cross-epic-reconciled';
+    readonly publicSafe: true;
+}
+export interface EpicLifecycleBackfillReceiptV1 {
+    readonly schemaVersion: 'EpicLifecycleBackfillReceipt/1.0';
+    readonly operationId: string;
+    readonly idempotencyKey: string;
+    readonly payloadHash: string;
+    readonly planDigest: string;
+    readonly sourceInventoryDigest: string;
+    readonly preimageDigest: string;
+    readonly postimageDigest: string;
+    readonly authorityPostimageDigest: string;
+    readonly backupManifestDigest: string;
+    readonly identityHash: string;
+    readonly appliedRevision: number;
+    readonly writerEpoch: number;
+    readonly stateMigrationOperationId: string | null;
+    readonly outcome: 'applied' | 'already-applied';
+    readonly reasonCodes: readonly string[];
+    readonly publicSafe: true;
+}
+export interface EpicOperationalRollbackReceiptV1 {
+    readonly schemaVersion: 'EpicOperationalRollbackReceipt/1.0';
+    readonly operationId: string;
+    readonly targetOperationId: string;
+    readonly expectedPostimageDigest: string;
+    readonly restoredPreimageDigest: string;
+    readonly reasonCodes: readonly string[];
+    readonly publicSafe: true;
+}
+export interface EpicOperationalStateV1 {
+    readonly schemaVersion: 'EpicOperationalState/1.0';
+    readonly repositoryFingerprint: string;
+    readonly writerEpoch: number;
+    readonly capabilities: readonly ('epic-operational-state-v1' | 'epic-lifecycle-backfill-v1')[];
+    readonly identities: Readonly<Record<string, EpicOperationalIdentityV1>>;
+    readonly yoloop: CommonYoloopAuthorityV1;
+    readonly projectionBindings: EpicOperationalProjectionBindingsV1;
+    readonly activeJournal: EpicOperationalJournalV1 | null;
+    readonly backfillReceipts: readonly EpicLifecycleBackfillReceiptV1[];
+    readonly reconciliationReceipts: readonly YoloopCrossEpicReconciliationReceiptV1[];
+    readonly rollbackReceipts: readonly EpicOperationalRollbackReceiptV1[];
+}
+export interface EpicOperationalPublicProjectionV1 {
+    readonly schemaVersion: 'EpicOperationalPublicProjection/1.0';
+    readonly repositoryFingerprint: string;
+    readonly identityHash: string;
+    readonly epicId: string;
+    readonly executionBranch: string;
+    readonly graphRevision: string;
+    readonly storeRevision: number;
+    readonly writerEpoch: number;
+    readonly runId: string | null;
+    readonly runStatus: string | null;
+    readonly runRevision: number | null;
+    readonly snapshotHash: string | null;
+    readonly continuationSessionHash: string;
+    readonly pendingAuthorityHash: string;
+    readonly pendingAuthorityCount: number;
+    readonly lockActive: boolean;
+    readonly currentSessionActive: boolean;
+    readonly journalActive: boolean;
+    readonly reasonCodes: readonly string[];
+    readonly publicSafe: true;
+}
+export interface YoloopCrossEpicReconciliationEvidenceV1 extends Omit<EpicOperationalPublicProjectionV1, 'schemaVersion'> {
+    readonly schemaVersion: 'YoloopCrossEpicReconciliationEvidence/1.0';
+    readonly sourceEpicId: string;
+    readonly sourceGraphRevision: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly decision: 'eligible';
+}
+export type CrossEpicReconciliationDecisionV1 = {
+    readonly kind: 'eligible';
+    readonly evidence: YoloopCrossEpicReconciliationEvidenceV1;
+} | {
+    readonly kind: 'blocked';
+    readonly reasonCodes: readonly string[];
+} | {
+    readonly kind: 'not-applicable';
+    readonly reasonCodes: readonly string[];
+};
+export interface EpicOperationalMutationContext {
+    readonly identityHash: string;
+    readonly expectedRevision: number;
+    readonly expectedWriterEpoch: number;
+}
+export declare function epicOperationalCanonicalJson(value: unknown): string;
+export declare function epicOperationalHash(domain: string, value: unknown): string;
+export declare function deriveEpicOperationalRepositoryFingerprint(projectRoot: string): string;
+export declare function createEpicOperationalIdentity(projectRoot: string, input: {
+    readonly epicId: string;
+    readonly executionBranch: string;
+    readonly graphRevision: string;
+    readonly originBindingDigest: string;
+}): EpicOperationalIdentityV1;
+export declare function createInitialEpicOperationalState(input: {
+    readonly identity: EpicOperationalIdentityV1;
+    readonly yoloop: Omit<CommonYoloopAuthorityV1, 'schemaVersion'>;
+    readonly trackedStateDigest: string;
+    readonly sqliteStatus?: 'unbound' | 'unavailable';
+    readonly sqliteReasonCodes?: readonly string[];
+}): EpicOperationalStateV1;
+export declare function assertEpicOperationalState(value: unknown): asserts value is EpicOperationalStateV1;
+export declare function readEpicOperationalState(projectRoot: string, context?: Partial<EpicOperationalMutationContext>): {
+    readonly document: GitLifecycleRuntimeDocument;
+    readonly operational: EpicOperationalStateV1;
+};
+export declare function mutateEpicOperationalState<T>(projectRoot: string, context: EpicOperationalMutationContext, mutate: (state: EpicOperationalStateV1, document: GitLifecycleRuntimeDocument) => T): Promise<{
+    readonly document: GitLifecycleRuntimeDocument;
+    readonly value: T;
+}>;
+export declare function projectEpicOperationalState(document: GitLifecycleRuntimeDocument, identityHash: string): EpicOperationalPublicProjectionV1;
+export declare function classifyCrossEpicContinuationReconciliation(input: {
+    readonly document: GitLifecycleRuntimeDocument;
+    readonly targetIdentityHash: string;
+    readonly targetEpicId: string;
+    readonly targetGraphRevision: string;
+    readonly legacyActivity: 'inactive' | 'active' | 'unknown';
+}): CrossEpicReconciliationDecisionV1;
+export declare function buildCrossEpicContinuationPayloadHash(payload: Omit<Extract<YoloopStateOperation, {
+    readonly type: 'reconcile_cross_epic_continuation';
+}>, 'type' | 'payloadHash' | 'receipt'>): string;
+export declare function applyCrossEpicContinuationReconciliation(projectRoot: string, operation: Extract<YoloopStateOperation, {
+    readonly type: 'reconcile_cross_epic_continuation';
+}>): Promise<{
+    readonly applied: boolean;
+    readonly replay: boolean;
+    readonly receipt: YoloopCrossEpicReconciliationReceiptV1;
+}>;