@contractspec/example.knowledge-canon 1.44.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,37 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ 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
+ℹ Cleaning 28 files
+ℹ 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                            0.90 kB │ gzip: 0.48 kB
+ℹ dist/blueprint.js                          0.84 kB │ gzip: 0.46 kB
+ℹ dist/tenant.js                             0.80 kB │ gzip: 0.44 kB
+ℹ dist/source.sample.js                      0.69 kB │ gzip: 0.40 kB
+ℹ dist/index.js                              0.50 kB │ gzip: 0.21 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/tenant.js.map                         1.39 kB │ gzip: 0.68 kB
+ℹ dist/blueprint.js.map                      1.30 kB │ gzip: 0.64 kB
+ℹ dist/example.js.map                        1.26 kB │ gzip: 0.65 kB
+ℹ dist/source.sample.js.map                  1.18 kB │ gzip: 0.58 kB
+ℹ dist/agent.d.ts.map                        0.29 kB │ gzip: 0.20 kB
+ℹ dist/example.d.ts.map                      0.14 kB │ gzip: 0.13 kB
+ℹ dist/source.sample.d.ts.map                0.14 kB │ gzip: 0.12 kB
+ℹ dist/blueprint.d.ts.map                    0.13 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                       0.12 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts                          1.14 kB │ gzip: 0.48 kB
+ℹ dist/agent.d.ts                            0.97 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/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: 20.33 kB
+✔ Build complete in 15599ms

package/.turbo/turbo-build.log

@@ -0,0 +1,38 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ 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                            0.90 kB │ gzip: 0.48 kB
+ℹ dist/blueprint.js                          0.84 kB │ gzip: 0.46 kB
+ℹ dist/tenant.js                             0.80 kB │ gzip: 0.44 kB
+ℹ dist/source.sample.js                      0.69 kB │ gzip: 0.40 kB
+ℹ dist/index.js                              0.50 kB │ gzip: 0.21 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/tenant.js.map                         1.39 kB │ gzip: 0.68 kB
+ℹ dist/blueprint.js.map                      1.30 kB │ gzip: 0.64 kB
+ℹ dist/example.js.map                        1.26 kB │ gzip: 0.65 kB
+ℹ dist/source.sample.js.map                  1.18 kB │ gzip: 0.58 kB
+ℹ dist/agent.d.ts.map                        0.29 kB │ gzip: 0.20 kB
+ℹ dist/example.d.ts.map                      0.14 kB │ gzip: 0.13 kB
+ℹ dist/source.sample.d.ts.map                0.14 kB │ gzip: 0.12 kB
+ℹ dist/blueprint.d.ts.map                    0.13 kB │ gzip: 0.12 kB
+ℹ dist/tenant.d.ts.map                       0.12 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts                          1.14 kB │ gzip: 0.48 kB
+ℹ dist/agent.d.ts                            0.97 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/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: 20.33 kB
+✔ Build complete in 17577ms

package/CHANGELOG.md

@@ -0,0 +1,161 @@
+# @contractspec/example.knowledge-canon
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.schema@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.schema@1.43.3
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.schema@1.43.2
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.schema@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.schema@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.schema@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.schema@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.schema@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.schema@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.schema@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.schema@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.schema@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.schema@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.schema@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.schema@1.42.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+### Knowledge Example – Product Canon Space
+
+Website: https://contractspec.io/
+
+
+This example demonstrates how to bind the Product Canon `KnowledgeSpaceSpec` to a tenant and surface it to agents/workflows.
+
+Included assets:
+
+- `blueprint.ts` – `AppBlueprintSpec` that references an FAQ workflow depending on the Product Canon space.
+- `tenant.ts` – `TenantAppConfig` binding the canonical knowledge space to the workflow and a `productSupportAssistant` agent.
+- `source.sample.ts` – illustrative `KnowledgeSourceConfig` for syncing a Notion database into the canonical corpus.
+- `agent.ts` – helper illustrating how to pick knowledge bindings from a `ResolvedAppConfig` at runtime.
+
+Usage sketch:
+
+1. Register the knowledge space spec (`knowledge.product-canon`) via `KnowledgeSpaceRegistry`.
+2. Persist the Notion source through the knowledge CRUD contracts (`knowledge.source.create`).
+3. Compose the app configuration and pass the `ResolvedAppConfig` to your workflow runner / agent runtime.
+4. Use helpers similar to `selectKnowledgeBindings` to scope which spaces can answer a given request before dispatching to embedding/vector services.
+
+
+
+
+
+
+

package/dist/agent.d.ts

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

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","names":[],"sources":["../src/agent.ts"],"sourcesContent":[],"mappings":";;;;;;;AAKgB,iBAAA,uBAAA,CACJ,QAAA,EAAA,iBAAiB,EAAA,OAAA,EAAA;EAoBP,UAAA,CAAA,EAAA,MAAA;EACV,OAAA,CAAA,EAAA,MAAA;CAER,CAAA,EAvByB,+CAAA,CACuB,iBAAA,EAsBhD;;;;;iBAHkB,mBAAA,WACV;;;;;;IAGT"}

package/dist/agent.js

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

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","names":[],"sources":["../src/agent.ts"],"sourcesContent":["import type { ResolvedAppConfig } from '@contractspec/lib.contracts/app-config/runtime';\n\n/**\n * Selects knowledge bindings that apply to a workflow or agent identifier.\n */\nexport function selectKnowledgeBindings(\n  resolved: ResolvedAppConfig,\n  options: { workflowId?: string; agentId?: string }\n) {\n  return resolved.knowledge.filter(({ binding }) => {\n    if (!binding.scope) return true;\n    if (\n      options.workflowId &&\n      binding.scope.workflows?.includes(options.workflowId)\n    )\n      return true;\n    if (options.agentId && binding.scope.agents?.includes(options.agentId))\n      return true;\n    return false;\n  });\n}\n\n/**\n * Pseudo implementation of an assistant lookup that routes prompts to the appropriate\n * knowledge sources. In a real system this would call the ingestion/search services.\n */\nexport async function answerWithKnowledge(\n  resolved: ResolvedAppConfig,\n  question: string,\n  { workflowId, agentId }: { workflowId?: string; agentId?: string }\n): Promise<string> {\n  const bindings = selectKnowledgeBindings(resolved, { workflowId, agentId });\n  if (bindings.length === 0) {\n    return 'No knowledge space available for this request.';\n  }\n\n  const summaries = bindings.map(\n    ({ space }) => `• ${space.meta.title || space.meta.description}`\n  );\n  return [\n    `Q: ${question}`,\n    'Routed to knowledge spaces:',\n    ...summaries,\n    '',\n    'TODO: invoke knowledge search service and synthesize response.',\n  ].join('\\n');\n}\n"],"mappings":";;;;AAKA,SAAgB,wBACd,UACA,SACA;AACA,QAAO,SAAS,UAAU,QAAQ,EAAE,cAAc;AAChD,MAAI,CAAC,QAAQ,MAAO,QAAO;AAC3B,MACE,QAAQ,cACR,QAAQ,MAAM,WAAW,SAAS,QAAQ,WAAW,CAErD,QAAO;AACT,MAAI,QAAQ,WAAW,QAAQ,MAAM,QAAQ,SAAS,QAAQ,QAAQ,CACpE,QAAO;AACT,SAAO;GACP;;;;;;AAOJ,eAAsB,oBACpB,UACA,UACA,EAAE,YAAY,WACG;CACjB,MAAM,WAAW,wBAAwB,UAAU;EAAE;EAAY;EAAS,CAAC;AAC3E,KAAI,SAAS,WAAW,EACtB,QAAO;CAGT,MAAM,YAAY,SAAS,KACxB,EAAE,YAAY,KAAK,MAAM,KAAK,SAAS,MAAM,KAAK,cACpD;AACD,QAAO;EACL,MAAM;EACN;EACA,GAAG;EACH;EACA;EACD,CAAC,KAAK,KAAK"}

package/dist/blueprint.d.ts

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

package/dist/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","names":[],"sources":["../src/blueprint.ts"],"sourcesContent":[],"mappings":";;;cAOa,2BAA2B"}

package/dist/blueprint.js

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

package/dist/blueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.js","names":["artisanKnowledgeBlueprint: AppBlueprintSpec"],"sources":["../src/blueprint.ts"],"sourcesContent":["import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const artisanKnowledgeBlueprint: AppBlueprintSpec = {\n  meta: {\n    key: 'artisan.knowledge.product',\n    version: 1,\n    appId: 'artisan',\n    title: 'ArtisanOS Knowledge – Product Canon',\n    description:\n      'Blueprint that surfaces canonical product knowledge to agents and workflows.',\n    domain: 'knowledge',\n    owners: [OwnersEnum.PlatformContent],\n    tags: ['knowledge', 'product-canon', TagsEnum.Guide],\n    stability: StabilityEnum.Experimental,\n  },\n  workflows: {\n    answerFaq: { key: 'artisan.knowledge.answerFaq', version: 1 },\n  },\n  notes:\n    'Workflows and assistants running on this blueprint should bind the Product Canon knowledge space.',\n};\n"],"mappings":";;;AAOA,MAAaA,4BAA8C;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,gBAAgB;EACpC,MAAM;GAAC;GAAa;GAAiB,SAAS;GAAM;EACpD,WAAW,cAAc;EAC1B;CACD,WAAW,EACT,WAAW;EAAE,KAAK;EAA+B,SAAS;EAAG,EAC9D;CACD,OACE;CACH"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

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

package/dist/docs/knowledge-canon.docblock.d.ts

@@ -0,0 +1 @@
+export { };

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

@@ -0,0 +1,29 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#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.`
+}]);
+
+//#endregion
+//# sourceMappingURL=knowledge-canon.docblock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-canon.docblock.js","names":[],"sources":["../../src/docs/knowledge-canon.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.knowledge-canon',\n    title: 'Knowledge Example — Product Canon Space',\n    summary:\n      'Bind the Product Canon KnowledgeSpaceSpec to a tenant and expose it to agents/workflows via ResolvedAppConfig.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/knowledge-canon',\n    tags: ['knowledge', 'canon', 'example'],\n    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.`,\n  },\n  {\n    id: 'docs.examples.knowledge-canon.usage',\n    title: 'Knowledge Canon — Usage',\n    summary:\n      'How to register the space, configure sources, and route requests.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/knowledge-canon/usage',\n    tags: ['knowledge', 'usage'],\n    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.`,\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA4BA,kBAzB2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAS;EAAU;CACvC,MAAM;CACP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,aAAa,QAAQ;CAC5B,MAAM;CACP,CACF,CAEwB"}

package/dist/example.d.ts

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

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAsBI,EAAA,iBAAA"}

package/dist/example.js

@@ -0,0 +1,40 @@
+//#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: "@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;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'knowledge-canon',\n  title: 'Knowledge Canon (Product Canon space)',\n  summary:\n    'Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).',\n  tags: ['knowledge', 'canon', 'app-config', 'agents', 'workflows'],\n  kind: 'knowledge',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.knowledge-canon',\n    usageDocId: 'docs.examples.knowledge-canon.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.knowledge-canon',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\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;EAAS;EAAc;EAAU;EAAY;CACjE,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { answerWithKnowledge, selectKnowledgeBindings } from "./agent.js";
+import { artisanKnowledgeBlueprint } from "./blueprint.js";
+import example from "./example.js";
+import { artisanKnowledgeTenantConfig } from "./tenant.js";
+import { productCanonNotionSource } from "./source.sample.js";
+export { answerWithKnowledge, artisanKnowledgeBlueprint, artisanKnowledgeTenantConfig, example, productCanonNotionSource, selectKnowledgeBindings };

package/dist/index.js

@@ -0,0 +1,8 @@
+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 };

package/dist/source.sample.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSourceConfig } from "@contractspec/lib.contracts/knowledge/source";
+
+//#region src/source.sample.d.ts
+declare const productCanonNotionSource: KnowledgeSourceConfig;
+//#endregion
+export { productCanonNotionSource };
+//# sourceMappingURL=source.sample.d.ts.map

package/dist/source.sample.d.ts.map

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

package/dist/source.sample.js

@@ -0,0 +1,30 @@
+//#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 };
+//# sourceMappingURL=source.sample.js.map

package/dist/source.sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.sample.js","names":["productCanonNotionSource: KnowledgeSourceConfig"],"sources":["../src/source.sample.ts"],"sourcesContent":["import type { KnowledgeSourceConfig } from '@contractspec/lib.contracts/knowledge/source';\n\nexport const productCanonNotionSource: KnowledgeSourceConfig = {\n  meta: {\n    id: 'source-canon-notion',\n    tenantId: 'artisan-co',\n    spaceKey: 'knowledge.product-canon',\n    spaceVersion: 1,\n    label: 'Product Canon (Notion)',\n    sourceType: 'notion',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  config: {\n    notionDatabaseId: 'xxxxxxxxxxxxxxxx',\n    apiKey: 'secret_notion_token',\n  },\n  syncSchedule: {\n    enabled: true,\n    cron: '0 * * * *',\n  },\n  lastSync: {\n    timestamp: new Date('2026-01-01T00:00:00.000Z'),\n    success: true,\n    itemsProcessed: 128,\n  },\n};\n"],"mappings":";AAEA,MAAaA,2BAAkD;CAC7D,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,UAAU;EACV,cAAc;EACd,OAAO;EACP,YAAY;EACZ,WAAW;EACX,WAAW;EACZ;CACD,QAAQ;EACN,kBAAkB;EAClB,QAAQ;EACT;CACD,cAAc;EACZ,SAAS;EACT,MAAM;EACP;CACD,UAAU;EACR,2BAAW,IAAI,KAAK,2BAA2B;EAC/C,SAAS;EACT,gBAAgB;EACjB;CACF"}

package/dist/tenant.d.ts

@@ -0,0 +1,7 @@
+import { TenantAppConfig } from "@contractspec/lib.contracts/app-config/spec";
+
+//#region src/tenant.d.ts
+declare const artisanKnowledgeTenantConfig: TenantAppConfig;
+//#endregion
+export { artisanKnowledgeTenantConfig };
+//# sourceMappingURL=tenant.d.ts.map

package/dist/tenant.d.ts.map

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

package/dist/tenant.js

@@ -0,0 +1,33 @@
+//#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 };
+//# sourceMappingURL=tenant.js.map

package/dist/tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.js","names":["artisanKnowledgeTenantConfig: TenantAppConfig"],"sources":["../src/tenant.ts"],"sourcesContent":["import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';\n\nexport const artisanKnowledgeTenantConfig: TenantAppConfig = {\n  meta: {\n    id: 'tenant-config-artisan-knowledge',\n    tenantId: 'artisan-co',\n    appId: 'artisan',\n    blueprintName: 'artisan.knowledge.product',\n    blueprintVersion: 1,\n    environment: 'production',\n    version: 1,\n    status: 'published',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  knowledge: [\n    {\n      spaceKey: 'knowledge.product-canon',\n      spaceVersion: 1,\n      scope: {\n        workflows: ['answerFaq'],\n        agents: ['productSupportAssistant'],\n      },\n      constraints: {\n        maxTokensPerQuery: 4096,\n        maxQueriesPerMinute: 30,\n      },\n    },\n  ],\n  integrations: [],\n  notes: 'Product Canon knowledge space bound for production assistants.',\n};\n"],"mappings":";AAEA,MAAaA,+BAAgD;CAC3D,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,OAAO;EACP,eAAe;EACf,kBAAkB;EAClB,aAAa;EACb,SAAS;EACT,QAAQ;EACR,WAAW;EACX,WAAW;EACZ;CACD,WAAW,CACT;EACE,UAAU;EACV,cAAc;EACd,OAAO;GACL,WAAW,CAAC,YAAY;GACxB,QAAQ,CAAC,0BAA0B;GACpC;EACD,aAAa;GACX,mBAAmB;GACnB,qBAAqB;GACtB;EACF,CACF;CACD,cAAc,EAAE;CAChB,OAAO;CACR"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@contractspec/example.knowledge-canon",
+  "version": "1.44.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",
+    "./*": "./*"
+  },
+  "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/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "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",
+      "./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",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "module": "./dist/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/knowledge-canon"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/agent.ts

@@ -0,0 +1,47 @@
+import type { ResolvedAppConfig } from '@contractspec/lib.contracts/app-config/runtime';
+
+/**
+ * Selects knowledge bindings that apply to a workflow or agent identifier.
+ */
+export function selectKnowledgeBindings(
+  resolved: ResolvedAppConfig,
+  options: { workflowId?: string; agentId?: string }
+) {
+  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.
+ */
+export async function answerWithKnowledge(
+  resolved: ResolvedAppConfig,
+  question: string,
+  { workflowId, agentId }: { workflowId?: string; agentId?: string }
+): Promise<string> {
+  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');
+}

package/src/blueprint.ts

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

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './knowledge-canon.docblock';

package/src/docs/knowledge-canon.docblock.ts

@@ -0,0 +1,29 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const blocks: DocBlock[] = [
+  {
+    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.`,
+  },
+];
+
+registerDocBlocks(blocks);

package/src/example.ts

@@ -0,0 +1,25 @@
+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: '@contractspec/example.knowledge-canon',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['markdown', 'specs'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+} as const;
+
+export default example;

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './agent';
+export * from './blueprint';
+export * from './tenant';
+export * from './source.sample';
+export { default as example } from './example';
+import './docs';

package/src/source.sample.ts

@@ -0,0 +1,27 @@
+import type { KnowledgeSourceConfig } from '@contractspec/lib.contracts/knowledge/source';
+
+export const productCanonNotionSource: KnowledgeSourceConfig = {
+  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: new Date('2026-01-01T00:00:00.000Z'),
+    success: true,
+    itemsProcessed: 128,
+  },
+};

package/src/tenant.ts

@@ -0,0 +1,32 @@
+import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';
+
+export const artisanKnowledgeTenantConfig: TenantAppConfig = {
+  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.',
+};

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"],
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+
+

package/tsdown.config.js

@@ -0,0 +1,6 @@
+import { defineConfig } from 'tsdown';
+import { moduleLibrary } from '@contractspec/tool.tsdown';
+
+export default defineConfig(() => ({
+  ...moduleLibrary,
+}));