@happyvertical/smrt-prompts 0.51.21 → 0.51.29

package/dist/smrt-knowledge.json

@@ -3,26 +3,33 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-prompts",
-  "packageVersion": "0.51.21",
+  "packageVersion": "0.51.29",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "37a72f3e7c90995d64c9f85ab7015996dfb34ab1da3175a09e10df3c3a96f1c2",
-    "packageJson": "3533a95d111ce54ed6a6deb9847735c81837cbba5f61153bc3f6bef40ecb0721",
-    "agents": "f273f3ce4ed80310d9afdea484314a455a4f7927f79ad8d92a4dff37c20233fa"
+    "manifest": "5f2cdbd24dd366b89f64319285fe0241935c2f4fd082ee92c04cfb9b2fb5e398",
+    "packageJson": "62e12bb3d7649acc05d4b2ac3ef343427a7c4e55be6fa6b48d353a692f5fa853",
+    "agents": "45d48bbf65b540f94cd3a9c261f21c883d3f5fef0681931d5438842cf1727a66"
   },
   "exports": [
     ".",
     "./manifest",
-    "./manifest.json"
+    "./manifest.json",
+    "./svelte"
   ],
   "dependencies": {
     "@happyvertical/smrt-config": "workspace:*",
     "@happyvertical/smrt-core": "workspace:*",
     "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/smrt-ui": "workspace:*",
     "@happyvertical/sql": "catalog:",
     "@happyvertical/smrt-vitest": "workspace:*",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",
+    "jsdom": "^29.1.1",
+    "svelte": "^5.57.1",
+    "svelte-check": "^4.7.6",
     "typescript": "5.9.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
@@ -31,6 +38,7 @@
     "@happyvertical/smrt-config",
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-ui",
     "@happyvertical/smrt-vitest"
   ],
   "sdkDependencies": [
@@ -58,11 +66,25 @@
       "fields": [],
       "relationships": [],
       "methods": [
+        "findByScope",
         "getAppOverride",
+        "getOverrideMapForKeys",
         "getResolutionLayers",
-        "getTenantOverride"
+        "getTenantOverride",
+        "removeOverride",
+        "setTemplateOverride"
       ],
       "methodSignatures": [
+        {
+          "name": "findByScope",
+          "async": true,
+          "params": [
+            "key: string",
+            "scopeType: PromptOverrideScopeType",
+            "scopeId: string"
+          ],
+          "returns": "Promise<PromptOverride | null>"
+        },
         {
           "name": "getAppOverride",
           "async": true,
@@ -72,6 +94,16 @@
           ],
           "returns": "Promise<PromptOverride | null>"
         },
+        {
+          "name": "getOverrideMapForKeys",
+          "async": true,
+          "params": [
+            "keys: string[]",
+            "scopeType: PromptOverrideScopeType",
+            "scopeId: string"
+          ],
+          "returns": "Promise<Map<string, PromptOverride>>"
+        },
         {
           "name": "getResolutionLayers",
           "async": true,
@@ -91,67 +123,78 @@
             "options?: object"
           ],
           "returns": "Promise<PromptOverride | null>"
-        }
-      ],
-      "surfaces": [
-        {
-          "kind": "api",
-          "name": "promptoverrides.getAppOverride",
-          "operation": "getAppOverride",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-          "path": "/promptoverrides/getAppOverride",
-          "method": "POST"
         },
         {
-          "kind": "api",
-          "name": "promptoverrides.getTenantOverride",
-          "operation": "getTenantOverride",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-          "path": "/promptoverrides/getTenantOverride",
-          "method": "POST"
+          "name": "removeOverride",
+          "async": true,
+          "params": [
+            "key: string",
+            "scopeType: PromptOverrideScopeType",
+            "scopeId: string"
+          ],
+          "returns": "Promise<boolean>"
         },
+        {
+          "name": "setTemplateOverride",
+          "async": true,
+          "params": [
+            "key: string",
+            "scopeType: PromptOverrideScopeType",
+            "scopeId: string",
+            "template: string | null"
+          ],
+          "returns": "Promise<PromptOverride>"
+        }
+      ],
+      "surfaces": [],
+      "withheldSurfaces": [
         {
           "kind": "api",
-          "name": "promptoverrides.getResolutionLayers",
-          "operation": "getResolutionLayers",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-          "path": "/promptoverrides/getResolutionLayers",
-          "method": "POST"
+          "operation": "findByScope",
+          "code": "api-disabled",
+          "reason": "api is disabled",
+          "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "cli",
-          "name": "promptoverridecollection_getAppOverride",
+          "kind": "api",
           "operation": "getAppOverride",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "cli",
-          "name": "promptoverridecollection_getTenantOverride",
-          "operation": "getTenantOverride",
+          "kind": "api",
+          "operation": "getOverrideMapForKeys",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "cli",
-          "name": "promptoverridecollection_getResolutionLayers",
+          "kind": "api",
           "operation": "getResolutionLayers",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "mcp",
-          "name": "promptoverridecollection_getappoverride",
-          "operation": "getAppOverride",
+          "kind": "api",
+          "operation": "getTenantOverride",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "mcp",
-          "name": "promptoverridecollection_gettenantoverride",
-          "operation": "getTenantOverride",
+          "kind": "api",
+          "operation": "removeOverride",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         },
         {
-          "kind": "mcp",
-          "name": "promptoverridecollection_getresolutionlayers",
-          "operation": "getResolutionLayers",
+          "kind": "api",
+          "operation": "setTemplateOverride",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
         }
       ],
@@ -246,105 +289,41 @@
         "key",
         "context"
       ],
-      "surfaces": [
-        {
-          "kind": "api",
-          "name": "promptoverrides.list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-          "path": "/promptoverrides",
-          "method": "GET"
-        },
-        {
-          "kind": "api",
-          "name": "promptoverrides.get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-          "path": "/promptoverrides/[id]",
-          "method": "GET"
-        },
-        {
-          "kind": "api",
-          "name": "promptoverrides.create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-          "path": "/promptoverrides",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "promptoverrides.update",
-          "operation": "update",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-          "path": "/promptoverrides/[id]",
-          "method": "PATCH"
-        },
+      "surfaces": [],
+      "withheldSurfaces": [
         {
           "kind": "api",
-          "name": "promptoverrides.delete",
           "operation": "delete",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-          "path": "/promptoverrides/[id]",
-          "method": "DELETE"
-        },
-        {
-          "kind": "cli",
-          "name": "promptoverride_list",
-          "operation": "list",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
-        },
-        {
-          "kind": "cli",
-          "name": "promptoverride_get",
-          "operation": "get",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
-        },
-        {
-          "kind": "cli",
-          "name": "promptoverride_create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
-        },
-        {
-          "kind": "cli",
-          "name": "promptoverride_update",
-          "operation": "update",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverride"
         },
-        {
-          "kind": "cli",
-          "name": "promptoverride_delete",
-          "operation": "delete",
-          "objectName": "@happyvertical/smrt-prompts:PromptOverride"
-        }
-      ],
-      "withheldSurfaces": [
         {
           "kind": "api",
           "operation": "getParams",
-          "code": "not-included",
-          "reason": "not listed in api.include",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverride"
         },
         {
           "kind": "api",
           "operation": "save",
-          "code": "lifecycle-method",
-          "reason": "`save` is a framework lifecycle method, not a distinct operation",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverride"
         },
         {
           "kind": "api",
           "operation": "setParams",
-          "code": "not-included",
-          "reason": "not listed in api.include",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverride"
         },
         {
           "kind": "api",
           "operation": "toPromptLayer",
-          "code": "not-included",
-          "reason": "not listed in api.include",
+          "code": "api-disabled",
+          "reason": "api is disabled",
           "objectName": "@happyvertical/smrt-prompts:PromptOverride"
         }
       ],
@@ -355,147 +334,28 @@
       "risks": []
     }
   ],
-  "surfaces": [
-    {
-      "kind": "api",
-      "name": "promptoverrides.getAppOverride",
-      "operation": "getAppOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-      "path": "/promptoverrides/getAppOverride",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.getTenantOverride",
-      "operation": "getTenantOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-      "path": "/promptoverrides/getTenantOverride",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.getResolutionLayers",
-      "operation": "getResolutionLayers",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection",
-      "path": "/promptoverrides/getResolutionLayers",
-      "method": "POST"
-    },
-    {
-      "kind": "cli",
-      "name": "promptoverridecollection_getAppOverride",
-      "operation": "getAppOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "cli",
-      "name": "promptoverridecollection_getTenantOverride",
-      "operation": "getTenantOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "cli",
-      "name": "promptoverridecollection_getResolutionLayers",
-      "operation": "getResolutionLayers",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "promptoverridecollection_getappoverride",
-      "operation": "getAppOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "promptoverridecollection_gettenantoverride",
-      "operation": "getTenantOverride",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "promptoverridecollection_getresolutionlayers",
-      "operation": "getResolutionLayers",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverrideCollection"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.list",
-      "operation": "list",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-      "path": "/promptoverrides",
-      "method": "GET"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.get",
-      "operation": "get",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-      "path": "/promptoverrides/[id]",
-      "method": "GET"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.create",
-      "operation": "create",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-      "path": "/promptoverrides",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.update",
-      "operation": "update",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-      "path": "/promptoverrides/[id]",
-      "method": "PATCH"
-    },
-    {
-      "kind": "api",
-      "name": "promptoverrides.delete",
-      "operation": "delete",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride",
-      "path": "/promptoverrides/[id]",
-      "method": "DELETE"
-    },
+  "surfaces": [],
+  "prompts": [
     {
-      "kind": "cli",
-      "name": "promptoverride_list",
-      "operation": "list",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+      "filePath": "src/generated-surfaces.test.ts"
     },
     {
-      "kind": "cli",
-      "name": "promptoverride_get",
-      "operation": "get",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+      "filePath": "src/index.ts"
     },
     {
-      "kind": "cli",
-      "name": "promptoverride_create",
-      "operation": "create",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+      "filePath": "src/prompt-override-service.test.ts"
     },
     {
-      "kind": "cli",
-      "name": "promptoverride_update",
-      "operation": "update",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
+      "filePath": "src/prompt-registry.ts"
     },
     {
-      "kind": "cli",
-      "name": "promptoverride_delete",
-      "operation": "delete",
-      "objectName": "@happyvertical/smrt-prompts:PromptOverride"
-    }
-  ],
-  "prompts": [
-    {
-      "filePath": "src/index.ts"
+      "filePath": "src/prompt-resolver.test.ts"
     },
     {
-      "filePath": "src/prompt-registry.ts"
+      "filePath": "src/prompt-settings.test.ts"
     },
     {
-      "filePath": "src/prompt-resolver.test.ts"
+      "filePath": "src/public-surface.test.ts"
     }
   ],
   "relationshipsV2": {
@@ -506,5 +366,5 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 2
   },
-  "agentDoc": "# smrt-prompts\n\nSMRT prompt registry and tenant-aware prompt override package. Code defines defaults; config layers and DB-stored overrides personalize at app and tenant levels.\n\n## Core pieces\n\n- `definePrompt()` registers code defaults in a global process registry (`globalThis.__smrtPromptRegistry`)\n- `resolvePrompt()` merges code defaults, file/config overrides (via `@happyvertical/smrt-config`), stored app-level overrides, stored tenant-level overrides, and a runtime override\n- `PromptOverride` (`_smrt_prompt_overrides` table) stores partial app-level and tenant-level overrides with write-time validation\n- `PromptOverrideCollection` exposes the standard SmrtCollection CRUD surface\n\n## Resolution layers (priority low → high)\n\n1. Code default — registered via `definePrompt({ key, template, ai })`\n2. File/config override — `getPackageConfig<PromptPackageConfig>('prompts', defaults)`\n3. App-level stored override — `PromptOverride` row with `tenantId = null`\n4. Tenant-level stored override — `PromptOverride` row with current tenant\n5. Runtime override — passed to `resolvePrompt({ overrides })`\n\nEach layer can override any subset of fields (template, profile, model, params). Inheritance is field-by-field.\n\n## Conventions\n\n- **Namespace prompt keys** by package or domain: `projects.issue.incorporateFeedback`, `content.summarize.headline`\n- **Stored overrides use nullable fields** so inheritance stays field-by-field — null means \"use the lower layer\"\n- **Provider selection is indirect** in v1: prompts select named profiles, and profiles resolve to provider/model in `smrt-config`\n- **`editable` flags are enforced on `PromptOverride.save()`** — definitions can lock specific fields against tenant override\n\n## Caching\n\n`resolvePrompt()` results are cached per `(key, tenantId)` with a TTL. The cache is invalidated on `PromptOverride.save()` and `.delete()`. Use `clearPromptCache()` for manual invalidation in tests.\n\n**A monotonic per-`(db, key)` invalidation generation guards the cache write.**\nA resolution captures `getPromptCacheGeneration(key, db)` before its\nasynchronous layer loads and hands it back to `setCachedPromptBase()`; a\nconcurrent `save()` / `delete()` bumps the generation and the in-flight\nresolution is then refused the cache write instead of repopulating the key it\njust invalidated with the pre-write value. Without it, \"a stale entry is never\nserved after a write\" held only until a read raced a write, and then failed for\nthe full 30s TTL (a raced `delete()` resurrected the deleted override).\nGenerations are tracked per `(db, key)`, not per tenant, because an app-level\nrow is inherited by every tenant. `clearPromptCache()` raises a single floor\n(`clearedThrough`) rather than resetting or per-key bumping: a key that has\nnever been invalidated has no map entry and reads as generation 0, so a per-key\nbump cannot reach it and a resolution that started before the clear would write\nits pre-clear value back. `smrt-languages` carries the same mechanism, keyed\nadditionally by locale. `smrt-playbooks` has the generation but not the floor\n(#2716).\n\n## Related\n\n- `@happyvertical/smrt-languages` — parallel package for language strings (uses the same architecture pattern)\n- `@happyvertical/smrt-features` — parallel package for feature flags\n"
+  "agentDoc": "# smrt-prompts\n\nSMRT prompt registry and tenant-aware prompt override package. Code defines defaults; config layers and DB-stored overrides personalize at app and tenant levels.\n\n## Core pieces\n\n- `definePrompt()` registers code defaults in a global process registry (`globalThis.__smrtPromptRegistry`)\n- `resolvePrompt()` merges code defaults, file/config overrides (via `@happyvertical/smrt-config`), stored app-level overrides, stored tenant-level overrides, and a runtime override\n- `PromptOverride` (`_smrt_prompt_overrides` table) stores partial app-level and tenant-level overrides with write-time validation\n- `PromptOverrideCollection` — collection API, plus `setTemplateOverride()` / `removeOverride()` / `findByScope()` / `getOverrideMapForKeys()` for the write and enumeration paths below\n- `PromptOverrideService` — the only write path a host should use directly; asks a host-supplied authorizer before every write and fails closed (mirrors `FeatureOverrideService`, #3013); before authorizing it rejects any scope the resolver never reads (`InvalidPromptScopeError`: unknown type, app id other than `__app__`, blank/untrimmed/`__app__` tenant id), so a malformed tenant write cannot reach the app-wide row\n- `PromptSettingsService` — read/write helper for a management screen: `listPromptSettings()` returns one `PromptSettingsRow` per registered key (the effective template, `appTemplate`/`tenantTemplate` for the raw override at each scope, `appDefaultTemplate`/`inheritedTemplate` for what reverting each scope produces, and `supplyingLevel`); `setPromptOverride()` refuses unknown keys and fields the definition marks not editable, then delegates to `PromptOverrideService` (#3053)\n- `./svelte` subpath — `PromptSettingsPanel`, the presentational management panel (#3053)\n\n## Resolution layers (priority low → high)\n\n1. Code default — registered via `definePrompt({ key, template, ai })`\n2. File/config override — `getPackageConfig<PromptPackageConfig>('prompts', defaults)`\n3. App-level stored override — `PromptOverride` row with `tenantId = null`\n4. Tenant-level stored override — `PromptOverride` row with current tenant\n5. Runtime override — passed to `resolvePrompt({ overrides })`\n\nEach layer can override any subset of fields (template, profile, model, params). Inheritance is field-by-field.\n\n## Conventions\n\n- **Namespace prompt keys** by package or domain: `projects.issue.incorporateFeedback`, `content.summarize.headline`\n- **Stored overrides use nullable fields** so inheritance stays field-by-field — null means \"use the lower layer\"\n- **Provider selection is indirect** in v1: prompts select named profiles, and profiles resolve to provider/model in `smrt-config`\n- **`editable` flags are enforced on `PromptOverride.save()`** — definitions can lock specific fields against tenant override\n\n## Generated surfaces\n\n`PromptOverride` ships with generated REST routes, MCP tools, and CLI commands\nclosed (`api: false`, `cli: false`, `mcp: false`, mirrors `FeatureOverride`,\n#3013). Override rows are authorization state for every scope and `tenantId` is\nan ordinary settable field, not request-derived tenant scoping — a generated\nauthentication-only surface would let any signed-in principal set another\ntenant's prompt text. Hosts write overrides server-side with\n`PromptOverrideService` (which requires an explicit authorizer for every\nwrite) or `PromptOverrideCollection.setTemplateOverride()` /\n`removeOverride()` only after their own authorization decision.\n\n## Management UI (`./svelte`)\n\n- Built like every other Svelte-shipping package here (`smrt-features`/`smrt-tenancy` are the closest models): `vite build --mode library && svelte-package -i src/svelte -o dist/svelte`, an `./svelte` export with a `svelte` condition, `svelte` as an **optional** peer dependency, plus `scripts/prune-svelte-package-artifacts.js` so `svelte-package` does not copy `__tests__/` into the published `dist/svelte`. The root export stays Svelte-free so server-only consumers are unaffected.\n- `PromptSettingsPanel` is presentational: rows and callbacks in, no fetching, no authorization. `src/svelte/types.ts` deliberately imports nothing from `smrt-core` or the `@smrt()` models, so the browser bundle stays thin; `PromptSettingsRow` is structurally assignable to `PromptSettingsView`.\n- Each row is its own `<form>` with a checkbox + `<textarea>` pair per scope (`tenantOverride`/`tenantTemplate`, and `appOverride`/`appTemplate` when `showApp` is set). The checkbox's presence in the submitted `FormData` — not whether the textarea is disabled — decides override vs. revert, because a plain HTML submit cannot un-disable a field the browser already marked disabled. `onSave` reads the same `FormData` when driving the panel from a client handler instead of `formAction`.\n- Two invariants, both regression-tested. (1) The \"revert\" preview never claims the bare registry default: `tenantRevertPreview()` shows `inheritedTemplate` (registry + config + app override), falling back to `appDefaultTemplate` only when the row does not carry it, and `appRevertPreview()` shows `appDefaultTemplate` (registry + config, never the app override itself). `PromptSettingsService` computes both explicitly rather than deriving one from the other — an earlier draft reused the app-only merge as the \"no tenant requested\" effective value and broke both. (2) The rows remount on `contextKey ?? prompts`, so an unsaved edit cannot survive a reload or a tenant switch and be submitted against the new rows.\n- **Authorization stays with the consumer.** `PromptSettingsService` reads are unfiltered and every write goes through `PromptOverrideService`; constructing the settings service without an `authorize` option makes it read-only (writes fail closed). Never add an authorization decision to this package.\n- `vitest.config.ts` runs two projects (`server` node + `smrtVitestPlugin`, `svelte` jsdom + `@sveltejs/vite-plugin-svelte` with `conditions: ['browser']`) because the browser condition would send `smrt-core` to its browser build if applied globally.\n- `PromptSettingsService.create()` builds its `PromptOverrideCollection` with the caller's `defaultListLimit`/`maxListLimit` stripped before the bulk `getOverrideMapForKeys()` enumeration read that backs `listPromptSettings()` — the #3056 hazard class in `smrt-features`'s `FeatureOverrideCollection.getOverrideMap()`, applied here proactively rather than left for a follow-up issue. A host-configured list bound must never silently drop a key's override from a management screen.\n\n## Prompt keys are persisted identifiers\n\nOverrides are stored keyed by the exact `key` string and resolved by that\nstring at runtime. **Renaming a key orphans every existing override and\nsilently reverts every tenant to the registry default.** Treat a shipped key\nas immutable; a rename needs a data migration over\n`_smrt_prompt_overrides.key`, not an edit.\n\n## Caching\n\n`resolvePrompt()` results are cached per `(key, tenantId)` with a TTL. The cache is invalidated on `PromptOverride.save()` and `.delete()`. Use `clearPromptCache()` for manual invalidation in tests.\n\n**A monotonic per-`(db, key)` invalidation generation guards the cache write.**\nA resolution captures `getPromptCacheGeneration(key, db)` before its\nasynchronous layer loads and hands it back to `setCachedPromptBase()`; a\nconcurrent `save()` / `delete()` bumps the generation and the in-flight\nresolution is then refused the cache write instead of repopulating the key it\njust invalidated with the pre-write value. Without it, \"a stale entry is never\nserved after a write\" held only until a read raced a write, and then failed for\nthe full 30s TTL (a raced `delete()` resurrected the deleted override).\nGenerations are tracked per `(db, key)`, not per tenant, because an app-level\nrow is inherited by every tenant. `clearPromptCache()` raises a single floor\n(`clearedThrough`) rather than resetting or per-key bumping: a key that has\nnever been invalidated has no map entry and reads as generation 0, so a per-key\nbump cannot reach it and a resolution that started before the clear would write\nits pre-clear value back. `smrt-languages` carries the same mechanism, keyed\nadditionally by locale. `smrt-playbooks` has the generation but not the floor\n(#2716).\n\n## Related\n\n- `@happyvertical/smrt-languages` — parallel package for language strings (uses the same architecture pattern)\n- `@happyvertical/smrt-features` — parallel package for feature flags\n"
 }