@iflow-mcp/jkheadley-instar 0.26.2

package/dist/core/DispatchManager.js

@@ -0,0 +1,524 @@
+/**
+ * Dispatch Manager — receives and integrates intelligence from Dawn.
+ *
+ * The counterpart to FeedbackManager: while feedback flows agent → Dawn,
+ * dispatches flow Dawn → agent. This is the "collective intelligence"
+ * distribution channel.
+ *
+ * Security model:
+ *   Layer 1 (Transport): HTTPS only, source URL validation
+ *   Layer 2 (Identity): Sends agent identification headers
+ *   Layer 3 (Intelligence): Agent evaluates dispatch content before applying
+ *
+ * Dispatches are stored locally in .instar/state/dispatches.json and
+ * can be loaded into agent context for behavioral integration.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** Types that are safe for auto-apply (no security risk from automated integration) */
+const AUTO_APPLY_SAFE_TYPES = new Set([
+    'lesson', 'strategy',
+]);
+/** Priorities that are safe for auto-apply (exclude critical — those deserve human eyes) */
+const AUTO_APPLY_SAFE_PRIORITIES = new Set([
+    'low', 'normal', 'high',
+]);
+export class DispatchManager {
+    config;
+    dispatchFile;
+    version;
+    lastCheckFile;
+    contextFile;
+    constructor(config) {
+        if (config.dispatchUrl) {
+            DispatchManager.validateDispatchUrl(config.dispatchUrl);
+        }
+        this.config = config;
+        this.dispatchFile = config.dispatchFile;
+        this.version = config.version || '0.0.0';
+        this.lastCheckFile = config.dispatchFile.replace('.json', '-last-check.json');
+        this.contextFile = config.dispatchFile.replace('dispatches.json', 'dispatch-context.md');
+    }
+    /** Validate dispatch URL is HTTPS and not internal. */
+    static validateDispatchUrl(url) {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            throw new Error(`DispatchManager: invalid dispatch URL: ${url}`);
+        }
+        if (parsed.protocol !== 'https:') {
+            throw new Error('DispatchManager: dispatch URL must use HTTPS');
+        }
+        const host = parsed.hostname.toLowerCase();
+        if (host === 'localhost' || host === '127.0.0.1' || host === '::1' || host === '0.0.0.0' ||
+            host.startsWith('10.') || host.startsWith('192.168.') || host.endsWith('.local') ||
+            host.startsWith('169.254.') || host === '[::1]') {
+            throw new Error('DispatchManager: dispatch URL must not point to internal addresses');
+        }
+    }
+    /** Standard headers identifying this agent. */
+    get requestHeaders() {
+        return {
+            'Accept': 'application/json',
+            'User-Agent': `instar/${this.version} (node/${process.version})`,
+            'X-Instar-Version': this.version,
+        };
+    }
+    /**
+     * Poll for new dispatches since last check.
+     */
+    async check() {
+        if (!this.config.enabled || !this.config.dispatchUrl) {
+            return { newCount: 0, dispatches: [], checkedAt: new Date().toISOString() };
+        }
+        const lastCheck = this.getLastCheckTime();
+        const now = new Date().toISOString();
+        try {
+            const url = new URL(this.config.dispatchUrl);
+            if (lastCheck) {
+                url.searchParams.set('since', lastCheck);
+            }
+            const response = await fetch(url.toString(), {
+                method: 'GET',
+                headers: this.requestHeaders,
+                signal: AbortSignal.timeout(15000),
+            });
+            if (!response.ok) {
+                const errorText = await response.text().catch(() => 'Unknown error');
+                return {
+                    newCount: 0,
+                    dispatches: [],
+                    checkedAt: now,
+                    error: `Server returned ${response.status}: ${errorText}`,
+                };
+            }
+            const data = await response.json();
+            // Filter out dispatches we already have
+            const existing = this.loadDispatches();
+            const existingIds = new Set(existing.map(d => d.dispatchId));
+            const newDispatches = data.dispatches
+                .filter(d => !existingIds.has(d.dispatchId))
+                .map(d => ({
+                dispatchId: d.dispatchId,
+                type: d.type,
+                title: d.title,
+                content: d.content,
+                priority: (d.priority || 'normal'),
+                minVersion: d.minVersion,
+                maxVersion: d.maxVersion,
+                createdAt: d.createdAt,
+                receivedAt: now,
+                applied: false,
+            }));
+            // Append new dispatches
+            if (newDispatches.length > 0) {
+                this.appendDispatches(newDispatches);
+            }
+            // Save last check time
+            this.saveLastCheckTime(now);
+            return {
+                newCount: newDispatches.length,
+                dispatches: newDispatches,
+                checkedAt: now,
+            };
+        }
+        catch (err) {
+            return {
+                newCount: 0,
+                dispatches: [],
+                checkedAt: now,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    /**
+     * List all received dispatches.
+     */
+    list() {
+        return this.loadDispatches();
+    }
+    /**
+     * List only unapplied dispatches (includes those pending approval).
+     */
+    pending() {
+        return this.loadDispatches().filter(d => !d.applied);
+    }
+    /**
+     * List only dispatches awaiting human approval.
+     */
+    pendingApproval() {
+        return this.loadDispatches().filter(d => d.pendingApproval === true && !d.applied);
+    }
+    /**
+     * Approve a dispatch that was pending human sign-off.
+     * Clears pendingApproval and marks as applied with an accepted evaluation.
+     */
+    approve(dispatchId) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch || !dispatch.pendingApproval)
+            return false;
+        dispatch.pendingApproval = false;
+        dispatch.applied = true;
+        dispatch.evaluation = {
+            decision: 'accepted',
+            reason: 'Human-approved',
+            evaluatedAt: new Date().toISOString(),
+            auto: false,
+        };
+        this.saveDispatches(dispatches);
+        this.rebuildContextFile();
+        return true;
+    }
+    /**
+     * Reject a dispatch that was pending human sign-off.
+     * Clears pendingApproval and records a rejection evaluation.
+     */
+    reject(dispatchId, reason) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch || !dispatch.pendingApproval)
+            return false;
+        dispatch.pendingApproval = false;
+        dispatch.evaluation = {
+            decision: 'rejected',
+            reason,
+            evaluatedAt: new Date().toISOString(),
+            auto: false,
+        };
+        this.saveDispatches(dispatches);
+        return true;
+    }
+    /**
+     * Mark a dispatch as pending human approval.
+     */
+    markPendingApproval(dispatchId) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch)
+            return false;
+        dispatch.pendingApproval = true;
+        this.saveDispatches(dispatches);
+        return true;
+    }
+    /**
+     * Mark a dispatch as applied.
+     */
+    markApplied(dispatchId) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch)
+            return false;
+        dispatch.applied = true;
+        this.saveDispatches(dispatches);
+        return true;
+    }
+    /**
+     * Get a single dispatch by ID.
+     */
+    get(dispatchId) {
+        return this.loadDispatches().find(d => d.dispatchId === dispatchId) ?? null;
+    }
+    /**
+     * Generate a context string for loading into agent sessions.
+     * Returns pending high-priority dispatches formatted for LLM consumption.
+     */
+    generateContext() {
+        const pending = this.pending();
+        if (pending.length === 0)
+            return '';
+        // Sort by priority (critical > high > normal > low)
+        const priorityOrder = { critical: 0, high: 1, normal: 2, low: 3 };
+        pending.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+        const lines = [
+            '## Intelligence Dispatches',
+            '',
+            `${pending.length} pending dispatch${pending.length === 1 ? '' : 'es'} from Dawn:`,
+            '',
+        ];
+        for (const d of pending) {
+            const priorityTag = d.priority === 'critical' ? ' [CRITICAL]' :
+                d.priority === 'high' ? ' [HIGH]' : '';
+            lines.push(`### ${d.title}${priorityTag}`);
+            lines.push(`Type: ${d.type} | ID: ${d.dispatchId}`);
+            lines.push('');
+            lines.push(d.content);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    // ── Phase 2: Intelligent Application ────────────────────────────
+    /**
+     * Evaluate a dispatch — record whether it was accepted, rejected, or deferred.
+     * This is the "intelligence as security" layer: the agent decides.
+     */
+    evaluate(dispatchId, decision, reason) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch)
+            return false;
+        dispatch.evaluation = {
+            decision,
+            reason,
+            evaluatedAt: new Date().toISOString(),
+            auto: false,
+        };
+        // If accepted, also mark as applied
+        if (decision === 'accepted') {
+            dispatch.applied = true;
+        }
+        this.saveDispatches(dispatches);
+        return true;
+    }
+    /**
+     * Apply a dispatch to the persistent context file.
+     * This writes the dispatch content to .instar/state/dispatch-context.md
+     * which agents load at session start for behavioral integration.
+     */
+    applyToContext(dispatchId) {
+        const dispatch = this.get(dispatchId);
+        if (!dispatch)
+            return false;
+        // Mark as applied if not already
+        if (!dispatch.applied) {
+            this.markApplied(dispatchId);
+        }
+        // Rebuild the context file from all applied dispatches
+        this.rebuildContextFile();
+        return true;
+    }
+    /**
+     * Check for new dispatches and auto-apply safe ones.
+     * Auto-apply criteria:
+     *   - autoApply must be enabled in config
+     *   - dispatch type must be in AUTO_APPLY_SAFE_TYPES (lesson, strategy)
+     *   - dispatch priority must not be critical
+     *   - security dispatches are NEVER auto-applied (need agent review)
+     *   - behavioral/configuration dispatches need agent review
+     */
+    async checkAndAutoApply() {
+        const result = await this.check();
+        if (result.newCount === 0 || !this.config.autoApply) {
+            return result;
+        }
+        let autoApplied = 0;
+        const dispatches = this.loadDispatches();
+        for (const newDispatch of result.dispatches) {
+            const stored = dispatches.find(d => d.dispatchId === newDispatch.dispatchId);
+            if (!stored || stored.applied)
+                continue;
+            if (this.isSafeForAutoApply(stored)) {
+                stored.applied = true;
+                stored.evaluation = {
+                    decision: 'accepted',
+                    reason: `Auto-applied: ${stored.type} dispatch with ${stored.priority} priority`,
+                    evaluatedAt: new Date().toISOString(),
+                    auto: true,
+                };
+                autoApplied++;
+            }
+        }
+        if (autoApplied > 0) {
+            this.saveDispatches(dispatches);
+            this.rebuildContextFile();
+        }
+        return { ...result, autoApplied };
+    }
+    /**
+     * Check whether a dispatch is safe for automatic application.
+     */
+    isSafeForAutoApply(dispatch) {
+        return AUTO_APPLY_SAFE_TYPES.has(dispatch.type) &&
+            AUTO_APPLY_SAFE_PRIORITIES.has(dispatch.priority);
+    }
+    /**
+     * Get the path to the persistent context file.
+     */
+    getContextFilePath() {
+        return this.contextFile;
+    }
+    /**
+     * Read the current context file contents (for agent session loading).
+     */
+    readContextFile() {
+        if (!fs.existsSync(this.contextFile))
+            return '';
+        try {
+            return fs.readFileSync(this.contextFile, 'utf-8');
+        }
+        catch {
+            // @silent-fallback-ok — context file returns empty
+            return '';
+        }
+    }
+    // ── Phase 3: Feedback Loop Closure ─────────────────────────────
+    /**
+     * Record feedback on a dispatch — was it helpful?
+     * This is the agent-side of the feedback loop. The route handler
+     * should also forward this to FeedbackManager for upstream delivery.
+     */
+    recordFeedback(dispatchId, helpful, comment) {
+        const dispatches = this.loadDispatches();
+        const dispatch = dispatches.find(d => d.dispatchId === dispatchId);
+        if (!dispatch)
+            return false;
+        dispatch.feedback = {
+            helpful,
+            comment,
+            feedbackAt: new Date().toISOString(),
+        };
+        this.saveDispatches(dispatches);
+        return true;
+    }
+    /**
+     * Get aggregate stats about dispatch effectiveness.
+     */
+    stats() {
+        const dispatches = this.loadDispatches();
+        const byType = {};
+        let applied = 0;
+        let pending = 0;
+        let rejected = 0;
+        let helpfulCount = 0;
+        let unhelpfulCount = 0;
+        for (const d of dispatches) {
+            // Per-type tracking
+            if (!byType[d.type]) {
+                byType[d.type] = { total: 0, applied: 0, helpful: 0 };
+            }
+            byType[d.type].total++;
+            if (d.applied) {
+                applied++;
+                byType[d.type].applied++;
+            }
+            else if (d.evaluation?.decision === 'rejected') {
+                rejected++;
+            }
+            else {
+                pending++;
+            }
+            if (d.feedback?.helpful === true) {
+                helpfulCount++;
+                byType[d.type].helpful++;
+            }
+            else if (d.feedback?.helpful === false) {
+                unhelpfulCount++;
+            }
+        }
+        return {
+            total: dispatches.length,
+            applied,
+            pending,
+            rejected,
+            helpfulCount,
+            unhelpfulCount,
+            byType,
+        };
+    }
+    /**
+     * Get dispatches that have feedback (for upstream aggregation).
+     */
+    withFeedback() {
+        return this.loadDispatches().filter(d => d.feedback != null);
+    }
+    /**
+     * Rebuild the persistent context file from all applied dispatches.
+     * This is the file that agents load at session start.
+     */
+    rebuildContextFile() {
+        const applied = this.loadDispatches().filter(d => d.applied);
+        if (applied.length === 0) {
+            // Remove context file if no applied dispatches
+            if (fs.existsSync(this.contextFile)) {
+                fs.unlinkSync(this.contextFile);
+            }
+            return;
+        }
+        // Sort by type, then by creation date
+        const typeOrder = {
+            security: 0, behavioral: 1, configuration: 2, strategy: 3, lesson: 4,
+        };
+        applied.sort((a, b) => {
+            const typeDiff = (typeOrder[a.type] ?? 5) - (typeOrder[b.type] ?? 5);
+            return typeDiff !== 0 ? typeDiff : a.createdAt.localeCompare(b.createdAt);
+        });
+        const lines = [
+            '# Intelligence Dispatches (Applied)',
+            '',
+            '> This file is auto-generated from applied dispatches.',
+            '> It is loaded into agent sessions for behavioral integration.',
+            `> Last updated: ${new Date().toISOString()}`,
+            '',
+        ];
+        // Group by type
+        let currentType = '';
+        for (const d of applied) {
+            if (d.type !== currentType) {
+                currentType = d.type;
+                lines.push(`## ${currentType.charAt(0).toUpperCase() + currentType.slice(1)} Dispatches`);
+                lines.push('');
+            }
+            lines.push(`### ${d.title}`);
+            lines.push('');
+            lines.push(d.content);
+            lines.push('');
+        }
+        const dir = path.dirname(this.contextFile);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.contextFile, lines.join('\n'));
+    }
+    // ── Private helpers ──────────────────────────────────────────────
+    loadDispatches() {
+        if (!fs.existsSync(this.dispatchFile))
+            return [];
+        try {
+            return JSON.parse(fs.readFileSync(this.dispatchFile, 'utf-8'));
+        }
+        catch {
+            return [];
+        }
+    }
+    saveDispatches(items) {
+        const dir = path.dirname(this.dispatchFile);
+        fs.mkdirSync(dir, { recursive: true });
+        const tmpPath = `${this.dispatchFile}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(items, null, 2));
+            fs.renameSync(tmpPath, this.dispatchFile);
+        }
+        catch (err) {
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch { /* ignore */ }
+            throw err;
+        }
+    }
+    appendDispatches(newItems) {
+        const items = this.loadDispatches();
+        items.push(...newItems);
+        // Cap at 500 dispatches
+        const capped = items.length > 500 ? items.slice(-500) : items;
+        this.saveDispatches(capped);
+    }
+    getLastCheckTime() {
+        if (!fs.existsSync(this.lastCheckFile))
+            return null;
+        try {
+            const data = JSON.parse(fs.readFileSync(this.lastCheckFile, 'utf-8'));
+            return data.lastCheck || null;
+        }
+        catch {
+            // @silent-fallback-ok — last check returns null
+            return null;
+        }
+    }
+    saveLastCheckTime(time) {
+        const dir = path.dirname(this.lastCheckFile);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.lastCheckFile, JSON.stringify({ lastCheck: time }));
+    }
+}
+//# sourceMappingURL=DispatchManager.js.map

package/dist/core/DispatchManager.js.map

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

package/dist/core/DispatchScopeEnforcer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * DispatchScopeEnforcer — scope limits for dispatch execution.
+ *
+ * Part of Phase 4 of the Adaptive Autonomy System (Improvement 3).
+ *
+ * Dispatch types have different scope tiers controlling what they can modify:
+ *   - lesson/strategy: Context only (always eligible for auto-execute)
+ *   - configuration: Config files only (when profile >= collaborative)
+ *   - action: Project files + shell (when profile >= autonomous)
+ *   - behavioral: Agent behavior (CLAUDE.md, hooks) — always requires human
+ *   - security: Security settings — always requires human
+ *
+ * At collaborative profile, action dispatches queue for approval with summary.
+ * At autonomous profile, they auto-execute with Telegram notification.
+ */
+import type { AutonomyProfileLevel } from './types.js';
+import type { Dispatch } from './DispatchManager.js';
+import type { ActionStep } from './DispatchExecutor.js';
+export type DispatchScopeTier = 'context' | 'config' | 'project' | 'behavior' | 'security';
+export interface ScopeCheckResult {
+    /** Whether execution is allowed */
+    allowed: boolean;
+    /** The determined scope tier */
+    tier: DispatchScopeTier;
+    /** Why it was allowed/denied */
+    reason: string;
+    /** Whether the dispatch needs human approval */
+    requiresApproval: boolean;
+}
+export declare class DispatchScopeEnforcer {
+    /**
+     * Check whether a dispatch is allowed to execute at the given autonomy profile.
+     */
+    checkScope(dispatch: Dispatch, profile: AutonomyProfileLevel): ScopeCheckResult;
+    /**
+     * Validate that action steps stay within their scope tier.
+     * Returns invalid steps if any escape the allowed scope.
+     */
+    validateSteps(steps: ActionStep[], tier: DispatchScopeTier): {
+        valid: boolean;
+        violations: string[];
+    };
+    /**
+     * Get the scope tier for a dispatch type.
+     */
+    getScopeTier(type: Dispatch['type']): DispatchScopeTier;
+    /**
+     * Check if a file path is within config scope.
+     */
+    isConfigPath(filePath: string): boolean;
+    /**
+     * Check if a file path is a behavioral file (always requires human).
+     */
+    isBehavioralPath(filePath: string): boolean;
+    private checkStepScope;
+}
+//# sourceMappingURL=DispatchScopeEnforcer.d.ts.map

package/dist/core/DispatchScopeEnforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DispatchScopeEnforcer.d.ts","sourceRoot":"","sources":["../../src/core/DispatchScopeEnforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAgDD,qBAAa,qBAAqB;IAChC;;OAEG;IACH,UAAU,CACR,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,oBAAoB,GAC5B,gBAAgB;IA4CnB;;;OAGG;IACH,aAAa,CACX,KAAK,EAAE,UAAU,EAAE,EACnB,IAAI,EAAE,iBAAiB,GACtB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IAiB3C;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,iBAAiB;IAIvD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM3C,OAAO,CAAC,cAAc;CA6CvB"}