@gitgov/core 2.1.2 → 2.3.0

package/dist/src/fs.d.ts

@@ -1,7 +1,11 @@
-import { R as RecordStore, C as ConfigStore, G as GitGovConfig, S as SessionStore, 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--ahcnsG3.js';
-export { F as FsFileListerOptions } from './index--ahcnsG3.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-ByOUWOt6.js';
-export { z as FsFileLister, x as FsKeyProvider, y as FsKeyProviderOptions } from './agent_runner-ByOUWOt6.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-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 { 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
@@ -10,21 +14,6 @@ interface Serializer {
     stringify: (value: unknown) => string;
     parse: <T>(text: string) => T;
 }
-/**
- * IdEncoder for transforming IDs to filesystem-safe filenames
- * Useful for characters not allowed in filesystem (e.g., `:` on Windows)
- */
-interface IdEncoder {
-    /** Transform ID to filename-safe string */
-    encode: (id: string) => string;
-    /** Recover original ID from filename */
-    decode: (encoded: string) => string;
-}
-/**
- * Default encoder: `:` → `_` (for IDs like "human:camilo")
- * Reversible because IDs cannot contain `_` (see id_generator.ts)
- */
-declare const DEFAULT_ID_ENCODER: IdEncoder;
 /**
  * Options for FsRecordStore
  */
@@ -63,6 +52,10 @@ declare class FsRecordStore<T> implements RecordStore<T> {
     private getFilePath;
     get(id: string): Promise<T | null>;
     put(id: string, value: T): Promise<void>;
+    putMany(entries: Array<{
+        id: string;
+        value: T;
+    }>): Promise<void>;
     delete(id: string): Promise<void>;
     list(): Promise<string[]>;
     exists(id: string): Promise<boolean>;
@@ -247,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;
 }
@@ -920,6 +913,7 @@ declare class LocalGitModule implements IGitModule {
      */
     add(filePaths: string[], options?: {
         force?: boolean;
+        contentMap?: Record<string, string>;
     }): Promise<void>;
     /**
      * Removes files from both working directory and staging area
@@ -1366,4 +1360,22 @@ declare class FsAgentRunner implements IAgentRunner {
  */
 declare function createAgentRunner(deps: AgentRunnerDependencies): IAgentRunner;
 
-export { DEFAULT_ID_ENCODER, 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, LocalGitModule as GitModule, GitModuleDependencies, type IFsLintModule, IGitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };

package/dist/src/fs.js

@@ -16,10 +16,14 @@ import os from 'os';
 import chokidar from 'chokidar';
 
 // src/record_store/fs/fs_record_store.ts
+
+// src/record_store/record_store.ts
 var DEFAULT_ID_ENCODER = {
   encode: (id) => id.replace(/:/g, "_"),
   decode: (encoded) => encoded.replace(/_/g, ":")
 };
+
+// src/record_store/fs/fs_record_store.ts
 var DEFAULT_SERIALIZER = {
   stringify: (value) => JSON.stringify(value, null, 2),
   parse: (text) => JSON.parse(text)
@@ -70,6 +74,11 @@ var FsRecordStore = class {
     const content = this.serializer.stringify(value);
     await fs.writeFile(filePath, content, "utf-8");
   }
+  async putMany(entries) {
+    for (const { id, value } of entries) {
+      await this.put(id, value);
+    }
+  }
   async delete(id) {
     const filePath = this.getFilePath(id);
     try {
@@ -3510,25 +3519,25 @@ var FsLintModule = class {
     this.projectRoot = dependencies.projectRoot;
     this.lintModule = dependencies.lintModule;
     this.fileSystem = dependencies.fileSystem ?? {
-      readFile: async (path12, encoding) => {
-        return promises.readFile(path12, encoding);
+      readFile: async (path13, encoding) => {
+        return promises.readFile(path13, encoding);
       },
-      writeFile: async (path12, content) => {
-        await promises.writeFile(path12, content, "utf-8");
+      writeFile: async (path13, content) => {
+        await promises.writeFile(path13, content, "utf-8");
       },
-      exists: async (path12) => {
+      exists: async (path13) => {
         try {
-          await promises.access(path12);
+          await promises.access(path13);
           return true;
         } catch {
           return false;
         }
       },
-      unlink: async (path12) => {
-        await promises.unlink(path12);
+      unlink: async (path13) => {
+        await promises.unlink(path13);
       },
-      readdir: async (path12) => {
-        return readdir(path12);
+      readdir: async (path13) => {
+        return readdir(path13);
       }
     };
   }
@@ -5809,7 +5818,7 @@ var FsSyncStateModule = class {
       throw new Error("LintModule is required for SyncStateModule");
     }
     if (!dependencies.indexer) {
-      throw new Error("IndexerAdapter is required for SyncStateModule");
+      throw new Error("RecordProjector is required for SyncStateModule");
     }
     this.git = dependencies.git;
     this.config = dependencies.config;
@@ -7298,7 +7307,7 @@ To avoid losing your changes, push first or use --force to overwrite.`,
         }
       }
       if (shouldReindex) {
-        logger6.info("Invoking IndexerAdapter.generateIndex() after pull...");
+        logger6.info("Invoking RecordProjector.generateIndex() after pull...");
         try {
           await this.indexer.generateIndex();
           logger6.info("Index regenerated successfully");
@@ -7543,7 +7552,7 @@ Signed-off-by: ${actorId}`;
       log("Temp directory cleaned up");
     } catch {
     }
-    logger6.info("Invoking IndexerAdapter.generateIndex() after conflict resolution...");
+    logger6.info("Invoking RecordProjector.generateIndex() after conflict resolution...");
     try {
       await this.indexer.generateIndex();
       logger6.info("Index regenerated successfully after conflict resolution");
@@ -8444,7 +8453,50 @@ var FsAgentRunner = class {
 function createAgentRunner(deps) {
   return new FsAgentRunner(deps);
 }
+var FsRecordProjection = class {
+  indexPath;
+  constructor(options) {
+    this.indexPath = path9.join(options.basePath, "index.json");
+  }
+  async persist(data, _context) {
+    const dir = path9.dirname(this.indexPath);
+    await fs.mkdir(dir, { recursive: true });
+    const tmpPath = `${this.indexPath}.tmp`;
+    const content = JSON.stringify(data, null, 2);
+    await fs.writeFile(tmpPath, content, "utf-8");
+    await fs.rename(tmpPath, this.indexPath);
+  }
+  async read(_context) {
+    try {
+      const content = await fs.readFile(this.indexPath, "utf-8");
+      return JSON.parse(content);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return null;
+      }
+      throw error;
+    }
+  }
+  async exists(_context) {
+    try {
+      await fs.access(this.indexPath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async clear(_context) {
+    try {
+      await fs.unlink(this.indexPath);
+    } catch (error) {
+      if (error.code === "ENOENT") {
+        return;
+      }
+      throw error;
+    }
+  }
+};
 
-export { DEFAULT_ID_ENCODER, FsAgentRunner, FsConfigStore, FsFileLister, FsKeyProvider, FsLintModule, FsProjectInitializer, FsRecordStore, FsSessionStore, FsSyncStateModule, FsWatcherStateModule, LocalGitModule as GitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };
+export { DEFAULT_ID_ENCODER, FsAgentRunner, FsConfigStore, FsFileLister, FsKeyProvider, FsLintModule, FsProjectInitializer, FsRecordProjection, FsRecordStore, FsSessionStore, FsSyncStateModule, FsWatcherStateModule, LocalGitModule as GitModule, LocalGitModule, createAgentRunner, createConfigManager, createSessionManager, findGitgovRoot, findProjectRoot, getGitgovPath, isGitgovProject, resetDiscoveryCache };
 //# sourceMappingURL=fs.js.map
 //# sourceMappingURL=fs.js.map