@lssm/example.knowledge-canon 0.0.0-canary-20251217083314 → 1.41.0

package/.turbo/turbo-build.log

@@ -1,29 +1,19 @@
-
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/knowledge-canon/tsdown.config.js (unrun)
-ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 9 files
-ℹ dist/docs/knowledge-canon.docblock.js    1.46 kB │ gzip: 0.71 kB
-ℹ dist/example.js                          0.64 kB │ gzip: 0.38 kB
-ℹ dist/blueprint.js                        0.63 kB │ gzip: 0.38 kB
-ℹ dist/tenant.js                           0.60 kB │ gzip: 0.37 kB
-ℹ dist/agent.js                            0.58 kB │ gzip: 0.37 kB
-ℹ dist/source.sample.js                    0.48 kB │ gzip: 0.31 kB
-ℹ dist/index.js                            0.48 kB │ gzip: 0.22 kB
-ℹ dist/docs/index.js                       0.04 kB │ gzip: 0.06 kB
-ℹ dist/example.d.ts                        1.09 kB │ gzip: 0.45 kB
-ℹ dist/agent.d.ts                          0.90 kB │ gzip: 0.42 kB
-ℹ dist/index.d.ts                          0.44 kB │ gzip: 0.19 kB
-ℹ dist/source.sample.d.ts                  0.22 kB │ gzip: 0.16 kB
-ℹ dist/tenant.d.ts                         0.21 kB │ gzip: 0.15 kB
-ℹ dist/blueprint.d.ts                      0.21 kB │ gzip: 0.15 kB
-ℹ dist/docs/index.d.ts                     0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/knowledge-canon.docblock.d.ts  0.01 kB │ gzip: 0.03 kB
-ℹ 16 files, total: 8.01 kB
-✔ Build complete in 6227ms
-$ tsc --noEmit
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/knowledge-canon/tsdown.config.js 
+ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/knowledge-canon.docblock.js  1.46 kB │ gzip: 0.71 kB
+ℹ dist/example.js                        0.64 kB │ gzip: 0.38 kB
+ℹ dist/blueprint.js                      0.63 kB │ gzip: 0.38 kB
+ℹ dist/tenant.js                         0.60 kB │ gzip: 0.37 kB
+ℹ dist/agent.js                          0.58 kB │ gzip: 0.37 kB
+ℹ dist/source.sample.js                  0.48 kB │ gzip: 0.31 kB
+ℹ dist/index.js                          0.48 kB │ gzip: 0.22 kB
+ℹ dist/docs/index.js                     0.04 kB │ gzip: 0.06 kB
+ℹ 8 files, total: 4.91 kB
+✔ Build complete in 47ms
+$ tsc --noEmit

package/dist/agent.js

@@ -1,34 +1,2 @@
-//#region src/agent.ts
-/**
-* Selects knowledge bindings that apply to a workflow or agent identifier.
-*/
-function selectKnowledgeBindings(resolved, options) {
-	return resolved.knowledge.filter(({ binding }) => {
-		if (!binding.scope) return true;
-		if (options.workflowId && binding.scope.workflows?.includes(options.workflowId)) return true;
-		if (options.agentId && binding.scope.agents?.includes(options.agentId)) return true;
-		return false;
-	});
-}
-/**
-* Pseudo implementation of an assistant lookup that routes prompts to the appropriate
-* knowledge sources. In a real system this would call the ingestion/search services.
-*/
-async function answerWithKnowledge(resolved, question, { workflowId, agentId }) {
-	const bindings = selectKnowledgeBindings(resolved, {
-		workflowId,
-		agentId
-	});
-	if (bindings.length === 0) return "No knowledge space available for this request.";
-	const summaries = bindings.map(({ space }) => `• ${space.meta.displayName}`);
-	return [
-		`Q: ${question}`,
-		"Routed to knowledge spaces:",
-		...summaries,
-		"",
-		"TODO: invoke knowledge search service and synthesize response."
-	].join("\n");
-}
-
-//#endregion
-export { answerWithKnowledge, selectKnowledgeBindings };
+function e(e,t){return e.knowledge.filter(({binding:e})=>!!(!e.scope||t.workflowId&&e.scope.workflows?.includes(t.workflowId)||t.agentId&&e.scope.agents?.includes(t.agentId)))}async function t(t,n,{workflowId:r,agentId:i}){let a=e(t,{workflowId:r,agentId:i});if(a.length===0)return`No knowledge space available for this request.`;let o=a.map(({space:e})=>`• ${e.meta.displayName}`);return[`Q: ${n}`,`Routed to knowledge spaces:`,...o,``,`TODO: invoke knowledge search service and synthesize response.`].join(`
+`)}export{t as answerWithKnowledge,e as selectKnowledgeBindings};

package/dist/blueprint.js

@@ -1,28 +1 @@
-import { OwnersEnum, StabilityEnum, TagsEnum } from "./libs/contracts/dist/ownership.js";
-
-//#region src/blueprint.ts
-const artisanKnowledgeBlueprint = {
-	meta: {
-		name: "artisan.knowledge.product",
-		version: 1,
-		appId: "artisan",
-		title: "ArtisanOS Knowledge – Product Canon",
-		description: "Blueprint that surfaces canonical product knowledge to agents and workflows.",
-		domain: "knowledge",
-		owners: [OwnersEnum.PlatformContent],
-		tags: [
-			"knowledge",
-			"product-canon",
-			TagsEnum.Guide
-		],
-		stability: StabilityEnum.Experimental
-	},
-	workflows: { answerFaq: {
-		name: "artisan.knowledge.answerFaq",
-		version: 1
-	} },
-	notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
-};
-
-//#endregion
-export { artisanKnowledgeBlueprint };
+import{OwnersEnum as e,StabilityEnum as t,TagsEnum as n}from"@lssm/lib.contracts/ownership";const r={meta:{name:`artisan.knowledge.product`,version:1,appId:`artisan`,title:`ArtisanOS Knowledge – Product Canon`,description:`Blueprint that surfaces canonical product knowledge to agents and workflows.`,domain:`knowledge`,owners:[e.PlatformContent],tags:[`knowledge`,`product-canon`,n.Guide],stability:t.Experimental},workflows:{answerFaq:{name:`artisan.knowledge.answerFaq`,version:1}},notes:`Workflows and assistants running on this blueprint should bind the Product Canon knowledge space.`};export{r as artisanKnowledgeBlueprint};

package/dist/docs/index.js

@@ -1 +1 @@
-import "./knowledge-canon.docblock.js";
+import"./knowledge-canon.docblock.js";

package/dist/docs/knowledge-canon.docblock.js

@@ -1,29 +1,18 @@
-import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
-import "../libs/contracts/dist/docs/index.js";
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.knowledge-canon`,title:`Knowledge Example — Product Canon Space`,summary:`Bind the Product Canon KnowledgeSpaceSpec to a tenant and expose it to agents/workflows via ResolvedAppConfig.`,kind:`reference`,visibility:`public`,route:`/docs/examples/knowledge-canon`,tags:[`knowledge`,`canon`,`example`],body:`## Included assets
+- Blueprint referencing a workflow depending on the Product Canon space.
+- Tenant app config binding the space to a workflow and agent scope.
+- Sample knowledge source configuration.
+- Helper to pick knowledge bindings from ResolvedAppConfig.
 
-//#region src/docs/knowledge-canon.docblock.ts
-registerDocBlocks([{
-	id: "docs.examples.knowledge-canon",
-	title: "Knowledge Example — Product Canon Space",
-	summary: "Bind the Product Canon KnowledgeSpaceSpec to a tenant and expose it to agents/workflows via ResolvedAppConfig.",
-	kind: "reference",
-	visibility: "public",
-	route: "/docs/examples/knowledge-canon",
-	tags: [
-		"knowledge",
-		"canon",
-		"example"
-	],
-	body: `## Included assets\n- Blueprint referencing a workflow depending on the Product Canon space.\n- Tenant app config binding the space to a workflow and agent scope.\n- Sample knowledge source configuration.\n- Helper to pick knowledge bindings from ResolvedAppConfig.\n\n## Guardrails\n- Keep sources scoped per tenant.\n- Keep secret fields out of config (use secret providers).\n- Enforce scope restrictions before answering.`
-}, {
-	id: "docs.examples.knowledge-canon.usage",
-	title: "Knowledge Canon — Usage",
-	summary: "How to register the space, configure sources, and route requests.",
-	kind: "usage",
-	visibility: "public",
-	route: "/docs/examples/knowledge-canon/usage",
-	tags: ["knowledge", "usage"],
-	body: `## Usage\n1) Register the knowledge space spec in your KnowledgeSpaceRegistry.\n2) Persist the source config through knowledge CRUD operations.\n3) Compose ResolvedAppConfig and pass it to your workflow/agent runtime.\n4) Use helpers like \`selectKnowledgeBindings\` before dispatching to search/embedding.\n\n## Notes\n- Avoid logging PII.\n- Keep search results auditable and cite sources.`
-}]);
+## Guardrails
+- Keep sources scoped per tenant.
+- Keep secret fields out of config (use secret providers).
+- Enforce scope restrictions before answering.`},{id:`docs.examples.knowledge-canon.usage`,title:`Knowledge Canon — Usage`,summary:`How to register the space, configure sources, and route requests.`,kind:`usage`,visibility:`public`,route:`/docs/examples/knowledge-canon/usage`,tags:[`knowledge`,`usage`],body:`## Usage
+1) Register the knowledge space spec in your KnowledgeSpaceRegistry.
+2) Persist the source config through knowledge CRUD operations.
+3) Compose ResolvedAppConfig and pass it to your workflow/agent runtime.
+4) Use helpers like \`selectKnowledgeBindings\` before dispatching to search/embedding.
 
-//#endregion
+## Notes
+- Avoid logging PII.
+- Keep search results auditable and cite sources.`}]);

package/dist/example.js

@@ -1,39 +1 @@
-//#region src/example.ts
-const example = {
-	id: "knowledge-canon",
-	title: "Knowledge Canon (Product Canon space)",
-	summary: "Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).",
-	tags: [
-		"knowledge",
-		"canon",
-		"app-config",
-		"agents",
-		"workflows"
-	],
-	kind: "knowledge",
-	visibility: "public",
-	docs: {
-		rootDocId: "docs.examples.knowledge-canon",
-		usageDocId: "docs.examples.knowledge-canon.usage"
-	},
-	entrypoints: {
-		packageName: "@lssm/example.knowledge-canon",
-		docs: "./docs"
-	},
-	surfaces: {
-		templates: true,
-		sandbox: {
-			enabled: true,
-			modes: ["markdown", "specs"]
-		},
-		studio: {
-			enabled: true,
-			installable: true
-		},
-		mcp: { enabled: true }
-	}
-};
-var example_default = example;
-
-//#endregion
-export { example_default as default };
+var e={id:`knowledge-canon`,title:`Knowledge Canon (Product Canon space)`,summary:`Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).`,tags:[`knowledge`,`canon`,`app-config`,`agents`,`workflows`],kind:`knowledge`,visibility:`public`,docs:{rootDocId:`docs.examples.knowledge-canon`,usageDocId:`docs.examples.knowledge-canon.usage`},entrypoints:{packageName:`@lssm/example.knowledge-canon`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};

package/dist/index.js

@@ -1,8 +1 @@
-import { answerWithKnowledge, selectKnowledgeBindings } from "./agent.js";
-import { artisanKnowledgeBlueprint } from "./blueprint.js";
-import example_default from "./example.js";
-import { artisanKnowledgeTenantConfig } from "./tenant.js";
-import { productCanonNotionSource } from "./source.sample.js";
-import "./docs/index.js";
-
-export { answerWithKnowledge, artisanKnowledgeBlueprint, artisanKnowledgeTenantConfig, example_default as example, productCanonNotionSource, selectKnowledgeBindings };
+import{answerWithKnowledge as e,selectKnowledgeBindings as t}from"./agent.js";import{artisanKnowledgeBlueprint as n}from"./blueprint.js";import r from"./example.js";import{artisanKnowledgeTenantConfig as i}from"./tenant.js";import{productCanonNotionSource as a}from"./source.sample.js";import"./docs/index.js";export{e as answerWithKnowledge,n as artisanKnowledgeBlueprint,i as artisanKnowledgeTenantConfig,r as example,a as productCanonNotionSource,t as selectKnowledgeBindings};

package/dist/source.sample.js

@@ -1,29 +1 @@
-//#region src/source.sample.ts
-const productCanonNotionSource = {
-	meta: {
-		id: "source-canon-notion",
-		tenantId: "artisan-co",
-		spaceKey: "knowledge.product-canon",
-		spaceVersion: 1,
-		label: "Product Canon (Notion)",
-		sourceType: "notion",
-		createdAt: "2026-01-01T00:00:00.000Z",
-		updatedAt: "2026-01-01T00:00:00.000Z"
-	},
-	config: {
-		notionDatabaseId: "xxxxxxxxxxxxxxxx",
-		apiKey: "secret_notion_token"
-	},
-	syncSchedule: {
-		enabled: true,
-		cron: "0 * * * *"
-	},
-	lastSync: {
-		timestamp: /* @__PURE__ */ new Date("2026-01-01T00:00:00.000Z"),
-		success: true,
-		itemsProcessed: 128
-	}
-};
-
-//#endregion
-export { productCanonNotionSource };
+const e={meta:{id:`source-canon-notion`,tenantId:`artisan-co`,spaceKey:`knowledge.product-canon`,spaceVersion:1,label:`Product Canon (Notion)`,sourceType:`notion`,createdAt:`2026-01-01T00:00:00.000Z`,updatedAt:`2026-01-01T00:00:00.000Z`},config:{notionDatabaseId:`xxxxxxxxxxxxxxxx`,apiKey:`secret_notion_token`},syncSchedule:{enabled:!0,cron:`0 * * * *`},lastSync:{timestamp:new Date(`2026-01-01T00:00:00.000Z`),success:!0,itemsProcessed:128}};export{e as productCanonNotionSource};

package/dist/tenant.js

@@ -1,32 +1 @@
-//#region src/tenant.ts
-const artisanKnowledgeTenantConfig = {
-	meta: {
-		id: "tenant-config-artisan-knowledge",
-		tenantId: "artisan-co",
-		appId: "artisan",
-		blueprintName: "artisan.knowledge.product",
-		blueprintVersion: 1,
-		environment: "production",
-		version: 1,
-		status: "published",
-		createdAt: "2026-01-01T00:00:00.000Z",
-		updatedAt: "2026-01-01T00:00:00.000Z"
-	},
-	knowledge: [{
-		spaceKey: "knowledge.product-canon",
-		spaceVersion: 1,
-		scope: {
-			workflows: ["answerFaq"],
-			agents: ["productSupportAssistant"]
-		},
-		constraints: {
-			maxTokensPerQuery: 4096,
-			maxQueriesPerMinute: 30
-		}
-	}],
-	integrations: [],
-	notes: "Product Canon knowledge space bound for production assistants."
-};
-
-//#endregion
-export { artisanKnowledgeTenantConfig };
+const e={meta:{id:`tenant-config-artisan-knowledge`,tenantId:`artisan-co`,appId:`artisan`,blueprintName:`artisan.knowledge.product`,blueprintVersion:1,environment:`production`,version:1,status:`published`,createdAt:`2026-01-01T00:00:00.000Z`,updatedAt:`2026-01-01T00:00:00.000Z`},knowledge:[{spaceKey:`knowledge.product-canon`,spaceVersion:1,scope:{workflows:[`answerFaq`],agents:[`productSupportAssistant`]},constraints:{maxTokensPerQuery:4096,maxQueriesPerMinute:30}}],integrations:[],notes:`Product Canon knowledge space bound for production assistants.`};export{e as artisanKnowledgeTenantConfig};

package/package.json

@@ -1,24 +1,22 @@
 {
   "name": "@lssm/example.knowledge-canon",
-  "version": "0.0.0-canary-20251217083314",
+  "version": "1.41.0",
   "description": "Knowledge example – Product Canon space (blueprint + tenant config + source sample + runtime helper).",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./agent": "./dist/agent.js",
-    "./blueprint": "./dist/blueprint.js",
-    "./docs": "./dist/docs/index.js",
-    "./docs/knowledge-canon.docblock": "./dist/docs/knowledge-canon.docblock.js",
-    "./example": "./dist/example.js",
-    "./source.sample": "./dist/source.sample.js",
-    "./tenant": "./dist/tenant.js",
+    ".": "./src/index.ts",
+    "./agent": "./src/agent.ts",
+    "./blueprint": "./src/blueprint.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/knowledge-canon.docblock": "./src/docs/knowledge-canon.docblock.ts",
+    "./example": "./src/example.ts",
+    "./source.sample": "./src/source.sample.ts",
+    "./tenant": "./src/tenant.ts",
     "./*": "./*"
   },
   "scripts": {
-    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
-    "publish:pkg:canary": "bun publish:pkg --tag canary",
     "build": "bun build:bundle && bun build:types",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
@@ -30,12 +28,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217083314",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217083314"
+    "@lssm/lib.contracts": "workspace:*"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217083314",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217083314",
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },