@happyvertical/smrt-core 0.55.23 → 0.55.24

package/dist/scanner/types.d.ts

@@ -42,6 +42,14 @@ export interface FieldUIHints {
      * `currency` is a currency-CODE picker, also on `text`).
      */
     widget?: 'textarea' | 'currency' | 'email' | 'url' | 'phone';
+    /**
+     * How the value is presented (#3718 record page): `money` (an INTEGER of
+     * minor units — the amount hint; `widget: 'currency'` is the currency-code
+     * picker), `date` (a business date on a `datetime`, shown without a time),
+     * `datetime`, `percent` (a rate on a `decimal`/`integer`). Validated
+     * against the field type at build time.
+     */
+    format?: 'money' | 'date' | 'datetime' | 'percent';
 }
 /**
  * Structured metadata attached to a field definition under `_meta`.
@@ -74,6 +82,11 @@ export interface FieldMeta {
     ui?: FieldUIHints;
     /** Opt-in column/JSON-path indexing flag. */
     indexed?: boolean;
+    /**
+     * Relationship role on a `foreignKey` / `crossPackageRef` (#3718):
+     * `items` marks the declaring model as the line items of the target.
+     */
+    role?: 'items';
     /** Foreign-key delete action carried in metadata. */
     onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';
     /** Foreign-key update action carried in metadata. */

package/dist/scanner/types.d.ts.map

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

package/dist/scanner/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/scanner/types.ts"],"sourcesContent":["/**\n * Type definitions for AST scanning and manifest generation\n */\n\nimport type {\n  PackageBrowserCapability,\n  RecipeDefinition,\n} from '@happyvertical/smrt-types';\nimport type { SmartObjectConfig } from '../registry.js';\n\n/**\n * Qualified class name in format \"@package/name:ClassName\"\n * Example: \"@happyvertical/smrt-core:Product\"\n */\nexport type QualifiedClassName = `${string}:${string}`;\n\n/**\n * Static per-field UI hints authored via `@field({ ui })` (#2046).\n *\n * A pure presentation seed for the field-policy rail (epic #2045): it rides the\n * manifest under the field's `_meta.ui` (never promoted to a top-level\n * `FieldDefinition` key), reaches runtime at `field._meta.ui` via\n * `ObjectRegistry.getAllFields()`, and is emitted to the browser in generated\n * web-collection definitions. It has NO schema, persistence, or security\n * effect — `sensitive`/`readPermission` remain the security rail.\n */\nexport interface FieldUIHints {\n  /**\n   * Seed the field into the \"basic\" visibility tier (shown before the\n   * advanced disclosure). Unmarked fields default per the cold-start rule:\n   * an object with no basic markers renders everything basic; once any field\n   * is marked, unmarked fields default to advanced.\n   */\n  basic?: boolean;\n  /** Grouping key for form section/grouping (consumer-defined label). */\n  group?: string;\n  /** Relative sort order within the form/group (ascending). */\n  order?: number;\n  /**\n   * Seed the field's policy as locked: org/user policy tiers may not\n   * override it unless an org admin explicitly unlocks it.\n   */\n  locked?: boolean;\n  /**\n   * Presentation widget for the field's input (#3599): one of\n   * `'textarea' | 'currency' | 'email' | 'url' | 'phone'`. Validated against\n   * the field type at build time (every widget needs a `text` field;\n   * `currency` is a currency-CODE picker, also on `text`).\n   */\n  widget?: 'textarea' | 'currency' | 'email' | 'url' | 'phone';\n}\n\n/**\n * Structured metadata attached to a field definition under `_meta`.\n *\n * Captures the field-helper options the scanner and schema/manifest\n * generators read off a field (`sqlType`, `nullable`, `__tenancy`, …). The\n * index signature keeps the bag open for forward-compatible keys without\n * forcing every consumer through `any`.\n */\nexport interface FieldMeta {\n  /** Explicit SQL type override (e.g. 'UUID') applied during schema generation. */\n  sqlType?: string;\n  /** Storage type for cross-package reference ids ('text' forces TEXT). */\n  idType?: 'uuid' | 'text';\n  /** When true, the column is nullable regardless of `required`. */\n  nullable?: boolean;\n  /** Mirror of the field's required flag captured at registration. */\n  required?: boolean;\n  /** Default value carried in metadata for runtime-registry generation. */\n  default?: unknown;\n  /** Per-row SQL backfill for adding/tightening a required column (#3008). */\n  backfill?: string;\n  /** Marks the field as the primary key column. */\n  primaryKey?: boolean;\n  /** Marks the column as unique. */\n  unique?: boolean;\n  /** Column description carried into generated schema. */\n  description?: string;\n  /** Static per-field UI hints authored via `@field({ ui })` (#2046). */\n  ui?: FieldUIHints;\n  /** Opt-in column/JSON-path indexing flag. */\n  indexed?: boolean;\n  /** Foreign-key delete action carried in metadata. */\n  onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';\n  /** Foreign-key update action carried in metadata. */\n  onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';\n  /** Configures physical DDL while retaining FK relationship metadata. */\n  constraint?:\n    | boolean\n    | { engines: Array<'postgres' | 'sqlite' | 'duckdb' | 'json'> };\n  /** Excludes the field from persistence when true. */\n  transient?: boolean;\n  /** Numeric/length validation bounds and pattern. */\n  min?: number;\n  max?: number;\n  minLength?: number;\n  maxLength?: number;\n  /** Allowed values, mirrored from the manifest field's `enum` (#3598). */\n  enum?: ReadonlyArray<string | number>;\n  /**\n   * Validation regex. A string source, a `RegExp`, or — when a manifest was\n   * JSON-serialized and a `RegExp` collapsed to `{}` — an opaque object. Read\n   * sites must narrow before accessing `.source`.\n   */\n  pattern?: unknown;\n  /** Tenancy metadata injected for tenant-scoped models. */\n  __tenancy?: {\n    isTenantIdField?: boolean;\n    /** Populated by the tenancy beforeSave interceptor when enabled. */\n    autoPopulate?: boolean;\n    [key: string]: unknown;\n  };\n  /** Report-aggregate metadata injected by the report normalizer. */\n  __report?: {\n    kind?: string;\n    [key: string]: unknown;\n  };\n  [key: string]: unknown;\n}\n\n/**\n * Controls how a class is exposed in manifests and across packages\n */\nexport type SmrtVisibility =\n  | 'public' // Included in published manifest, available to all consumers\n  | 'internal' // Package-only, excluded from published manifest\n  | 'test'; // Test-only, never in any published manifest\n\nexport interface FieldDefinition {\n  type:\n    | 'text'\n    | 'decimal'\n    | 'boolean'\n    | 'integer'\n    | 'datetime'\n    | 'json'\n    | 'foreignKey'\n    | 'crossPackageRef' // Cross-package reference — UUID id column by default, no DDL FK\n    | 'oneToMany'\n    | 'manyToMany'\n    | 'meta'; // STI meta fields (_meta_type, _meta_data)\n  required?: boolean;\n  default?: unknown;\n  min?: number;\n  max?: number;\n  maxLength?: number;\n  minLength?: number;\n  /**\n   * Closed set of allowed values for a field typed as a TypeScript `enum` or\n   * a string/number literal union, in declaration order (values, not member\n   * names). Resolved by the scanner (#3598); generated tool and REST schemas\n   * constrain the field to it.\n   */\n  enum?: ReadonlyArray<string | number>;\n  related?: string; // For foreignKey, crossPackageRef, oneToMany, manyToMany\n  description?: string;\n  _meta?: FieldMeta;\n  transient?: boolean; // Field not persisted to database\n  /**\n   * Sensitive value (API secrets, credentials, tax IDs). Still persisted, but\n   * excluded from `toPublicJSON()` (generated REST/MCP/SvelteKit responses) and\n   * rejected as a `where` filter key.\n   */\n  sensitive?: boolean;\n  /**\n   * Read-only over generated write surfaces. Stripped from create/update\n   * request bodies so callers cannot mass-assign it.\n   */\n  readonly?: boolean;\n  /**\n   * Permission slug required to include this field in public/read responses.\n   * Omitted unless the serializer is given a resolved permission set that\n   * includes this slug. `sensitive` still wins and hides the field for all\n   * callers.\n   */\n  readPermission?: string;\n  /**\n   * Controls whether the field is included in JSON exports.\n   * - `true`: Always exported (unless site explicitly excludes it)\n   * - `false`: Never exported (cannot be overridden by site config)\n   * - `undefined`: Uses site's fieldExportDefault setting\n   */\n  exported?: boolean;\n}\n\nexport interface MethodParameterDefinition {\n  name: string;\n  type: string;\n  optional: boolean;\n  default?: unknown;\n  /**\n   * The declared annotation -- or a member of an inline object literal inside\n   * it -- was syntax the scanner could not express as a string (intersection,\n   * tuple, conditional, mapped, `typeof`, indexed access).\n   *\n   * `type` still reads `'any'` for compatibility, so this flag is the ONLY\n   * thing separating \"the author wrote `any`\" from \"the scanner gave up\".\n   * Anything that must fail closed on an uncertain type -- notably the API\n   * wire-ability gate in `generators/custom-action.ts` -- reads this (#2686).\n   */\n  typeUnresolved?: boolean;\n  /**\n   * Resolved member types of an INLINE object-literal annotation, flattened\n   * across nested literals, arrays, unions, and type arguments.\n   *\n   * The manifest records an inline literal as the single string `'object'`,\n   * which hides exactly the members that decide whether the bag can cross a\n   * wire (a callback, a model instance). NAMED bags -- an interface, type\n   * alias, `Partial<>`/`Pick<>` -- are deliberately absent here and accepted\n   * heuristically instead; expanding them needs cross-file type resolution the\n   * AST scanner does not perform (#2686).\n   */\n  memberTypes?: string[];\n  /**\n   * For a top-level UNION, each branch with the inline members IT declared.\n   *\n   * `memberTypes` above flattens across branches, which lets one branch veto\n   * another: `{ callback: () => void } | string` is wire-able through its\n   * string branch, but the flattened `Function` rejected the whole parameter.\n   * A consumer that understands this field MUST prefer it over `memberTypes`\n   * for unions. Absent on a non-union parameter and on manifests generated\n   * before #2686.\n   */\n  unionBranches?: ParameterTypeBranch[];\n}\n\n/** One branch of a top-level union parameter type (#2686). */\nexport interface ParameterTypeBranch {\n  /** The branch's own type name, e.g. `string` or `object`. */\n  type: string;\n  /** Inline object members declared by THIS branch only. */\n  memberTypes?: string[];\n}\n\nexport interface MethodDefinition {\n  name: string;\n  async: boolean;\n  parameters: MethodParameterDefinition[];\n  returnType: string;\n  description?: string;\n  isStatic: boolean;\n  isPublic: boolean;\n  /**\n   * Config object of an `@method()` decorator declared on this method.\n   *\n   * `{}` for a bare `@method()`; absent when the method carries no `@method()`\n   * at all. Typed loosely on purpose: this is SCANNED config that reached the\n   * manifest as JSON, so consumers narrow it defensively through\n   * `readMethodDecoratorConfig` in `generators/custom-action.ts` rather than\n   * trusting a compile-time shape. The authoring type is `MethodOptions` in\n   * `decorators/index.ts` (#2686).\n   */\n  decoratorConfig?: Record<string, unknown>;\n}\n\n/**\n * Pre-generated schema column definition for manifest\n */\nexport interface ManifestColumnDefinition {\n  type: string; // SQL type: TEXT, INTEGER, DECIMAL, BOOLEAN, DATETIME, JSON\n  primaryKey?: boolean;\n  /**\n   * Non-DDL marker for SMRT-owned identifier/reference columns.\n   */\n  referenceKind?: 'id' | 'foreignKey' | 'crossPackageRef' | 'tenantId';\n  notNull?: boolean;\n  unique?: boolean;\n  default?: unknown;\n  /** Same-package FK only. Cross-package references never populate this. */\n  foreignKey?: import('../schema/types.js').ColumnDefinition['foreignKey'];\n}\n\n/**\n * Pre-generated schema index definition for manifest\n */\nexport interface ManifestIndexDefinition {\n  /** Optional generated index purpose, preserved across materialization. */\n  description?: string;\n  name: string;\n  columns: string[];\n  unique?: boolean;\n  /** SMRT-owned nullable upsert identity; PostgreSQL 15+ uses NULLS NOT DISTINCT. */\n  nullsNotDistinct?: boolean;\n  where?: string;\n  /**\n   * Expression-based index target — when set, the DDL strategy renders the\n   * index over a JSON path inside `column` (dialect-specific syntax).\n   */\n  jsonPath?: {\n    column: string;\n    path: string;\n  };\n}\n\n/**\n * Pre-generated schema for efficient external package consumption\n * Generated at build time by ManifestGenerator, stored in manifest.json\n */\nexport interface ManifestSchema {\n  tableName: string;\n  /**\n   * Engine-neutral CREATE TABLE preview. Not executable as-is: no indexes,\n   * abstract SQL types. Consumers render `columns` + `indexes` through the\n   * engine DDL strategy (see `schema/manifest-schema.ts`, #2358).\n   */\n  ddl: string;\n  columns: Record<string, ManifestColumnDefinition>;\n  indexes: ManifestIndexDefinition[];\n  version: string; // Hash of schema definition for migration tracking\n}\n\n/**\n * Validation rule type for pre-computed validators\n * These are serializable rules extracted from field definitions at build time,\n * eliminating the need to compile validator closures at runtime.\n */\nexport type ValidationRuleType =\n  | 'required'\n  | 'min'\n  | 'max'\n  | 'minLength'\n  | 'maxLength'\n  | 'pattern';\n\n/**\n * Pre-computed validation rule for a field\n * Generated at build time by ManifestGenerator, stored in manifest.json\n *\n * These rules are evaluated at runtime without creating closure functions,\n * significantly reducing CLI startup time for projects with many SMRT objects.\n */\nexport interface ValidationRule {\n  /** Field name to validate */\n  field: string;\n  /** Type of validation rule */\n  rule: ValidationRuleType;\n  /** Value for the rule (number for min/max/minLength/maxLength, string for pattern) */\n  value?: number | string;\n  /** Field type for context (text, integer, decimal, etc.) */\n  fieldType?: string;\n}\n\n// ── Agent manifest types ────────────────────────────────────────────────\n\n/**\n * Permission declared by an agent\n * Generated from uiSlots (manage:*) and CLI/MCP methods (execute:*)\n */\nexport interface AgentPermission {\n  id: string;\n  label: string;\n  category: 'slot' | 'method';\n  defaultGranted?: boolean;\n}\n\n/**\n * Feature declared by an agent\n */\nexport interface AgentFeature {\n  id: string;\n  label: string;\n  description?: string;\n  type: 'slot' | 'method';\n}\n\n/**\n * Menu item derived from agent uiSlots\n */\nexport interface AgentMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  order: number;\n  path: string;\n  requiredPermission?: string;\n}\n\n/**\n * Component export declaration derived from package.json exports\n */\nexport interface AgentComponentDeclaration {\n  exportPath: string;\n  type: string;\n}\n\n/**\n * UI slot definition captured from static uiSlots on Agent subclasses\n */\nexport interface AgentUISlotManifest {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  order?: number;\n  disabled?: boolean;\n  /** Durable owner for settings written through this slot. */\n  scope?: 'agent' | 'persona';\n  /** Optional fallback form contract for host applications. */\n  settingsSchema?: {\n    version: number;\n    fields: Array<{\n      id: string;\n      label: string;\n      type: 'string' | 'number' | 'boolean' | 'select' | 'textarea' | 'json';\n      description?: string;\n      required?: boolean;\n      default?: unknown;\n      placeholder?: string;\n      options?: Array<{ value: string; label: string }>;\n      min?: number;\n      max?: number;\n    }>;\n  };\n}\n\n/**\n * Admin route declared by an agent via static adminRoutes\n * Consumed by vitePluginAgentRoutes to register admin routes with SvelteKit\n */\nexport interface AgentAdminRouteManifest {\n  /** Route path relative to agent root (e.g., 'sources/[sourceId]') */\n  path: string;\n  /** Component export name from the agent's admin entry point */\n  component: string;\n  /** Optional: export name for server load function */\n  load?: string;\n}\n\n/**\n * A \"create\" option an agent contributes, declared via `static createEntries`\n * on the agent class. See `AgentCreateEntry` in `@happyvertical/smrt-agents/ui`.\n */\nexport interface AgentCreateEntryManifest {\n  id: string;\n  type: string;\n  format?: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  route: string;\n  order?: number;\n  availability?: {\n    permission?: string;\n    accessLevels?: string[];\n    requires?: string[];\n  };\n}\n\n/**\n * Auto-generated agent manifest section\n * Produced by the manifest build pipeline for any class with `agent` decorator config\n */\nexport interface AgentManifest {\n  name: string;\n  slug: string;\n  icon?: string;\n  tier: 'free' | 'standard' | 'premium';\n  description?: string;\n  uiSlots: Record<string, AgentUISlotManifest>;\n  adminRoutes?: AgentAdminRouteManifest[];\n  /** Create options this agent contributes (`static createEntries`) */\n  createEntries?: AgentCreateEntryManifest[];\n  /** Default signal subscriptions declared by this agent */\n  signalSubscriptions?: string[];\n  permissions: AgentPermission[];\n  features: AgentFeature[];\n  menuItems: AgentMenuItem[];\n  components: AgentComponentDeclaration[];\n}\n\n// ── Core manifest types ─────────────────────────────────────────────────\n\nexport interface SmartObjectDefinition {\n  /**\n   * Qualified name in format \"@package/name:ClassName\"\n   * This is the PRIMARY KEY for manifest lookups.\n   * Example: \"@happyvertical/smrt-core:Product\"\n   *\n   * Optional during transition - will be required in future versions.\n   */\n  qualifiedName?: QualifiedClassName;\n\n  /**\n   * Simple class name (PascalCase)\n   * Example: \"Product\"\n   */\n  className: string;\n\n  /**\n   * Package name where this class is defined.\n   * Example: \"@happyvertical/smrt-core\"\n   *\n   * Optional during transition - will be required in future versions.\n   */\n  packageName?: string;\n\n  /**\n   * Visibility control for manifest inclusion\n   * - 'public': Included in published manifest (default)\n   * - 'internal': Package-only, excluded from published manifest\n   * - 'test': Test-only, never in any published manifest\n   *\n   * Defaults to 'public' if not specified.\n   */\n  visibility?: SmrtVisibility;\n\n  /**\n   * @deprecated Use qualifiedName instead. Kept for transition period.\n   * Lowercase class name, formerly used as manifest key.\n   */\n  name: string;\n\n  collection: string; // Pluralized name for endpoints\n  /**\n   * The collection segment of this class's operation permission slugs\n   * (`<permissionCollection>.create`), when it differs from `collection`.\n   * Set only by consumer hosting, which moves a hosted STI subclass to its own\n   * route collection while the permission catalog keeps granting the STI\n   * base's slugs (#3770). Absent in scanned manifests.\n   */\n  permissionCollection?: string;\n  /** User-facing model description (`@smrt({ description })`, else class JSDoc summary). */\n  description?: string;\n  filePath: string;\n  packageVersion?: string; // Package version for external manifest loading\n  importPath?: string; // Import path for dynamic loading (e.g., \"@pkg/objects\")\n  modulePath?: string; // Relative module path within package\n  exportName?: string; // Named export to use (defaults to className)\n  collectionExportName?: string; // Collection class export name\n  fields: Record<string, FieldDefinition>;\n  methods: Record<string, MethodDefinition>;\n  decoratorConfig: SmartObjectConfig;\n  extends?: string; // Base class name (simple name, not qualified)\n  extendsQualified?: string; // Base class qualified name\n  extendsTypeArg?: string; // Generic type argument (e.g., \"Meeting\" from \"SmrtCollection<Meeting>\")\n  tools?: Array<{\n    type: 'function';\n    function: {\n      name: string;\n      description?: string;\n      parameters?: Record<string, unknown>;\n    };\n  }>;\n  /**\n   * Pre-generated schema for efficient external package consumption\n   * Generated at build time by ManifestGenerator (smrt scan)\n   *\n   * When present, consumers can use this pre-computed schema directly\n   * without calling generateSchema() at runtime, eliminating latency.\n   */\n  schema?: ManifestSchema;\n\n  /**\n   * Pre-computed validation rules for efficient runtime validation\n   * Generated at build time by ManifestGenerator (smrt scan)\n   *\n   * When present, the registry uses these rules instead of compiling\n   * validator closures at runtime, significantly reducing startup time.\n   *\n   * @see ValidationRule\n   */\n  validationRules?: ValidationRule[];\n\n  /**\n   * Static properties captured from the class definition\n   * Currently used for `static uiSlots` on Agent subclasses\n   */\n  staticProperties?: Record<string, unknown>;\n\n  /**\n   * The own field generic pickers and assistants use to label a record\n   * (#3599): `@smrt({ display: { label } })`, or the first of\n   * `name`/`title`/`label`/`code` when undeclared. Absent when the model has no\n   * usable own field (it should ship a selector instead).\n   */\n  displayLabelField?: string;\n\n  /**\n   * Auto-generated agent manifest\n   * Only present for classes with `agent` in their decorator config\n   * Generated at build time by ManifestGenerator fifth pass\n   */\n  agent?: AgentManifest;\n}\n\n/**\n * Fixed `timestamp` for every manifest that can reach build output.\n *\n * Manifests are inlined into bundles (`registerPackageManifest(JSON.parse(...))`),\n * so a wall-clock value changes the emitted bytes on every build. That changes\n * Vite's content hash, which changes `dist/`, which invalidates every\n * downstream package through `dependsOn: ['^build']` — one rebuilt package\n * churned 202 of 245 task hashes, and `typecheck` never reused a cache entry\n * across runs (#2223).\n *\n * Nothing reads the field: `getManifestTimestampsHash` invalidates on\n * filesystem mtimes, and `normalizeManifestForHash` deletes it before\n * comparing. A fixed value therefore costs no information.\n *\n * Genuine runtime caches that expire on elapsed time — the discovery cache in\n * `manifest/discover-smrt-packages.ts` — keep using the clock; they never\n * reach build output.\n */\nexport const MANIFEST_TIMESTAMP = 0;\n\n/**\n * Fixed `generatedAt` for knowledge artifacts emitted into `dist/`.\n *\n * Same reasoning as {@link MANIFEST_TIMESTAMP}: build output is compared\n * byte-for-byte, so it cannot carry the clock. The Unix epoch is used rather\n * than `0` because the field is an ISO-8601 string, and a parseable value\n * keeps any consumer that formats it working.\n *\n * The working copy under `.smrt/` keeps a real timestamp — it is useful to a\n * human there, and `preserveKnowledgeGeneratedAt` already stops it churning\n * across incremental rebuilds.\n */\nexport const DETERMINISTIC_GENERATED_AT = '1970-01-01T00:00:00.000Z';\n\n/**\n * A package UI component declared as the selector for one model (#3599),\n * from a `ModuleUISlot` with `selects`.\n */\nexport interface ManifestUISelector {\n  /** The slot id the package registers its component under. */\n  slotId: string;\n  /** Qualified name of the model this component selects. */\n  selects: QualifiedClassName;\n  label?: string;\n  description?: string;\n}\n\nexport interface SmartObjectManifest {\n  version: string;\n  /** Always {@link MANIFEST_TIMESTAMP} for build-output manifests. */\n  timestamp: number;\n  packageName?: string; // Root package name (should be set for all new manifests)\n  packageVersion?: string; // Root package version\n  /**\n   * Objects keyed by qualified name (e.g., \"@happyvertical/smrt-core:Product\")\n   * Key is string for backward compatibility, but should be QualifiedClassName format.\n   */\n  objects: Record<string, SmartObjectDefinition>;\n  /** Test artifacts must not become dependency providers during discovery. */\n  artifactPurpose?: 'runtime' | 'test';\n  moduleType?: string; // Module type identifier (e.g., \"smrt\") for package discovery\n  smrtDependencies?: string[]; // Discovered SMRT packages from dependency tree\n  /**\n   * The package's library build stamps every decorated class it declares\n   * with `static __smrtPackage__` (#3490), so its classes carry their package\n   * identity wherever a consumer bundles them.\n   */\n  stampsConstructors?: true;\n  /**\n   * Declared recipes (#3590): user-facing units of app functionality that\n   * group models, navigation, and prerequisites. Model names are qualified.\n   * Omitted when the package declares none.\n   */\n  recipes?: RecipeDefinition[];\n  /**\n   * Whether this package's root entry builds for a browser (#3709), derived\n   * from the bundle-gate ratchet. Omitted for packages the gate does not\n   * measure (a consumer app, a UI package).\n   */\n  browser?: PackageBrowserCapability;\n  /**\n   * Selector slots keyed by slot id (#3599). Look one up for a model with\n   * `findSelectorFor` from `@happyvertical/smrt-core/ui-metadata`.\n   */\n  uiSelectors?: Record<string, ManifestUISelector>;\n}\n\nexport interface ScanResult {\n  filePath: string;\n  objects: SmartObjectDefinition[];\n  errors: Array<{\n    message: string;\n    line?: number;\n    column?: number;\n  }>;\n}\n\nexport interface ScanOptions {\n  includePrivateMethods?: boolean;\n  includeStaticMethods?: boolean;\n  followImports?: boolean;\n  baseClasses?: string[]; // Classes to consider as SMRT base classes\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA4lBA,IAAa,qBAAqB;;;;;;;;;;;;;AAclC,IAAa,6BAA6B"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/scanner/types.ts"],"sourcesContent":["/**\n * Type definitions for AST scanning and manifest generation\n */\n\nimport type {\n  PackageBrowserCapability,\n  RecipeDefinition,\n} from '@happyvertical/smrt-types';\nimport type { SmartObjectConfig } from '../registry.js';\n\n/**\n * Qualified class name in format \"@package/name:ClassName\"\n * Example: \"@happyvertical/smrt-core:Product\"\n */\nexport type QualifiedClassName = `${string}:${string}`;\n\n/**\n * Static per-field UI hints authored via `@field({ ui })` (#2046).\n *\n * A pure presentation seed for the field-policy rail (epic #2045): it rides the\n * manifest under the field's `_meta.ui` (never promoted to a top-level\n * `FieldDefinition` key), reaches runtime at `field._meta.ui` via\n * `ObjectRegistry.getAllFields()`, and is emitted to the browser in generated\n * web-collection definitions. It has NO schema, persistence, or security\n * effect — `sensitive`/`readPermission` remain the security rail.\n */\nexport interface FieldUIHints {\n  /**\n   * Seed the field into the \"basic\" visibility tier (shown before the\n   * advanced disclosure). Unmarked fields default per the cold-start rule:\n   * an object with no basic markers renders everything basic; once any field\n   * is marked, unmarked fields default to advanced.\n   */\n  basic?: boolean;\n  /** Grouping key for form section/grouping (consumer-defined label). */\n  group?: string;\n  /** Relative sort order within the form/group (ascending). */\n  order?: number;\n  /**\n   * Seed the field's policy as locked: org/user policy tiers may not\n   * override it unless an org admin explicitly unlocks it.\n   */\n  locked?: boolean;\n  /**\n   * Presentation widget for the field's input (#3599): one of\n   * `'textarea' | 'currency' | 'email' | 'url' | 'phone'`. Validated against\n   * the field type at build time (every widget needs a `text` field;\n   * `currency` is a currency-CODE picker, also on `text`).\n   */\n  widget?: 'textarea' | 'currency' | 'email' | 'url' | 'phone';\n  /**\n   * How the value is presented (#3718 record page): `money` (an INTEGER of\n   * minor units — the amount hint; `widget: 'currency'` is the currency-code\n   * picker), `date` (a business date on a `datetime`, shown without a time),\n   * `datetime`, `percent` (a rate on a `decimal`/`integer`). Validated\n   * against the field type at build time.\n   */\n  format?: 'money' | 'date' | 'datetime' | 'percent';\n}\n\n/**\n * Structured metadata attached to a field definition under `_meta`.\n *\n * Captures the field-helper options the scanner and schema/manifest\n * generators read off a field (`sqlType`, `nullable`, `__tenancy`, …). The\n * index signature keeps the bag open for forward-compatible keys without\n * forcing every consumer through `any`.\n */\nexport interface FieldMeta {\n  /** Explicit SQL type override (e.g. 'UUID') applied during schema generation. */\n  sqlType?: string;\n  /** Storage type for cross-package reference ids ('text' forces TEXT). */\n  idType?: 'uuid' | 'text';\n  /** When true, the column is nullable regardless of `required`. */\n  nullable?: boolean;\n  /** Mirror of the field's required flag captured at registration. */\n  required?: boolean;\n  /** Default value carried in metadata for runtime-registry generation. */\n  default?: unknown;\n  /** Per-row SQL backfill for adding/tightening a required column (#3008). */\n  backfill?: string;\n  /** Marks the field as the primary key column. */\n  primaryKey?: boolean;\n  /** Marks the column as unique. */\n  unique?: boolean;\n  /** Column description carried into generated schema. */\n  description?: string;\n  /** Static per-field UI hints authored via `@field({ ui })` (#2046). */\n  ui?: FieldUIHints;\n  /** Opt-in column/JSON-path indexing flag. */\n  indexed?: boolean;\n  /**\n   * Relationship role on a `foreignKey` / `crossPackageRef` (#3718):\n   * `items` marks the declaring model as the line items of the target.\n   */\n  role?: 'items';\n  /** Foreign-key delete action carried in metadata. */\n  onDelete?: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';\n  /** Foreign-key update action carried in metadata. */\n  onUpdate?: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION';\n  /** Configures physical DDL while retaining FK relationship metadata. */\n  constraint?:\n    | boolean\n    | { engines: Array<'postgres' | 'sqlite' | 'duckdb' | 'json'> };\n  /** Excludes the field from persistence when true. */\n  transient?: boolean;\n  /** Numeric/length validation bounds and pattern. */\n  min?: number;\n  max?: number;\n  minLength?: number;\n  maxLength?: number;\n  /** Allowed values, mirrored from the manifest field's `enum` (#3598). */\n  enum?: ReadonlyArray<string | number>;\n  /**\n   * Validation regex. A string source, a `RegExp`, or — when a manifest was\n   * JSON-serialized and a `RegExp` collapsed to `{}` — an opaque object. Read\n   * sites must narrow before accessing `.source`.\n   */\n  pattern?: unknown;\n  /** Tenancy metadata injected for tenant-scoped models. */\n  __tenancy?: {\n    isTenantIdField?: boolean;\n    /** Populated by the tenancy beforeSave interceptor when enabled. */\n    autoPopulate?: boolean;\n    [key: string]: unknown;\n  };\n  /** Report-aggregate metadata injected by the report normalizer. */\n  __report?: {\n    kind?: string;\n    [key: string]: unknown;\n  };\n  [key: string]: unknown;\n}\n\n/**\n * Controls how a class is exposed in manifests and across packages\n */\nexport type SmrtVisibility =\n  | 'public' // Included in published manifest, available to all consumers\n  | 'internal' // Package-only, excluded from published manifest\n  | 'test'; // Test-only, never in any published manifest\n\nexport interface FieldDefinition {\n  type:\n    | 'text'\n    | 'decimal'\n    | 'boolean'\n    | 'integer'\n    | 'datetime'\n    | 'json'\n    | 'foreignKey'\n    | 'crossPackageRef' // Cross-package reference — UUID id column by default, no DDL FK\n    | 'oneToMany'\n    | 'manyToMany'\n    | 'meta'; // STI meta fields (_meta_type, _meta_data)\n  required?: boolean;\n  default?: unknown;\n  min?: number;\n  max?: number;\n  maxLength?: number;\n  minLength?: number;\n  /**\n   * Closed set of allowed values for a field typed as a TypeScript `enum` or\n   * a string/number literal union, in declaration order (values, not member\n   * names). Resolved by the scanner (#3598); generated tool and REST schemas\n   * constrain the field to it.\n   */\n  enum?: ReadonlyArray<string | number>;\n  related?: string; // For foreignKey, crossPackageRef, oneToMany, manyToMany\n  description?: string;\n  _meta?: FieldMeta;\n  transient?: boolean; // Field not persisted to database\n  /**\n   * Sensitive value (API secrets, credentials, tax IDs). Still persisted, but\n   * excluded from `toPublicJSON()` (generated REST/MCP/SvelteKit responses) and\n   * rejected as a `where` filter key.\n   */\n  sensitive?: boolean;\n  /**\n   * Read-only over generated write surfaces. Stripped from create/update\n   * request bodies so callers cannot mass-assign it.\n   */\n  readonly?: boolean;\n  /**\n   * Permission slug required to include this field in public/read responses.\n   * Omitted unless the serializer is given a resolved permission set that\n   * includes this slug. `sensitive` still wins and hides the field for all\n   * callers.\n   */\n  readPermission?: string;\n  /**\n   * Controls whether the field is included in JSON exports.\n   * - `true`: Always exported (unless site explicitly excludes it)\n   * - `false`: Never exported (cannot be overridden by site config)\n   * - `undefined`: Uses site's fieldExportDefault setting\n   */\n  exported?: boolean;\n}\n\nexport interface MethodParameterDefinition {\n  name: string;\n  type: string;\n  optional: boolean;\n  default?: unknown;\n  /**\n   * The declared annotation -- or a member of an inline object literal inside\n   * it -- was syntax the scanner could not express as a string (intersection,\n   * tuple, conditional, mapped, `typeof`, indexed access).\n   *\n   * `type` still reads `'any'` for compatibility, so this flag is the ONLY\n   * thing separating \"the author wrote `any`\" from \"the scanner gave up\".\n   * Anything that must fail closed on an uncertain type -- notably the API\n   * wire-ability gate in `generators/custom-action.ts` -- reads this (#2686).\n   */\n  typeUnresolved?: boolean;\n  /**\n   * Resolved member types of an INLINE object-literal annotation, flattened\n   * across nested literals, arrays, unions, and type arguments.\n   *\n   * The manifest records an inline literal as the single string `'object'`,\n   * which hides exactly the members that decide whether the bag can cross a\n   * wire (a callback, a model instance). NAMED bags -- an interface, type\n   * alias, `Partial<>`/`Pick<>` -- are deliberately absent here and accepted\n   * heuristically instead; expanding them needs cross-file type resolution the\n   * AST scanner does not perform (#2686).\n   */\n  memberTypes?: string[];\n  /**\n   * For a top-level UNION, each branch with the inline members IT declared.\n   *\n   * `memberTypes` above flattens across branches, which lets one branch veto\n   * another: `{ callback: () => void } | string` is wire-able through its\n   * string branch, but the flattened `Function` rejected the whole parameter.\n   * A consumer that understands this field MUST prefer it over `memberTypes`\n   * for unions. Absent on a non-union parameter and on manifests generated\n   * before #2686.\n   */\n  unionBranches?: ParameterTypeBranch[];\n}\n\n/** One branch of a top-level union parameter type (#2686). */\nexport interface ParameterTypeBranch {\n  /** The branch's own type name, e.g. `string` or `object`. */\n  type: string;\n  /** Inline object members declared by THIS branch only. */\n  memberTypes?: string[];\n}\n\nexport interface MethodDefinition {\n  name: string;\n  async: boolean;\n  parameters: MethodParameterDefinition[];\n  returnType: string;\n  description?: string;\n  isStatic: boolean;\n  isPublic: boolean;\n  /**\n   * Config object of an `@method()` decorator declared on this method.\n   *\n   * `{}` for a bare `@method()`; absent when the method carries no `@method()`\n   * at all. Typed loosely on purpose: this is SCANNED config that reached the\n   * manifest as JSON, so consumers narrow it defensively through\n   * `readMethodDecoratorConfig` in `generators/custom-action.ts` rather than\n   * trusting a compile-time shape. The authoring type is `MethodOptions` in\n   * `decorators/index.ts` (#2686).\n   */\n  decoratorConfig?: Record<string, unknown>;\n}\n\n/**\n * Pre-generated schema column definition for manifest\n */\nexport interface ManifestColumnDefinition {\n  type: string; // SQL type: TEXT, INTEGER, DECIMAL, BOOLEAN, DATETIME, JSON\n  primaryKey?: boolean;\n  /**\n   * Non-DDL marker for SMRT-owned identifier/reference columns.\n   */\n  referenceKind?: 'id' | 'foreignKey' | 'crossPackageRef' | 'tenantId';\n  notNull?: boolean;\n  unique?: boolean;\n  default?: unknown;\n  /** Same-package FK only. Cross-package references never populate this. */\n  foreignKey?: import('../schema/types.js').ColumnDefinition['foreignKey'];\n}\n\n/**\n * Pre-generated schema index definition for manifest\n */\nexport interface ManifestIndexDefinition {\n  /** Optional generated index purpose, preserved across materialization. */\n  description?: string;\n  name: string;\n  columns: string[];\n  unique?: boolean;\n  /** SMRT-owned nullable upsert identity; PostgreSQL 15+ uses NULLS NOT DISTINCT. */\n  nullsNotDistinct?: boolean;\n  where?: string;\n  /**\n   * Expression-based index target — when set, the DDL strategy renders the\n   * index over a JSON path inside `column` (dialect-specific syntax).\n   */\n  jsonPath?: {\n    column: string;\n    path: string;\n  };\n}\n\n/**\n * Pre-generated schema for efficient external package consumption\n * Generated at build time by ManifestGenerator, stored in manifest.json\n */\nexport interface ManifestSchema {\n  tableName: string;\n  /**\n   * Engine-neutral CREATE TABLE preview. Not executable as-is: no indexes,\n   * abstract SQL types. Consumers render `columns` + `indexes` through the\n   * engine DDL strategy (see `schema/manifest-schema.ts`, #2358).\n   */\n  ddl: string;\n  columns: Record<string, ManifestColumnDefinition>;\n  indexes: ManifestIndexDefinition[];\n  version: string; // Hash of schema definition for migration tracking\n}\n\n/**\n * Validation rule type for pre-computed validators\n * These are serializable rules extracted from field definitions at build time,\n * eliminating the need to compile validator closures at runtime.\n */\nexport type ValidationRuleType =\n  | 'required'\n  | 'min'\n  | 'max'\n  | 'minLength'\n  | 'maxLength'\n  | 'pattern';\n\n/**\n * Pre-computed validation rule for a field\n * Generated at build time by ManifestGenerator, stored in manifest.json\n *\n * These rules are evaluated at runtime without creating closure functions,\n * significantly reducing CLI startup time for projects with many SMRT objects.\n */\nexport interface ValidationRule {\n  /** Field name to validate */\n  field: string;\n  /** Type of validation rule */\n  rule: ValidationRuleType;\n  /** Value for the rule (number for min/max/minLength/maxLength, string for pattern) */\n  value?: number | string;\n  /** Field type for context (text, integer, decimal, etc.) */\n  fieldType?: string;\n}\n\n// ── Agent manifest types ────────────────────────────────────────────────\n\n/**\n * Permission declared by an agent\n * Generated from uiSlots (manage:*) and CLI/MCP methods (execute:*)\n */\nexport interface AgentPermission {\n  id: string;\n  label: string;\n  category: 'slot' | 'method';\n  defaultGranted?: boolean;\n}\n\n/**\n * Feature declared by an agent\n */\nexport interface AgentFeature {\n  id: string;\n  label: string;\n  description?: string;\n  type: 'slot' | 'method';\n}\n\n/**\n * Menu item derived from agent uiSlots\n */\nexport interface AgentMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  order: number;\n  path: string;\n  requiredPermission?: string;\n}\n\n/**\n * Component export declaration derived from package.json exports\n */\nexport interface AgentComponentDeclaration {\n  exportPath: string;\n  type: string;\n}\n\n/**\n * UI slot definition captured from static uiSlots on Agent subclasses\n */\nexport interface AgentUISlotManifest {\n  id: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  order?: number;\n  disabled?: boolean;\n  /** Durable owner for settings written through this slot. */\n  scope?: 'agent' | 'persona';\n  /** Optional fallback form contract for host applications. */\n  settingsSchema?: {\n    version: number;\n    fields: Array<{\n      id: string;\n      label: string;\n      type: 'string' | 'number' | 'boolean' | 'select' | 'textarea' | 'json';\n      description?: string;\n      required?: boolean;\n      default?: unknown;\n      placeholder?: string;\n      options?: Array<{ value: string; label: string }>;\n      min?: number;\n      max?: number;\n    }>;\n  };\n}\n\n/**\n * Admin route declared by an agent via static adminRoutes\n * Consumed by vitePluginAgentRoutes to register admin routes with SvelteKit\n */\nexport interface AgentAdminRouteManifest {\n  /** Route path relative to agent root (e.g., 'sources/[sourceId]') */\n  path: string;\n  /** Component export name from the agent's admin entry point */\n  component: string;\n  /** Optional: export name for server load function */\n  load?: string;\n}\n\n/**\n * A \"create\" option an agent contributes, declared via `static createEntries`\n * on the agent class. See `AgentCreateEntry` in `@happyvertical/smrt-agents/ui`.\n */\nexport interface AgentCreateEntryManifest {\n  id: string;\n  type: string;\n  format?: string;\n  label: string;\n  description?: string;\n  icon?: string;\n  route: string;\n  order?: number;\n  availability?: {\n    permission?: string;\n    accessLevels?: string[];\n    requires?: string[];\n  };\n}\n\n/**\n * Auto-generated agent manifest section\n * Produced by the manifest build pipeline for any class with `agent` decorator config\n */\nexport interface AgentManifest {\n  name: string;\n  slug: string;\n  icon?: string;\n  tier: 'free' | 'standard' | 'premium';\n  description?: string;\n  uiSlots: Record<string, AgentUISlotManifest>;\n  adminRoutes?: AgentAdminRouteManifest[];\n  /** Create options this agent contributes (`static createEntries`) */\n  createEntries?: AgentCreateEntryManifest[];\n  /** Default signal subscriptions declared by this agent */\n  signalSubscriptions?: string[];\n  permissions: AgentPermission[];\n  features: AgentFeature[];\n  menuItems: AgentMenuItem[];\n  components: AgentComponentDeclaration[];\n}\n\n// ── Core manifest types ─────────────────────────────────────────────────\n\nexport interface SmartObjectDefinition {\n  /**\n   * Qualified name in format \"@package/name:ClassName\"\n   * This is the PRIMARY KEY for manifest lookups.\n   * Example: \"@happyvertical/smrt-core:Product\"\n   *\n   * Optional during transition - will be required in future versions.\n   */\n  qualifiedName?: QualifiedClassName;\n\n  /**\n   * Simple class name (PascalCase)\n   * Example: \"Product\"\n   */\n  className: string;\n\n  /**\n   * Package name where this class is defined.\n   * Example: \"@happyvertical/smrt-core\"\n   *\n   * Optional during transition - will be required in future versions.\n   */\n  packageName?: string;\n\n  /**\n   * Visibility control for manifest inclusion\n   * - 'public': Included in published manifest (default)\n   * - 'internal': Package-only, excluded from published manifest\n   * - 'test': Test-only, never in any published manifest\n   *\n   * Defaults to 'public' if not specified.\n   */\n  visibility?: SmrtVisibility;\n\n  /**\n   * @deprecated Use qualifiedName instead. Kept for transition period.\n   * Lowercase class name, formerly used as manifest key.\n   */\n  name: string;\n\n  collection: string; // Pluralized name for endpoints\n  /**\n   * The collection segment of this class's operation permission slugs\n   * (`<permissionCollection>.create`), when it differs from `collection`.\n   * Set only by consumer hosting, which moves a hosted STI subclass to its own\n   * route collection while the permission catalog keeps granting the STI\n   * base's slugs (#3770). Absent in scanned manifests.\n   */\n  permissionCollection?: string;\n  /** User-facing model description (`@smrt({ description })`, else class JSDoc summary). */\n  description?: string;\n  filePath: string;\n  packageVersion?: string; // Package version for external manifest loading\n  importPath?: string; // Import path for dynamic loading (e.g., \"@pkg/objects\")\n  modulePath?: string; // Relative module path within package\n  exportName?: string; // Named export to use (defaults to className)\n  collectionExportName?: string; // Collection class export name\n  fields: Record<string, FieldDefinition>;\n  methods: Record<string, MethodDefinition>;\n  decoratorConfig: SmartObjectConfig;\n  extends?: string; // Base class name (simple name, not qualified)\n  extendsQualified?: string; // Base class qualified name\n  extendsTypeArg?: string; // Generic type argument (e.g., \"Meeting\" from \"SmrtCollection<Meeting>\")\n  tools?: Array<{\n    type: 'function';\n    function: {\n      name: string;\n      description?: string;\n      parameters?: Record<string, unknown>;\n    };\n  }>;\n  /**\n   * Pre-generated schema for efficient external package consumption\n   * Generated at build time by ManifestGenerator (smrt scan)\n   *\n   * When present, consumers can use this pre-computed schema directly\n   * without calling generateSchema() at runtime, eliminating latency.\n   */\n  schema?: ManifestSchema;\n\n  /**\n   * Pre-computed validation rules for efficient runtime validation\n   * Generated at build time by ManifestGenerator (smrt scan)\n   *\n   * When present, the registry uses these rules instead of compiling\n   * validator closures at runtime, significantly reducing startup time.\n   *\n   * @see ValidationRule\n   */\n  validationRules?: ValidationRule[];\n\n  /**\n   * Static properties captured from the class definition\n   * Currently used for `static uiSlots` on Agent subclasses\n   */\n  staticProperties?: Record<string, unknown>;\n\n  /**\n   * The own field generic pickers and assistants use to label a record\n   * (#3599): `@smrt({ display: { label } })`, or the first of\n   * `name`/`title`/`label`/`code` when undeclared. Absent when the model has no\n   * usable own field (it should ship a selector instead).\n   */\n  displayLabelField?: string;\n\n  /**\n   * Auto-generated agent manifest\n   * Only present for classes with `agent` in their decorator config\n   * Generated at build time by ManifestGenerator fifth pass\n   */\n  agent?: AgentManifest;\n}\n\n/**\n * Fixed `timestamp` for every manifest that can reach build output.\n *\n * Manifests are inlined into bundles (`registerPackageManifest(JSON.parse(...))`),\n * so a wall-clock value changes the emitted bytes on every build. That changes\n * Vite's content hash, which changes `dist/`, which invalidates every\n * downstream package through `dependsOn: ['^build']` — one rebuilt package\n * churned 202 of 245 task hashes, and `typecheck` never reused a cache entry\n * across runs (#2223).\n *\n * Nothing reads the field: `getManifestTimestampsHash` invalidates on\n * filesystem mtimes, and `normalizeManifestForHash` deletes it before\n * comparing. A fixed value therefore costs no information.\n *\n * Genuine runtime caches that expire on elapsed time — the discovery cache in\n * `manifest/discover-smrt-packages.ts` — keep using the clock; they never\n * reach build output.\n */\nexport const MANIFEST_TIMESTAMP = 0;\n\n/**\n * Fixed `generatedAt` for knowledge artifacts emitted into `dist/`.\n *\n * Same reasoning as {@link MANIFEST_TIMESTAMP}: build output is compared\n * byte-for-byte, so it cannot carry the clock. The Unix epoch is used rather\n * than `0` because the field is an ISO-8601 string, and a parseable value\n * keeps any consumer that formats it working.\n *\n * The working copy under `.smrt/` keeps a real timestamp — it is useful to a\n * human there, and `preserveKnowledgeGeneratedAt` already stops it churning\n * across incremental rebuilds.\n */\nexport const DETERMINISTIC_GENERATED_AT = '1970-01-01T00:00:00.000Z';\n\n/**\n * A package UI component declared as the selector for one model (#3599),\n * from a `ModuleUISlot` with `selects`.\n */\nexport interface ManifestUISelector {\n  /** The slot id the package registers its component under. */\n  slotId: string;\n  /** Qualified name of the model this component selects. */\n  selects: QualifiedClassName;\n  label?: string;\n  description?: string;\n}\n\nexport interface SmartObjectManifest {\n  version: string;\n  /** Always {@link MANIFEST_TIMESTAMP} for build-output manifests. */\n  timestamp: number;\n  packageName?: string; // Root package name (should be set for all new manifests)\n  packageVersion?: string; // Root package version\n  /**\n   * Objects keyed by qualified name (e.g., \"@happyvertical/smrt-core:Product\")\n   * Key is string for backward compatibility, but should be QualifiedClassName format.\n   */\n  objects: Record<string, SmartObjectDefinition>;\n  /** Test artifacts must not become dependency providers during discovery. */\n  artifactPurpose?: 'runtime' | 'test';\n  moduleType?: string; // Module type identifier (e.g., \"smrt\") for package discovery\n  smrtDependencies?: string[]; // Discovered SMRT packages from dependency tree\n  /**\n   * The package's library build stamps every decorated class it declares\n   * with `static __smrtPackage__` (#3490), so its classes carry their package\n   * identity wherever a consumer bundles them.\n   */\n  stampsConstructors?: true;\n  /**\n   * Declared recipes (#3590): user-facing units of app functionality that\n   * group models, navigation, and prerequisites. Model names are qualified.\n   * Omitted when the package declares none.\n   */\n  recipes?: RecipeDefinition[];\n  /**\n   * Whether this package's root entry builds for a browser (#3709), derived\n   * from the bundle-gate ratchet. Omitted for packages the gate does not\n   * measure (a consumer app, a UI package).\n   */\n  browser?: PackageBrowserCapability;\n  /**\n   * Selector slots keyed by slot id (#3599). Look one up for a model with\n   * `findSelectorFor` from `@happyvertical/smrt-core/ui-metadata`.\n   */\n  uiSelectors?: Record<string, ManifestUISelector>;\n}\n\nexport interface ScanResult {\n  filePath: string;\n  objects: SmartObjectDefinition[];\n  errors: Array<{\n    message: string;\n    line?: number;\n    column?: number;\n  }>;\n}\n\nexport interface ScanOptions {\n  includePrivateMethods?: boolean;\n  includeStaticMethods?: boolean;\n  followImports?: boolean;\n  baseClasses?: string[]; // Classes to consider as SMRT base classes\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAymBA,IAAa,qBAAqB;;;;;;;;;;;;;AAclC,IAAa,6BAA6B"}

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-core",
-  "packageVersion": "0.55.23",
+  "packageVersion": "0.55.24",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "852023c8b1dfa1f5dddcfb21df60d85ebc3dd8ae864068269113169465ef5840",
-    "packageJson": "eb4b1d57dc18de61bc355392978393cbbbef339b375c4e18013a3b670cfaad9f",
+    "manifest": "8642918ccc524246f2a1e63dae865d92e2eceebc62dafa8d92422a11c039dfae",
+    "packageJson": "d2f3a12d1f9ff62918ec4dbe6d39cf9d0f7aba9c861a53b16f586b0deed6c695",
     "agents": "a55cc2d7dccf8f5dc9fd515361fddf719466159ee11e265285cf14b3fcdd96fa",
     "moduleDoc:agents/object-runtime.md": "93ba429467c5f3c886613fe5748e14844ceb8d2bbdebd47214a013a8e60b2a06",
     "moduleDoc:agents/revision-guard.md": "f6ea32a6860964c98aba14b93587f40b33c8f7d0deccb2c54d21bff45db3da42",
@@ -19,7 +19,7 @@
     "moduleDoc:agents/change-feed.md": "c3d6206758dd1d2e0475177e1938fb7d7b6cfe8a6c4d3c3b56ef62bc7bc7739d",
     "moduleDoc:agents/change-signals.md": "a2dbe7077483b5a19bd5ea9589b5a08fe847377c8e05d01d57f813c6d9cbc28b",
     "moduleDoc:agents/generators.md": "55244a454c2ab8937143600eb785f069d949d75fc4da8bfdf78fb801a59facc8",
-    "moduleDoc:agents/build-knowledge.md": "d123541604372fd6fa7f0ade665a19b066d2e9c572e09d39c3cb4849211d09ef",
+    "moduleDoc:agents/build-knowledge.md": "93ea3d5c708daea35ec7f90de81ed33974ce1610d76a2d1c32a77e149bec7ee8",
     "moduleDoc:agents/memory.md": "a86bdf370403d08ecad3be86e341eb322dfe6e6b7a4e8806a6f8be9bf3421da5",
     "moduleDoc:agents/system-diagnostics.md": "b7ccae18ee312bf788d5470f95fa78d3535f1789247d5372e40ca86538290772",
     "moduleDoc:agents/registry-snapshot.md": "6234aa540427396d1dda1825a4641b1072e247187d5ddf413ae46c691344ee30",
@@ -1186,7 +1186,7 @@
     {
       "path": "agents/build-knowledge.md",
       "module": "build-knowledge",
-      "content": "# Decorators, build integration, and knowledge\n\nKey options: `tableName`, `tableStrategy` ('cti'|'sti'), `conflictColumns`, `indexes` (declared multi-column indexes; see [schema-paths.md](schema-paths.md)), `api`/`mcp`/`cli` (generation config), `ai` (callable methods), `hooks` (beforeSave/afterSave/beforeDelete/afterDelete), `embeddings` (auto-generate), `tenantScoped`, `agent`, `ui` (`{ icon, label, description }` — nav/help hints round-tripped through the manifest as plain data; `description` is the object-level seed for form-level help, #2046).\n\nRegistration sets `SMRT_TABLE_NAME` static property (survives minification).\n\nAn explicit `@smrt({ collection: 'domain.records' })` names the route/permission\nnamespace independently of `tableName`, including standalone non-STI models.\nScanner output preserves it in both `collection` and `decoratorConfig.collection`.\nGenerated registration reads the merged declaration, so older manifests with a\nderived top-level collection still agree with native decorators. Explicit runtime\nregistration options win; absent declarations retain manifest/STI/default naming.\n\n## @field() UI hints (#2046)\n\n`@field({ ui: { basic, group, order, locked } })` — a static, presentation-only\nseed for the field-policy rail (epic #2045). Carried in the manifest under the\nfield's `_meta.ui` (never a top-level `FieldDefinition` key), readable at\nruntime via `getAllFields()` at `field._meta.ui`, and emitted (sanitized) with\n`description` into generated web-collection definitions and browser MCP tool\nschemas. No schema/persistence/security effect — `sensitive`/`readPermission`\nstay the security rail, and `sensitive`/`transient` fields never emit to the\nclient at all.\n\n`ui.widget` (#3599) adds a presentation widget hint:\n`'textarea' | 'currency' | 'email' | 'url' | 'phone'`. It rides the same\n`_meta.ui` channel and is also emitted (sanitized) into web-collection\ndefinitions. The manifest generator validates it against the field type and\nfails the build otherwise: every widget needs a `text` field (`currency` is a\ncurrency-CODE picker for an ISO 4217 string such as `currency = 'USD'`, not a\nmoney amount; amounts are integer minor units and take no widget); an unknown\nvalue or a non-text field is an error. `ui.widget` is a hint only — it never changes\nthe column type or validation.\n\n## Presentation metadata (#3599)\n\nPure helpers live in `src/ui-metadata.ts`, published browser-safe as\n`@happyvertical/smrt-core/ui-metadata` (also re-exported from the package\nroot). `ManifestGenerator.applyUiMetadata()` runs in `applyGenerationPasses`\nafter inheritance, so every producer (Vite plugin, `ManifestBuilder`,\n`generateManifest`) validates the same way.\n\n- **Display label.** `@smrt({ display: { label: '<field>' } })` names the own\n  field generic pickers and assistants use to label a record. Own fields only —\n  no paths into other packages; a model whose label lives elsewhere ships a\n  selector. Undeclared, it defaults to the first of `name`, `title`, `label`,\n  `code` that is a usable own field. Build fails when the declared field is\n  missing, `sensitive`, `transient`, or a relationship/json field. The resolved\n  field is emitted as `displayLabelField` on the manifest object and in the\n  knowledge artifact, and generated MCP/WebMCP `list`/`get`/`update`/`delete`\n  descriptions end with ``Records are identified by their `<field>` field.``\n  (`describeAction` in `generators/tool-schema.ts`; nothing is added when the\n  model has no label field).\n- **Selector slots.** `ModuleUISlot.selects: '@scope/pkg:Model'`\n  (`@happyvertical/smrt-types`) marks a package component as THE selector for a\n  model. The scanner reads such slots statically from `src/**/ui.ts`\n  (`parseUiSelectorsFile`, independent of the class glob) and the manifest\n  carries them as `uiSelectors` keyed by slot id. `selects` must be a string\n  literal; a duplicate slot id, two selectors for one model, or an own-package\n  target that does not exist fails the build. Hosts call\n  `findSelectorFor(manifests, qualifiedName)`; generic forms use the selector\n  for any `@foreignKey`/`@crossPackageRef` field targeting that model and fall\n  back to a generic picker labelled by `displayLabelField`. `display` is read\n  per class: an STI subclass that declares none uses the default lookup rather\n  than its base's declaration, and a CTI child cannot name a parent's field.\n\n## Worker registration artifact (#3117)\n\nWith `svelteKit.enabled`, a production `vite build` compiles the generated\n`smrt-register.ts` into `.smrt/runtime/register.js` after the server build\n(`src/vite-plugin/worker-registration.ts`, called once from `closeBundle`).\nadapter-node re-bundles the server from its own entries, so the web bundle is\nnever importable by a separate Node process; this artifact is how a deployed\ntask/schedule worker registers the app's local objects (and, through the\n`.smrt/register.js` it imports, consumed packages' objects) with the same\nqualified identities and isolated manifests as the web server. It is a nested\nSSR build with no consumer plugins: only aliases pointing into the project\nsources (e.g. `$lib`) apply, and every other bare import stays external so the\nworker shares the installed `@happyvertical/smrt-core` registry. SvelteKit\nvirtual modules (`$env/*`, `$app/*`) are not available to a worker; an object\nimporting one fails at worker startup. A failure fails the build.\n\n## Lightweight discovery\n\nFilesystem-only discovery, module-doc parsing, and graph freshness are owned by\n`@happyvertical/smrt-scanner/knowledge`. Core's knowledge exports remain compatible\nreexports. Runtime manifest projection and custom-action semantics stay in core.\n\n`src/knowledge-discovery.ts`, exported through `smrt-core/knowledge`, enumerates\ninstalled scope directories and reads canonical AGENTS/legacy CLAUDE docs without\nloading package code, artifacts, or scanning objects. CLI snapshots and MCP share\nthese primitives. Callers retain selection policy: snapshots resolve links and\nfall back to `packages/*` only when no installed SMRT package loads; MCP preserves\nnode_modules paths, deduplicates realpaths, excludes authored workspace links,\nand then enriches the selected packages. Workspace-root/glob discovery remains\nowned by each consumer.\n\n## Domain Knowledge Artifacts\n\n`smrtPlugin()` writes runtime manifests and agent/developer knowledge artifacts:\n\n- local dev/build: `.smrt/manifest.json` and `.smrt/smrt-knowledge.json`\n- package build: `dist/manifest.json` and `dist/smrt-knowledge.json`\n\nKeep `manifest.json` runtime-focused. `smrt-knowledge.json` is the deterministic\nagent contract for downstream review and architecture tools.\n\nThe CLI's schema-command gate reads that same merged file: a pure-consumer\nproject (0 local objects) qualifies on the consumed packages its manifest\nrecords, so a clobbered `objects` map is what made `smrt db:migrate` report\n`missing_local_manifest` (#2925).\n\n`.smrt/manifest.json` has two writers and neither owns all of it: `smrtPlugin()`\ncontributes the project's scanned objects and `smrtConsumer()` the consumed\npackages' entries. Both writes are merge-preserving, keyed on each entry's\nrecorded `packageName` — a plain overwrite in either direction silently drops\nthe other's objects, and the last pass of a multi-environment build is not\nreliably the aggregating one (#1760, #2925). `dist/manifest.json` stays\nlocal-only: a published package must not carry its dependencies' objects.\n\nThe schema-version-1 object projection is additive and high-signal: it retains\nnormalized tenant mode/field, explicit `cti`/`sti` strategy, conflict columns,\nmethod signatures, and field defaults/constraints/readonly/transient flags.\nSensitive fields are removed before both `fields` and `relationships` are\nderived, including legacy flags stored under `_meta`; matching field and\nsnake-case column names are also removed from projected conflict columns, and a\nsensitive custom tenant field is omitted while retaining scope and mode.\nGenerated artifacts assert this boundary with `sensitiveFieldsExcluded: true`;\nthe optional marker keeps schema version 1 additive while letting readers\nidentify older artifacts that require raw-manifest corroboration.\n\nConfig precedence for knowledge is defaults → top-level `knowledge` in\n`smrt.config.ts` → `packages[packageName].knowledge` → plugin option →\nobject-level `@smrt({ knowledge })`.\n\nTest generation uses that same effective configuration and publishes knowledge\nmatching the manifest it generated. Disabling knowledge removes a previous local\nknowledge artifact, so consumers cannot mistake it for current enabled output.\n`new ManifestBuilder(projectRoot)` keeps discovery, package identity, and output\nat that explicit root, including installed providers and external base classes;\nomitting the argument retains the current-working-directory\nbehavior. Both manifest writers retain declared package dependencies when merging\ntheir local and consumed-object projections.\n\nTest manifests carry optional `artifactPurpose: 'test'`; dependency discovery\nskips those artifacts, including `.smrt` fallbacks. Unmarked runtime manifests,\nempty published providers, and source-only development providers remain eligible.\n`ManifestBuilder` accepts explicit `outputMode: 'dev' | 'build'`; omitted mode\nretains legacy filename inference. Vitest selects dev mode explicitly, so tests\nnever replace a production `dist/manifest.json`. Relative output directories are\nresolved against the builder's project root.\n\nWith `svelteKit.enabled`, `smrtPlugin()`'s transform prepends\n`import './smrt-register.js';` to the configured config module\n(`<configPath>/<configFileName>`, `src/vite-plugin/sveltekit-register-injection.ts`)\nonce the register module exists, on the same first line so line numbers hold.\nApps therefore never hand-write the guarded registration import (#3416); a\nconfig module that still has it imports the same module twice, harmlessly.\n\nTracked `src/lib/server/smrt-register.ts` belongs to SvelteKit config/type\ngeneration. Generic library builds consume it but do not cache or restore it\nas an output; otherwise a concurrent config producer's bytes can be replayed\nover a newer registration after dependency eligibility changes.\n\nObject-level `knowledge: false` excludes an object from authored context only;\nit must not change runtime manifest registration. Use\n`knowledge: { tags, summary, risks }` for review-sensitive domain objects.\n\nHTTP knowledge routes are disabled by default. If `knowledge.api.enabled` is\ntrue, generated SvelteKit routes must stay GET-only and guarded by dev mode or\nadmin auth.\n\n\n## Vite Plugin\n\n`src/vite-preset/` (`@happyvertical/smrt-core/vite`, `smrt()`) composes the Oxc\ndecorator block, `smrtConsumer`, then `smrtPlugin` with the template path\nconventions. Its package list comes only from the `smrt({ packages })` option, or\n`smrt.config` `consumer.packages` (smrt-config schema); it never sniffs\n`package.json`, and a missing or malformed list throws. Keep its output\nbyte-identical to the two-plugin form (`src/vite-preset/index.test.ts`). It\nalso dedupes `@sveltejs/kit` (`smrt:shared-runtime`): SvelteKit matches\n`redirect()`/`fail()` by class, and a linked/workspace SMRT SvelteKit entry\nwould otherwise import its own copy and turn redirects into 500s.\n\n**Package models over REST (#3749).** `consumer.packages` registers a package's\nmodels and gives `@smrt/web` (the consumer's `collectionDefinitions`, one per\nlist-capable model, endpoint `/<collection>`) their definitions, but a package\nmodel gets generated REST routes only when it is on the consumer's hosting\nallowlist (`smrtConsumer({ svelteKit: { objects } })`, #2850: an HTTP exposure\nboundary, each model's own `api` config still applies, so `api: false` and\nempty-include models stay closed, tenancy comes with the generated route). The\npreset fills that allowlist: with `smrt.cookbook.json` present it is the models\nof the cookbook's recipes plus `features`, minus models the cookbook `exposure`\nturns off for `api` or a recipe's `options[model].exposure.api === false`\n(`vite-preset/cookbook-exposure.ts`; recipe `{ exclude }` narrowing is not\napplied by the build yet). `smrt({ expose })` replaces the derived list. No\ncookbook and no `expose` keeps `svelteKit: true` (nothing hosted). The producer's\n`@happyvertical/smrt-virt-web` still covers only the app's own models; read\npackage models from `@smrt/web`. `smrt({ objectsDir })` is passed to the hosting\ncontribution too: the producer and consumer share one `routesDir`, and the\ngenerator refuses it when their settings differ.\n\n**STI siblings (#3749).** Package STI subclasses share their base's table, and\nthe manifest gives them the base's `collection` unless they declare one\n(`consumer-plugin/hosted-sti-collections.ts`). Two hosted siblings would both\nclaim `/<base collection>`, so each hosted subclass that inherits its\ncollection gets its class-derived one (`Order` -> `orders`,\n`defaultCollectionName` in the scanner), in every manifest view the consumer\nderives: routes, `@smrt/web`, the generated client and registration. This is the\nconvention the framework already has for an independent route collection\n(`@smrt({ collection })`), applied by default for hosted subclasses; an explicit\ncollection wins. The route therefore reads through the subclass's own\ncollection (rows scoped to its `_meta_type`) and the definition for that model\nadvertises that route (`objectRef` = the model, `endpoint` = `/orders`). A hosted\nbase keeps the shared name and the base-collection semantics (every row of the\ntable, any subtype). A subclass left off the allowlist keeps the shared\ncollection and folds into the base's definition, as before. A collection class\nthat inherits another's item type (`MaterialCollection extends\nProductCollection`) resolves to the same item and collection, so only one of\nthem is hosted (the class named for the item, else the first). Subclasses that\ndeclare no `api` config get the omitted-config default (full CRUD), not the\nbase's `include`; narrow them on the subclass if the base is meant to restrict\nthem.\n\n```typescript\n// vite.config.ts — required for @smrt() decorators (Vite 8+, oxc transform)\nexport default defineConfig({\n  oxc: {\n    decorator: {\n      legacy: true,\n      emitDecoratorMetadata: true,\n    },\n  },\n});\n```\n\nUnder Vite 8 the oxc transform does not honor the pre-Vite-8 `esbuild.tsconfigRaw`\nrecipe (or tsconfig `experimentalDecorators` reached through SvelteKit's\n`extends \"./.svelte-kit/tsconfig.json\"` chain), so that recipe throws\n`SyntaxError: Invalid or unexpected token` on the first SSR request. Configure\ndecorators through `oxc.decorator` instead. Consumers still pinned on vite<8 need\nthe legacy `esbuild.tsconfigRaw` form with `experimentalDecorators: true,\nemitDecoratorMetadata: true`.\n\nFor independent CI invocations, both `smrtPlugin()` and `smrtConsumer()` accept\nthe same `generationSnapshot: { path, sha256, provenance, sourceRoot }`. The\nschema-v1 snapshot produced by `serializeSmrtGenerationSnapshot()` contains the\nmerged project/dependency manifest, portable source paths, and source-file\ndigests; each plugin selects its own view. Reuse mode fails closed on\nbyte/provenance/path/content drift, skips scans and manifest writes, and still\ngenerates routes, types, registration, and virtual modules. Omit it for normal\nlocal development and watch mode.\n\n## Clean consumer type checks (TypeScript 6)\n\nThe consumer config hook writes `.smrt/register.js` alongside generated types\nafter route preflight succeeds. Generated SvelteKit registration imports that\nmodule, so it must exist during `svelte-kit sync`, before Vite's `buildStart`.\nBoth hosted routes and the legacy `svelteKit: true` mode follow this order.\nThe clean-consumer regression fixture ships real provider declarations and\nchecks the generated imports with `svelte-check`.\nCore's `generate:test` task depends on its own `build`: both publish the local\n`.smrt` manifest/knowledge pair, so Turbo must serialize production before test\ngeneration instead of caching an interleaved pair.\n\n## Model descriptions\n\nEach manifest object and knowledge `objects[]` entry may carry a user-facing\n`description` (for the planner Features tab and similar). The scanner\n(`extractClassJsDocDescription` in `packages/scanner/src/oxc-parser.ts`) reads it\nfrom the parsed source, in priority order: explicit `@smrt({ description })`,\nelse the first paragraph of the class JSDoc (the JSDoc may sit above `export`\nand decorators), minus a leading `ClassName - ` / `ClassName: `, tags\n(`{@link}`, backticks, HTML) and later paragraphs, capped at 200 chars on a\nsentence boundary. `@internal` classes and classes without docs emit no key. It\nis not inherited from a parent class. Generated MCP tool descriptions are\nunchanged (they stay generic).\n"
+      "content": "# Decorators, build integration, and knowledge\n\nKey options: `tableName`, `tableStrategy` ('cti'|'sti'), `conflictColumns`, `indexes` (declared multi-column indexes; see [schema-paths.md](schema-paths.md)), `api`/`mcp`/`cli` (generation config), `ai` (callable methods), `hooks` (beforeSave/afterSave/beforeDelete/afterDelete), `embeddings` (auto-generate), `tenantScoped`, `agent`, `ui` (`{ icon, label, description }` — nav/help hints round-tripped through the manifest as plain data; `description` is the object-level seed for form-level help, #2046).\n\nRegistration sets `SMRT_TABLE_NAME` static property (survives minification).\n\nAn explicit `@smrt({ collection: 'domain.records' })` names the route/permission\nnamespace independently of `tableName`, including standalone non-STI models.\nScanner output preserves it in both `collection` and `decoratorConfig.collection`.\nGenerated registration reads the merged declaration, so older manifests with a\nderived top-level collection still agree with native decorators. Explicit runtime\nregistration options win; absent declarations retain manifest/STI/default naming.\n\n## @field() UI hints (#2046)\n\n`@field({ ui: { basic, group, order, locked } })` — a static, presentation-only\nseed for the field-policy rail (epic #2045). Carried in the manifest under the\nfield's `_meta.ui` (never a top-level `FieldDefinition` key), readable at\nruntime via `getAllFields()` at `field._meta.ui`, and emitted (sanitized) with\n`description` into generated web-collection definitions and browser MCP tool\nschemas. No schema/persistence/security effect — `sensitive`/`readPermission`\nstay the security rail, and `sensitive`/`transient` fields never emit to the\nclient at all.\n\n`ui.widget` (#3599) adds a presentation widget hint:\n`'textarea' | 'currency' | 'email' | 'url' | 'phone'`. It rides the same\n`_meta.ui` channel and is also emitted (sanitized) into web-collection\ndefinitions. The manifest generator validates it against the field type and\nfails the build otherwise: every widget needs a `text` field (`currency` is a\ncurrency-CODE picker for an ISO 4217 string such as `currency = 'USD'`, not a\nmoney amount; amounts are integer minor units and take no widget); an unknown\nvalue or a non-text field is an error. `ui.widget` is a hint only — it never changes\nthe column type or validation.\n\n`ui.format` (#3718) says how a value is presented: `money` (an `integer` of\nminor units — the amount hint record pages format and total), `date` (a\nbusiness date on a `datetime`, shown without a time), `datetime`, `percent`\n(a rate on a `decimal`/`integer`). Same channel, same emission, same build-time\ncheck against the field type. `@foreignKey(Target, { role: 'items' })` (or on\n`@crossPackageRef`) marks the declaring model as the target's line items; the\nscanner keeps it at `_meta.role`, the build rejects it on a non-reference or\nan unknown value, and the generated web relationship edge carries\n`role: 'items'` (edges without a role stay byte-stable). Both are hints: no\nschema, persistence or security effect.\n\n## Presentation metadata (#3599)\n\nPure helpers live in `src/ui-metadata.ts`, published browser-safe as\n`@happyvertical/smrt-core/ui-metadata` (also re-exported from the package\nroot). `ManifestGenerator.applyUiMetadata()` runs in `applyGenerationPasses`\nafter inheritance, so every producer (Vite plugin, `ManifestBuilder`,\n`generateManifest`) validates the same way.\n\n- **Display label.** `@smrt({ display: { label: '<field>' } })` names the own\n  field generic pickers and assistants use to label a record. Own fields only —\n  no paths into other packages; a model whose label lives elsewhere ships a\n  selector. Undeclared, it defaults to the first of `name`, `title`, `label`,\n  `code` that is a usable own field. Build fails when the declared field is\n  missing, `sensitive`, `transient`, or a relationship/json field. The resolved\n  field is emitted as `displayLabelField` on the manifest object and in the\n  knowledge artifact, and generated MCP/WebMCP `list`/`get`/`update`/`delete`\n  descriptions end with ``Records are identified by their `<field>` field.``\n  (`describeAction` in `generators/tool-schema.ts`; nothing is added when the\n  model has no label field).\n- **Selector slots.** `ModuleUISlot.selects: '@scope/pkg:Model'`\n  (`@happyvertical/smrt-types`) marks a package component as THE selector for a\n  model. The scanner reads such slots statically from `src/**/ui.ts`\n  (`parseUiSelectorsFile`, independent of the class glob) and the manifest\n  carries them as `uiSelectors` keyed by slot id. `selects` must be a string\n  literal; a duplicate slot id, two selectors for one model, or an own-package\n  target that does not exist fails the build. Hosts call\n  `findSelectorFor(manifests, qualifiedName)`; generic forms use the selector\n  for any `@foreignKey`/`@crossPackageRef` field targeting that model and fall\n  back to a generic picker labelled by `displayLabelField`. `display` is read\n  per class: an STI subclass that declares none uses the default lookup rather\n  than its base's declaration, and a CTI child cannot name a parent's field.\n\n## Worker registration artifact (#3117)\n\nWith `svelteKit.enabled`, a production `vite build` compiles the generated\n`smrt-register.ts` into `.smrt/runtime/register.js` after the server build\n(`src/vite-plugin/worker-registration.ts`, called once from `closeBundle`).\nadapter-node re-bundles the server from its own entries, so the web bundle is\nnever importable by a separate Node process; this artifact is how a deployed\ntask/schedule worker registers the app's local objects (and, through the\n`.smrt/register.js` it imports, consumed packages' objects) with the same\nqualified identities and isolated manifests as the web server. It is a nested\nSSR build with no consumer plugins: only aliases pointing into the project\nsources (e.g. `$lib`) apply, and every other bare import stays external so the\nworker shares the installed `@happyvertical/smrt-core` registry. SvelteKit\nvirtual modules (`$env/*`, `$app/*`) are not available to a worker; an object\nimporting one fails at worker startup. A failure fails the build.\n\n## Lightweight discovery\n\nFilesystem-only discovery, module-doc parsing, and graph freshness are owned by\n`@happyvertical/smrt-scanner/knowledge`. Core's knowledge exports remain compatible\nreexports. Runtime manifest projection and custom-action semantics stay in core.\n\n`src/knowledge-discovery.ts`, exported through `smrt-core/knowledge`, enumerates\ninstalled scope directories and reads canonical AGENTS/legacy CLAUDE docs without\nloading package code, artifacts, or scanning objects. CLI snapshots and MCP share\nthese primitives. Callers retain selection policy: snapshots resolve links and\nfall back to `packages/*` only when no installed SMRT package loads; MCP preserves\nnode_modules paths, deduplicates realpaths, excludes authored workspace links,\nand then enriches the selected packages. Workspace-root/glob discovery remains\nowned by each consumer.\n\n## Domain Knowledge Artifacts\n\n`smrtPlugin()` writes runtime manifests and agent/developer knowledge artifacts:\n\n- local dev/build: `.smrt/manifest.json` and `.smrt/smrt-knowledge.json`\n- package build: `dist/manifest.json` and `dist/smrt-knowledge.json`\n\nKeep `manifest.json` runtime-focused. `smrt-knowledge.json` is the deterministic\nagent contract for downstream review and architecture tools.\n\nThe CLI's schema-command gate reads that same merged file: a pure-consumer\nproject (0 local objects) qualifies on the consumed packages its manifest\nrecords, so a clobbered `objects` map is what made `smrt db:migrate` report\n`missing_local_manifest` (#2925).\n\n`.smrt/manifest.json` has two writers and neither owns all of it: `smrtPlugin()`\ncontributes the project's scanned objects and `smrtConsumer()` the consumed\npackages' entries. Both writes are merge-preserving, keyed on each entry's\nrecorded `packageName` — a plain overwrite in either direction silently drops\nthe other's objects, and the last pass of a multi-environment build is not\nreliably the aggregating one (#1760, #2925). `dist/manifest.json` stays\nlocal-only: a published package must not carry its dependencies' objects.\n\nThe schema-version-1 object projection is additive and high-signal: it retains\nnormalized tenant mode/field, explicit `cti`/`sti` strategy, conflict columns,\nmethod signatures, and field defaults/constraints/readonly/transient flags.\nSensitive fields are removed before both `fields` and `relationships` are\nderived, including legacy flags stored under `_meta`; matching field and\nsnake-case column names are also removed from projected conflict columns, and a\nsensitive custom tenant field is omitted while retaining scope and mode.\nGenerated artifacts assert this boundary with `sensitiveFieldsExcluded: true`;\nthe optional marker keeps schema version 1 additive while letting readers\nidentify older artifacts that require raw-manifest corroboration.\n\nConfig precedence for knowledge is defaults → top-level `knowledge` in\n`smrt.config.ts` → `packages[packageName].knowledge` → plugin option →\nobject-level `@smrt({ knowledge })`.\n\nTest generation uses that same effective configuration and publishes knowledge\nmatching the manifest it generated. Disabling knowledge removes a previous local\nknowledge artifact, so consumers cannot mistake it for current enabled output.\n`new ManifestBuilder(projectRoot)` keeps discovery, package identity, and output\nat that explicit root, including installed providers and external base classes;\nomitting the argument retains the current-working-directory\nbehavior. Both manifest writers retain declared package dependencies when merging\ntheir local and consumed-object projections.\n\nTest manifests carry optional `artifactPurpose: 'test'`; dependency discovery\nskips those artifacts, including `.smrt` fallbacks. Unmarked runtime manifests,\nempty published providers, and source-only development providers remain eligible.\n`ManifestBuilder` accepts explicit `outputMode: 'dev' | 'build'`; omitted mode\nretains legacy filename inference. Vitest selects dev mode explicitly, so tests\nnever replace a production `dist/manifest.json`. Relative output directories are\nresolved against the builder's project root.\n\nWith `svelteKit.enabled`, `smrtPlugin()`'s transform prepends\n`import './smrt-register.js';` to the configured config module\n(`<configPath>/<configFileName>`, `src/vite-plugin/sveltekit-register-injection.ts`)\nonce the register module exists, on the same first line so line numbers hold.\nApps therefore never hand-write the guarded registration import (#3416); a\nconfig module that still has it imports the same module twice, harmlessly.\n\nTracked `src/lib/server/smrt-register.ts` belongs to SvelteKit config/type\ngeneration. Generic library builds consume it but do not cache or restore it\nas an output; otherwise a concurrent config producer's bytes can be replayed\nover a newer registration after dependency eligibility changes.\n\nObject-level `knowledge: false` excludes an object from authored context only;\nit must not change runtime manifest registration. Use\n`knowledge: { tags, summary, risks }` for review-sensitive domain objects.\n\nHTTP knowledge routes are disabled by default. If `knowledge.api.enabled` is\ntrue, generated SvelteKit routes must stay GET-only and guarded by dev mode or\nadmin auth.\n\n\n## Vite Plugin\n\n`src/vite-preset/` (`@happyvertical/smrt-core/vite`, `smrt()`) composes the Oxc\ndecorator block, `smrtConsumer`, then `smrtPlugin` with the template path\nconventions. Its package list comes only from the `smrt({ packages })` option, or\n`smrt.config` `consumer.packages` (smrt-config schema); it never sniffs\n`package.json`, and a missing or malformed list throws. Keep its output\nbyte-identical to the two-plugin form (`src/vite-preset/index.test.ts`). It\nalso dedupes `@sveltejs/kit` (`smrt:shared-runtime`): SvelteKit matches\n`redirect()`/`fail()` by class, and a linked/workspace SMRT SvelteKit entry\nwould otherwise import its own copy and turn redirects into 500s.\n\n**Package models over REST (#3749).** `consumer.packages` registers a package's\nmodels and gives `@smrt/web` (the consumer's `collectionDefinitions`, one per\nlist-capable model, endpoint `/<collection>`) their definitions, but a package\nmodel gets generated REST routes only when it is on the consumer's hosting\nallowlist (`smrtConsumer({ svelteKit: { objects } })`, #2850: an HTTP exposure\nboundary, each model's own `api` config still applies, so `api: false` and\nempty-include models stay closed, tenancy comes with the generated route). The\npreset fills that allowlist: with `smrt.cookbook.json` present it is the models\nof the cookbook's recipes plus `features`, minus models the cookbook `exposure`\nturns off for `api` or a recipe's `options[model].exposure.api === false`\n(`vite-preset/cookbook-exposure.ts`; recipe `{ exclude }` narrowing is not\napplied by the build yet). `smrt({ expose })` replaces the derived list. No\ncookbook and no `expose` keeps `svelteKit: true` (nothing hosted). The producer's\n`@happyvertical/smrt-virt-web` still covers only the app's own models; read\npackage models from `@smrt/web`. `smrt({ objectsDir })` is passed to the hosting\ncontribution too: the producer and consumer share one `routesDir`, and the\ngenerator refuses it when their settings differ.\n\n**STI siblings (#3749).** Package STI subclasses share their base's table, and\nthe manifest gives them the base's `collection` unless they declare one\n(`consumer-plugin/hosted-sti-collections.ts`). Two hosted siblings would both\nclaim `/<base collection>`, so each hosted subclass that inherits its\ncollection gets its class-derived one (`Order` -> `orders`,\n`defaultCollectionName` in the scanner), in every manifest view the consumer\nderives: routes, `@smrt/web`, the generated client and registration. This is the\nconvention the framework already has for an independent route collection\n(`@smrt({ collection })`), applied by default for hosted subclasses; an explicit\ncollection wins. The route therefore reads through the subclass's own\ncollection (rows scoped to its `_meta_type`) and the definition for that model\nadvertises that route (`objectRef` = the model, `endpoint` = `/orders`). A hosted\nbase keeps the shared name and the base-collection semantics (every row of the\ntable, any subtype). A subclass left off the allowlist keeps the shared\ncollection and folds into the base's definition, as before. A collection class\nthat inherits another's item type (`MaterialCollection extends\nProductCollection`) resolves to the same item and collection, so only one of\nthem is hosted (the class named for the item, else the first). Subclasses that\ndeclare no `api` config get the omitted-config default (full CRUD), not the\nbase's `include`; narrow them on the subclass if the base is meant to restrict\nthem.\n\n```typescript\n// vite.config.ts — required for @smrt() decorators (Vite 8+, oxc transform)\nexport default defineConfig({\n  oxc: {\n    decorator: {\n      legacy: true,\n      emitDecoratorMetadata: true,\n    },\n  },\n});\n```\n\nUnder Vite 8 the oxc transform does not honor the pre-Vite-8 `esbuild.tsconfigRaw`\nrecipe (or tsconfig `experimentalDecorators` reached through SvelteKit's\n`extends \"./.svelte-kit/tsconfig.json\"` chain), so that recipe throws\n`SyntaxError: Invalid or unexpected token` on the first SSR request. Configure\ndecorators through `oxc.decorator` instead. Consumers still pinned on vite<8 need\nthe legacy `esbuild.tsconfigRaw` form with `experimentalDecorators: true,\nemitDecoratorMetadata: true`.\n\nFor independent CI invocations, both `smrtPlugin()` and `smrtConsumer()` accept\nthe same `generationSnapshot: { path, sha256, provenance, sourceRoot }`. The\nschema-v1 snapshot produced by `serializeSmrtGenerationSnapshot()` contains the\nmerged project/dependency manifest, portable source paths, and source-file\ndigests; each plugin selects its own view. Reuse mode fails closed on\nbyte/provenance/path/content drift, skips scans and manifest writes, and still\ngenerates routes, types, registration, and virtual modules. Omit it for normal\nlocal development and watch mode.\n\n## Clean consumer type checks (TypeScript 6)\n\nThe consumer config hook writes `.smrt/register.js` alongside generated types\nafter route preflight succeeds. Generated SvelteKit registration imports that\nmodule, so it must exist during `svelte-kit sync`, before Vite's `buildStart`.\nBoth hosted routes and the legacy `svelteKit: true` mode follow this order.\nThe clean-consumer regression fixture ships real provider declarations and\nchecks the generated imports with `svelte-check`.\nCore's `generate:test` task depends on its own `build`: both publish the local\n`.smrt` manifest/knowledge pair, so Turbo must serialize production before test\ngeneration instead of caching an interleaved pair.\n\n## Model descriptions\n\nEach manifest object and knowledge `objects[]` entry may carry a user-facing\n`description` (for the planner Features tab and similar). The scanner\n(`extractClassJsDocDescription` in `packages/scanner/src/oxc-parser.ts`) reads it\nfrom the parsed source, in priority order: explicit `@smrt({ description })`,\nelse the first paragraph of the class JSDoc (the JSDoc may sit above `export`\nand decorators), minus a leading `ClassName - ` / `ClassName: `, tags\n(`{@link}`, backticks, HTML) and later paragraphs, capped at 200 chars on a\nsentence boundary. `@internal` classes and classes without docs emit no key. It\nis not inherited from a parent class. Generated MCP tool descriptions are\nunchanged (they stay generic).\n"
     },
     {
       "path": "agents/memory.md",

package/dist/ui-metadata.d.ts

@@ -14,6 +14,19 @@ export type FieldUIWidget = (typeof FIELD_UI_WIDGETS)[number];
 /** Manifest field types each widget may be applied to. */
 export declare const FIELD_UI_WIDGET_TYPES: Readonly<Record<FieldUIWidget, readonly string[]>>;
 export declare function isFieldUIWidget(value: unknown): value is FieldUIWidget;
+/** Presentation formats a field may declare via `@field({ ui: { format } })`. */
+export declare const FIELD_UI_FORMATS: readonly ["money", "date", "datetime", "percent"];
+export type FieldUIFormat = (typeof FIELD_UI_FORMATS)[number];
+/**
+ * Manifest field types each format may be applied to. Money is integer
+ * minor units only (rates and confidences are the only decimals).
+ */
+export declare const FIELD_UI_FORMAT_TYPES: Readonly<Record<FieldUIFormat, readonly string[]>>;
+export declare function isFieldUIFormat(value: unknown): value is FieldUIFormat;
+/** Relationship roles a `foreignKey` / `crossPackageRef` may declare. */
+export declare const RELATIONSHIP_ROLES: readonly ["items"];
+export type RelationshipRole = (typeof RELATIONSHIP_ROLES)[number];
+export declare function isRelationshipRole(value: unknown): value is RelationshipRole;
 /**
  * Fields tried, in order, when a model declares no
  * `@smrt({ display: { label } })`.

package/dist/ui-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-metadata.d.ts","sourceRoot":"","sources":["../src/ui-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,4DAMnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC,CASzC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKtE;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,6CAK/B,CAAC;AAYX,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACtC,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAaf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CASpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EACjD,aAAa,EAAE,kBAAkB,GAAG,MAAM,GACzC,kBAAkB,GAAG,SAAS,CAUhC"}
+{"version":3,"file":"ui-metadata.d.ts","sourceRoot":"","sources":["../src/ui-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,4DAMnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC,CASzC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKtE;AAED,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,mDAKnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC,CAMzC,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAKtE;AAED,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,oBAAqB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAK5E;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,6CAK/B,CAAC;AAYX,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACtC,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAaf;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CASpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI3E;AAED,KAAK,YAAY,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,EACjD,aAAa,EAAE,kBAAkB,GAAG,MAAM,GACzC,kBAAkB,GAAG,SAAS,CAUhC"}

package/dist/ui-metadata.js

@@ -18,6 +18,31 @@ var FIELD_UI_WIDGET_TYPES = {
 function isFieldUIWidget(value) {
 	return typeof value === "string" && FIELD_UI_WIDGETS.includes(value);
 }
+/** Presentation formats a field may declare via `@field({ ui: { format } })`. */
+var FIELD_UI_FORMATS = [
+	"money",
+	"date",
+	"datetime",
+	"percent"
+];
+/**
+* Manifest field types each format may be applied to. Money is integer
+* minor units only (rates and confidences are the only decimals).
+*/
+var FIELD_UI_FORMAT_TYPES = {
+	money: ["integer"],
+	date: ["datetime"],
+	datetime: ["datetime"],
+	percent: ["decimal", "integer"]
+};
+function isFieldUIFormat(value) {
+	return typeof value === "string" && FIELD_UI_FORMATS.includes(value);
+}
+/** Relationship roles a `foreignKey` / `crossPackageRef` may declare. */
+var RELATIONSHIP_ROLES = ["items"];
+function isRelationshipRole(value) {
+	return typeof value === "string" && RELATIONSHIP_ROLES.includes(value);
+}
 /**
 * Fields tried, in order, when a model declares no
 * `@smrt({ display: { label } })`.
@@ -80,6 +105,6 @@ function findSelectorFor(manifests, qualifiedName) {
 	for (const manifest of list) for (const selector of Object.values(manifest.uiSelectors ?? {})) if (selector.selects === qualifiedName) return selector;
 }
 //#endregion
-export { DEFAULT_DISPLAY_LABEL_FIELDS, FIELD_UI_WIDGETS, FIELD_UI_WIDGET_TYPES, describeDisplayLabel, displayLabelFieldProblem, findSelectorFor, isFieldUIWidget, resolveDisplayLabelField };
+export { DEFAULT_DISPLAY_LABEL_FIELDS, FIELD_UI_FORMATS, FIELD_UI_FORMAT_TYPES, FIELD_UI_WIDGETS, FIELD_UI_WIDGET_TYPES, RELATIONSHIP_ROLES, describeDisplayLabel, displayLabelFieldProblem, findSelectorFor, isFieldUIFormat, isFieldUIWidget, isRelationshipRole, resolveDisplayLabelField };
 
 //# sourceMappingURL=ui-metadata.js.map

package/dist/ui-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-metadata.js","names":[],"sources":["../src/ui-metadata.ts"],"sourcesContent":["/**\n * Presentation metadata helpers (#3599): `@field({ ui: { widget } })` hints,\n * the own-field display label, and selector-slot lookup.\n *\n * Pure and dependency-free so it is safe in browser bundles\n * (`@happyvertical/smrt-core/ui-metadata`). The manifest generator, the MCP /\n * WebMCP tool descriptors, the knowledge projection and host UIs all read the\n * same rules from here.\n */\n\nimport type {\n  ManifestUISelector,\n  QualifiedClassName,\n  SmartObjectManifest,\n} from './scanner/types.js';\n\n/** Widget hints a field may declare via `@field({ ui: { widget } })`. */\nexport const FIELD_UI_WIDGETS = [\n  'textarea',\n  'currency',\n  'email',\n  'url',\n  'phone',\n] as const;\n\nexport type FieldUIWidget = (typeof FIELD_UI_WIDGETS)[number];\n\n/** Manifest field types each widget may be applied to. */\nexport const FIELD_UI_WIDGET_TYPES: Readonly<\n  Record<FieldUIWidget, readonly string[]>\n> = {\n  textarea: ['text'],\n  email: ['text'],\n  url: ['text'],\n  phone: ['text'],\n  // A currency CODE (ISO 4217, e.g. `currency: string = 'USD'`) picker, not an\n  // amount: amounts are integer minor units and need no widget hint.\n  currency: ['text'],\n};\n\nexport function isFieldUIWidget(value: unknown): value is FieldUIWidget {\n  return (\n    typeof value === 'string' &&\n    (FIELD_UI_WIDGETS as readonly string[]).includes(value)\n  );\n}\n\n/**\n * Fields tried, in order, when a model declares no\n * `@smrt({ display: { label } })`.\n */\nexport const DEFAULT_DISPLAY_LABEL_FIELDS = [\n  'name',\n  'title',\n  'label',\n  'code',\n] as const;\n\n/** Field kinds that can never be a record's label (they are not its own value). */\nconst NON_LABEL_FIELD_TYPES = new Set([\n  'foreignKey',\n  'crossPackageRef',\n  'oneToMany',\n  'manyToMany',\n  'json',\n  'meta',\n]);\n\ninterface LabelCandidate {\n  type?: string;\n  sensitive?: boolean;\n  transient?: boolean;\n  _meta?: { sensitive?: unknown; transient?: unknown } | undefined;\n}\n\n/**\n * Why `fieldName` cannot label a record of this model, or `null` when it can.\n * Used both to validate an explicit declaration and to filter the default\n * candidates.\n */\nexport function displayLabelFieldProblem(\n  fields: Record<string, LabelCandidate>,\n  fieldName: string,\n): string | null {\n  const field = fields[fieldName];\n  if (!field) return `it is not a field of this model`;\n  if (field.sensitive === true || field._meta?.sensitive === true) {\n    return `it is a sensitive field`;\n  }\n  if (field.transient === true || field._meta?.transient === true) {\n    return `it is a transient field`;\n  }\n  if (field.type && NON_LABEL_FIELD_TYPES.has(field.type)) {\n    return `a ${field.type} field is not the record's own value`;\n  }\n  return null;\n}\n\n/**\n * The own field generic pickers and assistants use to label a record: the\n * declared `display.label` when present, otherwise the first of\n * {@link DEFAULT_DISPLAY_LABEL_FIELDS} that is a usable own field. `undefined`\n * when the model has none (it should then ship a selector).\n */\nexport function resolveDisplayLabelField(\n  fields: Record<string, LabelCandidate>,\n  declared?: string,\n): string | undefined {\n  if (declared !== undefined) {\n    return displayLabelFieldProblem(fields, declared) === null\n      ? declared\n      : undefined;\n  }\n  return DEFAULT_DISPLAY_LABEL_FIELDS.find(\n    (name) => displayLabelFieldProblem(fields, name) === null,\n  );\n}\n\n/**\n * Sentence appended to generated tool descriptions (#3599), including its\n * leading separator; empty when the model has no label field.\n */\nexport function describeDisplayLabel(labelField: string | undefined): string {\n  return labelField\n    ? `. Records are identified by their \\`${labelField}\\` field.`\n    : '';\n}\n\ntype SelectorHost = Pick<SmartObjectManifest, 'uiSelectors'>;\n\n/**\n * The selector slot registered for a model, or `undefined`. Hosts render the\n * package-owned component registered under `slot.slotId` for any\n * `@foreignKey` / `@crossPackageRef` field whose target is `qualifiedName`, and\n * fall back to a generic picker labelled by the model's display label field.\n *\n * Pass every manifest in scope; the first selector found wins.\n */\nexport function findSelectorFor(\n  manifests: SelectorHost | readonly SelectorHost[],\n  qualifiedName: QualifiedClassName | string,\n): ManifestUISelector | undefined {\n  const list = Array.isArray(manifests)\n    ? (manifests as readonly SelectorHost[])\n    : [manifests as SelectorHost];\n  for (const manifest of list) {\n    for (const selector of Object.values(manifest.uiSelectors ?? {})) {\n      if (selector.selects === qualifiedName) return selector;\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;AAiBA,IAAa,mBAAmB;CAC9B;CACA;CACA;CACA;CACA;AACF;;AAKA,IAAa,wBAET;CACF,UAAU,CAAC,MAAM;CACjB,OAAO,CAAC,MAAM;CACd,KAAK,CAAC,MAAM;CACZ,OAAO,CAAC,MAAM;CAGd,UAAU,CAAC,MAAM;AACnB;AAEA,SAAgB,gBAAgB,OAAwC;CACtE,OACE,OAAO,UAAU,YAChB,iBAAuC,SAAS,KAAK;AAE1D;;;;;AAMA,IAAa,+BAA+B;CAC1C;CACA;CACA;CACA;AACF;;AAGA,IAAM,wCAAwB,IAAI,IAAI;CACpC;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAcD,SAAgB,yBACd,QACA,WACe;CACf,MAAM,QAAQ,OAAO;CACrB,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,MAAM,cAAc,QAAQ,MAAM,OAAO,cAAc,MACzD,OAAO;CAET,IAAI,MAAM,cAAc,QAAQ,MAAM,OAAO,cAAc,MACzD,OAAO;CAET,IAAI,MAAM,QAAQ,sBAAsB,IAAI,MAAM,IAAI,GACpD,OAAO,KAAK,MAAM,KAAK;CAEzB,OAAO;AACT;;;;;;;AAQA,SAAgB,yBACd,QACA,UACoB;CACpB,IAAI,aAAa,KAAA,GACf,OAAO,yBAAyB,QAAQ,QAAQ,MAAM,OAClD,WACA,KAAA;CAEN,OAAO,6BAA6B,MACjC,SAAS,yBAAyB,QAAQ,IAAI,MAAM,IACvD;AACF;;;;;AAMA,SAAgB,qBAAqB,YAAwC;CAC3E,OAAO,aACH,uCAAuC,WAAW,aAClD;AACN;;;;;;;;;AAYA,SAAgB,gBACd,WACA,eACgC;CAChC,MAAM,OAAO,MAAM,QAAQ,SAAS,IAC/B,YACD,CAAC,SAAyB;CAC9B,KAAK,MAAM,YAAY,MACrB,KAAK,MAAM,YAAY,OAAO,OAAO,SAAS,eAAe,CAAC,CAAC,GAC7D,IAAI,SAAS,YAAY,eAAe,OAAO;AAIrD"}
+{"version":3,"file":"ui-metadata.js","names":[],"sources":["../src/ui-metadata.ts"],"sourcesContent":["/**\n * Presentation metadata helpers (#3599): `@field({ ui: { widget } })` hints,\n * the own-field display label, and selector-slot lookup.\n *\n * Pure and dependency-free so it is safe in browser bundles\n * (`@happyvertical/smrt-core/ui-metadata`). The manifest generator, the MCP /\n * WebMCP tool descriptors, the knowledge projection and host UIs all read the\n * same rules from here.\n */\n\nimport type {\n  ManifestUISelector,\n  QualifiedClassName,\n  SmartObjectManifest,\n} from './scanner/types.js';\n\n/** Widget hints a field may declare via `@field({ ui: { widget } })`. */\nexport const FIELD_UI_WIDGETS = [\n  'textarea',\n  'currency',\n  'email',\n  'url',\n  'phone',\n] as const;\n\nexport type FieldUIWidget = (typeof FIELD_UI_WIDGETS)[number];\n\n/** Manifest field types each widget may be applied to. */\nexport const FIELD_UI_WIDGET_TYPES: Readonly<\n  Record<FieldUIWidget, readonly string[]>\n> = {\n  textarea: ['text'],\n  email: ['text'],\n  url: ['text'],\n  phone: ['text'],\n  // A currency CODE (ISO 4217, e.g. `currency: string = 'USD'`) picker, not an\n  // amount: amounts are integer minor units and need no widget hint.\n  currency: ['text'],\n};\n\nexport function isFieldUIWidget(value: unknown): value is FieldUIWidget {\n  return (\n    typeof value === 'string' &&\n    (FIELD_UI_WIDGETS as readonly string[]).includes(value)\n  );\n}\n\n/** Presentation formats a field may declare via `@field({ ui: { format } })`. */\nexport const FIELD_UI_FORMATS = [\n  'money',\n  'date',\n  'datetime',\n  'percent',\n] as const;\n\nexport type FieldUIFormat = (typeof FIELD_UI_FORMATS)[number];\n\n/**\n * Manifest field types each format may be applied to. Money is integer\n * minor units only (rates and confidences are the only decimals).\n */\nexport const FIELD_UI_FORMAT_TYPES: Readonly<\n  Record<FieldUIFormat, readonly string[]>\n> = {\n  money: ['integer'],\n  date: ['datetime'],\n  datetime: ['datetime'],\n  percent: ['decimal', 'integer'],\n};\n\nexport function isFieldUIFormat(value: unknown): value is FieldUIFormat {\n  return (\n    typeof value === 'string' &&\n    (FIELD_UI_FORMATS as readonly string[]).includes(value)\n  );\n}\n\n/** Relationship roles a `foreignKey` / `crossPackageRef` may declare. */\nexport const RELATIONSHIP_ROLES = ['items'] as const;\n\nexport type RelationshipRole = (typeof RELATIONSHIP_ROLES)[number];\n\nexport function isRelationshipRole(value: unknown): value is RelationshipRole {\n  return (\n    typeof value === 'string' &&\n    (RELATIONSHIP_ROLES as readonly string[]).includes(value)\n  );\n}\n\n/**\n * Fields tried, in order, when a model declares no\n * `@smrt({ display: { label } })`.\n */\nexport const DEFAULT_DISPLAY_LABEL_FIELDS = [\n  'name',\n  'title',\n  'label',\n  'code',\n] as const;\n\n/** Field kinds that can never be a record's label (they are not its own value). */\nconst NON_LABEL_FIELD_TYPES = new Set([\n  'foreignKey',\n  'crossPackageRef',\n  'oneToMany',\n  'manyToMany',\n  'json',\n  'meta',\n]);\n\ninterface LabelCandidate {\n  type?: string;\n  sensitive?: boolean;\n  transient?: boolean;\n  _meta?: { sensitive?: unknown; transient?: unknown } | undefined;\n}\n\n/**\n * Why `fieldName` cannot label a record of this model, or `null` when it can.\n * Used both to validate an explicit declaration and to filter the default\n * candidates.\n */\nexport function displayLabelFieldProblem(\n  fields: Record<string, LabelCandidate>,\n  fieldName: string,\n): string | null {\n  const field = fields[fieldName];\n  if (!field) return `it is not a field of this model`;\n  if (field.sensitive === true || field._meta?.sensitive === true) {\n    return `it is a sensitive field`;\n  }\n  if (field.transient === true || field._meta?.transient === true) {\n    return `it is a transient field`;\n  }\n  if (field.type && NON_LABEL_FIELD_TYPES.has(field.type)) {\n    return `a ${field.type} field is not the record's own value`;\n  }\n  return null;\n}\n\n/**\n * The own field generic pickers and assistants use to label a record: the\n * declared `display.label` when present, otherwise the first of\n * {@link DEFAULT_DISPLAY_LABEL_FIELDS} that is a usable own field. `undefined`\n * when the model has none (it should then ship a selector).\n */\nexport function resolveDisplayLabelField(\n  fields: Record<string, LabelCandidate>,\n  declared?: string,\n): string | undefined {\n  if (declared !== undefined) {\n    return displayLabelFieldProblem(fields, declared) === null\n      ? declared\n      : undefined;\n  }\n  return DEFAULT_DISPLAY_LABEL_FIELDS.find(\n    (name) => displayLabelFieldProblem(fields, name) === null,\n  );\n}\n\n/**\n * Sentence appended to generated tool descriptions (#3599), including its\n * leading separator; empty when the model has no label field.\n */\nexport function describeDisplayLabel(labelField: string | undefined): string {\n  return labelField\n    ? `. Records are identified by their \\`${labelField}\\` field.`\n    : '';\n}\n\ntype SelectorHost = Pick<SmartObjectManifest, 'uiSelectors'>;\n\n/**\n * The selector slot registered for a model, or `undefined`. Hosts render the\n * package-owned component registered under `slot.slotId` for any\n * `@foreignKey` / `@crossPackageRef` field whose target is `qualifiedName`, and\n * fall back to a generic picker labelled by the model's display label field.\n *\n * Pass every manifest in scope; the first selector found wins.\n */\nexport function findSelectorFor(\n  manifests: SelectorHost | readonly SelectorHost[],\n  qualifiedName: QualifiedClassName | string,\n): ManifestUISelector | undefined {\n  const list = Array.isArray(manifests)\n    ? (manifests as readonly SelectorHost[])\n    : [manifests as SelectorHost];\n  for (const manifest of list) {\n    for (const selector of Object.values(manifest.uiSelectors ?? {})) {\n      if (selector.selects === qualifiedName) return selector;\n    }\n  }\n  return undefined;\n}\n"],"mappings":";;AAiBA,IAAa,mBAAmB;CAC9B;CACA;CACA;CACA;CACA;AACF;;AAKA,IAAa,wBAET;CACF,UAAU,CAAC,MAAM;CACjB,OAAO,CAAC,MAAM;CACd,KAAK,CAAC,MAAM;CACZ,OAAO,CAAC,MAAM;CAGd,UAAU,CAAC,MAAM;AACnB;AAEA,SAAgB,gBAAgB,OAAwC;CACtE,OACE,OAAO,UAAU,YAChB,iBAAuC,SAAS,KAAK;AAE1D;;AAGA,IAAa,mBAAmB;CAC9B;CACA;CACA;CACA;AACF;;;;;AAQA,IAAa,wBAET;CACF,OAAO,CAAC,SAAS;CACjB,MAAM,CAAC,UAAU;CACjB,UAAU,CAAC,UAAU;CACrB,SAAS,CAAC,WAAW,SAAS;AAChC;AAEA,SAAgB,gBAAgB,OAAwC;CACtE,OACE,OAAO,UAAU,YAChB,iBAAuC,SAAS,KAAK;AAE1D;;AAGA,IAAa,qBAAqB,CAAC,OAAO;AAI1C,SAAgB,mBAAmB,OAA2C;CAC5E,OACE,OAAO,UAAU,YAChB,mBAAyC,SAAS,KAAK;AAE5D;;;;;AAMA,IAAa,+BAA+B;CAC1C;CACA;CACA;CACA;AACF;;AAGA,IAAM,wCAAwB,IAAI,IAAI;CACpC;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAcD,SAAgB,yBACd,QACA,WACe;CACf,MAAM,QAAQ,OAAO;CACrB,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,MAAM,cAAc,QAAQ,MAAM,OAAO,cAAc,MACzD,OAAO;CAET,IAAI,MAAM,cAAc,QAAQ,MAAM,OAAO,cAAc,MACzD,OAAO;CAET,IAAI,MAAM,QAAQ,sBAAsB,IAAI,MAAM,IAAI,GACpD,OAAO,KAAK,MAAM,KAAK;CAEzB,OAAO;AACT;;;;;;;AAQA,SAAgB,yBACd,QACA,UACoB;CACpB,IAAI,aAAa,KAAA,GACf,OAAO,yBAAyB,QAAQ,QAAQ,MAAM,OAClD,WACA,KAAA;CAEN,OAAO,6BAA6B,MACjC,SAAS,yBAAyB,QAAQ,IAAI,MAAM,IACvD;AACF;;;;;AAMA,SAAgB,qBAAqB,YAAwC;CAC3E,OAAO,aACH,uCAAuC,WAAW,aAClD;AACN;;;;;;;;;AAYA,SAAgB,gBACd,WACA,eACgC;CAChC,MAAM,OAAO,MAAM,QAAQ,SAAS,IAC/B,YACD,CAAC,SAAyB;CAC9B,KAAK,MAAM,YAAY,MACrB,KAAK,MAAM,YAAY,OAAO,OAAO,SAAS,eAAe,CAAC,CAAC,GAC7D,IAAI,SAAS,YAAY,eAAe,OAAO;AAIrD"}

package/dist/vite-plugin/index.d.ts.map

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

package/dist/vite-plugin/index.js

@@ -1287,6 +1287,7 @@ declare module '@happyvertical/smrt-virt-web' {
     order?: number;
     locked?: boolean;
     widget?: 'textarea' | 'currency' | 'email' | 'url' | 'phone';
+    format?: 'money' | 'date' | 'datetime' | 'percent';
   }
 
   export interface SmrtWebFieldDefinition {
@@ -1315,6 +1316,7 @@ declare module '@happyvertical/smrt-virt-web' {
     field: string;
     kind: SmrtWebRelationshipKind;
     relatedCollection: string;
+    role?: 'items';
   }
 
   export interface WebToolRouteDescriptor {