@beignet/cli 0.0.48 → 0.0.50

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @beignet/cli
 
+## 0.0.50
+
+### Patch Changes
+
+- 6fe026a: Expose event-subscription readiness and asynchronous cleanup, await listener
+  registries during provider startup with bounded rollback, diagnose unsafe app
+  wiring, and make Redis subscription lifecycle failures observable with bounded
+  provider shutdown and recoverable channel state.
+- 4be4573: Keep mail content out of provider instrumentation, document the Redis
+  deployment policy required for monotonic fencing, and align generated agent
+  guidance with optional seed, worker, and migration paths.
+- 2ec5545: Map local Git changes to bounded, source-backed Beignet concepts through the
+  CLI, library API, and MCP server.
+- Updated dependencies [6fe026a]
+- Updated dependencies [4be4573]
+- Updated dependencies [ee402a9]
+- Updated dependencies [d1db53e]
+- Updated dependencies [7b0961b]
+  - @beignet/core@0.0.50
+
+## 0.0.49
+
+### Patch Changes
+
+- e597d53: Require Node.js 22.12 or newer across every Beignet package, generated app,
+  and documented workflow.
+- 3049831: Prevent outbox job registries from silently running without a dispatcher by
+  wiring generated jobs, reporting incomplete app-port configuration, and
+  validating delivery transports before claiming messages. Jobs provider presets
+  replace only the marked generated inline fallback.
+- ea4bcf7: Inspect TypeScript module references structurally in architecture lint,
+  including require/import variants, transitive feature helpers, configured path
+  layouts, and exhaustive feature layer classification.
+- ac46aad: Inspect contracts through import-backed TypeScript syntax and local fluent-builder aliases, align lint and doctor placement diagnostics, and reject non-app roots before `beignet check` runs validation.
+- a06c5b9: Require contracts with query schemas to declare an explicit transport shared by typed clients, servers, and OpenAPI generation. Add deterministic scalar, repeated-array, and flat deep-object transports, migrate CLI generators, and diagnose legacy one-argument query declarations.
+- e597d53: Migrate the Beignet MCP server to the stable TypeScript SDK v2 packages while
+  preserving stdio transport and protocol compatibility.
+- 8c0b355: Isolate and safely frame default rate-limit buckets, fail closed for unresolved user scopes, escape Swagger script data, and require an explicit access policy for devtools routes.
+- b2188d8: Align provider production behavior by validating cache TTLs consistently,
+  requiring encrypted SMTP transport by default, and streaming unknown-size S3
+  uploads through bounded managed multipart uploads with explicit cleanup across
+  all failure stages.
+
+  The S3 provider now requires `@aws-sdk/lib-storage`; the Beignet provider
+  preset installs the compatible version automatically.
+
+- Updated dependencies [e597d53]
+- Updated dependencies [3049831]
+- Updated dependencies [60edd56]
+- Updated dependencies [a06c5b9]
+- Updated dependencies [8c0b355]
+- Updated dependencies [b2188d8]
+  - @beignet/core@0.0.49
+
 ## 0.0.48
 
 ### Patch Changes

package/README.md

@@ -6,6 +6,9 @@
 
 Command-line tools for creating and maintaining Beignet apps.
 
+Beignet requires Node.js 22.12 or newer. Bun 1.3.14 or newer is supported for
+CLI commands.
+
 The package ships a single `beignet` bin. Generated apps install
 `@beignet/cli` as a dev dependency and add a `beignet` package script, so the
 day-to-day form inside an app is:
@@ -362,7 +365,13 @@ server/routes.ts
 generated route tests pass the same value to `createTestApp(...)`.
 
 Route inspection supports contract-group definitions and direct
-`defineContract({ method, path })` exports.
+`defineContract({ method, path })` exports. It reads exported declarations and
+fluent contract calls from TypeScript syntax, so nested objects, comments, and
+multiline expressions do not truncate a contract before its method or path.
+Local fluent-builder aliases and named local exports are followed. Factories
+must be value imports from `@beignet/core/contracts`; named aliases and
+namespace imports work, while same-named methods on unrelated objects are
+ignored.
 
 The standard app layout includes the files feature generators expect:
 
@@ -688,7 +697,9 @@ starter, tests, and feature-specific not-found and conflict catalog errors. Use
 resource.
 
 Generated list routes use cursor pagination with `limit`, `cursor`, `name`,
-`sortBy`, and `sortDirection` query parameters. The generated use case
+`sortBy`, and `sortDirection` query parameters. Their contract pairs the query
+schema with an explicit transport so the client, server, and OpenAPI document
+use the same URL representation. The generated use case
 normalizes cursor pages, validates opaque base64url cursors against the selected
 sort, and passes one repository query object into memory and Drizzle adapters.
 Adapters filter `name` with case-insensitive contains matching, sort only by
@@ -787,10 +798,27 @@ and `make job` create that outbox path on first use and register the feature's
 `beignet doctor` reports events and jobs the registry cannot deliver. Keep the
 route as the durable recovery sweep even when the deferred trigger is present.
 
+`make job` also ensures `jobs: JobDispatcherPort` is declared and bound. When
+the app has no job dispatcher yet, it defers the port and installs an app-owned
+inline dispatcher provider; existing direct wiring and providers such as
+Inngest are preserved. Registry membership alone is not execution wiring.
+Adding the `jobs-inngest` or `jobs-bullmq` preset later replaces only that
+marked generated fallback; an unmarked app-owned inline provider is reported
+as a conflict instead of being removed.
+`beignet doctor` warns when an outbox registry contains jobs but the configured
+ports and port-wiring files do not declare and bind or defer `jobs`. Keep that
+key and the registry's `jobs` entries explicit; doctor reports indeterminate
+registry or port-wiring shapes when they prevent it from verifying required
+wiring, and the generator stops rather than replacing custom spread- or
+helper-based wiring it cannot verify.
+
 Generators wire the provider-backed ports their output depends on. `make
 event` (and `make resource --events`) wires `eventBus: EventBusPort` with
 `createMemoryEventBusProvider()` from
 `@beignet/provider-event-bus-memory`, including the package dependency.
+Listener generation also installs provider lifecycle wiring that registers the
+central listener registry in `start()`, waits for its initial readiness with
+the default 10-second registry deadline, and awaits cleanup in `stop()`.
 `make notification` wires `mailer: MailerPort` with
 `createMemoryMailerProvider()` and `notifications: NotificationPort` with
 `createInlineNotificationsProvider()`, both dev-default providers from
@@ -840,6 +868,8 @@ The runner loads `server/outbox.ts` or `paths.outbox`. That module should export
 `stopOutboxDrainContext(...)`. The context owns app ports and provider
 lifecycle, so the CLI drain uses the same outbox, event bus, jobs,
 instrumentation, actor, and tenant decisions as the scheduled drain route.
+The drain validates all transports required by the registry before claiming a
+batch, so missing `eventBus` or `jobs` wiring does not consume attempts.
 
 Inspect and recover failed deliveries through the same app-owned operational
 context:
@@ -1020,6 +1050,8 @@ Build a deterministic, source-backed graph of the app:
 beignet map
 beignet map --feature issues
 beignet map --json --kind route,use-case,event,listener
+beignet map --changed
+beignet map --changed --base origin/main --json
 ```
 
 The human view summarizes contracts, use cases, workflows, ports, UI, and tests
@@ -1032,17 +1064,48 @@ every edge carries source evidence and confidence.
 
 The JSON app map retains failed local module references as explicit
 `local_import_unresolved` entries instead of silently omitting their edges. It
-also reports `contract_declaration_unresolved` when it finds an exported direct
-`defineContract(...)` declaration whose method or path cannot be derived
-statically. Registration diagnostics identify their declaration through a
-structured `subject.file` and `subject.exportName`; registration status in the
-map uses that identity rather than matching human-readable messages.
+also reports `contract_declaration_unresolved` when an exported direct or
+contract-group declaration has a method, path, or group prefix that cannot be
+derived statically. Registration diagnostics identify their declaration
+through a structured `subject.file` and `subject.exportName`; registration
+status in the map uses that identity rather than matching human-readable
+messages.
 
 `--feature` keeps that feature plus its direct relationships, while `--kind`
 accepts one or a comma-separated list of node kinds. These projections make
 the same full graph practical for coding-agent context windows. The command is
 report-only and does not fail because doctor or lint findings are present.
 
+`--changed` maps the current Git change set to potentially affected concepts.
+Without `--base`, it preserves staged index changes, unstaged worktree changes,
+and untracked files instead of collapsing them into one net diff against
+`HEAD`. With `--base <ref>`, it also includes committed branch changes from the
+merge base of that already-local ref through `HEAD`; Beignet never fetches the
+ref. The bounded report distinguishes direct source changes, reverse local
+imports, one-hop semantic consumers, related members of directly changed
+containers, and feature ownership context. Governing configuration and changed
+direct local workspace dependencies are marked app-wide. Recognized guide
+files such as `README.md`, `AGENTS.md`, and `CLAUDE.md`, plus Markdown or text
+files under a root `docs/` or `documentation/` directory, remain non-impacting.
+Other `.mdx` and `.txt` paths remain application changes. Deleted declarations,
+unresolved imports, changed files with no mapped concept, and other
+static-analysis blind spots remain visible as gaps.
+Changed-file paths and gap paths are repository-relative; app-map node sources
+and source evidence remain relative to the selected app root.
+
+Changed mapping explains potential impact; it does not run checks or claim
+that a change is correct. Use `beignet check` after inspecting the report.
+`--changed` cannot be combined with `--feature` or `--kind`, and `--base`
+requires `--changed`.
+
+The same report is available to library callers:
+
+```ts
+import { mapAppChanges } from "@beignet/cli";
+
+const impact = await mapAppChanges({ cwd: "apps/api", base: "origin/main" });
+```
+
 ## Explain mapped app concepts
 
 Resolve one app-map target into deterministic, source-backed context:
@@ -1090,7 +1153,12 @@ in that order. Every step runs even when an earlier one fails, so a single
 run reports everything that needs fixing; the command exits non-zero when any
 step fails. Missing package scripts are reported as skipped, never as
 failures. Failed package-script output retains at most the last 64 KiB of each
-stream.
+stream. The target package must declare `@beignet/core`, `@beignet/next`, or
+`@beignet/web` as a runtime dependency. The root must also contain
+`app-context.ts` or `beignet.config.*`; a canonical app with both `features/`
+and `server/index.ts` is accepted when `app-context.ts` is missing so doctor
+can report the drift. Other package roots stop before lint, doctor, or app
+scripts run.
 
 Use `beignet check --fix` to apply doctor's eligible low-risk fixes
 before checking, and `beignet check --json` for a versioned payload
@@ -1148,14 +1216,30 @@ Run `lint` when you want the CLI to enforce Beignet dependency direction:
 beignet lint
 ```
 
-The command scans static imports and fails when app layers reach into runtime
-or framework layers. It catches domain, use case, workflow, policy, port,
-contract, route, infra, and component files importing things like `infra/`, UI
-components, route handlers, server modules, client modules, provider packages,
-Next.js, React, or database vendors in the wrong direction. It also catches
-feature-specific domain files importing another feature's domain unless the
-target is `features/shared/domain`. Workflow folders include feature-owned
-jobs, listeners, notifications, schedules, and uploads.
+The command recognizes TypeScript imports and re-exports, `require()`, import
+assignments, and literal dynamic imports. It fails when app layers reach into
+runtime or framework layers, including domain, use case, workflow, policy,
+port, contract, route, schema, seed, agent capability, feature helper, infra,
+and component files importing `infra/`, UI components, route handlers, server
+modules, client modules, provider packages, Next.js, React, or database vendors
+in the wrong direction. Computed `require()` and `import()` expressions inside
+constrained layers fail because lint cannot verify their destination; use a
+string-literal specifier or move runtime loading behind an allowed boundary.
+Client-safe graphs reject Node built-ins whether they use `node:fs` or a bare
+specifier such as `fs/promises`.
+
+Local value-import checks follow feature-root and other local helpers.
+For example, `use-case -> history.ts -> infra` reports the complete chain
+instead of treating `history.ts` as an unknown layer. Every module inside the
+configured feature root is classified; allowed feature-root helpers remain
+helpers, while near-miss canonical names such as `usecases/` report the
+expected `use-cases/` path. Feature-specific domain files still cannot import
+another feature's domain unless the target is `features/shared/domain`.
+Workflow folders include feature-owned jobs, listeners, notifications,
+schedules, tasks, and uploads. Agent capabilities may adapt use cases but core
+application layers cannot depend back on those adapters. Seeds may compose
+factories and app ports, but not concrete infra, providers, UI, or runtime
+composition.
 
 Local imports are resolved with the app's complete `tsconfig.json`
 configuration before dependency direction is classified. That includes
@@ -1163,10 +1247,10 @@ configuration before dependency direction is classified. That includes
 with multiple targets. The CLI uses TypeScript's config parser and resolver, so
 JSON comments and extended tsconfigs follow the same rules as the compiler.
 
-Import diagnostics include 1-based `line` and `column` positions. Human
-output prints clickable `file.ts:12:3` locations; runtime-boundary
-diagnostics report the chain root file and the full import chain in the
-message instead.
+Import diagnostics include 1-based `line` and `column` positions and preserve
+separate occurrences of the same module specifier. Human output prints
+clickable `file.ts:12:3` locations; transitive and runtime-boundary diagnostics
+report the chain root file and the full import chain in the message instead.
 
 Use JSON output in CI or custom scripts, or GitHub annotations in workflows:
 
@@ -1186,13 +1270,18 @@ beignet doctor
 Today it detects:
 
 - Contracts without a matching Next.js route handler
+- Contract query schemas without an explicit second `.query(...)` transport
 - Feature route groups that are not registered in the central route list
 - Feature schedules and tasks that are not registered in `server/schedules.ts`
   or `server/tasks.ts`
 - Feature events with listeners, and feature jobs, that are missing from
   `defineOutboxRegistry({...})` when the app uses outbox delivery
+- Outbox registries with jobs but no declared and bound or deferred `jobs`
+  application port
 - Feature listeners missing from `server/listeners.ts` or otherwise not
   referenced by `registerListeners(...)`
+- Listener wiring that does not register in `start()`, await initial readiness,
+  and await asynchronous cleanup in `stop()`
 - Opted-in runtime manifests that omit generated workflow registries
 - Next.js route handlers that do not map to known contracts
 - OpenAPI drift in direct arrays, exported contract lists, and
@@ -1208,6 +1297,9 @@ Today it detects:
   `features/shared/errors.ts`
 - Feature runtime `appError(...)` calls that are not declared on the feature's
   contracts
+- Feature layers whose normalized name or known alias points at a canonical
+  location, such as `usecases/` instead of `use-cases/` or `events/` instead
+  of `domain/events/`; doctor and lint report the same expected path
 - Authorization metadata whose ability is missing from feature policy coverage
 - Audit-required metadata without feature audit writes or test assertions
 - Mixed `@beignet/*` version ranges in package.json, and mixed installed
@@ -1247,7 +1339,7 @@ Today it detects:
 - Billing entitlement modules that are not wired into infra or server providers
 - Stripe payments configuration paired with local memory payments provider
   wiring
-- Devtools routes that are explicitly enabled without authorization
+- Devtools routes without authorization or an explicit local-only development opt-in
 - Cron routes that do not use `CRON_SECRET`
 - Installed provider packages without expected environment configuration
 - Better Auth providers without an auth route or trusted-origin configuration
@@ -1365,7 +1457,10 @@ Resources:
 Tools:
 
 - `app_map` - project the source-backed app graph by optional `feature`,
-  `kinds`, and `includeDiagnostics` inputs (read-only)
+  `kinds`, and `includeDiagnostics` inputs, or pass
+  `{ changed: true, base?: "origin/main" }` for the same bounded report as
+  `beignet map --changed --json` (read-only). Changed mode rejects projection
+  and diagnostic inputs
 - `explain` - explain any source-backed mapped concept or diagnostic with
   `{ kind, target }`, returning relationships, conventions, findings,
   suggested files, and follow-up commands (read-only)

package/dist/analysis/contract-factories.d.ts

@@ -0,0 +1,17 @@
+import ts from "typescript";
+export type ContractFactoryName = "defineContract" | "defineContractGroup";
+export type ContractFactoryBindings = {
+    localNames: Record<ContractFactoryName, Set<string>>;
+    namespaceNames: Set<string>;
+};
+export type ContractBindingNames = {
+    contracts: Set<string>;
+    groups: Set<string>;
+};
+export declare function contractFactoryBindings(sourceFile: ts.SourceFile): ContractFactoryBindings;
+export declare function isImportedContractFactoryCall(call: ts.CallExpression, name: ContractFactoryName, bindings: ContractFactoryBindings): boolean;
+/** Follow imported factories through local group and contract builder aliases. */
+export declare function contractBindingNames(sourceFile: ts.SourceFile, bindings: ContractFactoryBindings): ContractBindingNames;
+/** Determine whether an expression declares a direct or group-built contract. */
+export declare function isImportedContractDeclaration(expression: ts.Expression, bindings: ContractFactoryBindings, names: ContractBindingNames): boolean;
+//# sourceMappingURL=contract-factories.d.ts.map

package/dist/analysis/contract-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-factories.d.ts","sourceRoot":"","sources":["../../src/analysis/contract-factories.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAE3E,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrB,CAAC;AAkCF,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,EAAE,CAAC,UAAU,GACxB,uBAAuB,CAoCzB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,EAAE,CAAC,cAAc,EACvB,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAaT;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,QAAQ,EAAE,uBAAuB,GAChC,oBAAoB,CAiDtB;AAED,iFAAiF;AACjF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAaT"}

package/dist/analysis/contract-factories.js

@@ -0,0 +1,176 @@
+import ts from "typescript";
+const contractFactoryModule = "@beignet/core/contracts";
+const contractGroupMethods = new Set([
+    "defineContractGroup",
+    "deprecated",
+    "errors",
+    "headers",
+    "meta",
+    "namespace",
+    "prefix",
+    "responses",
+]);
+const httpContractMethods = new Set([
+    "delete",
+    "get",
+    "head",
+    "options",
+    "patch",
+    "post",
+    "put",
+]);
+export function contractFactoryBindings(sourceFile) {
+    const bindings = {
+        localNames: {
+            defineContract: new Set(),
+            defineContractGroup: new Set(),
+        },
+        namespaceNames: new Set(),
+    };
+    for (const statement of sourceFile.statements) {
+        if (!ts.isImportDeclaration(statement) ||
+            !ts.isStringLiteral(statement.moduleSpecifier) ||
+            statement.moduleSpecifier.text !== contractFactoryModule ||
+            !statement.importClause ||
+            statement.importClause.isTypeOnly) {
+            continue;
+        }
+        const namedBindings = statement.importClause.namedBindings;
+        if (namedBindings && ts.isNamespaceImport(namedBindings)) {
+            bindings.namespaceNames.add(namedBindings.name.text);
+            continue;
+        }
+        if (!namedBindings || !ts.isNamedImports(namedBindings))
+            continue;
+        for (const element of namedBindings.elements) {
+            if (element.isTypeOnly)
+                continue;
+            const importedName = (element.propertyName ?? element.name).text;
+            if (!isContractFactoryName(importedName))
+                continue;
+            bindings.localNames[importedName].add(element.name.text);
+        }
+    }
+    return bindings;
+}
+export function isImportedContractFactoryCall(call, name, bindings) {
+    const callee = unwrapExpression(call.expression);
+    if (ts.isIdentifier(callee)) {
+        return bindings.localNames[name].has(callee.text);
+    }
+    if (!ts.isPropertyAccessExpression(callee) || callee.name.text !== name) {
+        return false;
+    }
+    const receiver = unwrapExpression(callee.expression);
+    return (ts.isIdentifier(receiver) && bindings.namespaceNames.has(receiver.text));
+}
+/** Follow imported factories through local group and contract builder aliases. */
+export function contractBindingNames(sourceFile, bindings) {
+    const declarations = sourceFile.statements
+        .filter(ts.isVariableStatement)
+        .flatMap((statement) => [...statement.declarationList.declarations]);
+    const names = {
+        contracts: new Set(),
+        groups: new Set(),
+    };
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const declaration of declarations) {
+            if (!ts.isIdentifier(declaration.name) ||
+                !declaration.initializer ||
+                names.contracts.has(declaration.name.text) ||
+                names.groups.has(declaration.name.text)) {
+                continue;
+            }
+            const chain = contractCallChain(declaration.initializer);
+            if (!chain)
+                continue;
+            if (contractFactoryCall(chain, "defineContract", bindings) ||
+                (chain.baseIdentifier && names.contracts.has(chain.baseIdentifier))) {
+                names.contracts.add(declaration.name.text);
+                changed = true;
+                continue;
+            }
+            if (!isContractGroupDerived(chain, bindings, names.groups))
+                continue;
+            if (chain.calls.some((call) => httpContractMethods.has(call.name))) {
+                names.contracts.add(declaration.name.text);
+                changed = true;
+                continue;
+            }
+            if (chain.calls.some((call) => !contractGroupMethods.has(call.name))) {
+                continue;
+            }
+            names.groups.add(declaration.name.text);
+            changed = true;
+        }
+    }
+    return names;
+}
+/** Determine whether an expression declares a direct or group-built contract. */
+export function isImportedContractDeclaration(expression, bindings, names) {
+    const chain = contractCallChain(expression);
+    if (!chain)
+        return false;
+    if (contractFactoryCall(chain, "defineContract", bindings) ||
+        (chain.baseIdentifier && names.contracts.has(chain.baseIdentifier))) {
+        return true;
+    }
+    return (isContractGroupDerived(chain, bindings, names.groups) &&
+        chain.calls.some((call) => httpContractMethods.has(call.name)));
+}
+function isContractGroupDerived(chain, bindings, groupNames) {
+    return Boolean(contractFactoryCall(chain, "defineContractGroup", bindings) ||
+        (chain.baseIdentifier && groupNames.has(chain.baseIdentifier)));
+}
+function contractFactoryCall(chain, name, bindings) {
+    const calls = chain.rootCall ? [chain.rootCall, ...chain.calls] : chain.calls;
+    return calls.find((call) => isImportedContractFactoryCall(call.node, name, bindings));
+}
+function contractCallChain(rawExpression) {
+    const calls = [];
+    let expression = rawExpression;
+    while (true) {
+        expression = unwrapExpression(expression);
+        if (ts.isPropertyAccessExpression(expression)) {
+            expression = expression.expression;
+            continue;
+        }
+        if (ts.isCallExpression(expression)) {
+            const callee = unwrapExpression(expression.expression);
+            if (ts.isPropertyAccessExpression(callee)) {
+                calls.unshift({ name: callee.name.text, node: expression });
+                expression = callee.expression;
+                continue;
+            }
+            if (ts.isIdentifier(callee)) {
+                return {
+                    baseIdentifier: callee.text,
+                    rootCall: { name: callee.text, node: expression },
+                    calls,
+                };
+            }
+            return undefined;
+        }
+        if (ts.isIdentifier(expression)) {
+            return { baseIdentifier: expression.text, calls };
+        }
+        return undefined;
+    }
+}
+function isContractFactoryName(value) {
+    return value === "defineContract" || value === "defineContractGroup";
+}
+function unwrapExpression(expression) {
+    let current = expression;
+    while (ts.isParenthesizedExpression(current) ||
+        ts.isAsExpression(current) ||
+        ts.isTypeAssertionExpression(current) ||
+        ts.isNonNullExpression(current) ||
+        ts.isSatisfiesExpression(current)) {
+        current = current.expression;
+    }
+    return current;
+}
+//# sourceMappingURL=contract-factories.js.map

package/dist/analysis/contract-factories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-factories.js","sourceRoot":"","sources":["../../src/analysis/contract-factories.ts"],"names":[],"mappings":"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"}

package/dist/analysis/layers.d.ts

@@ -0,0 +1,5 @@
+import { type ResolvedBeignetConfig } from "../config.js";
+export type SourceLayer = "app" | "app-context" | "agent-capability" | "client" | "component" | "contract" | "domain" | "feature-helper" | "feature-port" | "infra" | "lib" | "policy" | "port" | "route" | "schema" | "seed" | "server" | "test" | "use-case" | "workflow" | "unknown";
+export declare function classifySourcePath(filePath: string, config: ResolvedBeignetConfig): SourceLayer;
+export declare function canonicalFeatureLayerPath(filePath: string, config: ResolvedBeignetConfig): string | undefined;
+//# sourceMappingURL=layers.d.ts.map

package/dist/analysis/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/analysis/layers.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,aAAa,GACb,kBAAkB,GAClB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,QAAQ,GACR,gBAAgB,GAChB,cAAc,GACd,OAAO,GACP,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AA6Cd,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,GAC5B,WAAW,CAuEb;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,qBAAqB,GAC5B,MAAM,GAAG,SAAS,CAmCpB"}