neotoma 0.3.0 → 0.3.2

package/scripts/dev-serve.js

@@ -1,349 +0,0 @@
-#!/usr/bin/env node
-
-import { spawn, execSync } from 'child_process';
-import readline from 'readline';
-import dotenv from 'dotenv';
-import path from 'path';
-import fs from 'fs';
-
-const projectRoot = process.cwd();
-const nodeEnv = process.env.NODE_ENV || 'development';
-
-const envFiles =
-  nodeEnv === 'production'
-    ? [path.join(projectRoot, '.env.production'), path.join(projectRoot, '.env')]
-    : [path.join(projectRoot, '.env')];
-
-envFiles.forEach((file) => {
-  dotenv.config({ path: file });
-});
-
-const bootTimeoutMs = Number(process.env.DEV_SERVE_BOOT_TIMEOUT_MS || 60000);
-const npmCommand = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-const logHistoryLimit = 200;
-const startedAt = Date.now();
-let devServeStatePersisted = false;
-
-const tasks = [
-  {
-    name: 'proxy',
-    description: 'Reverse proxy server',
-    script: null,
-    command: ['node', 'scripts/dev-proxy.js'],
-    readyPattern: /Reverse proxy listening on port/i,
-  },
-  {
-    name: 'actions',
-    description: 'HTTP Actions server',
-    script: 'dev:server',
-    readyPattern: /HTTP Actions listening on/i,
-  },
-  {
-    name: 'ui',
-    description: 'Vite dev server',
-    script: 'dev:ui',
-    readyPattern: /(VITE v|ready in|Local: http)/i,
-  },
-];
-
-const diagnostics = [
-  {
-    test: /listen EADDRINUSE/i,
-    message:
-      'Port already in use. Terminate other dev servers or set NEOTOMA_HTTP_PORT/HTTP_PORT or NEOTOMA_WS_PORT/WS_PORT before running npm run dev:serve.',
-  },
-  {
-    test: /Cannot find module/i,
-    message: 'Dependency missing. Run npm install to restore node_modules.',
-  },
-  {
-    test: /failed to load config from/i,
-    message: 'Vite failed to load its config. Inspect vite.config.ts for syntax problems.',
-  },
-];
-
-const labelWidth = Math.max(...tasks.map((task) => task.name.length));
-const taskState = new Map();
-let bootTimer;
-let shuttingDown = false;
-
-function hasValue(value) {
-  return typeof value === 'string' && value.trim().length > 0;
-}
-
-function getBranchName() {
-  if (hasValue(process.env.BRANCH_NAME)) {
-    return process.env.BRANCH_NAME;
-  }
-  try {
-    const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
-    return branch || 'main';
-  } catch {
-    return 'main';
-  }
-}
-
-const branchName = getBranchName();
-const devServeStateDir = path.join(projectRoot, '.dev-serve');
-const devServeStateFile = branchName ? path.join(devServeStateDir, `${branchName}.json`) : null;
-
-function readAssignedPorts() {
-  const readPort = (neotoma, legacy) => {
-    const raw = process.env[neotoma] || process.env[legacy];
-    const value = Number(raw);
-    return Number.isFinite(value) ? value : null;
-  };
-  return {
-    http: readPort('NEOTOMA_HTTP_PORT', 'HTTP_PORT'),
-    vite: readPort('VITE_PORT', 'VITE_PORT'),
-    ws: readPort('NEOTOMA_WS_PORT', 'WS_PORT'),
-  };
-}
-
-const assignedPorts = readAssignedPorts();
-
-function ensureDirExists(dir) {
-  if (!dir) {
-    return;
-  }
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-}
-
-function persistDevServeState() {
-  if (!devServeStateFile || !assignedPorts) {
-    return;
-  }
-  ensureDirExists(devServeStateDir);
-  const payload = {
-    branch: branchName,
-    pid: process.pid,
-    startedAt,
-    ports: assignedPorts,
-  };
-  try {
-    fs.writeFileSync(devServeStateFile, JSON.stringify(payload, null, 2));
-    devServeStatePersisted = true;
-  } catch (error) {
-    console.warn(`[dev-serve] Failed to persist state file ${devServeStateFile}: ${error.message}`);
-  }
-}
-
-function clearDevServeState() {
-  if (devServeStatePersisted && devServeStateFile) {
-    try {
-      fs.rmSync(devServeStateFile, { force: true });
-    } catch {
-      // ignore
-    }
-    devServeStatePersisted = false;
-  }
-}
-
-function ensureBaseEnv() {
-  // Local-only: no remote credentials required
-}
-
-function formatPrefix(name, stream) {
-  const padded = name.padEnd(labelWidth);
-  const suffix = stream === 'stderr' ? '!' : ' ';
-  return `[${padded}${suffix}]`;
-}
-
-function recordLog(state, line, stream) {
-  state.logs.push({ line, stream });
-  if (state.logs.length > logHistoryLimit) {
-    state.logs.shift();
-  }
-}
-
-function printDiagnostics(state) {
-  if (!state || state.logs.length === 0) {
-    return;
-  }
-  const joined = state.logs.map((entry) => entry.line).join('\n');
-  const match = diagnostics.find((diag) => diag.test.test(joined));
-  if (match) {
-    console.error(`[dev-serve] Diagnostic hint (${state.task.description}): ${match.message}`);
-    return;
-  }
-  const excerpt = state.logs.slice(-8).map((entry) => `  ${entry.stream === 'stderr' ? '!' : '-'} ${entry.line}`).join('\n');
-  if (excerpt) {
-    console.error(`[dev-serve] Recent ${state.task.description} log lines:\n${excerpt}`);
-  }
-}
-
-function sanitizeBranchForHost(branchName) {
-  // Convert branch name to hostname-safe format (e.g., "feature/test" -> "feature-test")
-  return branchName.replace(/\//g, '-').replace(/[^a-z0-9-]/gi, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
-}
-
-function checkAllReady() {
-  if ([...taskState.values()].every((state) => state.ready)) {
-    if (bootTimer) {
-      clearTimeout(bootTimer);
-    }
-    const proxyHttpPort = parseInt(process.env.PROXY_HTTP_PORT || process.env.PROXY_PORT || '80', 10);
-    const proxyHttpsPort = parseInt(process.env.PROXY_HTTPS_PORT || '443', 10);
-    const sanitizedBranch = sanitizeBranchForHost(branchName);
-    const httpPortSuffix = proxyHttpPort === 80 ? '' : `:${proxyHttpPort}`;
-    const httpsPortSuffix = proxyHttpsPort === 443 ? '' : `:${proxyHttpsPort}`;
-    const httpUrl = `http://${sanitizedBranch}.dev${httpPortSuffix}`;
-    const httpsUrl = `https://${sanitizedBranch}.dev${httpsPortSuffix}`;
-    
-    console.log('[dev-serve] All dev services are ready. Press Ctrl+C to stop.');
-    console.log(`[dev-serve] UI available at: ${httpsUrl} (HTTPS) or ${httpUrl} (HTTP)`);
-    if (assignedPorts.http) {
-      console.log(`[dev-serve] API available at: ${httpsUrl}/api (HTTPS) or ${httpUrl}/api (HTTP)`);
-    }
-  }
-}
-
-function handleLine(state, line, stream) {
-  recordLog(state, line, stream);
-  const prefix = formatPrefix(state.task.name, stream);
-  const output = `${prefix} ${line}`;
-  if (stream === 'stderr') {
-    console.error(output);
-  } else {
-    console.log(output);
-  }
-  if (!state.ready && state.task.readyPattern?.test(line)) {
-    state.ready = true;
-    console.log(`[dev-serve] ${state.task.description} reported ready.`);
-    checkAllReady();
-  }
-}
-
-function attachStream(state, stream, streamName) {
-  const rl = readline.createInterface({ input: stream });
-  rl.on('line', (line) => handleLine(state, line, streamName));
-  stream.on('error', (error) => {
-    if (!shuttingDown) {
-      console.error(`[dev-serve] Stream error for ${state.task.description}: ${error.message}`);
-    }
-  });
-}
-
-function terminateChild(child, signal = 'SIGTERM') {
-  if (!child || child.killed || child.exitCode !== null) {
-    return;
-  }
-  try {
-    child.kill(signal);
-  } catch {
-    // ignore
-  }
-}
-
-function shutdown(code = 0) {
-  if (shuttingDown) {
-    return;
-  }
-  shuttingDown = true;
-  if (bootTimer) {
-    clearTimeout(bootTimer);
-  }
-  clearDevServeState();
-  for (const state of taskState.values()) {
-    terminateChild(state.child, 'SIGTERM');
-  }
-  setTimeout(() => {
-    for (const state of taskState.values()) {
-      terminateChild(state.child, 'SIGKILL');
-    }
-    process.exit(code);
-  }, 500);
-}
-
-function spawnTask(task) {
-  let child;
-  if (task.command) {
-    // For direct commands (like proxy)
-    child = spawn(task.command[0], task.command.slice(1), {
-      stdio: ['inherit', 'pipe', 'pipe'],
-      env: { ...process.env },
-    });
-  } else {
-    // For npm scripts
-    child = spawn(npmCommand, ['run', task.script], {
-      stdio: ['inherit', 'pipe', 'pipe'],
-      env: { ...process.env },
-    });
-  }
-
-  const state = {
-    task,
-    child,
-    ready: false,
-    logs: [],
-  };
-
-  taskState.set(task.name, state);
-
-  attachStream(state, child.stdout, 'stdout');
-  attachStream(state, child.stderr, 'stderr');
-
-  child.on('exit', (code, signal) => {
-    if (shuttingDown) {
-      return;
-    }
-    const stage = state.ready ? 'runtime' : 'boot';
-    const reason = typeof code === 'number' ? `code ${code}` : `signal ${signal || 'unknown'}`;
-    console.error(`[dev-serve] ${state.task.description} exited during ${stage} with ${reason}.`);
-    printDiagnostics(state);
-    shutdown(typeof code === 'number' ? code : 1);
-  });
-
-  child.on('error', (error) => {
-    if (shuttingDown) {
-      return;
-    }
-    console.error(`[dev-serve] Failed to start ${state.task.description}: ${error.message}`);
-    recordLog(state, error.stack || error.message, 'stderr');
-    printDiagnostics(state);
-    shutdown(1);
-  });
-}
-
-function scheduleBootWatchdog() {
-  if (bootTimeoutMs <= 0) {
-    return;
-  }
-  bootTimer = setTimeout(() => {
-    for (const state of taskState.values()) {
-      if (!state.ready) {
-        console.error(
-          `[dev-serve] ${state.task.description} has not reported ready after ${Math.round(bootTimeoutMs / 1000)}s.`,
-        );
-        printDiagnostics(state);
-      }
-    }
-  }, bootTimeoutMs);
-}
-
-ensureBaseEnv();
-
-console.log('[dev-serve] Starting full dev stack (HTTP + UI) with diagnostics.');
-persistDevServeState();
-
-tasks.forEach((task) => spawnTask(task));
-scheduleBootWatchdog();
-
-['SIGINT', 'SIGTERM', 'SIGQUIT'].forEach((signal) => {
-  process.on(signal, () => shutdown(0));
-});
-
-process.on('exit', clearDevServeState);
-process.on('uncaughtException', (error) => {
-  console.error('[dev-serve] Uncaught exception:', error);
-  shutdown(1);
-});
-
-process.on('unhandledRejection', (reason) => {
-  console.error('[dev-serve] Unhandled promise rejection:', reason);
-  shutdown(1);
-});
-
-

package/scripts/disable-dns.sh

@@ -1,47 +0,0 @@
-#!/bin/bash
-# Disable DNS setup for *.dev domains
-# Run this script to remove the local DNS configuration
-
-set -e
-
-echo "Disabling DNS for *.dev domains..."
-
-# Stop dnsmasq service (requires sudo)
-if brew services list | grep -q "dnsmasq.*started"; then
-    echo "Stopping dnsmasq service (requires sudo)..."
-    sudo brew services stop dnsmasq
-    echo "✓ dnsmasq service stopped"
-else
-    echo "✓ dnsmasq service is not running"
-fi
-
-# Remove macOS resolver configuration (requires sudo)
-if [ -f /etc/resolver/dev ]; then
-    echo "Removing macOS resolver configuration (requires sudo)..."
-    sudo rm /etc/resolver/dev
-    echo "✓ macOS resolver configuration removed"
-else
-    echo "✓ macOS resolver configuration does not exist"
-fi
-
-# Optionally remove dnsmasq config file (optional - can keep for future use)
-if [ -f /opt/homebrew/etc/dnsmasq.d/dev.conf ]; then
-    read -p "Remove dnsmasq config file? (y/N): " -n 1 -r
-    echo
-    if [[ $REPLY =~ ^[Yy]$ ]]; then
-        rm /opt/homebrew/etc/dnsmasq.d/dev.conf
-        echo "✓ dnsmasq configuration file removed"
-    else
-        echo "✓ dnsmasq configuration file kept (can re-enable later)"
-    fi
-else
-    echo "✓ dnsmasq configuration file does not exist"
-fi
-
-echo ""
-echo "DNS setup disabled! *.dev domains will no longer resolve to 127.0.0.1"
-echo ""
-echo "To verify, run: ping -c 1 test.dev"
-echo "It should fail or resolve to a different address (not 127.0.0.1)"
-echo ""
-echo "To re-enable, run: ./scripts/setup-dns.sh"

package/scripts/doctor.ts

@@ -1,97 +0,0 @@
-#!/usr/bin/env node
-/**
- * Neotoma health check: environment, security, and optional backend checks.
- * Run with: npm run doctor
- * See: docs/operations/health_check.md
- */
-
-import { config } from "dotenv";
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
-import { execSync } from "node:child_process";
-
-const ROOT = resolve(process.cwd());
-const ENV_PATH = resolve(ROOT, ".env");
-
-if (existsSync(ENV_PATH)) {
-  config({ path: ENV_PATH });
-}
-
-type Status = "ok" | "fail" | "warn";
-
-function run(): void {
-  console.log("\n🔍 Neotoma Health Check\n");
-
-  const results: { name: string; status: Status; message: string }[] = [];
-
-  // Environment: .env exists
-  const envExists = existsSync(ENV_PATH);
-  results.push({
-    name: "Environment",
-    status: envExists ? "ok" : "warn",
-    message: envExists ? "Config present (.env)" : ".env not found (optional for local defaults)",
-  });
-
-  const backend = "local";
-  results.push({
-    name: "Storage backend",
-    status: "ok",
-    message: `Backend: ${backend}`,
-  });
-
-  // Security: .env should be gitignored
-  let gitIgnored = false;
-  try {
-    execSync("git check-ignore -v .env", { cwd: ROOT, encoding: "utf8" });
-    gitIgnored = true;
-  } catch {
-    // check-ignore exits 1 if file is not ignored
-  }
-  results.push({
-    name: "Security",
-    status: gitIgnored || !envExists ? "ok" : "warn",
-    message: envExists
-      ? gitIgnored
-        ? ".env is gitignored"
-        : ".env is not gitignored (do not commit it)"
-      : "N/A (no .env)",
-  });
-
-  // Database / Tables / RLS / Migrations / MCP: placeholder for full implementation
-  results.push({
-    name: "Database",
-    status: "warn",
-    message: "Run migrations and check:advisors for full verification",
-  });
-  results.push({
-    name: "MCP",
-    status: "warn",
-    message: "Run 'npm run dev' to verify server starts",
-  });
-
-  // Print
-  const symbols: Record<Status, string> = {
-    ok: "✅",
-    fail: "❌",
-    warn: "⚠️ ",
-  };
-  for (const r of results) {
-    console.log(`${symbols[r.status]} ${r.name}: ${r.message}`);
-  }
-
-  const failed = results.filter((r) => r.status === "fail");
-  const warnings = results.filter((r) => r.status === "warn");
-  console.log("");
-  if (failed.length > 0) {
-    console.log(`Overall: ❌ UNHEALTHY (${failed.length} failure(s))`);
-    process.exit(1);
-  }
-  if (warnings.length > 0) {
-    console.log(`Overall: ✅ HEALTHY (${warnings.length} warning(s))`);
-  } else {
-    console.log("Overall: ✅ HEALTHY");
-  }
-  console.log("");
-}
-
-run();