@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251213172311 → 0.0.0-canary-20251215231151

package/.turbo/turbo-build.log

@@ -1,8 +1,8 @@
 $ bun build:bundle && bun build:types
 $ tsdown
-ℹ tsdown v0.17.0 powered by rolldown v1.0.0-beta.53
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/locale-jurisdiction-gate/tsdown.config.js 
-ℹ entry: src/events.ts, src/example.ts, src/feature.ts, src/index.ts, src/docs/index.ts, src/docs/locale-jurisdiction-gate.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/contracts/assistant.ts, src/contracts/index.ts, src/handlers/demo.handlers.ts, src/handlers/index.ts, src/policy/guard.ts, src/policy/index.ts, src/policy/types.ts
+ℹ entry: src/events.ts, src/example.ts, src/feature.ts, src/index.ts, src/contracts/assistant.ts, src/contracts/index.ts, src/docs/index.ts, src/docs/locale-jurisdiction-gate.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/handlers/demo.handlers.ts, src/handlers/index.ts, src/policy/guard.ts, src/policy/index.ts, src/policy/types.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
@@ -22,5 +22,5 @@ $ tsdown
 ℹ dist/docs/index.js                              0.05 kB │ gzip: 0.07 kB
 ℹ dist/policy/types.js                            0.00 kB │ gzip: 0.02 kB
 ℹ 15 files, total: 14.27 kB
-✔ Build complete in 64ms
+✔ Build complete in 42ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,9 +1,9 @@
 # @lssm/example.locale-jurisdiction-gate
 
-## 0.0.0-canary-20251213172311
+## 0.0.0-canary-20251215231151
 
 ### Patch Changes
 
 - Updated dependencies [3086383]
-  - @lssm/lib.contracts@0.0.0-canary-20251213172311
-  - @lssm/lib.schema@0.0.0-canary-20251213172311
+  - @lssm/lib.contracts@0.0.0-canary-20251215231151
+  - @lssm/lib.schema@0.0.0-canary-20251215231151

package/README.md

@@ -29,3 +29,4 @@ bun test
 ```
 
 
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.locale-jurisdiction-gate",
-  "version": "0.0.0-canary-20251213172311",
+  "version": "0.0.0-canary-20251215231151",
   "description": "Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,7 +43,7 @@
   "devDependencies": {
     "@lssm/tool.tsdown": "workspace:*",
     "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.0",
+    "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "publishConfig": {

package/src/contracts/assistant.ts

@@ -1,7 +1,10 @@
 import { defineCommand } from '@lssm/lib.contracts';
 import { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';
 
-import { AssistantAnswerIRModel, LLMCallEnvelopeModel } from '../entities/models';
+import {
+  AssistantAnswerIRModel,
+  LLMCallEnvelopeModel,
+} from '../entities/models';
 
 const AssistantQuestionInput = defineSchemaModel({
   name: 'AssistantQuestionInput',
@@ -63,7 +66,8 @@ export const AssistantAnswerContract = defineCommand({
         when: 'answer has no citations',
       },
       SCOPE_VIOLATION: {
-        description: 'Answer violates allowed scope and must be refused/escalated',
+        description:
+          'Answer violates allowed scope and must be refused/escalated',
         http: 403,
         gqlCode: 'SCOPE_VIOLATION',
         when: 'output includes forbidden content under the given allowedScope',
@@ -92,5 +96,3 @@ export const AssistantExplainConceptContract = defineCommand({
   },
   policy: { auth: 'user' },
 });
-
-

package/src/contracts/index.ts

@@ -1,3 +1 @@
 export * from './assistant';
-
-

package/src/docs/index.ts

@@ -1,3 +1 @@
 import './locale-jurisdiction-gate.docblock';
-
-

package/src/docs/locale-jurisdiction-gate.docblock.ts

@@ -44,5 +44,3 @@ const docBlocks: DocBlock[] = [
 ];
 
 registerDocBlocks(docBlocks);
-
-

package/src/entities/index.ts

@@ -1,3 +1 @@
 export * from './models';
-
-

package/src/entities/models.ts

@@ -1,4 +1,8 @@
-import { ScalarTypeEnum, defineEnum, defineSchemaModel } from '@lssm/lib.schema';
+import {
+  ScalarTypeEnum,
+  defineEnum,
+  defineSchemaModel,
+} from '@lssm/lib.schema';
 
 export const AllowedScopeEnum = defineEnum('AllowedScope', [
   'education_only',
@@ -10,8 +14,14 @@ export const 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 },
+    preferredLocale: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true,
+    },
+    residencyCountry: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true,
+    },
     taxResidenceCountry: {
       type: ScalarTypeEnum.String_unsecure(),
       isOptional: true,
@@ -46,7 +56,8 @@ export const LLMCallEnvelopeModel = defineSchemaModel({
 
 export const AssistantCitationModel = defineSchemaModel({
   name: 'AssistantCitation',
-  description: 'Citation referencing a KB snapshot + a specific item within it.',
+  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 },
@@ -97,5 +108,3 @@ export const AssistantAnswerIRModel = defineSchemaModel({
     refusalReason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
   },
 });
-
-

package/src/events.ts

@@ -57,5 +57,3 @@ export const AssistantAnswerDeliveredEvent = defineEvent({
     'Assistant answer delivered (must include KB snapshot citations).',
   payload: AssistantAnswerDeliveredPayload,
 });
-
-

package/src/example.ts

@@ -25,5 +25,3 @@ const example = {
 } as const;
 
 export default example;
-
-

package/src/feature.ts

@@ -27,5 +27,3 @@ export const LocaleJurisdictionGateFeature: FeatureModuleSpec = {
     requires: [{ key: 'knowledge', version: 1 }],
   },
 };
-
-

package/src/handlers/demo.handlers.ts

@@ -1,24 +1,28 @@
-import { enforceAllowedScope, enforceCitations, validateEnvelope } from '../policy/guard';
+import {
+  enforceAllowedScope,
+  enforceCitations,
+  validateEnvelope,
+} from '../policy/guard';
 
 type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
 
-type AssistantAnswerIR = {
+interface AssistantAnswerIR {
   locale: string;
   jurisdiction: string;
   allowedScope: AllowedScope;
-  sections: Array<{ heading: string; body: string }>;
-  citations: Array<{
+  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: {
@@ -64,7 +68,8 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
     if (!env.ok) {
       return {
         locale: input.envelope.locale ?? 'en-US',
-        jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
+        jurisdiction:
+          input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
         allowedScope: input.envelope.allowedScope ?? 'education_only',
         sections: [
           {
@@ -73,7 +78,9 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
           },
         ],
         citations: [],
-        disclaimers: ['This system refuses to answer without a valid envelope.'],
+        disclaimers: [
+          'This system refuses to answer without a valid envelope.',
+        ],
         riskFlags: [env.error.code],
         refused: true,
         refusalReason: env.error.code,
@@ -121,9 +128,7 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
     if (!cited.ok) {
       return {
         ...draft,
-        sections: [
-          { heading: 'Request blocked', body: cited.error.message },
-        ],
+        sections: [{ heading: 'Request blocked', body: cited.error.message }],
         citations: [],
         refused: true,
         refusalReason: cited.error.code,
@@ -135,7 +140,9 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
   }
 
   async function explainConcept(input: {
-    envelope: DemoAssistantHandlers['explainConcept'] extends (a: infer A) => any
+    envelope: DemoAssistantHandlers['explainConcept'] extends (
+      a: infer A
+    ) => any
       ? A extends { envelope: infer E }
         ? E
         : never
@@ -150,5 +157,3 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
 
   return { answer, explainConcept };
 }
-
-

package/src/handlers/index.ts

@@ -1,3 +1 @@
 export * from './demo.handlers';
-
-

package/src/index.ts

@@ -13,5 +13,3 @@ export * from './feature';
 export { default as example } from './example';
 
 import './docs';
-
-

package/src/policy/guard.test.ts

@@ -23,5 +23,3 @@ describe('locale/jurisdiction gate policy', () => {
     if (!result.ok) expect(result.error.code).toBe('CITATIONS_REQUIRED');
   });
 });
-
-

package/src/policy/guard.ts

@@ -1,19 +1,19 @@
 import type { GateError, GateResult } from './types';
 
-type EnvelopeLike = {
+interface EnvelopeLike {
   locale?: string;
   kbSnapshotId?: string;
   allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
   regulatoryContext?: { jurisdiction?: string };
-};
+}
 
-type AnswerLike = {
+interface AnswerLike {
   citations?: unknown[];
-  sections?: Array<{ heading: string; body: string }>;
+  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']);
 
@@ -31,7 +31,10 @@ export function validateEnvelope(
     };
   }
   if (!envelope.regulatoryContext?.jurisdiction) {
-    return { ok: false, error: err('JURISDICTION_REQUIRED', 'jurisdiction is required') };
+    return {
+      ok: false,
+      error: err('JURISDICTION_REQUIRED', 'jurisdiction is required'),
+    };
   }
   if (!envelope.kbSnapshotId) {
     return {
@@ -53,7 +56,10 @@ export function enforceCitations(answer: AnswerLike): GateResult<AnswerLike> {
   if (!Array.isArray(citations) || citations.length === 0) {
     return {
       ok: false,
-      error: err('CITATIONS_REQUIRED', 'answers must include at least one citation'),
+      error: err(
+        'CITATIONS_REQUIRED',
+        'answers must include at least one citation'
+      ),
     };
   }
   return { ok: true, value: answer };
@@ -80,7 +86,9 @@ export function enforceAllowedScope(
   }
 
   const bodies = (answer.sections ?? []).map((s) => s.body).join('\n');
-  const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) => re.test(bodies));
+  const violations = EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) =>
+    re.test(bodies)
+  );
   if (violations) {
     return {
       ok: false,
@@ -92,5 +100,3 @@ export function enforceAllowedScope(
   }
   return { ok: true, value: answer };
 }
-
-

package/src/policy/index.ts

@@ -1,4 +1,2 @@
 export * from './types';
 export * from './guard';
-
-

package/src/policy/types.ts

@@ -1,4 +1,7 @@
-export type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+export type AllowedScope =
+  | 'education_only'
+  | 'generic_info'
+  | 'escalation_required';
 
 export interface GateError {
   code:
@@ -13,5 +16,3 @@ export interface GateError {
 export type GateResult<T> =
   | { ok: true; value: T }
   | { ok: false; error: GateError };
-
-

package/tsconfig.json

@@ -7,3 +7,4 @@
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]
 }
+