@guyghost/swarm-dao-core 0.1.0

package/dist/observability/metrics.js

@@ -0,0 +1,224 @@
+// ============================================================
+// Swarm DAO Core — Metrics Collection
+// ============================================================
+function matchesLabels(a, b) {
+    if (!b)
+        return true;
+    if (!a)
+        return false;
+    return Object.entries(b).every(([k, v]) => a[k] === v);
+}
+class CounterImpl {
+    name;
+    description;
+    values = [];
+    constructor(name, description) {
+        this.name = name;
+        this.description = description;
+    }
+    increment(labels) {
+        this.values.push({
+            name: this.name,
+            value: 1,
+            timestamp: new Date().toISOString(),
+            labels,
+        });
+    }
+    getCount(labels) {
+        return this.values.filter((v) => matchesLabels(v.labels, labels)).length;
+    }
+}
+class GaugeImpl {
+    name;
+    description;
+    values = [];
+    constructor(name, description) {
+        this.name = name;
+        this.description = description;
+    }
+    set(value, labels) {
+        this.values.push({
+            name: this.name,
+            value,
+            timestamp: new Date().toISOString(),
+            labels,
+        });
+    }
+    getValue(labels) {
+        const matching = this.values.filter((v) => matchesLabels(v.labels, labels));
+        return matching.length > 0 ? (matching[matching.length - 1]?.value ?? 0) : 0;
+    }
+}
+class HistogramImpl {
+    name;
+    description;
+    buckets;
+    values = [];
+    constructor(name, description, buckets = [10, 50, 100, 250, 500, 1000, 2500, 5000, 10000]) {
+        this.name = name;
+        this.description = description;
+        this.buckets = buckets;
+    }
+    observe(value, labels) {
+        this.values.push({
+            name: this.name,
+            value,
+            timestamp: new Date().toISOString(),
+            labels,
+        });
+    }
+    getCount(labels) {
+        return this.values.filter((v) => matchesLabels(v.labels, labels)).length;
+    }
+    getPercentile(p, labels) {
+        const matching = this.values
+            .filter((v) => matchesLabels(v.labels, labels))
+            .map((v) => v.value)
+            .sort((a, b) => a - b);
+        if (matching.length === 0)
+            return 0;
+        const index = Math.max(0, Math.ceil((p / 100) * matching.length) - 1);
+        return matching[index] ?? 0;
+    }
+    getBucketCounts(labels) {
+        const matching = this.values.filter((v) => matchesLabels(v.labels, labels)).map((v) => v.value);
+        const counts = {};
+        for (const bucket of this.buckets) {
+            counts[`le_${bucket}`] = matching.filter((v) => v <= bucket).length;
+        }
+        counts["+Inf"] = matching.length;
+        return counts;
+    }
+}
+// ── Registry ─────────────────────────────────────────────────
+const counters = new Map();
+const gauges = new Map();
+const histograms = new Map();
+export function createCounter(name, description) {
+    const counter = new CounterImpl(name, description);
+    counters.set(name, counter);
+    return counter;
+}
+export function createGauge(name, description) {
+    const gauge = new GaugeImpl(name, description);
+    gauges.set(name, gauge);
+    return gauge;
+}
+export function createHistogram(name, description, buckets) {
+    const histogram = new HistogramImpl(name, description, buckets);
+    histograms.set(name, histogram);
+    return histogram;
+}
+export function getCounter(name) {
+    return counters.get(name);
+}
+export function getGauge(name) {
+    return gauges.get(name);
+}
+export function getHistogram(name) {
+    return histograms.get(name);
+}
+export function getAllMetrics() {
+    return {
+        counters: Array.from(counters.values()),
+        gauges: Array.from(gauges.values()),
+        histograms: Array.from(histograms.values()),
+    };
+}
+export function resetMetrics() {
+    for (const counter of counters.values()) {
+        counter.values = [];
+    }
+    for (const gauge of gauges.values()) {
+        gauge.values = [];
+    }
+    for (const histogram of histograms.values()) {
+        histogram.values = [];
+    }
+}
+// ── DAO Metrics ──────────────────────────────────────────────
+export const DAO_METRICS = {
+    proposalsCreated: createCounter("dao_proposals_created", "Total proposals created"),
+    proposalsApproved: createCounter("dao_proposals_approved", "Total proposals approved"),
+    proposalsRejected: createCounter("dao_proposals_rejected", "Total proposals rejected"),
+    proposalsExecuted: createCounter("dao_proposals_executed", "Total proposals executed"),
+    votesCast: createCounter("dao_votes_cast", "Total votes cast by agents"),
+    deliberationDuration: createHistogram("dao_deliberation_duration_ms", "Deliberation duration in milliseconds"),
+    agentResponseTime: createHistogram("dao_agent_response_time_ms", "Agent response time in milliseconds"),
+    activeProposals: createGauge("dao_active_proposals", "Number of currently open proposals"),
+    agentCount: createGauge("dao_agent_count", "Number of active agents"),
+    approvalRate: createGauge("dao_approval_rate_percent", "Current approval rate percentage"),
+};
+export function recordProposalCreated(type) {
+    DAO_METRICS.proposalsCreated.increment({ type });
+    DAO_METRICS.activeProposals.set(DAO_METRICS.proposalsCreated.getCount() -
+        DAO_METRICS.proposalsApproved.getCount() -
+        DAO_METRICS.proposalsRejected.getCount());
+}
+export function recordProposalApproved(_id, type) {
+    DAO_METRICS.proposalsApproved.increment({ type });
+    updateApprovalRate();
+}
+export function recordProposalRejected(_id, type) {
+    DAO_METRICS.proposalsRejected.increment({ type });
+    updateApprovalRate();
+}
+export function recordProposalExecuted(_id, type) {
+    DAO_METRICS.proposalsExecuted.increment({ type });
+    DAO_METRICS.activeProposals.set(Math.max(0, DAO_METRICS.activeProposals.getValue() - 1));
+}
+export function recordVoteCast(agentId, position, weight) {
+    DAO_METRICS.votesCast.increment({ agent: agentId, position, weight: String(weight) });
+}
+export function recordDeliberationDuration(durationMs, proposalId) {
+    DAO_METRICS.deliberationDuration.observe(durationMs, { proposal_id: String(proposalId) });
+}
+export function recordAgentResponseTime(durationMs, agentId) {
+    DAO_METRICS.agentResponseTime.observe(durationMs, { agent: agentId });
+}
+function updateApprovalRate() {
+    const approved = DAO_METRICS.proposalsApproved.getCount();
+    const rejected = DAO_METRICS.proposalsRejected.getCount();
+    const total = approved + rejected;
+    DAO_METRICS.approvalRate.set(total > 0 ? Math.round((approved / total) * 100) : 0);
+}
+export function formatMetrics() {
+    const all = getAllMetrics();
+    let output = "# DAO Metrics\n\n";
+    for (const counter of all.counters) {
+        output += `## ${counter.name}\n${counter.description}\n**Total:** ${counter.getCount()}\n\n`;
+    }
+    for (const gauge of all.gauges) {
+        output += `## ${gauge.name}\n${gauge.description}\n**Value:** ${gauge.getValue()}\n\n`;
+    }
+    for (const histogram of all.histograms) {
+        output += `## ${histogram.name}\n${histogram.description}\n**Count:** ${histogram.getCount()}\n**P50:** ${histogram.getPercentile(50)}\n**P95:** ${histogram.getPercentile(95)}\n**P99:** ${histogram.getPercentile(99)}\n\n`;
+    }
+    return output;
+}
+export function formatMetricsPrometheus() {
+    const all = getAllMetrics();
+    let output = "";
+    for (const counter of all.counters) {
+        output += `# HELP ${counter.name} ${counter.description}\n`;
+        output += `# TYPE ${counter.name} counter\n`;
+        output += `${counter.name} ${counter.getCount()}\n\n`;
+    }
+    for (const gauge of all.gauges) {
+        output += `# HELP ${gauge.name} ${gauge.description}\n`;
+        output += `# TYPE ${gauge.name} gauge\n`;
+        output += `${gauge.name} ${gauge.getValue()}\n\n`;
+    }
+    for (const histogram of all.histograms) {
+        output += `# HELP ${histogram.name} ${histogram.description}\n`;
+        output += `# TYPE ${histogram.name} histogram\n`;
+        const buckets = histogram.getBucketCounts();
+        for (const [bucket, count] of Object.entries(buckets)) {
+            output += `${histogram.name}_bucket{le="${bucket}"} ${count}\n`;
+        }
+        output += `${histogram.name}_count ${histogram.getCount()}\n`;
+        output += `${histogram.name}_sum ${histogram.values.reduce((s, v) => s + v.value, 0)}\n\n`;
+    }
+    return output;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

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

package/dist/observability/tracing.d.ts

@@ -0,0 +1,44 @@
+export interface Span {
+    id: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    status: "running" | "success" | "error";
+    error?: string;
+    tags: Record<string, string>;
+    logs: SpanLog[];
+}
+export interface SpanLog {
+    timestamp: string;
+    message: string;
+    fields?: Record<string, unknown>;
+}
+export interface Trace {
+    traceId: string;
+    spans: Span[];
+    rootSpan: Span;
+}
+export declare function startSpan(name: string, options?: {
+    traceId?: string;
+    parentId?: string;
+    tags?: Record<string, string>;
+}): Span;
+export declare function finishSpan(spanId: string, error?: string): Span | undefined;
+export declare function logToSpan(spanId: string, message: string, fields?: Record<string, unknown>): void;
+export declare function tagSpan(spanId: string, key: string, value: string): void;
+export declare function getSpan(spanId: string): Span | undefined;
+export declare function getTrace(traceId: string): Trace | undefined;
+export declare function getAllTraces(): Trace[];
+export declare function getActiveSpans(): Span[];
+export declare function resetTracing(): void;
+export declare function formatTrace(trace: Trace): string;
+export declare function formatTracesSummary(): string;
+export declare function traced<T>(name: string, fn: (span: Span) => Promise<T>, options?: {
+    traceId?: string;
+    parentId?: string;
+    tags?: Record<string, string>;
+}): Promise<T>;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/observability/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../src/observability/tracing.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;CAChB;AASD,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B,GACA,IAAI,CA2BN;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAc3E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CASjG;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxE;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAExD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAE3D;AAED,wBAAgB,YAAY,IAAI,KAAK,EAAE,CAEtC;AAED,wBAAgB,cAAc,IAAI,IAAI,EAAE,CAEvC;AAED,wBAAgB,YAAY,IAAI,IAAI,CAGnC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CA2BhD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAgB5C;AAID,wBAAsB,MAAM,CAAC,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC/E,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/dist/observability/tracing.js

@@ -0,0 +1,129 @@
+// ============================================================
+// Swarm DAO Core — Distributed Tracing
+// ============================================================
+const activeSpans = new Map();
+const traces = new Map();
+function generateId() {
+    return `${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+export function startSpan(name, options) {
+    const traceId = options?.traceId || generateId();
+    const spanId = generateId();
+    const span = {
+        id: spanId,
+        traceId,
+        parentId: options?.parentId,
+        name,
+        startTime: new Date().toISOString(),
+        status: "running",
+        tags: options?.tags || {},
+        logs: [],
+    };
+    activeSpans.set(spanId, span);
+    if (!options?.parentId) {
+        traces.set(traceId, { traceId, spans: [span], rootSpan: span });
+    }
+    else {
+        const trace = traces.get(traceId);
+        if (trace) {
+            trace.spans.push(span);
+        }
+    }
+    return span;
+}
+export function finishSpan(spanId, error) {
+    const span = activeSpans.get(spanId);
+    if (!span)
+        return undefined;
+    span.endTime = new Date().toISOString();
+    span.status = error ? "error" : "success";
+    span.error = error;
+    const start = new Date(span.startTime).getTime();
+    const end = new Date(span.endTime).getTime();
+    span.durationMs = end - start;
+    activeSpans.delete(spanId);
+    return span;
+}
+export function logToSpan(spanId, message, fields) {
+    const span = activeSpans.get(spanId);
+    if (!span)
+        return;
+    span.logs.push({
+        timestamp: new Date().toISOString(),
+        message,
+        fields,
+    });
+}
+export function tagSpan(spanId, key, value) {
+    const span = activeSpans.get(spanId);
+    if (!span)
+        return;
+    span.tags[key] = value;
+}
+export function getSpan(spanId) {
+    return activeSpans.get(spanId);
+}
+export function getTrace(traceId) {
+    return traces.get(traceId);
+}
+export function getAllTraces() {
+    return Array.from(traces.values());
+}
+export function getActiveSpans() {
+    return Array.from(activeSpans.values());
+}
+export function resetTracing() {
+    activeSpans.clear();
+    traces.clear();
+}
+export function formatTrace(trace) {
+    let output = `# Trace: ${trace.traceId}\n\n`;
+    function formatSpan(span, depth) {
+        const indent = "  ".repeat(depth);
+        const status = span.status === "error" ? "❌" : span.status === "success" ? "✅" : "⏳";
+        const duration = span.durationMs !== undefined ? `${span.durationMs}ms` : "running";
+        output += `${indent}${status} ${span.name} (${duration})\n`;
+        if (span.error) {
+            output += `${indent}  Error: ${span.error}\n`;
+        }
+        for (const log of span.logs) {
+            output += `${indent}  [${log.timestamp}] ${log.message}\n`;
+        }
+        // Find child spans
+        const children = trace.spans.filter((s) => s.parentId === span.id);
+        for (const child of children) {
+            formatSpan(child, depth + 1);
+        }
+    }
+    formatSpan(trace.rootSpan, 0);
+    return output;
+}
+export function formatTracesSummary() {
+    const allTraces = getAllTraces();
+    const active = getActiveSpans();
+    let output = "# Traces Summary\n\n";
+    output += `**Total traces:** ${allTraces.length}\n`;
+    output += `**Active spans:** ${active.length}\n\n`;
+    for (const trace of allTraces.slice(-10)) {
+        const root = trace.rootSpan;
+        const duration = root.durationMs !== undefined ? `${root.durationMs}ms` : "running";
+        const status = root.status === "error" ? "❌" : root.status === "success" ? "✅" : "⏳";
+        output += `- ${status} ${root.name} — ${duration} (${trace.spans.length} spans)\n`;
+    }
+    return output;
+}
+// ── Helper: traced function wrapper ──────────────────────────
+export async function traced(name, fn, options) {
+    const span = startSpan(name, options);
+    try {
+        const result = await fn(span);
+        finishSpan(span.id);
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        finishSpan(span.id, message);
+        throw error;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/observability/tracing.js.map

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

package/dist/persistence.d.ts

@@ -0,0 +1,50 @@
+import type { AgentOutput, AuditEntry, CompositeScore, ControlCheckResult, DAOAgent, DAOArtefacts, DAOState, DeliveryPlan, ExecutionSnapshot, ExecutionVerification, Proposal, ProposalOutcome, ProposalStatus, StorageSettings, Vote } from "./types/index.js";
+export declare function getDaoRoot(cwd: string): string;
+export declare function getProposalsDir(daoRoot: string): string;
+export declare function getDecisionsDir(daoRoot: string): string;
+export declare function padId(id: number): string;
+export declare function getProposalPath(daoRoot: string, id: number): string;
+export declare function initStorage(cwd: string): Promise<string>;
+export declare function migrateFromLegacy(cwd: string): Promise<boolean>;
+export declare function getState(): DAOState;
+export declare function setState(newState: DAOState | null): void;
+export declare function getOrCreateState(cwd: string): DAOState;
+export declare function loadState(cwd: string): Promise<DAOState | null>;
+export declare function loadProposalsFromDisk(daoRoot: string): Promise<Proposal[]>;
+export declare function saveProposal(proposalId: number): Promise<string | null>;
+export declare function saveState(): Promise<void>;
+export declare function saveDecisions(): Promise<void>;
+export declare function getStorageSettings(daoRoot: string): Promise<StorageSettings>;
+export declare function updateStorageSettings(daoRoot: string, updates: Partial<StorageSettings>): Promise<StorageSettings>;
+export declare function addAgent(agent: DAOAgent): Promise<void>;
+export declare function removeAgent(agentId: string): Promise<boolean>;
+export declare function getAgent(agentId: string): DAOAgent | undefined;
+export declare function listAgents(): DAOAgent[];
+export declare function createProposal(title: string, type: string, description: string, proposedBy: string, context?: string): Promise<Proposal>;
+export declare function getProposal(proposalId: number): Proposal | undefined;
+export declare function listProposals(): Proposal[];
+export declare function updateProposalStatus(proposalId: number, status: ProposalStatus): Promise<boolean>;
+export declare function addVote(proposalId: number, vote: Vote): Promise<boolean>;
+export declare function storeAgentOutput(proposalId: number, output: AgentOutput): Promise<boolean>;
+export declare function storeSynthesis(proposalId: number, synthesis: string): Promise<boolean>;
+export declare function storeCompositeScore(proposalId: number, score: CompositeScore | undefined): Promise<boolean>;
+export declare function storeControlResult(proposalId: number, result: ControlCheckResult): Promise<void>;
+export declare function getControlResult(proposalId: number): ControlCheckResult | undefined;
+export declare function storeDeliveryPlan(proposalId: number, plan: DeliveryPlan): Promise<void>;
+export declare function getDeliveryPlan(proposalId: number): DeliveryPlan | undefined;
+export declare function recordAudit(proposalId: number, layer: AuditEntry["layer"], action: string, actor: string, details: string): Promise<void>;
+export declare function getAuditLog(proposalId: number): AuditEntry[];
+export declare function getAllAuditLog(): AuditEntry[];
+export declare function getOutcome(proposalId: number): ProposalOutcome | undefined;
+export declare function initOutcome(proposalId: number): Promise<ProposalOutcome>;
+export declare function addRating(proposalId: number, rating: ProposalOutcome["ratings"][0]): Promise<void>;
+export declare function addMetric(proposalId: number, metric: ProposalOutcome["metrics"][0]): Promise<void>;
+export declare function markReviewed(proposalId: number): Promise<void>;
+export declare function captureSnapshot(proposalId: number, snapshot: ExecutionSnapshot): Promise<void>;
+export declare function getSnapshot(proposalId: number): ExecutionSnapshot | undefined;
+export declare function storeVerification(proposalId: number, verification: ExecutionVerification): Promise<void>;
+export declare function getVerification(proposalId: number): ExecutionVerification | undefined;
+export declare function storeArtefacts(proposalId: number, artefacts: DAOArtefacts): Promise<void>;
+export declare function getArtefacts(proposalId: number): DAOArtefacts | undefined;
+export type { AgentOutput, Vote } from "./types/index.js";
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

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