@gitgov/core 2.1.2 → 2.3.0

package/dist/src/{agent_runner-ByOUWOt6.d.ts → agent_runner-D7JahEKk.d.ts}

@@ -1,4 +1,7 @@
-import { m as IConfigManager, C as ConfigStore, G as GitGovConfig, n as SyncConfig, o as SyncDefaults, k as AuditState, l as AuditStateUpdate, h as ISessionManager, S as SessionStore, a as GitGovSession, A as ActorState, i as SyncPreferencesUpdate, K as KeyProvider, s as FileLister, F as FsFileListerOptions, r as FileListOptions, t as FileStats, R as RecordStore, I as IGitModule } from './index--ahcnsG3.js';
+import { I as ISessionManager, S as SessionStore, G as GitGovSession, A as ActorState, a as SyncPreferencesUpdate, K as KeyProvider } from './key_provider-CRpHFGjN.js';
+import { k as IConfigManager, C as ConfigStore, G as GitGovConfig, S as SyncConfig, l as SyncDefaults, A as AuditState, j as AuditStateUpdate, g as FileLister, F as FsFileListerOptions, h as FileListOptions, i as FileStats, I as IGitModule } from './index-Bhc341pf.js';
+import { R as RecordStore } from './record_store-BXKWqon5.js';
+import { Q as BaseEvent, X as EventHandler, Z as EventSubscription, a0 as GitGovEvent, G as GitGovRecord, v as GitGovRecordType, I as IRecordProjector, A as ActorPayload, c as ActorRecord, R as RecordStores$1, l as ExecutionRecord, e as AgentRecord } from './record_projection.types-B8AM7u8U.js';
 
 /**
  * ConfigManager - Project Configuration Manager
@@ -269,1017 +272,6 @@ declare class FsFileLister implements FileLister {
     private validatePath;
 }
 
-/**
- * This file was automatically generated from actor_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for actor records as defined in actor_protocol.md
- */
-interface ActorRecord {
-    /**
-     * Unique, human-readable identifier for the actor.
-     */
-    id: string;
-    /**
-     * The type of actor.
-     */
-    type: 'human' | 'agent';
-    /**
-     * The name of the actor to be used in user interfaces.
-     */
-    displayName: string;
-    /**
-     * The Ed25519 public key (base64 encoded, 44 characters) for verifying the actor's signatures.
-     */
-    publicKey: string;
-    /**
-     * List of capacity roles defining the actor's skills and permissions. Uses hierarchical format with colons.
-     *
-     * @minItems 1
-     */
-    roles: [string, ...string[]];
-    /**
-     * Optional. The lifecycle status of the actor. Defaults to 'active' if not specified.
-     */
-    status?: 'active' | 'revoked';
-    /**
-     * Optional. The ID of the actor that replaces this one.
-     */
-    supersededBy?: string;
-    /**
-     * An optional field for additional, non-canonical metadata.
-     */
-    metadata?: {};
-}
-
-/**
- * This file was automatically generated from agent_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for agent operational manifests.
- */
-interface AgentRecord<TMetadata = object> {
-    /**
-     * Unique identifier for the agent, linking to an ActorRecord.
-     */
-    id: string;
-    status?: 'active' | 'archived';
-    /**
-     * Optional list of triggers that activate the agent.
-     * Additional fields are allowed and depend on trigger type:
-     * - webhook triggers: 'event' (event identifier), 'filter' (condition)
-     * - scheduled triggers: 'cron' (cron expression)
-     * - manual triggers: 'command' (example CLI command)
-     *
-     */
-    triggers?: {
-        /**
-         * Type of trigger that activates the agent
-         */
-        type: 'manual' | 'webhook' | 'scheduled';
-        [k: string]: unknown | undefined;
-    }[];
-    knowledge_dependencies?: string[];
-    prompt_engine_requirements?: {
-        roles?: string[];
-        skills?: string[];
-    };
-    /**
-     * Optional framework-specific or deployment-specific metadata for agent extensions.
-     * Common use cases: framework identification (langchain, google-adk), deployment info (provider, image, region),
-     * cost tracking (cost_per_invocation, currency), tool capabilities, maintainer info.
-     * This field does NOT affect agent execution - it is purely informational.
-     *
-     */
-    metadata?: TMetadata;
-    engine: {
-        type: 'local';
-        /**
-         * Runtime environment (typescript, python, etc.)
-         */
-        runtime?: string;
-        /**
-         * Path to the agent entry file
-         */
-        entrypoint?: string;
-        /**
-         * Function name to invoke
-         */
-        function?: string;
-    } | {
-        type: 'api';
-        /**
-         * HTTP endpoint for the agent
-         */
-        url: string;
-        method?: 'POST' | 'GET' | 'PUT';
-        /**
-         * Authentication configuration for API requests
-         */
-        auth?: {
-            /**
-             * Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests.
-             */
-            type?: 'bearer' | 'oauth' | 'api-key' | 'actor-signature';
-            /**
-             * Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)
-             */
-            secret_key?: string;
-            /**
-             * Direct token value (not recommended for production, use secret_key instead)
-             */
-            token?: string;
-            [k: string]: unknown | undefined;
-        };
-    } | {
-        type: 'mcp';
-        /**
-         * MCP server endpoint
-         */
-        url: string;
-        /**
-         * Name of the MCP tool to invoke. If not specified, defaults to agentId without 'agent:' prefix.
-         */
-        tool?: string;
-        /**
-         * Authentication configuration for MCP server
-         */
-        auth?: {
-            /**
-             * Authentication type. 'actor-signature' uses the agent's ActorRecord keypair to sign requests.
-             */
-            type?: 'bearer' | 'oauth' | 'api-key' | 'actor-signature';
-            /**
-             * Reference to secret in Secret Manager (for bearer/api-key/oauth auth types)
-             */
-            secret_key?: string;
-            /**
-             * Direct token value (not recommended for production, use secret_key instead)
-             */
-            token?: string;
-            [k: string]: unknown | undefined;
-        };
-    } | {
-        type: 'custom';
-        /**
-         * Custom protocol identifier (e.g., 'a2a', 'grpc')
-         */
-        protocol?: string;
-        /**
-         * Protocol-specific configuration
-         */
-        config?: {};
-    };
-}
-
-/**
- * This file was automatically generated from changelog_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for changelog records - aggregates N tasks into 1 release note
- */
-interface ChangelogRecord {
-    /**
-     * Unique identifier for the changelog entry
-     */
-    id: string;
-    /**
-     * Executive title of the deliverable
-     */
-    title: string;
-    /**
-     * Detailed description of the value delivered, including key decisions and impact
-     */
-    description: string;
-    /**
-     * IDs of tasks that compose this deliverable (minimum 1 required)
-     *
-     * @minItems 1
-     */
-    relatedTasks: [string, ...string[]];
-    /**
-     * Unix timestamp in seconds when the deliverable was completed
-     */
-    completedAt: number;
-    /**
-     * Optional IDs of cycles related to this deliverable
-     */
-    relatedCycles?: string[];
-    /**
-     * Optional IDs of key execution records related to this work
-     */
-    relatedExecutions?: string[];
-    /**
-     * Optional version or release identifier (e.g., 'v1.0.0', 'sprint-24')
-     */
-    version?: string;
-    /**
-     * Optional tags for categorization (e.g., 'feature:auth', 'bugfix', 'security')
-     */
-    tags?: string[];
-    /**
-     * Optional list of git commit hashes related to this deliverable
-     */
-    commits?: string[];
-    /**
-     * Optional list of main files that were created or modified
-     */
-    files?: string[];
-    /**
-     * Optional additional context, decisions, or learnings
-     */
-    notes?: string;
-}
-
-/**
- * This file was automatically generated from cycle_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for cycle records - strategic grouping of work
- */
-interface CycleRecord {
-    /**
-     * Unique identifier for the cycle (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)
-     */
-    id: string;
-    /**
-     * Human-readable title for the cycle (e.g., 'Sprint 24', 'Auth v2.0', 'Q4 2025')
-     */
-    title: string;
-    /**
-     * The lifecycle status of the cycle
-     */
-    status: 'planning' | 'active' | 'completed' | 'archived';
-    /**
-     * Optional array of Task IDs that belong to this cycle. Can be empty for cycles that only contain child cycles. (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)
-     */
-    taskIds?: string[];
-    /**
-     * Optional array of Cycle IDs that are children of this cycle, allowing for hierarchies (e.g., Q1 containing Sprint 1, Sprint 2, Sprint 3). (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)
-     */
-    childCycleIds?: string[];
-    /**
-     * Optional list of key:value tags for categorization (e.g., 'roadmap:q4', 'team:alpha', 'okr:growth').
-     */
-    tags?: string[];
-    /**
-     * Optional description of the cycle's goals, objectives, and context
-     */
-    notes?: string;
-}
-
-/**
- * This file was automatically generated from execution_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for execution log records - the universal event stream
- */
-interface ExecutionRecord<TMetadata = object> {
-    /**
-     * Unique identifier for the execution log entry (10 timestamp + 1 dash + 4 'exec' + 1 dash + max 50 slug = 66 max)
-     */
-    id: string;
-    /**
-     * ID of the parent task this execution belongs to (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)
-     */
-    taskId: string;
-    /**
-     * Semantic classification of the execution event
-     */
-    type: 'analysis' | 'progress' | 'blocker' | 'completion' | 'info' | 'correction';
-    /**
-     * Human-readable title for the execution (used to generate ID)
-     */
-    title: string;
-    /**
-     * The tangible, verifiable output or result of the execution.
-     * This is the "WHAT" - evidence of work or event summary.
-     *
-     */
-    result: string;
-    /**
-     * Optional narrative, context and decisions behind the execution.
-     * This is the "HOW" and "WHY" - the story behind the result.
-     *
-     */
-    notes?: string;
-    /**
-     * Optional list of typed references to relevant commits, files, PRs, or external documents.
-     * Should use typed prefixes for clarity and trazabilidad (see execution_protocol_appendix.md):
-     * - commit:     Git commit SHA
-     * - pr:         Pull Request number
-     * - file:       File path (relative to repo root)
-     * - url:        External URL
-     * - issue:      GitHub Issue number
-     * - task:       TaskRecord ID
-     * - exec:       ExecutionRecord ID (for corrections or dependencies)
-     * - changelog:  ChangelogRecord ID
-     *
-     */
-    references?: string[];
-    /**
-     * Optional structured data for machine consumption.
-     * Use this field for data that needs to be programmatically processed (e.g., audit findings,
-     * performance metrics, scan results). This complements result (human-readable WHAT) and
-     * notes (narrative HOW/WHY) by providing structured, queryable data.
-     * Common use cases: audit findings arrays, performance metrics, tool outputs, scan summaries.
-     *
-     */
-    metadata?: TMetadata;
-}
-
-/**
- * This file was automatically generated from feedback_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for feedback records - structured conversation about work
- */
-interface FeedbackRecord<TMetadata = object> {
-    /**
-     * Unique identifier for the feedback entry
-     */
-    id: string;
-    /**
-     * The type of entity this feedback refers to
-     */
-    entityType: 'task' | 'execution' | 'changelog' | 'feedback' | 'cycle';
-    /**
-     * The ID of the entity this feedback refers to.
-     * Must match the pattern for its entityType:
-     * - task: ^\d{10}-task-[a-z0-9-]{1,50}$
-     * - execution: ^\d{10}-exec-[a-z0-9-]{1,50}$
-     * - changelog: ^\d{10}-changelog-[a-z0-9-]{1,50}$
-     * - feedback: ^\d{10}-feedback-[a-z0-9-]{1,50}$
-     * - cycle: ^\d{10}-cycle-[a-z0-9-]{1,50}$
-     *
-     */
-    entityId: string;
-    /**
-     * The semantic intent of the feedback
-     */
-    type: 'blocking' | 'suggestion' | 'question' | 'approval' | 'clarification' | 'assignment';
-    /**
-     * The lifecycle status of the feedback.
-     * Note: FeedbackRecords are immutable. To change status, create a new feedback
-     * that references this one using entityType: "feedback" and resolvesFeedbackId.
-     *
-     */
-    status: 'open' | 'acknowledged' | 'resolved' | 'wontfix';
-    /**
-     * The content of the feedback. Reduced from 10000 to 5000 chars for practical use.
-     */
-    content: string;
-    /**
-     * Optional. The Actor ID responsible for addressing the feedback (e.g., 'human:maria', 'agent:camilo:cursor')
-     */
-    assignee?: string;
-    /**
-     * Optional. The ID of another feedback record that this one resolves or responds to
-     */
-    resolvesFeedbackId?: string;
-    /**
-     * Optional structured data for machine consumption.
-     * Use this field for domain-specific data that needs to be programmatically processed.
-     * Common use cases: waiver details (fingerprint, ruleId, file, line), approval context, assignment metadata.
-     *
-     */
-    metadata?: TMetadata;
-}
-
-/**
- * This file was automatically generated from task_record_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for task records as defined in task_protocol.md
- */
-interface TaskRecord {
-    /**
-     * Unique identifier for the task (10 timestamp + 1 dash + 4 'task' + 1 dash + max 50 slug = 66 max)
-     */
-    id: string;
-    /**
-     * A brief, human-readable title for the task. Used to generate the ID slug.
-     */
-    title: string;
-    /**
-     * Optional. The IDs of the strategic cycles this task belongs to. (10 timestamp + 1 dash + 5 'cycle' + 1 dash + max 50 slug = 67 max)
-     */
-    cycleIds?: string[];
-    /**
-     * Current state of the task in the institutional flow
-     */
-    status: 'draft' | 'review' | 'ready' | 'active' | 'done' | 'archived' | 'paused' | 'discarded';
-    /**
-     * Strategic or tactical priority level
-     */
-    priority: 'low' | 'medium' | 'high' | 'critical';
-    /**
-     * Functional, technical or strategic summary of the objective
-     */
-    description: string;
-    /**
-     * Optional. List of key:value tags for categorization and role suggestion (e.g., 'skill:react', 'role:agent:developer').
-     */
-    tags?: string[];
-    /**
-     * Valid links or files, when mentioned
-     */
-    references?: string[];
-    /**
-     * Additional comments, decisions made or added context
-     */
-    notes?: string;
-}
-
-/**
- * This file was automatically generated from embedded_metadata_schema.json.
- * DO NOT MODIFY IT BY HAND. Instead, modify the source schema,
- * and run 'pnpm compile:types' to regenerate this file.
- */
-/**
- * Canonical schema for the wrapper structure of all GitGovernance records.
- */
-type EmbeddedMetadataRecord$1 = {
-    header: {
-        /**
-         * Version of the embedded metadata format.
-         */
-        version: '1.0';
-        /**
-         * 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;
-        /**
-         * SHA-256 checksum of the canonically serialized payload.
-         */
-        payloadChecksum: string;
-        /**
-         * An array of one or more signature objects.
-         *
-         * @minItems 1
-         */
-        signatures: [
-            {
-                /**
-                 * The Actor ID of the signer (must match ActorRecord.id pattern).
-                 */
-                keyId: string;
-                /**
-                 * The context role of the signature (e.g., 'author', 'reviewer', 'auditor', or 'custom:*').
-                 */
-                role: string;
-                /**
-                 * Human-readable note from the signer. Part of the signature digest.
-                 */
-                notes: string;
-                /**
-                 * The Ed25519 signature (base64 encoded, 88 chars with padding) of the signature digest.
-                 */
-                signature: string;
-                /**
-                 * Unix timestamp of the signature.
-                 */
-                timestamp: number;
-            },
-            ...{
-                /**
-                 * The Actor ID of the signer (must match ActorRecord.id pattern).
-                 */
-                keyId: string;
-                /**
-                 * The context role of the signature (e.g., 'author', 'reviewer', 'auditor', or 'custom:*').
-                 */
-                role: string;
-                /**
-                 * Human-readable note from the signer. Part of the signature digest.
-                 */
-                notes: string;
-                /**
-                 * The Ed25519 signature (base64 encoded, 88 chars with padding) of the signature digest.
-                 */
-                signature: string;
-                /**
-                 * Unix timestamp of the signature.
-                 */
-                timestamp: number;
-            }[]
-        ];
-    };
-    /**
-     * The specific record data, validated against the schema defined by header.type.
-     */
-    payload: {};
-} & {
-    [k: string]: unknown | undefined;
-};
-
-/**
- * Extract Signature type from the auto-generated base type.
- * This is hardcoded solution but avoids duplication and uses the generated type as source of truth.
- */
-type Signature = EmbeddedMetadataRecord$1['header']['signatures'][0];
-/**
- * Extract Header type from the auto-generated base type.
- * This is the complete header structure for EmbeddedMetadata.
- */
-type EmbeddedMetadataHeader = EmbeddedMetadataRecord$1['header'];
-/**
- * Generic version of EmbeddedMetadataRecord that accepts any payload type T.
- * This extends the auto-generated base type but makes the payload generic.
- * We need to explicitly preserve the header structure due to the index signature in the base type.
- */
-type EmbeddedMetadataRecord<T extends GitGovRecordPayload> = {
-    header: EmbeddedMetadataHeader;
-    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";
-/**
- * The canonical payload for any GitGovernance record.
- */
-type GitGovRecordPayload = ActorRecord | AgentRecord | CycleRecord | TaskRecord | ExecutionRecord | ChangelogRecord | FeedbackRecord | CustomRecord;
-/**
- * The canonical type for any record in GitGovernance, wrapping a payload with metadata.
- */
-type GitGovRecord = EmbeddedMetadataRecord<GitGovRecordPayload>;
-/**
- * Specific GitGov record types with full metadata (header + payload).
- * These types provide clean, type-safe access to records with their signatures and checksums.
- *
- * @example
- * const taskRecord: GitGovTaskRecord = await taskStore.read(taskId);
- * const authorId = taskRecord.header.signatures[0].keyId;
- */
-type GitGovTaskRecord = EmbeddedMetadataRecord<TaskRecord>;
-type GitGovCycleRecord = EmbeddedMetadataRecord<CycleRecord>;
-type GitGovFeedbackRecord = EmbeddedMetadataRecord<FeedbackRecord>;
-type GitGovExecutionRecord = EmbeddedMetadataRecord<ExecutionRecord>;
-type GitGovChangelogRecord = EmbeddedMetadataRecord<ChangelogRecord>;
-type GitGovActorRecord = EmbeddedMetadataRecord<ActorRecord>;
-type GitGovAgentRecord = EmbeddedMetadataRecord<AgentRecord>;
-type ActorPayload = Partial<ActorRecord>;
-type AgentPayload = Partial<AgentRecord>;
-type CyclePayload = Partial<CycleRecord>;
-type TaskPayload = Partial<TaskRecord>;
-type ExecutionPayload = Partial<ExecutionRecord>;
-type ChangelogPayload = Partial<ChangelogRecord>;
-type FeedbackPayload = Partial<FeedbackRecord>;
-/**
- * Base class for all GitGovernance-specific errors.
- * Centralized here as it's used across multiple modules (schemas, validation, etc.)
- */
-declare class GitGovError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-
-/**
- * RecordStores - Typed container for all stores
- *
- * Allows injecting multiple stores to modules that need them.
- * Keys correspond to directory names in .gitgov/
- *
- * All stores are OPTIONAL.
- * Reason: LintModule.lint(stores) can receive only relevant stores.
- * Example: To validate only tasks, pass { tasks: taskStore }.
- * The module iterates over Object.entries(stores) and skips undefined.
- */
-type RecordStores$1 = {
-    actors?: RecordStore<GitGovActorRecord>;
-    agents?: RecordStore<GitGovAgentRecord>;
-    tasks?: RecordStore<GitGovTaskRecord>;
-    cycles?: RecordStore<GitGovCycleRecord>;
-    executions?: RecordStore<GitGovExecutionRecord>;
-    feedbacks?: RecordStore<GitGovFeedbackRecord>;
-    changelogs?: RecordStore<GitGovChangelogRecord>;
-};
-
-/**
- * MetricsAdapter Dependencies - Facade + Dependency Injection Pattern
- */
-type MetricsAdapterDependencies = {
-    stores: Required<Pick<RecordStores$1, 'tasks' | 'cycles' | 'feedbacks' | 'executions' | 'actors'>>;
-    platformApi?: IPlatformApi;
-};
-interface IPlatformApi {
-    getTokenConsumption(timeframe: string): Promise<TokenConsumption[]>;
-}
-type TokenConsumption = {
-    agentId: string;
-    tokens: number;
-    cost: number;
-    timestamp: number;
-};
-type SystemStatus = {
-    tasks: {
-        total: number;
-        byStatus: Record<string, number>;
-        byPriority: Record<string, number>;
-    };
-    cycles: {
-        total: number;
-        active: number;
-        completed: number;
-    };
-    health: {
-        overallScore: number;
-        blockedTasks: number;
-        staleTasks: number;
-    };
-};
-type TaskHealthReport = {
-    taskId: string;
-    healthScore: number;
-    timeInCurrentStage: number;
-    stalenessIndex: number;
-    blockingFeedbacks: number;
-    lastActivity: number;
-    recommendations: string[];
-};
-type ProductivityMetrics = {
-    throughput: number;
-    leadTime: number;
-    cycleTime: number;
-    tasksCompleted7d: number;
-    averageCompletionTime: number;
-};
-type CollaborationMetrics = {
-    activeAgents: number;
-    totalAgents: number;
-    agentUtilization: number;
-    humanAgentRatio: number;
-    collaborationIndex: number;
-};
-/**
- * MetricsAdapter Interface - The System Analyst
- */
-interface IMetricsAdapter {
-    getSystemStatus(): Promise<SystemStatus>;
-    getTaskHealth(taskId: string): Promise<TaskHealthReport>;
-    getProductivityMetrics(): Promise<ProductivityMetrics>;
-    getCollaborationMetrics(): Promise<CollaborationMetrics>;
-    calculateTimeInCurrentStage(task: TaskRecord): number;
-    calculateStalenessIndex(tasks: TaskRecord[]): number;
-    calculateBlockingFeedbackAge(feedback: FeedbackRecord[]): number;
-    calculateHealth(tasks: TaskRecord[]): number;
-    calculateBacklogDistribution(tasks: TaskRecord[]): Record<string, number>;
-    calculateTasksCreatedToday(tasks: TaskRecord[]): number;
-    calculateThroughput(tasks: TaskRecord[]): number;
-    calculateLeadTime(tasks: TaskRecord[]): number;
-    calculateCycleTime(tasks: TaskRecord[]): number;
-    calculateActiveAgents(actors: ActorRecord[], executions: ExecutionRecord[]): number;
-}
-
-/**
- * MetricsAdapter - The System Analyst
- *
- * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
- * Acts as Mediator between analytics system and multi-store data sources.
- */
-declare class MetricsAdapter implements IMetricsAdapter {
-    private stores;
-    private platformApi;
-    constructor(dependencies: MetricsAdapterDependencies);
-    /**
-     * [EARS-A1] Gets aggregated system status using Tier 1 metrics.
-     */
-    getSystemStatus(): Promise<SystemStatus>;
-    /**
-     * [EARS-A2] Gets task health analysis using Tier 1 metrics.
-     */
-    getTaskHealth(taskId: string): Promise<TaskHealthReport>;
-    /**
-     * [EARS-E1] Gets productivity metrics using Tier 2 calculations.
-     */
-    getProductivityMetrics(): Promise<ProductivityMetrics>;
-    /**
-     * [EARS-E2] Gets collaboration metrics with agent activity analysis.
-     */
-    getCollaborationMetrics(): Promise<CollaborationMetrics>;
-    /**
-     * [EARS-B1] Calculates exact days since last state change.
-     */
-    calculateTimeInCurrentStage(task: TaskRecord): number;
-    /**
-     * [EARS-B2] Calculates days since last ExecutionRecord.
-     */
-    calculateStalenessIndex(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-B3] Calculates days of oldest active blocking feedback.
-     */
-    calculateBlockingFeedbackAge(feedback: FeedbackRecord[]): number;
-    /**
-     * [EARS-B4] Calculates health percentage using improved protocol formula.
-     */
-    calculateHealth(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-B5] Returns status distribution with percentages.
-     */
-    calculateBacklogDistribution(tasks: TaskRecord[]): Record<string, number>;
-    /**
-     * [EARS-B6] Counts tasks created in last 24 hours.
-     */
-    calculateTasksCreatedToday(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-D1] Counts tasks moved to 'done' in last 7 days.
-     */
-    calculateThroughput(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-D2] Calculates average done-draft time for lead time.
-     */
-    calculateLeadTime(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-D3] Calculates average done-active time for cycle time.
-     */
-    calculateCycleTime(tasks: TaskRecord[]): number;
-    /**
-     * [EARS-D4] Counts unique agents with executions in 24h.
-     */
-    calculateActiveAgents(actors: ActorRecord[], executions: ExecutionRecord[]): number;
-    /**
-     * Extracts timestamp from ID (format: {timestamp}-{type}-{slug})
-     */
-    private getTimestampFromId;
-    /**
-     * Counts tasks by status
-     */
-    private countTasksByStatus;
-    /**
-     * Counts tasks by priority
-     */
-    private countTasksByPriority;
-    /**
-     * [EARS-C3] Throws NotImplementedError for Tier 3 functions.
-     */
-    calculateQuality(_tasks: TaskRecord[]): number;
-    calculateReworkRate(_tasks: TaskRecord[]): number;
-    calculateCompletionRate(_tasks: TaskRecord[]): number;
-    calculateAuditScoreDistribution(_tasks: TaskRecord[]): Record<string, number>;
-    calculateEpicPromotionRate(_tasks: TaskRecord[]): number;
-    calculateTaskRefinementRate(_tasks: TaskRecord[]): number;
-    calculatePlanningAccuracy(_tasks: TaskRecord[]): number;
-    calculateDependencyDiscoveryRate(_tasks: TaskRecord[]): number;
-    /**
-     * [EARS-C4] Returns null for Premium metrics without Platform API.
-     */
-    calculateCostBurnRate(_consumption: TokenConsumption[]): number;
-    calculateTokenConsumption(_consumption: TokenConsumption[]): number;
-    calculateTokenConsumptionByAgent(_consumption: TokenConsumption[]): Record<string, number>;
-    calculateAiAccuracyRate(_tasks: TaskRecord[], _feedback: FeedbackRecord[]): number;
-    calculateAgentExecutionTime(_executions: ExecutionRecord[]): number;
-}
-
-/**
- * Event Bus types for GitGovernance event-driven architecture
- */
-/**
- * Event metadata for ordering and debugging
- */
-type EventMetadata = {
-    /** Unique event identifier */
-    eventId: string;
-    /** Event creation timestamp */
-    timestamp: number;
-    /** Event processing timestamp (set by handlers) */
-    processedAt?: number;
-    /** Source adapter that emitted the event */
-    sourceAdapter: string;
-    /** Sequence number for ordering (optional) */
-    sequenceNumber?: number;
-};
-/**
- * Base event structure
- */
-type BaseEvent = {
-    /** Event type identifier */
-    type: string;
-    /** Event timestamp */
-    timestamp: number;
-    /** Event payload */
-    payload: unknown;
-    /** Source that emitted the event */
-    source: string;
-    /** Event metadata for ordering and debugging */
-    metadata?: EventMetadata;
-};
-
-type TaskCreatedEvent = BaseEvent & {
-    type: 'task.created';
-    payload: {
-        taskId: string;
-        triggeredBy: string;
-    };
-};
-type TaskStatusChangedEvent = BaseEvent & {
-    type: 'task.status.changed';
-    payload: {
-        taskId: string;
-        oldStatus: TaskRecord['status'];
-        newStatus: TaskRecord['status'];
-        triggeredBy: string;
-        reason?: string;
-    };
-};
-
-type CycleCreatedEvent = BaseEvent & {
-    type: 'cycle.created';
-    payload: {
-        cycleId: string;
-        triggeredBy: string;
-    };
-};
-type CycleStatusChangedEvent = BaseEvent & {
-    type: 'cycle.status.changed';
-    payload: {
-        cycleId: string;
-        oldStatus: CycleRecord['status'];
-        newStatus: CycleRecord['status'];
-        triggeredBy: string;
-    };
-};
-
-type ExecutionCreatedEvent = BaseEvent & {
-    type: 'execution.created';
-    payload: Pick<ExecutionRecord, 'taskId' | 'type' | 'title'> & {
-        executionId: string;
-        triggeredBy: string;
-        isFirstExecution: boolean;
-    };
-};
-
-type FeedbackCreatedEvent = BaseEvent & {
-    type: 'feedback.created';
-    payload: Pick<FeedbackRecord, 'entityType' | 'entityId' | 'type' | 'status' | 'content' | 'assignee' | 'resolvesFeedbackId'> & {
-        feedbackId: string;
-        triggeredBy: string;
-    };
-};
-
-type ChangelogCreatedEvent = BaseEvent & {
-    type: 'changelog.created';
-    payload: Pick<ChangelogRecord, 'relatedTasks' | 'title' | 'version'> & {
-        changelogId: string;
-    };
-};
-
-type ActorCreatedEvent = BaseEvent & {
-    type: 'identity.actor.created';
-    payload: Pick<ActorRecord, 'type' | 'publicKey' | 'roles'> & {
-        actorId: string;
-        isBootstrap: boolean;
-    };
-};
-type ActorRevokedEvent = BaseEvent & {
-    type: 'identity.actor.revoked';
-    payload: Pick<ActorRecord, 'supersededBy'> & {
-        actorId: string;
-        revokedBy: string;
-        revocationReason: 'compromised' | 'rotation' | 'manual';
-    };
-};
-type AgentRegisteredEvent = BaseEvent & {
-    type: 'identity.agent.registered';
-    payload: Pick<AgentRecord, 'engine'> & {
-        agentId: string;
-        correspondingActorId: string;
-    };
-};
-/**
- * System events
- */
-type SystemDailyTickEvent = BaseEvent & {
-    type: 'system.daily_tick';
-    payload: {
-        date: string;
-    };
-};
-/**
- * Union type of all possible events
- */
-type GitGovEvent = TaskCreatedEvent | TaskStatusChangedEvent | CycleCreatedEvent | CycleStatusChangedEvent | ExecutionCreatedEvent | FeedbackCreatedEvent | ChangelogCreatedEvent | ActorCreatedEvent | ActorRevokedEvent | AgentRegisteredEvent | SystemDailyTickEvent;
-/**
- * Event handler function type
- */
-type EventHandler<T extends BaseEvent = BaseEvent> = (event: T) => void | Promise<void>;
-/**
- * Event subscription
- */
-type EventSubscription = {
-    /** Unique subscription ID */
-    id: string;
-    /** Event type being subscribed to */
-    eventType: string;
-    /** Handler function */
-    handler: EventHandler;
-    /** Subscription metadata */
-    metadata?: {
-        subscriberName?: string;
-        createdAt: number;
-    };
-};
-/**
- * Activity Event for IndexerAdapter activity tracking
- * Uses discriminated unions for type-safe metadata per event type
- */
-type ActivityEvent = {
-    timestamp: number;
-    type: "task_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        priority?: string;
-        status?: string;
-    };
-} | {
-    timestamp: number;
-    type: "cycle_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        status?: string;
-    };
-} | {
-    timestamp: number;
-    type: "feedback_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        type?: string;
-        assignee?: string;
-        resolution?: string;
-    };
-} | {
-    timestamp: number;
-    type: "changelog_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        version?: string;
-    };
-} | {
-    timestamp: number;
-    type: "execution_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        executionType?: string;
-        taskId?: string;
-    };
-} | {
-    timestamp: number;
-    type: "actor_created";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: {
-        type?: string;
-    };
-} | {
-    timestamp: number;
-    type: "agent_registered";
-    entityId: string;
-    entityTitle: string;
-    actorId?: string;
-    metadata?: Record<string, never>;
-};
-
 /**
  * Event Stream interface - Contract for both Local and Global bus implementations
  */
@@ -1418,188 +410,6 @@ declare function publishEvent(event: GitGovEvent): void;
  */
 declare function subscribeToEvent<T extends GitGovEvent>(eventType: T['type'], handler: EventHandler<T>): EventSubscription;
 
-/**
- * Collection of all records with full GitGov metadata (headers + payloads).
- * This allows access to signatures, checksums, and other metadata for enrichment.
- *
- * @see GitGovTaskRecord - Full record type with header.signatures for author/lastModifier extraction
- */
-type AllRecords = {
-    tasks: GitGovTaskRecord[];
-    cycles: GitGovCycleRecord[];
-    feedback: GitGovFeedbackRecord[];
-    executions: GitGovExecutionRecord[];
-    changelogs: GitGovChangelogRecord[];
-    actors: GitGovActorRecord[];
-};
-/**
- * System-wide derived states for dashboard analytics and filtering.
- * Calculated by calculateDerivedStates() during index generation.
- *
- * @see derived_data_protocol.md for calculation algorithms
- */
-type DerivedStates = {
-    stalledTasks: string[];
-    atRiskTasks: string[];
-    needsClarificationTasks: string[];
-    blockedByDependencyTasks: string[];
-};
-/**
- * Optimized version of DerivedStates using Sets for O(1) lookup performance.
- * Used internally by enrichTaskRecord() to efficiently check task membership.
- *
- * Conversion from DerivedStates (arrays) to DerivedStateSets (Sets) happens once
- * in generateIndex() before processing multiple tasks, avoiding repeated O(n) lookups.
- */
-type DerivedStateSets = {
-    stalledTasks: Set<string>;
-    atRiskTasks: Set<string>;
-    needsClarificationTasks: Set<string>;
-    blockedByDependencyTasks: Set<string>;
-};
-/**
- * Enhanced Task Record with complete intelligence layer.
- * Calculated by enrichTaskRecord() with relationships, metrics, and derived states.
- *
- * @see indexer_adapter.md Section 3.6 - EnrichedTaskRecord Specification (EARS 25-48)
- */
-type EnrichedTaskRecord = TaskRecord & {
-    derivedState: {
-        isStalled: boolean;
-        isAtRisk: boolean;
-        needsClarification: boolean;
-        isBlockedByDependency: boolean;
-        healthScore: number;
-        timeInCurrentStage: number;
-    };
-    relationships: {
-        author?: {
-            actorId: string;
-            timestamp: number;
-        };
-        lastModifier?: {
-            actorId: string;
-            timestamp: number;
-        };
-        assignedTo: Array<{
-            actorId: string;
-            assignedAt?: number;
-        }>;
-        dependsOn: string[];
-        blockedBy: string[];
-        cycles: Array<{
-            id: string;
-            title: string;
-        }>;
-    };
-    metrics: {
-        executionCount: number;
-        blockingFeedbackCount: number;
-        openQuestionCount: number;
-        timeToResolution?: number;
-    };
-    release: {
-        isReleased: boolean;
-        lastReleaseVersion?: string;
-    };
-    lastUpdated: number;
-    lastActivityType: 'task_modified' | 'feedback_received' | 'execution_added' | 'changelog_created' | 'task_created';
-    recentActivity?: string;
-};
-/**
- * IndexData - Complete cached index structure.
- * Generated by generateIndex() and consumed by CLI/Dashboard.
- */
-type IndexData = {
-    metadata: {
-        generatedAt: string;
-        lastCommitHash: string;
-        integrityStatus: 'valid' | 'warnings' | 'errors';
-        recordCounts: Record<string, number>;
-        generationTime: number;
-    };
-    metrics: SystemStatus & ProductivityMetrics & CollaborationMetrics;
-    derivedStates: DerivedStates;
-    activityHistory: ActivityEvent[];
-    tasks: GitGovTaskRecord[];
-    enrichedTasks: EnrichedTaskRecord[];
-    cycles: GitGovCycleRecord[];
-    actors: GitGovActorRecord[];
-    feedback: GitGovFeedbackRecord[];
-};
-/**
- * Integrity validation error types.
- */
-type IntegrityError = {
-    type: 'schema_violation' | 'checksum_failure' | 'signature_invalid';
-    recordId: string;
-    message: string;
-};
-/**
- * Integrity validation warning types.
- */
-type IntegrityWarning = {
-    type: 'missing_reference' | 'deprecated_field' | 'performance_issue';
-    recordId: string;
-    message: string;
-};
-/**
- * Result of validateIntegrity() operation.
- */
-type IntegrityReport = {
-    status: 'valid' | 'warnings' | 'errors';
-    recordsScanned: number;
-    errorsFound: IntegrityError[];
-    warningsFound: IntegrityWarning[];
-    validationTime: number;
-    checksumFailures: number;
-    signatureFailures: number;
-};
-/**
- * Result of generateIndex() operation.
- */
-type IndexGenerationReport = {
-    success: boolean;
-    recordsProcessed: number;
-    metricsCalculated: number;
-    derivedStatesApplied: number;
-    generationTime: number;
-    errors: string[];
-    performance: {
-        readTime: number;
-        calculationTime: number;
-        writeTime: number;
-    };
-};
-/**
- * IndexerAdapter Dependencies - Facade + Dependency Injection Pattern.
- *
- * @see indexer_adapter.md Section 2 - Architecture
- */
-type IndexerAdapterDependencies = {
-    metricsAdapter: MetricsAdapter;
-    stores: Required<Pick<RecordStores$1, 'tasks' | 'cycles' | 'feedbacks' | 'executions' | 'changelogs' | 'actors'>>;
-    cacheStore: RecordStore<IndexData>;
-};
-/**
- * IndexerAdapter Interface - The Cache Engine.
- */
-interface IIndexerAdapter {
-    generateIndex(): Promise<IndexGenerationReport>;
-    getIndexData(): Promise<IndexData | null>;
-    validateIntegrity(): Promise<IntegrityReport>;
-    calculateDerivedStates(allRecords: AllRecords): Promise<DerivedStates>;
-    calculateActivityHistory(allRecords: AllRecords): Promise<ActivityEvent[]>;
-    calculateLastUpdated(task: GitGovTaskRecord, relatedRecords: AllRecords): Promise<{
-        lastUpdated: number;
-        lastActivityType: EnrichedTaskRecord['lastActivityType'];
-        recentActivity: string;
-    }>;
-    enrichTaskRecord(task: GitGovTaskRecord, relatedRecords: AllRecords, derivedStateSets: DerivedStateSets): Promise<EnrichedTaskRecord>;
-    isIndexUpToDate(): Promise<boolean>;
-    invalidateCache(): Promise<void>;
-}
-
 /**
  * Public interface for pure LintModule operations (no I/O).
  *
@@ -1701,7 +511,7 @@ interface LintModuleDependencies {
      * Indexing adapter for advanced reference resolution (OPTIONAL)
      * If not present, reference validations will be limited.
      */
-    indexerAdapter?: IIndexerAdapter;
+    projector?: IRecordProjector;
 }
 /**
  * Options for pure record fix operation.
@@ -2071,8 +881,8 @@ type SyncStateModuleDependencies = {
     identity: IIdentityAdapter;
     /** Lint module for record validation (required) */
     lint: ILintModule;
-    /** Indexer adapter for automatic re-indexing after pull/resolve (required) */
-    indexer: IIndexerAdapter;
+    /** Record projector for automatic re-indexing after pull/resolve (required) */
+    indexer: IRecordProjector;
 };
 /**
  * Options for pushState operation
@@ -2577,4 +1387,4 @@ interface RuntimeHandlerRegistry {
  */
 type RuntimeHandler = (engine: LocalEngine, ctx: AgentExecutionContext) => Promise<AgentOutput>;
 
-export { type GitGovChangelogRecord as $, type AuditStateOptions as A, type ActorPayload as B, ConfigManager as C, type ActorRecord as D, type EnvironmentValidation as E, type FixRecordOptions as F, type GitGovRecord as G, type AgentPayload as H, type ILintModule as I, type AgentRecord as J, type ChangelogPayload as K, type LintOptions as L, type ChangelogRecord as M, type CustomRecord as N, type CyclePayload as O, type ProtocolHandlerRegistry as P, type CycleRecord as Q, type RecordStores as R, SessionManager as S, type EmbeddedMetadataHeader as T, type EmbeddedMetadataRecord as U, type ExecutionPayload as V, type ExecutionRecord as W, type FeedbackPayload as X, type FeedbackRecord as Y, type GitGovActorRecord as Z, type GitGovAgentRecord as _, type LintReport as a, type ConflictFileDiff as a$, type GitGovCycleRecord as a0, GitGovError as a1, type GitGovExecutionRecord as a2, type GitGovFeedbackRecord as a3, type GitGovRecordPayload as a4, type GitGovRecordType as a5, type GitGovTaskRecord as a6, type Signature as a7, type TaskPayload as a8, type TaskRecord as a9, type TaskCreatedEvent as aA, type TaskStatusChangedEvent as aB, eventBus as aC, publishEvent as aD, subscribeToEvent as aE, type IndexerAdapterDependencies as aF, type IndexGenerationReport as aG, type IndexData as aH, type IntegrityReport as aI, type AllRecords as aJ, type DerivedStates as aK, type EnrichedTaskRecord as aL, type DerivedStateSets as aM, type IntegrityError as aN, type IntegrityWarning as aO, type IIdentityAdapter as aP, IdentityAdapter as aQ, type IdentityAdapterDependencies as aR, type LintModuleDependencies as aS, type FixResult as aT, type LintSummary as aU, type RecordEntry as aV, type ValidationContext as aW, type ValidatorType as aX, type IExecutionAdapter as aY, type ExecutionAdapterDependencies as aZ, type AuditScope as a_, type RecordStores$1 as aa, type CollaborationMetrics as ab, type IMetricsAdapter as ac, type IPlatformApi as ad, MetricsAdapter as ae, type MetricsAdapterDependencies as af, type ProductivityMetrics as ag, type SystemStatus as ah, type TaskHealthReport as ai, type TokenConsumption as aj, type ActivityEvent as ak, type ActorCreatedEvent as al, type ActorRevokedEvent as am, type AgentRegisteredEvent as an, type BaseEvent as ao, type ChangelogCreatedEvent as ap, type CycleCreatedEvent as aq, type CycleStatusChangedEvent as ar, EventBus as as, type EventHandler as at, type EventMetadata as au, type EventSubscription as av, type ExecutionCreatedEvent as aw, type FeedbackCreatedEvent as ax, type GitGovEvent as ay, type SystemDailyTickEvent as az, type FixReport as b, type ConflictInfo as b0, type ConflictType as b1, type ExpectedFilesScope as b2, type AgentExecutionContext as b3, type AgentOutput as b4, type AgentRunnerEvent as b5, type ApiEngine as b6, type AuthConfig as b7, type AuthType as b8, type CustomEngine as b9, type Engine as ba, type EngineType as bb, type IAgentLoader as bc, type LocalEngine as bd, type McpEngine as be, type ProtocolHandler as bf, type RuntimeHandler as bg, type RuntimeHandlerRegistry as bh, type IIndexerAdapter as c, type LintRecordContext as d, type LintResult as e, type IProjectInitializer as f, type ISyncStateModule as g, type SyncStateModuleDependencies as h, type StateDeltaFile as i, type ConflictDiff as j, type IntegrityViolation as k, type AuditStateReport as l, type SyncStatePushOptions as m, type SyncStatePushResult as n, type SyncStatePullOptions as o, type SyncStatePullResult as p, type SyncStateResolveOptions as q, type SyncStateResolveResult as r, type IEventStream as s, type IAgentRunner as t, type AgentRunnerDependencies as u, type RunOptions as v, type AgentResponse as w, FsKeyProvider as x, type FsKeyProviderOptions as y, FsFileLister as z };
+export { type ExpectedFilesScope as $, type AuditStateOptions as A, eventBus as B, ConfigManager as C, publishEvent as D, type EnvironmentValidation as E, type FixRecordOptions as F, subscribeToEvent as G, type IIdentityAdapter as H, type ILintModule as I, IdentityAdapter as J, type IdentityAdapterDependencies as K, type LintOptions as L, type LintModuleDependencies as M, type FixResult as N, type LintSummary as O, type ProtocolHandlerRegistry as P, type RecordEntry as Q, type RecordStores as R, SessionManager as S, type ValidatorType as T, type IExecutionAdapter as U, type ValidationContext as V, type ExecutionAdapterDependencies as W, type AuditScope as X, type ConflictFileDiff as Y, type ConflictInfo as Z, type ConflictType as _, type LintReport as a, type AgentExecutionContext as a0, type AgentOutput as a1, type AgentRunnerEvent as a2, type ApiEngine as a3, type AuthConfig as a4, type AuthType as a5, type CustomEngine as a6, type Engine as a7, type EngineType as a8, type IAgentLoader as a9, type LocalEngine as aa, type McpEngine as ab, type ProtocolHandler as ac, type RuntimeHandler as ad, type RuntimeHandlerRegistry as ae, type FixReport as b, type LintRecordContext as c, type LintResult as d, type IProjectInitializer as e, type ISyncStateModule as f, type SyncStateModuleDependencies as g, type StateDeltaFile as h, type ConflictDiff as i, type IntegrityViolation as j, type AuditStateReport as k, type SyncStatePushOptions as l, type SyncStatePushResult as m, type SyncStatePullOptions as n, type SyncStatePullResult as o, type SyncStateResolveOptions as p, type SyncStateResolveResult as q, type IEventStream as r, type IAgentRunner as s, type AgentRunnerDependencies as t, type RunOptions as u, type AgentResponse as v, FsKeyProvider as w, type FsKeyProviderOptions as x, FsFileLister as y, EventBus as z };