hivemind-pipeline 0.1.0

package/dist/src/core/governance.js

@@ -0,0 +1,276 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/** Level descriptions for human display */
+export const LEVEL_LABELS = {
+    1: 'Full Autonomy',
+    2: 'Notify After',
+    3: 'Notify Before',
+    4: 'Approval Required',
+    5: 'Human Only',
+};
+/** Default domains with initial policies */
+const DEFAULT_POLICIES = [
+    { domain: 'code-generation', level: 2, trustScore: 70, autoPromoteThreshold: 85, autoDemoteOnRevert: true },
+    { domain: 'dependency-updates', level: 3, trustScore: 50, autoPromoteThreshold: 80, autoDemoteOnRevert: true },
+    { domain: 'architecture', level: 4, trustScore: 30, autoPromoteThreshold: 90, autoDemoteOnRevert: true },
+    { domain: 'deployment', level: 5, trustScore: 20, autoPromoteThreshold: 95, autoDemoteOnRevert: true },
+    { domain: 'testing', level: 1, trustScore: 80, autoPromoteThreshold: 90, autoDemoteOnRevert: false },
+    { domain: 'refactoring', level: 2, trustScore: 65, autoPromoteThreshold: 85, autoDemoteOnRevert: true },
+    { domain: 'documentation', level: 1, trustScore: 90, autoPromoteThreshold: 95, autoDemoteOnRevert: false },
+    { domain: 'security', level: 5, trustScore: 10, autoPromoteThreshold: 98, autoDemoteOnRevert: true },
+];
+function emptyState() {
+    return {
+        policies: DEFAULT_POLICIES.map(p => ({ ...p })),
+        decisions: [],
+        trustScores: Object.fromEntries(DEFAULT_POLICIES.map(p => [p.domain, p.trustScore])),
+        overrides: 0,
+        totalDecisions: 0,
+        autonomousRate: 0,
+        budgetAllocation: {},
+    };
+}
+export class GovernanceEngine {
+    state;
+    filePath;
+    constructor(swarmDir) {
+        if (!existsSync(swarmDir)) {
+            mkdirSync(swarmDir, { recursive: true });
+        }
+        this.filePath = join(swarmDir, 'governance.json');
+        this.state = this.load();
+    }
+    // ── Persistence ──────────────────────────────────────────
+    load() {
+        if (!existsSync(this.filePath))
+            return emptyState();
+        try {
+            const raw = readFileSync(this.filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return emptyState();
+        }
+    }
+    save() {
+        writeFileSync(this.filePath, JSON.stringify(this.state, null, 2));
+    }
+    // ── Decision Classification ──────────────────────────────
+    /**
+     * Classify an action within a domain into a governance level.
+     * Returns the level from the matching policy, falling back to level 4
+     * for unknown domains.
+     */
+    classifyDecision(action, domain) {
+        const policy = this.state.policies.find(p => p.domain === domain);
+        const level = policy?.level ?? 4;
+        const trustScore = this.state.trustScores[domain] ?? 50;
+        // Confidence based on trust score and number of prior decisions
+        const domainDecisions = this.state.decisions.filter(d => d.domain === domain);
+        const historyFactor = Math.min(domainDecisions.length / 20, 1);
+        const confidence = Math.round(trustScore * 0.7 + historyFactor * 30);
+        const decision = {
+            id: randomUUID().slice(0, 8),
+            action,
+            domain,
+            level,
+            confidence,
+            reasoning: this.buildReasoning(action, domain, level, trustScore),
+            alternatives: this.suggestAlternatives(level),
+            status: level <= 2 ? 'auto-approved' : 'pending',
+            timestamp: Date.now(),
+        };
+        return decision;
+    }
+    buildReasoning(action, domain, level, trust) {
+        const parts = [];
+        parts.push(`Domain "${domain}" policy is ${LEVEL_LABELS[level]} (level ${level}).`);
+        parts.push(`Current trust score: ${trust}/100.`);
+        if (level <= 2) {
+            parts.push('Auto-approved based on autonomy level and trust score.');
+        }
+        else if (level <= 4) {
+            parts.push('Requires approval before proceeding.');
+        }
+        else {
+            parts.push('Human-only domain — must be performed manually.');
+        }
+        return parts.join(' ');
+    }
+    suggestAlternatives(level) {
+        const alts = [];
+        if (level >= 4)
+            alts.push('Delegate to lower-trust sub-task');
+        if (level >= 3)
+            alts.push('Request scope reduction');
+        if (level >= 2)
+            alts.push('Add automated verification step');
+        return alts;
+    }
+    // ── Decision Recording ───────────────────────────────────
+    /** Record a classified decision and persist it. */
+    recordDecision(decision) {
+        this.state.decisions.push(decision);
+        this.state.totalDecisions++;
+        // Update autonomous rate
+        const autoCount = this.state.decisions.filter(d => d.status === 'auto-approved').length;
+        this.state.autonomousRate = Math.round((autoCount / this.state.totalDecisions) * 100);
+        this.save();
+    }
+    // ── Override Mechanism ───────────────────────────────────
+    /**
+     * Override a pending decision.
+     * Logs the override and auto-reduces trust on repeated overrides.
+     */
+    override(decisionId, action) {
+        const decision = this.state.decisions.find(d => d.id === decisionId);
+        if (!decision)
+            return null;
+        decision.status = action === 'approve' ? 'approved' : 'rejected';
+        decision.resolvedAt = Date.now();
+        decision.resolvedBy = 'human-override';
+        this.state.overrides++;
+        // Count recent overrides for this domain (last 20 decisions)
+        const domainDecisions = this.state.decisions
+            .filter(d => d.domain === decision.domain)
+            .slice(-20);
+        const recentOverrides = domainDecisions.filter(d => d.resolvedBy === 'human-override').length;
+        // Auto-reduce trust if repeated overrides (more than 3 in last 20)
+        if (recentOverrides > 3) {
+            const trustDelta = Math.min(recentOverrides * 2, 15);
+            this.adjustTrust(decision.domain, -trustDelta);
+        }
+        this.save();
+        return decision;
+    }
+    // ── Trust Scoring ────────────────────────────────────────
+    /** Get the current trust score for a domain. */
+    getTrustScore(domain) {
+        return this.state.trustScores[domain] ?? 50;
+    }
+    /**
+     * Adjust trust for a domain. Positive delta = increase on success,
+     * negative delta = decrease on revert/incident.
+     */
+    adjustTrust(domain, delta) {
+        const current = this.state.trustScores[domain] ?? 50;
+        const updated = Math.max(0, Math.min(100, current + delta));
+        this.state.trustScores[domain] = updated;
+        // Update matching policy's trustScore
+        const policy = this.state.policies.find(p => p.domain === domain);
+        if (policy) {
+            policy.trustScore = updated;
+        }
+        // Auto-promote / demote based on thresholds
+        this.evaluatePromotion(domain);
+        this.save();
+    }
+    /** Record a successful outcome — increases trust. */
+    recordSuccess(domain) {
+        this.adjustTrust(domain, 3);
+        // Update last decision outcome
+        const last = [...this.state.decisions]
+            .reverse()
+            .find(d => d.domain === domain && !d.outcome);
+        if (last) {
+            last.outcome = 'success';
+        }
+        this.save();
+    }
+    /** Record a revert/incident — decreases trust. */
+    recordIncident(domain) {
+        this.adjustTrust(domain, -10);
+        const policy = this.state.policies.find(p => p.domain === domain);
+        if (policy?.autoDemoteOnRevert) {
+            this.demotePolicy(domain);
+        }
+        // Update last decision outcome
+        const last = [...this.state.decisions]
+            .reverse()
+            .find(d => d.domain === domain && !d.outcome);
+        if (last) {
+            last.outcome = 'reverted';
+        }
+        this.save();
+    }
+    // ── Auto-Promote / Demote ────────────────────────────────
+    evaluatePromotion(domain) {
+        const policy = this.state.policies.find(p => p.domain === domain);
+        if (!policy)
+            return;
+        const trust = this.state.trustScores[domain] ?? 50;
+        // Auto-promote: trust exceeds threshold and level > 1
+        if (trust >= policy.autoPromoteThreshold && policy.level > 1) {
+            policy.level = (policy.level - 1);
+        }
+    }
+    demotePolicy(domain) {
+        const policy = this.state.policies.find(p => p.domain === domain);
+        if (!policy || policy.level >= 5)
+            return;
+        policy.level = (policy.level + 1);
+    }
+    // ── Policy Management ────────────────────────────────────
+    /** Get the policy for a specific domain. */
+    getPolicy(domain) {
+        return this.state.policies.find(p => p.domain === domain);
+    }
+    /** Set or update the policy for a domain. */
+    setPolicy(domain, level) {
+        const existing = this.state.policies.find(p => p.domain === domain);
+        if (existing) {
+            existing.level = level;
+        }
+        else {
+            this.state.policies.push({
+                domain,
+                level,
+                trustScore: this.state.trustScores[domain] ?? 50,
+                autoPromoteThreshold: 85,
+                autoDemoteOnRevert: true,
+            });
+            if (!(domain in this.state.trustScores)) {
+                this.state.trustScores[domain] = 50;
+            }
+        }
+        this.save();
+    }
+    // ── Budget Governance ────────────────────────────────────
+    /** Set a budget allocation for a surface/priority. */
+    allocateBudget(surface, amount) {
+        this.state.budgetAllocation[surface] = {
+            allocated: amount,
+            spent: this.state.budgetAllocation[surface]?.spent ?? 0,
+        };
+        this.save();
+    }
+    /** Record spend against a surface budget. Returns true if within budget. */
+    recordSpend(surface, amount) {
+        const alloc = this.state.budgetAllocation[surface];
+        if (!alloc)
+            return true; // No budget constraint
+        alloc.spent += amount;
+        this.save();
+        return alloc.spent <= alloc.allocated;
+    }
+    /** Check if a surface is within budget. */
+    isWithinBudget(surface) {
+        const alloc = this.state.budgetAllocation[surface];
+        if (!alloc)
+            return true;
+        return alloc.spent <= alloc.allocated;
+    }
+    // ── Audit Trail ──────────────────────────────────────────
+    /** Get the decision audit trail, optionally limited. */
+    getAuditTrail(limit) {
+        const sorted = [...this.state.decisions].sort((a, b) => b.timestamp - a.timestamp);
+        return limit ? sorted.slice(0, limit) : sorted;
+    }
+    // ── State Access ─────────────────────────────────────────
+    /** Get the full governance state. */
+    getState() {
+        return this.state;
+    }
+}
+//# sourceMappingURL=governance.js.map

package/dist/src/core/governance.js.map

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

package/dist/src/core/guardrails.d.ts

@@ -0,0 +1,34 @@
+import type { GuardrailRule, GuardrailViolation, GuardrailPreset } from '../types.js';
+export declare class GuardrailsEngine {
+    private rules;
+    private preset;
+    constructor(swarmDir?: string, preset?: GuardrailPreset);
+    private applyPreset;
+    evaluate(cwd: string): GuardrailViolation[];
+    /** Evaluate guardrails for a single artifact file. Returns only violations for that artifact. */
+    evaluateArtifact(cwd: string, artifact: string): GuardrailViolation[];
+    private runCheck;
+    /**
+     * Apply auto-fixes for all fixable violations.
+     * Reads artifact files, inserts missing sections/patterns, writes back.
+     */
+    applyFixes(cwd: string, violations: GuardrailViolation[]): {
+        fixed: number;
+        skipped: number;
+    };
+    /**
+     * Insert content after a matching markdown section heading.
+     * Finds the section heading and appends content right after the heading line
+     * (before the next section or at the end of the section's content).
+     */
+    private insertAfterSection;
+    /**
+     * Format a pretty CLI report of violations, grouped by file.
+     * Uses chalk for colors and ESLint-style output.
+     */
+    formatReport(violations: GuardrailViolation[], cwd: string): string;
+    private escapeRegex;
+    getRules(): GuardrailRule[];
+    getPreset(): GuardrailPreset;
+}
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/src/core/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../../src/core/guardrails.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAkB,kBAAkB,EAAE,eAAe,EAAgB,MAAM,aAAa,CAAC;AAoMpH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,eAA4B;IA0BnE,OAAO,CAAC,WAAW;IAoBnB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAgC3C,iGAAiG;IACjG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAoCrE,OAAO,CAAC,QAAQ;IAgIhB;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IA8E7F;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,kBAAkB,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAiDnE,OAAO,CAAC,WAAW;IAInB,QAAQ,IAAI,aAAa,EAAE;IAI3B,SAAS,IAAI,eAAe;CAG7B"}