@senpi/trading-recipe 1.0.69 → 1.0.70

package/dist/health/index.d.ts

@@ -1,6 +1,26 @@
+import type { ComponentHealth, DslComponentHealthStatus, DslSystemState, RuntimeHealthStatus, RuntimeSystemState, ScannerComponentHealthStatus, ScannerSystemState, StateStatusProvider } from "./types.js";
+export type { ComponentHealth, ComponentHealthStatus, ComponentSystemState, DslComponentHealthStatus, DslSystemState, RuntimeHealthStatus, RuntimeSystemState, ScannerComponentHealthStatus, ScannerRegistrationSystemState, ScannerSystemState, StateStatusProvider, } from "./types.js";
+type HealthProviderMap = {
+    scanners: StateStatusProvider<ScannerComponentHealthStatus, ScannerSystemState>;
+    dsl?: StateStatusProvider<DslComponentHealthStatus, DslSystemState>;
+};
+export interface CreateHealthStateModuleOptions {
+    recipeId?: string;
+    recipeName: string;
+    stateDir: string;
+    startedAt?: number;
+    providers: HealthProviderMap;
+}
+export interface HealthStateModule {
+    getHealthStatus(): Promise<RuntimeHealthStatus>;
+    getSystemState(): Promise<RuntimeSystemState>;
+    registerProvider<Name extends keyof HealthProviderMap>(name: Name, provider: HealthProviderMap[Name]): void;
+}
+export declare function createHealthStateModule(options: CreateHealthStateModuleOptions): HealthStateModule;
+export declare function deriveRuntimeHealth(healths: Array<ComponentHealth | undefined>): ComponentHealth;
 /**
- * Health feature of Senpi core trading plugin.
- * Placeholder for health checks, liveness, and diagnostics.
+ * Legacy hook-based health initializer retained for compatibility.
+ * Runtime health/state aggregation is now handled by createHealthStateModule().
  */
 export declare function initHealth(_bus: {
     emit: (e: string, p?: unknown) => void;

package/dist/health/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAA;CAAE,GAAG,IAAI,CAEpI"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAGf,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAE5B,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,mBAAmB,CAAC,4BAA4B,EAAE,kBAAkB,CAAC,CAAC;IAChF,GAAG,CAAC,EAAE,mBAAmB,CAAC,wBAAwB,EAAE,cAAc,CAAC,CAAC;CACrE,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChD,cAAc,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9C,gBAAgB,CAAC,IAAI,SAAS,MAAM,iBAAiB,EACnD,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAChC,IAAI,CAAC;CACT;AAUD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,iBAAiB,CAmEnB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC,GAC1C,eAAe,CAgBjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;CACnD,GAAG,IAAI,CAEP"}

package/dist/health/index.js

@@ -1,9 +1,191 @@
+const HEALTH_ORDER = {
+    healthy: 0,
+    disabled: 0,
+    unknown: 1,
+    degraded: 2,
+    unhealthy: 3,
+};
+export function createHealthStateModule(options) {
+    const startedAtMs = options.startedAt ?? Date.now();
+    const providers = { ...options.providers };
+    return {
+        async getHealthStatus() {
+            const [scanners, dsl] = await Promise.all([
+                readProviderHealth({
+                    component: "scanners",
+                    provider: providers.scanners,
+                    fallback: buildScannerHealthFallback("Scanners provider is not registered."),
+                }),
+                readProviderHealth({
+                    component: "dsl",
+                    provider: providers.dsl,
+                    fallback: buildDslHealthFallback("DSL provider is not registered."),
+                }),
+            ]);
+            return {
+                ...(options.recipeId ? { recipeId: options.recipeId } : {}),
+                recipeName: options.recipeName,
+                startedAt: new Date(startedAtMs).toISOString(),
+                generatedAt: new Date().toISOString(),
+                health: deriveRuntimeHealth([scanners.health, providers.dsl ? dsl.health : undefined]),
+                components: {
+                    scanners,
+                    ...(providers.dsl ? { dsl } : {}),
+                },
+            };
+        },
+        async getSystemState() {
+            const [scanners, dsl] = await Promise.all([
+                readProviderState({
+                    component: "scanners",
+                    provider: providers.scanners,
+                    fallback: buildScannerStateFallback("Scanners provider is not registered."),
+                }),
+                readProviderState({
+                    component: "dsl",
+                    provider: providers.dsl,
+                    fallback: buildDslStateFallback("DSL provider is not registered."),
+                }),
+            ]);
+            return {
+                ...(options.recipeId ? { recipeId: options.recipeId } : {}),
+                recipeName: options.recipeName,
+                stateDir: options.stateDir,
+                startedAt: new Date(startedAtMs).toISOString(),
+                generatedAt: new Date().toISOString(),
+                health: deriveRuntimeHealth([scanners.health, providers.dsl ? dsl.health : undefined]),
+                components: {
+                    scanners,
+                    ...(providers.dsl ? { dsl } : {}),
+                },
+            };
+        },
+        registerProvider(name, provider) {
+            providers[name] = provider;
+        },
+    };
+}
+export function deriveRuntimeHealth(healths) {
+    const values = healths.filter((value) => value !== undefined);
+    if (values.length === 0) {
+        return "unknown";
+    }
+    const active = values.filter((value) => value !== "disabled");
+    const source = active.length > 0 ? active : values;
+    let worst = source[0] ?? "unknown";
+    for (const value of source) {
+        if (HEALTH_ORDER[value] > HEALTH_ORDER[worst]) {
+            worst = value;
+        }
+    }
+    return worst;
+}
 /**
- * Health feature of Senpi core trading plugin.
- * Placeholder for health checks, liveness, and diagnostics.
+ * Legacy hook-based health initializer retained for compatibility.
+ * Runtime health/state aggregation is now handled by createHealthStateModule().
  */
-// TODO: implement health module (liveness, readiness, metrics, etc.)
 export function initHealth(_bus) {
-    // no-op until implemented
+    // no-op
+}
+async function readProviderHealth(options) {
+    if (!options.provider) {
+        return options.fallback;
+    }
+    try {
+        return await options.provider.getHealthStatus();
+    }
+    catch (error) {
+        return {
+            ...options.fallback,
+            summary: `Failed to query ${options.component} health.`,
+            updatedAt: new Date().toISOString(),
+            error: formatProviderError(error),
+        };
+    }
+}
+async function readProviderState(options) {
+    if (!options.provider) {
+        return options.fallback;
+    }
+    try {
+        return await options.provider.getSystemState();
+    }
+    catch (error) {
+        return {
+            ...options.fallback,
+            updatedAt: new Date().toISOString(),
+            error: formatProviderError(error),
+        };
+    }
+}
+function buildScannerHealthFallback(error) {
+    return {
+        component: "scanners",
+        health: "unhealthy",
+        updatedAt: new Date().toISOString(),
+        summary: "Failed to query scanners health.",
+        error,
+        totals: {
+            registered: 0,
+            enabled: 0,
+            inFlight: 0,
+            degraded: 0,
+            unhealthy: 1,
+        },
+        scanners: [],
+    };
+}
+function buildDslHealthFallback(error) {
+    return {
+        component: "dsl",
+        health: "unhealthy",
+        updatedAt: new Date().toISOString(),
+        summary: "Failed to query DSL health.",
+        error,
+        enabled: false,
+        activePositions: 0,
+    };
+}
+function buildScannerStateFallback(error) {
+    return {
+        component: "scanners",
+        health: "unhealthy",
+        updatedAt: new Date().toISOString(),
+        error,
+        state: {
+            totalRegistered: 0,
+            totalEnabled: 0,
+            scanners: [],
+        },
+    };
+}
+function buildDslStateFallback(error) {
+    return {
+        component: "dsl",
+        health: "unhealthy",
+        updatedAt: new Date().toISOString(),
+        error,
+        state: {
+            enabled: false,
+            intervalMs: 0,
+            preset: "unknown",
+            monitor: {
+                running: false,
+                inFlight: false,
+                lastTickStartedAt: null,
+                lastTickFinishedAt: null,
+                lastTickError: null,
+                nextTickAt: null,
+                tickAttemptCount: 0,
+                tickSuccessCount: 0,
+                tickErrorCount: 0,
+            },
+            activePositions: [],
+            positions: [],
+        },
+    };
+}
+function formatProviderError(error) {
+    return error instanceof Error ? error.message : String(error);
 }
 //# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qEAAqE;AAErE,MAAM,UAAU,UAAU,CAAC,IAAmG;IAC5H,0BAA0B;AAC5B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"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"}

package/dist/health/types.d.ts

@@ -0,0 +1,114 @@
+export type ComponentHealth = "healthy" | "degraded" | "unhealthy" | "disabled" | "unknown";
+export interface ComponentHealthStatus {
+    component: string;
+    health: ComponentHealth;
+    updatedAt: string;
+    summary: string;
+    error?: string;
+}
+export interface ComponentSystemState<TState = unknown> {
+    component: string;
+    health: ComponentHealth;
+    updatedAt: string;
+    state: TState;
+    error?: string;
+}
+export interface StateStatusProvider<THealth extends ComponentHealthStatus = ComponentHealthStatus, TState extends ComponentSystemState = ComponentSystemState> {
+    getHealthStatus(): Promise<THealth>;
+    getSystemState(): Promise<TState>;
+}
+export interface ScannerRegistrationHealth {
+    address: string;
+    scannerId: string;
+    health: ComponentHealth;
+}
+export interface ScannerComponentHealthStatus extends ComponentHealthStatus {
+    component: "scanners";
+    totals: {
+        registered: number;
+        enabled: number;
+        inFlight: number;
+        degraded: number;
+        unhealthy: number;
+    };
+    scanners: ScannerRegistrationHealth[];
+}
+export interface ScannerRegistrationSystemState {
+    address: string;
+    scannerId: string;
+    health: ComponentHealth;
+    enabled: boolean;
+    initialized: boolean;
+    intervalSeconds: number;
+    inFlight: boolean;
+    lastRunStartedAt: number | null;
+    lastRunFinishedAt: number | null;
+    lastRunStatus: string | null;
+    lastRunReason: string | null;
+    lastError: string | null;
+    lastErrorAt: number | null;
+    nextRunAt: number | null;
+    runCount: number;
+    errorCount: number;
+    consecutiveErrorCount: number;
+    configVersion: number | null;
+    runtimeUpdatedAt: number | null;
+    config: unknown;
+    state: unknown;
+}
+export interface ScannerSystemState extends ComponentSystemState<{
+    totalRegistered: number;
+    totalEnabled: number;
+    scanners: ScannerRegistrationSystemState[];
+}> {
+    component: "scanners";
+}
+export interface DslComponentHealthStatus extends ComponentHealthStatus {
+    component: "dsl";
+    enabled: boolean;
+    activePositions: number;
+}
+export interface DslSystemState extends ComponentSystemState<{
+    enabled: boolean;
+    intervalMs: number;
+    preset: string;
+    monitor: {
+        running: boolean;
+        inFlight: boolean;
+        lastTickStartedAt: number | null;
+        lastTickFinishedAt: number | null;
+        lastTickError: string | null;
+        nextTickAt: number | null;
+        tickAttemptCount: number;
+        tickSuccessCount: number;
+        tickErrorCount: number;
+    };
+    activePositions: unknown[];
+    positions: unknown[];
+}> {
+    component: "dsl";
+}
+export interface RuntimeHealthStatus {
+    recipeId?: string;
+    recipeName: string;
+    startedAt: string;
+    generatedAt: string;
+    health: ComponentHealth;
+    components: {
+        scanners: ScannerComponentHealthStatus;
+        dsl?: DslComponentHealthStatus;
+    };
+}
+export interface RuntimeSystemState {
+    recipeId?: string;
+    recipeName: string;
+    stateDir: string;
+    startedAt: string;
+    generatedAt: string;
+    health: ComponentHealth;
+    components: {
+        scanners: ScannerSystemState;
+        dsl?: DslSystemState;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/health/types.d.ts.map

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

package/dist/health/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/health/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/health/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -10,7 +10,8 @@ export declare function initCore(bus: SenpiEventBus): void;
 export { initDsl, DslPlugin, dslLogger, setDslLogLevel, parseDslPluginConfig, DslConfigValidationError, dslValidationIssue, EVENTS as DslEvents, DSL_EVENTS, } from "./dsl/index.js";
 export type { DslArchivedClose, DslPluginConfig, DslPositionSummary, DslState, DslTickResult, ExitBlockConfig, DslValidationIssue, DslValidationIssueCode, } from "./dsl/index.js";
 export { initRisk } from "./risk/index.js";
-export { initHealth } from "./health/index.js";
+export { createHealthStateModule, initHealth } from "./health/index.js";
+export type { ComponentHealth, ComponentHealthStatus, ComponentSystemState, DslComponentHealthStatus, DslSystemState, RuntimeHealthStatus, RuntimeSystemState, ScannerComponentHealthStatus, ScannerRegistrationSystemState, ScannerSystemState, StateStatusProvider, } from "./health/index.js";
 export { HOOK_EVENT } from './types/index.js';
 export type { HookEventType, HookEvent, HookSystem, StrategyConfig, StateManager, GateCheckResult, RiskGuard, NotificationService, Signal, ScanResult, } from './types/index.js';
 export { ScanStatus } from './types/index.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -26,8 +26,8 @@ export function initCore(bus) {
 export { initDsl, DslPlugin, dslLogger, setDslLogLevel, parseDslPluginConfig, DslConfigValidationError, dslValidationIssue, EVENTS as DslEvents, DSL_EVENTS, } from "./dsl/index.js";
 // Risk feature (placeholder)
 export { initRisk } from "./risk/index.js";
-// Health feature (placeholder)
-export { initHealth } from "./health/index.js";
+// Health feature
+export { createHealthStateModule, initHealth } from "./health/index.js";
 // Shared types
 export { HOOK_EVENT } from './types/index.js';
 export { ScanStatus } from './types/index.js';
@@ -261,6 +261,7 @@ const senpiRecipePlugin = {
             pluginLogger.info("[senpi-recipe] CLI registrar callback invoked — attaching senpi subcommands to program");
             registerSenpiCli(ctx.program);
         }, { commands: ["senpi"] });
+        /** Gateway respond accepts (ok, payload?, error?) with error as { code, message }; plugin SDK types may omit the third arg. */
         api.registerGatewayMethod("senpi.installRecipe", async (ctx) => {
             const { params } = ctx;
             const respond = ctx.respond;
@@ -446,8 +447,151 @@ const senpiRecipePlugin = {
                 closes = closes.slice(0, limit);
             respond(true, { closes });
         });
-        pluginLogger.info(`[senpi-recipe] v${VERSION} plugin registered — stateDir: ${baseStateDir}`);
+        api.registerGatewayMethod("senpi.getHealthStatus", async (ctx) => {
+            const respond = ctx.respond;
+            const recipeId = typeof ctx.params?.recipeId === "string" ? ctx.params.recipeId : undefined;
+            if (recipeId) {
+                const handle = getRuntimeHandleOrRespond(runtimeHandles, recipeId, respond);
+                if (!handle) {
+                    return;
+                }
+                try {
+                    const status = await handle.getHealthStatus();
+                    respond(true, {
+                        status: status ? { ...status, recipeId } : null,
+                    });
+                }
+                catch (err) {
+                    api.logger.warn("[senpi-recipe] getHealthStatus error", { recipeId, err });
+                    respond(false, undefined, {
+                        code: "INTERNAL_ERROR",
+                        message: `Failed to get health status for recipe ${recipeId}: ${formatGatewayError(err)}`,
+                    });
+                }
+                return;
+            }
+            const statuses = await collectRuntimeHealthStatuses(runtimeHandles, api.logger);
+            respond(true, { statuses });
+        });
+        api.registerGatewayMethod("senpi.getSystemState", async (ctx) => {
+            const respond = ctx.respond;
+            const recipeId = typeof ctx.params?.recipeId === "string" ? ctx.params.recipeId : undefined;
+            if (recipeId) {
+                const handle = getRuntimeHandleOrRespond(runtimeHandles, recipeId, respond);
+                if (!handle) {
+                    return;
+                }
+                try {
+                    const state = await handle.getSystemState();
+                    respond(true, {
+                        state: state ? { ...state, recipeId } : null,
+                    });
+                }
+                catch (err) {
+                    api.logger.warn("[senpi-recipe] getSystemState error", { recipeId, err });
+                    respond(false, undefined, {
+                        code: "INTERNAL_ERROR",
+                        message: `Failed to get system state for recipe ${recipeId}: ${formatGatewayError(err)}`,
+                    });
+                }
+                return;
+            }
+            const states = await collectRuntimeSystemStates(runtimeHandles, api.logger, baseStateDir);
+            respond(true, { states });
+        });
+        api.logger.info(`[senpi-recipe] v${VERSION} plugin registered — stateDir: ${baseStateDir}`);
     },
 };
+function getRuntimeHandleOrRespond(runtimeHandles, recipeId, respond) {
+    const handle = runtimeHandles.get(recipeId);
+    if (handle) {
+        return handle;
+    }
+    respond(false, undefined, {
+        code: "NOT_FOUND",
+        message: `No running recipe found for id ${recipeId}`,
+    });
+    return null;
+}
+async function collectRuntimeHealthStatuses(runtimeHandles, logger) {
+    return (await Promise.all(Array.from(runtimeHandles, async ([recipeId, handle]) => {
+        try {
+            const status = await handle.getHealthStatus();
+            return status ? { ...status, recipeId } : null;
+        }
+        catch (err) {
+            logger.warn("[senpi-recipe] getHealthStatus error", { recipeId, err });
+            return createGatewayHealthErrorStatus(recipeId, err);
+        }
+    }))).filter((status) => status !== null);
+}
+async function collectRuntimeSystemStates(runtimeHandles, logger, baseStateDir) {
+    return (await Promise.all(Array.from(runtimeHandles, async ([recipeId, handle]) => {
+        try {
+            const state = await handle.getSystemState();
+            return state ? { ...state, recipeId } : null;
+        }
+        catch (err) {
+            logger.warn("[senpi-recipe] getSystemState error", { recipeId, err });
+            return createGatewaySystemStateError(recipeId, join(baseStateDir, recipeId), err);
+        }
+    }))).filter((state) => state !== null);
+}
+function createGatewayHealthErrorStatus(recipeId, error) {
+    const now = new Date().toISOString();
+    const message = formatGatewayError(error);
+    return {
+        recipeId,
+        recipeName: recipeId,
+        startedAt: now,
+        generatedAt: now,
+        health: "unhealthy",
+        components: {
+            scanners: {
+                component: "scanners",
+                health: "unhealthy",
+                updatedAt: now,
+                summary: "Failed to query scanners health.",
+                error: message,
+                totals: {
+                    registered: 0,
+                    enabled: 0,
+                    inFlight: 0,
+                    degraded: 0,
+                    unhealthy: 1,
+                },
+                scanners: [],
+            },
+        },
+    };
+}
+function createGatewaySystemStateError(recipeId, stateDir, error) {
+    const now = new Date().toISOString();
+    const message = formatGatewayError(error);
+    return {
+        recipeId,
+        recipeName: recipeId,
+        stateDir,
+        startedAt: now,
+        generatedAt: now,
+        health: "unhealthy",
+        components: {
+            scanners: {
+                component: "scanners",
+                health: "unhealthy",
+                updatedAt: now,
+                error: message,
+                state: {
+                    totalRegistered: 0,
+                    totalEnabled: 0,
+                    scanners: [],
+                },
+            },
+        },
+    };
+}
+function formatGatewayError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
 export default senpiRecipePlugin;
 //# sourceMappingURL=index.js.map