@gitgov/core 2.3.0 → 2.5.0

package/dist/src/{agent_runner-D7JahEKk.d.ts → agent_runner-pr7h-9cV.d.ts}

@@ -1,4 +1,4 @@
-import { I as ISessionManager, S as SessionStore, G as GitGovSession, A as ActorState, a as SyncPreferencesUpdate, K as KeyProvider } from './key_provider-CRpHFGjN.js';
+import { I as ISessionManager, S as SessionStore, G as GitGovSession, A as ActorState, a as SyncPreferencesUpdate, K as KeyProvider } from './key_provider-jjWek3w1.js';
 import { k as IConfigManager, C as ConfigStore, G as GitGovConfig, S as SyncConfig, l as SyncDefaults, A as AuditState, j as AuditStateUpdate, g as FileLister, F as FsFileListerOptions, h as FileListOptions, i as FileStats, I as IGitModule } from './index-Bhc341pf.js';
 import { R as RecordStore } from './record_store-BXKWqon5.js';
 import { Q as BaseEvent, X as EventHandler, Z as EventSubscription, a0 as GitGovEvent, G as GitGovRecord, v as GitGovRecordType, I as IRecordProjector, A as ActorPayload, c as ActorRecord, R as RecordStores$1, l as ExecutionRecord, e as AgentRecord } from './record_projection.types-B8AM7u8U.js';
@@ -152,7 +152,7 @@ declare class SessionManager implements ISessionManager {
 /**
  * FsKeyProvider - Filesystem-based KeyProvider implementation
  *
- * Stores private keys alongside actor records in .gitgov/actors/{actorId}.key
+ * Stores private keys in .gitgov/keys/{actorId}.key
  * Used in development and CLI environments.
  *
  * @module key_provider/fs/fs_key_provider
@@ -162,8 +162,8 @@ declare class SessionManager implements ISessionManager {
  * Options for FsKeyProvider.
  */
 interface FsKeyProviderOptions {
-    /** Directory where key files are stored (same as actors: .gitgov/actors) */
-    actorsDir: string;
+    /** Directory where key files are stored (e.g., .gitgov/keys) */
+    keysDir: string;
     /** File extension for key files (default: '.key') */
     extension?: string;
     /** File permissions for key files (default: 0o600 - owner read/write only) */
@@ -171,17 +171,17 @@ interface FsKeyProviderOptions {
 }
 /**
  * Filesystem-based KeyProvider implementation.
- * Keys are stored alongside actor records with .key extension.
+ * Keys are stored in a dedicated directory with .key extension.
  *
  * @example
  * ```typescript
- * const provider = new FsKeyProvider({ actorsDir: '.gitgov/actors' });
+ * const provider = new FsKeyProvider({ keysDir: '.gitgov/keys' });
  * await provider.setPrivateKey('actor:human:alice', 'base64PrivateKey...');
  * const key = await provider.getPrivateKey('actor:human:alice');
  * ```
  */
 declare class FsKeyProvider implements KeyProvider {
-    private readonly actorsDir;
+    private readonly keysDir;
     private readonly extension;
     private readonly fileMode;
     constructor(options: FsKeyProviderOptions);
@@ -193,8 +193,8 @@ declare class FsKeyProvider implements KeyProvider {
     getPrivateKey(actorId: string): Promise<string | null>;
     /**
      * [EARS-KP03] Stores a private key for an actor.
-     * [EARS-FKP01] Creates actorsDir if not exists.
-     * [EARS-FKP02] Writes key to {actorsDir}/{actorId}.key.
+     * [EARS-FKP01] Creates keysDir if not exists.
+     * [EARS-FKP02] Writes key to {keysDir}/{actorId}.key.
      * [EARS-FKP03] Sets secure file permissions (0600).
      */
     setPrivateKey(actorId: string, privateKey: string): Promise<void>;
@@ -1132,6 +1132,8 @@ interface ISyncStateModule {
     ensureStateBranch(): Promise<void>;
     /** Calculates the file delta between source branch and state branch */
     calculateStateDelta(sourceBranch: string): Promise<StateDeltaFile[]>;
+    /** Returns pending local changes not yet synced to the state branch */
+    getPendingChanges(): Promise<StateDeltaFile[]>;
     /** Checks if a rebase operation is currently in progress */
     isRebaseInProgress(): Promise<boolean>;
     /** Returns list of files that still contain conflict markers */

package/dist/src/fs.d.ts

@@ -2,9 +2,9 @@ import { R as RecordStore, I as IdEncoder } from './record_store-BXKWqon5.js';
 export { D as DEFAULT_ID_ENCODER } from './record_store-BXKWqon5.js';
 import { C as ConfigStore, G as GitGovConfig, I as IGitModule, a as GitModuleDependencies, E as ExecOptions, b as ExecResult, c as ChangedFile, d as GetCommitHistoryOptions, e as CommitInfo, f as CommitAuthor } from './index-Bhc341pf.js';
 export { F as FsFileListerOptions } from './index-Bhc341pf.js';
-import { C as ConfigManager, S as SessionManager, I as ILintModule, L as LintOptions, a as LintReport, F as FixRecordOptions, b as FixReport, R as RecordStores, c as LintRecordContext, d as LintResult, e as IProjectInitializer, E as EnvironmentValidation, f as ISyncStateModule, g as SyncStateModuleDependencies, h as StateDeltaFile, i as ConflictDiff, j as IntegrityViolation, A as AuditStateOptions, k as AuditStateReport, l as SyncStatePushOptions, m as SyncStatePushResult, n as SyncStatePullOptions, o as SyncStatePullResult, p as SyncStateResolveOptions, q as SyncStateResolveResult, r as IEventStream, s as IAgentRunner, P as ProtocolHandlerRegistry, t as AgentRunnerDependencies, u as RunOptions, v as AgentResponse } from './agent_runner-D7JahEKk.js';
-export { y as FsFileLister, w as FsKeyProvider, x as FsKeyProviderOptions } from './agent_runner-D7JahEKk.js';
-import { S as SessionStore, G as GitGovSession } from './key_provider-CRpHFGjN.js';
+import { C as ConfigManager, S as SessionManager, I as ILintModule, L as LintOptions, a as LintReport, F as FixRecordOptions, b as FixReport, R as RecordStores, c as LintRecordContext, d as LintResult, e as IProjectInitializer, E as EnvironmentValidation, f as ISyncStateModule, g as SyncStateModuleDependencies, h as StateDeltaFile, i as ConflictDiff, j as IntegrityViolation, A as AuditStateOptions, k as AuditStateReport, l as SyncStatePushOptions, m as SyncStatePushResult, n as SyncStatePullOptions, o as SyncStatePullResult, p as SyncStateResolveOptions, q as SyncStateResolveResult, r as IEventStream, s as IAgentRunner, P as ProtocolHandlerRegistry, t as AgentRunnerDependencies, u as RunOptions, v as AgentResponse } from './agent_runner-pr7h-9cV.js';
+export { y as FsFileLister, w as FsKeyProvider, x as FsKeyProviderOptions } from './agent_runner-pr7h-9cV.js';
+import { S as SessionStore, G as GitGovSession } from './key_provider-jjWek3w1.js';
 import { I as IRecordProjector, G as GitGovRecord, a as IRecordProjection, b as IndexData, P as ProjectionContext } from './record_projection.types-B8AM7u8U.js';
 
 /**
@@ -138,7 +138,7 @@ declare function createConfigManager(projectRoot: string): ConfigManager;
  */
 declare class FsSessionStore implements SessionStore {
     private readonly sessionPath;
-    private readonly actorsPath;
+    private readonly keysPath;
     constructor(projectRootPath: string);
     /**
      * Load local session from .gitgov/.session.json
@@ -158,12 +158,12 @@ declare class FsSessionStore implements SessionStore {
      */
     saveSession(session: GitGovSession): Promise<void>;
     /**
-     * Detect actor from .key files in .gitgov/actors/
+     * Detect actor from .key files in .gitgov/keys/
      *
      * [EARS-C1] Returns actor ID from first .key file
      * [EARS-C2] Returns first .key file alphabetically if multiple exist
      * [EARS-C3] Returns null if no .key files exist
-     * [EARS-C4] Returns null if actors directory doesn't exist
+     * [EARS-C4] Returns null if keys directory doesn't exist
      * [EARS-C5] Ignores non-.key files
      * [EARS-C6] Returns null for empty directory
      *
@@ -435,7 +435,8 @@ declare class FsLintModule implements IFsLintModule {
  */
 declare class FsProjectInitializer implements IProjectInitializer {
     private readonly projectRoot;
-    constructor(projectRoot: string);
+    private readonly repoRoot;
+    constructor(projectRoot: string, repoRoot?: string);
     /**
      * Creates the .gitgov/ directory structure.
      */
@@ -1134,6 +1135,8 @@ declare class FsSyncStateModule implements ISyncStateModule {
      * [EARS-A1]
      */
     private createOrphanStateBranch;
+    /** Returns pending local changes not yet synced (delegates to calculateStateDelta) */
+    getPendingChanges(): Promise<StateDeltaFile[]>;
     /**
      * Calculates the file delta in .gitgov/ between the current branch and gitgov-state.
      *
@@ -1221,6 +1224,91 @@ declare class FsSyncStateModule implements ISyncStateModule {
     resolveConflict(options: SyncStateResolveOptions): Promise<SyncStateResolveResult>;
 }
 
+/**
+ * Reutiliza las mismas dependencias que FsSyncStateModule.
+ * No requiere dependencias adicionales.
+ */
+type FsWorktreeSyncStateDependencies = SyncStateModuleDependencies;
+/**
+ * Configuration for worktree-based sync module.
+ */
+type FsWorktreeSyncStateConfig = {
+    /** Root directory of the git repository */
+    repoRoot: string;
+    /** State branch name (default: "gitgov-state") */
+    stateBranchName?: string;
+    /** Absolute path to worktree. Default: path.join(repoRoot, '.gitgov-worktree') */
+    worktreePath?: string;
+};
+
+/**
+ * Worktree-based implementation of ISyncStateModule.
+ *
+ * Uses a permanent git worktree at <repoRoot>/.gitgov-worktree/ to
+ * sync state with the gitgov-state branch. Eliminates branch switching,
+ * stash, and temp directories.
+ *
+ * @see fs_worktree_sync_state_module.md for EARS specifications
+ */
+declare class FsWorktreeSyncStateModule implements ISyncStateModule {
+    private readonly deps;
+    private readonly repoRoot;
+    private readonly stateBranchName;
+    private readonly worktreePath;
+    private readonly gitgovPath;
+    constructor(deps: FsWorktreeSyncStateDependencies, config: FsWorktreeSyncStateConfig);
+    /** [WTSYNC-A4] Returns the worktree path */
+    getWorktreePath(): string;
+    /** [WTSYNC-A1..A6] Ensures worktree exists and is healthy */
+    ensureWorktree(): Promise<void>;
+    /** Check worktree health */
+    private checkWorktreeHealth;
+    /** Remove worktree cleanly */
+    private removeWorktree;
+    /** [WTSYNC-B1..B14] Push local state to remote */
+    pushState(options: SyncStatePushOptions): Promise<SyncStatePushResult>;
+    /** [WTSYNC-C1..C8] Pull remote state */
+    pullState(options?: SyncStatePullOptions): Promise<SyncStatePullResult>;
+    /** [WTSYNC-D1..D7] Resolve rebase conflict */
+    resolveConflict(options: SyncStateResolveOptions): Promise<SyncStateResolveResult>;
+    /** [WTSYNC-E8] Get configured state branch name */
+    getStateBranchName(): Promise<string>;
+    /** [WTSYNC-A5/A6] Ensure state branch exists */
+    ensureStateBranch(): Promise<void>;
+    /** Returns pending syncable changes not yet pushed (filters by shouldSyncFile) */
+    getPendingChanges(): Promise<StateDeltaFile[]>;
+    /** Calculate delta between source and worktree state branch */
+    calculateStateDelta(_sourceBranch: string): Promise<StateDeltaFile[]>;
+    /** [WTSYNC-E6] Check if rebase is in progress in worktree */
+    isRebaseInProgress(): Promise<boolean>;
+    /** Check for conflict markers in files */
+    checkConflictMarkers(filePaths: string[]): Promise<string[]>;
+    /** [WTSYNC-E7] Get structured conflict diff */
+    getConflictDiff(filePaths?: string[]): Promise<ConflictDiff>;
+    /** [WTSYNC-E1] Verify resolution integrity */
+    verifyResolutionIntegrity(): Promise<IntegrityViolation[]>;
+    /** [WTSYNC-E1..E5] Audit state */
+    auditState(options?: AuditStateOptions): Promise<AuditStateReport>;
+    /** Execute git command in repo root (throws on non-zero exit) */
+    private execGit;
+    /** Execute git command in worktree context (throws on non-zero exit) */
+    private execInWorktree;
+    /** Calculate file delta (uncommitted changes in worktree) */
+    private calculateFileDelta;
+    /** [WTSYNC-B4/B9/B10/B11] Stage only syncable files from delta (adds, mods, and deletions) */
+    private stageSyncableFiles;
+    /** Get list of conflicted files during rebase */
+    private getConflictedFiles;
+    /** Re-sign records after conflict resolution */
+    private resignResolvedRecords;
+    /** Re-index records from worktree */
+    private reindex;
+    /** Parse git diff --name-status output */
+    private parseDiffOutput;
+    /** Parse git status --porcelain output */
+    private parseStatusOutput;
+}
+
 interface WatcherStateModuleOptions {
     gitgovPath: string;
     debounceMs?: number;
@@ -1378,4 +1466,4 @@ declare class FsRecordProjection implements IRecordProjection {
     clear(_context: ProjectionContext): Promise<void>;
 }
 
-export { type FileSystem, FsAgentRunner, AgentRunnerDependencies as FsAgentRunnerDependencies, FsConfigStore, type FsFixOptions, FsLintModule, type FsLintModuleDependencies, type FsLintOptions, FsProjectInitializer, FsRecordProjection, type FsRecordProjectionOptions, FsRecordStore, FsSessionStore, FsSyncStateModule, FsWatcherStateModule, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };
+export { type FileSystem, FsAgentRunner, AgentRunnerDependencies as FsAgentRunnerDependencies, FsConfigStore, type FsFixOptions, FsLintModule, type FsLintModuleDependencies, type FsLintOptions, FsProjectInitializer, FsRecordProjection, type FsRecordProjectionOptions, FsRecordStore, FsSessionStore, FsSyncStateModule, FsWatcherStateModule, FsWorktreeSyncStateModule, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };