@contractspec/example.knowledge-canon 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,43 +1,41 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ 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.68 kB │ gzip: 0.79 kB
-ℹ dist/agent.js                              1.25 kB │ gzip: 0.62 kB
-ℹ dist/example.js                            1.05 kB │ gzip: 0.55 kB
-ℹ dist/blueprint.js                          0.85 kB │ gzip: 0.46 kB
-ℹ dist/tenant.js                             0.82 kB │ gzip: 0.45 kB
-ℹ dist/source.sample.js                      0.70 kB │ gzip: 0.41 kB
-ℹ dist/index.js                              0.47 kB │ gzip: 0.20 kB
-ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
-ℹ dist/docs/knowledge-canon.docblock.js.map  2.18 kB │ gzip: 0.97 kB
-ℹ dist/agent.js.map                          2.13 kB │ gzip: 1.00 kB
-ℹ dist/example.js.map                        1.52 kB │ gzip: 0.75 kB
-ℹ dist/tenant.js.map                         1.35 kB │ gzip: 0.68 kB
-ℹ dist/blueprint.js.map                      1.26 kB │ gzip: 0.64 kB
-ℹ dist/source.sample.js.map                  1.14 kB │ gzip: 0.58 kB
-ℹ dist/agent.d.ts.map                        0.29 kB │ gzip: 0.19 kB
-ℹ dist/source.sample.d.ts.map                0.13 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
-ℹ dist/blueprint.d.ts.map                    0.12 kB │ gzip: 0.12 kB
-ℹ dist/tenant.d.ts.map                       0.11 kB │ gzip: 0.12 kB
-ℹ dist/agent.d.ts                            0.91 kB │ gzip: 0.44 kB
-ℹ dist/index.d.ts                            0.44 kB │ gzip: 0.19 kB
-ℹ dist/source.sample.d.ts                    0.28 kB │ gzip: 0.18 kB
-ℹ dist/blueprint.d.ts                        0.26 kB │ gzip: 0.18 kB
-ℹ dist/tenant.d.ts                           0.26 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 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
-ℹ 27 files, total: 19.65 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (72%)
-  - tsdown:external (24%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=8
+Bundled 8 modules in 10ms
 
-✔ Build complete in 20950ms
+  ./agent.js                        1.0 KB   (entry point)
+  ./index.js                        5.98 KB  (entry point)
+  ./blueprint.js                    0.82 KB  (entry point)
+  docs/index.js                     1.67 KB  (entry point)
+  docs/knowledge-canon.docblock.js  1.67 KB  (entry point)
+  ./example.js                      1.0 KB   (entry point)
+  ./source.sample.js                0.67 KB  (entry point)
+  ./tenant.js                       0.85 KB  (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=8
+Bundled 8 modules in 31ms
+
+  ./agent.js                        0.99 KB  (entry point)
+  ./index.js                        5.96 KB  (entry point)
+  ./blueprint.js                    0.81 KB  (entry point)
+  docs/index.js                     1.66 KB  (entry point)
+  docs/knowledge-canon.docblock.js  1.66 KB  (entry point)
+  ./example.js                      1.0 KB   (entry point)
+  ./source.sample.js                0.66 KB  (entry point)
+  ./tenant.js                       0.84 KB  (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=8
+Bundled 8 modules in 16ms
+
+  ./agent.js                        0.99 KB  (entry point)
+  ./index.js                        5.96 KB  (entry point)
+  ./blueprint.js                    0.81 KB  (entry point)
+  docs/index.js                     1.66 KB  (entry point)
+  docs/knowledge-canon.docblock.js  1.66 KB  (entry point)
+  ./example.js                      1.0 KB   (entry point)
+  ./source.sample.js                0.66 KB  (entry point)
+  ./tenant.js                       0.84 KB  (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @contractspec/example.knowledge-canon
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/agent.d.ts

@@ -1,25 +1,17 @@
-import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
-import { ResolvedAppConfig } from "@contractspec/lib.contracts/app-config/runtime";
-
-//#region src/agent.d.ts
+import type { ResolvedAppConfig } from '@contractspec/lib.contracts/app-config/runtime';
 /**
  * Selects knowledge bindings that apply to a workflow or agent identifier.
  */
-declare function selectKnowledgeBindings(resolved: ResolvedAppConfig, options: {
-  workflowId?: string;
-  agentId?: string;
-}): _contractspec_lib_contracts0.ResolvedKnowledge[];
+export declare function selectKnowledgeBindings(resolved: ResolvedAppConfig, options: {
+    workflowId?: string;
+    agentId?: string;
+}): import("@contractspec/lib.contracts").ResolvedKnowledge[];
 /**
  * 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.
  */
-declare function answerWithKnowledge(resolved: ResolvedAppConfig, question: string, {
-  workflowId,
-  agentId
-}: {
-  workflowId?: string;
-  agentId?: string;
+export declare function answerWithKnowledge(resolved: ResolvedAppConfig, question: string, { workflowId, agentId }: {
+    workflowId?: string;
+    agentId?: string;
 }): Promise<string>;
-//#endregion
-export { answerWithKnowledge, selectKnowledgeBindings };
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","names":[],"sources":["../src/agent.ts"],"mappings":";;;;;;;iBAKgB,uBAAA,CACd,QAAA,EAAU,iBAAA,EACV,OAAA;EAAW,UAAA;EAAqB,OAAA;AAAA,IADL,4BAAA,CACuB,iBAAA;;;;;iBAmB9B,mBAAA,CACpB,QAAA,EAAU,iBAAA,EACV,QAAA;EACE,UAAA;EAAY;AAAA;EAAa,UAAA;EAAqB,OAAA;AAAA,IAC/C,OAAA"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAExF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,6DAanD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,MAAM,EAChB,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/agent.js

@@ -1,35 +1,32 @@
-//#region src/agent.ts
-/**
-* Selects knowledge bindings that apply to a workflow or agent identifier.
-*/
+// @bun
+// src/agent.ts
 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;
-	});
+  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.title || space.meta.description}`);
-	return [
-		`Q: ${question}`,
-		"Routed to knowledge spaces:",
-		...summaries,
-		"",
-		"TODO: invoke knowledge search service and synthesize response."
-	].join("\n");
+  const bindings = selectKnowledgeBindings(resolved, { workflowId, agentId });
+  if (bindings.length === 0) {
+    return "No knowledge space available for this request.";
+  }
+  const summaries = bindings.map(({ space }) => `\u2022 ${space.meta.title || space.meta.description}`);
+  return [
+    `Q: ${question}`,
+    "Routed to knowledge spaces:",
+    ...summaries,
+    "",
+    "TODO: invoke knowledge search service and synthesize response."
+  ].join(`
+`);
 }
-
-//#endregion
-export { answerWithKnowledge, selectKnowledgeBindings };
-//# sourceMappingURL=agent.js.map
+export {
+  selectKnowledgeBindings,
+  answerWithKnowledge
+};

package/dist/blueprint.d.ts

@@ -1,7 +1,3 @@
-import { AppBlueprintSpec } from "@contractspec/lib.contracts/app-config/spec";
-
-//#region src/blueprint.d.ts
-declare const artisanKnowledgeBlueprint: AppBlueprintSpec;
-//#endregion
-export { artisanKnowledgeBlueprint };
+import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';
+export declare const artisanKnowledgeBlueprint: AppBlueprintSpec;
 //# sourceMappingURL=blueprint.d.ts.map

package/dist/blueprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint.d.ts","names":[],"sources":["../src/blueprint.ts"],"mappings":";;;cAOa,yBAAA,EAA2B,gBAAA"}
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../src/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAOpF,eAAO,MAAM,yBAAyB,EAAE,gBAkBvC,CAAC"}

package/dist/blueprint.js

@@ -1,29 +1,27 @@
-import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts/ownership";
-
-//#region src/blueprint.ts
-const artisanKnowledgeBlueprint = {
-	meta: {
-		key: "artisan.knowledge.product",
-		version: "1.0.0",
-		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: {
-		key: "artisan.knowledge.answerFaq",
-		version: "1.0.0"
-	} },
-	notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
+// @bun
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanKnowledgeBlueprint = {
+  meta: {
+    key: "artisan.knowledge.product",
+    version: "1.0.0",
+    appId: "artisan",
+    title: "ArtisanOS Knowledge \u2013 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: { key: "artisan.knowledge.answerFaq", version: "1.0.0" }
+  },
+  notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
+};
+export {
+  artisanKnowledgeBlueprint
 };
-
-//#endregion
-export { artisanKnowledgeBlueprint };
-//# sourceMappingURL=blueprint.js.map

package/dist/browser/agent.js

@@ -0,0 +1,31 @@
+// src/agent.ts
+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;
+  });
+}
+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.title || space.meta.description}`);
+  return [
+    `Q: ${question}`,
+    "Routed to knowledge spaces:",
+    ...summaries,
+    "",
+    "TODO: invoke knowledge search service and synthesize response."
+  ].join(`
+`);
+}
+export {
+  selectKnowledgeBindings,
+  answerWithKnowledge
+};

package/dist/browser/blueprint.js

@@ -0,0 +1,26 @@
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanKnowledgeBlueprint = {
+  meta: {
+    key: "artisan.knowledge.product",
+    version: "1.0.0",
+    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: { key: "artisan.knowledge.answerFaq", version: "1.0.0" }
+  },
+  notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
+};
+export {
+  artisanKnowledgeBlueprint
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,42 @@
+// src/docs/knowledge-canon.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.
+
+## 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.
+
+## Notes
+- Avoid logging PII.
+- Keep search results auditable and cite sources.`
+  }
+];
+registerDocBlocks(blocks);

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

@@ -0,0 +1,42 @@
+// src/docs/knowledge-canon.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.
+
+## 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.
+
+## Notes
+- Avoid logging PII.
+- Keep search results auditable and cite sources.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,33 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "knowledge-canon",
+    version: "1.0.0",
+    title: "Knowledge Canon (Product Canon space)",
+    description: "Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).",
+    kind: "knowledge",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["knowledge", "canon", "app-config", "agents", "workflows"]
+  },
+  docs: {
+    rootDocId: "docs.examples.knowledge-canon",
+    usageDocId: "docs.examples.knowledge-canon.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/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;
+export {
+  example_default as default
+};

package/dist/browser/index.js

@@ -0,0 +1,191 @@
+// src/agent.ts
+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;
+  });
+}
+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.title || space.meta.description}`);
+  return [
+    `Q: ${question}`,
+    "Routed to knowledge spaces:",
+    ...summaries,
+    "",
+    "TODO: invoke knowledge search service and synthesize response."
+  ].join(`
+`);
+}
+
+// src/blueprint.ts
+import {
+  OwnersEnum,
+  StabilityEnum,
+  TagsEnum
+} from "@contractspec/lib.contracts/ownership";
+var artisanKnowledgeBlueprint = {
+  meta: {
+    key: "artisan.knowledge.product",
+    version: "1.0.0",
+    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: { key: "artisan.knowledge.answerFaq", version: "1.0.0" }
+  },
+  notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
+};
+
+// src/docs/knowledge-canon.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    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.
+
+## 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.
+
+## Notes
+- Avoid logging PII.
+- Keep search results auditable and cite sources.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "knowledge-canon",
+    version: "1.0.0",
+    title: "Knowledge Canon (Product Canon space)",
+    description: "Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).",
+    kind: "knowledge",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["knowledge", "canon", "app-config", "agents", "workflows"]
+  },
+  docs: {
+    rootDocId: "docs.examples.knowledge-canon",
+    usageDocId: "docs.examples.knowledge-canon.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/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;
+
+// src/tenant.ts
+var artisanKnowledgeTenantConfig = {
+  meta: {
+    id: "tenant-config-artisan-knowledge",
+    tenantId: "artisan-co",
+    appId: "artisan",
+    blueprintName: "artisan.knowledge.product",
+    blueprintVersion: "1.0.0",
+    environment: "production",
+    version: "1.0.0",
+    status: "published",
+    createdAt: "2026-01-01T00:00:00.000Z",
+    updatedAt: "2026-01-01T00:00:00.000Z"
+  },
+  knowledge: [
+    {
+      spaceKey: "knowledge.product-canon",
+      spaceVersion: "1.0.0",
+      scope: {
+        workflows: ["answerFaq"],
+        agents: ["productSupportAssistant"]
+      },
+      constraints: {
+        maxTokensPerQuery: 4096,
+        maxQueriesPerMinute: 30
+      }
+    }
+  ],
+  integrations: [],
+  notes: "Product Canon knowledge space bound for production assistants."
+};
+
+// src/source.sample.ts
+var productCanonNotionSource = {
+  meta: {
+    id: "source-canon-notion",
+    tenantId: "artisan-co",
+    spaceKey: "knowledge.product-canon",
+    spaceVersion: "1.0.0",
+    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: new Date("2026-01-01T00:00:00.000Z"),
+    success: true,
+    itemsProcessed: 128
+  }
+};
+export {
+  selectKnowledgeBindings,
+  productCanonNotionSource,
+  example_default as example,
+  artisanKnowledgeTenantConfig,
+  artisanKnowledgeBlueprint,
+  answerWithKnowledge
+};