@feltdb/core 0.6.11 → 0.6.13

package/dist/cli/application.js

@@ -71,7 +71,7 @@ export function applicationUrlCandidate(project, environment = process.env) {
     if (project.configuredUrl)
         return project.configuredUrl;
     if (project.configuredPort)
-        return `http://127.0.0.1:${project.configuredPort}`;
+        return `http://localhost:${project.configuredPort}/`;
     return undefined;
 }
 export function applicationIsRunning(url, timeoutMs = 750) {

package/dist/cli/browser-opening.js

@@ -0,0 +1,35 @@
+import { spawn } from 'child_process';
+function defaultSpawn(command, args) {
+    return spawn(command, [...args], { detached: true, stdio: 'ignore' });
+}
+export function browserCommand(url, platform = process.platform) {
+    if (platform === 'darwin')
+        return ['open', [url]];
+    if (platform === 'win32')
+        return ['cmd', ['/c', 'start', '', url]];
+    if (platform === 'linux')
+        return ['xdg-open', [url]];
+    return null;
+}
+export function openBrowser(url, spawnBrowser = defaultSpawn) {
+    const command = browserCommand(url);
+    if (!command || !process.stdout.isTTY || process.env.CI)
+        return false;
+    try {
+        const child = spawnBrowser(command[0], command[1]);
+        child.once('error', () => undefined);
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function openApplication(url) {
+    console.log(`🌐 Application: ${url}`);
+    return openBrowser(url);
+}
+export function openStudio(url) {
+    console.log(`🛠️  Studio:     ${url}`);
+    return openBrowser(url);
+}

package/dist/cli/commands.js

@@ -13,6 +13,7 @@ import { discoverWorkspace, ensureWorkspaceGitIgnored, generatePairingToken, per
 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 { openApplication, openStudio } from './browser-opening.js';
 function loadProjectEnvironment(file = path.resolve('.env.local')) {
     if (!fs.existsSync(file))
         return;
@@ -511,7 +512,7 @@ async function handleDev(args) {
     if (args.includes('--help')) {
         console.log('Usage: feltdb dev [--app-url URL] [--studio-port 7701] [--authority-port 7700] [--discovery-port 7799] [--no-open]');
         console.log('\nOptions:');
-        console.log('  --app-url <url>           Application URL (e.g., http://127.0.0.1:3000)');
+        console.log('  --app-url <url>           Application URL (e.g., http://localhost:3000/)');
         console.log('  --studio-port <port>      FeltDB Studio port (default: 7701)');
         console.log('  --authority-port <port>   Authority port (default: 7700)');
         console.log('  --discovery-port <port>   Pairing discovery port (default: 7799)');
@@ -628,7 +629,7 @@ async function handleDev(args) {
         console.log(`Attaching existing FeltDB application (${detectedApplication.feltDBSignals.join(', ')})\n`);
     }
     const requestedStudioPort = Number(args.includes('--studio-port') ? args[args.indexOf('--studio-port') + 1] || '7701' : '7701');
-    const studioPort = String(await availablePort(requestedStudioPort));
+    const studioPort = String(await availablePort(requestedStudioPort, 'localhost'));
     if (studioPort !== String(requestedStudioPort))
         console.log(`⚠ Port ${requestedStudioPort} is busy; using ${studioPort} for Studio.\n`);
     process.env.STUDIO_PORT = studioPort;
@@ -678,7 +679,7 @@ async function handleDev(args) {
         storage: config.storage,
         lifecycle: applicationLifecycle,
         authorityUrl,
-        studioUrl: `http://127.0.0.1:${studioPort}`,
+        studioUrl: `http://localhost:${studioPort}/`,
         pairingUrl: `http://127.0.0.1:${discoveryPort}`,
         applicationUrl: appUrl,
     });
@@ -791,7 +792,7 @@ async function handleDev(args) {
     else {
         console.log('❌ No application URL is configured.\n');
         console.log('Start your application, then run:\n');
-        console.log('  feltdb dev --app-url http://127.0.0.1:<port>\n');
+        console.log('  feltdb dev --app-url http://localhost:<port>/\n');
         console.log('Or set applicationUrl in feltdb.config.json\n');
         console.log('FeltDB workspace is ready at:');
         console.log('Authority: ' + developmentSession.authorityUrl);
@@ -812,10 +813,21 @@ async function handleDev(args) {
             '--lifecycle', developmentSession.lifecycle,
             ...(developmentSession.applicationUrl ? ['--app-url', developmentSession.applicationUrl] : []),
             ...((developmentSession.runtime === 'self-hosted' || developmentSession.runtime === 'managed') ? ['--connect', developmentSession.authorityUrl] : []),
-            ...(open ? [] : ['--no-open']),
-        ], () => {
+            '--no-open',
+        ], studioUrl => {
+            developmentSession.studioUrl = studioUrl;
             transitionDevelopmentSession(developmentSession, 'READY');
             console.log(`\n${developmentSessionSummary(developmentSession)}\n`);
+            if (open) {
+                if (developmentSession.applicationUrl)
+                    openApplication(developmentSession.applicationUrl);
+                openStudio(developmentSession.studioUrl);
+            }
+            else {
+                if (developmentSession.applicationUrl)
+                    console.log(`🌐 Application: ${developmentSession.applicationUrl}`);
+                console.log(`🛠️  Studio:     ${developmentSession.studioUrl}`);
+            }
             transitionDevelopmentSession(developmentSession, 'RUNNING');
         });
         if (managedApplication) {
@@ -1092,8 +1104,8 @@ async function handleStudio(args, onReady) {
         ? args[args.indexOf('--port') + 1] || '7701'
         : '7701';
     const host = args.includes('--host')
-        ? args[args.indexOf('--host') + 1] || '127.0.0.1'
-        : '127.0.0.1';
+        ? args[args.indexOf('--host') + 1] || 'localhost'
+        : 'localhost';
     const open = !args.includes('--no-open');
     const namespace = args.includes('--namespace')
         ? args[args.indexOf('--namespace') + 1] || 'default'
@@ -1223,15 +1235,12 @@ async function handleStudio(args, onReady) {
     if (session.pairingUrl)
         parameters.set('pairing', session.pairingUrl);
     const query = `?${parameters.toString()}`;
-    const studioUrl = `http://127.0.0.1:${port}/${query}`;
+    const studioUrl = `http://localhost:${port}/${query}`;
     console.log(`FeltDB Studio ready at ${studioUrl}`);
-    onReady?.();
+    onReady?.(studioUrl);
     console.log('Use Ctrl+C to stop the server.');
-    if (open) {
-        const command = process.platform === 'darwin' ? ['open', studioUrl] : process.platform === 'win32' ? ['cmd', '/c', 'start', '', studioUrl] : ['xdg-open', studioUrl];
-        const child = spawn(command[0], command.slice(1), { detached: true, stdio: 'ignore' });
-        child.unref();
-    }
+    if (open)
+        openStudio(studioUrl);
     await new Promise(() => { });
 }
 function handleHelp() {

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

package/dist/cli/workspace-integration.js

@@ -176,11 +176,16 @@ export function startPairingDiscoveryServer(token, port = 7799, host = '127.0.0.
                 return;
             }
             response.setHeader('Content-Type', 'application/json; charset=utf-8');
+            const activeRuntime = runtimeSession
+                ? activeRegistrations().sort((left, right) => right.lastSeenAt - left.lastSeenAt)[0]
+                : undefined;
             response.end(JSON.stringify({
                 workspaceId: token.workspaceId,
                 endpoint: authorityEndpoint,
                 expiresAt: token.expiresAt,
                 namespace: token.namespace,
+                sessionId: runtimeSession?.sessionId,
+                runtimeInstanceId: activeRuntime?.runtimeInstanceId,
             }));
         }
         catch (error) {

package/dist/create/cli.js

@@ -11,6 +11,7 @@ import { spawn, spawnSync } from 'child_process';
 import { createProject } from './create.js';
 import { FELTDB_PACKAGE_VERSION } from './package-versions.js';
 import { configureManagedAccount } from './managed-account.js';
+import { localFeltdbExecutable } from './development-handoff.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 function parseArgs(args) {
     const options = {
@@ -235,7 +236,7 @@ Options:
   --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
+  --no-start               Skip automatic feltdb dev startup
   -y, --yes                Use all defaults (non-interactive mode)
   -h, --help               Show this help message
   --version                Show version number
@@ -314,6 +315,7 @@ Learn more: https://github.com/rkendel1/feltdb`);
             agents: options.agents,
             webllm: options.webllm,
             capabilities: options.capabilities,
+            showNextSteps: false,
         });
         projectCreated = true;
         if (options.runtime === 'managed') {
@@ -335,18 +337,18 @@ Learn more: https://github.com/rkendel1/feltdb`);
         }
         if (shouldStart) {
             if (!shouldInstall) {
-                console.log(`Start after installing dependencies:\n  cd ${projectName}\n  npm install\n  npm run dev\n`);
+                console.log(`Start after installing dependencies:\n  cd ${projectName}\n  npm install\n  npm run feltdb:dev\n`);
             }
             else {
                 if (options.runtime === 'self-hosted' && spawnSync('docker', ['version'], { stdio: 'ignore' }).status !== 0) {
                     console.log('\n✅ Project and Docker image definition are ready.');
                     console.log('Docker is not currently running, so startup was skipped.');
-                    console.log(`Start Docker Desktop, then run:\n  cd ${projectName}\n  npm run dev`);
+                    console.log(`Start Docker Desktop, then run:\n  cd ${projectName}\n  npm run feltdb:dev`);
                     console.log('Build the production application image with: docker compose build app');
                 }
                 else {
-                    console.log('\n🚀 Starting the application...\n');
-                    await run(npm, ['run', 'dev'], projectDir);
+                    console.log('\n🚀 Starting your FeltDB development session...\n');
+                    await run(localFeltdbExecutable(projectDir), ['dev'], projectDir);
                 }
             }
         }

package/dist/create/create.js

@@ -87,7 +87,7 @@ export async function createProject(options) {
         application: {
             lifecycle: 'managed',
         },
-        applicationUrl: 'http://127.0.0.1:5173',
+        applicationUrl: 'http://localhost:5173/',
         capabilities: {},
     };
     if (capabilities.includes('search')) {
@@ -1657,7 +1657,7 @@ Configuration is in \`feltdb.config.json\`:
   "application": {
     "lifecycle": "managed"
   },
-  "applicationUrl": "http://127.0.0.1:5173",
+  "applicationUrl": "http://localhost:5173/",
   "capabilities": ["${capabilities}"]
 }
 \`\`\`
@@ -1810,9 +1810,11 @@ MIT
     console.log(`\n✓ Development Workspace initialized`);
     console.log(`  Workspace ID: ${workspaceDiscovery.workspaceId}`);
     console.log(`  Location: ${path.join(projectName, '.feltdb/workspace.json')}`);
-    console.log(`\nNext steps:`);
-    console.log(`  cd ${projectName}`);
-    console.log(`  npm install`);
-    console.log(`  npm run dev`);
-    console.log(`\nYour Development Workspace is ready for use!`);
+    if (options.showNextSteps !== false) {
+        console.log(`\nNext steps:`);
+        console.log(`  cd ${projectName}`);
+        console.log(`  npm install`);
+        console.log(`  npm run feltdb:dev`);
+        console.log(`\nYour Development Workspace is ready for use!`);
+    }
 }

package/dist/create/development-handoff.js

@@ -0,0 +1,4 @@
+import path from 'path';
+export function localFeltdbExecutable(projectDir, platform = process.platform) {
+    return path.join(projectDir, 'node_modules', '.bin', platform === 'win32' ? 'feltdb.cmd' : 'feltdb');
+}

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

@@ -38,9 +38,9 @@ export function generateDockerCompose(config) {
       - --data
       - /data/feltdb.log
       - --allow-origin
-      - http://127.0.0.1:\${APP_PORT:-5173}
+      - http://localhost:\${APP_PORT:-5173}
       - --allow-origin
-      - http://127.0.0.1:\${STUDIO_PORT:-${config.studioPort}}
+      - http://localhost:\${STUDIO_PORT:-${config.studioPort}}
     volumes:
       - feltdb_data:/data
       - ./feltdb.flow:/app/feltdb.flow:ro
@@ -97,7 +97,7 @@ export function generateDockerCompose(config) {
     container_name: \${COMPOSE_PROJECT_NAME}-studio
     environment:
       FELTDB_API_URL: \${FELTDB_PUBLIC_URL:-http://127.0.0.1:${config.port}}
-      APP_URL: \${APP_PUBLIC_URL:-http://127.0.0.1:5173}
+      APP_URL: \${APP_PUBLIC_URL:-http://localhost:5173/}
       FELTDB_NAMESPACE: \${FELTDB_APP_ID:-${config.appId}}
     ports:
       - "\${STUDIO_PORT:-${config.studioPort}}:8000"
@@ -140,7 +140,7 @@ 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}"]
+CMD ["feltdb-server", "--host", "0.0.0.0", "--port", "7700", "--namespace", "${config.appId}", "--data", "/data/feltdb.log", "--allow-origin", "http://localhost:5173", "--allow-origin", "http://localhost:${config.studioPort}"]
 `;
 }
 export function generateStudioDockerfile(config) {

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

package/dist/workspace/browser.d.ts

@@ -16,7 +16,7 @@ export { startRuntimeObservation } from './runtime-observer.js';
 export type { RuntimeObservationOptions, RuntimeObservationHandle } from './runtime-observer.js';
 export { collectEvidence, deriveFinding, candidateSourcePaths, recommendChanges, resolveRelevantSource, verificationContractFor, summarizeDefect, } from './investigation-analysis.js';
 export { RUNTIME_INVESTIGATION_COLLECTION, LEGACY_RUNTIME_INVESTIGATION_COLLECTION, transitionInvestigation, transitionRemediation, transitionVerification, createRemediationContract, classifyWorkspaceActivity, evaluateVerification, agentRemediationHandoff, RUNTIME_INVESTIGATION_INSTRUCTIONS, FELTDB_OBSERVATION_BOUNDARY, } from './runtime-investigation.js';
-export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, BrowserPairingResolution, PairingDiscoveryOptions, ClientInfo, } from './workspace-connection.js';
+export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, BrowserPairingResolution, PairingDiscoveryOptions, ClientInfo, CreateRuntimeInvestigationInput, } from './workspace-connection.js';
 export { connectDevelopmentWorkspace, discoverDevelopmentWorkspace, resolvePairingCode, DevelopmentWorkspaceConnection, } from './workspace-connection.js';
 export { createWorkspaceId, isValidWorkspaceId, createDevelopmentWorkspace, updateWorkspaceTimestamp, discoverWorkspace, persistWorkspaceDiscovery, } from './workspace-identity.js';
 //# sourceMappingURL=browser.d.ts.map

package/dist/workspace/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/workspace/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/workspace/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,EACV,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC"}

package/dist/workspace/index.d.ts

@@ -21,7 +21,7 @@ export { captureRepositoryIdentity, changedPaths, repositoryChanged, trackRemedi
 export { RuntimeInvestigationSupervisor } from './investigation-supervisor.js';
 export type { SupervisorOptions, AgentHandoffArtifact } from './investigation-supervisor.js';
 export { RUNTIME_INVESTIGATION_COLLECTION, LEGACY_RUNTIME_INVESTIGATION_COLLECTION, transitionInvestigation, transitionRemediation, transitionVerification, createRemediationContract, classifyWorkspaceActivity, evaluateVerification, agentRemediationHandoff, RUNTIME_INVESTIGATION_INSTRUCTIONS, FELTDB_OBSERVATION_BOUNDARY, } from './runtime-investigation.js';
-export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, BrowserPairingResolution, PairingDiscoveryOptions, ClientInfo, } from './workspace-connection.js';
+export type { WorkspaceConnectionOptions, WorkspaceMetadata, PairingTokenData, BrowserPairingResolution, PairingDiscoveryOptions, ClientInfo, CreateRuntimeInvestigationInput, } from './workspace-connection.js';
 export { connectDevelopmentWorkspace, discoverDevelopmentWorkspace, resolvePairingCode, DevelopmentWorkspaceConnection, } from './workspace-connection.js';
 export { createWorkspaceId, isValidWorkspaceId, createDevelopmentWorkspace, updateWorkspaceTimestamp, discoverWorkspace, persistWorkspaceDiscovery, } from './workspace-identity.js';
 export { DevelopmentNode, getDevelopmentNode, shutdownDevelopmentNode, } from './development-node.js';

package/dist/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE7F,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAEpH,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,oBAAoB,EACpB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,6BAA6B,EAC7B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE7F,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,UAAU,EACV,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAEpH,OAAO,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACrF,YAAY,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/workspace/runtime-observer.js

@@ -76,8 +76,8 @@ export async function startRuntimeObservation(options) {
             startedAt: input.startedAt,
             completedAt,
             workspaceId: connection.workspaceId,
-            sessionId: options.sessionId,
-            runtimeInstanceId: options.runtimeInstanceId,
+            sessionId: options.sessionId || connection.sessionId,
+            runtimeInstanceId: options.runtimeInstanceId || connection.runtimeInstanceId,
             page: scope.location ? String(scope.location.href) : undefined,
             userAgent: scope.navigator ? String(scope.navigator.userAgent) : undefined,
             correlationId: input.correlationId,
@@ -245,8 +245,8 @@ export async function startRuntimeObservation(options) {
     };
     const handle = {
         workspaceId: connection.workspaceId,
-        sessionId: options.sessionId,
-        runtimeInstanceId: options.runtimeInstanceId,
+        sessionId: options.sessionId || connection.sessionId,
+        runtimeInstanceId: options.runtimeInstanceId || connection.runtimeInstanceId,
         observations: () => [...emitted],
         flush,
         stop: async () => {

package/dist/workspace/workspace-connection.d.ts

@@ -4,8 +4,9 @@
  * Public API for clients (browser, IDE, agent) to discover and connect
  * to a FeltDB Development Workspace.
  */
-import type { ClientType } from './workspace-types.js';
+import type { ClientType, RuntimeInvestigation, RuntimeRequestObservation } from './workspace-types.js';
 import type { WorkspaceEventPayload } from './workspace-types.js';
+import { type RuntimeObservationInput } from './runtime-observation.js';
 export interface WorkspaceConnectionOptions {
     pairingCode?: string;
     workspaceId?: string;
@@ -14,6 +15,10 @@ export interface WorkspaceConnectionOptions {
     clientType?: ClientType;
     endpoint?: string;
     discoveryEndpoint?: string;
+    /** Development-session identity supplied by FeltDB, never derived locally. */
+    sessionId?: string;
+    /** Runtime registration identity supplied by FeltDB, never derived locally. */
+    runtimeInstanceId?: string;
     auth?: {
         token: string;
         apiKey?: string;
@@ -31,12 +36,22 @@ export interface PairingTokenData {
     endpoint?: string;
     authorityEndpoint?: string;
     namespace?: string;
+    sessionId?: string;
+    runtimeInstanceId?: string;
 }
 export interface BrowserPairingResolution {
     workspaceId: string;
     endpoint: string;
     expiresAt: number;
     namespace: string;
+    sessionId?: string;
+    runtimeInstanceId?: string;
+}
+export interface CreateRuntimeInvestigationInput {
+    investigationId?: string;
+    observationId: string;
+    changeId?: string;
+    verificationId?: string;
 }
 export interface PairingDiscoveryOptions {
     endpoint?: string;
@@ -112,6 +127,10 @@ export declare function connectDevelopmentWorkspace(options: WorkspaceConnection
  */
 export declare class DevelopmentWorkspaceConnection {
     workspaceId: string;
+    /** Canonical `feltdb dev` session identity, when supplied by pairing/session configuration. */
+    sessionId?: string;
+    /** Canonical active runtime identity, when supplied by pairing/session configuration. */
+    runtimeInstanceId?: string;
     clientId: string;
     clientType: ClientType;
     private options;
@@ -161,6 +180,19 @@ export declare class DevelopmentWorkspaceConnection {
      * Query entities in workspace collection
      */
     query<T>(collection: string): Promise<T[]>;
+    /** Record a redacted canonical observation under its FeltDB observation id. */
+    recordRuntimeObservation(input: RuntimeObservationInput): Promise<RuntimeRequestObservation>;
+    getRuntimeObservation(observationId: string): Promise<RuntimeRequestObservation | null>;
+    /** Create the canonical shared-workspace investigation for an existing observation. */
+    createRuntimeInvestigation(input: CreateRuntimeInvestigationInput): Promise<RuntimeInvestigation>;
+    getRuntimeInvestigation(investigationId: string): Promise<RuntimeInvestigation | null>;
+    linkRuntimeObservationToInvestigation(observationId: string, investigationId: string): Promise<RuntimeInvestigation>;
+    getRuntimeInvestigationForObservation(observationId: string): Promise<RuntimeInvestigation | null>;
+    linkRuntimeInvestigation(input: {
+        investigationId: string;
+        changeId?: string;
+        verificationId?: string;
+    }): Promise<RuntimeInvestigation>;
     /**
      * Update entity in workspace
      */

package/dist/workspace/workspace-connection.d.ts.map

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

package/dist/workspace/workspace-connection.js

@@ -5,6 +5,8 @@
  * to a FeltDB Development Workspace.
  */
 import { HttpJsDb } from '../http-db.js';
+import { RUNTIME_OBSERVATION_COLLECTION, createRuntimeObservation, } from './runtime-observation.js';
+import { RUNTIME_INVESTIGATION_COLLECTION } from './runtime-investigation.js';
 const DEFAULT_PAIRING_DISCOVERY_ENDPOINT = 'http://127.0.0.1:7799';
 /**
  * Discover workspace from .feltdb/workspace.json
@@ -117,6 +119,8 @@ export async function resolvePairingCode(pairingCode, source = {}) {
 export async function connectDevelopmentWorkspace(options) {
     let workspaceId = options.workspaceId;
     let authorityEndpoint = options.endpoint;
+    let sessionId = options.sessionId;
+    let runtimeInstanceId = options.runtimeInstanceId;
     // Resolve pairing code to workspace ID if provided
     if (options.pairingCode && !workspaceId) {
         if (options.projectDir) {
@@ -128,6 +132,8 @@ export async function connectDevelopmentWorkspace(options) {
             });
             workspaceId = resolution.workspaceId;
             authorityEndpoint = resolution.endpoint;
+            sessionId = resolution.sessionId;
+            runtimeInstanceId = resolution.runtimeInstanceId;
         }
     }
     // Discover workspace if no ID provided
@@ -140,7 +146,7 @@ export async function connectDevelopmentWorkspace(options) {
     }
     const clientId = options.clientId || generateClientId(options.clientType);
     const clientType = options.clientType || 'other';
-    const connection = new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, { ...options, endpoint: authorityEndpoint });
+    const connection = new DevelopmentWorkspaceConnection(workspaceId, clientId, clientType, { ...options, endpoint: authorityEndpoint, sessionId, runtimeInstanceId });
     await connection.connect();
     return connection;
 }
@@ -166,6 +172,8 @@ export class DevelopmentWorkspaceConnection {
         this.transport = null;
         this.unsubscribeEvents = null;
         this.workspaceId = workspaceId;
+        this.sessionId = options.sessionId;
+        this.runtimeInstanceId = options.runtimeInstanceId;
         this.clientId = clientId;
         this.clientType = clientType;
         this.options = options;
@@ -264,7 +272,12 @@ export class DevelopmentWorkspaceConnection {
      * Creates new entity in workspace collection.
      */
     async publish(collection, entity) {
-        const id = generateEntityId();
+        const canonicalId = collection === RUNTIME_OBSERVATION_COLLECTION
+            ? entity.observationId
+            : collection === RUNTIME_INVESTIGATION_COLLECTION
+                ? entity.id
+                : undefined;
+        const id = canonicalId || generateEntityId();
         await this.requireTransport().publish({
             workspaceId: this.workspaceId,
             collection,
@@ -286,6 +299,108 @@ export class DevelopmentWorkspaceConnection {
     async query(collection) {
         return this.requireTransport().query({ workspaceId: this.workspaceId, collection });
     }
+    /** Record a redacted canonical observation under its FeltDB observation id. */
+    async recordRuntimeObservation(input) {
+        if (!this.sessionId || !this.runtimeInstanceId) {
+            throw new Error('Canonical runtime observation requires FeltDB sessionId and runtimeInstanceId');
+        }
+        const observation = createRuntimeObservation({
+            ...input,
+            workspaceId: this.workspaceId,
+            sessionId: this.sessionId,
+            runtimeInstanceId: this.runtimeInstanceId,
+        });
+        await this.requireTransport().publish({
+            workspaceId: this.workspaceId,
+            collection: RUNTIME_OBSERVATION_COLLECTION,
+            entityId: observation.observationId,
+            value: observation,
+            originClientId: this.clientId,
+        });
+        return observation;
+    }
+    async getRuntimeObservation(observationId) {
+        return this.get(RUNTIME_OBSERVATION_COLLECTION, observationId);
+    }
+    /** Create the canonical shared-workspace investigation for an existing observation. */
+    async createRuntimeInvestigation(input) {
+        const observation = await this.getRuntimeObservation(input.observationId);
+        if (!observation)
+            throw new Error(`Runtime observation not found: ${input.observationId}`);
+        const now = Date.now();
+        const investigation = {
+            id: input.investigationId || `inv_${now}_${Math.random().toString(36).slice(2, 9)}`,
+            workspaceId: this.workspaceId,
+            observationId: observation.observationId,
+            observationIds: [observation.observationId],
+            runtimeInstanceId: observation.runtimeInstanceId,
+            sessionId: observation.sessionId,
+            changeId: input.changeId,
+            verificationId: input.verificationId,
+            remediationContractId: '',
+            investigationState: 'OBSERVED',
+            remediationState: 'NOT_STARTED',
+            verificationState: 'NOT_READY',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.requireTransport().publish({
+            workspaceId: this.workspaceId,
+            collection: RUNTIME_INVESTIGATION_COLLECTION,
+            entityId: investigation.id,
+            value: investigation,
+            originClientId: this.clientId,
+        });
+        return investigation;
+    }
+    async getRuntimeInvestigation(investigationId) {
+        return this.get(RUNTIME_INVESTIGATION_COLLECTION, investigationId);
+    }
+    async linkRuntimeObservationToInvestigation(observationId, investigationId) {
+        const [observation, investigation] = await Promise.all([
+            this.getRuntimeObservation(observationId),
+            this.getRuntimeInvestigation(investigationId),
+        ]);
+        if (!observation)
+            throw new Error(`Runtime observation not found: ${observationId}`);
+        if (!investigation)
+            throw new Error(`Runtime investigation not found: ${investigationId}`);
+        if (observation.workspaceId !== this.workspaceId || investigation.workspaceId !== this.workspaceId) {
+            throw new Error('Runtime observation and investigation must belong to the connected workspace');
+        }
+        const owner = await this.getRuntimeInvestigationForObservation(observationId);
+        if (owner && owner.id !== investigationId) {
+            throw new Error(`Runtime observation ${observationId} is already linked to ${owner.id}`);
+        }
+        const observationIds = [...new Set([
+                investigation.observationId,
+                ...(investigation.observationIds || []),
+                observationId,
+            ])];
+        const updatedAt = Date.now();
+        await this.update(RUNTIME_INVESTIGATION_COLLECTION, investigationId, {
+            observationIds,
+            updatedAt,
+        });
+        return { ...investigation, observationIds, updatedAt };
+    }
+    async getRuntimeInvestigationForObservation(observationId) {
+        const investigations = await this.query(RUNTIME_INVESTIGATION_COLLECTION);
+        return investigations.find(investigation => investigation.observationId === observationId
+            || investigation.observationIds?.includes(observationId)) || null;
+    }
+    async linkRuntimeInvestigation(input) {
+        const investigation = await this.getRuntimeInvestigation(input.investigationId);
+        if (!investigation)
+            throw new Error(`Runtime investigation not found: ${input.investigationId}`);
+        const updates = {
+            ...(input.changeId ? { changeId: input.changeId } : {}),
+            ...(input.verificationId ? { verificationId: input.verificationId } : {}),
+            updatedAt: Date.now(),
+        };
+        await this.update(RUNTIME_INVESTIGATION_COLLECTION, investigation.id, updates);
+        return { ...investigation, ...updates };
+    }
     /**
      * Update entity in workspace
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feltdb/core",
-  "version": "0.6.11",
+  "version": "0.6.13",
   "description": "FeltDB Core - Application-facing database with Browser, Local, and Server runtimes. Durable state, reactive APIs.",
   "license": "MIT",
   "type": "module",