@gitgov/core 2.5.0 → 2.7.0

package/dist/src/key_provider-jjWek3w1.d.ts

@@ -1,227 +0,0 @@
-/**
- * SessionManager Types
- */
-/**
- * Sync status for an actor's synchronization state.
- */
-type SyncStatus = {
-    lastSyncPush?: string;
-    lastSyncPull?: string;
-    status?: 'synced' | 'pending' | 'pulling' | 'pushing' | 'conflict';
-    lastError?: string;
-};
-/**
- * State for a specific actor on this machine.
- */
-type ActorState = {
-    activeTaskId?: string | undefined;
-    activeCycleId?: string | undefined;
-    lastSync?: string;
-    syncStatus?: SyncStatus;
-    [key: string]: unknown;
-};
-/**
- * GitGovernance Session State
- * Based on session_state.md blueprint
- */
-type GitGovSession = {
-    cloud?: {
-        sessionToken?: string;
-    };
-    lastSession?: {
-        actorId: string;
-        timestamp: string;
-    };
-    actorState?: Record<string, ActorState>;
-    syncPreferences?: {
-        pullScheduler?: {
-            enabled?: boolean;
-            pullIntervalSeconds?: number;
-            continueOnNetworkError?: boolean;
-            stopOnConflict?: boolean;
-        };
-        fileWatcher?: {
-            enabled?: boolean;
-            debounceMs?: number;
-            ignoredPatterns?: string[];
-        };
-    };
-};
-/**
- * Sync preferences update payload
- */
-type SyncPreferencesUpdate = {
-    pullScheduler?: Partial<{
-        enabled: boolean;
-        pullIntervalSeconds: number;
-        continueOnNetworkError: boolean;
-        stopOnConflict: boolean;
-    }>;
-    fileWatcher?: Partial<{
-        enabled: boolean;
-        debounceMs: number;
-        ignoredPatterns: string[];
-    }>;
-};
-/**
- * ISessionManager interface
- *
- * Provides typed access to GitGovernance session state.
- * Session state is ephemeral, machine-local, and NOT versioned in Git.
- */
-interface ISessionManager {
-    /**
-     * Load GitGovernance session state
-     * [EARS-B9] Auto-detects actor from .key files if no session or no actorId exists
-     */
-    loadSession(): Promise<GitGovSession | null>;
-    /**
-     * [EARS-B9] Detect actor from .key files in .gitgov/actors/
-     */
-    detectActorFromKeyFiles(): Promise<string | null>;
-    /**
-     * Get actor state for a specific actor
-     */
-    getActorState(actorId: string): Promise<ActorState | null>;
-    /**
-     * Update actor state for a specific actor
-     */
-    updateActorState(actorId: string, state: Partial<ActorState>): Promise<void>;
-    /**
-     * Get cloud session token
-     */
-    getCloudSessionToken(): Promise<string | null>;
-    /**
-     * Get sync preferences from session
-     */
-    getSyncPreferences(): Promise<GitGovSession['syncPreferences'] | null>;
-    /**
-     * Update sync preferences in .session.json
-     * These are local machine preferences that override project defaults
-     */
-    updateSyncPreferences(preferences: SyncPreferencesUpdate): Promise<void>;
-    /**
-     * Get last session info (last human who interacted)
-     */
-    getLastSession(): Promise<{
-        actorId: string;
-        timestamp: string;
-    } | null>;
-}
-
-/**
- * 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>;
-}
-
-/**
- * KeyProvider Interface
- *
- * Abstracts private key storage for Actor signing operations.
- * Enables different backends: filesystem (development), environment variables (serverless),
- * or cloud KMS (enterprise).
- *
- * @module key_provider
- */
-/**
- * Error codes for KeyProvider operations.
- */
-type KeyProviderErrorCode = 'KEY_NOT_FOUND' | 'KEY_READ_ERROR' | 'KEY_WRITE_ERROR' | 'KEY_DELETE_ERROR' | 'INVALID_KEY_FORMAT' | 'INVALID_ACTOR_ID';
-/**
- * Error thrown when key operations fail.
- */
-declare class KeyProviderError extends Error {
-    readonly code: KeyProviderErrorCode;
-    readonly actorId?: string | undefined;
-    constructor(message: string, code: KeyProviderErrorCode, actorId?: string | undefined);
-}
-/**
- * Interface for managing private key storage.
- * Implementations handle the actual persistence mechanism.
- *
- * @example
- * ```typescript
- * // Filesystem backend (development)
- * const provider = new FsKeyProvider({ keysDir: '.gitgov/keys' });
- *
- * // Environment backend (serverless)
- * const provider = new EnvKeyProvider({ prefix: 'GITGOV_KEY_' });
- *
- * // Usage
- * const privateKey = await provider.getPrivateKey('actor:human:alice');
- * if (privateKey) {
- *   const signature = signPayload(payload, privateKey, actorId, role);
- * }
- * ```
- */
-interface KeyProvider {
-    /**
-     * Retrieves the private key for an actor.
-     * @param actorId - The actor's ID (e.g., 'actor:human:alice')
-     * @returns The base64-encoded private key, or null if not found
-     */
-    getPrivateKey(actorId: string): Promise<string | null>;
-    /**
-     * Stores a private key for an actor.
-     * @param actorId - The actor's ID
-     * @param privateKey - The base64-encoded private key
-     * @throws KeyProviderError if write fails
-     */
-    setPrivateKey(actorId: string, privateKey: string): Promise<void>;
-    /**
-     * Checks if a private key exists for an actor.
-     * @param actorId - The actor's ID
-     * @returns true if key exists, false otherwise
-     */
-    hasPrivateKey(actorId: string): Promise<boolean>;
-    /**
-     * Deletes the private key for an actor.
-     * @param actorId - The actor's ID
-     * @returns true if key was deleted, false if it didn't exist
-     */
-    deletePrivateKey(actorId: string): Promise<boolean>;
-}
-
-export { type ActorState as A, type GitGovSession as G, type ISessionManager as I, type KeyProvider as K, type SessionStore as S, type SyncPreferencesUpdate as a, type SyncStatus as b, KeyProviderError as c, type KeyProviderErrorCode as d };

package/dist/src/record_store-BXKWqon5.d.ts

@@ -1,64 +0,0 @@
-/**
- * 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>;
-}
-
-export { DEFAULT_ID_ENCODER as D, type IdEncoder as I, type RecordStore as R };