@lssm/example.knowledge-canon 0.0.0-canary-20251217062943 → 0.0.0-canary-20251217072406

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

@@ -1,58 +1,57 @@
-
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/knowledge-canon/tsdown.config.js (unrun)
-ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 60 files
-ℹ dist/docs/knowledge-canon.docblock.js                                           1.50 kB │ gzip: 0.72 kB
-ℹ dist/example.js                                                                 0.64 kB │ gzip: 0.38 kB
-ℹ dist/blueprint.js                                                               0.60 kB │ gzip: 0.37 kB
-ℹ dist/tenant.js                                                                  0.60 kB │ gzip: 0.37 kB
-ℹ dist/agent.js                                                                   0.58 kB │ gzip: 0.37 kB
-ℹ dist/source.sample.js                                                           0.48 kB │ gzip: 0.31 kB
-ℹ dist/index.js                                                                   0.48 kB │ gzip: 0.22 kB
-ℹ dist/docs/index.js                                                              0.04 kB │ gzip: 0.06 kB
-ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.51 kB │ gzip: 7.15 kB
-ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   10.97 kB │ gzip: 4.28 kB
-ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.65 kB │ gzip: 3.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.10 kB │ gzip: 3.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.74 kB │ gzip: 2.67 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.91 kB │ gzip: 2.61 kB
-ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.62 kB │ gzip: 2.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.42 kB │ gzip: 2.25 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.35 kB │ gzip: 2.05 kB
-ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 3.89 kB │ gzip: 1.69 kB
-ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.58 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.42 kB │ gzip: 1.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.34 kB │ gzip: 1.45 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.07 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.03 kB │ gzip: 1.32 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     2.98 kB │ gzip: 1.52 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.81 kB │ gzip: 1.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.73 kB │ gzip: 1.30 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.49 kB │ gzip: 1.11 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.13 kB │ gzip: 1.03 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                1.89 kB │ gzip: 0.93 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           1.78 kB │ gzip: 0.87 kB
-ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.70 kB │ gzip: 0.89 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.57 kB │ gzip: 0.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.47 kB │ gzip: 0.73 kB
-ℹ dist/libs/contracts/dist/docs/index.js                                          1.42 kB │ gzip: 0.47 kB
-ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.23 kB │ gzip: 0.68 kB
-ℹ dist/libs/contracts/dist/docs/presentations.js                                  1.14 kB │ gzip: 0.56 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          0.89 kB │ gzip: 0.55 kB
-ℹ dist/libs/contracts/dist/ownership.js                                           0.69 kB │ gzip: 0.38 kB
-ℹ dist/libs/contracts/dist/docs/registry.js                                       0.63 kB │ gzip: 0.39 kB
-ℹ dist/example.d.ts                                                               1.09 kB │ gzip: 0.45 kB
-ℹ dist/agent.d.ts                                                                 0.90 kB │ gzip: 0.42 kB
-ℹ dist/index.d.ts                                                                 0.44 kB │ gzip: 0.19 kB
-ℹ dist/source.sample.d.ts                                                         0.22 kB │ gzip: 0.16 kB
-ℹ dist/tenant.d.ts                                                                0.21 kB │ gzip: 0.15 kB
-ℹ dist/blueprint.d.ts                                                             0.21 kB │ gzip: 0.15 kB
-ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/knowledge-canon.docblock.d.ts                                         0.01 kB │ gzip: 0.03 kB
-ℹ 47 files, total: 132.18 kB
-✔ Build complete in 2624ms
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/knowledge-canon/tsdown.config.js 
+ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 60 files
+ℹ dist/docs/knowledge-canon.docblock.js                                           1.68 kB │ gzip: 0.78 kB
+ℹ dist/agent.js                                                                   1.20 kB │ gzip: 0.59 kB
+ℹ dist/example.js                                                                 0.86 kB │ gzip: 0.45 kB
+ℹ dist/blueprint.js                                                               0.80 kB │ gzip: 0.43 kB
+ℹ dist/tenant.js                                                                  0.77 kB │ gzip: 0.42 kB
+ℹ dist/source.sample.js                                                           0.65 kB │ gzip: 0.38 kB
+ℹ dist/index.js                                                                   0.50 kB │ gzip: 0.21 kB
+ℹ dist/docs/index.js                                                              0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.91 kB │ gzip: 7.23 kB
+ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   11.21 kB │ gzip: 4.33 kB
+ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.96 kB │ gzip: 3.83 kB
+ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.53 kB │ gzip: 3.50 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               9.22 kB │ gzip: 2.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           6.16 kB │ gzip: 2.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.85 kB │ gzip: 2.66 kB
+ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.66 kB │ gzip: 2.34 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.62 kB │ gzip: 2.13 kB
+ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 4.16 kB │ gzip: 1.78 kB
+ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.85 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.62 kB │ gzip: 1.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.60 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.33 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.30 kB │ gzip: 1.42 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.25 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   3.13 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.97 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.75 kB │ gzip: 1.22 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.40 kB │ gzip: 1.13 kB
+ℹ dist/libs/contracts/dist/docs/presentations.js                                  2.18 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                2.13 kB │ gzip: 1.02 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           2.04 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.96 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.85 kB │ gzip: 0.87 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.73 kB │ gzip: 0.82 kB
+ℹ dist/libs/contracts/dist/docs/index.js                                          1.58 kB │ gzip: 0.51 kB
+ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.46 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/registry.js                                       1.25 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          1.14 kB │ gzip: 0.65 kB
+ℹ dist/libs/contracts/dist/ownership.js                                           0.91 kB │ gzip: 0.46 kB
+ℹ dist/example.d.ts                                                               1.09 kB │ gzip: 0.45 kB
+ℹ dist/agent.d.ts                                                                 0.90 kB │ gzip: 0.42 kB
+ℹ dist/index.d.ts                                                                 0.44 kB │ gzip: 0.19 kB
+ℹ dist/source.sample.d.ts                                                         0.22 kB │ gzip: 0.16 kB
+ℹ dist/tenant.d.ts                                                                0.21 kB │ gzip: 0.15 kB
+ℹ dist/blueprint.d.ts                                                             0.21 kB │ gzip: 0.15 kB
+ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/knowledge-canon.docblock.d.ts                                         0.01 kB │ gzip: 0.03 kB
+ℹ 47 files, total: 143.31 kB
+✔ Build complete in 33867ms

package/.turbo/turbo-build.log

@@ -1,29 +1,58 @@
-
-$ bun build:bundle && bun build:types
-$ tsdown
-ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
-ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/knowledge-canon/tsdown.config.js (unrun)
-ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ Cleaning 9 files
-ℹ dist/docs/knowledge-canon.docblock.js    1.46 kB │ gzip: 0.71 kB
-ℹ dist/example.js                          0.64 kB │ gzip: 0.38 kB
-ℹ dist/blueprint.js                        0.63 kB │ gzip: 0.38 kB
-ℹ dist/tenant.js                           0.60 kB │ gzip: 0.37 kB
-ℹ dist/agent.js                            0.58 kB │ gzip: 0.37 kB
-ℹ dist/source.sample.js                    0.48 kB │ gzip: 0.31 kB
-ℹ dist/index.js                            0.48 kB │ gzip: 0.22 kB
-ℹ dist/docs/index.js                       0.04 kB │ gzip: 0.06 kB
-ℹ dist/example.d.ts                        1.09 kB │ gzip: 0.45 kB
-ℹ dist/agent.d.ts                          0.90 kB │ gzip: 0.42 kB
-ℹ dist/index.d.ts                          0.44 kB │ gzip: 0.19 kB
-ℹ dist/source.sample.d.ts                  0.22 kB │ gzip: 0.16 kB
-ℹ dist/tenant.d.ts                         0.21 kB │ gzip: 0.15 kB
-ℹ dist/blueprint.d.ts                      0.21 kB │ gzip: 0.15 kB
-ℹ dist/docs/index.d.ts                     0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/knowledge-canon.docblock.d.ts  0.01 kB │ gzip: 0.03 kB
-ℹ 16 files, total: 8.01 kB
-✔ Build complete in 6227ms
-$ tsc --noEmit
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/knowledge-canon/tsdown.config.js 
+ℹ entry: src/agent.ts, src/blueprint.ts, src/example.ts, src/index.ts, src/source.sample.ts, src/tenant.ts, src/docs/index.ts, src/docs/knowledge-canon.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/docs/knowledge-canon.docblock.js                                           1.68 kB │ gzip: 0.78 kB
+ℹ dist/agent.js                                                                   1.20 kB │ gzip: 0.59 kB
+ℹ dist/example.js                                                                 0.86 kB │ gzip: 0.45 kB
+ℹ dist/blueprint.js                                                               0.80 kB │ gzip: 0.43 kB
+ℹ dist/tenant.js                                                                  0.77 kB │ gzip: 0.42 kB
+ℹ dist/source.sample.js                                                           0.65 kB │ gzip: 0.38 kB
+ℹ dist/index.js                                                                   0.50 kB │ gzip: 0.21 kB
+ℹ dist/docs/index.js                                                              0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.91 kB │ gzip: 7.23 kB
+ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   11.21 kB │ gzip: 4.33 kB
+ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.96 kB │ gzip: 3.83 kB
+ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.53 kB │ gzip: 3.50 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               9.22 kB │ gzip: 2.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           6.16 kB │ gzip: 2.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.85 kB │ gzip: 2.66 kB
+ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.66 kB │ gzip: 2.34 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.62 kB │ gzip: 2.13 kB
+ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 4.16 kB │ gzip: 1.78 kB
+ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.85 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.62 kB │ gzip: 1.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.60 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.33 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.30 kB │ gzip: 1.42 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.25 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   3.13 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.97 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.75 kB │ gzip: 1.22 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.40 kB │ gzip: 1.13 kB
+ℹ dist/libs/contracts/dist/docs/presentations.js                                  2.18 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                2.13 kB │ gzip: 1.02 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           2.04 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.96 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.85 kB │ gzip: 0.87 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.73 kB │ gzip: 0.82 kB
+ℹ dist/libs/contracts/dist/docs/index.js                                          1.58 kB │ gzip: 0.51 kB
+ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.46 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/registry.js                                       1.25 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          1.14 kB │ gzip: 0.65 kB
+ℹ dist/libs/contracts/dist/ownership.js                                           0.91 kB │ gzip: 0.46 kB
+ℹ dist/example.d.ts                                                               1.09 kB │ gzip: 0.45 kB
+ℹ dist/agent.d.ts                                                                 0.90 kB │ gzip: 0.42 kB
+ℹ dist/index.d.ts                                                                 0.44 kB │ gzip: 0.19 kB
+ℹ dist/source.sample.d.ts                                                         0.22 kB │ gzip: 0.16 kB
+ℹ dist/tenant.d.ts                                                                0.21 kB │ gzip: 0.15 kB
+ℹ dist/blueprint.d.ts                                                             0.21 kB │ gzip: 0.15 kB
+ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/knowledge-canon.docblock.d.ts                                         0.01 kB │ gzip: 0.03 kB
+ℹ 47 files, total: 143.31 kB
+✔ Build complete in 35181ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.knowledge-canon
 
-## 0.0.0-canary-20251217062943
+## 0.0.0-canary-20251217072406
 
 ### Minor Changes
 
@@ -9,4 +9,5 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/lib.contracts@0.0.0-canary-20251217062943
+  - @lssm/lib.contracts@0.0.0-canary-20251217072406
+  - @lssm/lib.schema@0.0.0-canary-20251217072406

package/dist/agent.js

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

package/dist/blueprint.js

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

package/dist/docs/index.js

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

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

@@ -1,18 +1,29 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.examples.knowledge-canon`,title:`Knowledge Example — Product Canon Space`,summary:`Bind the Product Canon KnowledgeSpaceSpec to a tenant and expose it to agents/workflows via ResolvedAppConfig.`,kind:`reference`,visibility:`public`,route:`/docs/examples/knowledge-canon`,tags:[`knowledge`,`canon`,`example`],body:`## Included assets
-- Blueprint referencing a workflow depending on the Product Canon space.
-- Tenant app config binding the space to a workflow and agent scope.
-- Sample knowledge source configuration.
-- Helper to pick knowledge bindings from ResolvedAppConfig.
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
 
-## 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.
+//#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.`
+}]);
 
-## Notes
-- Avoid logging PII.
-- Keep search results auditable and cite sources.`}]);
+//#endregion

package/dist/example.js

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

package/dist/index.js

@@ -1 +1,8 @@
-import{answerWithKnowledge as e,selectKnowledgeBindings as t}from"./agent.js";import{artisanKnowledgeBlueprint as n}from"./blueprint.js";import r from"./example.js";import{artisanKnowledgeTenantConfig as i}from"./tenant.js";import{productCanonNotionSource as a}from"./source.sample.js";import"./docs/index.js";export{e as answerWithKnowledge,n as artisanKnowledgeBlueprint,i as artisanKnowledgeTenantConfig,r as example,a as productCanonNotionSource,t as selectKnowledgeBindings};
+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/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -1,76 +1,16 @@
-import{a as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
-
-This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
-
-## Release Tracks
-
-| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
-|-------|--------|---------|-----------|------------|----------|
-| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
-| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
-
-## Prerequisites
-
-- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
-- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
-- ✅ For stable releases: \`release\` branch exists and is protected.
-
-## Canary Workflow (Automatic)
-
-Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
-
-1. **Trigger**: Push to \`main\`.
-2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
-3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
-
-### Consuming Canary Builds
-
-To install the latest bleeding-edge version:
-
-\`\`\`bash
-npm install @lssm/lib.contracts@canary
-# or
-bun add @lssm/lib.contracts@canary
-\`\`\`
-
-## Stable Release Workflow (Manual)
-
-Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
-
-1. **Develop on \`main\`**: Create features and fixes.
-2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
-3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
-4. **"Version Packages" PR**:
-   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
-   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
-5. **Merge & Publish**:
-   - Review and merge the "Version Packages" PR.
-   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
-
-### Publishing Steps
-
-1. Ensure all changesets are present on \`main\`.
-2. Merge \`main\` into \`release\`:
-   \`\`\`bash
-   git checkout release
-   git pull origin release
-   git merge main
-   git push origin release
-   \`\`\`
-3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
-4. Merge that PR.
-5. The release is now live on npm!
-
-## Manual Verification (Optional)
-
-Before publishing a new version you can run:
-
-\`\`\`bash
-bun run build:not-apps
-npx npm-packlist --json packages/libs/contracts
-\`\`\`
-
-## Rollback
-
-If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
-`}]);
+import { registerDocBlocks } from "./registry.js";
+
+//#region ../../libs/contracts/dist/docs/PUBLISHING.docblock.js
+const PUBLISHING_DocBlocks = [{
+	id: "docs.PUBLISHING",
+	title: "Publishing ContractSpec Libraries",
+	summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/PUBLISHING",
+	tags: ["PUBLISHING"],
+	body: "# Publishing ContractSpec Libraries\n\nThis guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).\n\n## Release Tracks\n\n| Track | Branch | npm Tag | Frequency | Versioning | Use Case |\n|-------|--------|---------|-----------|------------|----------|\n| **Stable** | `release` | `latest` | Manual | SemVer (e.g., `1.7.4`) | Production, external users |\n| **Canary** | `main` | `canary` | Every Push | Snapshot (e.g., `1.7.4-canary...`) | Dev, internal testing |\n\n## Prerequisites\n\n- ✅ `NPM_TOKEN` secret is configured in GitHub (owner or automation token with _publish_ scope).\n- ✅ `GITHUB_TOKEN` (built-in) has permissions to create PRs (enabled by default in new repos).\n- ✅ For stable releases: `release` branch exists and is protected.\n\n## Canary Workflow (Automatic)\n\nEvery commit pushed to `main` triggers the `.github/workflows/publish-canary.yml` workflow.\n\n1. **Trigger**: Push to `main`.\n2. **Versioning**: Runs `changeset version --snapshot canary` to generate a temporary snapshot version.\n3. **Publish**: Packages are published to npm with the `canary` tag using `changeset publish --tag canary`.\n\n### Consuming Canary Builds\n\nTo install the latest bleeding-edge version:\n\n```bash\nnpm install @lssm/lib.contracts@canary\n# or\nbun add @lssm/lib.contracts@canary\n```\n\n## Stable Release Workflow (Manual)\n\nStable releases are managed via the `release` branch using the standard [Changesets Action](https://github.com/changesets/action).\n\n1. **Develop on `main`**: Create features and fixes.\n2. **Add Changesets**: Run `bun changeset` to document changes and impact (major/minor/patch).\n3. **Merge to `release`**: When ready to ship, open a PR from `main` to `release` or merge manually.\n4. **\"Version Packages\" PR**:\n   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **\"Version Packages\"**.\n   - This PR contains the version bumps and updated `CHANGELOG.md` files.\n5. **Merge & Publish**:\n   - Review and merge the \"Version Packages\" PR.\n   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the `latest` tag.\n\n### Publishing Steps\n\n1. Ensure all changesets are present on `main`.\n2. Merge `main` into `release`:\n   ```bash\n   git checkout release\n   git pull origin release\n   git merge main\n   git push origin release\n   ```\n3. Go to GitHub Pull Requests. You will see a **\"Version Packages\"** PR created by the bot.\n4. Merge that PR.\n5. The release is now live on npm!\n\n## Manual Verification (Optional)\n\nBefore publishing a new version you can run:\n\n```bash\nbun run build:not-apps\nnpx npm-packlist --json packages/libs/contracts\n```\n\n## Rollback\n\nIf a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use `npm deprecate <package>@<version>` if we need to warn consumers about a broken release.\n"
+}];
+registerDocBlocks(PUBLISHING_DocBlocks);
+
+//#endregion