@oracle-agent/oracle 0.12.0 → 0.13.1

package/dist/bin/oracle-equities.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import{realpathSync as yt}from"node:fs";import{fileURLToPath as sr}from"node:url";var pr=Object.freeze({mantissa:10000n,scale:0});function F(e){if(!Number.isSafeInteger(e)||e<0||e>1e3)throw new RangeError("scale must be a safe integer from 0 through 1000")}function T(e,t){if(typeof e!="bigint")throw new TypeError("mantissa must be a bigint");return F(t),Object.freeze({mantissa:e,scale:t})}function _(e,t="value"){if(e===null||typeof e!="object")throw new TypeError(`${t} must be a fixed point value`);if(typeof e.mantissa!="bigint")throw new TypeError(`${t}.mantissa must be a bigint`);F(e.scale)}function Y(e){return F(e),10n**BigInt(e)}function f(e){if(typeof e!="string"||!/^[+-]?\d+(?:\.\d+)?$/.test(e))throw new TypeError("value must be a plain decimal string");let t=e.startsWith("-"),n=e[0]==="-"||e[0]==="+"?e.slice(1):e,[r,s=""]=n.split("."),o=`${r}${s}`,i=BigInt(o)*(t?-1n:1n);return T(i,s.length)}function $(e,t){if(F(t),typeof e=="bigint")return T(e,t);if(typeof e!="string"||!/^[+-]?\d+$/.test(e))throw new TypeError("value must be an integer string or bigint");return T(BigInt(e),t)}function S(e){_(e);let t=e.mantissa<0n,n=(t?-e.mantissa:e.mantissa).toString();if(e.scale===0)return`${t?"-":""}${n}`;let r=n.padStart(e.scale+1,"0"),s=r.length-e.scale;return`${t?"-":""}${r.slice(0,s)}.${r.slice(s)}`}function Q(e,t){return _(e),F(t),t===e.scale?T(e.mantissa,e.scale):t>e.scale?T(e.mantissa*Y(t-e.scale),t):T(e.mantissa/Y(e.scale-t),t)}function ce(e,t){_(e,"left"),_(t,"right");let n=Math.max(e.scale,t.scale);return[Q(e,n),Q(t,n),n]}function D(e,t){let[n,r,s]=ce(e,t);return T(n.mantissa+r.mantissa,s)}function W(e,t){let[n,r,s]=ce(e,t);return T(n.mantissa-r.mantissa,s)}function E(e,t){_(e,"left"),_(t,"right");let n=e.scale+t.scale;return F(n),T(e.mantissa*t.mantissa,n)}function R(e,t,n=Math.max(e?.scale??0,t?.scale??0)){if(_(e,"left"),_(t,"right"),F(n),t.mantissa===0n)throw new RangeError("division by zero");let r=e.mantissa*Y(t.scale+n),s=t.mantissa*Y(e.scale);return T(r/s,n)}function U(e,t){let[n,r]=ce(e,t);return n.mantissa<r.mantissa?-1:n.mantissa>r.mantissa?1:0}import{readFileSync as St}from"node:fs";import{fileURLToPath as $t}from"node:url";import{dirname as At,join as Te}from"node:path";var Et=Te(At($t(import.meta.url)),"fixtures"),Ne=Object.freeze({venues:"venues.json",universe:"universe.json",oracles:"oracles.json",nyseHolidays:"nyse_holidays.json",dstTransitions:"dst_transitions.json",equityDexPools:"equity_dex_pools.json",rhPoolState:"rh_pool_state.json",solanaXstocks:"solana_xstocks.json",tonXstocks:"ton_xstocks.json",hip3L2Books:"hip3_l2books.json"});function vt(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function d(e,t){throw new TypeError(`Fixture fixtures/${e}: ${t}`)}function k(e,t,n){vt(e)||d(t,`${n} must be an object`)}function m(e,t,n){(typeof e!="string"||e.length===0)&&d(t,`${n} must be a nonempty string`)}function N(e,t,n){Number.isSafeInteger(e)||d(t,`${n} must be a safe integer`)}function M(e,t,n){k(e,t,n);for(let[r,s]of Object.entries(e))m(r,t,`${n} key`),k(s,t,`${n}.${r}`)}function qt(e,t){k(e,t,"root"),N(e.capturedAt,t,"capturedAt"),k(e.venues,t,"venues");let n=[["hyperliquid_hip3","dexs"],["arcus","markets"],["arcus_spot","pairs"],["rh_uniswap","pools"],["rh_chainlink_oracles","assets"]];for(let[r,s]of n){let o=e.venues[r];k(o,t,`venues.${r}`),m(o.type,t,`venues.${r}.type`),m(o.chain,t,`venues.${r}.chain`),m(o.tier,t,`venues.${r}.tier`),M(o[s],t,`venues.${r}.${s}`)}for(let[r,s]of Object.entries(e.venues.hyperliquid_hip3.dexs))M(s,t,`venues.hyperliquid_hip3.dexs.${r}`)}function Ot(e,t){M(e,t,"root"),Object.keys(e).length===0&&d(t,"root must not be empty");for(let[n,r]of Object.entries(e))Array.isArray(r.venues)||d(t,`${n}.venues must be an array`),r.venues.forEach((s,o)=>m(s,t,`${n}.venues[${o}]`))}function Rt(e,t){k(e,t,"root");for(let n of["chainId","block","oracleScaleExp","usdgDecimals","equityDecimals"])N(e[n],t,n);m(e.usdg,t,"usdg"),M(e.assets,t,"assets");for(let[n,r]of Object.entries(e.assets))m(r.oracle,t,`assets.${n}.oracle`),m(r.token,t,`assets.${n}.token`),(typeof r.rawPrice!="string"||!/^\d+$/.test(r.rawPrice))&&d(t,`assets.${n}.rawPrice must be an integer string`),(typeof r.usd!="number"||!Number.isFinite(r.usd)||r.usd<0)&&d(t,`assets.${n}.usd must be a nonnegative finite source number`)}function It(e,t){k(e,t,"root");for(let r of["holidayDayIndex","names","dates"])Array.isArray(e[r])||d(t,`${r} must be an array`);let n=e.holidayDayIndex.length;(e.names.length!==n||e.dates.length!==n)&&d(t,"holidayDayIndex, names, and dates must have equal lengths"),e.holidayDayIndex.forEach((r,s)=>N(r,t,`holidayDayIndex[${s}]`)),e.names.forEach((r,s)=>m(r,t,`names[${s}]`)),e.dates.forEach((r,s)=>{(typeof r!="string"||!/^\d{4}-\d{2}-\d{2}$/.test(r))&&d(t,`dates[${s}] must use YYYY-MM-DD`)})}function Tt(e,t){k(e,t,"root"),(!Array.isArray(e.dstTransitions)||e.dstTransitions.length===0)&&d(t,"dstTransitions must be a nonempty array");let n=new Set;e.dstTransitions.forEach((r,s)=>{k(r,t,`dstTransitions[${s}]`);for(let o of["year","startUtc","endUtc"])N(r[o],t,`dstTransitions[${s}].${o}`);r.startUtc>=r.endUtc&&d(t,`dstTransitions[${s}] startUtc must be before endUtc`),n.has(r.year)&&d(t,`dstTransitions contains duplicate year ${r.year}`),n.add(r.year)})}function Nt(e,t){M(e,t,"root"),Object.keys(e).length===0&&d(t,"root must not be empty");for(let[n,r]of Object.entries(e)){for(let s of["addr","quote","quoteAddr","dex","pair"])m(r[s],t,`${n}.${s}`);(typeof r.liq!="number"||!Number.isFinite(r.liq)||r.liq<0)&&d(t,`${n}.liq must be a nonnegative finite source number`)}}function _t(e,t){k(e,t,"root"),N(e.capturedAt,t,"capturedAt"),N(e.block,t,"block"),N(e.chainId,t,"chainId"),m(e.gasPriceWei,t,"gasPriceWei"),m(e.stateView,t,"stateView"),M(e.pools,t,"pools"),Object.keys(e.pools).length===0&&d(t,"pools must not be empty");for(let[n,r]of Object.entries(e.pools)){for(let s of["pair","version","quote","token","sqrtPriceX96"])m(r[s],t,`pools.${n}.${s}`);r.version!=="v3"&&r.version!=="v4"&&d(t,`pools.${n}.version must be v3 or v4`),typeof r.quoteIsToken0!="boolean"&&d(t,`pools.${n}.quoteIsToken0 must be a boolean`),(!/^[0-9]+$/.test(r.sqrtPriceX96)||BigInt(r.sqrtPriceX96)<=0n)&&d(t,`pools.${n}.sqrtPriceX96 must be a positive integer string`)}}function Dt(e,t){k(e,t,"root"),N(e.capturedAt,t,"capturedAt"),m(e.source,t,"source"),k(e.books,t,"books"),Object.keys(e.books).length===0&&d(t,"books must not be empty");for(let[n,r]of Object.entries(e.books)){k(r,t,`books.${n}`),(!Array.isArray(r.bids)||!Array.isArray(r.asks))&&d(t,`books.${n} must have bids and asks arrays`);for(let[s,o]of r.bids.entries())k(o,t,`books.${n}.bids[${s}]`),m(o.px,t,`books.${n}.bids[${s}].px`),m(o.sz,t,`books.${n}.bids[${s}].sz`);for(let[s,o]of r.asks.entries())k(o,t,`books.${n}.asks[${s}]`),m(o.px,t,`books.${n}.asks[${s}].px`),m(o.sz,t,`books.${n}.asks[${s}].sz`)}}function Ut(e,t){k(e,t,"root"),N(e.capturedAt,t,"capturedAt"),m(e.source,t,"source"),m(e.chain,t,"chain"),M(e.tokens,t,"tokens"),k(e.pairs,t,"pairs"),Object.keys(e.tokens).length===0&&d(t,"tokens must not be empty");for(let[n,r]of Object.entries(e.tokens)){m(r.symbolRaw,t,`tokens.${n}.symbolRaw`),m(r.mint,t,`tokens.${n}.mint`),Object.hasOwn(e.pairs,n)||d(t,`pairs.${n} is required for token ${n}`),(!Array.isArray(e.pairs[n])||e.pairs[n].length===0)&&d(t,`pairs.${n} must be a nonempty array`);for(let[s,o]of e.pairs[n].entries())k(o,t,`pairs.${n}[${s}]`),m(o.pairAddress,t,`pairs.${n}[${s}].pairAddress`),m(o.dexId,t,`pairs.${n}[${s}].dexId`),(typeof o.priceUsd!="number"||!Number.isFinite(o.priceUsd)||o.priceUsd<=0)&&d(t,`pairs.${n}[${s}].priceUsd must be a positive finite number`),(typeof o.liquidityUsd!="number"||!Number.isFinite(o.liquidityUsd)||o.liquidityUsd<0)&&d(t,`pairs.${n}[${s}].liquidityUsd must be a nonnegative finite number`)}}function Mt(e,t){k(e,t,"root"),N(e.capturedAt,t,"capturedAt"),m(e.source,t,"source"),m(e.chain,t,"chain"),e.chain!=="ton"&&d(t,'chain must be "ton"'),M(e.tokens,t,"tokens"),k(e.pairs,t,"pairs"),Object.keys(e.tokens).length===0&&d(t,"tokens must not be empty");for(let[n,r]of Object.entries(e.tokens)){m(r.symbolRaw,t,`tokens.${n}.symbolRaw`),m(r.mint,t,`tokens.${n}.mint`),Object.hasOwn(e.pairs,n)||d(t,`pairs.${n} is required for token ${n}`),(!Array.isArray(e.pairs[n])||e.pairs[n].length===0)&&d(t,`pairs.${n} must be a nonempty array`);for(let[s,o]of e.pairs[n].entries())k(o,t,`pairs.${n}[${s}]`),m(o.pairAddress,t,`pairs.${n}[${s}].pairAddress`),m(o.dexId,t,`pairs.${n}[${s}].dexId`),(typeof o.priceUsd!="number"||!Number.isFinite(o.priceUsd)||o.priceUsd<=0)&&d(t,`pairs.${n}[${s}].priceUsd must be a positive finite number`),(typeof o.liquidityUsd!="number"||!Number.isFinite(o.liquidityUsd)||o.liquidityUsd<0)&&d(t,`pairs.${n}[${s}].liquidityUsd must be a nonnegative finite number`)}}var jt=Object.freeze({venues:qt,universe:Ot,oracles:Rt,nyseHolidays:It,dstTransitions:Tt,equityDexPools:Nt,rhPoolState:_t,solanaXstocks:Ut,tonXstocks:Mt,hip3L2Books:Dt});function Pt(e,t){let n=Ne[t],r=Te(e,n),s;try{s=St(r,"utf8")}catch(i){throw i?.code==="ENOENT"?new Error(`Fixture fixtures/${n} is missing at ${r}`):new Error(`Fixture fixtures/${n} could not be read: ${i.message}`)}let o;try{o=JSON.parse(s)}catch(i){throw new SyntaxError(`Fixture fixtures/${n} contains invalid JSON: ${i.message}`)}return jt[t](o,n),o}function _e(e){if(e!==null&&typeof e=="object"&&!Object.isFrozen(e)){Object.freeze(e);for(let t of Object.values(e))_e(t)}return e}function De({fixtureDir:e=Et}={}){if(typeof e!="string"||e.length===0)throw new TypeError("fixtureDir must be a nonempty path string");let t={};for(let n of Object.keys(Ne))t[n]=Pt(e,n);return _e(t)}var Ie;function j(){return Ie??=De(),Ie}function q(){return j().venues}function Ue(){return j().oracles}function Me(){return j().nyseHolidays}function je(){return j().dstTransitions}function J(){return j().rhPoolState}function Pe(){return j().solanaXstocks}function Fe(){return j().tonXstocks}function Be(){return j().hip3L2Books}var fe=1e3,ze=60*fe,pe=60*ze,Ce=24*pe,Ft=-5*pe,Bt=-4*pe,Le=240,Qe=570,We=960,Ve=1200,kr=Object.freeze([Le,Qe,We,Ve]),xr=Object.freeze(["core","extended","dark"]),He,le;function Ct(){let e=je().dstTransitions.map(r=>({year:r.year,startMs:r.startUtc*fe,endMs:r.endUtc*fe}));e.sort((r,s)=>r.startMs-s.startMs);let t=e[0].year,n=e[e.length-1].year;return Object.freeze({rows:Object.freeze(e),firstYear:t,lastYear:n,coverageStartMs:Date.UTC(t,0,1),coverageEndMs:Date.UTC(n+1,0,1)})}function Xe(){return He??=Ct(),He}function Ht(){return le===void 0&&(le=new Set(Me().holidayDayIndex)),le}function Ke(e,t){if(!Number.isSafeInteger(e))throw new TypeError(`${t}: epochMs must be a safe integer number of milliseconds`)}function zt(e,t){let{coverageStartMs:n,coverageEndMs:r,firstYear:s,lastYear:o}=Xe();if(e<n||e>=r)throw new RangeError(`${t}: ${new Date(e).toISOString()} is outside DST fixture coverage (${s} through ${o}). Refusing to assume a UTC offset.`)}function Lt(e){for(let t of Xe().rows)if(e>=t.startMs&&e<t.endMs)return!0;return!1}function Qt(e){return Lt(e)?Bt:Ft}function Wt(e){let t=e+Qt(e),n=Math.floor(t/Ce),r=t-n*Ce,s=new Date(t);return{dayIndex:n,minuteOfDay:Math.floor(r/ze),msIntoDay:r,weekday:s.getUTCDay()}}function Vt({dayIndex:e,weekday:t}){return t===0||t===6?!1:!Ht().has(e)}function Xt(e){return e<Le?"dark":e<Qe?"extended":e<We?"core":e<Ve?"extended":"dark"}function V(e){Ke(e,"sessionState"),zt(e,"sessionState");let t=Wt(e);return Vt(t)?Xt(t.minuteOfDay):"dark"}function de(e){return Ke(e,"isDark"),V(e)==="dark"}var G=Object.freeze({DORMANT_VENUE:"dormant-venue",CROSSED_BOOK:"crossed-book",STALE_QUOTE:"stale-quote",STALE_ORACLE:"stale-oracle"}),Kt=12e4,Yt=6e5;function Z(e,t){e.push(Object.freeze({venue:t.venue,symbol:t.symbol??null,reason:t.reason,evidence:t.evidence??null}))}function Jt(e){let t=e.raw?.vol24h;return!!(t===0||t===0||typeof t=="number"&&Number.isFinite(t)&&t<=0)}function Gt(e){return!e.bid||!e.ask?!1:U(e.bid,e.ask)>0}function Ye(e,t,n){return Number.isSafeInteger(e.capturedAt)?t-e.capturedAt>n:!1}function ee(e,t={}){if(!Array.isArray(e))throw new TypeError("quotes must be an array");let n=t.nowMs??Date.now(),r=t.quoteFreshnessMs??Kt,s=t.oracleFreshnessMs??Yt,o=t.includeDormant===!0,i=[],u=[];for(let a of e){if(Jt(a)){o?i.push(Object.freeze({...a,staleData:!0})):Z(u,{venue:a.venue,symbol:a.symbolRaw??a.symbol,reason:G.DORMANT_VENUE,evidence:{vol24h:a.raw?.vol24h??null}});continue}if(Gt(a)){Z(u,{venue:a.venue,symbol:a.symbolRaw??a.symbol,reason:G.CROSSED_BOOK,evidence:{bid:a.bid?String(a.bid.mantissa)+"e-"+a.bid.scale:null,ask:a.ask?String(a.ask.mantissa)+"e-"+a.ask.scale:null}});continue}if(Ye(a,n,r)){Z(u,{venue:a.venue,symbol:a.symbolRaw??a.symbol,reason:G.STALE_QUOTE,evidence:{capturedAt:a.capturedAt,nowMs:n,ageMs:n-a.capturedAt,freshnessMs:r}});continue}if(a.tier==="read-only"&&a.raw?.oracleRaw!==void 0){let l=V(n),c=l==="core"?s:s*2;if(Ye(a,n,c)){Z(u,{venue:a.venue,symbol:a.symbolRaw??a.symbol,reason:G.STALE_ORACLE,evidence:{capturedAt:a.capturedAt,nowMs:n,session:l}});continue}}i.push(a)}return{survivors:i,excluded:u}}function Zt(e){if(typeof e!="number"||!Number.isFinite(e))throw new TypeError("value must be a finite number");let t=String(e);if(!t.includes("e")&&!t.includes("E"))return t;let[n,r]=t.split(/[eE]/),s=Number(r),o=n.startsWith("-"),i=o?n.slice(1):n,[u,a=""]=i.split("."),l=`${u}${a}`,c=u.length+s,p;return c<=0?p=`0.${"0".repeat(-c)}${l}`:c>=l.length?p=`${l}${"0".repeat(c-l.length)}`:p=`${l.slice(0,c)}.${l.slice(c)}`,`${o?"-":""}${p}`}function w(e){return e==null?null:typeof e=="string"?f(e):typeof e!="number"||!Number.isFinite(e)?null:f(Zt(e))}function I(e,t){let n=w(e);if(n===null)throw new TypeError(`${t} must be a finite source number`);return n}var en=new Set(["spot","perp"]),tn=new Set(["read-only","quote-only","prepare","intent"]),nn=new Set(["buy","sell"]),rn=new Set(["net-of-cost","gross"]),sn=new Set(["homogeneous","heterogeneous"]),on=["bid","ask","mid","mark"],Je=["fees","gasEstimate","priceImpact","fundingHourly"],un=/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;function h(e,t){throw new TypeError(`${e} ${t}`)}function Ze(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)}function B(e,t){Ze(e)||h(t,"must be an object")}function et(e,t,n){Object.hasOwn(e,t)||h(`${n}.${t}`,"is required")}function C(e,t){(typeof e!="string"||e.length===0)&&h(t,"must be a nonempty string")}function X(e,t,n){t.has(e)||h(n,`must be one of ${[...t].join(", ")}`)}function be(e,t){(!Number.isSafeInteger(e)||e<0)&&h(t,"must be a nonnegative safe integer")}function me(e,t,n=!1){e===null&&n||(Ze(e)||h(t,"must be a fixed point value"),typeof e.mantissa!="bigint"&&h(`${t}.mantissa`,"must be a bigint"),(!Number.isSafeInteger(e.scale)||e.scale<0)&&h(`${t}.scale`,"must be a nonnegative safe integer"))}function te(e,t,n=!1){e===null&&n||B(e,t)}function Ge(e,t){B(e,t),C(e.venue,`${t}.venue`),C(e.reason,`${t}.reason`),un.test(e.reason)||h(`${t}.reason`,"must be a machine readable lower case code"),Object.hasOwn(e,"symbol")&&e.symbol!==null&&C(e.symbol,`${t}.symbol`)}function v(e){B(e,"quote");for(let n of["venue","chain","instrument","tier","symbolRaw","symbol","side","requestedSize",...Je,"costAccounted","capturedAt","blockOrSeq","raw"])et(e,n,"quote");C(e.venue,"quote.venue"),!(typeof e.chain=="string"&&e.chain.length>0)&&!(Number.isSafeInteger(e.chain)&&e.chain>=0)&&h("quote.chain","must be a nonempty string or nonnegative chain id"),X(e.instrument,en,"quote.instrument"),X(e.tier,tn,"quote.tier"),C(e.symbolRaw,"quote.symbolRaw"),C(e.symbol,"quote.symbol"),X(e.side,nn,"quote.side"),me(e.requestedSize,"quote.requestedSize"),e.requestedSize.mantissa<0n&&h("quote.requestedSize","must not be negative");let t=0;for(let n of on)Object.hasOwn(e,n)&&(me(e[n],`quote.${n}`),t+=1);t===0&&h("quote","must contain at least one of bid, ask, mid, mark");for(let n of Je)me(e[n],`quote.${n}`,!0);if(typeof e.costAccounted!="boolean"&&h("quote.costAccounted","must be a boolean"),e.costAccounted){for(let n of["fees","gasEstimate","priceImpact"])e[n]===null&&h(`quote.${n}`,"cannot be unknown when costAccounted is true");e.instrument==="perp"&&e.fundingHourly===null&&h("quote.fundingHourly","cannot be unknown when costAccounted is true for a perp")}return e.instrument==="spot"&&e.fundingHourly!==null&&h("quote.fundingHourly","must be null for a spot quote"),be(e.capturedAt,"quote.capturedAt"),e.blockOrSeq!==null&&!(typeof e.blockOrSeq=="string"&&e.blockOrSeq.length>0)&&!(Number.isSafeInteger(e.blockOrSeq)&&e.blockOrSeq>=0)&&h("quote.blockOrSeq","must be null, a nonempty string, or a nonnegative safe integer"),B(e.raw,"quote.raw"),e}function ye(e){B(e,"rankResult");for(let t of["rankedOn","ranked","winner","runnersUp","improvementBps","sourcesAnswered","sourcesTried","failed","excluded","darkWindow","instrumentMix","bestPreparable"])et(e,t,"rankResult");return X(e.rankedOn,rn,"rankResult.rankedOn"),Array.isArray(e.ranked)||h("rankResult.ranked","must be an array"),e.ranked.forEach((t,n)=>te(t,`rankResult.ranked[${n}]`)),te(e.winner,"rankResult.winner",!0),e.ranked.length===0&&e.winner!==null&&h("rankResult.winner","must be null when ranked is empty"),e.ranked.length>0&&e.winner===null&&h("rankResult.winner","must be present when ranked is not empty"),Array.isArray(e.runnersUp)||h("rankResult.runnersUp","must be an array"),e.runnersUp.forEach((t,n)=>te(t,`rankResult.runnersUp[${n}]`)),e.improvementBps!==null&&!(typeof e.improvementBps=="number"&&Number.isFinite(e.improvementBps))&&h("rankResult.improvementBps","must be a finite number or null"),be(e.sourcesAnswered,"rankResult.sourcesAnswered"),be(e.sourcesTried,"rankResult.sourcesTried"),e.sourcesAnswered>e.sourcesTried&&h("rankResult.sourcesAnswered","must not exceed sourcesTried"),Array.isArray(e.failed)||h("rankResult.failed","must be an array"),e.failed.forEach((t,n)=>Ge(t,`failed[${n}]`)),Array.isArray(e.excluded)||h("rankResult.excluded","must be an array"),e.excluded.forEach((t,n)=>Ge(t,`excluded[${n}]`)),e.darkWindow!==null&&B(e.darkWindow,"rankResult.darkWindow"),X(e.instrumentMix,sn,"rankResult.instrumentMix"),te(e.bestPreparable,"rankResult.bestPreparable",!0),Object.hasOwn(e,"carry")&&e.carry!==null&&B(e.carry,"rankResult.carry"),e}var an="arcus_perp",cn="robinhood-4663",ln="quote-only",ne="0.00000480324074074";function tt(){return q().venues.arcus}function fn(){return Object.keys(tt().markets).sort()}function pn({symbol:e,side:t="buy",sizeUsd:n=null}={}){if(typeof e!="string"||e.length===0)return null;let r=e.endsWith("-USD")?e.slice(0,-4):e,s=tt().markets[r];if(!s)return null;let o=I(s.mark,`${r}.mark`),i=w(s.oracle),u=w(s.fundingHourly),a=n===null?f("0"):n,l={venue:an,chain:cn,instrument:"perp",tier:ln,symbolRaw:e,symbol:r,side:t,requestedSize:a,mark:o,fees:null,gasEstimate:null,priceImpact:null,fundingHourly:u,costAccounted:!1,capturedAt:q().capturedAt*1e3,blockOrSeq:null,raw:{fixture:"fixtures/venues.json#venues.arcus",oraclePrice:s.oracle,vol24h:s.vol24h,oi:s.oi,fundingAnnPct:s.fundingAnnPct,category:s.category,isOutsideRth:s.isOutsideRth===!0,rth:s.rth,darkWindowFundingHourly:ne,initialMarginFraction:s.initialMarginFraction??null,offHoursInitialMarginFraction:s.offHoursInitialMarginFraction??null,reasonCostUnknown:"fees, gas, and impact at size not captured for Arcus perps"}};return i!==null&&(l.raw.oracleFixed=i),v(l)}function re({side:e="buy",sizeUsd:t=null}={}){return fn().map(n=>pn({symbol:n,side:e,sizeUsd:t})).filter(n=>n!==null)}var nt=36e5,jr=24*365;function he(e,t,n=8){if(e==null)throw new TypeError("hourlyFundingRate is required");if(!Number.isFinite(t)||t<0)throw new RangeError("horizonHours must be a nonnegative finite number");if(t===0)return f("0");let r=f(String(t)),s=$(10000n,0);return E(E(e,r),s)}function rt(e,t,n={}){if(e.instrument!=="perp")return{model:"current-funding-held-constant",horizonHours:t,carryBps:f("0"),carryBpsDisplay:"0",confidence:"estimate",note:"spot has no funding carry"};let r=n.nowMs??Date.now(),s=n.applyDarkWindowLock===!0,o=e.fundingHourly;if(s&&o!==null){let u=dn(r,t),a=t-u,l=f(ne),c=he(o,a),p=he(l,u),y=Math.max(c.scale,p.scale),b={mantissa:c.mantissa*10n**BigInt(y-c.scale)+p.mantissa*10n**BigInt(y-p.scale),scale:y};return{model:"current-funding-held-constant",horizonHours:t,carryBps:b,carryBpsDisplay:S(b),confidence:"estimate",darkHours:u,litHours:a,darkWindowRate:ne,compounding:"ignored",compoundingErrorBoundNote:"simple sum; at 30d and 1e-5/h the ignored compound is under 0.5bp"}}if(o===null)return{model:"current-funding-held-constant",horizonHours:t,carryBps:null,carryBpsDisplay:null,confidence:"estimate",note:"funding rate unknown"};let i=he(o,t);return{model:"current-funding-held-constant",horizonHours:t,carryBps:i,carryBpsDisplay:S(i),confidence:"estimate",compounding:"ignored",compoundingErrorBoundNote:"simple sum; at 30d and 1e-5/h the ignored compound is under 0.5bp"}}function dn(e,t){if(t<=0)return 0;let n=0,r=Math.floor(t);for(let s=0;s<r;s+=1)de(e+s*nt)&&(n+=1);return t>r&&de(e+r*nt)&&(n+=t-r),n}function mn(e){return e.mid??e.mark??e.ask??e.bid??null}function bn(e){let t=mn(e);if(t===null)return null;let n=e.costAccounted===!0,r=f("0");e.fees!==null?r=D(r,e.fees):n=!1,e.priceImpact!==null?r=D(r,e.priceImpact):e.requestedSize&&e.requestedSize.mantissa>0n&&(n=!1),e.gasEstimate===null?n=!1:r=D(r,e.gasEstimate);let s;if(e.fees!==null&&U(e.fees,f("1"))<0&&U(e.fees,f("0"))>=0){let o=D(f("1"),e.fees);s=E(t,o),e.priceImpact!==null&&(s=D(s,E(t,e.priceImpact)))}else s=D(t,r);return{net:s,costAccounted:n,px:t}}function yn(e,t,n=null){return{venue:e.venue,chain:e.chain,instrument:e.instrument,tier:e.tier,symbol:e.symbol,symbolRaw:e.symbolRaw,side:e.side,price:t.px,net:t.net,costAccounted:t.costAccounted,fundingHourly:e.fundingHourly,carry:n,quote:e}}function hn(e,t){if(!e||!t||!e.costAccounted||!t.costAccounted||e.instrument!==t.instrument||e.net.mantissa===0n)return null;let n=W(t.net,e.net);return R(E(n,$(10000n,0)),t.net,4)}function ge(e,t={}){if(!Array.isArray(e))throw new TypeError("quotes must be an array");let n=t.nowMs??e[0]?.capturedAt??Date.now(),r=e.length,s=e,o=[];if(!t.skipLiveness){let x=ee(e,{nowMs:n});s=x.survivors,o=x.excluded}let i=e.length,u=[],a=t.horizonHours,l=Number.isFinite(a)&&a>0,c=[];for(let x of s){let A=bn(x);if(A===null)continue;let O=null;if(l&&x.instrument==="perp"&&(O=rt(x,a,{nowMs:n}),O.carryBps!==null)){let wt=D(f("1"),R(O.carryBps,$(10000n,0),12));A.net=E(A.net,wt),A.costAccounted=!1}c.push(yn(x,A,O))}let p=c,y="homogeneous";if(l)y="heterogeneous",p=c;else{let x=c.filter(O=>O.instrument==="spot"),A=c.filter(O=>O.instrument==="perp");x.length>0&&A.length>0?(p=x.length>=A.length?x:A,y="homogeneous"):(p=c,y="homogeneous")}p.sort((x,A)=>{let O=U(x.net,A.net);return O!==0?O:x.venue<A.venue?-1:x.venue>A.venue?1:0});let b=p[0]??null,g=p.slice(1),P=p,L="gross";b&&b.costAccounted&&(g.length===0||g[0].costAccounted)&&(L="net-of-cost");let Oe=g.length===0?null:hn(b,g[0]),gt=c.find(x=>x.tier==="prepare")??null,ae=V(n),kt=ae==="core"?null:{session:ae,warning:ae==="dark"?"market is dark; marks are not real price discovery":"extended session; thinner books and higher staleness risk"},Re=null;l&&(Re=gn(c));let xt={rankedOn:L,ranked:P,winner:b,runnersUp:g,improvementBps:Oe===null?null:Number(S(Oe)),sourcesAnswered:i,sourcesTried:r,failed:u,excluded:o,darkWindow:kt,instrumentMix:y,bestPreparable:gt,carry:b?.carry??null,breakEvenHorizonHours:Re};return ye(xt)}function gn(e){let t=e.filter(o=>o.instrument==="spot").sort((o,i)=>U(o.net,i.net))[0],n=e.filter(o=>o.instrument==="perp").sort((o,i)=>U(o.net,i.net))[0];if(!t||!n||n.fundingHourly===null)return null;let r=W(t.net,n.net);if(r.mantissa===0n)return 0;let s=E(n.fundingHourly,n.price);if(s.mantissa===0n)return null;try{let o=R(r,s,4),i=Number(S(o));return!Number.isFinite(i)||i<0?null:i}catch{return null}}var kn="rh_uniswap",xn=4663,wn="prepare",Sn=1n<<192n,H=18,$n=Object.freeze({v3:180000n,v4:240000n});function ke(){return J()}function An(e){return{mantissa:e*e*10n**BigInt(H)/Sn,scale:H}}function En(e){let t=An(BigInt(e.sqrtPriceX96)),n=e.quote==="USDG"?6:18,r=18;if(e.quoteIsToken0){let s=R(E(t,$(10n**BigInt(n),0)),$(10n**BigInt(r),0),H);return s.mantissa===0n?null:R(f("1"),s,H)}return R(E(t,$(10n**BigInt(r),0)),$(10n**BigInt(n),0),H)}function vn(e){let t=Ue(),n=t.assets[e];return n?$(n.rawPrice,t.oracleScaleExp):null}function qn(e,t){if(e===null||t===null||e.mantissa<=0n||t.mantissa<=0n)return null;let n={...e};return R(t,On(n,t),H)}function On(e,t){let n=Math.max(e.scale,t.scale);return{mantissa:Q(e,n).mantissa+Q(t,n).mantissa,scale:n}}function Rn(e){let t=ke(),n=$n[e];return n?{wei:BigInt(t.gasPriceWei)*n,units:n,native:"ETH"}:null}function xe(){return Object.keys(ke().pools).sort()}function z({symbol:e,side:t="buy",sizeUsd:n=null}={}){if(typeof e!="string"||e.length===0)throw new TypeError("symbol must be a nonempty string");let r=ke(),s=r.pools[e];if(!s)return null;let o=En(s);if(o===null)return null;let i=w(s.liqUsd),u=n===null?f("0"):n,a=s.feePpm===null||s.feePpm===void 0?null:R($(BigInt(s.feePpm),0),$(1000000n,0),8),l=u.mantissa===0n?f("0"):qn(i,u),c=Rn(s.version),b={venue:kn,chain:xn,instrument:"spot",tier:wn,symbolRaw:e,symbol:e,side:t,requestedSize:u,mid:o,fees:a,gasEstimate:null,priceImpact:l,fundingHourly:null,costAccounted:!1,capturedAt:r.capturedAt*1e3,blockOrSeq:r.block,raw:{fixture:"fixtures/rh_pool_state.json",pair:s.pair,version:s.version,sqrtPriceX96:s.sqrtPriceX96,quote:s.quote,quoteIsToken0:s.quoteIsToken0,liqUsd:s.liqUsd,gasNativeWei:c===null?null:c.wei.toString(),gasUnits:c===null?null:c.units.toString(),impactModel:"constant-product-estimate",notes:["price read live from chain 4663",s.version==="v4"?"v4 fee may be dynamic via hook and was not captured":"v3 fee tier is the pool static fee","gas known in native wei only, no ETH price captured to denominate it"]}},g=vn(e);return g!==null&&(b.referencePrice=g,b.referenceBasisBps=S(R(E(W(o,g),$(10000n,0)),g,4))),v(b)}function st({side:e="buy",sizeUsd:t=null}={}){return xe().map(n=>z({symbol:n,side:e,sizeUsd:t})).filter(n=>n!==null)}var ot=12e4,In="0x0000000000000000000000000000000000000000",Tn="0x84b75b19A3cdf8E2F56d0507d22D442847B2053C";function we(e={}){let{symbol:t,side:n="buy",sizeUsd:r=null,recipient:s,nowMs:o=Date.now()}=e;if(typeof t!="string"||!t)throw new TypeError("symbol is required");if(typeof s!="string"||!/^0x[0-9a-fA-F]{40}$/.test(s))throw new TypeError("recipient must be a 0x-prefixed 20 byte address");let i=z({symbol:t,side:n,sizeUsd:r});if(i===null)throw new Error(`no RH Uniswap pool for ${t}`);if(i.tier!=="prepare")throw new Error(`route tier is ${i.tier}, only prepare tier can be prepared`);let u=o-i.capturedAt;if(u>ot)throw new Error(`quote is stale (${u}ms old, bound ${ot}ms); re-quote before preparing`);let l=J().pools[t],c=l.version==="v4"?Tn:In,p=c,y=n==="buy"?l.quoteAddr:l.token;return Object.freeze({artifactKind:"unsigned-tx",chainId:4663,to:c,data:"0x",value:"0",requiresApproval:{spender:p,token:y,amount:null},requiresWalletSignature:!0,backendSigner:!1,unsigned:!0,houseSigned:!1,quoteRef:{venue:i.venue,symbol:i.symbol,symbolRaw:i.symbolRaw,capturedAt:i.capturedAt,blockOrSeq:i.blockOrSeq,mid:i.mid,version:l.version,pair:l.pair},quoteAgeMs:u,recipient:s,side:n,notes:["prepare-only: user wallet must sign","calldata encoding is deferred; this artifact is the bound intent",l.version==="v4"?"V4 route via PoolManager":"V3 route via SwapRouter (address not yet pinned)"]})}var Nn="hyperliquid_hip3",_n="hyperliquid",Dn="quote-only";function K(){return q().venues.hyperliquid_hip3}function it(){return Object.keys(K().dexs).sort()}function Un(){let e=[];for(let[t,n]of Object.entries(K().dexs))for(let r of Object.keys(n))e.push(`${t}:${r}`);return e.sort()}function Mn(e){if(typeof e!="string"||e.length===0)return[];let t=e.indexOf(":");if(t>0){let r=e.slice(0,t),s=e.slice(t+1),o=K().dexs[r]?.[s];return o?[{dex:r,ticker:s,market:o}]:[]}let n=[];for(let[r,s]of Object.entries(K().dexs))Object.hasOwn(s,e)&&n.push({dex:r,ticker:e,market:s[e]});return n}function jn(e,t){try{return Be().books[`${e}:${t}`]??null}catch{return null}}function Pn(e,t,n){if(!e||n===null||n.mantissa<=0n)return null;let r=t==="buy"?e.asks:e.bids;if(!r||r.length===0)return null;let s=Number(S(n));if(!Number.isFinite(s)||s<=0)return null;let o=0,i=0,u=0;for(let a of r){let l=Number(a.px),c=Number(a.sz);if(!(l>0)||!(c>0))continue;let p=l*c,y=Math.min(s,p),b=y/l;if(o+=y,i+=b,s-=y,u+=1,s<=1e-9)break}return i<=0?null:{vwap:o/i,filledUsd:o,unfilledUsd:Math.max(0,s),levelsUsed:u}}function Fn(e,t,n,r){let s=Pn(e,t,n);if(!s)return{impact:null,depth:null};let o=Number(S(r));if(!(o>0))return{impact:null,depth:s};let i=t==="buy"?(s.vwap-o)/o:(o-s.vwap)/o,u=Math.max(0,i);return{impact:w(Number(u.toPrecision(12))),depth:{...s,impactFraction:u,fullyFilled:s.unfilledUsd<=1e-6}}}function ut({dex:e,ticker:t,market:n,side:r,size:s}){let o=I(n.mark,`${e}:${t}.mark`),i=w(n.fundingHourly),u=w(n.vol24h),a=w(n.oi),l=s===null?f("0"):s,c=jn(e,t),p=null,y=null,b="fees and gas not captured";if(l.mantissa>0n)if(c){let L=Fn(c,r,l,o);p=L.impact,y=L.depth,y?.fullyFilled?b="impact measured from l2Book; fees and gas still not captured":b="book walked but size exceeds visible depth; fees and gas not captured"}else b="no order book depth wired for this coin; fees and gas not captured";else c?b="zero size; fees and gas not captured":b="no order book depth wired for this coin; fees and gas not captured";let P={venue:Nn,chain:_n,instrument:"perp",tier:Dn,symbolRaw:`${e}:${t}`,symbol:t,side:r,requestedSize:l,mark:o,fees:null,gasEstimate:null,priceImpact:p,fundingHourly:i,costAccounted:!1,capturedAt:q().capturedAt*1e3,blockOrSeq:null,raw:{fixture:"fixtures/venues.json#venues.hyperliquid_hip3",dex:e,ticker:t,vol24h:n.vol24h,oi:n.oi,fundingAnnPct:n.fundingAnnPct,maxLev:n.maxLev,reasonCostUnknown:b,hasL2Book:c!==null,l2BookFixture:c?"fixtures/hip3_l2books.json":null,depth:y}};return u!==null&&(P.raw.vol24hFixed=u),a!==null&&(P.raw.oiFixed=a),c?.bids?.[0]&&c?.asks?.[0]&&(P.bid=f(String(c.bids[0].px)),P.ask=f(String(c.asks[0].px))),v(P)}function at({symbol:e,side:t="buy",sizeUsd:n=null}={}){let r=Mn(e);return r.length===0||r.length>1?null:ut({...r[0],side:t,size:n})}function se({side:e="buy",sizeUsd:t=null,ticker:n=null}={}){let r=[];for(let s of Un()){let[o,i]=s.split(":");if(n!==null&&i!==n)continue;let u=K().dexs[o][i];r.push(ut({dex:o,ticker:i,market:u,side:e,size:t}))}return r}var Bn="arcus_spot",Cn="robinhood-4663",Hn="quote-only";function ct(){return q().venues.arcus_spot}function zn(){return Object.keys(ct().pairs).sort()}function Ln({symbol:e,side:t="buy",sizeUsd:n=null}={}){if(typeof e!="string"||e.length===0)return null;let r=ct().pairs[e];if(!r)return null;let s=r.bid===void 0||r.bid===null?null:I(r.bid,`${e}.bid`),o=r.ask===void 0||r.ask===null?null:I(r.ask,`${e}.ask`),i=w(r.last),u=null;if(s!==null&&o!==null){u={mantissa:s.mantissa+o.mantissa,scale:s.scale===o.scale?s.scale+1:Math.max(s.scale,o.scale)+1};let p=Math.max(s.scale,o.scale),y=s.scale===p?s.mantissa:s.mantissa*10n**BigInt(p-s.scale),b=o.scale===p?o.mantissa:o.mantissa*10n**BigInt(p-o.scale);u={mantissa:y+b,scale:p+1},u={mantissa:(y+b)/2n,scale:p}}else i!==null&&(u=i);if(s===null&&o===null&&u===null)return null;let a=n===null?f("0"):n,l=f("0"),c={venue:Bn,chain:Cn,instrument:"spot",tier:Hn,symbolRaw:e,symbol:e,side:t,requestedSize:a,fees:l,gasEstimate:null,priceImpact:null,fundingHourly:null,costAccounted:!1,capturedAt:q().capturedAt*1e3,blockOrSeq:null,raw:{fixture:"fixtures/venues.json#venues.arcus_spot",last:r.last,bid:r.bid,ask:r.ask,vol24h:r.vol24h,feeKnownZero:!0,reasonCostUnknown:"gas and impact at size not captured; fee is a known zero"}};return s!==null&&(c.bid=s),o!==null&&(c.ask=o),u!==null&&(c.mid=u),v(c)}function oe({side:e="buy",sizeUsd:t=null}={}){return zn().map(n=>Ln({symbol:n,side:e,sizeUsd:t})).filter(n=>n!==null)}var Qn="solana_xstocks",Wn="solana",Vn="quote-only",lt=25e3;function ie(){return Pe()}function Se(){return Object.keys(ie().tokens).sort()}function Xn(e){let t=ie().pairs[e];return!t||t.length===0?null:[...t].sort((n,r)=>(r.liquidityUsd??0)-(n.liquidityUsd??0))[0]}function Kn(e,t){if(e===null||t===null)return null;if(e.mantissa<=0n||t.mantissa<=0n)return f("0");let n=Math.max(e.scale,t.scale),r=e.scale===n?e.mantissa:e.mantissa*10n**BigInt(n-e.scale),s=t.scale===n?t.mantissa:t.mantissa*10n**BigInt(n-t.scale),o=s*10n**6n,i=r+s;return{mantissa:o/i,scale:6}}function $e({symbol:e,side:t="buy",sizeUsd:n=null}={}){if(typeof e!="string"||e.length===0)return null;let r=e,s=e,o=ie().tokens;if(Object.hasOwn(o,e))r=e,s=o[e].symbolRaw;else if(e.endsWith("x")||e.endsWith("X")){let g=e.slice(0,-1).toUpperCase();if(Object.hasOwn(o,g))r=g,s=o[g].symbolRaw;else return null}else return null;let i=o[r],u=Xn(r);if(!i||!u)return null;let a=I(u.priceUsd,`${r}.priceUsd`),l=w(u.liquidityUsd),c=n===null?f("0"):n,p=c.mantissa===0n?f("0"):Kn(l,c),y=!1;c.mantissa===0n&&(u.liquidityUsd??0)>=lt&&(y=!1);let b={venue:Qn,chain:Wn,instrument:"spot",tier:Vn,symbolRaw:s,symbol:r,side:t,requestedSize:c,mid:a,fees:null,gasEstimate:null,priceImpact:p,fundingHourly:null,costAccounted:y,capturedAt:ie().capturedAt*1e3,blockOrSeq:null,raw:{fixture:"fixtures/solana_xstocks.json",mint:i.mint,pairAddress:u.pairAddress,dexId:u.dexId,quote:u.quote,liquidityUsd:u.liquidityUsd,volume24h:u.volume24h,priceUsd:u.priceUsd,source:"dexscreener",approximate:!0,reasonCostUnknown:"DexScreener liquidity.usd is a third-party float; fees and SOL gas not captured; impact is modeled",thin:(u.liquidityUsd??0)<lt}};return v(b)}function ft({side:e="buy",sizeUsd:t=null}={}){return Se().map(n=>$e({symbol:n,side:e,sizeUsd:t})).filter(n=>n!==null)}var Yn="ton_stonfi",Jn="ton",Gn="quote-only",Zn=25e3,er=.01;function ue(){return Fe()}function Ae(){return Object.keys(ue().tokens).sort()}function tr(e){let t=ue().pairs[e];return!t||t.length===0?null:[...t].sort((n,r)=>(r.liquidityUsd??0)-(n.liquidityUsd??0))[0]}function nr(e,t){if(e===null||t===null)return null;if(e.mantissa<=0n||t.mantissa<=0n)return f("0");let n=Math.max(e.scale,t.scale),r=e.scale===n?e.mantissa:e.mantissa*10n**BigInt(n-e.scale),s=t.scale===n?t.mantissa:t.mantissa*10n**BigInt(n-t.scale),o=s*10n**6n,i=r+s;return{mantissa:o/i,scale:6}}function Ee({symbol:e,side:t="buy",sizeUsd:n=null}={}){if(typeof e!="string"||e.length===0)return null;let r=e,s=e,o=ue().tokens;if(Object.hasOwn(o,e))r=e,s=o[e].symbolRaw;else if(e.endsWith("x")||e.endsWith("X")){let g=e.slice(0,-1).toUpperCase();if(Object.hasOwn(o,g))r=g,s=o[g].symbolRaw;else return null}else{let g=e.toUpperCase();if(Object.hasOwn(o,g))r=g,s=o[g].symbolRaw;else return null}let i=o[r],u=tr(r);if(!i||!u)return null;let a=I(u.priceUsd,`${r}.priceUsd`),l=w(u.liquidityUsd),c=n===null?f("0"):n,p=c.mantissa===0n?f("0"):nr(l,c),b={venue:Yn,chain:Jn,instrument:"spot",tier:Gn,symbolRaw:s,symbol:r,side:t,requestedSize:c,mid:a,fees:null,gasEstimate:null,priceImpact:p,fundingHourly:null,costAccounted:!1,capturedAt:ue().capturedAt*1e3,blockOrSeq:null,raw:{fixture:"fixtures/ton_xstocks.json",mint:i.mint,pairAddress:u.pairAddress,dexId:u.dexId,quote:u.quote,liquidityUsd:u.liquidityUsd,volume24h:u.volume24h,priceUsd:u.priceUsd,source:"dexscreener",approximate:!0,reasonCostUnknown:"DexScreener liquidity.usd is a third-party float; fees and TON gas not captured; impact is modeled; TON books are thin",thin:(u.liquidityUsd??0)<Zn,impactSizeFractionHint:er}};return v(b)}function pt({side:e="buy",sizeUsd:t=null}={}){return Ae().map(n=>Ee({symbol:n,side:e,sizeUsd:t})).filter(n=>n!==null)}function ve(e){return e==null||e===""?null:typeof e=="object"&&e&&typeof e.mantissa=="bigint"?e:f(String(e))}function rr(e,{sizeUsd:t=null}={}){if(typeof e!="string"||!e.trim())throw new TypeError("ticker is required");let n=e.trim().toUpperCase(),r=ve(t),s=[],o=at({symbol:`xyz:${n}`,sizeUsd:r});if(o)s.push(o);else for(let l of se({ticker:n,sizeUsd:r}))s.push(l);for(let l of re({sizeUsd:r}))l.symbol===n&&s.push(l);for(let l of oe({sizeUsd:r}))l.symbol===n&&s.push(l);let i=z({symbol:n,sizeUsd:r});i&&s.push(i);let u=$e({symbol:n,sizeUsd:r});u&&s.push(u);let a=Ee({symbol:n,sizeUsd:r});return a&&s.push(a),s}function dt(e={}){let t=String(e.ticker||e.symbol||"").trim().toUpperCase();if(!t)throw new Error("bestEquityRoute requires ticker");let n=ve(e.sizeUsd??e.size??null),r=rr(t,{sizeUsd:n});if(r.length===0)return{ticker:t,rankedOn:"gross",ranked:[],winner:null,runnersUp:[],improvementBps:null,sourcesAnswered:0,sourcesTried:0,failed:[],excluded:[],bestPreparable:null,instrumentMix:"homogeneous",note:"no venue answered for this ticker in the pinned fixture capture"};let s=e.nowMs??r[0].capturedAt+1e3,o=ge(r,{nowMs:s,horizonHours:e.horizonHours!=null?Number(e.horizonHours):void 0,skipLiveness:e.skipLiveness===!0});return{ticker:t,...o}}function mt(){let e=[{venue:"hyperliquid_hip3",tier:"quote-only",chain:"hyperliquid",n:se().length},{venue:"arcus_perp",tier:"quote-only",chain:"robinhood-4663",n:re().length},{venue:"arcus_spot",tier:"quote-only",chain:"robinhood-4663",n:oe().length},{venue:"rh_uniswap",tier:"prepare",chain:4663,n:xe().length},{venue:"solana_xstocks",tier:"quote-only",chain:"solana",n:Se().length},{venue:"ton_stonfi",tier:"quote-only",chain:"ton",n:Ae().length}],t=[...se(),...re(),...oe(),...st(),...ft(),...pt()],n=(t[0]?.capturedAt??Date.now())+1e3,{survivors:r,excluded:s}=ee(t,{nowMs:n});return{inventory:e,hip3Dexs:it(),liveness:{survivors:r.length,excluded:s.length,byReason:s.reduce((o,i)=>(o[i.reason]=(o[i.reason]??0)+1,o),{})},capturedAt:q().capturedAt,custody:"prepare-only",note:"quote-only venues are ranked for discovery; only rh_uniswap is preparable in v1"}}function bt(e={}){let t=String(e.ticker||e.symbol||"").trim().toUpperCase(),n=e.recipient||e.taker;if(!t)throw new Error("prepareEquityRoute requires ticker");if(!n)throw new Error("prepareEquityRoute requires recipient (signing wallet)");let r=ve(e.sizeUsd??e.size??null),s=z({symbol:t,sizeUsd:r});if(!s)return{ok:!1,failureKind:"no-prepare-path",ticker:t,note:"no RH Uniswap prepare-tier route for this ticker in fixtures"};try{let o=we({symbol:t,sizeUsd:r,recipient:n,nowMs:e.nowMs??s.capturedAt+1e3});return{ok:!0,ticker:t,artifact:o,bestPreparableVenue:"rh_uniswap"}}catch(o){return{ok:!1,failureKind:"prepare-refused",ticker:t,error:String(o.message||o)}}}function qe(e){return JSON.parse(JSON.stringify(e,(t,n)=>typeof n=="bigint"?n.toString():n))}function ht(){return`oracle equities <command>
+
+Commands:
+  venues                         inventory + tiers + liveness snapshot
+  quote <TICKER> [options]       rank venues for a ticker (HIP-3, Arcus, RH, Solana, TON)
+  prepare <TICKER> --recipient 0x...   prepare unsigned RH Uniswap artifact
+
+Options:
+  --size <usd>         notional size for impact model
+  --horizon <hours>    enable funding-adjusted heterogeneous ranking
+  --json               machine readable output
+  --fixtures           offline mode (default in v1)
+`}function or(e){let t={_:[]};for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="--json")t.json=!0;else if(r==="--fixtures")t.fixtures=!0;else if(r==="--size")t.size=e[++n];else if(r==="--horizon")t.horizon=e[++n];else if(r==="--recipient")t.recipient=e[++n];else{if(r.startsWith("--"))throw new Error(`unknown flag ${r}`);t._.push(r)}}return t}function ir(e){let t=[];t.push(`oracle equities quote ${e.ticker}`),e.darkWindow&&t.push(`WARNING: ${e.darkWindow.warning} (session=${e.darkWindow.session})`),t.push(`rankedOn=${e.rankedOn} mix=${e.instrumentMix}`),t.push(`sources answered/tried=${e.sourcesAnswered}/${e.sourcesTried} excluded=${e.excluded?.length??0} failed=${e.failed?.length??0}`),e.winner?t.push(`WINNER  ${e.winner.venue} ${e.winner.instrument} tier=${e.winner.tier} net=${S(e.winner.net)} costAccounted=${e.winner.costAccounted}`):t.push("WINNER  (none)");for(let n of(e.runnersUp||[]).slice(0,5))t.push(`  runner ${n.venue} ${n.instrument} tier=${n.tier} net=${S(n.net)} costAccounted=${n.costAccounted}`);if(e.improvementBps!==null&&e.improvementBps!==void 0?t.push(`improvementBps=${e.improvementBps}`):t.push("improvementBps=null (no honest same-class costed comparison)"),e.bestPreparable?t.push(`bestPreparable ${e.bestPreparable.venue} net=${S(e.bestPreparable.net)}`):t.push("bestPreparable (none)"),e.excluded?.length){let n={};for(let r of e.excluded)n[r.reason]=(n[r.reason]??0)+1;t.push(`excluded: ${JSON.stringify(n)}`)}return t.join(`
+`)}function ur(e){let t=mt();return e.json?JSON.stringify(t,null,2):["oracle equities venues",...t.inventory.map(n=>`  ${n.venue.padEnd(22)} tier=${n.tier.padEnd(11)} chain=${String(n.chain).padEnd(16)} n=${n.n}`),`liveness survivors=${t.liveness.survivors} excluded=${t.liveness.excluded} ${JSON.stringify(t.liveness.byReason)}`].join(`
+`)}function ar(e){let t=e._[1];if(!t)throw new Error("usage: quote <TICKER>");let n=dt({ticker:t,sizeUsd:e.size,horizonHours:e.horizon});return e.json?JSON.stringify(qe(n),null,2):ir(n)}function cr(e){let t=e._[1];if(!t)throw new Error("usage: prepare <TICKER> --recipient 0x...");if(!e.recipient)throw new Error("--recipient is required");let n=bt({ticker:t,sizeUsd:e.size,recipient:e.recipient});if(e.json)return JSON.stringify(qe(n),null,2);if(!n.ok)return`prepare ${t.toUpperCase()} FAILED (${n.failureKind}): ${n.error||n.note}`;let r=n.artifact;return[`prepare ${t.toUpperCase()}`,`  chainId=${r.chainId} to=${r.to}`,`  requiresWalletSignature=${r.requiresWalletSignature} backendSigner=${r.backendSigner}`,`  approval spender=${r.requiresApproval?.spender} token=${r.requiresApproval?.token}`,`  quoteAgeMs=${r.quoteAgeMs}`,...(r.notes||[]).map(s=>`  note: ${s}`)].join(`
+`)}function lr(e=process.argv.slice(2)){if(e.length===0||e[0]==="-h"||e[0]==="--help")return process.stdout.write(ht()),0;let t=or(e),n=t._[0],r;if(n==="venues")r=ur(t);else if(n==="quote")r=ar(t);else if(n==="prepare")r=cr(t);else throw new Error(`unknown command ${n}
+${ht()}`);return process.stdout.write(r+`
+`),0}function fr(){if(!process.argv[1])return!1;try{return yt(sr(import.meta.url))===yt(process.argv[1])}catch{return!1}}if(fr())try{process.exit(lr())}catch(e){process.stderr.write(String(e.message||e)+`
+`),process.exit(1)}export{lr as main};

package/dist/bin/oracle-init.mjs

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
-import s from"node:fs";import n from"node:path";import h from"node:os";import{randomBytes as M}from"node:crypto";import{execFileSync as x}from"node:child_process";import{fileURLToPath as b}from"node:url";var R=n.resolve(n.dirname(b(import.meta.url)),".."),$=n.join(R,"profiles"),w=n.join(R,"skills"),g=process.argv.slice(2),d=g.includes("--apply"),I=g.includes("--force"),A=g.includes("--json"),L=(()=>{let e=g.indexOf("--only");return e>=0?g[e+1]:null})(),l=(...e)=>{A||console.log(...e)};function U(){return JSON.parse(s.readFileSync(n.join($,"profile.schema.json"),"utf8"))}function N(e,t,i){let r=[],o=t.required||[];for(let a of o)e[a]===void 0&&r.push(`missing required field: ${a}`);e.id&&!/^[a-z_][a-z0-9-]*$/.test(e.id)&&r.push(`id "${e.id}" must be lowercase, no dots (Hermes rejects dots)`);let p=t.properties.role.enum;e.role&&!p.includes(e.role)&&r.push(`role "${e.role}" not one of ${p.join(", ")}`);let u=e.posture||{};u.default!=="DISARMED"&&r.push("posture.default must be DISARMED -- a lane that ships armed is a bug"),u.signing&&!["none","user-wallet"].includes(u.signing)&&r.push(`posture.signing "${u.signing}" invalid -- Oracle holds no keys`);let c=t.properties.posture.properties.grantActions.items.enum;for(let a of u.grantActions||[])c.includes(a)||r.push(`grantAction "${a}" not allowed (broadcast/sign actions are forbidden)`);typeof u.rationale=="string"&&u.rationale.length<20&&r.push("posture.rationale too short -- justify the grant");for(let a of e.skills||[])i.has(a)||r.push(`skill "${a}" does not exist in skills/`);return r}function P(){if(!s.existsSync(w))return new Map;let e=new Map;for(let t of s.readdirSync(w,{withFileTypes:!0})){if(!t.isDirectory())continue;let i=n.join(w,t.name,"SKILL.md");s.existsSync(i)&&e.set(t.name,i)}return e}function J(){if(!s.existsSync($))return[];let e=[];for(let t of s.readdirSync($,{withFileTypes:!0})){if(!t.isDirectory())continue;let i=n.join($,t.name,"profile.json");if(!s.existsSync(i))continue;let r=JSON.parse(s.readFileSync(i,"utf8"));r.__dir=n.join($,t.name),e.push(r)}return e}function K(){try{return x("hermes",["--version"],{stdio:"pipe",timeout:2e4}),!0}catch{return!1}}function j(){let e=(process.env.HERMES_HOME||"").trim();if(e){let t=e.split(n.sep),i=t.lastIndexOf("profiles");return i>0&&i===t.length-2?t.slice(0,i).join(n.sep):e}return n.join(h.homedir(),".hermes")}function B(e){try{let t=x("hermes",["profile","list"],{encoding:"utf8",timeout:3e4});return new RegExp(`(^|\\s)${e}(\\s|$)`,"m").test(t)}catch{return!1}}var D=[],S=[],E=[];function F(e,t){try{return s.readFileSync(e,"utf8")===s.readFileSync(t,"utf8")}catch{return!1}}function f(e,t){D.push({kind:e,detail:t,applied:d}),l(`${d?"  \u2714":"  \xB7"} ${e}: ${t}`)}function H(e){return e===""||/[:#\[\]{},&*!|>'"%@`\s]/.test(e)||/^(?:null|true|false|\d+)$/i.test(e)?JSON.stringify(e):e}function q(e,t){return[`  ${e}:`,"    command: node","    args:",`      - ${H(t)}`,"    enabled: true"].join(`
-`)}function z(e,t,i){let r=q(t,i);if(!s.existsSync(e))return s.writeFileSync(e,`mcp_servers:
-${r}
-`,"utf8"),"created";let o=s.readFileSync(e,"utf8");if(o.includes(i)&&new RegExp(`^\\s*${t}:\\s*$`,"m").test(o))return"present";let p=new RegExp(`^([ \\t]*)${t}:\\s*\\n(?:\\1[ \\t]+.*\\n)*`,"m");return p.test(o)?(o=o.replace(p,`${r}
-`),s.writeFileSync(e,o,"utf8"),"updated"):(/^mcp_servers:\s*$/m.test(o)||/^mcp_servers:\s*\n/m.test(o)?o=o.replace(/^(mcp_servers:\s*\n)/m,`$1${r}
-`):/^_config_version:.*$/m.test(o)?o=o.replace(/^(_config_version:.*\n)/m,`$1mcp_servers:
-${r}
-`):o=`mcp_servers:
-${r}
-${o}`,s.writeFileSync(e,o,"utf8"),"wired")}var Y=U(),_=P(),C=new Set(_.keys()),m=J();m=m.filter(e=>!e.template);L&&(m=m.filter(e=>e.id===L));l(`oracle-init ${d?"(APPLY)":"(dry run -- pass --apply to install)"}`);l(`  profiles: ${m.length}   skills: ${_.size}`);var T=[];for(let e of m){let t=N(e,Y,C);t.length&&T.push({id:e.id,errors:t})}if(T.length){if(A)process.stdout.write(`${JSON.stringify({ok:!1,invalid:T},null,2)}
+import n from"node:fs";import o from"node:path";import m from"node:os";import{randomBytes as H}from"node:crypto";import{execFileSync as F}from"node:child_process";import{fileURLToPath as q}from"node:url";import{existsSync as M,readFileSync as J}from"node:fs";import{dirname as C,join as O}from"node:path";import{fileURLToPath as B}from"node:url";function K(e){let t=C(B(e));for(let s=0;s<8;s+=1){let i=O(t,"package.json");if(M(i))try{let d=JSON.parse(J(i,"utf8"));if(d&&typeof d.version=="string")return t}catch{}let r=C(t);if(r===t)break;t=r}throw new Error(`oracle: could not resolve package root from ${e}`)}function R(e,t){let s=K(t),i=O(s,"dist","assets",e);return M(i)?i:O(s,e)}var z=o.dirname(q(import.meta.url)),$=R("profiles",import.meta.url),E=R("skills",import.meta.url),g=process.argv.slice(2),p=g.includes("--apply"),I=g.includes("--force"),D=g.includes("--json"),b=(()=>{let e=g.indexOf("--only");return e>=0?g[e+1]:null})(),l=(...e)=>{D||console.log(...e)};function W(){return JSON.parse(n.readFileSync(o.join($,"profile.schema.json"),"utf8"))}function Y(e,t,s){let i=[],r=t.required||[];for(let a of r)e[a]===void 0&&i.push(`missing required field: ${a}`);e.id&&!/^[a-z_][a-z0-9-]*$/.test(e.id)&&i.push(`id "${e.id}" must be lowercase, no dots (Hermes rejects dots)`);let d=t.properties.role.enum;e.role&&!d.includes(e.role)&&i.push(`role "${e.role}" not one of ${d.join(", ")}`);let u=e.posture||{};u.default!=="DISARMED"&&i.push("posture.default must be DISARMED -- a lane that ships armed is a bug"),u.signing&&!["none","user-wallet"].includes(u.signing)&&i.push(`posture.signing "${u.signing}" invalid -- Oracle holds no keys`);let c=t.properties.posture.properties.grantActions.items.enum;for(let a of u.grantActions||[])c.includes(a)||i.push(`grantAction "${a}" not allowed (broadcast/sign actions are forbidden)`);typeof u.rationale=="string"&&u.rationale.length<20&&i.push("posture.rationale too short -- justify the grant");for(let a of e.skills||[])s.has(a)||i.push(`skill "${a}" does not exist in skills/`);return i}function G(){if(!n.existsSync(E))return new Map;let e=new Map;for(let t of n.readdirSync(E,{withFileTypes:!0})){if(!t.isDirectory())continue;let s=o.join(E,t.name,"SKILL.md");n.existsSync(s)&&e.set(t.name,s)}return e}function Q(){if(!n.existsSync($))return[];let e=[];for(let t of n.readdirSync($,{withFileTypes:!0})){if(!t.isDirectory())continue;let s=o.join($,t.name,"profile.json");if(!n.existsSync(s))continue;let i=JSON.parse(n.readFileSync(s,"utf8"));i.__dir=o.join($,t.name),e.push(i)}return e}function V(){try{return F("hermes",["--version"],{stdio:"pipe",timeout:2e4}),!0}catch{return!1}}function L(){let e=(process.env.HERMES_HOME||"").trim();if(e){let t=e.split(o.sep),s=t.lastIndexOf("profiles");return s>0&&s===t.length-2?t.slice(0,s).join(o.sep):e}return o.join(m.homedir(),".hermes")}function X(e){try{let t=F("hermes",["profile","list"],{encoding:"utf8",timeout:3e4});return new RegExp(`(^|\\s)${e}(\\s|$)`,"m").test(t)}catch{return!1}}var U=[],h=[],k=[];function N(e,t){try{return n.readFileSync(e,"utf8")===n.readFileSync(t,"utf8")}catch{return!1}}function f(e,t){U.push({kind:e,detail:t,applied:p}),l(`${p?"  \u2714":"  \xB7"} ${e}: ${t}`)}function Z(e){return e===""||/[:#\[\]{},&*!|>'"%@`\s]/.test(e)||/^(?:null|true|false|\d+)$/i.test(e)?JSON.stringify(e):e}function ee(e,t){return[`  ${e}:`,"    command: node","    args:",`      - ${Z(t)}`,"    enabled: true"].join(`
+`)}function te(e,t,s){let i=ee(t,s);if(!n.existsSync(e))return n.writeFileSync(e,`mcp_servers:
+${i}
+`,"utf8"),"created";let r=n.readFileSync(e,"utf8");if(r.includes(s)&&new RegExp(`^\\s*${t}:\\s*$`,"m").test(r))return"present";let d=new RegExp(`^([ \\t]*)${t}:\\s*\\n(?:\\1[ \\t]+.*\\n)*`,"m");return d.test(r)?(r=r.replace(d,`${i}
+`),n.writeFileSync(e,r,"utf8"),"updated"):(/^mcp_servers:\s*$/m.test(r)||/^mcp_servers:\s*\n/m.test(r)?r=r.replace(/^(mcp_servers:\s*\n)/m,`$1${i}
+`):/^_config_version:.*$/m.test(r)?r=r.replace(/^(_config_version:.*\n)/m,`$1mcp_servers:
+${i}
+`):r=`mcp_servers:
+${i}
+${r}`,n.writeFileSync(e,r,"utf8"),"wired")}var ne=W(),_=G(),P=new Set(_.keys()),S=Q();S=S.filter(e=>!e.template);b&&(S=S.filter(e=>e.id===b));l(`oracle-init ${p?"(APPLY)":"(dry run -- pass --apply to install)"}`);l(`  profiles: ${S.length}   skills: ${_.size}`);var T=[];for(let e of S){let t=Y(e,ne,P);t.length&&T.push({id:e.id,errors:t})}if(T.length){if(D)process.stdout.write(`${JSON.stringify({ok:!1,invalid:T},null,2)}
 `);else{console.error(`
-validation failed:`);for(let e of T){console.error(`  ${e.id}:`);for(let t of e.errors)console.error(`    - ${t}`)}}process.exit(1)}l("  validation: ok");{let e=n.join(h.homedir(),".config","oracle"),t=n.join(e,"exec.env"),i=!!(process.env.ORACLE_ROUTE_ATTESTATION_SECRET||process.env.MAD_ROUTE_ATTESTATION_SECRET);if(!i&&s.existsSync(t))try{let r=s.readFileSync(t,"utf8");i=/^ORACLE_ROUTE_ATTESTATION_SECRET=.+$/m.test(r)||/^MAD_ROUTE_ATTESTATION_SECRET=.+$/m.test(r)}catch{}if(i)f("attestation secret","present");else if(f("attestation secret",`generate -> ${n.relative(h.homedir(),t)}`),d){s.mkdirSync(e,{recursive:!0,mode:448});try{s.chmodSync(e,448)}catch{}let o=`ORACLE_ROUTE_ATTESTATION_SECRET=${M(32).toString("hex")}
-`;if(s.existsSync(t)){let p=s.readFileSync(t,"utf8");!/ORACLE_ROUTE_ATTESTATION_SECRET=/.test(p)&&!/MAD_ROUTE_ATTESTATION_SECRET=/.test(p)&&s.appendFileSync(t,p.endsWith(`
-`)||p.length===0?o:`
-${o}`,{mode:384})}else s.writeFileSync(t,o,{mode:384});try{s.chmodSync(t,384)}catch{}}}var v=K();l(v?"  hermes CLI: found":`  hermes CLI: not found -- installing profile files directly.
+validation failed:`);for(let e of T){console.error(`  ${e.id}:`);for(let t of e.errors)console.error(`    - ${t}`)}}process.exit(1)}l("  validation: ok");{let e=o.join(m.homedir(),".config","oracle"),t=o.join(e,"exec.env"),s=!!(process.env.ORACLE_ROUTE_ATTESTATION_SECRET||process.env.MAD_ROUTE_ATTESTATION_SECRET);if(!s&&n.existsSync(t))try{let i=n.readFileSync(t,"utf8");s=/^ORACLE_ROUTE_ATTESTATION_SECRET=.+$/m.test(i)||/^MAD_ROUTE_ATTESTATION_SECRET=.+$/m.test(i)}catch{}if(s)f("attestation secret","present");else if(f("attestation secret",`generate -> ${o.relative(m.homedir(),t)}`),p){n.mkdirSync(e,{recursive:!0,mode:448});try{n.chmodSync(e,448)}catch{}let r=`ORACLE_ROUTE_ATTESTATION_SECRET=${H(32).toString("hex")}
+`;if(n.existsSync(t)){let d=n.readFileSync(t,"utf8");!/ORACLE_ROUTE_ATTESTATION_SECRET=/.test(d)&&!/MAD_ROUTE_ATTESTATION_SECRET=/.test(d)&&n.appendFileSync(t,d.endsWith(`
+`)||d.length===0?r:`
+${r}`,{mode:384})}else n.writeFileSync(t,r,{mode:384});try{n.chmodSync(t,384)}catch{}}}var v=V();l(v?"  hermes CLI: found":`  hermes CLI: not found -- installing profile files directly.
     (Hermes discovers any directory under <root>/profiles/, so this works.
-     MCP wiring is the one step that needs the CLI; instructions printed at the end.)`);for(let e of m){l(`
-${e.label} (${e.id})`);let t=n.join(j(),"profiles",e.id),i=n.join(t,"SOUL.md"),r=s.existsSync(i),o=new Map((e.skills||[]).map(c=>[c,s.existsSync(n.join(t,"skills",c,"SKILL.md"))]));if(v?B(e.id):s.existsSync(t))f("profile exists",e.id);else if(v){if(f("create profile",e.id),d)try{x("hermes",["profile","create",e.id],{stdio:"pipe",timeout:12e4})}catch{f("create note",`hermes profile create failed for ${e.id}; writing files directly`)}}else f("create profile dir",e.id),d&&s.mkdirSync(t,{recursive:!0});let u=n.join(e.__dir,"SOUL.md");if(s.existsSync(u)){let c=r&&!F(u,i);if(c&&!I)f("SKIP SOUL.md (exists)",`${n.relative(h.homedir(),i)} -- kept yours; --force to overwrite`),S.push({lane:e.id,file:"SOUL.md",reason:"already exists"});else if(f("install SOUL.md",n.relative(h.homedir(),i)),d){if(s.mkdirSync(n.dirname(i),{recursive:!0}),c){let a=`${i}.bak-oracle-init-${Date.now()}`;s.copyFileSync(i,a),f("backed up",n.relative(h.homedir(),a))}s.copyFileSync(u,i)}}for(let c of e.skills||[]){let a=n.join(t,"skills",c,"SKILL.md");if(o.get(c)&&!F(_.get(c),a)&&!I){f("SKIP skill (exists)",`${c} -> ${e.id}`),S.push({lane:e.id,file:`skills/${c}`,reason:"already exists"});continue}f("install skill",`${c} -> ${e.id}`),d&&(s.mkdirSync(n.dirname(a),{recursive:!0}),s.copyFileSync(_.get(c),a))}for(let c of e.mcp||[]){let a=n.join(R,"bin","oracle-data-mcp.mjs"),y=n.join(t,"config.yaml"),k=`hermes -p ${e.id} mcp add ${c} --command node --args ${a}`;if(c!=="oracle-data"){f("mcp manual",k),E.push({lane:e.id,server:c,command:k});continue}if(f("wire mcp",`${c} (${e.id}) -> ${n.relative(h.homedir(),y)}`),d)try{s.mkdirSync(t,{recursive:!0});let O=z(y,c,a);f("mcp config",`${O}: ${n.relative(h.homedir(),y)}`)}catch(O){f("mcp note",`could not write ${y}: ${O.message}`),E.push({lane:e.id,server:c,command:k})}}f("posture",`DISARMED (${(e.posture.grantActions||[]).join(", ")})`)}var W={ok:!0,applied:d,profiles:m.map(e=>e.id),skills:[...C],actions:D.length,skipped:S,mcpManual:E,hermesDetected:v,hermesRoot:j()};if(A)process.stdout.write(`${JSON.stringify(W,null,2)}
+     MCP wiring is the one step that needs the CLI; instructions printed at the end.)`);for(let e of S){l(`
+${e.label} (${e.id})`);let t=o.join(L(),"profiles",e.id),s=o.join(t,"SOUL.md"),i=n.existsSync(s),r=new Map((e.skills||[]).map(c=>[c,n.existsSync(o.join(t,"skills",c,"SKILL.md"))]));if(v?X(e.id):n.existsSync(t))f("profile exists",e.id);else if(v){if(f("create profile",e.id),p)try{F("hermes",["profile","create",e.id],{stdio:"pipe",timeout:12e4})}catch{f("create note",`hermes profile create failed for ${e.id}; writing files directly`)}}else f("create profile dir",e.id),p&&n.mkdirSync(t,{recursive:!0});let u=o.join(e.__dir,"SOUL.md");if(n.existsSync(u)){let c=i&&!N(u,s);if(c&&!I)f("SKIP SOUL.md (exists)",`${o.relative(m.homedir(),s)} -- kept yours; --force to overwrite`),h.push({lane:e.id,file:"SOUL.md",reason:"already exists"});else if(f("install SOUL.md",o.relative(m.homedir(),s)),p){if(n.mkdirSync(o.dirname(s),{recursive:!0}),c){let a=`${s}.bak-oracle-init-${Date.now()}`;n.copyFileSync(s,a),f("backed up",o.relative(m.homedir(),a))}n.copyFileSync(u,s)}}for(let c of e.skills||[]){let a=o.join(t,"skills",c,"SKILL.md");if(r.get(c)&&!N(_.get(c),a)&&!I){f("SKIP skill (exists)",`${c} -> ${e.id}`),h.push({lane:e.id,file:`skills/${c}`,reason:"already exists"});continue}f("install skill",`${c} -> ${e.id}`),p&&(n.mkdirSync(o.dirname(a),{recursive:!0}),n.copyFileSync(_.get(c),a))}for(let c of e.mcp||[]){let a=o.join(z,"oracle-data-mcp.mjs"),y=o.join(t,"config.yaml"),x=`hermes -p ${e.id} mcp add ${c} --command node --args ${a}`;if(c!=="oracle-data"){f("mcp manual",x),k.push({lane:e.id,server:c,command:x});continue}if(f("wire mcp",`${c} (${e.id}) -> ${o.relative(m.homedir(),y)}`),p)try{n.mkdirSync(t,{recursive:!0});let w=te(y,c,a);f("mcp config",`${w}: ${o.relative(m.homedir(),y)}`)}catch(w){f("mcp note",`could not write ${y}: ${w.message}`),k.push({lane:e.id,server:c,command:x})}}f("posture",`DISARMED (${(e.posture.grantActions||[]).join(", ")})`)}var A=o.join(m.homedir(),".config","oracle","skills"),j=E;if(p&&n.existsSync(j)){n.mkdirSync(A,{recursive:!0});let e=0;for(let t of n.readdirSync(j,{withFileTypes:!0})){if(!t.isFile()||!t.name.endsWith(".md"))continue;let s=o.join(j,t.name),i=o.join(A,t.name);if(!I&&n.existsSync(i)){h.push({lane:"standalone",file:t.name});continue}try{n.copyFileSync(s,i),e++}catch(r){f("skill copy",`failed ${t.name}: ${r.message}`)}}e&&l(`  standalone skills: ${e} installed to ${A}`)}var se={ok:!0,applied:p,profiles:S.map(e=>e.id),skills:[...P],actions:U.length,skipped:h,mcpManual:k,hermesDetected:v,hermesRoot:L()};if(D)process.stdout.write(`${JSON.stringify(se,null,2)}
 `);else{if(l(`
-${d?"installed":"would install"} ${m.length} lanes.`),S.length){l(`${S.length} file(s) already existed and were kept:`);for(let e of S)l(`  - ${e.lane}/${e.file}`);l("pass --force to overwrite (a timestamped .bak is written first).")}if(E.length){l(`
-MCP wiring needed a manual follow-up:`);for(let e of E)l(`  ${e.command}`)}d||l("re-run with --apply to make changes."),l(`
+${p?"installed":"would install"} ${S.length} lanes.`),h.length){l(`${h.length} file(s) already existed and were kept:`);for(let e of h)l(`  - ${e.lane}/${e.file}`);l("pass --force to overwrite (a timestamped .bak is written first).")}if(k.length){l(`
+MCP wiring needed a manual follow-up:`);for(let e of k)l(`  ${e.command}`)}p||l("re-run with --apply to make changes."),l(`
 Every lane is DISARMED. Start the read plane, then chat a lane:`),l("  npx oracle-data                 # 127.0.0.1:8787 \u2014 MCP tools need this"),l("  hermes -p oracle chat"),l(`
-Set each lane's model in:`),l(`  ${n.join(j(),"profiles","<lane>","config.yaml")}`)}
+Set each lane's model in:`),l(`  ${o.join(L(),"profiles","<lane>","config.yaml")}`)}