@gitgov/core 1.8.0 → 1.8.3

package/README.md

@@ -4,7 +4,7 @@
 [![License: MPL-2.0](https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](./tsconfig.json)
 
-`@gitgov/core` is the **SDK** for the GitGovernance ecosystem. It provides a type-safe, local-first, and schema-driven API to manage identities, agents, and workflows in software projects.
+`@gitgov/core` is the **SDK** for the GitGovernance ecosystem. It provides a type-safe, local-first, and schema-driven API to manage identities, agents, tasks, and workflows in software projects.
 
 ## 🚀 Quick Start
 

package/dist/src/index.d.ts

@@ -1218,7 +1218,7 @@ interface IIdentityAdapter {
     resolveCurrentActorId(originalActorId: string): Promise<string>;
     getCurrentActor(): Promise<ActorRecord>;
     getEffectiveActorForAgent(agentId: string): Promise<ActorRecord | null>;
-    signRecord(record: GitGovRecord, actorId: string, role: string): Promise<GitGovRecord>;
+    signRecord(record: GitGovRecord, actorId: string, role: string, notes: string): Promise<GitGovRecord>;
     rotateActorKey(actorId: string): Promise<{
         oldActor: ActorRecord;
         newActor: ActorRecord;
@@ -1249,7 +1249,7 @@ declare class IdentityAdapter implements IIdentityAdapter {
     createActor(payload: ActorPayload, _signerId: string): Promise<ActorRecord>;
     getActor(actorId: string): Promise<ActorRecord | null>;
     listActors(): Promise<ActorRecord[]>;
-    signRecord(record: GitGovRecord, actorId: string, role: string): Promise<GitGovRecord>;
+    signRecord(record: GitGovRecord, actorId: string, role: string, notes: string): Promise<GitGovRecord>;
     /**
      * Resolves the current active ActorRecord ID by following the succession chain.
      * This is critical for AgentRecord operations after key rotation.
@@ -1887,8 +1887,15 @@ declare class ConfigManager {
     loadConfig(): Promise<GitGovConfig | null>;
     /**
      * Load GitGovernance session state
+     * [EARS-53] Auto-detects actor from .key files if no session or no actorId exists
      */
     loadSession(): Promise<GitGovSession | null>;
+    /**
+     * [EARS-53] Detect actor from .key files in .gitgov/actors/
+     * Returns the actor ID if exactly one .key file exists, or the first one if multiple exist.
+     * Private keys (.key files) indicate which actors can sign on this machine.
+     */
+    detectActorFromKeyFiles(): Promise<string | null>;
     /**
      * Get root cycle from configuration
      */
@@ -2139,7 +2146,7 @@ interface IBacklogAdapter {
     getAllTasks(): Promise<TaskRecord[]>;
     submitTask(taskId: string, actorId: string): Promise<TaskRecord>;
     approveTask(taskId: string, actorId: string): Promise<TaskRecord>;
-    updateTask(taskId: string, payload: Partial<TaskRecord>): Promise<TaskRecord>;
+    updateTask(taskId: string, payload: Partial<TaskRecord>, actorId: string): Promise<TaskRecord>;
     activateTask(taskId: string, actorId: string): Promise<TaskRecord>;
     completeTask(taskId: string, actorId: string): Promise<TaskRecord>;
     pauseTask(taskId: string, actorId: string, reason?: string): Promise<TaskRecord>;
@@ -2252,8 +2259,9 @@ declare class BacklogAdapter implements IBacklogAdapter {
     deleteTask(taskId: string, actorId: string): Promise<void>;
     /**
      * Updates a task with new payload
+     * [EARS-28] Signs the updated record with the editor's signature
      */
-    updateTask(taskId: string, payload: Partial<TaskRecord>): Promise<TaskRecord>;
+    updateTask(taskId: string, payload: Partial<TaskRecord>, actorId: string): Promise<TaskRecord>;
     /**
      * Gets tasks assigned to a specific actor
      */
@@ -8296,6 +8304,15 @@ interface SyncPushResult {
     conflictInfo?: ConflictInfo;
     /** Error message if operation failed */
     error?: string;
+    /** [EARS-54] Implicit pull results when push does reconciliation with remote */
+    implicitPull?: {
+        /** Whether changes were pulled from remote */
+        hasChanges: boolean;
+        /** Number of files updated from remote */
+        filesUpdated: number;
+        /** Whether index was regenerated */
+        reindexed: boolean;
+    };
 }
 /**
  * Options for pullState operation
@@ -8303,6 +8320,8 @@ interface SyncPushResult {
 interface SyncPullOptions {
     /** Force re-indexing even if there are no new changes */
     forceReindex?: boolean;
+    /** [EARS-62] Force pull even if local changes would be overwritten */
+    force?: boolean;
 }
 /**
  * Result of pullState operation
@@ -8322,6 +8341,8 @@ interface SyncPullResult {
     conflictInfo?: ConflictInfo;
     /** Error message if operation failed */
     error?: string;
+    /** [EARS-62] Files that were forcefully overwritten (when force: true) */
+    forcedOverwrites?: string[];
 }
 /**
  * Options for resolveConflict operation
@@ -8366,8 +8387,13 @@ interface ConflictInfo {
 }
 /**
  * Auxiliary type to identify the conflict type
+ *
+ * Git-Native conflict model (post-refactor):
+ * - rebase_conflict: Used for all Git-level conflicts during push/pull
+ * - local_changes_conflict: Used when pull would overwrite local changes (EARS-61)
+ * - integrity_violation: Used when resolution commits are missing
  */
-type ConflictType = "rebase_conflict" | "merge_conflict" | "integrity_violation" | "unresolved_markers";
+type ConflictType = "rebase_conflict" | "integrity_violation" | "local_changes_conflict";
 /**
  * Information about a detected integrity violation
  */
@@ -8541,6 +8567,17 @@ declare class SyncModule {
      * [EARS-5]
      */
     calculateStateDelta(sourceBranch: string): Promise<StateDeltaFile[]>;
+    /**
+     * [EARS-60] 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.
      *
@@ -8591,9 +8628,20 @@ declare class SyncModule {
      */
     pullState(options?: SyncPullOptions): Promise<SyncPullResult>;
     /**
-     * Resolves state conflicts in a governed manner.
-     * Updates resolved Records (recalculates checksum and adds resolver signature),
-     * creates rebase and resolution commits signed according to protocol.
+     * 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-17 through EARS-23]
      */