@gitgov/core 2.7.2 → 2.9.0

package/dist/src/{agent_runner-DijNVjaF.d.ts → agent_runner-Cgle_zVX.d.ts}

@@ -1,7 +1,7 @@
 import { S as SessionStore } from './session_store-I4Z6PW2c.js';
 import { k as ISessionManager, a as GitGovSession, A as ActorState, S as SyncPreferencesUpdate, K as KeyProvider, h as FileLister, F as FsFileListerOptions, i as FileListOptions, j as FileStats, G as GitGovConfig } from './index-LULVRsCZ.js';
-import { q as IIdentityAdapter, u as IdentityAdapterDependencies, S as SyncStateModuleDependencies, p as IEventStream } from './sync_state-C2a2RuBQ.js';
-import { A as ActorPayload, d as ActorRecord, G as GitGovRecord, l as ExecutionRecord, y as RecordStores, f as AgentRecord } from './record_projection.types-D9NkQbL_.js';
+import { p as IIdentityAdapter, t as IdentityAdapterDependencies, J as SyncStateModuleDependencies, o as IEventStream } from './sync_state-B8X4NDKF.js';
+import { A as ActorPayload, d as ActorRecord, G as GitGovRecord, k as ExecutionRecord, y as RecordStores, f as AgentRecord } from './record_projection.types-CFsl44em.js';
 
 /**
  * SessionManager - Local Session State Manager

package/dist/src/fs.d.ts

@@ -1,11 +1,11 @@
-import { R as RecordStore, I as IdEncoder, a as IRecordProjector, G as GitGovRecord, b as IRecordProjection, c as IndexData, P as ProjectionContext } from './record_projection.types-D9NkQbL_.js';
-export { D as DEFAULT_ID_ENCODER } from './record_projection.types-D9NkQbL_.js';
+import { R as RecordStore, I as IdEncoder, a as IRecordProjector, G as GitGovRecord, b as IRecordProjection, c as IndexData, P as ProjectionContext } from './record_projection.types-CFsl44em.js';
+export { D as DEFAULT_ID_ENCODER } from './record_projection.types-CFsl44em.js';
 import { C as ConfigStore, G as GitGovConfig, a as GitGovSession, I 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-LULVRsCZ.js';
 export { F as FsFileListerOptions } from './index-LULVRsCZ.js';
-import { C as ConfigManager, 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 ISyncStateModule, S as SyncStateModuleDependencies, f as StateDeltaFile, g as ConflictDiff, h as IntegrityViolation, A as AuditStateOptions, i as AuditStateReport, j as SyncStatePushOptions, k as SyncStatePushResult, l as SyncStatePullOptions, m as SyncStatePullResult, n as SyncStateResolveOptions, o as SyncStateResolveResult, p as IEventStream } from './sync_state-C2a2RuBQ.js';
+import { C as ConfigManager, 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 ISyncStateModule, S as SyncStatePushOptions, f as SyncStatePushResult, g as SyncStatePullOptions, h as SyncStatePullResult, i as SyncStateResolveOptions, j as SyncStateResolveResult, k as StateDeltaFile, l as ConflictDiff, m as IntegrityViolation, A as AuditStateOptions, n as AuditStateReport, o as IEventStream } from './sync_state-B8X4NDKF.js';
 import { S as SessionStore } from './session_store-I4Z6PW2c.js';
-import { S as SessionManager, I as IProjectInitializer, E as EnvironmentValidation, F as FsWorktreeSyncStateDependencies, a as FsWorktreeSyncStateConfig, b as IAgentRunner, P as ProtocolHandlerRegistry, A as AgentRunnerDependencies, R as RunOptions, c as AgentResponse } from './agent_runner-DijNVjaF.js';
-export { f as FsFileLister, d as FsKeyProvider, e as FsKeyProviderOptions } from './agent_runner-DijNVjaF.js';
+import { S as SessionManager, I as IProjectInitializer, E as EnvironmentValidation, F as FsWorktreeSyncStateDependencies, a as FsWorktreeSyncStateConfig, b as IAgentRunner, P as ProtocolHandlerRegistry, A as AgentRunnerDependencies, R as RunOptions, c as AgentResponse } from './agent_runner-Cgle_zVX.js';
+export { f as FsFileLister, d as FsKeyProvider, e as FsKeyProviderOptions } from './agent_runner-Cgle_zVX.js';
 
 /**
  * Serializer for FsRecordStore - allows custom serialization
@@ -314,7 +314,7 @@ declare class FsLintModule implements IFsLintModule {
      */
     lintRecord(record: GitGovRecord, context: LintRecordContext): LintResult[];
     /**
-     * Delegates to LintModule.lintRecordReferences() for prefix validation.
+     * Delegates to LintModule.lintRecordReferences() for reference validation.
      */
     lintRecordReferences(record: GitGovRecord, context: LintRecordContext): LintResult[];
     /**
@@ -1049,184 +1049,23 @@ declare class LocalGitModule implements IGitModule {
  * @returns Path to project root, or null if not found
  */
 declare function findProjectRoot(startPath?: string): string | null;
-/**
- * Finds the project root by searching upwards.
- * First looks for .gitgov (initialized project), then .git (for init).
- *
- * @param startPath - Starting path (default: process.cwd())
- * @returns Path to project root, or null if not found
- */
-declare function findGitgovRoot(startPath?: string): string | null;
-/**
- * Gets the .gitgov directory path from project root.
- *
- * @throws Error if not inside a GitGovernance project
- */
-declare function getGitgovPath(): string;
-/**
- * Checks if current directory is inside a GitGovernance project.
- */
-declare function isGitgovProject(): boolean;
 /**
  * Reset the project root cache.
  * Useful for testing when switching between project contexts.
  */
 declare function resetDiscoveryCache(): void;
-
 /**
- * FsSyncStateModule - Manages state synchronization between local environment and gitgov-state branch
+ * Compute the worktree base path for a given repo root.
  *
- * Responsibilities:
- * - Create and maintain the gitgov-state branch (local and remote)
- * - Publish local changes (pushState)
- * - Pull remote changes (pullState)
- * - Resolve conflicts in a governed manner (resolveConflict)
- * - Audit state integrity (auditState)
+ * The CLI stores .gitgov/ state in ~/.gitgov/worktrees/<hash>/ — NOT inside
+ * the repo directory. The hash is SHA-256(realpathSync(repoRoot))[0:12].
+ *
+ * Uses realpathSync to resolve symlinks (macOS /tmp/ → /private/tmp/).
  *
- * Philosophy:
- * - Pipeline Pattern: Sequential operations with validation at each phase
- * - Fail-Fast: Early verifications to avoid costly operations
- * - Strict Dependencies: All dependencies (git, config, identity, lint, indexer) are required for robust operations
+ * @param repoRoot - Absolute path to the git repo root
+ * @returns Path under ~/.gitgov/worktrees/{hash}
  */
-declare class FsSyncStateModule implements ISyncStateModule {
-    private git;
-    private config;
-    private identity;
-    private lint;
-    private indexer;
-    /**
-     * Constructor with dependency injection
-     */
-    constructor(dependencies: SyncStateModuleDependencies);
-    /**
-     * Static method to bootstrap .gitgov/ from gitgov-state branch.
-     * Used when cloning a repo that has gitgov-state but .gitgov/ is not in the work branch.
-     *
-     * This method only requires GitModule and can be called before full SyncStateModule initialization.
-     *
-     * @param gitModule - GitModule instance for git operations
-     * @param stateBranch - Name of the state branch (default: "gitgov-state")
-     * @returns Promise<{ success: boolean; error?: string }>
-     */
-    static bootstrapFromStateBranch(gitModule: IGitModule, stateBranch?: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /**
-     * Gets the state branch name from configuration.
-     * Default: "gitgov-state"
-     *
-     * [EARS-A4]
-     */
-    getStateBranchName(): Promise<string>;
-    /**
-     * Ensures that the gitgov-state branch exists both locally and remotely.
-     * If it doesn't exist, creates it as an orphan branch.
-     *
-     * Use cases (4 edge cases):
-     * 1. Doesn't exist locally or remotely → Create orphan branch + initial commit + push
-     * 2. Exists remotely, not locally → Fetch + create local + set tracking
-     * 3. Exists locally, not remotely → Push + set tracking
-     * 4. Exists both → Verify tracking
-     *
-     * [EARS-A1, EARS-A2, EARS-A3]
-     */
-    ensureStateBranch(): Promise<void>;
-    /**
-     * Creates the gitgov-state orphan branch with an empty initial commit.
-     * Used by ensureStateBranch when the branch doesn't exist locally or remotely.
-     *
-     * [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.
-     *
-     * [EARS-A5]
-     */
-    calculateStateDelta(sourceBranch: string): Promise<StateDeltaFile[]>;
-    /**
-     * [EARS-B23] Detect file-level conflicts and identify remote-only changes.
-     *
-     * A conflict exists when:
-     * 1. A file was modified by the remote during implicit pull
-     * 2. AND the LOCAL USER also modified that same file (content in tempDir differs from what was in git before pull)
-     *
-     * This catches conflicts that git rebase can't detect because we copy files AFTER the pull.
-     *
-     * @param tempDir - Directory containing local .gitgov/ files (preserved before checkout)
-     * @param repoRoot - Repository root path
-    /**
-     * Checks if a rebase is in progress.
-     *
-     * [EARS-D6]
-     */
-    isRebaseInProgress(): Promise<boolean>;
-    /**
-     * Checks for absence of conflict markers in specified files.
-     * Returns list of files that still have markers.
-     *
-     * [EARS-D7]
-     */
-    checkConflictMarkers(filePaths: string[]): Promise<string[]>;
-    /**
-     * Gets the diff of conflicted files for manual analysis.
-     * Useful so the actor can analyze conflicted changes before resolving.
-     *
-     * [EARS-E8]
-     */
-    getConflictDiff(filePaths?: string[]): Promise<ConflictDiff>;
-    /**
-     * Verifies integrity of previous resolutions in gitgov-state history.
-     * Returns list of violations if any exist.
-     *
-     * [EARS-E1, EARS-E2, EARS-E3]
-     */
-    verifyResolutionIntegrity(): Promise<IntegrityViolation[]>;
-    /**
-     * Complete audit of gitgov-state status.
-     * Verifies integrity of resolutions, signatures in Records, checksums and expected files.
-     *
-     * [EARS-E4, EARS-E5, EARS-E6, EARS-E7]
-     */
-    auditState(options?: AuditStateOptions): Promise<AuditStateReport>;
-    /**
-     * Publishes local state changes to gitgov-state.
-     * Implements 3 phases: verification, reconciliation, publication.
-     *
-     * [EARS-B1 through EARS-B7]
-     */
-    pushState(options: SyncStatePushOptions): Promise<SyncStatePushResult>;
-    /**
-     * Pulls remote changes from gitgov-state to the local environment.
-     * Includes automatic re-indexing if there are new changes.
-     *
-     * [EARS-C1 through EARS-C4]
-     * [EARS-C5] Requires remote to be configured (pull without remote makes no sense)
-     */
-    pullState(options?: SyncStatePullOptions): Promise<SyncStatePullResult>;
-    /**
-     * Resolves state conflicts in a governed manner (Git-Native).
-     *
-     * Git-Native Flow:
-     * 1. User resolves conflicts using standard Git tools (edit files, remove markers)
-     * 2. User stages resolved files: git add .gitgov/
-     * 3. User runs: gitgov sync resolve --reason "reason"
-     *
-     * This method:
-     * - Verifies that a rebase is in progress
-     * - Checks that no conflict markers remain in staged files
-     * - Updates resolved Records with new checksums and signatures
-     * - Continues the git rebase (git rebase --continue)
-     * - Creates a signed resolution commit
-     * - Regenerates the index
-     *
-     * [EARS-D1 through EARS-D7]
-     */
-    resolveConflict(options: SyncStateResolveOptions): Promise<SyncStateResolveResult>;
-}
+declare function getWorktreeBasePath(repoRoot: string): string;
 
 /**
  * Worktree-based implementation of ISyncStateModule.
@@ -1466,4 +1305,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, FsWorktreeSyncStateModule, 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, FsWatcherStateModule, FsWorktreeSyncStateModule, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findProjectRoot, getWorktreeBasePath, resetDiscoveryCache };