ci: GitHub Actions workflow + smoke tests

Add .github/workflows/ci.yml with two jobs:
- unit-tests: Runs on every push/PR. Validates JS syntax, ecosystem config,
  compressor unit tests (28 assertions), and smoke tests (11 assertions)
- integration-tests: Manual trigger only (workflow_dispatch). Requires
  OPENAI_API_KEY secret. Runs uptime, recovery, and chaos tests with PM2.

Add test/smoke-test.js — fast (< 1s) sanity check that verifies:
- All 8 utilities export expected functions
- All 5 agent files exist and are non-empty
- Ecosystem config defines 6 apps with valid scripts

Update package.json: 'npm test' now runs both unit + smoke tests.
Integration tests remain available via 'npm run test:{uptime,chaos,recovery,full}'

Author: shivaram19

.github/workflows/ci.yml

@@ -0,0 +1,95 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  unit-tests:
+    name: Unit Tests + Smoke Checks
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Validate JS syntax
+        run: |
+          echo "Checking all JavaScript files parse correctly..."
+          find src test -name '*.js' -exec node --check {} \;
+          echo "✅ All files parse correctly"
+
+      - name: Validate ecosystem config
+        run: |
+          node -e "
+            const config = require('./ecosystem.config.js');
+            assert(config.apps && config.apps.length > 0, 'No apps defined');
+            assert(config.apps.every(a => a.name && a.script), 'Each app needs name and script');
+            console.log('✅ Valid PM2 config with', config.apps.length, 'apps');
+          "
+
+      - name: Run unit tests
+        run: node test/compressor-test.js
+
+      - name: Run smoke tests
+        env:
+          OPENAI_API_KEY: sk-test-dummy-key-for-ci
+          SCAN_ROOT: /tmp
+        run: node test/smoke-test.js
+
+  integration-tests:
+    name: Integration Tests (optional)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Start agents
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          SCAN_ROOT: /tmp
+        run: |
+          mkdir -p logs .checkpoints .control
+          npx pm2 start ecosystem.config.js
+          sleep 10
+          npx pm2 status
+
+      - name: Run uptime test
+        run: node test/uptime-test.js
+
+      - name: Run recovery test
+        run: node test/recovery-test.js
+
+      - name: Run chaos test
+        run: node test/chaos-test.js
+
+      - name: Upload test reports
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-reports
+          path: test-report-*.json
+
+      - name: Cleanup
+        if: always()
+        run: npx pm2 delete ecosystem.config.js || true

package.json

@@ -9,6 +9,9 @@
     "restart": "pm2 restart ecosystem.config.js",
     "logs": "pm2 logs",
     "monit": "pm2 monit",
+    "test": "node test/compressor-test.js && node test/smoke-test.js",
+    "test:unit": "node test/compressor-test.js",
+    "test:smoke": "node test/smoke-test.js",
     "test:agents": "node test/uptime-test.js",
     "test:agents:long": "TEST_DURATION_MS=300000 node test/uptime-test.js",
     "test:uptime": "node test/uptime-test.js",

test/smoke-test.js

@@ -0,0 +1,128 @@
+/**
+ * Smoke Test — Verifies all modules load without crashing
+ *
+ * This is a fast sanity check (runs in < 1s) that ensures:
+ * 1. All utility modules export valid functions
+ * 2. All agent modules load without immediate errors
+ * 3. The ecosystem config is valid
+ *
+ * Note: This does NOT start agents or make API calls. It only checks
+ * that require() succeeds and exports are as expected.
+ */
+
+const assert = require('assert');
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    fn();
+    passed++;
+    console.log(`  ✅ ${name}`);
+  } catch (err) {
+    failed++;
+    console.error(`  ❌ ${name}: ${err.message}`);
+  }
+}
+
+// ── Utilities ──
+console.log('\n🔧 Utilities');
+
+test('logger exports Logger class', () => {
+  const { Logger } = require('../src/utils/logger');
+  assert(typeof Logger === 'function');
+  const l = new Logger('Test');
+  assert(typeof l.info === 'function');
+  assert(typeof l.error === 'function');
+});
+
+test('checkpoint exports saveCheckpoint and loadCheckpoint', () => {
+  const { saveCheckpoint, loadCheckpoint } = require('../src/utils/checkpoint');
+  assert(typeof saveCheckpoint === 'function');
+  assert(typeof loadCheckpoint === 'function');
+});
+
+test('control exports isPaused', () => {
+  const { isPaused } = require('../src/utils/control');
+  assert(typeof isPaused === 'function');
+});
+
+test('openai-client exports embed, chat, chatStream, buildRagPrompt', () => {
+  const { embed, chat, chatStream, buildRagPrompt } = require('../src/utils/openai-client');
+  assert(typeof embed === 'function');
+  assert(typeof chat === 'function');
+  assert(typeof chatStream === 'function');
+  assert(typeof buildRagPrompt === 'function');
+});
+
+test('content-compressor exports compress and detectContentType', () => {
+  const { compress, detectContentType, ContentType } = require('../src/utils/content-compressor');
+  assert(typeof compress === 'function');
+  assert(typeof detectContentType === 'function');
+  assert(typeof ContentType === 'object');
+});
+
+test('knowledge-db exports getStats, hybridSearch, addConversation', () => {
+  const db = require('../src/utils/knowledge-db');
+  assert(typeof db.getStats === 'function');
+  assert(typeof db.hybridSearch === 'function');
+  assert(typeof db.addConversation === 'function');
+});
+
+test('file-scanner exports walk and extractText', () => {
+  const { walk, walkSync, extractText } = require('../src/utils/file-scanner');
+  assert(typeof walk === 'function');
+  assert(typeof walkSync === 'function');
+  assert(typeof extractText === 'function');
+});
+
+test('search exports search functions', () => {
+  const search = require('../src/utils/search');
+  assert(typeof search === 'object');
+});
+
+// ── Agents (syntax only — verified in CI via node --check) ──
+console.log('\n🤖 Agents');
+
+test('all agent files exist and are non-empty', () => {
+  const fs = require('fs');
+  const agents = [
+    'src/agents/search-agent.js',
+    'src/agents/extractor-agent.js',
+    'src/agents/research-coordinator.js',
+    'src/agents/knowledge-agent.js',
+    'src/agents/doc-synthesizer.js',
+  ];
+  for (const f of agents) {
+    const stat = fs.statSync(f);
+    assert(stat.size > 100, `${f} is suspiciously small (${stat.size} bytes)`);
+  }
+});
+
+// ── Ecosystem Config ──
+console.log('\n⚙️  Ecosystem Config');
+
+test('ecosystem.config.js exports apps array', () => {
+  const config = require('../ecosystem.config.js');
+  assert(Array.isArray(config.apps));
+  assert(config.apps.length === 6, `Expected 6 apps, got ${config.apps.length}`);
+  assert(config.apps.every(a => a.name && a.script), 'Each app needs name and script');
+});
+
+test('all agent scripts exist', () => {
+  const fs = require('fs');
+  const path = require('path');
+  const config = require('../ecosystem.config.js');
+  for (const app of config.apps) {
+    const scriptPath = path.join(process.cwd(), app.script);
+    assert(fs.existsSync(scriptPath), `Missing script: ${app.script}`);
+  }
+});
+
+// ── Summary ──
+console.log('\n═══════════════════════════════════════════════════════════════');
+console.log(`  Results: ${passed} passed, ${failed} failed`);
+console.log('═══════════════════════════════════════════════════════════════\n');
+
+process.exit(failed > 0 ? 1 : 0);