@handong66/evidoc-core 0.1.0

package/dist/src/agent-runtime.d.ts

@@ -0,0 +1,15 @@
+import type { AgentRuntimeContract, AgentRuntimeEvent, AgentRuntimeMode, AgentRuntimeScope, DriftFinding, DriftReport } from "./types.js";
+export interface AgentRuntimeContractOptions {
+    event: AgentRuntimeEvent;
+    mode: AgentRuntimeMode;
+    scope: AgentRuntimeScope;
+    baseline?: string;
+    baselineCommit?: string;
+    changedFiles?: string[];
+    changedFileFingerprints?: Record<string, string>;
+    affectedDocuments?: string[];
+    generatedAt?: string;
+}
+export declare function createAgentRuntimeContract(report: DriftReport, options: AgentRuntimeContractOptions): AgentRuntimeContract;
+export declare function fingerprintDriftFinding(finding: DriftFinding): string;
+export declare function fingerprintFileContent(content: string | Uint8Array): string;

package/dist/src/agent-runtime.js

@@ -0,0 +1,149 @@
+import { createHash } from "node:crypto";
+const DRIFT_EVIDENCE_KINDS = new Set([
+    "agent_instruction",
+    "api",
+    "command",
+    "config",
+    "coverage",
+    "frontmatter",
+    "path",
+    "review_log",
+    "symbol"
+]);
+export function createAgentRuntimeContract(report, options) {
+    const findings = report.findings.map((finding) => ({
+        fingerprint: fingerprintDriftFinding(finding),
+        findingId: finding.id,
+        ruleId: finding.ruleId,
+        status: finding.status,
+        severity: finding.severity,
+        location: `${finding.docPath}:${finding.line}`,
+        message: finding.message,
+        suggestedAction: finding.suggestedAction
+    }));
+    const status = runtimeStatus(report);
+    const changedFiles = normalizeList(options.changedFiles);
+    const changedFileFingerprints = normalizeRecord(options.changedFileFingerprints);
+    const affectedDocuments = normalizeList(options.affectedDocuments);
+    return {
+        schemaVersion: "evidoc.agent-runtime.v1",
+        source: "evidoc",
+        event: options.event,
+        mode: options.mode,
+        scope: options.scope,
+        baseline: options.baseline,
+        baselineCommit: options.baselineCommit,
+        status,
+        fingerprint: aggregateRuntimeFingerprint({
+            status,
+            findingFingerprints: findings.map((finding) => finding.fingerprint),
+            event: options.event,
+            mode: options.mode,
+            scope: options.scope,
+            baseline: options.baseline,
+            baselineCommit: options.baselineCommit,
+            changedFiles,
+            changedFileFingerprints,
+            affectedDocuments
+        }),
+        generatedAt: options.generatedAt ?? new Date().toISOString(),
+        scannedAt: report.scannedAt,
+        summary: {
+            findings: report.summary.findings,
+            broken: report.summary.broken,
+            reviewNeeded: report.summary.reviewNeeded
+        },
+        findings,
+        dedupe: {
+            strategy: "runtime.findings[].fingerprint",
+            fingerprintCount: new Set(findings.map((finding) => finding.fingerprint)).size
+        },
+        changedFiles,
+        changedFileFingerprints,
+        affectedDocuments
+    };
+}
+export function fingerprintDriftFinding(finding) {
+    return `dgf_${stableHash({
+        ruleId: finding.ruleId,
+        status: finding.status,
+        severity: finding.severity,
+        docPath: finding.docPath,
+        line: finding.line,
+        evidence: readFindingEvidence(finding)
+            .map((item) => ({
+            kind: item.kind,
+            subject: item.subject,
+            expected: item.expected,
+            actual: item.actual,
+            detail: item.detail
+        }))
+            .sort((left, right) => stableStringify(left).localeCompare(stableStringify(right)))
+    })}`;
+}
+function readFindingEvidence(finding) {
+    if (!Array.isArray(finding.evidence))
+        return [];
+    return finding.evidence.filter(isDriftEvidence);
+}
+function isDriftEvidence(item) {
+    if (!item || typeof item !== "object")
+        return false;
+    const candidate = item;
+    return (typeof candidate.kind === "string" &&
+        DRIFT_EVIDENCE_KINDS.has(candidate.kind) &&
+        typeof candidate.subject === "string" &&
+        typeof candidate.detail === "string" &&
+        (candidate.expected === undefined || typeof candidate.expected === "string") &&
+        (candidate.actual === undefined || typeof candidate.actual === "string"));
+}
+export function fingerprintFileContent(content) {
+    return `sha256:${createHash("sha256").update(content).digest("hex")}`;
+}
+function runtimeStatus(report) {
+    if (report.summary.broken > 0)
+        return "failed";
+    if (report.summary.reviewNeeded > 0)
+        return "review_needed";
+    return "passed";
+}
+function aggregateRuntimeFingerprint(input) {
+    return `dgr_${stableHash({
+        status: input.status,
+        event: input.event,
+        mode: input.mode,
+        scope: input.scope,
+        baseline: input.baseline,
+        baselineCommit: input.baselineCommit,
+        changedFiles: input.changedFiles,
+        changedFileFingerprints: input.changedFileFingerprints,
+        affectedDocuments: input.affectedDocuments,
+        findings: [...input.findingFingerprints].sort()
+    })}`;
+}
+function normalizeList(value) {
+    if (!value)
+        return undefined;
+    return [...new Set(value)].sort();
+}
+function normalizeRecord(value) {
+    if (!value)
+        return undefined;
+    return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)));
+}
+function stableHash(value) {
+    return createHash("sha256").update(stableStringify(value)).digest("hex").slice(0, 16);
+}
+function stableStringify(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (!value || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => [key, canonicalize(item)]));
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/src/agent-runtime.js.map

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

package/dist/src/detectors.d.ts

@@ -0,0 +1,2 @@
+import type { DriftFinding, RepositorySnapshot } from "./types.js";
+export declare function detectDrift(snapshot: RepositorySnapshot): Promise<DriftFinding[]>;