@jinn-network/client 0.1.1 → 0.1.2-canary.6237288d

package/dist/restorer/impls/legacy-claude/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * legacy-claude — RestorerImpl fallback for spec=undefined (health-check) intents.
+ *
+ * Wraps the existing ClaudeRunner so that intents with no spec.kind continue to
+ * work via the RestorationEngine. Registered as the default fallback in the impl
+ * registry (supports spec.kind === '').
+ *
+ * The engine calls findFor({ kind: '' }) for legacy intents because
+ * PersistedIntent.specKind is null → coerced to '' in runImpl().
+ */
+import { type Runner } from '../../../runner/runner.js';
+import type { RestorerImpl, RestorationContext, RestorationOutput, ReadyStatus, EnableResult, IntentEnableMetadata } from '../../types.js';
+export interface LegacyClaudeConfig {
+    runner: Runner;
+    /** Passed to RunnerContext. Defaults to /tmp */
+    workingDirectory?: string;
+    /** Timeout in ms passed to runner. Defaults to 300000 */
+    timeoutMs?: number;
+    /** Passed to runner for artifact storage */
+    storePath?: string;
+    /** Daemon API URL for MCP server */
+    daemonApiUrl?: string;
+    /**
+     * When true (e.g. synthetic registry), `isReady` reports the daemon is required.
+     * Production daemon should omit.
+     */
+    stub?: boolean;
+}
+export declare class LegacyClaudeImpl implements RestorerImpl {
+    private readonly config;
+    readonly name = "legacy-claude";
+    readonly version = "1.0.0";
+    constructor(config: LegacyClaudeConfig);
+    /**
+     * Supports the empty-string kind produced by the engine for intents with no spec.
+     * Legacy release-acceptance jobs use no spec for both restoration and evaluation,
+     * so both phases route through the Claude runner.
+     */
+    supports(ctx: {
+        kind: string;
+        type?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt(): Promise<{
+        ok: true;
+    }>;
+    isReady(): Promise<ReadyStatus>;
+    enableMetadata(): IntentEnableMetadata;
+    onEnable(_args: Record<string, string | undefined>): Promise<EnableResult>;
+    run(ctx: RestorationContext): Promise<RestorationOutput>;
+    private recoverPublishedArtifact;
+}
+export default LegacyClaudeImpl;

package/dist/restorer/impls/legacy-claude/index.js

@@ -0,0 +1,140 @@
+/**
+ * legacy-claude — RestorerImpl fallback for spec=undefined (health-check) intents.
+ *
+ * Wraps the existing ClaudeRunner so that intents with no spec.kind continue to
+ * work via the RestorationEngine. Registered as the default fallback in the impl
+ * registry (supports spec.kind === '').
+ *
+ * The engine calls findFor({ kind: '' }) for legacy intents because
+ * PersistedIntent.specKind is null → coerced to '' in runImpl().
+ */
+import { REQUIRES_LIVE_DAEMON_READINESS, SkippableError } from '../../types.js';
+import { Store } from '../../../store/store.js';
+// ── Impl ──────────────────────────────────────────────────────────────────────
+export class LegacyClaudeImpl {
+    config;
+    name = 'legacy-claude';
+    version = '1.0.0';
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Supports the empty-string kind produced by the engine for intents with no spec.
+     * Legacy release-acceptance jobs use no spec for both restoration and evaluation,
+     * so both phases route through the Claude runner.
+     */
+    supports(ctx) {
+        return ctx.kind === '' || ctx.kind === 'legacy';
+    }
+    async canAttempt() {
+        return { ok: true };
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    enableMetadata() {
+        return {
+            description: 'legacy-claude — handles health-check intents (no spec.kind). Always enabled.',
+        };
+    }
+    async onEnable(_args) {
+        return { status: 'ready' };
+    }
+    async run(ctx) {
+        const { intent, workingDir, log } = ctx;
+        log({ level: 'info', msg: 'legacy-claude: starting', data: { requestId: intent.id } });
+        const runnerCtx = {
+            requestId: intent.id,
+            workingDirectory: workingDir ?? this.config.workingDirectory ?? '/tmp',
+            timeoutMs: this.config.timeoutMs ?? 300_000,
+            storePath: this.config.storePath,
+            daemonApiUrl: this.config.daemonApiUrl,
+        };
+        let result;
+        try {
+            result = await this.config.runner.run(intent, runnerCtx);
+        }
+        catch (err) {
+            if (isClaudeUnavailableError(err)) {
+                const detail = err instanceof Error ? err.message : String(err);
+                throw new SkippableError('claude_unavailable', detail);
+            }
+            throw err;
+        }
+        const resultTag = intent.type === 'evaluation' ? 'evaluation-verdict' : 'restoration-result';
+        const recoveredData = result.data || await this.recoverPublishedArtifact(intent.id, resultTag);
+        const artifactCount = result.artifacts?.length ?? (recoveredData ? 1 : 0);
+        log({ level: 'info', msg: 'legacy-claude: runner completed', data: { hasData: !!recoveredData } });
+        const output = {
+            venueRef: { name: 'legacy' },
+            gating: {
+                result: recoveredData,
+            },
+            informational: {
+                runnerResult: recoveredData,
+                artifactCount,
+            },
+            artifacts: [],
+        };
+        return output;
+    }
+    async recoverPublishedArtifact(desiredStateId, tag) {
+        if (!this.config.storePath)
+            return '';
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+            const store = new Store(this.config.storePath);
+            try {
+                const [artifact] = store.searchArtifacts({
+                    desiredStateId,
+                    tags: [tag],
+                    limit: 1,
+                });
+                if (artifact?.content)
+                    return artifact.content;
+            }
+            finally {
+                store.close();
+            }
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        return '';
+    }
+}
+export default LegacyClaudeImpl;
+/**
+ * Narrow heuristic: only match phrases that unambiguously indicate the Claude
+ * CLI is unavailable (not logged in, quota exhausted, API key rejected).
+ * Mirrors the former engine-level check (jinn-mono-7ee.4).
+ */
+function isClaudeUnavailableError(err) {
+    const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+    const claudeSpecificPhrases = [
+        'claude auth',
+        'claude not authenticated',
+        'claude cli not found',
+        'claude: command not found',
+        'claude quota',
+        'claude rate limit',
+        'claude credit',
+        'anthropic api key',
+    ];
+    if (claudeSpecificPhrases.some((p) => msg.includes(p)))
+        return true;
+    if (msg.includes('claude')) {
+        const availabilityPhrases = [
+            'not logged in',
+            'please login',
+            'please log in',
+            'quota exhausted',
+            'quota exceeded',
+            'credit limit',
+            'invalid api key',
+            'api key not found',
+        ];
+        return availabilityPhrases.some((p) => msg.includes(p));
+    }
+    return false;
+}
+//# sourceMappingURL=index.js.map

package/dist/restorer/impls/legacy-claude/index.js.map

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

package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Canonical metric computation for portfolio.v0 — §7.6.
+ *
+ * Single source of truth shared by both the restorer and evaluator.
+ * Pure functions; no I/O.
+ */
+import type { HlFill } from '../../../venues/hyperliquid/types.js';
+/** A single point on the equity curve: [timestamp_ms, accountValue_as_number]. */
+export interface EquityPoint {
+    ts: number;
+    value: number;
+}
+/**
+ * Build an equity curve from the pre/post snapshot values and fills.
+ *
+ * Per §7.6: the curve is sampled at:
+ *   - preSnapshot.capturedAt (value = preSnapshot accountValue)
+ *   - every fill.time (value = inline equity; see note below)
+ *   - postSnapshot.capturedAt (value = postSnapshot accountValue)
+ *
+ * Note: HL does not return per-fill equity. The evaluator uses the
+ * pre/post accountValues and the fill timestamps as curve shape anchors.
+ * For drawdown calculation purposes the curve is:
+ *   pre-equity → (fills sorted by time but using pre/post values interpolated
+ *   between them) → post-equity.
+ *
+ * Actually §7.6 says "sampled at preSnapshot.capturedAt + every fill.time +
+ * postSnapshot.capturedAt". Since HL only provides point-in-time equity at
+ * pre/post (not at each fill), the canonical approach is to use linear
+ * interpolation between the pre and post equity values at each fill timestamp.
+ * This matches what the restorer can compute and is deterministic.
+ */
+export declare function equityCurve(preTs: number, preValue: number, postTs: number, postValue: number, fillTimes: number[]): EquityPoint[];
+/**
+ * Compute max drawdown percentage over an equity curve.
+ *
+ * Per §7.6:
+ *   Drawdown at P = 100 * (peak_so_far - equity_P) / peak_so_far
+ *   maxDrawdownPct = max over all P
+ *
+ * Returns 0 if the curve has fewer than 2 points or no drawdown.
+ */
+export declare function maxDrawdownPct(curve: EquityPoint[]): number;
+/**
+ * Compute equity return percentage.
+ *
+ * Per §7.6: 100 * (postValue - preValue) / preValue
+ *
+ * Returns 0 if preValue is 0.
+ */
+export declare function equityReturnPct(preValue: number, postValue: number): number;
+/**
+ * Count fills where closedPnl is non-zero.
+ *
+ * Per §7.6: count of fills where closedPnl != 0
+ *
+ * Parses as float to handle "0", "0.0", "0.00", "-0.0", "+0.0" etc.
+ * NaN (non-numeric input) and empty string are treated as not-closed (excluded).
+ */
+export declare function closedTradesCount(fills: HlFill[]): number;
+/**
+ * Compute traded notional multiple.
+ *
+ * Per §7.6: sum_i(|sz_i * px_i|) / preValue
+ *
+ * Returns 0 if preValue is 0.
+ */
+export declare function tradedNotionalMultiple(fills: HlFill[], preValue: number): number;

package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.js

@@ -0,0 +1,117 @@
+/**
+ * Canonical metric computation for portfolio.v0 — §7.6.
+ *
+ * Single source of truth shared by both the restorer and evaluator.
+ * Pure functions; no I/O.
+ */
+/**
+ * Build an equity curve from the pre/post snapshot values and fills.
+ *
+ * Per §7.6: the curve is sampled at:
+ *   - preSnapshot.capturedAt (value = preSnapshot accountValue)
+ *   - every fill.time (value = inline equity; see note below)
+ *   - postSnapshot.capturedAt (value = postSnapshot accountValue)
+ *
+ * Note: HL does not return per-fill equity. The evaluator uses the
+ * pre/post accountValues and the fill timestamps as curve shape anchors.
+ * For drawdown calculation purposes the curve is:
+ *   pre-equity → (fills sorted by time but using pre/post values interpolated
+ *   between them) → post-equity.
+ *
+ * Actually §7.6 says "sampled at preSnapshot.capturedAt + every fill.time +
+ * postSnapshot.capturedAt". Since HL only provides point-in-time equity at
+ * pre/post (not at each fill), the canonical approach is to use linear
+ * interpolation between the pre and post equity values at each fill timestamp.
+ * This matches what the restorer can compute and is deterministic.
+ */
+export function equityCurve(preTs, preValue, postTs, postValue, fillTimes) {
+    const points = [];
+    // Pre snapshot
+    points.push({ ts: preTs, value: preValue });
+    // Fill time points — linear interpolation between pre and post
+    const duration = postTs - preTs;
+    const sorted = [...fillTimes].sort((a, b) => a - b);
+    for (const ts of sorted) {
+        const clampedTs = Math.max(preTs, Math.min(postTs, ts));
+        const frac = duration > 0 ? (clampedTs - preTs) / duration : 0;
+        const value = preValue + frac * (postValue - preValue);
+        points.push({ ts: clampedTs, value });
+    }
+    // Post snapshot
+    points.push({ ts: postTs, value: postValue });
+    return points;
+}
+// ── maxDrawdownPct ────────────────────────────────────────────────────────────
+/**
+ * Compute max drawdown percentage over an equity curve.
+ *
+ * Per §7.6:
+ *   Drawdown at P = 100 * (peak_so_far - equity_P) / peak_so_far
+ *   maxDrawdownPct = max over all P
+ *
+ * Returns 0 if the curve has fewer than 2 points or no drawdown.
+ */
+export function maxDrawdownPct(curve) {
+    if (curve.length < 2)
+        return 0;
+    let peakSoFar = curve[0].value;
+    let maxDd = 0;
+    for (const point of curve) {
+        if (point.value > peakSoFar) {
+            peakSoFar = point.value;
+        }
+        if (peakSoFar > 0) {
+            const dd = (100 * (peakSoFar - point.value)) / peakSoFar;
+            if (dd > maxDd)
+                maxDd = dd;
+        }
+    }
+    return maxDd;
+}
+// ── equityReturnPct ───────────────────────────────────────────────────────────
+/**
+ * Compute equity return percentage.
+ *
+ * Per §7.6: 100 * (postValue - preValue) / preValue
+ *
+ * Returns 0 if preValue is 0.
+ */
+export function equityReturnPct(preValue, postValue) {
+    if (preValue === 0)
+        return 0;
+    return (100 * (postValue - preValue)) / preValue;
+}
+// ── closedTradesCount ─────────────────────────────────────────────────────────
+/**
+ * Count fills where closedPnl is non-zero.
+ *
+ * Per §7.6: count of fills where closedPnl != 0
+ *
+ * Parses as float to handle "0", "0.0", "0.00", "-0.0", "+0.0" etc.
+ * NaN (non-numeric input) and empty string are treated as not-closed (excluded).
+ */
+export function closedTradesCount(fills) {
+    return fills.filter((f) => {
+        const v = parseFloat(f.closedPnl);
+        return !isNaN(v) && v !== 0;
+    }).length;
+}
+// ── tradedNotionalMultiple ────────────────────────────────────────────────────
+/**
+ * Compute traded notional multiple.
+ *
+ * Per §7.6: sum_i(|sz_i * px_i|) / preValue
+ *
+ * Returns 0 if preValue is 0.
+ */
+export function tradedNotionalMultiple(fills, preValue) {
+    if (preValue === 0)
+        return 0;
+    const total = fills.reduce((acc, f) => {
+        const sz = parseFloat(f.sz);
+        const px = parseFloat(f.px);
+        return acc + Math.abs(sz * px);
+    }, 0);
+    return total / preValue;
+}
+//# sourceMappingURL=canonical-metrics.js.map

package/dist/restorer/impls/portfolio-v0-evaluator/canonical-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-metrics.js","sourceRoot":"","sources":["../../../../src/restorer/impls/portfolio-v0-evaluator/canonical-metrics.ts"],"names":[],"mappings":"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"}

package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Availability checks for portfolio.v0.eval — §7.4.
+ *
+ * availability.hyperliquid_reachable
+ * availability.hl_pre_snapshot_rederivable
+ * availability.hl_fills_rederivable
+ *
+ * FAIL in any of these → verdict INDETERMINATE per §7.3.
+ */
+import type { HlGridPoint } from '../../../../venues/hyperliquid/types.js';
+import type { Check } from '../types.js';
+/**
+ * Wraps a HL API call that should succeed if HL is reachable.
+ *
+ * Returns PASS if the call completes without throwing, FAIL otherwise.
+ */
+export declare function checkHlReachable(reachable: boolean, errorMsg?: string): Check;
+/**
+ * Check whether the pre-snapshot equity can be rederived from the portfolio
+ * grid. A bracket must exist around preTs.
+ *
+ * Returns PASS if a bracket is found, FAIL if the grid has no bracket.
+ */
+export declare function checkPreSnapshotRederivable(grid: HlGridPoint[], preTs: number): Check;
+/**
+ * Check whether fills could be fetched without clamping.
+ *
+ * If startTimeClamped is true, HL silently moved the retention horizon and
+ * fills are incomplete — FAIL.
+ */
+export declare function checkFillsRederivable(startTimeClamped: boolean): Check;
+/**
+ * Check whether the post-snapshot is rederivable (no funding accrual issue).
+ *
+ * Per §7.5: if postSnapshot.capturedAt > endTs + 60s, emit SKIP and
+ * downstream consistency checks should be skipped → INDETERMINATE.
+ *
+ * This check is named availability.hl_post_snapshot_rederivable and uses
+ * SKIP status to propagate INDETERMINATE via the derivation rule (SKIP ≠ FAIL
+ * for availability — a FAIL would cause INDETERMINATE, but SKIP means we
+ * surface it separately).
+ *
+ * However, per §7.3 the derivation rule is:
+ *   if any "availability.*" FAIL → INDETERMINATE
+ *
+ * A SKIP doesn't trigger INDETERMINATE via the rule, so the eval impl must
+ * handle this edge case explicitly by checking for SKIP in downstream checks.
+ */
+export declare function checkPostSnapshotFundingAccrual(postCapturedAt: number, endTs: number): Check;

package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.js

@@ -0,0 +1,91 @@
+/**
+ * Availability checks for portfolio.v0.eval — §7.4.
+ *
+ * availability.hyperliquid_reachable
+ * availability.hl_pre_snapshot_rederivable
+ * availability.hl_fills_rederivable
+ *
+ * FAIL in any of these → verdict INDETERMINATE per §7.3.
+ */
+import { bracketGridPoints } from '../../../../venues/hyperliquid/grid.js';
+// ── hyperliquid_reachable ─────────────────────────────────────────────────────
+/**
+ * Wraps a HL API call that should succeed if HL is reachable.
+ *
+ * Returns PASS if the call completes without throwing, FAIL otherwise.
+ */
+export function checkHlReachable(reachable, errorMsg) {
+    if (reachable) {
+        return { name: 'availability.hyperliquid_reachable', status: 'PASS' };
+    }
+    return {
+        name: 'availability.hyperliquid_reachable',
+        status: 'FAIL',
+        detail: errorMsg ?? 'Hyperliquid API is unreachable',
+    };
+}
+// ── hl_pre_snapshot_rederivable ───────────────────────────────────────────────
+/**
+ * Check whether the pre-snapshot equity can be rederived from the portfolio
+ * grid. A bracket must exist around preTs.
+ *
+ * Returns PASS if a bracket is found, FAIL if the grid has no bracket.
+ */
+export function checkPreSnapshotRederivable(grid, preTs) {
+    const bracket = bracketGridPoints(grid, preTs);
+    if (bracket !== null) {
+        return { name: 'availability.hl_pre_snapshot_rederivable', status: 'PASS' };
+    }
+    return {
+        name: 'availability.hl_pre_snapshot_rederivable',
+        status: 'FAIL',
+        detail: `No grid bracket found for preTs=${preTs}`,
+    };
+}
+// ── hl_fills_rederivable ──────────────────────────────────────────────────────
+/**
+ * Check whether fills could be fetched without clamping.
+ *
+ * If startTimeClamped is true, HL silently moved the retention horizon and
+ * fills are incomplete — FAIL.
+ */
+export function checkFillsRederivable(startTimeClamped) {
+    if (!startTimeClamped) {
+        return { name: 'availability.hl_fills_rederivable', status: 'PASS' };
+    }
+    return {
+        name: 'availability.hl_fills_rederivable',
+        status: 'FAIL',
+        detail: 'HL userFillsByTime startTime was clamped to retention horizon — fills are incomplete',
+    };
+}
+// ── Post-snapshot funding-accrual edge case ───────────────────────────────────
+/**
+ * Check whether the post-snapshot is rederivable (no funding accrual issue).
+ *
+ * Per §7.5: if postSnapshot.capturedAt > endTs + 60s, emit SKIP and
+ * downstream consistency checks should be skipped → INDETERMINATE.
+ *
+ * This check is named availability.hl_post_snapshot_rederivable and uses
+ * SKIP status to propagate INDETERMINATE via the derivation rule (SKIP ≠ FAIL
+ * for availability — a FAIL would cause INDETERMINATE, but SKIP means we
+ * surface it separately).
+ *
+ * However, per §7.3 the derivation rule is:
+ *   if any "availability.*" FAIL → INDETERMINATE
+ *
+ * A SKIP doesn't trigger INDETERMINATE via the rule, so the eval impl must
+ * handle this edge case explicitly by checking for SKIP in downstream checks.
+ */
+export function checkPostSnapshotFundingAccrual(postCapturedAt, endTs) {
+    const threshold = endTs + 60_000; // 60 seconds
+    if (postCapturedAt > threshold) {
+        return {
+            name: 'availability.hl_post_snapshot_rederivable',
+            status: 'SKIP',
+            detail: `postSnapshot.capturedAt (${postCapturedAt}) > endTs+60s (${threshold}) — funding may have accrued`,
+        };
+    }
+    return { name: 'availability.hl_post_snapshot_rederivable', status: 'PASS' };
+}
+//# sourceMappingURL=availability.js.map

package/dist/restorer/impls/portfolio-v0-evaluator/checks/availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../../../../src/restorer/impls/portfolio-v0-evaluator/checks/availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB,EAAE,QAAiB;IACpE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,oCAAoC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACxE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,oCAAoC;QAC1C,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,QAAQ,IAAI,gCAAgC;KACrD,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAmB,EACnB,KAAa;IAEb,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,0CAA0C,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,IAAI,EAAE,0CAA0C;QAChD,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,mCAAmC,KAAK,EAAE;KACnD,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,gBAAyB;IAC7D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,mCAAmC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,sFAAsF;KAC/F,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,cAAsB,EACtB,KAAa;IAEb,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,aAAa;IAC/C,IAAI,cAAc,GAAG,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,2CAA2C;YACjD,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,4BAA4B,cAAc,kBAAkB,SAAS,8BAA8B;SAC5G,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,2CAA2C,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC/E,CAAC"}

package/dist/restorer/impls/portfolio-v0-evaluator/checks/consistency.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Consistency checks for portfolio.v0.eval — §7.4.
+ *
+ * consistency.pre_snapshot
+ * consistency.post_snapshot
+ * consistency.fills              (set match by tid; per-fill fields exact)
+ * consistency.gating.equity_return
+ * consistency.gating.max_drawdown
+ * consistency.gating.closed_trades
+ * consistency.gating.traded_notional
+ *
+ * FAIL in any consistency.* check → verdict FAIL per §7.3.
+ *
+ * Tolerance rules per §7.5:
+ *   Snapshot decimal fields: 0.01% relative OR 0.0001 USD absolute (whichever greater)
+ *   Per-fill HL fields: exact
+ *   Fills set membership (by tid): exact
+ *   equityReturnPct, maxDrawdownPct: 0.05% absolute
+ *   closedTradesCount: exact
+ *   tradedNotionalMultiple: 0.05% relative
+ */
+import type { HlFill } from '../../../../venues/hyperliquid/types.js';
+import type { Check } from '../types.js';
+/**
+ * Extract the canonical accountValue from a snapshot payload.
+ *
+ * Supports two shapes:
+ *   1. Legacy: `{ marginSummary: { accountValue } }` (HL's raw clearinghouseState).
+ *   2. Unified (current restorer): `{ accountValue, clearinghouseState, spotClearinghouseState, ... }`
+ *      — top-level `accountValue` is perps margin + spot USDC, matching HL's
+ *      `portfolio` endpoint unified equity.
+ */
+export declare function extractAccountValue(payload: unknown): number | null;
+/**
+ * Check pre-snapshot consistency.
+ *
+ * Compares accountValue between claimed and rederived pre-snapshot.
+ * If either snapshot lacks a parseable accountValue, SKIP (not enough data).
+ */
+export declare function checkPreSnapshot(claimedPayload: unknown, rederived: {
+    capturedAt: number;
+    payload: unknown;
+} | null): Check;
+/**
+ * Check post-snapshot consistency.
+ *
+ * Compares accountValue between claimed and rederived post-snapshot.
+ * If postSnapshot rederivation was skipped (funding accrual), SKIP.
+ */
+export declare function checkPostSnapshot(claimedPayload: unknown, rederived: {
+    capturedAt: number;
+    payload: unknown;
+} | null): Check;
+/**
+ * Check fills consistency: set membership by tid (exact), and per-fill field
+ * equality for px, sz, time, fee, closedPnl.
+ */
+export declare function checkFills(claimedFills: unknown[], rederived: HlFill[]): Check;
+/**
+ * Check consistency of equityReturnPct (claimed vs rederived).
+ * Tolerance: 0.05% absolute.
+ */
+export declare function checkGatingEquityReturn(claimed: string, rederived: number): Check;
+/**
+ * Check consistency of maxDrawdownPct (claimed vs rederived).
+ * Tolerance: 0.05% absolute.
+ */
+export declare function checkGatingMaxDrawdown(claimed: string, rederived: number): Check;
+/**
+ * Check consistency of closedTradesCount (claimed vs rederived).
+ * Tolerance: exact.
+ */
+export declare function checkGatingClosedTrades(claimed: number, rederived: number): Check;
+/**
+ * Check consistency of tradedNotionalMultiple (claimed vs rederived).
+ * Tolerance: 0.05% relative.
+ */
+export declare function checkGatingTradedNotional(claimed: string, rederived: number): Check;