@contractspec/example.locale-jurisdiction-gate 3.7.6 → 3.7.10

package/dist/index.js

@@ -44,9 +44,9 @@ var docBlocks = [
 registerDocBlocks(docBlocks);
 // src/entities/models.ts
 import {
-  ScalarTypeEnum,
   defineEnum,
-  defineSchemaModel
+  defineSchemaModel,
+  ScalarTypeEnum
 } from "@contractspec/lib.schema";
 var AllowedScopeEnum = defineEnum("AllowedScope", [
   "education_only",
@@ -145,7 +145,7 @@ var AssistantAnswerIRModel = defineSchemaModel({
 });
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var AssistantAnswerRequestedPayload = defineSchemaModel2({
   name: "AssistantAnswerRequestedPayload",
   description: "Emitted when an assistant answer is requested (pre-gate).",
@@ -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,23 +502,126 @@ 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({
+  meta: {
+    key: "locale-jurisdiction-gate",
+    version: "1.0.0",
+    title: "Locale + Jurisdiction Gate",
+    description: "Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.",
+    domain: "knowledge",
+    owners: ["@examples"],
+    tags: ["assistant", "policy", "locale", "jurisdiction", "knowledge"],
+    stability: "experimental"
+  },
+  operations: [
+    { key: "assistant.answer", version: "1.0.0" },
+    { key: "assistant.explainConcept", version: "1.0.0" }
+  ],
+  events: [
+    { key: "assistant.answer.requested", version: "1.0.0" },
+    { key: "assistant.answer.blocked", version: "1.0.0" },
+    { key: "assistant.answer.delivered", version: "1.0.0" }
+  ],
+  presentations: [],
+  opToPresentation: [],
+  presentationsTargets: [],
+  capabilities: {
+    requires: [{ key: "knowledge", version: "1.0.0" }]
+  },
+  policies: [
+    {
+      key: AssistantGatePolicy.meta.key,
+      version: AssistantGatePolicy.meta.version
+    }
+  ],
+  knowledge: [
+    { key: "locale-jurisdiction-gate.knowledge.rules", version: "1.0.0" }
+  ],
+  docs: [
+    "docs.examples.locale-jurisdiction-gate.goal",
+    "docs.examples.locale-jurisdiction-gate.reference"
+  ]
+});
+
 // src/operations/assistant.ts
 import { defineCommand } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } 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({
@@ -480,42 +691,148 @@ var AssistantExplainConceptContract = defineCommand({
   },
   policy: { auth: "user" }
 });
-// src/locale-jurisdiction-gate.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LocaleJurisdictionGateFeature = defineFeature({
+// 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",
+    key: "locale-jurisdiction-gate.translation.assistant-gate.en-GB",
     version: "1.0.0",
-    title: "Locale + Jurisdiction Gate",
-    description: "Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.",
-    domain: "knowledge",
-    owners: ["@examples"],
-    tags: ["assistant", "policy", "locale", "jurisdiction", "knowledge"],
-    stability: "experimental"
+    domain: "assistant",
+    description: "British English messages for the assistant locale and jurisdiction gate.",
+    owners: [OwnersEnum3.PlatformFinance],
+    stability: StabilityEnum3.Experimental,
+    tags: [TagsEnum3.I18n, "assistant", "policy"]
   },
-  operations: [
-    { key: "assistant.answer", version: "1.0.0" },
-    { key: "assistant.explainConcept", version: "1.0.0" }
-  ],
-  events: [
-    { key: "assistant.answer.requested", version: "1.0.0" },
-    { key: "assistant.answer.blocked", version: "1.0.0" },
-    { key: "assistant.answer.delivered", version: "1.0.0" }
-  ],
-  presentations: [],
-  opToPresentation: [],
-  presentationsTargets: [],
-  capabilities: {
-    requires: [{ key: "knowledge", version: "1.0.0" }]
+  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"]
   },
-  policies: [{ key: "locale-jurisdiction-gate.policy.gate", version: "1.0.0" }],
-  knowledge: [
-    { key: "locale-jurisdiction-gate.knowledge.rules", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.locale-jurisdiction-gate.goal",
-    "docs.examples.locale-jurisdiction-gate.reference"
-  ]
+  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,
@@ -527,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" }
   ],

package/dist/node/entities/index.js

@@ -1,8 +1,8 @@
 // src/entities/models.ts
 import {
-  ScalarTypeEnum,
   defineEnum,
-  defineSchemaModel
+  defineSchemaModel,
+  ScalarTypeEnum
 } from "@contractspec/lib.schema";
 var AllowedScopeEnum = defineEnum("AllowedScope", [
   "education_only",

package/dist/node/entities/models.js

@@ -1,8 +1,8 @@
 // src/entities/models.ts
 import {
-  ScalarTypeEnum,
   defineEnum,
-  defineSchemaModel
+  defineSchemaModel,
+  ScalarTypeEnum
 } from "@contractspec/lib.schema";
 var AllowedScopeEnum = defineEnum("AllowedScope", [
   "education_only",

package/dist/node/events.js

@@ -1,6 +1,6 @@
 // src/events.ts
 import { defineEvent } from "@contractspec/lib.contracts-spec";
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var AssistantAnswerRequestedPayload = defineSchemaModel({
   name: "AssistantAnswerRequestedPayload",
   description: "Emitted when an assistant answer is requested (pre-gate).",