@contractspec/example.locale-jurisdiction-gate 3.7.7 → 3.7.12

package/.turbo/turbo-build.log

@@ -2,61 +2,82 @@ $ contractspec-bun-build prebuild
 $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
-[contractspec-bun-build] transpile target=bun root=src entries=15 noBundle=false
-Bundled 15 modules in 15ms
+[contractspec-bun-build] transpile target=bun root=src entries=22 noBundle=false
+Bundled 22 modules in 31ms
 
-  docs/index.js                               1.64 KB   (entry point)
-  ./index.js                                  18.69 KB  (entry point)
-  ./locale-jurisdiction-gate.feature.js       1.38 KB   (entry point)
-  operations/index.js                         6.95 KB   (entry point)
-  operations/assistant.js                     6.95 KB   (entry point)
-  policy/index.js                             2.0 KB    (entry point)
-  policy/types.js                             8 bytes   (entry point)
-  docs/locale-jurisdiction-gate.docblock.js   1.64 KB   (entry point)
-  entities/index.js                           3.89 KB   (entry point)
-  entities/models.js                          3.89 KB   (entry point)
-  ./events.js                                 2.97 KB   (entry point)
-  ./example.js                                1.1 KB    (entry point)
-  handlers/index.js                           4.45 KB   (entry point)
-  handlers/demo.handlers.js                   4.45 KB   (entry point)
-  policy/guard.js                             2.0 KB    (entry point)
+  docs/index.js                                      1.64 KB   (entry point)
+  ./index.js                                         30.25 KB  (entry point)
+  policy/index.js                                    4.12 KB   (entry point)
+  policy/types.js                                    8 bytes   (entry point)
+  translations/index.js                              5.92 KB   (entry point)
+  translations/assistant-gate.en-GB.translation.js   1.85 KB   (entry point)
+  translations/assistant-gate.en-US.translation.js   2.0 KB    (entry point)
+  translations/assistant-gate.fr-FR.translation.js   1.94 KB   (entry point)
+  handlers/index.js                                  4.45 KB   (entry point)
+  handlers/demo.handlers.js                          4.45 KB   (entry point)
+  ./locale-jurisdiction-gate.feature.js              3.48 KB   (entry point)
+  operations/index.js                                6.95 KB   (entry point)
+  operations/assistant.js                            6.95 KB   (entry point)
+  policy/assistant-gate.policy.js                    2.10 KB   (entry point)
+  policy/guard.js                                    2.0 KB    (entry point)
+  docs/locale-jurisdiction-gate.docblock.js          1.64 KB   (entry point)
+  entities/index.js                                  3.89 KB   (entry point)
+  ./events.js                                        2.97 KB   (entry point)
+  ./example.js                                       1.1 KB    (entry point)
+  forms/index.js                                     7.15 KB   (entry point)
+  forms/assistant-context.form.js                    7.15 KB   (entry point)
+  entities/models.js                                 3.89 KB   (entry point)
 
-[contractspec-bun-build] transpile target=node root=src entries=15 noBundle=false
-Bundled 15 modules in 35ms
+[contractspec-bun-build] transpile target=node root=src entries=22 noBundle=false
+Bundled 22 modules in 55ms
 
-  docs/index.js                               1.63 KB   (entry point)
-  ./index.js                                  18.68 KB  (entry point)
-  ./locale-jurisdiction-gate.feature.js       1.37 KB   (entry point)
-  operations/index.js                         6.94 KB   (entry point)
-  operations/assistant.js                     6.94 KB   (entry point)
-  policy/index.js                             2.0 KB    (entry point)
-  policy/types.js                             0 KB      (entry point)
-  docs/locale-jurisdiction-gate.docblock.js   1.63 KB   (entry point)
-  entities/index.js                           3.88 KB   (entry point)
-  entities/models.js                          3.88 KB   (entry point)
-  ./events.js                                 2.96 KB   (entry point)
-  ./example.js                                1.1 KB    (entry point)
-  handlers/index.js                           4.44 KB   (entry point)
-  handlers/demo.handlers.js                   4.44 KB   (entry point)
-  policy/guard.js                             2.0 KB    (entry point)
+  docs/index.js                                      1.63 KB   (entry point)
+  ./index.js                                         30.21 KB  (entry point)
+  policy/index.js                                    4.11 KB   (entry point)
+  policy/types.js                                    0 KB      (entry point)
+  translations/index.js                              5.89 KB   (entry point)
+  translations/assistant-gate.en-GB.translation.js   1.84 KB   (entry point)
+  translations/assistant-gate.en-US.translation.js   2.0 KB    (entry point)
+  translations/assistant-gate.fr-FR.translation.js   1.90 KB   (entry point)
+  handlers/index.js                                  4.44 KB   (entry point)
+  handlers/demo.handlers.js                          4.44 KB   (entry point)
+  ./locale-jurisdiction-gate.feature.js              3.47 KB   (entry point)
+  operations/index.js                                6.94 KB   (entry point)
+  operations/assistant.js                            6.94 KB   (entry point)
+  policy/assistant-gate.policy.js                    2.1 KB    (entry point)
+  policy/guard.js                                    2.0 KB    (entry point)
+  docs/locale-jurisdiction-gate.docblock.js          1.63 KB   (entry point)
+  entities/index.js                                  3.88 KB   (entry point)
+  ./events.js                                        2.96 KB   (entry point)
+  ./example.js                                       1.1 KB    (entry point)
+  forms/index.js                                     7.14 KB   (entry point)
+  forms/assistant-context.form.js                    7.14 KB   (entry point)
+  entities/models.js                                 3.88 KB   (entry point)
 
-[contractspec-bun-build] transpile target=browser root=src entries=15 noBundle=false
-Bundled 15 modules in 30ms
+[contractspec-bun-build] transpile target=browser root=src entries=22 noBundle=false
+Bundled 22 modules in 53ms
 
-  docs/index.js                               1.63 KB   (entry point)
-  ./index.js                                  18.68 KB  (entry point)
-  ./locale-jurisdiction-gate.feature.js       1.37 KB   (entry point)
-  operations/index.js                         6.94 KB   (entry point)
-  operations/assistant.js                     6.94 KB   (entry point)
-  policy/index.js                             2.0 KB    (entry point)
-  policy/types.js                             0 KB      (entry point)
-  docs/locale-jurisdiction-gate.docblock.js   1.63 KB   (entry point)
-  entities/index.js                           3.88 KB   (entry point)
-  entities/models.js                          3.88 KB   (entry point)
-  ./events.js                                 2.96 KB   (entry point)
-  ./example.js                                1.1 KB    (entry point)
-  handlers/index.js                           4.44 KB   (entry point)
-  handlers/demo.handlers.js                   4.44 KB   (entry point)
-  policy/guard.js                             2.0 KB    (entry point)
+  docs/index.js                                      1.63 KB   (entry point)
+  ./index.js                                         30.21 KB  (entry point)
+  policy/index.js                                    4.11 KB   (entry point)
+  policy/types.js                                    0 KB      (entry point)
+  translations/index.js                              5.89 KB   (entry point)
+  translations/assistant-gate.en-GB.translation.js   1.84 KB   (entry point)
+  translations/assistant-gate.en-US.translation.js   2.0 KB    (entry point)
+  translations/assistant-gate.fr-FR.translation.js   1.90 KB   (entry point)
+  handlers/index.js                                  4.44 KB   (entry point)
+  handlers/demo.handlers.js                          4.44 KB   (entry point)
+  ./locale-jurisdiction-gate.feature.js              3.47 KB   (entry point)
+  operations/index.js                                6.94 KB   (entry point)
+  operations/assistant.js                            6.94 KB   (entry point)
+  policy/assistant-gate.policy.js                    2.1 KB    (entry point)
+  policy/guard.js                                    2.0 KB    (entry point)
+  docs/locale-jurisdiction-gate.docblock.js          1.63 KB   (entry point)
+  entities/index.js                                  3.88 KB   (entry point)
+  ./events.js                                        2.96 KB   (entry point)
+  ./example.js                                       1.1 KB    (entry point)
+  forms/index.js                                     7.14 KB   (entry point)
+  forms/assistant-context.form.js                    7.14 KB   (entry point)
+  entities/models.js                                 3.88 KB   (entry point)
 
 $ contractspec-bun-build types

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @contractspec/example.locale-jurisdiction-gate
 
+## 3.7.12
+
+### Patch Changes
+
+- Updated dependencies [81256ea]
+- Updated dependencies [2619dd8]
+- Updated dependencies [6de2f1c]
+- Updated dependencies [81256ea]
+- Updated dependencies [a4489bb]
+- Updated dependencies [9cb304e]
+  - @contractspec/lib.contracts-spec@5.0.0
+  - @contractspec/lib.schema@3.7.10
+
+## 3.7.11
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-spec@4.1.3
+  - @contractspec/lib.schema@3.7.9
+
+## 3.7.10
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.schema@3.7.8
+
+## 3.7.9
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.schema@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -704,14 +744,17 @@
   feat: Contract layers support (features, examples, app-configs)
 
   ### New CLI Commands
+
   - `contractspec list layers` - List all contract layers with filtering
 
   ### Enhanced Commands
+
   - `contractspec ci` - New `layers` check category validates features/examples/config
   - `contractspec doctor` - New `layers` health checks
   - `contractspec integrity` - Now shows layer statistics
 
   ### New APIs
+
   - `discoverLayers()` - Scan workspace for all layer files
   - `scanExampleSource()` - Parse ExampleSpec from source code
   - `isExampleFile()` - Check if file is an example spec

package/README.md

@@ -6,6 +6,9 @@ Website: https://contractspec.io
 
 ## What This Demonstrates
 
+- Canonical `policy` export via `AssistantGatePolicy`.
+- Canonical `form` export via `AssistantContextForm`.
+- Canonical `translation` exports for `en-US`, `en-GB`, and `fr-FR`.
 - Fail-closed policy guard pattern for AI assistant calls.
 - Entity models for locale/jurisdiction gating.
 - Event-driven policy enforcement.
@@ -31,9 +34,11 @@ Use `@contractspec/example.locale-jurisdiction-gate` as a reference implementati
 - `src/entities/` contains domain entities and value objects.
 - `src/events.ts` is package-level event definitions.
 - `src/example.ts` is the runnable example entrypoint.
+- `src/forms/` contains the exported assistant context form spec.
 - `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
 - `src/index.ts` is the root public barrel and package entrypoint.
 - `src/locale-jurisdiction-gate.feature.ts` defines a feature entrypoint.
+- `src/translations/` contains the exported locale catalogs.
 
 ## Public Entry Points
 
@@ -44,10 +49,17 @@ Use `@contractspec/example.locale-jurisdiction-gate` as a reference implementati
 - Export `./entities/models` resolves through `./src/entities/models.ts`.
 - Export `./events` resolves through `./src/events.ts`.
 - Export `./example` resolves through `./src/example.ts`.
+- Export `./forms` resolves through `./src/forms/index.ts`.
+- Export `./forms/assistant-context.form` resolves through `./src/forms/assistant-context.form.ts`.
 - Export `./handlers` resolves through `./src/handlers/index.ts`.
 - Export `./handlers/demo.handlers` resolves through `./src/handlers/demo.handlers.ts`.
 - Export `./locale-jurisdiction-gate.feature` resolves through `./src/locale-jurisdiction-gate.feature.ts`.
-- The package publishes 15 total export subpaths; keep docs aligned with `package.json`.
+- Export `./policy/assistant-gate.policy` resolves through `./src/policy/assistant-gate.policy.ts`.
+- Export `./translations` resolves through `./src/translations/index.ts`.
+- Export `./translations/assistant-gate.en-GB.translation` resolves through `./src/translations/assistant-gate.en-GB.translation.ts`.
+- Export `./translations/assistant-gate.en-US.translation` resolves through `./src/translations/assistant-gate.en-US.translation.ts`.
+- Export `./translations/assistant-gate.fr-FR.translation` resolves through `./src/translations/assistant-gate.fr-FR.translation.ts`.
+- The package publishes 21 total export subpaths; keep docs aligned with `package.json`.
 
 ## Local Commands
 

package/dist/browser/forms/assistant-context.form.js

@@ -0,0 +1,213 @@
+// src/entities/models.ts
+import {
+  defineEnum,
+  defineSchemaModel,
+  ScalarTypeEnum
+} from "@contractspec/lib.schema";
+var AllowedScopeEnum = defineEnum("AllowedScope", [
+  "education_only",
+  "generic_info",
+  "escalation_required"
+]);
+var UserProfileModel = defineSchemaModel({
+  name: "UserProfile",
+  description: "User profile inputs used to derive regulatory context.",
+  fields: {
+    preferredLocale: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    residencyCountry: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    taxResidenceCountry: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var RegulatoryContextModel = defineSchemaModel({
+  name: "RegulatoryContext",
+  description: "Explicit regulatory context (no guessing).",
+  fields: {
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    region: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false }
+  }
+});
+var LLMCallEnvelopeModel = defineSchemaModel({
+  name: "LLMCallEnvelope",
+  description: "Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.",
+  fields: {
+    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    regulatoryContext: { type: RegulatoryContextModel, isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false }
+  }
+});
+var AssistantCitationModel = defineSchemaModel({
+  name: "AssistantCitation",
+  description: "Citation referencing a KB snapshot + a specific item within it.",
+  fields: {
+    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var AssistantAnswerSectionModel = defineSchemaModel({
+  name: "AssistantAnswerSection",
+  description: "Structured answer section.",
+  fields: {
+    heading: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var AssistantAnswerIRModel = defineSchemaModel({
+  name: "AssistantAnswerIR",
+  description: "Structured assistant answer with mandatory citations and explicit locale/jurisdiction.",
+  fields: {
+    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    sections: {
+      type: AssistantAnswerSectionModel,
+      isArray: true,
+      isOptional: false
+    },
+    citations: {
+      type: AssistantCitationModel,
+      isArray: true,
+      isOptional: false
+    },
+    disclaimers: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    riskFlags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    refused: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+    refusalReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+
+// src/forms/assistant-context.form.ts
+import { defineFormSpec } from "@contractspec/lib.contracts-spec/forms";
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
+var AssistantContextFormModel = defineSchemaModel2({
+  name: "AssistantContextFormModel",
+  description: "Form values required before a policy-gated assistant request can be executed.",
+  fields: {
+    locale: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    question: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
+  }
+});
+var AssistantContextForm = defineFormSpec({
+  meta: {
+    key: "locale-jurisdiction-gate.form.assistant-context",
+    version: "1.0.0",
+    title: "Assistant Context Gate",
+    description: "Collects the explicit locale, jurisdiction, scope, and knowledge snapshot required by the assistant gate.",
+    domain: "assistant",
+    owners: [OwnersEnum.PlatformFinance],
+    tags: [TagsEnum.I18n, "assistant", "form", "policy"],
+    stability: StabilityEnum.Experimental
+  },
+  model: AssistantContextFormModel,
+  fields: [
+    {
+      kind: "select",
+      name: "locale",
+      labelI18n: "assistantGate.locale.label",
+      descriptionI18n: "assistantGate.locale.description",
+      options: {
+        kind: "static",
+        options: [
+          { labelI18n: "assistantGate.locale.enUs", value: "en-US" },
+          { labelI18n: "assistantGate.locale.enGb", value: "en-GB" },
+          { labelI18n: "assistantGate.locale.frFr", value: "fr-FR" }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "text",
+      name: "jurisdiction",
+      labelI18n: "assistantGate.jurisdiction.label",
+      placeholderI18n: "assistantGate.jurisdiction.placeholder",
+      required: true
+    },
+    {
+      kind: "text",
+      name: "kbSnapshotId",
+      labelI18n: "assistantGate.kbSnapshotId.label",
+      placeholderI18n: "assistantGate.kbSnapshotId.placeholder",
+      required: true
+    },
+    {
+      kind: "radio",
+      name: "allowedScope",
+      labelI18n: "assistantGate.allowedScope.label",
+      options: {
+        kind: "static",
+        options: [
+          {
+            labelI18n: "assistantGate.allowedScope.educationOnly",
+            value: "education_only"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.genericInfo",
+            value: "generic_info"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.escalationRequired",
+            value: "escalation_required"
+          }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "textarea",
+      name: "question",
+      labelI18n: "assistantGate.question.label",
+      placeholderI18n: "assistantGate.question.placeholder",
+      required: true
+    }
+  ],
+  actions: [
+    {
+      key: "submit",
+      labelI18n: "assistantGate.submit.label",
+      op: { name: "assistant.answer", version: "1.0.0" }
+    }
+  ],
+  policy: {
+    flags: [],
+    pii: ["kbSnapshotId", "question"]
+  },
+  renderHints: {
+    ui: "custom",
+    form: "react-hook-form"
+  }
+});
+export {
+  AssistantContextForm
+};

package/dist/browser/forms/index.js

@@ -0,0 +1,213 @@
+// src/entities/models.ts
+import {
+  defineEnum,
+  defineSchemaModel,
+  ScalarTypeEnum
+} from "@contractspec/lib.schema";
+var AllowedScopeEnum = defineEnum("AllowedScope", [
+  "education_only",
+  "generic_info",
+  "escalation_required"
+]);
+var UserProfileModel = defineSchemaModel({
+  name: "UserProfile",
+  description: "User profile inputs used to derive regulatory context.",
+  fields: {
+    preferredLocale: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    residencyCountry: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    taxResidenceCountry: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var RegulatoryContextModel = defineSchemaModel({
+  name: "RegulatoryContext",
+  description: "Explicit regulatory context (no guessing).",
+  fields: {
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    region: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    clientType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false }
+  }
+});
+var LLMCallEnvelopeModel = defineSchemaModel({
+  name: "LLMCallEnvelope",
+  description: "Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.",
+  fields: {
+    traceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    regulatoryContext: { type: RegulatoryContextModel, isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false }
+  }
+});
+var AssistantCitationModel = defineSchemaModel({
+  name: "AssistantCitation",
+  description: "Citation referencing a KB snapshot + a specific item within it.",
+  fields: {
+    kbSnapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var AssistantAnswerSectionModel = defineSchemaModel({
+  name: "AssistantAnswerSection",
+  description: "Structured answer section.",
+  fields: {
+    heading: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    body: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var AssistantAnswerIRModel = defineSchemaModel({
+  name: "AssistantAnswerIR",
+  description: "Structured assistant answer with mandatory citations and explicit locale/jurisdiction.",
+  fields: {
+    locale: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    sections: {
+      type: AssistantAnswerSectionModel,
+      isArray: true,
+      isOptional: false
+    },
+    citations: {
+      type: AssistantCitationModel,
+      isArray: true,
+      isOptional: false
+    },
+    disclaimers: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    riskFlags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    refused: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+    refusalReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+
+// src/forms/assistant-context.form.ts
+import { defineFormSpec } from "@contractspec/lib.contracts-spec/forms";
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
+var AssistantContextFormModel = defineSchemaModel2({
+  name: "AssistantContextFormModel",
+  description: "Form values required before a policy-gated assistant request can be executed.",
+  fields: {
+    locale: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    question: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
+  }
+});
+var AssistantContextForm = defineFormSpec({
+  meta: {
+    key: "locale-jurisdiction-gate.form.assistant-context",
+    version: "1.0.0",
+    title: "Assistant Context Gate",
+    description: "Collects the explicit locale, jurisdiction, scope, and knowledge snapshot required by the assistant gate.",
+    domain: "assistant",
+    owners: [OwnersEnum.PlatformFinance],
+    tags: [TagsEnum.I18n, "assistant", "form", "policy"],
+    stability: StabilityEnum.Experimental
+  },
+  model: AssistantContextFormModel,
+  fields: [
+    {
+      kind: "select",
+      name: "locale",
+      labelI18n: "assistantGate.locale.label",
+      descriptionI18n: "assistantGate.locale.description",
+      options: {
+        kind: "static",
+        options: [
+          { labelI18n: "assistantGate.locale.enUs", value: "en-US" },
+          { labelI18n: "assistantGate.locale.enGb", value: "en-GB" },
+          { labelI18n: "assistantGate.locale.frFr", value: "fr-FR" }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "text",
+      name: "jurisdiction",
+      labelI18n: "assistantGate.jurisdiction.label",
+      placeholderI18n: "assistantGate.jurisdiction.placeholder",
+      required: true
+    },
+    {
+      kind: "text",
+      name: "kbSnapshotId",
+      labelI18n: "assistantGate.kbSnapshotId.label",
+      placeholderI18n: "assistantGate.kbSnapshotId.placeholder",
+      required: true
+    },
+    {
+      kind: "radio",
+      name: "allowedScope",
+      labelI18n: "assistantGate.allowedScope.label",
+      options: {
+        kind: "static",
+        options: [
+          {
+            labelI18n: "assistantGate.allowedScope.educationOnly",
+            value: "education_only"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.genericInfo",
+            value: "generic_info"
+          },
+          {
+            labelI18n: "assistantGate.allowedScope.escalationRequired",
+            value: "escalation_required"
+          }
+        ]
+      },
+      required: true
+    },
+    {
+      kind: "textarea",
+      name: "question",
+      labelI18n: "assistantGate.question.label",
+      placeholderI18n: "assistantGate.question.placeholder",
+      required: true
+    }
+  ],
+  actions: [
+    {
+      key: "submit",
+      labelI18n: "assistantGate.submit.label",
+      op: { name: "assistant.answer", version: "1.0.0" }
+    }
+  ],
+  policy: {
+    flags: [],
+    pii: ["kbSnapshotId", "question"]
+  },
+  renderHints: {
+    ui: "custom",
+    form: "react-hook-form"
+  }
+});
+export {
+  AssistantContextForm
+};