@gitgov/core 2.6.0 → 2.7.1

package/dist/src/{record_projection.types-B8AM7u8U.d.ts → record_projection.types-D9NkQbL_.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.
@@ -453,15 +514,7 @@ type EmbeddedMetadataRecord$1 = {
         /**
          * The type of the record contained in the payload.
          */
-        type: 'actor' | 'agent' | 'task' | 'execution' | 'changelog' | 'feedback' | 'cycle' | 'custom';
-        /**
-         * Optional URL to a custom schema for the payload.
-         */
-        schemaUrl?: string;
-        /**
-         * Optional SHA-256 checksum of the custom schema.
-         */
-        schemaChecksum?: string;
+        type: 'actor' | 'agent' | 'task' | 'execution' | 'changelog' | 'feedback' | 'cycle';
         /**
          * SHA-256 checksum of the canonically serialized payload.
          */
@@ -546,21 +599,14 @@ type EmbeddedMetadataRecord<T extends GitGovRecordPayload> = {
     payload: T;
 };
 
-/**
- * A custom record type for testing purposes.
- */
-type CustomRecord = {
-    type: 'custom';
-    data: unknown;
-};
 /**
  * Defines the possible 'type' values for any record in the system.
  */
-type GitGovRecordType = "actor" | "agent" | "cycle" | "task" | "execution" | "changelog" | "feedback" | "custom";
+type GitGovRecordType = "actor" | "agent" | "cycle" | "task" | "execution" | "changelog" | "feedback";
 /**
  * The canonical payload for any GitGovernance record.
  */
-type GitGovRecordPayload = ActorRecord | AgentRecord | CycleRecord | TaskRecord | ExecutionRecord | ChangelogRecord | FeedbackRecord | CustomRecord;
+type GitGovRecordPayload = ActorRecord | AgentRecord | CycleRecord | TaskRecord | ExecutionRecord | ChangelogRecord | FeedbackRecord;
 /**
  * The canonical type for any record in GitGovernance, wrapping a payload with metadata.
  */
@@ -1163,8 +1209,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 +1249,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 EventSubscription as $, type ActorPayload as A, type IRecordMetrics as B, type ChangelogPayload as C, DEFAULT_ID_ENCODER as D, type EmbeddedMetadataHeader as E, type FeedbackPayload as F, type GitGovRecord as G, type ProductivityMetrics as H, type IdEncoder as I, RecordMetrics as J, type RecordMetricsDependencies as K, type SystemStatus as L, type TaskHealthReport as M, type ActivityEvent as N, type ActorCreatedEvent as O, type ProjectionContext as P, type ActorRevokedEvent as Q, type RecordStore as R, type Signature as S, type TaskPayload as T, type AgentRegisteredEvent as U, type BaseEvent as V, type ChangelogCreatedEvent as W, type CycleCreatedEvent as X, type CycleStatusChangedEvent as Y, type EventHandler as Z, type EventMetadata as _, type IRecordProjector as a, type ExecutionCreatedEvent as a0, type FeedbackCreatedEvent as a1, type GitGovEvent as a2, type SystemDailyTickEvent as a3, type TaskCreatedEvent as a4, type TaskStatusChangedEvent as a5, type RecordProjectorDependencies as a6, type IndexGenerationReport as a7, type IntegrityReport as a8, type AllRecords as a9, type DerivedStates as aa, type EnrichedTaskRecord as ab, type DerivedStateSets as ac, type IntegrityError as ad, type IntegrityWarning as ae, 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 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 RecordStores as y, type CollaborationMetrics 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 };