harnery 0.35.0 → 0.37.0

package/dist/core/events/v3/reader.d.ts

@@ -53,7 +53,35 @@ export interface ReadLedgerV3SinceResult extends ReadLedgerV3Result {
 export declare function inspectInvalidActiveAuthorityV3(coordRoot: string, controlReason: string): EventV3RecoveryFailure;
 /** Hash one preserved V3 authority by relative path, byte count, and file digest. */
 export declare function digestEventV3AuthorityDirectoryV3(root: string): `sha256:${string}`;
+export interface PendingAdvance {
+    event_id: string;
+    next_schema_digest: string;
+    position: LedgerFrameV3["position"];
+}
+export interface EventV3AuthorityStorageVersionV3 {
+    fingerprint: `sha256:${string}`;
+    stable_fingerprint: `sha256:${string}`;
+    active_bytes: number;
+}
+export interface EventV3AppendValidationCheckpointV3 {
+    format: "harnery-event-v3-append-validation-checkpoint";
+    format_version: 1;
+    reader_build: string;
+    accepted_schema_digests: string[];
+    seen_event_ids: string[];
+    producer_sequences: Array<[string, number]>;
+    attestation_ids: string[];
+    clocks: Array<[string, number, string?]>;
+    event_count: number;
+    genesis_id?: string;
+    active_schema_digest?: string;
+    pending?: PendingAdvance;
+    active_segment_ordinal: number;
+    validated_active_bytes: number;
+}
 export declare const EVENT_V3_LEDGER_RELATIVE_ROOT: ".harnery/ledgers/v3";
+export declare const EVENT_V3_CONTROL_WITNESS_RELATIVE_PATH: ".harnery/ledgers/v3/control-state-witness.json";
+export declare const EVENT_V3_CONTROL_CHECKPOINT_RELATIVE_PATH: ".harnery/ledgers/v3/control-state-validation.json";
 export declare function eventV3Paths(coordRoot: string): {
     root: string;
     active: string;
@@ -62,6 +90,29 @@ export declare function eventV3Paths(coordRoot: string): {
 };
 /** Stable file target for change notification only; reads still go through readLedgerV3. */
 export declare function eventV3ActiveWatchPath(coordRoot: string): string;
+/** Stable auxiliary control-cache target; canonical event reads remain inside this module. */
+export declare function eventV3ControlWitnessPathV3(coordRoot: string): string;
+/** Stable auxiliary validator-checkpoint target owned by the control witness. */
+export declare function eventV3ControlCheckpointPathV3(coordRoot: string): string;
+/**
+ * Content-independent identity for the complete filesystem authority.
+ *
+ * The control witness authenticates this value after a complete validation.
+ * Any append, rewrite, inode replacement, catalog change, sealed-segment
+ * change, or recovery-record change produces a different fingerprint and
+ * sends the control reader back through the canonical full validation path.
+ */
+export declare function eventV3AuthorityStorageVersionV3(coordRoot: string): EventV3AuthorityStorageVersionV3;
+/** Serialize the validator tail produced by the current complete cached read. */
+export declare function readEventV3AppendValidationCheckpointV3(coordRoot: string): EventV3AppendValidationCheckpointV3 | undefined;
+/**
+ * Validate only the bytes appended after an authenticated checkpoint.
+ * Unsupported or semantically invalid transitions return undefined so the
+ * control reader falls back to a complete canonical validation.
+ */
+export declare function advanceEventV3AppendValidationCheckpointV3(coordRoot: string, checkpoint: EventV3AppendValidationCheckpointV3): EventV3AppendValidationCheckpointV3 | undefined;
+/** Parse an untrusted persisted checkpoint without weakening the writer fence. */
+export declare function parseEventV3AppendValidationCheckpointV3(value: unknown): EventV3AppendValidationCheckpointV3 | undefined;
 /** Read the complete V3 ledger through catalog-bound filesystem discovery. */
 export declare function readLedgerV3(coordRoot: string, options?: ReadLedgerV3Options): ReadLedgerV3Result;
 export declare function readLedgerV3Since(coordRoot: string, cursor?: LedgerCursorV3, options?: ReadLedgerV3Options): ReadLedgerV3SinceResult;

package/dist/core/events/v3/reader.d.ts.map

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

package/dist/core/events/v3/reader.js

@@ -72,6 +72,8 @@ export function digestEventV3AuthorityDirectoryV3(root) {
 const MAX_CACHED_LEDGER_READS = 4;
 const ledgerReadCacheV3 = new Map();
 export const EVENT_V3_LEDGER_RELATIVE_ROOT = ".harnery/ledgers/v3";
+export const EVENT_V3_CONTROL_WITNESS_RELATIVE_PATH = `${EVENT_V3_LEDGER_RELATIVE_ROOT}/control-state-witness.json`;
+export const EVENT_V3_CONTROL_CHECKPOINT_RELATIVE_PATH = `${EVENT_V3_LEDGER_RELATIVE_ROOT}/control-state-validation.json`;
 export function eventV3Paths(coordRoot) {
     const root = join(resolve(coordRoot), EVENT_V3_LEDGER_RELATIVE_ROOT);
     return {
@@ -85,6 +87,107 @@ export function eventV3Paths(coordRoot) {
 export function eventV3ActiveWatchPath(coordRoot) {
     return eventV3Paths(coordRoot).active;
 }
+/** Stable auxiliary control-cache target; canonical event reads remain inside this module. */
+export function eventV3ControlWitnessPathV3(coordRoot) {
+    return join(eventV3Paths(coordRoot).root, "control-state-witness.json");
+}
+/** Stable auxiliary validator-checkpoint target owned by the control witness. */
+export function eventV3ControlCheckpointPathV3(coordRoot) {
+    return join(eventV3Paths(coordRoot).root, "control-state-validation.json");
+}
+/**
+ * Content-independent identity for the complete filesystem authority.
+ *
+ * The control witness authenticates this value after a complete validation.
+ * Any append, rewrite, inode replacement, catalog change, sealed-segment
+ * change, or recovery-record change produces a different fingerprint and
+ * sends the control reader back through the canonical full validation path.
+ */
+export function eventV3AuthorityStorageVersionV3(coordRoot) {
+    const storage = ledgerStorageVersionV3(coordRoot);
+    return {
+        fingerprint: sha256V3(storage.fingerprint),
+        stable_fingerprint: sha256V3(storage.stable_fingerprint),
+        active_bytes: storage.active?.size ?? 0,
+    };
+}
+/** Serialize the validator tail produced by the current complete cached read. */
+export function readEventV3AppendValidationCheckpointV3(coordRoot) {
+    const options = {};
+    const result = readLedgerV3(coordRoot, options);
+    if (!result.complete)
+        return undefined;
+    const cached = ledgerReadCacheV3.get(ledgerReadCacheKeyV3(coordRoot, options));
+    if (!cached?.active || !cached.result.complete)
+        return undefined;
+    return checkpointFromValidationStateV3(cached.validation_state, cached.active);
+}
+/**
+ * Validate only the bytes appended after an authenticated checkpoint.
+ * Unsupported or semantically invalid transitions return undefined so the
+ * control reader falls back to a complete canonical validation.
+ */
+export function advanceEventV3AppendValidationCheckpointV3(coordRoot, checkpoint) {
+    const parsed = parseEventV3AppendValidationCheckpointV3(checkpoint);
+    if (!parsed)
+        return undefined;
+    const storage = ledgerStorageVersionV3(coordRoot);
+    if (!storage.active || storage.active.size <= parsed.validated_active_bytes)
+        return undefined;
+    const appended = readActiveRangeV3(storage.active.path, parsed.validated_active_bytes, storage.active.size, parsed.active_segment_ordinal);
+    if (!appended || appended.diagnostics.length > 0)
+        return undefined;
+    const state = validationStateFromCheckpointV3(parsed);
+    validateLedgerFramesIntoStateV3(appended.frames, state);
+    if (state.diagnostics.length > 0)
+        return undefined;
+    return checkpointFromValidationStateV3(state, {
+        bytes: storage.active.size,
+        path: storage.active.path,
+        segment_ordinal: parsed.active_segment_ordinal,
+    });
+}
+/** Parse an untrusted persisted checkpoint without weakening the writer fence. */
+export function parseEventV3AppendValidationCheckpointV3(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const checkpoint = value;
+    if (checkpoint.format !== "harnery-event-v3-append-validation-checkpoint" ||
+        checkpoint.format_version !== 1 ||
+        typeof checkpoint.reader_build !== "string" ||
+        !Array.isArray(checkpoint.accepted_schema_digests) ||
+        !checkpoint.accepted_schema_digests.every((item) => typeof item === "string") ||
+        !Array.isArray(checkpoint.seen_event_ids) ||
+        !checkpoint.seen_event_ids.every((item) => typeof item === "string") ||
+        !Array.isArray(checkpoint.producer_sequences) ||
+        !checkpoint.producer_sequences.every((item) => Array.isArray(item) &&
+            item.length === 2 &&
+            typeof item[0] === "string" &&
+            Number.isSafeInteger(item[1]) &&
+            item[1] > 0) ||
+        !Array.isArray(checkpoint.attestation_ids) ||
+        !checkpoint.attestation_ids.every((item) => typeof item === "string") ||
+        !Array.isArray(checkpoint.clocks) ||
+        !checkpoint.clocks.every((item) => Array.isArray(item) &&
+            (item.length === 2 || item.length === 3) &&
+            typeof item[0] === "string" &&
+            typeof item[1] === "number" &&
+            Number.isFinite(item[1]) &&
+            (item[2] === undefined || (typeof item[2] === "string" && /^\d+$/.test(item[2])))) ||
+        !Number.isSafeInteger(checkpoint.event_count) ||
+        (checkpoint.event_count ?? -1) < 0 ||
+        !Number.isSafeInteger(checkpoint.active_segment_ordinal) ||
+        (checkpoint.active_segment_ordinal ?? 0) < 1 ||
+        !Number.isSafeInteger(checkpoint.validated_active_bytes) ||
+        (checkpoint.validated_active_bytes ?? -1) < 0 ||
+        (checkpoint.genesis_id !== undefined && typeof checkpoint.genesis_id !== "string") ||
+        (checkpoint.active_schema_digest !== undefined &&
+            typeof checkpoint.active_schema_digest !== "string") ||
+        !validPendingAdvanceV3(checkpoint.pending)) {
+        return undefined;
+    }
+    return checkpoint;
+}
 /** Read the complete V3 ledger through catalog-bound filesystem discovery. */
 export function readLedgerV3(coordRoot, options = {}) {
     const cacheKey = ledgerReadCacheKeyV3(coordRoot, options);
@@ -177,6 +280,7 @@ function validateLedgerFramesV3(frames, options) {
         producer_sequences: new Map(),
         attestations: new Set(),
         clocks: new Map(),
+        event_count: 0,
     };
     validateLedgerFramesIntoStateV3(frames, state);
     return { result: finishLedgerValidationV3(state, options, ledgerFramesBytesV3(frames)), state };
@@ -234,7 +338,7 @@ function validateLedgerFramesIntoStateV3(frames, state) {
                 diagnostics.push(diagnostic("multiple_genesis", frame, shape.event_id));
                 continue;
             }
-            if (events.length !== 0)
+            if (state.event_count !== 0)
                 diagnostics.push(diagnostic("genesis_not_first", frame, shape.event_id));
             const payload = shape.payload;
             state.genesis_id = string(payload.genesis_id);
@@ -298,6 +402,7 @@ function validateLedgerFramesIntoStateV3(frames, state) {
             }
         }
         events.push({ event, position: frame.position });
+        state.event_count += 1;
     }
 }
 function finishLedgerValidationV3(state, options, bytes) {
@@ -514,6 +619,81 @@ function isolateValidationStateV3(state) {
         advances: [...state.advances],
     };
 }
+function checkpointFromValidationStateV3(state, active) {
+    return {
+        format: "harnery-event-v3-append-validation-checkpoint",
+        format_version: 1,
+        reader_build: state.reader_build,
+        accepted_schema_digests: [...state.accepted].sort(),
+        seen_event_ids: [...state.seen_ids.keys()].sort(),
+        producer_sequences: [...state.producer_sequences.entries()].sort(([left], [right]) => left.localeCompare(right)),
+        attestation_ids: [...state.attestations].sort(),
+        clocks: [...state.clocks.entries()]
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([clockId, clock]) => clock.monotonic_ns !== undefined
+            ? [clockId, clock.observed_at_ms, clock.monotonic_ns.toString()]
+            : [clockId, clock.observed_at_ms]),
+        event_count: state.event_count,
+        ...(state.genesis_id ? { genesis_id: state.genesis_id } : {}),
+        ...(state.active_schema_digest ? { active_schema_digest: state.active_schema_digest } : {}),
+        ...(state.pending
+            ? {
+                pending: {
+                    ...state.pending,
+                    position: { ...state.pending.position },
+                },
+            }
+            : {}),
+        active_segment_ordinal: active.segment_ordinal,
+        validated_active_bytes: active.bytes,
+    };
+}
+function validationStateFromCheckpointV3(checkpoint) {
+    return {
+        diagnostics: [],
+        events: [],
+        advances: [],
+        accepted: new Set(checkpoint.accepted_schema_digests),
+        reader_build: checkpoint.reader_build,
+        seen_ids: new Map(checkpoint.seen_event_ids.map((eventId) => [eventId, ""])),
+        producer_sequences: new Map(checkpoint.producer_sequences),
+        attestations: new Set(checkpoint.attestation_ids),
+        clocks: new Map(checkpoint.clocks.map(([clockId, observedAtMs, monotonicNs]) => [
+            clockId,
+            {
+                observed_at_ms: observedAtMs,
+                ...(monotonicNs !== undefined ? { monotonic_ns: BigInt(monotonicNs) } : {}),
+            },
+        ])),
+        event_count: checkpoint.event_count,
+        ...(checkpoint.genesis_id ? { genesis_id: checkpoint.genesis_id } : {}),
+        ...(checkpoint.active_schema_digest
+            ? { active_schema_digest: checkpoint.active_schema_digest }
+            : {}),
+        ...(checkpoint.pending
+            ? {
+                pending: {
+                    ...checkpoint.pending,
+                    position: { ...checkpoint.pending.position },
+                },
+            }
+            : {}),
+    };
+}
+function validPendingAdvanceV3(value) {
+    if (value === undefined)
+        return true;
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const pending = value;
+    return (typeof pending.event_id === "string" &&
+        typeof pending.next_schema_digest === "string" &&
+        Boolean(pending.position) &&
+        Number.isSafeInteger(pending.position?.segment_ordinal) &&
+        Number.isSafeInteger(pending.position?.byte_offset) &&
+        (pending.position?.segment_ordinal ?? 0) > 0 &&
+        (pending.position?.byte_offset ?? -1) >= 0);
+}
 function readActiveRangeV3(path, start, end, segmentOrdinal) {
     const length = end - start;
     const bytes = Buffer.alloc(length);

package/dist/core/events/v3/rotation-config.d.ts

@@ -0,0 +1,9 @@
+/** Default active-segment size that triggers automatic V3 epoch rotation. */
+export declare const DEFAULT_EVENT_LEDGER_ROTATE_ACTIVE_BYTES: number;
+/**
+ * Resolve the active-segment byte threshold without importing the host CLI's
+ * configuration layer. Event V3 is vendored into clients as a closed runtime,
+ * so this leaf reads only process state and JSONC files.
+ */
+export declare function resolveEventLedgerRotateActiveBytesV3(coordRoot: string | null): number;
+//# sourceMappingURL=rotation-config.d.ts.map

package/dist/core/events/v3/rotation-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotation-config.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/rotation-config.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,eAAO,MAAM,wCAAwC,QAAmB,CAAC;AAsEzE;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAiBtF"}

package/dist/core/events/v3/rotation-config.js

@@ -0,0 +1,91 @@
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Default active-segment size that triggers automatic V3 epoch rotation. */
+export const DEFAULT_EVENT_LEDGER_ROTATE_ACTIVE_BYTES = 32 * 1024 * 1024;
+/** Strip JSONC comments without treating comment-like text inside strings as syntax. */
+function stripJsonComments(input) {
+    let out = "";
+    let index = 0;
+    let inString = false;
+    while (index < input.length) {
+        const character = input[index];
+        if (inString) {
+            out += character;
+            if (character === "\\" && index + 1 < input.length) {
+                out += input[index + 1];
+                index += 2;
+                continue;
+            }
+            if (character === '"')
+                inString = false;
+            index++;
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+            out += character;
+            index++;
+            continue;
+        }
+        if (character === "/" && input[index + 1] === "/") {
+            while (index < input.length && input[index] !== "\n")
+                index++;
+            continue;
+        }
+        if (character === "/" && input[index + 1] === "*") {
+            index += 2;
+            while (index < input.length && !(input[index] === "*" && input[index + 1] === "/")) {
+                index++;
+            }
+            index += 2;
+            continue;
+        }
+        out += character;
+        index++;
+    }
+    return out;
+}
+function readConfig(path) {
+    try {
+        const parsed = JSON.parse(stripJsonComments(readFileSync(path, "utf8")));
+        if (parsed && typeof parsed === "object")
+            return parsed;
+    }
+    catch {
+        // Missing or malformed config falls through to the next precedence layer.
+    }
+    return {};
+}
+function configuredThreshold(config) {
+    const events = config.events;
+    if (!events || typeof events !== "object")
+        return { present: false, value: undefined };
+    return {
+        present: Object.hasOwn(events, "rotate_active_bytes"),
+        value: events.rotate_active_bytes,
+    };
+}
+/**
+ * Resolve the active-segment byte threshold without importing the host CLI's
+ * configuration layer. Event V3 is vendored into clients as a closed runtime,
+ * so this leaf reads only process state and JSONC files.
+ */
+export function resolveEventLedgerRotateActiveBytesV3(coordRoot) {
+    const env = process.env.HARNERY_EVENT_V3_ROTATE_ACTIVE_BYTES;
+    if (env !== undefined) {
+        const parsed = Number.parseInt(env, 10);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    if (coordRoot) {
+        const project = configuredThreshold(readConfig(join(coordRoot, ".harnery", "config.jsonc")));
+        const xdg = process.env.XDG_CONFIG_HOME;
+        const userBase = xdg?.trim() ? xdg : join(homedir(), ".config");
+        const user = configuredThreshold(readConfig(join(userBase, "harnery", "config.jsonc")));
+        const configured = project.present ? project.value : user.value;
+        if (typeof configured === "number" && Number.isSafeInteger(configured))
+            return configured;
+    }
+    return DEFAULT_EVENT_LEDGER_ROTATE_ACTIVE_BYTES;
+}

package/dist/core/events/v3/runtime-build.d.ts

@@ -0,0 +1,11 @@
+export { liveEventV3BuildId, livePlatformV3 } from "./runtime-identity.js";
+/**
+ * Identify the code running this producer.
+ *
+ * Source checkouts use the exact Git commit. Published packages use their
+ * package version, which changes at the installation boundary without tying
+ * the authority profile to a machine-specific install path.
+ */
+export declare function currentHarneryRuntimeBuild(): string;
+export declare function harneryPackageRoot(): string;
+//# sourceMappingURL=runtime-build.d.ts.map

package/dist/core/events/v3/runtime-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-build.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAuBnD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/core/events/v3/runtime-build.js

@@ -0,0 +1,39 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+export { liveEventV3BuildId, livePlatformV3 } from "./runtime-identity.js";
+/**
+ * Identify the code running this producer.
+ *
+ * Source checkouts use the exact Git commit. Published packages use their
+ * package version, which changes at the installation boundary without tying
+ * the authority profile to a machine-specific install path.
+ */
+export function currentHarneryRuntimeBuild() {
+    const root = harneryPackageRoot();
+    if (existsSync(resolve(root, ".git"))) {
+        const result = spawnSync("git", ["-C", root, "rev-parse", "HEAD"], {
+            encoding: "utf8",
+            timeout: 5_000,
+        });
+        const commit = result.status === 0 ? result.stdout.trim() : "";
+        if (/^[0-9a-f]{40,64}$/.test(commit))
+            return commit;
+    }
+    const packagePath = resolve(root, "package.json");
+    if (existsSync(packagePath)) {
+        try {
+            const value = JSON.parse(readFileSync(packagePath, "utf8"));
+            if (typeof value.version === "string" && /^[0-9A-Za-z._+-]{1,100}$/.test(value.version)) {
+                return `npm-${value.version}`;
+            }
+        }
+        catch {
+            // A malformed package manifest falls through to a stable source digest.
+        }
+    }
+    throw new Error("harnery_runtime_build_unavailable");
+}
+export function harneryPackageRoot() {
+    return resolve(import.meta.dir, "../../../..");
+}

package/dist/core/events/v3/runtime-identity.d.ts

@@ -0,0 +1,5 @@
+/** Stable producer build id bound into one V3 epoch. */
+export declare function liveEventV3BuildId(harneryBuild: string): `build_${string}`;
+/** Platform recorded by runtime-owned V3 producers. */
+export declare function livePlatformV3(): "linux" | "windows" | "macos" | "unknown";
+//# sourceMappingURL=runtime-identity.d.ts.map

package/dist/core/events/v3/runtime-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-identity.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-identity.ts"],"names":[],"mappings":"AAEA,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAI1E;AAED,uDAAuD;AACvD,wBAAgB,cAAc,IAAI,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAK1E"}

package/dist/core/events/v3/runtime-identity.js

@@ -0,0 +1,18 @@
+import { createHash } from "node:crypto";
+/** Stable producer build id bound into one V3 epoch. */
+export function liveEventV3BuildId(harneryBuild) {
+    const exact = harneryBuild.normalize("NFC");
+    if (/^[a-zA-Z0-9._-]{1,120}$/.test(exact))
+        return `build_${exact}`;
+    return `build_${createHash("sha256").update(exact).digest("hex")}`;
+}
+/** Platform recorded by runtime-owned V3 producers. */
+export function livePlatformV3() {
+    if (process.platform === "linux")
+        return "linux";
+    if (process.platform === "win32")
+        return "windows";
+    if (process.platform === "darwin")
+        return "macos";
+    return "unknown";
+}

package/dist/core/events/v3/runtime-telemetry-capabilities.d.ts

@@ -1,7 +1,7 @@
 import type { Adapter } from "../../adapter.js";
 import { type CapabilitySupportV3, type CursorExecutionModeV3 } from "./capabilities.js";
 export type RuntimeTelemetryChannelV3 = "context_usage" | "wait_spans" | "wait_completeness" | "response_latency" | "inference_timing";
-export type RuntimeTelemetryCompletenessV3 = "exact" | "lower_bound" | "unknown";
+export type RuntimeTelemetryCompletenessV3 = "exact" | "inferred" | "percentage_only" | "lower_bound" | "unknown";
 export interface RuntimeTelemetryCapabilityValueV3 {
     support: Exclude<CapabilitySupportV3, "unsupported">;
     source: string;
@@ -10,8 +10,8 @@ export interface RuntimeTelemetryCapabilityValueV3 {
 export type RuntimeTelemetryCapabilityObservationV3 = {
     state: "observed";
     value: RuntimeTelemetryCapabilityValueV3;
-    attestation: "native" | "derived";
-    confidence: "exact" | "high";
+    attestation: "native" | "derived" | "inferred";
+    confidence: "exact" | "high" | "medium" | "low";
 } | {
     state: "expected_but_missing";
     capability: string;
@@ -23,8 +23,9 @@ export type RuntimeTelemetryCapabilityObservationV3 = {
 export type RuntimeContextCapabilityEvidenceV3 = {
     state: "observed";
     source: string;
-    attestation: "native" | "derived";
-    confidence: "exact" | "high";
+    attestation: "native" | "derived" | "inferred";
+    confidence: "exact" | "high" | "medium" | "low";
+    completeness?: "exact" | "inferred" | "percentage_only";
 } | {
     state: "partial";
     reason: string;

package/dist/core/events/v3/runtime-telemetry-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-telemetry-capabilities.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-telemetry-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,YAAY,GACZ,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,8BAA8B,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;AAEjF,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,8BAA8B,CAAC;CAC9C;AAED,MAAM,MAAM,uCAAuC,GAC/C;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,iCAAiC,CAAC;IACzC,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B,GACD;IAAE,KAAK,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,kCAAkC,GAC1C;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B,GACD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE7B,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,OAAO,EAAE,kCAAkC,CAAC;IAC5C,yBAAyB,EAAE,OAAO,CAAC;IACnC,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,MAAM,8BAA8B,GAAG,MAAM,CACjD,yBAAyB,EACzB,uCAAuC,CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,oCAAoC,GAC7C,8BAA8B,CAYhC"}
+{"version":3,"file":"runtime-telemetry-capabilities.d.ts","sourceRoot":"","sources":["../../../../src/core/events/v3/runtime-telemetry-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,YAAY,GACZ,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,8BAA8B,GACtC,OAAO,GACP,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,8BAA8B,CAAC;CAC9C;AAED,MAAM,MAAM,uCAAuC,GAC/C;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,iCAAiC,CAAC;IACzC,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACjD,GACD;IAAE,KAAK,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,kCAAkC,GAC1C;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC/C,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAChD,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,iBAAiB,CAAC;CACzD,GACD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE7B,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,OAAO,EAAE,kCAAkC,CAAC;IAC5C,yBAAyB,EAAE,OAAO,CAAC;IACnC,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,MAAM,8BAA8B,GAAG,MAAM,CACjD,yBAAyB,EACzB,uCAAuC,CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,oCAAoC,GAC7C,8BAA8B,CAYhC"}

package/dist/core/events/v3/runtime-telemetry-capabilities.js

@@ -22,7 +22,7 @@ export function effectiveRuntimeTelemetryCapabilitiesV3(evidence) {
 }
 function contextCapability(evidence) {
     if (evidence.state === "observed") {
-        return observed(evidence.attestation === "native" ? "native" : "derived", evidence.source, "exact", evidence.attestation, evidence.confidence);
+        return observed(evidence.attestation === "native" ? "native" : "derived", evidence.source, evidence.completeness ?? (evidence.attestation === "inferred" ? "inferred" : "exact"), evidence.attestation, evidence.confidence);
     }
     if (evidence.state === "partial") {
         return missing("context_usage", evidence.reason);

package/dist/core/events/v3/support-storage/classify.d.ts

@@ -0,0 +1,46 @@
+import type { EventV3SupportFamily } from "./pack-contract.js";
+export type EventV3SupportDisposition = "live-required" | "recovery-required" | "pack-eligible" | "quarantine" | "unsupported";
+export declare const EVENT_V3_SUPPORT_CLASSIFICATION_REASONS: readonly ["active_committed_receipt_deferred", "active_epoch_family_not_enabled", "archive_has_ready_authority_transaction", "authority_lease_live", "authority_ready_active", "command_state_lease_live", "command_state_open", "command_state_pending", "committed_receipt_grace_not_elapsed", "committed_receipt_reconciled", "diagnostic_consumer_window_elapsed", "diagnostic_timestamp_mismatch", "diagnostic_within_loose_window", "epoch_not_enabled_for_maintenance_slice", "event_reference_cross_epoch", "event_reference_unresolved", "file_contract_invalid", "file_not_owner_only", "file_not_regular", "finalization_not_complete", "maintenance_transaction_owns_path", "producer_pending_reference", "recovery_bound_archive_not_enabled", "receipt_digest_mismatch", "receipt_has_ready_sibling", "sealed_terminal_state", "stale_writer_grace_not_elapsed", "transaction_digest_mismatch", "turn_not_sealed", "unknown_support_family"];
+export type EventV3SupportClassificationReason = (typeof EVENT_V3_SUPPORT_CLASSIFICATION_REASONS)[number];
+export interface EventV3SupportClassificationEvidence {
+    family?: EventV3SupportFamily;
+    authority_state: "active" | "archived";
+    recovery_bound?: boolean;
+    recovery_packing_enabled?: boolean;
+    epoch_maintenance_enabled?: boolean;
+    active_session_tee_enabled?: boolean;
+    active_committed_receipt_enabled?: boolean;
+    file_regular?: boolean;
+    file_owner_only?: boolean;
+    contract_valid?: boolean;
+    maintenance_owned?: boolean;
+    recorded_at?: string;
+    filename_recorded_at?: string;
+    now: string;
+    maximum_loose_consumer_window_ms?: number;
+    fixed_consumer_grace_ms?: number;
+    writer_tolerance_ms?: number;
+    terminal?: boolean;
+    pending?: boolean;
+    turn_sealed?: boolean;
+    finalization_complete?: boolean;
+    event_references_resolved?: boolean;
+    event_references_same_epoch?: boolean;
+    lease_live?: boolean;
+    stale_writer_grace_elapsed?: boolean;
+    ready_sibling?: boolean;
+    producer_pending_reference?: boolean;
+    event_row_digest_matches?: boolean;
+    transaction_digest_matches?: boolean;
+    receipt_grace_elapsed?: boolean;
+    archive_has_ready_transaction?: boolean;
+}
+export interface EventV3SupportClassification {
+    disposition: EventV3SupportDisposition;
+    reasons: EventV3SupportClassificationReason[];
+}
+export declare const EVENT_V3_DIAGNOSTIC_CONSUMER_WINDOW_MS: number;
+export declare const EVENT_V3_DIAGNOSTIC_FIXED_GRACE_MS: number;
+/** The only disposition decision point for V3 support files. */
+export declare function classifyEventV3Support(evidence: EventV3SupportClassificationEvidence): EventV3SupportClassification;
+//# sourceMappingURL=classify.d.ts.map

package/dist/core/events/v3/support-storage/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../../../src/core/events/v3/support-storage/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,MAAM,yBAAyB,GACjC,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,YAAY,GACZ,aAAa,CAAC;AAElB,eAAO,MAAM,uCAAuC,45BA+B1C,CAAC;AAEX,MAAM,MAAM,kCAAkC,GAC5C,CAAC,OAAO,uCAAuC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,oCAAoC;IACnD,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,eAAe,EAAE,QAAQ,GAAG,UAAU,CAAC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gCAAgC,CAAC,EAAE,OAAO,CAAC;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,yBAAyB,CAAC;IACvC,OAAO,EAAE,kCAAkC,EAAE,CAAC;CAC/C;AAED,eAAO,MAAM,sCAAsC,QAAsB,CAAC;AAC1E,eAAO,MAAM,kCAAkC,QAAsB,CAAC;AAEtE,gEAAgE;AAChE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,oCAAoC,GAC7C,4BAA4B,CAgC9B"}