codekin 0.4.1 → 0.5.0

package/server/dist/orchestrator-memory.js

@@ -0,0 +1,288 @@
+/**
+ * Orchestrator memory store — SQLite + FTS5 for structured, searchable memory.
+ *
+ * Provides durable memory across restarts with full-text search retrieval,
+ * trust record tracking, and automatic expiry/aging of stale items.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import { ORCHESTRATOR_DIR } from './orchestrator-manager.js';
+// ---------------------------------------------------------------------------
+// Store
+// ---------------------------------------------------------------------------
+export class OrchestratorMemory {
+    db;
+    constructor(dbPath) {
+        if (!existsSync(ORCHESTRATOR_DIR))
+            mkdirSync(ORCHESTRATOR_DIR, { recursive: true });
+        const resolvedPath = dbPath ?? join(ORCHESTRATOR_DIR, 'memory.sqlite');
+        this.db = new Database(resolvedPath, { fileMustExist: false });
+        this.db.pragma('journal_mode = WAL');
+        this.createTables();
+    }
+    createTables() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memory_items (
+        id TEXT PRIMARY KEY,
+        memory_type TEXT NOT NULL,
+        scope TEXT,
+        title TEXT,
+        content TEXT NOT NULL,
+        source_ref TEXT,
+        confidence REAL DEFAULT 0.8,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL,
+        expires_at TEXT,
+        is_pinned INTEGER DEFAULT 0,
+        tags TEXT DEFAULT '[]'
+      );
+
+      CREATE TABLE IF NOT EXISTS trust_records (
+        id TEXT PRIMARY KEY,
+        action TEXT NOT NULL,
+        category TEXT NOT NULL,
+        severity TEXT NOT NULL DEFAULT 'medium',
+        repo TEXT,
+        approval_count INTEGER DEFAULT 0,
+        rejection_count INTEGER DEFAULT 0,
+        last_approved_at TEXT,
+        last_rejected_at TEXT,
+        pinned_level TEXT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_memory_type ON memory_items(memory_type);
+      CREATE INDEX IF NOT EXISTS idx_memory_scope ON memory_items(scope);
+      CREATE INDEX IF NOT EXISTS idx_memory_expires ON memory_items(expires_at);
+      CREATE INDEX IF NOT EXISTS idx_trust_action ON trust_records(action, category, repo);
+    `);
+        // FTS5 virtual table for full-text search
+        // Use a separate try-catch since FTS5 tables can't use IF NOT EXISTS
+        try {
+            this.db.exec(`
+        CREATE VIRTUAL TABLE memory_fts USING fts5(
+          title, content, tags,
+          content='memory_items',
+          content_rowid='rowid',
+          tokenize='unicode61'
+        );
+      `);
+        }
+        catch {
+            // Table already exists — that's fine
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Memory CRUD
+    // -------------------------------------------------------------------------
+    /** Insert or update a memory item. */
+    upsert(item) {
+        const id = item.id ?? randomUUID();
+        const now = new Date().toISOString();
+        const tagsJson = JSON.stringify(item.tags);
+        const existing = this.db.prepare('SELECT id FROM memory_items WHERE id = ?').get(id);
+        if (existing) {
+            this.db.prepare(`
+        UPDATE memory_items SET
+          memory_type = ?, scope = ?, title = ?, content = ?,
+          source_ref = ?, confidence = ?, updated_at = ?,
+          expires_at = ?, is_pinned = ?, tags = ?
+        WHERE id = ?
+      `).run(item.memoryType, item.scope, item.title, item.content, item.sourceRef, item.confidence, now, item.expiresAt, item.isPinned ? 1 : 0, tagsJson, id);
+        }
+        else {
+            this.db.prepare(`
+        INSERT INTO memory_items (id, memory_type, scope, title, content,
+          source_ref, confidence, created_at, updated_at,
+          expires_at, is_pinned, tags)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(id, item.memoryType, item.scope, item.title, item.content, item.sourceRef, item.confidence, now, now, item.expiresAt, item.isPinned ? 1 : 0, tagsJson);
+        }
+        // Update FTS index
+        this.db.prepare('INSERT INTO memory_fts(rowid, title, content, tags) VALUES ((SELECT rowid FROM memory_items WHERE id = ?), ?, ?, ?)').run(id, item.title ?? '', item.content, tagsJson);
+        return id;
+    }
+    /** Delete a memory item by ID. */
+    delete(id) {
+        const result = this.db.prepare('DELETE FROM memory_items WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    /** Get a memory item by ID. */
+    get(id) {
+        const row = this.db.prepare('SELECT * FROM memory_items WHERE id = ?').get(id);
+        return row ? this.rowToItem(row) : null;
+    }
+    /** List memory items with optional filters. */
+    list(filters) {
+        let sql = 'SELECT * FROM memory_items WHERE 1=1';
+        const params = [];
+        if (filters?.memoryType) {
+            sql += ' AND memory_type = ?';
+            params.push(filters.memoryType);
+        }
+        if (filters?.scope !== undefined) {
+            if (filters.scope === null) {
+                sql += ' AND scope IS NULL';
+            }
+            else {
+                sql += ' AND scope = ?';
+                params.push(filters.scope);
+            }
+        }
+        if (filters?.pinnedOnly) {
+            sql += ' AND is_pinned = 1';
+        }
+        sql += ' ORDER BY updated_at DESC';
+        if (filters?.limit) {
+            sql += ' LIMIT ?';
+            params.push(filters.limit);
+        }
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(r => this.rowToItem(r));
+    }
+    /** Full-text search across memory items. */
+    search(query, limit = 10) {
+        const rows = this.db.prepare(`
+      SELECT m.* FROM memory_items m
+      JOIN memory_fts f ON m.rowid = f.rowid
+      WHERE memory_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
+    `).all(query, limit);
+        return rows.map(r => this.rowToItem(r));
+    }
+    /** Remove expired items. */
+    expireStale() {
+        const now = new Date().toISOString();
+        const result = this.db.prepare('DELETE FROM memory_items WHERE expires_at IS NOT NULL AND expires_at < ?').run(now);
+        return result.changes;
+    }
+    // -------------------------------------------------------------------------
+    // Trust Records
+    // -------------------------------------------------------------------------
+    /** Get or create a trust record for an action pattern. */
+    getTrust(action, category, repo) {
+        const row = this.db.prepare(repo
+            ? 'SELECT * FROM trust_records WHERE action = ? AND category = ? AND repo = ?'
+            : 'SELECT * FROM trust_records WHERE action = ? AND category = ? AND repo IS NULL').get(...(repo ? [action, category, repo] : [action, category]));
+        if (row)
+            return this.rowToTrust(row);
+        // Check for global override
+        if (repo) {
+            const globalRow = this.db.prepare('SELECT * FROM trust_records WHERE action = ? AND category = ? AND repo IS NULL').get(action, category);
+            if (globalRow?.pinned_level)
+                return this.rowToTrust(globalRow);
+        }
+        // Create new record
+        const id = randomUUID();
+        this.db.prepare('INSERT INTO trust_records (id, action, category, repo) VALUES (?, ?, ?, ?)').run(id, action, category, repo);
+        return {
+            id, action, category, severity: 'medium', repo,
+            approvalCount: 0, rejectionCount: 0,
+            lastApprovedAt: null, lastRejectedAt: null, pinnedLevel: null,
+        };
+    }
+    /** Record a user approval for an action pattern. */
+    recordApproval(action, category, repo) {
+        const trust = this.getTrust(action, category, repo);
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      UPDATE trust_records SET
+        approval_count = approval_count + 1,
+        last_approved_at = ?
+      WHERE id = ?
+    `).run(now, trust.id);
+        return { ...trust, approvalCount: trust.approvalCount + 1, lastApprovedAt: now };
+    }
+    /** Record a user rejection — resets trust to ASK level. */
+    recordRejection(action, category, repo) {
+        const trust = this.getTrust(action, category, repo);
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      UPDATE trust_records SET
+        approval_count = 0,
+        rejection_count = rejection_count + 1,
+        last_rejected_at = ?,
+        pinned_level = NULL
+      WHERE id = ?
+    `).run(now, trust.id);
+        return { ...trust, approvalCount: 0, rejectionCount: trust.rejectionCount + 1, lastRejectedAt: now, pinnedLevel: null };
+    }
+    /** Pin a trust record to a specific level (user override). */
+    pinTrust(action, category, repo, level) {
+        const trust = this.getTrust(action, category, repo);
+        this.db.prepare('UPDATE trust_records SET pinned_level = ? WHERE id = ?').run(level, trust.id);
+    }
+    /** Reset all trust records back to ASK. */
+    resetAllTrust() {
+        this.db.prepare('UPDATE trust_records SET approval_count = 0, pinned_level = NULL').run();
+    }
+    /** Compute the effective trust level for an action. */
+    computeTrustLevel(action, category, severity, repo) {
+        const trust = this.getTrust(action, category, repo);
+        // User-pinned override takes precedence
+        if (trust.pinnedLevel)
+            return trust.pinnedLevel;
+        // High-severity actions have higher thresholds
+        const isHighSeverity = severity === 'high' || severity === 'critical';
+        const notifyThreshold = isHighSeverity ? 4 : 2;
+        const silentThreshold = isHighSeverity ? Infinity : 5; // high-severity never reaches silent
+        if (trust.approvalCount >= silentThreshold)
+            return 'silent';
+        if (trust.approvalCount >= notifyThreshold)
+            return 'notify_do';
+        return 'ask';
+    }
+    /** List all trust records with their effective levels. */
+    listTrustRecords() {
+        const rows = this.db.prepare('SELECT * FROM trust_records ORDER BY category, action').all();
+        return rows.map(r => {
+            const trust = this.rowToTrust(r);
+            return {
+                ...trust,
+                effectiveLevel: this.computeTrustLevel(trust.action, trust.category, trust.severity, trust.repo),
+            };
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Cleanup
+    // -------------------------------------------------------------------------
+    close() {
+        this.db.close();
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    rowToItem(row) {
+        return {
+            id: row.id,
+            memoryType: row.memory_type,
+            scope: row.scope,
+            title: row.title,
+            content: row.content,
+            sourceRef: row.source_ref,
+            confidence: row.confidence,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            expiresAt: row.expires_at,
+            isPinned: row.is_pinned === 1,
+            tags: JSON.parse(row.tags || '[]'),
+        };
+    }
+    rowToTrust(row) {
+        return {
+            id: row.id,
+            action: row.action,
+            category: row.category,
+            severity: row.severity,
+            repo: row.repo,
+            approvalCount: row.approval_count,
+            rejectionCount: row.rejection_count,
+            lastApprovedAt: row.last_approved_at,
+            lastRejectedAt: row.last_rejected_at,
+            pinnedLevel: row.pinned_level,
+        };
+    }
+}
+//# sourceMappingURL=orchestrator-memory.js.map

package/server/dist/orchestrator-memory.js.map

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

package/server/dist/orchestrator-monitor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Orchestrator proactive monitor — watches for new reports, idle repos,
+ * and workflow events, then queues notifications for the orchestrator session.
+ *
+ * Runs a periodic poll and subscribes to workflow engine events.
+ * Notifications are delivered in-chat via the orchestrator session.
+ */
+import type { SessionManager } from './session-manager.js';
+import type { WorkflowEngine } from './workflow-engine.js';
+import { OrchestratorMemory } from './orchestrator-memory.js';
+export interface OrchestratorNotification {
+    id: string;
+    severity: 'info' | 'action' | 'alert';
+    title: string;
+    body: string;
+    timestamp: string;
+    delivered: boolean;
+}
+export declare class OrchestratorMonitor {
+    private sessions;
+    private pollTimer;
+    private agingTimer;
+    private notifications;
+    private seenReports;
+    private memory;
+    constructor(sessions: SessionManager);
+    /** Connect to the workflow engine for event-driven notifications. */
+    setEngine(engine: WorkflowEngine): void;
+    /** Set the memory store for aging and decision tracking. */
+    setMemory(memory: OrchestratorMemory): void;
+    /** Start the periodic poll. */
+    start(): void;
+    /** Stop the monitor. */
+    stop(): void;
+    /** Get pending (undelivered) notifications. */
+    getPending(): OrchestratorNotification[];
+    /** Mark notifications as delivered. */
+    markDelivered(ids: string[]): void;
+    /** Get all notifications (including delivered). */
+    getAll(): OrchestratorNotification[];
+    /** Run aging cycle and check for pending decision assessments. */
+    private runAgingAndAssessments;
+    /** Initial scan — populate the set of already-seen reports. */
+    private initialScan;
+    /** Periodic poll — check for new reports and idle repos. */
+    private poll;
+    /** Check for reports we haven't seen before. */
+    private checkNewReports;
+    /** Check for repos that haven't had recent commits. */
+    private checkPassiveRepos;
+    /** Handle workflow engine events. */
+    private handleWorkflowEvent;
+    /** Add a notification. */
+    private addNotification;
+    /** Deliver a notification to the orchestrator chat session. */
+    private deliverToOrchestrator;
+    /** Discover repo paths from REPOS_ROOT. */
+    private discoverRepoPaths;
+}

package/server/dist/orchestrator-monitor.js

@@ -0,0 +1,238 @@
+/**
+ * Orchestrator proactive monitor — watches for new reports, idle repos,
+ * and workflow events, then queues notifications for the orchestrator session.
+ *
+ * Runs a periodic poll and subscribes to workflow engine events.
+ * Notifications are delivered in-chat via the orchestrator session.
+ */
+import { readdirSync, statSync, existsSync } from 'fs';
+import { join } from 'path';
+import { scanRepoReports } from './orchestrator-reports.js';
+import { runAgingCycle, getPendingOutcomeAssessments } from './orchestrator-learning.js';
+import { getOrchestratorSessionId } from './orchestrator-manager.js';
+import { REPOS_ROOT, getAgentDisplayName } from './config.js';
+// ---------------------------------------------------------------------------
+// Monitor
+// ---------------------------------------------------------------------------
+const POLL_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+const PASSIVE_THRESHOLD_DAYS = 30;
+export class OrchestratorMonitor {
+    sessions;
+    pollTimer = null;
+    agingTimer = null;
+    notifications = [];
+    seenReports = new Set();
+    memory = null;
+    constructor(sessions) {
+        this.sessions = sessions;
+    }
+    /** Connect to the workflow engine for event-driven notifications. */
+    setEngine(engine) {
+        engine.on('workflow_event', (event) => {
+            this.handleWorkflowEvent(event);
+        });
+    }
+    /** Set the memory store for aging and decision tracking. */
+    setMemory(memory) {
+        this.memory = memory;
+    }
+    /** Start the periodic poll. */
+    start() {
+        if (this.pollTimer)
+            return;
+        console.log('[orchestrator-monitor] Starting proactive monitor (poll every 15m)');
+        // Initial scan to populate seen reports
+        void this.initialScan();
+        this.pollTimer = setInterval(() => {
+            void this.poll();
+        }, POLL_INTERVAL_MS);
+        // Run aging cycle daily (check every 6 hours)
+        this.agingTimer = setInterval(() => {
+            this.runAgingAndAssessments();
+        }, 6 * 60 * 60 * 1000);
+    }
+    /** Stop the monitor. */
+    stop() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        if (this.agingTimer) {
+            clearInterval(this.agingTimer);
+            this.agingTimer = null;
+        }
+    }
+    /** Get pending (undelivered) notifications. */
+    getPending() {
+        return this.notifications.filter(n => !n.delivered);
+    }
+    /** Mark notifications as delivered. */
+    markDelivered(ids) {
+        for (const n of this.notifications) {
+            if (ids.includes(n.id))
+                n.delivered = true;
+        }
+    }
+    /** Get all notifications (including delivered). */
+    getAll() {
+        return [...this.notifications].sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    /** Run aging cycle and check for pending decision assessments. */
+    runAgingAndAssessments() {
+        if (!this.memory)
+            return;
+        try {
+            const agingResult = runAgingCycle(this.memory);
+            if (agingResult.expired > 0 || agingResult.compacted > 0) {
+                console.log(`[orchestrator-monitor] Aging cycle: ${agingResult.expired} expired, ${agingResult.compacted} compacted, ${agingResult.decayed} decayed`);
+            }
+            // Check for decisions that need outcome assessment
+            const pending = getPendingOutcomeAssessments(this.memory);
+            if (pending.length > 0) {
+                this.addNotification({
+                    severity: 'info',
+                    title: 'Decisions need review',
+                    body: `${pending.length} decision(s) from over a week ago need outcome assessment. Ask me to review them.`,
+                });
+            }
+        }
+        catch (err) {
+            console.error('[orchestrator-monitor] Aging cycle error:', err);
+        }
+    }
+    /** Initial scan — populate the set of already-seen reports. */
+    async initialScan() {
+        const repoPaths = this.discoverRepoPaths();
+        for (const repoPath of repoPaths) {
+            const reports = scanRepoReports(repoPath);
+            for (const r of reports) {
+                this.seenReports.add(r.filePath);
+            }
+        }
+        // initial scan complete
+    }
+    /** Periodic poll — check for new reports and idle repos. */
+    async poll() {
+        const repoPaths = this.discoverRepoPaths();
+        // Check for new reports
+        this.checkNewReports(repoPaths);
+        // Check for passive repos
+        this.checkPassiveRepos(repoPaths);
+        // initial scan complete
+    }
+    /** Check for reports we haven't seen before. */
+    checkNewReports(repoPaths) {
+        for (const repoPath of repoPaths) {
+            const reports = scanRepoReports(repoPath);
+            const newReports = reports.filter(r => !this.seenReports.has(r.filePath));
+            if (newReports.length > 0) {
+                for (const r of newReports) {
+                    this.seenReports.add(r.filePath);
+                }
+                const repoName = repoPath.split('/').pop() ?? repoPath;
+                const categories = [...new Set(newReports.map(r => r.category))];
+                this.addNotification({
+                    severity: 'action',
+                    title: `New reports for ${repoName}`,
+                    body: `${newReports.length} new report(s) landed: ${categories.join(', ')}. Want a summary?`,
+                });
+            }
+        }
+    }
+    /** Check for repos that haven't had recent commits. */
+    checkPassiveRepos(repoPaths) {
+        const now = Date.now();
+        for (const repoPath of repoPaths) {
+            try {
+                const gitDir = join(repoPath, '.git');
+                if (!existsSync(gitDir))
+                    continue;
+                // Use HEAD ref's mtime as a proxy for last commit time
+                const headFile = join(gitDir, 'HEAD');
+                if (!existsSync(headFile))
+                    continue;
+                const headStat = statSync(headFile);
+                const daysSinceActivity = Math.floor((now - headStat.mtime.getTime()) / (24 * 60 * 60 * 1000));
+                if (daysSinceActivity >= PASSIVE_THRESHOLD_DAYS) {
+                    const repoName = repoPath.split('/').pop() ?? repoPath;
+                    this.addNotification({
+                        severity: 'info',
+                        title: `${repoName} looks passive`,
+                        body: `No activity in ${daysSinceActivity} days. Consider de-scheduling workflows to save resources.`,
+                    });
+                }
+            }
+            catch {
+                // Skip repos we can't stat
+            }
+        }
+    }
+    /** Handle workflow engine events. */
+    handleWorkflowEvent(event) {
+        // Notify on workflow failures
+        if (event.eventType === 'run_failed') {
+            this.addNotification({
+                severity: 'alert',
+                title: `Workflow failed: ${event.kind}`,
+                body: `Run ${event.runId} failed. Check the workflow logs for details.`,
+            });
+        }
+        // Notify on successful runs that produce reports
+        if (event.eventType === 'run_succeeded') {
+            // Report was likely written — next poll will pick it up as a new report
+        }
+    }
+    /** Add a notification. */
+    addNotification(opts) {
+        const notification = {
+            id: `notif-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            timestamp: new Date().toISOString(),
+            delivered: false,
+            ...opts,
+        };
+        this.notifications.push(notification);
+        // Keep last 100 notifications
+        if (this.notifications.length > 100) {
+            this.notifications = this.notifications.slice(-100);
+        }
+        // Deliver to orchestrator session if active
+        this.deliverToOrchestrator(notification);
+    }
+    /** Deliver a notification to the orchestrator chat session. */
+    deliverToOrchestrator(notification) {
+        const orchestratorId = getOrchestratorSessionId(this.sessions);
+        if (!orchestratorId)
+            return;
+        const session = this.sessions.get(orchestratorId);
+        if (!session?.claudeProcess?.isAlive())
+            return;
+        // Send as a system message that the orchestrator will see and respond to
+        const message = `[Agent ${getAgentDisplayName()} Notification — ${notification.severity.toUpperCase()}]\n${notification.title}\n${notification.body}`;
+        this.sessions.sendInput(orchestratorId, message);
+        notification.delivered = true;
+    }
+    /** Discover repo paths from REPOS_ROOT. */
+    discoverRepoPaths() {
+        if (!existsSync(REPOS_ROOT))
+            return [];
+        try {
+            return readdirSync(REPOS_ROOT)
+                .map(name => join(REPOS_ROOT, name))
+                .filter(p => {
+                try {
+                    return statSync(p).isDirectory() && existsSync(join(p, '.git'));
+                }
+                catch {
+                    return false;
+                }
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=orchestrator-monitor.js.map

package/server/dist/orchestrator-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-monitor.js","sourceRoot":"","sources":["../orchestrator-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAA;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAe7D,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAE,aAAa;AACtD,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAEjC,MAAM,OAAO,mBAAmB;IACtB,QAAQ,CAAgB;IACxB,SAAS,GAA0C,IAAI,CAAA;IACvD,UAAU,GAA0C,IAAI,CAAA;IACxD,aAAa,GAA+B,EAAE,CAAA;IAC9C,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,MAAM,GAA8B,IAAI,CAAA;IAEhD,YAAY,QAAwB;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,MAAsB;QAC9B,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAoB,EAAE,EAAE;YACnD,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,4DAA4D;IAC5D,SAAS,CAAC,MAA0B;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACH,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAC1B,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAA;QAEjF,wCAAwC;QACxC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAA;QAEvB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;QAClB,CAAC,EAAE,gBAAgB,CAAC,CAAA;QAEpB,8CAA8C;QAC9C,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,sBAAsB,EAAE,CAAA;QAC/B,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,wBAAwB;IACxB,IAAI;QACF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACvB,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;QACxB,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACrD,CAAC;IAED,uCAAuC;IACvC,aAAa,CAAC,GAAa;QACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,CAAC,CAAC,SAAS,GAAG,IAAI,CAAA;QAC5C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IACvF,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAE5E,kEAAkE;IAC1D,sBAAsB;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QAExB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC9C,IAAI,WAAW,CAAC,OAAO,GAAG,CAAC,IAAI,WAAW,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,uCAAuC,WAAW,CAAC,OAAO,aAAa,WAAW,CAAC,SAAS,eAAe,WAAW,CAAC,OAAO,UAAU,CAAC,CAAA;YACvJ,CAAC;YAED,mDAAmD;YACnD,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,eAAe,CAAC;oBACnB,QAAQ,EAAE,MAAM;oBAChB,KAAK,EAAE,uBAAuB;oBAC9B,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,mFAAmF;iBAC3G,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,2CAA2C,EAAE,GAAG,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,+DAA+D;IACvD,KAAK,CAAC,WAAW;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAC1C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;YACzC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;YAClC,CAAC;QACH,CAAC;QACD,wBAAwB;IAC1B,CAAC;IAED,4DAA4D;IACpD,KAAK,CAAC,IAAI;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAE1C,wBAAwB;QACxB,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;QAE/B,0BAA0B;QAC1B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QAEjC,wBAAwB;IAC1B,CAAC;IAED,gDAAgD;IACxC,eAAe,CAAC,SAAmB;QACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;YAEzE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;oBAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;gBAClC,CAAC;gBAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAA;gBACtD,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAEhE,IAAI,CAAC,eAAe,CAAC;oBACnB,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,mBAAmB,QAAQ,EAAE;oBACpC,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,0BAA0B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB;iBAC7F,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,uDAAuD;IAC/C,iBAAiB,CAAC,SAAmB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;gBACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;oBAAE,SAAQ;gBAEjC,uDAAuD;gBACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,SAAQ;gBAEnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBACnC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;gBAE9F,IAAI,iBAAiB,IAAI,sBAAsB,EAAE,CAAC;oBAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAA;oBACtD,IAAI,CAAC,eAAe,CAAC;wBACnB,QAAQ,EAAE,MAAM;wBAChB,KAAK,EAAE,GAAG,QAAQ,gBAAgB;wBAClC,IAAI,EAAE,kBAAkB,iBAAiB,4DAA4D;qBACtG,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,qCAAqC;IAC7B,mBAAmB,CAAC,KAAoB;QAC9C,8BAA8B;QAC9B,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;YACrC,IAAI,CAAC,eAAe,CAAC;gBACnB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,oBAAoB,KAAK,CAAC,IAAI,EAAE;gBACvC,IAAI,EAAE,OAAO,KAAK,CAAC,KAAK,+CAA+C;aACxE,CAAC,CAAA;QACJ,CAAC;QAED,iDAAiD;QACjD,IAAI,KAAK,CAAC,SAAS,KAAK,eAAe,EAAE,CAAC;YACxC,wEAAwE;QAC1E,CAAC;IACH,CAAC;IAED,0BAA0B;IAClB,eAAe,CAAC,IAAsE;QAC5F,MAAM,YAAY,GAA6B;YAC7C,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACnE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,KAAK;YAChB,GAAG,IAAI;SACR,CAAA;QACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAErC,8BAA8B;QAC9B,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAA;QACrD,CAAC;QAED,4CAA4C;QAC5C,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;IAED,+DAA+D;IACvD,qBAAqB,CAAC,YAAsC;QAClE,MAAM,cAAc,GAAG,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC9D,IAAI,CAAC,cAAc;YAAE,OAAM;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACjD,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE;YAAE,OAAM;QAE9C,yEAAyE;QACzE,MAAM,OAAO,GAAG,UAAU,mBAAmB,EAAE,mBAAmB,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,YAAY,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,EAAE,CAAA;QACrJ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;QAChD,YAAY,CAAC,SAAS,GAAG,IAAI,CAAA;IAC/B,CAAC;IAED,2CAA2C;IACnC,iBAAiB;QACvB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAA;QACtC,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,UAAU,CAAC;iBAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;iBACnC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACV,IAAI,CAAC;oBACH,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;gBACjE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC,CAAC,CAAA;QACN,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;CACF"}

package/server/dist/orchestrator-reports.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Orchestrator report reader — scans .codekin/reports/ across managed repos.
+ *
+ * Discovers audit reports, parses their metadata, and provides them
+ * to the orchestrator session for triage and action.
+ */
+export interface ReportMeta {
+    /** Full path to the report file. */
+    filePath: string;
+    /** Report category (directory name): repo-health, security, code-review, etc. */
+    category: string;
+    /** Date extracted from filename (YYYY-MM-DD). */
+    date: string;
+    /** Repository path this report belongs to. */
+    repoPath: string;
+    /** File size in bytes. */
+    size: number;
+    /** Last modified time. */
+    mtime: string;
+}
+export interface ReportContent extends ReportMeta {
+    /** Full markdown content of the report. */
+    content: string;
+}
+/**
+ * Scan a single repo for all available reports.
+ * Returns metadata only (no content) for efficiency.
+ */
+export declare function scanRepoReports(repoPath: string): ReportMeta[];
+/**
+ * Scan multiple repos for reports.
+ */
+export declare function scanAllReports(repoPaths: string[]): ReportMeta[];
+/**
+ * Read a report's full content.
+ */
+export declare function readReport(filePath: string): ReportContent | null;
+/**
+ * Get the latest report for a given repo and category.
+ */
+export declare function getLatestReport(repoPath: string, category: string): ReportMeta | null;
+/**
+ * Get reports that are newer than a given date.
+ */
+export declare function getReportsSince(repoPaths: string[], sinceDate: string): ReportMeta[];