@pattern-stack/codegen 0.9.2 → 0.10.0

package/dist/src/cli/index.js

@@ -13,8 +13,8 @@ var __decorateParam = (index2, decorator) => (target, key) => decorator(target,
 
 // src/cli/index.ts
 import { readFileSync as readFileSync6 } from "fs";
-import { join as join11 } from "path";
-import { Builtins, Cli, Command as Command11 } from "clipanion";
+import { join as join10 } from "path";
+import { Builtins, Cli, Command as Command13 } from "clipanion";
 
 // src/cli/noun-module.ts
 import { Command, Option } from "clipanion";
@@ -24,13 +24,36 @@ import fs from "fs";
 import path from "path";
 import yaml from "yaml";
 
+// src/utils/find-yaml-files.ts
+import { readdirSync } from "fs";
+import { join, resolve } from "path";
+function isYaml(name) {
+  return name.endsWith(".yaml") || name.endsWith(".yml");
+}
+function findYamlFiles(dir) {
+  const root = resolve(dir);
+  const out = [];
+  const walk = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      if (entry.isDirectory()) {
+        if (entry.name.startsWith(".")) continue;
+        walk(join(current, entry.name));
+      } else if (isYaml(entry.name)) {
+        out.push(join(current, entry.name));
+      }
+    }
+  };
+  walk(root);
+  return out.sort();
+}
+
 // src/scanner/index.ts
 import { existsSync as existsSync5, statSync as statSync2 } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/scanner/framework-detector.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { join } from "path";
+import { existsSync, readdirSync as readdirSync2, readFileSync } from "fs";
+import { join as join2 } from "path";
 var FRAMEWORK_MARKERS = {
   nestjs: {
     imports: [
@@ -87,12 +110,12 @@ var FRAMEWORK_MARKERS = {
 function getAllTsFiles(dir, files = []) {
   if (!existsSync(dir)) return files;
   try {
-    const entries = readdirSync(dir, { withFileTypes: true });
+    const entries = readdirSync2(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) {
         continue;
       }
-      const fullPath = join(dir, entry.name);
+      const fullPath = join2(dir, entry.name);
       if (entry.isDirectory()) {
         getAllTsFiles(fullPath, files);
       } else if (entry.isFile() && entry.name.endsWith(".ts")) {
@@ -177,15 +200,15 @@ async function detectFramework(projectPath) {
 }
 
 // src/scanner/orm-detector.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync2, readdirSync as readdirSync3, readFileSync as readFileSync2 } from "fs";
+import { join as join3 } from "path";
 async function detectORM(projectPath) {
   const markers = {
     drizzle: [],
     prisma: [],
     typeorm: []
   };
-  const prismaSchemaPath = join2(projectPath, "prisma", "schema.prisma");
+  const prismaSchemaPath = join3(projectPath, "prisma", "schema.prisma");
   if (existsSync2(prismaSchemaPath)) {
     markers.prisma.push("prisma/schema.prisma");
   }
@@ -265,12 +288,12 @@ function findTypeScriptFiles(dir, files = []) {
     return files;
   }
   try {
-    const entries = readdirSync2(dir, { withFileTypes: true });
+    const entries = readdirSync3(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (shouldSkip(entry.name)) {
         continue;
       }
-      const fullPath = join2(dir, entry.name);
+      const fullPath = join3(dir, entry.name);
       if (entry.isDirectory()) {
         findTypeScriptFiles(fullPath, files);
       } else if (entry.isFile() && (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx"))) {
@@ -298,8 +321,8 @@ function shouldSkip(name) {
 }
 
 // src/scanner/architecture-detector.ts
-import { readdirSync as readdirSync3, statSync } from "fs";
-import { join as join3 } from "path";
+import { readdirSync as readdirSync4, statSync } from "fs";
+import { join as join4 } from "path";
 async function detectArchitecture(projectPath) {
   const scores = [
     detectCleanArchitecture(projectPath),
@@ -356,7 +379,7 @@ function detectFeatureArchitecture(projectPath) {
     const basePath = findFolder(projectPath, baseFolder);
     if (basePath) {
       try {
-        const subfolders = readdirSync3(basePath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => `${baseFolder}/${dirent.name}`);
+        const subfolders = readdirSync4(basePath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => `${baseFolder}/${dirent.name}`);
         if (subfolders.length > 0) {
           matchedFolders.push(baseFolder);
           matchedFolders.push(...subfolders.slice(0, 3));
@@ -406,8 +429,8 @@ function findMatchingFolders(projectPath, folderNames) {
 }
 function findFolder(projectPath, folderName) {
   const candidates = [
-    join3(projectPath, folderName),
-    join3(projectPath, "src", folderName)
+    join4(projectPath, folderName),
+    join4(projectPath, "src", folderName)
   ];
   for (const candidate of candidates) {
     try {
@@ -422,8 +445,8 @@ function findFolder(projectPath, folderName) {
 }
 
 // src/scanner/naming-detector.ts
-import { existsSync as existsSync3, readdirSync as readdirSync4, readFileSync as readFileSync3 } from "fs";
-import { basename, join as join4 } from "path";
+import { existsSync as existsSync3, readdirSync as readdirSync5, readFileSync as readFileSync3 } from "fs";
+import { basename, join as join5 } from "path";
 var CASE_PATTERNS = {
   "kebab-case": /^[a-z]+(-[a-z0-9]+)*$/,
   "camelCase": /^[a-z]+([A-Z][a-z0-9]*)*$/,
@@ -452,12 +475,12 @@ var COMMON_SUFFIXES = [
 function getAllTsFiles2(dir, files = []) {
   if (!existsSync3(dir)) return files;
   try {
-    const entries = readdirSync4(dir, { withFileTypes: true });
+    const entries = readdirSync5(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.name === "node_modules" || entry.name === "dist" || entry.name === "build" || entry.name === "coverage" || entry.name.startsWith(".")) {
         continue;
       }
-      const fullPath = join4(dir, entry.name);
+      const fullPath = join5(dir, entry.name);
       if (entry.isDirectory()) {
         getAllTsFiles2(fullPath, files);
       } else if (entry.isFile() && entry.name.endsWith(".ts")) {
@@ -617,7 +640,7 @@ async function detectNaming(projectPath) {
 
 // src/scanner/config-generator.ts
 import { existsSync as existsSync4 } from "fs";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 function generateConfig(profile) {
   const framework = profile.framework.detected;
   const orm = profile.orm.detected;
@@ -640,7 +663,7 @@ function generateConfig(profile) {
 }
 function buildGenerateConfig(profile, paths) {
   const explicitFrontendSrc = typeof paths.frontend_src === "string" && paths.frontend_src.length > 0;
-  const appsFrontendExists = existsSync4(join5(profile.paths.root, "apps", "frontend"));
+  const appsFrontendExists = existsSync4(join6(profile.paths.root, "apps", "frontend"));
   return {
     architecture: "clean",
     frontend: explicitFrontendSrc || appsFrontendExists
@@ -806,7 +829,7 @@ function calculateConfidence(profile) {
 function findSrcDirectory(projectPath) {
   const candidates = ["src", "app", "lib"];
   for (const candidate of candidates) {
-    const fullPath = join6(projectPath, candidate);
+    const fullPath = join7(projectPath, candidate);
     try {
       const stats = statSync2(fullPath);
       if (stats.isDirectory()) {
@@ -878,7 +901,7 @@ function resolveEntitiesDir(cwd, config) {
 function countEntityYamls(entitiesDir) {
   if (!entitiesDir || !fs.existsSync(entitiesDir)) return 0;
   try {
-    return fs.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).length;
+    return findYamlFiles(entitiesDir).length;
   } catch {
     return 0;
   }
@@ -986,13 +1009,13 @@ function renderPane(pane) {
 }
 
 // src/cli/ui/hints.ts
-function renderHints(hints9) {
+function renderHints(hints10) {
   if (isJsonMode()) return;
-  if (hints9.length === 0) return;
+  if (hints10.length === 0) return;
   console.log("");
   console.log(theme.muted("  Next:"));
-  const maxCmd = Math.max(...hints9.map((h) => h.command.length));
-  for (const h of hints9) {
+  const maxCmd = Math.max(...hints10.map((h) => h.command.length));
+  for (const h of hints10) {
     const pad = " ".repeat(maxCmd - h.command.length + 2);
     console.log(`    ${theme.system(h.command)}${pad}${theme.muted(h.description)}`);
   }
@@ -1017,13 +1040,13 @@ function buildNounSummaryCommand(noun) {
         json: this.json,
         verbose: this.verbose
       });
-      const [pane, hints9] = await Promise.all([noun.summary(ctx), noun.hints(ctx)]);
+      const [pane, hints10] = await Promise.all([noun.summary(ctx), noun.hints(ctx)]);
       if (isJsonMode()) {
-        printJson({ noun: noun.name, summary: pane, hints: hints9 });
+        printJson({ noun: noun.name, summary: pane, hints: hints10 });
         return 0;
       }
       renderPane(pane);
-      renderHints(hints9);
+      renderHints(hints10);
       return 0;
     }
   }
@@ -2935,8 +2958,8 @@ function loadEntityFromYaml(filePath) {
 }
 function formatZodErrors(error) {
   return error.errors.map((err) => {
-    const path31 = err.path.join(".");
-    const location = path31 ? `at '${path31}'` : "at root";
+    const path34 = err.path.join(".");
+    const location = path34 ? `at '${path34}'` : "at root";
     return `${err.message} ${location}`;
   });
 }
@@ -3091,8 +3114,7 @@ function detectYamlType(filePath) {
 }
 
 // src/parser/load-entities.ts
-import { readdirSync as readdirSync5 } from "fs";
-import { join as join7, resolve } from "path";
+import { resolve as resolve2 } from "path";
 function transformToEntity(result) {
   const { definition, filePath } = result;
   const queries = definition.queries?.filter((q) => "by" in q).map((q) => ({
@@ -3224,10 +3246,10 @@ function loadErrorToIssue(error) {
 function loadEntities(entitiesDir) {
   const entities = [];
   const issues = [];
-  const resolvedDir = resolve(entitiesDir);
+  const resolvedDir = resolve2(entitiesDir);
   let files;
   try {
-    files = readdirSync5(resolvedDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => join7(resolvedDir, f));
+    files = findYamlFiles(resolvedDir);
   } catch (err) {
     issues.push({
       severity: "error",
@@ -3272,19 +3294,19 @@ function resolveReferences(entities) {
     entityMap.set(entity.name, entity);
   }
   for (const entity of entities) {
-    for (const [relName, rel] of entity.relationships) {
-      const targetEntity = entityMap.get(rel.target);
+    for (const [relName, rel2] of entity.relationships) {
+      const targetEntity = entityMap.get(rel2.target);
       if (targetEntity) {
-        rel.resolved = true;
+        rel2.resolved = true;
       } else {
         issues.push({
           severity: "error",
           type: "missing_target",
           entity: entity.name,
           field: relName,
-          message: `Relationship '${relName}' references unknown entity '${rel.target}'`,
+          message: `Relationship '${relName}' references unknown entity '${rel2.target}'`,
           path: entity.sourcePath,
-          suggestion: `Define entity '${rel.target}' or fix the target name`
+          suggestion: `Define entity '${rel2.target}' or fix the target name`
         });
       }
     }
@@ -3397,10 +3419,10 @@ function resolveTypeDirections(types) {
 function loadRelationships(relationshipsDir) {
   const relationships = [];
   const issues = [];
-  const resolvedDir = resolve(relationshipsDir);
+  const resolvedDir = resolve2(relationshipsDir);
   let files;
   try {
-    files = readdirSync5(resolvedDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => join7(resolvedDir, f));
+    files = findYamlFiles(resolvedDir);
   } catch {
     return { relationships, issues };
   }
@@ -3482,14 +3504,14 @@ function buildDomainGraph(entities, relationshipDefinitions = []) {
     relDefMap.set(relDef.name, relDef);
   }
   for (const entity of entities) {
-    for (const [relName, rel] of entity.relationships) {
-      if (!rel.resolved) continue;
-      const reverseEdge = hasReverseEdge(edges, entity.name, rel.target);
+    for (const [relName, rel2] of entity.relationships) {
+      if (!rel2.resolved) continue;
+      const reverseEdge = hasReverseEdge(edges, entity.name, rel2.target);
       const edge = {
         from: entity.name,
-        to: rel.target,
-        relationship: rel,
-        cardinality: inferCardinality(rel.type),
+        to: rel2.target,
+        relationship: rel2,
+        cardinality: inferCardinality(rel2.type),
         bidirectional: reverseEdge !== void 0
       };
       if (reverseEdge) {
@@ -3534,19 +3556,19 @@ function findCircularDependencies(graph) {
   const cycles = [];
   const visited = /* @__PURE__ */ new Set();
   const recursionStack = /* @__PURE__ */ new Set();
-  function dfs(node, path31) {
+  function dfs(node, path34) {
     visited.add(node);
     recursionStack.add(node);
     const outgoingEdges = graph.edges.filter((e) => e.from === node);
     for (const edge of outgoingEdges) {
       if (!visited.has(edge.to)) {
-        dfs(edge.to, [...path31, edge.to]);
+        dfs(edge.to, [...path34, edge.to]);
       } else if (recursionStack.has(edge.to)) {
-        const cycleStart = path31.indexOf(edge.to);
+        const cycleStart = path34.indexOf(edge.to);
         if (cycleStart !== -1) {
-          cycles.push([...path31.slice(cycleStart), edge.to]);
+          cycles.push([...path34.slice(cycleStart), edge.to]);
         } else {
-          cycles.push([...path31, edge.to]);
+          cycles.push([...path34, edge.to]);
         }
       }
     }
@@ -3847,32 +3869,32 @@ function checkEntityConsistency(entity) {
 }
 function checkRelationshipConsistency(entity, graph) {
   const issues = [];
-  for (const [relName, rel] of entity.relationships) {
-    if (rel.type === "belongs_to") {
-      const fkField = entity.fields.get(rel.foreignKey);
+  for (const [relName, rel2] of entity.relationships) {
+    if (rel2.type === "belongs_to") {
+      const fkField = entity.fields.get(rel2.foreignKey);
       if (!fkField) {
         issues.push({
           severity: "warning",
           type: "missing_fk_field",
           entity: entity.name,
           field: relName,
-          message: `Relationship "${relName}" references foreign key "${rel.foreignKey}" but field doesn't exist`,
-          suggestion: `Add field "${rel.foreignKey}" with foreign_key reference`
+          message: `Relationship "${relName}" references foreign key "${rel2.foreignKey}" but field doesn't exist`,
+          suggestion: `Add field "${rel2.foreignKey}" with foreign_key reference`
         });
       }
     }
-    if (rel.type === "has_many" || rel.type === "has_one") {
-      const targetEntity = graph.entities.get(rel.target);
+    if (rel2.type === "has_many" || rel2.type === "has_one") {
+      const targetEntity = graph.entities.get(rel2.target);
       if (targetEntity) {
-        const targetFkField = targetEntity.fields.get(rel.foreignKey);
+        const targetFkField = targetEntity.fields.get(rel2.foreignKey);
         if (!targetFkField) {
           issues.push({
             severity: "warning",
             type: "missing_target_fk",
             entity: entity.name,
             field: relName,
-            message: `Relationship "${relName}" expects foreign key "${rel.foreignKey}" on "${rel.target}" but field doesn't exist`,
-            suggestion: `Add field "${rel.foreignKey}" to "${rel.target}" entity`
+            message: `Relationship "${relName}" expects foreign key "${rel2.foreignKey}" on "${rel2.target}" but field doesn't exist`,
+            suggestion: `Add field "${rel2.foreignKey}" to "${rel2.target}" entity`
           });
         }
       }
@@ -3989,7 +4011,7 @@ function checkMissingInverses(graph) {
     const targetEntity = graph.entities.get(to);
     if (!targetEntity) continue;
     const hasInverse = Array.from(targetEntity.relationships.values()).some(
-      (rel) => rel.target === from
+      (rel2) => rel2.target === from
     );
     if (!hasInverse && relationship.type !== "belongs_to") {
       issues.push({
@@ -4009,9 +4031,9 @@ function getAvailableFieldNames(entity) {
   const behaviorFields = resolveBehaviorFields(entity.behaviors);
   const behaviorFieldNames = behaviorFields.map((f) => f.name);
   const belongsToFkNames = [];
-  for (const rel of entity.relationships.values()) {
-    if (rel.type === "belongs_to" && rel.foreignKey) {
-      belongsToFkNames.push(rel.foreignKey);
+  for (const rel2 of entity.relationships.values()) {
+    if (rel2.type === "belongs_to" && rel2.foreignKey) {
+      belongsToFkNames.push(rel2.foreignKey);
     }
   }
   return [.../* @__PURE__ */ new Set([...entityFieldNames, ...behaviorFieldNames, ...belongsToFkNames])];
@@ -4116,8 +4138,8 @@ function computeStatistics(graph) {
     for (const field of entity.fields.values()) {
       fieldsByType[field.type] = (fieldsByType[field.type] ?? 0) + 1;
     }
-    for (const rel of entity.relationships.values()) {
-      relationshipsByType[rel.type] = (relationshipsByType[rel.type] ?? 0) + 1;
+    for (const rel2 of entity.relationships.values()) {
+      relationshipsByType[rel2.type] = (relationshipsByType[rel2.type] ?? 0) + 1;
     }
   }
   return {
@@ -4143,8 +4165,8 @@ function suggestTransitiveRelationships(graph, options) {
   for (const [entityName, entity] of graph.entities) {
     if (shouldExcludeEntity(entityName, opts)) continue;
     const paths = findTransitivePaths(graph, entityName, opts);
-    for (const path31 of paths) {
-      suggestions.push(createSuggestion(path31));
+    for (const path34 of paths) {
+      suggestions.push(createSuggestion(path34));
     }
   }
   return suggestions;
@@ -4175,22 +4197,22 @@ function findTransitivePaths(graph, sourceEntity, opts) {
   while (queue.length > 0) {
     const current = queue.shift();
     if (!current) continue;
-    const { entity, depth, path: path31, visited } = current;
+    const { entity, depth, path: path34, visited } = current;
     if (depth >= opts.maxDepth) continue;
     const currentEntity = graph.entities.get(entity);
     if (!currentEntity) continue;
-    for (const [relName, rel] of currentEntity.relationships) {
-      if (rel.through) continue;
-      if (rel.type !== "has_many" && rel.type !== "has_one") continue;
-      const target = rel.target;
+    for (const [relName, rel2] of currentEntity.relationships) {
+      if (rel2.through) continue;
+      if (rel2.type !== "has_many" && rel2.type !== "has_one") continue;
+      const target = rel2.target;
       if (shouldExcludeEntity(target, opts)) continue;
       if (visited.has(target)) continue;
       const newPath = [
-        ...path31,
+        ...path34,
         {
           via: entity,
           relationship: relName,
-          foreignKey: rel.foreignKey
+          foreignKey: rel2.foreignKey
         }
       ];
       if (depth >= 1) {
@@ -4218,8 +4240,8 @@ function findTransitivePaths(graph, sourceEntity, opts) {
   return paths;
 }
 function hasDirectRelationship(sourceEntity, targetName) {
-  for (const rel of sourceEntity.relationships.values()) {
-    if (rel.target === targetName && !rel.through) {
+  for (const rel2 of sourceEntity.relationships.values()) {
+    if (rel2.target === targetName && !rel2.through) {
       return true;
     }
   }
@@ -4254,15 +4276,15 @@ function generateYamlSnippet(name, target, throughPath) {
     target: ${target}
     through: "${throughPath}"`;
 }
-function createSuggestion(path31) {
-  const pathDescription = [path31.source, ...path31.hops.map((h) => h.via), path31.target].join(" -> ");
+function createSuggestion(path34) {
+  const pathDescription = [path34.source, ...path34.hops.map((h) => h.via), path34.target].join(" -> ");
   return {
     severity: "info",
     type: "transitive_suggestion",
-    entity: path31.source,
+    entity: path34.source,
     message: `Potential transitive relationship: ${pathDescription}`,
-    suggestion: `Add "${path31.suggestedName}" relationship via "${path31.throughPath}"`,
-    path: path31
+    suggestion: `Add "${path34.suggestedName}" relationship via "${path34.throughPath}"`,
+    path: path34
   };
 }
 
@@ -4354,13 +4376,13 @@ function toManifestEntity(entity) {
     };
   }
   const relationships = {};
-  for (const [name, rel] of entity.relationships) {
+  for (const [name, rel2] of entity.relationships) {
     relationships[name] = {
-      type: rel.type,
-      target: rel.target,
-      foreignKey: rel.foreignKey,
-      through: rel.through,
-      inverse: rel.inverse
+      type: rel2.type,
+      target: rel2.target,
+      foreignKey: rel2.foreignKey,
+      through: rel2.through,
+      inverse: rel2.inverse
     };
   }
   return {
@@ -5332,8 +5354,8 @@ function formatEntitySection(entity) {
     lines.push("");
     lines.push("| Name | Type | Target | Foreign Key |");
     lines.push("|------|------|--------|-------------|");
-    for (const [name, rel] of entity.relationships) {
-      lines.push(`| ${name} | ${rel.type} | ${rel.target} | ${rel.foreignKey} |`);
+    for (const [name, rel2] of entity.relationships) {
+      lines.push(`| ${name} | ${rel2.type} | ${rel2.target} | ${rel2.foreignKey} |`);
     }
     lines.push("");
   }
@@ -5665,7 +5687,7 @@ function toKebabCase(input) {
 }
 function listEntityYamls(entitiesDir) {
   if (!fs2.existsSync(entitiesDir)) return [];
-  return fs2.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path4.join(entitiesDir, f)).sort();
+  return findYamlFiles(entitiesDir);
 }
 function collectEntities(entitiesDir) {
   const files = listEntityYamls(entitiesDir);
@@ -5684,7 +5706,9 @@ function collectEntities(entitiesDir) {
 }
 function listRelationshipYamls(relationshipsDir) {
   if (!fs2.existsSync(relationshipsDir)) return [];
-  return fs2.readdirSync(relationshipsDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path4.join(relationshipsDir, f)).filter((full) => detectYamlType(full) === "relationship").sort();
+  return findYamlFiles(relationshipsDir).filter(
+    (full) => detectYamlType(full) === "relationship"
+  );
 }
 function collectRelationships(relationshipsDir) {
   const files = listRelationshipYamls(relationshipsDir);
@@ -5692,9 +5716,9 @@ function collectRelationships(relationshipsDir) {
   for (const file of files) {
     const result = loadRelationshipFromYaml(file);
     if (!result.success) continue;
-    const rel = result.definition.relationship;
-    const name = rel.name;
-    const plural = rel.table ?? pluralize(name);
+    const rel2 = result.definition.relationship;
+    const name = rel2.name;
+    const plural = rel2.table ?? pluralize(name);
     junctions.push({ name, plural });
   }
   junctions.sort((a, b) => a.name.localeCompare(b.name));
@@ -5702,7 +5726,9 @@ function collectRelationships(relationshipsDir) {
 }
 function listJunctionYamls(junctionsDir) {
   if (!fs2.existsSync(junctionsDir)) return [];
-  return fs2.readdirSync(junctionsDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path4.join(junctionsDir, f)).filter((full) => detectYamlType(full) === "junction").sort();
+  return findYamlFiles(junctionsDir).filter(
+    (full) => detectYamlType(full) === "junction"
+  );
 }
 function deriveJunctionName(def) {
   return def.name ?? `${def.between[0]}_${def.between[1]}`;
@@ -5747,9 +5773,9 @@ var HEADER = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
 `;
 function relativeImport(fromFile, toFile) {
   const fromDir = path4.posix.dirname(fromFile);
-  let rel = path4.posix.relative(fromDir, toFile);
-  if (!rel.startsWith(".")) rel = `./${rel}`;
-  return rel.replace(/\.ts$/, "");
+  let rel2 = path4.posix.relative(fromDir, toFile);
+  if (!rel2.startsWith(".")) rel2 = `./${rel2}`;
+  return rel2.replace(/\.ts$/, "");
 }
 function buildModulesBarrel(entities, barrelFile, architecture, backendSrc = "app/backend/src") {
   const imports = [];
@@ -5836,8 +5862,8 @@ function resolveArchitecture(ctx) {
 }
 function resolveGeneratedDir(ctx) {
   const fromConfig = ctx.config?.paths?.generated;
-  const rel = typeof fromConfig === "string" && fromConfig.length > 0 ? fromConfig : "src/generated";
-  return path4.resolve(ctx.cwd, rel);
+  const rel2 = typeof fromConfig === "string" && fromConfig.length > 0 ? fromConfig : "src/generated";
+  return path4.resolve(ctx.cwd, rel2);
 }
 function resolveBackendSrc(ctx) {
   const fromConfig = ctx.config?.paths?.backend_src;
@@ -5852,7 +5878,7 @@ var HEADER2 = `// AUTO-GENERATED by @pattern-stack/codegen. Do not edit.
 `;
 function collectScopeableNames(entitiesDir) {
   if (!fs3.existsSync(entitiesDir)) return [];
-  const files = fs3.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path5.join(entitiesDir, f)).sort();
+  const files = findYamlFiles(entitiesDir);
   const names = [];
   for (const file of files) {
     const result = loadEntityFromYaml(file);
@@ -7042,8 +7068,7 @@ import fs8 from "fs";
 import path11 from "path";
 
 // src/parser/load-events.ts
-import { readdirSync as readdirSync7 } from "fs";
-import { basename as basename2, join as join10, resolve as resolve2 } from "path";
+import { basename as basename2, resolve as resolve3 } from "path";
 function loadErrorToIssue2(error) {
   const issues = [];
   issues.push({
@@ -7073,10 +7098,10 @@ function stripYamlExt(file) {
 function loadEvents(eventsDir, entityNames) {
   const events = [];
   const issues = [];
-  const resolvedDir = resolve2(eventsDir);
+  const resolvedDir = resolve3(eventsDir);
   let files;
   try {
-    files = readdirSync7(resolvedDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).sort().map((f) => join10(resolvedDir, f));
+    files = findYamlFiles(resolvedDir);
   } catch {
     issues.push({
       severity: "warning",
@@ -7227,7 +7252,7 @@ function collectEntityEvents(entitiesDir) {
   if (!fs8.existsSync(entitiesDir)) {
     return { events, issues };
   }
-  const files = fs8.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path11.join(entitiesDir, f)).sort();
+  const files = findYamlFiles(entitiesDir);
   for (const filePath of files) {
     const result = loadEntityFromYaml(filePath);
     if (!result.success) continue;
@@ -7269,7 +7294,7 @@ function collectMergedEvents(opts) {
   const { entitiesDir, eventsDir } = opts;
   const entityNames = [];
   if (fs8.existsSync(entitiesDir)) {
-    const entityFiles = fs8.readdirSync(entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path11.join(entitiesDir, f)).sort();
+    const entityFiles = findYamlFiles(entitiesDir);
     for (const f of entityFiles) {
       const result = loadEntityFromYaml(f);
       if (result.success) entityNames.push(result.definition.entity.name);
@@ -7752,7 +7777,7 @@ function printInfo(msg) {
 // src/cli/commands/entity.ts
 function listEntityYamls2(dir) {
   if (!fs9.existsSync(dir)) return [];
-  return fs9.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => path13.join(dir, f));
+  return findYamlFiles(dir);
 }
 function summarizePatternLabel(entity) {
   if (typeof entity.pattern === "string" && entity.pattern.length > 0) {
@@ -8788,13 +8813,6 @@ function readIfExists(p) {
     return null;
   }
 }
-function writeFile(target, content) {
-  const existing = readIfExists(target);
-  if (existing === content) return "unchanged";
-  fs10.mkdirSync(path21.dirname(target), { recursive: true });
-  fs10.writeFileSync(target, content);
-  return existing === null ? "written" : "updated";
-}
 function extractRelativeImports(source) {
   const out = [];
   const re = /(?:import|export)\s+(?:[^'"`;]*?\s+from\s+)?['"`](\.{1,2}\/[^'"`]+)['"`]/g;
@@ -8813,7 +8831,7 @@ function resolveSourceImport(sourceFile, specifier) {
   return null;
 }
 async function copyRuntime(opts) {
-  const { sourceDir, targetDir, filter, resolveDeps, dryRun } = opts;
+  const { sourceDir, targetDir, filter, resolveDeps, dryRun, onlyExisting } = opts;
   if (!fs10.existsSync(sourceDir) || !fs10.statSync(sourceDir).isDirectory()) {
     throw new Error(`runtime source directory not found: ${sourceDir}`);
   }
@@ -8838,9 +8856,9 @@ async function copyRuntime(opts) {
       }
       if (!stat.isFile()) continue;
       if (!entry.endsWith(".ts") && !entry.endsWith(".tsx")) continue;
-      const rel = path21.relative(sourceDir, src);
-      if (filter && !filter(rel) && !filter(entry)) continue;
-      queue.push({ src, dest: path21.join(targetDir, rel), isDep: false });
+      const rel2 = path21.relative(sourceDir, src);
+      if (filter && !filter(rel2) && !filter(entry)) continue;
+      queue.push({ src, dest: path21.join(targetDir, rel2), isDep: false });
     }
   }
   walk(sourceDir);
@@ -8849,14 +8867,20 @@ async function copyRuntime(opts) {
     const next = queue.shift();
     if (visited.has(next.src)) continue;
     visited.add(next.src);
+    if (onlyExisting && !fs10.existsSync(next.dest)) {
+      continue;
+    }
     const content = fs10.readFileSync(next.src, "utf-8");
     result.planned.push(next.dest);
-    if (!dryRun) {
-      const status = writeFile(next.dest, content);
-      if (status === "written") result.written.push(next.dest);
-      else if (status === "updated") result.updated.push(next.dest);
-      else result.unchanged.push(next.dest);
-      if (next.isDep) result.dependenciesCopied.push(next.dest);
+    const existing = readIfExists(next.dest);
+    const status = existing === content ? "unchanged" : existing === null ? "written" : "updated";
+    if (status === "written") result.written.push(next.dest);
+    else if (status === "updated") result.updated.push(next.dest);
+    else result.unchanged.push(next.dest);
+    if (next.isDep) result.dependenciesCopied.push(next.dest);
+    if (!dryRun && status !== "unchanged") {
+      fs10.mkdirSync(path21.dirname(next.dest), { recursive: true });
+      fs10.writeFileSync(next.dest, content);
     }
     if (resolveDeps) {
       for (const spec of extractRelativeImports(content)) {
@@ -8909,11 +8933,11 @@ async function summary2(ctx) {
   }
   body.push(theme.muted("Installed:"));
   for (const i of installed) {
-    const rel = path22.relative(ctx.cwd, i.path) || i.path;
+    const rel2 = path22.relative(ctx.cwd, i.path) || i.path;
     body.push(
       `  ${theme.success(icons.check)} ${i.name.padEnd(10)} ${theme.muted(
         `${i.backend} backend`
-      )}   ${theme.muted(rel)}`
+      )}   ${theme.muted(rel2)}`
     );
   }
   if (missing.length > 0) {
@@ -9916,9 +9940,9 @@ function buildAuthImportRewriter(subsystemsRoot) {
       return content;
     }
     AUTH_BARE_IMPORT_RE.lastIndex = 0;
-    let rel = path22.relative(path22.dirname(destPath), authRoot);
-    if (!rel.startsWith(".")) rel = `./${rel}`;
-    const relPosix = rel.split(path22.sep).join("/");
+    let rel2 = path22.relative(path22.dirname(destPath), authRoot);
+    if (!rel2.startsWith(".")) rel2 = `./${rel2}`;
+    const relPosix = rel2.split(path22.sep).join("/");
     return content.replace(
       AUTH_BARE_IMPORT_RE,
       (_match, quote) => `${quote}${relPosix}${quote}`
@@ -10100,10 +10124,10 @@ var subsystemNoun = {
 var subsystem_default = subsystemNoun;
 
 // src/cli/commands/project.ts
-import fs14 from "fs";
-import path25 from "path";
+import fs17 from "fs";
+import path28 from "path";
 import readline from "readline";
-import { Command as Command5, Option as Option5 } from "clipanion";
+import { Command as Command7, Option as Option7 } from "clipanion";
 import { stringify as stringifyYaml2 } from "yaml";
 
 // src/cli/shared/init-scaffold.ts
@@ -10746,8 +10770,8 @@ async function buildInitPlan(ctx, options) {
   {
     const entitiesDir = path23.join(cwd, "entities");
     const examplePath = path23.join(entitiesDir, "example.yaml");
-    const hasOtherYamls = fs12.existsSync(entitiesDir) && fs12.readdirSync(entitiesDir).some(
-      (f) => (f.endsWith(".yaml") || f.endsWith(".yml")) && f !== "example.yaml"
+    const hasOtherYamls = fs12.existsSync(entitiesDir) && findYamlFiles(entitiesDir).some(
+      (f) => path23.basename(f) !== "example.yaml"
     );
     if (fs12.existsSync(examplePath)) {
       entries.push({
@@ -11058,8 +11082,8 @@ function runtimeRoot3() {
   if (fs13.existsSync(topLevel)) return topLevel;
   return path24.join(pkgRoot, "dist", "runtime");
 }
-function loadRuntimeFile2(rel) {
-  return fs13.readFileSync(path24.join(runtimeRoot3(), rel), "utf-8");
+function loadRuntimeFile2(rel2) {
+  return fs13.readFileSync(path24.join(runtimeRoot3(), rel2), "utf-8");
 }
 function resolveProjectRoot(startDir) {
   let dir = path24.resolve(startDir);
@@ -11342,8 +11366,457 @@ ${CONSUMER_SETUP_POINTER}
   }
 };
 
-// src/cli/commands/project.ts
+// src/cli/commands/project-update.ts
+import fs16 from "fs";
+import path27 from "path";
+import { Command as Command6, Option as Option6 } from "clipanion";
+
+// src/cli/commands/skills.ts
+import fs15 from "fs";
+import path26 from "path";
+import { Command as Command5, Option as Option5 } from "clipanion";
+
+// src/cli/shared/tree-copier.ts
+import fs14 from "fs";
+import path25 from "path";
+var TEXT_EXTENSIONS = [".ts", ".tsx", ".md", ".mdx", ".yaml", ".yml", ".json"];
+function isTextFile(name) {
+  return TEXT_EXTENSIONS.some((ext) => name.endsWith(ext));
+}
+function copyTreeWithReport(opts) {
+  const { srcDir, destDir, dryRun = false, transform, include } = opts;
+  const report = {
+    entries: [],
+    created: [],
+    updated: [],
+    unchanged: []
+  };
+  if (!fs14.existsSync(srcDir) || !fs14.statSync(srcDir).isDirectory()) {
+    throw new Error(`tree-copier source directory not found: ${srcDir}`);
+  }
+  const walk = (relDir) => {
+    const absSrcDir = path25.join(srcDir, relDir);
+    for (const entry of fs14.readdirSync(absSrcDir, { withFileTypes: true })) {
+      const relPath2 = relDir ? path25.posix.join(relDir, entry.name) : entry.name;
+      const absSrc = path25.join(srcDir, relPath2);
+      if (entry.isDirectory()) {
+        walk(relPath2);
+        continue;
+      }
+      if (!entry.isFile()) continue;
+      if (include && !include(relPath2)) continue;
+      const dest = path25.join(destDir, relPath2);
+      let content = fs14.readFileSync(absSrc, "utf-8");
+      if (transform && isTextFile(entry.name)) {
+        content = transform(content, dest);
+      }
+      const existing = fs14.existsSync(dest) ? fs14.readFileSync(dest, "utf-8") : null;
+      let action;
+      if (existing === null) {
+        action = "created";
+      } else if (existing === content) {
+        action = "unchanged";
+      } else {
+        action = "updated";
+      }
+      if (!dryRun && action !== "unchanged") {
+        fs14.mkdirSync(path25.dirname(dest), { recursive: true });
+        fs14.writeFileSync(dest, content, "utf-8");
+      }
+      const record = { relPath: relPath2, dest, action };
+      report.entries.push(record);
+      report[action].push(record);
+    }
+  };
+  walk("");
+  return report;
+}
+
+// src/cli/commands/skills.ts
+function consumerSkillsRoot() {
+  const pkgRoot = path26.resolve(import.meta.dirname, "..", "..", "..");
+  const topLevel = path26.join(pkgRoot, "consumer-skills");
+  if (fs15.existsSync(topLevel)) return topLevel;
+  return path26.join(pkgRoot, "dist", "consumer-skills");
+}
+function skillsTargetDir(cwd) {
+  return path26.join(cwd, ".claude", "skills");
+}
+function availableSkills() {
+  const root = consumerSkillsRoot();
+  if (!fs15.existsSync(root)) return [];
+  return fs15.readdirSync(root, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+}
+function runSkillsInstall(opts) {
+  const sourceRoot = consumerSkillsRoot();
+  const targetDir = skillsTargetDir(opts.cwd);
+  if (!fs15.existsSync(sourceRoot)) {
+    return {
+      ok: false,
+      sourceRoot,
+      targetDir,
+      error: `consumer skills source missing: ${sourceRoot}`
+    };
+  }
+  const report = copyTreeWithReport({
+    srcDir: sourceRoot,
+    destDir: targetDir,
+    dryRun: Boolean(opts.dryRun)
+  });
+  return { ok: true, sourceRoot, targetDir, report };
+}
 async function summary3(ctx) {
+  const skills = availableSkills();
+  const targetDir = skillsTargetDir(ctx.cwd);
+  const installedDirs = fs15.existsSync(targetDir) ? new Set(
+    fs15.readdirSync(targetDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name)
+  ) : /* @__PURE__ */ new Set();
+  const body = [];
+  if (skills.length === 0) {
+    body.push(theme.muted("No consumer skills bundled with this package build."));
+    return { title: "skills", body, footer: "" };
+  }
+  body.push(theme.muted("Consumer skills:"));
+  for (const name of skills) {
+    const present = installedDirs.has(name);
+    const icon = present ? theme.success(icons.check) : theme.muted(icons.dash);
+    const status = present ? "" : theme.muted("not installed");
+    body.push(`  ${icon} ${name.padEnd(12)} ${status}`);
+  }
+  const installedCount = skills.filter((s) => installedDirs.has(s)).length;
+  return {
+    title: "skills",
+    body,
+    footer: `${installedCount} of ${skills.length} skills installed \u2192 ${path26.relative(ctx.cwd, targetDir) || targetDir}`
+  };
+}
+async function hints3(ctx) {
+  const skills = availableSkills();
+  const targetDir = skillsTargetDir(ctx.cwd);
+  const allPresent = skills.length > 0 && fs15.existsSync(targetDir) && skills.every((s) => fs15.existsSync(path26.join(targetDir, s)));
+  if (allPresent) {
+    return [
+      { command: "codegen update", description: "Re-sync skills + runtime after a package bump" }
+    ];
+  }
+  return [
+    { command: "codegen skills install", description: "Vendor consumer skills into .claude/skills" }
+  ];
+}
+function renderTreeReport(report) {
+  const show = (entry) => {
+    const icon = theme.success(icons.check);
+    console.log(`  ${icon} ${theme.muted(entry.action.padEnd(10))} ${entry.relPath}`);
+  };
+  for (const e of [...report.created, ...report.updated]) show(e);
+  if (report.unchanged.length > 0) {
+    console.log(
+      `  ${theme.muted(icons.dash)} ${theme.muted("unchanged".padEnd(10))} ${theme.muted(
+        `${report.unchanged.length} file${report.unchanged.length === 1 ? "" : "s"} already current`
+      )}`
+    );
+  }
+}
+var SkillsInstallCommand = class extends Command5 {
+  static paths = [["skills", "install"]];
+  static usage = Command5.Usage({
+    description: "Vendor consumer-facing skills into the project .claude/skills",
+    examples: [
+      ["Install all consumer skills", "codegen skills install"],
+      ["Preview without writing", "codegen skills install --dry-run"],
+      ["Overwrite locally-edited skill files", "codegen skills install --force"]
+    ]
+  });
+  force = Option5.Boolean("--force", false);
+  dryRun = Option5.Boolean("--dry-run", false);
+  json = Option5.Boolean("--json", false);
+  cwd = Option5.String("--cwd", { required: false });
+  async execute() {
+    if (this.json) setJsonMode(true);
+    const ctx = await loadContext({ cwd: this.cwd, json: this.json, skipDetection: true });
+    const preview = runSkillsInstall({ cwd: ctx.cwd, dryRun: true });
+    if (!preview.ok) {
+      if (isJsonMode()) {
+        printJson({ command: "skills install", status: "error", error: preview.error });
+      } else {
+        printError(preview.error ?? "skills install failed");
+      }
+      return 1;
+    }
+    if (!this.dryRun && !this.force) {
+      const updatedPaths = preview.report.updated.map((e) => e.dest);
+      const gate = checkGitSafety(updatedPaths, ctx.cwd);
+      if (gate.inRepo && !gate.clean) {
+        printWarning(
+          `Uncommitted changes in ${gate.dirty.length} skill file(s). Commit them or pass --force to overwrite.`
+        );
+        if (!isJsonMode()) return 1;
+      }
+    }
+    const result = runSkillsInstall({ cwd: ctx.cwd, dryRun: this.dryRun });
+    const report = result.report;
+    if (isJsonMode()) {
+      printJson({
+        command: "skills install",
+        dryRun: this.dryRun,
+        target: result.targetDir,
+        files: {
+          created: report.created.map((e) => e.relPath),
+          updated: report.updated.map((e) => e.relPath),
+          unchanged: report.unchanged.map((e) => e.relPath)
+        }
+      });
+      return 0;
+    }
+    printInfo(`target = ${path26.relative(ctx.cwd, result.targetDir) || result.targetDir}`);
+    console.log("");
+    renderTreeReport(report);
+    console.log("");
+    if (this.dryRun) {
+      printWarning("dry-run \u2014 no files written");
+      return 0;
+    }
+    printSuccess(
+      `skills installed (${report.created.length} new, ${report.updated.length} updated, ${report.unchanged.length} unchanged)`
+    );
+    printInfo("Skills are auto-discovered by Claude Code from .claude/skills/.");
+    return 0;
+  }
+};
+var SkillsListCommand = class extends Command5 {
+  static paths = [["skills", "list"]];
+  static usage = Command5.Usage({
+    description: "List available consumer skills and their installed status"
+  });
+  json = Option5.Boolean("--json", false);
+  cwd = Option5.String("--cwd", { required: false });
+  async execute() {
+    if (this.json) setJsonMode(true);
+    const ctx = await loadContext({ cwd: this.cwd, json: this.json, skipDetection: true });
+    const skills = availableSkills();
+    const targetDir = skillsTargetDir(ctx.cwd);
+    const rows = skills.map((name) => {
+      const dir = path26.join(targetDir, name);
+      return { name, status: fs15.existsSync(dir) ? "installed" : "available" };
+    });
+    if (isJsonMode()) {
+      printJson({ command: "skills list", target: targetDir, skills: rows });
+      return 0;
+    }
+    if (rows.length === 0) {
+      printWarning("No consumer skills bundled with this package build.");
+      return 0;
+    }
+    const pad = (s, n) => s.length >= n ? s : s + " ".repeat(n - s.length);
+    console.log(theme.muted(`${pad("NAME", 14)}STATUS`));
+    for (const r of rows) console.log(`${pad(r.name, 14)}${r.status}`);
+    return 0;
+  }
+};
+var skillsNoun = {
+  name: "skills",
+  commandClasses: [SkillsInstallCommand, SkillsListCommand],
+  summary: summary3,
+  hints: hints3
+};
+var skills_default = skillsNoun;
+
+// src/cli/commands/project-update.ts
+var NON_RUNTIME_SUBSYSTEMS = /* @__PURE__ */ new Set(["openapi-config", "auth-integrations"]);
+function syncVendoredRuntime(cwd, write) {
+  const changes = [];
+  for (const v of VENDORED_RUNTIME_FILES) {
+    const dest = path27.join(cwd, v.target);
+    const content = loadRuntimeFile(v.runtime);
+    const existing = fs16.existsSync(dest) ? fs16.readFileSync(dest, "utf-8") : null;
+    let action;
+    if (existing === null) action = "created";
+    else if (existing === content) action = "unchanged";
+    else action = "updated";
+    if (write && action !== "unchanged") {
+      fs16.mkdirSync(path27.dirname(dest), { recursive: true });
+      fs16.writeFileSync(dest, content, "utf-8");
+    }
+    changes.push({ path: v.target, action });
+  }
+  return changes;
+}
+async function syncSubsystemRuntime(cwd, inst, write) {
+  if (NON_RUNTIME_SUBSYSTEMS.has(inst.name)) {
+    return { name: inst.name, changes: [], skippedReason: "config-only / vendored elsewhere" };
+  }
+  const source = subsystemSource(inst.name);
+  if (!fs16.existsSync(source)) {
+    return { name: inst.name, changes: [], skippedReason: "no runtime source in package" };
+  }
+  const subsystemsRoot = path27.dirname(inst.path);
+  const result = await copyRuntime({
+    sourceDir: source,
+    targetDir: inst.path,
+    filter: backendFileFilter(inst.backend, inst.name),
+    resolveDeps: true,
+    runtimeRoot: runtimeRoot2(),
+    depsTargetRoot: path27.resolve(subsystemsRoot, ".."),
+    dryRun: !write,
+    // Refresh files already vendored for this subsystem; never install new
+    // ones (that's `subsystem install`). copyRuntime classifies accurately
+    // in dry-run too, so this report is correct either way.
+    onlyExisting: true
+  });
+  const changes = [];
+  for (const p of result.written) changes.push({ path: rel(cwd, p), action: "created" });
+  for (const p of result.updated) changes.push({ path: rel(cwd, p), action: "updated" });
+  for (const p of result.unchanged) changes.push({ path: rel(cwd, p), action: "unchanged" });
+  return { name: inst.name, changes };
+}
+function rel(cwd, abs) {
+  return path27.relative(cwd, abs) || abs;
+}
+var ProjectUpdateCommand = class extends Command6 {
+  static paths = [["project", "update"]];
+  static usage = Command6.Usage({
+    description: "Re-sync vendored runtime, installed subsystems, and consumer skills to the installed package version",
+    examples: [
+      ["Re-sync everything after a package bump", "codegen update"],
+      ["Preview without writing", "codegen update --dry-run"],
+      ["Overwrite even with uncommitted changes", "codegen update --force"],
+      ["Skip the skills re-sync", "codegen update --skip-skills"]
+    ]
+  });
+  dryRun = Option6.Boolean("--dry-run", false);
+  force = Option6.Boolean("--force", false);
+  skipSkills = Option6.Boolean("--skip-skills", false);
+  skipSubsystems = Option6.Boolean("--skip-subsystems", false);
+  json = Option6.Boolean("--json", false);
+  cwd = Option6.String("--cwd", { required: false });
+  configPath = Option6.String("--config", { required: false });
+  async execute() {
+    if (this.json) setJsonMode(true);
+    const ctx = await loadContext({
+      cwd: this.cwd,
+      configPath: this.configPath,
+      json: this.json,
+      skipDetection: true
+    });
+    if (!ctx.isInitialized) {
+      if (isJsonMode()) {
+        printJson({ command: "project update", status: "not-initialized" });
+      } else {
+        printWarning("project is not initialized \u2014 run `codegen init` first");
+      }
+      return 1;
+    }
+    const installed = this.skipSubsystems ? [] : await detectInstalledSubsystems(ctx);
+    if (!this.dryRun && !this.force) {
+      const vendoredDry = syncVendoredRuntime(ctx.cwd, false);
+      const vendoredDirtyCandidates = vendoredDry.filter((c) => c.action === "updated").map((c) => path27.join(ctx.cwd, c.path));
+      const skillDirtyCandidates = this.skipSkills ? [] : runSkillsInstall({ cwd: ctx.cwd, dryRun: true }).report?.updated.map((e) => e.dest) ?? [];
+      const subsystemDirs = installed.filter((i) => !NON_RUNTIME_SUBSYSTEMS.has(i.name)).map((i) => i.path);
+      const gate = checkGitSafety(
+        [...vendoredDirtyCandidates, ...skillDirtyCandidates, ...subsystemDirs],
+        ctx.cwd
+      );
+      if (gate.inRepo && !gate.clean) {
+        if (isJsonMode()) {
+          printJson({
+            command: "project update",
+            status: "dirty-tree",
+            dirty: gate.dirty
+          });
+        } else {
+          printWarning(
+            `Uncommitted changes in ${gate.dirty.length} file(s) that update would overwrite. Commit them or pass --force.`
+          );
+          for (const d of gate.dirty.slice(0, 10)) {
+            console.log(`  ${theme.muted(icons.dash)} ${d}`);
+          }
+        }
+        return 1;
+      }
+    }
+    const write = !this.dryRun;
+    const vendored = syncVendoredRuntime(ctx.cwd, write);
+    const subsystemResults = [];
+    for (const inst of installed) {
+      subsystemResults.push(await syncSubsystemRuntime(ctx.cwd, inst, write));
+    }
+    const skills = this.skipSkills ? null : runSkillsInstall({ cwd: ctx.cwd, dryRun: this.dryRun });
+    const tally = (changes) => ({
+      created: changes.filter((c) => c.action === "created").length,
+      updated: changes.filter((c) => c.action === "updated").length,
+      unchanged: changes.filter((c) => c.action === "unchanged").length
+    });
+    if (isJsonMode()) {
+      printJson({
+        command: "project update",
+        dryRun: this.dryRun,
+        runtime: vendored,
+        subsystems: subsystemResults.map((s) => ({
+          name: s.name,
+          skipped: s.skippedReason ?? null,
+          ...tally(s.changes)
+        })),
+        skills: skills && skills.report ? {
+          created: skills.report.created.length,
+          updated: skills.report.updated.length,
+          unchanged: skills.report.unchanged.length
+        } : null
+      });
+      return 0;
+    }
+    printInfo(`Updating ${ctx.cwd} to the installed @pattern-stack/codegen version`);
+    console.log("");
+    renderSection("shared runtime", vendored);
+    for (const s of subsystemResults) {
+      if (s.skippedReason) {
+        console.log(
+          `  ${theme.muted(icons.dash)} ${theme.muted(`subsystem ${s.name} skipped (${s.skippedReason})`)}`
+        );
+        continue;
+      }
+      renderSection(`subsystem ${s.name}`, s.changes);
+    }
+    if (skills?.report) {
+      renderSection(
+        "skills",
+        [
+          ...skills.report.created.map((e) => ({ path: e.relPath, action: "created" })),
+          ...skills.report.updated.map((e) => ({ path: e.relPath, action: "updated" })),
+          ...skills.report.unchanged.map((e) => ({
+            path: e.relPath,
+            action: "unchanged"
+          }))
+        ]
+      );
+    } else if (this.skipSkills) {
+      console.log(`  ${theme.muted(icons.dash)} ${theme.muted("skills skipped (--skip-skills)")}`);
+    }
+    console.log("");
+    if (this.dryRun) {
+      printWarning("dry-run \u2014 no files written");
+      return 0;
+    }
+    printSuccess("update complete");
+    printInfo(
+      "Schema shape changes are NOT re-synced \u2014 if a subsystem schema changed across versions, run `codegen subsystem install <name> --force --force-config`."
+    );
+    return 0;
+  }
+};
+function renderSection(label, changes) {
+  const created = changes.filter((c) => c.action === "created");
+  const updated = changes.filter((c) => c.action === "updated");
+  const unchanged = changes.filter((c) => c.action === "unchanged");
+  if (created.length === 0 && updated.length === 0 && unchanged.length === 0) return;
+  const head = created.length + updated.length === 0 ? theme.muted(`${label} \u2014 up to date (${unchanged.length})`) : `${theme.system(label)} \u2014 ${created.length} new, ${updated.length} updated`;
+  console.log(`  ${head}`);
+  for (const c of [...created, ...updated]) {
+    console.log(`    ${theme.success(icons.check)} ${theme.muted(c.action.padEnd(8))} ${c.path}`);
+  }
+}
+
+// src/cli/commands/project.ts
+async function summary4(ctx) {
   if (!ctx.isInitialized) {
     return {
       title: "project",
@@ -11368,7 +11841,7 @@ async function summary3(ctx) {
   body.push(`  orm:          ${orm}`);
   body.push(`  architecture: ${arch}`);
   body.push(`  entities:     ${ctx.entityCount}`);
-  body.push(`  subsystems:   ${ctx.installedSubsystems.length}/4 installed`);
+  body.push(`  subsystems:   ${ctx.installedSubsystems.length}/${SUBSYSTEMS.length} installed`);
   body.push(`  generated:    ${generated}`);
   return {
     title: "project",
@@ -11376,7 +11849,7 @@ async function summary3(ctx) {
     footer: `cwd: ${ctx.cwd}`
   };
 }
-async function hints3(ctx) {
+async function hints4(ctx) {
   if (!ctx.isInitialized) {
     return [
       { command: "codegen init", description: "Scaffold consumer project" },
@@ -11394,17 +11867,17 @@ async function hints3(ctx) {
   } else {
     out.push({ command: "codegen entity", description: "Entity summary + hints" });
   }
-  if (ctx.installedSubsystems.length < 4) {
+  if (ctx.installedSubsystems.length < SUBSYSTEMS.length) {
     out.push({
       command: "codegen subsystem",
-      description: "Install events/jobs/cache/storage"
+      description: "Install events/jobs/cache/storage/\u2026"
     });
   }
   return out;
 }
-var ProjectInitCommand = class extends Command5 {
+var ProjectInitCommand = class extends Command7 {
   static paths = [["project", "init"]];
-  static usage = Command5.Usage({
+  static usage = Command7.Usage({
     description: "Scaffold a consumer project (config, shims, barrels, app.module)",
     examples: [
       ["Initialize with defaults", "codegen project init --yes"],
@@ -11413,12 +11886,14 @@ var ProjectInitCommand = class extends Command5 {
       ["Overwrite existing shims", "codegen project init --force"]
     ]
   });
-  yes = Option5.Boolean("--yes,-y", false);
-  dryRun = Option5.Boolean("--dry-run", false);
-  force = Option5.Boolean("--force", false);
-  withTsconfig = Option5.Boolean("--with-tsconfig", false);
-  json = Option5.Boolean("--json", false);
-  cwd = Option5.String("--cwd", { required: false });
+  yes = Option7.Boolean("--yes,-y", false);
+  dryRun = Option7.Boolean("--dry-run", false);
+  force = Option7.Boolean("--force", false);
+  withTsconfig = Option7.Boolean("--with-tsconfig", false);
+  // Vendor consumer skills into .claude/skills by default; opt out with --no-skills.
+  skills = Option7.Boolean("--skills", true);
+  json = Option7.Boolean("--json", false);
+  cwd = Option7.String("--cwd", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -11449,6 +11924,7 @@ var ProjectInitCommand = class extends Command5 {
       console.log("");
     }
     const result = writePlan(plan);
+    const skillsResult = this.skills ? runSkillsInstall({ cwd: ctx.cwd, dryRun: false }) : null;
     if (isJsonMode()) {
       printJson({
         command: "project init",
@@ -11457,7 +11933,12 @@ var ProjectInitCommand = class extends Command5 {
         created: result.created.map((e) => e.relPath),
         merged: result.merged.map((e) => e.relPath),
         overwritten: result.overwritten.map((e) => e.relPath),
-        skipped: result.skipped.map((e) => ({ path: e.relPath, reason: e.reason }))
+        skipped: result.skipped.map((e) => ({ path: e.relPath, reason: e.reason })),
+        skills: skillsResult && skillsResult.report ? {
+          created: skillsResult.report.created.length,
+          updated: skillsResult.report.updated.length,
+          unchanged: skillsResult.report.unchanged.length
+        } : null
       });
       return 0;
     }
@@ -11486,6 +11967,22 @@ var ProjectInitCommand = class extends Command5 {
         `  ${theme.muted(icons.dash)} ${theme.muted("skip    ")} ${e.relPath}${e.reason ? theme.muted("  (" + e.reason + ")") : ""}`
       );
     }
+    if (skillsResult?.report) {
+      const r = skillsResult.report;
+      console.log(
+        `  ${theme.success(icons.check)} ${theme.muted("skills  ")} .claude/skills/ ${theme.muted(
+          `(${r.created.length} new, ${r.updated.length} updated, ${r.unchanged.length} unchanged)`
+        )}`
+      );
+    } else if (!this.skills) {
+      console.log(
+        `  ${theme.muted(icons.dash)} ${theme.muted("skip    ")} .claude/skills/ ${theme.muted("(--no-skills)")}`
+      );
+    } else if (skillsResult && !skillsResult.ok) {
+      console.log(
+        `  ${theme.warning(icons.warning)} ${theme.muted("skills  ")} ${theme.muted(skillsResult.error ?? "skills install failed")}`
+      );
+    }
     console.log("");
     printInfo("Next steps:");
     console.log(`  1. ${theme.system("bun add")} the peer deps (see docs/CONSUMER-SETUP.md)`);
@@ -11498,10 +11995,10 @@ var ProjectInitCommand = class extends Command5 {
 };
 function askConfirm(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     rl.question(`${question} [Y/n] `, (answer) => {
       rl.close();
-      resolve3(answer.trim().toLowerCase() !== "n");
+      resolve4(answer.trim().toLowerCase() !== "n");
     });
   });
 }
@@ -11534,9 +12031,9 @@ function renderPlanOnly(plan, opts) {
   }
   return 0;
 }
-var ProjectScanCommand = class extends Command5 {
+var ProjectScanCommand = class extends Command7 {
   static paths = [["project", "scan"]];
-  static usage = Command5.Usage({
+  static usage = Command7.Usage({
     description: "Detect framework/ORM/architecture and propose a codegen.config.yaml",
     examples: [
       ["Scan the current directory", "codegen project scan"],
@@ -11544,17 +12041,17 @@ var ProjectScanCommand = class extends Command5 {
       ["Preview only", "codegen project scan --dry-run"]
     ]
   });
-  directory = Option5.String({ required: false });
-  write = Option5.Boolean("--write", false);
-  dryRun = Option5.Boolean("--dry-run", false);
-  verbose = Option5.Boolean("--verbose,-v", false);
-  json = Option5.Boolean("--json", false);
-  cwd = Option5.String("--cwd", { required: false });
+  directory = Option7.String({ required: false });
+  write = Option7.Boolean("--write", false);
+  dryRun = Option7.Boolean("--dry-run", false);
+  verbose = Option7.Boolean("--verbose,-v", false);
+  json = Option7.Boolean("--json", false);
+  cwd = Option7.String("--cwd", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
-    const baseCwd = this.cwd ? path25.resolve(this.cwd) : process.cwd();
-    const target = this.directory ? path25.resolve(baseCwd, this.directory) : baseCwd;
-    if (!fs14.existsSync(target)) {
+    const baseCwd = this.cwd ? path28.resolve(this.cwd) : process.cwd();
+    const target = this.directory ? path28.resolve(baseCwd, this.directory) : baseCwd;
+    if (!fs17.existsSync(target)) {
       printError(`Directory not found: ${target}`);
       return 1;
     }
@@ -11604,8 +12101,8 @@ var ProjectScanCommand = class extends Command5 {
         `architecture: ${profile.architecture.evidence.join(", ") || "\u2014"}`
       ]);
     }
-    const outPath = path25.join(target, "codegen.config.yaml");
-    const existsNow = fs14.existsSync(outPath);
+    const outPath = path28.join(target, "codegen.config.yaml");
+    const existsNow = fs17.existsSync(outPath);
     if (this.dryRun) {
       console.log("");
       printInfo("Dry run \u2014 proposed codegen.config.yaml:");
@@ -11618,7 +12115,7 @@ var ProjectScanCommand = class extends Command5 {
         printWarning(`${outPath} already exists \u2014 pass --force via edit; skipping.`);
         return 0;
       }
-      fs14.writeFileSync(outPath, yamlText);
+      fs17.writeFileSync(outPath, yamlText);
       printSuccess(`wrote ${outPath}`);
       return 0;
     }
@@ -11636,14 +12133,14 @@ function printMutedBlock(title, lines) {
   console.log(theme.muted(title + ":"));
   for (const l of lines) console.log(theme.muted("  " + l));
 }
-var ProjectConfigCommand = class extends Command5 {
+var ProjectConfigCommand = class extends Command7 {
   static paths = [["project", "config"]];
-  static usage = Command5.Usage({
+  static usage = Command7.Usage({
     description: "Print the resolved codegen config (YAML or JSON)"
   });
-  json = Option5.Boolean("--json", false);
-  cwd = Option5.String("--cwd", { required: false });
-  configPath = Option5.String("--config", { required: false });
+  json = Option7.Boolean("--json", false);
+  cwd = Option7.String("--cwd", { required: false });
+  configPath = Option7.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -11675,9 +12172,9 @@ var ProjectConfigCommand = class extends Command5 {
     return 0;
   }
 };
-var ProjectInspectCommand = class extends Command5 {
+var ProjectInspectCommand = class extends Command7 {
   static paths = [["project", "inspect"]];
-  static usage = Command5.Usage({
+  static usage = Command7.Usage({
     description: "Domain analysis, statistics, documentation, and manifest operations",
     examples: [
       ["Full analysis", "codegen project inspect --kind analyze"],
@@ -11687,20 +12184,20 @@ var ProjectInspectCommand = class extends Command5 {
       ["Review suggestions", "codegen project inspect --kind suggestions"]
     ]
   });
-  kind = Option5.String("--kind", { required: true });
-  dir = Option5.String({ required: false });
-  format = Option5.String("--format", "console");
-  output = Option5.String("--output,-o", { required: false });
-  strict = Option5.Boolean("--strict", false);
-  entity = Option5.String("--entity", { required: false });
-  force = Option5.Boolean("--force", false);
-  accept = Option5.String("--accept", { required: false });
-  skip = Option5.String("--skip", { required: false });
-  acceptAll = Option5.Boolean("--accept-all", false);
-  skipAll = Option5.Boolean("--skip-all", false);
-  json = Option5.Boolean("--json", false);
-  cwd = Option5.String("--cwd", { required: false });
-  configPath = Option5.String("--config", { required: false });
+  kind = Option7.String("--kind", { required: true });
+  dir = Option7.String({ required: false });
+  format = Option7.String("--format", "console");
+  output = Option7.String("--output,-o", { required: false });
+  strict = Option7.Boolean("--strict", false);
+  entity = Option7.String("--entity", { required: false });
+  force = Option7.Boolean("--force", false);
+  accept = Option7.String("--accept", { required: false });
+  skip = Option7.String("--skip", { required: false });
+  acceptAll = Option7.Boolean("--accept-all", false);
+  skipAll = Option7.Boolean("--skip-all", false);
+  json = Option7.Boolean("--json", false);
+  cwd = Option7.String("--cwd", { required: false });
+  configPath = Option7.String("--config", { required: false });
   async execute() {
     if (this.json || this.format === "json") setJsonMode(true);
     const ctx = await loadContext({
@@ -11725,12 +12222,12 @@ var ProjectInspectCommand = class extends Command5 {
     return 2;
   }
   resolveEntitiesDir(ctx) {
-    if (this.dir) return path25.resolve(ctx.cwd, this.dir);
-    return ctx.entitiesDir ?? path25.resolve(ctx.cwd, "entities");
+    if (this.dir) return path28.resolve(ctx.cwd, this.dir);
+    return ctx.entitiesDir ?? path28.resolve(ctx.cwd, "entities");
   }
   async runAnalysis(ctx, kind) {
     const entitiesDir = this.resolveEntitiesDir(ctx);
-    if (!entitiesDir || !fs14.existsSync(entitiesDir)) {
+    if (!entitiesDir || !fs17.existsSync(entitiesDir)) {
       printError(`Directory not found: ${entitiesDir ?? "(no entities/ dir)"}`);
       return 1;
     }
@@ -11760,7 +12257,7 @@ var ProjectInspectCommand = class extends Command5 {
       out = formatConsole(filtered);
     }
     if (this.output) {
-      fs14.writeFileSync(this.output, out);
+      fs17.writeFileSync(this.output, out);
       if (!isJsonMode()) printSuccess(`wrote ${this.output}`);
     } else {
       console.log(out);
@@ -11773,7 +12270,7 @@ var ProjectInspectCommand = class extends Command5 {
   }
   async runManifest(ctx) {
     const entitiesDir = this.resolveEntitiesDir(ctx);
-    if (!entitiesDir || !fs14.existsSync(entitiesDir)) {
+    if (!entitiesDir || !fs17.existsSync(entitiesDir)) {
       printError(`Directory not found: ${entitiesDir ?? "(no entities/ dir)"}`);
       return 1;
     }
@@ -11906,9 +12403,9 @@ function formatStatsConsole(result) {
   lines.push("");
   return lines.join("\n");
 }
-var ProjectGraphCommand = class extends Command5 {
+var ProjectGraphCommand = class extends Command7 {
   static paths = [["project", "graph"]];
-  static usage = Command5.Usage({
+  static usage = Command7.Usage({
     description: "Visualize the entity-relationship graph in a browser",
     examples: [
       ["Open interactive graph viewer", "codegen project graph"],
@@ -11916,11 +12413,11 @@ var ProjectGraphCommand = class extends Command5 {
       ["Write graph JSON to file", "codegen project graph --output graph.json"]
     ]
   });
-  dir = Option5.String({ required: false });
-  output = Option5.String("--output,-o", { required: false });
-  json = Option5.Boolean("--json", false);
-  cwd = Option5.String("--cwd", { required: false });
-  configPath = Option5.String("--config", { required: false });
+  dir = Option7.String({ required: false });
+  output = Option7.String("--output,-o", { required: false });
+  json = Option7.Boolean("--json", false);
+  cwd = Option7.String("--cwd", { required: false });
+  configPath = Option7.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -11929,17 +12426,17 @@ var ProjectGraphCommand = class extends Command5 {
       json: this.json,
       skipDetection: true
     });
-    const entitiesDir = this.dir ? path25.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path25.resolve(ctx.cwd, "entities");
-    if (!fs14.existsSync(entitiesDir)) {
+    const entitiesDir = this.dir ? path28.resolve(ctx.cwd, this.dir) : ctx.entitiesDir ?? path28.resolve(ctx.cwd, "entities");
+    if (!fs17.existsSync(entitiesDir)) {
       printError(`Entity directory not found: ${entitiesDir}`);
       return 1;
     }
     const relCandidates = [
-      path25.resolve(path25.dirname(entitiesDir), "relationships"),
-      path25.resolve(entitiesDir, "relationships"),
-      path25.resolve(ctx.cwd, "relationships")
+      path28.resolve(path28.dirname(entitiesDir), "relationships"),
+      path28.resolve(entitiesDir, "relationships"),
+      path28.resolve(ctx.cwd, "relationships")
     ];
-    const relationshipsDir = relCandidates.find((d) => fs14.existsSync(d));
+    const relationshipsDir = relCandidates.find((d) => fs17.existsSync(d));
     const result = await analyzeDomain(entitiesDir, relationshipsDir);
     const serialized = serializeDomainGraph(result.graph);
     if (isJsonMode()) {
@@ -11953,20 +12450,20 @@ var ProjectGraphCommand = class extends Command5 {
       return 0;
     }
     if (this.output) {
-      const outPath = path25.resolve(ctx.cwd, this.output);
-      fs14.writeFileSync(outPath, JSON.stringify(serialized, null, 2));
+      const outPath = path28.resolve(ctx.cwd, this.output);
+      fs17.writeFileSync(outPath, JSON.stringify(serialized, null, 2));
       printSuccess(`Graph written to ${outPath}`);
       printInfo(`${result.entities.length} entities, ${result.relationshipDefinitions.length} relationships, ${result.graph.edges.length} edges`);
       return 0;
     }
     const os = await import("os");
-    const tmpDir = fs14.mkdtempSync(path25.join(os.default.tmpdir(), "codegen-graph-"));
-    const graphPath = path25.join(tmpDir, "graph.json");
-    fs14.writeFileSync(graphPath, JSON.stringify(serialized, null, 2));
-    const viewerDir = path25.resolve(import.meta.dirname, "..", "..", "..", "tools", "schema-graph-viewer");
-    const viewerDist = path25.join(viewerDir, "dist", "index.html");
-    if (fs14.existsSync(viewerDist)) {
-      fs14.copyFileSync(graphPath, path25.join(viewerDir, "dist", "graph.json"));
+    const tmpDir = fs17.mkdtempSync(path28.join(os.default.tmpdir(), "codegen-graph-"));
+    const graphPath = path28.join(tmpDir, "graph.json");
+    fs17.writeFileSync(graphPath, JSON.stringify(serialized, null, 2));
+    const viewerDir = path28.resolve(import.meta.dirname, "..", "..", "..", "tools", "schema-graph-viewer");
+    const viewerDist = path28.join(viewerDir, "dist", "index.html");
+    if (fs17.existsSync(viewerDist)) {
+      fs17.copyFileSync(graphPath, path28.join(viewerDir, "dist", "graph.json"));
       printSuccess("Graph exported");
       printInfo(`${result.entities.length} entities, ${result.relationshipDefinitions.length} relationships, ${result.graph.edges.length} edges`);
       printInfo(`Graph JSON: ${graphPath}`);
@@ -11988,18 +12485,19 @@ var projectNoun = {
     ProjectConfigCommand,
     ProjectInspectCommand,
     ProjectGraphCommand,
-    ProjectUpgradeOpenapiCommand
+    ProjectUpgradeOpenapiCommand,
+    ProjectUpdateCommand
   ],
-  summary: summary3,
-  hints: hints3
+  summary: summary4,
+  hints: hints4
 };
 var project_default = projectNoun;
 
 // src/cli/commands/dev.ts
-import fs15 from "fs";
-import path26 from "path";
+import fs18 from "fs";
+import path29 from "path";
 import { execSync as execSync3, spawn, spawnSync } from "child_process";
-import { Command as Command6, Option as Option6 } from "clipanion";
+import { Command as Command8, Option as Option8 } from "clipanion";
 var DEFAULT_APP_PORT = 3e3;
 var DEFAULT_PG_PORT = 5433;
 var DEFAULT_REDIS_PORT = 6380;
@@ -12030,33 +12528,33 @@ function getRedisPort(_ctx) {
   return Number(process.env.DEV_REDIS_PORT ?? DEFAULT_REDIS_PORT);
 }
 function composeFilePath(cwd) {
-  const devPath = path26.join(cwd, COMPOSE_FILE);
-  if (fs15.existsSync(devPath)) return devPath;
-  const rootPath = path26.join(cwd, "docker-compose.yml");
-  if (fs15.existsSync(rootPath)) return rootPath;
+  const devPath = path29.join(cwd, COMPOSE_FILE);
+  if (fs18.existsSync(devPath)) return devPath;
+  const rootPath = path29.join(cwd, "docker-compose.yml");
+  if (fs18.existsSync(rootPath)) return rootPath;
   return devPath;
 }
 function pidFilePath(cwd) {
-  return path26.join(cwd, PID_FILE);
+  return path29.join(cwd, PID_FILE);
 }
 function readAppPid(cwd) {
   const p = pidFilePath(cwd);
-  if (!fs15.existsSync(p)) return null;
-  const pid = parseInt(fs15.readFileSync(p, "utf-8").trim(), 10);
+  if (!fs18.existsSync(p)) return null;
+  const pid = parseInt(fs18.readFileSync(p, "utf-8").trim(), 10);
   if (isNaN(pid)) return null;
   try {
     process.kill(pid, 0);
     return pid;
   } catch {
-    fs15.rmSync(p, { force: true });
+    fs18.rmSync(p, { force: true });
     return null;
   }
 }
 function writeAppPid(cwd, pid) {
-  fs15.writeFileSync(pidFilePath(cwd), String(pid));
+  fs18.writeFileSync(pidFilePath(cwd), String(pid));
 }
 function clearAppPid(cwd) {
-  fs15.rmSync(pidFilePath(cwd), { force: true });
+  fs18.rmSync(pidFilePath(cwd), { force: true });
 }
 function checkPostgres(cwd, port) {
   const r = runCmd(`docker exec codegen-dev-postgres pg_isready -U postgres`, cwd, {
@@ -12096,8 +12594,10 @@ function checkApp(cwd, port) {
   };
 }
 function listEntityNames(ctx) {
-  if (!ctx.entitiesDir || !fs15.existsSync(ctx.entitiesDir)) return [];
-  return fs15.readdirSync(ctx.entitiesDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => f.replace(/\.ya?ml$/, ""));
+  if (!ctx.entitiesDir || !fs18.existsSync(ctx.entitiesDir)) return [];
+  return findYamlFiles(ctx.entitiesDir).map(
+    (f) => path29.basename(f).replace(/\.ya?ml$/, "")
+  );
 }
 function formatServiceLine(svc) {
   const icon = svc.healthy ? theme.success(icons.check) : theme.error(icons.error);
@@ -12106,8 +12606,8 @@ function formatServiceLine(svc) {
   return `${icon} ${svc.name.padEnd(12)}  ${theme.muted(`${svc.host}:${svc.port}`)}    ${status}${pidStr}`;
 }
 function ensureComposeFile(cwd, pgPort, redisPort) {
-  const composePath = path26.join(cwd, COMPOSE_FILE);
-  if (fs15.existsSync(composePath)) return composePath;
+  const composePath = path29.join(cwd, COMPOSE_FILE);
+  if (fs18.existsSync(composePath)) return composePath;
   const content = `# Auto-generated by codegen dev
 # Ports offset from defaults to avoid conflicts with other local services.
 services:
@@ -12142,22 +12642,22 @@ services:
 volumes:
   codegen-dev-pgdata:
 `;
-  fs15.writeFileSync(composePath, content);
+  fs18.writeFileSync(composePath, content);
   return composePath;
 }
-var DevUpCommand = class extends Command6 {
+var DevUpCommand = class extends Command8 {
   static paths = [["dev", "up"]];
-  static usage = Command6.Usage({
+  static usage = Command8.Usage({
     description: "Start Docker services (Postgres + Redis), run migrations, start the NestJS app",
     examples: [
       ["Start everything", "codegen dev up"],
       ["Skip app start (services only)", "codegen dev up --no-app"]
     ]
   });
-  noApp = Option6.Boolean("--no-app", false);
-  json = Option6.Boolean("--json", false);
-  cwd = Option6.String("--cwd", { required: false });
-  configPath = Option6.String("--config", { required: false });
+  noApp = Option8.Boolean("--no-app", false);
+  json = Option8.Boolean("--json", false);
+  cwd = Option8.String("--cwd", { required: false });
+  configPath = Option8.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12191,7 +12691,7 @@ var DevUpCommand = class extends Command6 {
     if (!pgReady) printWarning("postgres did not become healthy in time");
     if (!redisReady) printWarning("redis did not become healthy in time");
     const drizzleConfig = ["drizzle.config.ts", "drizzle.config.js"].find(
-      (f) => fs15.existsSync(path26.join(ctx.cwd, f))
+      (f) => fs18.existsSync(path29.join(ctx.cwd, f))
     );
     if (drizzleConfig) {
       if (!isJsonMode()) printInfo("pushing database schema...");
@@ -12211,8 +12711,8 @@ var DevUpCommand = class extends Command6 {
         if (!isJsonMode()) printInfo("starting NestJS app...");
         const dbUrl = `postgres://postgres:postgres@localhost:${pgPort}/codegen_dev`;
         const redisUrl = `redis://localhost:${redisPort}`;
-        const logFile = path26.join(ctx.cwd, ".dev-app.log");
-        const logFd = fs15.openSync(logFile, "a");
+        const logFile = path29.join(ctx.cwd, ".dev-app.log");
+        const logFd = fs18.openSync(logFile, "a");
         const child = spawn("bun", ["src/main.ts"], {
           cwd: ctx.cwd,
           detached: true,
@@ -12225,7 +12725,7 @@ var DevUpCommand = class extends Command6 {
           }
         });
         child.unref();
-        fs15.closeSync(logFd);
+        fs18.closeSync(logFd);
         if (child.pid) {
           writeAppPid(ctx.cwd, child.pid);
           spawnSync("sleep", ["2"]);
@@ -12255,15 +12755,15 @@ var DevUpCommand = class extends Command6 {
     return 0;
   }
 };
-var DevDownCommand = class extends Command6 {
+var DevDownCommand = class extends Command8 {
   static paths = [["dev", "down"]];
-  static usage = Command6.Usage({
+  static usage = Command8.Usage({
     description: "Stop Docker services and the NestJS app"
   });
-  volumes = Option6.Boolean("--volumes,-v", false);
-  json = Option6.Boolean("--json", false);
-  cwd = Option6.String("--cwd", { required: false });
-  configPath = Option6.String("--config", { required: false });
+  volumes = Option8.Boolean("--volumes,-v", false);
+  json = Option8.Boolean("--json", false);
+  cwd = Option8.String("--cwd", { required: false });
+  configPath = Option8.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12299,14 +12799,14 @@ var DevDownCommand = class extends Command6 {
     return 0;
   }
 };
-var DevStatusCommand = class extends Command6 {
+var DevStatusCommand = class extends Command8 {
   static paths = [["dev", "status"]];
-  static usage = Command6.Usage({
+  static usage = Command8.Usage({
     description: "Show status of Docker services and the NestJS app"
   });
-  json = Option6.Boolean("--json", false);
-  cwd = Option6.String("--cwd", { required: false });
-  configPath = Option6.String("--config", { required: false });
+  json = Option8.Boolean("--json", false);
+  cwd = Option8.String("--cwd", { required: false });
+  configPath = Option8.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12334,9 +12834,9 @@ var DevStatusCommand = class extends Command6 {
     return 0;
   }
 };
-var DevLogsCommand = class extends Command6 {
+var DevLogsCommand = class extends Command8 {
   static paths = [["dev", "logs"]];
-  static usage = Command6.Usage({
+  static usage = Command8.Usage({
     description: "Tail application and Docker service logs",
     examples: [
       ["Tail app logs", "codegen dev logs"],
@@ -12344,11 +12844,11 @@ var DevLogsCommand = class extends Command6 {
       ["Show last N lines", "codegen dev logs --tail 50"]
     ]
   });
-  docker = Option6.Boolean("--docker", false);
-  tail = Option6.String("--tail", "30");
-  json = Option6.Boolean("--json", false);
-  cwd = Option6.String("--cwd", { required: false });
-  configPath = Option6.String("--config", { required: false });
+  docker = Option8.Boolean("--docker", false);
+  tail = Option8.String("--tail", "30");
+  json = Option8.Boolean("--json", false);
+  cwd = Option8.String("--cwd", { required: false });
+  configPath = Option8.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12369,8 +12869,8 @@ var DevLogsCommand = class extends Command6 {
       }
       return 0;
     }
-    const logFile = path26.join(ctx.cwd, ".dev-app.log");
-    if (!fs15.existsSync(logFile)) {
+    const logFile = path29.join(ctx.cwd, ".dev-app.log");
+    if (!fs18.existsSync(logFile)) {
       printInfo("no app logs found \u2014 is the app running?");
       return 0;
     }
@@ -12382,14 +12882,14 @@ var DevLogsCommand = class extends Command6 {
     return 0;
   }
 };
-var DevRestartCommand = class extends Command6 {
+var DevRestartCommand = class extends Command8 {
   static paths = [["dev", "restart"]];
-  static usage = Command6.Usage({
+  static usage = Command8.Usage({
     description: "Restart the NestJS app (keep Docker services running)"
   });
-  json = Option6.Boolean("--json", false);
-  cwd = Option6.String("--cwd", { required: false });
-  configPath = Option6.String("--config", { required: false });
+  json = Option8.Boolean("--json", false);
+  cwd = Option8.String("--cwd", { required: false });
+  configPath = Option8.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12413,8 +12913,8 @@ var DevRestartCommand = class extends Command6 {
     spawnSync("sleep", ["1"]);
     const dbUrl = `postgres://postgres:postgres@localhost:${pgPort}/codegen_dev`;
     const redisUrl = `redis://localhost:${redisPort}`;
-    const logFile = path26.join(ctx.cwd, ".dev-app.log");
-    const logFd = fs15.openSync(logFile, "a");
+    const logFile = path29.join(ctx.cwd, ".dev-app.log");
+    const logFd = fs18.openSync(logFile, "a");
     const child = spawn("bun", ["src/main.ts"], {
       cwd: ctx.cwd,
       detached: true,
@@ -12427,7 +12927,7 @@ var DevRestartCommand = class extends Command6 {
       }
     });
     child.unref();
-    fs15.closeSync(logFd);
+    fs18.closeSync(logFd);
     if (child.pid) {
       writeAppPid(ctx.cwd, child.pid);
       spawnSync("sleep", ["2"]);
@@ -12489,7 +12989,7 @@ function renderDevStatus(ctx) {
     { command: "/dev-test", description: "Run test suite + endpoint verification" }
   ]);
 }
-async function summary4(ctx) {
+async function summary5(ctx) {
   const pgPort = getPgPort(ctx);
   const redisPort = getRedisPort(ctx);
   const appPort = getAppPort(ctx);
@@ -12513,7 +13013,7 @@ async function summary4(ctx) {
     footer: `${running}/${total} services healthy`
   };
 }
-async function hints4(ctx) {
+async function hints5(ctx) {
   const app = checkApp(ctx.cwd, getAppPort(ctx));
   if (!app.healthy) {
     return [
@@ -12536,21 +13036,20 @@ var devNoun = {
     DevLogsCommand,
     DevRestartCommand
   ],
-  summary: summary4,
-  hints: hints4
+  summary: summary5,
+  hints: hints5
 };
 var dev_default = devNoun;
 
 // src/cli/commands/relationship.ts
-import fs16 from "fs";
-import path27 from "path";
-import { Command as Command7, Option as Option7 } from "clipanion";
+import fs19 from "fs";
+import path30 from "path";
+import { Command as Command9, Option as Option9 } from "clipanion";
 function listRelationshipYamls2(dir) {
-  if (!fs16.existsSync(dir)) return [];
-  return fs16.readdirSync(dir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).filter((f) => {
-    const fullPath = path27.join(dir, f);
-    return detectYamlType(fullPath) === "relationship";
-  }).map((f) => path27.join(dir, f));
+  if (!fs19.existsSync(dir)) return [];
+  return findYamlFiles(dir).filter(
+    (full) => detectYamlType(full) === "relationship"
+  );
 }
 function summarizeRelationshipFile(filePath) {
   const result = loadRelationshipFromYaml(filePath);
@@ -12570,8 +13069,8 @@ function summarizeRelationshipFile(filePath) {
 function padRight2(s, n) {
   return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
-async function summary5(ctx) {
-  const relDir = path27.resolve(ctx.cwd, "relationships");
+async function summary6(ctx) {
+  const relDir = path30.resolve(ctx.cwd, "relationships");
   const files = listRelationshipYamls2(relDir);
   if (files.length === 0) {
     return {
@@ -12603,16 +13102,16 @@ async function summary5(ctx) {
     footer: `${rows.length} relationships`
   };
 }
-async function hints5(_ctx) {
+async function hints6(_ctx) {
   return [
     { command: "codegen relationship new <file>", description: "Generate one relationship" },
     { command: "codegen relationship new --all", description: "Generate all relationships" },
     { command: "codegen relationship list", description: "List relationship definitions" }
   ];
 }
-var RelationshipNewCommand = class extends Command7 {
+var RelationshipNewCommand = class extends Command9 {
   static paths = [["relationship", "new"]];
-  static usage = Command7.Usage({
+  static usage = Command9.Usage({
     description: "Generate code for one or more relationships from YAML",
     examples: [
       ["Generate a single relationship", "codegen relationship new relationships/person_organization.yaml"],
@@ -12620,13 +13119,13 @@ var RelationshipNewCommand = class extends Command7 {
       ["Preview without writing", "codegen relationship new relationships/person_organization.yaml --dry-run"]
     ]
   });
-  yaml = Option7.String({ required: false });
-  all = Option7.Boolean("--all", false);
-  dryRun = Option7.Boolean("--dry-run", false);
-  force = Option7.Boolean("--force", false);
-  json = Option7.Boolean("--json", false);
-  cwd = Option7.String("--cwd", { required: false });
-  configPath = Option7.String("--config", { required: false });
+  yaml = Option9.String({ required: false });
+  all = Option9.Boolean("--all", false);
+  dryRun = Option9.Boolean("--dry-run", false);
+  force = Option9.Boolean("--force", false);
+  json = Option9.Boolean("--json", false);
+  cwd = Option9.String("--cwd", { required: false });
+  configPath = Option9.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12641,14 +13140,14 @@ var RelationshipNewCommand = class extends Command7 {
     }
     let targets = [];
     if (this.all) {
-      const dir = path27.resolve(ctx.cwd, "relationships");
+      const dir = path30.resolve(ctx.cwd, "relationships");
       targets = listRelationshipYamls2(dir);
       if (targets.length === 0) {
         printError(`No relationship YAML files found in ${dir}`);
         return 1;
       }
     } else if (this.yaml) {
-      targets = [path27.resolve(ctx.cwd, this.yaml)];
+      targets = [path30.resolve(ctx.cwd, this.yaml)];
     } else {
       printError("Missing YAML path. Pass a file or --all.");
       return 2;
@@ -12665,7 +13164,7 @@ var RelationshipNewCommand = class extends Command7 {
     }
     if (invalid.length > 0) {
       for (const i of invalid) {
-        printError(`${path27.basename(i.file)} \u2014 ${i.message}`);
+        printError(`${path30.basename(i.file)} \u2014 ${i.message}`);
       }
       if (!isJsonMode()) return 1;
     }
@@ -12696,7 +13195,7 @@ var RelationshipNewCommand = class extends Command7 {
     }
     const succeeded = [];
     const failed = [
-      ...invalid.map((i) => ({ name: path27.basename(i.file), file: i.file, message: i.message }))
+      ...invalid.map((i) => ({ name: path30.basename(i.file), file: i.file, message: i.message }))
     ];
     for (const v of validated) {
       if (!isJsonMode()) {
@@ -12715,8 +13214,8 @@ var RelationshipNewCommand = class extends Command7 {
         if (!isJsonMode()) printError(`${v.name} \u2014 ${res.stderr ?? "failed"}`);
       }
     }
-    const entitiesDir = ctx.entitiesDir ?? path27.resolve(ctx.cwd, "entities");
-    const relationshipsDir = path27.resolve(ctx.cwd, "relationships");
+    const entitiesDir = ctx.entitiesDir ?? path30.resolve(ctx.cwd, "entities");
+    const relationshipsDir = path30.resolve(ctx.cwd, "relationships");
     const generatedDir = resolveGeneratedDir(ctx);
     const architecture = resolveArchitecture(ctx);
     let barrelResult = null;
@@ -12761,21 +13260,21 @@ var RelationshipNewCommand = class extends Command7 {
       }
       if (barrelResult) {
         printInfo(
-          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path27.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path27.relative(ctx.cwd, barrelResult.schemaBarrel)}`
+          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path30.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path30.relative(ctx.cwd, barrelResult.schemaBarrel)}`
         );
       }
     }
     return failed.length === 0 ? 0 : 1;
   }
 };
-var RelationshipListCommand = class extends Command7 {
+var RelationshipListCommand = class extends Command9 {
   static paths = [["relationship", "list"]];
-  static usage = Command7.Usage({
+  static usage = Command9.Usage({
     description: "List defined relationships as a table"
   });
-  json = Option7.Boolean("--json", false);
-  cwd = Option7.String("--cwd", { required: false });
-  configPath = Option7.String("--config", { required: false });
+  json = Option9.Boolean("--json", false);
+  cwd = Option9.String("--cwd", { required: false });
+  configPath = Option9.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12784,7 +13283,7 @@ var RelationshipListCommand = class extends Command7 {
       json: this.json,
       skipDetection: true
     });
-    const relDir = path27.resolve(ctx.cwd, "relationships");
+    const relDir = path30.resolve(ctx.cwd, "relationships");
     const files = listRelationshipYamls2(relDir);
     if (files.length === 0) {
       printInfo("No relationship definitions found.");
@@ -12818,14 +13317,14 @@ var RelationshipListCommand = class extends Command7 {
 var relationshipNoun = {
   name: "relationship",
   commandClasses: [RelationshipNewCommand, RelationshipListCommand],
-  summary: summary5,
-  hints: hints5
+  summary: summary6,
+  hints: hints6
 };
 var relationship_default = relationshipNoun;
 
 // src/cli/commands/junction.ts
-import path28 from "path";
-import { Command as Command8, Option as Option8 } from "clipanion";
+import path31 from "path";
+import { Command as Command10, Option as Option10 } from "clipanion";
 function summarizeJunctionFile(filePath) {
   const result = loadJunctionFromYaml(filePath);
   if (!result.success) return null;
@@ -12846,8 +13345,8 @@ function summarizeJunctionFile(filePath) {
 function padRight3(s, n) {
   return s.length >= n ? s : s + " ".repeat(n - s.length);
 }
-async function summary6(ctx) {
-  const junctionDir = path28.resolve(ctx.cwd, "junctions");
+async function summary7(ctx) {
+  const junctionDir = path31.resolve(ctx.cwd, "junctions");
   const files = listJunctionYamls(junctionDir);
   if (files.length === 0) {
     return {
@@ -12879,16 +13378,16 @@ async function summary6(ctx) {
     footer: `${rows.length} junctions`
   };
 }
-async function hints6(_ctx) {
+async function hints7(_ctx) {
   return [
     { command: "codegen junction new <file>", description: "Generate one junction" },
     { command: "codegen junction new --all", description: "Generate all junctions" },
     { command: "codegen junction list", description: "List junction definitions" }
   ];
 }
-var JunctionNewCommand = class extends Command8 {
+var JunctionNewCommand = class extends Command10 {
   static paths = [["junction", "new"]];
-  static usage = Command8.Usage({
+  static usage = Command10.Usage({
     description: "Generate code for one or more junctions from YAML",
     examples: [
       ["Generate a single junction", "codegen junction new junctions/opportunity_contact.yaml"],
@@ -12896,13 +13395,13 @@ var JunctionNewCommand = class extends Command8 {
       ["Preview without writing", "codegen junction new junctions/opportunity_contact.yaml --dry-run"]
     ]
   });
-  yaml = Option8.String({ required: false });
-  all = Option8.Boolean("--all", false);
-  dryRun = Option8.Boolean("--dry-run", false);
-  force = Option8.Boolean("--force", false);
-  json = Option8.Boolean("--json", false);
-  cwd = Option8.String("--cwd", { required: false });
-  configPath = Option8.String("--config", { required: false });
+  yaml = Option10.String({ required: false });
+  all = Option10.Boolean("--all", false);
+  dryRun = Option10.Boolean("--dry-run", false);
+  force = Option10.Boolean("--force", false);
+  json = Option10.Boolean("--json", false);
+  cwd = Option10.String("--cwd", { required: false });
+  configPath = Option10.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -12917,14 +13416,14 @@ var JunctionNewCommand = class extends Command8 {
     }
     let targets = [];
     if (this.all) {
-      const dir = path28.resolve(ctx.cwd, "junctions");
+      const dir = path31.resolve(ctx.cwd, "junctions");
       targets = listJunctionYamls(dir);
       if (targets.length === 0) {
         printError(`No junction YAML files found in ${dir}`);
         return 1;
       }
     } else if (this.yaml) {
-      targets = [path28.resolve(ctx.cwd, this.yaml)];
+      targets = [path31.resolve(ctx.cwd, this.yaml)];
     } else {
       printError("Missing YAML path. Pass a file or --all.");
       return 2;
@@ -12943,7 +13442,7 @@ var JunctionNewCommand = class extends Command8 {
     }
     if (invalid.length > 0) {
       for (const i of invalid) {
-        printError(`${path28.basename(i.file)} \u2014 ${i.message}`);
+        printError(`${path31.basename(i.file)} \u2014 ${i.message}`);
       }
       if (!isJsonMode()) return 1;
     }
@@ -12974,7 +13473,7 @@ var JunctionNewCommand = class extends Command8 {
     }
     const succeeded = [];
     const failed = [
-      ...invalid.map((i) => ({ name: path28.basename(i.file), file: i.file, message: i.message }))
+      ...invalid.map((i) => ({ name: path31.basename(i.file), file: i.file, message: i.message }))
     ];
     for (const v of validated) {
       if (!isJsonMode()) {
@@ -12993,9 +13492,9 @@ var JunctionNewCommand = class extends Command8 {
         if (!isJsonMode()) printError(`${v.name} \u2014 ${res.stderr ?? "failed"}`);
       }
     }
-    const entitiesDir = ctx.entitiesDir ?? path28.resolve(ctx.cwd, "entities");
-    const relationshipsDir = path28.resolve(ctx.cwd, "relationships");
-    const junctionsDir = path28.resolve(ctx.cwd, "junctions");
+    const entitiesDir = ctx.entitiesDir ?? path31.resolve(ctx.cwd, "entities");
+    const relationshipsDir = path31.resolve(ctx.cwd, "relationships");
+    const junctionsDir = path31.resolve(ctx.cwd, "junctions");
     const generatedDir = resolveGeneratedDir(ctx);
     const architecture = resolveArchitecture(ctx);
     let barrelResult = null;
@@ -13041,21 +13540,21 @@ var JunctionNewCommand = class extends Command8 {
       }
       if (barrelResult) {
         printInfo(
-          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path28.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path28.relative(ctx.cwd, barrelResult.schemaBarrel)}`
+          `barrels regenerated (${barrelResult.entityCount} modules) \u2192 ${path31.relative(ctx.cwd, barrelResult.modulesBarrel)}, ${path31.relative(ctx.cwd, barrelResult.schemaBarrel)}`
         );
       }
     }
     return failed.length === 0 ? 0 : 1;
   }
 };
-var JunctionListCommand = class extends Command8 {
+var JunctionListCommand = class extends Command10 {
   static paths = [["junction", "list"]];
-  static usage = Command8.Usage({
+  static usage = Command10.Usage({
     description: "List defined junctions as a table"
   });
-  json = Option8.Boolean("--json", false);
-  cwd = Option8.String("--cwd", { required: false });
-  configPath = Option8.String("--config", { required: false });
+  json = Option10.Boolean("--json", false);
+  cwd = Option10.String("--cwd", { required: false });
+  configPath = Option10.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -13064,7 +13563,7 @@ var JunctionListCommand = class extends Command8 {
       json: this.json,
       skipDetection: true
     });
-    const junctionDir = path28.resolve(ctx.cwd, "junctions");
+    const junctionDir = path31.resolve(ctx.cwd, "junctions");
     const files = listJunctionYamls(junctionDir);
     if (files.length === 0) {
       printInfo("No junction definitions found.");
@@ -13098,16 +13597,16 @@ var JunctionListCommand = class extends Command8 {
 var junctionNoun = {
   name: "junction",
   commandClasses: [JunctionNewCommand, JunctionListCommand],
-  summary: summary6,
-  hints: hints6
+  summary: summary7,
+  hints: hints7
 };
 var junction_default = junctionNoun;
 
 // src/cli/commands/events.ts
-import fs17 from "fs";
-import path29 from "path";
+import fs20 from "fs";
+import path32 from "path";
 import ts2 from "typescript";
-import { Command as Command9, Option as Option9 } from "clipanion";
+import { Command as Command11, Option as Option11 } from "clipanion";
 function scanSourceFileForConsumers(sourceFile, filePath, eventType) {
   const tier2 = [];
   const tier1 = [];
@@ -13204,7 +13703,7 @@ function scanDirectoryForConsumers(rootDir, eventType) {
   const tier1 = [];
   let hasEventFlowImport = false;
   for (const filePath of files) {
-    const text2 = fs17.readFileSync(filePath, "utf8");
+    const text2 = fs20.readFileSync(filePath, "utf8");
     const sourceFile = ts2.createSourceFile(
       filePath,
       text2,
@@ -13241,7 +13740,7 @@ function suggestEventTypes(target, known, limit = 3) {
   return known.map((t) => ({ t, d: levenshtein(target, t) })).sort((a, b) => a.d - b.d).slice(0, limit).map((x) => x.t);
 }
 function renderConsumerReport(result, cwd) {
-  const rel = (p) => path29.relative(cwd, p) || p;
+  const rel2 = (p) => path32.relative(cwd, p) || p;
   const lines = [];
   const total = result.tier3.length + result.tier2.length + result.tier1.length;
   lines.push(`Event: ${result.eventType}`);
@@ -13255,7 +13754,7 @@ function renderConsumerReport(result, cwd) {
     const labelWidth = Math.max(...result.tier3.map((h) => h.triggerId.length)) + 2;
     for (const h of result.tier3) {
       const padded = h.triggerId.padEnd(labelWidth);
-      lines.push(`  - ${padded}(${rel(h.sourceFile)}:${h.sourceLine})`);
+      lines.push(`  - ${padded}(${rel2(h.sourceFile)}:${h.sourceLine})`);
     }
   }
   lines.push(`Tier 2 \u2014 Direct invoke via publishAndStart (${result.tier2.length}):`);
@@ -13263,7 +13762,7 @@ function renderConsumerReport(result, cwd) {
     lines.push("  - (none)");
   } else {
     for (const h of result.tier2) {
-      lines.push(`  - ${rel(h.sourceFile)}:${h.sourceLine}`);
+      lines.push(`  - ${rel2(h.sourceFile)}:${h.sourceLine}`);
     }
   }
   lines.push(`Tier 1 \u2014 Subscribers (${result.tier1.length}):`);
@@ -13271,13 +13770,13 @@ function renderConsumerReport(result, cwd) {
     lines.push("  - (none)");
   } else {
     for (const h of result.tier1) {
-      lines.push(`  - ${h.siteLabel} at ${rel(h.sourceFile)}:${h.sourceLine}`);
+      lines.push(`  - ${h.siteLabel} at ${rel2(h.sourceFile)}:${h.sourceLine}`);
     }
   }
   return lines;
 }
 function runConsumersScan(opts) {
-  const scanRoot = opts.scanRoot ?? path29.join(opts.cwd, "src");
+  const scanRoot = opts.scanRoot ?? path32.join(opts.cwd, "src");
   const handlersDir = opts.handlersDir ?? scanRoot;
   const allTriggers = scanHandlerFiles(handlersDir);
   const tier3 = allTriggers.filter((t) => t.event === opts.eventType).map((t) => ({
@@ -13286,8 +13785,8 @@ function runConsumersScan(opts) {
     sourceFile: t.sourceFile,
     sourceLine: t.sourceLine
   }));
-  const tier21 = fs17.existsSync(scanRoot) ? scanDirectoryForConsumers(scanRoot, opts.eventType) : { tier2: [], tier1: [], hasEventFlowImport: false };
-  const eventsGeneratedDir = opts.eventsGeneratedDir ?? path29.join(
+  const tier21 = fs20.existsSync(scanRoot) ? scanDirectoryForConsumers(scanRoot, opts.eventType) : { tier2: [], tier1: [], hasEventFlowImport: false };
+  const eventsGeneratedDir = opts.eventsGeneratedDir ?? path32.join(
     resolveSubsystemsRootFromContext(opts.cwd, opts.config),
     "events",
     "generated"
@@ -13308,15 +13807,15 @@ function runConsumersScan(opts) {
 function resolveSubsystemsRootFromContext(cwd, config) {
   const configured = config?.paths?.subsystems;
   if (typeof configured === "string" && configured.length > 0) {
-    return path29.resolve(cwd, configured);
+    return path32.resolve(cwd, configured);
   }
   const backendSrc = config?.paths?.backend_src;
   const base = typeof backendSrc === "string" && backendSrc.length > 0 ? backendSrc : "src";
-  return path29.resolve(cwd, base, "shared", "subsystems");
+  return path32.resolve(cwd, base, "shared", "subsystems");
 }
-var EventsConsumersCommand = class extends Command9 {
+var EventsConsumersCommand = class extends Command11 {
   static paths = [["events", "consumers"]];
-  static usage = Command9.Usage({
+  static usage = Command11.Usage({
     description: "List all consumers of an event across the three tiers",
     examples: [
       [
@@ -13325,10 +13824,10 @@ var EventsConsumersCommand = class extends Command9 {
       ]
     ]
   });
-  eventType = Option9.String({ required: true });
-  json = Option9.Boolean("--json", false);
-  cwd = Option9.String("--cwd", { required: false });
-  configPath = Option9.String("--config", { required: false });
+  eventType = Option11.String({ required: true });
+  json = Option11.Boolean("--json", false);
+  cwd = Option11.String("--cwd", { required: false });
+  configPath = Option11.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -13373,7 +13872,7 @@ var EventsConsumersCommand = class extends Command9 {
     return 0;
   }
 };
-async function summary7(_ctx) {
+async function summary8(_ctx) {
   return {
     title: "events",
     body: [
@@ -13384,7 +13883,7 @@ async function summary7(_ctx) {
     ]
   };
 }
-async function hints7(_ctx) {
+async function hints8(_ctx) {
   return [
     {
       command: "codegen events consumers <type>",
@@ -13395,14 +13894,14 @@ async function hints7(_ctx) {
 var eventsNoun = {
   name: "events",
   commandClasses: [EventsConsumersCommand],
-  summary: summary7,
-  hints: hints7
+  summary: summary8,
+  hints: hints8
 };
 var events_default = eventsNoun;
 
 // src/cli/commands/orchestration.ts
-import path30 from "path";
-import { Command as Command10, Option as Option10 } from "clipanion";
+import path33 from "path";
+import { Command as Command12, Option as Option12 } from "clipanion";
 var DEFAULT_PATTERN_GLOBS = ["src/patterns/*.pattern.ts"];
 function resolvePatternGlobs(ctx) {
   const fromConfig = ctx.config?.patterns;
@@ -13415,26 +13914,26 @@ function resolveOrchestrationOutputRoot(ctx) {
   const paths = ctx.config?.paths;
   const explicit = paths?.orchestration_src;
   if (typeof explicit === "string" && explicit.length > 0) {
-    return path30.resolve(ctx.cwd, explicit);
+    return path33.resolve(ctx.cwd, explicit);
   }
   const backendSrc = typeof paths?.backend_src === "string" && paths.backend_src.length > 0 ? paths.backend_src : "app/backend/src";
-  return path30.resolve(ctx.cwd, backendSrc, "orchestration");
+  return path33.resolve(ctx.cwd, backendSrc, "orchestration");
 }
 async function reloadRegistry(ctx) {
   _resetRegistryForTests({ includeLibrary: false });
   return loadAppPatterns(resolvePatternGlobs(ctx), ctx.cwd);
 }
-var OrchestrationGenCommand = class extends Command10 {
+var OrchestrationGenCommand = class extends Command12 {
   static paths = [["orchestration", "gen"]];
-  static usage = Command10.Usage({
+  static usage = Command12.Usage({
     description: "Emit token / providers / dispatcher / module files per orchestration pattern (ADR-032 Phase 3-2/3)."
   });
-  pattern = Option10.String("--pattern", { required: false });
-  all = Option10.Boolean("--all", false);
-  dryRun = Option10.Boolean("--dry-run", false);
-  json = Option10.Boolean("--json", false);
-  cwd = Option10.String("--cwd", { required: false });
-  configPath = Option10.String("--config", { required: false });
+  pattern = Option12.String("--pattern", { required: false });
+  all = Option12.Boolean("--all", false);
+  dryRun = Option12.Boolean("--dry-run", false);
+  json = Option12.Boolean("--json", false);
+  cwd = Option12.String("--cwd", { required: false });
+  configPath = Option12.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -13507,12 +14006,12 @@ var OrchestrationGenCommand = class extends Command10 {
         );
         for (const f of result.files) {
           console.log(
-            `  ${theme.muted(icons.arrow)} ${path30.relative(ctx.cwd, f.outputPath)}`
+            `  ${theme.muted(icons.arrow)} ${path33.relative(ctx.cwd, f.outputPath)}`
           );
         }
       } else {
         printSuccess(
-          `Emitted ${result.files.length} file(s) across ${targets.length} pattern(s) \u2192 ${path30.relative(ctx.cwd, outputRoot)}`
+          `Emitted ${result.files.length} file(s) across ${targets.length} pattern(s) \u2192 ${path33.relative(ctx.cwd, outputRoot)}`
         );
       }
       return 0;
@@ -13525,14 +14024,14 @@ var OrchestrationGenCommand = class extends Command10 {
     }
   }
 };
-var OrchestrationListCommand = class extends Command10 {
+var OrchestrationListCommand = class extends Command12 {
   static paths = [["orchestration", "list"]];
-  static usage = Command10.Usage({
+  static usage = Command12.Usage({
     description: "List registered orchestration patterns"
   });
-  json = Option10.Boolean("--json", false);
-  cwd = Option10.String("--cwd", { required: false });
-  configPath = Option10.String("--config", { required: false });
+  json = Option12.Boolean("--json", false);
+  cwd = Option12.String("--cwd", { required: false });
+  configPath = Option12.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -13576,14 +14075,14 @@ var OrchestrationListCommand = class extends Command10 {
     return 0;
   }
 };
-var OrchestrationValidateCommand = class extends Command10 {
+var OrchestrationValidateCommand = class extends Command12 {
   static paths = [["orchestration", "validate"]];
-  static usage = Command10.Usage({
+  static usage = Command12.Usage({
     description: "Run the Phase 3-1 project-level orchestration validator (ADR-032)"
   });
-  json = Option10.Boolean("--json", false);
-  cwd = Option10.String("--cwd", { required: false });
-  configPath = Option10.String("--config", { required: false });
+  json = Option12.Boolean("--json", false);
+  cwd = Option12.String("--cwd", { required: false });
+  configPath = Option12.String("--config", { required: false });
   async execute() {
     if (this.json) setJsonMode(true);
     const ctx = await loadContext({
@@ -13619,7 +14118,7 @@ var OrchestrationValidateCommand = class extends Command10 {
     return errors.length === 0 && loadResult.errors.length === 0 ? 0 : 1;
   }
 };
-async function summary8(ctx) {
+async function summary9(ctx) {
   try {
     await reloadRegistry(ctx);
   } catch {
@@ -13633,7 +14132,7 @@ async function summary8(ctx) {
     ]
   };
 }
-async function hints8(_ctx) {
+async function hints9(_ctx) {
   return [
     {
       command: "codegen orchestration gen",
@@ -13656,8 +14155,8 @@ var orchestrationNoun = {
     OrchestrationListCommand,
     OrchestrationValidateCommand
   ],
-  summary: summary8,
-  hints: hints8
+  summary: summary9,
+  hints: hints9
 };
 var orchestration_default = orchestrationNoun;
 
@@ -13668,19 +14167,26 @@ var InitShortcut = class extends ProjectInitCommand {
 };
 var init_default = InitShortcut;
 
+// src/cli/shortcuts/update.ts
+var UpdateShortcut = class extends ProjectUpdateCommand {
+  static paths = [["update"]];
+  static usage = ProjectUpdateCommand.usage;
+};
+var update_default = UpdateShortcut;
+
 // src/cli/index.ts
 function readVersion() {
   try {
-    const pkgPath = join11(import.meta.dirname, "..", "..", "package.json");
+    const pkgPath = join10(import.meta.dirname, "..", "..", "package.json");
     const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
     return typeof pkg.version === "string" ? pkg.version : "0.0.0";
   } catch {
     return "0.0.0";
   }
 }
-var RootSummaryCommand = class extends Command11 {
-  static paths = [Command11.Default];
-  static usage = Command11.Usage({
+var RootSummaryCommand = class extends Command13 {
+  static paths = [Command13.Default];
+  static usage = Command13.Usage({
     description: "Show project status and available noun commands"
   });
   async execute() {
@@ -13722,6 +14228,7 @@ var nouns = [
   entity_default,
   subsystem_default,
   project_default,
+  skills_default,
   dev_default,
   relationship_default,
   junction_default,
@@ -13740,6 +14247,7 @@ async function main() {
   cli.register(Builtins.VersionCommand);
   cli.register(RootSummaryCommand);
   cli.register(init_default);
+  cli.register(update_default);
   for (const noun of nouns) {
     for (const CommandClass of noun.commandClasses) {
       cli.register(CommandClass);