vgxness 1.0.3 → 1.0.5

package/dist/memory/sqlite/database.js

@@ -4,6 +4,15 @@ import { fileURLToPath } from 'node:url';
 import Database from 'better-sqlite3';
 const migrationsDirectory = join(dirname(fileURLToPath(import.meta.url)), 'migrations');
 export const sqliteBusyTimeoutMs = 5000;
+const nativeBindingDiagnosticGuidance = 'Detected a likely better-sqlite3 native binding problem. Ensure npm install scripts are enabled, then rebuild or reinstall dependencies for the active Node.js version (for example: npm rebuild better-sqlite3 --ignore-scripts=false).';
+const nativeBindingFailurePatterns = [
+    /better_sqlite3\.node/i,
+    /better-sqlite3/i,
+    /NODE_MODULE_VERSION/i,
+    /ERR_DLOPEN_FAILED/i,
+    /Could not locate the bindings file/i,
+    /compiled against a different Node\.js version/i,
+];
 export class MemoryDatabase {
     connection;
     constructor(connection) {
@@ -29,7 +38,7 @@ export class MemoryDatabase {
                 ok: false,
                 error: {
                     code: 'store_unavailable',
-                    message: `Unable to open local memory store at ${options.path}`,
+                    message: buildMemoryStoreUnavailableMessage(options.path, cause),
                     cause,
                 },
             };
@@ -89,9 +98,42 @@ export class MemoryDatabase {
 export function openMemoryDatabase(options) {
     return MemoryDatabase.open(options);
 }
+export function buildMemoryStoreUnavailableMessage(path, cause) {
+    const message = `Unable to open local memory store at ${path}`;
+    if (!isLikelyBetterSqlite3NativeBindingFailure(cause))
+        return message;
+    return `${message}. ${nativeBindingDiagnosticGuidance}`;
+}
+export function isLikelyBetterSqlite3NativeBindingFailure(cause) {
+    const values = collectDiagnosticValues(cause);
+    return values.some((value) => nativeBindingFailurePatterns.some((pattern) => pattern.test(value)));
+}
 function migrationFailure(message, cause) {
     const error = { code: 'migration_failed', message };
     if (cause !== undefined)
         error.cause = cause;
     return { ok: false, error };
 }
+function collectDiagnosticValues(value, seen = new Set()) {
+    if (value === undefined || value === null)
+        return [];
+    if (typeof value === 'string')
+        return [value];
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint' || typeof value === 'symbol')
+        return [String(value)];
+    if (typeof value !== 'object')
+        return [];
+    if (seen.has(value))
+        return [];
+    seen.add(value);
+    const diagnosticValues = [];
+    const record = value;
+    for (const key of ['code', 'message', 'stack', 'name']) {
+        const property = record[key];
+        if (property !== undefined)
+            diagnosticValues.push(...collectDiagnosticValues(property, seen));
+    }
+    if (record.cause !== undefined)
+        diagnosticValues.push(...collectDiagnosticValues(record.cause, seen));
+    return diagnosticValues;
+}

package/dist/setup/setup-lifecycle-service.js

@@ -74,7 +74,7 @@ function storeStatus(result) {
         status: 'blocked',
         path: '',
         blocker: result.error.message,
-        recovery: 'Run `npm run cli -- doctor` and verify the configured local memory path is writable.',
+        recovery: 'Run `vgx doctor` and verify the configured local memory path is writable.',
     };
 }
 function mcpStatus(result, storeReadiness) {
@@ -178,17 +178,17 @@ function verificationSummary(environment, project, providers, agents, mcp) {
 }
 function nextAction(store, mcp, defaults, providers, project) {
     if (store.status !== 'ready') {
-        return { command: 'npm run cli -- doctor', reason: `Local store is blocked: ${store.blocker ?? 'local store is unavailable'}` };
+        return { command: 'vgx doctor', reason: `Local store is blocked: ${store.blocker ?? 'local store is unavailable'}` };
     }
     if (defaults.status !== 'ready') {
         if (defaults.blocker?.startsWith('No project selected') === true) {
             return {
-                command: 'npm run cli -- dashboard interactive --project <project>',
+                command: 'vgx dashboard interactive --project <project>',
                 reason: defaults.nextAction ?? 'Select a project to verify project-scoped setup checks.',
             };
         }
         return {
-            command: 'npm run cli -- agents seed --scope project',
+            command: 'vgx agents seed --scope project',
             reason: `Default context is blocked: ${defaults.blocker ?? 'default context is unavailable'}`,
         };
     }
@@ -201,8 +201,8 @@ function nextAction(store, mcp, defaults, providers, project) {
             reason: `Provider MCP status is not ready; review the Providers section for provider-specific preview/install guidance (${providerSummary}).`,
         };
     }
-    return { command: 'npm run cli -- runs list', reason: 'Project setup is ready; continue with normal vgxness usage.' };
+    return { command: 'vgx runs list', reason: 'Project setup is ready; continue with normal vgxness usage.' };
 }
 function setupStatusCommand(project) {
-    return project === undefined ? 'npm run cli -- setup status' : `npm run cli -- setup status --project ${project}`;
+    return project === undefined ? 'vgx setup status' : `vgx setup status --project ${project}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vgxness",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "CLI and MCP control plane for guided AI-agent workflows, SDD, memory, and OpenCode setup.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {