@gitgov/core 2.2.0 → 2.4.0

package/dist/src/fs.d.ts

@@ -1,8 +1,11 @@
-import { R as RecordStore, I as IdEncoder, C as ConfigStore, G as GitGovConfig, a as IGitModule, b as GitModuleDependencies, E as ExecOptions, c as ExecResult, d as ChangedFile, e as GetCommitHistoryOptions, f as CommitInfo, g as CommitAuthor } from './index-D1RVufxB.js';
-export { D as DEFAULT_ID_ENCODER, F as FsFileListerOptions } from './index-D1RVufxB.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 IIndexerAdapter, G as GitGovRecord, d as LintRecordContext, e as LintResult, f as IProjectInitializer, E as EnvironmentValidation, g as ISyncStateModule, h as SyncStateModuleDependencies, i as StateDeltaFile, j as ConflictDiff, k as IntegrityViolation, A as AuditStateOptions, l as AuditStateReport, m as SyncStatePushOptions, n as SyncStatePushResult, o as SyncStatePullOptions, p as SyncStatePullResult, q as SyncStateResolveOptions, r as SyncStateResolveResult, s as IEventStream, t as IAgentRunner, P as ProtocolHandlerRegistry, u as AgentRunnerDependencies, v as RunOptions, w as AgentResponse } from './agent_runner-Cs5HXt4h.js';
-export { z as FsFileLister, x as FsKeyProvider, y as FsKeyProviderOptions } from './agent_runner-Cs5HXt4h.js';
-import { S as SessionStore, G as GitGovSession } from './key_provider-CRpHFGjN.js';
+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-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';
 
 /**
  * Serializer for FsRecordStore - allows custom serialization
@@ -135,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
@@ -155,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
      *
@@ -237,8 +240,8 @@ interface FsLintModuleDependencies {
     lintModule: ILintModule;
     /** Record stores for reference lookups (OPTIONAL) */
     stores?: RecordStores;
-    /** Indexer adapter for reference resolution (OPTIONAL) */
-    indexerAdapter?: IIndexerAdapter;
+    /** Record projector for reference resolution (OPTIONAL) */
+    projector?: IRecordProjector;
     /** FileSystem abstraction for I/O (OPTIONAL, default: Node.js fs) */
     fileSystem?: FileSystem;
 }
@@ -432,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.
      */
@@ -1131,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.
      *
@@ -1218,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;
@@ -1357,4 +1448,22 @@ declare class FsAgentRunner implements IAgentRunner {
  */
 declare function createAgentRunner(deps: AgentRunnerDependencies): IAgentRunner;
 
-export { type FileSystem, FsAgentRunner, AgentRunnerDependencies as FsAgentRunnerDependencies, FsConfigStore, type FsFixOptions, FsLintModule, type FsLintModuleDependencies, type FsLintOptions, FsProjectInitializer, FsRecordStore, FsSessionStore, FsSyncStateModule, FsWatcherStateModule, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };
+type FsRecordProjectionOptions = {
+    basePath: string;
+};
+/**
+ * FsRecordProjection - Filesystem IRecordProjection for CLI.
+ *
+ * Writes IndexData as JSON to .gitgov/index.json using atomic write
+ * (write to temp file + rename) to prevent corruption on crash.
+ */
+declare class FsRecordProjection implements IRecordProjection {
+    private readonly indexPath;
+    constructor(options: FsRecordProjectionOptions);
+    persist(data: IndexData, _context: ProjectionContext): Promise<void>;
+    read(_context: ProjectionContext): Promise<IndexData | null>;
+    exists(_context: ProjectionContext): Promise<boolean>;
+    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, FsWorktreeSyncStateModule, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };