@contractspec/lib.contracts 1.44.0

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,8 @@
+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/product-canon.d.ts

@@ -0,0 +1,7 @@
+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 };

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

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

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

@@ -0,0 +1,7 @@
+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 };

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

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

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

@@ -0,0 +1,7 @@
+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 };

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

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

package/dist/knowledge/spec.d.ts

@@ -0,0 +1,48 @@
+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 {
+  category: KnowledgeCategory;
+}
+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 };

package/dist/knowledge/spec.js

@@ -0,0 +1,39 @@
+//#region src/knowledge/spec.ts
+const knowledgeKey = (meta) => `${meta.key}.v${meta.version}`;
+var KnowledgeSpaceRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = knowledgeKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate KnowledgeSpaceSpec ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(key, version) {
+		if (version != null) return this.items.get(knowledgeKey({
+			key,
+			version
+		}));
+		let latest;
+		let maxVersion = -Infinity;
+		for (const spec of this.items.values()) {
+			if (spec.meta.key !== key) continue;
+			if (spec.meta.version > maxVersion) {
+				maxVersion = spec.meta.version;
+				latest = spec;
+			}
+		}
+		return latest;
+	}
+	getByCategory(category) {
+		return this.list().filter((spec) => spec.meta.category === category);
+	}
+};
+function makeKnowledgeSpaceKey(meta) {
+	return knowledgeKey(meta);
+}
+
+//#endregion
+export { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey };

package/dist/llm/exporters.d.ts

@@ -0,0 +1,70 @@
+import { DocBlock } from "../docs/types.js";
+import { PresentationSpec } from "../presentations/presentations.js";
+import { EventSpec } from "../events.js";
+import { AnyOperationSpec } from "../operations/operation.js";
+import { OperationSpecRegistry } from "../operations/registry.js";
+import "../operations/index.js";
+import { FeatureModuleSpec } from "../features/types.js";
+import { PresentationRegistry } from "../presentations/registry.js";
+import "../presentations/index.js";
+import "../features/index.js";
+import { FeatureExportOptions, FeatureExportResult, SpecExportOptions, SpecExportResult } from "./types.js";
+import { AnySchemaModel } from "@contractspec/lib.schema";
+
+//#region src/llm/exporters.d.ts
+
+/**
+ * Export a single spec to context-focused markdown.
+ * Includes: goal, context, description, acceptance scenarios.
+ * Best for: Understanding what the spec does, providing context to LLMs.
+ */
+declare function operationSpecToContextMarkdown(spec: AnyOperationSpec): string;
+/**
+ * Export a single spec to full markdown with all details.
+ * Includes: all fields, I/O schemas, policy, events, examples.
+ * Best for: Complete documentation, implementation reference.
+ */
+declare function operationSpecToFullMarkdown(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): string;
+/**
+ * Export a single spec as an actionable agent prompt.
+ * Includes: instructions, full spec, expected output format.
+ * Best for: Directly feeding to coding agents for implementation.
+ */
+declare function operationSpecToAgentPrompt(spec: AnyOperationSpec, options?: {
+  taskType?: 'implement' | 'test' | 'refactor' | 'review';
+  existingCode?: string;
+}): string;
+/**
+ * Export a feature module to markdown.
+ * Includes all related specs, events, and presentations.
+ */
+declare function featureToMarkdown(feature: FeatureModuleSpec, deps?: {
+  specs?: OperationSpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): string;
+/**
+ * Export a presentation descriptor to markdown.
+ */
+declare function presentationToMarkdown(presentation: PresentationSpec): string;
+/**
+ * Export an event spec to markdown.
+ */
+declare function eventToMarkdown(event: EventSpec<AnySchemaModel>): string;
+/**
+ * Export a DocBlock to markdown (already markdown, but formatted consistently).
+ */
+declare function docBlockToMarkdown(doc: DocBlock): string;
+/**
+ * Export a spec with a specific format.
+ * Convenience function that wraps the format-specific functions.
+ */
+declare function exportSpec(spec: AnyOperationSpec, options?: Partial<SpecExportOptions>): SpecExportResult;
+/**
+ * Export a feature with a specific format.
+ */
+declare function exportFeature(feature: FeatureModuleSpec, deps?: {
+  specs?: OperationSpecRegistry;
+  presentations?: PresentationRegistry;
+}, options?: Partial<FeatureExportOptions>): FeatureExportResult;
+//#endregion
+export { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, presentationToMarkdown };