@contractspec/example.knowledge-canon 1.57.0 → 1.58.0

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

@@ -1 +0,0 @@
-{"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.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\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,MAAM,UAAU,cAAc;CAC5B,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,CAAC"}

package/dist/source.sample.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"source.sample.js","names":[],"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,MAAa,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.map

@@ -1 +0,0 @@
-{"version":3,"file":"tenant.js","names":[],"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,MAAa,+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"}