@noodleseed/one 0.46.0 → 0.47.0

package/node_modules/@noodle-borg/service/dist/billing/meter-capacity.d.ts

@@ -0,0 +1,77 @@
+export declare const BILLING_METER_CAPACITY_TARGET: {
+    readonly minimumThroughputPerSecond: 400;
+    readonly maximumP95Ms: 100;
+    readonly maximumP99Ms: 250;
+};
+export declare const BILLING_METER_PLAN_MONTHLY_CALLS: {
+    readonly pro: 10000000;
+    readonly scale: 100000000;
+};
+export type BillingMeterCapacityScenarioName = 'hot_account' | 'multi_account';
+export interface BillingMeterCapacityScenarioResult {
+    readonly name: BillingMeterCapacityScenarioName;
+    readonly attempted: number;
+    readonly recorded: number;
+    readonly duplicates: number;
+    readonly durationMs: number;
+    readonly throughputPerSecond: number;
+    readonly p95Ms: number;
+    readonly p99Ms: number;
+    readonly consistent: boolean;
+}
+export interface BillingMeterCapacityEvaluation {
+    readonly passed: boolean;
+    readonly failures: readonly string[];
+}
+export interface BillingMeterRelationStorage {
+    readonly tableBytes: number;
+    readonly indexBytes: number;
+}
+export interface BillingMeterStorageSample {
+    readonly receipts: BillingMeterRelationStorage;
+    readonly exactKeyTombstones: BillingMeterRelationStorage;
+    readonly accountWindows: BillingMeterRelationStorage;
+    readonly orgWindows: BillingMeterRelationStorage;
+    readonly meterWindows: BillingMeterRelationStorage;
+}
+interface BillingMeterRelationStorageWithTotal extends BillingMeterRelationStorage {
+    readonly totalBytes: number;
+}
+export interface BillingMeterRetainedStorageProjection {
+    readonly plan: keyof typeof BILLING_METER_PLAN_MONTHLY_CALLS;
+    readonly monthlyCalls: number;
+    readonly peakRetainedReceiptRows: number;
+    readonly peakRetainedExactKeyTombstoneRows: number;
+    readonly receipts: BillingMeterRelationStorageWithTotal;
+    readonly exactKeyTombstones: BillingMeterRelationStorageWithTotal;
+    readonly combinedBytes: number;
+}
+export interface BillingMeterStorageEvidence {
+    readonly sampleRecordedEvents: number;
+    readonly measurementBasis: 'allocated_growth';
+    readonly receiptRetentionDays: number;
+    readonly exactKeyTombstoneRetentionDays: number;
+    readonly measuredBytesPerRecordedEvent: BillingMeterStorageSample & {
+        readonly allMeasuredRelations: BillingMeterRelationStorageWithTotal;
+    };
+    readonly projections: readonly BillingMeterRetainedStorageProjection[];
+    readonly topologyApproval: {
+        readonly state: 'manual_review_required';
+        readonly checkpointContention: 'one_row_per_epoch_window';
+        readonly reason: string;
+    };
+}
+/** Evaluate safe aggregate harness evidence; never lowers a failed target automatically. */
+export declare function evaluateBillingMeterCapacity(results: readonly BillingMeterCapacityScenarioResult[]): BillingMeterCapacityEvaluation;
+/** Round raw benchmark measurements only when constructing retained human-readable evidence. */
+export declare function presentBillingMeterCapacityScenario(result: BillingMeterCapacityScenarioResult): BillingMeterCapacityScenarioResult;
+/**
+ * Build conservative allocated-storage projections from safe aggregate relation sizes. The projection
+ * intentionally does not approve a database tier or topology: WAL, replicas, backups, vacuum headroom,
+ * burst shape, and operational contention require a human review of the measured environment.
+ */
+export declare function buildBillingMeterStorageEvidence(sample: BillingMeterStorageSample, recordedEvents: number): BillingMeterStorageEvidence;
+/** Nearest-rank percentile for positive, finite latency samples. */
+export declare function billingMeterPercentile(samples: readonly number[], percentile: number): number;
+export {};
+//# sourceMappingURL=meter-capacity.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/meter-capacity.d.ts.map

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

package/node_modules/@noodle-borg/service/dist/billing/meter-capacity.js

@@ -0,0 +1,202 @@
+import { BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS, BILLING_METER_RECEIPT_RETENTION_DAYS, } from './meter-readiness.js';
+export const BILLING_METER_CAPACITY_TARGET = {
+    minimumThroughputPerSecond: 400,
+    maximumP95Ms: 100,
+    maximumP99Ms: 250,
+};
+export const BILLING_METER_PLAN_MONTHLY_CALLS = {
+    pro: 10_000_000,
+    scale: 100_000_000,
+};
+const BILLING_METER_PEAK_RETAINED_COHORTS = {
+    receipts: 2,
+    exactKeyTombstones: 3,
+};
+const SCENARIOS = ['hot_account', 'multi_account'];
+/** Evaluate safe aggregate harness evidence; never lowers a failed target automatically. */
+export function evaluateBillingMeterCapacity(results) {
+    const failures = [];
+    for (const name of SCENARIOS) {
+        const matches = results.filter((result) => result.name === name);
+        if (matches.length === 0) {
+            failures.push(`${name}:missing`);
+            continue;
+        }
+        if (matches.length > 1) {
+            failures.push(`${name}:duplicate_result`);
+            continue;
+        }
+        const result = matches[0];
+        if (result === undefined)
+            continue;
+        validateScenario(result);
+        if (result.throughputPerSecond < BILLING_METER_CAPACITY_TARGET.minimumThroughputPerSecond) {
+            failures.push(`${name}:throughput_below_target`);
+        }
+        if (result.p95Ms > BILLING_METER_CAPACITY_TARGET.maximumP95Ms) {
+            failures.push(`${name}:p95_above_target`);
+        }
+        if (result.p99Ms > BILLING_METER_CAPACITY_TARGET.maximumP99Ms) {
+            failures.push(`${name}:p99_above_target`);
+        }
+        if (!result.consistent || result.recorded !== result.attempted || result.duplicates !== 0) {
+            failures.push(`${name}:counter_drift`);
+        }
+    }
+    return { passed: failures.length === 0, failures };
+}
+/** Round raw benchmark measurements only when constructing retained human-readable evidence. */
+export function presentBillingMeterCapacityScenario(result) {
+    validateScenario(result);
+    return {
+        ...result,
+        durationMs: roundForPresentation(result.durationMs),
+        throughputPerSecond: roundForPresentation(result.throughputPerSecond),
+        p95Ms: roundForPresentation(result.p95Ms),
+        p99Ms: roundForPresentation(result.p99Ms),
+    };
+}
+/**
+ * Build conservative allocated-storage projections from safe aggregate relation sizes. The projection
+ * intentionally does not approve a database tier or topology: WAL, replicas, backups, vacuum headroom,
+ * burst shape, and operational contention require a human review of the measured environment.
+ */
+export function buildBillingMeterStorageEvidence(sample, recordedEvents) {
+    if (!Number.isSafeInteger(recordedEvents) || recordedEvents <= 0) {
+        throw new Error('billing meter storage sample requires a positive safe integer event count');
+    }
+    const measured = {
+        receipts: bytesPerEvent(sample.receipts, recordedEvents),
+        exactKeyTombstones: bytesPerEvent(sample.exactKeyTombstones, recordedEvents),
+        accountWindows: bytesPerEvent(sample.accountWindows, recordedEvents),
+        orgWindows: bytesPerEvent(sample.orgWindows, recordedEvents),
+        meterWindows: bytesPerEvent(sample.meterWindows, recordedEvents),
+    };
+    const allMeasuredRelations = relationWithTotal(Object.values(measured).reduce((total, relation) => ({
+        tableBytes: total.tableBytes + relation.tableBytes,
+        indexBytes: total.indexBytes + relation.indexBytes,
+    }), { tableBytes: 0, indexBytes: 0 }));
+    const projections = Object.entries(BILLING_METER_PLAN_MONTHLY_CALLS).map(([plan, monthlyCalls]) => retainedStorageProjection(plan, monthlyCalls, measured));
+    return {
+        sampleRecordedEvents: recordedEvents,
+        measurementBasis: 'allocated_growth',
+        receiptRetentionDays: BILLING_METER_RECEIPT_RETENTION_DAYS,
+        exactKeyTombstoneRetentionDays: BILLING_METER_EXACT_KEY_TOMBSTONE_RETENTION_DAYS,
+        measuredBytesPerRecordedEvent: { ...measured, allMeasuredRelations },
+        projections,
+        topologyApproval: {
+            state: 'manual_review_required',
+            checkpointContention: 'one_row_per_epoch_window',
+            reason: 'Measured allocation projections exclude WAL, replicas, backups, vacuum headroom, and burst shape; every receipt also serializes one checkpoint update per epoch/window, so the 400/s hot-window gate is topology-critical.',
+        },
+    };
+}
+/** Nearest-rank percentile for positive, finite latency samples. */
+export function billingMeterPercentile(samples, percentile) {
+    if (samples.length === 0)
+        throw new Error('billing meter percentile requires at least one latency');
+    if (!Number.isFinite(percentile) || percentile <= 0 || percentile > 1) {
+        throw new Error('billing meter percentile must be greater than zero and at most one');
+    }
+    const sorted = samples.map(validateLatency).sort((left, right) => left - right);
+    const index = Math.max(0, Math.ceil(percentile * sorted.length) - 1);
+    const value = sorted[index];
+    if (value === undefined)
+        throw new Error('billing meter percentile could not be calculated');
+    return value;
+}
+function validateScenario(result) {
+    for (const [name, value] of Object.entries({
+        attempted: result.attempted,
+        recorded: result.recorded,
+        duplicates: result.duplicates,
+    })) {
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new Error(`billing meter capacity ${name} must be a non-negative safe integer`);
+        }
+    }
+    for (const [name, value] of Object.entries({
+        durationMs: result.durationMs,
+        throughputPerSecond: result.throughputPerSecond,
+        p95Ms: result.p95Ms,
+        p99Ms: result.p99Ms,
+    })) {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new Error(`billing meter capacity ${name} must be non-negative and finite`);
+        }
+    }
+}
+function validateLatency(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error('billing meter latency must be non-negative and finite');
+    }
+    return value;
+}
+function roundForPresentation(value) {
+    return Math.round(value * 100) / 100;
+}
+function bytesPerEvent(relation, recordedEvents) {
+    const validated = validateRelationStorage(relation);
+    return relationWithTotal({
+        tableBytes: roundStorageBytesUp(validated.tableBytes / recordedEvents),
+        indexBytes: roundStorageBytesUp(validated.indexBytes / recordedEvents),
+    });
+}
+function retainedStorageProjection(plan, monthlyCalls, measured) {
+    const peakRetainedReceiptRows = monthlyCalls * BILLING_METER_PEAK_RETAINED_COHORTS.receipts;
+    const peakRetainedExactKeyTombstoneRows = monthlyCalls * BILLING_METER_PEAK_RETAINED_COHORTS.exactKeyTombstones;
+    const receipts = projectedRelation(measured.receipts, peakRetainedReceiptRows);
+    const exactKeyTombstones = projectedRelation(measured.exactKeyTombstones, peakRetainedExactKeyTombstoneRows);
+    const combinedBytes = receipts.totalBytes + exactKeyTombstones.totalBytes;
+    if (!Number.isSafeInteger(combinedBytes)) {
+        throw new Error('billing meter storage projection exceeds the safe integer range');
+    }
+    return {
+        plan,
+        monthlyCalls,
+        peakRetainedReceiptRows,
+        peakRetainedExactKeyTombstoneRows,
+        receipts,
+        exactKeyTombstones,
+        combinedBytes,
+    };
+}
+function projectedRelation(bytes, rows) {
+    return relationWithTotal({
+        tableBytes: safeProjectedBytes(bytes.tableBytes, rows),
+        indexBytes: safeProjectedBytes(bytes.indexBytes, rows),
+    });
+}
+function safeProjectedBytes(bytesPerRow, rows) {
+    const result = Math.ceil(bytesPerRow * rows);
+    if (!Number.isSafeInteger(result) || result < 0) {
+        throw new Error('billing meter storage projection exceeds the safe integer range');
+    }
+    return result;
+}
+function validateRelationStorage(relation) {
+    for (const value of [relation.tableBytes, relation.indexBytes]) {
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new Error('billing meter relation bytes must be a non-negative safe integer');
+        }
+    }
+    return relation;
+}
+function relationWithTotal(relation) {
+    const totalBytes = roundStorageBytes(relation.tableBytes + relation.indexBytes);
+    if (!Number.isFinite(totalBytes) || totalBytes < 0) {
+        throw new Error('billing meter relation total bytes must be non-negative and finite');
+    }
+    return { ...relation, totalBytes };
+}
+function roundStorageBytesUp(value) {
+    if (Number.isSafeInteger(value))
+        return value;
+    return Math.ceil(value * 1_000_000) / 1_000_000;
+}
+function roundStorageBytes(value) {
+    if (Number.isSafeInteger(value))
+        return value;
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+//# sourceMappingURL=meter-capacity.js.map

package/node_modules/@noodle-borg/service/dist/billing/meter-capacity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-capacity.js","sourceRoot":"","sources":["../../src/billing/meter-capacity.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gDAAgD,EAChD,oCAAoC,GACrC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,0BAA0B,EAAE,GAAG;IAC/B,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,GAAG;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,WAAW;CACV,CAAC;AAEX,MAAM,mCAAmC,GAAG;IAC1C,QAAQ,EAAE,CAAC;IACX,kBAAkB,EAAE,CAAC;CACb,CAAC;AAgEX,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,eAAe,CAAU,CAAC;AAE5D,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAC1C,OAAsD;IAEtD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,MAAM,KAAK,SAAS;YAAE,SAAS;QACnC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,MAAM,CAAC,mBAAmB,GAAG,6BAA6B,CAAC,0BAA0B,EAAE,CAAC;YAC1F,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,0BAA0B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,GAAG,6BAA6B,CAAC,YAAY,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,GAAG,6BAA6B,CAAC,YAAY,EAAE,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,mBAAmB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC1F,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mCAAmC,CACjD,MAA0C;IAE1C,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO;QACL,GAAG,MAAM;QACT,UAAU,EAAE,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC;QACnD,mBAAmB,EAAE,oBAAoB,CAAC,MAAM,CAAC,mBAAmB,CAAC;QACrE,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC;QACzC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAiC,EACjC,cAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,QAAQ,GAAG;QACf,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC;QACxD,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,CAAC;QAC5E,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC;QACpE,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC;QAC5D,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC;KACjE,CAAC;IACF,MAAM,oBAAoB,GAAG,iBAAiB,CAC5C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU;QAClD,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU;KACnD,CAAC,EACF,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CACjC,CACF,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,EAAE,CAChG,yBAAyB,CACvB,IAAqD,EACrD,YAAY,EACZ,QAAQ,CACT,CACF,CAAC;IACF,OAAO;QACL,oBAAoB,EAAE,cAAc;QACpC,gBAAgB,EAAE,kBAAkB;QACpC,oBAAoB,EAAE,oCAAoC;QAC1D,8BAA8B,EAAE,gDAAgD;QAChF,6BAA6B,EAAE,EAAE,GAAG,QAAQ,EAAE,oBAAoB,EAAE;QACpE,WAAW;QACX,gBAAgB,EAAE;YAChB,KAAK,EAAE,wBAAwB;YAC/B,oBAAoB,EAAE,0BAA0B;YAChD,MAAM,EACJ,4NAA4N;SAC/N;KACF,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,OAA0B,EAAE,UAAkB;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA0C;IAClE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,EAAE,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,sCAAsC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;QAC/C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,EAAE,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,kCAAkC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC;AAED,SAAS,aAAa,CACpB,QAAqC,EACrC,cAAsB;IAEtB,MAAM,SAAS,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACpD,OAAO,iBAAiB,CAAC;QACvB,UAAU,EAAE,mBAAmB,CAAC,SAAS,CAAC,UAAU,GAAG,cAAc,CAAC;QACtE,UAAU,EAAE,mBAAmB,CAAC,SAAS,CAAC,UAAU,GAAG,cAAc,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAChC,IAAmD,EACnD,YAAoB,EACpB,QAGC;IAED,MAAM,uBAAuB,GAAG,YAAY,GAAG,mCAAmC,CAAC,QAAQ,CAAC;IAC5F,MAAM,iCAAiC,GACrC,YAAY,GAAG,mCAAmC,CAAC,kBAAkB,CAAC;IACxE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IAC/E,MAAM,kBAAkB,GAAG,iBAAiB,CAC1C,QAAQ,CAAC,kBAAkB,EAC3B,iCAAiC,CAClC,CAAC;IACF,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,uBAAuB;QACvB,iCAAiC;QACjC,QAAQ;QACR,kBAAkB;QAClB,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,KAA2C,EAC3C,IAAY;IAEZ,OAAO,iBAAiB,CAAC;QACvB,UAAU,EAAE,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC;QACtD,UAAU,EAAE,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC;KACvD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB,EAAE,IAAY;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,uBAAuB,CAC9B,QAAqC;IAErC,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CACxB,QAAqC;IAErC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AACnD,CAAC"}

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation-contract.d.ts

@@ -0,0 +1,8 @@
+import type { BillingMeterLiveValidationRecordInput, BillingMeterWriterHealthSnapshot, BillingMeterWriterSessionIdentity } from './meter-live-validation.js';
+import type { BillingMeterValidationEpochPrepareBindings } from './postgres-meter-epochs.js';
+import type { BillingMeterValidationRecordInput } from './postgres-meter-validation.js';
+export declare function normalizeBillingMeterLiveValidationInput(input: BillingMeterLiveValidationRecordInput): Omit<BillingMeterValidationRecordInput, 'epochId'>;
+export declare function normalizeBillingMeterWriterSessionIdentity(input: BillingMeterWriterSessionIdentity): BillingMeterWriterSessionIdentity;
+export declare function normalizeBillingMeterValidationEpochBindings(input: BillingMeterValidationEpochPrepareBindings): BillingMeterValidationEpochPrepareBindings;
+export declare function normalizeBillingMeterWriterHealthSnapshot(input: BillingMeterWriterHealthSnapshot, expected: BillingMeterWriterSessionIdentity): BillingMeterWriterHealthSnapshot;
+//# sourceMappingURL=meter-live-validation-contract.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter-live-validation-contract.d.ts","sourceRoot":"","sources":["../../src/billing/meter-live-validation-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAGxF,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,qCAAqC,GAC3C,IAAI,CAAC,iCAAiC,EAAE,SAAS,CAAC,CAwBpD;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,iCAAiC,GACvC,iCAAiC,CAcnC;AAED,wBAAgB,4CAA4C,CAC1D,KAAK,EAAE,0CAA0C,GAChD,0CAA0C,CAa5C;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,gCAAgC,EACvC,QAAQ,EAAE,iCAAiC,GAC1C,gCAAgC,CAuClC"}

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation-contract.js

@@ -0,0 +1,93 @@
+import { validateSlug } from '../store/validate.js';
+import { validateScalarId } from './postgres-records.js';
+export function normalizeBillingMeterLiveValidationInput(input) {
+    return {
+        classification: input.classification,
+        org: validateSlug('org', input.org),
+        app: validateSlug('app', input.app),
+        environment: validateSlug('env', input.environment),
+        deploymentId: validateScalarId('billing meter deployment id', input.deploymentId),
+        ...(input.identity.highConfidenceKeyHash === undefined
+            ? {}
+            : {
+                highConfidenceKeyHash: validateFingerprint('billing meter high-confidence key', input.identity.highConfidenceKeyHash),
+            }),
+        fallbackFingerprint: validateFingerprint('billing meter fallback fingerprint', input.identity.fallbackFingerprint),
+        semanticFingerprint: validateFingerprint('billing meter semantic fingerprint', input.identity.semanticFingerprint),
+    };
+}
+export function normalizeBillingMeterWriterSessionIdentity(input) {
+    return {
+        sessionId: validateScalarId('billing meter writer session id', input.sessionId),
+        releaseSha: validateReleaseSha(input.releaseSha),
+        keyGeneration: validateFingerprint('billing meter writer key generation', input.keyGeneration),
+        retryIdentityVersion: validatePositiveVersion('billing meter retry identity version', input.retryIdentityVersion),
+        writerContractVersion: validatePositiveVersion('billing meter writer contract version', input.writerContractVersion),
+    };
+}
+export function normalizeBillingMeterValidationEpochBindings(input) {
+    return {
+        keyGeneration: validateFingerprint('billing meter epoch key generation', input.keyGeneration),
+        releaseSha: validateReleaseSha(input.releaseSha),
+        retryIdentityVersion: validatePositiveVersion('billing meter epoch retry identity version', input.retryIdentityVersion),
+        writerContractVersion: validatePositiveVersion('billing meter epoch writer contract version', input.writerContractVersion),
+    };
+}
+export function normalizeBillingMeterWriterHealthSnapshot(input, expected) {
+    const identity = normalizeBillingMeterWriterSessionIdentity(input);
+    if (!sameIdentity(identity, expected)) {
+        throw new Error('billing meter writer health identity does not match its session');
+    }
+    const snapshot = { ...input, ...identity };
+    for (const [name, value] of Object.entries(snapshot)) {
+        if (name !== 'sessionId' &&
+            name !== 'releaseSha' &&
+            name !== 'keyGeneration' &&
+            name !== 'retryIdentityVersion' &&
+            name !== 'writerContractVersion' &&
+            (!Number.isSafeInteger(value) || value < 0)) {
+            throw new Error(`billing meter writer ${name} must be a non-negative safe integer`);
+        }
+    }
+    if (snapshot.observedCalls !==
+        snapshot.attemptedWrites +
+            snapshot.circuitOpenSkips +
+            snapshot.saturationSkips +
+            snapshot.derivationFailures) {
+        throw new Error('billing meter writer observed-call counters are inconsistent');
+    }
+    if (snapshot.attemptedWrites !==
+        snapshot.recordedWrites +
+            snapshot.duplicateWrites +
+            snapshot.finalFailures +
+            snapshot.noEpochSkips +
+            snapshot.epochIdentityFailures +
+            snapshot.inFlightWrites) {
+        throw new Error('billing meter writer attempted-write counters are inconsistent');
+    }
+    return snapshot;
+}
+function sameIdentity(left, right) {
+    return (left.sessionId === right.sessionId &&
+        left.releaseSha === right.releaseSha &&
+        left.keyGeneration === right.keyGeneration &&
+        left.retryIdentityVersion === right.retryIdentityVersion &&
+        left.writerContractVersion === right.writerContractVersion);
+}
+function validateFingerprint(name, value) {
+    if (!/^[0-9a-f]{64}$/.test(value))
+        throw new Error(`${name} must be a SHA-256 digest`);
+    return value;
+}
+function validateReleaseSha(value) {
+    if (!/^[0-9a-f]{40}$/.test(value)) {
+        throw new Error('billing meter writer release SHA must be a full 40-character commit digest');
+    }
+    return value;
+}
+function validatePositiveVersion(name, value) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new Error(`${name} must be positive`);
+    return value;
+}
+//# sourceMappingURL=meter-live-validation-contract.js.map

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation-contract.js.map

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

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation.d.ts

@@ -0,0 +1,76 @@
+import type { HostedToolDispatchContext, Logger } from '@noodle-borg/transport-http';
+import type { BillingMeterValidationClassification } from './postgres-meter-validation.js';
+import { type BillingUsageDispatchIdentity } from './usage-identity.js';
+import type { BillingUsageObserver } from './usage-observer.js';
+export interface BillingMeterWriterSessionIdentity {
+    readonly sessionId: string;
+    readonly releaseSha: string;
+    readonly keyGeneration: string;
+    readonly retryIdentityVersion: number;
+    readonly writerContractVersion: number;
+}
+export interface BillingMeterWriterHealthSnapshot extends BillingMeterWriterSessionIdentity {
+    readonly reportVersion: number;
+    readonly observedCalls: number;
+    readonly attemptedWrites: number;
+    readonly recordedWrites: number;
+    readonly duplicateWrites: number;
+    readonly finalFailures: number;
+    readonly noEpochSkips: number;
+    readonly circuitOpenSkips: number;
+    readonly saturationSkips: number;
+    readonly derivationFailures: number;
+    readonly epochIdentityFailures: number;
+    /** Sticky uncertainty evidence. A later committed receipt does not decrement this counter. */
+    readonly timeoutUnknownOutcomes: number;
+    readonly inFlightWrites: number;
+}
+export interface BillingMeterLiveValidationRecordInput {
+    readonly classification: BillingMeterValidationClassification;
+    readonly org: string;
+    readonly app: string;
+    readonly environment: string;
+    readonly deploymentId: string;
+    readonly identity: BillingUsageDispatchIdentity;
+}
+export type BillingMeterLiveValidationRecordResult = {
+    readonly outcome: 'recorded' | 'duplicate';
+} | {
+    readonly outcome: 'no_prepared_epoch' | 'identity_mismatch';
+};
+export interface BillingMeterLiveValidationWriter {
+    readonly session: BillingMeterWriterSessionIdentity;
+    record(input: BillingMeterLiveValidationRecordInput): Promise<BillingMeterLiveValidationRecordResult>;
+    /** Persist a monotonic absolute snapshot; an unarmed epoch requests an exact local fence. */
+    reportHealth(snapshot: BillingMeterWriterHealthSnapshot): Promise<undefined | {
+        readonly armEpochId: string;
+    }>;
+    /** Persist the exact drained snapshot as this writer's zero point for one prepared epoch. */
+    armEpoch?(epochId: string, snapshot: BillingMeterWriterHealthSnapshot): Promise<void>;
+    /** A clean close requires no in-flight write. */
+    close(snapshot: BillingMeterWriterHealthSnapshot): Promise<void>;
+}
+export type BillingMeterShadowSink = (context: HostedToolDispatchContext, identity: BillingUsageDispatchIdentity) => Promise<void>;
+export interface BillingMeterValidationMirror {
+    readonly observe: BillingUsageObserver;
+    snapshot(): BillingMeterWriterHealthSnapshot;
+    reportHealth(): Promise<void>;
+    close(): Promise<void>;
+}
+export interface BillingMeterValidationMirrorOptions {
+    readonly hmacKey: string;
+    readonly shadowSink?: BillingMeterShadowSink;
+    readonly writer: BillingMeterLiveValidationWriter;
+    readonly maxWaitMs?: number;
+    readonly maxConcurrentWrites?: number;
+    readonly failureCooldownMs?: number;
+    readonly shutdownDrainMs?: number;
+    readonly logger: Logger;
+}
+/**
+ * Mirror the final hosted tool-dispatch boundary into v1 shadow and the prepared v2 validation epoch.
+ * Both sinks are observational: every local, timeout, saturation, or database outcome still allows the
+ * connector exactly as before.
+ */
+export declare function createBillingMeterValidationMirror(options: BillingMeterValidationMirrorOptions): BillingMeterValidationMirror;
+//# sourceMappingURL=meter-live-validation.d.ts.map

package/node_modules/@noodle-borg/service/dist/billing/meter-live-validation.d.ts.map

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