♻️ SQLite state foundation with migrations and full metadata parity

package.json

@@ -89,6 +89,7 @@
   "dependencies": {
     "@vizzly-testing/honeydiff": "^0.10.0",
     "ansis": "^4.2.0",
+    "better-sqlite3": "^12.6.2",
     "commander": "^14.0.0",
     "cosmiconfig": "^9.0.0",
     "dotenv": "^17.2.1",

src/cli.js

@@ -53,6 +53,7 @@ import {
   generateStaticReport,
   getReportFileUrl,
 } from './services/static-report-generator.js';
+import { bootstrapLegacyStateIfNeeded } from './tdd/state-store.js';
 import { openBrowser } from './utils/browser.js';
 import { colors } from './utils/colors.js';
 import { loadConfig } from './utils/config-loader.js';
@@ -331,6 +332,11 @@ output.configure({
   json: jsonArg,
 });
 
+bootstrapLegacyStateIfNeeded({
+  workingDir: process.cwd(),
+  output,
+});
+
 const config = await loadConfig(configPath, {});
 const services = createServices(config);
 const pluginServices = createPluginServices(services);

src/commands/tdd-daemon.js

@@ -97,6 +97,16 @@ export async function tddStartCommand(options = {}, globalOptions = {}) {
     // The registry acts as a soft reservation, and findAvailablePort does
     // an actual TCP bind test to minimize this window.
     port = await registry.findAvailablePort();
+    if (port == null) {
+      output.header('tdd', 'local');
+      output.print(
+        `  ${output.statusDot('error')} No available port found after trying 100 ports starting at 47392`
+      );
+      output.blank();
+      output.hint('Free a running TDD server and try again');
+      output.hint('Or specify a port manually: vizzly tdd start --port <port>');
+      return;
+    }
     autoAllocated = port !== 47392;
   }