@trading-boy/core 0.1.0

package/README.md

@@ -0,0 +1,8 @@
+# @trading-boy/core
+
+Shared types, constants, and utilities for the Trading Boy monorepo.
+
+## Contents
+
+- **types/** — Graph node types, edge types, ContextPackage interface, enums
+- **constants/** — Threshold values, configuration constants

package/dist/config/env.d.ts

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+declare const envSchema: z.ZodObject<{
+    NODE_ENV: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+        fatal: "fatal";
+    }>>;
+    NEO4J_URI: z.ZodDefault<z.ZodString>;
+    NEO4J_USER: z.ZodDefault<z.ZodString>;
+    NEO4J_PASSWORD: z.ZodDefault<z.ZodString>;
+    TIMESCALE_HOST: z.ZodDefault<z.ZodString>;
+    TIMESCALE_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    TIMESCALE_USER: z.ZodDefault<z.ZodString>;
+    TIMESCALE_PASSWORD: z.ZodDefault<z.ZodString>;
+    TIMESCALE_DB: z.ZodDefault<z.ZodString>;
+    REDIS_URL: z.ZodDefault<z.ZodString>;
+    REDIS_PASSWORD: z.ZodDefault<z.ZodString>;
+    JUPITER_API_KEY: z.ZodDefault<z.ZodString>;
+    HELIUS_API_KEY: z.ZodDefault<z.ZodString>;
+    COINGECKO_API_KEY: z.ZodDefault<z.ZodString>;
+    ALCHEMY_API_KEY: z.ZodDefault<z.ZodString>;
+    GLASSNODE_API_KEY: z.ZodDefault<z.ZodString>;
+    TWITTER_BEARER_TOKEN: z.ZodDefault<z.ZodString>;
+    ANTHROPIC_API_KEY: z.ZodDefault<z.ZodString>;
+    LLM_PROVIDER: z.ZodDefault<z.ZodEnum<{
+        anthropic: "anthropic";
+        openrouter: "openrouter";
+        ollama: "ollama";
+        custom: "custom";
+    }>>;
+    LLM_API_KEY: z.ZodDefault<z.ZodString>;
+    LLM_BASE_URL: z.ZodDefault<z.ZodString>;
+    LLM_MODEL: z.ZodDefault<z.ZodString>;
+    LLM_FALLBACK_PROVIDER: z.ZodDefault<z.ZodString>;
+    LLM_FALLBACK_MODEL: z.ZodDefault<z.ZodString>;
+    LLM_FALLBACK_API_KEY: z.ZodDefault<z.ZodString>;
+    LLM_MAX_RETRIES: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    LLM_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    BELIEF_HMAC_KEY: z.ZodDefault<z.ZodString>;
+    ENABLE_LLM: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false">>;
+    ENABLE_LEARNING: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false">>;
+    ENABLE_SOCIAL: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false">>;
+    API_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    TELEGRAM_BOT_TOKEN: z.ZodDefault<z.ZodString>;
+    TELEGRAM_ALLOWED_CHAT_IDS: z.ZodDefault<z.ZodString>;
+    RESEND_API_KEY: z.ZodDefault<z.ZodString>;
+    EMAIL_FROM_ADDRESS: z.ZodDefault<z.ZodString>;
+    EMAIL_FROM_NAME: z.ZodDefault<z.ZodString>;
+    SMTP_HOST: z.ZodDefault<z.ZodString>;
+    SMTP_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    SMTP_USER: z.ZodDefault<z.ZodString>;
+    SMTP_PASS: z.ZodDefault<z.ZodString>;
+    NOTIFICATION_FROM_EMAIL: z.ZodDefault<z.ZodString>;
+    STRIPE_SECRET_KEY: z.ZodDefault<z.ZodString>;
+    STRIPE_WEBHOOK_SECRET: z.ZodDefault<z.ZodString>;
+    STRIPE_PRICE_ID: z.ZodDefault<z.ZodString>;
+    APP_URL: z.ZodDefault<z.ZodString>;
+    API_KEY_HASHES: z.ZodDefault<z.ZodString>;
+    API_KEY_AUTH_ENABLED: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false">>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof envSchema>;
+/**
+ * Parse and validate environment variables. Returns a cached Config singleton.
+ *
+ * In production mode, NEO4J_PASSWORD, TIMESCALE_PASSWORD, and REDIS_PASSWORD
+ * must be explicitly set to non-default values. In development/test mode,
+ * defaults are used so the system works out of the box.
+ *
+ * @throws {ConfigError} if validation fails
+ */
+export declare function getConfig(): Config;
+/**
+ * Reset the config singleton. Used in tests to re-parse environment variables.
+ * @internal
+ */
+export declare function resetConfig(): void;
+/**
+ * Build a PostgreSQL connection string from individual TimescaleDB config fields.
+ */
+export declare function getTimescaleConnectionString(config: Config): string;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiJX,CAAC;AAEL,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAM/C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAclC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/config/env.js

@@ -0,0 +1,178 @@
+import dotenv from 'dotenv';
+import { z } from 'zod';
+import { ConfigError } from '../errors/index.js';
+dotenv.config({ quiet: true });
+// ─── Sensitive Fields (must be non-empty in production) ───
+const PRODUCTION_REQUIRED_PASSWORDS = [
+    'NEO4J_PASSWORD',
+    'TIMESCALE_PASSWORD',
+    'REDIS_PASSWORD',
+];
+// ─── Environment Schema ───
+const envSchema = z
+    .object({
+    // Runtime
+    NODE_ENV: z
+        .enum(['development', 'production', 'test'])
+        .default('development'),
+    LOG_LEVEL: z
+        .enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])
+        .default('info'),
+    // Neo4j
+    NEO4J_URI: z.string().default('bolt://localhost:7687'),
+    NEO4J_USER: z.string().default('neo4j'),
+    NEO4J_PASSWORD: z.string().default('tradingboy'),
+    // TimescaleDB (individual fields for explicit control)
+    TIMESCALE_HOST: z.string().default('localhost'),
+    TIMESCALE_PORT: z.coerce.number().int().positive().default(5432),
+    TIMESCALE_USER: z.string().default('tradingboy'),
+    TIMESCALE_PASSWORD: z.string().default('tradingboy'),
+    TIMESCALE_DB: z.string().default('tradingboy'),
+    // Redis
+    REDIS_URL: z.string().default('redis://localhost:6379'),
+    REDIS_PASSWORD: z.string().default('tradingboy_redis_dev'),
+    // Data Sources (optional — empty string means not configured)
+    JUPITER_API_KEY: z.string().default(''),
+    HELIUS_API_KEY: z.string().default(''),
+    COINGECKO_API_KEY: z.string().default(''),
+    // Future data sources (not yet integrated)
+    ALCHEMY_API_KEY: z.string().default(''),
+    GLASSNODE_API_KEY: z.string().default(''),
+    TWITTER_BEARER_TOKEN: z.string().default(''),
+    // AI (legacy — use LLM_API_KEY instead)
+    ANTHROPIC_API_KEY: z.string().default(''),
+    // LLM Abstraction
+    LLM_PROVIDER: z.enum(['anthropic', 'openrouter', 'ollama', 'custom']).default('anthropic'),
+    LLM_API_KEY: z.string().default(''),
+    LLM_BASE_URL: z.string().default(''),
+    LLM_MODEL: z.string().default('claude-sonnet-4-6'),
+    LLM_FALLBACK_PROVIDER: z.string().default(''),
+    LLM_FALLBACK_MODEL: z.string().default(''),
+    LLM_FALLBACK_API_KEY: z.string().default(''),
+    LLM_MAX_RETRIES: z.coerce.number().default(2),
+    LLM_TIMEOUT_MS: z.coerce.number().default(30000),
+    // Learning system
+    BELIEF_HMAC_KEY: z.string().default(''),
+    // Feature flags
+    ENABLE_LLM: z
+        .enum(['true', 'false'])
+        .default('false')
+        .transform((v) => v === 'true'),
+    ENABLE_LEARNING: z
+        .enum(['true', 'false'])
+        .default('false')
+        .transform((v) => v === 'true'),
+    ENABLE_SOCIAL: z
+        .enum(['true', 'false'])
+        .default('false')
+        .transform((v) => v === 'true'),
+    // API
+    API_PORT: z.coerce.number().int().positive().default(3000),
+    // Telegram Bot
+    TELEGRAM_BOT_TOKEN: z.string().default(''),
+    TELEGRAM_ALLOWED_CHAT_IDS: z.string().default(''),
+    // Email (Resend)
+    RESEND_API_KEY: z.string().default(''),
+    EMAIL_FROM_ADDRESS: z.string().default('digest@tradingboy.dev'),
+    EMAIL_FROM_NAME: z.string().default('Trading Boy'),
+    // SMTP (Gateway email adapter)
+    SMTP_HOST: z.string().default(''),
+    SMTP_PORT: z.coerce.number().int().default(587),
+    SMTP_USER: z.string().default(''),
+    SMTP_PASS: z.string().default(''),
+    NOTIFICATION_FROM_EMAIL: z.string().default('alerts@tradingboy.dev'),
+    // Stripe Billing
+    STRIPE_SECRET_KEY: z.string().default(''),
+    STRIPE_WEBHOOK_SECRET: z.string().default(''),
+    STRIPE_PRICE_ID: z.string().default(''),
+    APP_URL: z.string().default('http://localhost:3003'),
+    // API Authentication
+    API_KEY_HASHES: z.string().default(''),
+    API_KEY_AUTH_ENABLED: z
+        .enum(['true', 'false'])
+        .default('true')
+        .transform((v) => v === 'true'),
+})
+    .superRefine((data, ctx) => {
+    if (data.NODE_ENV === 'production') {
+        const DEV_DEFAULTS = ['tradingboy', 'tradingboy_redis_dev'];
+        for (const field of PRODUCTION_REQUIRED_PASSWORDS) {
+            const value = data[field];
+            if (!value || DEV_DEFAULTS.includes(value)) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `${field} is required in production mode (cannot be empty or use default value)`,
+                    path: [field],
+                });
+            }
+        }
+        if (!data.BELIEF_HMAC_KEY) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'BELIEF_HMAC_KEY is required in production mode for belief state integrity',
+                path: ['BELIEF_HMAC_KEY'],
+            });
+        }
+        // Stripe: if secret key is configured, webhook secret must also be set
+        if (data.STRIPE_SECRET_KEY && !data.STRIPE_WEBHOOK_SECRET) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'STRIPE_WEBHOOK_SECRET is required when STRIPE_SECRET_KEY is configured',
+                path: ['STRIPE_WEBHOOK_SECRET'],
+            });
+        }
+        if (data.STRIPE_SECRET_KEY && !data.STRIPE_PRICE_ID) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'STRIPE_PRICE_ID is required when STRIPE_SECRET_KEY is configured',
+                path: ['STRIPE_PRICE_ID'],
+            });
+        }
+        // Telegram: if bot token is set, chat IDs must be configured (prevent open-access bot)
+        if (data.TELEGRAM_BOT_TOKEN && !data.TELEGRAM_ALLOWED_CHAT_IDS) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'TELEGRAM_ALLOWED_CHAT_IDS is required in production when TELEGRAM_BOT_TOKEN is set (prevents unauthorized access)',
+                path: ['TELEGRAM_ALLOWED_CHAT_IDS'],
+            });
+        }
+    }
+});
+// ─── Singleton ───
+let _config = null;
+/**
+ * Parse and validate environment variables. Returns a cached Config singleton.
+ *
+ * In production mode, NEO4J_PASSWORD, TIMESCALE_PASSWORD, and REDIS_PASSWORD
+ * must be explicitly set to non-default values. In development/test mode,
+ * defaults are used so the system works out of the box.
+ *
+ * @throws {ConfigError} if validation fails
+ */
+export function getConfig() {
+    if (!_config) {
+        const result = envSchema.safeParse(process.env);
+        if (!result.success) {
+            const messages = result.error.issues
+                .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+                .join('\n');
+            throw new ConfigError(`Environment validation failed:\n${messages}`);
+        }
+        _config = result.data;
+    }
+    return _config;
+}
+/**
+ * Reset the config singleton. Used in tests to re-parse environment variables.
+ * @internal
+ */
+export function resetConfig() {
+    _config = null;
+}
+/**
+ * Build a PostgreSQL connection string from individual TimescaleDB config fields.
+ */
+export function getTimescaleConnectionString(config) {
+    return `postgresql://${config.TIMESCALE_USER}:${config.TIMESCALE_PASSWORD}@${config.TIMESCALE_HOST}:${config.TIMESCALE_PORT}/${config.TIMESCALE_DB}`;
+}
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { getConfig, resetConfig, getTimescaleConnectionString, type Config, } from './env.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,4BAA4B,EAC5B,KAAK,MAAM,GACZ,MAAM,UAAU,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { getConfig, resetConfig, getTimescaleConnectionString, } from './env.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,4BAA4B,GAE7B,MAAM,UAAU,CAAC"}

package/dist/constants/index.d.ts

@@ -0,0 +1,49 @@
+export declare const THRESHOLDS: {
+    readonly MVRV_OVERVALUED: 3;
+    readonly MVRV_UNDERVALUED: 1;
+    readonly SOPR_PROFIT_TAKING: 1.05;
+    readonly SOPR_CAPITULATION: 0.95;
+    readonly FUNDING_HIGH: 0.05;
+    readonly FUNDING_NEGATIVE: -0.01;
+    readonly OI_SURGE: 20;
+    readonly OI_COLLAPSE: -20;
+    readonly VOLUME_SPIKE: 3;
+    readonly VOLUME_EXTREME: 5;
+    readonly WHALE_TX_MIN_USD: 100000;
+    readonly UNLOCK_HIGH_PCT: 2;
+    readonly UNLOCK_MEDIUM_PCT: 0.5;
+    readonly UNLOCK_WEIGHT_TEAM: 1;
+    readonly UNLOCK_WEIGHT_VC: 0.8;
+    readonly UNLOCK_WEIGHT_ECOSYSTEM: 0.4;
+    readonly UNLOCK_WEIGHT_COMMUNITY: 0.3;
+    readonly SOCIAL_VELOCITY_SPIKE: 5;
+    readonly SENTIMENT_DIVERGENCE: 0.3;
+    readonly MINDSHARE_EMERGING: 0.01;
+    readonly RISK_SCORE_HIGH: 70;
+    readonly RISK_SCORE_CRITICAL: 90;
+    readonly TVL_DROP_WARNING: 0.1;
+    readonly TVL_DROP_CRITICAL: 0.25;
+};
+export declare const TIME_WINDOWS: {
+    readonly TICK: "1m";
+    readonly SHORT: "15m";
+    readonly MEDIUM: "4h";
+    readonly LONG: "1d";
+    readonly WEEKLY: "7d";
+    readonly MONTHLY: "30d";
+};
+export declare const FRESHNESS_MAX_AGE_MS: {
+    readonly MARKET_DATA: number;
+    readonly ONCHAIN_DATA: number;
+    readonly SOCIAL_DATA: number;
+    readonly ANALYTICS_DATA: number;
+    readonly EVENT_DATA: number;
+};
+export declare const CONTEXT_DEFAULTS: {
+    readonly TRAVERSAL_DEPTH: 2;
+    readonly MAX_EVENTS_LOOKAHEAD_DAYS: 30;
+    readonly MAX_SOCIAL_LOOKBACK_HOURS: 24;
+    readonly MAX_ITEMS_PER_CATEGORY: 10;
+    readonly RELEVANCE_CUTOFF: 0.1;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CA4Cb,CAAC;AAIX,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAIX,eAAO,MAAM,oBAAoB;;;;;;CAMvB,CAAC;AAIX,eAAO,MAAM,gBAAgB;;;;;;CAMnB,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,63 @@
+// ─── Signal Detection Thresholds ───
+export const THRESHOLDS = {
+    // MVRV Z-Score (from on-chain analytics research)
+    MVRV_OVERVALUED: 3.0,
+    MVRV_UNDERVALUED: 1.0,
+    // SOPR (Spent Output Profit Ratio)
+    SOPR_PROFIT_TAKING: 1.05,
+    SOPR_CAPITULATION: 0.95,
+    // Funding rate (8h rate, not annualized — raw exchange data)
+    FUNDING_HIGH: 0.05, // 0.05% per 8h = euphoria signal
+    FUNDING_NEGATIVE: -0.01,
+    // Open interest change (% in 24h)
+    OI_SURGE: 20,
+    OI_COLLAPSE: -20,
+    // Volume anomaly (multiple of 30d average)
+    VOLUME_SPIKE: 3.0,
+    VOLUME_EXTREME: 5.0,
+    // Exchange netflow (positive = inflow = bearish)
+    WHALE_TX_MIN_USD: 100_000,
+    // Token unlock materiality (% of circulating supply)
+    UNLOCK_HIGH_PCT: 2.0,
+    UNLOCK_MEDIUM_PCT: 0.5,
+    // Unlock recipient weights (from tokenomics research: team unlocks have highest dump probability)
+    UNLOCK_WEIGHT_TEAM: 1.0,
+    UNLOCK_WEIGHT_VC: 0.8,
+    UNLOCK_WEIGHT_ECOSYSTEM: 0.4,
+    UNLOCK_WEIGHT_COMMUNITY: 0.3,
+    // Social signal thresholds
+    SOCIAL_VELOCITY_SPIKE: 5.0, // multiple of 7d average
+    SENTIMENT_DIVERGENCE: 0.3,
+    MINDSHARE_EMERGING: 0.01, // 1% of total mentions = emerging
+    // Risk scoring
+    RISK_SCORE_HIGH: 70,
+    RISK_SCORE_CRITICAL: 90,
+    TVL_DROP_WARNING: 0.1, // 10% drop
+    TVL_DROP_CRITICAL: 0.25, // 25% drop
+};
+// ─── Time Windows ───
+export const TIME_WINDOWS = {
+    TICK: '1m',
+    SHORT: '15m',
+    MEDIUM: '4h',
+    LONG: '1d',
+    WEEKLY: '7d',
+    MONTHLY: '30d',
+};
+// ─── Data Freshness Requirements ───
+export const FRESHNESS_MAX_AGE_MS = {
+    MARKET_DATA: 5 * 60 * 1000, // 5 minutes
+    ONCHAIN_DATA: 15 * 60 * 1000, // ~1 block for EVM
+    SOCIAL_DATA: 15 * 60 * 1000, // 15 minutes
+    ANALYTICS_DATA: 60 * 60 * 1000, // 1 hour
+    EVENT_DATA: 24 * 60 * 60 * 1000, // 1 day
+};
+// ─── Context Assembly ───
+export const CONTEXT_DEFAULTS = {
+    TRAVERSAL_DEPTH: 2,
+    MAX_EVENTS_LOOKAHEAD_DAYS: 30,
+    MAX_SOCIAL_LOOKBACK_HOURS: 24,
+    MAX_ITEMS_PER_CATEGORY: 10,
+    RELEVANCE_CUTOFF: 0.1,
+};
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kDAAkD;IAClD,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IAErB,mCAAmC;IACnC,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IAEvB,6DAA6D;IAC7D,YAAY,EAAE,IAAI,EAAE,iCAAiC;IACrD,gBAAgB,EAAE,CAAC,IAAI;IAEvB,kCAAkC;IAClC,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,CAAC,EAAE;IAEhB,2CAA2C;IAC3C,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,GAAG;IAEnB,iDAAiD;IACjD,gBAAgB,EAAE,OAAO;IAEzB,qDAAqD;IACrD,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,GAAG;IAEtB,kGAAkG;IAClG,kBAAkB,EAAE,GAAG;IACvB,gBAAgB,EAAE,GAAG;IACrB,uBAAuB,EAAE,GAAG;IAC5B,uBAAuB,EAAE,GAAG;IAE5B,2BAA2B;IAC3B,qBAAqB,EAAE,GAAG,EAAE,yBAAyB;IACrD,oBAAoB,EAAE,GAAG;IACzB,kBAAkB,EAAE,IAAI,EAAE,kCAAkC;IAE5D,eAAe;IACf,eAAe,EAAE,EAAE;IACnB,mBAAmB,EAAE,EAAE;IACvB,gBAAgB,EAAE,GAAG,EAAE,WAAW;IAClC,iBAAiB,EAAE,IAAI,EAAE,WAAW;CAC5B,CAAC;AAEX,uBAAuB;AAEvB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,KAAK;CACN,CAAC;AAEX,sCAAsC;AAEtC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACxC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,mBAAmB;IACjD,WAAW,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAC1C,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IACzC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,QAAQ;CACjC,CAAC;AAEX,2BAA2B;AAE3B,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe,EAAE,CAAC;IAClB,yBAAyB,EAAE,EAAE;IAC7B,yBAAyB,EAAE,EAAE;IAC7B,sBAAsB,EAAE,EAAE;IAC1B,gBAAgB,EAAE,GAAG;CACb,CAAC"}

package/dist/crypto.d.ts

@@ -0,0 +1,47 @@
+/** Fields required for hash computation. Subset of DecisionEvent. */
+interface HashableDecision {
+    decisionType: string;
+    tokenSymbol: string;
+    eventTime: Date;
+    direction: string | null;
+    entryPrice: number | null;
+    exitPrice: number | null;
+    size: number | null;
+    thesis: string | null;
+    confidence: number;
+    actor: string;
+}
+/** Result of chain verification. */
+export interface ChainVerificationResult {
+    valid: boolean;
+    brokenAt?: number;
+}
+/** Minimal shape needed for chain verification. */
+export interface VerifiableDecision extends HashableDecision {
+    hash: string;
+    previousHash: string | null;
+}
+/**
+ * Compute a SHA256 hash for a decision event, chained to the previous hash.
+ *
+ * The hash is deterministic: same inputs always produce the same hex digest.
+ * Fields are serialized in a fixed order to ensure consistency.
+ *
+ * @param event - Core decision fields to hash
+ * @param previousHash - Hash of the preceding decision in the chain, or null for the first
+ * @returns Hex-encoded SHA256 hash string
+ */
+export declare function computeDecisionHash(event: HashableDecision, previousHash: string | null): string;
+/**
+ * Verify the integrity of a decision hash chain.
+ *
+ * Iterates through decisions in chronological order, recomputing each hash
+ * and checking that it matches the stored hash. The first decision must have
+ * `previousHash === null`.
+ *
+ * @param decisions - Array of decisions in chronological order (oldest first)
+ * @returns `{ valid: true }` if the chain is intact, or `{ valid: false, brokenAt: index }`
+ */
+export declare function verifyChain(decisions: VerifiableDecision[]): ChainVerificationResult;
+export {};
+//# sourceMappingURL=crypto.d.ts.map

package/dist/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,UAAU,gBAAgB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAID;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,MAAM,CAgBR;AAID;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,CAkBpF"}

package/dist/crypto.js

@@ -0,0 +1,56 @@
+import { createHash } from 'node:crypto';
+// ─── Hash Computation ───
+/**
+ * Compute a SHA256 hash for a decision event, chained to the previous hash.
+ *
+ * The hash is deterministic: same inputs always produce the same hex digest.
+ * Fields are serialized in a fixed order to ensure consistency.
+ *
+ * @param event - Core decision fields to hash
+ * @param previousHash - Hash of the preceding decision in the chain, or null for the first
+ * @returns Hex-encoded SHA256 hash string
+ */
+export function computeDecisionHash(event, previousHash) {
+    const payload = [
+        event.decisionType,
+        event.tokenSymbol,
+        event.eventTime.toISOString(),
+        event.direction ?? '',
+        event.entryPrice?.toString() ?? '',
+        event.exitPrice?.toString() ?? '',
+        event.size?.toString() ?? '',
+        event.thesis ?? '',
+        event.confidence.toString(),
+        event.actor,
+        previousHash ?? '',
+    ].join('|');
+    return createHash('sha256').update(payload).digest('hex');
+}
+// ─── Chain Verification ───
+/**
+ * Verify the integrity of a decision hash chain.
+ *
+ * Iterates through decisions in chronological order, recomputing each hash
+ * and checking that it matches the stored hash. The first decision must have
+ * `previousHash === null`.
+ *
+ * @param decisions - Array of decisions in chronological order (oldest first)
+ * @returns `{ valid: true }` if the chain is intact, or `{ valid: false, brokenAt: index }`
+ */
+export function verifyChain(decisions) {
+    for (let i = 0; i < decisions.length; i++) {
+        const decision = decisions[i];
+        const expectedPreviousHash = i === 0 ? null : decisions[i - 1].hash;
+        // Verify previousHash linkage
+        if (decision.previousHash !== expectedPreviousHash) {
+            return { valid: false, brokenAt: i };
+        }
+        // Recompute hash and verify
+        const recomputed = computeDecisionHash(decision, decision.previousHash);
+        if (recomputed !== decision.hash) {
+            return { valid: false, brokenAt: i };
+        }
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8BzC,2BAA2B;AAE3B;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAuB,EACvB,YAA2B;IAE3B,MAAM,OAAO,GAAG;QACd,KAAK,CAAC,YAAY;QAClB,KAAK,CAAC,WAAW;QACjB,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;QAC7B,KAAK,CAAC,SAAS,IAAI,EAAE;QACrB,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QAClC,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;QACjC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5B,KAAK,CAAC,MAAM,IAAI,EAAE;QAClB,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE;QAC3B,KAAK,CAAC,KAAK;QACX,YAAY,IAAI,EAAE;KACnB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,6BAA6B;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,SAA+B;IACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,oBAAoB,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpE,8BAA8B;QAC9B,IAAI,QAAQ,CAAC,YAAY,KAAK,oBAAoB,EAAE,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;QAED,4BAA4B;QAC5B,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QACxE,IAAI,UAAU,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,25 @@
+export declare class TradingBoyError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class DatabaseError extends TradingBoyError {
+    constructor(message: string);
+}
+export declare class NetworkError extends TradingBoyError {
+    readonly statusCode: number | undefined;
+    readonly url: string;
+    constructor(message: string, url: string, statusCode?: number);
+}
+export declare class ValidationError extends TradingBoyError {
+    readonly field: string;
+    constructor(message: string, field: string);
+}
+export declare class ConfigError extends TradingBoyError {
+    constructor(message: string);
+}
+export declare class NotFoundError extends TradingBoyError {
+    readonly entity: string;
+    readonly id: string;
+    constructor(entity: string, id: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAEA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAID,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM;CAG5B;AAID,qBAAa,YAAa,SAAQ,eAAe;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAK9D;AAID,qBAAa,eAAgB,SAAQ,eAAe;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAI3C;AAID,qBAAa,WAAY,SAAQ,eAAe;gBAClC,OAAO,EAAE,MAAM;CAG5B;AAID,qBAAa,aAAc,SAAQ,eAAe;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;CAKvC"}

package/dist/errors/index.js

@@ -0,0 +1,50 @@
+// ─── Base Error ───
+export class TradingBoyError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+    }
+}
+// ─── Database ───
+export class DatabaseError extends TradingBoyError {
+    constructor(message) {
+        super(message, 'DB_ERROR');
+    }
+}
+// ─── Network ───
+export class NetworkError extends TradingBoyError {
+    statusCode;
+    url;
+    constructor(message, url, statusCode) {
+        super(message, 'NETWORK_ERROR');
+        this.url = url;
+        this.statusCode = statusCode;
+    }
+}
+// ─── Validation ───
+export class ValidationError extends TradingBoyError {
+    field;
+    constructor(message, field) {
+        super(message, 'VALIDATION_ERROR');
+        this.field = field;
+    }
+}
+// ─── Config ───
+export class ConfigError extends TradingBoyError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+    }
+}
+// ─── Not Found ───
+export class NotFoundError extends TradingBoyError {
+    entity;
+    id;
+    constructor(entity, id) {
+        super(`${entity} not found: ${id}`, 'NOT_FOUND');
+        this.entity = entity;
+        this.id = id;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AAErB,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,mBAAmB;AAEnB,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,kBAAkB;AAElB,MAAM,OAAO,YAAa,SAAQ,eAAe;IACtC,UAAU,CAAqB;IAC/B,GAAG,CAAS;IAErB,YAAY,OAAe,EAAE,GAAW,EAAE,UAAmB;QAC3D,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,qBAAqB;AAErB,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACzC,KAAK,CAAS;IAEvB,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,iBAAiB;AAEjB,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACjC,CAAC;CACF;AAED,oBAAoB;AAEpB,MAAM,OAAO,aAAc,SAAQ,eAAe;IACvC,MAAM,CAAS;IACf,EAAE,CAAS;IAEpB,YAAY,MAAc,EAAE,EAAU;QACpC,KAAK,CAAC,GAAG,MAAM,eAAe,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF"}