@jinn-network/client 0.1.1 → 0.1.2-canary.d6e72dfd

package/dist/restorer/impls/claude-mcp-prediction/session-orchestrator.js

@@ -0,0 +1,137 @@
+/**
+ * Session orchestrator for claude-mcp-prediction.
+ *
+ * Single-session (no cadence loop, no market-move triggers). Spawns Claude
+ * once with the prediction MCP + prompt, polls a shared "submitted" flag to
+ * detect `submit_prediction` tool call, and terminates after a short grace
+ * period so Claude's tool response reaches it.
+ *
+ * Slimmed-down version of:
+ *   client/src/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
+ */
+import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+const DEFAULT_SESSION_MAX_MS = 180_000;
+const DEFAULT_POLL_INTERVAL_MS = 500;
+const DEFAULT_SUBMISSION_GRACE_MS = 2_000;
+export async function spawnSession(sessionId, prompt, deps) {
+    const sessionMaxMs = deps.sessionMaxMs ?? DEFAULT_SESSION_MAX_MS;
+    const pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const submissionGraceMs = deps.submissionGraceMs ?? DEFAULT_SUBMISSION_GRACE_MS;
+    const sessionDir = join(deps.workingDir, 'sessions', sessionId);
+    mkdirSync(sessionDir, { recursive: true });
+    const transcriptPath = join(sessionDir, 'transcript.txt');
+    const startedAt = Date.now();
+    writeFileSync(transcriptPath, `=== Session ${sessionId} started at ${new Date(startedAt).toISOString()} ===\n\n`);
+    const args = [
+        '-p', prompt,
+        '--mcp-config', deps.mcpConfigPath,
+        '--strict-mcp-config',
+        '--allowedTools', 'mcp__jinn-prediction__*',
+    ];
+    if (deps.claudeModel)
+        args.push('--model', deps.claudeModel);
+    // Minimal env allowlist — same set as the HL orchestrator.
+    const agentEnv = {};
+    for (const key of [
+        'PATH', 'HOME', 'USER', 'SHELL', 'LANG', 'TERM', 'TMPDIR',
+        'XDG_CONFIG_HOME', 'XDG_DATA_HOME', 'XDG_CACHE_HOME',
+        'NODE_PATH', 'NODE_OPTIONS', 'NPM_CONFIG_PREFIX',
+        // Anthropic auth — required for Claude Code to reach the model.
+        'CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY',
+    ]) {
+        if (process.env[key])
+            agentEnv[key] = process.env[key];
+    }
+    deps.log({ level: 'info', msg: `prediction-session: spawning ${sessionId}`, data: { claudePath: deps.claudePath } });
+    const spawnFn = deps._spawnFn ?? spawn;
+    return new Promise((resolve) => {
+        const child = spawnFn(deps.claudePath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: agentEnv,
+        });
+        let stdout = '';
+        let aborted = false;
+        let terminatedEarly = false;
+        child.stdout?.on('data', (d) => {
+            const chunk = d.toString();
+            stdout += chunk;
+            appendFileSync(transcriptPath, chunk);
+        });
+        child.stderr?.on('data', (d) => {
+            appendFileSync(transcriptPath, `[stderr] ${d.toString()}`);
+        });
+        const sessionTimeout = setTimeout(() => {
+            if (!child.killed) {
+                deps.log({ level: 'warn', msg: `prediction-session: ${sessionId} reached sessionMaxMs; killing`, data: { sessionMaxMs } });
+                child.kill('SIGTERM');
+            }
+        }, sessionMaxMs);
+        // Poll for submit_prediction: once the flag flips, give Claude a short grace
+        // window to receive the tool response + close the connection, then SIGTERM.
+        let graceTimer = null;
+        const pollTimer = setInterval(() => {
+            if (graceTimer || child.killed)
+                return;
+            if (deps.isSubmitted()) {
+                deps.log({ level: 'info', msg: `prediction-session: ${sessionId} submit_prediction invoked; scheduling graceful termination` });
+                terminatedEarly = true;
+                graceTimer = setTimeout(() => {
+                    if (!child.killed)
+                        child.kill('SIGTERM');
+                }, submissionGraceMs);
+            }
+        }, pollIntervalMs);
+        const onAbort = () => {
+            if (aborted)
+                return;
+            aborted = true;
+            deps.log({ level: 'info', msg: `prediction-session: ${sessionId} window abort; killing` });
+            child.kill('SIGTERM');
+        };
+        deps.abort.addEventListener('abort', onAbort);
+        const cleanup = () => {
+            clearTimeout(sessionTimeout);
+            if (graceTimer)
+                clearTimeout(graceTimer);
+            clearInterval(pollTimer);
+            deps.abort.removeEventListener('abort', onAbort);
+        };
+        child.on('exit', (code, signal) => {
+            cleanup();
+            const endedAt = Date.now();
+            appendFileSync(transcriptPath, `\n\n=== Session ended at ${new Date(endedAt).toISOString()} (code=${code} signal=${signal} submitted=${deps.isSubmitted()} terminatedEarly=${terminatedEarly} aborted=${aborted}) ===\n`);
+            deps.log({
+                level: 'info',
+                msg: `prediction-session: ${sessionId} exited`,
+                data: { code, signal, durationMs: endedAt - startedAt, submitted: deps.isSubmitted(), aborted },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: aborted || deps.abort.aborted,
+            });
+        });
+        child.on('error', (err) => {
+            cleanup();
+            const endedAt = Date.now();
+            appendFileSync(transcriptPath, `\n\n=== Session spawn error: ${err.message} ===\n`);
+            deps.log({ level: 'error', msg: `prediction-session: ${sessionId} spawn error`, data: { err: err.message } });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: deps.abort.aborted,
+            });
+        });
+    });
+}
+//# sourceMappingURL=session-orchestrator.js.map

package/dist/restorer/impls/claude-mcp-prediction/session-orchestrator.js.map

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

package/dist/restorer/impls/claude-mcp-prediction/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Types for claude-mcp-prediction — a RestorerImpl that spawns Claude with
+ * two MCP tools to decide a prediction.v0 probability.
+ */
+import type { PublicClient } from 'viem';
+export interface McpToolContent {
+    type: 'text';
+    text: string;
+}
+export interface McpToolResult {
+    content: McpToolContent[];
+}
+/** Discriminated union for the tool registry. Kept open to add future tools. */
+export interface PredictionToolDefinition {
+    name: string;
+    description: string;
+    /** Zod object schema — registered as the MCP input-schema shape. */
+    schema: import('zod').ZodObject<import('zod').ZodRawShape>;
+    handler: (args: unknown) => Promise<McpToolResult>;
+}
+export interface SubmissionState {
+    probability: string | null;
+    rationale: string | null;
+    submittedAt: number | null;
+}
+export interface PredictionToolDeps {
+    /** Chainlink AggregatorV3 proxy address the intent is anchored to. */
+    feed: `0x${string}`;
+    /** Human-readable feed description, echoed in tool responses. */
+    feedDescription: string;
+    /** Venue label — used to sanity-check in the tool response. */
+    venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    /** viem public client for reading the feed. */
+    publicClient: PublicClient;
+    /**
+     * Called when Claude invokes `submit_prediction`. The impl mutates its own
+     * SubmissionState via this callback and signals the orchestrator to terminate.
+     */
+    onSubmit: (submission: {
+        probability: string;
+        rationale: string;
+    }) => void;
+}
+export interface ClaudeMcpPredictionConfig {
+    rpcUrl?: string;
+    claudeModel?: string;
+    claudePath?: string;
+    /** Max wall time for the Claude session (ms). Default 3 min. */
+    sessionMaxMs?: number;
+    /** Injected deps for test mode — bypasses the real Claude spawn. */
+    _testDeps?: TestDeps;
+}
+export interface TestDeps {
+    /**
+     * Replacement for the real session spawn. Given the MCP config path + prompt,
+     * must eventually call the `onSubmit` callback registered on the tools
+     * (via in-process MCP, or by writing to the submission state directly).
+     *
+     * Minimum-viable mock: immediately invoke the submit callback passed in ctx,
+     * then return a stub SessionResult.
+     */
+    runSession?: (args: {
+        sessionId: string;
+        prompt: string;
+        mcpConfigPath: string;
+        workingDir: string;
+        implStateDir: string;
+        timeoutMs: number;
+        signalSubmit: (probability: string, rationale: string) => void;
+    }) => Promise<SessionResult>;
+}
+export interface SessionResult {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    transcriptPath: string;
+    /** True iff `submit_prediction` was called before timeout/abort. */
+    submitted: boolean;
+    /** Accumulated stdout for post-mortem. */
+    stdout: string;
+    aborted: boolean;
+}

package/dist/restorer/impls/claude-mcp-prediction/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for claude-mcp-prediction — a RestorerImpl that spawns Claude with
+ * two MCP tools to decide a prediction.v0 probability.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/impls/claude-mcp-prediction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-mcp-prediction/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,45 @@
+/**
+ * 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;
+}
+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.
+     * Also supports explicitly undefined-kind intents routed by registry default config.
+     */
+    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>;
+}
+export default LegacyClaudeImpl;

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

@@ -0,0 +1,71 @@
+/**
+ * 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().
+ */
+// ── 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.
+     * Also supports explicitly undefined-kind intents routed by registry default config.
+     */
+    supports(ctx) {
+        // legacy-claude handles restoration-type health-check intents with no spec.kind.
+        // It never runs as an evaluator.
+        if (ctx.type === 'evaluation')
+            return false;
+        return ctx.kind === '' || ctx.kind === 'legacy';
+    }
+    async canAttempt() {
+        return { ok: true };
+    }
+    async isReady() {
+        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,
+        };
+        const result = await this.config.runner.run(intent, runnerCtx);
+        log({ level: 'info', msg: 'legacy-claude: runner completed', data: { hasData: !!result.data } });
+        const output = {
+            venueRef: { name: 'legacy' },
+            gating: {
+                result: result.data,
+            },
+            informational: {
+                runnerResult: result.data,
+                artifactCount: result.artifacts?.length ?? 0,
+            },
+            artifacts: [],
+        };
+        return output;
+    }
+}
+export default LegacyClaudeImpl;
+//# 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":"AAAA;;;;;;;;;GASG;AA0BH,iFAAiF;AAEjF,MAAM,OAAO,gBAAgB;IAIE;IAHpB,IAAI,GAAG,eAAe,CAAC;IACvB,OAAO,GAAG,OAAO,CAAC;IAE3B,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D;;;OAGG;IACH,QAAQ,CAAC,GAA0D;QACjE,iFAAiF;QACjF,iCAAiC;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,cAAc;QACZ,OAAO;YACL,WAAW,EACT,8EAA8E;SACjF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAyC;QACtD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAuB;QAC/B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;QAExC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,yBAAyB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAEvF,MAAM,SAAS,GAAkB;YAC/B,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,gBAAgB,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM;YACtE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO;YAC3C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;SACvC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE/D,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iCAAiC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEjG,MAAM,MAAM,GAAsB;YAChC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,MAAM,EAAE;gBACN,MAAM,EAAE,MAAM,CAAC,IAAI;aACpB;YACD,aAAa,EAAE;gBACb,YAAY,EAAE,MAAM,CAAC,IAAI;gBACzB,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;aAC7C;YACD,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,eAAe,gBAAgB,CAAC"}

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;