evidential-protocol 2.0.0 → 3.0.0

package/dist/fingerprint.d.ts

@@ -0,0 +1,126 @@
+/**
+ * EP-2: Behavioral Fingerprinting (Kusunda phonological uniqueness)
+ *
+ * Each agent develops a fingerprint from its behavioral patterns.
+ * Supports anomaly detection, cross-agent similarity scoring,
+ * and health reporting.
+ */
+import type { EvidenceClass } from "./types.js";
+/** A single behavioral observation of an agent. */
+export interface BehaviorSample {
+    /** Agent identifier. */
+    agent_id: string;
+    /** ISO 8601 timestamp of the observation. */
+    timestamp: string;
+    /** Tool that was used. */
+    tool_used: string;
+    /** Evidence class of the action's output. */
+    evidence_class: EvidenceClass;
+    /** Confidence score of the action. */
+    confidence: number;
+    /** Response time in milliseconds. */
+    response_time_ms: number;
+    /** Whether the action succeeded. */
+    success: boolean;
+}
+/** Computed behavioral fingerprint for an agent. */
+export interface AgentFingerprint {
+    /** Agent identifier. */
+    agent_id: string;
+    /** Total number of samples ingested. */
+    sample_count: number;
+    /** Average response time in milliseconds. */
+    avg_response_time: number;
+    /** Fraction of samples that failed (0.0 - 1.0). */
+    error_rate: number;
+    /** Percentage distribution across evidence classes (sums to ~100). */
+    evidence_distribution: Record<EvidenceClass, number>;
+    /** Most frequently used tools, sorted by frequency descending. */
+    top_tools: string[];
+    /** Mean confidence across all samples. */
+    confidence_mean: number;
+    /** Standard deviation of confidence. */
+    confidence_stddev: number;
+    /** ISO 8601 timestamp of the most recent sample. */
+    last_active: string;
+}
+/** Result of anomaly detection for a single sample. */
+export interface AnomalyResult {
+    /** Whether the sample is anomalous. */
+    anomalous: boolean;
+    /** Human-readable reasons for the anomaly. */
+    reasons: string[];
+    /** Severity score (0.0 = normal, 1.0 = extreme anomaly). */
+    severity: number;
+}
+/** Health status for a single agent. */
+export type HealthStatus = "healthy" | "degraded" | "anomalous" | "inactive";
+/** Health report entry for a single agent. */
+export interface AgentHealthEntry {
+    agent_id: string;
+    fingerprint: AgentFingerprint;
+    status: HealthStatus;
+    issues: string[];
+}
+/**
+ * Behavioral fingerprinting engine.
+ *
+ * Ingests behavioral samples, computes fingerprints, detects anomalies
+ * by comparing new samples against established behavioral baselines,
+ * and measures cross-agent similarity.
+ */
+export declare class FingerprintEngine {
+    private samples;
+    /** Total number of samples across all agents. */
+    get totalSamples(): number;
+    /** Total number of distinct agents tracked. */
+    get agentCount(): number;
+    /** Add a behavioral observation. */
+    ingest(sample: BehaviorSample): void;
+    /**
+     * Compute the current fingerprint for an agent.
+     *
+     * @returns The fingerprint, or undefined if no samples exist.
+     */
+    getFingerprint(agentId: string): AgentFingerprint | undefined;
+    /** Compute fingerprints for all tracked agents. */
+    getAllFingerprints(): AgentFingerprint[];
+    /**
+     * Detect whether a new sample is anomalous for the given agent.
+     *
+     * Checks:
+     * - Response time > 2x established average
+     * - Error rate spike > 3x established rate (via recent window)
+     * - Evidence class distribution shift > 30%
+     * - Confidence drop > 0.2 below established mean
+     *
+     * @returns Anomaly result. If the agent has fewer than 5 samples,
+     *          returns non-anomalous (insufficient baseline).
+     */
+    detectAnomaly(agentId: string, sample: BehaviorSample): AnomalyResult;
+    /**
+     * Compute a similarity score between two agents (0.0 - 1.0).
+     *
+     * Compares: response time profile, error rate, evidence distribution,
+     * confidence mean, and tool overlap.
+     *
+     * @returns Similarity score, or 0 if either agent has no data.
+     */
+    similarity(agentA: string, agentB: string): number;
+    /**
+     * Generate a health report for all tracked agents.
+     *
+     * Status classification:
+     * - inactive: no samples in last 24 hours
+     * - anomalous: error rate > 30% or avg confidence < 0.3
+     * - degraded: error rate > 15% or avg confidence < 0.5
+     * - healthy: otherwise
+     */
+    getHealthReport(): AgentHealthEntry[];
+    private computeFingerprint;
+    /** Cosine similarity between two evidence distributions. */
+    private cosineDistribution;
+    /** Jaccard similarity between two sets. */
+    private jaccardSimilarity;
+}
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAUhD,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACrD,kEAAkE;IAClE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7E,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAuC;IAEtD,iDAAiD;IACjD,IAAI,YAAY,IAAI,MAAM,CAMzB;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,oCAAoC;IACpC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IASpC;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAM7D,mDAAmD;IACnD,kBAAkB,IAAI,gBAAgB,EAAE;IAUxC;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,aAAa;IAwErE;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAmClD;;;;;;;;OAQG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAsDrC,OAAO,CAAC,kBAAkB;IAwF1B,4DAA4D;IAC5D,OAAO,CAAC,kBAAkB;IAmB1B,2CAA2C;IAC3C,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/fingerprint.js

@@ -0,0 +1,315 @@
+/**
+ * EP-2: Behavioral Fingerprinting (Kusunda phonological uniqueness)
+ *
+ * Each agent develops a fingerprint from its behavioral patterns.
+ * Supports anomaly detection, cross-agent similarity scoring,
+ * and health reporting.
+ */
+/** All evidence classes for iteration. */
+const ALL_CLASSES = [
+    "direct",
+    "inferred",
+    "reported",
+    "conjecture",
+];
+/**
+ * Behavioral fingerprinting engine.
+ *
+ * Ingests behavioral samples, computes fingerprints, detects anomalies
+ * by comparing new samples against established behavioral baselines,
+ * and measures cross-agent similarity.
+ */
+export class FingerprintEngine {
+    samples = new Map();
+    /** Total number of samples across all agents. */
+    get totalSamples() {
+        let count = 0;
+        for (const arr of this.samples.values()) {
+            count += arr.length;
+        }
+        return count;
+    }
+    /** Total number of distinct agents tracked. */
+    get agentCount() {
+        return this.samples.size;
+    }
+    /** Add a behavioral observation. */
+    ingest(sample) {
+        const arr = this.samples.get(sample.agent_id);
+        if (arr) {
+            arr.push(sample);
+        }
+        else {
+            this.samples.set(sample.agent_id, [sample]);
+        }
+    }
+    /**
+     * Compute the current fingerprint for an agent.
+     *
+     * @returns The fingerprint, or undefined if no samples exist.
+     */
+    getFingerprint(agentId) {
+        const agentSamples = this.samples.get(agentId);
+        if (!agentSamples || agentSamples.length === 0)
+            return undefined;
+        return this.computeFingerprint(agentId, agentSamples);
+    }
+    /** Compute fingerprints for all tracked agents. */
+    getAllFingerprints() {
+        const results = [];
+        for (const [agentId, agentSamples] of this.samples) {
+            if (agentSamples.length > 0) {
+                results.push(this.computeFingerprint(agentId, agentSamples));
+            }
+        }
+        return results;
+    }
+    /**
+     * Detect whether a new sample is anomalous for the given agent.
+     *
+     * Checks:
+     * - Response time > 2x established average
+     * - Error rate spike > 3x established rate (via recent window)
+     * - Evidence class distribution shift > 30%
+     * - Confidence drop > 0.2 below established mean
+     *
+     * @returns Anomaly result. If the agent has fewer than 5 samples,
+     *          returns non-anomalous (insufficient baseline).
+     */
+    detectAnomaly(agentId, sample) {
+        const baseline = this.getFingerprint(agentId);
+        if (!baseline || baseline.sample_count < 5) {
+            return { anomalous: false, reasons: [], severity: 0 };
+        }
+        const reasons = [];
+        let severity = 0;
+        // Check 1: Response time > 2x average
+        if (sample.response_time_ms > baseline.avg_response_time * 2) {
+            const ratio = sample.response_time_ms / baseline.avg_response_time;
+            reasons.push(`Response time ${sample.response_time_ms}ms is ${ratio.toFixed(1)}x the average ${baseline.avg_response_time.toFixed(0)}ms`);
+            severity += Math.min((ratio - 2) / 3, 0.4);
+        }
+        // Check 2: Error rate spike > 3x (check recent 10-sample window)
+        if (!sample.success) {
+            const agentSamples = this.samples.get(agentId);
+            const recentWindow = agentSamples.slice(-10);
+            const recentErrorRate = recentWindow.filter((s) => !s.success).length / recentWindow.length;
+            if (baseline.error_rate > 0 &&
+                recentErrorRate > baseline.error_rate * 3) {
+                reasons.push(`Recent error rate ${(recentErrorRate * 100).toFixed(1)}% is >${(baseline.error_rate * 300).toFixed(0)}% of baseline ${(baseline.error_rate * 100).toFixed(1)}%`);
+                severity += 0.3;
+            }
+            else if (baseline.error_rate === 0 && recentErrorRate > 0.3) {
+                reasons.push(`Error rate spike to ${(recentErrorRate * 100).toFixed(1)}% from a previously error-free baseline`);
+                severity += 0.3;
+            }
+        }
+        // Check 3: Evidence class distribution shift > 30%
+        const classPct = baseline.evidence_distribution[sample.evidence_class];
+        if (classPct < 5) {
+            // This class is rarely used — potential distribution shift
+            const totalOtherPct = 100 - classPct;
+            if (totalOtherPct > 30) {
+                reasons.push(`Evidence class "${sample.evidence_class}" represents only ${classPct.toFixed(1)}% of established behavior`);
+                severity += 0.2;
+            }
+        }
+        // Check 4: Confidence drop > 0.2 below mean
+        const confidenceDrop = baseline.confidence_mean - sample.confidence;
+        if (confidenceDrop > 0.2) {
+            reasons.push(`Confidence ${sample.confidence.toFixed(3)} is ${confidenceDrop.toFixed(3)} below mean ${baseline.confidence_mean.toFixed(3)}`);
+            severity += Math.min(confidenceDrop / 0.5, 0.3);
+        }
+        severity = Math.min(Math.round(severity * 1000) / 1000, 1.0);
+        return {
+            anomalous: reasons.length > 0,
+            reasons,
+            severity,
+        };
+    }
+    /**
+     * Compute a similarity score between two agents (0.0 - 1.0).
+     *
+     * Compares: response time profile, error rate, evidence distribution,
+     * confidence mean, and tool overlap.
+     *
+     * @returns Similarity score, or 0 if either agent has no data.
+     */
+    similarity(agentA, agentB) {
+        const fpA = this.getFingerprint(agentA);
+        const fpB = this.getFingerprint(agentB);
+        if (!fpA || !fpB)
+            return 0;
+        // Component 1: Response time similarity (weight 0.2)
+        const maxRt = Math.max(fpA.avg_response_time, fpB.avg_response_time, 1);
+        const rtSim = 1 - Math.abs(fpA.avg_response_time - fpB.avg_response_time) / maxRt;
+        // Component 2: Error rate similarity (weight 0.15)
+        const erSim = 1 - Math.abs(fpA.error_rate - fpB.error_rate);
+        // Component 3: Evidence distribution similarity via cosine (weight 0.3)
+        const distSim = this.cosineDistribution(fpA.evidence_distribution, fpB.evidence_distribution);
+        // Component 4: Confidence similarity (weight 0.2)
+        const confSim = 1 - Math.abs(fpA.confidence_mean - fpB.confidence_mean);
+        // Component 5: Tool overlap via Jaccard (weight 0.15)
+        const toolSim = this.jaccardSimilarity(new Set(fpA.top_tools), new Set(fpB.top_tools));
+        const weighted = rtSim * 0.2 + erSim * 0.15 + distSim * 0.3 + confSim * 0.2 + toolSim * 0.15;
+        return Math.round(Math.max(0, Math.min(1, weighted)) * 1000) / 1000;
+    }
+    /**
+     * Generate a health report for all tracked agents.
+     *
+     * Status classification:
+     * - inactive: no samples in last 24 hours
+     * - anomalous: error rate > 30% or avg confidence < 0.3
+     * - degraded: error rate > 15% or avg confidence < 0.5
+     * - healthy: otherwise
+     */
+    getHealthReport() {
+        const now = Date.now();
+        const twentyFourHours = 24 * 60 * 60 * 1000;
+        const report = [];
+        for (const [agentId, agentSamples] of this.samples) {
+            if (agentSamples.length === 0)
+                continue;
+            const fp = this.computeFingerprint(agentId, agentSamples);
+            const issues = [];
+            let status = "healthy";
+            // Check inactivity
+            const lastActiveMs = new Date(fp.last_active).getTime();
+            if (now - lastActiveMs > twentyFourHours) {
+                status = "inactive";
+                const hoursAgo = ((now - lastActiveMs) / (60 * 60 * 1000)).toFixed(1);
+                issues.push(`No activity for ${hoursAgo} hours`);
+            }
+            // Check error rate
+            if (fp.error_rate > 0.3) {
+                status = "anomalous";
+                issues.push(`Error rate ${(fp.error_rate * 100).toFixed(1)}% exceeds 30% threshold`);
+            }
+            else if (fp.error_rate > 0.15) {
+                if (status === "healthy")
+                    status = "degraded";
+                issues.push(`Error rate ${(fp.error_rate * 100).toFixed(1)}% exceeds 15% threshold`);
+            }
+            // Check confidence
+            if (fp.confidence_mean < 0.3) {
+                status = "anomalous";
+                issues.push(`Mean confidence ${fp.confidence_mean.toFixed(3)} below 0.3 threshold`);
+            }
+            else if (fp.confidence_mean < 0.5) {
+                if (status === "healthy")
+                    status = "degraded";
+                issues.push(`Mean confidence ${fp.confidence_mean.toFixed(3)} below 0.5 threshold`);
+            }
+            report.push({ agent_id: agentId, fingerprint: fp, status, issues });
+        }
+        return report;
+    }
+    // ---- Internal computation ----
+    computeFingerprint(agentId, agentSamples) {
+        const n = agentSamples.length;
+        // Response time
+        let rtSum = 0;
+        for (const s of agentSamples) {
+            rtSum += s.response_time_ms;
+        }
+        const avgResponseTime = rtSum / n;
+        // Error rate
+        let errorCount = 0;
+        for (const s of agentSamples) {
+            if (!s.success)
+                errorCount++;
+        }
+        const errorRate = errorCount / n;
+        // Evidence distribution (percentages)
+        const classCounts = {
+            direct: 0,
+            inferred: 0,
+            reported: 0,
+            conjecture: 0,
+        };
+        for (const s of agentSamples) {
+            classCounts[s.evidence_class]++;
+        }
+        const evidenceDistribution = {
+            direct: 0,
+            inferred: 0,
+            reported: 0,
+            conjecture: 0,
+        };
+        for (const cls of ALL_CLASSES) {
+            evidenceDistribution[cls] =
+                Math.round((classCounts[cls] / n) * 1000) / 10;
+        }
+        // Top tools by frequency
+        const toolCounts = new Map();
+        for (const s of agentSamples) {
+            toolCounts.set(s.tool_used, (toolCounts.get(s.tool_used) ?? 0) + 1);
+        }
+        const topTools = Array.from(toolCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([tool]) => tool);
+        // Confidence mean and stddev
+        let confSum = 0;
+        for (const s of agentSamples) {
+            confSum += s.confidence;
+        }
+        const confidenceMean = confSum / n;
+        let varianceSum = 0;
+        for (const s of agentSamples) {
+            const diff = s.confidence - confidenceMean;
+            varianceSum += diff * diff;
+        }
+        const confidenceStddev = Math.sqrt(varianceSum / n);
+        // Last active
+        let lastActiveTs = "";
+        let lastActiveMs = 0;
+        for (const s of agentSamples) {
+            const ms = new Date(s.timestamp).getTime();
+            if (ms > lastActiveMs) {
+                lastActiveMs = ms;
+                lastActiveTs = s.timestamp;
+            }
+        }
+        return {
+            agent_id: agentId,
+            sample_count: n,
+            avg_response_time: Math.round(avgResponseTime * 100) / 100,
+            error_rate: Math.round(errorRate * 10000) / 10000,
+            evidence_distribution: evidenceDistribution,
+            top_tools: topTools,
+            confidence_mean: Math.round(confidenceMean * 10000) / 10000,
+            confidence_stddev: Math.round(confidenceStddev * 10000) / 10000,
+            last_active: lastActiveTs,
+        };
+    }
+    /** Cosine similarity between two evidence distributions. */
+    cosineDistribution(a, b) {
+        let dot = 0;
+        let magA = 0;
+        let magB = 0;
+        for (const cls of ALL_CLASSES) {
+            dot += a[cls] * b[cls];
+            magA += a[cls] * a[cls];
+            magB += b[cls] * b[cls];
+        }
+        const denom = Math.sqrt(magA) * Math.sqrt(magB);
+        if (denom === 0)
+            return 0;
+        return dot / denom;
+    }
+    /** Jaccard similarity between two sets. */
+    jaccardSimilarity(a, b) {
+        if (a.size === 0 && b.size === 0)
+            return 1;
+        let intersection = 0;
+        for (const item of a) {
+            if (b.has(item))
+                intersection++;
+        }
+        const union = a.size + b.size - intersection;
+        if (union === 0)
+            return 1;
+        return intersection / union;
+    }
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * evidential-protocol — EP-1
+ * evidential-protocol — EP-1 + Kusunda Extensions
  *
- * Matsés-inspired evidential metadata for AI agent systems.
- * Every claim must declare its epistemic basis.
+ * Matsés-inspired evidential metadata + Kusunda-inspired
+ * system architecture for AI agent systems.
  *
  * @packageDocumentation
  */
@@ -13,5 +13,15 @@ export { wrapToolResult, buildAgentResponse, directClaim, inferredClaim, reporte
 export { McpEvidenceWrapper, EvidenceCache, createMcpMiddleware, type ToolHandler, type WrappedToolResult, type WrapperConfig, type McpToolCall, type McpToolResponse, } from "./mcp-wrapper.js";
 export { AgentOutputBuilder, runAgentTeam, runPipeline, generateReport, type AgentIdentity, type TeamRunResult, type PipelineStep, } from "./agent-wrapper.js";
 export { isClaim, stripMarkers, analyzeContent, tagSentence, autoTag, publishGate, renderForReview, type TaggedSentence, type ContentAnalysis, type PublishGateResult, } from "./content.js";
-export { extractAudit, buildDashboardData, renderDashboardHtml, type AuditEntry, type DashboardData, type ProducerSummary, } from "./dashboard.js";
+export { extractAudit, buildDashboardData, renderDashboardHtml, type AuditEntry as DashboardAuditEntry, type DashboardData, type ProducerSummary, } from "./dashboard.js";
+export { AuditLedger, type AuditEntry, type AuditAction, } from "./audit-ledger.js";
+export { ProvenanceChain, type ProvenanceNode, } from "./provenance.js";
+export { FingerprintEngine, type BehaviorSample, type AgentFingerprint, type AnomalyResult, type HealthStatus, type AgentHealthEntry, } from "./fingerprint.js";
+export { ErgativeGate, meetsEvidenceRequirement, type AgentRole, type ToolPermission, type PermissionManifest, } from "./ergative.js";
+export { PurityScanner, computePurityScore, type SourceOrigin, type ContentSegment, type PurityAnalysis, } from "./purity.js";
+export { AttestationBuilder, formatForSigning, attestationToMemo, type ContentAttestation, } from "./attestation.js";
+export { ResilienceAnalyzer, type SystemComponent, type ResilienceReport, } from "./resilience.js";
+export { DormantScanner, type AssetProfile, type DormantScore, } from "./dormant.js";
+export { ScoringEngine, type ScoringAxis, type ContinuousScore, } from "./scoring.js";
+export { PayloadBuilder, isExpired as isPayloadExpired, describe as describePayload, validate as validatePayload, type PayloadMeta, type SelfDescribingPayload, } from "./self-describing.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,8 @@
 /**
- * evidential-protocol — EP-1
+ * evidential-protocol — EP-1 + Kusunda Extensions
  *
- * Matsés-inspired evidential metadata for AI agent systems.
- * Every claim must declare its epistemic basis.
+ * Matsés-inspired evidential metadata + Kusunda-inspired
+ * system architecture for AI agent systems.
  *
  * @packageDocumentation
  */
@@ -22,4 +22,25 @@ export { AgentOutputBuilder, runAgentTeam, runPipeline, generateReport, } from "
 export { isClaim, stripMarkers, analyzeContent, tagSentence, autoTag, publishGate, renderForReview, } from "./content.js";
 // Dashboard & Audit Trail (Phase 5)
 export { extractAudit, buildDashboardData, renderDashboardHtml, } from "./dashboard.js";
+// --- Kusunda Extensions ---
+// K1: Bilateral Audit Ledger (dual-person marking)
+export { AuditLedger, } from "./audit-ledger.js";
+// K2: Root Provenance Tracing (pre-family lineage)
+export { ProvenanceChain, } from "./provenance.js";
+// K3: Behavioral Fingerprinting (phonological uniqueness)
+export { FingerprintEngine, } from "./fingerprint.js";
+// K4: Ergative Permission Model (ergative alignment)
+export { ErgativeGate, meetsEvidenceRequirement, } from "./ergative.js";
+// K5: Content Contamination Detection (loanword resistance)
+export { PurityScanner, computePurityScore, } from "./purity.js";
+// K6: Content Attestation (isolate identity)
+export { AttestationBuilder, formatForSigning, attestationToMemo, } from "./attestation.js";
+// K7: Bus Factor / SPOF Detection (last-speaker problem)
+export { ResilienceAnalyzer, } from "./resilience.js";
+// K8: Dormant Asset Scanner (rediscovery)
+export { DormantScanner, } from "./dormant.js";
+// K9: Continuous Scoring (no-gender / bias-free)
+export { ScoringEngine, } from "./scoring.js";
+// K10: Self-Describing Payloads (verb morphology)
+export { PayloadBuilder, isExpired as isPayloadExpired, describe as describePayload, validate as validatePayload, } from "./self-describing.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,aAAa;AACb,OAAO,EAWL,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GAMpB,MAAM,kBAAkB,CAAC;AAE1B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,aAAa;AACb,OAAO,EAWL,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,8BAA8B;AAC9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AAErB,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GAIjB,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB;AACxB,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GAMpB,MAAM,kBAAkB,CAAC;AAE1B,mCAAmC;AACnC,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,WAAW,EACX,OAAO,EACP,WAAW,EACX,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB,oCAAoC;AACpC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,gBAAgB,CAAC;AAExB,6BAA6B;AAE7B,mDAAmD;AACnD,OAAO,EACL,WAAW,GAGZ,MAAM,mBAAmB,CAAC;AAE3B,mDAAmD;AACnD,OAAO,EACL,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AAEzB,0DAA0D;AAC1D,OAAO,EACL,iBAAiB,GAMlB,MAAM,kBAAkB,CAAC;AAE1B,qDAAqD;AACrD,OAAO,EACL,YAAY,EACZ,wBAAwB,GAIzB,MAAM,eAAe,CAAC;AAEvB,4DAA4D;AAC5D,OAAO,EACL,aAAa,EACb,kBAAkB,GAInB,MAAM,aAAa,CAAC;AAErB,6CAA6C;AAC7C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAE1B,yDAAyD;AACzD,OAAO,EACL,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC;AAEzB,0CAA0C;AAC1C,OAAO,EACL,cAAc,GAGf,MAAM,cAAc,CAAC;AAEtB,iDAAiD;AACjD,OAAO,EACL,aAAa,GAGd,MAAM,cAAc,CAAC;AAEtB,kDAAkD;AAClD,OAAO,EACL,cAAc,EACd,SAAS,IAAI,gBAAgB,EAC7B,QAAQ,IAAI,eAAe,EAC3B,QAAQ,IAAI,eAAe,GAG5B,MAAM,sBAAsB,CAAC"}

package/dist/provenance.d.ts

@@ -0,0 +1,101 @@
+/**
+ * EP-2: Root Provenance Tracing (Kusunda pre-family lineage)
+ *
+ * Traces any claim back through the full agent chain to its absolute
+ * origin. Supports depth queries, weakest-link analysis, compounding
+ * confidence degradation, and Mermaid diagram rendering.
+ */
+import type { Evidence, EvidenceClass } from "./types.js";
+/** A single node in the provenance chain. */
+export interface ProvenanceNode {
+    /** Unique node identifier. */
+    id: string;
+    /** The claim or assertion at this point in the chain. */
+    claim: string;
+    /** Evidence supporting this claim. */
+    evidence: Evidence;
+    /** Agent or tool that produced this node. */
+    producer: string;
+    /** ISO 8601 timestamp of when this node was created. */
+    timestamp: string;
+    /** ID of the parent node, or null if this is a root. */
+    parent_id: string | null;
+}
+/** Serialized form for persistence. */
+export interface ProvenanceChainSnapshot {
+    version: "1.0";
+    nodes: ProvenanceNode[];
+    created_at: string;
+}
+/**
+ * Manages a directed acyclic provenance chain.
+ *
+ * Each node records a claim, its evidence, and a link to its parent.
+ * Root nodes represent original observations; leaves are terminal claims.
+ */
+export declare class ProvenanceChain {
+    private nodes;
+    private childrenIndex;
+    /** Total number of nodes in the chain. */
+    get size(): number;
+    /**
+     * Add a new node to the provenance chain.
+     *
+     * @param claim - The assertion being made.
+     * @param evidence - Evidence supporting the claim.
+     * @param producer - Agent or tool that produced this node.
+     * @param parentId - ID of the parent node (omit for root nodes).
+     * @returns The created ProvenanceNode.
+     * @throws If parentId is provided but does not exist in the chain.
+     */
+    addNode(claim: string, evidence: Evidence, producer: string, parentId?: string): ProvenanceNode;
+    /** Get a node by ID, or undefined if not found. */
+    getNode(nodeId: string): ProvenanceNode | undefined;
+    /**
+     * Walk back from a node to the absolute origin.
+     *
+     * @returns Array of nodes from the given node to the root (inclusive).
+     * @throws If nodeId does not exist.
+     */
+    traceToRoot(nodeId: string): ProvenanceNode[];
+    /**
+     * Get the depth (number of hops from the root) for a node.
+     *
+     * Root nodes have depth 0.
+     * @throws If nodeId does not exist.
+     */
+    getDepth(nodeId: string): number;
+    /** Get all root nodes (original observations with no parent). */
+    getRoots(): ProvenanceNode[];
+    /** Get all leaf nodes (terminal claims with no children). */
+    getLeaves(): ProvenanceNode[];
+    /**
+     * Find the weakest evidence class in the chain from a node to its root.
+     *
+     * @returns The lowest evidence class found along the path.
+     * @throws If nodeId does not exist.
+     */
+    weakestLink(nodeId: string): EvidenceClass;
+    /**
+     * Compute compounding confidence through the chain to root.
+     *
+     * Each hop multiplies confidence, modeling degradation: the further
+     * from the source, the lower the total confidence.
+     *
+     * @returns Compounded confidence score (0.0 - 1.0).
+     * @throws If nodeId does not exist.
+     */
+    chainConfidence(nodeId: string): number;
+    /**
+     * Render the entire provenance chain as a Mermaid flowchart.
+     *
+     * Direction: bottom-to-top (roots at bottom, leaves at top).
+     */
+    toMermaid(): string;
+    /** Serialize the chain to a JSON-safe snapshot. */
+    toJSON(): ProvenanceChainSnapshot;
+    /** Restore a chain from a serialized snapshot. */
+    static fromJSON(snapshot: ProvenanceChainSnapshot): ProvenanceChain;
+    private escapeMermaid;
+}
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG1D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,uCAAuC;AACvC,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,aAAa,CAA+B;IAEpD,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;;OASG;IACH,OAAO,CACL,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc;IA4BjB,mDAAmD;IACnD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAgB7C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKhC,iEAAiE;IACjE,QAAQ,IAAI,cAAc,EAAE;IAU5B,6DAA6D;IAC7D,SAAS,IAAI,cAAc,EAAE;IAW7B;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAa1C;;;;;;;;OAQG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAWvC;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAmBnB,mDAAmD;IACnD,MAAM,IAAI,uBAAuB;IAQjC,kDAAkD;IAClD,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,eAAe;IAkBnE,OAAO,CAAC,aAAa;CAGtB"}