@contractspec/example.knowledge-canon 1.44.0 → 1.45.0

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

@@ -8,30 +8,30 @@ $ tsdown
 ℹ 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/example.js                            1.01 kB │ gzip: 0.53 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.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/example.js.map                        1.54 kB │ gzip: 0.75 kB
+ℹ dist/tenant.js.map                         1.40 kB │ gzip: 0.69 kB
+ℹ dist/blueprint.js.map                      1.31 kB │ gzip: 0.65 kB
+ℹ dist/source.sample.js.map                  1.19 kB │ gzip: 0.59 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/example.d.ts.map                      0.12 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/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.20 kB │ gzip: 0.16 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
+ℹ 27 files, total: 19.78 kB
+✔ Build complete in 31908ms

package/.turbo/turbo-build.log

@@ -9,30 +9,30 @@ $ tsdown
 ℹ 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/example.js                            1.01 kB │ gzip: 0.53 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.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/example.js.map                        1.54 kB │ gzip: 0.75 kB
+ℹ dist/tenant.js.map                         1.40 kB │ gzip: 0.69 kB
+ℹ dist/blueprint.js.map                      1.31 kB │ gzip: 0.65 kB
+ℹ dist/source.sample.js.map                  1.19 kB │ gzip: 0.59 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/example.d.ts.map                      0.12 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/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.20 kB │ gzip: 0.16 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
+ℹ 27 files, total: 19.78 kB
+✔ Build complete in 21438ms

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @contractspec/example.knowledge-canon
 
+## 1.45.0
+
+### Minor Changes
+
+- e73ca1d: feat: improve app config and examples contracts
+  feat: Contract layers support (features, examples, app-configs)
+
+  ### New CLI Commands
+  - `contractspec list layers` - List all contract layers with filtering
+
+  ### Enhanced Commands
+  - `contractspec ci` - New `layers` check category validates features/examples/config
+  - `contractspec doctor` - New `layers` health checks
+  - `contractspec integrity` - Now shows layer statistics
+
+  ### New APIs
+  - `discoverLayers()` - Scan workspace for all layer files
+  - `scanExampleSource()` - Parse ExampleSpec from source code
+  - `isExampleFile()` - Check if file is an example spec
+
+### Patch Changes
+
+- Updated dependencies [e73ca1d]
+  - @contractspec/lib.contracts@1.45.0
+  - @contractspec/lib.schema@1.45.0
+
+## 1.44.1
+
+### Patch Changes
+
+- 3c594fb: fix
+- Updated dependencies [3c594fb]
+  - @contractspec/lib.contracts@1.44.1
+  - @contractspec/lib.schema@1.44.1
+
 ## 1.44.0
 
 ### Minor Changes

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import * as _contractspec_lib_contracts_app_config_runtime0 from "@contractspec/lib.contracts/app-config/runtime";
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
 import { ResolvedAppConfig } from "@contractspec/lib.contracts/app-config/runtime";
 
 //#region src/agent.d.ts
@@ -8,7 +8,7 @@ import { ResolvedAppConfig } from "@contractspec/lib.contracts/app-config/runtim
 declare function selectKnowledgeBindings(resolved: ResolvedAppConfig, options: {
   workflowId?: string;
   agentId?: string;
-}): _contractspec_lib_contracts_app_config_runtime0.ResolvedKnowledge[];
+}): _contractspec_lib_contracts0.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.

package/dist/agent.d.ts.map

@@ -1 +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"}
+{"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,4BAAA,CACuB,iBAAA,EAsBhD;;;;;iBAHkB,mBAAA,WACV;;;;;;IAGT"}

package/dist/blueprint.js

@@ -4,7 +4,7 @@ import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts
 const artisanKnowledgeBlueprint = {
 	meta: {
 		key: "artisan.knowledge.product",
-		version: 1,
+		version: "1.0.0",
 		appId: "artisan",
 		title: "ArtisanOS Knowledge – Product Canon",
 		description: "Blueprint that surfaces canonical product knowledge to agents and workflows.",
@@ -19,7 +19,7 @@ const artisanKnowledgeBlueprint = {
 	},
 	workflows: { answerFaq: {
 		key: "artisan.knowledge.answerFaq",
-		version: 1
+		version: "1.0.0"
 	} },
 	notes: "Workflows and assistants running on this blueprint should bind the Product Canon knowledge space."
 };

package/dist/blueprint.js.map

@@ -1 +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"}
+{"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.0.0',\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.0.0' },\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;EAAS,EACpE;CACD,OACE;CACH"}

package/dist/example.d.ts

@@ -1,34 +1,7 @@
+import { ExampleSpec } from "@contractspec/lib.contracts";
+
 //#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;
-    };
-  };
-};
+declare const example: ExampleSpec;
 //#endregion
 export { example as default };
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

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

package/dist/example.js

@@ -1,17 +1,22 @@
 //#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",
+	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"

package/dist/example.js.map

@@ -1 +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"}
+{"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n  meta: {\n    key: 'knowledge-canon',\n    version: '1.0.0',\n    title: 'Knowledge Canon (Product Canon space)',\n    description:\n      'Bind a canonical knowledge space to a tenant and route assistant/workflow requests to the right sources (blueprint + app config pattern).',\n    kind: 'knowledge',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['knowledge', 'canon', 'app-config', 'agents', 'workflows'],\n  },\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};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAS;GAAc;GAAU;GAAY;EAClE;CACD,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/source.sample.js

@@ -4,7 +4,7 @@ const productCanonNotionSource = {
 		id: "source-canon-notion",
 		tenantId: "artisan-co",
 		spaceKey: "knowledge.product-canon",
-		spaceVersion: 1,
+		spaceVersion: "1.0.0",
 		label: "Product Canon (Notion)",
 		sourceType: "notion",
 		createdAt: "2026-01-01T00:00:00.000Z",

package/dist/source.sample.js.map

@@ -1 +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"}
+{"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.0.0',\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.js

@@ -5,16 +5,16 @@ const artisanKnowledgeTenantConfig = {
 		tenantId: "artisan-co",
 		appId: "artisan",
 		blueprintName: "artisan.knowledge.product",
-		blueprintVersion: 1,
+		blueprintVersion: "1.0.0",
 		environment: "production",
-		version: 1,
+		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,
+		spaceVersion: "1.0.0",
 		scope: {
 			workflows: ["answerFaq"],
 			agents: ["productSupportAssistant"]

package/dist/tenant.js.map

@@ -1 +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"}
+{"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.0.0',\n    environment: 'production',\n    version: '1.0.0',\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.0.0',\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

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.knowledge-canon",
-  "version": "1.44.0",
+  "version": "1.45.0",
   "description": "Knowledge example – Product Canon space (blueprint + tenant config + source sample + runtime helper).",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,12 +30,12 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "1.44.0",
-    "@contractspec/lib.contracts": "1.44.0"
+    "@contractspec/lib.schema": "1.45.0",
+    "@contractspec/lib.contracts": "1.45.0"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.44.0",
-    "@contractspec/tool.typescript": "1.44.0",
+    "@contractspec/tool.tsdown": "1.45.0",
+    "@contractspec/tool.typescript": "1.45.0",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },

package/src/blueprint.ts

@@ -8,7 +8,7 @@ import {
 export const artisanKnowledgeBlueprint: AppBlueprintSpec = {
   meta: {
     key: 'artisan.knowledge.product',
-    version: 1,
+    version: '1.0.0',
     appId: 'artisan',
     title: 'ArtisanOS Knowledge – Product Canon',
     description:
@@ -19,7 +19,7 @@ export const artisanKnowledgeBlueprint: AppBlueprintSpec = {
     stability: StabilityEnum.Experimental,
   },
   workflows: {
-    answerFaq: { key: 'artisan.knowledge.answerFaq', version: 1 },
+    answerFaq: { key: 'artisan.knowledge.answerFaq', version: '1.0.0' },
   },
   notes:
     'Workflows and assistants running on this blueprint should bind the Product Canon knowledge space.',

package/src/example.ts

@@ -1,11 +1,18 @@
-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',
+import type { ExampleSpec } from '@contractspec/lib.contracts';
+
+const example: ExampleSpec = {
+  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',
@@ -20,6 +27,6 @@ const example = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-} as const;
+};
 
 export default example;

package/src/source.sample.ts

@@ -5,7 +5,7 @@ export const productCanonNotionSource: KnowledgeSourceConfig = {
     id: 'source-canon-notion',
     tenantId: 'artisan-co',
     spaceKey: 'knowledge.product-canon',
-    spaceVersion: 1,
+    spaceVersion: '1.0.0',
     label: 'Product Canon (Notion)',
     sourceType: 'notion',
     createdAt: '2026-01-01T00:00:00.000Z',

package/src/tenant.ts

@@ -6,9 +6,9 @@ export const artisanKnowledgeTenantConfig: TenantAppConfig = {
     tenantId: 'artisan-co',
     appId: 'artisan',
     blueprintName: 'artisan.knowledge.product',
-    blueprintVersion: 1,
+    blueprintVersion: '1.0.0',
     environment: 'production',
-    version: 1,
+    version: '1.0.0',
     status: 'published',
     createdAt: '2026-01-01T00:00:00.000Z',
     updatedAt: '2026-01-01T00:00:00.000Z',
@@ -16,7 +16,7 @@ export const artisanKnowledgeTenantConfig: TenantAppConfig = {
   knowledge: [
     {
       spaceKey: 'knowledge.product-canon',
-      spaceVersion: 1,
+      spaceVersion: '1.0.0',
       scope: {
         workflows: ['answerFaq'],
         agents: ['productSupportAssistant'],