@feltdb/core 0.9.1 → 0.11.0

package/dist/cli/commands.js

@@ -5,7 +5,7 @@ import fs from 'fs';
 import path from 'path';
 import http from 'http';
 import net from 'net';
-import { createRequire } from 'module';
+import { createRequire } from 'node:module';
 import { spawn, spawnSync } from 'child_process';
 import { randomBytes } from 'crypto';
 import { createInterface } from 'node:readline/promises';
@@ -15,7 +15,7 @@ import { collectRepositoryEvidence } from './repository-evidence.js';
 import { discoverWorkspace, ensureWorkspaceGitIgnored, generatePairingToken, persistPairingToken, displayWorkspaceStatus, initializeWorkspace, startPairingDiscoveryServer } from './workspace-integration.js';
 import { applicationUrlCandidate, detectApplication, discoverApplicationUrl } from './application.js';
 import { resolveApplicationLifecycle, startManagedApplication, waitForManagedApplication } from './application-lifecycle.js';
-import { createDevelopmentSession, developmentSessionEnvironment, developmentSessionSummary, transitionDevelopmentSession } from './development-session.js';
+import { createDevelopmentSession, developmentSessionEnvironment, developmentSessionSummary, developmentStudioArguments, transitionDevelopmentSession } from './development-session.js';
 import { openApplication, openStudio } from './browser-opening.js';
 import { publishApplication } from './publish-engine.js';
 import { applyFlowProposalAtomic, assertProposalSourcePlan, describeProposal, loadLocalDevelopmentContract, repositoryContext, reviewFlowProposal, syncGeneratedSource } from './source-sync.js';
@@ -23,6 +23,8 @@ import { configureAiModel, generateConfiguredFlowProposal, publicAiModelConfigur
 import { proposalService } from './proposal-client.js';
 import { resolveManagedAuthorityEnvironment } from './managed-environment.js';
 import { readManagedProjectState } from './managed-project.js';
+import { resolveCanonicalStudioArtifact } from './studio-artifact.js';
+import { configureManagedAccount, finalizeManagedProvisioning } from '../create/index.js';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -60,6 +62,8 @@ export async function handleCommand(command, args) {
             return handleServer(args);
         case 'keys':
             return handleKeys(args);
+        case 'init-managed':
+            return handleInitManaged(args);
         case 'connect':
             return handleConnect(args);
         case 'status':
@@ -863,6 +867,123 @@ async function handleConnect(args) {
     console.log(`Health:       ${health.status || 'healthy'}\n`);
     console.log('Use: feltdb status  (to check connection)\n');
 }
+async function promptSecret(message) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return '';
+    const input = process.stdin;
+    const output = process.stdout;
+    const wasRaw = input.isRaw;
+    const readline = await import('node:readline');
+    readline.emitKeypressEvents(input);
+    input.setRawMode(true);
+    input.resume();
+    output.write(message);
+    return new Promise(resolve => {
+        let value = '';
+        const finish = () => {
+            input.off('keypress', onKeypress);
+            input.setRawMode(Boolean(wasRaw));
+            input.pause();
+            output.write('\n');
+            resolve(value);
+        };
+        const onKeypress = (character, key) => {
+            if (key.ctrl && key.name === 'c')
+                process.exit(130);
+            if (key.name === 'return' || key.name === 'enter')
+                return finish();
+            if (key.name === 'backspace') {
+                value = value.slice(0, -1);
+                return;
+            }
+            if (!key.ctrl && !key.meta && character)
+                value += character;
+        };
+        input.on('keypress', onKeypress);
+    });
+}
+async function handleInitManaged(args) {
+    loadProjectEnvironment();
+    const projectDir = process.cwd();
+    // Check if already managed
+    const managedState = readManagedProjectState(projectDir);
+    if (managedState.applicationId) {
+        console.log('✅ This project is already configured for managed FeltDB\n');
+        console.log(`Application: ${managedState.applicationId}`);
+        console.log(`Namespace:   ${managedState.namespace}`);
+        console.log(`URL:         ${managedState.url}`);
+        if (managedState.revisionId) {
+            console.log(`Revision:    ${managedState.revisionId}`);
+        }
+        console.log('\nTo update credentials, manually edit .env.local and .feltdb/managed.json\n');
+        return;
+    }
+    // Prompt for credentials
+    console.log('☁️  Setting up managed FeltDB for this project\n');
+    const prompt = await import('node:readline/promises').then(m => m.createInterface({ input: process.stdin, output: process.stdout }));
+    const email = args[0] || await prompt.question('Email: ');
+    if (!email)
+        throw new Error('Email is required');
+    const password = args[1] || await promptSecret('Password (8+ characters): ');
+    if (password.length < 8)
+        throw new Error('Password must be at least 8 characters');
+    prompt.close();
+    console.log('\nProvisioning managed account...\n');
+    try {
+        const projectConfig = fs.existsSync(path.join(projectDir, 'feltdb.config.json'))
+            ? JSON.parse(fs.readFileSync(path.join(projectDir, 'feltdb.config.json'), 'utf8'))
+            : {};
+        const namespace = projectConfig.namespace || path.basename(projectDir);
+        const applicationName = projectConfig.name || path.basename(projectDir);
+        const managed = await configureManagedAccount({
+            projectDir,
+            applicationName,
+            namespace,
+            email,
+            password,
+        });
+        console.log(`✓ Managed application: ${managed.application.name}`);
+        console.log(`✓ Namespace: ${managed.application.namespace || namespace}`);
+        console.log(`✓ Environment configured in .env.local\n`);
+        // Ask if user wants to publish the initial revision
+        const publishPrompt = await import('node:readline/promises').then(m => m.createInterface({ input: process.stdin, output: process.stdout }));
+        const shouldPublish = await publishPrompt.question('Publish initial application revision now? [Y/n] ');
+        publishPrompt.close();
+        if (!/^(n|no)$/i.test(shouldPublish.trim())) {
+            console.log('\n🔨 Building and publishing initial revision...\n');
+            const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+            // Run publish
+            await new Promise((resolve, reject) => {
+                const child = spawn(npm, ['run', 'feltdb:publish'], {
+                    cwd: projectDir,
+                    stdio: 'inherit',
+                    env: process.env,
+                });
+                child.once('error', reject);
+                child.once('exit', code => code === 0 ? resolve() : reject(new Error(`feltdb publish exited with status ${code ?? 'unknown'}`)));
+            });
+            console.log('\n✓ Initial revision published\n');
+            // Finalize and verify
+            try {
+                const finalized = await finalizeManagedProvisioning({ projectDir });
+                console.log(`✓ Managed runtime verified at revision ${finalized.revisionId}\n`);
+            }
+            catch (error) {
+                console.log('⚠️  Revision published but verification skipped.\n');
+                console.log('Your application is ready to use. Run: npm run dev\n');
+            }
+        }
+        else {
+            console.log('\n✅ Managed setup complete!\n');
+            console.log('Next steps:');
+            console.log('  1. npm run feltdb:publish (to publish your initial revision)');
+            console.log('  2. npm run dev (to start development)\n');
+        }
+    }
+    catch (error) {
+        throw error;
+    }
+}
 async function handleExplain(args) {
     const flowRef = args[0];
     if (!flowRef || !flowRef.startsWith('flow://')) {
@@ -1127,6 +1248,14 @@ async function handleDev(args) {
             port: authorityPort,
             proposalContext: () => loadLocalDevelopmentContract(projectDir),
             intentObservations: () => collectRepositoryEvidence(projectDir),
+            runtimeContext: {
+                namespace: runtimeNamespace || config.namespace,
+                runtime: config.runtime,
+                storage: config.storage,
+                distributed: Boolean(config.distributed),
+                applicationLifecycle,
+                applicationUrl: appUrl,
+            },
         });
         process.env.VITE_FELTDB_URL = localAuthority.endpoint;
         const connectionsPath = path.join(projectDir, '.feltdb', 'connections.json');
@@ -1277,20 +1406,7 @@ async function handleDev(args) {
     }
     const open = !args.includes('--no-open');
     try {
-        const studio = handleStudio([
-            '--port', studioPort,
-            '--namespace', developmentSession.namespace,
-            '--runtime', developmentSession.runtime,
-            '--workspace-id', developmentSession.workspaceId,
-            '--session-id', developmentSession.sessionId,
-            '--project-id', developmentSession.projectId,
-            '--authority-url', developmentSession.authorityUrl,
-            '--pairing-url', developmentSession.pairingUrl,
-            '--lifecycle', developmentSession.lifecycle,
-            ...(developmentSession.applicationUrl ? ['--app-url', developmentSession.applicationUrl] : []),
-            ...((developmentSession.runtime === 'self-hosted' || developmentSession.runtime === 'managed') ? ['--connect', developmentSession.authorityUrl] : []),
-            '--no-open',
-        ], studioUrl => {
+        const studio = handleStudio(developmentStudioArguments(developmentSession, studioPort), studioUrl => {
             developmentSession.studioUrl = studioUrl;
             transitionDevelopmentSession(developmentSession, 'READY');
             console.log(`\n${developmentSessionSummary(developmentSession)}\n`);
@@ -1640,13 +1756,15 @@ async function handleStudio(args, onReady) {
     else {
         console.log(`Studio Server: http://localhost:${port}\n`);
     }
-    const require = createRequire(import.meta.url);
-    const packageFile = require.resolve('@feltdb/core/package.json');
-    const root = path.join(path.dirname(packageFile), 'dist', 'studio-app');
-    if (!fs.existsSync(path.join(root, 'index.html'))) {
-        console.log('⚠️  Studio application artifacts not found.');
+    let studioArtifact;
+    try {
+        studioArtifact = resolveCanonicalStudioArtifact();
+    }
+    catch (error) {
+        console.log(`⚠️  ${error instanceof Error ? error.message : String(error)}`);
         return;
     }
+    const root = studioArtifact.root;
     const canonicalFlow = path.resolve(process.cwd(), 'feltdb.flow');
     const projectFlow = fs.existsSync(canonicalFlow) ? canonicalFlow : undefined;
     const studioMutationToken = randomBytes(24).toString('hex');
@@ -2019,6 +2137,7 @@ Commands:
   diff [file]           Diff FlowSpec against the last deployed model
   deploy [file]         Validate, version, and deploy FlowSpec
   publish [file]        Build and publish/update a managed application
+  init-managed          Set up managed FeltDB for an existing project
   ai                    Open the canonical interactive local-AI workflow
   ai --dry-run          Open an ephemeral preview-only AI session
   ai model show         Show the selected local or user-provided model
@@ -2068,7 +2187,15 @@ API Key Commands:
   feltdb keys revoke <key-id>
 
 Connection:
-  feltdb connect <url>
+  feltdb connect <url>                    Connect to a running FeltDB server
+
+Managed FeltDB Setup (Existing Projects):
+  feltdb init-managed                     Set up managed FeltDB for an existing project
+                                          Prompts for email and password, provisions resources,
+                                          and optionally publishes the initial revision
+  feltdb init-managed <email> <password>  Non-interactive setup with provided credentials
+
+Development:
   dev         Start development server
   build       Build FeltDB application
   check       Validate configuration
@@ -2102,6 +2229,8 @@ Examples:
   feltdb studio --connect http://localhost:7700
   feltdb server --port 7700 --data ./data
   feltdb keys create --name development
+  feltdb init-managed                     (interactive - prompts for email/password)
+  feltdb init-managed user@example.com secret123
   feltdb connect http://localhost:7700
   feltdb status
   feltdb dev

package/dist/cli/development-session.js

@@ -41,6 +41,22 @@ export function developmentSessionEnvironment(session) {
         VITE_FELTDB_NAMESPACE: session.namespace,
     };
 }
+export function developmentStudioArguments(session, port) {
+    return [
+        '--port', port,
+        '--namespace', session.namespace,
+        '--runtime', session.runtime,
+        '--workspace-id', session.workspaceId,
+        '--session-id', session.sessionId,
+        '--project-id', session.projectId,
+        '--authority-url', session.authorityUrl,
+        '--pairing-url', session.pairingUrl,
+        '--lifecycle', session.lifecycle,
+        ...(session.applicationUrl ? ['--app-url', session.applicationUrl] : []),
+        '--connect', session.authorityUrl,
+        '--no-open',
+    ];
+}
 export function developmentSessionSummary(session) {
     const rows = [
         ['Session', session.sessionId], ['Workspace', session.workspaceId], ['Project', session.projectId], ['Namespace', session.namespace],

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.8.0';
+const VERSION = '0.9.0';
 function prompt(question) {
     const rl = readline.createInterface({
         input: process.stdin,

package/dist/cli/studio-artifact.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+export const CANONICAL_STUDIO_ARTIFACT_CONTRACT = 'feltdb.studio.app.v1';
+// Kept non-contiguous so Core assembly's package-import rewrite cannot mutate
+// this artifact identity from its source package into an import subpath.
+export const CANONICAL_STUDIO_ARTIFACT_SOURCE = '@feltdb/' + 'studio';
+/** Resolve the one Studio application shipped by the installed Core package. */
+export function resolveCanonicalStudioArtifact(options = {}) {
+    const require = createRequire(import.meta.url);
+    const resolvePackage = options.resolvePackage || (specifier => require.resolve(specifier));
+    const packageFile = resolvePackage('@feltdb/core/package.json');
+    const root = path.join(path.dirname(packageFile), 'dist', 'studio-app');
+    const index = path.join(root, 'index.html');
+    const identityFile = path.join(root, 'feltdb-studio.json');
+    if (!fs.existsSync(index) || !fs.existsSync(identityFile)) {
+        throw new Error(`The installed @feltdb/core package does not contain the canonical FeltDB Studio artifact (${root})`);
+    }
+    let identity;
+    try {
+        identity = JSON.parse(fs.readFileSync(identityFile, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`The canonical FeltDB Studio artifact identity is unreadable (${identityFile}): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (identity.contract !== CANONICAL_STUDIO_ARTIFACT_CONTRACT
+        || identity.source !== CANONICAL_STUDIO_ARTIFACT_SOURCE
+        || typeof identity.version !== 'string' || !identity.version
+        || identity.entrypoint !== 'src/main.tsx') {
+        throw new Error(`The installed Studio artifact is not the canonical @feltdb/core/studio application (${identityFile})`);
+    }
+    return { root, index, identity };
+}

package/dist/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"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"}

package/dist/collection.js

@@ -484,10 +484,12 @@ export class Collection {
                 conflictCode: casResult.conflictCode,
             };
         }
-        // Use the item returned by cas() which has the correct incremented version
-        const finalItem = (casResult.item || updated);
-        // CAS operation on backend increments version atomically - update finalItem to match
-        finalItem.__version = casResult.currentVersion;
+        // Use the item returned by cas() if available (file-db, memory-db), otherwise use local copy
+        // When cas() returns the item, it's the authoritative post-commit state from the backend.
+        // When it doesn't, we reconstruct from our local updated object and the returned version.
+        const finalItem = casResult.item
+            ? casResult.item
+            : { ...updated, __version: casResult.currentVersion };
         // Update indexes
         this.indexBackend.updateRecord(String(id), current, finalItem);
         // Emit change through reactive dependency graph

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.9.1';
+export const FELTDB_PACKAGE_VERSION = '0.11.0';
 export const feltdbPackageRange = `^${FELTDB_PACKAGE_VERSION}`;

package/dist/create/server-source/crates/feltdb/src/acceptance_tests.rs

@@ -1460,9 +1460,12 @@ mod convergence_acceptance_tests {
     use crate::FeltDb;
     use serde::{Deserialize, Serialize};
     use std::path::PathBuf;
+    use std::sync::atomic::{AtomicU64, Ordering};
     use std::time::SystemTime;
     use std::time::UNIX_EPOCH;
 
+    static TEMP_FILE_SEQUENCE: AtomicU64 = AtomicU64::new(0);
+
     #[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
     struct Task {
         title: String,
@@ -1475,7 +1478,11 @@ mod convergence_acceptance_tests {
             .duration_since(UNIX_EPOCH)
             .expect("time")
             .as_nanos();
-        std::env::temp_dir().join(format!("feltdb-convergence-test-{nanos}.data"))
+        let sequence = TEMP_FILE_SEQUENCE.fetch_add(1, Ordering::Relaxed);
+        std::env::temp_dir().join(format!(
+            "feltdb-convergence-test-{}-{nanos}-{sequence}.data",
+            std::process::id()
+        ))
     }
 
     /// Test convergence: Two instances make concurrent mutations on same key

package/dist/create/server-source/crates/feltdb/src/application.rs

@@ -1203,6 +1203,22 @@ impl ApplicationStore {
             records: Arc::new(RwLock::new(records)),
         })
     }
+
+    /// Return every tenant scope asserted by canonical application definition
+    /// records for one stable application identity. Callers must reject zero
+    /// or multiple distinct tenants; ordering is never ownership evidence.
+    pub fn tenant_ownership_candidates(&self, application_id: &str) -> Vec<String> {
+        let Ok(records) = self.records.read() else {
+            return Vec::new();
+        };
+        records
+            .revisions
+            .iter()
+            .map(|value| (&value.application_id, &value.tenant_id))
+            .filter(|(candidate, _)| candidate.as_str() == application_id)
+            .map(|(_, tenant)| tenant.clone())
+            .collect()
+    }
     fn persist(&self, r: &RevisionRecords) -> Result<(), String> {
         if let Some(parent) = self.path.parent() {
             fs::create_dir_all(parent).map_err(|e| e.to_string())?;

package/dist/create/server-source/crates/feltdb/src/bin/feltdb_node.rs

@@ -744,11 +744,12 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
                                 link.peer.clone(),
                                 envelope.envelope_id.sequence,
                             );
-                            if link.io.send(message.clone()).await.is_ok() {
-                                delivered.push(link.peer.clone());
-                            } else if connect_with_retry(link, 3).await
-                                && link.io.send(message).await.is_ok()
-                            {
+                            // Forwarding, like re-sending, is an explicit
+                            // recovery operation. Prefer a fresh connection so
+                            // a peer restart cannot leave this write accepted
+                            // by a stale local socket and delivered nowhere.
+                            let _ = connect_with_retry(link, 3).await;
+                            if link.io.send(message).await.is_ok() {
                                 delivered.push(link.peer.clone());
                             }
                         }
@@ -793,19 +794,16 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
                                 link.peer.clone(),
                                 envelope.envelope_id.sequence,
                             );
-                            // The peer this is aimed at may have restarted
-                            // since the link was established, which is the
-                            // whole point of re-sending. Reconnect and retry,
-                            // as `execute-tx` does.
-                            match link.io.send(message.clone()).await {
-                                Ok(()) => delivered.push(link.peer.clone()),
-                                Err(_) => {
-                                    if connect_with_retry(link, 3).await
-                                        && link.io.send(message).await.is_ok()
-                                    {
-                                        delivered.push(link.peer.clone());
-                                    }
-                                }
+                            // Re-sending is the recovery primitive used after a
+                            // peer restart. A write to the old TCP socket can
+                            // still return success after the peer has exited,
+                            // because that only confirms acceptance by the
+                            // local kernel. Try to establish a fresh connection
+                            // first. If the peer never restarted, the connect
+                            // attempt leaves the established stream untouched.
+                            let _ = connect_with_retry(link, 3).await;
+                            if link.io.send(message).await.is_ok() {
+                                delivered.push(link.peer.clone());
                             }
                         }
                         println!(
@@ -961,12 +959,13 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
 
                 let mut delivered = Vec::new();
                 for link in &send_links {
+                    // Acknowledgements are durable recovery evidence and are
+                    // commonly rebroadcast after a peer restart. Refresh the
+                    // connection first for the same reason as explicit
+                    // envelope replay.
+                    let _ = connect_with_retry(link, 3).await;
                     if link.io.send_acknowledgement(ack.clone()).await.is_ok() {
                         delivered.push(link.peer.clone());
-                    } else if connect_with_retry(link, 3).await
-                        && link.io.send_acknowledgement(ack.clone()).await.is_ok()
-                    {
-                        delivered.push(link.peer.clone());
                     }
                 }
                 println!(