@contractspec/example.knowledge-canon 1.56.1 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,38 +1,41 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
-ℹ 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.09 kB │ gzip: 0.56 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/example.js.map                        1.53 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.20 kB
-ℹ dist/source.sample.d.ts.map                0.14 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts.map                      0.14 kB │ gzip: 0.13 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/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.76 kB
-✔ Build complete in 21549ms
+$ 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
+
+  ./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,33 @@
 # @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
+
+- 11a5a05: feat: improve product intent
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+
 ## 1.56.1
 
 ### Patch 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"],"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"}
+{"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"],"sourcesContent":[],"mappings":";;;cAOa,2BAA2B"}
+{"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
+};