@gitgov/core 2.5.0 → 2.7.0

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 CustomRecord, i as CyclePayload, j as CycleRecord, E as EmbeddedMetadataHeader, k as EmbeddedMetadataRecord, l as ExecutionPayload, m as ExecutionRecord, F as FeedbackPayload, n as FeedbackRecord, o as GitGovActorRecord, p as GitGovAgentRecord, q as GitGovChangelogRecord, r as GitGovCycleRecord, s as GitGovError, t as GitGovExecutionRecord, u as GitGovFeedbackRecord, G as GitGovRecord, v as GitGovRecordPayload, w as GitGovRecordType, x as GitGovTaskRecord, S as Signature, T as TaskPayload, y as TaskRecord, D as DEFAULT_ID_ENCODER, I as IdEncoder, R as RecordStore, z as RecordStores, B as CollaborationMetrics, H as IRecordMetrics, J as ProductivityMetrics, K as RecordMetrics, L as RecordMetricsDependencies, M as SystemStatus, N as TaskHealthReport, O as ActivityEvent, Q as ActorCreatedEvent, U as ActorRevokedEvent, V as AgentRegisteredEvent, W as BaseEvent, X as ChangelogCreatedEvent, Y as CycleCreatedEvent, Z as CycleStatusChangedEvent, _ as EventHandler, $ as EventMetadata, a0 as EventSubscription, a1 as ExecutionCreatedEvent, a2 as FeedbackCreatedEvent, a3 as GitGovEvent, a4 as SystemDailyTickEvent, a5 as TaskCreatedEvent, a6 as TaskStatusChangedEvent, a as IRecordProjector, a7 as RecordProjectorDependencies, c as IndexData, a8 as IndexGenerationReport, a9 as IntegrityReport, aa as AllRecords, ab as DerivedStates, ac as EnrichedTaskRecord, ad as DerivedStateSets, b as IRecordProjection, ae as IntegrityError, af as IntegrityWarning, P as ProjectionContext } from './record_projection.types-Dz9YU3r9.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-Bn_LogJ2.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-CHDkBfPZ.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
@@ -997,12 +997,13 @@ declare class WorkflowAdapter implements IWorkflow {
 }
 
 type index$h_IWorkflow = IWorkflow;
+type index$h_TransitionRule = TransitionRule;
 type index$h_ValidationContext = ValidationContext;
 type index$h_WorkflowAdapter = WorkflowAdapter;
 declare const index$h_WorkflowAdapter: typeof WorkflowAdapter;
 type index$h_WorkflowAdapterDependencies = WorkflowAdapterDependencies;
 declare namespace index$h {
-  export { type index$h_IWorkflow as IWorkflow, type index$h_ValidationContext as ValidationContext, index$h_WorkflowAdapter as WorkflowAdapter, type index$h_WorkflowAdapterDependencies as WorkflowAdapterDependencies };
+  export { type index$h_IWorkflow as IWorkflow, type index$h_TransitionRule as TransitionRule, type index$h_ValidationContext as ValidationContext, index$h_WorkflowAdapter as WorkflowAdapter, type index$h_WorkflowAdapterDependencies as WorkflowAdapterDependencies };
 }
 
 /**
@@ -1393,6 +1394,8 @@ interface ProjectAdapterDependencies {
 type ProjectInitOptions = {
     /** Project name (will be slugified for projectId) */
     name: string;
+    /** Actor type for bootstrap trust root. Default: 'human' */
+    type?: 'human' | 'agent';
     /** Path to JSON template file for initial cycles/tasks */
     template?: string;
     /** Display name for bootstrap actor */
@@ -1641,12 +1644,13 @@ type index$c_ProjectInitOptions = ProjectInitOptions;
 type index$c_ProjectInitResult = ProjectInitResult;
 type index$c_ProjectReport = ProjectReport;
 type index$c_TemplateProcessingResult = TemplateProcessingResult;
+type index$c_TransitionRule = TransitionRule;
 type index$c_ValidationContext = ValidationContext;
 type index$c_WorkflowAdapter = WorkflowAdapter;
 declare const index$c_WorkflowAdapter: typeof WorkflowAdapter;
 type index$c_WorkflowAdapterDependencies = WorkflowAdapterDependencies;
 declare namespace index$c {
-  export { index$c_AgentAdapter as AgentAdapter, type index$c_AgentAdapterDependencies as AgentAdapterDependencies, type index$c_AuditReport as AuditReport, index$c_BacklogAdapter as BacklogAdapter, type index$c_BacklogAdapterConfig as BacklogAdapterConfig, type index$c_BacklogAdapterDependencies as BacklogAdapterDependencies, index$c_ChangelogAdapter as ChangelogAdapter, type index$c_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$c_ChangelogListOptions as ChangelogListOptions, index$c_EnvironmentValidation as EnvironmentValidation, index$c_ExecutionAdapter as ExecutionAdapter, index$c_ExecutionAdapterDependencies as ExecutionAdapterDependencies, index$c_FeedbackAdapter as FeedbackAdapter, type index$c_FeedbackAdapterDependencies as FeedbackAdapterDependencies, type index$c_FeedbackThread as FeedbackThread, type index$c_IAgentAdapter as IAgentAdapter, type index$c_IBacklogAdapter as IBacklogAdapter, type index$c_IChangelogAdapter as IChangelogAdapter, index$c_IExecutionAdapter as IExecutionAdapter, type index$c_IFeedbackAdapter as IFeedbackAdapter, index$c_IIdentityAdapter as IIdentityAdapter, type index$c_IProjectAdapter as IProjectAdapter, type index$c_IWorkflow as IWorkflow, index$c_IdentityAdapter as IdentityAdapter, index$c_IdentityAdapterDependencies as IdentityAdapterDependencies, type index$c_LintReport as LintReport, index$c_ProjectAdapter as ProjectAdapter, type index$c_ProjectAdapterDependencies as ProjectAdapterDependencies, type index$c_ProjectContext as ProjectContext, type index$c_ProjectInfo as ProjectInfo, type index$c_ProjectInitOptions as ProjectInitOptions, type index$c_ProjectInitResult as ProjectInitResult, type index$c_ProjectReport as ProjectReport, type index$c_TemplateProcessingResult as TemplateProcessingResult, type index$c_ValidationContext as ValidationContext, index$c_WorkflowAdapter as WorkflowAdapter, type index$c_WorkflowAdapterDependencies as WorkflowAdapterDependencies };
+  export { index$c_AgentAdapter as AgentAdapter, type index$c_AgentAdapterDependencies as AgentAdapterDependencies, type index$c_AuditReport as AuditReport, index$c_BacklogAdapter as BacklogAdapter, type index$c_BacklogAdapterConfig as BacklogAdapterConfig, type index$c_BacklogAdapterDependencies as BacklogAdapterDependencies, index$c_ChangelogAdapter as ChangelogAdapter, type index$c_ChangelogAdapterDependencies as ChangelogAdapterDependencies, type index$c_ChangelogListOptions as ChangelogListOptions, index$c_EnvironmentValidation as EnvironmentValidation, index$c_ExecutionAdapter as ExecutionAdapter, index$c_ExecutionAdapterDependencies as ExecutionAdapterDependencies, index$c_FeedbackAdapter as FeedbackAdapter, type index$c_FeedbackAdapterDependencies as FeedbackAdapterDependencies, type index$c_FeedbackThread as FeedbackThread, type index$c_IAgentAdapter as IAgentAdapter, type index$c_IBacklogAdapter as IBacklogAdapter, type index$c_IChangelogAdapter as IChangelogAdapter, index$c_IExecutionAdapter as IExecutionAdapter, type index$c_IFeedbackAdapter as IFeedbackAdapter, index$c_IIdentityAdapter as IIdentityAdapter, type index$c_IProjectAdapter as IProjectAdapter, type index$c_IWorkflow as IWorkflow, index$c_IdentityAdapter as IdentityAdapter, index$c_IdentityAdapterDependencies as IdentityAdapterDependencies, type index$c_LintReport as LintReport, index$c_ProjectAdapter as ProjectAdapter, type index$c_ProjectAdapterDependencies as ProjectAdapterDependencies, type index$c_ProjectContext as ProjectContext, type index$c_ProjectInfo as ProjectInfo, type index$c_ProjectInitOptions as ProjectInitOptions, type index$c_ProjectInitResult as ProjectInitResult, type index$c_ProjectReport as ProjectReport, type index$c_TemplateProcessingResult as TemplateProcessingResult, type index$c_TransitionRule as TransitionRule, type index$c_ValidationContext as ValidationContext, index$c_WorkflowAdapter as WorkflowAdapter, type index$c_WorkflowAdapterDependencies as WorkflowAdapterDependencies };
 }
 
 /**
@@ -5712,6 +5716,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;
@@ -5756,7 +5761,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 };
 }
 
 /**
@@ -7122,4 +7127,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, 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, 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 };

package/dist/src/index.js

@@ -5880,7 +5880,7 @@ var ProjectAdapter = class {
       await this.projectInitializer.copyAgentPrompt();
       const actor = await this.identityAdapter.createActor(
         {
-          type: "human",
+          type: options.type ?? "human",
           displayName: options.actorName || "Project Owner",
           roles: [
             "admin",
@@ -8229,6 +8229,7 @@ __export(sync_state_exports, {
   ActorIdentityMismatchError: () => ActorIdentityMismatchError,
   ConflictMarkersPresentError: () => ConflictMarkersPresentError,
   CryptoModuleRequiredError: () => CryptoModuleRequiredError,
+  DEFAULT_STATE_BRANCH: () => DEFAULT_STATE_BRANCH,
   IntegrityViolationError: () => IntegrityViolationError,
   NoRebaseInProgressError: () => NoRebaseInProgressError,
   PullScheduler: () => PullScheduler,
@@ -8440,6 +8441,9 @@ var PullScheduler = class {
   }
 };
 
+// src/sync_state/fs_worktree/fs_worktree_sync_state.types.ts
+var DEFAULT_STATE_BRANCH = "gitgov-state";
+
 // src/sync_state/sync_state.errors.ts
 var SyncStateError = class _SyncStateError extends Error {
   constructor(message) {