voidforge-build 23.11.0 → 23.11.2

package/dist/wizard/lib/natural-language-deploy.js

@@ -1,186 +0,0 @@
-/**
- * Natural Language Deploy — resolve prose deployment descriptions to YAML frontmatter.
- *
- * Parse: "I want a $20/month server with SSL and daily backups"
- * → { deploy: 'vps', instanceType: 't3.small', hostname: '', resilience: { backups: 'daily', ... } }
- *
- * Uses keyword matching and heuristics — no AI API call required.
- */
-const BUDGET_TIERS = [
-    { maxMonthly: 10, instanceType: 't3.micro', label: '~$8/mo' },
-    { maxMonthly: 25, instanceType: 't3.small', label: '~$17/mo' },
-    { maxMonthly: 50, instanceType: 't3.medium', label: '~$34/mo' },
-    { maxMonthly: 100, instanceType: 't3.large', label: '~$68/mo' },
-    { maxMonthly: Infinity, instanceType: 't3.xlarge', label: '~$136/mo' },
-];
-function resolveInstanceFromBudget(budget) {
-    return BUDGET_TIERS.find(t => budget <= t.maxMonthly) ?? BUDGET_TIERS[BUDGET_TIERS.length - 1];
-}
-// ── Keyword patterns ────────────────────────────
-const PLATFORM_KEYWORDS = [
-    { pattern: /\bvercel\b/i, target: 'vercel', reason: 'Vercel mentioned explicitly' },
-    { pattern: /\brailway\b/i, target: 'railway', reason: 'Railway mentioned explicitly' },
-    { pattern: /\bcloudflare\b/i, target: 'cloudflare', reason: 'Cloudflare mentioned explicitly' },
-    { pattern: /\bdocker\b|\bcontainer\b/i, target: 'docker', reason: 'Docker/container mentioned' },
-    { pattern: /\bstatic\s*(?:site|hosting|files?)\b/i, target: 'static', reason: 'Static site hosting' },
-    { pattern: /\bvps\b|\bserver\b|\bec2\b|\baws\b|\bssh\b/i, target: 'vps', reason: 'Server/VPS/AWS mentioned' },
-    { pattern: /\bserverless\b|\bedge\b/i, target: 'vercel', reason: 'Serverless/edge → Vercel' },
-    { pattern: /\bfree\s*tier\b|\bno\s*cost\b|\bfree\b/i, target: 'railway', reason: 'Free tier → Railway' },
-];
-const FEATURE_KEYWORDS = [
-    { pattern: /\bbackup/i, key: 'backups', reason: 'Backups requested' },
-    { pattern: /\bssl\b|\bhttps\b|\btls\b/i, key: 'ssl', reason: 'SSL/TLS requested' },
-    { pattern: /\bcustom\s*domain\b|\bmy\s*domain\b/i, key: 'customDomain', reason: 'Custom domain' },
-    { pattern: /\brollback\b|\brevert\b/i, key: 'rollback', reason: 'Rollback requested' },
-    { pattern: /\bpreview\b|\bpr\s*deploy/i, key: 'previewDeploys', reason: 'Preview deploys' },
-    { pattern: /\bhealth\s*check\b|\bmonitoring\b|\buptime\b/i, key: 'healthCheck', reason: 'Health monitoring' },
-    { pattern: /\brate\s*limit/i, key: 'rateLimiting', reason: 'Rate limiting' },
-    { pattern: /\bgraceful\b|\bzero\s*downtime\b/i, key: 'gracefulShutdown', reason: 'Zero-downtime' },
-    { pattern: /\bmulti\s*(?:env|environment)\b|\bstaging\b/i, key: 'multiEnv', reason: 'Multi-environment' },
-    { pattern: /\berror\s*boundar/i, key: 'errorBoundaries', reason: 'Error boundaries' },
-    { pattern: /\bdead\s*letter\b|\bdlq\b|\bretry\s*queue\b/i, key: 'deadLetterQueue', reason: 'Dead letter queue' },
-    { pattern: /\bmigration/i, key: 'migrations', reason: 'Database migrations' },
-];
-const SCALE_KEYWORDS = [
-    { pattern: /\bsmall\b|\bsimple\b|\bblog\b|\bpersonal\b|\bside\s*project\b|\bmvp\b|\bprototype\b/i, scale: 'small', reason: 'Small/simple project' },
-    { pattern: /\bmedium\b|\bstartup\b|\bsaas\b|\bteam\b|\bgrow/i, scale: 'medium', reason: 'Medium/startup scale' },
-    { pattern: /\blarge\b|\benterprise\b|\bthousands\b|\bhigh\s*traffic\b|\bscale\b|\bproduction\b/i, scale: 'large', reason: 'Large/production scale' },
-];
-// ── Main resolver ───────────────────────────────
-export function resolveDeployConfig(prose) {
-    if (!prose.trim())
-        return null;
-    const reasoning = [];
-    const features = new Set();
-    // Extract budget — prefer amounts near cost keywords, fall back to first $N
-    const costContextMatch = prose.match(/(?:budget|spend|cost|month|mo)[^$]*\$(\d+(?:\.\d+)?)/i)
-        ?? prose.match(/\$(\d+(?:\.\d+)?)(?:\s*\/\s*mo(?:nth)?)/i)
-        ?? prose.match(/\$(\d+(?:\.\d+)?)/i);
-    const budget = costContextMatch ? Math.round(parseFloat(costContextMatch[1])) : -1;
-    // Detect explicit platform
-    let deploy = 'vps'; // default
-    let platformDetected = false;
-    for (const kw of PLATFORM_KEYWORDS) {
-        if (kw.pattern.test(prose)) {
-            deploy = kw.target;
-            reasoning.push(kw.reason);
-            platformDetected = true;
-            break;
-        }
-    }
-    // Detect features
-    for (const kw of FEATURE_KEYWORDS) {
-        if (kw.pattern.test(prose)) {
-            features.add(kw.key);
-            reasoning.push(kw.reason);
-        }
-    }
-    // Detect scale
-    let scale = 'small';
-    for (const kw of SCALE_KEYWORDS) {
-        if (kw.pattern.test(prose)) {
-            scale = kw.scale;
-            reasoning.push(kw.reason);
-            break;
-        }
-    }
-    // If no platform detected, infer from features and scale
-    if (!platformDetected) {
-        if (features.has('previewDeploys') || features.has('errorBoundaries')) {
-            deploy = 'vercel';
-            reasoning.push('Preview deploys/error boundaries → Vercel (best support)');
-        }
-        else if (scale === 'large' || features.has('customDomain') || budget > 30) {
-            deploy = 'vps';
-            reasoning.push('Large scale or custom domain with budget → VPS');
-        }
-        else if (scale === 'small' && budget < 0) {
-            deploy = 'railway';
-            reasoning.push('Small project, no budget specified → Railway (easiest start)');
-        }
-        else {
-            deploy = 'vps';
-            reasoning.push('Default → VPS (most flexible)');
-        }
-    }
-    // Resolve instance type from budget or scale
-    let instanceType = '';
-    let estimatedCost = '';
-    if (deploy === 'vps') {
-        if (budget >= 0) {
-            const tier = resolveInstanceFromBudget(budget);
-            instanceType = tier.instanceType;
-            estimatedCost = tier.label;
-            reasoning.push(`Budget $${budget}/mo → ${tier.instanceType} (${tier.label})`);
-        }
-        else {
-            const scaleMap = { small: 't3.micro', medium: 't3.small', large: 't3.medium' };
-            const costMap = { small: '~$8/mo', medium: '~$17/mo', large: '~$34/mo' };
-            instanceType = scaleMap[scale];
-            estimatedCost = costMap[scale];
-            reasoning.push(`${scale} scale → ${instanceType} (${estimatedCost})`);
-        }
-    }
-    else {
-        estimatedCost = deploy === 'railway' ? 'Free tier available' :
-            deploy === 'vercel' ? 'Free tier available' :
-                deploy === 'cloudflare' ? 'Free tier available' :
-                    deploy === 'static' ? 'Minimal (~$1/mo S3)' : 'Varies';
-    }
-    // Extract hostname if mentioned
-    const hostnameMatch = prose.match(/(?:domain|hostname|url)[\s:]*([a-z0-9.-]+\.[a-z]{2,})/i);
-    const hostname = hostnameMatch ? hostnameMatch[1] : '';
-    if (hostname)
-        reasoning.push(`Hostname detected: ${hostname}`);
-    // Build resilience config — defaults based on deploy target + detected features
-    const isVps = deploy === 'vps';
-    const isPlatform = ['vercel', 'railway', 'cloudflare'].includes(deploy);
-    const resilience = {
-        multiEnv: features.has('multiEnv') || scale !== 'small',
-        previewDeploys: features.has('previewDeploys') || (isPlatform && scale !== 'small'),
-        rollback: features.has('rollback') || isPlatform,
-        migrations: features.has('migrations') ? 'auto' : (isVps ? 'manual' : 'no'),
-        backups: features.has('backups') ? 'daily' : (isVps && scale !== 'small' ? 'weekly' : 'no'),
-        healthCheck: features.has('healthCheck') || isVps || scale !== 'small',
-        gracefulShutdown: features.has('gracefulShutdown') || isVps,
-        errorBoundaries: features.has('errorBoundaries'),
-        rateLimiting: features.has('rateLimiting') || scale === 'large',
-        deadLetterQueue: features.has('deadLetterQueue'),
-    };
-    return {
-        deploy,
-        instanceType,
-        hostname,
-        estimatedMonthlyCost: estimatedCost,
-        resilience,
-        reasoning,
-    };
-}
-/** Sanitize a string for safe YAML double-quoted interpolation. */
-function yamlSafe(value) {
-    return value.replace(/[\\"]/g, '');
-}
-/** Convert a DeployConfig to YAML frontmatter fragment. */
-export function toFrontmatter(config) {
-    const lines = [
-        `deploy: "${yamlSafe(config.deploy)}"`,
-    ];
-    if (config.instanceType) {
-        lines.push(`instance_type: "${yamlSafe(config.instanceType)}"`);
-    }
-    if (config.hostname) {
-        lines.push(`hostname: "${yamlSafe(config.hostname.toLowerCase())}"`);
-    }
-    lines.push('resilience:');
-    lines.push(`  multi-env: ${config.resilience.multiEnv ? 'yes' : 'no'}`);
-    lines.push(`  preview-deploys: ${config.resilience.previewDeploys ? 'yes' : 'no'}`);
-    lines.push(`  rollback: ${config.resilience.rollback ? 'yes' : 'no'}`);
-    lines.push(`  migrations: "${yamlSafe(config.resilience.migrations)}"`);
-    lines.push(`  backups: "${yamlSafe(config.resilience.backups)}"`);
-    lines.push(`  health-check: ${config.resilience.healthCheck ? 'yes' : 'no'}`);
-    lines.push(`  graceful-shutdown: ${config.resilience.gracefulShutdown ? 'yes' : 'no'}`);
-    lines.push(`  error-boundaries: ${config.resilience.errorBoundaries ? 'yes' : 'no'}`);
-    lines.push(`  rate-limiting: ${config.resilience.rateLimiting ? 'yes' : 'no'}`);
-    lines.push(`  dead-letter-queue: ${config.resilience.deadLetterQueue ? 'yes' : 'no'}`);
-    return lines.join('\n');
-}

package/dist/wizard/lib/route-optimizer.d.ts

@@ -1,28 +0,0 @@
-/**
- * Paris's Route Optimizer — ROI-weighted campaign sequencing (v12.3).
- *
- * Given multiple possible campaigns (from the proposal generator), Paris
- * computes the optimal execution order based on estimated ROI, dependencies,
- * risk, and urgency.
- *
- * PRD Reference: ROADMAP v12.3, DEEP_CURRENT.md Paris's role
- */
-import type { CampaignProposal } from './campaign-proposer.js';
-import type { SituationModel } from './deep-current.js';
-interface RouteScore {
-    proposal: CampaignProposal;
-    roiScore: number;
-    urgencyScore: number;
-    riskScore: number;
-    totalScore: number;
-}
-/**
- * Score and rank campaign proposals by optimal execution order.
- * Returns proposals sorted by total score (highest first = execute first).
- */
-export declare function optimizeRoute(proposals: CampaignProposal[], model: SituationModel): RouteScore[];
-/**
- * Pick the single best campaign to execute next.
- */
-export declare function pickBestCampaign(proposals: CampaignProposal[], model: SituationModel): CampaignProposal | null;
-export type { RouteScore };

package/dist/wizard/lib/route-optimizer.js

@@ -1,93 +0,0 @@
-/**
- * Paris's Route Optimizer — ROI-weighted campaign sequencing (v12.3).
- *
- * Given multiple possible campaigns (from the proposal generator), Paris
- * computes the optimal execution order based on estimated ROI, dependencies,
- * risk, and urgency.
- *
- * PRD Reference: ROADMAP v12.3, DEEP_CURRENT.md Paris's role
- */
-// ── Scoring Weights ───────────────────────────────────
-const WEIGHTS = {
-    roi: 0.40,
-    urgency: 0.35,
-    risk: 0.25, // Inverted — lower risk gets higher score
-};
-// ── ROI Estimation ────────────────────────────────────
-function estimateRoi(proposal, model) {
-    // ROI = (dimension improvement potential) / (estimated effort)
-    const currentScore = proposal.dimensionScore;
-    const potentialGain = Math.min(30, 100 - currentScore); // Cap at 30-point improvement
-    const effort = proposal.estimatedSessions;
-    // Higher gain per session = higher ROI
-    const roiRatio = potentialGain / Math.max(effort, 1);
-    return Math.min(100, Math.round(roiRatio * 10)); // Scale to 0-100
-}
-// ── Urgency Scoring ───────────────────────────────────
-function scoreUrgency(proposal, model) {
-    const dim = proposal.dimension;
-    const score = proposal.dimensionScore;
-    // Critical defects are always urgent
-    if (dim === 'quality' && score < 30)
-        return 100;
-    // Security issues are urgent
-    if (dim === 'performance' && model.lastSiteScan && !model.lastSiteScan.security.https)
-        return 90;
-    // Low scores are more urgent
-    if (score < 20)
-        return 80;
-    if (score < 40)
-        return 60;
-    if (score < 60)
-        return 40;
-    // Revenue is urgent for OPERATING projects
-    if (dim === 'revenuePotential' && model.projectState === 'OPERATING')
-        return 70;
-    return 20; // Low urgency by default
-}
-// ── Risk Scoring ──────────────────────────────────────
-function scoreRisk(proposal) {
-    // Revenue/payment campaigns are higher risk (real money)
-    if (proposal.dimension === 'revenuePotential')
-        return 70;
-    // Feature campaigns have moderate risk (new code)
-    if (proposal.dimension === 'featureCompleteness')
-        return 50;
-    // Quality and performance campaigns are low risk
-    if (proposal.dimension === 'quality')
-        return 20;
-    if (proposal.dimension === 'performance')
-        return 25;
-    // Growth foundation is low risk (additive, no existing code modified)
-    if (proposal.dimension === 'growthReadiness')
-        return 30;
-    return 40;
-}
-// ── Route Optimization ────────────────────────────────
-/**
- * Score and rank campaign proposals by optimal execution order.
- * Returns proposals sorted by total score (highest first = execute first).
- */
-export function optimizeRoute(proposals, model) {
-    const scored = proposals.map(proposal => {
-        const roiScore = estimateRoi(proposal, model);
-        const urgencyScore = scoreUrgency(proposal, model);
-        const riskScore = 100 - scoreRisk(proposal); // Invert: low risk = high score
-        const totalScore = Math.round(roiScore * WEIGHTS.roi +
-            urgencyScore * WEIGHTS.urgency +
-            riskScore * WEIGHTS.risk);
-        return { proposal, roiScore, urgencyScore, riskScore, totalScore };
-    });
-    // Sort by total score descending (best first)
-    scored.sort((a, b) => b.totalScore - a.totalScore);
-    return scored;
-}
-/**
- * Pick the single best campaign to execute next.
- */
-export function pickBestCampaign(proposals, model) {
-    if (proposals.length === 0)
-        return null;
-    const ranked = optimizeRoute(proposals, model);
-    return ranked[0].proposal;
-}

package/dist/wizard/lib/service-install.d.ts

@@ -1,18 +0,0 @@
-/**
- * Service Install — launchd/systemd/Task Scheduler integration (§9.18, §9.19.2).
- *
- * Creates system services for:
- * 1. Heartbeat daemon (com.voidforge.heartbeat)
- * 2. Wizard server (com.voidforge.server) — persistent when Cultivation is installed
- *
- * PRD Reference: §9.18 (macOS LaunchAgent), §9.19.2 (two services)
- */
-export declare function installHeartbeatService(): Promise<{
-    method: string;
-    path: string;
-}>;
-export declare function installServerService(port?: number): Promise<{
-    method: string;
-    path: string;
-}>;
-export declare function uninstallServices(): Promise<void>;

package/dist/wizard/lib/service-install.js

@@ -1,182 +0,0 @@
-/**
- * Service Install — launchd/systemd/Task Scheduler integration (§9.18, §9.19.2).
- *
- * Creates system services for:
- * 1. Heartbeat daemon (com.voidforge.heartbeat)
- * 2. Wizard server (com.voidforge.server) — persistent when Cultivation is installed
- *
- * PRD Reference: §9.18 (macOS LaunchAgent), §9.19.2 (two services)
- */
-import { writeFile, mkdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { homedir, platform } from 'node:os';
-import { execSync } from 'node:child_process';
-const VOIDFORGE_DIR = join(homedir(), '.voidforge');
-// ── macOS LaunchAgent ─────────────────────────────────
-function heartbeatPlist() {
-    const nodePath = process.execPath;
-    // Assuming the heartbeat entry point is at wizard/lib/heartbeat.js
-    // In production, this would be the installed package path
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.voidforge.heartbeat</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${nodePath}</string>
-    <string>${join(VOIDFORGE_DIR, 'heartbeat-entry.js')}</string>
-  </array>
-  <key>KeepAlive</key>
-  <true/>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>ProcessType</key>
-  <string>Background</string>
-  <key>ThrottleInterval</key>
-  <integer>10</integer>
-  <key>StandardOutPath</key>
-  <string>${join(VOIDFORGE_DIR, 'heartbeat-launchd.log')}</string>
-  <key>StandardErrorPath</key>
-  <string>${join(VOIDFORGE_DIR, 'heartbeat-launchd.log')}</string>
-</dict>
-</plist>`;
-}
-function serverPlist(port = 3141) {
-    const nodePath = process.execPath;
-    return `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>com.voidforge.server</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${nodePath}</string>
-    <string>${join(VOIDFORGE_DIR, 'server-entry.js')}</string>
-  </array>
-  <key>KeepAlive</key>
-  <true/>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>ProcessType</key>
-  <string>Background</string>
-  <key>ThrottleInterval</key>
-  <integer>10</integer>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>VOIDFORGE_PORT</key>
-    <string>${port}</string>
-  </dict>
-  <key>StandardOutPath</key>
-  <string>${join(VOIDFORGE_DIR, 'server-launchd.log')}</string>
-  <key>StandardErrorPath</key>
-  <string>${join(VOIDFORGE_DIR, 'server-launchd.log')}</string>
-</dict>
-</plist>`;
-}
-// ── Linux systemd ─────────────────────────────────────
-function heartbeatSystemdUnit() {
-    return `[Unit]
-Description=VoidForge Heartbeat Daemon
-After=network.target
-
-[Service]
-Type=simple
-ExecStart=${process.execPath} ${join(VOIDFORGE_DIR, 'heartbeat-entry.js')}
-Restart=always
-RestartSec=10
-StandardOutput=append:${join(VOIDFORGE_DIR, 'heartbeat-systemd.log')}
-StandardError=append:${join(VOIDFORGE_DIR, 'heartbeat-systemd.log')}
-
-[Install]
-WantedBy=default.target`;
-}
-function serverSystemdUnit(port = 3141) {
-    return `[Unit]
-Description=VoidForge Server (Danger Room + Cultivation)
-After=network.target
-
-[Service]
-Type=simple
-ExecStart=${process.execPath} ${join(VOIDFORGE_DIR, 'server-entry.js')}
-Environment=VOIDFORGE_PORT=${port}
-Restart=always
-RestartSec=10
-StandardOutput=append:${join(VOIDFORGE_DIR, 'server-systemd.log')}
-StandardError=append:${join(VOIDFORGE_DIR, 'server-systemd.log')}
-
-[Install]
-WantedBy=default.target`;
-}
-// ── Install Functions ─────────────────────────────────
-export async function installHeartbeatService() {
-    if (platform() === 'darwin') {
-        const plistDir = join(homedir(), 'Library', 'LaunchAgents');
-        const plistPath = join(plistDir, 'com.voidforge.heartbeat.plist');
-        await mkdir(plistDir, { recursive: true });
-        await writeFile(plistPath, heartbeatPlist());
-        execSync(`launchctl load "${plistPath}" 2>/dev/null || true`);
-        return { method: 'launchd', path: plistPath };
-    }
-    if (platform() === 'linux') {
-        const unitDir = join(homedir(), '.config', 'systemd', 'user');
-        const unitPath = join(unitDir, 'voidforge-heartbeat.service');
-        await mkdir(unitDir, { recursive: true });
-        await writeFile(unitPath, heartbeatSystemdUnit());
-        execSync('systemctl --user daemon-reload 2>/dev/null || true');
-        execSync('systemctl --user enable voidforge-heartbeat 2>/dev/null || true');
-        return { method: 'systemd', path: unitPath };
-    }
-    // Windows: Task Scheduler (recommend WSL2 for full support per §9.17)
-    return { method: 'manual', path: 'Windows: use WSL2 or run `voidforge heartbeat start --daemon` manually' };
-}
-export async function installServerService(port = 3141) {
-    if (platform() === 'darwin') {
-        const plistDir = join(homedir(), 'Library', 'LaunchAgents');
-        const plistPath = join(plistDir, 'com.voidforge.server.plist');
-        await mkdir(plistDir, { recursive: true });
-        await writeFile(plistPath, serverPlist(port));
-        execSync(`launchctl load "${plistPath}" 2>/dev/null || true`);
-        return { method: 'launchd', path: plistPath };
-    }
-    if (platform() === 'linux') {
-        const unitDir = join(homedir(), '.config', 'systemd', 'user');
-        const unitPath = join(unitDir, 'voidforge-server.service');
-        await mkdir(unitDir, { recursive: true });
-        await writeFile(unitPath, serverSystemdUnit(port));
-        execSync('systemctl --user daemon-reload 2>/dev/null || true');
-        execSync('systemctl --user enable voidforge-server 2>/dev/null || true');
-        return { method: 'systemd', path: unitPath };
-    }
-    return { method: 'manual', path: 'Windows: use WSL2 or run the wizard server manually' };
-}
-export async function uninstallServices() {
-    if (platform() === 'darwin') {
-        const agents = ['com.voidforge.heartbeat', 'com.voidforge.server'];
-        for (const label of agents) {
-            const path = join(homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
-            try {
-                execSync(`launchctl unload "${path}" 2>/dev/null`);
-                const { unlink } = await import('node:fs/promises');
-                await unlink(path);
-            }
-            catch { /* not installed */ }
-        }
-    }
-    if (platform() === 'linux') {
-        const units = ['voidforge-heartbeat', 'voidforge-server'];
-        for (const unit of units) {
-            try {
-                execSync(`systemctl --user stop ${unit} 2>/dev/null`);
-                execSync(`systemctl --user disable ${unit} 2>/dev/null`);
-                const path = join(homedir(), '.config', 'systemd', 'user', `${unit}.service`);
-                const { unlink } = await import('node:fs/promises');
-                await unlink(path);
-            }
-            catch { /* not installed */ }
-        }
-        execSync('systemctl --user daemon-reload 2>/dev/null || true');
-    }
-}