@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/config/loader.js

@@ -0,0 +1,311 @@
+/**
+ * Config loader: smol-toml parsing, nested section detection, env override, Zod validation.
+ *
+ * Pipeline: read config.toml -> parse with smol-toml -> detectNestedSections ->
+ *           applyEnvOverrides -> DaemonConfigSchema.parse (Zod defaults + validation).
+ *
+ * @see docs/24-monorepo-data-directory.md section 3.5
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse } from 'smol-toml';
+import { z } from 'zod';
+import { EvmNetworkTypeEnum } from '@waiaas/core';
+// ---------------------------------------------------------------------------
+// Zod Schema: 10 sections, flat keys, with defaults
+// ---------------------------------------------------------------------------
+export const DaemonConfigSchema = z.object({
+    daemon: z
+        .object({
+        port: z.number().int().min(1024).max(65535).default(3100),
+        hostname: z
+            .union([z.literal('127.0.0.1'), z.literal('0.0.0.0')])
+            .default('127.0.0.1'),
+        log_level: z.enum(['trace', 'debug', 'info', 'warn', 'error']).default('info'),
+        log_file: z.string().default('logs/daemon.log'),
+        log_max_size: z.string().default('50MB'),
+        log_max_files: z.number().int().min(1).max(100).default(5),
+        pid_file: z.string().default('daemon.pid'),
+        shutdown_timeout: z.number().int().min(5).max(300).default(30),
+        dev_mode: z.boolean().default(false),
+        admin_ui: z.boolean().default(true),
+        admin_timeout: z.number().int().min(60).max(7200).default(900),
+        update_check: z.boolean().default(true),
+        update_check_interval: z.number().int().min(3600).max(604800).default(86400),
+    })
+        .default({}),
+    keystore: z
+        .object({
+        argon2_memory: z.number().int().min(32768).max(1048576).default(65536),
+        argon2_time: z.number().int().min(1).max(20).default(3),
+        argon2_parallelism: z.number().int().min(1).max(16).default(4),
+        backup_on_rotate: z.boolean().default(true),
+    })
+        .default({}),
+    database: z
+        .object({
+        path: z.string().default('data/waiaas.db'),
+        wal_checkpoint_interval: z.number().int().min(60).max(3600).default(300),
+        busy_timeout: z.number().int().min(1000).max(30000).default(5000),
+        cache_size: z.number().int().min(2000).max(512000).default(64000),
+        mmap_size: z.number().int().min(0).max(1073741824).default(268435456),
+    })
+        .default({}),
+    rpc: z
+        .object({
+        // Solana (unchanged)
+        solana_mainnet: z.string().default('https://api.mainnet-beta.solana.com'),
+        solana_devnet: z.string().default('https://api.devnet.solana.com'),
+        solana_testnet: z.string().default('https://api.testnet.solana.com'),
+        solana_ws_mainnet: z.string().default('wss://api.mainnet-beta.solana.com'),
+        solana_ws_devnet: z.string().default('wss://api.devnet.solana.com'),
+        // EVM Tier 1 (replaces ethereum_mainnet/ethereum_sepolia)
+        evm_ethereum_mainnet: z.string().default('https://eth.drpc.org'),
+        evm_ethereum_sepolia: z.string().default('https://sepolia.drpc.org'),
+        evm_polygon_mainnet: z.string().default('https://polygon.drpc.org'),
+        evm_polygon_amoy: z.string().default('https://polygon-amoy.drpc.org'),
+        evm_arbitrum_mainnet: z.string().default('https://arbitrum.drpc.org'),
+        evm_arbitrum_sepolia: z.string().default('https://arbitrum-sepolia.drpc.org'),
+        evm_optimism_mainnet: z.string().default('https://optimism.drpc.org'),
+        evm_optimism_sepolia: z.string().default('https://optimism-sepolia.drpc.org'),
+        evm_base_mainnet: z.string().default('https://base.drpc.org'),
+        evm_base_sepolia: z.string().default('https://base-sepolia.drpc.org'),
+        // EVM default network for agent creation when network not specified
+        evm_default_network: EvmNetworkTypeEnum.default('ethereum-sepolia'),
+    })
+        .default({}),
+    notifications: z
+        .object({
+        enabled: z.boolean().default(false),
+        min_channels: z.number().int().min(1).max(10).default(2),
+        health_check_interval: z.number().int().min(60).max(3600).default(300),
+        log_retention_days: z.number().int().min(7).max(365).default(30),
+        dedup_ttl: z.number().int().min(60).max(3600).default(300),
+        telegram_bot_token: z.string().default(''),
+        telegram_chat_id: z.string().default(''),
+        discord_webhook_url: z.string().default(''),
+        ntfy_server: z.string().default('https://ntfy.sh'),
+        ntfy_topic: z.string().default(''),
+        slack_webhook_url: z.string().default(''),
+        locale: z.enum(['en', 'ko']).default('en'),
+        rate_limit_rpm: z.number().int().min(1).max(60).default(20),
+    })
+        .default({}),
+    security: z
+        .object({
+        session_ttl: z.number().int().min(300).max(604800).default(86400),
+        jwt_secret: z.string().default(''),
+        max_sessions_per_wallet: z.number().int().min(1).max(50).default(5),
+        max_pending_tx: z.number().int().min(1).max(100).default(10),
+        nonce_storage: z.enum(['memory', 'sqlite']).default('memory'),
+        nonce_cache_max: z.number().int().min(100).max(10000).default(1000),
+        nonce_cache_ttl: z.number().int().min(60).max(600).default(300),
+        rate_limit_global_ip_rpm: z.number().int().min(100).max(10000).default(1000),
+        rate_limit_session_rpm: z.number().int().min(10).max(5000).default(300),
+        rate_limit_tx_rpm: z.number().int().min(1).max(100).default(10),
+        cors_origins: z
+            .array(z.string())
+            .default(['http://localhost:3100', 'http://127.0.0.1:3100']),
+        // AutoStop engine thresholds (AUTO-05 runtime-overridable via Admin Settings)
+        autostop_consecutive_failures_threshold: z.number().int().min(1).max(50).default(5),
+        autostop_unusual_activity_threshold: z.number().int().min(5).max(200).default(20),
+        autostop_unusual_activity_window_sec: z.number().int().min(60).max(3600).default(300),
+        autostop_idle_timeout_sec: z.number().int().min(300).max(86400).default(3600),
+        autostop_idle_check_interval_sec: z.number().int().min(10).max(600).default(60),
+        autostop_enabled: z.boolean().default(true),
+        // Balance monitoring thresholds (BMON-05 runtime-overridable via Admin Settings)
+        monitoring_check_interval_sec: z.number().int().min(60).max(3600).default(300),
+        monitoring_low_balance_threshold_sol: z.number().min(0.001).max(100).default(0.01),
+        monitoring_low_balance_threshold_eth: z.number().min(0.0001).max(10).default(0.005),
+        monitoring_cooldown_hours: z.number().int().min(1).max(168).default(24),
+        monitoring_enabled: z.boolean().default(true),
+        policy_defaults_delay_seconds: z.number().int().min(60).max(3600).default(300),
+        policy_defaults_approval_timeout: z.number().int().min(300).max(86400).default(3600),
+        kill_switch_recovery_cooldown: z.number().int().min(600).max(86400).default(1800),
+        kill_switch_max_recovery_attempts: z.number().int().min(1).max(10).default(3),
+    })
+        .default({}),
+    walletconnect: z
+        .object({
+        project_id: z.string().default(''),
+        relay_url: z.string().default('wss://relay.walletconnect.com'),
+    })
+        .default({}),
+    x402: z
+        .object({
+        enabled: z.boolean().default(true),
+        request_timeout: z.number().int().min(5).max(120).default(30),
+    })
+        .default({}),
+    display: z
+        .object({
+        currency: z.string().default('USD'),
+    })
+        .default({}),
+    telegram: z
+        .object({
+        enabled: z.boolean().default(false),
+        bot_token: z.string().default(''),
+        locale: z.enum(['en', 'ko']).default('en'),
+    })
+        .default({}),
+});
+// ---------------------------------------------------------------------------
+// Known TOML sections
+// ---------------------------------------------------------------------------
+const KNOWN_SECTIONS = [
+    'daemon',
+    'keystore',
+    'database',
+    'rpc',
+    'notifications',
+    'security',
+    'walletconnect',
+    'x402',
+    'display',
+    'telegram',
+];
+// ---------------------------------------------------------------------------
+// detectNestedSections: reject nested TOML sections
+// ---------------------------------------------------------------------------
+/**
+ * Walk top-level keys. If any value is a non-array object whose own values
+ * are also non-array objects, that indicates nested TOML sections which
+ * violate the flat-key config policy.
+ *
+ * Also rejects unknown top-level sections not in KNOWN_SECTIONS.
+ */
+export function detectNestedSections(parsed) {
+    for (const key of Object.keys(parsed)) {
+        // Check unknown section
+        if (!KNOWN_SECTIONS.includes(key)) {
+            throw new Error(`Unknown config section '[${key}]'. Allowed sections: ${KNOWN_SECTIONS.join(', ')}`);
+        }
+        const value = parsed[key];
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            // Check if any sub-value is itself a nested object (not array)
+            for (const [subKey, subValue] of Object.entries(value)) {
+                if (subValue !== null && typeof subValue === 'object' && !Array.isArray(subValue)) {
+                    throw new Error(`Nested TOML section '[${key}.${subKey}]' detected. ` +
+                        `WAIaaS config requires flattened keys. ` +
+                        `Use '${key}_${subKey}_<field>' instead of nested sections.`);
+                }
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// parseEnvValue: coerce string env values to correct types
+// ---------------------------------------------------------------------------
+/**
+ * Parse an environment variable string into the appropriate JS type.
+ * - 'true'/'false' -> boolean
+ * - Numeric strings -> number
+ * - JSON array strings -> parsed array
+ * - Otherwise -> string
+ */
+export function parseEnvValue(value) {
+    // Boolean
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    // JSON array
+    if (value.startsWith('[') && value.endsWith(']')) {
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Fall through to string
+        }
+    }
+    // Number
+    if (/^-?\d+(\.\d+)?$/.test(value)) {
+        const num = Number(value);
+        if (Number.isFinite(num))
+            return num;
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// applyEnvOverrides: WAIAAS_{SECTION}_{KEY} -> config override
+// ---------------------------------------------------------------------------
+/** Env keys to skip (not mapped to config sections). */
+const SKIP_ENV_KEYS = new Set([
+    'WAIAAS_DATA_DIR',
+    'WAIAAS_MASTER_PASSWORD',
+    'WAIAAS_MASTER_PASSWORD_FILE',
+]);
+/**
+ * Apply environment variable overrides. Pattern: WAIAAS_{SECTION}_{KEY}.
+ * The first segment after WAIAAS_ is the section; the rest joined with '_' is the field.
+ *
+ * Special case: WAIAAS_DAEMON_HOSTNAME maps to daemon.hostname.
+ */
+export function applyEnvOverrides(config) {
+    for (const [envKey, envValue] of Object.entries(process.env)) {
+        if (!envKey.startsWith('WAIAAS_') || envValue === undefined)
+            continue;
+        if (SKIP_ENV_KEYS.has(envKey))
+            continue;
+        // Strip prefix, lowercase
+        const stripped = envKey.slice('WAIAAS_'.length).toLowerCase();
+        const parts = stripped.split('_');
+        // First part = section, rest = field name
+        const section = parts[0];
+        if (!section)
+            continue;
+        // Check if section is known
+        if (!KNOWN_SECTIONS.includes(section))
+            continue;
+        const field = parts.slice(1).join('_');
+        if (!field)
+            continue;
+        // Ensure section object exists
+        if (config[section] === undefined ||
+            config[section] === null ||
+            typeof config[section] !== 'object') {
+            config[section] = {};
+        }
+        config[section][field] = parseEnvValue(envValue);
+    }
+}
+// ---------------------------------------------------------------------------
+// loadConfig: main pipeline
+// ---------------------------------------------------------------------------
+/**
+ * Load daemon config from dataDir/config.toml with env override and Zod validation.
+ *
+ * Pipeline:
+ * 1. Read config.toml (ENOENT -> empty object, all defaults)
+ * 2. Parse with smol-toml
+ * 3. Detect nested sections (reject)
+ * 4. Apply env overrides (WAIAAS_{SECTION}_{KEY})
+ * 5. Validate with DaemonConfigSchema.parse() (applies defaults)
+ * 6. Return typed config
+ */
+export function loadConfig(dataDir) {
+    let raw = {};
+    const configPath = join(dataDir, 'config.toml');
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        if (content.trim().length > 0) {
+            raw = parse(content);
+        }
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+        // ENOENT: no config file, use all defaults
+    }
+    // Validate structure
+    detectNestedSections(raw);
+    // Apply env overrides
+    applyEnvOverrides(raw);
+    // Validate and apply defaults via Zod
+    return DaemonConfigSchema.parse(raw);
+}
+//# sourceMappingURL=loader.js.map

package/dist/infrastructure/config/loader.js.map

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

package/dist/infrastructure/database/checks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Utility to generate SQLite CHECK constraint SQL from SSoT enum arrays.
+ *
+ * Produces plain SQL strings (not Drizzle sql.raw()) for test comparison
+ * against sqlite_master CREATE TABLE output.
+ *
+ * @see docs/49-enum-config-consistency-verification.md
+ */
+/**
+ * Generate SQLite CHECK constraint SQL from SSoT enum array.
+ * Returns plain SQL string for test comparison against sqlite_master.
+ *
+ * @param column - Column name to constrain.
+ * @param values - SSoT enum values (as const array).
+ * @returns CHECK constraint SQL, e.g. `CHECK (status IN ('ACTIVE', 'SUSPENDED'))`.
+ * @throws Error if any value contains a single quote (SQL injection prevention).
+ */
+export declare function generateCheckConstraint(column: string, values: readonly string[]): string;
+//# sourceMappingURL=checks.d.ts.map

package/dist/infrastructure/database/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/database/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQzF"}

package/dist/infrastructure/database/checks.js

@@ -0,0 +1,27 @@
+/**
+ * Utility to generate SQLite CHECK constraint SQL from SSoT enum arrays.
+ *
+ * Produces plain SQL strings (not Drizzle sql.raw()) for test comparison
+ * against sqlite_master CREATE TABLE output.
+ *
+ * @see docs/49-enum-config-consistency-verification.md
+ */
+/**
+ * Generate SQLite CHECK constraint SQL from SSoT enum array.
+ * Returns plain SQL string for test comparison against sqlite_master.
+ *
+ * @param column - Column name to constrain.
+ * @param values - SSoT enum values (as const array).
+ * @returns CHECK constraint SQL, e.g. `CHECK (status IN ('ACTIVE', 'SUSPENDED'))`.
+ * @throws Error if any value contains a single quote (SQL injection prevention).
+ */
+export function generateCheckConstraint(column, values) {
+    for (const v of values) {
+        if (v.includes("'")) {
+            throw new Error(`Enum value contains single quote: '${v}'`);
+        }
+    }
+    const quoted = values.map(v => `'${v}'`).join(', ');
+    return `CHECK (${column} IN (${quoted}))`;
+}
+//# sourceMappingURL=checks.js.map

package/dist/infrastructure/database/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../../src/infrastructure/database/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,MAAyB;IAC/E,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,OAAO,UAAU,MAAM,QAAQ,MAAM,IAAI,CAAC;AAC5C,CAAC"}

package/dist/infrastructure/database/compatibility.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Schema compatibility checker for daemon startup.
+ *
+ * Checks whether the running code version is compatible with the DB schema version.
+ * Three outcomes:
+ *   - ok: code == db schema version (or fresh DB)
+ *   - migrate: code > db schema version (auto-migration will be applied by pushSchema)
+ *   - reject: code < db schema version (user must upgrade) OR db < MIN_COMPATIBLE (step-by-step upgrade)
+ *
+ * @see docs/65-migration-strategy.md
+ */
+import type { Database } from 'better-sqlite3';
+/**
+ * Minimum DB schema version this code version can work with.
+ * If the DB schema is below this, a step-by-step upgrade path is required.
+ * Set to 1 (initial schema) -- all migrations from v1 to current are available.
+ * Future breaking migrations may bump this value.
+ */
+export declare const MIN_COMPATIBLE_SCHEMA_VERSION = 1;
+export type CompatibilityResult = {
+    action: 'ok';
+} | {
+    action: 'migrate';
+} | {
+    action: 'reject';
+    reason: 'code_too_old' | 'schema_too_old';
+    message: string;
+};
+/**
+ * Check compatibility between code's expected schema and DB's actual schema version.
+ *
+ * @param sqlite - Raw better-sqlite3 database instance
+ * @returns CompatibilityResult indicating whether to proceed, migrate, or reject
+ */
+export declare function checkSchemaCompatibility(sqlite: Database): CompatibilityResult;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/infrastructure/database/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/database/compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,mBAAmB,CAsD9E"}

package/dist/infrastructure/database/compatibility.js

@@ -0,0 +1,75 @@
+/**
+ * Schema compatibility checker for daemon startup.
+ *
+ * Checks whether the running code version is compatible with the DB schema version.
+ * Three outcomes:
+ *   - ok: code == db schema version (or fresh DB)
+ *   - migrate: code > db schema version (auto-migration will be applied by pushSchema)
+ *   - reject: code < db schema version (user must upgrade) OR db < MIN_COMPATIBLE (step-by-step upgrade)
+ *
+ * @see docs/65-migration-strategy.md
+ */
+import { LATEST_SCHEMA_VERSION } from './migrate.js';
+/**
+ * Minimum DB schema version this code version can work with.
+ * If the DB schema is below this, a step-by-step upgrade path is required.
+ * Set to 1 (initial schema) -- all migrations from v1 to current are available.
+ * Future breaking migrations may bump this value.
+ */
+export const MIN_COMPATIBLE_SCHEMA_VERSION = 1;
+/**
+ * Check compatibility between code's expected schema and DB's actual schema version.
+ *
+ * @param sqlite - Raw better-sqlite3 database instance
+ * @returns CompatibilityResult indicating whether to proceed, migrate, or reject
+ */
+export function checkSchemaCompatibility(sqlite) {
+    // Check if schema_version table exists
+    const tableExists = sqlite
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='schema_version'")
+        .get();
+    if (!tableExists) {
+        // Fresh DB, no schema yet -> pushSchema will handle everything
+        return { action: 'ok' };
+    }
+    // Get current max version and row count
+    const row = sqlite
+        .prepare('SELECT MAX(version) AS max_version FROM schema_version')
+        .get();
+    const dbVersion = row?.max_version ?? null;
+    if (dbVersion === null) {
+        // Empty schema_version table -> fresh DB
+        return { action: 'ok' };
+    }
+    if (dbVersion < MIN_COMPATIBLE_SCHEMA_VERSION) {
+        return {
+            action: 'reject',
+            reason: 'schema_too_old',
+            message: [
+                `DB schema version ${dbVersion} is below minimum compatible version ${MIN_COMPATIBLE_SCHEMA_VERSION}.`,
+                `This database was created with a much older version of WAIaaS.`,
+                `Step-by-step upgrade required:`,
+                `  1. Install the intermediate version: npm install -g @waiaas/cli@<intermediate-version>`,
+                `  2. Run: waiaas start (to migrate DB to intermediate schema)`,
+                `  3. Then upgrade to latest: waiaas upgrade`,
+            ].join('\n'),
+        };
+    }
+    if (dbVersion > LATEST_SCHEMA_VERSION) {
+        return {
+            action: 'reject',
+            reason: 'code_too_old',
+            message: [
+                `DB schema version ${dbVersion} is newer than code expects (${LATEST_SCHEMA_VERSION}).`,
+                `This database was created or migrated by a newer version of WAIaaS.`,
+                `Run: waiaas upgrade`,
+            ].join('\n'),
+        };
+    }
+    if (dbVersion < LATEST_SCHEMA_VERSION) {
+        return { action: 'migrate' };
+    }
+    // dbVersion === LATEST_SCHEMA_VERSION
+    return { action: 'ok' };
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/infrastructure/database/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../../src/infrastructure/database/compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAO/C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAgB;IACvD,uCAAuC;IACvC,MAAM,WAAW,GAAG,MAAM;SACvB,OAAO,CAAC,6EAA6E,CAAC;SACtF,GAAG,EAAE,CAAC;IACT,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,+DAA+D;QAC/D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,wCAAwC;IACxC,MAAM,GAAG,GAAG,MAAM;SACf,OAAO,CAAC,wDAAwD,CAAC;SACjE,GAAG,EAAgD,CAAC;IACvD,MAAM,SAAS,GAAG,GAAG,EAAE,WAAW,IAAI,IAAI,CAAC;IAE3C,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,yCAAyC;QACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,GAAG,6BAA6B,EAAE,CAAC;QAC9C,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE;gBACP,qBAAqB,SAAS,wCAAwC,6BAA6B,GAAG;gBACtG,gEAAgE;gBAChE,gCAAgC;gBAChC,0FAA0F;gBAC1F,+DAA+D;gBAC/D,6CAA6C;aAC9C,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAG,qBAAqB,EAAE,CAAC;QACtC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,cAAc;YACtB,OAAO,EAAE;gBACP,qBAAqB,SAAS,gCAAgC,qBAAqB,IAAI;gBACvF,qEAAqE;gBACrE,qBAAqB;aACtB,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,GAAG,qBAAqB,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/infrastructure/database/connection.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SQLite database connection with 7 required PRAGMAs.
+ *
+ * PRAGMAs are applied in order on every new connection per doc 25 section 1.2:
+ *   1. journal_mode = WAL
+ *   2. synchronous = NORMAL
+ *   3. foreign_keys = ON
+ *   4. busy_timeout = 5000
+ *   5. cache_size = -64000
+ *   6. mmap_size = 268435456
+ *   7. temp_store = MEMORY
+ *
+ * @see docs/25-sqlite-schema.md
+ */
+import type { Database as DatabaseType } from 'better-sqlite3';
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import * as schema from './schema.js';
+export interface DatabaseConnection {
+    sqlite: DatabaseType;
+    db: BetterSQLite3Database<typeof schema>;
+}
+/**
+ * Create a new SQLite database connection with all required PRAGMAs applied.
+ *
+ * @param dbPath - Path to the SQLite database file, or ':memory:' for in-memory.
+ * @returns Object containing the raw better-sqlite3 instance and the Drizzle ORM instance.
+ */
+export declare function createDatabase(dbPath: string): DatabaseConnection;
+/**
+ * Gracefully close the database connection.
+ * Runs WAL checkpoint(TRUNCATE) to merge WAL into main database file before closing.
+ *
+ * @param sqlite - The raw better-sqlite3 database instance.
+ */
+export declare function closeDatabase(sqlite: DatabaseType): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/infrastructure/database/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/database/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAcjE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGxD"}

package/dist/infrastructure/database/connection.js

@@ -0,0 +1,47 @@
+/**
+ * SQLite database connection with 7 required PRAGMAs.
+ *
+ * PRAGMAs are applied in order on every new connection per doc 25 section 1.2:
+ *   1. journal_mode = WAL
+ *   2. synchronous = NORMAL
+ *   3. foreign_keys = ON
+ *   4. busy_timeout = 5000
+ *   5. cache_size = -64000
+ *   6. mmap_size = 268435456
+ *   7. temp_store = MEMORY
+ *
+ * @see docs/25-sqlite-schema.md
+ */
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import * as schema from './schema.js';
+/**
+ * Create a new SQLite database connection with all required PRAGMAs applied.
+ *
+ * @param dbPath - Path to the SQLite database file, or ':memory:' for in-memory.
+ * @returns Object containing the raw better-sqlite3 instance and the Drizzle ORM instance.
+ */
+export function createDatabase(dbPath) {
+    const sqlite = new Database(dbPath);
+    // Apply 7 PRAGMAs in order (doc 25 section 1.2)
+    sqlite.pragma('journal_mode = WAL');
+    sqlite.pragma('synchronous = NORMAL');
+    sqlite.pragma('foreign_keys = ON');
+    sqlite.pragma('busy_timeout = 5000');
+    sqlite.pragma('cache_size = -64000');
+    sqlite.pragma('mmap_size = 268435456');
+    sqlite.pragma('temp_store = MEMORY');
+    const db = drizzle(sqlite, { schema });
+    return { sqlite, db };
+}
+/**
+ * Gracefully close the database connection.
+ * Runs WAL checkpoint(TRUNCATE) to merge WAL into main database file before closing.
+ *
+ * @param sqlite - The raw better-sqlite3 database instance.
+ */
+export function closeDatabase(sqlite) {
+    sqlite.pragma('wal_checkpoint(TRUNCATE)');
+    sqlite.close();
+}
+//# sourceMappingURL=connection.js.map

package/dist/infrastructure/database/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/infrastructure/database/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAOtC;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,gDAAgD;IAChD,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACnC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAErC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}

package/dist/infrastructure/database/id.d.ts

@@ -0,0 +1,17 @@
+/**
+ * UUID v7 ID generation for database records.
+ *
+ * Uses the `uuidv7` package per TD-09 decision: npm package for correctness
+ * over manual implementation. UUID v7 embeds ms-precision timestamp for
+ * time-ordered sorting by string comparison.
+ */
+/**
+ * Generate a new UUID v7 string with ms-precision time ordering.
+ *
+ * IDs generated later will sort lexicographically after earlier IDs,
+ * making `ORDER BY id` equivalent to chronological ordering.
+ *
+ * @returns A new UUID v7 string (e.g., "01927f6e-3c4a-7f1b-8d2e-5f9a0b1c2d3e").
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/infrastructure/database/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/database/id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/infrastructure/database/id.js

@@ -0,0 +1,20 @@
+/**
+ * UUID v7 ID generation for database records.
+ *
+ * Uses the `uuidv7` package per TD-09 decision: npm package for correctness
+ * over manual implementation. UUID v7 embeds ms-precision timestamp for
+ * time-ordered sorting by string comparison.
+ */
+import { uuidv7 } from 'uuidv7';
+/**
+ * Generate a new UUID v7 string with ms-precision time ordering.
+ *
+ * IDs generated later will sort lexicographically after earlier IDs,
+ * making `ORDER BY id` equivalent to chronological ordering.
+ *
+ * @returns A new UUID v7 string (e.g., "01927f6e-3c4a-7f1b-8d2e-5f9a0b1c2d3e").
+ */
+export function generateId() {
+    return uuidv7();
+}
+//# sourceMappingURL=id.js.map

package/dist/infrastructure/database/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../src/infrastructure/database/id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC"}