@aifabrix/builder 2.52.1 → 2.53.0

package/scripts/pnpm/help.mjs

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-const showAll = process.argv.includes('--all');
-
-const publicSections = [
-  {
-    title: 'Start here (80/20)',
-    lines: [
-      'aifabrix setup     → once (any directory)',
-      'dev-install        → after clone (npm install + install:local)',
-      'dev-reload         → daily (Docker live reload)',
-      'check-quiet        → before commit (build:ci → .temp/validation/)',
-      'Full guide: QUICK-START.md'
-    ]
-  },
-  {
-    title: 'Sometimes',
-    lines: [
-      'dev                → builder-api on host (aifabrix resolve builder-api first)',
-      'ui-build           → N/A (no UI in this repo)',
-      'check              → lint + test (fast, not full CI)',
-      'pnpm run af ba-logs | ba-down'
-    ]
-  }
-];
-
-const advancedLines = [
-  '--- Advanced (help -- --all) ---',
-  'dev-build / dev-promote (tags main + version) / af ba-*',
-  'build:ci           → lint + schema-sync + flags + test:ci (same as GitHub)',
-  'sync-json          → publish builder/builder-api → templates/',
-  'test:154           → builder-api scoped Jest + arch grep',
-  'test:manual        → live API tests (aifabrix login first)',
-  'test:integration   → integration fixtures (TEST_LANGUAGE=python|typescript optional)',
-  'test:hubspot-wizard [-- --type negative|positive]',
-  'docker-image-gate-builder-api',
-  'builder-api:build | builder-api:nest | builder-api:cleanup',
-  'install:global / uninstall:global / diagnose:cli',
-  'Docs: docs/development/pnpm-commands.md'
-];
-
-console.log('AI Fabrix Builder — pnpm commands\n');
-for (const section of publicSections) {
-  console.log(section.title);
-  for (const line of section.lines) {
-    console.log(`  ${line}`);
-  }
-  console.log('');
-}
-if (!showAll) {
-  console.log('Run: pnpm run help -- --all');
-  process.exit(0);
-}
-for (const line of advancedLines) {
-  console.log(line);
-}

package/scripts/pnpm/lib/dev-reload-core.mjs

@@ -1,189 +0,0 @@
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { resolveAifabrixBin } from './resolve-aifabrix-bin.mjs';
-import { resolveAppUrl } from './resolve-app-url.mjs';
-import { createSpinner } from './spinner.mjs';
-
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
-const LOG_FILE = 'dev-reload.log';
-const CAPTURE_PID_FILE = 'dev-reload-capture.pid';
-
-/**
- * @typedef {Object} DevReloadProfile
- * @property {string} appKey
- * @property {string} displayName
- * @property {number} portBase
- * @property {string} [webServerUrlEnvKey]
- * @property {string} [healthPath]
- * @property {boolean} [apiOnly]
- * @property {string} [uiBuildCommand]
- * @property {string} [uiOutputDir]
- */
-
-/**
- * @param {DevReloadProfile} profile
- * @returns {Promise<void>}
- */
-export async function runDevReload(profile) {
-  const logPath = prepareLogFile();
-  appendSessionBanner(profile.appKey, logPath);
-
-  const aifabrix = resolveAifabrixBin();
-  const spinner = createSpinner(`Starting ${profile.displayName} (live reload)…`);
-  spinner.start();
-
-  await runToLogFile(aifabrix, ['resolve', profile.appKey], logPath);
-  const runExit = await runToLogFile(aifabrix, ['run', profile.appKey, '--reload'], logPath);
-  if (runExit !== 0) {
-    spinner.stop();
-    printRunFailure(logPath);
-    process.exit(runExit);
-  }
-  spinner.stop();
-
-  startBackgroundLogCapture(profile.appKey, logPath);
-  printDevReloadSummary(profile, logPath);
-}
-
-/**
- * @returns {string}
- */
-function prepareLogFile() {
-  const logDir = path.join(repoRoot, '.temp');
-  fs.mkdirSync(logDir, { recursive: true });
-  const logPath = path.join(logDir, LOG_FILE);
-  fs.writeFileSync(logPath, '');
-  return logPath;
-}
-
-/**
- * @returns {string}
- */
-function capturePidPath() {
-  return path.join(repoRoot, '.temp', CAPTURE_PID_FILE);
-}
-
-function stopPreviousCapture() {
-  const pidPath = capturePidPath();
-  if (!fs.existsSync(pidPath)) {
-    return;
-  }
-  const pid = Number.parseInt(fs.readFileSync(pidPath, 'utf8').trim(), 10);
-  if (!pid) {
-    return;
-  }
-  try {
-    process.kill(pid, 'SIGTERM');
-  } catch {
-    // already stopped
-  }
-}
-
-/**
- * @param {string} appKey
- * @param {string} logPath
- */
-function startBackgroundLogCapture(appKey, logPath) {
-  stopPreviousCapture();
-
-  const captureScript = path.join(
-    path.dirname(fileURLToPath(import.meta.url)),
-    'dev-reload-log-capture.mjs'
-  );
-  const child = spawn(process.execPath, [captureScript, appKey, logPath], {
-    cwd: repoRoot,
-    env: process.env,
-    detached: true,
-    stdio: 'ignore'
-  });
-  child.unref();
-  fs.writeFileSync(capturePidPath(), String(child.pid));
-}
-
-/**
- * @param {DevReloadProfile} profile
- * @param {string} logPath
- */
-function printDevReloadSummary(profile, logPath) {
-  const appUrl = resolveAppUrl(profile, { repoRoot }).replace(/\/+$/, '');
-  const absLog = path.resolve(logPath);
-  const healthUrl = profile.healthPath ? `${appUrl}${profile.healthPath}` : `${appUrl}/`;
-
-  console.log('');
-  console.log('═'.repeat(60));
-  console.log(`  ${profile.displayName} — live reload (Docker)`);
-  console.log('═'.repeat(60));
-  console.log('');
-  console.log(`  App URL:  ${appUrl}/`);
-  if (profile.healthPath) {
-    console.log(`  Health:   ${healthUrl}`);
-  }
-  console.log(`  Logs:     ${absLog}`);
-  console.log('');
-  console.log('  Backend code on mounted paths reloads automatically.');
-  if (!profile.apiOnly && profile.uiBuildCommand && profile.uiOutputDir) {
-    console.log('');
-    console.log('  UI changes: run');
-    console.log(`    ${profile.uiBuildCommand}`);
-    console.log(`    → ${profile.uiOutputDir}`);
-  }
-  console.log('');
-  console.log('  Log capture runs in the background (this command exits).');
-  console.log('═'.repeat(60));
-  console.log('');
-}
-
-/**
- * @param {string} logPath
- */
-function printRunFailure(logPath) {
-  console.error(`\n[dev-reload] Start failed. Logs: ${path.resolve(logPath)}\n`);
-  if (!fs.existsSync(logPath)) {
-    return;
-  }
-  const lines = fs.readFileSync(logPath, 'utf8').trim().split('\n').filter(Boolean);
-  const tail = lines.slice(-15).join('\n');
-  if (tail) {
-    console.error(tail);
-    console.error('');
-  }
-}
-
-/**
- * @param {string} appKey
- * @param {string} logPath
- */
-function appendSessionBanner(appKey, logPath) {
-  const banner =
-    `\n${'='.repeat(72)}\n` +
-    `[${new Date().toISOString()}] dev-reload session: ${appKey}\n` +
-    `${'='.repeat(72)}\n`;
-  fs.appendFileSync(logPath, banner);
-}
-
-/**
- * @param {string} command
- * @param {string[]} args
- * @param {string} logPath
- * @returns {Promise<number>}
- */
-function runToLogFile(command, args, logPath) {
-  return new Promise((resolve) => {
-    const proc = spawn(command, args, {
-      cwd: repoRoot,
-      env: process.env,
-      stdio: ['ignore', 'pipe', 'pipe']
-    });
-
-    const append = (chunk) => {
-      fs.appendFileSync(logPath, chunk);
-    };
-
-    proc.stdout.on('data', append);
-    proc.stderr.on('data', append);
-    proc.on('close', (code) => resolve(typeof code === 'number' ? code : 1));
-    proc.on('error', () => resolve(1));
-  });
-}

package/scripts/pnpm/lib/dev-reload-log-capture.mjs

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-/**
- * Background log capture for dev-reload (detached child).
- * Usage: node dev-reload-log-capture.mjs <appKey> <logPath>
- */
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import readline from 'node:readline';
-import { fileURLToPath } from 'node:url';
-import { resolveAifabrixBin } from './resolve-aifabrix-bin.mjs';
-import { resolveLogKeys } from './dev-reload-log-utils.mjs';
-
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
-const appKey = process.argv[2];
-const logPath = process.argv[3];
-
-if (!appKey || !logPath) {
-  console.error('Usage: node dev-reload-log-capture.mjs <appKey> <logPath>');
-  process.exit(2);
-}
-
-const aifabrix = resolveAifabrixBin();
-const logKeys = resolveLogKeys(repoRoot, appKey);
-
-await Promise.all(
-  logKeys.map((key) => followAppLogsToFile(aifabrix, key, logPath, key === appKey))
-);
-
-/**
- * @param {string} aifabrix
- * @param {string} key
- * @param {string} filePath
- * @param {boolean} required
- */
-function followAppLogsToFile(aifabrix, key, filePath, required) {
-  return new Promise((resolve, reject) => {
-    const proc = spawn(aifabrix, ['logs', key, '-f', '--tail', '100'], {
-      cwd: repoRoot,
-      env: process.env,
-      stdio: ['ignore', 'pipe', 'pipe']
-    });
-
-    const prefix = `[${key}] `;
-    const onLine = (line) => {
-      fs.appendFileSync(filePath, `${new Date().toISOString()} ${prefix}${line}\n`);
-    };
-
-    readline.createInterface({ input: proc.stdout }).on('line', onLine);
-    readline.createInterface({ input: proc.stderr }).on('line', onLine);
-
-    proc.on('close', (code) => {
-      if (code !== 0 && required) {
-        reject(new Error(`Log capture ended for ${key} (exit ${code ?? 1})`));
-        return;
-      }
-      resolve();
-    });
-    proc.on('error', (err) => {
-      if (required) {
-        reject(err);
-        return;
-      }
-      resolve();
-    });
-  });
-}

package/scripts/pnpm/lib/dev-reload-log-utils.mjs

@@ -1,32 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-/**
- * @param {string} repoRoot
- * @param {string} appKey
- * @returns {string[]}
- */
-export function resolveLogKeys(repoRoot, appKey) {
-  return [appKey, ...readCompanionKeys(repoRoot, appKey)];
-}
-
-/**
- * @param {string} repoRoot
- * @param {string} appKey
- * @returns {string[]}
- */
-function readCompanionKeys(repoRoot, appKey) {
-  const yamlPath = path.join(repoRoot, 'builder', appKey, 'application.yaml');
-  if (!fs.existsSync(yamlPath)) {
-    return [];
-  }
-  const text = fs.readFileSync(yamlPath, 'utf8');
-  if (!/^\s*worker:\s*true\s*$/m.test(text)) {
-    return [];
-  }
-  const companions = [`${appKey}-worker`];
-  if (/^\s*imageRunBeat:/m.test(text)) {
-    companions.push(`${appKey}-beat`);
-  }
-  return companions;
-}

package/scripts/pnpm/lib/resolve-aifabrix-bin.mjs

@@ -1,124 +0,0 @@
-import { execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
-
-/** application.yaml / platform apps need manifest-aware builder (not variables.yaml-only CLIs). */
-const MIN_AIFABRIX_VERSION = '2.45.0';
-
-/**
- * @param {string} version - Semver string.
- * @returns {number[]} Parsed numeric semver segments.
- */
-function parseSemver(version) {
-  return String(version)
-    .trim()
-    .split('.')
-    .map((part) => parseInt(part, 10) || 0);
-}
-
-/**
- * @param {string} left - Left semver.
- * @param {string} right - Right semver.
- * @returns {number} Compare result (1, 0, -1).
- */
-function compareSemver(left, right) {
-  const a = parseSemver(left);
-  const b = parseSemver(right);
-  for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
-    const av = a[i] || 0;
-    const bv = b[i] || 0;
-    if (av > bv) return 1;
-    if (av < bv) return -1;
-  }
-  return 0;
-}
-
-/**
- * @param {string} bin - Candidate executable path.
- * @returns {string|null} CLI version output or null.
- */
-function readAifabrixVersion(bin) {
-  try {
-    return execFileSync(bin, ['--version'], { encoding: 'utf8' }).trim();
-  } catch {
-    return null;
-  }
-}
-
-/**
- * @returns {string[]} Candidate aifabrix binary paths.
- */
-function collectAifabrixCandidates() {
-  const candidates = [];
-  const seen = new Set();
-
-  const push = (candidate) => {
-    if (!candidate || seen.has(candidate)) {
-      return;
-    }
-    seen.add(candidate);
-    candidates.push(candidate);
-  };
-
-  push(path.join(repoRoot, 'bin', 'aifabrix.js'));
-
-  if (process.env.AIFABRIX_CLI) {
-    push(process.env.AIFABRIX_CLI);
-  }
-
-  const home = os.homedir();
-  push(path.join(home, '.npm-global', 'bin', 'aifabrix'));
-  push(path.join(home, '.local', 'bin', 'aifabrix'));
-
-  for (const dir of (process.env.PATH || '').split(path.delimiter)) {
-    if (!dir) continue;
-    push(path.join(dir, 'aifabrix'));
-  }
-
-  return candidates;
-}
-
-/**
- * Prefer this repo's bin/aifabrix.js when developing the builder package locally.
- *
- * @returns {string} Resolved aifabrix executable path.
- */
-export function resolveAifabrixBin() {
-  let bestBin = null;
-  let bestVersion = null;
-
-  for (const candidate of collectAifabrixCandidates()) {
-    let resolved;
-    try {
-      if (fs.existsSync(candidate)) {
-        resolved = fs.realpathSync(candidate);
-      } else {
-        continue;
-      }
-    } catch {
-      continue;
-    }
-
-    const version = readAifabrixVersion(resolved);
-    if (!version) {
-      continue;
-    }
-    if (!bestVersion || compareSemver(version, bestVersion) > 0) {
-      bestBin = resolved;
-      bestVersion = version;
-    }
-  }
-
-  if (!bestBin || !bestVersion || compareSemver(bestVersion, MIN_AIFABRIX_VERSION) < 0) {
-    throw new Error(
-      `@aifabrix/builder >= ${MIN_AIFABRIX_VERSION} is required (found ${bestVersion || 'none'}). ` +
-        'Install: npm run install:local — or set AIFABRIX_CLI to a newer aifabrix binary.'
-    );
-  }
-
-  return bestBin;
-}

package/scripts/pnpm/lib/resolve-app-url.mjs

@@ -1,183 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-
-/**
- * @typedef {Object} AppUrlProfile
- * @property {string} appKey
- * @property {number} portBase
- * @property {string} [webServerUrlEnvKey]
- * @property {string} [healthPath]
- */
-
-/**
- * @returns {string}
- */
-function readDeveloperIdRaw() {
-  const configPath = path.join(os.homedir(), '.aifabrix', 'config.yaml');
-  if (!fs.existsSync(configPath)) {
-    return '0';
-  }
-  const match = fs.readFileSync(configPath, 'utf8').match(/^developer-id:\s*['"]?(\d+)['"]?\s*$/m);
-  return match ? match[1] : '0';
-}
-
-/**
- * @param {string} appKey
- * @param {string} developerIdRaw
- * @returns {string}
- */
-function buildContainerName(appKey, developerIdRaw) {
-  const idNum = Number.parseInt(developerIdRaw, 10) || 0;
-  if (idNum === 0) {
-    return `aifabrix-${appKey}`;
-  }
-  return `aifabrix-dev${developerIdRaw}-${appKey}`;
-}
-
-/**
- * @param {string} filePath
- * @returns {Record<string, string>}
- */
-function parseEnvFile(filePath) {
-  const values = {};
-  for (const line of fs.readFileSync(filePath, 'utf8').split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) {
-      continue;
-    }
-    const eq = trimmed.indexOf('=');
-    if (eq === -1) {
-      continue;
-    }
-    const key = trimmed.slice(0, eq).trim();
-    let value = trimmed.slice(eq + 1).trim();
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1);
-    }
-    values[key] = value;
-  }
-  return values;
-}
-
-/**
- * @param {string} raw
- * @returns {string|null}
- */
-function normalizeHttpUrl(raw) {
-  const trimmed = raw?.trim();
-  if (!trimmed || trimmed.startsWith('kv://')) {
-    return null;
-  }
-  try {
-    const parsed = new URL(trimmed);
-    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
-      return null;
-    }
-    return parsed.toString().replace(/\/+$/, '');
-  } catch {
-    return null;
-  }
-}
-
-/**
- * @param {string} repoRoot
- * @param {string} appKey
- * @param {string} envKey
- * @returns {string|null}
- */
-function readBuilderEnvUrl(repoRoot, appKey, envKey) {
-  const envPath = path.join(repoRoot, 'builder', appKey, '.env');
-  if (!fs.existsSync(envPath)) {
-    return null;
-  }
-  return normalizeHttpUrl(parseEnvFile(envPath)[envKey]);
-}
-
-/**
- * @param {string} containerName
- * @param {string} envKey
- * @returns {string|null}
- */
-function readContainerEnvUrl(containerName, envKey) {
-  const result = spawnSync('docker', ['exec', containerName, 'env'], {
-    encoding: 'utf8',
-    timeout: 8000
-  });
-  if (result.status !== 0) {
-    return null;
-  }
-  for (const line of result.stdout.split('\n')) {
-    if (!line.startsWith(`${envKey}=`)) {
-      continue;
-    }
-    return normalizeHttpUrl(line.slice(envKey.length + 1));
-  }
-  return null;
-}
-
-/**
- * @param {string} containerName
- * @returns {string|null}
- */
-function readDockerPublishedUrl(containerName) {
-  const result = spawnSync(
-    'docker',
-    ['ps', '--filter', `name=^/${containerName}$`, '--format', '{{.Ports}}'],
-    { encoding: 'utf8', timeout: 8000 }
-  );
-  if (result.status !== 0) {
-    return null;
-  }
-  const portMatch = result.stdout.match(/:(\d+)->\d+\//);
-  if (!portMatch) {
-    return null;
-  }
-  return `http://localhost:${portMatch[1]}`;
-}
-
-/**
- * @param {number} portBase
- * @returns {number}
- */
-function resolveHostPort(portBase) {
-  const devId = Number.parseInt(readDeveloperIdRaw(), 10) || 0;
-  return devId === 0 ? portBase : portBase + devId * 100;
-}
-
-/**
- * @param {AppUrlProfile} profile
- * @param {{ repoRoot: string }} options
- * @returns {string}
- */
-export function resolveAppUrl(profile, options) {
-  const { repoRoot } = options;
-  const envKey = profile.webServerUrlEnvKey;
-  const containerName = buildContainerName(profile.appKey, readDeveloperIdRaw());
-
-  if (envKey) {
-    const fromContainer = readContainerEnvUrl(containerName, envKey);
-    if (fromContainer) {
-      return `${fromContainer}/`;
-    }
-  }
-
-  const fromDockerPort = readDockerPublishedUrl(containerName);
-  if (fromDockerPort) {
-    return `${fromDockerPort}/`;
-  }
-
-  if (envKey) {
-    const fromBuilderEnv = readBuilderEnvUrl(repoRoot, profile.appKey, envKey);
-    if (fromBuilderEnv) {
-      return `${fromBuilderEnv}/`;
-    }
-  }
-
-  const port = resolveHostPort(profile.portBase);
-  return `http://localhost:${port}/`;
-}

package/scripts/pnpm/lib/spinner.mjs

@@ -1,42 +0,0 @@
-/** Minimal TTY spinner (no extra dependencies). */
-
-const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-
-/**
- * @param {string} label
- * @returns {{ start: () => void, stop: (finalLine?: string) => void }}
- */
-export function createSpinner(label) {
-  let frameIndex = 0;
-  /** @type {NodeJS.Timeout | null} */
-  let timer = null;
-  const enabled = process.stdout.isTTY && process.env.CI !== 'true';
-
-  function clearLine() {
-    if (enabled) {
-      process.stdout.write('\r\x1b[K');
-    }
-  }
-
-  return {
-    start() {
-      if (!enabled) {
-        console.log(label);
-        return;
-      }
-      timer = setInterval(() => {
-        process.stdout.write(`\r${FRAMES[frameIndex++ % FRAMES.length]} ${label}`);
-      }, 80);
-    },
-    stop(finalLine) {
-      if (timer) {
-        clearInterval(timer);
-        timer = null;
-      }
-      clearLine();
-      if (finalLine) {
-        console.log(finalLine);
-      }
-    }
-  };
-}