agentera 3.0.0-dev.5 → 3.0.0-dev.7

package/dist/state/startupAnalysis/report.js

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+import { pyJsonIndentSorted } from "../../core/pyjson.js";
+import { Flt, formatFloat, pyFmt, pyJsonDumps } from "./helpers.js";
+export const STARTUP_REPORT_MARKDOWN = "startup-overhead-report.md";
+export const STARTUP_REPORT_JSON = "startup-overhead-report.json";
+function startupJsonScalar(value) {
+    if (value instanceof Flt)
+        return formatFloat(value.v);
+    return undefined;
+}
+function pyJsonIndent(value, level = 0, indent = "  ") {
+    return pyJsonIndentSorted(value, indent.length || 2, level, startupJsonScalar);
+}
+function markdownTable(headers, rows) {
+    const lines = [
+        "| " + headers.join(" | ") + " |",
+        "| " + headers.map(() => "---").join(" | ") + " |",
+    ];
+    if (rows.length === 0) {
+        return [...lines, "| " + headers.map(() => "none").join(" | ") + " |"];
+    }
+    return [...lines, ...rows.map((row) => "| " + row.map((v) => pyFmt(v)).join(" | ") + " |")];
+}
+export function renderStartupReport(metrics) {
+    const thresholdDerivation = metrics.threshold_derivation && typeof metrics.threshold_derivation === "object" && !Array.isArray(metrics.threshold_derivation)
+        ? metrics.threshold_derivation
+        : {};
+    const threshold = thresholdDerivation.action_thresholds && typeof thresholdDerivation.action_thresholds === "object" && !Array.isArray(thresholdDerivation.action_thresholds)
+        ? thresholdDerivation.action_thresholds
+        : {};
+    const envelopeThreshold = threshold.startup_envelope && typeof threshold.startup_envelope === "object" && !Array.isArray(threshold.startup_envelope) ? threshold.startup_envelope : {};
+    const guidanceThreshold = threshold.targeted_guidance && typeof threshold.targeted_guidance === "object" && !Array.isArray(threshold.targeted_guidance) ? threshold.targeted_guidance : {};
+    const recommendation = metrics.startup_recommendation && typeof metrics.startup_recommendation === "object" && !Array.isArray(metrics.startup_recommendation)
+        ? metrics.startup_recommendation
+        : {};
+    const measuredDistribution = thresholdDerivation.measured_distribution && typeof thresholdDerivation.measured_distribution === "object" && !Array.isArray(thresholdDerivation.measured_distribution)
+        ? thresholdDerivation.measured_distribution
+        : {};
+    const runtimeCoverage = Array.isArray(metrics.runtime_coverage) ? metrics.runtime_coverage : [];
+    const capabilityCounts = metrics.per_capability_state_counts && typeof metrics.per_capability_state_counts === "object" && !Array.isArray(metrics.per_capability_state_counts)
+        ? metrics.per_capability_state_counts
+        : {};
+    const lines = [
+        "# Agentera Startup State-Access Analysis",
+        "",
+        "This report is local-only and privacy-preserving. It measures raw Agentera artifact access after CLI state calls during capability startup/state gathering.",
+        "",
+        "## Boundary Source",
+        "",
+        `- Contract version: \`${pyFmt(metrics.contract_version)}\``,
+        `- Boundary source: \`${pyFmt(metrics.boundary_source)}\``,
+        `- Boundary commit: \`${pyFmt(metrics.boundary_commit)}\``,
+        `- Boundary timestamp: \`${pyFmt(metrics.boundary_committed_at)}\``,
+        `- Corpus adapter version: \`${pyFmt(metrics.corpus_adapter_version)}\``,
+        "",
+        "## Benchmark Window",
+        "",
+        `- Mode: \`${pyFmt(metrics.benchmark_mode)}\``,
+        `- Previous watermark: \`${pyFmt(metrics.benchmark_previous_watermark_at)}\``,
+        `- Window started after: \`${pyFmt(metrics.benchmark_window_started_after)}\``,
+        `- Watermark: \`${pyFmt(metrics.benchmark_watermark_at)}\``,
+        "",
+        "## Runtime Coverage",
+        "",
+    ];
+    const runtimeRows = [];
+    for (const status of runtimeCoverage) {
+        if (status && typeof status === "object" && !Array.isArray(status)) {
+            runtimeRows.push([
+                status.runtime ?? "unknown",
+                status.status ?? "unknown",
+                status.reason ?? "unknown",
+                status.record_count ?? 0,
+                status.file_count ?? 0,
+                status.error_count ?? 0,
+            ]);
+        }
+    }
+    lines.push(...markdownTable(["Runtime", "Status", "Reason", "Records", "Files", "Errors"], runtimeRows));
+    lines.push("", "## Metrics", "", `- Total state-gathering sequences: \`${pyFmt(metrics.total_state_sequences)}\``, `- Sequences with raw artifact access after CLI: \`${pyFmt(metrics.state_sequences_with_raw_after_cli)}\``, `- Sequences with redundant raw artifact access: \`${pyFmt(metrics.state_sequences_with_redundant_raw_access)}\``, `- Raw-after-CLI sequence rate: \`${pyFmt(metrics.raw_after_cli_sequence_rate)}\``, `- Redundant raw sequence rate: \`${pyFmt(metrics.redundant_raw_sequence_rate)}\``, `- CLI state command counts: \`${pyJsonDumps(metrics.cli_state_command_counts ?? {})}\``, `- Raw artifact access after CLI counts: \`${pyJsonDumps(metrics.raw_artifact_access_after_cli_counts ?? {})}\``, `- Redundant raw artifact access counts: \`${pyJsonDumps(metrics.redundant_raw_artifact_access_counts ?? {})}\``, "", "## Estimated Token Impact", "", `- Token estimator version: \`${pyFmt(metrics.token_estimator_version)}\``, `- Estimated raw-after-CLI tokens: \`${pyFmt(metrics.estimated_raw_after_cli_tokens)}\``, `- Estimated redundant raw tokens: \`${pyFmt(metrics.estimated_redundant_raw_tokens)}\``, `- Estimated raw-after-CLI tokens by artifact: \`${pyJsonDumps(metrics.estimated_raw_after_cli_tokens_by_artifact ?? {})}\``, `- Estimated redundant raw tokens by artifact: \`${pyJsonDumps(metrics.estimated_redundant_raw_tokens_by_artifact ?? {})}\``, `- Estimated tokens saved vs previous: \`${pyFmt(metrics.estimated_tokens_saved_vs_previous)}\``, `- Estimated tokens saved null reason: \`${pyFmt(metrics.estimated_tokens_saved_vs_previous_null_reason)}\``, "");
+    const capabilityRows = [];
+    for (const capability of Object.keys(capabilityCounts).sort()) {
+        const counts = capabilityCounts[capability];
+        if (counts && typeof counts === "object" && !Array.isArray(counts)) {
+            capabilityRows.push([
+                capability,
+                counts.state_sequences ?? 0,
+                counts.cli_state_call ?? 0,
+                counts.raw_artifact_access_after_cli ?? 0,
+                counts.redundant_raw_artifact_access ?? 0,
+                counts.capability_prose_read ?? 0,
+            ]);
+        }
+    }
+    lines.push(...markdownTable(["Capability", "Sequences", "CLI Calls", "Raw After CLI", "Redundant Raw", "Prose Reads"], capabilityRows));
+    lines.push("", "## Threshold Rationale", "", `- Startup envelope threshold credible: \`${pyFmt(envelopeThreshold.credible)}\``, `- Redundant-sequence threshold: \`${pyFmt(envelopeThreshold.redundant_sequence_threshold)}\``, `- Startup envelope selection reason: ${pyFmt(envelopeThreshold.selection_reason)}`, `- Targeted-guidance selection reason: ${pyFmt(guidanceThreshold.selection_reason)}`, `- Measured distribution: \`${pyJsonDumps(measuredDistribution)}\``, "", "## Recommendation", "", `- Action: \`${pyFmt(recommendation.action)}\``, `- Measured trigger: \`${pyFmt(recommendation.measured_trigger)}\``, `- Rationale: ${pyFmt(recommendation.rationale)}`, `- Implementation recommended: \`${pyFmt(metrics.implementation_recommended)}\``, "", "## Privacy Caveats", "", "- Raw transcript text is not emitted.", "- Full local paths and raw store paths are not emitted.", "- Session identifiers are salted or omitted.", "- Raw artifact accesses use canonical artifact_id labels such as `plan`, not filesystem paths.", "- Runtime coverage may be incomplete or degraded; inspect `confidence_caveats` before selecting follow-up work.", "");
+    return lines.join("\n");
+}
+export function writeStartupReports(metrics, outputDir) {
+    fs.mkdirSync(outputDir, { recursive: true });
+    const jsonPath = path.join(outputDir, STARTUP_REPORT_JSON);
+    const markdownPath = path.join(outputDir, STARTUP_REPORT_MARKDOWN);
+    fs.writeFileSync(jsonPath, pyJsonIndent(metrics) + "\n");
+    fs.writeFileSync(markdownPath, renderStartupReport(metrics));
+    return { structured: jsonPath, human_readable: markdownPath };
+}
+// ===========================================================================
+// Slice 6: benchmark persistence + intermediate building + corpus-file extraction
+// (extract_*_from_runtime_stores depends on extract_corpus and lands in Phase 10)
+// ===========================================================================
+//# sourceMappingURL=report.js.map

package/dist/state/startupAnalysis/report.js.map

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

package/dist/state/startupAnalysis/threshold.js

@@ -0,0 +1,500 @@
+import { canonicalArtifactLabel, hashLabel, loadContract } from "./contract.js";
+import { inc, counterDict, countMatches, recordLabel, recordThresholdText, detailMetrics, thresholdWarnings, detailLossStatus, argumentsText, CLI_COMMAND_ARTIFACTS, QUERY_ARTIFACTS, toolName, toolArgument, capabilityInvocation, introCapability, BUDGET_PRESSURE_RE, FULL_PLAN_BUDGET_RE, POST_AUDIT_FLAG_RE, } from "./helpers.js";
+export const THRESHOLD_EVIDENCE_ENVELOPE = "threshold_evidence_scan_v1";
+export const THRESHOLD_CLASSIFICATION_ENVELOPE = "threshold_evidence_classification_v1";
+export const STATE_EVENT_CLASSES = new Set([
+    "cli_state_call",
+    "raw_artifact_access",
+    "capability_prose_read",
+    "implementation_boundary",
+    "non_state_context",
+]);
+export const BOUNDARY_DEGRADATION_REASONS = new Set([
+    "pre_boundary_record",
+    "missing_timestamp",
+    "malformed_record",
+    "missing_conversation_key",
+    "no_agentera_state_sequence",
+    "privacy_redaction_required",
+]);
+export const BOUNDED_RUNTIME_STATUSES = new Set([
+    "ok",
+    "available",
+    "missing",
+    "sparse",
+    "degraded",
+    "skipped",
+]);
+export const BOUNDED_RUNTIME_REASONS = new Set([
+    "candidate_files_found",
+    "disabled",
+    "extractor_unimplemented",
+    "no_candidate_files",
+    "no_runtime_stores_approved",
+    "no_matching_records",
+    "records_extracted",
+    "schema_divergent",
+    "store_absent",
+    "store_locked",
+    "store_not_directory",
+    "store_unreadable",
+]);
+export function boundedRuntimeStatus(status) {
+    const runtime = String(status.runtime ?? "unknown");
+    const state = String(status.status ?? "degraded");
+    const reason = String(status.reason ?? "schema_divergent");
+    const item = {
+        runtime,
+        status: BOUNDED_RUNTIME_STATUSES.has(state) ? state : "degraded",
+        reason: BOUNDED_RUNTIME_REASONS.has(reason) ? reason : "schema_divergent",
+    };
+    for (const key of ["file_count", "record_count", "error_count"]) {
+        const value = status[key];
+        if (typeof value === "number" && Number.isInteger(value))
+            item[key] = value;
+    }
+    if (Array.isArray(status.remediation_labels)) {
+        item.remediation_labels = status.remediation_labels.map((l) => String(l));
+    }
+    return item;
+}
+export const STATE_CLI_COMMANDS = new Set([
+    "status",
+    "prime",
+    "plan",
+    "progress",
+    "health",
+    "todo",
+    "decisions",
+    "docs",
+    "objective",
+    "experiments",
+    "query",
+]);
+export function startupConversationKey(record) {
+    const key = record.conversation_key;
+    if (typeof key === "string" && key)
+        return key;
+    const sid = record.session_id;
+    if (typeof sid === "string" && sid)
+        return sid;
+    const data = record.data;
+    if (data && typeof data === "object" && !Array.isArray(data)) {
+        const dsid = data.session_id;
+        if (typeof dsid === "string" && dsid)
+            return dsid;
+    }
+    const ssid = record.source_id;
+    if (typeof ssid === "string" && ssid)
+        return ssid;
+    return null;
+}
+function stateCliCommand(command) {
+    if (!command)
+        return null;
+    const tokens = command.replace(/"/g, " ").replace(/'/g, " ").split(/\s+/).filter((t) => t);
+    for (let i = 0; i < tokens.length - 1; i++) {
+        if (tokens[i].endsWith("agentera") && STATE_CLI_COMMANDS.has(tokens[i + 1])) {
+            return tokens[i + 1];
+        }
+    }
+    return null;
+}
+function stateCliArtifacts(command, stateCommand) {
+    if (stateCommand === "query") {
+        const tokens = command.replace(/"/g, " ").replace(/'/g, " ").split(/\s+/).filter((t) => t);
+        for (let i = 0; i < tokens.length - 1; i++) {
+            if (tokens[i].endsWith("agentera") && tokens[i + 1] === "query") {
+                for (const arg of tokens.slice(i + 2)) {
+                    const label = QUERY_ARTIFACTS[arg.toLowerCase()];
+                    if (label)
+                        return new Set([label]);
+                }
+                return new Set();
+            }
+        }
+    }
+    return new Set(CLI_COMMAND_ARTIFACTS[stateCommand] ?? []);
+}
+export function classifyStartupEvent(record) {
+    if (!record || typeof record !== "object" || Array.isArray(record) || record.source_kind !== "tool_call") {
+        return ["non_state_context", null, null, new Set()];
+    }
+    const tool = toolName(record).toLowerCase();
+    const command = toolArgument(record, "command");
+    if (tool === "bash") {
+        const stateCommand = stateCliCommand(command);
+        if (stateCommand) {
+            return ["cli_state_call", null, stateCommand, stateCliArtifacts(command, stateCommand)];
+        }
+        return ["implementation_boundary", null, null, new Set()];
+    }
+    const argsText = argumentsText(record).replace(/\\/g, "/");
+    if (["read", "grep", "glob"].includes(tool) &&
+        (argsText.includes("skills/agentera/capabilities/") ||
+            argsText.includes("skills/agentera/SKILL.md") ||
+            argsText.includes("skills/agentera/protocol.yaml"))) {
+        return ["capability_prose_read", argsText.includes("SKILL.md") ? "SKILL.md" : null, null, new Set()];
+    }
+    const artifactLabel = ["read", "grep", "glob"].includes(tool) ? canonicalArtifactLabel(argsText) : null;
+    if (artifactLabel) {
+        return ["raw_artifact_access", artifactLabel, null, new Set()];
+    }
+    if (["apply_patch", "edit", "write"].includes(tool)) {
+        return ["implementation_boundary", null, null, new Set()];
+    }
+    return ["non_state_context", null, null, new Set()];
+}
+function eventWarningKeys(event) {
+    const keys = [];
+    for (const warning of Array.isArray(event.warnings) ? event.warnings : []) {
+        if (!warning || typeof warning !== "object" || Array.isArray(warning))
+            continue;
+        const family = warning.family;
+        const category = warning.category;
+        if (typeof family === "string" && typeof category === "string")
+            keys.push(`${family}.${category}`);
+    }
+    return keys;
+}
+function eventClassification(event, coverageCaveated) {
+    const status = event.detail_loss_status;
+    if (status === "possible_useful_detail_removed")
+        return "likely_false_positive";
+    if (status === "retained_artifact_false_positive_signal")
+        return "likely_false_positive";
+    if (status === "possible_compression_without_anchor_loss" || status === "not_detected")
+        return "legitimate_pressure";
+    if (coverageCaveated)
+        return "unsupported_by_available_coverage";
+    return "inconclusive";
+}
+function categoryClassification(counts) {
+    if (counts.likely_false_positive)
+        return "likely_false_positive";
+    if (counts.unsupported_by_available_coverage)
+        return "unsupported_by_available_coverage";
+    if (counts.inconclusive)
+        return "inconclusive";
+    return "legitimate_pressure";
+}
+function nowIsoSeconds() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, "+00:00");
+}
+export function scanThresholdEvidence(corpus, opts) {
+    const salt = opts.salt;
+    const loaded = opts.contract ?? loadContract();
+    let records = corpus && typeof corpus === "object" && !Array.isArray(corpus) ? (corpus.records ?? []) : [];
+    if (!Array.isArray(records))
+        records = [];
+    let metadata = corpus && typeof corpus === "object" && !Array.isArray(corpus) ? (corpus.metadata ?? {}) : {};
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata))
+        metadata = {};
+    let runtimeStatuses = metadata.runtime_statuses;
+    if (!Array.isArray(runtimeStatuses))
+        runtimeStatuses = [];
+    const runtimeCoverage = runtimeStatuses
+        .filter((s) => s !== null && typeof s === "object" && !Array.isArray(s))
+        .map((s) => boundedRuntimeStatus(s));
+    const coverageCaveats = [];
+    if (runtimeCoverage.length === 0) {
+        coverageCaveats.push("No runtime coverage metadata was available for threshold evidence scanning.");
+    }
+    if (runtimeCoverage.some((s) => ["missing", "sparse", "degraded", "skipped"].includes(s.status))) {
+        coverageCaveats.push("Runtime coverage is incomplete or degraded; absence of warning evidence is not proof of absence.");
+    }
+    const groups = new Map();
+    const degradations = [];
+    for (const record of records) {
+        if (!record || typeof record !== "object" || Array.isArray(record)) {
+            degradations.push({ reason: "malformed_record" });
+            continue;
+        }
+        const key = startupConversationKey(record);
+        if (key === null) {
+            degradations.push({ record: recordLabel(record, salt), reason: "missing_conversation_key" });
+            continue;
+        }
+        if (!groups.has(key))
+            groups.set(key, []);
+        groups.get(key).push(record);
+    }
+    const warningCounts = {};
+    const artifactCounts = {};
+    const capabilityCounts = {};
+    const sourceCounts = {};
+    const detailStatusCounts = {};
+    const warningEvents = [];
+    for (const [conversationKey, items] of groups) {
+        items.sort((a, b) => {
+            const ta = String(a.timestamp ?? "");
+            const tb = String(b.timestamp ?? "");
+            return ta < tb ? -1 : ta > tb ? 1 : 0;
+        });
+        let capability = "unknown";
+        let pending = [];
+        for (const record of items) {
+            const text = recordThresholdText(record);
+            const data = record.data && typeof record.data === "object" && !Array.isArray(record.data) ? record.data : {};
+            const actor = data.actor;
+            if (actor === "user") {
+                capability = capabilityInvocation(text) || "unknown";
+                pending = [];
+                continue;
+            }
+            if (actor === "assistant") {
+                capability = introCapability(text) || capability;
+            }
+            const warnings = thresholdWarnings(text);
+            if (warnings.length > 0) {
+                const artifactLabel = canonicalArtifactLabel(text, loaded) || "unknown";
+                const beforeMetrics = detailMetrics(text);
+                const event = {
+                    event_label: recordLabel(record, salt),
+                    conversation: hashLabel("session", conversationKey, salt),
+                    capability,
+                    artifact_label: artifactLabel,
+                    warnings,
+                    detail_loss_status: "not_assessed",
+                    rewrite_followup: null,
+                    observed_counts: {
+                        warning_word_count: beforeMetrics.word_count,
+                        warning_anchor_count: beforeMetrics.anchor_count,
+                    },
+                };
+                warningEvents.push(event);
+                pending.push({ event, metrics: beforeMetrics });
+                inc(artifactCounts, artifactLabel);
+                inc(capabilityCounts, capability);
+                for (const warning of warnings) {
+                    inc(warningCounts, `${warning.family}.${warning.category}`);
+                    inc(sourceCounts, warning.threshold_source);
+                }
+            }
+            if (pending.length > 0 && record.source_kind === "tool_call") {
+                const [eventClass] = classifyStartupEvent(record);
+                if (eventClass === "implementation_boundary") {
+                    const afterMetrics = detailMetrics(text);
+                    for (const pendingItem of pending) {
+                        const event = pendingItem.event;
+                        if (event.rewrite_followup !== null)
+                            continue;
+                        const status = detailLossStatus(pendingItem.metrics, afterMetrics);
+                        event.detail_loss_status = status;
+                        event.rewrite_followup = {
+                            event_label: recordLabel(record, salt),
+                            event_class: eventClass,
+                            word_count_delta: afterMetrics.word_count - pendingItem.metrics.word_count,
+                            anchor_count_delta: afterMetrics.anchor_count - pendingItem.metrics.anchor_count,
+                        };
+                        inc(detailStatusCounts, status);
+                    }
+                    pending = [];
+                }
+            }
+        }
+        for (const pendingItem of pending) {
+            inc(detailStatusCounts, pendingItem.event.detail_loss_status);
+        }
+    }
+    if (degradations.length > 0) {
+        coverageCaveats.push("One or more records were skipped because they were malformed or lacked conversation identity.");
+    }
+    return {
+        output_envelope: THRESHOLD_EVIDENCE_ENVELOPE,
+        contract_version: loaded.version,
+        generated_at: nowIsoSeconds(),
+        total_records: records.length,
+        runtime_coverage: runtimeCoverage,
+        coverage_caveats: [...new Set(coverageCaveats)],
+        counts: {
+            warning_events: warningEvents.length,
+            by_warning: counterDict(warningCounts),
+            by_artifact: counterDict(artifactCounts),
+            by_capability: counterDict(capabilityCounts),
+            by_threshold_source: counterDict(sourceCounts),
+            by_detail_loss_status: counterDict(detailStatusCounts),
+        },
+        warning_events: warningEvents,
+        degradations,
+        privacy_redaction_summary: {
+            raw_transcript_text: "not_emitted",
+            raw_tool_arguments: "not_emitted",
+            full_local_paths: "not_emitted",
+            raw_store_paths: "not_emitted",
+            session_ids: "salted_or_not_emitted",
+            artifact_labels: "canonical_only",
+        },
+    };
+}
+export function scanRetainedThresholdEvidence(artifacts, opts) {
+    const salt = opts.salt;
+    const loaded = opts.contract ?? loadContract();
+    const warningCounts = {};
+    const artifactCounts = {};
+    const sourceCounts = {};
+    const detailStatusCounts = {};
+    const warningEvents = [];
+    for (const sourceLabel of Object.keys(artifacts).sort()) {
+        const text = artifacts[sourceLabel];
+        if (typeof sourceLabel !== "string" || typeof text !== "string")
+            continue;
+        const artifactLabel = canonicalArtifactLabel(sourceLabel, loaded) || canonicalArtifactLabel(text, loaded) || "unknown";
+        const warnings = thresholdWarnings(text);
+        if (warnings.length === 0)
+            continue;
+        const postAuditMarkers = countMatches(POST_AUDIT_FLAG_RE, text);
+        const budgetMentions = countMatches(BUDGET_PRESSURE_RE, text);
+        const fullPlanBudgetPressure = artifactLabel === "plan" && budgetMentions > 0 && FULL_PLAN_BUDGET_RE.test(text);
+        const detailStatus = postAuditMarkers && fullPlanBudgetPressure ? "retained_artifact_false_positive_signal" : "not_assessed";
+        const event = {
+            event_label: hashLabel("record", sourceLabel, salt),
+            conversation: "retained_artifacts",
+            capability: "agentera",
+            artifact_label: artifactLabel,
+            evidence_source: "retained_artifact",
+            warnings,
+            detail_loss_status: detailStatus,
+            rewrite_followup: null,
+            observed_counts: {
+                post_audit_flag_markers: postAuditMarkers,
+                budget_pressure_mentions: budgetMentions,
+            },
+        };
+        warningEvents.push(event);
+        inc(artifactCounts, artifactLabel);
+        inc(detailStatusCounts, detailStatus);
+        for (const warning of warnings) {
+            inc(warningCounts, `${warning.family}.${warning.category}`);
+            inc(sourceCounts, warning.threshold_source);
+        }
+    }
+    return {
+        output_envelope: THRESHOLD_EVIDENCE_ENVELOPE,
+        contract_version: loaded.version,
+        generated_at: nowIsoSeconds(),
+        total_records: Object.keys(artifacts).length,
+        runtime_coverage: [],
+        coverage_caveats: [],
+        counts: {
+            warning_events: warningEvents.length,
+            by_warning: counterDict(warningCounts),
+            by_artifact: counterDict(artifactCounts),
+            by_capability: warningEvents.length > 0 ? { agentera: warningEvents.length } : {},
+            by_threshold_source: counterDict(sourceCounts),
+            by_detail_loss_status: counterDict(detailStatusCounts),
+        },
+        warning_events: warningEvents,
+        degradations: [],
+        privacy_redaction_summary: {
+            raw_artifact_text: "not_emitted",
+            raw_transcript_text: "not_emitted",
+            raw_tool_arguments: "not_emitted",
+            full_local_paths: "not_emitted",
+            artifact_labels: "canonical_only",
+        },
+    };
+}
+export function classifyThresholdEvidence(scan) {
+    let events = scan.warning_events;
+    if (!Array.isArray(events))
+        events = [];
+    let coverageCaveats = scan.coverage_caveats;
+    if (!Array.isArray(coverageCaveats))
+        coverageCaveats = [];
+    const byCategory = new Map();
+    const coverageCaveated = coverageCaveats.length > 0;
+    const unsupported = coverageCaveats.length > 0 && events.length === 0;
+    for (const event of events) {
+        if (!event || typeof event !== "object" || Array.isArray(event))
+            continue;
+        const classification = eventClassification(event, coverageCaveated);
+        const artifact = typeof event.artifact_label === "string" ? event.artifact_label : "unknown";
+        const capability = typeof event.capability === "string" ? event.capability : "unknown";
+        const detailStatus = typeof event.detail_loss_status === "string" ? event.detail_loss_status : "not_assessed";
+        for (const key of eventWarningKeys(event)) {
+            let entry = byCategory.get(key);
+            if (!entry) {
+                entry = {
+                    warning: key,
+                    event_count: 0,
+                    artifacts: new Set(),
+                    capabilities: new Set(),
+                    classification_counts: {},
+                    detail_loss_status_counts: {},
+                    event_labels: [],
+                };
+                byCategory.set(key, entry);
+            }
+            entry.event_count += 1;
+            entry.artifacts.add(artifact);
+            entry.capabilities.add(capability);
+            inc(entry.classification_counts, classification);
+            inc(entry.detail_loss_status_counts, detailStatus);
+            if (typeof event.event_label === "string")
+                entry.event_labels.push(event.event_label);
+        }
+    }
+    const categories = [];
+    let repeatedFalsePositive = false;
+    const classificationCounts = {};
+    for (const key of [...byCategory.keys()].sort()) {
+        const entry = byCategory.get(key);
+        const classification = categoryClassification(entry.classification_counts);
+        inc(classificationCounts, classification);
+        if (classification === "likely_false_positive" && entry.event_count >= 2)
+            repeatedFalsePositive = true;
+        categories.push({
+            warning: key,
+            classification,
+            event_count: entry.event_count,
+            artifacts: [...entry.artifacts].sort(),
+            capabilities: [...entry.capabilities].sort(),
+            event_classification_counts: counterDict(entry.classification_counts),
+            detail_loss_status_counts: counterDict(entry.detail_loss_status_counts),
+            event_labels: entry.event_labels,
+        });
+    }
+    if (unsupported)
+        inc(classificationCounts, "unsupported_by_available_coverage");
+    let recommendation;
+    if (repeatedFalsePositive) {
+        recommendation = {
+            action: "consider_minimal_threshold_or_diagnostic_change",
+            reason: "At least one warning category has repeated redacted evidence of possible useful detail removal.",
+        };
+    }
+    else if (unsupported) {
+        recommendation = {
+            action: "defer_without_threshold_change",
+            reason: "Available runtime coverage cannot support a false-positive conclusion.",
+        };
+    }
+    else {
+        recommendation = {
+            action: "no_threshold_change_yet",
+            reason: "False-positive evidence is absent, single-instance, legitimate pressure, or inconclusive.",
+        };
+    }
+    return {
+        output_envelope: THRESHOLD_CLASSIFICATION_ENVELOPE,
+        input_envelope: scan.output_envelope,
+        generated_at: nowIsoSeconds(),
+        categories,
+        counts: {
+            by_classification: counterDict(classificationCounts),
+            category_count: categories.length,
+            repeated_false_positive_categories: categories.filter((c) => c.classification === "likely_false_positive" && Number(c.event_count) >= 2).length,
+        },
+        recommendation,
+        coverage_caveats: coverageCaveats.map((c) => String(c)),
+        privacy_redaction_summary: scan.privacy_redaction_summary || {
+            raw_transcript_text: "not_emitted",
+            raw_tool_arguments: "not_emitted",
+        },
+    };
+}
+// ===========================================================================
+// Slice 3: startup record classification into state-gathering sequences
+// ===========================================================================
+//# sourceMappingURL=threshold.js.map