@contractspec/example.policy-safe-knowledge-assistant 1.44.0

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'policy-safe-knowledge-assistant',\n  title: 'Policy-safe Knowledge Assistant',\n  summary:\n    'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',\n  tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n  kind: 'template',\n  visibility: 'public',\n  docs: {\n    goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',\n    usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.policy-safe-knowledge-assistant',\n    feature: './feature',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAa;EAAa;EAAU;EAAQ;EAAW;CAC9D,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/feature.d.ts

@@ -0,0 +1,7 @@
+import { FeatureModuleSpec } from "@contractspec/lib.contracts";
+
+//#region src/feature.d.ts
+declare const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec;
+//#endregion
+export { PolicySafeKnowledgeAssistantFeature };
+//# sourceMappingURL=feature.d.ts.map

package/dist/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","names":[],"sources":["../src/feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,qCAAqC"}

package/dist/feature.js

@@ -0,0 +1,148 @@
+//#region src/feature.ts
+const PolicySafeKnowledgeAssistantFeature = {
+	meta: {
+		key: "policy-safe-knowledge-assistant",
+		version: 1,
+		title: "Policy-safe Knowledge Assistant",
+		description: "All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.",
+		domain: "knowledge",
+		owners: ["@examples"],
+		tags: [
+			"assistant",
+			"knowledge",
+			"policy",
+			"hitl",
+			"learning"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "assistant.answer",
+			version: 1
+		},
+		{
+			key: "assistant.explainConcept",
+			version: 1
+		},
+		{
+			key: "kb.ingestSource",
+			version: 1
+		},
+		{
+			key: "kb.upsertRuleVersion",
+			version: 1
+		},
+		{
+			key: "kb.approveRuleVersion",
+			version: 1
+		},
+		{
+			key: "kb.publishSnapshot",
+			version: 1
+		},
+		{
+			key: "kb.search",
+			version: 1
+		},
+		{
+			key: "kbPipeline.runWatch",
+			version: 1
+		},
+		{
+			key: "kbPipeline.createReviewTask",
+			version: 1
+		},
+		{
+			key: "kbPipeline.submitDecision",
+			version: 1
+		},
+		{
+			key: "kbPipeline.publishIfReady",
+			version: 1
+		}
+	],
+	events: [
+		{
+			key: "assistant.answer.requested",
+			version: 1
+		},
+		{
+			key: "assistant.answer.blocked",
+			version: 1
+		},
+		{
+			key: "assistant.answer.delivered",
+			version: 1
+		},
+		{
+			key: "kb.source.ingested",
+			version: 1
+		},
+		{
+			key: "kb.ruleVersion.created",
+			version: 1
+		},
+		{
+			key: "kb.ruleVersion.approved",
+			version: 1
+		},
+		{
+			key: "kb.snapshot.published",
+			version: 1
+		},
+		{
+			key: "kb.change.detected",
+			version: 1
+		},
+		{
+			key: "kb.review.requested",
+			version: 1
+		},
+		{
+			key: "kb.review.decided",
+			version: 1
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: 1
+		},
+		{
+			key: "audit-trail",
+			version: 1
+		},
+		{
+			key: "notifications",
+			version: 1
+		},
+		{
+			key: "jobs",
+			version: 1
+		},
+		{
+			key: "feature-flags",
+			version: 1
+		},
+		{
+			key: "files",
+			version: 1
+		},
+		{
+			key: "metering",
+			version: 1
+		},
+		{
+			key: "learning-journey",
+			version: 1
+		}
+	] }
+};
+
+//#endregion
+export { PolicySafeKnowledgeAssistantFeature };
+//# sourceMappingURL=feature.js.map

package/dist/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","names":["PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec"],"sources":["../src/feature.ts"],"sourcesContent":["import type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\nexport const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'policy-safe-knowledge-assistant',\n    version: 1,\n    title: 'Policy-safe Knowledge Assistant',\n    description:\n      'All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n    stability: 'experimental',\n  },\n  operations: [\n    // Gate\n    { key: 'assistant.answer', version: 1 },\n    { key: 'assistant.explainConcept', version: 1 },\n    // KB\n    { key: 'kb.ingestSource', version: 1 },\n    { key: 'kb.upsertRuleVersion', version: 1 },\n    { key: 'kb.approveRuleVersion', version: 1 },\n    { key: 'kb.publishSnapshot', version: 1 },\n    { key: 'kb.search', version: 1 },\n    // Pipeline\n    { key: 'kbPipeline.runWatch', version: 1 },\n    { key: 'kbPipeline.createReviewTask', version: 1 },\n    { key: 'kbPipeline.submitDecision', version: 1 },\n    { key: 'kbPipeline.publishIfReady', version: 1 },\n  ],\n  events: [\n    { key: 'assistant.answer.requested', version: 1 },\n    { key: 'assistant.answer.blocked', version: 1 },\n    { key: 'assistant.answer.delivered', version: 1 },\n    { key: 'kb.source.ingested', version: 1 },\n    { key: 'kb.ruleVersion.created', version: 1 },\n    { key: 'kb.ruleVersion.approved', version: 1 },\n    { key: 'kb.snapshot.published', version: 1 },\n    { key: 'kb.change.detected', version: 1 },\n    { key: 'kb.review.requested', version: 1 },\n    { key: 'kb.review.decided', version: 1 },\n  ],\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n  capabilities: {\n    requires: [\n      { key: 'identity', version: 1 },\n      { key: 'audit-trail', version: 1 },\n      { key: 'notifications', version: 1 },\n      { key: 'jobs', version: 1 },\n      { key: 'feature-flags', version: 1 },\n      { key: 'files', version: 1 },\n      { key: 'metering', version: 1 },\n      { key: 'learning-journey', version: 1 },\n    ],\n  },\n};\n"],"mappings":";AAEA,MAAaA,sCAAyD;CACpE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAa;GAAU;GAAQ;GAAW;EAC9D,WAAW;EACZ;CACD,YAAY;EAEV;GAAE,KAAK;GAAoB,SAAS;GAAG;EACvC;GAAE,KAAK;GAA4B,SAAS;GAAG;EAE/C;GAAE,KAAK;GAAmB,SAAS;GAAG;EACtC;GAAE,KAAK;GAAwB,SAAS;GAAG;EAC3C;GAAE,KAAK;GAAyB,SAAS;GAAG;EAC5C;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAa,SAAS;GAAG;EAEhC;GAAE,KAAK;GAAuB,SAAS;GAAG;EAC1C;GAAE,KAAK;GAA+B,SAAS;GAAG;EAClD;GAAE,KAAK;GAA6B,SAAS;GAAG;EAChD;GAAE,KAAK;GAA6B,SAAS;GAAG;EACjD;CACD,QAAQ;EACN;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAA0B,SAAS;GAAG;EAC7C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAC9C;GAAE,KAAK;GAAyB,SAAS;GAAG;EAC5C;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAuB,SAAS;GAAG;EAC1C;GAAE,KAAK;GAAqB,SAAS;GAAG;EACzC;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAe,SAAS;GAAG;EAClC;GAAE,KAAK;GAAiB,SAAS;GAAG;EACpC;GAAE,KAAK;GAAQ,SAAS;GAAG;EAC3B;GAAE,KAAK;GAAiB,SAAS;GAAG;EACpC;GAAE,KAAK;GAAS,SAAS;GAAG;EAC5B;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAoB,SAAS;GAAG;EACxC,EACF;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import example from "./example.js";
+import { PolicySafeKnowledgeAssistantFeature } from "./feature.js";
+import { DEMO_FIXTURES } from "./seed/fixtures.js";
+import { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer } from "./orchestrator/buildAnswer.js";
+export { AssistantAnswerIR, BuildAnswerInput, DEMO_FIXTURES, PolicySafeKnowledgeAssistantFeature, buildPolicySafeAnswer, example };

package/dist/index.js

@@ -0,0 +1,7 @@
+import example_default from "./example.js";
+import { PolicySafeKnowledgeAssistantFeature } from "./feature.js";
+import { DEMO_FIXTURES } from "./seed/fixtures.js";
+import { buildPolicySafeAnswer } from "./orchestrator/buildAnswer.js";
+import "./docs/index.js";
+
+export { DEMO_FIXTURES, PolicySafeKnowledgeAssistantFeature, buildPolicySafeAnswer, example_default as example };

package/dist/orchestrator/buildAnswer.d.ts

@@ -0,0 +1,53 @@
+//#region src/orchestrator/buildAnswer.d.ts
+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;
+}
+interface BuildAnswerInput {
+  envelope: {
+    traceId: string;
+    locale: string;
+    kbSnapshotId: string;
+    allowedScope: AllowedScope;
+    regulatoryContext: {
+      jurisdiction: string;
+    };
+  };
+  question: string;
+  kbSearch: (input: {
+    snapshotId: string;
+    jurisdiction: string;
+    query: string;
+  }) => Promise<{
+    items: {
+      ruleVersionId: string;
+      excerpt?: string;
+    }[];
+  }>;
+}
+/**
+ * Build a policy-safe assistant answer derived from KB search results.
+ *
+ * Deterministic: no LLM calls; if search yields no results, it refuses.
+ */
+declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
+//#endregion
+export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };
+//# sourceMappingURL=buildAnswer.d.ts.map

package/dist/orchestrator/buildAnswer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.d.ts","names":[],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":[],"mappings":";KAMK,YAAA;AAAA,UAEY,iBAAA,CAFA;EAEA,MAAA,EAAA,MAAA;EAkBA,YAAA,EAAA,MAAgB;EAqBX,YAAA,EApCN,YAoC2B;EAClC,QAAA,EAAA;IACE,OAAA,EAAA,MAAA;IAAR,IAAA,EAAA,MAAA;EAAO,CAAA,EAAA;;;;;;;;;;;;;UAvBO,gBAAA;;;;;kBAKC;;;;;;;;;;QAQV;;;;;;;;;;;;iBAQc,qBAAA,QACb,mBACN,QAAQ"}

package/dist/orchestrator/buildAnswer.js

@@ -0,0 +1,77 @@
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "@contractspec/example.locale-jurisdiction-gate/policy/guard";
+
+//#region src/orchestrator/buildAnswer.ts
+/**
+* Build a policy-safe assistant answer derived from KB search results.
+*
+* Deterministic: no LLM calls; if search yields no results, it refuses.
+*/
+async function buildPolicySafeAnswer(input) {
+	const env = validateEnvelope(input.envelope);
+	if (!env.ok) return {
+		locale: input.envelope.locale ?? "en-GB",
+		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 results = await input.kbSearch({
+		snapshotId: env.value.kbSnapshotId,
+		jurisdiction: env.value.regulatoryContext?.jurisdiction ?? "UNKNOWN",
+		query: input.question
+	});
+	const citations = results.items.map((item) => ({
+		kbSnapshotId: env.value.kbSnapshotId,
+		sourceType: "ruleVersion",
+		sourceId: item.ruleVersionId,
+		title: "Curated rule version",
+		excerpt: item.excerpt
+	}));
+	const draft = {
+		locale: env.value.locale,
+		jurisdiction: env.value.regulatoryContext?.jurisdiction ?? "UNKNOWN",
+		allowedScope: env.value.allowedScope,
+		sections: [{
+			heading: "Answer (KB-derived)",
+			body: results.items.length > 0 ? `This answer is derived from ${results.items.length} curated rule version(s) in the referenced snapshot.` : "No curated knowledge found in the referenced snapshot."
+		}],
+		citations,
+		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
+		}],
+		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]
+	};
+	return draft;
+}
+
+//#endregion
+export { buildPolicySafeAnswer };
+//# sourceMappingURL=buildAnswer.js.map

package/dist/orchestrator/buildAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '@contractspec/example.locale-jurisdiction-gate/policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\nexport interface AssistantAnswerIR {\n  locale: string;\n  jurisdiction: string;\n  allowedScope: AllowedScope;\n  sections: { heading: string; body: string }[];\n  citations: {\n    kbSnapshotId: string;\n    sourceType: string;\n    sourceId: string;\n    title?: string;\n    excerpt?: string;\n  }[];\n  disclaimers?: string[];\n  riskFlags?: string[];\n  refused?: boolean;\n  refusalReason?: string;\n}\n\nexport interface BuildAnswerInput {\n  envelope: {\n    traceId: string;\n    locale: string;\n    kbSnapshotId: string;\n    allowedScope: AllowedScope;\n    regulatoryContext: { jurisdiction: string };\n  };\n  question: string;\n  kbSearch: (input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }) => Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;\n}\n\n/**\n * Build a policy-safe assistant answer derived from KB search results.\n *\n * Deterministic: no LLM calls; if search yields no results, it refuses.\n */\nexport async function buildPolicySafeAnswer(\n  input: BuildAnswerInput\n): Promise<AssistantAnswerIR> {\n  const env = validateEnvelope(input.envelope);\n  if (!env.ok) {\n    return {\n      locale: input.envelope.locale ?? 'en-GB',\n      jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n      allowedScope: input.envelope.allowedScope ?? 'education_only',\n      sections: [{ heading: 'Request blocked', body: env.error.message }],\n      citations: [],\n      disclaimers: ['This system refuses to answer without a valid envelope.'],\n      riskFlags: [env.error.code],\n      refused: true,\n      refusalReason: env.error.code,\n    };\n  }\n\n  const results = await input.kbSearch({\n    snapshotId: env.value.kbSnapshotId,\n    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n    query: input.question,\n  });\n\n  const citations = results.items.map((item) => ({\n    kbSnapshotId: env.value.kbSnapshotId,\n    sourceType: 'ruleVersion',\n    sourceId: item.ruleVersionId,\n    title: 'Curated rule version',\n    excerpt: item.excerpt,\n  }));\n\n  const draft: AssistantAnswerIR = {\n    locale: env.value.locale,\n    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n    allowedScope: env.value.allowedScope,\n    sections: [\n      {\n        heading: 'Answer (KB-derived)',\n        body:\n          results.items.length > 0\n            ? `This answer is derived from ${results.items.length} curated rule version(s) in the referenced snapshot.`\n            : 'No curated knowledge found in the referenced snapshot.',\n      },\n    ],\n    citations,\n    disclaimers: ['Educational demo only.'],\n    riskFlags: [],\n  };\n\n  const scope = enforceAllowedScope(env.value.allowedScope, draft);\n  if (!scope.ok) {\n    return {\n      ...draft,\n      sections: [{ heading: 'Escalation required', body: scope.error.message }],\n      refused: true,\n      refusalReason: scope.error.code,\n      riskFlags: [...(draft.riskFlags ?? []), scope.error.code],\n    };\n  }\n\n  const cited = enforceCitations(draft);\n  if (!cited.ok) {\n    return {\n      ...draft,\n      sections: [{ heading: 'Request blocked', body: cited.error.message }],\n      citations: [],\n      refused: true,\n      refusalReason: cited.error.code,\n      riskFlags: [...(draft.riskFlags ?? []), cited.error.code],\n    };\n  }\n\n  return draft;\n}\n"],"mappings":";;;;;;;;AA+CA,eAAsB,sBACpB,OAC4B;CAC5B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,KAAI,CAAC,IAAI,GACP,QAAO;EACL,QAAQ,MAAM,SAAS,UAAU;EACjC,cAAc,MAAM,SAAS,mBAAmB,gBAAgB;EAChE,cAAc,MAAM,SAAS,gBAAgB;EAC7C,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,IAAI,MAAM;GAAS,CAAC;EACnE,WAAW,EAAE;EACb,aAAa,CAAC,0DAA0D;EACxE,WAAW,CAAC,IAAI,MAAM,KAAK;EAC3B,SAAS;EACT,eAAe,IAAI,MAAM;EAC1B;CAGH,MAAM,UAAU,MAAM,MAAM,SAAS;EACnC,YAAY,IAAI,MAAM;EACtB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;EAC3D,OAAO,MAAM;EACd,CAAC;CAEF,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;EAC7C,cAAc,IAAI,MAAM;EACxB,YAAY;EACZ,UAAU,KAAK;EACf,OAAO;EACP,SAAS,KAAK;EACf,EAAE;CAEH,MAAMA,QAA2B;EAC/B,QAAQ,IAAI,MAAM;EAClB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;EAC3D,cAAc,IAAI,MAAM;EACxB,UAAU,CACR;GACE,SAAS;GACT,MACE,QAAQ,MAAM,SAAS,IACnB,+BAA+B,QAAQ,MAAM,OAAO,wDACpD;GACP,CACF;EACD;EACA,aAAa,CAAC,yBAAyB;EACvC,WAAW,EAAE;EACd;CAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAuB,MAAM,MAAM,MAAM;GAAS,CAAC;EACzE,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;CAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,MAAM,MAAM;GAAS,CAAC;EACrE,WAAW,EAAE;EACb,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;AAGH,QAAO"}

package/dist/seed/fixtures.d.ts

@@ -0,0 +1,35 @@
+//#region src/seed/fixtures.d.ts
+declare const DEMO_FIXTURES: {
+  readonly jurisdictions: readonly ["EU", "FR"];
+  readonly locales: readonly ["en-GB", "fr-FR"];
+  readonly demoOrgId: "org_demo";
+  readonly demoUserId: "user_demo";
+  readonly sources: {
+    readonly EU_SOURCE_1: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v1";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v1";
+      readonly fileId: "file_eu_v1";
+    };
+    readonly EU_SOURCE_2: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v2";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v2";
+      readonly fileId: "file_eu_v2";
+    };
+  };
+  readonly rules: {
+    readonly EU_RULE_TAX: {
+      readonly id: "rule_eu_tax";
+      readonly jurisdiction: "EU";
+      readonly topicKey: "tax_reporting";
+    };
+  };
+};
+//#endregion
+export { DEMO_FIXTURES };
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/seed/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":[],"mappings":";cAAa;EAAA,SAAA,aA8BH,EAAA,SAAA,CAAA,IAAA,EAAA,IAAA,CAAA;;;;;;;;;0BAAA;;;;;;;;0BAAA"}

package/dist/seed/fixtures.js

@@ -0,0 +1,34 @@
+//#region src/seed/fixtures.ts
+const DEMO_FIXTURES = {
+	jurisdictions: ["EU", "FR"],
+	locales: ["en-GB", "fr-FR"],
+	demoOrgId: "org_demo",
+	demoUserId: "user_demo",
+	sources: {
+		EU_SOURCE_1: {
+			jurisdiction: "EU",
+			authority: "DemoAuthority",
+			title: "EU Demo Source v1",
+			fetchedAt: /* @__PURE__ */ new Date("2026-01-01T00:00:00.000Z"),
+			hash: "hash_eu_v1",
+			fileId: "file_eu_v1"
+		},
+		EU_SOURCE_2: {
+			jurisdiction: "EU",
+			authority: "DemoAuthority",
+			title: "EU Demo Source v2",
+			fetchedAt: /* @__PURE__ */ new Date("2026-02-01T00:00:00.000Z"),
+			hash: "hash_eu_v2",
+			fileId: "file_eu_v2"
+		}
+	},
+	rules: { EU_RULE_TAX: {
+		id: "rule_eu_tax",
+		jurisdiction: "EU",
+		topicKey: "tax_reporting"
+	} }
+};
+
+//#endregion
+export { DEMO_FIXTURES };
+//# sourceMappingURL=fixtures.js.map

package/dist/seed/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":["export const DEMO_FIXTURES = {\n  jurisdictions: ['EU', 'FR'] as const,\n  locales: ['en-GB', 'fr-FR'] as const,\n  demoOrgId: 'org_demo',\n  demoUserId: 'user_demo',\n  sources: {\n    EU_SOURCE_1: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v1',\n      fetchedAt: new Date('2026-01-01T00:00:00.000Z'),\n      hash: 'hash_eu_v1',\n      fileId: 'file_eu_v1',\n    },\n    EU_SOURCE_2: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v2',\n      fetchedAt: new Date('2026-02-01T00:00:00.000Z'),\n      hash: 'hash_eu_v2',\n      fileId: 'file_eu_v2',\n    },\n  },\n  rules: {\n    EU_RULE_TAX: {\n      id: 'rule_eu_tax',\n      jurisdiction: 'EU',\n      topicKey: 'tax_reporting',\n    },\n  },\n} as const;\n"],"mappings":";AAAA,MAAa,gBAAgB;CAC3B,eAAe,CAAC,MAAM,KAAK;CAC3B,SAAS,CAAC,SAAS,QAAQ;CAC3B,WAAW;CACX,YAAY;CACZ,SAAS;EACP,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACD,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACF;CACD,OAAO,EACL,aAAa;EACX,IAAI;EACJ,cAAc;EACd,UAAU;EACX,EACF;CACF"}

package/dist/seed/index.d.ts

@@ -0,0 +1,2 @@
+import { DEMO_FIXTURES } from "./fixtures.js";
+export { DEMO_FIXTURES };

package/dist/seed/index.js

@@ -0,0 +1,3 @@
+import { DEMO_FIXTURES } from "./fixtures.js";
+
+export { DEMO_FIXTURES };

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@contractspec/example.policy-safe-knowledge-assistant",
+  "version": "1.44.0",
+  "description": "All-in-one template example: policy-safe knowledge assistant with locale/jurisdiction gating, versioned KB snapshots, HITL update pipeline, and learning hub.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/policy-safe-knowledge-assistant.docblock": "./dist/docs/policy-safe-knowledge-assistant.docblock.js",
+    "./example": "./dist/example.js",
+    "./feature": "./dist/feature.js",
+    "./orchestrator/buildAnswer": "./dist/orchestrator/buildAnswer.js",
+    "./seed": "./dist/seed/index.js",
+    "./seed/fixtures": "./dist/seed/fixtures.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/example.locale-jurisdiction-gate": "1.44.0",
+    "@contractspec/example.versioned-knowledge-base": "1.44.0",
+    "@contractspec/example.kb-update-pipeline": "1.44.0",
+    "@contractspec/example.learning-patterns": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.identity-rbac": "1.44.0",
+    "@contractspec/lib.jobs": "1.44.0",
+    "@contractspec/lib.feature-flags": "1.44.0",
+    "@contractspec/lib.files": "1.44.0",
+    "@contractspec/lib.metering": "1.44.0",
+    "@contractspec/module.audit-trail": "1.44.0",
+    "@contractspec/module.notifications": "1.44.0",
+    "@contractspec/module.learning-journey": "1.44.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/policy-safe-knowledge-assistant.docblock": "./dist/docs/policy-safe-knowledge-assistant.docblock.js",
+      "./example": "./dist/example.js",
+      "./feature": "./dist/feature.js",
+      "./orchestrator/buildAnswer": "./dist/orchestrator/buildAnswer.js",
+      "./seed": "./dist/seed/index.js",
+      "./seed/fixtures": "./dist/seed/fixtures.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/policy-safe-knowledge-assistant"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './policy-safe-knowledge-assistant.docblock';

package/src/docs/policy-safe-knowledge-assistant.docblock.ts

@@ -0,0 +1,28 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const docBlocks: DocBlock[] = [
+  {
+    id: 'docs.examples.policy-safe-knowledge-assistant.goal',
+    title: 'Policy-safe Knowledge Assistant — Goal',
+    summary:
+      'End-to-end example: versioned KB snapshots + locale/jurisdiction gating + HITL pipeline + learning hub.',
+    kind: 'goal',
+    visibility: 'public',
+    route: '/docs/examples/policy-safe-knowledge-assistant/goal',
+    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
+    body: `## What this template proves\n- Assistant answers are structured and must cite a KB snapshot (or refuse).\n- Locale + jurisdiction are mandatory inputs for every assistant call.\n- Automation proposes KB patches; humans verify; publishing stays blocked until approvals.\n- Learning hub demonstrates drills + coaching + quests without spam.\n\n## Offline-first\n- Seeded fixtures are deterministic and require no external services.\n- Optional non-authoritative fallback can be added behind a single feature flag (disabled by default).`,
+  },
+  {
+    id: 'docs.examples.policy-safe-knowledge-assistant.usage',
+    title: 'Policy-safe Knowledge Assistant — Usage',
+    summary: '5–10 minute sandbox walkthrough for developers.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/policy-safe-knowledge-assistant/usage',
+    tags: ['assistant', 'knowledge', 'usage'],
+    body: `## Demo walkthrough (high level)\n1) Onboard: set locale + jurisdiction.\n2) Publish snapshot: ingest source -> propose rule -> approve -> publish.\n3) Ask assistant: must pass gate and cite snapshot.\n4) Simulate change: watcher -> review -> publish new snapshot.\n5) Learning hub: drills session, ambient tip, quest start + step completion.`,
+  },
+];
+
+registerDocBlocks(docBlocks);

package/src/example.ts

@@ -0,0 +1,29 @@
+const example = {
+  id: 'policy-safe-knowledge-assistant',
+  title: 'Policy-safe Knowledge Assistant',
+  summary:
+    'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',
+  tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
+  kind: 'template',
+  visibility: 'public',
+  docs: {
+    goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',
+    usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.policy-safe-knowledge-assistant',
+    feature: './feature',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: {
+      enabled: true,
+      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
+    },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;

package/src/feature.ts

@@ -0,0 +1,58 @@
+import type { FeatureModuleSpec } from '@contractspec/lib.contracts';
+
+export const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec = {
+  meta: {
+    key: 'policy-safe-knowledge-assistant',
+    version: 1,
+    title: 'Policy-safe Knowledge Assistant',
+    description:
+      'All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.',
+    domain: 'knowledge',
+    owners: ['@examples'],
+    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
+    stability: 'experimental',
+  },
+  operations: [
+    // Gate
+    { key: 'assistant.answer', version: 1 },
+    { key: 'assistant.explainConcept', version: 1 },
+    // KB
+    { key: 'kb.ingestSource', version: 1 },
+    { key: 'kb.upsertRuleVersion', version: 1 },
+    { key: 'kb.approveRuleVersion', version: 1 },
+    { key: 'kb.publishSnapshot', version: 1 },
+    { key: 'kb.search', version: 1 },
+    // Pipeline
+    { key: 'kbPipeline.runWatch', version: 1 },
+    { key: 'kbPipeline.createReviewTask', version: 1 },
+    { key: 'kbPipeline.submitDecision', version: 1 },
+    { key: 'kbPipeline.publishIfReady', version: 1 },
+  ],
+  events: [
+    { key: 'assistant.answer.requested', version: 1 },
+    { key: 'assistant.answer.blocked', version: 1 },
+    { key: 'assistant.answer.delivered', version: 1 },
+    { key: 'kb.source.ingested', version: 1 },
+    { key: 'kb.ruleVersion.created', version: 1 },
+    { key: 'kb.ruleVersion.approved', version: 1 },
+    { key: 'kb.snapshot.published', version: 1 },
+    { key: 'kb.change.detected', version: 1 },
+    { key: 'kb.review.requested', version: 1 },
+    { key: 'kb.review.decided', version: 1 },
+  ],
+  presentations: [],
+  opToPresentation: [],
+  presentationsTargets: [],
+  capabilities: {
+    requires: [
+      { key: 'identity', version: 1 },
+      { key: 'audit-trail', version: 1 },
+      { key: 'notifications', version: 1 },
+      { key: 'jobs', version: 1 },
+      { key: 'feature-flags', version: 1 },
+      { key: 'files', version: 1 },
+      { key: 'metering', version: 1 },
+      { key: 'learning-journey', version: 1 },
+    ],
+  },
+};

package/src/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Policy-safe Knowledge Assistant (all-in-one template) — spec-first exports.
+ */
+export * from './feature';
+export * from './seed';
+export * from './orchestrator/buildAnswer';
+export { default as example } from './example';
+
+import './docs';