@feltdb/core 0.4.11 → 0.4.13

package/dist/cli/commands.js

@@ -7,7 +7,7 @@ import http from 'http';
 import { createRequire } from 'module';
 import { spawn, spawnSync } from 'child_process';
 import { createFeltDB, diffFlowSpec, formatFlowSpec, parseFlowSpec, planFlowSpecMigration, validateFlowSpec } from '@feltdb/core';
-const RELEASE_VERSION = '0.4.11';
+const RELEASE_VERSION = '0.4.13';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -699,6 +699,9 @@ async function handleStudio(args) {
     const port = args.includes('--port')
         ? args[args.indexOf('--port') + 1] || '3000'
         : '3000';
+    const host = args.includes('--host')
+        ? args[args.indexOf('--host') + 1] || '127.0.0.1'
+        : '127.0.0.1';
     const open = !args.includes('--no-open');
     const namespace = args.includes('--namespace')
         ? args[args.indexOf('--namespace') + 1] || 'default'
@@ -745,7 +748,7 @@ async function handleStudio(args) {
         response.setHeader('Cache-Control', file.endsWith('index.html') ? 'no-store' : 'public, max-age=31536000, immutable');
         fs.createReadStream(file).pipe(response);
     });
-    await new Promise((resolve, reject) => { server.once('error', reject); server.listen(Number(port), '127.0.0.1', resolve); });
+    await new Promise((resolve, reject) => { server.once('error', reject); server.listen(Number(port), host, resolve); });
     const parameters = new URLSearchParams({ namespace, runtime });
     if (connectUrl)
         parameters.set('connect', connectUrl);

package/dist/cli/index.js

@@ -23,7 +23,7 @@ import * as path from 'path';
 import * as readline from 'readline';
 import { getClient } from './api-client.js';
 import { loadFeltDBConfig, createDefaultConfig, validateModel, } from './config.js';
-const VERSION = '0.4.11';
+const VERSION = '0.4.13';
 function prompt(question) {
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/create/cli.js

@@ -18,6 +18,7 @@ function parseArgs(args) {
         framework: 'react',
         distributed: true,
         agents: true,
+        webllm: true,
         capabilities: 'search',
     };
     for (let i = 0; i < args.length; i++) {
@@ -46,6 +47,12 @@ function parseArgs(args) {
             case '--no-agents':
                 options.agents = false;
                 break;
+            case '--webllm':
+                options.webllm = true;
+                break;
+            case '--no-webllm':
+                options.webllm = false;
+                break;
             case '--capabilities':
                 options.capabilities = args[++i];
                 break;
@@ -161,6 +168,10 @@ async function promptForOptions(defaults) {
         ], defaults.framework),
         distributed: await select('Enable distributed operation?', yesNo, defaults.distributed),
         agents: await select('Include an autonomous agent example?', yesNo, defaults.agents),
+        webllm: await select('Install WebLLM for private natural-language app building?', [
+            { label: 'Yes', value: true, description: 'build FeltDB schemas, capabilities, workflows, and UI locally with AI' },
+            { label: 'No', value: false, description: 'skip the browser model and AI builder' },
+        ], defaults.webllm),
         capabilities: await select('Choose starter capabilities:', [
             { label: 'Search', value: 'search' },
             { label: 'Vector search', value: 'vector' },
@@ -212,6 +223,8 @@ Options:
   --framework <framework>  Choose framework: react or vanilla (default: react)
   --no-distributed         Disable distributed operation
   --no-agents              Exclude agent examples
+  --webllm                 Include the private natural-language FeltDB app builder (default)
+  --no-webllm              Do not install WebLLM or generate the AI builder
   --capabilities <list>    Choose capabilities: search, vector, or search,vector
   --no-install             Skip npm install
   --no-start               Skip npm run dev
@@ -269,6 +282,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
     console.log(`Framework:     ${options.framework}`);
     console.log(`Distributed:   ${options.distributed ? 'yes' : 'no'}`);
     console.log(`Agents:        ${options.agents ? 'yes' : 'no'}`);
+    console.log(`WebLLM:        ${options.webllm ? 'yes — natural-language app builder' : 'no'}`);
     console.log(`Capabilities:  ${options.capabilities}`);
     console.log('\n═══════════════════════════════════════════════\n');
     const projectDir = path.resolve(process.cwd(), projectName);
@@ -281,6 +295,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
             framework: options.framework,
             distributed: options.distributed,
             agents: options.agents,
+            webllm: options.webllm,
             capabilities: options.capabilities,
         });
         if (options.runtime === 'managed') {
@@ -297,7 +312,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
         console.log('\n✅ FeltDB application created successfully!\n');
         const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
         if (shouldInstall) {
-            console.log('📦 Installing application, Studio, and local AI dependencies...\n');
+            console.log(`📦 Installing application, Studio${options.webllm ? ', and local WebLLM app builder' : ''} dependencies...\n`);
             await run(npm, ['install'], projectDir);
         }
         if (shouldStart) {

package/dist/create/create.js

@@ -3,8 +3,10 @@
  */
 import fs from 'fs';
 import path from 'path';
+import { fileURLToPath } from 'url';
+import { randomBytes } from 'crypto';
 import { feltdbPackageRange } from './package-versions.js';
-import { generateDockerCompose, generateDockerfile, generateDockerIgnore, generateDotEnvLocal, } from './docker-compose-generator.js';
+import { generateDockerCompose, generateDockerfile, generateDockerIgnore, generateDotEnvLocal, generateFeltDBDockerfile, generateStudioDockerfile, } from './docker-compose-generator.js';
 export async function createProject(options) {
     const { projectName, templatesDir } = options;
     const projectDir = path.resolve(process.cwd(), projectName);
@@ -29,6 +31,7 @@ export async function createProject(options) {
     const framework = options.framework || 'react';
     const distributed = options.distributed !== false;
     const hasAgents = options.agents !== false;
+    const hasWebLLM = options.webllm !== false;
     const capabilities = options.capabilities || 'search';
     // Create package.json
     const packageJson = {
@@ -65,7 +68,7 @@ export async function createProject(options) {
         packageJson.devDependencies['@types/react'] = '^18.0.0';
         packageJson.devDependencies['@types/react-dom'] = '^18.0.0';
     }
-    if (hasAgents) {
+    if (hasAgents && hasWebLLM) {
         packageJson.dependencies['@feltdb/webllm'] = feltdbPackageRange;
     }
     fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2));
@@ -345,7 +348,7 @@ async function logActivity(event: Omit<ActivityEvent, 'id' | 'timestamp'>): Prom
 `;
     fs.writeFileSync(path.join(srcDir, 'feltdb.ts'), feltdbTs);
     // Create a real local-inference agent for browser projects.
-    if (hasAgents) {
+    if (hasAgents && hasWebLLM) {
         const agentTs = `import { WebLLMProvider } from '@feltdb/webllm';
 import { db, reports } from '../../src/feltdb';
 
@@ -385,15 +388,19 @@ export async function runResearcher(
   }
 
   try {
-    const systemPrompt = \`You are a helpful AI assistant that operates entirely in the browser.
-You help users:
-- Summarize documents concisely
-- Expand and enhance text with more details
-- Generate ideas and suggestions
-- Improve writing clarity and structure
-- Answer questions about document content
+    const systemPrompt = \`You are the private, in-browser FeltDB application builder.
+Turn natural-language product requirements into valid, coherent FeltDB applications. You know the
+Flow DSL and keep collections, references, indexes, capabilities, workflows, triggers, policies,
+agents, and React UI code consistent with one another.
 
-Always be concise and practical. Respect the user's intent.\`;
+Supported field types are text, integer, number, decimal, money, bigint, boolean, datetime, date,
+time, uuid, email, url, phone, json, object, binary, file, geo, enum(...), array<T>, map<T>,
+vector<N>, and ref Collection. Prefer UUID identifiers, explicit references, precise domain types,
+least-privilege capabilities, and policies for every writable collection. Never invent syntax.
+
+When asked to build or change an app, return a short implementation plan followed by complete
+copy-ready feltdb.flow and TypeScript/React code blocks. Preserve the existing app model supplied
+by the user and clearly identify files to create or replace. All inference remains local.\`;
 
     const content = await provider.generate([
       { role: 'system', content: systemPrompt },
@@ -537,10 +544,10 @@ export const capabilities = {
     fs.writeFileSync(path.join(feltdbDir, 'capabilities', 'index.ts'), capabilitiesTs);
     // Create main application file based on framework
     if (framework === 'react') {
-        const agentImport = hasAgents
+        const agentImport = hasAgents && hasWebLLM
             ? "import { runResearcher, summarizeDocument, enhanceDocument, generateIdeas, generateFeltDBFeature, generateReactComponent, generateCapability } from '../feltdb/agents/researcher';"
             : '';
-        const agentState = hasAgents
+        const agentState = hasAgents && hasWebLLM
             ? `  const [prompt, setPrompt] = useState('');
   const [answer, setAnswer] = useState('');
   const [modelStatus, setModelStatus] = useState('Model not loaded');
@@ -548,7 +555,7 @@ export const capabilities = {
   const [selectedDoc, setSelectedDoc] = useState<any | null>(null);
   const [aiMode, setAiMode] = useState<'custom' | 'summarize' | 'enhance' | 'ideas' | 'feltdb' | 'react' | 'capability'>('custom');`
             : '';
-        const agentHandler = hasAgents
+        const agentHandler = hasAgents && hasWebLLM
             ? `
   const handleRunAI = async (mode: 'custom' | 'summarize' | 'enhance' | 'ideas' | 'feltdb' | 'react' | 'capability') => {
     setGenerating(true);
@@ -582,7 +589,7 @@ export const capabilities = {
   };
 `
             : '';
-        const agentMarkup = hasAgents
+        const agentMarkup = hasAgents && hasWebLLM
             ? `
         <section className="researcher">
           <h2>🤖 AI Assistant (Private, Local)</h2>
@@ -1230,8 +1237,15 @@ NODE_ENV=development
         };
         fs.writeFileSync(path.join(projectDir, 'docker-compose.yml'), generateDockerCompose(dockerConfig));
         fs.writeFileSync(path.join(projectDir, 'Dockerfile'), generateDockerfile(dockerConfig, framework));
+        fs.writeFileSync(path.join(projectDir, 'Dockerfile.feltdb'), generateFeltDBDockerfile(dockerConfig));
+        fs.writeFileSync(path.join(projectDir, 'Dockerfile.studio'), generateStudioDockerfile(dockerConfig));
+        const serverSource = fileURLToPath(new URL('./server-source', import.meta.url));
+        fs.cpSync(serverSource, path.join(projectDir, '.feltdb', 'server-source'), { recursive: true });
         fs.writeFileSync(path.join(projectDir, '.dockerignore'), generateDockerIgnore());
-        fs.writeFileSync(path.join(projectDir, '.env.docker'), generateDotEnvLocal(dockerConfig));
+        const dockerEnvironment = generateDotEnvLocal(dockerConfig, randomBytes(32).toString('hex'));
+        fs.writeFileSync(path.join(projectDir, '.env.docker'), dockerEnvironment);
+        // Docker Compose loads .env automatically; it is already excluded from git.
+        fs.writeFileSync(path.join(projectDir, '.env'), dockerEnvironment);
     }
     // Create RUNTIME_GUIDE.md
     const runtimeGuide = `# Runtime Configuration Guide

package/dist/create/docker-compose-generator.js

@@ -2,26 +2,28 @@
  * Docker Compose generator for self-hosted FeltDB deployments
  *
  * Generates:
- * - docker-compose.yml with three services (FeltDB, App, Studio)
- * - Dockerfile for application container
+ * - docker-compose.yml with three locally buildable services
+ * - Dockerfiles for the FeltDB server, application, and Studio
  * - .dockerignore for optimized builds
  * - Environment configuration
  */
 export function generateDockerCompose(config) {
     return `services:
   feltdb:
-    image: \${FELTDB_IMAGE:-ghcr.io/rkendel1/feltdb:${config.version}}
+    image: \${FELTDB_IMAGE:-${config.appName.toLowerCase().replace(/[^a-z0-9]/g, '-')}-feltdb:${config.version}}
+    build:
+      context: .
+      dockerfile: Dockerfile.feltdb
     container_name: \${COMPOSE_PROJECT_NAME}-feltdb
     environment:
       FELTDB_APP_NAME: \${FELTDB_APP_NAME:-${config.appName}}
       FELTDB_APP_ID: \${FELTDB_APP_ID:-${config.appId}}
       FELTDB_VERSION: \${FELTDB_VERSION:-${config.version}}
       FELTDB_PEERS: \${FELTDB_PEERS:-}
-      FELTDB_REPLICATION_PORT: ${config.replicationPort}
+      FELTDB_MASTER_KEY: \${FELTDB_MASTER_KEY}
       NODE_ENV: \${NODE_ENV:-production}
     ports:
       - "\${FELTDB_API_PORT:-${config.port}}:7700"
-      - "\${FELTDB_REPLICATION_PORT:-${config.replicationPort}}:${config.replicationPort}"
     volumes:
       - feltdb_data:/data
       - ./feltdb.flow:/app/feltdb.flow:ro
@@ -69,11 +71,17 @@ export function generateDockerCompose(config) {
       app.feltdb/version: "${config.version}"
 
   studio:
-    image: rkendel1/feltdb-studio:latest
+    image: \${STUDIO_IMAGE:-${config.appName.toLowerCase().replace(/[^a-z0-9]/g, '-')}-studio:${config.version}}
+    build:
+      context: .
+      dockerfile: Dockerfile.studio
+      args:
+        FELTDB_VERSION: ${config.version}
     container_name: \${COMPOSE_PROJECT_NAME}-studio
     environment:
-      FELTDB_API_URL: http://feltdb:7700
-      APP_URL: http://app:3000
+      FELTDB_API_URL: \${FELTDB_PUBLIC_URL:-http://127.0.0.1:${config.port}}
+      APP_URL: \${APP_PUBLIC_URL:-http://127.0.0.1:5173}
+      FELTDB_NAMESPACE: \${FELTDB_APP_ID:-${config.appId}}
     ports:
       - "\${STUDIO_PORT:-${config.studioPort}}:8000"
     depends_on:
@@ -97,6 +105,36 @@ volumes:
       app.feltdb/data: "durable-operations-log"
 `;
 }
+export function generateFeltDBDockerfile(config) {
+    return `# FeltDB server source is bundled with create-feltdb for a reproducible build.
+FROM rust:1.96-alpine AS builder
+RUN apk add --no-cache pkgconf openssl-dev musl-dev
+WORKDIR /source
+COPY .feltdb/server-source/ ./
+RUN cargo build -p feltdb-server --release --locked
+
+FROM alpine:3.22
+RUN apk add --no-cache ca-certificates curl tini
+COPY --from=builder /source/target/release/feltdb-server /usr/local/bin/feltdb-server
+RUN adduser -D -u 1000 feltdb && mkdir -p /data && chown feltdb:feltdb /data
+USER feltdb
+EXPOSE 7700
+HEALTHCHECK --interval=10s --timeout=5s --start-period=30s --retries=3 CMD curl -fsS http://127.0.0.1:7700/health || exit 1
+ENTRYPOINT ["/sbin/tini", "--"]
+CMD ["feltdb-server", "--host", "0.0.0.0", "--port", "7700", "--namespace", "${config.appId}", "--data", "/data/feltdb.log", "--allow-origin", "http://127.0.0.1:5173", "--allow-origin", "http://127.0.0.1:${config.studioPort}"]
+`;
+}
+export function generateStudioDockerfile(config) {
+    return `# FeltDB Studio served by the same version as this generated project.
+FROM node:22-alpine
+ARG FELTDB_VERSION=${config.version}
+RUN npm install --global "@feltdb/core@\${FELTDB_VERSION}" && npm cache clean --force
+WORKDIR /project
+COPY feltdb.flow ./feltdb.flow
+EXPOSE 8000
+CMD ["sh", "-c", "feltdb studio --host 0.0.0.0 --port 8000 --namespace \"\${FELTDB_NAMESPACE}\" --runtime self-hosted --connect \"\${FELTDB_API_URL}\" --app-url \"\${APP_URL}\" --no-open"]
+`;
+}
 export function generateDockerfile(config, framework) {
     const buildCommand = 'npm run build';
     return `# FeltDB Application Container
@@ -143,7 +181,7 @@ coverage
 .turbo
 `;
 }
-export function generateDotEnvLocal(config) {
+export function generateDotEnvLocal(config, masterKey = '') {
     return `# Docker Compose Environment
 # Generated by create-feltdb for \${config.appName}
 
@@ -156,6 +194,7 @@ FELTDB_VERSION=${config.version}
 FELTDB_API_PORT=${config.port}
 FELTDB_REPLICATION_PORT=${config.replicationPort}
 FELTDB_PEERS=
+FELTDB_MASTER_KEY=${masterKey}
 
 # Application Configuration
 APP_PORT=3000

package/dist/create/package-versions.js

@@ -1,4 +1,4 @@
 // One release train keeps generated applications installable. The repository
 // validation script checks these values against every workspace manifest.
-export const FELTDB_PACKAGE_VERSION = '0.4.11';
+export const FELTDB_PACKAGE_VERSION = '0.4.13';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;