tickflow-assist 0.2.0

package/dist/tools/view-analysis.tool.d.ts

@@ -0,0 +1,8 @@
+import { AnalysisViewService } from "../services/analysis-view-service.js";
+export declare function viewAnalysisTool(analysisViewService: AnalysisViewService): {
+    name: string;
+    description: string;
+    run({ rawInput }: {
+        rawInput?: unknown;
+    }): Promise<string>;
+};

package/dist/tools/view-analysis.tool.js

@@ -0,0 +1,95 @@
+import { normalizeSymbol } from "../utils/symbol.js";
+function parseInput(rawInput) {
+    if (typeof rawInput === "string" && rawInput.trim()) {
+        const [symbol, secondToken, thirdToken] = rawInput.trim().split(/\s+/, 3);
+        const parsed = parseProfileAndLimit(secondToken, thirdToken);
+        return {
+            symbol,
+            profile: parsed.profile,
+            limit: parsed.limit,
+        };
+    }
+    if (typeof rawInput === "object" && rawInput !== null) {
+        const input = rawInput;
+        const symbol = String(input.symbol ?? "").trim();
+        if (symbol) {
+            const explicitLimit = normalizeLimit(input.limit ?? input.count);
+            const historyLimit = explicitLimit ??
+                (Boolean(input.history) ? 5 : undefined);
+            return {
+                symbol,
+                profile: normalizeProfile(input.profile ?? input.view ?? input.section),
+                limit: historyLimit ?? 1,
+            };
+        }
+    }
+    throw new Error("view-analysis requires a symbol");
+}
+function parseProfileAndLimit(secondToken, thirdToken) {
+    const secondLimit = normalizeLimit(secondToken);
+    if (secondLimit != null) {
+        return {
+            profile: "composite",
+            limit: secondLimit,
+        };
+    }
+    return {
+        profile: normalizeProfile(secondToken),
+        limit: normalizeLimit(thirdToken) ?? 1,
+    };
+}
+function normalizeProfile(rawValue) {
+    const value = String(rawValue ?? "").trim().toLowerCase();
+    switch (value) {
+        case "technical":
+        case "tech":
+        case "技术":
+        case "技术面":
+            return "technical";
+        case "financial":
+        case "fundamental":
+        case "fundamentals":
+        case "财务":
+        case "基本面":
+            return "financial";
+        case "news":
+        case "info":
+        case "资讯":
+        case "消息":
+        case "研报":
+            return "news";
+        case "all":
+        case "全部":
+        case "所有":
+            return "all";
+        case "composite":
+        case "full":
+        case "综合":
+        case "综合分析":
+        case "":
+            return "composite";
+        default:
+            return "composite";
+    }
+}
+function normalizeLimit(rawValue) {
+    if (rawValue == null || rawValue === "") {
+        return undefined;
+    }
+    const value = Number(rawValue);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error("view-analysis limit must be > 0");
+    }
+    return Math.min(Math.trunc(value), 20);
+}
+export function viewAnalysisTool(analysisViewService) {
+    return {
+        name: "view_analysis",
+        description: "View latest or recent saved analyses for a symbol. Supports composite, technical, financial, news, or all.",
+        async run({ rawInput }) {
+            const input = parseInput(rawInput);
+            const symbol = normalizeSymbol(input.symbol);
+            return analysisViewService.render(symbol, input.profile, input.limit);
+        },
+    };
+}

package/dist/types/daily-update.d.ts

@@ -0,0 +1,26 @@
+export type DailyUpdateResultType = "success" | "skipped" | "failed";
+export interface DailyUpdateState {
+    running: boolean;
+    startedAt: string | null;
+    lastStoppedAt: string | null;
+    workerPid: number | null;
+    expectedStop: boolean;
+    runtimeHost: "project_scheduler" | "plugin_service" | null;
+    runtimeObservedAt: string | null;
+    runtimeConfigSource: "openclaw_plugin" | "local_config" | null;
+    lastHeartbeatAt: string | null;
+    lastAttemptAt: string | null;
+    lastAttemptDate: string | null;
+    lastSuccessAt: string | null;
+    lastSuccessDate: string | null;
+    lastResultType: DailyUpdateResultType | null;
+    lastResultSummary: string | null;
+    consecutiveFailures: number;
+    lastReviewAttemptAt: string | null;
+    lastReviewAttemptDate: string | null;
+    lastReviewSuccessAt: string | null;
+    lastReviewSuccessDate: string | null;
+    lastReviewResultType: DailyUpdateResultType | null;
+    lastReviewResultSummary: string | null;
+    reviewConsecutiveFailures: number;
+}

package/dist/types/daily-update.js

@@ -0,0 +1 @@
+export {};

package/dist/types/domain.d.ts

@@ -0,0 +1,140 @@
+export interface WatchlistItem {
+    symbol: string;
+    name: string;
+    costPrice: number | null;
+    addedAt: string;
+    sector: string | null;
+    themes: string[];
+    themeQuery: string | null;
+    themeUpdatedAt: string | null;
+}
+export interface QuoteSnapshot {
+    symbol: string;
+    name: string;
+    lastPrice: number;
+    prevClose: number;
+    timestamp: number;
+}
+export interface KeyLevels {
+    symbol?: string;
+    analysis_date?: string;
+    current_price: number;
+    stop_loss?: number | null;
+    breakthrough?: number | null;
+    support?: number | null;
+    cost_level?: number | null;
+    resistance?: number | null;
+    take_profit?: number | null;
+    gap?: number | null;
+    target?: number | null;
+    round_number?: number | null;
+    analysis_text: string;
+    score: number;
+}
+export interface AnalysisLogEntry {
+    symbol: string;
+    analysis_date: string;
+    analysis_text: string;
+    structured_ok: boolean;
+}
+export type AnalysisBias = "positive" | "neutral" | "negative";
+export interface AnalysisLevelsSnapshot {
+    current_price: number | null;
+    stop_loss: number | null;
+    breakthrough: number | null;
+    support: number | null;
+    cost_level: number | null;
+    resistance: number | null;
+    take_profit: number | null;
+    gap: number | null;
+    target: number | null;
+    round_number: number | null;
+    score: number | null;
+}
+export interface KeyLevelsHistoryEntry extends AnalysisLevelsSnapshot {
+    symbol: string;
+    analysis_date: string;
+    activated_at: string;
+    profile: "composite";
+    analysis_text: string;
+}
+export interface TechnicalAnalysisEntry extends AnalysisLevelsSnapshot {
+    symbol: string;
+    analysis_date: string;
+    analysis_text: string;
+    structured_ok: boolean;
+}
+export interface FinancialAnalysisEvidence {
+    available: boolean;
+    mode?: "full" | "lite" | "none";
+    source?: "tickflow" | "mx_select_stock" | "none";
+    note?: string | null;
+    latest_period_end: string | null;
+    latest_announce_date: string | null;
+    income_count: number;
+    metrics_count: number;
+    cash_flow_count: number;
+    balance_sheet_count: number;
+    lite_as_of?: string | null;
+    lite_query?: string | null;
+    lite_metric_count?: number;
+    lite_metric_labels?: string[];
+}
+export interface FinancialAnalysisEntry {
+    symbol: string;
+    analysis_date: string;
+    analysis_text: string;
+    score: number | null;
+    bias: AnalysisBias;
+    strengths: string[];
+    risks: string[];
+    watch_items: string[];
+    evidence: FinancialAnalysisEvidence;
+}
+export interface NewsAnalysisEvidenceItem {
+    title: string;
+    source: string | null;
+    published_at: string | null;
+    securities: string[];
+}
+export interface NewsAnalysisEvidence {
+    available: boolean;
+    source_count: number;
+    documents: NewsAnalysisEvidenceItem[];
+}
+export interface NewsAnalysisEntry {
+    symbol: string;
+    analysis_date: string;
+    query: string;
+    analysis_text: string;
+    score: number | null;
+    bias: AnalysisBias;
+    catalysts: string[];
+    risks: string[];
+    watch_items: string[];
+    source_count: number;
+    evidence: NewsAnalysisEvidence;
+}
+export interface CompositeAnalysisEvidence {
+    technical_structured: boolean;
+    financial_available: boolean;
+    financial_mode?: "full" | "lite" | "none";
+    financial_source?: "tickflow" | "mx_select_stock" | "none";
+    financial_latest_period_end: string | null;
+    financial_lite_as_of?: string | null;
+    news_available: boolean;
+    news_query: string;
+    news_source_count: number;
+}
+export interface CompositeAnalysisEntry extends AnalysisLevelsSnapshot {
+    symbol: string;
+    analysis_date: string;
+    analysis_text: string;
+    structured_ok: boolean;
+    technical_score: number | null;
+    financial_score: number | null;
+    news_score: number | null;
+    financial_bias: AnalysisBias;
+    news_bias: AnalysisBias;
+    evidence: CompositeAnalysisEvidence;
+}

package/dist/types/domain.js

@@ -0,0 +1 @@
+export {};

package/dist/types/indicator.d.ts

@@ -0,0 +1,43 @@
+export interface IndicatorInputRow {
+    trade_date: string;
+    trade_time?: string;
+    period?: string;
+    timestamp?: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    amount: number;
+    prev_close?: number;
+}
+export interface IndicatorRow {
+    symbol?: string;
+    trade_date: string;
+    trade_time?: string;
+    period?: string;
+    timestamp?: number;
+    ma5?: number | null;
+    ma10?: number | null;
+    ma20?: number | null;
+    ma60?: number | null;
+    macd?: number | null;
+    macd_signal?: number | null;
+    macd_hist?: number | null;
+    kdj_k?: number | null;
+    kdj_d?: number | null;
+    kdj_j?: number | null;
+    rsi_6?: number | null;
+    rsi_12?: number | null;
+    rsi_24?: number | null;
+    cci?: number | null;
+    bias_6?: number | null;
+    bias_12?: number | null;
+    bias_24?: number | null;
+    plus_di?: number | null;
+    minus_di?: number | null;
+    adx?: number | null;
+    boll_upper?: number | null;
+    boll_mid?: number | null;
+    boll_lower?: number | null;
+}

package/dist/types/indicator.js

@@ -0,0 +1 @@
+export {};

package/dist/types/monitor.d.ts

@@ -0,0 +1,17 @@
+export interface MonitorState {
+    running: boolean;
+    startedAt: string | null;
+    lastStoppedAt: string | null;
+    lastMode: "manual" | "system";
+    workerPid: number | null;
+    expectedStop: boolean;
+    runtimeHost: "plugin_service" | "fallback_process" | null;
+    runtimeObservedAt: string | null;
+    lastHeartbeatAt: string | null;
+    lastLoopError: string | null;
+    lastLoopErrorAt: string | null;
+    lastObservedPhase: "non_trading_day" | "pre_market" | "trading" | "lunch_break" | "closed" | null;
+    lastObservedPhaseDate: string | null;
+    sessionNotificationsDate: string | null;
+    sessionNotificationsSent: string[];
+}

package/dist/types/monitor.js

@@ -0,0 +1 @@
+export {};

package/dist/types/mx-search.d.ts

@@ -0,0 +1,14 @@
+export interface MxSearchSecurity {
+    secuCode?: string | null;
+    secuName?: string | null;
+    secuType?: string | null;
+    [key: string]: unknown;
+}
+export interface MxSearchDocument {
+    title: string;
+    trunk: string;
+    secuList: MxSearchSecurity[];
+    source: string | null;
+    publishedAt: string | null;
+    raw: Record<string, unknown>;
+}

package/dist/types/mx-search.js

@@ -0,0 +1 @@
+export {};

package/dist/types/mx-select-stock.d.ts

@@ -0,0 +1,28 @@
+export interface MxSelectStockColumn {
+    title: string;
+    key: string;
+    dateMsg: string | null;
+    sortable: boolean;
+    sortWay: string | null;
+    redGreenAble: boolean;
+    unit: string | null;
+    dataType: string | null;
+}
+export interface MxSelectStockCondition {
+    describe: string;
+    stockCount: number | null;
+}
+export interface MxSelectStockResult {
+    status: number | null;
+    message: string | null;
+    code: string | null;
+    msg: string | null;
+    resultType: number | null;
+    total: number;
+    totalRecordCount: number;
+    parserText: string | null;
+    columns: MxSelectStockColumn[];
+    dataList: Array<Record<string, unknown>>;
+    responseConditionList: MxSelectStockCondition[];
+    totalCondition: MxSelectStockCondition | null;
+}

package/dist/types/mx-select-stock.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tickflow.d.ts

@@ -0,0 +1,133 @@
+export interface TickFlowInstrument {
+    symbol: string;
+    name?: string | null;
+    exchange: string;
+    code: string;
+    region: string;
+    type?: string | null;
+}
+export interface TickFlowQuote {
+    symbol: string;
+    last_price: number;
+    prev_close: number;
+    timestamp: number;
+    volume?: number;
+    ext?: {
+        name?: string;
+        change_pct?: number;
+    };
+}
+export interface TickFlowCompactKline {
+    timestamp: number[];
+    open: number[];
+    high: number[];
+    low: number[];
+    close: number[];
+    volume: number[];
+    amount: number[];
+    prev_close?: number[];
+    open_interest?: number[];
+    settlement_price?: number[];
+}
+export interface TickFlowKlineRow {
+    symbol: string;
+    trade_date: string;
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    amount: number;
+    prev_close: number;
+}
+export interface TickFlowIntradayKlineRow {
+    symbol: string;
+    period: string;
+    trade_date: string;
+    trade_time: string;
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    amount: number;
+    prev_close: number;
+    open_interest: number | null;
+    settlement_price: number | null;
+}
+export interface TickFlowFinancialQueryOptions {
+    start_date?: string;
+    end_date?: string;
+    latest?: boolean;
+}
+export interface TickFlowBalanceSheetRecord {
+    period_end: string;
+    announce_date?: string | null;
+    accounts_payable?: number | null;
+    accounts_receivable?: number | null;
+    cash_and_equivalents?: number | null;
+    equity_attributable?: number | null;
+    fixed_assets?: number | null;
+    goodwill?: number | null;
+    intangible_assets?: number | null;
+    inventory?: number | null;
+    long_term_borrowing?: number | null;
+    minority_interest?: number | null;
+    retained_earnings?: number | null;
+    short_term_borrowing?: number | null;
+    total_assets?: number | null;
+    total_current_assets?: number | null;
+    total_current_liabilities?: number | null;
+    total_equity?: number | null;
+    total_liabilities?: number | null;
+    total_non_current_assets?: number | null;
+    total_non_current_liabilities?: number | null;
+}
+export interface TickFlowCashFlowRecord {
+    period_end: string;
+    announce_date?: string | null;
+    capex?: number | null;
+    net_cash_change?: number | null;
+    net_financing_cash_flow?: number | null;
+    net_investing_cash_flow?: number | null;
+    net_operating_cash_flow?: number | null;
+}
+export interface TickFlowIncomeRecord {
+    period_end: string;
+    announce_date?: string | null;
+    admin_expense?: number | null;
+    basic_eps?: number | null;
+    diluted_eps?: number | null;
+    financial_expense?: number | null;
+    income_tax?: number | null;
+    net_income?: number | null;
+    net_income_attributable?: number | null;
+    non_operating_expense?: number | null;
+    non_operating_income?: number | null;
+    operating_cost?: number | null;
+    operating_profit?: number | null;
+    rd_expense?: number | null;
+    revenue?: number | null;
+    selling_expense?: number | null;
+    total_profit?: number | null;
+}
+export interface TickFlowFinancialMetricsRecord {
+    period_end: string;
+    announce_date?: string | null;
+    bps?: number | null;
+    debt_to_asset_ratio?: number | null;
+    eps_basic?: number | null;
+    eps_diluted?: number | null;
+    gross_margin?: number | null;
+    inventory_turnover?: number | null;
+    net_income_yoy?: number | null;
+    net_margin?: number | null;
+    ocfps?: number | null;
+    operating_cash_to_revenue?: number | null;
+    revenue_yoy?: number | null;
+    roa?: number | null;
+    roe?: number | null;
+    roe_diluted?: number | null;
+}

package/dist/types/tickflow.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/abortable-sleep.d.ts

@@ -0,0 +1 @@
+export declare function sleepWithAbort(ms: number, signal?: AbortSignal): Promise<void>;

package/dist/utils/abortable-sleep.js

@@ -0,0 +1,20 @@
+export function sleepWithAbort(ms, signal) {
+    if (signal?.aborted) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            cleanup();
+            resolve();
+        };
+        const cleanup = () => {
+            signal?.removeEventListener("abort", onAbort);
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}

package/dist/utils/china-time.d.ts

@@ -0,0 +1,3 @@
+export declare function chinaNow(): Date;
+export declare function formatChinaDateTime(date?: Date): string;
+export declare function chinaToday(date?: Date): string;

package/dist/utils/china-time.js

@@ -0,0 +1,18 @@
+const CHINA_OFFSET_HOURS = 8;
+export function chinaNow() {
+    return new Date();
+}
+export function formatChinaDateTime(date = chinaNow()) {
+    const utcMs = date.getTime() + date.getTimezoneOffset() * 60_000;
+    const chinaDate = new Date(utcMs + CHINA_OFFSET_HOURS * 60 * 60 * 1000);
+    const year = chinaDate.getUTCFullYear();
+    const month = String(chinaDate.getUTCMonth() + 1).padStart(2, "0");
+    const day = String(chinaDate.getUTCDate()).padStart(2, "0");
+    const hour = String(chinaDate.getUTCHours()).padStart(2, "0");
+    const minute = String(chinaDate.getUTCMinutes()).padStart(2, "0");
+    const second = String(chinaDate.getUTCSeconds()).padStart(2, "0");
+    return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
+}
+export function chinaToday(date = chinaNow()) {
+    return formatChinaDateTime(date).slice(0, 10);
+}

package/dist/utils/cost-price.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeCostPrice(value: unknown): number | null;
+export declare function formatCostPrice(value: number | null | undefined, suffix?: string): string;
+export declare function calculateProfitPct(currentPrice: number, costPrice: number | null | undefined): number | null;

package/dist/utils/cost-price.js

@@ -0,0 +1,18 @@
+export function normalizeCostPrice(value) {
+    const numeric = Number(value ?? NaN);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        return null;
+    }
+    return numeric;
+}
+export function formatCostPrice(value, suffix = "") {
+    const numeric = normalizeCostPrice(value);
+    return numeric == null ? "未设置" : `${numeric.toFixed(2)}${suffix}`;
+}
+export function calculateProfitPct(currentPrice, costPrice) {
+    const numeric = normalizeCostPrice(costPrice);
+    if (numeric == null) {
+        return null;
+    }
+    return ((currentPrice - numeric) / numeric) * 100;
+}

package/dist/utils/format.d.ts

@@ -0,0 +1 @@
+export declare function formatPrice(value: number): string;

package/dist/utils/format.js

@@ -0,0 +1,3 @@
+export function formatPrice(value) {
+    return value.toFixed(2);
+}

package/dist/utils/process.d.ts

@@ -0,0 +1,5 @@
+export interface ProcessResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}

package/dist/utils/process.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/symbol.d.ts

@@ -0,0 +1 @@
+export declare function normalizeSymbol(input: string): string;

package/dist/utils/symbol.js

@@ -0,0 +1,13 @@
+export function normalizeSymbol(input) {
+    const normalized = input.trim().toUpperCase();
+    if (/^\d{6}\.(SH|SZ)$/.test(normalized)) {
+        return normalized;
+    }
+    if (/^\d{6}$/.test(normalized)) {
+        if (normalized.startsWith("6") || normalized.startsWith("9")) {
+            return `${normalized}.SH`;
+        }
+        return `${normalized}.SZ`;
+    }
+    return normalized;
+}