@lssm/lib.contracts 1.2.0

package/dist/knowledge/query/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","names":[],"sources":["../../../src/knowledge/query/service.ts"],"sourcesContent":["import type { EmbeddingProvider } from '../../integrations/providers/embedding';\nimport type {\n  VectorStoreProvider,\n  VectorSearchResult,\n} from '../../integrations/providers/vector-store';\nimport type { LLMProvider, LLMMessage, LLMResponse } from '../../integrations/providers/llm';\n\nexport interface KnowledgeQueryConfig {\n  collection: string;\n  namespace?: string;\n  topK?: number;\n  systemPrompt?: string;\n}\n\nexport interface KnowledgeAnswer {\n  answer: string;\n  references: Array<\n    VectorSearchResult & {\n      text?: string;\n    }\n  >;\n  usage?: LLMResponse['usage'];\n}\n\nexport class KnowledgeQueryService {\n  private readonly embeddings: EmbeddingProvider;\n  private readonly vectorStore: VectorStoreProvider;\n  private readonly llm: LLMProvider;\n  private readonly config: KnowledgeQueryConfig;\n\n  constructor(\n    embeddings: EmbeddingProvider,\n    vectorStore: VectorStoreProvider,\n    llm: LLMProvider,\n    config: KnowledgeQueryConfig\n  ) {\n    this.embeddings = embeddings;\n    this.vectorStore = vectorStore;\n    this.llm = llm;\n    this.config = config;\n  }\n\n  async query(question: string): Promise<KnowledgeAnswer> {\n    const embedding = await this.embeddings.embedQuery(question);\n    const results = await this.vectorStore.search({\n      collection: this.config.collection,\n      vector: embedding.vector,\n      topK: this.config.topK ?? 5,\n      namespace: this.config.namespace,\n      filter: undefined,\n    });\n    const context = buildContext(results);\n    const messages = this.buildMessages(question, context);\n    const response = await this.llm.chat(messages);\n    return {\n      answer: response.message.content\n        .map((part) => ('text' in part ? part.text : ''))\n        .join(''),\n      references: results.map((result) => ({\n        ...result,\n        text: extractText(result),\n      })),\n      usage: response.usage,\n    };\n  }\n\n  private buildMessages(question: string, context: string): LLMMessage[] {\n    const systemPrompt =\n      this.config.systemPrompt ??\n      'You are a knowledge assistant that answers questions using the provided context. Cite relevant sources if possible.';\n    return [\n      {\n        role: 'system',\n        content: [{ type: 'text', text: systemPrompt }],\n      },\n      {\n        role: 'user',\n        content: [\n          {\n            type: 'text',\n            text: `Question:\\n${question}\\n\\nContext:\\n${context}`,\n          },\n        ],\n      },\n    ];\n  }\n}\n\nfunction buildContext(results: VectorSearchResult[]): string {\n  if (results.length === 0) {\n    return 'No relevant documents found.';\n  }\n  return results\n    .map((result, index) => {\n      const text = extractText(result);\n      return `Source ${index + 1} (score: ${result.score.toFixed(3)}):\\n${text}`;\n    })\n    .join('\\n\\n');\n}\n\nfunction extractText(result: VectorSearchResult): string {\n  const payload = result.payload ?? {};\n  if (typeof payload.text === 'string') return payload.text;\n  if (typeof payload.content === 'string') return payload.content;\n  return JSON.stringify(payload);\n}\n\n\n"],"mappings":"AAwBA,IAAa,EAAb,KAAmC,CACjC,WACA,YACA,IACA,OAEA,YACE,EACA,EACA,EACA,EACA,CACA,KAAK,WAAa,EAClB,KAAK,YAAc,EACnB,KAAK,IAAM,EACX,KAAK,OAAS,EAGhB,MAAM,MAAM,EAA4C,CACtD,IAAM,EAAY,MAAM,KAAK,WAAW,WAAW,EAAS,CACtD,EAAU,MAAM,KAAK,YAAY,OAAO,CAC5C,WAAY,KAAK,OAAO,WACxB,OAAQ,EAAU,OAClB,KAAM,KAAK,OAAO,MAAQ,EAC1B,UAAW,KAAK,OAAO,UACvB,OAAQ,IAAA,GACT,CAAC,CACI,EAAU,EAAa,EAAQ,CAC/B,EAAW,KAAK,cAAc,EAAU,EAAQ,CAChD,EAAW,MAAM,KAAK,IAAI,KAAK,EAAS,CAC9C,MAAO,CACL,OAAQ,EAAS,QAAQ,QACtB,IAAK,GAAU,SAAU,EAAO,EAAK,KAAO,GAAI,CAChD,KAAK,GAAG,CACX,WAAY,EAAQ,IAAK,IAAY,CACnC,GAAG,EACH,KAAM,EAAY,EAAO,CAC1B,EAAE,CACH,MAAO,EAAS,MACjB,CAGH,cAAsB,EAAkB,EAA+B,CAIrE,MAAO,CACL,CACE,KAAM,SACN,QAAS,CAAC,CAAE,KAAM,OAAQ,KAL5B,KAAK,OAAO,cACZ,sHAIgD,CAAC,CAChD,CACD,CACE,KAAM,OACN,QAAS,CACP,CACE,KAAM,OACN,KAAM,cAAc,EAAS,gBAAgB,IAC9C,CACF,CACF,CACF,GAIL,SAAS,EAAa,EAAuC,CAI3D,OAHI,EAAQ,SAAW,EACd,+BAEF,EACJ,KAAK,EAAQ,IAAU,CACtB,IAAM,EAAO,EAAY,EAAO,CAChC,MAAO,UAAU,EAAQ,EAAE,WAAW,EAAO,MAAM,QAAQ,EAAE,CAAC,MAAM,KACpE,CACD,KAAK;;EAAO,CAGjB,SAAS,EAAY,EAAoC,CACvD,IAAM,EAAU,EAAO,SAAW,EAAE,CAGpC,OAFI,OAAO,EAAQ,MAAS,SAAiB,EAAQ,KACjD,OAAO,EAAQ,SAAY,SAAiB,EAAQ,QACjD,KAAK,UAAU,EAAQ"}

package/dist/knowledge/runtime.d.ts

@@ -0,0 +1,33 @@
+import { KnowledgeCategory } from "./spec.js";
+import { ResolvedAppConfig, ResolvedKnowledge } from "../app-config/runtime.js";
+
+//#region src/knowledge/runtime.d.ts
+interface KnowledgeAccessContext {
+  tenantId: string;
+  appId: string;
+  environment?: string;
+  workflowName?: string;
+  agentName?: string;
+  operation: 'read' | 'write' | 'search';
+}
+interface KnowledgeAccessResult {
+  allowed: boolean;
+  reason?: string;
+  severity?: 'error' | 'warning';
+}
+interface KnowledgeAccessGuardOptions {
+  disallowWriteCategories?: KnowledgeCategory[];
+  requireWorkflowBinding?: boolean;
+  requireAgentBinding?: boolean;
+}
+declare class KnowledgeAccessGuard {
+  private readonly disallowedWrite;
+  private readonly requireWorkflowBinding;
+  private readonly requireAgentBinding;
+  constructor(options?: KnowledgeAccessGuardOptions);
+  checkAccess(spaceBinding: ResolvedKnowledge, context: KnowledgeAccessContext, appConfig: ResolvedAppConfig): KnowledgeAccessResult;
+  private isSpaceBound;
+}
+//#endregion
+export { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/knowledge/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/knowledge/runtime.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,sBAAA;;EAAA,KAAA,EAAA,MAAA;EASA,WAAA,CAAA,EAAA,MAAA;EAMA,YAAA,CAAA,EAAA,MAAA;EAQJ,SAAA,CAAA,EAAA,MAAA;EAKU,SAAA,EAAA,MAAA,GAAA,OAAA,GAAA,QAAA;;AAUV,UA7BI,qBAAA,CA6BJ;EACE,OAAA,EAAA,OAAA;EACV,MAAA,CAAA,EAAA,MAAA;EAAqB,QAAA,CAAA,EAAA,OAAA,GAAA,SAAA;;UAzBT,2BAAA;4BACW;;;;cAOf,oBAAA;;;;wBAKU;4BASL,4BACL,mCACE,oBACV"}

package/dist/knowledge/runtime.js

@@ -0,0 +1,2 @@
+const e=[`external`,`ephemeral`];var t=class{disallowedWrite;requireWorkflowBinding;requireAgentBinding;constructor(t={}){this.disallowedWrite=new Set(t.disallowWriteCategories??e),this.requireWorkflowBinding=t.requireWorkflowBinding??!0,this.requireAgentBinding=t.requireAgentBinding??!1}checkAccess(e,t,n){let{binding:r,space:i}=e;if(r.required!==!1&&!this.isSpaceBound(e,n))return{allowed:!1,reason:`Knowledge space "${i.meta.key}" is not bound in the resolved app config.`};if(t.operation===`write`&&this.disallowedWrite.has(i.meta.category))return{allowed:!1,reason:`Knowledge space "${i.meta.key}" is category "${i.meta.category}" and is read-only.`};if(this.requireWorkflowBinding&&t.workflowName){let e=r.scope?.workflows;if(e&&!e.includes(t.workflowName))return{allowed:!1,reason:`Workflow "${t.workflowName}" is not authorized to access knowledge space "${i.meta.key}".`}}if(this.requireAgentBinding&&t.agentName){let e=r.scope?.agents;if(e&&!e.includes(t.agentName))return{allowed:!1,reason:`Agent "${t.agentName}" is not authorized to access knowledge space "${i.meta.key}".`}}return i.meta.category===`ephemeral`?{allowed:!0,severity:`warning`,reason:`Knowledge space "${i.meta.key}" is ephemeral; results may be transient.`}:{allowed:!0}}isSpaceBound(e,t){return t.knowledge.some(t=>t.space.meta.key===e.space.meta.key&&(e.space.meta.version==null||t.space.meta.version===e.space.meta.version))}};export{t as KnowledgeAccessGuard};
+//# sourceMappingURL=runtime.js.map

package/dist/knowledge/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["DEFAULT_DISALLOWED_WRITE: KnowledgeCategory[]"],"sources":["../../src/knowledge/runtime.ts"],"sourcesContent":["import type { ResolvedAppConfig, ResolvedKnowledge } from '../app-config/runtime';\nimport type { KnowledgeCategory } from './spec';\n\nexport interface KnowledgeAccessContext {\n  tenantId: string;\n  appId: string;\n  environment?: string;\n  workflowName?: string;\n  agentName?: string;\n  operation: 'read' | 'write' | 'search';\n}\n\nexport interface KnowledgeAccessResult {\n  allowed: boolean;\n  reason?: string;\n  severity?: 'error' | 'warning';\n}\n\nexport interface KnowledgeAccessGuardOptions {\n  disallowWriteCategories?: KnowledgeCategory[];\n  requireWorkflowBinding?: boolean;\n  requireAgentBinding?: boolean;\n}\n\nconst DEFAULT_DISALLOWED_WRITE: KnowledgeCategory[] = ['external', 'ephemeral'];\n\nexport class KnowledgeAccessGuard {\n  private readonly disallowedWrite: Set<KnowledgeCategory>;\n  private readonly requireWorkflowBinding: boolean;\n  private readonly requireAgentBinding: boolean;\n\n  constructor(options: KnowledgeAccessGuardOptions = {}) {\n    this.disallowedWrite = new Set(\n      options.disallowWriteCategories ?? DEFAULT_DISALLOWED_WRITE\n    );\n    this.requireWorkflowBinding = options.requireWorkflowBinding ?? true;\n    this.requireAgentBinding = options.requireAgentBinding ?? false;\n  }\n\n  checkAccess(\n    spaceBinding: ResolvedKnowledge,\n    context: KnowledgeAccessContext,\n    appConfig: ResolvedAppConfig\n  ): KnowledgeAccessResult {\n    const { binding, space } = spaceBinding;\n\n    if (binding.required !== false && !this.isSpaceBound(spaceBinding, appConfig)) {\n      return {\n        allowed: false,\n        reason: `Knowledge space \"${space.meta.key}\" is not bound in the resolved app config.`,\n      };\n    }\n\n    if (\n      context.operation === 'write' &&\n      this.disallowedWrite.has(space.meta.category)\n    ) {\n      return {\n        allowed: false,\n        reason: `Knowledge space \"${space.meta.key}\" is category \"${space.meta.category}\" and is read-only.`,\n      };\n    }\n\n    if (this.requireWorkflowBinding && context.workflowName) {\n      const allowedWorkflows = binding.scope?.workflows;\n      if (allowedWorkflows && !allowedWorkflows.includes(context.workflowName)) {\n        return {\n          allowed: false,\n          reason: `Workflow \"${context.workflowName}\" is not authorized to access knowledge space \"${space.meta.key}\".`,\n        };\n      }\n    }\n\n    if (this.requireAgentBinding && context.agentName) {\n      const allowedAgents = binding.scope?.agents;\n      if (allowedAgents && !allowedAgents.includes(context.agentName)) {\n        return {\n          allowed: false,\n          reason: `Agent \"${context.agentName}\" is not authorized to access knowledge space \"${space.meta.key}\".`,\n        };\n      }\n    }\n\n    if (space.meta.category === 'ephemeral') {\n      return {\n        allowed: true,\n        severity: 'warning',\n        reason: `Knowledge space \"${space.meta.key}\" is ephemeral; results may be transient.`,\n      };\n    }\n\n    return { allowed: true };\n  }\n\n  private isSpaceBound(\n    resolved: ResolvedKnowledge,\n    appConfig: ResolvedAppConfig\n  ): boolean {\n    return appConfig.knowledge.some(\n      (entry) =>\n        entry.space.meta.key === resolved.space.meta.key &&\n        (resolved.space.meta.version == null ||\n          entry.space.meta.version === resolved.space.meta.version)\n    );\n  }\n}\n\n\n\n\n"],"mappings":"AAwBA,MAAMA,EAAgD,CAAC,WAAY,YAAY,CAE/E,IAAa,EAAb,KAAkC,CAChC,gBACA,uBACA,oBAEA,YAAY,EAAuC,EAAE,CAAE,CACrD,KAAK,gBAAkB,IAAI,IACzB,EAAQ,yBAA2B,EACpC,CACD,KAAK,uBAAyB,EAAQ,wBAA0B,GAChE,KAAK,oBAAsB,EAAQ,qBAAuB,GAG5D,YACE,EACA,EACA,EACuB,CACvB,GAAM,CAAE,UAAS,SAAU,EAE3B,GAAI,EAAQ,WAAa,IAAS,CAAC,KAAK,aAAa,EAAc,EAAU,CAC3E,MAAO,CACL,QAAS,GACT,OAAQ,oBAAoB,EAAM,KAAK,IAAI,4CAC5C,CAGH,GACE,EAAQ,YAAc,SACtB,KAAK,gBAAgB,IAAI,EAAM,KAAK,SAAS,CAE7C,MAAO,CACL,QAAS,GACT,OAAQ,oBAAoB,EAAM,KAAK,IAAI,iBAAiB,EAAM,KAAK,SAAS,qBACjF,CAGH,GAAI,KAAK,wBAA0B,EAAQ,aAAc,CACvD,IAAM,EAAmB,EAAQ,OAAO,UACxC,GAAI,GAAoB,CAAC,EAAiB,SAAS,EAAQ,aAAa,CACtE,MAAO,CACL,QAAS,GACT,OAAQ,aAAa,EAAQ,aAAa,iDAAiD,EAAM,KAAK,IAAI,IAC3G,CAIL,GAAI,KAAK,qBAAuB,EAAQ,UAAW,CACjD,IAAM,EAAgB,EAAQ,OAAO,OACrC,GAAI,GAAiB,CAAC,EAAc,SAAS,EAAQ,UAAU,CAC7D,MAAO,CACL,QAAS,GACT,OAAQ,UAAU,EAAQ,UAAU,iDAAiD,EAAM,KAAK,IAAI,IACrG,CAYL,OARI,EAAM,KAAK,WAAa,YACnB,CACL,QAAS,GACT,SAAU,UACV,OAAQ,oBAAoB,EAAM,KAAK,IAAI,2CAC5C,CAGI,CAAE,QAAS,GAAM,CAG1B,aACE,EACA,EACS,CACT,OAAO,EAAU,UAAU,KACxB,GACC,EAAM,MAAM,KAAK,MAAQ,EAAS,MAAM,KAAK,MAC5C,EAAS,MAAM,KAAK,SAAW,MAC9B,EAAM,MAAM,KAAK,UAAY,EAAS,MAAM,KAAK,SACtD"}

package/dist/knowledge/source.d.ts

@@ -0,0 +1,33 @@
+//#region src/knowledge/source.d.ts
+type KnowledgeSourceType = 'notion' | 'url' | 'file_upload' | 'email' | 'api' | 'manual';
+interface KnowledgeSourceMeta {
+  id: string;
+  tenantId: string;
+  spaceKey: string;
+  spaceVersion: number;
+  label: string;
+  sourceType: KnowledgeSourceType;
+  createdAt: string | Date;
+  updatedAt: string | Date;
+}
+interface KnowledgeSourceConfig {
+  meta: KnowledgeSourceMeta;
+  /** Source-specific configuration (URLs, credentials, filters). */
+  config: Record<string, unknown>;
+  /** Sync schedule (cron or interval). */
+  syncSchedule?: {
+    enabled: boolean;
+    cron?: string;
+    intervalMs?: number;
+  };
+  /** Last sync status. */
+  lastSync?: {
+    timestamp: Date;
+    success: boolean;
+    itemsProcessed?: number;
+    error?: string;
+  };
+}
+//#endregion
+export { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType };
+//# sourceMappingURL=source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","names":[],"sources":["../../src/knowledge/source.ts"],"sourcesContent":[],"mappings":";KAAY,mBAAA;AAAA,UAQK,mBAAA,CARc;EAQd,EAAA,EAAA,MAAA;EAMH,QAAA,EAAA,MAAA;EACQ,QAAA,EAAA,MAAA;EACA,YAAA,EAAA,MAAA;EAAI,KAAA,EAAA,MAAA;EAGT,UAAA,EALH,mBAKwB;EAC9B,SAAA,EAAA,MAAA,GALc,IAKd;EAEE,SAAA,EAAA,MAAA,GANY,IAMZ;;AASS,UAZF,qBAAA,CAYE;QAXX;;UAEE;;;;;;;;;eASK"}

package/dist/knowledge/spaces/email-threads.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/email-threads.d.ts
+declare const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerEmailThreadsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace };
+//# sourceMappingURL=email-threads.d.ts.map

package/dist/knowledge/spaces/email-threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.d.ts","names":[],"sources":["../../../src/knowledge/spaces/email-threads.ts"],"sourcesContent":[],"mappings":";;;cAGa,4BAA4B;iBA+BzB,kCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/email-threads.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.email-threads`,version:1,category:`operational`,displayName:`Email Threads`,title:`Operational Email Threads`,description:`Indexed copies of operational email threads used for support, onboarding, and workflows.`,domain:`operations`,owners:[`platform.operations`],tags:[`email`,`operations`],stability:e.Beta},retention:{ttlDays:365},access:{policy:{name:`knowledge.access.email-threads`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:600,vectorDbIntegration:`vectordb.qdrant`},description:`Operational email threads synchronized from Gmail to support automations and contextual assistance.`};function n(e){return e.register(t)}export{t as emailThreadsKnowledgeSpace,n as registerEmailThreadsKnowledgeSpace};
+//# sourceMappingURL=email-threads.js.map

package/dist/knowledge/spaces/email-threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-threads.js","names":["emailThreadsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/email-threads.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const emailThreadsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.email-threads',\n    version: 1,\n    category: 'operational',\n    displayName: 'Email Threads',\n    title: 'Operational Email Threads',\n    description:\n      'Indexed copies of operational email threads used for support, onboarding, and workflows.',\n    domain: 'operations',\n    owners: ['platform.operations'],\n    tags: ['email', 'operations'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: 365,\n  },\n  access: {\n    policy: { name: 'knowledge.access.email-threads', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 600,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Operational email threads synchronized from Gmail to support automations and contextual assistance.',\n};\n\nexport function registerEmailThreadsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(emailThreadsKnowledgeSpace);\n}\n\n\n"],"mappings":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,cACV,YAAa,gBACb,MAAO,4BACP,YACE,2FACF,OAAQ,aACR,OAAQ,CAAC,sBAAsB,CAC/B,KAAM,CAAC,QAAS,aAAa,CAC7B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,IACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,sGACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

package/dist/knowledge/spaces/financial-docs.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/financial-docs.d.ts
+declare const financialDocsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerFinancialDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace };
+//# sourceMappingURL=financial-docs.d.ts.map

package/dist/knowledge/spaces/financial-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-docs.d.ts","names":[],"sources":["../../../src/knowledge/spaces/financial-docs.ts"],"sourcesContent":[],"mappings":";;;cAGa,6BAA6B;iBA+B1B,mCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/financial-docs.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.financial-docs`,version:1,category:`canonical`,displayName:`Financial Documents`,title:`Household Financial Documents`,description:`Invoices, bills, and contracts powering Pocket Family Office financial automation.`,domain:`finance`,owners:[`platform.finance`],tags:[`finance`,`documents`],stability:e.Beta},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.financial-docs`,version:1},trustLevel:`high`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:700,vectorDbIntegration:`vectordb.qdrant`},description:`Normalized financial documents enabling bill pay automation, reminders, and summaries.`};function n(e){return e.register(t)}export{t as financialDocsKnowledgeSpace,n as registerFinancialDocsKnowledgeSpace};
+//# sourceMappingURL=financial-docs.js.map

package/dist/knowledge/spaces/financial-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-docs.js","names":["financialDocsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/financial-docs.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const financialDocsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.financial-docs',\n    version: 1,\n    category: 'canonical',\n    displayName: 'Financial Documents',\n    title: 'Household Financial Documents',\n    description:\n      'Invoices, bills, and contracts powering Pocket Family Office financial automation.',\n    domain: 'finance',\n    owners: ['platform.finance'],\n    tags: ['finance', 'documents'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.financial-docs', version: 1 },\n    trustLevel: 'high',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 700,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Normalized financial documents enabling bill pay automation, reminders, and summaries.',\n};\n\nexport function registerFinancialDocsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(financialDocsKnowledgeSpace);\n}\n\n\n"],"mappings":"mDAGA,MAAaA,EAAkD,CAC7D,KAAM,CACJ,IAAK,2BACL,QAAS,EACT,SAAU,YACV,YAAa,sBACb,MAAO,gCACP,YACE,qFACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,UAAW,YAAY,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,kCAAmC,QAAS,EAAG,CAC/D,WAAY,OACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,yFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA4B"}

package/dist/knowledge/spaces/financial-overview.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/financial-overview.d.ts
+declare const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerFinancialOverviewKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace };
+//# sourceMappingURL=financial-overview.d.ts.map

package/dist/knowledge/spaces/financial-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-overview.d.ts","names":[],"sources":["../../../src/knowledge/spaces/financial-overview.ts"],"sourcesContent":[],"mappings":";;;cAGa,iCAAiC;iBA+B9B,uCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/financial-overview.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.financial-overview`,version:1,category:`operational`,displayName:`Financial Overview Summaries`,title:`Derived Financial Summaries`,description:`Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.`,domain:`finance`,owners:[`platform.finance`],tags:[`open-banking`,`summaries`,`cashflow`],stability:e.Experimental},retention:{ttlDays:180},access:{policy:{name:`knowledge.access.financial-overview`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:600,vectorDbIntegration:`vectordb.qdrant`},description:`Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails.`};function n(e){return e.register(t)}export{t as financialOverviewKnowledgeSpace,n as registerFinancialOverviewKnowledgeSpace};
+//# sourceMappingURL=financial-overview.js.map

package/dist/knowledge/spaces/financial-overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financial-overview.js","names":["financialOverviewKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/financial-overview.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const financialOverviewKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.financial-overview',\n    version: 1,\n    category: 'operational',\n    displayName: 'Financial Overview Summaries',\n    title: 'Derived Financial Summaries',\n    description:\n      'Aggregated cashflow summaries, category breakdowns, and balance trends derived from open banking data.',\n    domain: 'finance',\n    owners: ['platform.finance'],\n    tags: ['open-banking', 'summaries', 'cashflow'],\n    stability: StabilityEnum.Experimental,\n  },\n  retention: {\n    ttlDays: 180,\n  },\n  access: {\n    policy: { name: 'knowledge.access.financial-overview', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 600,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Derived knowledge space containing weekly/monthly cashflow rollups and account health summaries. Raw transactions are excluded to respect privacy guardrails.',\n};\n\nexport function registerFinancialOverviewKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(financialOverviewKnowledgeSpace);\n}\n\n"],"mappings":"mDAGA,MAAaA,EAAsD,CACjE,KAAM,CACJ,IAAK,+BACL,QAAS,EACT,SAAU,cACV,YAAa,+BACb,MAAO,8BACP,YACE,yGACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,eAAgB,YAAa,WAAW,CAC/C,UAAW,EAAc,aAC1B,CACD,UAAW,CACT,QAAS,IACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,sCAAuC,QAAS,EAAG,CACnE,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,gKACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAAgC"}

package/dist/knowledge/spaces/index.d.ts

@@ -0,0 +1,7 @@
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./financial-overview.js";
+export { emailThreadsKnowledgeSpace, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, productCanonKnowledgeSpace, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, supportFaqKnowledgeSpace, uploadedDocsKnowledgeSpace };

package/dist/knowledge/spaces/index.js

@@ -0,0 +1 @@
+import{productCanonKnowledgeSpace as e,registerProductCanonKnowledgeSpace as t}from"./product-canon.js";import{registerSupportFaqKnowledgeSpace as n,supportFaqKnowledgeSpace as r}from"./support-faq.js";import{emailThreadsKnowledgeSpace as i,registerEmailThreadsKnowledgeSpace as a}from"./email-threads.js";import{registerUploadedDocsKnowledgeSpace as o,uploadedDocsKnowledgeSpace as s}from"./uploaded-docs.js";import{financialDocsKnowledgeSpace as c,registerFinancialDocsKnowledgeSpace as l}from"./financial-docs.js";import{financialOverviewKnowledgeSpace as u,registerFinancialOverviewKnowledgeSpace as d}from"./financial-overview.js";export{i as emailThreadsKnowledgeSpace,c as financialDocsKnowledgeSpace,u as financialOverviewKnowledgeSpace,e as productCanonKnowledgeSpace,a as registerEmailThreadsKnowledgeSpace,l as registerFinancialDocsKnowledgeSpace,d as registerFinancialOverviewKnowledgeSpace,t as registerProductCanonKnowledgeSpace,n as registerSupportFaqKnowledgeSpace,o as registerUploadedDocsKnowledgeSpace,r as supportFaqKnowledgeSpace,s as uploadedDocsKnowledgeSpace};

package/dist/knowledge/spaces/product-canon.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/product-canon.d.ts
+declare const productCanonKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerProductCanonKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace };
+//# sourceMappingURL=product-canon.d.ts.map

package/dist/knowledge/spaces/product-canon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-canon.d.ts","names":[],"sources":["../../../src/knowledge/spaces/product-canon.ts"],"sourcesContent":[],"mappings":";;;cAGa,4BAA4B;iBA+BzB,kCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/product-canon.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.product-canon`,version:1,category:`canonical`,displayName:`Product Canon`,title:`Product Canon Knowledge Space`,description:`Authoritative product knowledge covering strategy, roadmap, and delivery canon.`,domain:`product`,owners:[`platform.product`],tags:[`knowledge`,`product`],stability:e.Stable},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.product-canon`,version:1},trustLevel:`high`,automationWritable:!1},indexing:{embeddingModel:`text-embedding-3-large`,chunkSize:800,vectorDbIntegration:`vectordb.qdrant`},description:`Single source of truth for product canon, principles, and strategic narratives.`};function n(e){return e.register(t)}export{t as productCanonKnowledgeSpace,n as registerProductCanonKnowledgeSpace};
+//# sourceMappingURL=product-canon.js.map

package/dist/knowledge/spaces/product-canon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-canon.js","names":["productCanonKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/product-canon.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const productCanonKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.product-canon',\n    version: 1,\n    category: 'canonical',\n    displayName: 'Product Canon',\n    title: 'Product Canon Knowledge Space',\n    description:\n      'Authoritative product knowledge covering strategy, roadmap, and delivery canon.',\n    domain: 'product',\n    owners: ['platform.product'],\n    tags: ['knowledge', 'product'],\n    stability: StabilityEnum.Stable,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.product-canon', version: 1 },\n    trustLevel: 'high',\n    automationWritable: false,\n  },\n  indexing: {\n    embeddingModel: 'text-embedding-3-large',\n    chunkSize: 800,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Single source of truth for product canon, principles, and strategic narratives.',\n};\n\nexport function registerProductCanonKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(productCanonKnowledgeSpace);\n}\n\n\n\n"],"mappings":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,YACV,YAAa,gBACb,MAAO,gCACP,YACE,kFACF,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,OAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,OACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,yBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,kFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

package/dist/knowledge/spaces/support-faq.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/support-faq.d.ts
+declare const supportFaqKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerSupportFaqKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace };
+//# sourceMappingURL=support-faq.d.ts.map

package/dist/knowledge/spaces/support-faq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-faq.d.ts","names":[],"sources":["../../../src/knowledge/spaces/support-faq.ts"],"sourcesContent":[],"mappings":";;;cAGa,0BAA0B;iBA+BvB,gCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/support-faq.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.support-faq`,version:1,category:`operational`,displayName:`Support FAQ`,title:`Support & Success FAQ`,description:`Operational knowledge base for customer support and success.`,domain:`support`,owners:[`platform.support`],tags:[`knowledge`,`support`],stability:e.Beta},retention:{ttlDays:365,archiveAfterDays:180},access:{policy:{name:`knowledge.access.support`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`text-embedding-3-small`,chunkSize:700,vectorDbIntegration:`vectordb.qdrant`},description:`Operational FAQs, runbooks, and customer success playbooks augmented with automation updates.`};function n(e){return e.register(t)}export{n as registerSupportFaqKnowledgeSpace,t as supportFaqKnowledgeSpace};
+//# sourceMappingURL=support-faq.js.map

package/dist/knowledge/spaces/support-faq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-faq.js","names":["supportFaqKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/support-faq.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const supportFaqKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.support-faq',\n    version: 1,\n    category: 'operational',\n    displayName: 'Support FAQ',\n    title: 'Support & Success FAQ',\n    description: 'Operational knowledge base for customer support and success.',\n    domain: 'support',\n    owners: ['platform.support'],\n    tags: ['knowledge', 'support'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: 365,\n    archiveAfterDays: 180,\n  },\n  access: {\n    policy: { name: 'knowledge.access.support', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'text-embedding-3-small',\n    chunkSize: 700,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'Operational FAQs, runbooks, and customer success playbooks augmented with automation updates.',\n};\n\nexport function registerSupportFaqKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(supportFaqKnowledgeSpace);\n}\n\n\n\n"],"mappings":"mDAGA,MAAaA,EAA+C,CAC1D,KAAM,CACJ,IAAK,wBACL,QAAS,EACT,SAAU,cACV,YAAa,cACb,MAAO,wBACP,YAAa,+DACb,OAAQ,UACR,OAAQ,CAAC,mBAAmB,CAC5B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,IACT,iBAAkB,IACnB,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,2BAA4B,QAAS,EAAG,CACxD,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,yBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,gGACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAAyB"}

package/dist/knowledge/spaces/uploaded-docs.d.ts

@@ -0,0 +1,8 @@
+import { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from "../spec.js";
+
+//#region src/knowledge/spaces/uploaded-docs.d.ts
+declare const uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec;
+declare function registerUploadedDocsKnowledgeSpace(registry: KnowledgeSpaceRegistry): KnowledgeSpaceRegistry;
+//#endregion
+export { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace };
+//# sourceMappingURL=uploaded-docs.d.ts.map

package/dist/knowledge/spaces/uploaded-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploaded-docs.d.ts","names":[],"sources":["../../../src/knowledge/spaces/uploaded-docs.ts"],"sourcesContent":[],"mappings":";;;cAGa,4BAA4B;iBA+BzB,kCAAA,WACJ,yBACT"}

package/dist/knowledge/spaces/uploaded-docs.js

@@ -0,0 +1,2 @@
+import{StabilityEnum as e}from"../../ownership.js";const t={meta:{key:`knowledge.uploaded-docs`,version:1,category:`external`,displayName:`Uploaded Documents`,title:`Uploaded Knowledge Assets`,description:`Documents uploaded by households, including invoices, contracts, and reference files.`,domain:`operations`,owners:[`platform.operations`],tags:[`documents`,`storage`],stability:e.Beta},retention:{ttlDays:null},access:{policy:{name:`knowledge.access.uploaded-docs`,version:1},trustLevel:`medium`,automationWritable:!0},indexing:{embeddingModel:`mistral-embed`,chunkSize:900,vectorDbIntegration:`vectordb.qdrant`},description:`User-provided documents normalized and embedded for retrieval augmented workflows.`};function n(e){return e.register(t)}export{n as registerUploadedDocsKnowledgeSpace,t as uploadedDocsKnowledgeSpace};
+//# sourceMappingURL=uploaded-docs.js.map

package/dist/knowledge/spaces/uploaded-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploaded-docs.js","names":["uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec"],"sources":["../../../src/knowledge/spaces/uploaded-docs.ts"],"sourcesContent":["import { StabilityEnum } from '../../ownership';\nimport type { KnowledgeSpaceRegistry, KnowledgeSpaceSpec } from '../spec';\n\nexport const uploadedDocsKnowledgeSpace: KnowledgeSpaceSpec = {\n  meta: {\n    key: 'knowledge.uploaded-docs',\n    version: 1,\n    category: 'external',\n    displayName: 'Uploaded Documents',\n    title: 'Uploaded Knowledge Assets',\n    description:\n      'Documents uploaded by households, including invoices, contracts, and reference files.',\n    domain: 'operations',\n    owners: ['platform.operations'],\n    tags: ['documents', 'storage'],\n    stability: StabilityEnum.Beta,\n  },\n  retention: {\n    ttlDays: null,\n  },\n  access: {\n    policy: { name: 'knowledge.access.uploaded-docs', version: 1 },\n    trustLevel: 'medium',\n    automationWritable: true,\n  },\n  indexing: {\n    embeddingModel: 'mistral-embed',\n    chunkSize: 900,\n    vectorDbIntegration: 'vectordb.qdrant',\n  },\n  description:\n    'User-provided documents normalized and embedded for retrieval augmented workflows.',\n};\n\nexport function registerUploadedDocsKnowledgeSpace(\n  registry: KnowledgeSpaceRegistry\n): KnowledgeSpaceRegistry {\n  return registry.register(uploadedDocsKnowledgeSpace);\n}\n\n\n"],"mappings":"mDAGA,MAAaA,EAAiD,CAC5D,KAAM,CACJ,IAAK,0BACL,QAAS,EACT,SAAU,WACV,YAAa,qBACb,MAAO,4BACP,YACE,wFACF,OAAQ,aACR,OAAQ,CAAC,sBAAsB,CAC/B,KAAM,CAAC,YAAa,UAAU,CAC9B,UAAW,EAAc,KAC1B,CACD,UAAW,CACT,QAAS,KACV,CACD,OAAQ,CACN,OAAQ,CAAE,KAAM,iCAAkC,QAAS,EAAG,CAC9D,WAAY,SACZ,mBAAoB,GACrB,CACD,SAAU,CACR,eAAgB,gBAChB,UAAW,IACX,oBAAqB,kBACtB,CACD,YACE,qFACH,CAED,SAAgB,EACd,EACwB,CACxB,OAAO,EAAS,SAAS,EAA2B"}

package/dist/knowledge/spec.d.ts

@@ -0,0 +1,53 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { PolicyRef } from "../policy/spec.js";
+
+//#region src/knowledge/spec.d.ts
+type KnowledgeCategory = 'canonical' | 'operational' | 'external' | 'ephemeral';
+interface KnowledgeSpaceMeta extends OwnerShipMeta {
+  /** Stable space identifier (e.g., "product-canon", "support-faq"). */
+  key: string;
+  version: number;
+  category: KnowledgeCategory;
+  displayName: string;
+}
+interface KnowledgeRetentionPolicy {
+  /** TTL in days (null = indefinite). */
+  ttlDays?: number | null;
+  /** Auto-archive after inactivity. */
+  archiveAfterDays?: number;
+}
+interface KnowledgeAccessPolicy {
+  /** Which PolicySpec governs access. */
+  policy?: PolicyRef;
+  /** Trust level for agent/workflow consumption. */
+  trustLevel: 'high' | 'medium' | 'low';
+  /** Can this space be mutated by automation? */
+  automationWritable: boolean;
+}
+interface KnowledgeIndexingConfig {
+  embeddingModel?: string;
+  chunkSize?: number;
+  vectorDbIntegration?: string;
+}
+interface KnowledgeSpaceSpec {
+  meta: KnowledgeSpaceMeta;
+  /** Retention and cleanup rules. */
+  retention: KnowledgeRetentionPolicy;
+  /** Access control and trust. */
+  access: KnowledgeAccessPolicy;
+  /** Optional embedding/indexing config. */
+  indexing?: KnowledgeIndexingConfig;
+  /** Documentation. */
+  description?: string;
+}
+declare class KnowledgeSpaceRegistry {
+  private readonly items;
+  register(spec: KnowledgeSpaceSpec): this;
+  list(): KnowledgeSpaceSpec[];
+  get(key: string, version?: number): KnowledgeSpaceSpec | undefined;
+  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[];
+}
+declare function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta): string;
+//#endregion
+export { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey };
+//# sourceMappingURL=spec.d.ts.map

package/dist/knowledge/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/knowledge/spec.ts"],"sourcesContent":[],"mappings":";;;;KAGY,iBAAA;UAMK,kBAAA,SAA2B;EANhC;EAMK,GAAA,EAAA,MAAA;EAQA,OAAA,EAAA,MAAA;EAOA,QAAA,EAXL,iBAW0B;EASrB,WAAA,EAAA,MAAA;AAMjB;AACQ,UAvBS,wBAAA,CAuBT;EAEK;EAEH,OAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAEG;EAAuB,gBAAA,CAAA,EAAA,MAAA;AAQpC;AAGiB,UAjCA,qBAAA,CAiCA;EASP;EAI4B,MAAA,CAAA,EA5C3B,SA4C2B;EAgBZ;EAAoB,UAAA,EAAA,MAAA,GAAA,QAAA,GAAA,KAAA;EAAkB;EAKhD,kBAAA,EAAA,OAAqB;;UA1DpB,uBAAA;;;;;UAMA,kBAAA;QACT;;aAEK;;UAEH;;aAEG;;;;cAQA,sBAAA;;iBAGI;UASP;sCAI4B;0BAgBZ,oBAAoB;;iBAK9B,qBAAA,OAA4B"}

package/dist/knowledge/spec.js

@@ -0,0 +1,2 @@
+const e=e=>`${e.key}.v${e.version}`;var t=class{items=new Map;register(t){let n=e(t.meta);if(this.items.has(n))throw Error(`Duplicate KnowledgeSpaceSpec ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()]}get(t,n){if(n!=null)return this.items.get(e({key:t,version:n}));let r,i=-1/0;for(let e of this.items.values())e.meta.key===t&&e.meta.version>i&&(i=e.meta.version,r=e);return r}getByCategory(e){return this.list().filter(t=>t.meta.category===e)}};function n(t){return e(t)}export{t as KnowledgeSpaceRegistry,n as makeKnowledgeSpaceKey};
+//# sourceMappingURL=spec.js.map

package/dist/knowledge/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","names":["latest: KnowledgeSpaceSpec | undefined"],"sources":["../../src/knowledge/spec.ts"],"sourcesContent":["import type { OwnerShipMeta } from '../ownership';\nimport type { PolicyRef } from '../policy/spec';\n\nexport type KnowledgeCategory =\n  | 'canonical'\n  | 'operational'\n  | 'external'\n  | 'ephemeral';\n\nexport interface KnowledgeSpaceMeta extends OwnerShipMeta {\n  /** Stable space identifier (e.g., \"product-canon\", \"support-faq\"). */\n  key: string;\n  version: number;\n  category: KnowledgeCategory;\n  displayName: string;\n}\n\nexport interface KnowledgeRetentionPolicy {\n  /** TTL in days (null = indefinite). */\n  ttlDays?: number | null;\n  /** Auto-archive after inactivity. */\n  archiveAfterDays?: number;\n}\n\nexport interface KnowledgeAccessPolicy {\n  /** Which PolicySpec governs access. */\n  policy?: PolicyRef;\n  /** Trust level for agent/workflow consumption. */\n  trustLevel: 'high' | 'medium' | 'low';\n  /** Can this space be mutated by automation? */\n  automationWritable: boolean;\n}\n\nexport interface KnowledgeIndexingConfig {\n  embeddingModel?: string;\n  chunkSize?: number;\n  vectorDbIntegration?: string;\n}\n\nexport interface KnowledgeSpaceSpec {\n  meta: KnowledgeSpaceMeta;\n  /** Retention and cleanup rules. */\n  retention: KnowledgeRetentionPolicy;\n  /** Access control and trust. */\n  access: KnowledgeAccessPolicy;\n  /** Optional embedding/indexing config. */\n  indexing?: KnowledgeIndexingConfig;\n  /** Documentation. */\n  description?: string;\n}\n\nconst knowledgeKey = (meta: Pick<KnowledgeSpaceMeta, 'key' | 'version'>) =>\n  `${meta.key}.v${meta.version}`;\n\nexport class KnowledgeSpaceRegistry {\n  private readonly items = new Map<string, KnowledgeSpaceSpec>();\n\n  register(spec: KnowledgeSpaceSpec): this {\n    const key = knowledgeKey(spec.meta);\n    if (this.items.has(key)) {\n      throw new Error(`Duplicate KnowledgeSpaceSpec ${key}`);\n    }\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): KnowledgeSpaceSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(key: string, version?: number): KnowledgeSpaceSpec | undefined {\n    if (version != null) {\n      return this.items.get(knowledgeKey({ key, version }));\n    }\n    let latest: KnowledgeSpaceSpec | undefined;\n    let maxVersion = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.key !== key) continue;\n      if (spec.meta.version > maxVersion) {\n        maxVersion = spec.meta.version;\n        latest = spec;\n      }\n    }\n    return latest;\n  }\n\n  getByCategory(category: KnowledgeCategory): KnowledgeSpaceSpec[] {\n    return this.list().filter((spec) => spec.meta.category === category);\n  }\n}\n\nexport function makeKnowledgeSpaceKey(meta: KnowledgeSpaceMeta) {\n  return knowledgeKey(meta);\n}\n\n\n\n"],"mappings":"AAmDA,MAAM,EAAgB,GACpB,GAAG,EAAK,IAAI,IAAI,EAAK,UAEvB,IAAa,EAAb,KAAoC,CAClC,MAAyB,IAAI,IAE7B,SAAS,EAAgC,CACvC,IAAM,EAAM,EAAa,EAAK,KAAK,CACnC,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,gCAAgC,IAAM,CAGxD,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAA6B,CAC3B,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAa,EAAkD,CACjE,GAAI,GAAW,KACb,OAAO,KAAK,MAAM,IAAI,EAAa,CAAE,MAAK,UAAS,CAAC,CAAC,CAEvD,IAAIA,EACA,EAAa,KACjB,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,MAAQ,GAClB,EAAK,KAAK,QAAU,IACtB,EAAa,EAAK,KAAK,QACvB,EAAS,GAGb,OAAO,EAGT,cAAc,EAAmD,CAC/D,OAAO,KAAK,MAAM,CAAC,OAAQ,GAAS,EAAK,KAAK,WAAa,EAAS,GAIxE,SAAgB,EAAsB,EAA0B,CAC9D,OAAO,EAAa,EAAK"}

package/dist/markdown.d.ts

@@ -0,0 +1,22 @@
+import { PresentationRegistry } from "./presentations.js";
+import { FeatureRegistry } from "./features.js";
+import { SpecRegistry } from "./registry.js";
+
+//#region src/markdown.d.ts
+
+/**
+ * Render simple Markdown docs for each spec.
+ * Useful for dev portals and repo docs generation.
+ */
+declare function specsToMarkdown(reg: SpecRegistry, extras?: {
+  presentations?: PresentationRegistry;
+  features?: FeatureRegistry;
+}): string;
+/** Render presentations and features as additional sections. */
+declare function docsToMarkdown(reg: SpecRegistry, extras: {
+  presentations?: PresentationRegistry;
+  features?: FeatureRegistry;
+}): string;
+//#endregion
+export { docsToMarkdown, specsToMarkdown };
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","names":[],"sources":["../src/markdown.ts"],"sourcesContent":[],"mappings":";;;;;;;;AASA;;AAE6B,iBAFb,eAAA,CAEa,GAAA,EADtB,YACsB,EAAA,MA2F7B,CA3F6B,EAAA;EAAiC,aAAA,CAAA,EAAjC,oBAAiC;EAAe,QAAA,CAAA,EAAf,eAAe;AA2F7E,CAAA,CAAA,EAAgB,MAAA;;AAEY,iBAFZ,cAAA,CAEY,GAAA,EADrB,YACqB,EAAA,MAAA,EAAA;EAAiC,aAAA,CAAA,EAAjC,oBAAiC;EAAe,QAAA,CAAA,EAAf,eAAe"}

package/dist/markdown.js

@@ -0,0 +1,4 @@
+import{isEmitDeclRef as e}from"./spec.js";function t(t,n){let r=[];for(let n of t.listSpecs()){let t=n.meta;if(r.push(`# ${t.name}.v${t.version}`),r.push(``),r.push(`**Kind:** ${t.kind} | **Stability:** ${t.stability} | **Owners:** ${t.owners.join(`, `)}`),r.push(``),r.push(`**Description:** ${t.description}`),r.push(``),r.push(`## Goal`),r.push(t.goal),r.push(``),r.push(`## Context`),r.push(t.context),r.push(``),r.push(`## Policy`),r.push(`- Auth: ${n.policy.auth}`),r.push(`- Idempotent: ${!!n.policy.idempotent}`),n.policy.rateLimit&&r.push(`- Rate Limit: ${n.policy.rateLimit.rpm}/min by ${n.policy.rateLimit.key}`),n.policy.flags?.length&&r.push(`- Flags: ${n.policy.flags.join(`, `)}`),n.policy.pii?.length&&r.push(`- PII: ${n.policy.pii.join(`, `)}`),r.push(``),n.sideEffects?.emits?.length){r.push(`## Emits Events`);for(let t of n.sideEffects.emits)e(t)?r.push(`- \`${t.ref.name}.v${t.ref.version}\` — ${t.when}`):r.push(`- \`${t.name}.v${t.version}\` — ${t.when}`);r.push(``)}if(n.io.errors&&Object.keys(n.io.errors).length){r.push(`## Errors`);for(let[e,t]of Object.entries(n.io.errors))r.push(`- \`${e}\` (${t.http??400}) — ${t.description} (when: ${t.when})`);r.push(``)}if(n.acceptance?.scenarios?.length){r.push(`## Acceptance Scenarios`);for(let e of n.acceptance.scenarios)r.push(`### ${e.name}`),r.push(`- **Given:** ${e.given.join(`; `)}`),r.push(`- **When:** ${e.when.join(`; `)}`),r.push(`- **Then:** ${e.then.join(`; `)}`),r.push(``)}if(n.acceptance?.examples?.length){r.push(`## Examples`);for(let e of n.acceptance.examples)r.push(`- **${e.name}**`),r.push(`  - Input:`),r.push("    ```json"),r.push(JSON.stringify(e.input,null,2)),r.push("    ```"),r.push(`  - Output:`),r.push("    ```json"),r.push(JSON.stringify(e.output,null,2)),r.push("    ```"),r.push(``)}r.push(`---`),r.push(``)}return r.join(`
+`)}function n(e,n){let r=[];if(r.push(t(e,n)),n.presentations){r.push(`# Presentations`),r.push(``);for(let e of n.presentations.list())r.push(`## ${e.meta.name}.v${e.meta.version}`),r.push(``),r.push(`- Kind: ${e.content.kind}`),`framework`in e.content&&r.push(`- Framework: ${e.content.framework}`),`componentKey`in e.content&&r.push(`- Component Key: ${e.content.componentKey}`),`mimeType`in e.content&&r.push(`- MIME Type: ${e.content.mimeType}`),r.push(``);r.push(``)}if(n.features){r.push(`# Features`),r.push(``);for(let e of n.features.list()){if(r.push(`## ${e.meta.title} (${e.meta.key})`),e.meta.description&&r.push(e.meta.description),r.push(``),e.operations?.length){r.push(`- Operations:`);for(let t of e.operations)r.push(`  - ${t.name}.v${t.version}`)}if(e.events?.length){r.push(`- Events:`);for(let t of e.events)r.push(`  - ${t.name}.v${t.version}`)}if(e.presentations?.length){r.push(`- Presentations:`);for(let t of e.presentations)r.push(`  - ${t.name}.v${t.version}`)}r.push(``)}}return r.join(`
+`)}export{n as docsToMarkdown,t as specsToMarkdown};
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","names":["lines: string[]","parts: string[]"],"sources":["../src/markdown.ts"],"sourcesContent":["import type { SpecRegistry } from './registry';\nimport { isEmitDeclRef } from './spec';\nimport type { PresentationRegistry } from './presentations';\nimport type { FeatureRegistry } from './features';\n\n/**\n * Render simple Markdown docs for each spec.\n * Useful for dev portals and repo docs generation.\n */\nexport function specsToMarkdown(\n  reg: SpecRegistry,\n  extras?: { presentations?: PresentationRegistry; features?: FeatureRegistry }\n): string {\n  const lines: string[] = [];\n\n  for (const spec of reg.listSpecs()) {\n    const m = spec.meta;\n    lines.push(`# ${m.name}.v${m.version}`);\n    lines.push('');\n    lines.push(\n      `**Kind:** ${m.kind} | **Stability:** ${m.stability} | **Owners:** ${m.owners.join(', ')}`\n    );\n    lines.push('');\n    lines.push(`**Description:** ${m.description}`);\n    lines.push('');\n    lines.push(`## Goal`);\n    lines.push(m.goal);\n    lines.push('');\n    lines.push(`## Context`);\n    lines.push(m.context);\n    lines.push('');\n\n    lines.push(`## Policy`);\n    lines.push(`- Auth: ${spec.policy.auth}`);\n    lines.push(`- Idempotent: ${!!spec.policy.idempotent}`);\n    if (spec.policy.rateLimit)\n      lines.push(\n        `- Rate Limit: ${spec.policy.rateLimit.rpm}/min by ${spec.policy.rateLimit.key}`\n      );\n    if (spec.policy.flags?.length)\n      lines.push(`- Flags: ${spec.policy.flags.join(', ')}`);\n    if (spec.policy.pii?.length)\n      lines.push(`- PII: ${spec.policy.pii.join(', ')}`);\n    lines.push('');\n\n    if (spec.sideEffects?.emits?.length) {\n      lines.push(`## Emits Events`);\n      for (const e of spec.sideEffects.emits) {\n        if (isEmitDeclRef(e)) {\n          lines.push(`- \\`${e.ref.name}.v${e.ref.version}\\` — ${e.when}`);\n        } else {\n          lines.push(`- \\`${e.name}.v${e.version}\\` — ${e.when}`);\n        }\n      }\n      lines.push('');\n    }\n\n    if (spec.io.errors && Object.keys(spec.io.errors).length) {\n      lines.push(`## Errors`);\n      for (const [code, err] of Object.entries(spec.io.errors)) {\n        lines.push(\n          `- \\`${code}\\` (${err.http ?? 400}) — ${err.description} (when: ${err.when})`\n        );\n      }\n      lines.push('');\n    }\n\n    if (spec.acceptance?.scenarios?.length) {\n      lines.push(`## Acceptance Scenarios`);\n      for (const s of spec.acceptance.scenarios) {\n        lines.push(`### ${s.name}`);\n        lines.push(`- **Given:** ${s.given.join('; ')}`);\n        lines.push(`- **When:** ${s.when.join('; ')}`);\n        lines.push(`- **Then:** ${s.then.join('; ')}`);\n        lines.push('');\n      }\n    }\n\n    if (spec.acceptance?.examples?.length) {\n      lines.push(`## Examples`);\n      for (const ex of spec.acceptance.examples) {\n        lines.push(`- **${ex.name}**`);\n        lines.push('  - Input:');\n        lines.push('    ```json');\n        lines.push(JSON.stringify(ex.input, null, 2));\n        lines.push('    ```');\n        lines.push('  - Output:');\n        lines.push('    ```json');\n        lines.push(JSON.stringify(ex.output, null, 2));\n        lines.push('    ```');\n        lines.push('');\n      }\n    }\n\n    lines.push('---');\n    lines.push('');\n  }\n\n  return lines.join('\\n');\n}\n\n/** Render presentations and features as additional sections. */\nexport function docsToMarkdown(\n  reg: SpecRegistry,\n  extras: { presentations?: PresentationRegistry; features?: FeatureRegistry }\n): string {\n  const parts: string[] = [];\n  parts.push(specsToMarkdown(reg, extras));\n\n  if (extras.presentations) {\n    parts.push('# Presentations');\n    parts.push('');\n    for (const p of extras.presentations.list()) {\n      parts.push(`## ${p.meta.name}.v${p.meta.version}`);\n      parts.push('');\n      parts.push(`- Kind: ${(p.content as any).kind}`);\n      if ('framework' in p.content)\n        parts.push(`- Framework: ${p.content.framework}`);\n      if ('componentKey' in p.content)\n        parts.push(`- Component Key: ${(p.content as any).componentKey}`);\n      if ('mimeType' in p.content)\n        parts.push(`- MIME Type: ${(p.content as any).mimeType}`);\n      parts.push('');\n    }\n    parts.push('');\n  }\n\n  if (extras.features) {\n    parts.push('# Features');\n    parts.push('');\n    for (const f of extras.features.list()) {\n      parts.push(`## ${f.meta.title} (${f.meta.key})`);\n      if (f.meta.description) parts.push(f.meta.description);\n      parts.push('');\n      if (f.operations?.length) {\n        parts.push('- Operations:');\n        for (const o of f.operations) parts.push(`  - ${o.name}.v${o.version}`);\n      }\n      if (f.events?.length) {\n        parts.push('- Events:');\n        for (const e of f.events) parts.push(`  - ${e.name}.v${e.version}`);\n      }\n      if (f.presentations?.length) {\n        parts.push('- Presentations:');\n        for (const p of f.presentations)\n          parts.push(`  - ${p.name}.v${p.version}`);\n      }\n      parts.push('');\n    }\n  }\n\n  return parts.join('\\n');\n}\n"],"mappings":"0CASA,SAAgB,EACd,EACA,EACQ,CACR,IAAMA,EAAkB,EAAE,CAE1B,IAAK,IAAM,KAAQ,EAAI,WAAW,CAAE,CAClC,IAAM,EAAI,EAAK,KA6Bf,GA5BA,EAAM,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,UAAU,CACvC,EAAM,KAAK,GAAG,CACd,EAAM,KACJ,aAAa,EAAE,KAAK,oBAAoB,EAAE,UAAU,iBAAiB,EAAE,OAAO,KAAK,KAAK,GACzF,CACD,EAAM,KAAK,GAAG,CACd,EAAM,KAAK,oBAAoB,EAAE,cAAc,CAC/C,EAAM,KAAK,GAAG,CACd,EAAM,KAAK,UAAU,CACrB,EAAM,KAAK,EAAE,KAAK,CAClB,EAAM,KAAK,GAAG,CACd,EAAM,KAAK,aAAa,CACxB,EAAM,KAAK,EAAE,QAAQ,CACrB,EAAM,KAAK,GAAG,CAEd,EAAM,KAAK,YAAY,CACvB,EAAM,KAAK,WAAW,EAAK,OAAO,OAAO,CACzC,EAAM,KAAK,iBAAiB,CAAC,CAAC,EAAK,OAAO,aAAa,CACnD,EAAK,OAAO,WACd,EAAM,KACJ,iBAAiB,EAAK,OAAO,UAAU,IAAI,UAAU,EAAK,OAAO,UAAU,MAC5E,CACC,EAAK,OAAO,OAAO,QACrB,EAAM,KAAK,YAAY,EAAK,OAAO,MAAM,KAAK,KAAK,GAAG,CACpD,EAAK,OAAO,KAAK,QACnB,EAAM,KAAK,UAAU,EAAK,OAAO,IAAI,KAAK,KAAK,GAAG,CACpD,EAAM,KAAK,GAAG,CAEV,EAAK,aAAa,OAAO,OAAQ,CACnC,EAAM,KAAK,kBAAkB,CAC7B,IAAK,IAAM,KAAK,EAAK,YAAY,MAC3B,EAAc,EAAE,CAClB,EAAM,KAAK,OAAO,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,QAAQ,OAAO,EAAE,OAAO,CAE/D,EAAM,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,QAAQ,OAAO,EAAE,OAAO,CAG3D,EAAM,KAAK,GAAG,CAGhB,GAAI,EAAK,GAAG,QAAU,OAAO,KAAK,EAAK,GAAG,OAAO,CAAC,OAAQ,CACxD,EAAM,KAAK,YAAY,CACvB,IAAK,GAAM,CAAC,EAAM,KAAQ,OAAO,QAAQ,EAAK,GAAG,OAAO,CACtD,EAAM,KACJ,OAAO,EAAK,MAAM,EAAI,MAAQ,IAAI,MAAM,EAAI,YAAY,UAAU,EAAI,KAAK,GAC5E,CAEH,EAAM,KAAK,GAAG,CAGhB,GAAI,EAAK,YAAY,WAAW,OAAQ,CACtC,EAAM,KAAK,0BAA0B,CACrC,IAAK,IAAM,KAAK,EAAK,WAAW,UAC9B,EAAM,KAAK,OAAO,EAAE,OAAO,CAC3B,EAAM,KAAK,gBAAgB,EAAE,MAAM,KAAK,KAAK,GAAG,CAChD,EAAM,KAAK,eAAe,EAAE,KAAK,KAAK,KAAK,GAAG,CAC9C,EAAM,KAAK,eAAe,EAAE,KAAK,KAAK,KAAK,GAAG,CAC9C,EAAM,KAAK,GAAG,CAIlB,GAAI,EAAK,YAAY,UAAU,OAAQ,CACrC,EAAM,KAAK,cAAc,CACzB,IAAK,IAAM,KAAM,EAAK,WAAW,SAC/B,EAAM,KAAK,OAAO,EAAG,KAAK,IAAI,CAC9B,EAAM,KAAK,aAAa,CACxB,EAAM,KAAK,cAAc,CACzB,EAAM,KAAK,KAAK,UAAU,EAAG,MAAO,KAAM,EAAE,CAAC,CAC7C,EAAM,KAAK,UAAU,CACrB,EAAM,KAAK,cAAc,CACzB,EAAM,KAAK,cAAc,CACzB,EAAM,KAAK,KAAK,UAAU,EAAG,OAAQ,KAAM,EAAE,CAAC,CAC9C,EAAM,KAAK,UAAU,CACrB,EAAM,KAAK,GAAG,CAIlB,EAAM,KAAK,MAAM,CACjB,EAAM,KAAK,GAAG,CAGhB,OAAO,EAAM,KAAK;EAAK,CAIzB,SAAgB,EACd,EACA,EACQ,CACR,IAAMC,EAAkB,EAAE,CAG1B,GAFA,EAAM,KAAK,EAAgB,EAAK,EAAO,CAAC,CAEpC,EAAO,cAAe,CACxB,EAAM,KAAK,kBAAkB,CAC7B,EAAM,KAAK,GAAG,CACd,IAAK,IAAM,KAAK,EAAO,cAAc,MAAM,CACzC,EAAM,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,EAAE,KAAK,UAAU,CAClD,EAAM,KAAK,GAAG,CACd,EAAM,KAAK,WAAY,EAAE,QAAgB,OAAO,CAC5C,cAAe,EAAE,SACnB,EAAM,KAAK,gBAAgB,EAAE,QAAQ,YAAY,CAC/C,iBAAkB,EAAE,SACtB,EAAM,KAAK,oBAAqB,EAAE,QAAgB,eAAe,CAC/D,aAAc,EAAE,SAClB,EAAM,KAAK,gBAAiB,EAAE,QAAgB,WAAW,CAC3D,EAAM,KAAK,GAAG,CAEhB,EAAM,KAAK,GAAG,CAGhB,GAAI,EAAO,SAAU,CACnB,EAAM,KAAK,aAAa,CACxB,EAAM,KAAK,GAAG,CACd,IAAK,IAAM,KAAK,EAAO,SAAS,MAAM,CAAE,CAItC,GAHA,EAAM,KAAK,MAAM,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,IAAI,GAAG,CAC5C,EAAE,KAAK,aAAa,EAAM,KAAK,EAAE,KAAK,YAAY,CACtD,EAAM,KAAK,GAAG,CACV,EAAE,YAAY,OAAQ,CACxB,EAAM,KAAK,gBAAgB,CAC3B,IAAK,IAAM,KAAK,EAAE,WAAY,EAAM,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,CAEzE,GAAI,EAAE,QAAQ,OAAQ,CACpB,EAAM,KAAK,YAAY,CACvB,IAAK,IAAM,KAAK,EAAE,OAAQ,EAAM,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,CAErE,GAAI,EAAE,eAAe,OAAQ,CAC3B,EAAM,KAAK,mBAAmB,CAC9B,IAAK,IAAM,KAAK,EAAE,cAChB,EAAM,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,CAE7C,EAAM,KAAK,GAAG,EAIlB,OAAO,EAAM,KAAK;EAAK"}

package/dist/migrations.d.ts

@@ -0,0 +1,53 @@
+import { OwnerShipMeta } from "./ownership.js";
+
+//#region src/migrations.d.ts
+type MigrationStepKind = 'schema' | 'data' | 'validation';
+interface MigrationCheck {
+  description: string;
+  expression: string;
+}
+interface MigrationStepBase {
+  kind: MigrationStepKind;
+  description?: string;
+  timeoutMs?: number;
+  retries?: number;
+  preChecks?: MigrationCheck[];
+  postChecks?: MigrationCheck[];
+}
+interface SchemaMigrationStep extends MigrationStepBase {
+  kind: 'schema';
+  sql: string;
+}
+interface DataMigrationStep extends MigrationStepBase {
+  kind: 'data';
+  script: string;
+}
+interface ValidationMigrationStep extends MigrationStepBase {
+  kind: 'validation';
+  assertion: string;
+}
+type MigrationStep = SchemaMigrationStep | DataMigrationStep | ValidationMigrationStep;
+interface MigrationMeta extends OwnerShipMeta {
+  /** Fully qualified migration name (e.g., "sigil.db.2025_01_add_users"). */
+  name: string;
+  /** Increment when the migration changes. */
+  version: number;
+}
+interface MigrationPlan {
+  up: MigrationStep[];
+  down?: MigrationStep[];
+}
+interface MigrationSpec {
+  meta: MigrationMeta;
+  plan: MigrationPlan;
+  dependencies?: string[];
+}
+declare class MigrationRegistry {
+  private readonly items;
+  register(spec: MigrationSpec): this;
+  list(): MigrationSpec[];
+  get(name: string, version?: number): MigrationSpec | undefined;
+}
+//#endregion
+export { DataMigrationStep, MigrationCheck, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, SchemaMigrationStep, ValidationMigrationStep };
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","names":[],"sources":["../src/migrations.ts"],"sourcesContent":[],"mappings":";;;KAEY,iBAAA;UAEK,cAAA;EAFL,WAAA,EAAA,MAAA;EAEK,UAAA,EAAA,MAAc;AAK/B;AACQ,UADS,iBAAA,CACT;EAIM,IAAA,EAJN,iBAIM;EACC,WAAA,CAAA,EAAA,MAAA;EAAc,SAAA,CAAA,EAAA,MAAA;EAGZ,OAAA,CAAA,EAAA,MAAA;EAKA,SAAA,CAAA,EATH,cASqB,EAAA;EAKlB,UAAA,CAAA,EAbF,cAa0B,EAAA;AAKzC;AACI,UAhBa,mBAAA,SAA4B,iBAgBzC,CAAA;EACA,IAAA,EAAA,QAAA;EACA,GAAA,EAAA,MAAA;;AAEa,UAfA,iBAAA,SAA0B,iBAeS,CAAA;EAOnC,IAAA,EAAA,MAAA;EAKA,MAAA,EAAA,MAAA;AAQjB;AAGiB,UAjCA,uBAAA,SAAgC,iBAiChC,CAAA;EAQP,IAAA,EAAA,YAAA;EAO6B,SAAA,EAAA,MAAA;;KA3C3B,aAAA,GACR,sBACA,oBACA;UAEa,aAAA,SAAsB;;;;;;UAOtB,aAAA;MACX;SACG;;UAGQ,aAAA;QACT;QACA;;;cAMK,iBAAA;;iBAGI;UAQP;uCAO6B"}

package/dist/migrations.js

@@ -0,0 +1,2 @@
+const e=(e,t)=>`${e}.v${t}`;var t=class{items=new Map;register(t){let n=e(t.meta.name,t.meta.version);if(this.items.has(n))throw Error(`Duplicate migration ${n}`);return this.items.set(n,t),this}list(){return[...this.items.values()].sort((t,r)=>n(e(t.meta.name,t.meta.version),e(r.meta.name,r.meta.version)))}get(t,n){if(n!=null)return this.items.get(e(t,n));let r,i=-1/0;for(let e of this.items.values())e.meta.name===t&&e.meta.version>i&&(i=e.meta.version,r=e);return r}};function n(e,t){return e<t?-1:e>t?1:0}export{t as MigrationRegistry};
+//# sourceMappingURL=migrations.js.map

package/dist/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","names":["candidate: MigrationSpec | undefined"],"sources":["../src/migrations.ts"],"sourcesContent":["import type { OwnerShipMeta } from './ownership';\n\nexport type MigrationStepKind = 'schema' | 'data' | 'validation';\n\nexport interface MigrationCheck {\n  description: string;\n  expression: string;\n}\n\nexport interface MigrationStepBase {\n  kind: MigrationStepKind;\n  description?: string;\n  timeoutMs?: number;\n  retries?: number;\n  preChecks?: MigrationCheck[];\n  postChecks?: MigrationCheck[];\n}\n\nexport interface SchemaMigrationStep extends MigrationStepBase {\n  kind: 'schema';\n  sql: string;\n}\n\nexport interface DataMigrationStep extends MigrationStepBase {\n  kind: 'data';\n  script: string;\n}\n\nexport interface ValidationMigrationStep extends MigrationStepBase {\n  kind: 'validation';\n  assertion: string;\n}\n\nexport type MigrationStep =\n  | SchemaMigrationStep\n  | DataMigrationStep\n  | ValidationMigrationStep;\n\nexport interface MigrationMeta extends OwnerShipMeta {\n  /** Fully qualified migration name (e.g., \"sigil.db.2025_01_add_users\"). */\n  name: string;\n  /** Increment when the migration changes. */\n  version: number;\n}\n\nexport interface MigrationPlan {\n  up: MigrationStep[];\n  down?: MigrationStep[];\n}\n\nexport interface MigrationSpec {\n  meta: MigrationMeta;\n  plan: MigrationPlan;\n  dependencies?: string[];\n}\n\nconst migrationKey = (name: string, version: number) => `${name}.v${version}`;\n\nexport class MigrationRegistry {\n  private readonly items = new Map<string, MigrationSpec>();\n\n  register(spec: MigrationSpec): this {\n    const key = migrationKey(spec.meta.name, spec.meta.version);\n    if (this.items.has(key))\n      throw new Error(`Duplicate migration ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): MigrationSpec[] {\n    return [...this.items.values()].sort(\n      (a, b) =>\n        compareKey(migrationKey(a.meta.name, a.meta.version), migrationKey(b.meta.name, b.meta.version))\n    );\n  }\n\n  get(name: string, version?: number): MigrationSpec | undefined {\n    if (version != null) return this.items.get(migrationKey(name, version));\n    let candidate: MigrationSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n\nfunction compareKey(a: string, b: string) {\n  return a < b ? -1 : a > b ? 1 : 0;\n}\n"],"mappings":"AAwDA,MAAM,GAAgB,EAAc,IAAoB,GAAG,EAAK,IAAI,IAEpE,IAAa,EAAb,KAA+B,CAC7B,MAAyB,IAAI,IAE7B,SAAS,EAA2B,CAClC,IAAM,EAAM,EAAa,EAAK,KAAK,KAAM,EAAK,KAAK,QAAQ,CAC3D,GAAI,KAAK,MAAM,IAAI,EAAI,CACrB,MAAU,MAAM,uBAAuB,IAAM,CAE/C,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAwB,CACtB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAAC,MAC7B,EAAG,IACF,EAAW,EAAa,EAAE,KAAK,KAAM,EAAE,KAAK,QAAQ,CAAE,EAAa,EAAE,KAAK,KAAM,EAAE,KAAK,QAAQ,CAAC,CACnG,CAGH,IAAI,EAAc,EAA6C,CAC7D,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,EAAa,EAAM,EAAQ,CAAC,CACvE,IAAIA,EACA,EAAM,KACV,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAM,EAAK,KAAK,QAChB,EAAY,GAGhB,OAAO,IAIX,SAAS,EAAW,EAAW,EAAW,CACxC,OAAO,EAAI,EAAI,GAAK,EAAI,EAAI,EAAI"}