@hype-stack/cli 1.17.0 → 1.20.0

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAyB1D,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAEtF;AAwBD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAYxF;AAoCD,wBAAgB,aAAa,IAAI,OAAO,CAiRvC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA8B1D,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAEtF;AAwBD,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAYxF;AAoCD,wBAAgB,aAAa,IAAI,OAAO,CA4UvC"}

package/dist/commands/community.d.ts

@@ -0,0 +1,41 @@
+import { CustomizationOptions, PackCategory } from '../types/types.js';
+export interface CommunityAddOptions extends CustomizationOptions {
+    cwd?: string;
+    force?: boolean;
+    yes?: boolean;
+}
+/**
+ * Install one community pack from a directory, a git repository, or an npm package.
+ *
+ * Deliberately a thin wrapper over `compose`. A community pack goes through the exact same
+ * pipeline as a catalog one, dependency resolution through migration prompt, and duplicating any
+ * of that here would guarantee the two drift: the copy that gets exercised less would be the one
+ * with the bug. Everything specific to community packs (fetching, the trust prompt, the name
+ * checks) lives in compose's own staging step, where it applies to `--community` too.
+ */
+export declare function communityAddCommand(spec: string, options?: CommunityAddOptions): Promise<void>;
+/**
+ * Check a pack directory and report everything wrong with it.
+ *
+ * Exits non-zero on an error so it can sit in an author's CI, and stays quiet enough to be run
+ * constantly while writing one.
+ */
+export declare function communityValidateCommand(dir?: string): Promise<void>;
+export interface CommunityInitOptions {
+    name?: string;
+    category?: PackCategory;
+    yes?: boolean;
+}
+/** Scaffold a new pack that validates on the first run. */
+export declare function communityInitCommand(dir?: string, options?: CommunityInitOptions): Promise<void>;
+/**
+ * Show which community packs a project carries and where each came from.
+ *
+ * Worth its own command because once third-party code is in a project, "what is in here that we
+ * did not write" is a question people actually have to answer, and `installedPacks` alone cannot:
+ * it is a list of names, and a community pack's name resolves to nothing anyone can look up.
+ */
+export declare function communityListCommand(options?: {
+    cwd?: string;
+}): Promise<void>;
+//# sourceMappingURL=community.d.ts.map

package/dist/commands/community.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community.d.ts","sourceRoot":"","sources":["../../src/commands/community.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAiB,YAAY,EAA2B,MAAM,mBAAmB,CAAC;AAQpH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExG;AAID;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E;AAUD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AASD,2DAA2D;AAC3D,wBAAsB,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6F1G;AAID;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBxF"}

package/dist/commands/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/commands/compose.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AAqB5G,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkThF;AAkLD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAUxG;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIhE"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/commands/compose.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AAsB5G,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwchF;AA8RD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAUxG;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAIhE"}

package/dist/commands/install-helpers.d.ts

@@ -10,16 +10,45 @@ export declare function authorizeUnowned(packs: PackListItem[], installedSet: Se
 export declare function stateTag(state: PackState, price: number): string;
 /** Tell the user which packs were dropped and offer to open purchase pages for locked ones. */
 export declare function handleBlocked(blocked: string[], isLocked: (name: string) => boolean, packsByName: Map<string, PackListItem>): Promise<void>;
-export declare function showPlanSummary(installable: string[], packsByName: Map<string, PackListItem>): void;
+/**
+ * The plan, as the last thing shown before the "Install N packs?" confirm.
+ *
+ * Community packs are marked with where they came from, and every npm package they will pull in is
+ * listed. That second part is the disclosure the trust prompt cannot make, because the manifest
+ * had not been fetched yet when the prompt ran. Nothing in a pack executes, but a dependency it
+ * asks for is a real package from a real registry, and the person confirming should see the names.
+ */
+/** One resolved template slot, for the review: which family, which variant, whether it is the default. */
+export interface SlotPick {
+    label: string;
+    pack: string;
+    isDefault: boolean;
+}
+export interface PlanSummaryOptions {
+    /** Staged community packs, so the summary can say where each came from and what npm it adds. */
+    community?: readonly PreparedPack[];
+    /** Template slot picks, shown ahead of the install order. */
+    picks?: readonly SlotPick[];
+}
+export declare function showPlanSummary(installable: string[], packsByName: Map<string, PackListItem>, { community, picks }?: PlanSummaryOptions): void;
 /**
  * Turn a denial into something the user can act on. A credential problem and an
  * entitlement problem look identical from the outside but need opposite fixes, so
  * they get different messages instead of one vague "access denied".
  */
 export declare function describeDownloadDenial(name: string, reason: DownloadDeniedReason): string;
-/** Fetch each pack's manifest and download its files into a temp dir, in install order. */
+/**
+ * Collect every pack in the plan into install order, downloading the ones that need downloading.
+ *
+ * A name present in `staged` is a community pack that was already fetched: its manifest had to be
+ * read before the dependency graph could be resolved, so re-fetching it here would be a second
+ * network round trip for bytes already on disk. Everything else goes through the registry, which
+ * is the only path that can authorize a paid pack. Both kinds come back as the same `PreparedPack`,
+ * so nothing downstream has to care which lane a pack arrived through.
+ */
 export declare function downloadPacks(order: string[], auth: {
     token?: string | null;
+    staged?: Map<string, PreparedPack>;
 }): Promise<PreparedPack[]>;
 export declare function installNpmForPacks(args: {
     prepared: PreparedPack[];
@@ -53,5 +82,11 @@ export declare function resolveOverwrites(args: {
     yes: boolean;
     /** Per-pack selected slots, used to scope which files count as conflicts. */
     slotsByPack?: Map<string, PackSlot[]>;
+    /**
+     * Resolved target paths the user already decided to replace, so they are never asked again.
+     * A starter swap fills this with the files both starters ship: replacing the starter was the
+     * decision, and one prompt per file would only let them answer it inconsistently.
+     */
+    preapproved?: Set<string>;
 }): Promise<Set<string>>;
 //# sourceMappingURL=install-helpers.d.ts.map

package/dist/commands/install-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAMpC,OAAO,EAAqB,KAAK,YAAY,EAAwB,MAAM,sBAAsB,CAAC;AASlG,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,YAAY,EAEZ,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,mBAAmB,CAAC;AAI3B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,0GAA0G;AAC1G,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EAAE,EACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAI/B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAQnG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAUzF;AAED,2FAA2F;AAC3F,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiB7G;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAOzD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;CACvC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAwDvB"}
+{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"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"}

package/dist/commands/template.d.ts

@@ -1,13 +1,14 @@
 import { TemplateCommandOptions } from '../types/types.js';
 /**
- * Install a template. The template expands to its starter/layout slot variants
- * plus a fixed set of feature packs, installs them like a normal compose, then
- * layers the template's frontend override files (landing page, etc.) on top so
- * the template takes responsibility for those paths.
+ * Install a template. The template expands to one variant per slot (starter,
+ * layout, billing, any pack family it ships) plus a fixed set of feature packs,
+ * installs them like a normal compose, then layers the template's frontend
+ * override files (landing page, etc.) on top so the template takes
+ * responsibility for those paths.
  *
- * Built for template making: you can swap the starter/layout variants for a
- * different same-family pack, and add extra packs that fall outside the
- * template's predefined scope.
+ * Built for template making: you can swap any slot for a different pack of the
+ * same family, and add extra packs that fall outside the template's predefined
+ * scope.
  */
 export declare function templateCommand(options?: TemplateCommandOptions): Promise<void>;
 //# sourceMappingURL=template.d.ts.map

package/dist/commands/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAIV,sBAAsB,EAGvB,MAAM,mBAAmB,CAAC;AAoB3B;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CA8YzF"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAKV,sBAAsB,EAIvB,MAAM,mBAAmB,CAAC;AAsB3B;;;;;;;;;;GAUG;AAEH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAwczF"}

package/dist/config/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as e, n as t, t as n, u as r } from "../cli-CGP_pCsR.js";
+import { d as e, n as t, t as n, u as r } from "../cli-CG3vutuw.js";
 import { z as i } from "zod";
 import * as a from "@sentry/node";
 //#region src/core/sentry.ts

package/dist/core/capabilities.d.ts

@@ -0,0 +1,56 @@
+import { PackCapability, PackManifest, StackConfig } from '../types/types.js';
+/**
+ * Capabilities are the contract between a starter and everything installed on top of it. A
+ * starter lists what it `provides`; a layout or feature pack lists what it `requires`. The names
+ * are the five things a starter can differ in, nothing finer: the point is a check that cannot
+ * rot, not a taxonomy.
+ */
+export declare const KNOWN_CAPABILITIES: readonly PackCapability[];
+export declare function isKnownCapability(value: string): value is PackCapability;
+/** Everything the installed packs and the packs about to land provide, together. */
+export declare function providedCapabilities(config: StackConfig, manifests: PackManifest[]): Set<PackCapability>;
+export interface UnsatisfiedRequirement {
+    pack: string;
+    missing: PackCapability[];
+}
+/**
+ * Which packs in a plan need a capability nothing provides. Checked against the union of what is
+ * installed and what is in the plan, so a starter and a feature pack selected together satisfy
+ * each other, and a feature added later is checked against the starter already in place.
+ */
+export declare function findUnsatisfiedRequirements(options: {
+    manifests: PackManifest[];
+    config: StackConfig;
+}): UnsatisfiedRequirement[];
+/** One line per unsatisfied pack, naming the capability and where it comes from. */
+export declare function describeUnsatisfiedRequirement(item: UnsatisfiedRequirement): string;
+/**
+ * A starter swap is an upgrade when the new starter provides everything the installed one did.
+ * That is the one direction a swap can take without breaking the packs already on top, so it is
+ * the one the CLI performs on its own; the other direction is a rebuild, not a swap.
+ */
+export declare function isCapabilityUpgrade(installedProvides: readonly string[], nextProvides: readonly string[]): boolean;
+export interface AppAlignment<T extends StackConfig> {
+    config: T;
+    /** What changed, for the log. Empty when the project already matched the starter. */
+    notes: string[];
+}
+/**
+ * Make the project's optional-app registration follow the starter. A starter that does not
+ * provide `admin` ships no admin login, users, or organizations views, so an `apps/admin` left in
+ * `stack.json` would collect feature packs' admin widgets that import starter modules which are
+ * not there. Dropping the app from `apps`/`paths` (the directory stays on disk, untouched) makes
+ * every admin-slot file and codemod skip, exactly as in a project that never had the app. When a
+ * starter that provides `admin` lands later, the app is registered again from the directory
+ * that is still there, so the upgrade from the free starter needs no re-clone.
+ */
+export declare function alignAppsWithStarter<T extends StackConfig>(options: {
+    config: T;
+    /** The starter about to land: its name and what it provides, from the catalog or its manifest. */
+    starter: {
+        name: string;
+        provides?: PackCapability[];
+    };
+    projectRoot: string;
+}): Promise<AppAlignment<T>>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/core/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAI/F;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAMvD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC,CASxG;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG,sBAAsB,EAAE,CAW3B;AAED,oFAAoF;AACpF,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAQnF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAGlH;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,WAAW;IACjD,MAAM,EAAE,CAAC,CAAC;IACV,qFAAqF;IACrF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE;IACzE,MAAM,EAAE,CAAC,CAAC;IACV,kGAAkG;IAClG,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IACvD,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA6B3B"}

package/dist/core/codegen.d.ts

@@ -33,6 +33,15 @@ export declare function promptPackCodegen(options: {
     dbReady?: boolean;
     /** True when the project was just scaffolded, so the dev DB has no real data and is safe to reset. */
     freshScaffold?: boolean;
+    /**
+     * Whether anything that just landed changed the Prisma schema. False skips the migration half
+     * of this entirely: no reachability probe, no prompt, no manual steps. A frontend-only pack has
+     * no business asking about the database, and probing it would warn that Docker is down for a
+     * database the install never needed.
+     *
+     * Defaults to true, which is the behavior every caller had before this existed.
+     */
+    schemaChanged?: boolean;
     /** Name for the migration `migrate dev` records, e.g. "init" from `create`. Defaults to "add-packs". */
     migrationName?: string;
     runCommand?: CodegenCommandRunner;

package/dist/core/codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/core/codegen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AA2DtH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,uGAAuG;IACvG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,uGAAuG;IACvG,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,GAAG,OAAO,CAAC,OAAO,CAAC,CAkHnB"}
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/core/codegen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AA2DtH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,uGAAuG;IACvG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wGAAwG;IACxG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,uGAAuG;IACvG,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,GAAG,OAAO,CAAC,OAAO,CAAC,CAmInB"}

package/dist/core/codemods.d.ts

@@ -1,4 +1,4 @@
-import { PackContextEntry, PackDashboardRow, PackEnumEntry, PackEnvEntry, PackFile, PackFrontendRoute, PackNavbarAction, PackNavEntry, PackJob, PackOnboardingStep, PackOrgDetailComponent, PackPermissionEntry, PackProvider, PackRoute, PackSdkConfiguration, PackSettingsTab, PackSlot, PackSocket, StackPaths } from '../types/types.js';
+import { PackContextEntry, PackDashboardRow, PackEnumEntry, PackEnvEntry, PackFile, PackFrontendRoute, PackNavbarAction, PackNavEntry, PackJob, PackOnboardingStep, PackOrgDetailComponent, PackPermissionEntry, PackProvider, PackRoute, PackSdkConfiguration, PackSettingsTab, PackSlot, ShellActionArea, PackSocket, StackPaths } from '../types/types.js';
 /** Replace the template workspace scope with the project scope, preserving `@hype-stack/cli`. */
 export declare function rewriteTemplateScope(content: string, newScope: string): string;
 /**
@@ -115,6 +115,19 @@ export declare function patchJobs(jobs: PackJob[], paths: StackPaths, projectRoo
 export declare function patchDashboardRows(rows: PackDashboardRow[], paths: StackPaths, projectRoot: string): Promise<void>;
 export declare function patchOrgDetailsRows(components: PackOrgDetailComponent[], paths: StackPaths, projectRoot: string): Promise<void>;
 export declare function patchOrgDetailsCards(components: PackOrgDetailComponent[], paths: StackPaths, projectRoot: string): Promise<void>;
+interface ShellActionAreaSpec {
+    /** Name of the exported array the area's entries live in. */
+    arrayName: string;
+    /** Element type of that array, as written in the file. */
+    typeName: string;
+    /** Which shells can render this area. */
+    shells: readonly PackSlot[];
+}
+/**
+ * Where each area lives. Web areas resolve against the frontend or admin shell
+ * (whichever the pack was selected for); the drawer area only exists on mobile.
+ */
+export declare const SHELL_ACTION_AREAS: Record<ShellActionArea, ShellActionAreaSpec>;
 export interface PatchActionsOptions {
     actions: PackNavbarAction[];
     paths: StackPaths;
@@ -122,8 +135,21 @@ export interface PatchActionsOptions {
     /** App shell to target (frontend by default, admin when retargeted). */
     slot?: PackSlot;
 }
+export interface PatchShellActionsOptions extends PatchActionsOptions {
+    area: ShellActionArea;
+}
 export declare function patchNavbarActions(options: PatchActionsOptions): Promise<void>;
 export declare function patchUserMenuActions(options: PatchActionsOptions): Promise<void>;
+/** The actions file for a shell, relative to the project root. */
+export declare function resolveShellActionsFile(slot: PackSlot | undefined, paths: StackPaths): string;
+/**
+ * Add actions to one area of one shell. Idempotent: an action already in the
+ * area (by id) is left alone, an import already present is not repeated. The
+ * file is created from the shell's template when missing, and an area export
+ * missing from an older file is appended, so a project generated before an area
+ * existed still gets it wired.
+ */
+export declare function patchShellActions({ actions, area, paths, projectRoot, slot, }: PatchShellActionsOptions): Promise<void>;
 export interface PatchProvidersOptions {
     providers: PackProvider[];
     paths: StackPaths;

package/dist/core/codemods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../src/core/codemods.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codemods.d.ts","sourceRoot":"","sources":["../../src/core/codemods.ts"],"names":[],"mappings":"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"}

package/dist/core/installer.d.ts

@@ -1,9 +1,30 @@
-import { PackManifest, PackSlot, SourceRevision, StackConfig, TemplateManifest } from '../types/types.js';
+import { PackManifest, PackSlot, PackSource, ShellActionRecord, SourceRevision, StackConfig, StackPaths, TemplateManifest } from '../types/types.js';
 export interface InstallResult {
     installed: string[];
     skipped: string[];
     errors: string[];
+    /** Shell actions this install wired, for `markPackInstalled` to record. */
+    shellActions: ShellActionRecord[];
 }
+/**
+ * Whether any of the files that just landed contribute to the Prisma schema.
+ *
+ * Packs add models by dropping a file into `{{backend.prisma}}/schema/` and letting Prisma's
+ * multi-file schema do the merging, so "this install needs a migration" is exactly "something
+ * landed under the backend's prisma directory". Nothing else touches the schema: no codemod
+ * writes `.prisma`, and a schema file that was skipped because it already existed changed
+ * nothing, which is why this reads `installed` rather than the manifest.
+ *
+ * Takes the raw target templates `InstallResult.installed` holds (`installFile` returns
+ * `file.target`), so it resolves each one before comparing. Directory entries are covered by the
+ * same containment test as single files. `TemplateOverlayResult.installed` mixes those templates
+ * with plain project-relative paths from `overlayDir`; both work, since a path with no `{{}}` in
+ * it comes back from `resolvePathTemplate` untouched.
+ *
+ * Returns true when the project's `stack.json` predates the `backend.prisma` path key: without
+ * it there is no way to tell, and the conservative answer is to keep asking.
+ */
+export declare function touchesPrismaSchema(installedTargets: string[], paths: StackPaths, projectRoot: string): boolean;
 interface PackInstallOptions {
     manifest: PackManifest;
     config: StackConfig;
@@ -25,11 +46,29 @@ export interface FileConflict {
     targetPath: string;
 }
 /**
- * Find every file that `applyPackInstall` would silently skip because its target already exists.
- * Only `create` files can conflict: `skip-if-exists` is an intentional no-op and `merge` /
- * `merge-json` edit the existing file in place. Deduplicated by resolved path so the same target is
- * never reported twice.
+ * Every file a pack would write into this project, as absolute target paths, walking directory
+ * entries down to their files. Merge strategies are left out: those edit a file the project owns
+ * rather than putting one down. This is what a starter swap diffs to know which of the old
+ * starter's files the new one does not ship.
  */
+export declare function listPackTargets(options: {
+    manifest: PackManifest;
+    packDir: string;
+    config: StackConfig;
+    projectRoot: string;
+    slots?: PackSlot[];
+}): Promise<Set<string>>;
+/**
+ * The resolved target path of every `create` entry a pack would install, directory entries
+ * included. This is the granularity `installFile` and `findInstallConflicts` decide at, so an
+ * overwrite approval has to name one of these, not a file inside a directory entry.
+ */
+export declare function listPackEntryTargets(options: {
+    manifest: PackManifest;
+    config: StackConfig;
+    projectRoot: string;
+    slots?: PackSlot[];
+}): Promise<string[]>;
 export declare function findInstallConflicts(options: {
     packs: PreparedPack[];
     config: StackConfig;
@@ -51,13 +90,18 @@ export declare function planPackInstall(options: PackInstallOptions): Promise<st
 export declare function applyPackInstall(options: PackInstallOptions): Promise<InstallResult>;
 export interface PreparedPack {
     manifest: PackManifest;
-    /** Directory holding the pack files downloaded from the backend. */
+    /** Directory holding the staged pack files. Always a temp dir the caller owns and deletes. */
     packDir: string;
     /**
      * Where these files came from, as reported by the download. Recorded in `stack.json` so the
      * project knows which revision of the pack it has. Null against an API that predates it.
      */
     revision?: SourceRevision | null;
+    /**
+     * Which lane the pack arrived through. Absent means the registry, which is what every install
+     * was before community packs existed.
+     */
+    source?: PackSource;
 }
 export interface InstallPlanResult {
     installed: string[];
@@ -105,6 +149,10 @@ export declare function markPackInstalled(options: {
     projectRoot: string;
     /** Provenance from the download. Absent against an API that does not report one. */
     revision?: SourceRevision | null;
+    /** Which lane the pack arrived through. Absent (or `registry`) for the catalog. */
+    source?: PackSource;
+    /** Shell actions the install wired, from `InstallResult.shellActions`. Replaces the pack's previous records. */
+    shellActions?: ShellActionRecord[];
 }): Promise<StackConfig>;
 export interface TemplateOverlayResult {
     installed: string[];

package/dist/core/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"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"}

package/dist/core/installs.d.ts

@@ -1,4 +1,4 @@
-import { InstallKind, InstallRecord, SourceRevision, StackConfig } from '../types/types.js';
+import { InstallKind, InstallRecord, PackSource, SourceRevision, StackConfig } from '../types/types.js';
 /**
  * The install log in `stack.json`: what landed in the project, from which revision, and when.
  *
@@ -18,6 +18,12 @@ export declare function buildInstallRecord(options: {
     commit?: string | null;
     /** Used when the download reported no revision, e.g. the version from the local manifest. */
     version?: string;
+    /**
+     * Where the files came from, for anything outside our own registry. A `registry` source is
+     * dropped rather than written out: it is the default, and a record that states the obvious on
+     * every entry makes the ones that matter harder to spot.
+     */
+    source?: PackSource;
     /** Defaults to now. Injected by tests so timestamps are predictable. */
     installedAt?: Date;
 }): InstallRecord;

package/dist/core/installs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installs.d.ts","sourceRoot":"","sources":["../../src/core/installs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjG;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,GAAG,aAAa,CAahB;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CAErF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGtG;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE5E"}
+{"version":3,"file":"installs.d.ts","sourceRoot":"","sources":["../../src/core/installs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7G;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,wEAAwE;IACxE,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB,GAAG,aAAa,CAchB;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CAErF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAGtG;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE5E"}

package/dist/core/npm-deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npm-deps.d.ts","sourceRoot":"","sources":["../../src/core/npm-deps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AASD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACnE,KAAK,EAAE,UAAU,GAChB,4BAA4B,CAqC9B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,mBAAmB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,GAC1E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAYxC;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,KACE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,oBAA2B,GACtC,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBxE;AAED,sGAAsG;AACtG,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,oBAA2B,GACtC,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}
+{"version":3,"file":"npm-deps.d.ts","sourceRoot":"","sources":["../../src/core/npm-deps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AASD,+FAA+F;AAC/F,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACnE,KAAK,EAAE,UAAU,GAChB,4BAA4B,CAqC9B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,mBAAmB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,GAC1E,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAYxC;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,KACE,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,oBAA2C,GACtD,OAAO,CAAC,UAAU,CAAC,CAErB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBxE;AAED,sGAAsG;AACtG,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,oBAA2C,GACtD,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}

package/dist/core/onboard-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"onboard-catalog.d.ts","sourceRoot":"","sources":["../../src/core/onboard-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;CAWsB,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAWzD,CAAC;AAIF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGzE;AAgDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAGnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,GAAG,OAAO,CAIjG;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE;IAAE,UAAU,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,EAAE,GAAG,SAAS,GACzD,UAAU,EAAE,CAWd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAStE;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAiB7C,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAalE"}
+{"version":3,"file":"onboard-catalog.d.ts","sourceRoot":"","sources":["../../src/core/onboard-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;CAWsB,CAAC;AAEhD,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAWzD,CAAC;AAIF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAGzE;AAgDD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAGnE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,GAAG,OAAO,CAIjG;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE;IAAE,UAAU,EAAE;QAAE,OAAO,EAAE,UAAU,CAAA;KAAE,CAAA;CAAE,EAAE,GAAG,SAAS,GACzD,UAAU,EAAE,CAWd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAStE;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAsB7C,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAalE"}

package/dist/core/pack-authoring.d.ts

@@ -0,0 +1,70 @@
+import { StackPaths } from '../types/types.js';
+/**
+ * The pack format, as data an agent can act on.
+ *
+ * This exists because the failure mode when an agent writes a pack blind is not a crash: it is a
+ * manifest that installs cleanly and quietly does nothing, because a file was never declared or a
+ * target named an app the project does not have. Handing over the rules up front is far cheaper
+ * than letting it discover them one validation error at a time.
+ *
+ * Everything here is derived from the constants `validatePackDir` actually enforces, so the guide
+ * cannot drift from the checks. Prose that is not enforced anywhere is kept to the `conventions`
+ * and `mistakes` lists, where it is clearly advice rather than a rule.
+ */
+export interface WiringField {
+    field: string;
+    patches: string;
+    purpose: string;
+    surface: "backend" | "frontend" | "admin" | "shared";
+}
+/**
+ * Every manifest field that makes the CLI patch a file, and what it patches.
+ *
+ * This list is the one thing an agent cannot infer from the JSON schema alone: the schema says a
+ * field takes an array of objects, but not that declaring it is how a route ends up registered.
+ * Keep it in step with the dispatch chain in `applyPackInstall`.
+ */
+export declare const WIRING_FIELDS: readonly WiringField[];
+export declare const FILE_STRATEGY_NOTES: Readonly<Record<string, string>>;
+/** Rules the validator enforces. Breaking one of these fails `validate_pack`. */
+export declare const HARD_RULES: readonly string[];
+/** Advice the validator does not enforce, but that separates a good pack from a working one. */
+export declare const CONVENTIONS: readonly string[];
+/** The ways packs actually go wrong, phrased as the symptom so it is recognisable. */
+export declare const COMMON_MISTAKES: readonly string[];
+/** Hosting a pack: the three free ways, and the one that lets a registry decide who gets it. */
+export declare const PUBLISHING: readonly string[];
+export interface AuthoringGuide {
+    format: {
+        summary: string;
+        required: readonly string[];
+        schemaUrl: string;
+        categories: readonly string[];
+        surfaces: readonly string[];
+        strategies: Readonly<Record<string, string>>;
+        slots: readonly string[];
+    };
+    wiring: readonly WiringField[];
+    rules: readonly string[];
+    conventions: readonly string[];
+    mistakes: readonly string[];
+    workflow: readonly string[];
+    /** How to host a pack so others can install it, including behind a paywall. */
+    publishing: readonly string[];
+    /** Path templates this specific project resolves, when the guide was asked for inside one. */
+    projectPathTemplates?: readonly string[];
+    /** Packs already installed here, so a dependency can name something real. */
+    installedPacks?: readonly string[];
+}
+/**
+ * Build the guide, narrowed to a project when one is available.
+ *
+ * The project-aware half is what makes this worth a tool call rather than a docs link: an agent
+ * writing a pack for a specific app should be told the path templates that app actually resolves
+ * and the packs it can legally depend on, instead of guessing from a generic list.
+ */
+export declare function buildAuthoringGuide(project?: {
+    paths?: StackPaths | null;
+    installedPacks?: readonly string[];
+}): AuthoringGuide;
+//# sourceMappingURL=pack-authoring.d.ts.map

package/dist/core/pack-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-authoring.d.ts","sourceRoot":"","sources":["../../src/core/pack-authoring.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;CACtD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAwH/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhE,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAWvC,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EASxC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAM5C,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAKvC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;QAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,+EAA+E;IAC/E,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,GAAG,cAAc,CA2BjB"}

package/dist/core/pack-categories.d.ts

@@ -17,6 +17,14 @@ export interface PackChoiceGroup {
      * groups (starter, features), which install without a slot.
      */
     slot?: PackSlot;
+    /**
+     * Swappable family this group resolves to one pick (e.g. `pack-billing`). Set on the one-of
+     * groups carved out of the feature list; starter and layout groups are families too but are
+     * addressed by category, so they leave this unset.
+     */
+    family?: string;
+    /** The group may be answered with "none". Only feature families are optional. */
+    optional?: boolean;
 }
 /** Fixed order the picker walks the modules in: foundation first, then shell, then add-ons. */
 export declare const CATEGORY_ORDER: PackCategory[];
@@ -39,4 +47,9 @@ export interface BuildPackChoiceGroupsOptions {
  * dropped, so a fully-installed module never shows an empty prompt.
  */
 export declare function buildPackChoiceGroups(selectable: PackListItem[], options?: BuildPackChoiceGroupsOptions): PackChoiceGroup[];
+/**
+ * The backend names each family ("Billing" for `pack-billing`). Older backends send no label, so
+ * fall back to the family id with its `pack-` prefix dropped and the words capitalised.
+ */
+export declare function familyLabel(family: string, members: PackListItem[]): string;
 //# sourceMappingURL=pack-categories.d.ts.map

package/dist/core/pack-categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-categories.d.ts","sourceRoot":"","sources":["../../src/core/pack-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9E,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,YAAY,EAAqC,CAAC;AAc/E,4FAA4F;AAC5F,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,YAAY,EAAE,EAC1B,OAAO,GAAE,4BAAiC,GACzC,eAAe,EAAE,CAgCnB"}
+{"version":3,"file":"pack-categories.d.ts","sourceRoot":"","sources":["../../src/core/pack-categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9E,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,YAAY,EAAqC,CAAC;AAc/E,4FAA4F;AAC5F,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,YAAY,EAAE,EAC1B,OAAO,GAAE,4BAAiC,GACzC,eAAe,EAAE,CAgCnB;AA0CD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAS3E"}