@gitgov/core 2.6.0 → 2.7.1

package/dist/src/{index-Bhc341pf.d.ts → index-LULVRsCZ.d.ts}

@@ -125,6 +125,117 @@ interface IConfigManager {
     getStateBranch(): Promise<string>;
 }
 
+/**
+ * SessionManager Types
+ */
+/**
+ * Sync status for an actor's synchronization state.
+ */
+type SyncStatus = {
+    lastSyncPush?: string;
+    lastSyncPull?: string;
+    status?: 'synced' | 'pending' | 'pulling' | 'pushing' | 'conflict';
+    lastError?: string;
+};
+/**
+ * State for a specific actor on this machine.
+ */
+type ActorState = {
+    activeTaskId?: string | undefined;
+    activeCycleId?: string | undefined;
+    lastSync?: string;
+    syncStatus?: SyncStatus;
+    [key: string]: unknown;
+};
+/**
+ * GitGovernance Session State
+ * Based on session_state.md blueprint
+ */
+type GitGovSession = {
+    cloud?: {
+        sessionToken?: string;
+    };
+    lastSession?: {
+        actorId: string;
+        timestamp: string;
+    };
+    actorState?: Record<string, ActorState>;
+    syncPreferences?: {
+        pullScheduler?: {
+            enabled?: boolean;
+            pullIntervalSeconds?: number;
+            continueOnNetworkError?: boolean;
+            stopOnConflict?: boolean;
+        };
+        fileWatcher?: {
+            enabled?: boolean;
+            debounceMs?: number;
+            ignoredPatterns?: string[];
+        };
+    };
+};
+/**
+ * Sync preferences update payload
+ */
+type SyncPreferencesUpdate = {
+    pullScheduler?: Partial<{
+        enabled: boolean;
+        pullIntervalSeconds: number;
+        continueOnNetworkError: boolean;
+        stopOnConflict: boolean;
+    }>;
+    fileWatcher?: Partial<{
+        enabled: boolean;
+        debounceMs: number;
+        ignoredPatterns: string[];
+    }>;
+};
+/**
+ * ISessionManager interface
+ *
+ * Provides typed access to GitGovernance session state.
+ * Session state is ephemeral, machine-local, and NOT versioned in Git.
+ */
+interface ISessionManager {
+    /**
+     * Load GitGovernance session state
+     * [EARS-B9] Auto-detects actor from .key files if no session or no actorId exists
+     */
+    loadSession(): Promise<GitGovSession | null>;
+    /**
+     * [EARS-B9] Detect actor from .key files in .gitgov/actors/
+     */
+    detectActorFromKeyFiles(): Promise<string | null>;
+    /**
+     * Get actor state for a specific actor
+     */
+    getActorState(actorId: string): Promise<ActorState | null>;
+    /**
+     * Update actor state for a specific actor
+     */
+    updateActorState(actorId: string, state: Partial<ActorState>): Promise<void>;
+    /**
+     * Get cloud session token
+     */
+    getCloudSessionToken(): Promise<string | null>;
+    /**
+     * Get sync preferences from session
+     */
+    getSyncPreferences(): Promise<GitGovSession['syncPreferences'] | null>;
+    /**
+     * Update sync preferences in .session.json
+     * These are local machine preferences that override project defaults
+     */
+    updateSyncPreferences(preferences: SyncPreferencesUpdate): Promise<void>;
+    /**
+     * Get last session info (last human who interacted)
+     */
+    getLastSession(): Promise<{
+        actorId: string;
+        timestamp: string;
+    } | null>;
+}
+
 /**
  * ConfigStore Interface
  *
@@ -176,6 +287,74 @@ interface ConfigStore<R = void> {
     saveConfig(config: GitGovConfig): Promise<R>;
 }
 
+/**
+ * KeyProvider Interface
+ *
+ * Abstracts private key storage for Actor signing operations.
+ * Enables different backends: filesystem (development), environment variables (serverless),
+ * or cloud KMS (enterprise).
+ *
+ * @module key_provider
+ */
+/**
+ * Error codes for KeyProvider operations.
+ */
+type KeyProviderErrorCode = 'KEY_NOT_FOUND' | 'KEY_READ_ERROR' | 'KEY_WRITE_ERROR' | 'KEY_DELETE_ERROR' | 'INVALID_KEY_FORMAT' | 'INVALID_ACTOR_ID';
+/**
+ * Error thrown when key operations fail.
+ */
+declare class KeyProviderError extends Error {
+    readonly code: KeyProviderErrorCode;
+    readonly actorId?: string | undefined;
+    constructor(message: string, code: KeyProviderErrorCode, actorId?: string | undefined);
+}
+/**
+ * Interface for managing private key storage.
+ * Implementations handle the actual persistence mechanism.
+ *
+ * @example
+ * ```typescript
+ * // Filesystem backend (development)
+ * const provider = new FsKeyProvider({ keysDir: '.gitgov/keys' });
+ *
+ * // Environment backend (serverless)
+ * const provider = new EnvKeyProvider({ prefix: 'GITGOV_KEY_' });
+ *
+ * // Usage
+ * const privateKey = await provider.getPrivateKey('actor:human:alice');
+ * if (privateKey) {
+ *   const signature = signPayload(payload, privateKey, actorId, role);
+ * }
+ * ```
+ */
+interface KeyProvider {
+    /**
+     * Retrieves the private key for an actor.
+     * @param actorId - The actor's ID (e.g., 'actor:human:alice')
+     * @returns The base64-encoded private key, or null if not found
+     */
+    getPrivateKey(actorId: string): Promise<string | null>;
+    /**
+     * Stores a private key for an actor.
+     * @param actorId - The actor's ID
+     * @param privateKey - The base64-encoded private key
+     * @throws KeyProviderError if write fails
+     */
+    setPrivateKey(actorId: string, privateKey: string): Promise<void>;
+    /**
+     * Checks if a private key exists for an actor.
+     * @param actorId - The actor's ID
+     * @returns true if key exists, false otherwise
+     */
+    hasPrivateKey(actorId: string): Promise<boolean>;
+    /**
+     * Deletes the private key for an actor.
+     * @param actorId - The actor's ID
+     * @returns true if key was deleted, false if it didn't exist
+     */
+    deletePrivateKey(actorId: string): Promise<boolean>;
+}
+
 /**
  * Options for file listing.
  */
@@ -536,4 +715,4 @@ declare namespace index {
   export { index_BranchAlreadyExistsError as BranchAlreadyExistsError, index_BranchNotFoundError as BranchNotFoundError, type index_ChangedFile as ChangedFile, type index_CommitAuthor as CommitAuthor, type index_CommitInfo as CommitInfo, type index_ExecOptions as ExecOptions, type index_ExecResult as ExecResult, index_FileNotFoundError as FileNotFoundError, type index_GetCommitHistoryOptions as GetCommitHistoryOptions, index_GitCommandError as GitCommandError, index_GitError as GitError, type index_GitModuleDependencies as GitModuleDependencies, type index_IGitModule as IGitModule, index_MergeConflictError as MergeConflictError, index_RebaseConflictError as RebaseConflictError, index_RebaseNotInProgressError as RebaseNotInProgressError };
 }
 
-export { type AuditState as A, type ConfigStore as C, type ExecOptions as E, type FsFileListerOptions as F, type GitGovConfig as G, type IGitModule as I, type MemoryFileListerOptions as M, type SyncConfig as S, type GitModuleDependencies as a, type ExecResult as b, type ChangedFile as c, type GetCommitHistoryOptions as d, type CommitInfo as e, type CommitAuthor as f, type FileLister as g, type FileListOptions as h, type FileStats as i, type AuditStateUpdate as j, type IConfigManager as k, type SyncDefaults as l, index as m };
+export { type ActorState as A, type ConfigStore as C, type ExecOptions as E, type FsFileListerOptions as F, type GitGovConfig as G, type IGitModule as I, type KeyProvider as K, type MemoryFileListerOptions as M, type SyncPreferencesUpdate as S, type GitGovSession as a, type GitModuleDependencies as b, type ExecResult as c, type ChangedFile as d, type GetCommitHistoryOptions as e, type CommitInfo as f, type CommitAuthor as g, type FileLister as h, type FileListOptions as i, type FileStats as j, type ISessionManager as k, type SyncStatus as l, type AuditState as m, type AuditStateUpdate as n, type IConfigManager as o, type SyncConfig as p, type SyncDefaults as q, KeyProviderError as r, type KeyProviderErrorCode as s, index as t };

package/dist/src/index.d.ts

@@ -1,11 +1,11 @@
-import { A as ActorPayload, c as ActorRecord, d as AgentPayload, e as AgentRecord, C as ChangelogPayload, f as ChangelogRecord, g as CustomRecord, h as CyclePayload, i as CycleRecord, E as EmbeddedMetadataHeader, j as EmbeddedMetadataRecord, k as ExecutionPayload, l as ExecutionRecord, F as FeedbackPayload, m as FeedbackRecord, n as GitGovActorRecord, o as GitGovAgentRecord, p as GitGovChangelogRecord, q as GitGovCycleRecord, r as GitGovError, s as GitGovExecutionRecord, t as GitGovFeedbackRecord, G as GitGovRecord, u as GitGovRecordPayload, v as GitGovRecordType, w as GitGovTaskRecord, S as Signature, T as TaskPayload, x as TaskRecord, R as RecordStores, y as CollaborationMetrics, z as IRecordMetrics, B as ProductivityMetrics, D as RecordMetrics, H as RecordMetricsDependencies, J as SystemStatus, K as TaskHealthReport, L as ActivityEvent, M as ActorCreatedEvent, N as ActorRevokedEvent, O as AgentRegisteredEvent, Q as BaseEvent, U as ChangelogCreatedEvent, V as CycleCreatedEvent, W as CycleStatusChangedEvent, X as EventHandler, Y as EventMetadata, Z as EventSubscription, _ as ExecutionCreatedEvent, $ as FeedbackCreatedEvent, a0 as GitGovEvent, a1 as SystemDailyTickEvent, a2 as TaskCreatedEvent, a3 as TaskStatusChangedEvent, I as IRecordProjector, a4 as RecordProjectorDependencies, b as IndexData, a5 as IndexGenerationReport, a6 as IntegrityReport, a7 as AllRecords, a8 as DerivedStates, a9 as EnrichedTaskRecord, aa as DerivedStateSets, a as IRecordProjection, ab as IntegrityError, ac as IntegrityWarning, P as ProjectionContext } from './record_projection.types-B8AM7u8U.js';
-import { S as SessionManager, C as ConfigManager, z as EventBus, r as IEventStream, B as eventBus, D as publishEvent, G as subscribeToEvent, H as IIdentityAdapter, J as IdentityAdapter, K as IdentityAdapterDependencies, I as ILintModule, M as LintModuleDependencies, c as LintRecordContext, d as LintResult, L as LintOptions, a as LintReport$1, F as FixRecordOptions, b as FixReport, N as FixResult, O as LintSummary, Q as RecordEntry, R as RecordStores$1, V as ValidationContext$1, T as ValidatorType, U as IExecutionAdapter, W as ExecutionAdapterDependencies, E as EnvironmentValidation, e as IProjectInitializer, w as FsKeyProvider, x as FsKeyProviderOptions, y as FsFileLister, f as ISyncStateModule, X as AuditScope$1, A as AuditStateOptions, k as AuditStateReport, i as ConflictDiff, Y as ConflictFileDiff, Z as ConflictInfo, _ as ConflictType, $ as ExpectedFilesScope, j as IntegrityViolation, h as StateDeltaFile, g as SyncStateModuleDependencies, n as SyncStatePullOptions, o as SyncStatePullResult, l as SyncStatePushOptions, m as SyncStatePushResult, p as SyncStateResolveOptions, q as SyncStateResolveResult, a0 as AgentExecutionContext, a1 as AgentOutput, v as AgentResponse, t as AgentRunnerDependencies, a2 as AgentRunnerEvent, a3 as ApiEngine, a4 as AuthConfig, a5 as AuthType, a6 as CustomEngine, a7 as Engine, a8 as EngineType, a9 as IAgentLoader, s as IAgentRunner, aa as LocalEngine, ab as McpEngine, ac as ProtocolHandler, P as ProtocolHandlerRegistry, u as RunOptions, ad as RuntimeHandler, ae as RuntimeHandlerRegistry } from './agent_runner-pr7h-9cV.js';
-import { A as ActorState, G as GitGovSession, I as ISessionManager, a as SyncPreferencesUpdate, b as SyncStatus, K as KeyProvider, c as KeyProviderError, d as KeyProviderErrorCode } from './key_provider-jjWek3w1.js';
-import { A as AuditState, j as AuditStateUpdate, G as GitGovConfig, k as IConfigManager, S as SyncConfig, l as SyncDefaults, h as FileListOptions, g as FileLister, i as FileStats, F as FsFileListerOptions, M as MemoryFileListerOptions, I as IGitModule } from './index-Bhc341pf.js';
-export { C as ConfigStore, m as Git } from './index-Bhc341pf.js';
-import { E as EnvKeyProvider, a as EnvKeyProviderOptions, M as MockKeyProvider, b as MockKeyProviderOptions, c as MemoryFileLister } from './memory_file_lister-BIIcVXLw.js';
+import { A as ActorPayload, d as ActorRecord, e as AgentPayload, f as AgentRecord, C as ChangelogPayload, g as ChangelogRecord, h as CyclePayload, i as CycleRecord, E as EmbeddedMetadataHeader, j as EmbeddedMetadataRecord, k as ExecutionPayload, l as ExecutionRecord, F as FeedbackPayload, m as FeedbackRecord, n as GitGovActorRecord, o as GitGovAgentRecord, p as GitGovChangelogRecord, q as GitGovCycleRecord, r as GitGovError, s as GitGovExecutionRecord, t as GitGovFeedbackRecord, G as GitGovRecord, u as GitGovRecordPayload, v as GitGovRecordType, w as GitGovTaskRecord, S as Signature, T as TaskPayload, x as TaskRecord, D as DEFAULT_ID_ENCODER, I as IdEncoder, R as RecordStore, y as RecordStores, z as CollaborationMetrics, B as IRecordMetrics, H as ProductivityMetrics, J as RecordMetrics, K as RecordMetricsDependencies, L as SystemStatus, M as TaskHealthReport, N as ActivityEvent, O as ActorCreatedEvent, Q as ActorRevokedEvent, U as AgentRegisteredEvent, V as BaseEvent, W as ChangelogCreatedEvent, X as CycleCreatedEvent, Y as CycleStatusChangedEvent, Z as EventHandler, _ as EventMetadata, $ as EventSubscription, a0 as ExecutionCreatedEvent, a1 as FeedbackCreatedEvent, a2 as GitGovEvent, a3 as SystemDailyTickEvent, a4 as TaskCreatedEvent, a5 as TaskStatusChangedEvent, a as IRecordProjector, a6 as RecordProjectorDependencies, c as IndexData, a7 as IndexGenerationReport, a8 as IntegrityReport, a9 as AllRecords, aa as DerivedStates, ab as EnrichedTaskRecord, ac as DerivedStateSets, b as IRecordProjection, ad as IntegrityError, ae as IntegrityWarning, P as ProjectionContext } from './record_projection.types-D9NkQbL_.js';
+import { C as ConfigManager, E as EventBus, p as IEventStream, r as eventBus, s as publishEvent, t as subscribeToEvent, q as IIdentityAdapter, u as IdentityAdapterDependencies, I as ILintModule, v as LintModuleDependencies, c as LintRecordContext, d as LintResult, L as LintOptions, a as LintReport$1, F as FixRecordOptions, b as FixReport, w as FixResult, x as LintSummary, y as RecordEntry, R as RecordStores$1, V as ValidationContext$1, z as ValidatorType, e as ISyncStateModule, B as AuditScope$1, A as AuditStateOptions, i as AuditStateReport, g as ConflictDiff, D as ConflictFileDiff, G as ConflictInfo, H as ConflictType, J as ExpectedFilesScope, h as IntegrityViolation, f as StateDeltaFile, S as SyncStateModuleDependencies, l as SyncStatePullOptions, m as SyncStatePullResult, j as SyncStatePushOptions, k as SyncStatePushResult, n as SyncStateResolveOptions, o as SyncStateResolveResult } from './sync_state-C2a2RuBQ.js';
+import { A as ActorState, a as GitGovSession, k as ISessionManager, S as SyncPreferencesUpdate, l as SyncStatus, m as AuditState, n as AuditStateUpdate, G as GitGovConfig, o as IConfigManager, p as SyncConfig, q as SyncDefaults, K as KeyProvider, r as KeyProviderError, s as KeyProviderErrorCode, i as FileListOptions, h as FileLister, j as FileStats, F as FsFileListerOptions, M as MemoryFileListerOptions, I as IGitModule } from './index-LULVRsCZ.js';
+export { C as ConfigStore, t as Git } from './index-LULVRsCZ.js';
+import { S as SessionManager, g as IdentityAdapter, h as IExecutionAdapter, i as ExecutionAdapterDependencies, E as EnvironmentValidation, I as IProjectInitializer, d as FsKeyProvider, e as FsKeyProviderOptions, f as FsFileLister, D as DEFAULT_STATE_BRANCH, j as AgentExecutionContext, k as AgentOutput, c as AgentResponse, A as AgentRunnerDependencies, l as AgentRunnerEvent, m as ApiEngine, n as AuthConfig, o as AuthType, C as CustomEngine, p as Engine, q as EngineType, r as IAgentLoader, b as IAgentRunner, L as LocalEngine, M as McpEngine, s as ProtocolHandler, P as ProtocolHandlerRegistry, R as RunOptions, t as RuntimeHandler, u as RuntimeHandlerRegistry } from './agent_runner-DijNVjaF.js';
+import { E as EnvKeyProvider, a as EnvKeyProviderOptions, M as MockKeyProvider, b as MockKeyProviderOptions, c as MemoryFileLister } from './memory_file_lister-BCY4ZYGW.js';
 import { ValidateFunction } from 'ajv';
-import { D as DEFAULT_ID_ENCODER, I as IdEncoder, R as RecordStore } from './record_store-BXKWqon5.js';
+import './session_store-I4Z6PW2c.js';
 
 /**
  * SessionManager Module
@@ -190,7 +190,6 @@ declare const index$q_AgentPayload: typeof AgentPayload;
 declare const index$q_AgentRecord: typeof AgentRecord;
 declare const index$q_ChangelogPayload: typeof ChangelogPayload;
 declare const index$q_ChangelogRecord: typeof ChangelogRecord;
-declare const index$q_CustomRecord: typeof CustomRecord;
 declare const index$q_CyclePayload: typeof CyclePayload;
 declare const index$q_CycleRecord: typeof CycleRecord;
 declare const index$q_EmbeddedMetadataHeader: typeof EmbeddedMetadataHeader;
@@ -215,7 +214,7 @@ declare const index$q_TaskPayload: typeof TaskPayload;
 declare const index$q_TaskRecord: typeof TaskRecord;
 type index$q_WorkflowRecord = WorkflowRecord;
 declare namespace index$q {
-  export { index$q_ActorPayload as ActorPayload, index$q_ActorRecord as ActorRecord, index$q_AgentPayload as AgentPayload, index$q_AgentRecord as AgentRecord, index$q_ChangelogPayload as ChangelogPayload, index$q_ChangelogRecord as ChangelogRecord, index$q_CustomRecord as CustomRecord, index$q_CyclePayload as CyclePayload, index$q_CycleRecord as CycleRecord, index$q_EmbeddedMetadataHeader as EmbeddedMetadataHeader, index$q_EmbeddedMetadataRecord as EmbeddedMetadataRecord, index$q_ExecutionPayload as ExecutionPayload, index$q_ExecutionRecord as ExecutionRecord, index$q_FeedbackPayload as FeedbackPayload, index$q_FeedbackRecord as FeedbackRecord, index$q_GitGovActorRecord as GitGovActorRecord, index$q_GitGovAgentRecord as GitGovAgentRecord, index$q_GitGovChangelogRecord as GitGovChangelogRecord, index$q_GitGovCycleRecord as GitGovCycleRecord, index$q_GitGovError as GitGovError, index$q_GitGovExecutionRecord as GitGovExecutionRecord, index$q_GitGovFeedbackRecord as GitGovFeedbackRecord, index$q_GitGovRecord as GitGovRecord, index$q_GitGovRecordPayload as GitGovRecordPayload, index$q_GitGovRecordType as GitGovRecordType, index$q_GitGovTaskRecord as GitGovTaskRecord, index$q_Signature as Signature, index$q_TaskPayload as TaskPayload, index$q_TaskRecord as TaskRecord, type index$q_WorkflowRecord as WorkflowRecord };
+  export { index$q_ActorPayload as ActorPayload, index$q_ActorRecord as ActorRecord, index$q_AgentPayload as AgentPayload, index$q_AgentRecord as AgentRecord, index$q_ChangelogPayload as ChangelogPayload, index$q_ChangelogRecord as ChangelogRecord, index$q_CyclePayload as CyclePayload, index$q_CycleRecord as CycleRecord, index$q_EmbeddedMetadataHeader as EmbeddedMetadataHeader, index$q_EmbeddedMetadataRecord as EmbeddedMetadataRecord, index$q_ExecutionPayload as ExecutionPayload, index$q_ExecutionRecord as ExecutionRecord, index$q_FeedbackPayload as FeedbackPayload, index$q_FeedbackRecord as FeedbackRecord, index$q_GitGovActorRecord as GitGovActorRecord, index$q_GitGovAgentRecord as GitGovAgentRecord, index$q_GitGovChangelogRecord as GitGovChangelogRecord, index$q_GitGovCycleRecord as GitGovCycleRecord, index$q_GitGovError as GitGovError, index$q_GitGovExecutionRecord as GitGovExecutionRecord, index$q_GitGovFeedbackRecord as GitGovFeedbackRecord, index$q_GitGovRecord as GitGovRecord, index$q_GitGovRecordPayload as GitGovRecordPayload, index$q_GitGovRecordType as GitGovRecordType, index$q_GitGovTaskRecord as GitGovTaskRecord, index$q_Signature as Signature, index$q_TaskPayload as TaskPayload, index$q_TaskRecord as TaskRecord, type index$q_WorkflowRecord as WorkflowRecord };
 }
 
 declare const index$p_DEFAULT_ID_ENCODER: typeof DEFAULT_ID_ENCODER;
@@ -479,6 +478,11 @@ declare class LintModule implements ILintModule {
      * @returns Array of lint results
      */
     lintRecord(record: GitGovRecord, context: LintRecordContext): LintResult[];
+    /**
+     * Validates typed references by prefix (pure, no I/O).
+     * Delegates to private validateTypedReferencesByPrefix.
+     */
+    lintRecordReferences(record: GitGovRecord, context: LintRecordContext): LintResult[];
     /**
      * Validates all records from stores.
      * Iterates this.stores to collect records, then validates each one.
@@ -508,6 +512,14 @@ declare class LintModule implements ILintModule {
      * @private
      */
     private validateTimestamps;
+    /**
+     * [EARS-E2] Validates typed references by prefix.
+     * Valid prefixes: file:, task:, cycle:, adapter:, url:, commit:, pr:
+     * Reports a warning for unknown prefixes and an error for empty values after known prefix.
+     * Pure — does not resolve actual references.
+     * @private
+     */
+    private validateTypedReferencesByPrefix;
     /**
      * [EARS-E1] through [EARS-E6] Validates references.
      * Uses Store<T> for lookups.
@@ -551,15 +563,15 @@ declare class LintModule implements ILintModule {
      */
     private fixChecksum;
     /**
-     * Fixes signature structure issues.
-     * @private
-     */
-    /**
-     * [EARS-F9] Fixes signature structure issues.
+     * [EARS-F9] [EARS-F10] Fixes signature structure issues.
      *
      * Preserves valid keyId and role from existing signature if present,
      * only using options.keyId as fallback when no existing signature exists.
      *
+     * [EARS-F10] When the ONLY problem is a missing `notes` field (no other
+     * signature errors exist for this record), adds `notes` WITHOUT regenerating
+     * the signature — preserving the existing cryptographic value.
+     *
      * @private
      */
     private fixSignature;
@@ -1861,7 +1873,7 @@ type SignatureConfig = Partial<Pick<Signature, 'keyId' | 'role' | 'notes'>> & {
  */
 type CreateEmbeddedMetadataOptions = {
     /** Header configuration (partial override, excludes auto-generated fields) */
-    header?: Partial<Pick<EmbeddedMetadataHeader, 'version' | 'type' | 'schemaUrl' | 'schemaChecksum'>>;
+    header?: Partial<Pick<EmbeddedMetadataHeader, 'version' | 'type'>>;
     /** Signature configuration (if not provided, uses default test signature) */
     signature?: SignatureConfig;
     /** Custom signatures array (if provided, overrides signature config) */
@@ -2809,15 +2821,6 @@ declare const Schemas: {
                         enum: string[];
                         description: string;
                     };
-                    schemaUrl: {
-                        type: string;
-                        description: string;
-                    };
-                    schemaChecksum: {
-                        type: string;
-                        pattern: string;
-                        description: string;
-                    };
                     payloadChecksum: {
                         type: string;
                         pattern: string;
@@ -2873,7 +2876,7 @@ declare const Schemas: {
         };
         required: string[];
         additionalProperties: boolean;
-        oneOf: ({
+        oneOf: {
             if: {
                 properties: {
                     header: {
@@ -2891,34 +2894,10 @@ declare const Schemas: {
                     payload: {
                         $ref: string;
                     };
-                    header?: never;
-                };
-            };
-            else: boolean;
-        } | {
-            if: {
-                properties: {
-                    header: {
-                        type: string;
-                        properties: {
-                            type: {
-                                const: string;
-                            };
-                        };
-                    };
-                };
-            };
-            then: {
-                properties: {
-                    header: {
-                        type: string;
-                        required: string[];
-                    };
-                    payload?: never;
                 };
             };
             else: boolean;
-        })[];
+        }[];
         examples: ({
             header: {
                 version: string;
@@ -4500,15 +4479,6 @@ declare function getSchema(name: SchemaName): {
                     enum: string[];
                     description: string;
                 };
-                schemaUrl: {
-                    type: string;
-                    description: string;
-                };
-                schemaChecksum: {
-                    type: string;
-                    pattern: string;
-                    description: string;
-                };
                 payloadChecksum: {
                     type: string;
                     pattern: string;
@@ -4564,7 +4534,7 @@ declare function getSchema(name: SchemaName): {
     };
     required: string[];
     additionalProperties: boolean;
-    oneOf: ({
+    oneOf: {
         if: {
             properties: {
                 header: {
@@ -4582,34 +4552,10 @@ declare function getSchema(name: SchemaName): {
                 payload: {
                     $ref: string;
                 };
-                header?: never;
             };
         };
         else: boolean;
-    } | {
-        if: {
-            properties: {
-                header: {
-                    type: string;
-                    properties: {
-                        type: {
-                            const: string;
-                        };
-                    };
-                };
-            };
-        };
-        then: {
-            properties: {
-                header: {
-                    type: string;
-                    required: string[];
-                };
-                payload?: never;
-            };
-        };
-        else: boolean;
-    })[];
+    }[];
     examples: ({
         header: {
             version: string;
@@ -5716,6 +5662,7 @@ declare const index$5_ConflictMarkersPresentError: typeof ConflictMarkersPresent
 declare const index$5_ConflictType: typeof ConflictType;
 type index$5_CryptoModuleRequiredError = CryptoModuleRequiredError;
 declare const index$5_CryptoModuleRequiredError: typeof CryptoModuleRequiredError;
+declare const index$5_DEFAULT_STATE_BRANCH: typeof DEFAULT_STATE_BRANCH;
 declare const index$5_ExpectedFilesScope: typeof ExpectedFilesScope;
 declare const index$5_ISyncStateModule: typeof ISyncStateModule;
 declare const index$5_IntegrityViolation: typeof IntegrityViolation;
@@ -5760,7 +5707,7 @@ declare const index$5_isSyncStateError: typeof isSyncStateError;
 declare const index$5_isUncommittedChangesError: typeof isUncommittedChangesError;
 declare const index$5_isWorktreeSetupError: typeof isWorktreeSetupError;
 declare namespace index$5 {
-  export { index$5_ActorIdentityMismatchError as ActorIdentityMismatchError, AuditScope$1 as AuditScope, index$5_AuditStateOptions as AuditStateOptions, index$5_AuditStateReport as AuditStateReport, index$5_ConflictDiff as ConflictDiff, index$5_ConflictFileDiff as ConflictFileDiff, index$5_ConflictInfo as ConflictInfo, index$5_ConflictMarkersPresentError as ConflictMarkersPresentError, index$5_ConflictType as ConflictType, index$5_CryptoModuleRequiredError as CryptoModuleRequiredError, index$5_ExpectedFilesScope as ExpectedFilesScope, index$5_ISyncStateModule as ISyncStateModule, index$5_IntegrityViolation as IntegrityViolation, index$5_IntegrityViolationError as IntegrityViolationError, index$5_NoRebaseInProgressError as NoRebaseInProgressError, index$5_PullScheduler as PullScheduler, type index$5_PullSchedulerConfig as PullSchedulerConfig, type index$5_PullSchedulerDependencies as PullSchedulerDependencies, type index$5_PullSchedulerResult as PullSchedulerResult, index$5_PushFromStateBranchError as PushFromStateBranchError, index$5_RebaseAlreadyInProgressError as RebaseAlreadyInProgressError, index$5_StateBranchSetupError as StateBranchSetupError, index$5_StateDeltaFile as StateDeltaFile, index$5_SyncStateError as SyncStateError, index$5_SyncStateModuleDependencies as SyncStateModuleDependencies, index$5_SyncStatePullOptions as SyncStatePullOptions, index$5_SyncStatePullResult as SyncStatePullResult, index$5_SyncStatePushOptions as SyncStatePushOptions, index$5_SyncStatePushResult as SyncStatePushResult, index$5_SyncStateResolveOptions as SyncStateResolveOptions, index$5_SyncStateResolveResult as SyncStateResolveResult, index$5_UncommittedChangesError as UncommittedChangesError, index$5_WorktreeSetupError as WorktreeSetupError, index$5_isActorIdentityMismatchError as isActorIdentityMismatchError, index$5_isConflictMarkersPresentError as isConflictMarkersPresentError, index$5_isCryptoModuleRequiredError as isCryptoModuleRequiredError, index$5_isIntegrityViolationError as isIntegrityViolationError, index$5_isNoRebaseInProgressError as isNoRebaseInProgressError, index$5_isPushFromStateBranchError as isPushFromStateBranchError, index$5_isRebaseAlreadyInProgressError as isRebaseAlreadyInProgressError, index$5_isStateBranchSetupError as isStateBranchSetupError, index$5_isSyncStateError as isSyncStateError, index$5_isUncommittedChangesError as isUncommittedChangesError, index$5_isWorktreeSetupError as isWorktreeSetupError };
+  export { index$5_ActorIdentityMismatchError as ActorIdentityMismatchError, AuditScope$1 as AuditScope, index$5_AuditStateOptions as AuditStateOptions, index$5_AuditStateReport as AuditStateReport, index$5_ConflictDiff as ConflictDiff, index$5_ConflictFileDiff as ConflictFileDiff, index$5_ConflictInfo as ConflictInfo, index$5_ConflictMarkersPresentError as ConflictMarkersPresentError, index$5_ConflictType as ConflictType, index$5_CryptoModuleRequiredError as CryptoModuleRequiredError, index$5_DEFAULT_STATE_BRANCH as DEFAULT_STATE_BRANCH, index$5_ExpectedFilesScope as ExpectedFilesScope, index$5_ISyncStateModule as ISyncStateModule, index$5_IntegrityViolation as IntegrityViolation, index$5_IntegrityViolationError as IntegrityViolationError, index$5_NoRebaseInProgressError as NoRebaseInProgressError, index$5_PullScheduler as PullScheduler, type index$5_PullSchedulerConfig as PullSchedulerConfig, type index$5_PullSchedulerDependencies as PullSchedulerDependencies, type index$5_PullSchedulerResult as PullSchedulerResult, index$5_PushFromStateBranchError as PushFromStateBranchError, index$5_RebaseAlreadyInProgressError as RebaseAlreadyInProgressError, index$5_StateBranchSetupError as StateBranchSetupError, index$5_StateDeltaFile as StateDeltaFile, index$5_SyncStateError as SyncStateError, index$5_SyncStateModuleDependencies as SyncStateModuleDependencies, index$5_SyncStatePullOptions as SyncStatePullOptions, index$5_SyncStatePullResult as SyncStatePullResult, index$5_SyncStatePushOptions as SyncStatePushOptions, index$5_SyncStatePushResult as SyncStatePushResult, index$5_SyncStateResolveOptions as SyncStateResolveOptions, index$5_SyncStateResolveResult as SyncStateResolveResult, index$5_UncommittedChangesError as UncommittedChangesError, index$5_WorktreeSetupError as WorktreeSetupError, index$5_isActorIdentityMismatchError as isActorIdentityMismatchError, index$5_isConflictMarkersPresentError as isConflictMarkersPresentError, index$5_isCryptoModuleRequiredError as isCryptoModuleRequiredError, index$5_isIntegrityViolationError as isIntegrityViolationError, index$5_isNoRebaseInProgressError as isNoRebaseInProgressError, index$5_isPushFromStateBranchError as isPushFromStateBranchError, index$5_isRebaseAlreadyInProgressError as isRebaseAlreadyInProgressError, index$5_isStateBranchSetupError as isStateBranchSetupError, index$5_isSyncStateError as isSyncStateError, index$5_isUncommittedChangesError as isUncommittedChangesError, index$5_isWorktreeSetupError as isWorktreeSetupError };
 }
 
 /**
@@ -7126,4 +7073,4 @@ declare namespace index {
   export { type index_ActiveWaiver as ActiveWaiver, type index_AuditContentsInput as AuditContentsInput, type index_AuditOptions as AuditOptions, type index_AuditResult as AuditResult, type index_AuditScope as AuditScope, type index_AuditSummary as AuditSummary, type index_AuditTarget as AuditTarget, type index_CodeScope as CodeScope, type index_CreateWaiverOptions as CreateWaiverOptions, type index_FailOnSeverity as FailOnSeverity, type index_FileContent as FileContent, type index_GitgovScope as GitgovScope, type index_GroupByOption as GroupByOption, type index_IWaiverReader as IWaiverReader, type index_JiraScope as JiraScope, type index_OutputFormat as OutputFormat, type index_ScopeConfig as ScopeConfig, index_ScopeSelector as ScopeSelector, index_ScoringEngine as ScoringEngine, type index_SourceAuditorDependencies as SourceAuditorDependencies, index_SourceAuditorModule as SourceAuditorModule, type index_WaiverMetadata as WaiverMetadata, index_WaiverReader as WaiverReader, type index_WaiverStatus as WaiverStatus, index_WaiverWriter as WaiverWriter };
 }
 
-export { ActivityEvent, ActorRecord, ActorState, index$c as Adapters, AgentRecord, AgentResponse, AllRecords, AuditState, AuditStateReport, index$f as BacklogAdapter, index$g as ChangelogAdapter, ChangelogRecord, CollaborationMetrics, index$r as Config, index$b as Crypto, CustomRecord, CycleRecord, DerivedStates, index$2 as DiagramGenerator, EmbeddedMetadataRecord, EnrichedTaskRecord, EnvironmentValidation, index$n as EventBus, index$j as ExecutionAdapter, ExecutionRecord, index$a as Factories, index$i as FeedbackAdapter, FeedbackRecord, index$8 as FileLister, index$1 as FindingDetector, FixReport, GitGovActorRecord, GitGovAgentRecord, GitGovChangelogRecord, GitGovConfig, GitGovCycleRecord, GitGovExecutionRecord, GitGovFeedbackRecord, GitGovRecord, GitGovRecordPayload, GitGovRecordType, GitGovTaskRecord, type IAgentAdapter, IAgentRunner, type IBacklogAdapter, IConfigManager, IExecutionAdapter, type IFeedbackAdapter, FileLister as IFileLister, IIdentityAdapter, KeyProvider as IKeyProvider, ILintModule, IRecordMetrics, IRecordProjection, IRecordProjector, ISessionManager, ISyncStateModule, IdEncoder, index$l as IdentityAdapter, IndexData, IndexGenerationReport, IntegrityReport, index$9 as KeyProvider, index$k as Lint, LintOptions, LintReport$1 as LintReport, LintResult, index$7 as Logger, ProductivityMetrics, index$d as ProjectAdapter, type ProjectInitResult, index$e as ProjectInitializer, ProjectionContext, index$o as RecordMetrics, RecordMetricsDependencies, index$m as RecordProjection, RecordProjectorDependencies, RecordStore, RecordStores$1 as RecordStores, index$q as Records, RunOptions, index$3 as Runner, index$6 as Schemas, index$s as Session, Signature, index as SourceAuditor, index$p as Store, index$5 as SyncState, SyncStatePullResult, SyncStatePushResult, SyncStateResolveResult, SyncStatus, SystemStatus, TaskHealthReport, TaskRecord, index$4 as Validation, ValidatorType, index$h as WorkflowAdapter, type WorkflowRecord };
+export { ActivityEvent, ActorRecord, ActorState, index$c as Adapters, AgentRecord, AgentResponse, AllRecords, AuditState, AuditStateReport, index$f as BacklogAdapter, index$g as ChangelogAdapter, ChangelogRecord, CollaborationMetrics, index$r as Config, index$b as Crypto, CycleRecord, DerivedStates, index$2 as DiagramGenerator, EmbeddedMetadataRecord, EnrichedTaskRecord, EnvironmentValidation, index$n as EventBus, index$j as ExecutionAdapter, ExecutionRecord, index$a as Factories, index$i as FeedbackAdapter, FeedbackRecord, index$8 as FileLister, index$1 as FindingDetector, FixReport, GitGovActorRecord, GitGovAgentRecord, GitGovChangelogRecord, GitGovConfig, GitGovCycleRecord, GitGovExecutionRecord, GitGovFeedbackRecord, GitGovRecord, GitGovRecordPayload, GitGovRecordType, GitGovTaskRecord, type IAgentAdapter, IAgentRunner, type IBacklogAdapter, IConfigManager, IExecutionAdapter, type IFeedbackAdapter, FileLister as IFileLister, IIdentityAdapter, KeyProvider as IKeyProvider, ILintModule, IRecordMetrics, IRecordProjection, IRecordProjector, ISessionManager, ISyncStateModule, IdEncoder, index$l as IdentityAdapter, IndexData, IndexGenerationReport, IntegrityReport, index$9 as KeyProvider, index$k as Lint, LintOptions, LintReport$1 as LintReport, LintResult, index$7 as Logger, ProductivityMetrics, index$d as ProjectAdapter, type ProjectInitResult, index$e as ProjectInitializer, ProjectionContext, index$o as RecordMetrics, RecordMetricsDependencies, index$m as RecordProjection, RecordProjectorDependencies, RecordStore, RecordStores$1 as RecordStores, index$q as Records, RunOptions, index$3 as Runner, index$6 as Schemas, index$s as Session, Signature, index as SourceAuditor, index$p as Store, index$5 as SyncState, SyncStatePullResult, SyncStatePushResult, SyncStateResolveResult, SyncStatus, SystemStatus, TaskHealthReport, TaskRecord, index$4 as Validation, ValidatorType, index$h as WorkflowAdapter, type WorkflowRecord };