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

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 18ms
+[contractspec-bun-build] transpile target=bun root=src entries=22 noBundle=false
+Bundled 22 modules in 17ms
 
-  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 24ms
+[contractspec-bun-build] transpile target=node root=src entries=22 noBundle=false
+Bundled 22 modules in 38ms
 
-  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 23ms
+[contractspec-bun-build] transpile target=browser root=src entries=22 noBundle=false
+Bundled 22 modules in 28ms
 
-  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/AGENTS.md

@@ -1,36 +1,59 @@
-# AI Agent Guide -- `@contractspec/example.locale-jurisdiction-gate`
+# AI Agent Guide — `@contractspec/example.locale-jurisdiction-gate`
 
 Scope: `packages/examples/locale-jurisdiction-gate/*`
 
-Enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed policy).
+Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`, `lib.schema`
-
-## What This Demonstrates
-
-- Fail-closed policy guard pattern for AI assistant calls
-- Entity models for locale/jurisdiction gating
-- Event-driven policy enforcement
-- Handler and operation separation with typed operations
-- Feature definition pattern
-
-## Public Exports
-
-- `.` -- root barrel
-- `./policy` -- guard, types
-- `./entities` -- models
-- `./operations` -- assistant operations
-- `./handlers` -- demo handlers
-- `./events` -- policy events
-- `./locale-jurisdiction-gate.feature` -- feature definition
-- `./docs`, `./example`
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+
+## Architecture
+
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `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/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.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/locale-jurisdiction-gate.docblock` resolves through `./src/docs/locale-jurisdiction-gate.docblock.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- Export `./entities/models` resolves through `./src/entities/models.ts`.
+- Export `./events` resolves through `./src/events.ts`.
+- Export `./example` resolves through `./src/example.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`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @contractspec/example.locale-jurisdiction-gate
 
+## 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 +722,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

@@ -1,42 +1,87 @@
-# `@contractspec/example.locale-jurisdiction-gate`
-
-Website: https://contractspec.io/
-
-
-Spec-first example showing how to **fail-closed** on every assistant call unless:
-
-- `locale` is provided and supported
-- `jurisdiction` is provided
-- `kbSnapshotId` is provided
-- `allowedScope` is provided and respected
-- answers include **at least one citation** (or the call is refused)
-
-## What this example demonstrates
-
-- **Locale + jurisdiction as explicit inputs** (no guessing)
-- **Structured Answer IR** with citations, disclaimers, and risk flags
-- **Scope enforcement**: blocks scope-violating content under restricted scopes
-- **Traceability**: emits events for requested / blocked / delivered
-
-## Key exports
-
-- `contracts`: `assistant.answer`, `assistant.explainConcept`
-- `entities/models`: `LLMCallEnvelope`, `AssistantAnswerIR`, `RegulatoryContext`
-- `policy/guard`: pure gate functions used by handlers and tests
-- `handlers/demo.handlers`: deterministic demo handlers (no LLM)
-
-## Running tests
-
-```bash
-bun test
-```
-
-
-
-
-
-
-
-
-
-
+# @contractspec/example.locale-jurisdiction-gate
+
+Website: https://contractspec.io
+
+**Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).**
+
+## 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.
+- Handler and operation separation with typed operations.
+- Feature definition pattern.
+- `src/docs/` contains docblocks and documentation-facing exports.
+
+## Running Locally
+
+From `packages/examples/locale-jurisdiction-gate`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
+
+## Usage
+
+Use `@contractspec/example.locale-jurisdiction-gate` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
+
+## Architecture
+
+- `src/docs/` contains docblocks and documentation-facing exports.
+- `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
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/locale-jurisdiction-gate.docblock` resolves through `./src/docs/locale-jurisdiction-gate.docblock.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- 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`.
+- 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
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.

package/dist/browser/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/browser/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/browser/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).",

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
+};