@specverse/engines 4.1.28 → 4.1.30

package/dist/libs/instance-factories/applications/templates/generic/main-generator.js

@@ -121,7 +121,7 @@ ${serviceMap}
 ${routeRegistrations}
 
     const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-    const host = process.env.HOST || '0.0.0.0';
+    const host = process.env.HOST || '::';
 
     // Try to start server with automatic port fallback
     let port = preferredPort;
@@ -201,7 +201,7 @@ ${routeRegistrations}
 
 async function start() {
   const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-  const host = process.env.HOST || '0.0.0.0';
+  const host = process.env.HOST || '::';
   const maxAttempts = 10;
 
   // Try to start server with automatic port fallback
@@ -254,7 +254,7 @@ async function bootstrap() {
   });
 
   const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-  const host = process.env.HOST || '0.0.0.0';
+  const host = process.env.HOST || '::';
   const maxAttempts = 10;
 
   // Try to start server with automatic port fallback

package/dist/libs/instance-factories/applications/templates/react/api-client-generator.js

@@ -324,7 +324,14 @@ export async function executeServiceOperation(
 }
 
 /**
- * Transition entity lifecycle state
+ * Transition entity lifecycle state.
+ *
+ * Calls the realized backend's CURVED evolve endpoint
+ * (PATCH /api/{resource}/:id/evolve) \u2014 matches what
+ * engines/libs/instance-factories/controllers/templates/fastify/routes-generator.ts
+ * emits and what scripts/smoke-parity.sh exercises. The older
+ * /transition URL this function used to call never existed on the
+ * realized backend.
  */
 export async function transitionState(
   modelName: string,
@@ -339,8 +346,8 @@ export async function transitionState(
 
   const resource = modelName.toLowerCase() + 's';
   return apiRequest<ApiResponse>(
-    'POST',
-    \`/\${resource}/\${entityId}/transition\`,
+    'PATCH',
+    \`/\${resource}/\${entityId}/evolve\`,
     body
   );
 }
@@ -431,7 +438,9 @@ export async function executeServiceOperation(
 }
 
 /**
- * Transition entity lifecycle state
+ * Transition entity lifecycle state \u2014 realized-backend variant
+ * (used by templates that pre-date the unified CURVED evolve path).
+ * Matches PATCH /api/{resource}/:id/evolve.
  */
 export async function transitionState(
   modelName: string,
@@ -444,9 +453,10 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
+  const resource = modelName.toLowerCase() + 's';
   return apiRequest<ApiResponse>(
-    'POST',
-    \`/lifecycle/\${modelName}/\${entityId}/transition\`,
+    'PATCH',
+    \`/\${resource}/\${entityId}/evolve\`,
     body
   );
 }

package/dist/libs/instance-factories/controllers/templates/fastify/server-generator.js

@@ -62,8 +62,11 @@ fastify.get('/api/runtime/info', async () => ({
   services: ${JSON.stringify(servicesList)}
 }));
 
-${hasEvents ? `// Event history endpoint
-fastify.get('/api/events', async () => eventBus.getHistory());` : ""}
+${hasEvents ? `// Event history endpoint \u2014 runtime introspection, not part of
+// the user's API surface. Lives under /api/runtime/ so it doesn't
+// collide with the auto-generated Event model route (spec models
+// named "Event" produce a GET /api/events of their own).
+fastify.get('/api/runtime/events', async () => eventBus.getHistory());` : ""}
 
 // Register routes
 ${routeImports}
@@ -84,7 +87,12 @@ const start = async () => {
 ${hasEvents ? `    // Register WebSocket bridge for real-time frontend events
     await registerWebSocketBridge(fastify);` : ""}
     const port = parseInt(process.env.PORT || '3000');
-    await fastify.listen({ port, host: '0.0.0.0' });
+    // Listen on :: (IPv6 wildcard) instead of 0.0.0.0 so the server
+    // accepts both IPv6 and IPv4-mapped connections. Node resolves
+    // 'localhost' to ::1 first; if the backend only binds IPv4, the
+    // vite dev-server WS proxy hits ECONNREFUSED on ::1 and doesn't
+    // fall back to 127.0.0.1 cleanly. Binding :: fixes both cases.
+    await fastify.listen({ port, host: '::' });
     console.log(\`Server running at http://localhost:\${port}\`);
     console.log(\`API endpoints: ${modelNames.map((n) => `/api/${n.toLowerCase()}s`).join(", ")}\`);
 ${hasEvents ? `    console.log(\`WebSocket: ws://localhost:\${port}/ws\`);

package/dist/libs/instance-factories/services/templates/prisma/controller-generator.js

@@ -213,39 +213,49 @@ function generateEvolveMethod(model, modelName, modelVar, prismaDelegate, contro
   const validTransitions = lifecycle ? buildTransitionMap(lifecycle) : {};
   return `
   /**
-   * Evolve ${modelName} through lifecycle
+   * Evolve ${modelName} through lifecycle "${lifecycleName}"
    * States: ${states.join(" \u2192 ")}
+   *
+   * Accepts either the client shape { toState, lifecycleName? } or
+   * the direct column shape { ${lifecycleName}: ... }. The frontend
+   * runtime's useTransitionStateMutation always sends the former; the
+   * realized smoke-parity script can send either.
    */
   public async evolve(id: string, data: any): Promise<any> {
-    // Validate input
-    const validationResult = this.validate(data, { operation: 'evolve' });
-    if (!validationResult.valid) {
-      throw new Error(\`Validation failed: \${validationResult.errors.join(', ')}\`);
-    }
-
     // Get current record to check lifecycle state
     const current = await ${prismaDelegate}.findUnique({ where: { id: parseId(id) } });
     if (!current) {
       throw new Error('${modelName} not found');
     }
 
+    // Normalize input: translate client { toState: X } shape to the
+    // lifecycle's actual column name. If the caller already sent the
+    // column directly, keep whatever they sent.
+    const targetLifecycle = data?.lifecycleName || '${lifecycleName}';
+    const targetState = data?.toState ?? data?.state ?? data?.[targetLifecycle];
+    if (!targetState) {
+      throw new Error('evolve requires toState (or ${lifecycleName}) in the request body');
+    }
+
     ${states.length > 0 ? `
-    // Validate lifecycle transition
-    const currentState = (current as any).${lifecycleName};
-    const newState = data.${lifecycleName};
-    if (newState) {
-      const validTransitions: Record<string, string[]> = ${JSON.stringify(validTransitions)};
-      const allowed = validTransitions[currentState] || [];
-      if (!allowed.includes(newState)) {
-        throw new Error(\`Invalid transition: \${currentState} \u2192 \${newState}. Allowed: \${allowed.join(', ') || 'none'}\`);
-      }
+    // Validate lifecycle transition against declared flow
+    const currentState = (current as any)[targetLifecycle];
+    const validTransitions: Record<string, string[]> = ${JSON.stringify(validTransitions)};
+    const allowed = validTransitions[currentState] || [];
+    if (!allowed.includes(targetState)) {
+      throw new Error(\`Invalid transition: \${currentState} \u2192 \${targetState}. Allowed: \${allowed.join(', ') || 'none'}\`);
     }
     ` : ""}
 
+    // Build the Prisma update payload \u2014 only the lifecycle column
+    // changes. Strips toState/lifecycleName/state so Prisma doesn't
+    // reject unknown fields.
+    const updateData: any = { [targetLifecycle]: targetState };
+
     // Update record
     const ${modelVar} = await ${prismaDelegate}.update({
       where: { id: parseId(id) },
-      data${generateIncludeRelationships(model)}
+      data: updateData${generateIncludeRelationships(model)}
     });
 
     // Publish CURED event

package/dist/libs/instance-factories/shared/path-resolver.js

@@ -39,7 +39,7 @@ function getApiBaseUrl(config) {
     return "${VITE_API_BASE_URL}";
   }
   const port = config.serverPort || 3e3;
-  return `http://localhost:${port}`;
+  return `http://127.0.0.1:${port}`;
 }
 function getPathConfig(context) {
   return {

package/libs/instance-factories/applications/templates/generic/main-generator.ts

@@ -154,7 +154,7 @@ ${serviceMap}
 ${routeRegistrations}
 
     const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-    const host = process.env.HOST || '0.0.0.0';
+    const host = process.env.HOST || '::';
 
     // Try to start server with automatic port fallback
     let port = preferredPort;
@@ -238,7 +238,7 @@ ${routeRegistrations}
 
 async function start() {
   const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-  const host = process.env.HOST || '0.0.0.0';
+  const host = process.env.HOST || '::';
   const maxAttempts = 10;
 
   // Try to start server with automatic port fallback
@@ -292,7 +292,7 @@ async function bootstrap() {
   });
 
   const preferredPort = process.env.PORT ? parseInt(process.env.PORT) : 3000;
-  const host = process.env.HOST || '0.0.0.0';
+  const host = process.env.HOST || '::';
   const maxAttempts = 10;
 
   // Try to start server with automatic port fallback

package/libs/instance-factories/applications/templates/react/api-client-generator.ts

@@ -360,7 +360,14 @@ export async function executeServiceOperation(
 }
 
 /**
- * Transition entity lifecycle state
+ * Transition entity lifecycle state.
+ *
+ * Calls the realized backend's CURVED evolve endpoint
+ * (PATCH /api/{resource}/:id/evolve) — matches what
+ * engines/libs/instance-factories/controllers/templates/fastify/routes-generator.ts
+ * emits and what scripts/smoke-parity.sh exercises. The older
+ * /transition URL this function used to call never existed on the
+ * realized backend.
  */
 export async function transitionState(
   modelName: string,
@@ -375,8 +382,8 @@ export async function transitionState(
 
   const resource = modelName.toLowerCase() + 's';
   return apiRequest<ApiResponse>(
-    'POST',
-    \`/\${resource}/\${entityId}/transition\`,
+    'PATCH',
+    \`/\${resource}/\${entityId}/evolve\`,
     body
   );
 }
@@ -468,7 +475,9 @@ export async function executeServiceOperation(
 }
 
 /**
- * Transition entity lifecycle state
+ * Transition entity lifecycle state — realized-backend variant
+ * (used by templates that pre-date the unified CURVED evolve path).
+ * Matches PATCH /api/{resource}/:id/evolve.
  */
 export async function transitionState(
   modelName: string,
@@ -481,9 +490,10 @@ export async function transitionState(
     body.lifecycleName = lifecycleName;
   }
 
+  const resource = modelName.toLowerCase() + 's';
   return apiRequest<ApiResponse>(
-    'POST',
-    \`/lifecycle/\${modelName}/\${entityId}/transition\`,
+    'PATCH',
+    \`/\${resource}/\${entityId}/evolve\`,
     body
   );
 }

package/libs/instance-factories/controllers/templates/fastify/server-generator.ts

@@ -82,8 +82,11 @@ fastify.get('/api/runtime/info', async () => ({
   services: ${JSON.stringify(servicesList)}
 }));
 
-${hasEvents ? `// Event history endpoint
-fastify.get('/api/events', async () => eventBus.getHistory());` : ''}
+${hasEvents ? `// Event history endpoint — runtime introspection, not part of
+// the user's API surface. Lives under /api/runtime/ so it doesn't
+// collide with the auto-generated Event model route (spec models
+// named "Event" produce a GET /api/events of their own).
+fastify.get('/api/runtime/events', async () => eventBus.getHistory());` : ''}
 
 // Register routes
 ${routeImports}
@@ -102,7 +105,12 @@ const start = async () => {
 ${hasEvents ? `    // Register WebSocket bridge for real-time frontend events
     await registerWebSocketBridge(fastify);` : ''}
     const port = parseInt(process.env.PORT || '3000');
-    await fastify.listen({ port, host: '0.0.0.0' });
+    // Listen on :: (IPv6 wildcard) instead of 0.0.0.0 so the server
+    // accepts both IPv6 and IPv4-mapped connections. Node resolves
+    // 'localhost' to ::1 first; if the backend only binds IPv4, the
+    // vite dev-server WS proxy hits ECONNREFUSED on ::1 and doesn't
+    // fall back to 127.0.0.1 cleanly. Binding :: fixes both cases.
+    await fastify.listen({ port, host: '::' });
     console.log(\`Server running at http://localhost:\${port}\`);
     console.log(\`API endpoints: ${modelNames.map((n: string) => `/api/${n.toLowerCase()}s`).join(', ')}\`);
 ${hasEvents ? `    console.log(\`WebSocket: ws://localhost:\${port}/ws\`);

package/libs/instance-factories/services/templates/prisma/controller-generator.ts

@@ -282,39 +282,49 @@ function generateEvolveMethod(model: any, modelName: string, modelVar: string, p
 
   return `
   /**
-   * Evolve ${modelName} through lifecycle
+   * Evolve ${modelName} through lifecycle "${lifecycleName}"
    * States: ${states.join(' → ')}
+   *
+   * Accepts either the client shape { toState, lifecycleName? } or
+   * the direct column shape { ${lifecycleName}: ... }. The frontend
+   * runtime's useTransitionStateMutation always sends the former; the
+   * realized smoke-parity script can send either.
    */
   public async evolve(id: string, data: any): Promise<any> {
-    // Validate input
-    const validationResult = this.validate(data, { operation: 'evolve' });
-    if (!validationResult.valid) {
-      throw new Error(\`Validation failed: \${validationResult.errors.join(', ')}\`);
-    }
-
     // Get current record to check lifecycle state
     const current = await ${prismaDelegate}.findUnique({ where: { id: parseId(id) } });
     if (!current) {
       throw new Error('${modelName} not found');
     }
 
+    // Normalize input: translate client { toState: X } shape to the
+    // lifecycle's actual column name. If the caller already sent the
+    // column directly, keep whatever they sent.
+    const targetLifecycle = data?.lifecycleName || '${lifecycleName}';
+    const targetState = data?.toState ?? data?.state ?? data?.[targetLifecycle];
+    if (!targetState) {
+      throw new Error('evolve requires toState (or ${lifecycleName}) in the request body');
+    }
+
     ${states.length > 0 ? `
-    // Validate lifecycle transition
-    const currentState = (current as any).${lifecycleName};
-    const newState = data.${lifecycleName};
-    if (newState) {
-      const validTransitions: Record<string, string[]> = ${JSON.stringify(validTransitions)};
-      const allowed = validTransitions[currentState] || [];
-      if (!allowed.includes(newState)) {
-        throw new Error(\`Invalid transition: \${currentState} → \${newState}. Allowed: \${allowed.join(', ') || 'none'}\`);
-      }
+    // Validate lifecycle transition against declared flow
+    const currentState = (current as any)[targetLifecycle];
+    const validTransitions: Record<string, string[]> = ${JSON.stringify(validTransitions)};
+    const allowed = validTransitions[currentState] || [];
+    if (!allowed.includes(targetState)) {
+      throw new Error(\`Invalid transition: \${currentState} → \${targetState}. Allowed: \${allowed.join(', ') || 'none'}\`);
     }
     ` : ''}
 
+    // Build the Prisma update payload — only the lifecycle column
+    // changes. Strips toState/lifecycleName/state so Prisma doesn't
+    // reject unknown fields.
+    const updateData: any = { [targetLifecycle]: targetState };
+
     // Update record
     const ${modelVar} = await ${prismaDelegate}.update({
       where: { id: parseId(id) },
-      data${generateIncludeRelationships(model)}
+      data: updateData${generateIncludeRelationships(model)}
     });
 
     // Publish CURED event

package/libs/instance-factories/shared/path-resolver.ts

@@ -93,9 +93,15 @@ export function getApiBaseUrl(config: PathResolverConfig & { apiBaseUrl?: string
     return '${VITE_API_BASE_URL}'; // Environment variable placeholder
   }
 
-  // In monorepo mode, default to local backend
+  // In monorepo mode, default to local backend.
+  // Use explicit 127.0.0.1 (not `localhost`) to avoid Node's
+  // happy-eyeballs IPv6→IPv4 fallback. The vite dev-server WS proxy
+  // doesn't handle that fallback for WebSocket upgrades — it would
+  // try `[::1]:3000`, get ECONNREFUSED if the backend isn't on IPv6,
+  // and log the error instead of retrying on 127.0.0.1. Pinning
+  // 127.0.0.1 in the proxy target sidesteps that entirely.
   const port = (config as any).serverPort || 3000;
-  return `http://localhost:${port}`;
+  return `http://127.0.0.1:${port}`;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/engines",
-  "version": "4.1.28",
+  "version": "4.1.30",
   "description": "SpecVerse toolchain \u2014 parser, inference, realize, generators, AI, registry",
   "type": "module",
   "main": "dist/index.js",

package/dist/libs/instance-factories/tools/templates/vscode/vscode-extension-generator.js.bak

@@ -1,244 +0,0 @@
-import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, copyFileSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-const __generatorDir = dirname(fileURLToPath(import.meta.url));
-function generateVSCodeExtension(context) {
-  const { spec, outputDir } = context;
-  const extensionDir = join(outputDir || ".", "tools", "vscode-extension");
-  if (!existsSync(extensionDir)) mkdirSync(extensionDir, { recursive: true });
-  const distribution = extractDistribution(spec);
-  let cliCommands = [];
-  if (distribution?.commands) {
-    cliCommands = distribution.commands.map((cmd) => {
-      const parts = (cmd.from || cmd.command || "").split(".");
-      const name = parts[parts.length - 1] || "unknown";
-      return {
-        command: `specverse.${name}`,
-        title: cmd.title || `${capitalize(name)}: ${cmd.description || ""}`,
-        category: "SpecVerse"
-      };
-    });
-  }
-  if (cliCommands.length === 0) {
-    cliCommands = extractCLICommands(spec);
-  }
-  if (cliCommands.length === 0) {
-    cliCommands = getStandardCommands();
-  }
-  const entityTypes = extractEntityTypes(spec);
-  const specVersion = distribution?.version || spec?.metadata?.version || spec?.version || "4.0.0";
-  const packageJson = generatePackageJson(cliCommands, entityTypes, specVersion);
-  if (distribution) {
-    if (distribution.displayName) packageJson.displayName = distribution.displayName;
-    if (distribution.publisher) packageJson.publisher = distribution.publisher;
-    if (distribution.description) packageJson.description = distribution.description;
-    if (distribution.languages && distribution.languages.length > 0) {
-      packageJson.contributes.languages = distribution.languages.map((lang) => ({
-        id: lang.id,
-        aliases: lang.aliases || [lang.id],
-        extensions: lang.extensions || [],
-        configuration: `./language-configuration.json`
-      }));
-      packageJson.contributes.grammars = distribution.languages.filter((lang) => lang.grammar).map((lang) => ({
-        language: lang.id,
-        scopeName: lang.grammar,
-        path: `./syntaxes/${lang.id}.tmLanguage.json`
-      }));
-    }
-    if (distribution.themes && distribution.themes.length > 0) {
-      packageJson.contributes.themes = distribution.themes.map((theme) => ({
-        label: theme.name,
-        uiTheme: theme.type === "dark" ? "vs-dark" : theme.type === "light" ? "vs" : "hc-black",
-        path: `./themes/${theme.name.toLowerCase().replace(/\s+/g, "-")}-theme.json`
-      }));
-    }
-  }
-  writeFileSync(join(extensionDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
-  let staticDir = join(__generatorDir, "static");
-  if (!existsSync(staticDir)) {
-    staticDir = join(__generatorDir.replace("/dist/libs/", "/libs/"), "static");
-  }
-  if (existsSync(staticDir)) {
-    copyRecursive(staticDir, extensionDir);
-  }
-  const srcDir = join(extensionDir, "src");
-  if (!existsSync(srcDir)) mkdirSync(srcDir, { recursive: true });
-  const extTs = join(staticDir, "extension.ts");
-  if (existsSync(extTs)) {
-    copyFileSync(extTs, join(srcDir, "extension.ts"));
-  }
-  const buildScript = `const esbuild = require('esbuild');
-esbuild.build({
-  entryPoints: ['src/extension.ts'],
-  bundle: true,
-  outfile: 'dist/extension.js',
-  external: ['vscode'],
-  format: 'cjs',
-  platform: 'node',
-}).catch(() => process.exit(1));
-`;
-  const scriptsDir = join(extensionDir, "scripts");
-  if (!existsSync(scriptsDir)) mkdirSync(scriptsDir, { recursive: true });
-  writeFileSync(join(scriptsDir, "build.js"), buildScript);
-  return `VSCode extension generated in: ${extensionDir}
-  ${cliCommands.length} commands, ${entityTypes.length} entity keywords`;
-}
-function extractDistribution(spec) {
-  const allDistributions = [];
-  if (spec?.distributions) {
-    const entries = Array.isArray(spec.distributions) ? spec.distributions : Object.entries(spec.distributions).map(([name, data]) => ({ name, ...data }));
-    allDistributions.push(...entries);
-  }
-  const components = spec?.components || {};
-  const componentList = Array.isArray(components) ? components : Object.values(components);
-  for (const comp of componentList) {
-    const distributions = comp?.distributions;
-    if (!distributions) continue;
-    const distEntries = Array.isArray(distributions) ? distributions : Object.entries(distributions).map(([name, data]) => ({ name, ...data }));
-    allDistributions.push(...distEntries);
-  }
-  for (const dist of allDistributions) {
-    if (dist.type === "ide") return dist;
-  }
-  return allDistributions.length > 0 ? allDistributions[0] : null;
-}
-function extractCLICommands(spec) {
-  const commands = [];
-  const components = spec?.components || {};
-  const componentList = Array.isArray(components) ? components : Object.entries(components).map(([name, data]) => ({ name, ...data }));
-  for (const comp of componentList) {
-    const cliCommands = comp?.commands;
-    if (!cliCommands) continue;
-    for (const [rootName, rootDef] of Object.entries(cliCommands)) {
-      const subcommands = rootDef?.subcommands || {};
-      for (const [subName, subDef] of Object.entries(subcommands)) {
-        const sub = subDef;
-        const nestedSubs = sub?.subcommands;
-        if (nestedSubs) {
-          for (const [nestedName, nestedDef] of Object.entries(nestedSubs)) {
-            commands.push({
-              command: `specverse.${subName}.${nestedName}`,
-              title: `${capitalize(subName)} ${capitalize(nestedName)}: ${nestedDef.description || ""}`,
-              category: "SpecVerse"
-            });
-          }
-        } else {
-          commands.push({
-            command: `specverse.${subName}`,
-            title: `${capitalize(subName)}: ${sub.description || ""}`,
-            category: "SpecVerse"
-          });
-        }
-      }
-    }
-  }
-  return commands;
-}
-function extractEntityTypes(spec) {
-  const types = /* @__PURE__ */ new Set();
-  const components = spec?.components || [];
-  for (const component of Array.isArray(components) ? components : Object.values(components)) {
-    const comp = component;
-    const models = comp?.models;
-    if (models) {
-      if (Array.isArray(models)) {
-        models.forEach((m) => types.add(m.name));
-      } else {
-        Object.keys(models).forEach((name) => types.add(name));
-      }
-    }
-  }
-  return [...types];
-}
-function generatePackageJson(commands, _entityTypes, specVersion = "1.0.0") {
-  return {
-    name: "specverse",
-    displayName: "SpecVerse",
-    description: "SpecVerse specification language support \u2014 syntax highlighting, validation, IntelliSense",
-    version: specVersion,
-    publisher: "specverse",
-    engines: { vscode: "^1.80.0" },
-    categories: ["Programming Languages", "Linters", "Snippets"],
-    activationEvents: ["onLanguage:specverse"],
-    main: "./dist/extension.js",
-    contributes: {
-      languages: [{
-        id: "specverse",
-        aliases: ["SpecVerse", "specly"],
-        extensions: [".specly", ".specverse"],
-        configuration: "./language-configuration.json"
-      }],
-      grammars: [{
-        language: "specverse",
-        scopeName: "source.specverse",
-        path: "./syntaxes/specverse.tmLanguage.json"
-      }],
-      jsonValidation: [{
-        fileMatch: ["*.specly", "*.specverse"],
-        url: "./schemas/specverse-v3-schema.json"
-      }],
-      themes: [
-        { label: "SpecVerse Dark", uiTheme: "vs-dark", path: "./themes/specverse-complete-theme.json" },
-        { label: "SpecVerse Basic", uiTheme: "vs-dark", path: "./themes/specverse-basic-theme.json" }
-      ],
-      commands: commands.map((c) => ({
-        command: c.command,
-        title: c.title,
-        category: c.category
-      }))
-    },
-    scripts: {
-      "vscode:prepublish": "npm run build",
-      build: "node scripts/build.js",
-      package: "npx @vscode/vsce package"
-    },
-    devDependencies: {
-      "@types/vscode": "^1.80.0",
-      "@vscode/vsce": "^3.0.0",
-      esbuild: "^0.25.0"
-    },
-    overrides: {
-      // Force the patched version of lodash through @vscode/vsce →
-      // @secretlint → @textlint transitive chain (4.17.23 has a
-      // code-injection advisory in `_.template`).
-      lodash: "^4.18.1"
-    }
-  };
-}
-function copyRecursive(src, dest) {
-  for (const entry of readdirSync(src)) {
-    if (entry === "extension.ts") continue;
-    const srcPath = join(src, entry);
-    const destPath = join(dest, entry);
-    if (statSync(srcPath).isDirectory()) {
-      if (!existsSync(destPath)) mkdirSync(destPath, { recursive: true });
-      copyRecursive(srcPath, destPath);
-    } else {
-      copyFileSync(srcPath, destPath);
-    }
-  }
-}
-function getStandardCommands() {
-  return [
-    { command: "specverse.validate", title: "Validate specification", category: "SpecVerse" },
-    { command: "specverse.infer", title: "Infer full architecture", category: "SpecVerse" },
-    { command: "specverse.realize", title: "Generate code from specification", category: "SpecVerse" },
-    { command: "specverse.init", title: "Initialize new project", category: "SpecVerse" },
-    { command: "specverse.gen.diagrams", title: "Generate Mermaid diagrams", category: "SpecVerse" },
-    { command: "specverse.gen.docs", title: "Generate documentation", category: "SpecVerse" },
-    { command: "specverse.gen.uml", title: "Generate UML diagrams", category: "SpecVerse" },
-    { command: "specverse.dev.format", title: "Format .specly file", category: "SpecVerse" },
-    { command: "specverse.dev.watch", title: "Watch and validate on change", category: "SpecVerse" },
-    { command: "specverse.dev.quick", title: "Quick validation", category: "SpecVerse" },
-    { command: "specverse.cache", title: "Manage import cache", category: "SpecVerse" },
-    { command: "specverse.ai.docs", title: "Generate AI implementation prompt", category: "SpecVerse" },
-    { command: "specverse.ai.suggest", title: "Get spec improvement suggestions", category: "SpecVerse" },
-    { command: "specverse.ai.template", title: "Load AI prompt template", category: "SpecVerse" }
-  ];
-}
-function capitalize(str) {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
-export {
-  generateVSCodeExtension as default
-};