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

package/src/policy/guard.test.ts

@@ -3,23 +3,23 @@ import { describe, expect, it } from 'bun:test';
 import { enforceCitations, validateEnvelope } from './guard';
 
 describe('locale/jurisdiction gate policy', () => {
-  it('blocks unsupported locale', () => {
-    const result = validateEnvelope({
-      locale: 'es-ES',
-      kbSnapshotId: 'snap_1',
-      allowedScope: 'education_only',
-      regulatoryContext: { jurisdiction: 'EU' },
-    });
-    expect(result.ok).toBeFalse();
-    if (!result.ok) expect(result.error.code).toBe('LOCALE_REQUIRED');
-  });
+	it('blocks unsupported locale', () => {
+		const result = validateEnvelope({
+			locale: 'es-ES',
+			kbSnapshotId: 'snap_1',
+			allowedScope: 'education_only',
+			regulatoryContext: { jurisdiction: 'EU' },
+		});
+		expect(result.ok).toBeFalse();
+		if (!result.ok) expect(result.error.code).toBe('LOCALE_REQUIRED');
+	});
 
-  it('blocks answer without citations', () => {
-    const result = enforceCitations({
-      sections: [{ heading: 'A', body: 'B' }],
-      citations: [],
-    });
-    expect(result.ok).toBeFalse();
-    if (!result.ok) expect(result.error.code).toBe('CITATIONS_REQUIRED');
-  });
+	it('blocks answer without citations', () => {
+		const result = enforceCitations({
+			sections: [{ heading: 'A', body: 'B' }],
+			citations: [],
+		});
+		expect(result.ok).toBeFalse();
+		if (!result.ok) expect(result.error.code).toBe('CITATIONS_REQUIRED');
+	});
 });

package/src/policy/guard.ts

@@ -1,102 +1,102 @@
 import type { GateError, GateResult } from './types';
 
 interface EnvelopeLike {
-  locale?: string;
-  kbSnapshotId?: string;
-  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
-  regulatoryContext?: { jurisdiction?: string };
+	locale?: string;
+	kbSnapshotId?: string;
+	allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+	regulatoryContext?: { jurisdiction?: string };
 }
 
 interface AnswerLike {
-  citations?: unknown[];
-  sections?: { heading: string; body: string }[];
-  refused?: boolean;
-  refusalReason?: string;
-  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+	citations?: unknown[];
+	sections?: { heading: string; body: string }[];
+	refused?: boolean;
+	refusalReason?: string;
+	allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
 }
 
 const SUPPORTED_LOCALES = new Set<string>(['en-US', 'en-GB', 'fr-FR']);
 
 function err(code: GateError['code'], message: string): GateError {
-  return { code, message };
+	return { code, message };
 }
 
 export function validateEnvelope(
-  envelope: EnvelopeLike
+	envelope: EnvelopeLike
 ): GateResult<Required<EnvelopeLike>> {
-  if (!envelope.locale || !SUPPORTED_LOCALES.has(envelope.locale)) {
-    return {
-      ok: false,
-      error: err('LOCALE_REQUIRED', 'locale is required and must be supported'),
-    };
-  }
-  if (!envelope.regulatoryContext?.jurisdiction) {
-    return {
-      ok: false,
-      error: err('JURISDICTION_REQUIRED', 'jurisdiction is required'),
-    };
-  }
-  if (!envelope.kbSnapshotId) {
-    return {
-      ok: false,
-      error: err('KB_SNAPSHOT_REQUIRED', 'kbSnapshotId is required'),
-    };
-  }
-  if (!envelope.allowedScope) {
-    return {
-      ok: false,
-      error: err('SCOPE_VIOLATION', 'allowedScope is required'),
-    };
-  }
-  return { ok: true, value: envelope as Required<EnvelopeLike> };
+	if (!envelope.locale || !SUPPORTED_LOCALES.has(envelope.locale)) {
+		return {
+			ok: false,
+			error: err('LOCALE_REQUIRED', 'locale is required and must be supported'),
+		};
+	}
+	if (!envelope.regulatoryContext?.jurisdiction) {
+		return {
+			ok: false,
+			error: err('JURISDICTION_REQUIRED', 'jurisdiction is required'),
+		};
+	}
+	if (!envelope.kbSnapshotId) {
+		return {
+			ok: false,
+			error: err('KB_SNAPSHOT_REQUIRED', 'kbSnapshotId is required'),
+		};
+	}
+	if (!envelope.allowedScope) {
+		return {
+			ok: false,
+			error: err('SCOPE_VIOLATION', 'allowedScope is required'),
+		};
+	}
+	return { ok: true, value: envelope as Required<EnvelopeLike> };
 }
 
 export function enforceCitations(answer: AnswerLike): GateResult<AnswerLike> {
-  const citations = answer.citations ?? [];
-  if (!Array.isArray(citations) || citations.length === 0) {
-    return {
-      ok: false,
-      error: err(
-        'CITATIONS_REQUIRED',
-        'answers must include at least one citation'
-      ),
-    };
-  }
-  return { ok: true, value: answer };
+	const citations = answer.citations ?? [];
+	if (!Array.isArray(citations) || citations.length === 0) {
+		return {
+			ok: false,
+			error: err(
+				'CITATIONS_REQUIRED',
+				'answers must include at least one citation'
+			),
+		};
+	}
+	return { ok: true, value: answer };
 }
 
 const EDUCATION_ONLY_FORBIDDEN_PATTERNS: RegExp[] = [
-  /\b(buy|sell)\b/i,
-  /\b(should\s+buy|should\s+sell)\b/i,
-  /\b(guarantee(d)?|promise(d)?)\b/i,
+	/\b(buy|sell)\b/i,
+	/\b(should\s+buy|should\s+sell)\b/i,
+	/\b(guarantee(d)?|promise(d)?)\b/i,
 ];
 
 export function enforceAllowedScope(
-  allowedScope: EnvelopeLike['allowedScope'],
-  answer: AnswerLike
+	allowedScope: EnvelopeLike['allowedScope'],
+	answer: AnswerLike
 ): GateResult<AnswerLike> {
-  if (!allowedScope) {
-    return {
-      ok: false,
-      error: err('SCOPE_VIOLATION', 'allowedScope is required'),
-    };
-  }
-  if (allowedScope !== 'education_only') {
-    return { ok: true, value: answer };
-  }
+	if (!allowedScope) {
+		return {
+			ok: false,
+			error: err('SCOPE_VIOLATION', 'allowedScope is required'),
+		};
+	}
+	if (allowedScope !== 'education_only') {
+		return { ok: true, value: answer };
+	}
 
-  const bodies = (answer.sections ?? []).map((s) => s.body).join('\n');
-  const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) =>
-    re.test(bodies)
-  );
-  if (violations) {
-    return {
-      ok: false,
-      error: err(
-        'SCOPE_VIOLATION',
-        'answer violates education_only scope (contains actionable or promotional language)'
-      ),
-    };
-  }
-  return { ok: true, value: answer };
+	const bodies = (answer.sections ?? []).map((s) => s.body).join('\n');
+	const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) =>
+		re.test(bodies)
+	);
+	if (violations) {
+		return {
+			ok: false,
+			error: err(
+				'SCOPE_VIOLATION',
+				'answer violates education_only scope (contains actionable or promotional language)'
+			),
+		};
+	}
+	return { ok: true, value: answer };
 }

package/src/policy/index.ts

@@ -1,2 +1,3 @@
-export * from './types';
+export * from './assistant-gate.policy';
 export * from './guard';
+export * from './types';

package/src/policy/types.ts

@@ -1,18 +1,18 @@
 export type AllowedScope =
-  | 'education_only'
-  | 'generic_info'
-  | 'escalation_required';
+	| 'education_only'
+	| 'generic_info'
+	| 'escalation_required';
 
 export interface GateError {
-  code:
-    | 'LOCALE_REQUIRED'
-    | 'JURISDICTION_REQUIRED'
-    | 'KB_SNAPSHOT_REQUIRED'
-    | 'CITATIONS_REQUIRED'
-    | 'SCOPE_VIOLATION';
-  message: string;
+	code:
+		| 'LOCALE_REQUIRED'
+		| 'JURISDICTION_REQUIRED'
+		| 'KB_SNAPSHOT_REQUIRED'
+		| 'CITATIONS_REQUIRED'
+		| 'SCOPE_VIOLATION';
+	message: string;
 }
 
 export type GateResult<T> =
-  | { ok: true; value: T }
-  | { ok: false; error: GateError };
+	| { ok: true; value: T }
+	| { ok: false; error: GateError };

package/src/translations/assistant-gate.en-GB.translation.ts

@@ -0,0 +1,46 @@
+import {
+	OwnersEnum,
+	StabilityEnum,
+	TagsEnum,
+} from '@contractspec/lib.contracts-spec/ownership';
+import { defineTranslation } from '@contractspec/lib.contracts-spec/translations/spec';
+
+export const 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: [OwnersEnum.PlatformFinance],
+		stability: StabilityEnum.Experimental,
+		tags: [TagsEnum.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' },
+	},
+});

package/src/translations/assistant-gate.en-US.translation.ts

@@ -0,0 +1,48 @@
+import {
+	OwnersEnum,
+	StabilityEnum,
+	TagsEnum,
+} from '@contractspec/lib.contracts-spec/ownership';
+import { defineTranslation } from '@contractspec/lib.contracts-spec/translations/spec';
+
+export const AssistantGateMessagesEnUs = defineTranslation({
+	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: [OwnersEnum.PlatformFinance],
+		stability: StabilityEnum.Experimental,
+		tags: [TagsEnum.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' },
+	},
+});

package/src/translations/assistant-gate.fr-FR.translation.ts

@@ -0,0 +1,51 @@
+import {
+	OwnersEnum,
+	StabilityEnum,
+	TagsEnum,
+} from '@contractspec/lib.contracts-spec/ownership';
+import { defineTranslation } from '@contractspec/lib.contracts-spec/translations/spec';
+
+export const AssistantGateMessagesFrFr = defineTranslation({
+	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: [OwnersEnum.PlatformFinance],
+		stability: StabilityEnum.Experimental,
+		tags: [TagsEnum.I18n, 'assistant', 'policy'],
+	},
+	locale: 'fr-FR',
+	fallback: 'en-US',
+	messages: {
+		'assistantGate.locale.label': { value: 'Langue' },
+		'assistantGate.locale.description': {
+			value: "Sélectionnez la langue validée pour la réponse 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érimètre autorisé' },
+		'assistantGate.allowedScope.educationOnly': {
+			value: 'Contenu éducatif uniquement',
+		},
+		'assistantGate.allowedScope.genericInfo': {
+			value: 'Information générale',
+		},
+		'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électionnée ?',
+		},
+		'assistantGate.submit.label': { value: 'Générer la réponse' },
+	},
+});

package/src/translations/index.ts

@@ -0,0 +1,3 @@
+export * from './assistant-gate.en-GB.translation';
+export * from './assistant-gate.en-US.translation';
+export * from './assistant-gate.fr-FR.translation';

package/tsconfig.json

@@ -1,17 +1,9 @@
 {
-  "extends": "@contractspec/tool.typescript/react-library.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+	"extends": "@contractspec/tool.typescript/react-library.json",
+	"compilerOptions": {
+		"outDir": "./dist",
+		"rootDir": "./src"
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist"]
 }
-
-
-
-
-
-
-
-

package/tsdown.config.js

@@ -1,16 +1,10 @@
-import { defineConfig, moduleLibrary, withDevExports } from '@contractspec/tool.bun';
+import {
+	defineConfig,
+	moduleLibrary,
+	withDevExports,
+} from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
-  ...moduleLibrary,
-  ...withDevExports,
+	...moduleLibrary,
+	...withDevExports,
 }));
-
-
-
-
-
-
-
-
-
-