@jay-framework/jay-stack-cli 0.23.0 → 0.23.1

package/agent-kit-template/plugin/add-menu-guide.md

@@ -44,10 +44,10 @@ Use `reference` for data sources (contracts, categories). Use `stage-place` for
 Controls card size in the browse grid:
 
 ```yaml
-    browse:
-      size: small    # 4 per row — color swatches, small tokens
-      size: medium   # 2 per row — default
-      size: large    # 1 per row — full-width previews
+browse:
+  size: small # 4 per row — color swatches, small tokens
+  size: medium # 2 per row — default
+  size: large # 1 per row — full-width previews
 ```
 
 ## Presentation (preview)
@@ -55,19 +55,19 @@ Controls card size in the browse grid:
 Optional visual preview in the browse grid:
 
 ```yaml
-    # Static image
-    presentation:
-      type: image
-      src: thumbnails/my-plugin/feature.png
-
-    # HTML fragment — must use @scope for CSS isolation
-    presentation:
-      type: html-fragment
-      html: |
-        <div>
-          <style>@scope { .demo { color: blue; } }</style>
-          <div class="demo">Preview content</div>
-        </div>
+# Static image
+presentation:
+  type: image
+  src: thumbnails/my-plugin/feature.png
+
+# HTML fragment — must use @scope for CSS isolation
+presentation:
+  type: html-fragment
+  html: |
+    <div>
+      <style>@scope { .demo { color: blue; } }</style>
+      <div class="demo">Preview content</div>
+    </div>
 ```
 
 Html-fragment rules:

package/dist/index.js

@@ -7,8 +7,8 @@ import path from "path";
 import fs, { promises } from "fs";
 import YAML from "yaml";
 import { getLogger, setDevLogger, createDevLogger } from "@jay-framework/logger";
-import { JAY_IMPORT_RESOLVER, parseJayFile, generateElementDefinitionFile, parseContract, generateElementFile, generateServerElementFile, htmlElementTagNameMap, loadLinkedContract, getLinkedContractDir } from "@jay-framework/compiler-jay-html";
-import { scanPlugins, listContracts, materializeContracts, SetupNeedsAnswerError, discoverPluginsWithSetup, discoverPluginsWithInit, sortPluginsByDependencies, executePluginSetup, executePluginServerInits, runInitCallbacks } from "@jay-framework/stack-server-runtime";
+import { parseJayFile, JAY_IMPORT_RESOLVER, generateElementDefinitionFile, parseContract, generateElementFile, generateServerElementFile, htmlElementTagNameMap, loadLinkedContract, getLinkedContractDir } from "@jay-framework/compiler-jay-html";
+import { scanPlugins, listContracts, materializeContracts, SetupNeedsAnswerError, discoverPluginsWithSetup, sortPluginsByDependencies, discoverPluginsWithInit, executePluginSetup, executePluginServerInits, runInitCallbacks } from "@jay-framework/stack-server-runtime";
 import { listContracts as listContracts2, materializeContracts as materializeContracts2 } from "@jay-framework/stack-server-runtime";
 import { Command } from "commander";
 import chalk from "chalk";
@@ -19,7 +19,7 @@ import { createRequire } from "module";
 import { glob } from "glob";
 import fsSync from "node:fs";
 import { fileURLToPath } from "node:url";
-import { input, confirm, select } from "@inquirer/prompts";
+import { select, confirm, input } from "@inquirer/prompts";
 const DEFAULT_CONFIG = {
   devServer: {
     portRange: [3e3, 3100],
@@ -464,17 +464,13 @@ function collectLocalInterfaces(sourceFile) {
 function collectContractImportedTypes(sourceFile) {
   const contractTypes = /* @__PURE__ */ new Set();
   for (const statement of sourceFile.statements) {
-    if (!u.isImportDeclaration(statement))
-      continue;
+    if (!u.isImportDeclaration(statement)) continue;
     const moduleSpecifier = statement.moduleSpecifier;
-    if (!u.isStringLiteral(moduleSpecifier))
-      continue;
+    if (!u.isStringLiteral(moduleSpecifier)) continue;
     const modulePath = moduleSpecifier.text;
-    if (!modulePath.includes(".jay-contract"))
-      continue;
+    if (!modulePath.includes(".jay-contract")) continue;
     const importClause = statement.importClause;
-    if (!importClause)
-      continue;
+    if (!importClause) continue;
     const namedBindings = importClause.namedBindings;
     if (namedBindings && u.isNamedImports(namedBindings)) {
       for (const element of namedBindings.elements) {
@@ -510,8 +506,7 @@ function visitNode(node, result) {
       }
       if (node.arguments.length > 0) {
         const arg = node.arguments[0];
-        if (u.isIdentifier(arg))
-          ;
+        if (u.isIdentifier(arg)) ;
       }
     }
   }
@@ -533,10 +528,8 @@ function extractTypeNames(typeNode) {
   return [];
 }
 function checkPropsConsistency(propsTypeName, localInterfaces, contractImportedTypes, contract, contractName, contractPath, sourcePath, errors, warnings) {
-  if (FRAMEWORK_PROP_TYPES.has(propsTypeName))
-    return;
-  if (contractImportedTypes.has(propsTypeName))
-    return;
+  if (FRAMEWORK_PROP_TYPES.has(propsTypeName)) return;
+  if (contractImportedTypes.has(propsTypeName)) return;
   const prefix = `[${contractName}]`;
   const iface = localInterfaces.get(propsTypeName);
   if (!iface) {
@@ -551,8 +544,7 @@ function checkPropsConsistency(propsTypeName, localInterfaces, contractImportedT
     return;
   }
   const ownProperties = iface.properties;
-  if (ownProperties.length === 0)
-    return;
+  if (ownProperties.length === 0) return;
   if (!contract.props || contract.props.length === 0) {
     errors.push({
       type: "contract-invalid",
@@ -596,10 +588,8 @@ function checkParamsConsistency(paramsTypeNames, localInterfaces, contractImport
       suggestion: `Add a params section to the contract (e.g., params: { slug: string })`
     });
     for (const typeName of paramsTypeNames) {
-      if (FRAMEWORK_PROP_TYPES.has(typeName))
-        continue;
-      if (contractImportedTypes.has(typeName))
-        continue;
+      if (FRAMEWORK_PROP_TYPES.has(typeName)) continue;
+      if (contractImportedTypes.has(typeName)) continue;
       const iface = localInterfaces.get(typeName);
       if (iface) {
         const ownProps = iface.properties;
@@ -612,13 +602,10 @@ function checkParamsConsistency(paramsTypeNames, localInterfaces, contractImport
     return;
   }
   for (const typeName of paramsTypeNames) {
-    if (FRAMEWORK_PROP_TYPES.has(typeName))
-      continue;
-    if (contractImportedTypes.has(typeName))
-      continue;
+    if (FRAMEWORK_PROP_TYPES.has(typeName)) continue;
+    if (contractImportedTypes.has(typeName)) continue;
     const iface = localInterfaces.get(typeName);
-    if (!iface)
-      continue;
+    if (!iface) continue;
     const ownProperties = iface.properties;
     const contractParamNames = new Set(contract.params.map((p) => p.name));
     for (const prop of ownProperties) {
@@ -710,16 +697,13 @@ function requiredString(obj, field, itemPath, errors, code) {
 }
 function optionalString(obj, field) {
   const value = obj[field];
-  if (value === void 0)
-    return void 0;
-  if (typeof value !== "string")
-    return void 0;
+  if (value === void 0) return void 0;
+  if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
 function validateInteraction(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -743,8 +727,7 @@ function validateInteraction(raw, itemPath, errors) {
   };
 }
 function validatePresentation(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -764,14 +747,12 @@ function validatePresentation(raw, itemPath, errors) {
   }
   if (type === "image") {
     const src = requiredString(raw, "src", itemPath, errors, "presentation-missing-src");
-    if (!src)
-      return void 0;
+    if (!src) return void 0;
     return { type: "image", src };
   }
   if (type === "gif") {
     const src = requiredString(raw, "src", itemPath, errors, "presentation-missing-src");
-    if (!src)
-      return void 0;
+    if (!src) return void 0;
     return {
       type: "gif",
       src,
@@ -816,8 +797,7 @@ function validatePresentation(raw, itemPath, errors) {
 }
 const BROWSE_SIZES = /* @__PURE__ */ new Set(["large", "medium", "small"]);
 function validateBrowse(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!isRecord$1(raw)) {
     errors.push({
       path: itemPath,
@@ -841,8 +821,7 @@ function validateBrowse(raw, itemPath, errors) {
   return { size: sizeRaw };
 }
 function validateFolderPath(raw, itemPath, errors) {
-  if (raw === void 0)
-    return void 0;
+  if (raw === void 0) return void 0;
   if (!Array.isArray(raw)) {
     errors.push({
       path: `${itemPath}.folderPath`,
@@ -980,8 +959,7 @@ function validateAddMenuCatalogFile(raw, sourcePath) {
   raw.items.forEach((entry, index) => {
     const result = validateAddMenuItem(entry, `${sourcePath}.items[${index}]`);
     errors.push(...result.errors);
-    if (result.item)
-      items.push(result.item);
+    if (result.item) items.push(result.item);
   });
   if (items.length === 0 && errors.length > 0) {
     return { file: null, errors };
@@ -989,11 +967,9 @@ function validateAddMenuCatalogFile(raw, sourcePath) {
   return { file: { items }, errors };
 }
 function normalizeAddMenuPresentation(item) {
-  if (item.presentation)
-    return item.presentation;
+  if (item.presentation) return item.presentation;
   const thumbnail = item.thumbnail?.trim();
-  if (!thumbnail)
-    return void 0;
+  if (!thumbnail) return void 0;
   if (/\.gif$/i.test(thumbnail)) {
     return { type: "gif", src: thumbnail };
   }
@@ -1004,15 +980,12 @@ function normalizeAddMenuBrowseSize(item) {
 }
 function hasSingleRootDiv(html) {
   const trimmed = html.trim();
-  if (!trimmed.startsWith("<div"))
-    return false;
+  if (!trimmed.startsWith("<div")) return false;
   const openMatch = trimmed.match(/^<div\b[^>]*>/i);
-  if (!openMatch)
-    return false;
+  if (!openMatch) return false;
   const afterOpen = trimmed.slice(openMatch[0].length);
   const closeIdx = afterOpen.lastIndexOf("</div>");
-  if (closeIdx < 0)
-    return false;
+  if (closeIdx < 0) return false;
   const tail = afterOpen.slice(closeIdx + "</div>".length).trim();
   return tail.length === 0;
 }
@@ -1088,8 +1061,7 @@ function lintHtmlFragment(item, sourcePath) {
 }
 function lintGifPoster(item, sourcePath) {
   const presentation = normalizeAddMenuPresentation(item);
-  if (presentation?.type !== "gif" || presentation.poster?.trim())
-    return [];
+  if (presentation?.type !== "gif" || presentation.poster?.trim()) return [];
   return [
     catalogWarning(
       "gif-missing-poster",
@@ -1100,10 +1072,8 @@ function lintGifPoster(item, sourcePath) {
   ];
 }
 function lintBrowseLargeWithoutPresentation(item, sourcePath) {
-  if (normalizeAddMenuBrowseSize(item) !== "large")
-    return [];
-  if (normalizeAddMenuPresentation(item))
-    return [];
+  if (normalizeAddMenuBrowseSize(item) !== "large") return [];
+  if (normalizeAddMenuPresentation(item)) return [];
   return [
     catalogWarning(
       "browse-large-without-presentation",
@@ -1176,8 +1146,7 @@ function resolveModulePath$1(basePath) {
   return void 0;
 }
 function collectTypeScriptFiles(dir, depth = 0) {
-  if (depth > 4)
-    return [];
+  if (depth > 4) return [];
   const entries = fs.readdirSync(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
@@ -1196,8 +1165,7 @@ function resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage) {
   }
   const searchRoots = isNpmPackage ? [path.join(pluginPath, "lib"), path.join(pluginPath, "dist")] : [pluginPath];
   for (const root of searchRoots) {
-    if (!fs.existsSync(root))
-      continue;
+    if (!fs.existsSync(root)) continue;
     for (const file of collectTypeScriptFiles(root)) {
       const content = fs.readFileSync(file, "utf-8");
       const definesHandler = new RegExp(
@@ -1217,8 +1185,7 @@ function resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage) {
       if (reExportMatch) {
         const importSpec = reExportMatch[1].replace(/\.js$/, "");
         const resolved = resolveModulePath$1(path.resolve(path.dirname(file), importSpec));
-        if (resolved)
-          return resolved;
+        if (resolved) return resolved;
       }
     }
   }
@@ -1228,8 +1195,7 @@ function extractBalancedBlock(source, openBraceIndex) {
   let depth = 0;
   for (let index = openBraceIndex; index < source.length; index++) {
     const char = source[index];
-    if (char === "{")
-      depth++;
+    if (char === "{") depth++;
     else if (char === "}") {
       depth--;
       if (depth === 0) {
@@ -1249,8 +1215,7 @@ function findFunctionBodyOpenBrace(source, searchFrom) {
   if (parenMatch?.index !== void 0) {
     candidates.push(searchFrom + parenMatch.index + parenMatch[0].length - 1);
   }
-  if (candidates.length === 0)
-    return -1;
+  if (candidates.length === 0) return -1;
   return Math.min(...candidates);
 }
 function extractFunctionBody(source, functionName) {
@@ -1267,11 +1232,9 @@ function extractFunctionBody(source, functionName) {
   ];
   for (const pattern of patterns) {
     const match = pattern.exec(source);
-    if (!match)
-      continue;
+    if (!match) continue;
     const braceIndex = findFunctionBodyOpenBrace(source, match.index);
-    if (braceIndex === -1)
-      continue;
+    if (braceIndex === -1) continue;
     return extractBalancedBlock(source, braceIndex);
   }
   return null;
@@ -1284,11 +1247,9 @@ function extractDefaultExportFunctionBody(source) {
   ];
   for (const pattern of patterns) {
     const match = pattern.exec(source);
-    if (!match)
-      continue;
+    if (!match) continue;
     const braceIndex = findFunctionBodyOpenBrace(source, match.index);
-    if (braceIndex === -1)
-      continue;
+    if (braceIndex === -1) continue;
     return extractBalancedBlock(source, braceIndex);
   }
   return null;
@@ -1298,8 +1259,7 @@ function handlerBodyWritesAddMenuCatalog(body) {
 }
 function resolveSetupHandlerFunctionBody(pluginPath, handlerRef, isNpmPackage) {
   const sourceFile = resolveHandlerSourceFile(pluginPath, handlerRef, isNpmPackage);
-  if (!sourceFile)
-    return null;
+  if (!sourceFile) return null;
   const source = fs.readFileSync(sourceFile, "utf-8");
   if (isRelativeHandlerRef(handlerRef)) {
     return extractDefaultExportFunctionBody(source) ?? extractFunctionBody(source, "setup") ?? extractFunctionBody(source, handlerRef);
@@ -1307,8 +1267,7 @@ function resolveSetupHandlerFunctionBody(pluginPath, handlerRef, isNpmPackage) {
   return extractFunctionBody(source, handlerRef);
 }
 function suggestionForCode(code) {
-  if (!code)
-    return `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
+  if (!code) return `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
   return ADD_MENU_VALIDATION_SUGGESTIONS[code] ?? `See ${CONTRIBUTOR_GUIDE} for schema and validation rules`;
 }
 function mapSchemaError$1(error, catalogPath) {
@@ -1338,8 +1297,7 @@ function pluginShipsAddMenuCatalog(context) {
   );
 }
 function validateAddMenuAgentKitHandler(context, result) {
-  if (!pluginShipsAddMenuCatalog(context))
-    return;
+  if (!pluginShipsAddMenuCatalog(context)) return;
   const agentKitHandler = context.manifest.agentkit;
   if (!agentKitHandler) {
     result.warnings.push({
@@ -1351,15 +1309,13 @@ function validateAddMenuAgentKitHandler(context, result) {
     });
   }
   const setupHandler = typeof context.manifest.setup === "string" ? context.manifest.setup : void 0;
-  if (!setupHandler)
-    return;
+  if (!setupHandler) return;
   const setupBody = resolveSetupHandlerFunctionBody(
     context.pluginPath,
     setupHandler,
     context.isNpmPackage
   );
-  if (!setupBody || !handlerBodyWritesAddMenuCatalog(setupBody))
-    return;
+  if (!setupBody || !handlerBodyWritesAddMenuCatalog(setupBody)) return;
   result.warnings.push({
     type: "add-menu-catalog",
     code: "add-menu-legacy-setup-handler",
@@ -1401,8 +1357,7 @@ async function validateAddMenuCatalog(context, result) {
   validateAddMenuAgentKitHandler(context, result);
   for (const relPath of ADD_MENU_CATALOG_REL_PATHS) {
     const catalogPath = path.join(context.pluginPath, relPath);
-    if (!fs.existsSync(catalogPath))
-      continue;
+    if (!fs.existsSync(catalogPath)) continue;
     await validateAddMenuCatalogFileAtPath(catalogPath, relPath, result);
   }
 }
@@ -2026,16 +1981,14 @@ async function validateSchema(context, result) {
 }
 function checkExportExists(exportName, context) {
   const packageJsonPath = path.join(context.pluginPath, "package.json");
-  if (!fs.existsSync(packageJsonPath))
-    return true;
+  if (!fs.existsSync(packageJsonPath)) return true;
   let mainPath;
   try {
     const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
     if (packageJson.exports?.["."]) {
       const entry = packageJson.exports["."];
       const entryPath = typeof entry === "string" ? entry : entry.default || entry.import;
-      if (entryPath)
-        mainPath = path.join(context.pluginPath, entryPath);
+      if (entryPath) mainPath = path.join(context.pluginPath, entryPath);
     }
     if (!mainPath && packageJson.main) {
       mainPath = path.join(context.pluginPath, packageJson.main);
@@ -2043,8 +1996,7 @@ function checkExportExists(exportName, context) {
   } catch {
     return true;
   }
-  if (!mainPath || !fs.existsSync(mainPath))
-    return true;
+  if (!mainPath || !fs.existsSync(mainPath)) return true;
   try {
     const content = fs.readFileSync(mainPath, "utf-8");
     const patterns = [
@@ -2104,8 +2056,7 @@ function resolveContractFile(contractSpec, context) {
             const resolvedPath = typeof exportValue === "string" ? exportValue : exportValue.default || exportValue.import || exportValue.require;
             if (resolvedPath) {
               const fullPath = path.join(context.pluginPath, resolvedPath);
-              if (fs.existsSync(fullPath))
-                return fullPath;
+              if (fs.existsSync(fullPath)) return fullPath;
             }
           }
         }
@@ -2114,8 +2065,7 @@ function resolveContractFile(contractSpec, context) {
     }
     for (const dir of ["dist", "lib", ""]) {
       const candidate = path.join(context.pluginPath, dir, contractSpec);
-      if (fs.existsSync(candidate))
-        return candidate;
+      if (fs.existsSync(candidate)) return candidate;
     }
     return void 0;
   } else {
@@ -2203,8 +2153,7 @@ function hasExportModifier(node) {
 function resolveModulePath(basePath) {
   for (const ext of ["", ".ts", ".js", "/index.ts", "/index.js"]) {
     const candidate = basePath + ext;
-    if (fs.existsSync(candidate))
-      return candidate;
+    if (fs.existsSync(candidate)) return candidate;
   }
   return void 0;
 }
@@ -2214,10 +2163,8 @@ function resolveComponentSourcePath(componentName, context) {
   const entryFile = resolveModulePath(entryBase);
   const libEntryFile = !entryFile ? resolveModulePath(path.join(context.pluginPath, "lib", modulePath)) : void 0;
   const sourceEntry = entryFile || libEntryFile;
-  if (!sourceEntry)
-    return void 0;
-  if (!sourceEntry.endsWith(".ts"))
-    return void 0;
+  if (!sourceEntry) return void 0;
+  if (!sourceEntry.endsWith(".ts")) return void 0;
   let sourceCode;
   try {
     sourceCode = fs.readFileSync(sourceEntry, "utf-8");
@@ -2233,12 +2180,9 @@ function resolveComponentSourcePath(componentName, context) {
   );
   const starReexportModules = [];
   for (const statement of sourceFile.statements) {
-    if (!u.isExportDeclaration(statement))
-      continue;
-    if (!statement.moduleSpecifier)
-      continue;
-    if (!u.isStringLiteral(statement.moduleSpecifier))
-      continue;
+    if (!u.isExportDeclaration(statement)) continue;
+    if (!statement.moduleSpecifier) continue;
+    if (!u.isStringLiteral(statement.moduleSpecifier)) continue;
     const moduleSpec = statement.moduleSpecifier.text;
     const exportClause = statement.exportClause;
     if (!exportClause) {
@@ -2256,12 +2200,10 @@ function resolveComponentSourcePath(componentName, context) {
     }
   }
   for (const moduleSpec of starReexportModules) {
-    if (!moduleSpec.startsWith("."))
-      continue;
+    if (!moduleSpec.startsWith(".")) continue;
     const resolvedBase = path.resolve(path.dirname(sourceEntry), moduleSpec);
     const resolvedPath = resolveModulePath(resolvedBase);
-    if (!resolvedPath || !resolvedPath.endsWith(".ts"))
-      continue;
+    if (!resolvedPath || !resolvedPath.endsWith(".ts")) continue;
     try {
       const modSource = fs.readFileSync(resolvedPath, "utf-8");
       const modFile = u.createSourceFile(
@@ -2294,16 +2236,12 @@ function resolveContractPath(contract, context) {
 }
 async function checkComponentContractConsistency(contract, context, result) {
   const componentName = contract.component;
-  if (!componentName)
-    return;
+  if (!componentName) return;
   const sourcePath = resolveComponentSourcePath(componentName, context);
-  if (!sourcePath)
-    return;
-  if (!sourcePath.endsWith(".ts"))
-    return;
+  if (!sourcePath) return;
+  if (!sourcePath.endsWith(".ts")) return;
   const contractPath = resolveContractPath(contract, context);
-  if (!contractPath)
-    return;
+  if (!contractPath) return;
   let contractContent;
   try {
     contractContent = await fs.promises.readFile(contractPath, "utf-8");
@@ -2311,8 +2249,7 @@ async function checkComponentContractConsistency(contract, context, result) {
     return;
   }
   const parsed = parseContract(contractContent, path.basename(contractPath));
-  if (parsed.validations.length > 0)
-    return;
+  if (parsed.validations.length > 0) return;
   let sourceCode;
   try {
     sourceCode = await fs.promises.readFile(sourcePath, "utf-8");
@@ -2431,8 +2368,7 @@ async function validatePackageJson(context, result) {
 }
 async function validateDynamicContracts(context, result) {
   const { dynamic_contracts } = context.manifest;
-  if (!dynamic_contracts)
-    return;
+  if (!dynamic_contracts) return;
   const dynamicConfigs = Array.isArray(dynamic_contracts) ? dynamic_contracts : [dynamic_contracts];
   for (const config of dynamicConfigs) {
     const prefix = config.prefix || "(unknown)";
@@ -2511,8 +2447,7 @@ function extractExpressions(text) {
 function extractTagPath(expr) {
   let cleaned = expr.replace(/^!/, "").trim();
   cleaned = cleaned.split(/\s*[!=]==?\s*/)[0].trim();
-  if (cleaned === "." || cleaned === "")
-    return null;
+  if (cleaned === "." || cleaned === "") return null;
   if (/^[a-zA-Z_$][a-zA-Z0-9_$]*(\.[a-zA-Z_$][a-zA-Z0-9_$]*)*$/.test(cleaned)) {
     return cleaned;
   }
@@ -2611,8 +2546,7 @@ function collectUsedTags(jayHtml) {
     const ifVal = element.getAttribute?.("if");
     if (ifVal) {
       const ifPath = extractTagPath(ifVal);
-      if (ifPath)
-        resolvePath(ifPath, scopes);
+      if (ifPath) resolvePath(ifPath, scopes);
     }
     const refVal = element.getAttribute?.("ref");
     if (refVal) {
@@ -2620,12 +2554,10 @@ function collectUsedTags(jayHtml) {
     }
     const attrs = element.attributes ?? {};
     for (const [name, value] of Object.entries(attrs)) {
-      if (SKIP_ATTRS.has(name))
-        continue;
+      if (SKIP_ATTRS.has(name)) continue;
       for (const expr of extractExpressions(value)) {
         const p = extractTagPath(expr);
-        if (p)
-          resolvePath(p, scopes);
+        if (p) resolvePath(p, scopes);
       }
     }
     for (const child of element.childNodes ?? []) {
@@ -2633,8 +2565,7 @@ function collectUsedTags(jayHtml) {
         const text = child.rawText ?? child.text ?? "";
         for (const expr of extractExpressions(text)) {
           const p = extractTagPath(expr);
-          if (p)
-            resolvePath(p, childScopes);
+          if (p) resolvePath(p, childScopes);
         }
       } else if (child.nodeType === 1) {
         walkElement(child, childScopes);
@@ -2647,14 +2578,12 @@ function collectUsedTags(jayHtml) {
 function analyzeTagCoverage(jayHtml, file) {
   const imports = jayHtml.headlessImports;
   const withContracts = imports.filter((imp) => imp.contract);
-  if (withContracts.length === 0)
-    return null;
+  if (withContracts.length === 0) return null;
   const usedTagsMap = collectUsedTags(jayHtml);
   const contracts = [];
   for (let i = 0; i < imports.length; i++) {
     const imp = imports[i];
-    if (!imp.contract)
-      continue;
+    if (!imp.contract) continue;
     const allTags = flattenContractTags(imp.contract.tags);
     const usedSet = usedTagsMap.get(i) ?? /* @__PURE__ */ new Set();
     const expanded = new Set(usedSet);
@@ -2683,12 +2612,9 @@ function resolveContractTag(contract, tagPath) {
   let tags = contract.tags;
   for (let i = 0; i < segments.length; i++) {
     const tag = tags.find((t) => t.tag === segments[i]);
-    if (!tag)
-      return void 0;
-    if (i === segments.length - 1)
-      return tag;
-    if (!tag.tags)
-      return void 0;
+    if (!tag) return void 0;
+    if (i === segments.length - 1) return tag;
+    if (!tag.tags) return void 0;
     tags = tag.tags;
   }
   return void 0;
@@ -2720,17 +2646,13 @@ function checkRefElementTypes(jayHtml, file) {
       importIndex = scope.importIndex;
       tagPath = scope.prefix ? `${scope.prefix}.${refPath}` : refPath;
     }
-    if (importIndex === void 0)
-      return;
+    if (importIndex === void 0) return;
     const imp = imports[importIndex];
-    if (!imp.contract)
-      return;
+    if (!imp.contract) return;
     const contractTag = resolveContractTag(imp.contract, tagPath);
-    if (!contractTag || !contractTag.elementType)
-      return;
+    if (!contractTag || !contractTag.elementType) return;
     const contractTypes = contractTag.elementType;
-    if (contractTypes.includes("HTMLElement"))
-      return;
+    if (contractTypes.includes("HTMLElement")) return;
     if (!contractTypes.includes(ref.actualType)) {
       const label = imp.key ? `${imp.key}.${tagPath}` : tagPath;
       warnings.push(
@@ -2840,8 +2762,7 @@ function checkRouteParams(parsedFile, filePath, pagesBase) {
       collectParams(imp.contract.params);
     }
   }
-  if (requiredParams.size === 0)
-    return [];
+  if (requiredParams.size === 0) return [];
   const routeParams = extractRouteParams(filePath, pagesBase);
   const headlessProps = extractHeadlessPropsParamNames(parsedFile);
   const availableParams = /* @__PURE__ */ new Set([...routeParams, ...headlessProps]);
@@ -2857,11 +2778,9 @@ function checkRouteParams(parsedFile, filePath, pagesBase) {
 }
 function checkRouteToContractParams(parsedFile, filePath, pagesBase) {
   const routeParams = extractRouteParams(filePath, pagesBase);
-  if (routeParams.size === 0)
-    return [];
+  if (routeParams.size === 0) return [];
   const hasAnyContract = !!parsedFile.contract || parsedFile.headlessImports.some((imp) => !!imp.contract);
-  if (!hasAnyContract)
-    return [];
+  if (!hasAnyContract) return [];
   const declaredParams = /* @__PURE__ */ new Set();
   if (parsedFile.contract?.params) {
     for (const p of parsedFile.contract.params) {
@@ -2913,17 +2832,14 @@ function resolveBindingPhase(bindingPath, jayHtml) {
   const keyedImport = jayHtml.headlessImports.find((i) => i.key === root && i.contract);
   if (keyedImport?.contract) {
     const tagPath = segments.slice(1).join(".");
-    if (!tagPath)
-      return void 0;
+    if (!tagPath) return void 0;
     const tag = resolveContractTag(keyedImport.contract, tagPath);
-    if (!tag)
-      return void 0;
+    if (!tag) return void 0;
     return tag.phase || "slow";
   }
   if (jayHtml.contract) {
     const tag = resolveContractTag(jayHtml.contract, bindingPath);
-    if (!tag)
-      return void 0;
+    if (!tag) return void 0;
     return tag.phase || "slow";
   }
   return void 0;
@@ -2974,15 +2890,12 @@ function checkHeadlessInstanceProps(jayHtml, file) {
           }
           for (const contractProp of contract.props) {
             const attrValue = lowerAttrs[contractProp.name.toLowerCase()];
-            if (!attrValue)
-              continue;
+            if (!attrValue) continue;
             const bindingMatch = attrValue.match(/^\{(.+)\}$/);
-            if (!bindingMatch)
-              continue;
+            if (!bindingMatch) continue;
             const bindingPath = bindingMatch[1];
             const sourcePhase = resolveBindingPhase(bindingPath, jayHtml);
-            if (!sourcePhase)
-              continue;
+            if (!sourcePhase) continue;
             const propPhase = contractProp.phase ?? "slow";
             const sourceOrder = PHASE_ORDER[sourcePhase] ?? 0;
             const propOrder = PHASE_ORDER[propPhase] ?? 0;
@@ -3020,8 +2933,7 @@ function resolveLinkedTags(tags, contractDir) {
   });
 }
 function resolveContractLinks(contract, contractPath) {
-  if (!contractPath)
-    return contract;
+  if (!contractPath) return contract;
   const contractDir = path.dirname(contractPath);
   return { ...contract, tags: resolveLinkedTags(contract.tags, contractDir) };
 }
@@ -3029,8 +2941,7 @@ async function runPluginValidators(projectRoot, parsedFiles, errors, warnings) {
   const scannedPlugins = await scanPlugins({ projectRoot, includeDevDeps: true });
   const loadedValidators = [];
   for (const [, plugin] of scannedPlugins) {
-    if (!plugin.manifest.validators)
-      continue;
+    if (!plugin.manifest.validators) continue;
     for (const validatorDef of plugin.manifest.validators) {
       const source = `${plugin.name}/${validatorDef.name}`;
       let validatorFn;
@@ -3609,8 +3520,7 @@ async function ensureAgentKitDocs(projectRoot, _force, mode) {
   const sharedDirs = ["contracts"];
   for (const dir of sharedDirs) {
     const srcDir = path$1.join(templateDir, dir);
-    if (!fsSync.existsSync(srcDir))
-      continue;
+    if (!fsSync.existsSync(srcDir)) continue;
     await copyDirRecursive(srcDir, path$1.join(agentKitDir, dir));
     getLogger().info(chalk.gray(`   Created agent-kit/${dir}/`));
   }
@@ -3635,8 +3545,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
   const copiedPerRole = /* @__PURE__ */ new Map();
   for (const [, plugin] of plugins) {
     const pluginAgentKitDir = path$1.join(plugin.pluginPath, "agent-kit");
-    if (!fsSync.existsSync(pluginAgentKitDir))
-      continue;
+    if (!fsSync.existsSync(pluginAgentKitDir)) continue;
     for (const role of roles) {
       const roleSourceDir = path$1.join(pluginAgentKitDir, role);
       let files;
@@ -3647,8 +3556,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
       } catch {
         continue;
       }
-      if (files.length === 0)
-        continue;
+      if (files.length === 0) continue;
       const roleOutputDir = path$1.join(agentKitDir, role);
       await fs$1.mkdir(roleOutputDir, { recursive: true });
       for (const filename of files) {
@@ -3671,8 +3579,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
           }
         } catch {
         }
-        if (!copiedPerRole.has(role))
-          copiedPerRole.set(role, []);
+        if (!copiedPerRole.has(role)) copiedPerRole.set(role, []);
         copiedPerRole.get(role).push({ filename, pluginName: plugin.name, description });
         getLogger().info(
           chalk.gray(
@@ -3684,8 +3591,7 @@ async function mergePluginAgentKitGuides(projectRoot, mode) {
   }
   for (const [role, entries] of copiedPerRole) {
     const instructionsPath = path$1.join(agentKitDir, role, "INSTRUCTIONS.md");
-    if (!fsSync.existsSync(instructionsPath))
-      continue;
+    if (!fsSync.existsSync(instructionsPath)) continue;
     const lines = [
       "",
       "## Plugin-Contributed Guides",
@@ -3707,8 +3613,7 @@ async function generatePluginAgentKit(projectRoot, options, initErrors, viteServ
     verbose: options.verbose,
     pluginFilter: options.plugin
   });
-  if (plugins.length === 0)
-    return;
+  if (plugins.length === 0) return;
   const logger = getLogger();
   logger.important("");
   logger.important(chalk.bold("Generating plugin agent-kit data..."));
@@ -3937,20 +3842,17 @@ function createAnswersFilePrompt(answers, pluginName) {
   return {
     async input(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value;
+      if (value !== void 0) return value;
       throw new SetupNeedsAnswerError(pluginName, options.key, "input", options.message);
     },
     async confirm(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value === "true" || value === "yes";
+      if (value !== void 0) return value === "true" || value === "yes";
       throw new SetupNeedsAnswerError(pluginName, options.key, "confirm", options.message);
     },
     async select(options) {
       const value = answers[options.key];
-      if (value !== void 0)
-        return value;
+      if (value !== void 0) return value;
       throw new SetupNeedsAnswerError(
         pluginName,
         options.key,
@@ -4111,12 +4013,9 @@ async function runSetup(pluginFilter, options, projectRoot) {
     }
     await runProjectInit(projectRoot, viteServer);
     const parts = [];
-    if (configured > 0)
-      parts.push(`${configured} configured`);
-    if (needsConfig > 0)
-      parts.push(`${needsConfig} needs config`);
-    if (errors > 0)
-      parts.push(`${errors} error(s)`);
+    if (configured > 0) parts.push(`${configured} configured`);
+    if (needsConfig > 0) parts.push(`${needsConfig} needs config`);
+    if (errors > 0) parts.push(`${errors} error(s)`);
     logger.important(`Setup complete: ${parts.join(", ")}`);
     if (errors > 0) {
       process.exit(1);
@@ -4135,8 +4034,7 @@ async function runSetup(pluginFilter, options, projectRoot) {
 }
 async function initPlugin(pluginName, allPluginsWithInit, viteServer, logger) {
   const pluginInit = allPluginsWithInit.filter((p) => p.name === pluginName);
-  if (pluginInit.length === 0)
-    return;
+  if (pluginInit.length === 0) return;
   const initErrors = await executePluginServerInits(pluginInit, viteServer, false, true);
   if (initErrors.size > 0) {
     for (const [, err] of initErrors) {
@@ -4276,8 +4174,7 @@ function printCommandList(commands) {
   logger.important("\nAvailable plugin commands:\n");
   const byPlugin = /* @__PURE__ */ new Map();
   for (const cmd of commands) {
-    if (!byPlugin.has(cmd.pluginName))
-      byPlugin.set(cmd.pluginName, []);
+    if (!byPlugin.has(cmd.pluginName)) byPlugin.set(cmd.pluginName, []);
     byPlugin.get(cmd.pluginName).push(cmd);
   }
   for (const [pluginName, cmds] of byPlugin) {
@@ -4333,8 +4230,7 @@ program.command("build").description("Build production artifacts").option("-p, -
     await runBuild(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Build failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });
@@ -4343,8 +4239,7 @@ program.command("serve").description("Start production server").option("-p, --pa
     await runServe(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Server failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });
@@ -4353,8 +4248,7 @@ program.command("rebuild").description("Rebuild instances by contract, route, or
     await runRebuild(options.path, options);
   } catch (error) {
     getLogger().error(chalk.red("Rebuild failed:") + " " + error.message);
-    if (error.stack)
-      getLogger().error(error.stack);
+    if (error.stack) getLogger().error(error.stack);
     process.exit(1);
   }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/jay-stack-cli",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -25,14 +25,14 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "@jay-framework/compiler-jay-html": "^0.23.0",
-    "@jay-framework/compiler-shared": "^0.23.0",
-    "@jay-framework/dev-server": "^0.23.0",
-    "@jay-framework/fullstack-component": "^0.23.0",
-    "@jay-framework/logger": "^0.23.0",
-    "@jay-framework/plugin-validator": "^0.23.0",
-    "@jay-framework/production-server": "^0.23.0",
-    "@jay-framework/stack-server-runtime": "^0.23.0",
+    "@jay-framework/compiler-jay-html": "^0.23.1",
+    "@jay-framework/compiler-shared": "^0.23.1",
+    "@jay-framework/dev-server": "^0.23.1",
+    "@jay-framework/fullstack-component": "^0.23.1",
+    "@jay-framework/logger": "^0.23.1",
+    "@jay-framework/plugin-validator": "^0.23.1",
+    "@jay-framework/production-server": "^0.23.1",
+    "@jay-framework/stack-server-runtime": "^0.23.1",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "express": "^5.0.1",
@@ -43,7 +43,7 @@
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.23.0",
+    "@jay-framework/dev-environment": "^0.23.1",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",