jcc_hyper_tool 0.1.4 → 0.1.6

package/dist/advisor/guards.js

@@ -0,0 +1,198 @@
+import { ConfigError } from "../core/errors.js";
+import { mergeUserProfileDefaults } from "../core/state/profileStore.js";
+import { assertMinPerpOrderNotional } from "../core/hyperliquid/rounding.js";
+import { isAdvisorBracketOpenAction } from "./actionSchema.js";
+import { findActiveProtectionBracket, hasActiveUnexpiredAmbush, resolvePositionOpenAgeSec, } from "./ambushPolicy.js";
+import { buildActivePositionPlan, unrealizedPnlPct } from "./positionPlan.js";
+import { resolveAdvisorMinSz, resolveAdvisorSzCap } from "./executionPolicy.js";
+import { assertBracketTpslGeometry, assertBracketTouchProbability } from "./tpslPolicy.js";
+import { computeAtr, computeBracketTouchProbabilities, parseCandlesFromSnapshot, } from "./touchProbability.js";
+function effectiveRequireTpsl(inputs) {
+    if (inputs.requireTpsl !== undefined) {
+        return inputs.requireTpsl;
+    }
+    return mergeUserProfileDefaults(inputs.profile).requireTpsl;
+}
+function defaultProtectionGraceSec(profile) {
+    return mergeUserProfileDefaults(profile).protectionGraceSec ?? 360;
+}
+function defaultMinClosePnlPct(profile) {
+    return mergeUserProfileDefaults(profile).minClosePnlPct ?? 0.01;
+}
+function assertClosePositionDiscipline(action, inputs) {
+    const pos = inputs.positionSignedSz;
+    const p = mergeUserProfileDefaults(inputs.profile);
+    const graceSec = defaultProtectionGraceSec(inputs.profile);
+    const minPnlPct = defaultMinClosePnlPct(inputs.profile);
+    const antiRushSec = p.antiRushCloseMinSec ?? 0;
+    const mid = inputs.mid;
+    const posRow = inputs.positionEntryPx;
+    const plan = inputs.tradeState && inputs.nowMs !== undefined
+        ? buildActivePositionPlan({
+            state: inputs.tradeState,
+            coin: inputs.coin,
+            nowMs: inputs.nowMs,
+            mid,
+            positionSignedSz: pos,
+            positionEntryPx: inputs.positionEntryPx,
+        })
+        : undefined;
+    const openAgeSec = plan?.open_age_sec ??
+        (inputs.tradeState && inputs.nowMs !== undefined
+            ? resolvePositionOpenAgeSec({
+                state: inputs.tradeState,
+                coin: inputs.coin,
+                nowMs: inputs.nowMs,
+            })
+            : undefined);
+    if (plan?.protection_pending && openAgeSec !== undefined && openAgeSec < graceSec) {
+        throw new ConfigError(`advise: close_position blocked (protection grace): bracket ${plan.intent_id} phase ${plan.phase}; TP/SL will be placed by reconcile (~${Math.ceil(graceSec - openAgeSec)}s grace left). Wait — do not treat as "裸仓".`);
+    }
+    if (!plan && openAgeSec !== undefined && openAgeSec < graceSec && inputs.tradeState) {
+        const maybeBracket = findActiveProtectionBracket(inputs.tradeState, inputs.coin);
+        if (maybeBracket) {
+            throw new ConfigError(`advise: close_position blocked (protection grace): wait for bracket ${maybeBracket.id} to finish reconcile before closing.`);
+        }
+    }
+    const tpUnreachable = action.tp_unreachable === true;
+    const refEntry = plan ? (posRow ?? plan.entry_limit_px) : posRow;
+    const pnlPct = plan && mid !== null && mid > 0 && refEntry !== undefined
+        ? unrealizedPnlPct(pos, refEntry, mid)
+        : undefined;
+    if (plan?.protection_active &&
+        !plan.tp_sl_hit &&
+        mid !== null &&
+        mid > 0 &&
+        pnlPct !== undefined &&
+        Math.abs(pnlPct) < minPnlPct) {
+        throw new ConfigError(`advise: close_position blocked (SL active): unrealized ${(pnlPct * 100).toFixed(2)}% below min ${(minPnlPct * 100).toFixed(2)}%; SL ${plan.sl_px} defines max loss — wait for TP/SL, do not close on small noise (tp_unreachable ignored).`);
+    }
+    if (plan && mid !== null && mid > 0 && !tpUnreachable) {
+        if (plan.tp_sl_hit) {
+            return;
+        }
+        if (antiRushSec > 0 && openAgeSec !== undefined && openAgeSec < antiRushSec) {
+            throw new ConfigError(`advise: close_position blocked (anti-rush): open ~${Math.floor(openAgeSec)}s < ${antiRushSec}s; TP ${plan.tp_px} / SL ${plan.sl_px} at mid ${mid}.`);
+        }
+        if (plan.trend_toward_tp) {
+            throw new ConfigError(`advise: close_position blocked: price trending toward TP ${plan.tp_px} (progress ${plan.progress_to_tp !== null ? (plan.progress_to_tp * 100).toFixed(0) : "?"}%); use wait, or set tp_unreachable=true with thesis that TP will not be reached.`);
+        }
+        if (pnlPct !== undefined &&
+            Math.abs(pnlPct) < minPnlPct &&
+            openAgeSec !== undefined &&
+            (antiRushSec <= 0 || openAgeSec < antiRushSec)) {
+            throw new ConfigError(`advise: close_position blocked: unrealized move ${(pnlPct * 100).toFixed(2)}% below min ${(minPnlPct * 100).toFixed(2)}%; wait for TP/SL or mark tp_unreachable=true if thesis broken.`);
+        }
+    }
+    if (plan && tpUnreachable && plan.trend_toward_tp && plan.progress_to_tp !== null && plan.progress_to_tp > 0.25) {
+        throw new ConfigError(`advise: close_position blocked: tp_unreachable contradicts plan (already ${(plan.progress_to_tp * 100).toFixed(0)}% toward TP ${plan.tp_px}); revise thesis or choose wait.`);
+    }
+}
+function effectiveDeviationMax(inputs) {
+    return mergeUserProfileDefaults(inputs.profile).priceDeviationPctMax;
+}
+/**
+ * Hard execution guards (do not rely on the model). Throws `ConfigError` when blocked.
+ */
+export function assertAdvisorActionPassesGuards(action, inputs) {
+    const maxSz = inputs.maxSz;
+    if (!Number.isFinite(maxSz) || maxSz <= 0) {
+        throw new ConfigError("advise: --max-sz must be a positive finite number.");
+    }
+    const szCap = resolveAdvisorSzCap(inputs);
+    const minSz = resolveAdvisorMinSz(inputs);
+    if (isAdvisorBracketOpenAction(action)) {
+        if (effectiveRequireTpsl(inputs)) {
+            if (!Number.isFinite(action.tp_px) || !Number.isFinite(action.sl_px)) {
+                throw new ConfigError(`advise: ${action.action} blocked (--require-tpsl): missing tp/sl.`);
+            }
+        }
+        if (action.action === "place_limit_ambush") {
+            if (!Number.isFinite(action.expires_in_min) || action.expires_in_min <= 0) {
+                throw new ConfigError("advise: place_limit_ambush requires positive expires_in_min.");
+            }
+            if (action.expires_in_min < 5 || action.expires_in_min > 120) {
+                throw new ConfigError("advise: place_limit_ambush expires_in_min should be between 5 and 120 minutes.");
+            }
+        }
+        if (minSz !== undefined && minSz > szCap) {
+            throw new ConfigError(`advise: profile min sz ${minSz} for ${inputs.coin} exceeds cap ${szCap} (--max-sz / profile).`);
+        }
+        if (minSz !== undefined && action.sz < minSz) {
+            throw new ConfigError(`advise: bracket sz ${action.sz} below profile min ${minSz} for ${inputs.coin}.`);
+        }
+        if (action.sz > szCap) {
+            throw new ConfigError(`advise: bracket sz ${action.sz} exceeds cap ${szCap} ( --max-sz / profile ).`);
+        }
+        const atr1h = inputs.kline1h !== undefined
+            ? computeAtr(parseCandlesFromSnapshot(inputs.kline1h))
+            : null;
+        if (inputs.szDecimals !== undefined) {
+            assertMinPerpOrderNotional({
+                sz: action.sz,
+                px: action.limit_px,
+                szDecimals: inputs.szDecimals,
+                label: `advise: ${action.action}`,
+            });
+        }
+        if (!inputs.skipEntryMidDeviation && inputs.mid !== null && inputs.mid > 0) {
+            const dev = Math.abs(action.limit_px - inputs.mid) / inputs.mid;
+            if (dev > effectiveDeviationMax(inputs)) {
+                throw new ConfigError(`advise: limit_px ${action.limit_px} deviates ${(dev * 100).toFixed(2)}% from mid ${inputs.mid}; max ${(effectiveDeviationMax(inputs) * 100).toFixed(2)}%.`);
+            }
+        }
+        assertBracketTpslGeometry(action, inputs.profile, inputs.mid, atr1h);
+        if (!inputs.skipTouchProb &&
+            action.action !== "place_limit_ambush" &&
+            inputs.kline1h !== undefined &&
+            inputs.mid !== null) {
+            const probs = computeBracketTouchProbabilities({
+                action,
+                spot: inputs.mid,
+                kline1h: inputs.kline1h,
+                analysis: action.analysis,
+                profile: inputs.profile,
+            });
+            assertBracketTouchProbability(action, probs, inputs.profile);
+        }
+    }
+    if (action.action === "cancel_all") {
+        const p = mergeUserProfileDefaults(inputs.profile);
+        if (p.forbidCancelAllWithActiveAmbush && inputs.tradeState && inputs.nowMs !== undefined) {
+            if (hasActiveUnexpiredAmbush(inputs.tradeState, inputs.coin, inputs.nowMs)) {
+                throw new ConfigError("advise: cancel_all blocked while unexpired TTL ambush entry is pending; wait for TTL or let reconcile replace stale orders.");
+            }
+        }
+    }
+    if (action.action === "close_position") {
+        const pos = inputs.positionSignedSz;
+        if (pos === undefined || !Number.isFinite(pos) || pos === 0) {
+            throw new ConfigError("advise: close_position blocked: no open position for this coin.");
+        }
+        if (action.method === "limit") {
+            if (action.limit_px === undefined || !Number.isFinite(action.limit_px)) {
+                throw new ConfigError("advise: close_position limit method requires limit_px.");
+            }
+            if (inputs.mid !== null && inputs.mid > 0) {
+                const dev = Math.abs(action.limit_px - inputs.mid) / inputs.mid;
+                if (dev > effectiveDeviationMax(inputs)) {
+                    throw new ConfigError(`advise: close limit_px deviates too far from mid (${(dev * 100).toFixed(2)}% > ${(effectiveDeviationMax(inputs) * 100).toFixed(2)}%).`);
+                }
+            }
+        }
+        if (action.method === "market" && inputs.mid === null) {
+            throw new ConfigError("advise: close_position market needs a valid mid price.");
+        }
+        assertClosePositionDiscipline(action, inputs);
+        if (inputs.szDecimals !== undefined && inputs.mid !== null && inputs.mid > 0) {
+            const closeSz = Math.min(Math.abs(pos), szCap);
+            assertMinPerpOrderNotional({
+                sz: closeSz,
+                px: inputs.mid,
+                szDecimals: inputs.szDecimals,
+                label: "advise: close_position",
+            });
+        }
+    }
+}
+//# sourceMappingURL=guards.js.map

package/dist/advisor/guards.js.map

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

package/dist/advisor/indicatorCompute.d.ts

@@ -0,0 +1,45 @@
+import type { JsonValue } from "../core/hyperliquid/types.js";
+export type IndicatorSummary = {
+    atr_5m: number | null;
+    atr_1h: number | null;
+    atr_1d: number | null;
+    /** ATR as % of current close (scale-invariant volatility). */
+    atr_pct_5m: string;
+    atr_pct_1h: string;
+    atr_pct_1d: string;
+    ema_5m: string;
+    ema_1h: string;
+    ema_1d: string;
+    macd_5m: string;
+    macd_1h: string;
+    macd_1d: string;
+    rsi_5m: number | null;
+    rsi_1h: number | null;
+    rsi_1d: number | null;
+    bollinger_5m: string;
+    bollinger_1h: string;
+    bollinger_1d: string;
+    /** Std of log-returns (per-candle), with per-period and annualised pct. */
+    log_return_vol_5m: string;
+    log_return_vol_1h: string;
+    log_return_vol_1d: string;
+    /** Price distance from SMA20 in standard deviations. */
+    zscore_5m: string;
+    zscore_1h: string;
+    zscore_1d: string;
+    volume_5m: string;
+    volume_1h: string;
+    volume_1d: string;
+};
+/** Compact candle for v2 prompt — h/l/o/c/v to support pattern + volume-price analysis. */
+export type CompactCandle = {
+    h: number;
+    l: number;
+    o: number;
+    c: number;
+    v: number;
+};
+export declare function computeIndicatorSummary(raw5m: JsonValue, raw1h: JsonValue, raw1d: JsonValue): IndicatorSummary;
+/** Build compact h/l/c candles for wave/Chan theory analysis in v2 mode. */
+export declare function buildCompactKlines(raw: JsonValue, maxBars: number): CompactCandle[];
+//# sourceMappingURL=indicatorCompute.d.ts.map

package/dist/advisor/indicatorCompute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indicatorCompute.d.ts","sourceRoot":"","sources":["../../src/advisor/indicatorCompute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAsOtF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,GACf,gBAAgB,CA+ClB;AAYD,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAIjB"}

package/dist/advisor/indicatorCompute.js

@@ -0,0 +1,259 @@
+import { EMA, MACD, RSI, BollingerBands, ATR } from "trading-signals";
+function parseCandlesWithVolume(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const row of raw) {
+        if (typeof row !== "object" || row === null)
+            continue;
+        const r = row;
+        const h = Number(r.h);
+        const l = Number(r.l);
+        const o = Number(r.o);
+        const c = Number(r.c);
+        const v = Number(r.v);
+        if (Number.isFinite(h) &&
+            Number.isFinite(l) &&
+            Number.isFinite(o) &&
+            Number.isFinite(c) &&
+            h >= l) {
+            out.push({ h, l, o, c, v: Number.isFinite(v) && v >= 0 ? v : 0 });
+        }
+    }
+    return out;
+}
+function emaLabel(candles, period) {
+    if (candles.length < period)
+        return null;
+    const ema = new EMA(period);
+    for (const c of candles)
+        ema.add(c.c);
+    return ema.isStable ? ema.getResultOrThrow().toFixed(4) : null;
+}
+function describeEmaAlignment(candles) {
+    // Pick the largest available period set based on candle count.
+    // EMA needs `period` candles to stabilise; pick the max set that fits.
+    const has60 = candles.length >= 61;
+    const has20 = candles.length >= 21;
+    const has5 = candles.length >= 6;
+    if (!has5)
+        return "数据不足无法计算EMA排列(需≥6根)";
+    const e5 = emaLabel(candles, 5);
+    const e20 = has20 ? emaLabel(candles, 20) : null;
+    const e60 = has60 ? emaLabel(candles, 60) : null;
+    const parts = [];
+    parts.push(`EMA5(${e5})`);
+    if (e20)
+        parts.push(`EMA20(${e20})`);
+    if (e60)
+        parts.push(`EMA60(${e60})`);
+    const v5 = Number(e5);
+    const v20 = e20 ? Number(e20) : null;
+    const v60 = e60 ? Number(e60) : null;
+    let alignment;
+    if (v60 !== null && v20 !== null) {
+        // Full three-line alignment
+        alignment =
+            v5 > v20 && v20 > v60 ? "多头排列"
+                : v5 < v20 && v20 < v60 ? "空头排列"
+                    : v5 > v20 ? "短期偏多(EMA5>EMA20)，长期EMA60待修复"
+                        : v5 < v20 ? "短期偏空(EMA5<EMA20)，长期EMA60支撑中"
+                            : "均线缠绕，方向不明";
+    }
+    else if (v20 !== null) {
+        // Two-line alignment (EMA5 vs EMA20)
+        alignment =
+            v5 > v20 ? "短期偏多(EMA5>EMA20)"
+                : v5 < v20 ? "短期偏空(EMA5<EMA20)"
+                    : "短期均线缠绕，方向不明";
+    }
+    else {
+        alignment = `仅EMA5可用(${e5})，数据不足以判断排列`;
+    }
+    const note = !has60 ? ` (仅${candles.length}根K线，EMA60不可用)`
+        : !has20 ? ` (仅${candles.length}根K线，EMA20/60不可用)`
+            : "";
+    return parts.join(" ") + ` — ${alignment}${note}`;
+}
+function describeMacd(candles) {
+    const shortEma = new EMA(12);
+    const longEma = new EMA(26);
+    const signalEma = new EMA(9);
+    const macd = new MACD(shortEma, longEma, signalEma);
+    for (const c of candles)
+        macd.add(c.c);
+    if (!macd.isStable)
+        return "数据不足无法计算MACD";
+    const r = macd.getResultOrThrow();
+    const dif = r.macd.toFixed(4);
+    const dea = r.signal.toFixed(4);
+    const hist = r.histogram.toFixed(4);
+    const histNum = Number(hist);
+    const difDeaRel = r.macd > r.signal ? `DIF(${dif})>DEA(${dea})` : `DIF(${dif})<DEA(${dea})`;
+    const histDir = histNum > 0.0001
+        ? "绿柱"
+        : histNum < -0.0001
+            ? "红柱"
+            : "柱近零";
+    const direction = histNum > 0 ? (r.macd > r.signal ? "多头动能增强" : "多头动能减弱") : "";
+    const parts = [difDeaRel, `柱${hist}`, histDir];
+    if (direction)
+        parts.push(direction);
+    // Simple divergence check: compare latest close direction vs MACD direction
+    // (We don't compare previous MACD values here — that's for the LLM to interpret)
+    return parts.join("，");
+}
+function computeRsi(candles, period = 14) {
+    if (candles.length < period + 1)
+        return null;
+    const rsi = new RSI(period);
+    for (const c of candles)
+        rsi.add(c.c);
+    return rsi.isStable ? Number(rsi.getResultOrThrow().toFixed(1)) : null;
+}
+function describeBollinger(candles) {
+    const bb = new BollingerBands(20, 2);
+    for (const c of candles)
+        bb.add(c.c);
+    if (!bb.isStable)
+        return "数据不足无法计算布林带";
+    const last = candles[candles.length - 1];
+    const { upper, middle, lower } = bb.getResultOrThrow();
+    const bandwidth = (upper - lower) / middle;
+    const posInBand = (last.c - lower) / (upper - lower);
+    const posLabel = posInBand > 0.9 ? "触及上轨" : posInBand > 0.65 ? "上轨区域" : posInBand < 0.1 ? "触及下轨" : posInBand < 0.35 ? "下轨区域" : "中轨附近";
+    const bwPct = (bandwidth * 100).toFixed(1);
+    const bwLabel = bandwidth > 0.08 ? "带宽较宽(高波动)" : bandwidth < 0.03 ? "带宽收窄(收缩待变)" : "带宽适中";
+    return `上轨${upper.toFixed(4)} 中轨${middle.toFixed(4)} 下轨${lower.toFixed(4)} — 价格在${posLabel}，${bwLabel}(${bwPct}%)`;
+}
+function describeVolume(candles) {
+    if (candles.length < 6)
+        return "数据不足";
+    const vols = candles.map((c) => c.v);
+    const recent = vols.slice(-3);
+    const baseline = vols.slice(0, -3);
+    if (baseline.length === 0)
+        return "数据不足";
+    const avgBaseline = baseline.reduce((s, v) => s + v, 0) / baseline.length;
+    if (avgBaseline <= 0)
+        return "无成交量数据";
+    const avgRecent = recent.reduce((s, v) => s + v, 0) / recent.length;
+    const ratio = avgRecent / avgBaseline;
+    const label = ratio > 2.0
+        ? "放量"
+        : ratio > 1.2
+            ? "温和放量"
+            : ratio < 0.5
+                ? "极度缩量"
+                : ratio < 0.8
+                    ? "缩量"
+                    : "量平";
+    return `${ratio.toFixed(1)}x均量(${label})`;
+}
+// ---------------------------------------------------------------------------
+// Log-return-based indicators
+// ---------------------------------------------------------------------------
+function logReturnVol(candles, window = 20) {
+    if (candles.length < window + 1)
+        return null;
+    const recent = candles.slice(-(window + 1));
+    const lr = [];
+    for (let i = 1; i < recent.length; i++) {
+        lr.push(Math.log(recent[i].c / recent[i - 1].c));
+    }
+    const mean = lr.reduce((s, r) => s + r, 0) / lr.length;
+    const variance = lr.reduce((s, r) => s + (r - mean) ** 2, 0) / (lr.length - 1 || 1);
+    return Math.sqrt(variance);
+}
+function describeLogReturnVol(candles, label, periodsPerYear) {
+    const perPeriod = logReturnVol(candles);
+    if (perPeriod === null)
+        return "数据不足无法计算波动率";
+    const periodPct = (perPeriod * 100).toFixed(2);
+    const annual = (perPeriod * Math.sqrt(periodsPerYear)) * 100;
+    const annualStr = Number.isFinite(annual) ? annual.toFixed(1) : "?";
+    const level = perPeriod > 0.03 ? "极高波动" : perPeriod > 0.015 ? "高波动" : perPeriod > 0.005 ? "中等波动" : "低波动";
+    return `${label}对数收益率 σ=${periodPct}%，年化≈${annualStr}% — ${level}`;
+}
+function computeZScore(candles, period = 20) {
+    if (candles.length < period)
+        return null;
+    const recent = candles.slice(-period);
+    const closes = recent.map((c) => c.c);
+    const mean = closes.reduce((s, v) => s + v, 0) / closes.length;
+    const variance = closes.reduce((s, v) => s + (v - mean) ** 2, 0) / (closes.length - 1 || 1);
+    const std = Math.sqrt(variance);
+    if (std === 0)
+        return 0;
+    return (closes[closes.length - 1] - mean) / std;
+}
+function describeZScore(candles, label) {
+    const z = computeZScore(candles);
+    if (z === null)
+        return "数据不足无法计算Z-Score";
+    const absZ = Math.abs(z);
+    const extreme = absZ > 2.5 ? "极端" : absZ > 1.5 ? "显著偏离" : absZ > 0.75 ? "略微偏离" : "在均值附近";
+    const dir = z > 0 ? "偏高" : z < 0 ? "偏低" : "等于均值";
+    return `${label} Z-Score(SMA20) ${z.toFixed(2)}σ — 价格${dir}，${extreme}`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function computeIndicatorSummary(raw5m, raw1h, raw1d) {
+    const c5m = parseCandlesWithVolume(raw5m);
+    const c1h = parseCandlesWithVolume(raw1h);
+    const c1d = parseCandlesWithVolume(raw1d);
+    const atr5m = computeAtrFromCandles(c5m);
+    const atr1h = computeAtrFromCandles(c1h);
+    const atr1d = computeAtrFromCandles(c1d);
+    const last5m = c5m.length > 0 ? c5m[c5m.length - 1].c : null;
+    const last1h = c1h.length > 0 ? c1h[c1h.length - 1].c : null;
+    const last1d = c1d.length > 0 ? c1d[c1d.length - 1].c : null;
+    const atrPct = (atr, close) => atr !== null && close !== null && close > 0
+        ? `ATR(${atr.toFixed(4)}) 占价格 ${((atr / close) * 100).toFixed(2)}%`
+        : "数据不足";
+    return {
+        atr_5m: atr5m,
+        atr_1h: atr1h,
+        atr_1d: atr1d,
+        atr_pct_5m: atrPct(atr5m, last5m),
+        atr_pct_1h: atrPct(atr1h, last1h),
+        atr_pct_1d: atrPct(atr1d, last1d),
+        ema_5m: describeEmaAlignment(c5m),
+        ema_1h: describeEmaAlignment(c1h),
+        ema_1d: describeEmaAlignment(c1d),
+        macd_5m: describeMacd(c5m),
+        macd_1h: describeMacd(c1h),
+        macd_1d: describeMacd(c1d),
+        rsi_5m: computeRsi(c5m),
+        rsi_1h: computeRsi(c1h),
+        rsi_1d: computeRsi(c1d),
+        bollinger_5m: describeBollinger(c5m),
+        bollinger_1h: describeBollinger(c1h),
+        bollinger_1d: describeBollinger(c1d),
+        log_return_vol_5m: describeLogReturnVol(c5m, "5m", 12 * 24 * 365),
+        log_return_vol_1h: describeLogReturnVol(c1h, "1h", 24 * 365),
+        log_return_vol_1d: describeLogReturnVol(c1d, "1d", 365),
+        zscore_5m: describeZScore(c5m, "5m"),
+        zscore_1h: describeZScore(c1h, "1h"),
+        zscore_1d: describeZScore(c1d, "1d"),
+        volume_5m: describeVolume(c5m),
+        volume_1h: describeVolume(c1h),
+        volume_1d: describeVolume(c1d),
+    };
+}
+function computeAtrFromCandles(candles, period = 14) {
+    if (candles.length < period + 1)
+        return null;
+    const atr = new ATR(period);
+    for (const c of candles)
+        atr.add({ high: c.h, low: c.l, close: c.c });
+    return atr.isStable ? Number(atr.getResultOrThrow().toFixed(4)) : null;
+}
+/** Build compact h/l/c candles for wave/Chan theory analysis in v2 mode. */
+export function buildCompactKlines(raw, maxBars) {
+    const parsed = parseCandlesWithVolume(raw);
+    const trimmed = parsed.length <= maxBars ? parsed : parsed.slice(-maxBars);
+    return trimmed.map((c) => ({ h: c.h, l: c.l, o: c.o, c: c.c, v: c.v }));
+}
+//# sourceMappingURL=indicatorCompute.js.map

package/dist/advisor/indicatorCompute.js.map

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

package/dist/advisor/positionPlan.d.ts

@@ -0,0 +1,33 @@
+import type { BracketIntentRecord, TradeStateFile } from "../core/state/schema.js";
+export type ActivePositionPlan = {
+    intent_id: string;
+    phase: string;
+    side: "buy" | "sell";
+    entry_limit_px: number;
+    tp_px: number;
+    sl_px: number;
+    /** Entry filled but reconcile has not placed TP/SL on book yet. */
+    protection_pending: boolean;
+    protection_active: boolean;
+    open_age_sec: number | null;
+    /** Mid is between entry and TP on the profitable side (thesis still working). */
+    trend_toward_tp: boolean;
+    tp_sl_hit: boolean;
+    /** Fraction of entry→TP distance covered (0 at entry, 1 at TP). */
+    progress_to_tp: number | null;
+    /** Trading strategy: scalp or ambush. */
+    strategy?: "scalp" | "ambush";
+};
+export declare function isTrendTowardTp(side: "buy" | "sell", mid: number, entryPx: number, tp: number, sl: number): boolean;
+export declare function progressTowardTp(side: "buy" | "sell", mid: number, entryPx: number, tp: number): number | null;
+export declare function findBestBracketPlanForPosition(state: TradeStateFile, coin: string, positionSignedSz: number | undefined): BracketIntentRecord | undefined;
+export declare function buildActivePositionPlan(params: {
+    state: TradeStateFile;
+    coin: string;
+    nowMs: number;
+    mid: number | null;
+    positionSignedSz: number | undefined;
+    positionEntryPx: number | undefined;
+}): ActivePositionPlan | undefined;
+export declare function unrealizedPnlPct(positionSignedSz: number, entryPx: number, mid: number): number;
+//# sourceMappingURL=positionPlan.d.ts.map

package/dist/advisor/positionPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionPlan.d.ts","sourceRoot":"","sources":["../../src/advisor/positionPlan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAInF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAYF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,KAAK,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAWT;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,KAAK,GAAG,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,mBAAmB,GAAG,SAAS,CA4CjC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG,kBAAkB,GAAG,SAAS,CA6DjC;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,CAQR"}