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

package/src/example.ts

@@ -1,34 +1,34 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'locale-jurisdiction-gate',
-    version: '1.0.0',
-    title: 'Locale / Jurisdiction Gate',
-    description:
-      'Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.',
-    kind: 'knowledge',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['policy', 'locale', 'jurisdiction', 'assistant', 'gating'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.locale-jurisdiction-gate',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.locale-jurisdiction-gate',
-    feature: './feature',
-    contracts: './contracts',
-    handlers: './handlers',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'locale-jurisdiction-gate',
+		version: '1.0.0',
+		title: 'Locale / Jurisdiction Gate',
+		description:
+			'Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.',
+		kind: 'knowledge',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['policy', 'locale', 'jurisdiction', 'assistant', 'gating'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.locale-jurisdiction-gate',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.locale-jurisdiction-gate',
+		feature: './feature',
+		contracts: './contracts',
+		handlers: './handlers',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

package/src/handlers/demo.handlers.test.ts

@@ -3,52 +3,52 @@ import { describe, expect, it } from 'bun:test';
 import { createDemoAssistantHandlers } from './demo.handlers';
 
 describe('@contractspec/example.locale-jurisdiction-gate demo handlers', () => {
-  it('blocks when locale is missing', async () => {
-    const handlers = createDemoAssistantHandlers();
-    const result = await handlers.answer({
-      envelope: {
-        traceId: 't1',
-        locale: '',
-        kbSnapshotId: 'snap_1',
-        allowedScope: 'education_only',
-        regulatoryContext: { jurisdiction: 'EU' },
-      },
-      question: 'What is a snapshot?',
-    });
-    expect(result.refused).toBeTrue();
-    expect(result.refusalReason).toBe('LOCALE_REQUIRED');
-  });
+	it('blocks when locale is missing', async () => {
+		const handlers = createDemoAssistantHandlers();
+		const result = await handlers.answer({
+			envelope: {
+				traceId: 't1',
+				locale: '',
+				kbSnapshotId: 'snap_1',
+				allowedScope: 'education_only',
+				regulatoryContext: { jurisdiction: 'EU' },
+			},
+			question: 'What is a snapshot?',
+		});
+		expect(result.refused).toBeTrue();
+		expect(result.refusalReason).toBe('LOCALE_REQUIRED');
+	});
 
-  it('blocks when kbSnapshotId is missing', async () => {
-    const handlers = createDemoAssistantHandlers();
-    const result = await handlers.answer({
-      envelope: {
-        traceId: 't2',
-        locale: 'en-GB',
-        kbSnapshotId: '',
-        allowedScope: 'education_only',
-        regulatoryContext: { jurisdiction: 'EU' },
-      },
-      question: 'What is a snapshot?',
-    });
-    expect(result.refused).toBeTrue();
-    expect(result.refusalReason).toBe('KB_SNAPSHOT_REQUIRED');
-  });
+	it('blocks when kbSnapshotId is missing', async () => {
+		const handlers = createDemoAssistantHandlers();
+		const result = await handlers.answer({
+			envelope: {
+				traceId: 't2',
+				locale: 'en-GB',
+				kbSnapshotId: '',
+				allowedScope: 'education_only',
+				regulatoryContext: { jurisdiction: 'EU' },
+			},
+			question: 'What is a snapshot?',
+		});
+		expect(result.refused).toBeTrue();
+		expect(result.refusalReason).toBe('KB_SNAPSHOT_REQUIRED');
+	});
 
-  it('blocks education_only answers that include buy/sell language', async () => {
-    const handlers = createDemoAssistantHandlers();
-    const result = await handlers.answer({
-      envelope: {
-        traceId: 't3',
-        locale: 'en-GB',
-        kbSnapshotId: 'snap_1',
-        allowedScope: 'education_only',
-        regulatoryContext: { jurisdiction: 'EU' },
-      },
-      question: 'Should I buy now?',
-    });
-    // demo handler echoes question; question includes forbidden phrase \"buy\"
-    expect(result.refused).toBeTrue();
-    expect(result.refusalReason).toBe('SCOPE_VIOLATION');
-  });
+	it('blocks education_only answers that include buy/sell language', async () => {
+		const handlers = createDemoAssistantHandlers();
+		const result = await handlers.answer({
+			envelope: {
+				traceId: 't3',
+				locale: 'en-GB',
+				kbSnapshotId: 'snap_1',
+				allowedScope: 'education_only',
+				regulatoryContext: { jurisdiction: 'EU' },
+			},
+			question: 'Should I buy now?',
+		});
+		// demo handler echoes question; question includes forbidden phrase \"buy\"
+		expect(result.refused).toBeTrue();
+		expect(result.refusalReason).toBe('SCOPE_VIOLATION');
+	});
 });

package/src/handlers/demo.handlers.ts

@@ -1,51 +1,51 @@
 import {
-  enforceAllowedScope,
-  enforceCitations,
-  validateEnvelope,
+	enforceAllowedScope,
+	enforceCitations,
+	validateEnvelope,
 } from '../policy/guard';
 
 type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
 
 interface AssistantAnswerIR {
-  locale: string;
-  jurisdiction: string;
-  allowedScope: AllowedScope;
-  sections: { heading: string; body: string }[];
-  citations: {
-    kbSnapshotId: string;
-    sourceType: string;
-    sourceId: string;
-    title?: string;
-    excerpt?: string;
-  }[];
-  disclaimers?: string[];
-  riskFlags?: string[];
-  refused?: boolean;
-  refusalReason?: string;
+	locale: string;
+	jurisdiction: string;
+	allowedScope: AllowedScope;
+	sections: { heading: string; body: string }[];
+	citations: {
+		kbSnapshotId: string;
+		sourceType: string;
+		sourceId: string;
+		title?: string;
+		excerpt?: string;
+	}[];
+	disclaimers?: string[];
+	riskFlags?: string[];
+	refused?: boolean;
+	refusalReason?: string;
 }
 
 export interface DemoAssistantHandlers {
-  answer(input: {
-    envelope: {
-      traceId: string;
-      locale: string;
-      kbSnapshotId: string;
-      allowedScope: AllowedScope;
-      regulatoryContext: { jurisdiction: string };
-    };
-    question: string;
-  }): Promise<AssistantAnswerIR>;
+	answer(input: {
+		envelope: {
+			traceId: string;
+			locale: string;
+			kbSnapshotId: string;
+			allowedScope: AllowedScope;
+			regulatoryContext: { jurisdiction: string };
+		};
+		question: string;
+	}): Promise<AssistantAnswerIR>;
 
-  explainConcept(input: {
-    envelope: {
-      traceId: string;
-      locale: string;
-      kbSnapshotId: string;
-      allowedScope: AllowedScope;
-      regulatoryContext: { jurisdiction: string };
-    };
-    conceptKey: string;
-  }): Promise<AssistantAnswerIR>;
+	explainConcept(input: {
+		envelope: {
+			traceId: string;
+			locale: string;
+			kbSnapshotId: string;
+			allowedScope: AllowedScope;
+			regulatoryContext: { jurisdiction: string };
+		};
+		conceptKey: string;
+	}): Promise<AssistantAnswerIR>;
 }
 
 /**
@@ -56,105 +56,105 @@ export interface DemoAssistantHandlers {
  * - Enforces allowedScope (education_only blocks actionable language)
  */
 export function createDemoAssistantHandlers(): DemoAssistantHandlers {
-  async function answer(input: {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any
-      ? A extends { envelope: infer E }
-        ? E
-        : never
-      : never;
-    question: string;
-  }): Promise<AssistantAnswerIR> {
-    const env = validateEnvelope(input.envelope);
-    if (!env.ok) {
-      return {
-        locale: input.envelope.locale ?? 'en-US',
-        jurisdiction:
-          input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
-        allowedScope: input.envelope.allowedScope ?? 'education_only',
-        sections: [
-          {
-            heading: 'Request blocked',
-            body: env.error.message,
-          },
-        ],
-        citations: [],
-        disclaimers: [
-          'This system refuses to answer without a valid envelope.',
-        ],
-        riskFlags: [env.error.code],
-        refused: true,
-        refusalReason: env.error.code,
-      };
-    }
+	async function answer(input: {
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any
+			? A extends { envelope: infer E }
+				? E
+				: never
+			: never;
+		question: string;
+	}): Promise<AssistantAnswerIR> {
+		const env = validateEnvelope(input.envelope);
+		if (!env.ok) {
+			return {
+				locale: input.envelope.locale ?? 'en-US',
+				jurisdiction:
+					input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
+				allowedScope: input.envelope.allowedScope ?? 'education_only',
+				sections: [
+					{
+						heading: 'Request blocked',
+						body: env.error.message,
+					},
+				],
+				citations: [],
+				disclaimers: [
+					'This system refuses to answer without a valid envelope.',
+				],
+				riskFlags: [env.error.code],
+				refused: true,
+				refusalReason: env.error.code,
+			};
+		}
 
-    const draft: AssistantAnswerIR = {
-      locale: env.value.locale,
-      jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
-      allowedScope: env.value.allowedScope ?? 'education_only',
-      sections: [
-        {
-          heading: 'Answer (demo)',
-          body: `You asked: "${input.question}". This demo answer is derived from the KB snapshot only.`,
-        },
-      ],
-      citations: [
-        {
-          kbSnapshotId: env.value.kbSnapshotId ?? 'unknown',
-          sourceType: 'ruleVersion',
-          sourceId: 'rv_demo',
-          title: 'Demo rule version',
-          excerpt: 'Demo excerpt',
-        },
-      ],
-      disclaimers: ['Educational demo only.'],
-      riskFlags: [],
-    };
+		const draft: AssistantAnswerIR = {
+			locale: env.value.locale,
+			jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
+			allowedScope: env.value.allowedScope ?? 'education_only',
+			sections: [
+				{
+					heading: 'Answer (demo)',
+					body: `You asked: "${input.question}". This demo answer is derived from the KB snapshot only.`,
+				},
+			],
+			citations: [
+				{
+					kbSnapshotId: env.value.kbSnapshotId ?? 'unknown',
+					sourceType: 'ruleVersion',
+					sourceId: 'rv_demo',
+					title: 'Demo rule version',
+					excerpt: 'Demo excerpt',
+				},
+			],
+			disclaimers: ['Educational demo only.'],
+			riskFlags: [],
+		};
 
-    const scope = enforceAllowedScope(env.value.allowedScope, draft);
-    if (!scope.ok) {
-      return {
-        ...draft,
-        sections: [
-          { heading: 'Escalation required', body: scope.error.message },
-        ],
-        citations: draft.citations,
-        refused: true,
-        refusalReason: scope.error.code,
-        riskFlags: [...(draft.riskFlags ?? []), scope.error.code],
-      };
-    }
+		const scope = enforceAllowedScope(env.value.allowedScope, draft);
+		if (!scope.ok) {
+			return {
+				...draft,
+				sections: [
+					{ heading: 'Escalation required', body: scope.error.message },
+				],
+				citations: draft.citations,
+				refused: true,
+				refusalReason: scope.error.code,
+				riskFlags: [...(draft.riskFlags ?? []), scope.error.code],
+			};
+		}
 
-    const cited = enforceCitations(draft);
-    if (!cited.ok) {
-      return {
-        ...draft,
-        sections: [{ heading: 'Request blocked', body: cited.error.message }],
-        citations: [],
-        refused: true,
-        refusalReason: cited.error.code,
-        riskFlags: [...(draft.riskFlags ?? []), cited.error.code],
-      };
-    }
+		const cited = enforceCitations(draft);
+		if (!cited.ok) {
+			return {
+				...draft,
+				sections: [{ heading: 'Request blocked', body: cited.error.message }],
+				citations: [],
+				refused: true,
+				refusalReason: cited.error.code,
+				riskFlags: [...(draft.riskFlags ?? []), cited.error.code],
+			};
+		}
 
-    return draft;
-  }
+		return draft;
+	}
 
-  async function explainConcept(input: {
-    envelope: DemoAssistantHandlers['explainConcept'] extends (
-      a: infer A
-    ) => any // eslint-disable-line @typescript-eslint/no-explicit-any
-      ? A extends { envelope: infer E }
-        ? E
-        : never
-      : never;
-    conceptKey: string;
-  }): Promise<AssistantAnswerIR> {
-    return await answer({
-      envelope: input.envelope,
-      question: `Explain concept: ${input.conceptKey}`,
-    });
-  }
+	async function explainConcept(input: {
+		envelope: DemoAssistantHandlers['explainConcept'] extends (
+			a: infer A
+		) => any // eslint-disable-line @typescript-eslint/no-explicit-any
+			? A extends { envelope: infer E }
+				? E
+				: never
+			: never;
+		conceptKey: string;
+	}): Promise<AssistantAnswerIR> {
+		return await answer({
+			envelope: input.envelope,
+			question: `Explain concept: ${input.conceptKey}`,
+		});
+	}
 
-  return { answer, explainConcept };
+	return { answer, explainConcept };
 }

package/src/index.ts

@@ -5,11 +5,11 @@
  * allowedScope must be explicit, and answers must cite a KB snapshot.
  */
 export * from './entities';
-export * from './operations';
 export * from './events';
-export * from './policy';
+export { default as example } from './example';
 export * from './handlers';
 export * from './locale-jurisdiction-gate.feature';
-export { default as example } from './example';
+export * from './operations';
+export * from './policy';
 
 import './docs';

package/src/locale-jurisdiction-gate.feature.ts

@@ -1,41 +1,41 @@
 import { defineFeature } from '@contractspec/lib.contracts-spec';
 
 export const 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' }],
-  },
+	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: 'locale-jurisdiction-gate.policy.gate', version: '1.0.0' }],
+	policies: [{ key: 'locale-jurisdiction-gate.policy.gate', version: '1.0.0' }],
 
-  knowledge: [
-    { key: 'locale-jurisdiction-gate.knowledge.rules', 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',
-  ],
+	docs: [
+		'docs.examples.locale-jurisdiction-gate.goal',
+		'docs.examples.locale-jurisdiction-gate.reference',
+	],
 });