@gitgov/core 2.6.0 → 2.7.0

package/dist/src/{record_projection.types-B8AM7u8U.d.ts → record_projection.types-Dz9YU3r9.d.ts}

@@ -1,4 +1,65 @@
-import { R as RecordStore } from './record_store-BXKWqon5.js';
+/**
+ * IdEncoder for transforming IDs to storage-safe filenames.
+ * Useful for characters not allowed in filesystem (e.g., `:` on Windows)
+ * or URL-unsafe characters in remote backends.
+ */
+interface IdEncoder {
+    /** Transform ID to storage-safe string */
+    encode: (id: string) => string;
+    /** Recover original ID from encoded string */
+    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;
+/**
+ * RecordStore<V, R, O> - Generic interface for record persistence
+ *
+ * Abstracts CRUD operations without assuming storage backend.
+ * Each implementation decides how to persist (fs, memory, db, remote).
+ *
+ * @typeParam V - Value type (the record being stored)
+ * @typeParam R - Return type for write operations (default: void for local, GitHubWriteResult for GitHub)
+ * @typeParam O - Options type for write operations (default: void for local, GitHubWriteOpts for GitHub)
+ */
+interface RecordStore<V, R = void, O = void> {
+    /**
+     * Gets a record by ID
+     * @returns The record or null if it doesn't exist
+     */
+    get(id: string): Promise<V | null>;
+    /**
+     * Persists a record
+     * @param id - Unique identifier
+     * @param value - The record to persist
+     */
+    put(id: string, value: V, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Persists multiple records in a single operation.
+     * Local backends iterate sequentially; GitHub backend uses atomic commits.
+     */
+    putMany(entries: Array<{
+        id: string;
+        value: V;
+    }>, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Deletes a record
+     * @param id - Identifier of the record to delete
+     */
+    delete(id: string, ...opts: O extends void ? [] : [opts?: O]): Promise<R>;
+    /**
+     * Lists all record IDs
+     * @returns Array of IDs
+     */
+    list(): Promise<string[]>;
+    /**
+     * Checks if a record exists
+     * @param id - Identifier to check
+     */
+    exists(id: string): Promise<boolean>;
+}
 
 /**
  * This file was automatically generated from actor_record_schema.json.
@@ -1163,8 +1224,7 @@ type ProjectionContext = {
  *
  * Abstracts where IndexData is persisted. Implementations:
  * - FsRecordProjection: writes to .gitgov/index.json (CLI)
- * - MemoryRecordProjection: in-memory Map (tests)
- * - PrismaRecordProjection: stores as JSON blob via Prisma-compatible client (SaaS)
+ * - PrismaRecordProjection: decomposes into 6 queryable Prisma tables (SaaS)
  */
 interface IRecordProjection {
     persist(data: IndexData, context: ProjectionContext): Promise<void>;
@@ -1204,4 +1264,4 @@ interface IRecordProjector {
     invalidateCache(): Promise<void>;
 }
 
-export { type FeedbackCreatedEvent as $, type ActorPayload as A, type ProductivityMetrics as B, type ChangelogPayload as C, RecordMetrics as D, type EmbeddedMetadataHeader as E, type FeedbackPayload as F, type GitGovRecord as G, type RecordMetricsDependencies as H, type IRecordProjector as I, type SystemStatus as J, type TaskHealthReport as K, type ActivityEvent as L, type ActorCreatedEvent as M, type ActorRevokedEvent as N, type AgentRegisteredEvent as O, type ProjectionContext as P, type BaseEvent as Q, type RecordStores as R, type Signature as S, type TaskPayload as T, type ChangelogCreatedEvent as U, type CycleCreatedEvent as V, type CycleStatusChangedEvent as W, type EventHandler as X, type EventMetadata as Y, type EventSubscription as Z, type ExecutionCreatedEvent as _, type IRecordProjection as a, type GitGovEvent as a0, type SystemDailyTickEvent as a1, type TaskCreatedEvent as a2, type TaskStatusChangedEvent as a3, type RecordProjectorDependencies as a4, type IndexGenerationReport as a5, type IntegrityReport as a6, type AllRecords as a7, type DerivedStates as a8, type EnrichedTaskRecord as a9, type DerivedStateSets as aa, type IntegrityError as ab, type IntegrityWarning as ac, type IndexData as b, type ActorRecord as c, type AgentPayload as d, type AgentRecord as e, type ChangelogRecord as f, type CustomRecord as g, type CyclePayload as h, type CycleRecord as i, type EmbeddedMetadataRecord as j, type ExecutionPayload as k, type ExecutionRecord as l, type FeedbackRecord as m, type GitGovActorRecord as n, type GitGovAgentRecord as o, type GitGovChangelogRecord as p, type GitGovCycleRecord as q, GitGovError as r, type GitGovExecutionRecord as s, type GitGovFeedbackRecord as t, type GitGovRecordPayload as u, type GitGovRecordType as v, type GitGovTaskRecord as w, type TaskRecord as x, type CollaborationMetrics as y, type IRecordMetrics as z };
+export { type EventMetadata as $, type ActorPayload as A, type CollaborationMetrics as B, type ChangelogPayload as C, DEFAULT_ID_ENCODER as D, type EmbeddedMetadataHeader as E, type FeedbackPayload as F, type GitGovRecord as G, type IRecordMetrics as H, type IdEncoder as I, type ProductivityMetrics as J, RecordMetrics as K, type RecordMetricsDependencies as L, type SystemStatus as M, type TaskHealthReport as N, type ActivityEvent as O, type ProjectionContext as P, type ActorCreatedEvent as Q, type RecordStore as R, type Signature as S, type TaskPayload as T, type ActorRevokedEvent as U, type AgentRegisteredEvent as V, type BaseEvent as W, type ChangelogCreatedEvent as X, type CycleCreatedEvent as Y, type CycleStatusChangedEvent as Z, type EventHandler as _, type IRecordProjector as a, type EventSubscription as a0, type ExecutionCreatedEvent as a1, type FeedbackCreatedEvent as a2, type GitGovEvent as a3, type SystemDailyTickEvent as a4, type TaskCreatedEvent as a5, type TaskStatusChangedEvent as a6, type RecordProjectorDependencies as a7, type IndexGenerationReport as a8, type IntegrityReport as a9, type AllRecords as aa, type DerivedStates as ab, type EnrichedTaskRecord as ac, type DerivedStateSets as ad, type IntegrityError as ae, type IntegrityWarning as af, type IRecordProjection as b, type IndexData as c, type ActorRecord as d, type AgentPayload as e, type AgentRecord as f, type ChangelogRecord as g, type CustomRecord as h, type CyclePayload as i, type CycleRecord as j, type EmbeddedMetadataRecord as k, type ExecutionPayload as l, type ExecutionRecord as m, type FeedbackRecord as n, type GitGovActorRecord as o, type GitGovAgentRecord as p, type GitGovChangelogRecord as q, type GitGovCycleRecord as r, GitGovError as s, type GitGovExecutionRecord as t, type GitGovFeedbackRecord as u, type GitGovRecordPayload as v, type GitGovRecordType as w, type GitGovTaskRecord as x, type TaskRecord as y, type RecordStores as z };

package/dist/src/session_store-I4Z6PW2c.d.ts

@@ -0,0 +1,50 @@
+import { a as GitGovSession } from './index-LULVRsCZ.js';
+
+/**
+ * SessionStore - Session persistence abstraction
+ *
+ * Interface for storing and retrieving local session state (.session.json).
+ * Session state is ephemeral, machine-local, and NOT versioned in Git.
+ *
+ * Implementations:
+ * - FsSessionStore: Filesystem-based (production)
+ * - MemorySessionStore: In-memory (tests, serverless)
+ */
+
+/**
+ * Interface for session state persistence.
+ *
+ * Session state includes:
+ * - Actor state (activeTaskId, activeCycleId, syncStatus)
+ * - Sync preferences (pullScheduler, fileWatcher settings)
+ * - Cloud session tokens
+ * - Last session information
+ *
+ * Unlike ConfigStore, SessionStore handles ephemeral, machine-local state
+ * that is NOT shared between collaborators.
+ */
+interface SessionStore {
+    /**
+     * Load session state from storage.
+     *
+     * @returns GitGovSession object or null if not found
+     */
+    loadSession(): Promise<GitGovSession | null>;
+    /**
+     * Save session state to storage.
+     *
+     * @param session - The session state to persist
+     */
+    saveSession(session: GitGovSession): Promise<void>;
+    /**
+     * Detect actor from private key files.
+     *
+     * Optional method for implementations that support actor auto-detection
+     * from .key files in the actors directory.
+     *
+     * @returns Actor ID (e.g., "human:camilo-v2") or null if not detectable
+     */
+    detectActorFromKeyFiles?(): Promise<string | null>;
+}
+
+export type { SessionStore as S };