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

package/dist/forms/index.js

@@ -0,0 +1,214 @@
+// @bun
+// 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/index.d.ts

@@ -7,8 +7,10 @@
 export * from './entities';
 export * from './events';
 export { default as example } from './example';
+export * from './forms';
 export * from './handlers';
 export * from './locale-jurisdiction-gate.feature';
 export * from './operations';
 export * from './policy';
+export * from './translations';
 import './docs';

package/dist/index.js

@@ -245,6 +245,114 @@ var example = defineExample({
 });
 var example_default = example;
 
+// 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 defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
+var AssistantContextFormModel = defineSchemaModel3({
+  name: "AssistantContextFormModel",
+  description: "Form values required before a policy-gated assistant request can be executed.",
+  fields: {
+    locale: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    jurisdiction: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    kbSnapshotId: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false },
+    allowedScope: { type: AllowedScopeEnum, isOptional: false },
+    question: { type: ScalarTypeEnum3.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"
+  }
+});
 // src/policy/guard.ts
 var SUPPORTED_LOCALES = new Set(["en-US", "en-GB", "fr-FR"]);
 function err(code, message) {
@@ -394,6 +502,66 @@ function createDemoAssistantHandlers() {
   }
   return { answer, explainConcept };
 }
+// src/policy/assistant-gate.policy.ts
+import {
+  OwnersEnum as OwnersEnum2,
+  StabilityEnum as StabilityEnum2,
+  TagsEnum as TagsEnum2
+} from "@contractspec/lib.contracts-spec/ownership";
+import { definePolicy } from "@contractspec/lib.contracts-spec/policy";
+var AssistantGatePolicy = definePolicy({
+  meta: {
+    key: "locale-jurisdiction-gate.policy.gate",
+    version: "1.0.0",
+    title: "Assistant Locale and Jurisdiction Gate",
+    description: "Requires explicit locale, jurisdiction, knowledge snapshot, and allowed scope before assistant requests may proceed.",
+    domain: "assistant",
+    scope: "operation",
+    owners: [OwnersEnum2.PlatformFinance],
+    tags: [TagsEnum2.I18n, "assistant", "policy", "jurisdiction"],
+    stability: StabilityEnum2.Experimental
+  },
+  rules: [
+    {
+      effect: "deny",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "!context.locale || !context.jurisdiction || !context.kbSnapshotId || !context.allowedScope"
+        }
+      ],
+      reason: "Assistant requests fail closed until locale, jurisdiction, kbSnapshotId, and allowedScope are explicit."
+    },
+    {
+      effect: "deny",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "!['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '')"
+        }
+      ],
+      reason: "Only the explicitly reviewed assistant locales are permitted."
+    },
+    {
+      effect: "allow",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '') && !!context.jurisdiction && !!context.kbSnapshotId && !!context.allowedScope"
+        }
+      ],
+      reason: "Explicit context is present, so the request may continue to citation and scope validation."
+    }
+  ],
+  pii: {
+    fields: ["kbSnapshotId"],
+    retentionDays: 30
+  }
+});
+
 // src/locale-jurisdiction-gate.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var LocaleJurisdictionGateFeature = defineFeature({
@@ -422,7 +590,12 @@ var LocaleJurisdictionGateFeature = defineFeature({
   capabilities: {
     requires: [{ key: "knowledge", version: "1.0.0" }]
   },
-  policies: [{ key: "locale-jurisdiction-gate.policy.gate", version: "1.0.0" }],
+  policies: [
+    {
+      key: AssistantGatePolicy.meta.key,
+      version: AssistantGatePolicy.meta.version
+    }
+  ],
   knowledge: [
     { key: "locale-jurisdiction-gate.knowledge.rules", version: "1.0.0" }
   ],
@@ -434,21 +607,21 @@ var LocaleJurisdictionGateFeature = defineFeature({
 
 // src/operations/assistant.ts
 import { defineCommand } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
-var AssistantQuestionInput = defineSchemaModel3({
+import { defineSchemaModel as defineSchemaModel4, ScalarTypeEnum as ScalarTypeEnum4 } from "@contractspec/lib.schema";
+var AssistantQuestionInput = defineSchemaModel4({
   name: "AssistantQuestionInput",
   description: "Input for assistant calls with mandatory envelope.",
   fields: {
     envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    question: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
+    question: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false }
   }
 });
-var AssistantConceptInput = defineSchemaModel3({
+var AssistantConceptInput = defineSchemaModel4({
   name: "AssistantConceptInput",
   description: "Input for explaining a concept with mandatory envelope.",
   fields: {
     envelope: { type: LLMCallEnvelopeModel, isOptional: false },
-    conceptKey: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
+    conceptKey: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false }
   }
 });
 var AssistantAnswerContract = defineCommand({
@@ -518,6 +691,149 @@ var AssistantExplainConceptContract = defineCommand({
   },
   policy: { auth: "user" }
 });
+// src/translations/assistant-gate.en-GB.translation.ts
+import {
+  OwnersEnum as OwnersEnum3,
+  StabilityEnum as StabilityEnum3,
+  TagsEnum as TagsEnum3
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations/spec";
+var AssistantGateMessagesEnGb = defineTranslation({
+  meta: {
+    key: "locale-jurisdiction-gate.translation.assistant-gate.en-GB",
+    version: "1.0.0",
+    domain: "assistant",
+    description: "British English messages for the assistant locale and jurisdiction gate.",
+    owners: [OwnersEnum3.PlatformFinance],
+    stability: StabilityEnum3.Experimental,
+    tags: [TagsEnum3.I18n, "assistant", "policy"]
+  },
+  locale: "en-GB",
+  fallback: "en-US",
+  messages: {
+    "assistantGate.locale.label": { value: "Locale" },
+    "assistantGate.locale.description": {
+      value: "Select the reviewed locale for the assistant response."
+    },
+    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
+    "assistantGate.jurisdiction.placeholder": { value: "UK-FCA" },
+    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
+    "assistantGate.kbSnapshotId.placeholder": {
+      value: "kb_2026_03_20_policy_reviewed"
+    },
+    "assistantGate.allowedScope.label": { value: "Permitted scope" },
+    "assistantGate.allowedScope.educationOnly": {
+      value: "Educational content only"
+    },
+    "assistantGate.allowedScope.genericInfo": { value: "General information" },
+    "assistantGate.allowedScope.escalationRequired": {
+      value: "Escalation required"
+    },
+    "assistantGate.question.label": { value: "Question" },
+    "assistantGate.question.placeholder": {
+      value: "What may I say about this product in the selected jurisdiction?"
+    },
+    "assistantGate.submit.label": { value: "Generate response" }
+  }
+});
+
+// src/translations/assistant-gate.en-US.translation.ts
+import {
+  OwnersEnum as OwnersEnum4,
+  StabilityEnum as StabilityEnum4,
+  TagsEnum as TagsEnum4
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations/spec";
+var AssistantGateMessagesEnUs = defineTranslation2({
+  meta: {
+    key: "locale-jurisdiction-gate.translation.assistant-gate.en-US",
+    version: "1.0.0",
+    domain: "assistant",
+    description: "US English messages for the assistant locale and jurisdiction gate.",
+    owners: [OwnersEnum4.PlatformFinance],
+    stability: StabilityEnum4.Experimental,
+    tags: [TagsEnum4.I18n, "assistant", "policy"]
+  },
+  locale: "en-US",
+  messages: {
+    "assistantGate.locale.label": { value: "Locale" },
+    "assistantGate.locale.description": {
+      value: "Choose the reviewed locale for the assistant answer."
+    },
+    "assistantGate.locale.enUs": { value: "English (United States)" },
+    "assistantGate.locale.enGb": { value: "English (United Kingdom)" },
+    "assistantGate.locale.frFr": { value: "French (France)" },
+    "assistantGate.jurisdiction.label": { value: "Jurisdiction" },
+    "assistantGate.jurisdiction.placeholder": { value: "US-SEC" },
+    "assistantGate.kbSnapshotId.label": { value: "Knowledge snapshot ID" },
+    "assistantGate.kbSnapshotId.placeholder": {
+      value: "kb_2026_03_20_policy_reviewed"
+    },
+    "assistantGate.allowedScope.label": { value: "Allowed scope" },
+    "assistantGate.allowedScope.educationOnly": {
+      value: "Educational content only"
+    },
+    "assistantGate.allowedScope.genericInfo": { value: "Generic information" },
+    "assistantGate.allowedScope.escalationRequired": {
+      value: "Escalation required"
+    },
+    "assistantGate.question.label": { value: "Question" },
+    "assistantGate.question.placeholder": {
+      value: "What can I say about this product in the selected jurisdiction?"
+    },
+    "assistantGate.submit.label": { value: "Generate answer" }
+  }
+});
+
+// src/translations/assistant-gate.fr-FR.translation.ts
+import {
+  OwnersEnum as OwnersEnum5,
+  StabilityEnum as StabilityEnum5,
+  TagsEnum as TagsEnum5
+} from "@contractspec/lib.contracts-spec/ownership";
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations/spec";
+var AssistantGateMessagesFrFr = defineTranslation3({
+  meta: {
+    key: "locale-jurisdiction-gate.translation.assistant-gate.fr-FR",
+    version: "1.0.0",
+    domain: "assistant",
+    description: "French messages for the assistant locale and jurisdiction gate.",
+    owners: [OwnersEnum5.PlatformFinance],
+    stability: StabilityEnum5.Experimental,
+    tags: [TagsEnum5.I18n, "assistant", "policy"]
+  },
+  locale: "fr-FR",
+  fallback: "en-US",
+  messages: {
+    "assistantGate.locale.label": { value: "Langue" },
+    "assistantGate.locale.description": {
+      value: "S\xE9lectionnez la langue valid\xE9e pour la r\xE9ponse de l'assistant."
+    },
+    "assistantGate.jurisdiction.label": { value: "Juridiction" },
+    "assistantGate.jurisdiction.placeholder": { value: "FR-AMF" },
+    "assistantGate.kbSnapshotId.label": {
+      value: "Identifiant du snapshot documentaire"
+    },
+    "assistantGate.kbSnapshotId.placeholder": {
+      value: "kb_2026_03_20_policy_reviewed"
+    },
+    "assistantGate.allowedScope.label": { value: "P\xE9rim\xE8tre autoris\xE9" },
+    "assistantGate.allowedScope.educationOnly": {
+      value: "Contenu \xE9ducatif uniquement"
+    },
+    "assistantGate.allowedScope.genericInfo": {
+      value: "Information g\xE9n\xE9rale"
+    },
+    "assistantGate.allowedScope.escalationRequired": {
+      value: "Escalade obligatoire"
+    },
+    "assistantGate.question.label": { value: "Question" },
+    "assistantGate.question.placeholder": {
+      value: "Que puis-je dire sur ce produit dans la juridiction s\xE9lectionn\xE9e ?"
+    },
+    "assistantGate.submit.label": { value: "G\xE9n\xE9rer la r\xE9ponse" }
+  }
+});
 export {
   validateEnvelope,
   example_default as example,
@@ -528,7 +844,12 @@ export {
   RegulatoryContextModel,
   LocaleJurisdictionGateFeature,
   LLMCallEnvelopeModel,
+  AssistantGatePolicy,
+  AssistantGateMessagesFrFr,
+  AssistantGateMessagesEnUs,
+  AssistantGateMessagesEnGb,
   AssistantExplainConceptContract,
+  AssistantContextForm,
   AssistantCitationModel,
   AssistantAnswerSectionModel,
   AssistantAnswerRequestedEvent,

package/dist/locale-jurisdiction-gate.feature.js

@@ -1,4 +1,64 @@
 // @bun
+// src/policy/assistant-gate.policy.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts-spec/ownership";
+import { definePolicy } from "@contractspec/lib.contracts-spec/policy";
+var AssistantGatePolicy = definePolicy({
+  meta: {
+    key: "locale-jurisdiction-gate.policy.gate",
+    version: "1.0.0",
+    title: "Assistant Locale and Jurisdiction Gate",
+    description: "Requires explicit locale, jurisdiction, knowledge snapshot, and allowed scope before assistant requests may proceed.",
+    domain: "assistant",
+    scope: "operation",
+    owners: [OwnersEnum.PlatformFinance],
+    tags: [TagsEnum.I18n, "assistant", "policy", "jurisdiction"],
+    stability: StabilityEnum.Experimental
+  },
+  rules: [
+    {
+      effect: "deny",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "!context.locale || !context.jurisdiction || !context.kbSnapshotId || !context.allowedScope"
+        }
+      ],
+      reason: "Assistant requests fail closed until locale, jurisdiction, kbSnapshotId, and allowedScope are explicit."
+    },
+    {
+      effect: "deny",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "!['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '')"
+        }
+      ],
+      reason: "Only the explicitly reviewed assistant locales are permitted."
+    },
+    {
+      effect: "allow",
+      actions: ["assistant.answer", "assistant.explainConcept"],
+      resource: { type: "assistant-call" },
+      conditions: [
+        {
+          expression: "['en-US', 'en-GB', 'fr-FR'].includes(context.locale ?? '') && !!context.jurisdiction && !!context.kbSnapshotId && !!context.allowedScope"
+        }
+      ],
+      reason: "Explicit context is present, so the request may continue to citation and scope validation."
+    }
+  ],
+  pii: {
+    fields: ["kbSnapshotId"],
+    retentionDays: 30
+  }
+});
+
 // src/locale-jurisdiction-gate.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var LocaleJurisdictionGateFeature = defineFeature({
@@ -27,7 +87,12 @@ var LocaleJurisdictionGateFeature = defineFeature({
   capabilities: {
     requires: [{ key: "knowledge", version: "1.0.0" }]
   },
-  policies: [{ key: "locale-jurisdiction-gate.policy.gate", version: "1.0.0" }],
+  policies: [
+    {
+      key: AssistantGatePolicy.meta.key,
+      version: AssistantGatePolicy.meta.version
+    }
+  ],
   knowledge: [
     { key: "locale-jurisdiction-gate.knowledge.rules", version: "1.0.0" }
   ],