@jay-framework/jay-stack-cli 0.13.0 → 0.15.0

package/agent-kit-template/INSTRUCTIONS.md

@@ -26,12 +26,12 @@ There is no standalone "interactive" phase. Any tag with `type: interactive` (re
 ## Workflow
 
 1. **Read this file** for overview and workflow
-2. **Discover plugins** — read `materialized-contracts/plugins-index.yaml` to see available plugins, contracts, and actions. Read `materialized-contracts/contracts-index.yaml` for the full contract list.
+2. **Discover plugins** — read `plugins-index.yaml` to see available plugins, contracts, and actions.
 3. **Read contracts** — read the `.jay-contract` files (paths from plugins-index) to understand data shapes, tag types, phases, and props.
 4. **Read actions** — read `.jay-action` files (paths from plugins-index) to see action descriptions, input schemas, and output schemas. This tells you what data each action accepts and returns.
 5. **Read references** — check `references/<plugin>/` for pre-generated discovery data (product catalogs, collection schemas, etc.). These are generated by `jay-stack agent-kit` and contain real data from the site.
 6. **Discover data** — run `jay-stack params <plugin>/<contract>` for SSG route params, `jay-stack action <plugin>/<action>` for data discovery. Use reference files (step 5) first when available — they're faster than running CLI commands.
-7. **Create pages** — write `.jay-html` files under `src/pages/` following directory-based routing.
+7. **Create pages** — write `.jay-html` files under `src/pages/` following directory-based routing. For static override routes (a static page that overrides a dynamic route for a specific URL), declare params with `<script type="application/jay-params">`.
 8. **Validate** — run `jay-stack validate` to check for errors.
 9. **Test** — run `jay-stack dev --test-mode` and verify pages render.
 
@@ -50,7 +50,7 @@ There is no standalone "interactive" phase. Any tag with `type: interactive` (re
 
 ### 1. Discover plugins and contracts
 
-Read `materialized-contracts/plugins-index.yaml`:
+Read `plugins-index.yaml`:
 
 ```yaml
 plugins:

package/agent-kit-template/cli-commands.md

@@ -50,8 +50,7 @@ jay-stack agent-kit --no-references
 
 Outputs:
 
-- `materialized-contracts/contracts-index.yaml`
-- `materialized-contracts/plugins-index.yaml`
+- `plugins-index.yaml`
 - `materialized-contracts/<plugin>/*.jay-contract` (dynamic contracts)
 - `references/<plugin>/` — plugin reference data (product catalogs, collection schemas, etc.)
 - Documentation files (INSTRUCTIONS.md and reference docs)

package/agent-kit-template/contracts-and-plugins.md

@@ -2,10 +2,9 @@
 
 ## Discovery: Plugins Index
 
-After running `jay-stack agent-kit`, read `materialized-contracts/plugins-index.yaml`:
+After running `jay-stack agent-kit`, read `plugins-index.yaml`:
 
 ```yaml
-materialized_at: '2026-02-09T...'
 jay_stack_version: '1.0.0'
 plugins:
   - name: wix-stores
@@ -37,18 +36,6 @@ Fields:
 - `actions[].description` — short description of what the action does
 - `actions[].path` — path to the `.jay-action` file with full input/output schemas
 
-## Discovery: Contracts Index
-
-`materialized-contracts/contracts-index.yaml` lists all contracts across all plugins:
-
-```yaml
-contracts:
-  - plugin: wix-stores
-    name: product-page
-    type: static
-    path: ./node_modules/@wix/stores/lib/contracts/product-page.jay-contract
-```
-
 ## Reading plugin.yaml
 
 Each plugin has a `plugin.yaml` at its root (the `path` from plugins-index):
@@ -249,16 +236,16 @@ outputSchema:
 
 Schemas use a compact type notation:
 
-| Notation | Meaning |
-| --- | --- |
-| `propName: string` | Required string property |
-| `propName?: number` | Optional number property |
-| `propName: boolean` | Required boolean |
-| `propName: enum(a \| b \| c)` | Required enum |
-| `propName:` + nested block | Nested object |
-| `propName:` + `- childProp: type` | Array of objects (YAML list) |
-| `propName: importedName` | Type from `import:` block (references a `.jay-contract`) |
-| `- importedName` | Array of imported type |
+| Notation                          | Meaning                                                  |
+| --------------------------------- | -------------------------------------------------------- |
+| `propName: string`                | Required string property                                 |
+| `propName?: number`               | Optional number property                                 |
+| `propName: boolean`               | Required boolean                                         |
+| `propName: enum(a \| b \| c)`     | Required enum                                            |
+| `propName:` + nested block        | Nested object                                            |
+| `propName:` + `- childProp: type` | Array of objects (YAML list)                             |
+| `propName: importedName`          | Type from `import:` block (references a `.jay-contract`) |
+| `- importedName`                  | Array of imported type                                   |
 
 ### Using Action Metadata
 

package/agent-kit-template/jay-html-syntax.md

@@ -10,9 +10,17 @@ A `.jay-html` file is standard HTML with jay-specific extensions.
     <!-- Page contract (optional — defines page-level data) -->
     <script type="application/jay-data" contract="./page.jay-contract"></script>
 
+    <!-- Explicit route params (for static override routes) -->
+    <script type="application/jay-params">
+      slug: ceramic-flower-vase
+    </script>
+
     <!-- Headless component imports -->
     <script type="application/jay-headless" plugin="..." contract="..." key="..."></script>
 
+    <!-- Headfull component imports -->
+    <script type="application/jay-headfull" src="..." names="..." contract="..."></script>
+
     <!-- Styles -->
     <style>
       /* inline CSS */
@@ -203,6 +211,35 @@ Use `<jay:contract-name>` tags with props:
 
 Inside `<jay:...>`, bindings resolve to **that instance's** contract tags (not the parent).
 
+## Headfull Full-Stack Components
+
+Headfull components that own their UI can be made full-stack by adding a `contract` attribute:
+
+```html
+<head>
+  <script
+    type="application/jay-headfull"
+    src="../components/shared-header"
+    names="SharedHeader"
+    contract="../components/shared-header/shared-header.jay-contract"
+  ></script>
+</head>
+```
+
+**Attributes:**
+
+- `src` — Path to the component module
+- `names` — Component name to import
+- `contract` — Path to the contract file (makes the component full-stack with SSR)
+
+**Usage** — same as client-only headfull, with props:
+
+```html
+<jay:SharedHeader logoUrl="/logo.png" />
+```
+
+Without `contract`, the component is client-only. With `contract`, it participates in slow/fast/interactive phases and is server-side rendered. Use headfull full-stack components for reusable UI with fixed layout that needs SSR (headers, footers, sidebars).
+
 ## Page-Level Contract
 
 A page can define its own data contract:

package/agent-kit-template/routing.md

@@ -39,7 +39,9 @@ Static routes match before dynamic routes (most specific first):
 3. **`[[param]]`** — optional param
 4. **`[...param]`** — catch-all — lowest priority
 
-Static override alongside a dynamic route:
+## Static Route Overrides
+
+A static route can override a dynamic route for a specific URL — giving one particular page a custom layout while the dynamic route handles everything else:
 
 ```
 src/pages/products/
@@ -47,6 +49,34 @@ src/pages/products/
 └── ceramic-flower-vase/page.jay-html # static override for this specific product
 ```
 
+The static `ceramic-flower-vase/` route takes priority over `[slug]/` for that URL, but all other product URLs still use the dynamic route.
+
+### Static Override Params (`jay-params`)
+
+Static override routes often use the same contract as the dynamic route they override. Since the static route has no dynamic directory segment, the params must be declared explicitly using `<script type="application/jay-params">`:
+
+```html
+<!-- src/pages/products/ceramic-flower-vase/page.jay-html -->
+<html>
+  <head>
+    <script type="application/jay-params">
+      slug: ceramic-flower-vase
+    </script>
+    <script
+      type="application/jay-headless"
+      plugin="wix-stores"
+      contract="product-page"
+      key="product"
+    ></script>
+  </head>
+  <body>
+    <h1>{product.productName}</h1>
+  </body>
+</html>
+```
+
+The script body is YAML. The declared params are passed to the component as if extracted from a dynamic URL segment. Without this, the component would receive no param values.
+
 ## Page Files
 
 Each page directory can contain:
@@ -82,9 +112,9 @@ tags:
 
 ## Dynamic Routes and Contract Params
 
-When a contract declares `params`, it means the component expects those URL parameters to be provided by the route. This tells you that the page using this contract **should be placed in a matching dynamic route directory**.
+When a component on the page — whether the page contract, a headless component, or a headfull full-stack component — declares `params`, the page should be placed in a dynamic route directory that provides those params.
 
-For example, if a contract declares:
+For example, if a headless component's contract declares:
 
 ```yaml
 name: product-page
@@ -94,12 +124,14 @@ tags:
   - ...
 ```
 
-Then the page using this contract should live at a route that provides a `slug` param:
+Then the page using this component should live at a route that provides a `slug` param:
 
 ```
 src/pages/products/[slug]/page.jay-html
 ```
 
+Multiple components on the same page can each declare params. The route directory must provide all required params across all components. For example, if the page contract requires `lang` and a headless component requires `slug`, the page should live at `src/pages/[lang]/products/[slug]/page.jay-html`.
+
 ### Discovering Param Values
 
 For SSG with dynamic routes, the plugin component provides a `loadParams` generator that yields all valid param combinations. Use it to discover what routes will be generated:

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { LogLevel } from '@jay-framework/logger';
 import { PublishMessage, PublishResponse, SaveImageMessage, SaveImageResponse, HasImageMessage, HasImageResponse, GetProjectInfoMessage, GetProjectInfoResponse, ExportMessage, ExportResponse, ImportMessage, ImportResponse, ProjectPage, Plugin } from '@jay-framework/editor-protocol';
-export { ContractIndexEntry, ContractsIndex, MaterializeContractsOptions, MaterializeResult, listContracts, materializeContracts } from '@jay-framework/stack-server-runtime';
+export { MaterializeContractsOptions, MaterializeResult, PluginContractEntry, PluginsIndex, PluginsIndexEntry, listContracts, materializeContracts } from '@jay-framework/stack-server-runtime';
 
 interface StartDevServerOptions {
     projectPath?: string;

package/dist/index.js

@@ -14,6 +14,7 @@ import { listContracts as listContracts2, materializeContracts as materializeCon
 import { Command } from "commander";
 import chalk from "chalk";
 import { glob } from "glob";
+import { parse } from "node-html-parser";
 const DEFAULT_CONFIG = {
   devServer: {
     portRange: [3e3, 3100],
@@ -2402,7 +2403,7 @@ async function startDevServer(options = {}) {
   const resolvedConfig = getConfigWithDefaults(config);
   const jayOptions = {
     tsConfigFilePath: "./tsconfig.json",
-    outputDir: "build/jay-runtime"
+    outputDir: "build"
   };
   const app = express();
   const devServerPort = await getPort({ port: resolvedConfig.devServer.portRange });
@@ -2441,7 +2442,6 @@ async function startDevServer(options = {}) {
     pagesRootFolder: path.resolve(resolvedConfig.devServer.pagesBase),
     projectRootFolder: process.cwd(),
     publicBaseUrlPath: "/",
-    dontCacheSlowly: false,
     jayRollupConfig: jayOptions,
     logLevel: options.logLevel
   });
@@ -2934,13 +2934,282 @@ async function findJayFiles(dir) {
 async function findContractFiles(dir) {
   return await glob(`${dir}/**/*${JAY_CONTRACT_EXTENSION}`);
 }
+function flattenContractTags(tags, prefix) {
+  const result = [];
+  for (const tag of tags) {
+    const tagPath = prefix ? `${prefix}.${tag.tag}` : tag.tag;
+    result.push({ path: tagPath, required: tag.required === true });
+    if (tag.tags) {
+      result.push(...flattenContractTags(tag.tags, tagPath));
+    }
+  }
+  return result;
+}
+function extractExpressions(text) {
+  const results = [];
+  const regex = /\{([^}]+)\}/g;
+  let match;
+  while ((match = regex.exec(text)) !== null) {
+    results.push(match[1].trim());
+  }
+  return results;
+}
+function extractTagPath(expr) {
+  let cleaned = expr.replace(/^!/, "").trim();
+  cleaned = cleaned.split(/\s*[!=]==?\s*/)[0].trim();
+  if (cleaned === "." || cleaned === "")
+    return null;
+  if (/^[a-zA-Z_$][a-zA-Z0-9_$]*(\.[a-zA-Z_$][a-zA-Z0-9_$]*)*$/.test(cleaned)) {
+    return cleaned;
+  }
+  return null;
+}
+const SKIP_ATTRS = /* @__PURE__ */ new Set([
+  "forEach",
+  "if",
+  "ref",
+  "trackBy",
+  "slowForEach",
+  "jayIndex",
+  "jayTrackBy",
+  "when-resolved",
+  "when-loading",
+  "when-rejected",
+  "accessor"
+]);
+function collectUsedTags(jayHtml) {
+  const imports = jayHtml.headlessImports;
+  const usedTags = /* @__PURE__ */ new Map();
+  const keyMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < imports.length; i++) {
+    if (imports[i].contract) {
+      usedTags.set(i, /* @__PURE__ */ new Set());
+      if (imports[i].key) {
+        keyMap.set(imports[i].key, i);
+      }
+    }
+  }
+  function markUsed(importIndex, tagPath) {
+    usedTags.get(importIndex)?.add(tagPath);
+  }
+  function resolvePath(path2, scopes) {
+    const dot = path2.indexOf(".");
+    if (dot !== -1) {
+      const key = path2.substring(0, dot);
+      const idx = keyMap.get(key);
+      if (idx !== void 0) {
+        markUsed(idx, path2.substring(dot + 1));
+        return;
+      }
+    }
+    if (scopes.length > 0) {
+      const scope = scopes[scopes.length - 1];
+      const full = scope.prefix ? `${scope.prefix}.${path2}` : path2;
+      markUsed(scope.importIndex, full);
+    }
+  }
+  function walkElement(element, scopes) {
+    const tagName = element.rawTagName?.toLowerCase();
+    let childScopes = scopes;
+    if (tagName?.startsWith("jay:")) {
+      const contractName = tagName.substring(4);
+      const idx = imports.findIndex(
+        (imp) => imp.contractName === contractName && imp.contract
+      );
+      if (idx !== -1) {
+        childScopes = [...scopes, { importIndex: idx, prefix: "" }];
+      }
+    }
+    const forEachVal = element.getAttribute?.("forEach");
+    if (forEachVal) {
+      const fePath = extractTagPath(forEachVal);
+      if (fePath) {
+        resolvePath(fePath, childScopes);
+        const dot = fePath.indexOf(".");
+        if (dot !== -1) {
+          const key = fePath.substring(0, dot);
+          const idx = keyMap.get(key);
+          if (idx !== void 0) {
+            childScopes = [
+              ...childScopes,
+              { importIndex: idx, prefix: fePath.substring(dot + 1) }
+            ];
+          }
+        } else if (childScopes.length > 0) {
+          const scope = childScopes[childScopes.length - 1];
+          const newPrefix = scope.prefix ? `${scope.prefix}.${fePath}` : fePath;
+          childScopes = [
+            ...childScopes,
+            { importIndex: scope.importIndex, prefix: newPrefix }
+          ];
+        }
+      }
+    }
+    if (tagName === "with-data") {
+      const accessor = element.getAttribute?.("accessor");
+      if (accessor && accessor !== "." && childScopes.length > 0) {
+        resolvePath(accessor, childScopes);
+        const scope = childScopes[childScopes.length - 1];
+        const newPrefix = scope.prefix ? `${scope.prefix}.${accessor}` : accessor;
+        childScopes = [
+          ...childScopes,
+          { importIndex: scope.importIndex, prefix: newPrefix }
+        ];
+      }
+    }
+    const ifVal = element.getAttribute?.("if");
+    if (ifVal) {
+      const ifPath = extractTagPath(ifVal);
+      if (ifPath)
+        resolvePath(ifPath, scopes);
+    }
+    const refVal = element.getAttribute?.("ref");
+    if (refVal) {
+      resolvePath(refVal, scopes);
+    }
+    const attrs = element.attributes ?? {};
+    for (const [name, value] of Object.entries(attrs)) {
+      if (SKIP_ATTRS.has(name))
+        continue;
+      for (const expr of extractExpressions(value)) {
+        const p = extractTagPath(expr);
+        if (p)
+          resolvePath(p, scopes);
+      }
+    }
+    for (const child of element.childNodes ?? []) {
+      if (child.nodeType === 3) {
+        const text = child.rawText ?? child.text ?? "";
+        for (const expr of extractExpressions(text)) {
+          const p = extractTagPath(expr);
+          if (p)
+            resolvePath(p, childScopes);
+        }
+      } else if (child.nodeType === 1) {
+        walkElement(child, childScopes);
+      }
+    }
+  }
+  walkElement(jayHtml.body, []);
+  return usedTags;
+}
+function analyzeTagCoverage(jayHtml, file) {
+  const imports = jayHtml.headlessImports;
+  const withContracts = imports.filter((imp) => imp.contract);
+  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;
+    const allTags = flattenContractTags(imp.contract.tags);
+    const usedSet = usedTagsMap.get(i) ?? /* @__PURE__ */ new Set();
+    const expanded = new Set(usedSet);
+    for (const usedPath of usedSet) {
+      const segments = usedPath.split(".");
+      for (let j = 1; j < segments.length; j++) {
+        expanded.add(segments.slice(0, j).join("."));
+      }
+    }
+    const unused = allTags.filter((t) => !expanded.has(t.path));
+    const requiredUnused = unused.filter((t) => t.required);
+    contracts.push({
+      key: imp.key,
+      contractName: imp.contractName,
+      totalTags: allTags.length,
+      usedTags: allTags.length - unused.length,
+      unusedTags: unused.map((t) => t.path),
+      requiredUnusedTags: requiredUnused.map((t) => t.path)
+    });
+  }
+  return { file, contracts };
+}
+const PARSE_PARAM = /^\[(\[)?(\.\.\.)?([^\]]+)\]?\]$/;
+function extractRouteParams(filePath, pagesBase) {
+  const relative = path.relative(pagesBase, filePath);
+  const segments = relative.split(path.sep);
+  const params = /* @__PURE__ */ new Set();
+  for (const segment of segments) {
+    const match = PARSE_PARAM.exec(segment);
+    if (match) {
+      params.add(match[3]);
+    }
+  }
+  return params;
+}
+function dedentYaml(text) {
+  const lines = text.split("\n").filter((l) => l.trim().length > 0);
+  if (lines.length === 0)
+    return "";
+  const minIndent = Math.min(...lines.map((l) => l.match(/^\s*/)?.[0].length ?? 0));
+  return lines.map((l) => l.slice(minIndent)).join("\n");
+}
+function extractJayParams(content) {
+  const root = parse(content, {
+    comment: true,
+    blockTextElements: { script: true, style: true }
+  });
+  const head = root.querySelector("head");
+  if (!head)
+    return /* @__PURE__ */ new Set();
+  const paramScripts = head.querySelectorAll('script[type="application/jay-params"]');
+  if (paramScripts.length !== 1)
+    return /* @__PURE__ */ new Set();
+  const body = dedentYaml(paramScripts[0].textContent ?? "");
+  if (!body)
+    return /* @__PURE__ */ new Set();
+  try {
+    const parsed = YAML.parse(body);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return new Set(Object.keys(parsed));
+    }
+    return /* @__PURE__ */ new Set();
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function checkRouteParams(parsedFile, filePath, pagesBase, jayHtmlContent) {
+  const requiredParams = /* @__PURE__ */ new Set();
+  function collectParams(params) {
+    for (const p of params) {
+      if (p.kind !== "optional") {
+        requiredParams.add(p.name);
+      }
+    }
+  }
+  if (parsedFile.contract?.params) {
+    collectParams(parsedFile.contract.params);
+  }
+  for (const imp of parsedFile.headlessImports) {
+    if (imp.contract?.params) {
+      collectParams(imp.contract.params);
+    }
+  }
+  if (requiredParams.size === 0)
+    return [];
+  const routeParams = extractRouteParams(filePath, pagesBase);
+  const jayParams = extractJayParams(jayHtmlContent);
+  const availableParams = /* @__PURE__ */ new Set([...routeParams, ...jayParams]);
+  const warnings = [];
+  for (const param of requiredParams) {
+    if (!availableParams.has(param)) {
+      warnings.push(
+        `Contract requires param "${param}" but the route does not provide it. Add a dynamic segment [${param}] to the route path or declare it in <script type="application/jay-params">.`
+      );
+    }
+  }
+  return warnings;
+}
 async function validateJayFiles(options = {}) {
   const config = loadConfig();
   const resolvedConfig = getConfigWithDefaults(config);
-  const projectRoot = process.cwd();
+  const projectRoot = options.projectRoot ?? process.cwd();
   const scanDir = options.path ? path.resolve(options.path) : path.resolve(resolvedConfig.devServer.pagesBase);
   const errors = [];
   const warnings = [];
+  const coverage = [];
   const jayHtmlFiles = await findJayFiles(scanDir);
   const contractFiles = await findContractFiles(scanDir);
   if (options.verbose) {
@@ -3006,6 +3275,14 @@ async function validateJayFiles(options = {}) {
         }
         continue;
       }
+      const routeParamWarnings = checkRouteParams(parsedFile.val, jayFile, scanDir, content);
+      for (const msg of routeParamWarnings) {
+        warnings.push({ file: relativePath, message: msg });
+      }
+      const fileCoverage = analyzeTagCoverage(parsedFile.val, relativePath);
+      if (fileCoverage) {
+        coverage.push(fileCoverage);
+      }
       const generatedFile = generateElementFile(
         parsedFile.val,
         RuntimeMode.MainTrusted,
@@ -3041,7 +3318,8 @@ async function validateJayFiles(options = {}) {
     jayHtmlFilesScanned: jayHtmlFiles.length,
     contractFilesScanned: contractFiles.length,
     errors,
-    warnings
+    warnings,
+    coverage
   };
 }
 function printJayValidationResult(result, options) {
@@ -3070,6 +3348,38 @@ function printJayValidationResult(result, options) {
       chalk.red(`${result.errors.length} error(s) found, ${validFiles} file(s) valid.`)
     );
   }
+  if (result.warnings.length > 0) {
+    logger.important("");
+    logger.important(chalk.yellow("Warnings:"));
+    for (const warning of result.warnings) {
+      logger.important(chalk.yellow(`  ⚠ ${warning.file}`));
+      logger.important(chalk.gray(`    ${warning.message}`));
+      logger.important("");
+    }
+  }
+  if (result.coverage.length > 0) {
+    logger.important("");
+    logger.important("Tag Coverage:");
+    for (const fileCov of result.coverage) {
+      logger.important(`  ${fileCov.file}`);
+      for (const contract of fileCov.contracts) {
+        const label = contract.key ? `${contract.key} (${contract.contractName})` : contract.contractName;
+        logger.important(
+          `    ${label}: ${contract.usedTags}/${contract.totalTags} tags used`
+        );
+        if (contract.unusedTags.length > 0) {
+          logger.important(chalk.gray(`      Unused: ${contract.unusedTags.join(", ")}`));
+        }
+        if (contract.requiredUnusedTags.length > 0) {
+          logger.important(
+            chalk.yellow(
+              `      ⚠ Required unused: ${contract.requiredUnusedTags.join(", ")}`
+            )
+          );
+        }
+      }
+    }
+  }
 }
 async function initializeServicesForCli(projectRoot, viteServer) {
   const path2 = await import("node:path");
@@ -3553,12 +3863,14 @@ async function runMaterialize(projectRoot, options, defaultOutputRelative, keepV
       services
     );
     if (options.yaml) {
-      getLogger().important(YAML.stringify(result.index));
+      getLogger().important(YAML.stringify(result.pluginsIndex));
     } else {
-      getLogger().important(
-        chalk.green(`
-✅ Materialized ${result.index.contracts.length} contracts`)
+      const totalContracts = result.pluginsIndex.plugins.reduce(
+        (sum, p) => sum + p.contracts.length,
+        0
       );
+      getLogger().important(chalk.green(`
+✅ Materialized ${totalContracts} contracts`));
       getLogger().important(`   Static: ${result.staticCount}`);
       getLogger().important(`   Dynamic: ${result.dynamicCount}`);
       getLogger().important(`   Output: ${result.outputDir}`);
@@ -3670,21 +3982,15 @@ function printValidationResult(result, verbose) {
 function printContractList(index) {
   const logger = getLogger();
   logger.important("\nAvailable Contracts:\n");
-  const byPlugin = /* @__PURE__ */ new Map();
-  for (const contract of index.contracts) {
-    const existing = byPlugin.get(contract.plugin) || [];
-    existing.push(contract);
-    byPlugin.set(contract.plugin, existing);
-  }
-  for (const [plugin, contracts] of byPlugin) {
-    logger.important(chalk.bold(`📦 ${plugin}`));
-    for (const contract of contracts) {
+  for (const plugin of index.plugins) {
+    logger.important(chalk.bold(`📦 ${plugin.name}`));
+    for (const contract of plugin.contracts) {
       const typeIcon = contract.type === "static" ? "📄" : "⚡";
       logger.important(`   ${typeIcon} ${contract.name}`);
     }
     logger.important("");
   }
-  if (index.contracts.length === 0) {
+  if (index.plugins.length === 0) {
     logger.important(chalk.gray("No contracts found."));
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/jay-stack-cli",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -24,23 +24,24 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-html": "^0.13.0",
-    "@jay-framework/compiler-shared": "^0.13.0",
-    "@jay-framework/dev-server": "^0.13.0",
-    "@jay-framework/editor-server": "^0.13.0",
-    "@jay-framework/fullstack-component": "^0.13.0",
-    "@jay-framework/logger": "^0.13.0",
-    "@jay-framework/plugin-validator": "^0.13.0",
-    "@jay-framework/stack-server-runtime": "^0.13.0",
+    "@jay-framework/compiler-jay-html": "^0.15.0",
+    "@jay-framework/compiler-shared": "^0.15.0",
+    "@jay-framework/dev-server": "^0.15.0",
+    "@jay-framework/editor-server": "^0.15.0",
+    "@jay-framework/fullstack-component": "^0.15.0",
+    "@jay-framework/logger": "^0.15.0",
+    "@jay-framework/plugin-validator": "^0.15.0",
+    "@jay-framework/stack-server-runtime": "^0.15.0",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
     "express": "^5.0.1",
     "glob": "^10.3.10",
+    "node-html-parser": "^6.1.12",
     "vite": "^5.0.11",
     "yaml": "^2.3.4"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.13.0",
+    "@jay-framework/dev-environment": "^0.15.0",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",