@stardeck-customer-apps/compose 0.8.0 → 0.10.0

package/dist/index.mjs

@@ -2020,8 +2020,8 @@ var require_semver2 = __commonJS({
 
 // src/index.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 
 // ../../packages/lib/src/server/module-rail/local-fs-sandbox.ts
 import { spawnSync } from "child_process";
@@ -2080,11 +2080,54 @@ function shellQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 
-// ../../packages/lib/src/shared/module-composition.ts
-import { z as z6 } from "zod";
+// ../../packages/lib/src/shared/compose-inputs.ts
+import { z } from "zod";
+var COMPOSE_INPUTS_PATH = "apps/web/stardeck.compose.json";
+var composeInputsSchema = z.strictObject({
+  connectedStores: z.array(
+    z.strictObject({
+      storeId: z.string().min(1),
+      slug: z.string().min(1),
+      // A row with an empty binding key must not fail a deploy: the rail
+      // treats falsy as "no binding key", so normalise rather than reject.
+      bindingKey: z.string().nullish().transform((value) => value || null),
+      accessLevel: z.enum(["read", "write", "admin"]),
+      // Defaulted so a file written before the platform emitted store types
+      // (database rows only) still parses. The platform starts writing
+      // storage rows, with `type` set, once forks run a compose that reads it.
+      type: z.enum(["database", "storage"]).default("database")
+    })
+  ).default([]),
+  installs: z.record(
+    z.string(),
+    z.strictObject({
+      installedVersion: z.string().min(1),
+      datastoreBindings: z.record(z.string(), z.string()).nullish()
+    })
+  ).default({})
+});
+var STUB_IGNORE_PATH = "apps/web/src/app/.gitignore";
+var STUB_IGNORE_HEADER = "# Generated by stardeck-compose \u2014 Module-rail stubs are build outputs; do not edit or commit them.";
+function escapeStubIgnorePattern(pattern) {
+  const escaped = pattern.replace(/[\\[\]*?]/g, (char) => `\\${char}`);
+  return /^[#!]/.test(escaped) ? `\\${escaped}` : escaped;
+}
+function buildStubIgnore(artifactPaths) {
+  const prefix = "apps/web/src/app/";
+  const entries = artifactPaths.filter((artifact) => artifact.startsWith(prefix)).map((artifact) => escapeStubIgnorePattern(`/${artifact.slice(prefix.length)}`)).sort();
+  return [STUB_IGNORE_HEADER, ...entries].join("\n") + "\n";
+}
+
+// ../../packages/lib/src/shared/module-enablement.ts
+function isModuleEnabledByList(raw, name, kindOf) {
+  if (!raw) return true;
+  const kind = kindOf(name);
+  if (kind != null && kind !== "feature") return true;
+  return raw.split(",").includes(name);
+}
 
 // ../../packages/module-contract/src/module-manifest.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 
 // ../../packages/module-contract/src/slug.ts
 function validateSlug(slug) {
@@ -2119,30 +2162,30 @@ var ROUTE_GROUP_REGEX = /^\([a-z0-9-]+\)$/;
 var ENDPOINT_STATIC_SEGMENT_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var ENDPOINT_PARAM_NAME_REGEX = /^[a-z][a-z0-9_-]*$/;
 var ENDPOINT_METHODS = ["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"];
-var moduleNameSchema = z.string().max(40).regex(KEBAB_SLUG_REGEX, "must be a kebab-case slug (lowercase letters, digits, hyphens)");
+var moduleNameSchema = z2.string().max(40).regex(KEBAB_SLUG_REGEX, "must be a kebab-case slug (lowercase letters, digits, hyphens)");
 function isValidModuleName(value) {
   return moduleNameSchema.safeParse(value).success;
 }
-var projectSlugSchema = z.string().refine((value) => validateSlug(value).valid, "must be a valid project slug");
-var moduleKindSchema = z.enum(["feature", "library", "contract"]);
-var endpointMethodSchema = z.enum(ENDPOINT_METHODS);
-function endpointPathValidationError(path3) {
-  if (!path3.startsWith("/api/")) {
+var projectSlugSchema = z2.string().refine((value) => validateSlug(value).valid, "must be a valid project slug");
+var moduleKindSchema = z2.enum(["feature", "library", "contract"]);
+var endpointMethodSchema = z2.enum(ENDPOINT_METHODS);
+function endpointPathValidationError(path4) {
+  if (!path4.startsWith("/api/")) {
     return 'must begin with "/api/"';
   }
-  if (path3.endsWith("/")) {
+  if (path4.endsWith("/")) {
     return "must not end with a trailing slash";
   }
-  if (path3.includes("?") || path3.includes("#")) {
+  if (path4.includes("?") || path4.includes("#")) {
     return "must not include query or hash";
   }
-  if (path3.includes("\\")) {
+  if (path4.includes("\\")) {
     return "must not include backslashes";
   }
-  if (path3.includes("%")) {
+  if (path4.includes("%")) {
     return "must not include percent-encoded segments";
   }
-  const parts = path3.split("/");
+  const parts = path4.split("/");
   if (parts.length < 3 || parts[0] !== "" || parts[1] !== "api") {
     return 'must begin with "/api/"';
   }
@@ -2192,12 +2235,12 @@ function endpointPathValidationError(path3) {
   }
   return null;
 }
-function normalizeEndpointPathForCollision(path3) {
-  const error = endpointPathValidationError(path3);
+function normalizeEndpointPathForCollision(path4) {
+  const error = endpointPathValidationError(path4);
   if (error != null) {
     throw new Error(`invalid endpoint path: ${error}`);
   }
-  return path3.split("/").map((segment, index) => {
+  return path4.split("/").map((segment, index) => {
     if (index < 2) {
       return segment;
     }
@@ -2210,21 +2253,21 @@ function normalizeEndpointPathForCollision(path3) {
     return segment;
   }).join("/");
 }
-var endpointPathSchema = z.string().superRefine((path3, ctx) => {
-  const error = endpointPathValidationError(path3);
+var endpointPathSchema = z2.string().superRefine((path4, ctx) => {
+  const error = endpointPathValidationError(path4);
   if (error != null) {
-    ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
+    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: error });
   }
 });
-var endpointClaimSchema = z.object({
+var endpointClaimSchema = z2.object({
   path: endpointPathSchema,
-  methods: z.array(endpointMethodSchema).min(1, "methods must be non-empty").superRefine((methods, ctx) => {
+  methods: z2.array(endpointMethodSchema).min(1, "methods must be non-empty").superRefine((methods, ctx) => {
     const seen = /* @__PURE__ */ new Set();
     for (let i = 0; i < methods.length; i += 1) {
       const method = methods[i];
       if (seen.has(method)) {
         ctx.addIssue({
-          code: z.ZodIssueCode.custom,
+          code: z2.ZodIssueCode.custom,
           message: `duplicate method "${method}"`,
           path: [i]
         });
@@ -2261,14 +2304,14 @@ function mountSegmentValidationError(segment) {
   }
   return null;
 }
-var mountSegmentSchema = z.string().superRefine((segment, ctx) => {
+var mountSegmentSchema = z2.string().superRefine((segment, ctx) => {
   const error = mountSegmentValidationError(segment);
   if (error != null) {
-    ctx.addIssue({ code: z.ZodIssueCode.custom, message: error });
+    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: error });
   }
 });
-var mountSchema = z.object({
-  group: z.string().regex(ROUTE_GROUP_REGEX, 'must be a Next.js route group like "(admin)"'),
+var mountSchema = z2.object({
+  group: z2.string().regex(ROUTE_GROUP_REGEX, 'must be a Next.js route group like "(admin)"'),
   segment: mountSegmentSchema
 }).strict();
 function splitMountSegment(segment) {
@@ -2281,21 +2324,21 @@ function splitMountSegment(segment) {
   }
   return segment.split("/");
 }
-var tableNameSchema = z.string().regex(SNAKE_TABLE_REGEX, "must be snake_case");
+var tableNameSchema = z2.string().regex(SNAKE_TABLE_REGEX, "must be snake_case");
 var NPM_PACKAGE_NAME_REGEX = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
-var npmPackageNameSchema = z.string().max(214).regex(NPM_PACKAGE_NAME_REGEX, "must be a valid npm package name");
-var descriptionSchema = z.string().max(200, "must be at most 200 characters").refine((value) => value.trim().length > 0, "must be non-empty after trimming");
-var crossAppSchema = z.object({
-  exposes: z.array(z.unknown()).max(0, "must be empty until cross-app contracts are defined"),
-  consumes: z.array(z.unknown()).max(0, "must be empty until cross-app contracts are defined")
+var npmPackageNameSchema = z2.string().max(214).regex(NPM_PACKAGE_NAME_REGEX, "must be a valid npm package name");
+var descriptionSchema = z2.string().max(200, "must be at most 200 characters").refine((value) => value.trim().length > 0, "must be non-empty after trimming");
+var crossAppSchema = z2.object({
+  exposes: z2.array(z2.unknown()).max(0, "must be empty until cross-app contracts are defined"),
+  consumes: z2.array(z2.unknown()).max(0, "must be empty until cross-app contracts are defined")
 }).strict();
-var enhancementWorkflowsSchema = z.record(moduleNameSchema, z.array(z.string().min(1))).default({});
-var enhancementEndpointsSchema = z.record(moduleNameSchema, z.array(endpointClaimSchema)).default({});
-var datastoreRequirementSchema = z.object({
+var enhancementWorkflowsSchema = z2.record(moduleNameSchema, z2.array(z2.string().min(1))).default({});
+var enhancementEndpointsSchema = z2.record(moduleNameSchema, z2.array(endpointClaimSchema)).default({});
+var datastoreRequirementSchema = z2.object({
   /** Logical name, module-local, snake_case. Never a physical store key. */
   id: tableNameSchema,
   /** "app" = this project's app-local store; "org" = an org-level shared store. */
-  scope: z.enum(["app", "org"]).default("app"),
+  scope: z2.enum(["app", "org"]).default("app"),
   /**
    * Which kind of connected store satisfies this requirement. A "database"
    * requirement only ever binds to a database store and a "storage" one
@@ -2303,34 +2346,34 @@ var datastoreRequirementSchema = z.object({
    * rail never crosses the two. Defaults to "database", the only kind the
    * rail resolved before this field existed.
    */
-  type: z.enum(["database", "storage"]).default("database"),
+  type: z2.enum(["database", "storage"]).default("database"),
   /** true → install fails when no store resolves; false → binding omitted, module degrades. */
-  required: z.boolean().default(true),
+  required: z2.boolean().default(true),
   /** Checked against the connected store's accessLevel at install. */
-  access: z.enum(["read", "write", "admin"]).default("write")
+  access: z2.enum(["read", "write", "admin"]).default("write")
 }).strict();
-var permissionClaimSchema = z.object({
+var permissionClaimSchema = z2.object({
   /**
    * Lowercase resource:action with one colon and no underscores. This grammar
    * is deliberately narrower than the platform permission tool's charset.
    */
-  key: z.string().regex(/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*$/, "must be a lowercase resource:action key").max(100, "must be at most 100 characters (platform permission tool limit)"),
+  key: z2.string().regex(/^[a-z0-9][a-z0-9-]*:[a-z0-9][a-z0-9-]*$/, "must be a lowercase resource:action key").max(100, "must be at most 100 characters (platform permission tool limit)"),
   /** Human label for the deployment auth config row. */
   description: descriptionSchema
 }).strict();
-var seedBundleSchema = z.object({
+var seedBundleSchema = z2.object({
   table: tableNameSchema,
   /** Columns forming the ON CONFLICT key — must appear in every row. */
-  conflictTarget: z.array(z.string().min(1)).min(1),
+  conflictTarget: z2.array(z2.string().min(1)).min(1),
   /** Scalar JSON values only (no nested objects/arrays). */
-  rows: z.array(z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.null()]))).min(1)
+  rows: z2.array(z2.record(z2.string(), z2.union([z2.string(), z2.number(), z2.boolean(), z2.null()]))).min(1)
 }).strict().superRefine((bundle, ctx) => {
   const rowKeys = bundle.rows.map((row) => Object.keys(row).sort().join("\0"));
   const canonical = rowKeys[0];
   for (let i = 1; i < rowKeys.length; i += 1) {
     if (rowKeys[i] !== canonical) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "all rows in a seed bundle must have identical key sets",
         path: ["rows", i]
       });
@@ -2342,7 +2385,7 @@ var seedBundleSchema = z.object({
     for (const col of bundle.conflictTarget) {
       if (!keys.has(col)) {
         ctx.addIssue({
-          code: z.ZodIssueCode.custom,
+          code: z2.ZodIssueCode.custom,
           message: `conflictTarget column "${col}" must be present in every row`,
           path: ["rows", i]
         });
@@ -2350,35 +2393,35 @@ var seedBundleSchema = z.object({
     }
   }
 });
-var moduleManifestSchema = z.object({
+var moduleManifestSchema = z2.object({
   name: moduleNameSchema,
   kind: moduleKindSchema,
   // Release versions are platform-owned in module_versions. Accept this
   // legacy field while existing Module source ages out, but strip it from the
   // parsed contract so no runtime can treat module.json as version authority.
-  version: z.unknown().optional(),
+  version: z2.unknown().optional(),
   home: projectSlugSchema,
   /** Machine-checkable purpose line — required, ≤200 code units, non-blank when trimmed. */
   description: descriptionSchema,
-  uses: z.array(moduleNameSchema).default([]),
+  uses: z2.array(moduleNameSchema).default([]),
   /**
    * Soft peers: this module ships `enhancements/<peer>/` directories that are
    * composition-pruned — the installer includes them only when the peer is
    * present, so the peer is NOT an install-time requirement. Disjoint from
    * `uses`; entries may name modules absent from the composition.
    */
-  enhancements: z.array(moduleNameSchema).default([]),
-  tables: z.array(tableNameSchema).default([]),
-  mounts: z.array(mountSchema).default([]),
-  integration: z.array(z.string()).default([]),
-  workflows: z.array(z.string().min(1)).default([]),
+  enhancements: z2.array(moduleNameSchema).default([]),
+  tables: z2.array(tableNameSchema).default([]),
+  mounts: z2.array(mountSchema).default([]),
+  integration: z2.array(z2.string()).default([]),
+  workflows: z2.array(z2.string().min(1)).default([]),
   /**
    * Slice-scoped workflow names keyed by peer. Keys must be ⊆ `enhancements`;
    * names must be unique across root `workflows` and every slice list.
    */
   enhancementWorkflows: enhancementWorkflowsSchema,
   /** Root API endpoint path claims. */
-  endpoints: z.array(endpointClaimSchema).default([]),
+  endpoints: z2.array(endpointClaimSchema).default([]),
   /**
    * Slice-scoped endpoint claims keyed by peer. Keys must be ⊆ `enhancements`;
    * normalized paths must be unique across root and every slice.
@@ -2394,38 +2437,38 @@ var moduleManifestSchema = z.object({
    * to a physical connected store and generates module-datastores.gen.ts;
    * unlike seeds, this field drives generated output.
    */
-  datastores: z.array(datastoreRequirementSchema).optional(),
+  datastores: z2.array(datastoreRequirementSchema).optional(),
   /**
    * Keys this module's guards enforce. Install registers them in deployment
    * auth config; registration only — declaring is never granting.
    */
-  permissions: z.array(permissionClaimSchema).optional(),
+  permissions: z2.array(permissionClaimSchema).optional(),
   /**
    * Optional starter rows for tables this module owns. Replay is
    * `INSERT ... ON CONFLICT (conflictTarget) DO NOTHING` — idempotent by
    * construction; the rail (not this schema) performs the replay.
    */
-  seeds: z.array(seedBundleSchema).optional(),
+  seeds: z2.array(seedBundleSchema).optional(),
   /** npm packages the source imports beyond the base app. Names only; the rail installs each at the home app's range. */
-  packages: z.array(npmPackageNameSchema).optional(),
+  packages: z2.array(npmPackageNameSchema).optional(),
   /**
    * UI-layer contract. `separable: true` asserts the Module's components/ and
    * routes/ hold presentation only — the Blueprint's
    * `module-boundaries/ui-layer` lint rule enforces it — so a fork may
    * soft-eject them. See docs/module-ui-soft-eject-plan.md.
    */
-  ui: z.object({ separable: z.boolean() }).strict().optional()
+  ui: z2.object({ separable: z2.boolean() }).strict().optional()
 }).strict().superRefine((manifest, ctx) => {
   if (manifest.uses.includes(manifest.name)) {
     ctx.addIssue({
-      code: z.ZodIssueCode.custom,
+      code: z2.ZodIssueCode.custom,
       message: "a module cannot list itself in uses",
       path: ["uses"]
     });
   }
   if (manifest.enhancements.includes(manifest.name)) {
     ctx.addIssue({
-      code: z.ZodIssueCode.custom,
+      code: z2.ZodIssueCode.custom,
       message: "a module cannot list itself in enhancements",
       path: ["enhancements"]
     });
@@ -2433,7 +2476,7 @@ var moduleManifestSchema = z.object({
   const hardAndSoft = manifest.enhancements.filter((peer) => manifest.uses.includes(peer));
   if (hardAndSoft.length > 0) {
     ctx.addIssue({
-      code: z.ZodIssueCode.custom,
+      code: z2.ZodIssueCode.custom,
       message: `uses and enhancements must be disjoint (a peer is either a hard dep or a soft one): ${hardAndSoft.join(", ")}`,
       path: ["enhancements"]
     });
@@ -2442,7 +2485,7 @@ var moduleManifestSchema = z.object({
   for (const peer of Object.keys(manifest.enhancementWorkflows)) {
     if (!enhancementPeers.has(peer)) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: `enhancementWorkflows key "${peer}" must be listed in enhancements`,
         path: ["enhancementWorkflows", peer]
       });
@@ -2451,23 +2494,23 @@ var moduleManifestSchema = z.object({
   for (const peer of Object.keys(manifest.enhancementEndpoints)) {
     if (!enhancementPeers.has(peer)) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: `enhancementEndpoints key "${peer}" must be listed in enhancements`,
         path: ["enhancementEndpoints", peer]
       });
     }
   }
   const seenWorkflows = /* @__PURE__ */ new Map();
-  const noteWorkflow = (name, path3) => {
+  const noteWorkflow = (name, path4) => {
     const existing = seenWorkflows.get(name);
     if (existing != null) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: `duplicate workflow name "${name}" (also at ${existing})`,
-        path: path3
+        path: path4
       });
     } else {
-      seenWorkflows.set(name, path3.join("."));
+      seenWorkflows.set(name, path4.join("."));
     }
   };
   for (let i = 0; i < manifest.workflows.length; i += 1) {
@@ -2479,7 +2522,7 @@ var moduleManifestSchema = z.object({
     }
   }
   const seenEndpointKeys = /* @__PURE__ */ new Map();
-  const noteEndpoint = (claim, path3) => {
+  const noteEndpoint = (claim, path4) => {
     let key;
     try {
       key = normalizeEndpointPathForCollision(claim.path);
@@ -2489,12 +2532,12 @@ var moduleManifestSchema = z.object({
     const existing = seenEndpointKeys.get(key);
     if (existing != null) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: `duplicate normalized endpoint path "${key}" (also at ${existing})`,
-        path: path3
+        path: path4
       });
     } else {
-      seenEndpointKeys.set(key, path3.join("."));
+      seenEndpointKeys.set(key, path4.join("."));
     }
   };
   for (let i = 0; i < manifest.endpoints.length; i += 1) {
@@ -2511,7 +2554,7 @@ var moduleManifestSchema = z.object({
       const id = manifest.datastores[i].id;
       if (seenDatastoreIds.has(id)) {
         ctx.addIssue({
-          code: z.ZodIssueCode.custom,
+          code: z2.ZodIssueCode.custom,
           message: `duplicate datastore id "${id}"`,
           path: ["datastores", i, "id"]
         });
@@ -2526,7 +2569,7 @@ var moduleManifestSchema = z.object({
       const key = manifest.permissions[i].key;
       if (seenPermissionKeys.has(key)) {
         ctx.addIssue({
-          code: z.ZodIssueCode.custom,
+          code: z2.ZodIssueCode.custom,
           message: `duplicate permission key "${key}"`,
           path: ["permissions", i, "key"]
         });
@@ -2538,35 +2581,35 @@ var moduleManifestSchema = z.object({
   if (manifest.kind === "library") {
     if (manifest.tables.length > 0) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "library modules must not declare tables",
         path: ["tables"]
       });
     }
     if (manifest.mounts.length > 0) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "library modules must not declare mounts",
         path: ["mounts"]
       });
     }
     if (manifest.seeds != null && manifest.seeds.length > 0) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "library modules must not declare seeds",
         path: ["seeds"]
       });
     }
     if (manifest.datastores != null && manifest.datastores.length > 0) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "library modules must not declare datastores",
         path: ["datastores"]
       });
     }
     if (manifest.permissions != null && manifest.permissions.length > 0) {
       ctx.addIssue({
-        code: z.ZodIssueCode.custom,
+        code: z2.ZodIssueCode.custom,
         message: "library modules must not declare permissions",
         path: ["permissions"]
       });
@@ -2574,7 +2617,7 @@ var moduleManifestSchema = z.object({
   }
   if (manifest.kind === "contract" && manifest.mounts.length > 0) {
     ctx.addIssue({
-      code: z.ZodIssueCode.custom,
+      code: z2.ZodIssueCode.custom,
       message: "contract modules must not declare mounts",
       path: ["mounts"]
     });
@@ -2585,7 +2628,7 @@ var moduleManifestSchema = z.object({
       const bundle = manifest.seeds[i];
       if (!ownedTables.has(bundle.table)) {
         ctx.addIssue({
-          code: z.ZodIssueCode.custom,
+          code: z2.ZodIssueCode.custom,
           message: `seeds may only target tables listed in tables (got "${bundle.table}")`,
           path: ["seeds", i, "table"]
         });
@@ -2595,8 +2638,8 @@ var moduleManifestSchema = z.object({
 }).transform(({ version: _legacyVersion, ...manifest }) => manifest);
 function formatZodErrors(error) {
   return error.issues.map((issue) => {
-    const path3 = issue.path.length > 0 ? issue.path.join(".") : "root";
-    return `${path3}: ${issue.message}`;
+    const path4 = issue.path.length > 0 ? issue.path.join(".") : "root";
+    return `${path4}: ${issue.message}`;
   });
 }
 function parseModuleManifest(raw) {
@@ -2636,10 +2679,10 @@ var MANDATORY_MODULE_CHECK_DESCRIPTORS = Object.freeze([
 ]);
 
 // ../../packages/module-contract/src/module-structure.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // ../../packages/module-contract/src/module-e2e-manifest.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 function e2eSpecFileValidationError(file) {
   if (file.length === 0) {
     return "must be a non-empty relative path ending in .spec.ts";
@@ -2667,22 +2710,22 @@ function e2eSpecFileValidationError(file) {
   }
   return null;
 }
-var e2eSpecFileSchema = z2.string().superRefine((file, ctx) => {
+var e2eSpecFileSchema = z3.string().superRefine((file, ctx) => {
   const error = e2eSpecFileValidationError(file);
   if (error != null) {
-    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: error });
+    ctx.addIssue({ code: z3.ZodIssueCode.custom, message: error });
   }
 });
-var e2eSpecSchema = z2.object({
+var e2eSpecSchema = z3.object({
   file: e2eSpecFileSchema,
-  requires: z2.array(moduleNameSchema).min(1, "requires must be non-empty")
+  requires: z3.array(moduleNameSchema).min(1, "requires must be non-empty")
 }).strict().superRefine((spec, ctx) => {
   const seen = /* @__PURE__ */ new Set();
   for (let i = 0; i < spec.requires.length; i += 1) {
     const name = spec.requires[i];
     if (seen.has(name)) {
       ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
+        code: z3.ZodIssueCode.custom,
         message: `duplicate requirement "${name}"`,
         path: ["requires", i]
       });
@@ -2691,15 +2734,15 @@ var e2eSpecSchema = z2.object({
     }
   }
 });
-var moduleE2eManifestSchema = z2.object({
-  specs: z2.array(e2eSpecSchema).min(1, "specs must contain at least one entry")
+var moduleE2eManifestSchema = z3.object({
+  specs: z3.array(e2eSpecSchema).min(1, "specs must contain at least one entry")
 }).strict().superRefine((manifest, ctx) => {
   const seenFiles = /* @__PURE__ */ new Set();
   for (let i = 0; i < manifest.specs.length; i += 1) {
     const file = manifest.specs[i].file;
     if (seenFiles.has(file)) {
       ctx.addIssue({
-        code: z2.ZodIssueCode.custom,
+        code: z3.ZodIssueCode.custom,
         message: `duplicate file "${file}"`,
         path: ["specs", i, "file"]
       });
@@ -2941,7 +2984,7 @@ function compareCodeUnit(a, b) {
 // ../../packages/module-contract/src/module-structure.ts
 var MODULE_STRUCTURE_JSON_BYTE_CAP = 64 * 1024;
 function uniqueSortedStringArray(label) {
-  return z3.array(z3.string()).superRefine((arr, ctx) => {
+  return z4.array(z4.string()).superRefine((arr, ctx) => {
     if (new Set(arr).size !== arr.length) {
       ctx.addIssue({ code: "custom", message: `${label} must be unique` });
       return;
@@ -2957,10 +3000,10 @@ function uniqueSortedStringArray(label) {
   });
 }
 function contributionPermissionsSchema(label) {
-  return z3.array(
-    z3.object({
-      contributionId: z3.string().min(1),
-      permission: z3.string().min(1)
+  return z4.array(
+    z4.object({
+      contributionId: z4.string().min(1),
+      permission: z4.string().min(1)
     }).strict()
   ).superRefine((entries, ctx) => {
     const keys = entries.map((entry) => `${entry.contributionId}\0${entry.permission}`);
@@ -2978,17 +3021,17 @@ function contributionPermissionsSchema(label) {
     }
   }).optional();
 }
-var collectedFilePayloadSchema = z3.discriminatedUnion("status", [
-  z3.object({ status: z3.literal("ok"), text: z3.string() }).strict(),
-  z3.object({ status: z3.literal("missing") }).strict(),
-  z3.object({ status: z3.literal("too-large") }).strict(),
-  z3.object({ status: z3.literal("unreadable") }).strict()
+var collectedFilePayloadSchema = z4.discriminatedUnion("status", [
+  z4.object({ status: z4.literal("ok"), text: z4.string() }).strict(),
+  z4.object({ status: z4.literal("missing") }).strict(),
+  z4.object({ status: z4.literal("too-large") }).strict(),
+  z4.object({ status: z4.literal("unreadable") }).strict()
 ]);
-var collectedLocaleFileSchema = z3.object({
-  locale: z3.string().min(1),
+var collectedLocaleFileSchema = z4.object({
+  locale: z4.string().min(1),
   payload: collectedFilePayloadSchema
 }).strict();
-var collectedE2eFactsSchema = z3.object({
+var collectedE2eFactsSchema = z4.object({
   manifest: collectedFilePayloadSchema,
   specFiles: uniqueSortedStringArray("specFiles"),
   escapingSymlinks: uniqueSortedStringArray("escapingSymlinks")
@@ -2996,34 +3039,34 @@ var collectedE2eFactsSchema = z3.object({
 function validateRouteExportEvidenceCongruence(input) {
   const entrySet = new Set(input.routeEntries);
   const exportPaths = input.routePageExports.map((e) => e.nextRelativePath);
-  for (const path3 of exportPaths) {
-    if (!entrySet.has(path3)) {
-      input.onIssue(`routePageExports path "${path3}" is not listed in routeEntries`);
+  for (const path4 of exportPaths) {
+    if (!entrySet.has(path4)) {
+      input.onIssue(`routePageExports path "${path4}" is not listed in routeEntries`);
     }
   }
   if (input.routeCollectionErrors.length === 0) {
     const exportSet = new Set(exportPaths);
-    for (const path3 of input.routeEntries) {
-      if (!exportSet.has(path3)) {
-        input.onIssue(`routeEntries path "${path3}" is missing from routePageExports`);
+    for (const path4 of input.routeEntries) {
+      if (!exportSet.has(path4)) {
+        input.onIssue(`routeEntries path "${path4}" is missing from routePageExports`);
       }
     }
   }
 }
-var collectedEnhancementFactsSchema = z3.object({
-  peer: z3.string().min(1),
-  hasContributionsTs: z3.boolean(),
+var collectedEnhancementFactsSchema = z4.object({
+  peer: z4.string().min(1),
+  hasContributionsTs: z4.boolean(),
   contributionPermissions: contributionPermissionsSchema("enhancement contributionPermissions"),
-  hasInitializeServerTs: z3.boolean(),
+  hasInitializeServerTs: z4.boolean(),
   contributionsCollectionErrors: uniqueSortedStringArray(
     "enhancement contributionsCollectionErrors"
   ),
   initializeServerCollectionErrors: uniqueSortedStringArray(
     "enhancement initializeServerCollectionErrors"
   ),
-  hasRoutesDir: z3.boolean(),
+  hasRoutesDir: z4.boolean(),
   routeCollectionErrors: uniqueSortedStringArray("enhancement routeCollectionErrors"),
-  locales: z3.array(collectedLocaleFileSchema).superRefine((locales, ctx) => {
+  locales: z4.array(collectedLocaleFileSchema).superRefine((locales, ctx) => {
     const names = locales.map((l) => l.locale);
     if (new Set(names).size !== names.length) {
       ctx.addIssue({ code: "custom", message: "enhancement locales must be unique by locale" });
@@ -3038,27 +3081,27 @@ var collectedEnhancementFactsSchema = z3.object({
   }),
   e2e: collectedE2eFactsSchema.nullable()
 }).strict();
-var moduleStructureFactsSchema = z3.object({
-  collected: z3.literal(true),
-  dirName: z3.string().min(1),
-  hasIndexTs: z3.boolean(),
-  hasContributionsTs: z3.boolean(),
+var moduleStructureFactsSchema = z4.object({
+  collected: z4.literal(true),
+  dirName: z4.string().min(1),
+  hasIndexTs: z4.boolean(),
+  hasContributionsTs: z4.boolean(),
   contributionPermissions: contributionPermissionsSchema("contributionPermissions"),
-  hasSlotsTs: z3.boolean(),
+  hasSlotsTs: z4.boolean(),
   contributionsCollectionErrors: uniqueSortedStringArray("contributionsCollectionErrors"),
   slotsCollectionErrors: uniqueSortedStringArray("slotsCollectionErrors"),
-  hasTestsDir: z3.boolean(),
-  hasDatastoreDir: z3.boolean(),
-  datastoreFileCount: z3.number().int().nonnegative(),
-  hasServerIndexTs: z3.boolean(),
-  hasOtherServerTs: z3.boolean(),
-  hasE2eDir: z3.boolean(),
-  hasRoutesDir: z3.boolean(),
+  hasTestsDir: z4.boolean(),
+  hasDatastoreDir: z4.boolean(),
+  datastoreFileCount: z4.number().int().nonnegative(),
+  hasServerIndexTs: z4.boolean(),
+  hasOtherServerTs: z4.boolean(),
+  hasE2eDir: z4.boolean(),
+  hasRoutesDir: z4.boolean(),
   routeEntries: uniqueSortedStringArray("routeEntries"),
-  routePageExports: z3.array(
-    z3.object({
-      nextRelativePath: z3.string().min(1),
-      hasGenerateMetadata: z3.boolean()
+  routePageExports: z4.array(
+    z4.object({
+      nextRelativePath: z4.string().min(1),
+      hasGenerateMetadata: z4.boolean()
     }).strict()
   ).superRefine((entries, ctx) => {
     const paths = entries.map((e) => e.nextRelativePath);
@@ -3080,7 +3123,7 @@ var moduleStructureFactsSchema = z3.object({
     }
   }),
   routeCollectionErrors: uniqueSortedStringArray("routeCollectionErrors"),
-  rootLocales: z3.array(collectedLocaleFileSchema).superRefine((locales, ctx) => {
+  rootLocales: z4.array(collectedLocaleFileSchema).superRefine((locales, ctx) => {
     const names = locales.map((l) => l.locale);
     if (new Set(names).size !== names.length) {
       ctx.addIssue({ code: "custom", message: "rootLocales must be unique by locale" });
@@ -3094,7 +3137,7 @@ var moduleStructureFactsSchema = z3.object({
     }
   }),
   rootE2e: collectedE2eFactsSchema.nullable(),
-  enhancements: z3.array(collectedEnhancementFactsSchema).superRefine((enhancements, ctx) => {
+  enhancements: z4.array(collectedEnhancementFactsSchema).superRefine((enhancements, ctx) => {
     const peers = enhancements.map((e) => e.peer);
     if (new Set(peers).size !== peers.length) {
       ctx.addIssue({ code: "custom", message: "enhancement peers must be unique" });
@@ -3115,10 +3158,10 @@ var moduleStructureFactsSchema = z3.object({
     onIssue: (message) => ctx.addIssue({ code: "custom", message })
   });
 });
-var moduleStructureCollectionSchema = z3.object({
+var moduleStructureCollectionSchema = z4.object({
   homeLocales: uniqueSortedStringArray("homeLocales"),
-  modules: z3.array(moduleStructureFactsSchema),
-  truncated: z3.boolean().optional(),
+  modules: z4.array(moduleStructureFactsSchema),
+  truncated: z4.boolean().optional(),
   collectionErrors: uniqueSortedStringArray("collectionErrors").optional()
 }).strict().superRefine((collection, ctx) => {
   const dirs = collection.modules.map((m) => m.dirName);
@@ -3135,9 +3178,9 @@ var moduleStructureCollectionSchema = z3.object({
 });
 
 // ../../packages/module-contract/src/locale.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var LOCALE_BASENAME_REGEX = /^[a-z]{2,3}(-[A-Za-z0-9]+)*$/;
-var localeBasenameSchema = z4.string().max(35).regex(LOCALE_BASENAME_REGEX, "must be a BCP47-like locale tag (e.g. en, th, en-US)");
+var localeBasenameSchema = z5.string().max(35).regex(LOCALE_BASENAME_REGEX, "must be a BCP47-like locale tag (e.g. en, th, en-US)");
 function isValidLocaleBasename(value) {
   return localeBasenameSchema.safeParse(value).success;
 }
@@ -3540,43 +3583,43 @@ function formatRoutePageExportErrors(nextRelativePath, validation) {
 import ts2 from "typescript";
 
 // ../../packages/module-contract/src/module-registry.ts
-import { z as z5 } from "zod";
-var projectSlugSchema2 = z5.string().refine((value) => validateSlug(value).valid, "must be a valid project slug");
-var registryEnhancementSchema = z5.object({
+import { z as z6 } from "zod";
+var projectSlugSchema2 = z6.string().refine((value) => validateSlug(value).valid, "must be a valid project slug");
+var registryEnhancementSchema = z6.object({
   peer: moduleNameSchema,
-  active: z5.boolean()
+  active: z6.boolean()
 }).strict();
-var registryModuleSchema = z5.object({
+var registryModuleSchema = z6.object({
   name: moduleNameSchema,
   /** Installed version as recorded by the rail (non-empty string). */
-  version: z5.string().min(1),
+  version: z6.string().min(1),
   home: projectSlugSchema2,
   kind: moduleKindSchema,
-  mounts: z5.array(mountSchema),
-  enhancements: z5.array(registryEnhancementSchema)
+  mounts: z6.array(mountSchema),
+  enhancements: z6.array(registryEnhancementSchema)
 }).strict().superRefine((mod, ctx) => {
   for (let i = 0; i < mod.enhancements.length; i += 1) {
     if (mod.enhancements[i].peer === mod.name) {
       ctx.addIssue({
-        code: z5.ZodIssueCode.custom,
+        code: z6.ZodIssueCode.custom,
         message: "enhancement peer must not equal the module's own name",
         path: ["enhancements", i, "peer"]
       });
     }
   }
 });
-var generatedModuleRegistrySchema = z5.object({
-  registryVersion: z5.literal(1),
+var generatedModuleRegistrySchema = z6.object({
+  registryVersion: z6.literal(1),
   /** Rail run id, or `"manual"` for fixtures. */
-  generatedBy: z5.string().min(1),
-  modules: z5.array(registryModuleSchema)
+  generatedBy: z6.string().min(1),
+  modules: z6.array(registryModuleSchema)
 }).strict().superRefine((registry, ctx) => {
   const seen = /* @__PURE__ */ new Set();
   for (let i = 0; i < registry.modules.length; i += 1) {
     const name = registry.modules[i].name;
     if (seen.has(name)) {
       ctx.addIssue({
-        code: z5.ZodIssueCode.custom,
+        code: z6.ZodIssueCode.custom,
         message: `duplicate module name "${name}"`,
         path: ["modules", i, "name"]
       });
@@ -3947,169 +3990,6 @@ function analyzeClientSafeEntryImports(sourceText, fileName) {
   return analyzeClientSafeEntryImportsWithTs(ts3, sourceText, fileName);
 }
 
-// ../../packages/lib/src/shared/module-composition.ts
-var moduleRefSchema = z6.object({
-  homeProjectId: z6.string().uuid(),
-  moduleName: moduleNameSchema
-});
-var creationSourceBlankSchema = z6.object({
-  type: z6.literal("blank")
-});
-var creationSourceBlueprintSchema = z6.object({
-  type: z6.literal("blueprint"),
-  /** Internal template/fork project id — keep template naming in identifiers. */
-  blueprintProjectId: z6.string().uuid(),
-  /**
-   * `null`/absent means every feature Module. `[]` is refused: the platform
-   * serialises it to an empty `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the
-   * enablement parser reads back as "all" (`module-enablement.ts`) — the
-   * opposite of what an empty selection means.
-   */
-  enabledModules: z6.array(moduleNameSchema).min(1, "Enable at least one Module").max(100).nullable().optional()
-});
-var creationSourceModulesSchema = z6.object({
-  type: z6.literal("modules"),
-  requested: z6.array(moduleRefSchema).min(1)
-});
-var creationSourceSchema = z6.discriminatedUnion("type", [
-  creationSourceBlankSchema,
-  creationSourceBlueprintSchema,
-  creationSourceModulesSchema
-]);
-var moduleCompositionStatusSchema = z6.enum([
-  "pending",
-  "installing",
-  "ready",
-  "partial",
-  "failed"
-]);
-var resolvedModuleSnapshotSchema = moduleRefSchema.extend({
-  version: z6.string().min(1),
-  homeCommitSha: z6.string().min(1)
-});
-var moduleInstallHandoffSchema = z6.object({
-  moduleName: z6.string().min(1),
-  homeProjectId: z6.string().uuid(),
-  installedVersion: z6.string().min(1),
-  baselineSha: z6.string().min(1),
-  mounts: z6.array(
-    z6.object({
-      group: z6.string(),
-      segment: z6.string()
-    })
-  ),
-  integration: z6.array(z6.string()),
-  workflows: z6.array(z6.string()),
-  prunedEnhancements: z6.array(z6.string()),
-  restoredEnhancements: z6.array(z6.string()).optional(),
-  permissions: z6.array(
-    z6.object({
-      key: z6.string().min(1),
-      description: z6.string().min(1)
-    })
-  ).optional()
-});
-var moduleCompositionRunAttemptSchema = z6.object({
-  module: moduleRefSchema,
-  runId: z6.string().min(1),
-  status: z6.string().min(1),
-  schemaApplied: z6.boolean(),
-  error: z6.string().optional(),
-  /** Prefer full ModuleInstallHandoff; identity fields optional for older rows. */
-  handoff: moduleInstallHandoffSchema.partial({ moduleName: true, homeProjectId: true }).optional()
-});
-var initialModuleCompositionSchema = z6.object({
-  version: z6.literal(1),
-  status: moduleCompositionStatusSchema,
-  requested: z6.array(moduleRefSchema).min(1),
-  resolved: z6.array(resolvedModuleSnapshotSchema),
-  installOrder: z6.array(moduleRefSchema),
-  runs: z6.array(moduleCompositionRunAttemptSchema).default([]),
-  /**
-   * True when any failed/partial attempt applied schema before failing.
-   * Never claim transactional rollback across git/schema.
-   */
-  schemaApplied: z6.boolean().default(false),
-  /**
-   * Present when retry would silently change pinned home SHAs — caller must
-   * reconfirm the new plan rather than continue.
-   */
-  reconfirmationRequired: z6.object({
-    reason: z6.string(),
-    previous: z6.array(resolvedModuleSnapshotSchema),
-    next: z6.array(resolvedModuleSnapshotSchema)
-  }).optional(),
-  error: z6.string().optional(),
-  /**
-   * First-turn system handoff lifecycle. Absent/`pending` means inject when
-   * status is ready; `consumed` means a successful agent turn already used it.
-   */
-  systemHandoffStatus: z6.enum(["pending", "consumed"]).optional(),
-  /**
-   * CAS ownership token for concurrent retry attempts. Only the attempt that
-   * currently owns this value may reset or compensate durable composition state.
-   */
-  retryAttemptId: z6.string().min(1).optional(),
-  /**
-   * When the current `installing` attempt was claimed. A setup run that dies
-   * with its host (a killed Vercel instance) leaves the composition `installing`
-   * forever, and the creating page's poll only stops on ready/partial/failed —
-   * so staleness, not a queue's stall detector, is what settles it. Absent on
-   * rows claimed before this field existed; treated as stale.
-   */
-  attemptStartedAt: z6.string().datetime().optional(),
-  /** Outside-module files the agent changed during connection work. */
-  integrationFiles: z6.array(z6.string()).optional(),
-  verificationSummary: z6.string().optional()
-});
-var MODULE_SETUP_ATTEMPT_STALE_MS = 10 * 60 * 1e3;
-
-// ../../packages/lib/src/shared/compose-inputs.ts
-import { z as z7 } from "zod";
-var COMPOSE_INPUTS_PATH = "apps/web/stardeck.compose.json";
-var composeInputsSchema = z7.strictObject({
-  connectedStores: z7.array(
-    z7.strictObject({
-      storeId: z7.string().min(1),
-      slug: z7.string().min(1),
-      // A row with an empty binding key must not fail a deploy: the rail
-      // treats falsy as "no binding key", so normalise rather than reject.
-      bindingKey: z7.string().nullish().transform((value) => value || null),
-      accessLevel: z7.enum(["read", "write", "admin"]),
-      // Defaulted so a file written before the platform emitted store types
-      // (database rows only) still parses. The platform starts writing
-      // storage rows, with `type` set, once forks run a compose that reads it.
-      type: z7.enum(["database", "storage"]).default("database")
-    })
-  ).default([]),
-  installs: z7.record(
-    z7.string(),
-    z7.strictObject({
-      installedVersion: z7.string().min(1),
-      datastoreBindings: z7.record(z7.string(), z7.string()).nullish()
-    })
-  ).default({})
-});
-var STUB_IGNORE_PATH = "apps/web/src/app/.gitignore";
-var STUB_IGNORE_HEADER = "# Generated by stardeck-compose \u2014 Module-rail stubs are build outputs; do not edit or commit them.";
-function escapeStubIgnorePattern(pattern) {
-  const escaped = pattern.replace(/[\\[\]*?]/g, (char) => `\\${char}`);
-  return /^[#!]/.test(escaped) ? `\\${escaped}` : escaped;
-}
-function buildStubIgnore(artifactPaths) {
-  const prefix = "apps/web/src/app/";
-  const entries = artifactPaths.filter((artifact) => artifact.startsWith(prefix)).map((artifact) => escapeStubIgnorePattern(`/${artifact.slice(prefix.length)}`)).sort();
-  return [STUB_IGNORE_HEADER, ...entries].join("\n") + "\n";
-}
-
-// ../../packages/lib/src/shared/module-enablement.ts
-function isModuleEnabledByList(raw, name, kindOf) {
-  if (!raw) return true;
-  const kind = kindOf(name);
-  if (kind != null && kind !== "feature") return true;
-  return raw.split(",").includes(name);
-}
-
 // ../../packages/lib/src/shared/platform-owned-paths.ts
 var APP_WEB_PREFIX = "apps/web/";
 var MODULE_STUB_MARKER = "@stardeck-module-rail-generated";
@@ -4256,13 +4136,13 @@ function assertClientSafeConventionalEntryImports(source, pathLabel, kind) {
 function createMessageTree() {
   return /* @__PURE__ */ Object.create(null);
 }
-function assertMessageTree(value, path3) {
+function assertMessageTree(value, path4) {
   if (typeof value === "string") return;
   if (value === null || Array.isArray(value) || typeof value !== "object") {
-    throw new Error(`Invalid message at ${path3}: expected string or nested object`);
+    throw new Error(`Invalid message at ${path4}: expected string or nested object`);
   }
   for (const [key, child] of Object.entries(value)) {
-    assertMessageTree(child, `${path3}.${key}`);
+    assertMessageTree(child, `${path4}.${key}`);
   }
 }
 function cloneTree(value) {
@@ -4272,17 +4152,17 @@ function cloneTree(value) {
   }
   return clone;
 }
-function collectLeafPaths(value, path3, out) {
+function collectLeafPaths(value, path4, out) {
   if (typeof value === "string") {
-    out.push(path3);
+    out.push(path4);
     return;
   }
-  assertMessageTree(value, path3);
-  for (const [key, child] of Object.entries(value)) collectLeafPaths(child, `${path3}.${key}`, out);
+  assertMessageTree(value, path4);
+  for (const [key, child] of Object.entries(value)) collectLeafPaths(child, `${path4}.${key}`, out);
 }
-function overrideInto(target, source, owner, path3, missing) {
+function overrideInto(target, source, owner, path4, missing) {
   for (const [key, value] of Object.entries(source)) {
-    const nextPath = path3 ? `${path3}.${key}` : key;
+    const nextPath = path4 ? `${path4}.${key}` : key;
     if (!Object.prototype.hasOwnProperty.call(target, key)) {
       collectLeafPaths(value, nextPath, missing);
       continue;
@@ -4309,9 +4189,9 @@ function overrideInto(target, source, owner, path3, missing) {
 function composeLocaleMessagesForPlan(layers) {
   const result = createMessageTree();
   const leafOwners = /* @__PURE__ */ new Map();
-  function mergeInto(target, source, owner, path3) {
+  function mergeInto(target, source, owner, path4) {
     for (const [key, value] of Object.entries(source)) {
-      const nextPath = path3 ? `${path3}.${key}` : key;
+      const nextPath = path4 ? `${path4}.${key}` : key;
       const hasExisting = Object.prototype.hasOwnProperty.call(target, key);
       const existing = hasExisting ? target[key] : void 0;
       if (typeof value === "string") {
@@ -4855,8 +4735,8 @@ var METHOD_ORDER = {
 function compareNames2(a, b) {
   return a < b ? -1 : a > b ? 1 : 0;
 }
-function endpointPairKey(method, path3) {
-  return `${method} ${path3}`;
+function endpointPairKey(method, path4) {
+  return `${method} ${path4}`;
 }
 function apiPathToRouteFile(apiPath) {
   if (!apiPath.startsWith("/api/")) {
@@ -4870,11 +4750,11 @@ function routeEntryToAppPageFile(nextRelativePath) {
 }
 var APP_ROUTE_FILE_PREFIX = `${APP_PACKAGE_DIR}/src/app/`;
 var API_ROUTE_FILE_SUFFIXES = ["/route.ts", "/route.tsx", "/route.jsx", "/route.js"];
-function appRouteFileToNextRelativePath(path3) {
-  const pagePath = appPageFileToNextRelativePath(path3, APP_PACKAGE_DIR);
+function appRouteFileToNextRelativePath(path4) {
+  const pagePath = appPageFileToNextRelativePath(path4, APP_PACKAGE_DIR);
   if (pagePath != null) return pagePath;
-  if (!path3.startsWith(APP_ROUTE_FILE_PREFIX)) return null;
-  const relative = path3.slice(APP_ROUTE_FILE_PREFIX.length);
+  if (!path4.startsWith(APP_ROUTE_FILE_PREFIX)) return null;
+  const relative = path4.slice(APP_ROUTE_FILE_PREFIX.length);
   if (!relative.startsWith("api/")) return null;
   const suffix = API_ROUTE_FILE_SUFFIXES.find((candidate) => relative.endsWith(candidate));
   if (!suffix) return null;
@@ -4966,9 +4846,9 @@ function legacyHandlerPropertyMatchesPath(property, method, physicalPath, bindin
   const expectedTokens = knownAliases[`${binding} ${method} ${physicalPath}`] ?? pathTokens;
   return handlerTokens.length === expectedTokens.length && handlerTokens.every((token, index) => token === expectedTokens[index]);
 }
-function parseLegacyApiAdapter(path3, source) {
-  const physicalPath = appRouteFileToNextRelativePath(path3);
-  if (expectedMarkerKindForPath(path3) !== "endpoint" || physicalPath == null) return null;
+function parseLegacyApiAdapter(path4, source) {
+  const physicalPath = appRouteFileToNextRelativePath(path4);
+  if (expectedMarkerKindForPath(path4) !== "endpoint" || physicalPath == null) return null;
   const firstLine = source.split(/\r?\n/, 1)[0]?.trim() ?? "";
   const match = firstLine.match(
     new RegExp(
@@ -4978,7 +4858,7 @@ function parseLegacyApiAdapter(path3, source) {
   if (!match || match[2] !== physicalPath) return null;
   const owner = match[1];
   if (!isValidModuleName(owner)) return null;
-  const file = ts4.createSourceFile(path3, source, ts4.ScriptTarget.Latest, false, ts4.ScriptKind.TS);
+  const file = ts4.createSourceFile(path4, source, ts4.ScriptTarget.Latest, false, ts4.ScriptKind.TS);
   if (file.parseDiagnostics.length > 0) {
     return null;
   }
@@ -5020,9 +4900,9 @@ function parseLegacyApiAdapter(path3, source) {
   }
   return handlerBinding != null && methods.size > 0 ? { owner, methods: [...methods] } : null;
 }
-function parseLegacyRouteAdapter(path3, source) {
-  const physicalPath = appRouteFileToNextRelativePath(path3);
-  if (expectedMarkerKindForPath(path3) !== "route" || physicalPath == null) return null;
+function parseLegacyRouteAdapter(path4, source) {
+  const physicalPath = appRouteFileToNextRelativePath(path4);
+  if (expectedMarkerKindForPath(path4) !== "route" || physicalPath == null) return null;
   const normalized = source.replace(/\r\n/g, "\n");
   const match = normalized.match(
     new RegExp(
@@ -5034,30 +4914,30 @@ function parseLegacyRouteAdapter(path3, source) {
   const nextRelativePath = match[2];
   return isValidModuleName(owner) && nextRelativePath === physicalPath ? { owner, nextRelativePath } : null;
 }
-function legacyRouteAdapterMatchesStub(path3, source, stub) {
-  const legacy = parseLegacyRouteAdapter(path3, source);
+function legacyRouteAdapterMatchesStub(path4, source, stub) {
+  const legacy = parseLegacyRouteAdapter(path4, source);
   return legacy != null && legacy.owner === stub.owner;
 }
 var API_ROUTE_DIR_PREFIX = `${APP_PACKAGE_DIR}/src/app/api/`;
 var APP_DIR_PREFIX = `${APP_PACKAGE_DIR}/src/app/`;
 var PAGE_FILE_SUFFIXES = ["/page.tsx", "/page.ts", "/page.jsx", "/page.js"];
-function expectedMarkerKindForPath(path3) {
-  if (path3 === MODULES_GEN_PATH) return "registry";
-  if (path3 === MODULE_CONTRIBUTIONS_GEN_PATH) return "contributions";
-  if (path3 === MODULE_DATASTORES_GEN_PATH) return "datastores";
-  if (path3 === MODULE_I18N_GEN_PATH) return "i18n";
-  if (path3 === MODULE_INIT_SERVER_GEN_PATH) return "init";
-  if (path3 === MODULE_SERVER_GEN_PATH) return "server";
-  if (path3.startsWith(API_ROUTE_DIR_PREFIX) && path3.endsWith("/route.ts")) return "endpoint";
-  if (path3.startsWith(APP_DIR_PREFIX) && !path3.startsWith(API_ROUTE_DIR_PREFIX) && PAGE_FILE_SUFFIXES.some((suffix) => path3.endsWith(suffix))) {
+function expectedMarkerKindForPath(path4) {
+  if (path4 === MODULES_GEN_PATH) return "registry";
+  if (path4 === MODULE_CONTRIBUTIONS_GEN_PATH) return "contributions";
+  if (path4 === MODULE_DATASTORES_GEN_PATH) return "datastores";
+  if (path4 === MODULE_I18N_GEN_PATH) return "i18n";
+  if (path4 === MODULE_INIT_SERVER_GEN_PATH) return "init";
+  if (path4 === MODULE_SERVER_GEN_PATH) return "server";
+  if (path4.startsWith(API_ROUTE_DIR_PREFIX) && path4.endsWith("/route.ts")) return "endpoint";
+  if (path4.startsWith(APP_DIR_PREFIX) && !path4.startsWith(API_ROUTE_DIR_PREFIX) && PAGE_FILE_SUFFIXES.some((suffix) => path4.endsWith(suffix))) {
     return "route";
   }
   return null;
 }
-function markerCongruentWithPath(path3, marker) {
-  if (expectedMarkerKindForPath(path3) !== marker.kind) return false;
+function markerCongruentWithPath(path4, marker) {
+  if (expectedMarkerKindForPath(path4) !== marker.kind) return false;
   if (marker.kind === "route") {
-    const derived = appPageFileToNextRelativePath(path3, APP_PACKAGE_DIR);
+    const derived = appPageFileToNextRelativePath(path4, APP_PACKAGE_DIR);
     return derived != null && derived === marker.nextRelativePath;
   }
   return true;
@@ -5328,8 +5208,8 @@ function buildGeneratedModuleRegistry(input) {
 function activeEnhancementPeers(registryModule) {
   return new Set(registryModule.enhancements.filter((e) => e.active).map((e) => e.peer));
 }
-function endpointBucketKey(path3, owner, scope) {
-  return `${path3}\0${owner}\0${scopeLabel(scope)}`;
+function endpointBucketKey(path4, owner, scope) {
+  return `${path4}\0${owner}\0${scopeLabel(scope)}`;
 }
 function planRouteStubs(input) {
   const endpointBuckets = /* @__PURE__ */ new Map();
@@ -5453,7 +5333,7 @@ function planRouteStubs(input) {
     for (const entry of entries) {
       const nextRelativePath = entry.nextRelativePath;
       const destination = normalizeAppRouterDestinationPattern(nextRelativePath);
-      const path3 = routeEntryToAppPageFile(nextRelativePath);
+      const path4 = routeEntryToAppPageFile(nextRelativePath);
       const existing = routeDestinationOwners.get(destination);
       if (existing) {
         throw new Error(
@@ -5463,13 +5343,13 @@ function planRouteStubs(input) {
       routeDestinationOwners.set(destination, {
         owner: regMod.name,
         nextRelativePath,
-        path: path3
+        path: path4
       });
       const importModule = routeEntryImport(regMod.name, nextRelativePath);
       const analyzed = analyzeRouteEntryPath(nextRelativePath);
       const mount = mounts.find((claim) => routeEntryCoveredByMountClaim(analyzed, claim));
       routeStubs.push({
-        path: path3,
+        path: path4,
         owner: regMod.name,
         nextRelativePath,
         importModule,
@@ -5530,16 +5410,16 @@ function planCompositionArtifacts(input) {
     ...stubs.routeStubs.map((stub) => stub.path)
   ]);
   const existingGeneratedPathSet = new Set(input.existingGeneratedPaths);
-  const isProvenStaleDeletionCandidate = (path3, content) => {
-    if (path3 === MODULES_GEN_PATH) return false;
-    if (COMPOSITION_RUNTIME_GEN_PATHS.includes(path3)) return false;
-    if (desiredPaths.has(path3)) return false;
-    if (!existingGeneratedPathSet.has(path3)) return false;
-    const legacy = parseLegacyApiAdapter(path3, content);
+  const isProvenStaleDeletionCandidate = (path4, content) => {
+    if (path4 === MODULES_GEN_PATH) return false;
+    if (COMPOSITION_RUNTIME_GEN_PATHS.includes(path4)) return false;
+    if (desiredPaths.has(path4)) return false;
+    if (!existingGeneratedPathSet.has(path4)) return false;
+    const legacy = parseLegacyApiAdapter(path4, content);
     if (legacy) return true;
-    if (parseLegacyRouteAdapter(path3, content)) return true;
+    if (parseLegacyRouteAdapter(path4, content)) return true;
     const marker = parseCompositionArtifactMarker(content);
-    return marker != null && markerCongruentWithPath(path3, marker);
+    return marker != null && markerCongruentWithPath(path4, marker);
   };
   const plannedByDestination = /* @__PURE__ */ new Map();
   for (const stub of stubs.routeStubs) {
@@ -5693,13 +5573,13 @@ function planCompositionArtifacts(input) {
   for (const stub of stubs.routeStubs) desired.set(stub.path, stub.content);
   const endpointStubByPath = new Map(stubs.endpointStubs.map((stub) => [stub.path, stub]));
   const routeStubByPath = new Map(stubs.routeStubs.map((stub) => [stub.path, stub]));
-  for (const [path3] of desired) {
-    const existing = input.existingFiles[path3];
+  for (const [path4] of desired) {
+    const existing = input.existingFiles[path4];
     if (existing == null) continue;
     let marker = parseCompositionArtifactMarker(existing);
-    const plannedEndpoint = endpointStubByPath.get(path3);
-    const plannedRoute = routeStubByPath.get(path3);
-    const legacy = parseLegacyApiAdapter(path3, existing);
+    const plannedEndpoint = endpointStubByPath.get(path4);
+    const plannedRoute = routeStubByPath.get(path4);
+    const legacy = parseLegacyApiAdapter(path4, existing);
     if (legacy && plannedEndpoint) {
       marker = {
         kind: "endpoint",
@@ -5707,66 +5587,66 @@ function planCompositionArtifacts(input) {
         scope: plannedEndpoint.scope
       };
     }
-    if (!marker && plannedRoute && legacyRouteAdapterMatchesStub(path3, existing, plannedRoute)) {
+    if (!marker && plannedRoute && legacyRouteAdapterMatchesStub(path4, existing, plannedRoute)) {
       marker = {
         kind: "route",
         owner: plannedRoute.owner,
         nextRelativePath: plannedRoute.nextRelativePath
       };
     }
-    const isGenRuntimePath = COMPOSITION_RUNTIME_GEN_PATHS.includes(path3);
+    const isGenRuntimePath = COMPOSITION_RUNTIME_GEN_PATHS.includes(path4);
     if (!marker) {
       return {
         ok: false,
-        error: path3 === MODULES_GEN_PATH ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged registry at ${path3}` : isGenRuntimePath ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged generated file at ${path3}` : `[ModuleRail] composition artifacts: refusing to overwrite unmanaged route at ${path3}`,
-        path: path3
+        error: path4 === MODULES_GEN_PATH ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged registry at ${path4}` : isGenRuntimePath ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged generated file at ${path4}` : `[ModuleRail] composition artifacts: refusing to overwrite unmanaged route at ${path4}`,
+        path: path4
       };
     }
-    const expectedKind = expectedMarkerKindForPath(path3);
+    const expectedKind = expectedMarkerKindForPath(path4);
     if (marker.kind !== expectedKind) {
       return {
         ok: false,
-        error: path3 === MODULES_GEN_PATH ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged registry at ${path3} (incongruent marker ownership: found ${marker.kind} marker)` : isGenRuntimePath ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged generated file at ${path3} (incongruent marker ownership: found ${marker.kind} marker)` : `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path3} (expected ${expectedKind ?? "no"} marker, found ${marker.kind} marker)`,
-        path: path3
+        error: path4 === MODULES_GEN_PATH ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged registry at ${path4} (incongruent marker ownership: found ${marker.kind} marker)` : isGenRuntimePath ? `[ModuleRail] composition artifacts: refusing to overwrite unmanaged generated file at ${path4} (incongruent marker ownership: found ${marker.kind} marker)` : `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path4} (expected ${expectedKind ?? "no"} marker, found ${marker.kind} marker)`,
+        path: path4
       };
     }
     if (marker.kind === "endpoint") {
-      const stub = endpointStubByPath.get(path3);
+      const stub = endpointStubByPath.get(path4);
       const ownerMatches = stub != null && marker.owner === stub.owner;
       const scopeMatches = stub != null && scopeLabel(marker.scope) === scopeLabel(stub.scope);
       if (!ownerMatches || !scopeMatches) {
         return {
           ok: false,
-          error: `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path3} (existing owner=${marker.owner} scope=${scopeLabel(marker.scope)} vs planned owner=${stub?.owner ?? "?"} scope=${stub ? scopeLabel(stub.scope) : "?"})`,
-          path: path3,
+          error: `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path4} (existing owner=${marker.owner} scope=${scopeLabel(marker.scope)} vs planned owner=${stub?.owner ?? "?"} scope=${stub ? scopeLabel(stub.scope) : "?"})`,
+          path: path4,
           owner: stub?.owner
         };
       }
     } else if (marker.kind === "route") {
-      const stub = routeStubByPath.get(path3);
+      const stub = routeStubByPath.get(path4);
       const ownerMatches = stub != null && marker.owner === stub.owner;
       const pathMatches = stub != null && marker.nextRelativePath === stub.nextRelativePath;
       if (!ownerMatches || !pathMatches) {
         return {
           ok: false,
-          error: `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path3} (existing owner=${marker.owner} path=${marker.nextRelativePath} vs planned owner=${stub?.owner ?? "?"} path=${stub?.nextRelativePath ?? "?"})`,
-          path: path3,
+          error: `[ModuleRail] composition artifacts: refusing to overwrite incongruent marker ownership at ${path4} (existing owner=${marker.owner} path=${marker.nextRelativePath} vs planned owner=${stub?.owner ?? "?"} path=${stub?.nextRelativePath ?? "?"})`,
+          path: path4,
           owner: stub?.owner
         };
       }
     }
   }
   const deletes = [];
-  for (const path3 of input.existingGeneratedPaths) {
-    const existing = input.existingFiles[path3];
+  for (const path4 of input.existingGeneratedPaths) {
+    const existing = input.existingFiles[path4];
     if (existing == null) continue;
-    if (!isProvenStaleDeletionCandidate(path3, existing)) {
+    if (!isProvenStaleDeletionCandidate(path4, existing)) {
       continue;
     }
-    deletes.push(path3);
+    deletes.push(path4);
   }
   deletes.sort(compareNames2);
-  const writes = [...desired.entries()].filter(([path3, content]) => input.existingFiles[path3] !== content).map(([path3, content]) => ({ path: path3, content })).sort((a, b) => compareNames2(a.path, b.path));
+  const writes = [...desired.entries()].filter(([path4, content]) => input.existingFiles[path4] !== content).map(([path4, content]) => ({ path: path4, content })).sort((a, b) => compareNames2(a.path, b.path));
   return {
     ok: true,
     plan: {
@@ -5795,8 +5675,16 @@ async function checkoutParsesTypedStores(sandbox) {
   try {
     if (!await sandbox.fileExists(APP_PACKAGE_JSON_PATH)) return false;
     const pkg = JSON.parse(await sandbox.readFile(APP_PACKAGE_JSON_PATH));
-    const range = pkg.devDependencies?.[COMPOSE_PACKAGE] ?? pkg.dependencies?.[COMPOSE_PACKAGE];
-    if (!range) return false;
+    return composeRangeParsesTypedStores(
+      pkg.devDependencies?.[COMPOSE_PACKAGE] ?? pkg.dependencies?.[COMPOSE_PACKAGE]
+    );
+  } catch {
+    return false;
+  }
+}
+function composeRangeParsesTypedStores(range) {
+  if (!range) return false;
+  try {
     const lowest = import_semver.default.minVersion(range);
     return lowest != null && import_semver.default.gte(lowest, TYPED_STORES_MIN_COMPOSE_VERSION);
   } catch {
@@ -6028,6 +5916,50 @@ function rejectPseudoModuleEntries(entries, parentDir, label) {
   return dirs;
 }
 
+// ../../packages/lib/src/shared/module-composition.ts
+import { z as z7 } from "zod";
+var creationSourceBlankSchema = z7.object({
+  type: z7.literal("blank")
+});
+var creationSourceBlueprintSchema = z7.object({
+  type: z7.literal("blueprint"),
+  /** Internal template/fork project id — keep template naming in identifiers. */
+  blueprintProjectId: z7.string().uuid(),
+  /**
+   * `null`/absent means every feature Module. `[]` is refused: the platform
+   * serialises it to an empty `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the
+   * enablement parser reads back as "all" (`module-enablement.ts`) — the
+   * opposite of what an empty selection means.
+   */
+  enabledModules: z7.array(moduleNameSchema).min(1, "Enable at least one Module").max(100).nullable().optional()
+});
+var creationSourceSchema = z7.discriminatedUnion("type", [
+  creationSourceBlankSchema,
+  creationSourceBlueprintSchema
+]);
+var moduleInstallHandoffSchema = z7.object({
+  moduleName: z7.string().min(1),
+  homeProjectId: z7.string().uuid(),
+  installedVersion: z7.string().min(1),
+  baselineSha: z7.string().min(1),
+  mounts: z7.array(
+    z7.object({
+      group: z7.string(),
+      segment: z7.string()
+    })
+  ),
+  integration: z7.array(z7.string()),
+  workflows: z7.array(z7.string()),
+  prunedEnhancements: z7.array(z7.string()),
+  restoredEnhancements: z7.array(z7.string()).optional(),
+  permissions: z7.array(
+    z7.object({
+      key: z7.string().min(1),
+      description: z7.string().min(1)
+    })
+  ).optional()
+});
+
 // ../../packages/lib/src/shared/schema-ops.ts
 import { z as z8 } from "zod";
 var columnSpecSchema = z8.object({
@@ -6241,11 +6173,11 @@ function countedCompositionContext(context) {
           counts.sandboxExecs += 1;
           return context.sandbox.exec(...args);
         },
-        readFile: (path3) => {
+        readFile: (path4) => {
           counts.sandboxReads += 1;
-          return context.sandbox.readFile(path3);
+          return context.sandbox.readFile(path4);
         },
-        fileExists: (path3) => context.sandbox.fileExists(path3),
+        fileExists: (path4) => context.sandbox.fileExists(path4),
         fetchRemoteRef: (...args) => context.sandbox.fetchRemoteRef(...args),
         addDependencies: (specs) => context.sandbox.addDependencies(specs)
       }
@@ -6457,14 +6389,14 @@ async function discoverModuleRouteEntries(context, moduleName) {
   }
   return pages.sort((a, b) => a.nextRelativePath.localeCompare(b.nextRelativePath));
 }
-async function writeSandboxFileAtomic(target, path3, content) {
-  const dir = dirnamePosix(path3);
-  const tmp = `${path3}.tmp.${target.runId}`;
+async function writeSandboxFileAtomic(target, path4, content) {
+  const dir = dirnamePosix(path4);
+  const tmp = `${path4}.tmp.${target.runId}`;
   const b64 = Buffer.from(content, "utf8").toString("base64");
   const cmd = [
     `mkdir -p ${shellQuote(dir)}`,
     `printf '%s' ${shellQuote(b64)} | base64 -d > ${shellQuote(tmp)}`,
-    `mv -f ${shellQuote(tmp)} ${shellQuote(path3)}`
+    `mv -f ${shellQuote(tmp)} ${shellQuote(path4)}`
   ].join(" && ");
   const result = await target.sandbox.exec(cmd, { raiseOnError: false });
   if (result.exitCode !== 0) {
@@ -6479,14 +6411,14 @@ async function writeSandboxFileAtomic(target, path3, content) {
     }
     const detail = typeof result.error === "string" && result.error.trim() || result.output.trim() || `exit ${result.exitCode}`;
     throw new Error(
-      `[ModuleRail] composition artifacts: failed to write ${redactSecrets(path3)}: ${redactSecrets(detail)}`
+      `[ModuleRail] composition artifacts: failed to write ${redactSecrets(path4)}: ${redactSecrets(detail)}`
     );
   }
 }
 async function collectAbsentWriteParentDirs(context, writePaths) {
   const absent = /* @__PURE__ */ new Set();
-  for (const path3 of writePaths) {
-    let dir = dirnamePosix(path3);
+  for (const path4 of writePaths) {
+    let dir = dirnamePosix(path4);
     while (dir !== "." && dir !== "") {
       if (absent.has(dir)) {
         dir = dirnamePosix(dir);
@@ -6523,12 +6455,12 @@ async function removeAbsentWriteParentDirsOnRollback(context, dirsDeepestFirst)
     );
   }
 }
-async function deleteSandboxFile(context, path3) {
-  const result = await context.sandbox.exec(`rm -f ${shellQuote(path3)}`, { raiseOnError: false });
+async function deleteSandboxFile(context, path4) {
+  const result = await context.sandbox.exec(`rm -f ${shellQuote(path4)}`, { raiseOnError: false });
   if (result.exitCode !== 0) {
     const detail = typeof result.error === "string" && result.error.trim() || result.output.trim() || `exit ${result.exitCode}`;
     throw new Error(
-      `[ModuleRail] composition artifacts: failed to delete ${redactSecrets(path3)}: ${redactSecrets(detail)}`
+      `[ModuleRail] composition artifacts: failed to delete ${redactSecrets(path4)}: ${redactSecrets(detail)}`
     );
   }
 }
@@ -6595,37 +6527,37 @@ async function applyCompositionArtifactMutations(context, plan, existingFiles) {
       await writeSandboxFileAtomic(context, write.path, write.content);
       appliedWrites.push({ path: write.path, previous });
     }
-    for (const path3 of plan.deletes) {
-      const previous = existingFiles[path3];
+    for (const path4 of plan.deletes) {
+      const previous = existingFiles[path4];
       if (previous == null) continue;
-      await deleteSandboxFile(context, path3);
-      appliedDeletes.push({ path: path3, previous });
+      await deleteSandboxFile(context, path4);
+      appliedDeletes.push({ path: path4, previous });
     }
   } catch (error) {
     console.log(
       `[ModuleRail] runId=${context.runId} composition artifacts mid-apply failure; rolling back writes=${appliedWrites.length} deletes=${appliedDeletes.length} newDirs=${newlyCreatedParentDirs.length}`
     );
-    for (const { path: path3, previous } of [...appliedDeletes].reverse()) {
+    for (const { path: path4, previous } of [...appliedDeletes].reverse()) {
       try {
-        await writeSandboxFileAtomic(context, path3, previous);
+        await writeSandboxFileAtomic(context, path4, previous);
       } catch (rollbackError) {
         console.log(
-          `[ModuleRail] runId=${context.runId} composition artifacts rollback restore failed for ${redactSecrets(path3)}: ${redactSecrets(
+          `[ModuleRail] runId=${context.runId} composition artifacts rollback restore failed for ${redactSecrets(path4)}: ${redactSecrets(
             rollbackError instanceof Error ? rollbackError.message : String(rollbackError)
           )}`
         );
       }
     }
-    for (const { path: path3, previous } of [...appliedWrites].reverse()) {
+    for (const { path: path4, previous } of [...appliedWrites].reverse()) {
       try {
         if (previous == null) {
-          await deleteSandboxFile(context, path3);
+          await deleteSandboxFile(context, path4);
         } else {
-          await writeSandboxFileAtomic(context, path3, previous);
+          await writeSandboxFileAtomic(context, path4, previous);
         }
       } catch (rollbackError) {
         console.log(
-          `[ModuleRail] runId=${context.runId} composition artifacts rollback write failed for ${redactSecrets(path3)}: ${redactSecrets(
+          `[ModuleRail] runId=${context.runId} composition artifacts rollback write failed for ${redactSecrets(path4)}: ${redactSecrets(
             rollbackError instanceof Error ? rollbackError.message : String(rollbackError)
           )}`
         );
@@ -6659,39 +6591,39 @@ async function listExistingGeneratedStubPaths(context) {
     COMPOSITION_ARTIFACT_KIND_PROBE_TOKEN
   );
   const presentPaths = [];
-  for (const path3 of candidates) {
+  for (const path4 of candidates) {
     const presence = assertRealCompositionArtifactFilePresence(
-      path3,
-      kinds.get(path3) ?? "unreadable"
+      path4,
+      kinds.get(path4) ?? "unreadable"
     );
-    if (presence === "file") presentPaths.push(path3);
+    if (presence === "file") presentPaths.push(path4);
   }
   let contents;
   try {
     contents = await readFilesMany(context, presentPaths);
   } catch (error) {
-    const path3 = readFailurePath(error);
+    const path4 = readFailurePath(error);
     throw new Error(
-      `[ModuleRail] composition artifacts: cannot read candidate stub ${redactSecrets(path3)}: ${redactSecrets(
+      `[ModuleRail] composition artifacts: cannot read candidate stub ${redactSecrets(path4)}: ${redactSecrets(
         error instanceof Error ? error.message : String(error)
       )}`
     );
   }
   const owned = [];
-  for (const path3 of presentPaths) {
-    const content = contents.get(path3);
+  for (const path4 of presentPaths) {
+    const content = contents.get(path4);
     const marker = parseCompositionArtifactMarker(content);
-    if (parseLegacyApiAdapter(path3, content) || parseLegacyRouteAdapter(path3, content)) {
-      owned.push(path3);
+    if (parseLegacyApiAdapter(path4, content) || parseLegacyRouteAdapter(path4, content)) {
+      owned.push(path4);
       continue;
     }
     if (marker == null) continue;
-    if (!markerCongruentWithPath(path3, marker)) {
+    if (!markerCongruentWithPath(path4, marker)) {
       throw new Error(
-        `[ModuleRail] composition artifacts: incongruent marker at ${redactSecrets(path3)} (found ${marker.kind} marker on a path shaped for ${expectedMarkerKindForPath(path3) ?? "no"} artifacts; refusing to reconcile a swapped marker)`
+        `[ModuleRail] composition artifacts: incongruent marker at ${redactSecrets(path4)} (found ${marker.kind} marker on a path shaped for ${expectedMarkerKindForPath(path4) ?? "no"} artifacts; refusing to reconcile a swapped marker)`
       );
     }
-    owned.push(path3);
+    owned.push(path4);
   }
   return owned;
 }
@@ -6824,7 +6756,7 @@ async function classifySandboxPathPresenceKindMany(context, paths, probeToken) {
       { raiseOnError: false }
     );
     if (result.exitCode !== 0) {
-      for (const path3 of chunk) kinds.set(path3, "unreadable");
+      for (const path4 of chunk) kinds.set(path4, "unreadable");
       continue;
     }
     const lines = result.output.split("\n").filter(Boolean);
@@ -6835,31 +6767,31 @@ async function classifySandboxPathPresenceKindMany(context, paths, probeToken) {
       }
     } else {
       for (const line of lines) {
-        const [rawKind, path3] = line.split("	", 2);
+        const [rawKind, path4] = line.split("	", 2);
         const kind = rawKind?.replace(/^entry-kind:/, "");
-        if (path3 && chunk.includes(path3) && CONVENTIONAL_ENTRY_PRESENCE_KINDS.includes(kind ?? "")) {
-          kinds.set(path3, kind);
+        if (path4 && chunk.includes(path4) && CONVENTIONAL_ENTRY_PRESENCE_KINDS.includes(kind ?? "")) {
+          kinds.set(path4, kind);
         }
       }
     }
-    for (const path3 of chunk) {
-      if (!kinds.has(path3)) kinds.set(path3, "unreadable");
+    for (const path4 of chunk) {
+      if (!kinds.has(path4)) kinds.set(path4, "unreadable");
     }
   }
   return kinds;
 }
-async function classifySandboxPathPresenceKind(context, path3, probeToken) {
-  return (await classifySandboxPathPresenceKindMany(context, [path3], probeToken)).get(path3);
+async function classifySandboxPathPresenceKind(context, path4, probeToken) {
+  return (await classifySandboxPathPresenceKindMany(context, [path4], probeToken)).get(path4);
 }
 var LOCALE_JSON_KIND_PROBE_TOKEN = "locale-json-kind";
-function assertRealLocaleJsonFilePresence(path3, presence) {
+function assertRealLocaleJsonFilePresence(path4, presence) {
   if (presence === "file") return;
   if (presence === "absent") {
-    throw new Error(`[ModuleRail] composition artifacts: locale file missing at ${path3}`);
+    throw new Error(`[ModuleRail] composition artifacts: locale file missing at ${path4}`);
   }
-  const presenceError = formatConventionalEntryPresenceError(path3, presence);
+  const presenceError = formatConventionalEntryPresenceError(path4, presence);
   throw new Error(
-    `[ModuleRail] composition artifacts: ${presenceError ?? `${path3} is not a real locale JSON file`}`
+    `[ModuleRail] composition artifacts: ${presenceError ?? `${path4} is not a real locale JSON file`}`
   );
 }
 function splitTaggedLine(line) {
@@ -6934,11 +6866,11 @@ async function listLocaleBasenamesIfDirMany(context, dirs) {
 }
 async function readFilesMany(context, paths) {
   const sortedPaths = [...paths].sort((a, b) => a.localeCompare(b));
-  const settled = await mapConcurrent(sortedPaths, SANDBOX_READ_CONCURRENCY, async (path3) => {
+  const settled = await mapConcurrent(sortedPaths, SANDBOX_READ_CONCURRENCY, async (path4) => {
     try {
-      return { path: path3, value: await context.sandbox.readFile(path3) };
+      return { path: path4, value: await context.sandbox.readFile(path4) };
     } catch (error) {
-      return { path: path3, error };
+      return { path: path4, error };
     }
   });
   const files = /* @__PURE__ */ new Map();
@@ -6961,58 +6893,58 @@ function readFailurePath(error) {
 var CONVENTIONAL_ENTRY_KIND_PROBE_TOKEN = "conventional-entry-kind";
 var SERVER_REGISTRATIONS_FILE = "server/registrations.ts";
 var COMPOSITION_ARTIFACT_KIND_PROBE_TOKEN = "composition-artifact-kind";
-async function classifyCompositionArtifactPathKind(context, path3) {
-  return classifySandboxPathPresenceKind(context, path3, COMPOSITION_ARTIFACT_KIND_PROBE_TOKEN);
+async function classifyCompositionArtifactPathKind(context, path4) {
+  return classifySandboxPathPresenceKind(context, path4, COMPOSITION_ARTIFACT_KIND_PROBE_TOKEN);
 }
-function assertRealCompositionArtifactFilePresence(path3, presence) {
+function assertRealCompositionArtifactFilePresence(path4, presence) {
   if (presence === "file") return "file";
   if (presence === "absent") return "absent";
-  const presenceError = formatConventionalEntryPresenceError(path3, presence);
+  const presenceError = formatConventionalEntryPresenceError(path4, presence);
   throw new Error(
-    `[ModuleRail] composition artifacts: ${presenceError ?? `${path3} is not a real composition artifact file`}`
+    `[ModuleRail] composition artifacts: ${presenceError ?? `${path4} is not a real composition artifact file`}`
   );
 }
-async function readConventionalEntryIfRealFile(path3, kind, presences, files) {
-  const presence = presences.get(path3) ?? "unreadable";
-  const presenceError = formatConventionalEntryPresenceError(path3, presence);
+async function readConventionalEntryIfRealFile(path4, kind, presences, files) {
+  const presence = presences.get(path4) ?? "unreadable";
+  const presenceError = formatConventionalEntryPresenceError(path4, presence);
   if (presenceError) {
     throw new Error(`[ModuleRail] composition artifacts: ${presenceError}`);
   }
   if (presence === "absent") {
     return null;
   }
-  const source = files.get(path3);
+  const source = files.get(path4);
   switch (kind) {
     case "contributions":
-      assertContributionsExport(source, path3);
-      assertClientSafeConventionalEntryImports(source, path3, "contributions");
+      assertContributionsExport(source, path4);
+      assertClientSafeConventionalEntryImports(source, path4, "contributions");
       break;
     case "slotCatalogs":
-      assertSlotCatalogsExport(source, path3);
-      assertClientSafeConventionalEntryImports(source, path3, "slotCatalogs");
+      assertSlotCatalogsExport(source, path4);
+      assertClientSafeConventionalEntryImports(source, path4, "slotCatalogs");
       break;
     case "initializeEnhancement":
-      assertInitializeEnhancementExport(source, path3);
+      assertInitializeEnhancementExport(source, path4);
       break;
   }
   return source;
 }
 function hasRealServerRegistrations(modulePath, presences) {
-  const path3 = `${modulePath}/${SERVER_REGISTRATIONS_FILE}`;
-  return assertRealCompositionArtifactFilePresence(path3, presences.get(path3) ?? "unreadable") === "file";
+  const path4 = `${modulePath}/${SERVER_REGISTRATIONS_FILE}`;
+  return assertRealCompositionArtifactFilePresence(path4, presences.get(path4) ?? "unreadable") === "file";
 }
-async function readJsonObjectFile(path3, files) {
-  const raw = files.get(path3);
+async function readJsonObjectFile(path4, files) {
+  const raw = files.get(path4);
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch (error) {
     throw new Error(
-      `[ModuleRail] composition artifacts: invalid JSON at ${path3}: ${error instanceof Error ? error.message : String(error)}`
+      `[ModuleRail] composition artifacts: invalid JSON at ${path4}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   if (parsed === null || Array.isArray(parsed) || typeof parsed !== "object") {
-    throw new Error(`[ModuleRail] composition artifacts: ${path3} root must be an object`);
+    throw new Error(`[ModuleRail] composition artifacts: ${path4} root must be an object`);
   }
   return parsed;
 }
@@ -7061,11 +6993,11 @@ async function collectCompositionEntryFacts(context, registry) {
     classifySandboxPathPresenceKindMany(context, localePaths, LOCALE_JSON_KIND_PROBE_TOKEN)
   ]);
   const presentConventionalPaths = [];
-  for (const path3 of conventionalPaths) {
-    const presence = conventionalPresences.get(path3) ?? "unreadable";
-    if (presence === "file") presentConventionalPaths.push(path3);
+  for (const path4 of conventionalPaths) {
+    const presence = conventionalPresences.get(path4) ?? "unreadable";
+    if (presence === "file") presentConventionalPaths.push(path4);
   }
-  const presentLocalePaths = localePaths.filter((path3) => localePresences.get(path3) === "file");
+  const presentLocalePaths = localePaths.filter((path4) => localePresences.get(path4) === "file");
   const files = await readFilesMany(context, [...presentConventionalPaths, ...presentLocalePaths]);
   const substrateLocales = [];
   for (const locale of substrateNames) {
@@ -7163,8 +7095,8 @@ async function collectCompositionEntryFacts(context, registry) {
     });
     if (rootLocales.length > 0) {
       for (const locale of rootLocales) {
-        const path3 = `${modulePath}/i18n/${locale}.json`;
-        assertRealLocaleJsonFilePresence(path3, localePresences.get(path3) ?? "unreadable");
+        const path4 = `${modulePath}/i18n/${locale}.json`;
+        assertRealLocaleJsonFilePresence(path4, localePresences.get(path4) ?? "unreadable");
       }
       const enMessages = await readJsonObjectFile(`${modulePath}/i18n/en.json`, files);
       const localeMessages = { en: enMessages };
@@ -7188,8 +7120,8 @@ async function collectCompositionEntryFacts(context, registry) {
       if (!enh.active || enh.locales.length === 0) continue;
       const peerDir = `${modulePath}/enhancements/${enh.peer}`;
       for (const locale of enh.locales) {
-        const path3 = `${peerDir}/i18n/${locale}.json`;
-        assertRealLocaleJsonFilePresence(path3, localePresences.get(path3) ?? "unreadable");
+        const path4 = `${peerDir}/i18n/${locale}.json`;
+        assertRealLocaleJsonFilePresence(path4, localePresences.get(path4) ?? "unreadable");
       }
       const enMessages = await readJsonObjectFile(`${peerDir}/i18n/en.json`, files);
       const localeMessages = { en: enMessages };
@@ -7390,16 +7322,16 @@ async function reconcileCompositionArtifacts(context, options = {}) {
   for (const stub of probePlan.plan.routeStubs) candidatePaths.add(stub.path);
   const existingFiles = {};
   const remainingCandidatePaths = [];
-  for (const path3 of [...candidatePaths].sort((a, b) => a.localeCompare(b))) {
-    if (Object.prototype.hasOwnProperty.call(existingAppPages, path3)) {
-      existingFiles[path3] = existingAppPages[path3];
+  for (const path4 of [...candidatePaths].sort((a, b) => a.localeCompare(b))) {
+    if (Object.prototype.hasOwnProperty.call(existingAppPages, path4)) {
+      existingFiles[path4] = existingAppPages[path4];
       continue;
     }
-    if (Object.prototype.hasOwnProperty.call(existingAppRoutes, path3)) {
-      existingFiles[path3] = existingAppRoutes[path3];
+    if (Object.prototype.hasOwnProperty.call(existingAppRoutes, path4)) {
+      existingFiles[path4] = existingAppRoutes[path4];
       continue;
     }
-    remainingCandidatePaths.push(path3);
+    remainingCandidatePaths.push(path4);
   }
   const candidateKinds = await classifySandboxPathPresenceKindMany(
     context,
@@ -7407,12 +7339,12 @@ async function reconcileCompositionArtifacts(context, options = {}) {
     COMPOSITION_ARTIFACT_KIND_PROBE_TOKEN
   );
   const presentCandidatePaths = [];
-  for (const path3 of remainingCandidatePaths) {
+  for (const path4 of remainingCandidatePaths) {
     const presence = assertRealCompositionArtifactFilePresence(
-      path3,
-      candidateKinds.get(path3) ?? "unreadable"
+      path4,
+      candidateKinds.get(path4) ?? "unreadable"
     );
-    if (presence === "file") presentCandidatePaths.push(path3);
+    if (presence === "file") presentCandidatePaths.push(path4);
   }
   try {
     Object.assign(
@@ -7420,9 +7352,9 @@ async function reconcileCompositionArtifacts(context, options = {}) {
       Object.fromEntries(await readFilesMany(context, presentCandidatePaths))
     );
   } catch (error) {
-    const path3 = readFailurePath(error);
+    const path4 = readFailurePath(error);
     throw new Error(
-      `[ModuleRail] composition artifacts: cannot read ${redactSecrets(path3)} during preflight: ${redactSecrets(
+      `[ModuleRail] composition artifacts: cannot read ${redactSecrets(path4)} during preflight: ${redactSecrets(
         error instanceof Error ? error.message : String(error)
       )}`
     );
@@ -7491,14 +7423,142 @@ async function reconcileCompositionArtifacts(context, options = {}) {
 var HOME_I18N_SUBSTRATE_DIR = `${APP_PACKAGE_DIR}/src/lib/i18n/substrate`;
 var HOME_I18N_MESSAGES_DIR = `${APP_PACKAGE_DIR}/src/lib/i18n/messages`;
 
+// src/index.ts
+import ts6 from "typescript";
+
+// src/module-boundaries.ts
+import fs2 from "fs";
+import path2 from "path";
+import ts5 from "typescript";
+var SOURCE_FILE = /\.[cm]?[jt]sx?$/;
+var RESOLVE_SUFFIXES = ["", ".ts", ".tsx", ".js", ".jsx", "/index.ts", "/index.tsx", "/index.js"];
+var DATA_FILE = /\.(?:sql|json)$/;
+function dataPathsIn(fileName, source) {
+  if (!/\.(?:sql|json)["'`]/.test(source)) return [];
+  const paths = [];
+  const visit = (node) => {
+    if ((ts5.isStringLiteralLike(node) || ts5.isTemplateTail(node)) && DATA_FILE.test(node.text)) {
+      paths.push(node.text);
+    }
+    ts5.forEachChild(node, visit);
+  };
+  visit(ts5.createSourceFile(fileName, source, ts5.ScriptTarget.Latest, false));
+  return paths;
+}
+function scanModule(modulesDir, module) {
+  const scanned = /* @__PURE__ */ new Map();
+  const moduleDir = path2.join(modulesDir, module);
+  if (!fs2.existsSync(moduleDir)) return scanned;
+  const files = fs2.readdirSync(moduleDir, { recursive: true, encoding: "utf8" }).filter((relative) => SOURCE_FILE.test(relative) && !relative.includes("node_modules"));
+  for (const relative of files) {
+    const absolute = path2.join(moduleDir, relative);
+    if (!fs2.statSync(absolute).isFile()) continue;
+    const source = fs2.readFileSync(absolute, "utf8");
+    const specifiers = ts5.preProcessFile(source, true, true).importedFiles.map((f) => f.fileName);
+    const dataPaths = dataPathsIn(absolute, source);
+    const targets = [...specifiers, ...dataPaths].flatMap((spec) => {
+      if (spec.startsWith("@/modules/"))
+        return [path2.join(modulesDir, spec.slice("@/modules/".length))];
+      if (spec.startsWith("./") || spec.startsWith("../")) {
+        return [path2.resolve(path2.dirname(absolute), spec)];
+      }
+      return [];
+    });
+    scanned.set(absolute, {
+      module,
+      relative: relative.split(path2.sep).join("/"),
+      targets,
+      dataPaths
+    });
+  }
+  return scanned;
+}
+function findModuleBoundaryViolations(modulesDir, peersByModule, { pruning = false } = {}) {
+  const files = /* @__PURE__ */ new Map();
+  for (const [module, peers] of Object.entries(peersByModule)) {
+    if (peers.length === 0) continue;
+    for (const [absolute, file] of scanModule(modulesDir, module)) files.set(absolute, file);
+  }
+  const exempt = (file, peer) => (pruning ? peersByModule[file.module] ?? [] : [peer]).some(
+    (q) => file.relative.startsWith(`enhancements/${q}/`)
+  );
+  const goneWith = (target, peer) => {
+    const relative = path2.relative(modulesDir, target).split(path2.sep).join("/");
+    return relative === peer || relative.startsWith(`${peer}/`) || new RegExp(`^[^/]+/enhancements/${peer}(/|$)`).test(relative);
+  };
+  const tainted = /* @__PURE__ */ new Map();
+  const queue = [];
+  const taint = (absolute, peer) => {
+    const peers = tainted.get(absolute) ?? /* @__PURE__ */ new Set();
+    if (peers.has(peer)) return;
+    peers.add(peer);
+    tainted.set(absolute, peers);
+    queue.push([absolute, peer]);
+  };
+  const importers = /* @__PURE__ */ new Map();
+  for (const [absolute, file] of files) {
+    for (const target of file.targets) {
+      const hit = RESOLVE_SUFFIXES.map((suffix) => target + suffix).find((c) => files.has(c));
+      if (hit) importers.set(hit, [...importers.get(hit) ?? [], absolute]);
+    }
+    for (const peer of peersByModule[file.module] ?? []) {
+      if (exempt(file, peer)) continue;
+      if (file.targets.some((target) => goneWith(target, peer)) || file.dataPaths.some(
+        (p) => p.startsWith(`modules/${peer}/`) || p.includes(`/modules/${peer}/`)
+      )) {
+        taint(absolute, peer);
+      }
+    }
+  }
+  for (let next = queue.shift(); next; next = queue.shift()) {
+    const [target, peer] = next;
+    for (const importer of importers.get(target) ?? []) {
+      const file = files.get(importer);
+      if ((peersByModule[file.module] ?? []).includes(peer) && !exempt(file, peer)) {
+        taint(importer, peer);
+      }
+    }
+  }
+  const violations = [];
+  for (const [absolute, peers] of tainted) {
+    const file = files.get(absolute);
+    for (const peer of peers) {
+      violations.push({ file: `${file.module}/${file.relative}`, module: file.module, peer });
+    }
+  }
+  return violations.sort((a, b) => a.file.localeCompare(b.file) || a.peer.localeCompare(b.peer));
+}
+function findOptionalPeerViolations(modulesDir) {
+  if (!fs2.existsSync(modulesDir)) return [];
+  const manifests = {};
+  for (const name of fs2.readdirSync(modulesDir)) {
+    const manifestPath = path2.join(modulesDir, name, "module.json");
+    if (!fs2.existsSync(manifestPath)) continue;
+    manifests[name] = JSON.parse(fs2.readFileSync(manifestPath, "utf8"));
+  }
+  const features = Object.keys(manifests).filter((name) => manifests[name].kind === "feature");
+  const peersByModule = {};
+  for (const [name, manifest] of Object.entries(manifests)) {
+    const uses = new Set(manifest.uses ?? []);
+    peersByModule[name] = features.filter((peer) => peer !== name && !uses.has(peer));
+  }
+  return findModuleBoundaryViolations(modulesDir, peersByModule);
+}
+function formatBoundaryViolations(modulesDirLabel, violations) {
+  const files = new Set(violations.map((v) => v.file)).size;
+  return `${files} Module file(s) import a peer Module that may be absent (not in the Module's \`uses\`, or excluded by --enabled).
+\`next build\` type-checks them after the peer is gone. For each line, move the file into ${modulesDirLabel}/<module>/enhancements/<peer>/ or declare <peer> in the module's module.json \`uses\` (and enable it).
+` + violations.map((v) => `${modulesDirLabel}/${v.file}: ${v.peer}`).join("\n");
+}
+
 // src/index.ts
 var MODULES_DIR2 = MODULES_SANDBOX_DIR;
 function readComposeInputs(cwd) {
-  const file = path2.join(cwd, COMPOSE_INPUTS_PATH);
-  if (!fs2.existsSync(file)) return { connectedStores: [], installs: {} };
+  const file = path3.join(cwd, COMPOSE_INPUTS_PATH);
+  if (!fs3.existsSync(file)) return { connectedStores: [], installs: {} };
   let raw;
   try {
-    raw = JSON.parse(fs2.readFileSync(file, "utf8"));
+    raw = JSON.parse(fs3.readFileSync(file, "utf8"));
   } catch (error) {
     throw new Error(
       `[compose] ${file} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
@@ -7540,18 +7600,18 @@ function stubGitignoreEntries(artifactPaths) {
 function writeStubGitignore(cwd, artifactPaths) {
   const entries = stubGitignoreEntries(artifactPaths);
   const content = [STUB_GITIGNORE_HEADER, ...entries].join("\n") + "\n";
-  const file = path2.join(cwd, STUB_GITIGNORE_PATH);
-  const existing = fs2.existsSync(file) ? fs2.readFileSync(file, "utf8") : null;
+  const file = path3.join(cwd, STUB_GITIGNORE_PATH);
+  const existing = fs3.existsSync(file) ? fs3.readFileSync(file, "utf8") : null;
   if (existing !== content) {
-    fs2.mkdirSync(path2.dirname(file), { recursive: true });
-    fs2.writeFileSync(file, content);
+    fs3.mkdirSync(path3.dirname(file), { recursive: true });
+    fs3.writeFileSync(file, content);
   }
   return entries.length;
 }
 function assertStubGitignoreOwned(cwd) {
-  const file = path2.join(cwd, STUB_GITIGNORE_PATH);
-  if (!fs2.existsSync(file)) return;
-  const firstLine = fs2.readFileSync(file, "utf8").split("\n", 1)[0] ?? "";
+  const file = path3.join(cwd, STUB_GITIGNORE_PATH);
+  if (!fs3.existsSync(file)) return;
+  const firstLine = fs3.readFileSync(file, "utf8").split("\n", 1)[0] ?? "";
   if (firstLine !== STUB_GITIGNORE_HEADER) {
     throw new Error(
       `[compose] refusing to overwrite ${STUB_GITIGNORE_PATH}: it is not compose-generated (line 1 is not the generated header)`
@@ -7559,8 +7619,8 @@ function assertStubGitignoreOwned(cwd) {
   }
 }
 function assertAppRoot(cwd) {
-  const appPath = path2.join(cwd, APP_PACKAGE_JSON);
-  if (!fs2.existsSync(appPath)) {
+  const appPath = path3.join(cwd, APP_PACKAGE_JSON);
+  if (!fs3.existsSync(appPath)) {
     throw new Error(
       `[compose] ${appPath} not found \u2014 run this from the repo root of a Stardeck app`
     );
@@ -7606,9 +7666,9 @@ ${porcelain.trim()}`
 }
 var APP_SRC_DIR = "apps/web/src";
 function walkSources(dir, skip, out) {
-  if (!fs2.existsSync(dir)) return;
-  for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
-    const full = path2.join(dir, entry.name);
+  if (!fs3.existsSync(dir)) return;
+  for (const entry of fs3.readdirSync(dir, { withFileTypes: true })) {
+    const full = path3.join(dir, entry.name);
     if (full === skip) continue;
     if (entry.isDirectory()) walkSources(full, skip, out);
     else if (/\.[cm]?[jt]sx?$/.test(entry.name)) out.push(full);
@@ -7617,13 +7677,13 @@ function walkSources(dir, skip, out) {
 function assertNoAppLayerImporters(cwd, excluded) {
   if (excluded.length === 0) return;
   const files = [];
-  walkSources(path2.join(cwd, APP_SRC_DIR), path2.join(cwd, MODULES_DIR2), files);
+  walkSources(path3.join(cwd, APP_SRC_DIR), path3.join(cwd, MODULES_DIR2), files);
   const offenders = [];
   for (const file of files) {
-    const source = fs2.readFileSync(file, "utf8");
+    const source = fs3.readFileSync(file, "utf8");
     for (const name of excluded) {
       if (new RegExp(`@/modules/${name}(?=["'\`/])`).test(source)) {
-        offenders.push(`${path2.relative(cwd, file)}: ${name}`);
+        offenders.push(`${path3.relative(cwd, file)}: ${name}`);
       }
     }
   }
@@ -7635,9 +7695,44 @@ function assertNoAppLayerImporters(cwd, excluded) {
     );
   }
 }
+var TSCONFIG_PATH = "apps/web/tsconfig.json";
+var BUILD_TSCONFIG_PATH = "apps/web/tsconfig.build.gen.json";
+var BUILD_TSCONFIG_HEADER = "// Generated by stardeck-compose \u2014 the tsconfig `next build` type-checks. Do not edit or commit.";
+function writeBuildTsconfig(cwd, excluded) {
+  const baseFile = path3.join(cwd, TSCONFIG_PATH);
+  if (!fs3.existsSync(path3.join(cwd, MODULES_DIR2)) || !fs3.existsSync(baseFile)) return;
+  const base = ts6.readConfigFile(baseFile, ts6.sys.readFile);
+  if (base.error) {
+    throw new Error(
+      `[compose] cannot read ${TSCONFIG_PATH}: ${ts6.flattenDiagnosticMessageText(base.error.messageText, "\n")}`
+    );
+  }
+  const baseExclude = base.config?.exclude ?? ["node_modules"];
+  const modulesDir = path3.posix.relative("apps/web", MODULES_DIR2);
+  const config = {
+    extends: "./tsconfig.json",
+    exclude: [
+      ...baseExclude,
+      ...excluded.flatMap((name) => [
+        `${modulesDir}/${name}`,
+        `${modulesDir}/*/enhancements/${name}`
+      ])
+    ]
+  };
+  const content = `${BUILD_TSCONFIG_HEADER}
+${JSON.stringify(config, null, 2)}
+`;
+  const file = path3.join(cwd, BUILD_TSCONFIG_PATH);
+  if (!fs3.existsSync(file) || fs3.readFileSync(file, "utf8") !== content) {
+    fs3.writeFileSync(file, content);
+  }
+  console.log(
+    `[compose] ${BUILD_TSCONFIG_PATH} excludes ${excluded.length} Module(s): ${excluded.join(",") || "none"}`
+  );
+}
 function removeDir(absolute) {
-  if (!fs2.existsSync(absolute)) return false;
-  fs2.rmSync(absolute, { recursive: true, force: true });
+  if (!fs3.existsSync(absolute)) return false;
+  fs3.rmSync(absolute, { recursive: true, force: true });
   return true;
 }
 async function compose(options) {
@@ -7664,6 +7759,16 @@ async function compose(options) {
       dryRun: true
     });
     assertNoAppLayerImporters(options.cwd, preview.excludedModules);
+    const violations = findModuleBoundaryViolations(
+      path3.join(options.cwd, MODULES_DIR2),
+      Object.fromEntries(preview.composedModules.map((name) => [name, preview.excludedModules])),
+      { pruning: true }
+    );
+    if (violations.length > 0) {
+      throw new Error(
+        `[compose] refusing --prune: ${formatBoundaryViolations(MODULES_DIR2, violations)}`
+      );
+    }
   }
   const result = await reconcileCompositionArtifacts(context, {
     enabledModulesRaw: options.enabled,
@@ -7672,14 +7777,15 @@ async function compose(options) {
     skipComposeInputs: true
   });
   const gitignoreEntries = options.enabled ? null : writeStubGitignore(options.cwd, result.artifactPaths);
+  writeBuildTsconfig(options.cwd, result.excludedModules);
   let pruned = 0;
   if (options.prune) {
     for (const name of result.excludedModules) {
-      if (removeDir(path2.join(options.cwd, MODULES_DIR2, name))) pruned++;
+      if (removeDir(path3.join(options.cwd, MODULES_DIR2, name))) pruned++;
     }
     for (const owner of result.composedModules) {
       for (const peer of result.excludedModules) {
-        if (removeDir(path2.join(options.cwd, MODULES_DIR2, owner, "enhancements", peer))) pruned++;
+        if (removeDir(path3.join(options.cwd, MODULES_DIR2, owner, "enhancements", peer))) pruned++;
       }
     }
   }
@@ -7693,9 +7799,13 @@ async function compose(options) {
   };
 }
 export {
+  BUILD_TSCONFIG_PATH,
   COMPOSE_INPUTS_PATH,
   assertSupportedTypescript,
   compose,
   escapeGitignore,
+  findModuleBoundaryViolations,
+  findOptionalPeerViolations,
+  formatBoundaryViolations,
   readComposeInputs
 };