kachow 0.1.0

package/README.md

@@ -0,0 +1,77 @@
+# ⚡ KA-CHOW
+
+**Living knowledge graph for your engineering system.**
+
+Scan any codebase and get an interactive architecture dashboard — dependency graph, health scores, impact analysis, and AI-powered insights — all in your browser.
+
+![KA-CHOW Dashboard](https://raw.githubusercontent.com/HarshXAI/kachow/main/docs/dashboard.png)
+
+## Quick Start
+
+```bash
+npx kachow init
+```
+
+That's it. KA-CHOW will:
+1. 🔑 Ask for your API keys (Anthropic required, others optional)
+2. 🔍 Auto-detect and scan your repositories
+3. 🚀 Start a local server with an interactive dashboard
+4. 🌐 Open your browser at `http://localhost:3000`
+
+## What You Get
+
+- **Interactive Knowledge Graph** — Visualize every service, dependency, and data flow
+- **Health Scores** — Per-service health with latency, error rate, and coverage metrics
+- **Impact Analysis** — "What breaks if I change this?" with blast radius visualization
+- **AI Q&A Terminal** — Ask questions about your architecture in natural language
+- **Self-Healing Suggestions** — AI-detected issues with one-click fix proposals
+- **Architecture Blueprints** — Per-service compliance reports against your standards
+- **Manager Dashboard** — Team onboarding, critical issues, and deployment overview
+
+## Commands
+
+```bash
+kachow init              # Full setup: credentials → scan → dashboard
+kachow serve             # Start server without re-scanning
+kachow scan -p ./path    # Scan a specific repo
+kachow health            # Print system health summary
+kachow reset --force     # Wipe local data and start fresh
+```
+
+## Requirements
+
+- **Node.js 18+**
+- **Anthropic API key** (for AI features — get one at [console.anthropic.com](https://console.anthropic.com))
+
+Optional: GitHub token (for private repos), OpenAI key (alternate models), Slack/Jira tokens (integrations).
+
+## How It Works
+
+KA-CHOW scans your codebase to build a knowledge graph:
+- Detects services, packages, and modules
+- Maps imports, API calls, and data flows into dependency edges
+- Scores health based on test coverage, documentation, error handling, and more
+- Stores everything in a local SQLite database (`.kachow/kachow.db`)
+
+No data ever leaves your machine unless you explicitly configure cloud integrations.
+
+## Configuration
+
+Create a `kachow.config.yaml` in your project root (auto-generated on first `init`):
+
+```yaml
+version: 1
+project:
+  name: "My Platform"
+repos:
+  - name: api-service
+    path: ./services/api
+    language: typescript
+standards:
+  require_readme: true
+  min_test_coverage: 70
+```
+
+## License
+
+MIT

package/_server/dist/app.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * KA-CHOW Express application.
+ * Sets up middleware, mounts route handlers, and defines error handling.
+ * This file exports the `app` — it does NOT call app.listen().
+ * Server startup lives in server.ts.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.app = void 0;
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const dotenv_1 = __importDefault(require("dotenv"));
+const path_1 = require("path");
+const fs_1 = require("fs");
+const ingest_js_1 = require("./routes/ingest.js");
+const graph_js_1 = require("./routes/graph.js");
+const github_js_1 = require("./routes/github.js");
+const impact_js_1 = require("./routes/impact.js");
+const qa_js_1 = require("./routes/qa.js");
+const stream_js_1 = require("./routes/stream.js");
+const manager_js_1 = require("./routes/manager.js");
+const architecture_js_1 = require("./routes/architecture.js");
+const healing_js_1 = require("./routes/healing.js");
+const webhooks_js_1 = require("./routes/webhooks.js");
+const scanner_js_1 = require("./routes/scanner.js");
+const agents_js_1 = require("./routes/agents.js");
+const notifications_js_1 = require("./routes/notifications.js");
+const config_js_1 = require("./routes/config.js");
+// Load .env — try monorepo root first (packages/server → ../../), then local fallback
+dotenv_1.default.config({ path: (0, path_1.resolve)(process.cwd(), '../../.env') });
+dotenv_1.default.config(); // no-op if already loaded; handles local .env for non-monorepo setups
+const app = (0, express_1.default)();
+exports.app = app;
+// ── Middleware ────────────────────────────────────────────────────────────────
+const PORT = process.env.PORT || '3000';
+const ALLOWED_ORIGINS = (process.env.CORS_ORIGIN || '')
+    .split(',')
+    .map(o => o.trim())
+    .filter(Boolean)
+    .concat([
+    `http://localhost:${PORT}`, // same-origin when served by Express
+    `http://127.0.0.1:${PORT}`,
+    'http://localhost:5173', // Vite dev server
+    'http://localhost:8080',
+    'http://127.0.0.1:8080',
+]);
+app.use((0, cors_1.default)({
+    origin: (origin, cb) => {
+        // Allow requests with no origin (curl, Postman, server-to-server)
+        if (!origin)
+            return cb(null, true);
+        if (ALLOWED_ORIGINS.includes(origin))
+            return cb(null, true);
+        cb(new Error(`CORS: origin ${origin} not allowed`));
+    },
+    credentials: true,
+}));
+app.use(express_1.default.json());
+app.use(express_1.default.urlencoded({ extended: true }));
+// ── Static files — serve built React app ──────────────────────────────────────
+// __dirname works in CJS (tsc compiles to CJS). In dev (tsx) we fallback.
+const publicDir = (0, path_1.resolve)(__dirname, '../public');
+if ((0, fs_1.existsSync)(publicDir)) {
+    app.use(express_1.default.static(publicDir));
+}
+// ── Routes ────────────────────────────────────────────────────────────────────
+/**
+ * GET /health
+ * Server health check used by load balancers and the frontend status strip.
+ *
+ * @returns Standard ApiResponse with server status and version
+ */
+app.get('/health', (_req, res) => {
+    res.json({
+        success: true,
+        data: { status: 'ok', version: '1.0.0' },
+        error: null,
+        meta: { timestamp: new Date().toISOString(), version: '1.0.0' },
+    });
+});
+// ── API Routes ───────────────────────────────────────────────────────────────
+app.use('/api/ingest', ingest_js_1.ingestRouter);
+app.use('/api/graph', graph_js_1.graphRouter);
+app.use('/api/github', github_js_1.githubRouter);
+app.use('/api/impact', impact_js_1.impactRouter);
+app.use('/api/qa', qa_js_1.qaRouter);
+app.use('/api/stream', stream_js_1.streamRouter);
+app.use('/api/manager', manager_js_1.managerRouter);
+app.use('/api/onboarding', manager_js_1.managerRouter); // brief: GET /api/onboarding/path/:role
+app.use('/api/architecture', architecture_js_1.architectureRouter);
+app.use('/api/heal', healing_js_1.healingRouter);
+app.use('/api/webhooks', webhooks_js_1.webhooksRouter);
+app.use('/api/scanner', scanner_js_1.scannerRouter);
+app.use('/api/agents', agents_js_1.agentRouter);
+app.use('/api/notifications', notifications_js_1.notificationRouter);
+app.use('/api/ci', webhooks_js_1.webhooksRouter);
+app.use('/api/config', config_js_1.configRouter);
+// ── SPA catch-all — serve index.html for non-API routes ──────────────────────
+const indexPath = (0, path_1.join)(publicDir, 'index.html');
+if ((0, fs_1.existsSync)(indexPath)) {
+    app.use((req, res, next) => {
+        if (req.path.startsWith('/api') || req.path === '/health')
+            return next();
+        res.sendFile(indexPath);
+    });
+}
+// ── 404 handler (only hits for unmatched /api/* routes) ───────────────────────
+app.use((req, res) => {
+    res.status(404).json({
+        success: false,
+        data: null,
+        error: `Route ${req.method} ${req.path} not found`,
+        meta: { timestamp: new Date().toISOString(), version: '1.0.0' },
+    });
+});
+// ── Global error handler ──────────────────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+app.use((err, _req, res, _next) => {
+    console.error('[KA-CHOW Error]', err.stack);
+    res.status(500).json({
+        success: false,
+        data: null,
+        error: err.message || 'Internal Server Error',
+        meta: { timestamp: new Date().toISOString(), version: '1.0.0' },
+    });
+});
+//# sourceMappingURL=app.js.map

package/_server/dist/db/index.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * KA-CHOW database singleton.
+ * Returns the same better-sqlite3 instance for the lifetime of the process.
+ * In test mode (NODE_ENV=test) uses TEST_DB_PATH (defaults to :memory:).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDb = getDb;
+exports.closeDb = closeDb;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const path_1 = __importDefault(require("path"));
+const schema_js_1 = require("./schema.js");
+let _db = null;
+/**
+ * Returns the initialised SQLite database singleton.
+ * Creates the database file and runs all migrations on first call.
+ * Subsequent calls return the same cached instance.
+ *
+ * @returns The better-sqlite3 Database instance
+ * @throws If the database file cannot be created or migrations fail
+ */
+function getDb() {
+    if (_db)
+        return _db;
+    const isTest = process.env.NODE_ENV === 'test';
+    const dbPath = isTest
+        ? (process.env.TEST_DB_PATH ?? ':memory:')
+        : (process.env.DB_PATH ?? path_1.default.resolve(process.cwd(), 'kachow.db'));
+    _db = new better_sqlite3_1.default(dbPath);
+    _db.pragma('journal_mode = WAL');
+    _db.pragma('foreign_keys = ON');
+    (0, schema_js_1.runMigrations)(_db);
+    return _db;
+}
+/**
+ * Closes the database connection and clears the singleton.
+ * Must be called on graceful shutdown and in test afterAll hooks.
+ *
+ * @returns void
+ */
+function closeDb() {
+    if (_db) {
+        _db.close();
+        _db = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/_server/dist/db/schema.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * KA-CHOW SQLite schema.
+ * All CREATE TABLE statements live here.
+ * Called once by db/index.ts on first startup and by test-helpers in tests.
+ *
+ * Rule: Never DROP or ALTER tables directly — write a migration in
+ * packages/server/src/db/migrations/ instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TABLES = void 0;
+exports.runMigrations = runMigrations;
+/**
+ * All table names in the KA-CHOW schema.
+ * Used by tests to assert every table was created.
+ */
+exports.TABLES = [
+    'services',
+    'dependencies',
+    'incidents',
+    'endpoints',
+    'impact_analyses',
+    'adrs',
+    'healing_prs',
+    'qa_sessions',
+    'activity_feed',
+    'snapshots',
+    'teams',
+    'team_members',
+    'agent_analyses',
+    'knowledge_graph',
+];
+/**
+ * Runs all DDL statements against the provided database instance.
+ * Uses CREATE TABLE IF NOT EXISTS — idempotent and safe to call multiple times.
+ *
+ * @param db - An initialised better-sqlite3 Database instance
+ * @returns void
+ * @throws If SQLite reports a syntax or constraint error in the DDL
+ */
+function runMigrations(db) {
+    db.exec(`
+    -- ── TEAMS (manager-created, join-code gated) ─────────────────────
+    -- Created FIRST because services references teams(id)
+    CREATE TABLE IF NOT EXISTS teams (
+      id          TEXT PRIMARY KEY,
+      name        TEXT NOT NULL,
+      repo        TEXT DEFAULT '—',
+      join_code   TEXT NOT NULL UNIQUE,     -- 6-digit numeric code
+      description TEXT DEFAULT '',
+      color       TEXT DEFAULT '#6366F1',
+      created_at  TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at  TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── TEAM MEMBERS ─────────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS team_members (
+      id        TEXT PRIMARY KEY,
+      team_id   TEXT NOT NULL REFERENCES teams(id) ON DELETE CASCADE,
+      name      TEXT NOT NULL,
+      role      TEXT DEFAULT 'Engineer',
+      online    INTEGER DEFAULT 0,          -- 0 = offline, 1 = online
+      progress  INTEGER DEFAULT 0,          -- onboarding progress (0-7)
+      joined_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── SERVICES (graph nodes) ──────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS services (
+      id            TEXT PRIMARY KEY,           -- slug: 'auth-service'
+      name          TEXT NOT NULL,              -- 'Auth Service'
+      repo_url      TEXT,                       -- github.com/org/auth-service
+      repo_subpath  TEXT,                       -- subdir within monorepo e.g. 'services/blog'
+      team          TEXT,                       -- legacy sub-team label e.g. 'platform'
+      team_id       TEXT REFERENCES teams(id) ON DELETE CASCADE,  -- FK to teams table for multi-tenancy
+      language      TEXT,                       -- 'typescript'
+      health_score  INTEGER DEFAULT 100,        -- 0-100
+      health_tier   TEXT    DEFAULT 'healthy',  -- healthy/warning/critical
+      doc_coverage  INTEGER DEFAULT 0,          -- % documented
+      test_coverage INTEGER DEFAULT 0,          -- % tested
+      is_external   INTEGER DEFAULT 0,          -- 1 = unresolved external dep, not a real service
+      last_commit   TEXT,                       -- ISO timestamp
+      last_ingested TEXT,                       -- ISO timestamp
+      created_at    TEXT    DEFAULT CURRENT_TIMESTAMP,
+      updated_at    TEXT    DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── DEPENDENCIES (graph edges) ──────────────────────────────────
+    CREATE TABLE IF NOT EXISTS dependencies (
+      id         TEXT PRIMARY KEY,
+      source_id  TEXT REFERENCES services(id) ON DELETE CASCADE,
+      target_id  TEXT REFERENCES services(id) ON DELETE CASCADE,
+      type       TEXT NOT NULL,             -- REST/Event/gRPC/DB
+      endpoints  TEXT,                      -- JSON array of endpoint strings
+      strength   INTEGER DEFAULT 1,         -- call frequency weight
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(source_id, target_id, type)    -- one edge per direction+type pair
+    );
+
+    -- ── INCIDENTS ───────────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS incidents (
+      id          TEXT PRIMARY KEY,
+      service_id  TEXT REFERENCES services(id) ON DELETE CASCADE,
+      severity    TEXT NOT NULL,            -- P0/P1/P2/P3
+      title       TEXT NOT NULL,
+      root_cause  TEXT,
+      status      TEXT DEFAULT 'open',      -- open/resolved/postmortem
+      occurred_at TEXT NOT NULL,
+      resolved_at TEXT,
+      created_at  TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── ENDPOINTS ───────────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS endpoints (
+      id         TEXT PRIMARY KEY,
+      service_id TEXT REFERENCES services(id) ON DELETE CASCADE,
+      method     TEXT NOT NULL,             -- GET/POST/PUT/DELETE
+      path       TEXT NOT NULL,             -- /api/v1/users/:id
+      deprecated INTEGER DEFAULT 0,         -- 0 or 1
+      has_spec   INTEGER DEFAULT 0,         -- OpenAPI spec exists
+      consumers  TEXT,                      -- JSON array of service ids
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      updated_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(service_id, path, method)      -- one row per service+route+verb
+    );
+
+    -- ── IMPACT ANALYSES ─────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS impact_analyses (
+      id           TEXT PRIMARY KEY,
+      trigger_type TEXT NOT NULL,           -- deprecation/schema-change/delete
+      trigger_ref  TEXT NOT NULL,           -- endpoint or schema name
+      service_id   TEXT REFERENCES services(id) ON DELETE CASCADE,
+      team_id      TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      affected     TEXT NOT NULL,           -- JSON: [{id, name, impact_type}]
+      risk_score   REAL NOT NULL,           -- 0.0-10.0
+      confidence   REAL NOT NULL,           -- 0.0-1.0
+      precedent    TEXT,                    -- historical match description
+      status       TEXT DEFAULT 'pending',  -- pending/reviewed/actioned
+      created_at   TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── ADR DRAFTS ──────────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS adrs (
+      id           TEXT PRIMARY KEY,
+      analysis_id  TEXT REFERENCES impact_analyses(id) ON DELETE CASCADE,
+      title        TEXT NOT NULL,
+      context      TEXT NOT NULL,
+      decision     TEXT NOT NULL,
+      consequences TEXT NOT NULL,
+      status       TEXT DEFAULT 'draft',    -- draft/approved/rejected
+      created_at   TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── SELF-HEALING PRs ────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS healing_prs (
+      id            TEXT PRIMARY KEY,
+      service_id    TEXT REFERENCES services(id) ON DELETE CASCADE,
+      team_id       TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      issue_type    TEXT NOT NULL,          -- missing-retry/no-error-handling/etc
+      patch         TEXT NOT NULL,          -- the actual code diff
+      explanation   TEXT NOT NULL,
+      github_pr_url TEXT,
+      github_pr_num INTEGER,
+      status        TEXT DEFAULT 'open',    -- open/merged/closed
+      created_at    TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── Q&A HISTORY ─────────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS qa_sessions (
+      id            TEXT PRIMARY KEY,
+      team_id       TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      question      TEXT NOT NULL,
+      answer        TEXT NOT NULL,
+      citations     TEXT NOT NULL,          -- JSON array of {file, line, snippet}
+      related_nodes TEXT NOT NULL,          -- JSON array of service ids
+      created_at    TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── ACTIVITY FEED ───────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS activity_feed (
+      id         TEXT PRIMARY KEY,
+      type       TEXT NOT NULL,             -- commit/health-drop/pr-opened/etc
+      service_id TEXT,
+      team_id    TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      title      TEXT NOT NULL,
+      detail     TEXT,
+      severity   TEXT DEFAULT 'info',       -- info/warning/critical
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── GRAPH SNAPSHOTS ─────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS snapshots (
+      id         TEXT PRIMARY KEY,
+      version    TEXT NOT NULL,
+      team_id    TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      nodes      TEXT NOT NULL,             -- JSON: GraphNode[]
+      edges      TEXT NOT NULL,             -- JSON: GraphEdge[]
+      created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+      UNIQUE(version, team_id)              -- one snapshot per version per team
+    );
+
+    -- ── AGENT ANALYSES ──────────────────────────────────────────────
+    CREATE TABLE IF NOT EXISTS agent_analyses (
+      id            TEXT PRIMARY KEY,
+      analysis_id   TEXT NOT NULL,
+      agent_name    TEXT NOT NULL,
+      service_id    TEXT,
+      service_name  TEXT,
+      team_id       TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      findings      TEXT NOT NULL,
+      summary       TEXT NOT NULL,
+      duration_ms   INTEGER,
+      created_at    TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+
+    -- ── KNOWLEDGE GRAPH (agent-produced) ────────────────────────────
+    CREATE TABLE IF NOT EXISTS knowledge_graph (
+      id            TEXT PRIMARY KEY,
+      team_id       TEXT REFERENCES teams(id) ON DELETE CASCADE,
+      nodes         TEXT NOT NULL,          -- JSON: KnowledgeNode[]
+      edges         TEXT NOT NULL,          -- JSON: KnowledgeEdge[]
+      architecture  TEXT NOT NULL,          -- JSON: { layers, dataFlows }
+      self_healing  TEXT NOT NULL,          -- JSON: SelfHealingSuggestion[]
+      summary       TEXT NOT NULL,
+      created_at    TEXT DEFAULT CURRENT_TIMESTAMP
+    );
+  `);
+    // ── Run additive migrations for existing databases ────────────────────────
+    // These are safe to run repeatedly — they only add columns if missing.
+    const safeAddColumn = (table, column, definition) => {
+        try {
+            db.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${definition}`);
+        }
+        catch {
+            // Column already exists — this is expected and safe to ignore
+        }
+    };
+    // Multi-tenancy columns for existing DBs
+    safeAddColumn('services', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('impact_analyses', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('healing_prs', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('qa_sessions', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('activity_feed', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('snapshots', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('agent_analyses', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+    safeAddColumn('knowledge_graph', 'team_id', 'TEXT REFERENCES teams(id) ON DELETE CASCADE');
+}
+//# sourceMappingURL=schema.js.map

package/_server/dist/queues/ingestQueue.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * BullMQ ingest queue definition.
+ * All repository ingestion jobs are enqueued here and processed by ingestWorker.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIngestQueue = getIngestQueue;
+exports.closeIngestQueue = closeIngestQueue;
+const bullmq_1 = require("bullmq");
+const redis_js_1 = require("./redis.js");
+let _ingestQueue = null;
+/**
+ * Returns (and lazily creates) the ingest BullMQ queue.
+ * Returns null when Redis is disabled — callers should run jobs in-process instead.
+ *
+ * @returns BullMQ Queue for ingestion jobs, or null if Redis is disabled
+ */
+function getIngestQueue() {
+    if ((0, redis_js_1.isRedisDisabled)())
+        return null;
+    const redis = (0, redis_js_1.getRedis)();
+    if (!redis)
+        return null;
+    if (!_ingestQueue) {
+        _ingestQueue = new bullmq_1.Queue('ingest', {
+            connection: redis,
+            defaultJobOptions: {
+                attempts: 2,
+                backoff: { type: 'exponential', delay: 3000 },
+                removeOnComplete: { count: 100 },
+                removeOnFail: { count: 50 },
+            },
+        });
+    }
+    return _ingestQueue;
+}
+/**
+ * Closes the ingest queue connection.
+ * Call during graceful server shutdown.
+ *
+ * @returns Promise that resolves when queue is closed
+ */
+async function closeIngestQueue() {
+    if (_ingestQueue) {
+        await _ingestQueue.close();
+        _ingestQueue = null;
+    }
+}
+//# sourceMappingURL=ingestQueue.js.map

package/_server/dist/queues/redis.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Redis connection for BullMQ.
+ * A single shared IORedis instance reused by all queues and workers.
+ * Connection parameters are read from environment variables.
+ *
+ * Set DISABLE_REDIS=true to skip Redis entirely (jobs run in-process).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRedisDisabled = isRedisDisabled;
+exports.getRedis = getRedis;
+exports.closeRedis = closeRedis;
+const ioredis_1 = require("ioredis");
+let _redis = null;
+/** Returns true when Redis has been explicitly disabled via env var. */
+function isRedisDisabled() {
+    return process.env.DISABLE_REDIS === 'true';
+}
+/**
+ * Returns (and lazily creates) the shared Redis client.
+ * Returns null when DISABLE_REDIS=true — callers must handle the null case.
+ *
+ * @returns Shared IORedis instance or null if Redis is disabled
+ */
+function getRedis() {
+    if (isRedisDisabled())
+        return null;
+    if (!_redis) {
+        _redis = new ioredis_1.Redis({
+            host: process.env.REDIS_HOST || '127.0.0.1',
+            port: Number(process.env.REDIS_PORT) || 6379,
+            password: process.env.REDIS_PASSWORD || undefined,
+            maxRetriesPerRequest: null, // required by BullMQ
+            enableReadyCheck: false,
+            // Stop hammering the console — log once, then back off silently
+            retryStrategy: (times) => {
+                if (times === 1)
+                    console.warn('[Redis] Not available — ingest jobs will run in-process. Set DISABLE_REDIS=true to silence this.');
+                return Math.min(times * 500, 10_000);
+            },
+        });
+        _redis.on('error', () => { });
+    }
+    return _redis;
+}
+/**
+ * Closes the shared Redis connection.
+ * Call during graceful server shutdown.
+ *
+ * @returns Promise that resolves when connection is fully closed
+ */
+async function closeRedis() {
+    if (_redis) {
+        await _redis.quit();
+        _redis = null;
+    }
+}
+//# sourceMappingURL=redis.js.map