@thoughtflow/core 0.1.2

package/dist/libs/audit-logger.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * ID53: Decision Logging and Audit Trail
+ * Comprehensive audit logging for all decisions, actions, and state changes with full traceability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditLogger = exports.AuditEventType = void 0;
+/**
+ * Audit event type
+ */
+var AuditEventType;
+(function (AuditEventType) {
+    AuditEventType["INTERRUPT_CREATED"] = "interrupt_created";
+    AuditEventType["INTERRUPT_ACKNOWLEDGED"] = "interrupt_acknowledged";
+    AuditEventType["INTERRUPT_DECIDED"] = "interrupt_decided";
+    AuditEventType["INTERRUPT_ESCALATED"] = "interrupt_escalated";
+    AuditEventType["INTERRUPT_CANCELLED"] = "interrupt_cancelled";
+    AuditEventType["VALIDATION_CREATED"] = "validation_created";
+    AuditEventType["VALIDATION_COMPLETED"] = "validation_completed";
+    AuditEventType["DECISION_SUBMITTED"] = "decision_submitted";
+    AuditEventType["DECISION_MODIFIED"] = "decision_modified";
+    AuditEventType["DATA_ACCESSED"] = "data_accessed";
+    AuditEventType["DATA_MODIFIED"] = "data_modified";
+    AuditEventType["RULE_VIOLATED"] = "rule_violated";
+    AuditEventType["APPROVAL_GRANTED"] = "approval_granted";
+    AuditEventType["APPROVAL_DENIED"] = "approval_denied";
+    AuditEventType["SYSTEM_ACTION"] = "system_action";
+    AuditEventType["ERROR_OCCURRED"] = "error_occurred";
+})(AuditEventType || (exports.AuditEventType = AuditEventType = {}));
+/**
+ * Audit logger with immutable event log
+ */
+class AuditLogger {
+    entries = [];
+    entriesById = new Map();
+    decisionTraces = new Map();
+    retentionDays;
+    maxEntries;
+    listeners = new Set();
+    constructor(retentionDays = 365, maxEntries = 100000) {
+        this.retentionDays = retentionDays;
+        this.maxEntries = maxEntries;
+    }
+    /**
+     * Log audit event (immutable)
+     */
+    log(eventType, resource, resourceId, actor, action, description, metadata) {
+        const entry = {
+            id: `audit_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            eventType,
+            timestamp: Date.now(),
+            actor,
+            resource,
+            resourceId,
+            action,
+            description,
+            status: "success",
+            ...metadata,
+        };
+        // Immutable - entries are only added, never modified
+        this.entries.push(entry);
+        this.entriesById.set(entry.id, entry);
+        // Prune old entries if exceeding max
+        if (this.entries.length > this.maxEntries) {
+            this.pruneOldEntries();
+        }
+        // Notify listeners
+        this.notifyListeners(entry);
+        return entry;
+    }
+    /**
+     * Log error event
+     */
+    logError(resource, resourceId, actor, action, errorMessage, metadata) {
+        return this.log(AuditEventType.ERROR_OCCURRED, resource, resourceId, actor, action, `Error: ${errorMessage}`, {
+            metadata,
+            errorMessage,
+        });
+    }
+    /**
+     * Get entry by ID
+     */
+    getEntry(entryId) {
+        return this.entriesById.get(entryId);
+    }
+    /**
+     * Query audit log
+     */
+    query(options) {
+        let results = [...this.entries];
+        // Apply filters
+        if (options.eventType) {
+            const eventTypes = Array.isArray(options.eventType)
+                ? options.eventType
+                : [options.eventType];
+            results = results.filter((e) => eventTypes.includes(e.eventType));
+        }
+        if (options.resourceId) {
+            results = results.filter((e) => e.resourceId === options.resourceId);
+        }
+        if (options.actor) {
+            results = results.filter((e) => e.actor === options.actor);
+        }
+        if (options.resource) {
+            results = results.filter((e) => e.resource === options.resource);
+        }
+        if (options.fromTimestamp) {
+            results = results.filter((e) => e.timestamp >= options.fromTimestamp);
+        }
+        if (options.toTimestamp) {
+            results = results.filter((e) => e.timestamp <= options.toTimestamp);
+        }
+        if (options.status) {
+            results = results.filter((e) => e.status === options.status);
+        }
+        // Apply sorting
+        const sortBy = options.sortBy || "timestamp";
+        const sortOrder = options.sortOrder || "desc";
+        results.sort((a, b) => {
+            let aVal, bVal;
+            if (sortBy === "timestamp") {
+                aVal = a.timestamp;
+                bVal = b.timestamp;
+            }
+            else if (sortBy === "actor") {
+                aVal = a.actor;
+                bVal = b.actor;
+            }
+            else if (sortBy === "resource") {
+                aVal = a.resource;
+                bVal = b.resource;
+            }
+            const comparison = aVal < bVal ? -1 : aVal > bVal ? 1 : 0;
+            return sortOrder === "asc" ? comparison : -comparison;
+        });
+        // Apply pagination
+        const offset = options.offset || 0;
+        const limit = options.limit || results.length;
+        return results.slice(offset, offset + limit);
+    }
+    /**
+     * Create decision trace
+     */
+    createDecisionTrace(decisionId, decision, decidedBy, decidedAt) {
+        const trace = {
+            decisionId,
+            decision,
+            decidedBy,
+            decidedAt,
+            auditTrail: [],
+            approvals: [],
+            rejections: [],
+        };
+        this.decisionTraces.set(decisionId, trace);
+        return trace;
+    }
+    /**
+     * Add entry to decision trace
+     */
+    addToDecisionTrace(decisionId, entry) {
+        const trace = this.decisionTraces.get(decisionId);
+        if (trace) {
+            trace.auditTrail.push(entry);
+        }
+    }
+    /**
+     * Add approval to decision trace
+     */
+    addApprovalToTrace(decisionId, approver, comment) {
+        const trace = this.decisionTraces.get(decisionId);
+        if (trace) {
+            trace.approvals.push({
+                approver,
+                approvedAt: Date.now(),
+                comment,
+            });
+        }
+    }
+    /**
+     * Add rejection to decision trace
+     */
+    addRejectionToTrace(decisionId, rejector, reason) {
+        const trace = this.decisionTraces.get(decisionId);
+        if (trace) {
+            trace.rejections.push({
+                rejector,
+                rejectedAt: Date.now(),
+                reason,
+            });
+        }
+    }
+    /**
+     * Get decision trace
+     */
+    getDecisionTrace(decisionId) {
+        return this.decisionTraces.get(decisionId);
+    }
+    /**
+     * Generate audit report
+     */
+    generateReport(fromTimestamp, toTimestamp) {
+        const now = Date.now();
+        const from = fromTimestamp || now - 30 * 24 * 60 * 60 * 1000; // Default: 30 days
+        const to = toTimestamp || now;
+        const filtered = this.query({
+            fromTimestamp: from,
+            toTimestamp: to,
+        });
+        const eventsByType = {};
+        const eventsByActor = {};
+        const eventsByResource = {};
+        let failures = 0;
+        for (const entry of filtered) {
+            eventsByType[entry.eventType] = (eventsByType[entry.eventType] || 0) + 1;
+            eventsByActor[entry.actor] = (eventsByActor[entry.actor] || 0) + 1;
+            eventsByResource[entry.resource] = (eventsByResource[entry.resource] || 0) + 1;
+            if (entry.status === "failure") {
+                failures++;
+            }
+        }
+        const highlights = [];
+        // Find most active actor
+        const mostActiveActor = Object.entries(eventsByActor).sort((a, b) => b[1] - a[1])[0];
+        if (mostActiveActor) {
+            highlights.push(`Most active actor: ${mostActiveActor[0]} (${mostActiveActor[1]} events)`);
+        }
+        // Find most accessed resource
+        const mostAccessedResource = Object.entries(eventsByResource).sort((a, b) => b[1] - a[1])[0];
+        if (mostAccessedResource) {
+            highlights.push(`Most accessed resource: ${mostAccessedResource[0]} (${mostAccessedResource[1]} events)`);
+        }
+        return {
+            generatedAt: now,
+            period: { from, to },
+            totalEvents: filtered.length,
+            eventsByType: eventsByType,
+            eventsByActor,
+            eventsByResource,
+            failureRate: filtered.length > 0 ? failures / filtered.length : 0,
+            highlights,
+        };
+    }
+    /**
+     * Export audit log
+     */
+    export(options) {
+        const entries = this.query(options || {});
+        return JSON.stringify(entries, null, 2);
+    }
+    /**
+     * Check audit trail for resource
+     */
+    getResourceAuditTrail(resourceId) {
+        return this.entries.filter((e) => e.resourceId === resourceId);
+    }
+    /**
+     * Get all entries for actor
+     */
+    getActorHistory(actor) {
+        return this.entries.filter((e) => e.actor === actor);
+    }
+    /**
+     * Register listener for new entries
+     */
+    onEntry(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove listener
+     */
+    removeListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Notify listeners of new entry
+     */
+    notifyListeners(entry) {
+        for (const listener of this.listeners) {
+            try {
+                listener(entry);
+            }
+            catch (error) {
+                console.error("Error in audit listener:", error);
+            }
+        }
+    }
+    /**
+     * Prune old entries based on retention policy
+     */
+    pruneOldEntries() {
+        const cutoffTime = Date.now() - this.retentionDays * 24 * 60 * 60 * 1000;
+        // Keep only entries after cutoff time
+        const entriesToKeep = this.entries.filter((e) => e.timestamp > cutoffTime);
+        if (entriesToKeep.length < this.entries.length) {
+            // Clear and rebuild maps
+            this.entriesById.clear();
+            this.entries = entriesToKeep;
+            for (const entry of this.entries) {
+                this.entriesById.set(entry.id, entry);
+            }
+        }
+    }
+    /**
+     * Get total number of entries
+     */
+    getEntryCount() {
+        return this.entries.length;
+    }
+    /**
+     * Clear all entries (use with caution)
+     */
+    clear() {
+        this.entries = [];
+        this.entriesById.clear();
+        this.decisionTraces.clear();
+        this.listeners.clear();
+    }
+}
+exports.AuditLogger = AuditLogger;
+//# sourceMappingURL=audit-logger.js.map

package/dist/libs/audit-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logger.js","sourceRoot":"","sources":["../../src/libs/audit-logger.ts"],"names":[],"mappings":"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"}

package/dist/libs/autonomous-orchestrator.class.d.ts

@@ -0,0 +1,159 @@
+/**
+ * AutonomousOrchestrator — Phase 4
+ *
+ * Long-running orchestration loop that drives autonomous development:
+ *
+ *   while(running) {
+ *     1. Pick highest-priority ready task
+ *     2. Route to appropriate agent profile
+ *     3. Execute task (with checkpoint + abort)
+ *     4. Verify result
+ *     5. Update knowledge graph
+ *     6. Checkpoint state
+ *   }
+ *
+ * Features:
+ *   - Agent rotation by task type
+ *   - Checkpoint recovery (survive restarts)
+ *   - HITL pause (wait for human when needed)
+ *   - Periodic re-analysis (detect divergences)
+ *   - Iteration budgets (max iterations before pause)
+ *   - Event emission for real-time monitoring
+ *
+ * The orchestrator is LLM-agnostic: agent execution is injected as callbacks.
+ */
+import type { KnowledgeGraph } from "./knowledge-graph.class";
+import type { TaskBoard } from "./task-board.class";
+import type { AnalysisPipeline, AnalysisPipelineCallbacks, AnalysisPipelineConfig } from "./analysis-pipeline.class";
+import type { BoardTask } from "../contracts/task-board.types";
+import { OrchestratorStatus } from "../contracts/task-board.types";
+import type { OrchestratorIteration, OrchestratorState } from "../contracts/task-board.types";
+export interface AgentProfile {
+    name: string;
+    /** Task types this agent can handle. */
+    taskTypes: string[];
+    /** Function that executes a task and returns a result. */
+    execute: (task: BoardTask, context: AgentContext) => Promise<AgentResult>;
+}
+export interface AgentContext {
+    graph: KnowledgeGraph;
+    taskBoard: TaskBoard;
+    iterationId: string;
+    signal: AbortSignal;
+}
+export interface AgentResult {
+    success: boolean;
+    /** Summary of what was done. */
+    summary: string;
+    /** Files that were modified. */
+    changedFiles?: string[];
+    /** Whether HITL review is requested before merging. */
+    requestsReview?: boolean;
+    /** New knowledge to add to graph. */
+    knowledgeUpdates?: Array<{
+        nodeId?: string;
+        patch?: Record<string, unknown>;
+        newNode?: {
+            type: string;
+            name: string;
+            description: string;
+            source: string;
+        };
+    }>;
+    /** Error message if failed. */
+    error?: string;
+}
+export interface AutonomousOrchestratorConfig {
+    /** Max iterations before auto-pause (0 = unlimited). Default: 100. */
+    maxIterations?: number;
+    /** Interval between re-analysis runs in ms. Default: 30 minutes. */
+    reanalysisIntervalMs?: number;
+    /** Max consecutive failures before auto-pause. Default: 3. */
+    maxConsecutiveFailures?: number;
+    /** Whether to auto-pause on HITL requests. Default: true. */
+    pauseOnHitl?: boolean;
+    /** Delay between iterations in ms (rate limiting). Default: 1000. */
+    iterationDelayMs?: number;
+}
+export type OrchestratorEvent = {
+    type: "iteration:start";
+    iteration: OrchestratorIteration;
+} | {
+    type: "iteration:complete";
+    iteration: OrchestratorIteration;
+} | {
+    type: "iteration:failed";
+    iteration: OrchestratorIteration;
+    error: string;
+} | {
+    type: "status:changed";
+    from: OrchestratorStatus;
+    to: OrchestratorStatus;
+} | {
+    type: "task:picked";
+    task: BoardTask;
+    agent: string;
+} | {
+    type: "task:completed";
+    task: BoardTask;
+} | {
+    type: "task:failed";
+    task: BoardTask;
+    error: string;
+} | {
+    type: "hitl:requested";
+    task: BoardTask;
+    reason: string;
+} | {
+    type: "reanalysis:start";
+} | {
+    type: "reanalysis:complete";
+    divergenceCount: number;
+} | {
+    type: "paused";
+    reason: string;
+} | {
+    type: "stopped";
+    reason: string;
+};
+export type OrchestratorEventHandler = (event: OrchestratorEvent) => void;
+export declare class AutonomousOrchestrator {
+    private readonly graph;
+    private readonly taskBoard;
+    private readonly pipeline?;
+    private readonly agents;
+    private readonly config;
+    private listeners;
+    private state;
+    private abortController?;
+    private consecutiveFailures;
+    private lastReanalysisAt;
+    constructor(graph: KnowledgeGraph, taskBoard: TaskBoard, pipeline?: AnalysisPipeline, config?: AutonomousOrchestratorConfig);
+    registerAgent(profile: AgentProfile): this;
+    on(handler: OrchestratorEventHandler): this;
+    off(handler: OrchestratorEventHandler): this;
+    getState(): Readonly<OrchestratorState>;
+    /**
+     * Start the autonomous loop. Runs until stopped, paused, or budget exhausted.
+     */
+    start(pipelineConfig?: AnalysisPipelineConfig, pipelineCallbacks?: AnalysisPipelineCallbacks): Promise<OrchestratorState>;
+    /**
+     * Pause the orchestrator (can be resumed).
+     */
+    pause(reason: string): void;
+    /**
+     * Stop the orchestrator completely.
+     */
+    stop(reason?: string): void;
+    /**
+     * Resume from paused state.
+     */
+    resume(pipelineConfig?: AnalysisPipelineConfig, pipelineCallbacks?: AnalysisPipelineCallbacks): Promise<OrchestratorState>;
+    private executeIteration;
+    private pickAgent;
+    private runReanalysis;
+    private setStatus;
+    private emit;
+    private delay;
+}
+//# sourceMappingURL=autonomous-orchestrator.class.d.ts.map

package/dist/libs/autonomous-orchestrator.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autonomous-orchestrator.class.d.ts","sourceRoot":"","sources":["../../src/libs/autonomous-orchestrator.class.ts"],"names":[],"mappings":"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"}