@powerhousedao/knowledge-note 1.0.0

package/dist/document-models/research-claim/v1/tests/claim-management.test.js

@@ -0,0 +1,45 @@
+import { generateMock } from "@powerhousedao/common/utils";
+import { describe, expect, it } from "vitest";
+import { reducer, utils, isResearchClaimDocument, createClaim, addResearchConnection, removeResearchConnection, updateClaimContent, CreateClaimInputSchema, AddResearchConnectionInputSchema, RemoveResearchConnectionInputSchema, UpdateClaimContentInputSchema, } from "@powerhousedao/knowledge-note/document-models/research-claim/v1";
+describe("ClaimManagementOperations", () => {
+    it("should handle createClaim operation", () => {
+        const document = utils.createDocument();
+        const input = generateMock(CreateClaimInputSchema());
+        const updatedDocument = reducer(document, createClaim(input));
+        expect(isResearchClaimDocument(updatedDocument)).toBe(true);
+        expect(updatedDocument.operations.global).toHaveLength(1);
+        expect(updatedDocument.operations.global[0].action.type).toBe("CREATE_CLAIM");
+        expect(updatedDocument.operations.global[0].action.input).toStrictEqual(input);
+        expect(updatedDocument.operations.global[0].index).toEqual(0);
+    });
+    it("should handle addResearchConnection operation", () => {
+        const document = utils.createDocument();
+        const input = generateMock(AddResearchConnectionInputSchema());
+        const updatedDocument = reducer(document, addResearchConnection(input));
+        expect(isResearchClaimDocument(updatedDocument)).toBe(true);
+        expect(updatedDocument.operations.global).toHaveLength(1);
+        expect(updatedDocument.operations.global[0].action.type).toBe("ADD_RESEARCH_CONNECTION");
+        expect(updatedDocument.operations.global[0].action.input).toStrictEqual(input);
+        expect(updatedDocument.operations.global[0].index).toEqual(0);
+    });
+    it("should handle removeResearchConnection operation", () => {
+        const document = utils.createDocument();
+        const input = generateMock(RemoveResearchConnectionInputSchema());
+        const updatedDocument = reducer(document, removeResearchConnection(input));
+        expect(isResearchClaimDocument(updatedDocument)).toBe(true);
+        expect(updatedDocument.operations.global).toHaveLength(1);
+        expect(updatedDocument.operations.global[0].action.type).toBe("REMOVE_RESEARCH_CONNECTION");
+        expect(updatedDocument.operations.global[0].action.input).toStrictEqual(input);
+        expect(updatedDocument.operations.global[0].index).toEqual(0);
+    });
+    it("should handle updateClaimContent operation", () => {
+        const document = utils.createDocument();
+        const input = generateMock(UpdateClaimContentInputSchema());
+        const updatedDocument = reducer(document, updateClaimContent(input));
+        expect(isResearchClaimDocument(updatedDocument)).toBe(true);
+        expect(updatedDocument.operations.global).toHaveLength(1);
+        expect(updatedDocument.operations.global[0].action.type).toBe("UPDATE_CLAIM_CONTENT");
+        expect(updatedDocument.operations.global[0].action.input).toStrictEqual(input);
+        expect(updatedDocument.operations.global[0].index).toEqual(0);
+    });
+});

package/dist/document-models/research-claim/v1/tests/document-model.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This is a scaffold file meant for customization:
+ * - change it by adding new tests or modifying the existing ones
+ */
+/**
+ * This is a scaffold file meant for customization:
+ * - change it by adding new tests or modifying the existing ones
+ */
+export {};
+//# sourceMappingURL=document-model.test.d.ts.map

package/dist/document-models/research-claim/v1/tests/document-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-model.test.d.ts","sourceRoot":"","sources":["../../../../../document-models/research-claim/v1/tests/document-model.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH;;;GAGG"}

package/dist/document-models/research-claim/v1/tests/document-model.test.js

@@ -0,0 +1,104 @@
+/**
+ * This is a scaffold file meant for customization:
+ * - change it by adding new tests or modifying the existing ones
+ */
+/**
+ * This is a scaffold file meant for customization:
+ * - change it by adding new tests or modifying the existing ones
+ */
+import { describe, it, expect } from "vitest";
+import { utils, initialGlobalState, initialLocalState, researchClaimDocumentType, isResearchClaimDocument, assertIsResearchClaimDocument, isResearchClaimState, assertIsResearchClaimState, } from "@powerhousedao/knowledge-note/document-models/research-claim/v1";
+import { ZodError } from "zod";
+describe("ResearchClaim Document Model", () => {
+    it("should create a new ResearchClaim document", () => {
+        const document = utils.createDocument();
+        expect(document).toBeDefined();
+        expect(document.header.documentType).toBe(researchClaimDocumentType);
+    });
+    it("should create a new ResearchClaim document with a valid initial state", () => {
+        const document = utils.createDocument();
+        expect(document.state.global).toStrictEqual(initialGlobalState);
+        expect(document.state.local).toStrictEqual(initialLocalState);
+        expect(isResearchClaimDocument(document)).toBe(true);
+        expect(isResearchClaimState(document.state)).toBe(true);
+    });
+    it("should reject a document that is not a ResearchClaim document", () => {
+        const wrongDocumentType = utils.createDocument();
+        wrongDocumentType.header.documentType = "the-wrong-thing-1234";
+        try {
+            expect(assertIsResearchClaimDocument(wrongDocumentType)).toThrow();
+            expect(isResearchClaimDocument(wrongDocumentType)).toBe(false);
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(ZodError);
+        }
+    });
+    const wrongState = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    wrongState.state.global = {
+        ...{ notWhat: "you want" },
+    };
+    try {
+        expect(isResearchClaimState(wrongState.state)).toBe(false);
+        expect(assertIsResearchClaimState(wrongState.state)).toThrow();
+        expect(isResearchClaimDocument(wrongState)).toBe(false);
+        expect(assertIsResearchClaimDocument(wrongState)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+    const wrongInitialState = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    wrongInitialState.initialState.global = {
+        ...{ notWhat: "you want" },
+    };
+    try {
+        expect(isResearchClaimState(wrongInitialState.state)).toBe(false);
+        expect(assertIsResearchClaimState(wrongInitialState.state)).toThrow();
+        expect(isResearchClaimDocument(wrongInitialState)).toBe(false);
+        expect(assertIsResearchClaimDocument(wrongInitialState)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+    const missingIdInHeader = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    delete missingIdInHeader.header.id;
+    try {
+        expect(isResearchClaimDocument(missingIdInHeader)).toBe(false);
+        expect(assertIsResearchClaimDocument(missingIdInHeader)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+    const missingNameInHeader = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    delete missingNameInHeader.header.name;
+    try {
+        expect(isResearchClaimDocument(missingNameInHeader)).toBe(false);
+        expect(assertIsResearchClaimDocument(missingNameInHeader)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+    const missingCreatedAtUtcIsoInHeader = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    delete missingCreatedAtUtcIsoInHeader.header.createdAtUtcIso;
+    try {
+        expect(isResearchClaimDocument(missingCreatedAtUtcIsoInHeader)).toBe(false);
+        expect(assertIsResearchClaimDocument(missingCreatedAtUtcIsoInHeader)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+    const missingLastModifiedAtUtcIsoInHeader = utils.createDocument();
+    // @ts-expect-error - we are testing the error case
+    delete missingLastModifiedAtUtcIsoInHeader.header.lastModifiedAtUtcIso;
+    try {
+        expect(isResearchClaimDocument(missingLastModifiedAtUtcIsoInHeader)).toBe(false);
+        expect(assertIsResearchClaimDocument(missingLastModifiedAtUtcIsoInHeader)).toThrow();
+    }
+    catch (error) {
+        expect(error).toBeInstanceOf(ZodError);
+    }
+});

package/dist/document-models/research-claim/v1/utils.d.ts

@@ -0,0 +1,14 @@
+import type { ResearchClaimPHState } from "./gen/types.js";
+/** Utils for the ResearchClaim document model */
+export declare const utils: {
+    fileExtension: string;
+    createState: import("document-model").CreateState<ResearchClaimPHState>;
+    createDocument: import("document-model").CreateDocument<ResearchClaimPHState>;
+    loadFromInput: import("document-model").LoadFromInput<ResearchClaimPHState>;
+    saveToFileHandle: import("document-model").SaveToFileHandle;
+    isStateOfType: import("document-model").IsStateOfType<ResearchClaimPHState>;
+    assertIsStateOfType: import("document-model").AssertIsStateOfType<ResearchClaimPHState>;
+    isDocumentOfType: import("document-model").IsDocumentOfType<ResearchClaimPHState>;
+    assertIsDocumentOfType: import("document-model").AssertIsDocumentOfType<ResearchClaimPHState>;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/document-models/research-claim/v1/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../document-models/research-claim/v1/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,iDAAiD;AACjD,eAAO,MAAM,KAAK;;;;;;;;;;CAGkC,CAAC"}

package/dist/document-models/research-claim/v1/utils.js

@@ -0,0 +1,7 @@
+import { utils as genUtils } from "./gen/utils.js";
+import * as customUtils from "./src/utils.js";
+/** Utils for the ResearchClaim document model */
+export const utils = {
+    ...genUtils,
+    ...customUtils,
+};

package/dist/document-models/source/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./v1/index.js";
+export * from "./upgrades/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/document-models/source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../document-models/source/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC"}

package/dist/document-models/source/index.js

@@ -0,0 +1,2 @@
+export * from "./v1/index.js";
+export * from "./upgrades/index.js";

package/dist/document-models/source/upgrades/index.d.ts

@@ -0,0 +1,3 @@
+export { sourceUpgradeManifest } from "./upgrade-manifest.js";
+export { supportedVersions, latestVersion } from "./versions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/document-models/source/upgrades/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../document-models/source/upgrades/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/document-models/source/upgrades/index.js

@@ -0,0 +1,2 @@
+export { sourceUpgradeManifest } from "./upgrade-manifest.js";
+export { supportedVersions, latestVersion } from "./versions.js";

package/dist/document-models/source/upgrades/upgrade-manifest.d.ts

@@ -0,0 +1,4 @@
+import type { UpgradeManifest } from "document-model";
+import { supportedVersions } from "./versions.js";
+export declare const sourceUpgradeManifest: UpgradeManifest<typeof supportedVersions>;
+//# sourceMappingURL=upgrade-manifest.d.ts.map

package/dist/document-models/source/upgrades/upgrade-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-manifest.d.ts","sourceRoot":"","sources":["../../../../document-models/source/upgrades/upgrade-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAiB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjE,eAAO,MAAM,qBAAqB,EAAE,eAAe,CAAC,OAAO,iBAAiB,CAMzE,CAAC"}

package/dist/document-models/source/upgrades/upgrade-manifest.js

@@ -0,0 +1,7 @@
+import { latestVersion, supportedVersions } from "./versions.js";
+export const sourceUpgradeManifest = {
+    documentType: "bai/source",
+    latestVersion,
+    supportedVersions,
+    upgrades: {},
+};

package/dist/document-models/source/upgrades/versions.d.ts

@@ -0,0 +1,3 @@
+export declare const supportedVersions: readonly [1];
+export declare const latestVersion: 1;
+//# sourceMappingURL=versions.d.ts.map

package/dist/document-models/source/upgrades/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../../../document-models/source/upgrades/versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,cAAe,CAAC;AAE9C,eAAO,MAAM,aAAa,GAAuB,CAAC"}

package/dist/document-models/source/upgrades/versions.js

@@ -0,0 +1,2 @@
+export const supportedVersions = [1];
+export const latestVersion = supportedVersions[0];

package/dist/document-models/source/v1/actions.d.ts

@@ -0,0 +1,18 @@
+/** Actions for the Source document model */
+export declare const actions: {
+    ingestSource: (input: import("./index.js").IngestSourceInput) => import("./index.js").IngestSourceAction;
+    setSourceStatus: (input: import("./index.js").SetSourceStatusInput) => import("./index.js").SetSourceStatusAction;
+    addExtractedClaim: (input: import("./index.js").AddExtractedClaimInput) => import("./index.js").AddExtractedClaimAction;
+    recordExtractionStats: (input: import("./index.js").RecordExtractionStatsInput) => import("./index.js").RecordExtractionStatsAction;
+    setName: (name: string | {
+        name: string;
+    }) => import("document-model").SetNameAction;
+    undo: (count?: number, scope?: string) => import("document-model").UndoAction;
+    redo: (count?: number, scope?: string) => import("document-model").RedoAction;
+    prune: (start?: number, end?: number, scope?: string) => import("document-model").SchemaPruneAction;
+    loadState: <TState extends import("document-model").PHBaseState = import("document-model").PHBaseState>(state: TState & {
+        name: string;
+    }, operations: number) => import("document-model").LoadStateAction;
+    noop: (scope?: string) => import("document-model").NOOPAction;
+};
+//# sourceMappingURL=actions.d.ts.map

package/dist/document-models/source/v1/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../document-models/source/v1/actions.ts"],"names":[],"mappings":"AAGA,4CAA4C;AAE5C,eAAO,MAAM,OAAO;mBACqR,6CAAwB;sBAAgL,gDAA2B;wBAA4L,kDAA6B;4BAAsM,sDAAiC;;;;gBAA2gM,CAAC,eAAe,CAAC;gBAAkE,CAAC,eAAe,CAAC;iBAAmE,CAAC,aAAa,CAAC,eAAe,CAAC;;;;gBAAqS,CAAC;CAD93O,CAAC"}

package/dist/document-models/source/v1/actions.js

@@ -0,0 +1,4 @@
+import { baseActions } from "document-model";
+import { sourceManagementActions } from "./gen/creators.js";
+/** Actions for the Source document model */
+export const actions = { ...baseActions, ...sourceManagementActions };

package/dist/document-models/source/v1/gen/actions.d.ts

@@ -0,0 +1,4 @@
+import type { SourceSourceManagementAction } from "./source-management/actions.js";
+export * from "./source-management/actions.js";
+export type SourceAction = SourceSourceManagementAction;
+//# sourceMappingURL=actions.d.ts.map

package/dist/document-models/source/v1/gen/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,cAAc,gCAAgC,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,4BAA4B,CAAC"}

package/dist/document-models/source/v1/gen/actions.js

@@ -0,0 +1 @@
+export * from "./source-management/actions.js";

package/dist/document-models/source/v1/gen/controller.d.ts

@@ -0,0 +1,4 @@
+import { PHDocumentController } from "document-model/core";
+import type { SourcePHState } from "./types.js";
+export declare const SourceController: new (initialDocument?: import("document-model").PHDocument<SourcePHState> | undefined) => PHDocumentController<SourcePHState> & import("document-model/core").ActionMap<import("./actions.js").SourceSourceManagementAction, PHDocumentController<SourcePHState>>;
+//# sourceMappingURL=controller.d.ts.map

package/dist/document-models/source/v1/gen/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,gBAAgB,mQAGpB,CAAC"}

package/dist/document-models/source/v1/gen/controller.js

@@ -0,0 +1,3 @@
+import { PHDocumentController } from "document-model/core";
+import { Source } from "../module.js";
+export const SourceController = PHDocumentController.forDocumentModel(Source);

package/dist/document-models/source/v1/gen/creators.d.ts

@@ -0,0 +1,3 @@
+export * from "./source-management/creators.js";
+export * as sourceManagementActions from "./source-management/creators.js";
+//# sourceMappingURL=creators.d.ts.map

package/dist/document-models/source/v1/gen/creators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creators.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/creators.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,OAAO,KAAK,uBAAuB,MAAM,iCAAiC,CAAC"}

package/dist/document-models/source/v1/gen/creators.js

@@ -0,0 +1,2 @@
+export * from "./source-management/creators.js";
+export * as sourceManagementActions from "./source-management/creators.js";

package/dist/document-models/source/v1/gen/document-model.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentModelGlobalState } from "document-model";
+export declare const documentModel: DocumentModelGlobalState;
+//# sourceMappingURL=document-model.d.ts.map

package/dist/document-models/source/v1/gen/document-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-model.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/document-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,wBAyF3B,CAAC"}

package/dist/document-models/source/v1/gen/document-model.js

@@ -0,0 +1,81 @@
+export const documentModel = {
+    id: "bai/source",
+    name: "Source",
+    author: {
+        name: "BAI",
+        website: "https://bai.dev",
+    },
+    extension: "src.phd",
+    description: "Ingested source material \u2014 articles, papers, transcripts, and other content that feeds the knowledge extraction pipeline.",
+    specifications: [
+        {
+            state: {
+                local: {
+                    schema: "",
+                    examples: [],
+                    initialValue: "",
+                },
+                global: {
+                    schema: "enum SourceType {\n    ARTICLE\n    PAPER\n    BOOK_CHAPTER\n    TRANSCRIPT\n    DOCUMENTATION\n    CONVERSATION\n    WEB_PAGE\n    MANUAL_ENTRY\n}\n\nenum SourceStatus {\n    INBOX\n    EXTRACTING\n    EXTRACTED\n    ARCHIVED\n}\n\ntype SourceProvenance {\n    url: String\n    author: String\n    publishedAt: DateTime\n    method: String\n    tool: String\n}\n\ntype ExtractionStats {\n    claimCount: Int!\n    skippedCount: Int!\n    skipRate: Float!\n    extractedAt: DateTime\n    extractedBy: String\n}\n\ntype SourceState {\n    title: String\n    description: String\n    content: String\n    sourceType: SourceType\n    status: SourceStatus\n    provenance: SourceProvenance\n    extractedClaims: [String!]!\n    extractionStats: ExtractionStats\n    createdAt: DateTime\n    createdBy: String\n}",
+                    examples: [],
+                    initialValue: '{\n    "title": null,\n    "description": null,\n    "content": null,\n    "sourceType": null,\n    "status": "INBOX",\n    "provenance": null,\n    "extractedClaims": [],\n    "extractionStats": null,\n    "createdAt": null,\n    "createdBy": null\n}',
+                },
+            },
+            modules: [
+                {
+                    id: "source-management",
+                    name: "source-management",
+                    description: "Source lifecycle and extraction tracking",
+                    operations: [
+                        {
+                            id: "ingest-source",
+                            name: "INGEST_SOURCE",
+                            description: "Add new source material",
+                            schema: "input IngestSourceInput {\n    title: String!\n    content: String!\n    sourceType: SourceType!\n    description: String\n    url: String\n    author: String\n    publishedAt: DateTime\n    method: String\n    tool: String\n    createdAt: DateTime!\n    createdBy: String\n}",
+                            template: "Add new source material",
+                            reducer: 'state.title = action.input.title;\nstate.content = action.input.content;\nstate.sourceType = action.input.sourceType;\nstate.description = action.input.description || null;\nstate.status = "INBOX";\nstate.createdAt = action.input.createdAt;\nstate.createdBy = action.input.createdBy || null;\nif (action.input.url || action.input.author || action.input.publishedAt) {\n    state.provenance = {\n        url: action.input.url || null,\n        author: action.input.author || null,\n        publishedAt: action.input.publishedAt || null,\n        method: action.input.method || null,\n        tool: action.input.tool || null,\n    };\n}',
+                            errors: [],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "set-source-status",
+                            name: "SET_SOURCE_STATUS",
+                            description: "Transition source status",
+                            schema: "input SetSourceStatusInput {\n    status: SourceStatus!\n}",
+                            template: "Transition source status",
+                            reducer: "state.status = action.input.status;",
+                            errors: [],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "add-extracted-claim",
+                            name: "ADD_EXTRACTED_CLAIM",
+                            description: "Link an extracted claim to this source",
+                            schema: "input AddExtractedClaimInput {\n    claimRef: String!\n}",
+                            template: "Link an extracted claim to this source",
+                            reducer: "state.extractedClaims.push(action.input.claimRef);",
+                            errors: [],
+                            examples: [],
+                            scope: "global",
+                        },
+                        {
+                            id: "record-extraction-stats",
+                            name: "RECORD_EXTRACTION_STATS",
+                            description: "Record extraction statistics",
+                            schema: "input RecordExtractionStatsInput {\n    claimCount: Int!\n    skippedCount: Int!\n    skipRate: Float!\n    extractedAt: DateTime!\n    extractedBy: String\n}",
+                            template: "Record extraction statistics",
+                            reducer: "state.extractionStats = {\n    claimCount: action.input.claimCount,\n    skippedCount: action.input.skippedCount,\n    skipRate: action.input.skipRate,\n    extractedAt: action.input.extractedAt,\n    extractedBy: action.input.extractedBy || null,\n};",
+                            errors: [],
+                            examples: [],
+                            scope: "global",
+                        },
+                    ],
+                },
+            ],
+            version: 1,
+            changeLog: [],
+        },
+    ],
+};

package/dist/document-models/source/v1/gen/document-schema.d.ts

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import type { SourceDocument, SourcePHState } from "./types.js";
+/** Schema for validating the header object of a Source document */
+export declare const SourceDocumentHeaderSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    createdAtUtcIso: z.ZodString;
+    lastModifiedAtUtcIso: z.ZodString;
+    documentType: z.ZodLiteral<"bai/source">;
+}, z.core.$strip>;
+/** Schema for validating the state object of a Source document */
+export declare const SourcePHStateSchema: z.ZodObject<{
+    global: z.ZodObject<Required<{
+        content: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        createdAt: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        createdBy: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        description: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        extractedClaims: z.ZodType<string[], unknown, z.core.$ZodTypeInternals<string[], unknown>>;
+        extractionStats: z.ZodType<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown>>;
+        provenance: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown>>;
+        sourceType: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceType>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceType>, unknown>>;
+        status: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown>>;
+        title: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+    }>, z.core.$strip>;
+}, z.core.$strip>;
+export declare const SourceDocumentSchema: z.ZodObject<{
+    header: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        createdAtUtcIso: z.ZodString;
+        lastModifiedAtUtcIso: z.ZodString;
+        documentType: z.ZodLiteral<"bai/source">;
+    }, z.core.$strip>;
+    state: z.ZodObject<{
+        global: z.ZodObject<Required<{
+            content: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            createdAt: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            createdBy: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            description: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            extractedClaims: z.ZodType<string[], unknown, z.core.$ZodTypeInternals<string[], unknown>>;
+            extractionStats: z.ZodType<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown>>;
+            provenance: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown>>;
+            sourceType: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceType>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceType>, unknown>>;
+            status: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown>>;
+            title: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        }>, z.core.$strip>;
+    }, z.core.$strip>;
+    initialState: z.ZodObject<{
+        global: z.ZodObject<Required<{
+            content: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            createdAt: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            createdBy: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            description: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+            extractedClaims: z.ZodType<string[], unknown, z.core.$ZodTypeInternals<string[], unknown>>;
+            extractionStats: z.ZodType<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").ExtractionStats>, unknown>>;
+            provenance: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceProvenance>, unknown>>;
+            sourceType: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceType>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceType>, unknown>>;
+            status: z.ZodType<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<import("./types.js").SourceStatus>, unknown>>;
+            title: z.ZodType<import("./types.js").Maybe<string>, unknown, z.core.$ZodTypeInternals<import("./types.js").Maybe<string>, unknown>>;
+        }>, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** Simple helper function to check if a state object is a Source document state object */
+export declare function isSourceState(state: unknown): state is SourcePHState;
+/** Simple helper function to assert that a document state object is a Source document state object */
+export declare function assertIsSourceState(state: unknown): asserts state is SourcePHState;
+/** Simple helper function to check if a document is a Source document */
+export declare function isSourceDocument(document: unknown): document is SourceDocument;
+/** Simple helper function to assert that a document is a Source document */
+export declare function assertIsSourceDocument(document: unknown): asserts document is SourceDocument;
+//# sourceMappingURL=document-schema.d.ts.map

package/dist/document-models/source/v1/gen/document-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-schema.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/document-schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhE,mEAAmE;AACnE,eAAO,MAAM,0BAA0B;;;;;;iBAErC,CAAC;AAEH,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAE9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEpE;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,aAAa,CAEhC;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,cAAc,CAE5B;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,IAAI,cAAc,CAEpC"}

package/dist/document-models/source/v1/gen/document-schema.js

@@ -0,0 +1,33 @@
+import { BaseDocumentHeaderSchema, BaseDocumentStateSchema, } from "document-model";
+import { z } from "zod";
+import { sourceDocumentType } from "./document-type.js";
+import { SourceStateSchema } from "./schema/zod.js";
+/** Schema for validating the header object of a Source document */
+export const SourceDocumentHeaderSchema = BaseDocumentHeaderSchema.extend({
+    documentType: z.literal(sourceDocumentType),
+});
+/** Schema for validating the state object of a Source document */
+export const SourcePHStateSchema = BaseDocumentStateSchema.extend({
+    global: SourceStateSchema(),
+});
+export const SourceDocumentSchema = z.object({
+    header: SourceDocumentHeaderSchema,
+    state: SourcePHStateSchema,
+    initialState: SourcePHStateSchema,
+});
+/** Simple helper function to check if a state object is a Source document state object */
+export function isSourceState(state) {
+    return SourcePHStateSchema.safeParse(state).success;
+}
+/** Simple helper function to assert that a document state object is a Source document state object */
+export function assertIsSourceState(state) {
+    SourcePHStateSchema.parse(state);
+}
+/** Simple helper function to check if a document is a Source document */
+export function isSourceDocument(document) {
+    return SourceDocumentSchema.safeParse(document).success;
+}
+/** Simple helper function to assert that a document is a Source document */
+export function assertIsSourceDocument(document) {
+    SourceDocumentSchema.parse(document);
+}

package/dist/document-models/source/v1/gen/document-type.d.ts

@@ -0,0 +1,2 @@
+export declare const sourceDocumentType = "bai/source";
+//# sourceMappingURL=document-type.d.ts.map

package/dist/document-models/source/v1/gen/document-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-type.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/document-type.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,eAAe,CAAC"}

package/dist/document-models/source/v1/gen/document-type.js

@@ -0,0 +1 @@
+export const sourceDocumentType = "bai/source";

package/dist/document-models/source/v1/gen/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./actions.js";
+export * from "./document-model.js";
+export * from "./types.js";
+export * from "./creators.js";
+export { createSourceDocument, createState, defaultPHState, defaultGlobalState, defaultLocalState, } from "./ph-factories.js";
+export * from "./utils.js";
+export * from "./reducer.js";
+export * from "./controller.js";
+export * from "./schema/index.js";
+export * from "./document-type.js";
+export * from "./document-schema.js";
+export * from "./source-management/operations.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/document-models/source/v1/gen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC"}

package/dist/document-models/source/v1/gen/index.js

@@ -0,0 +1,12 @@
+export * from "./actions.js";
+export * from "./document-model.js";
+export * from "./types.js";
+export * from "./creators.js";
+export { createSourceDocument, createState, defaultPHState, defaultGlobalState, defaultLocalState, } from "./ph-factories.js";
+export * from "./utils.js";
+export * from "./reducer.js";
+export * from "./controller.js";
+export * from "./schema/index.js";
+export * from "./document-type.js";
+export * from "./document-schema.js";
+export * from "./source-management/operations.js";

package/dist/document-models/source/v1/gen/ph-factories.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Factory methods for creating SourceDocument instances
+ */
+import type { PHAuthState, PHDocumentState, PHBaseState } from "document-model";
+import type { SourceDocument, SourceLocalState, SourceGlobalState, SourcePHState } from "./types.js";
+export declare function defaultGlobalState(): SourceGlobalState;
+export declare function defaultLocalState(): SourceLocalState;
+export declare function defaultPHState(): SourcePHState;
+export declare function createGlobalState(state?: Partial<SourceGlobalState>): SourceGlobalState;
+export declare function createLocalState(state?: Partial<SourceLocalState>): SourceLocalState;
+export declare function createState(baseState?: Partial<PHBaseState>, globalState?: Partial<SourceGlobalState>, localState?: Partial<SourceLocalState>): SourcePHState;
+/**
+ * Creates a SourceDocument with custom global and local state
+ * This properly handles the PHBaseState requirements while allowing
+ * document-specific state to be set.
+ */
+export declare function createSourceDocument(state?: Partial<{
+    auth?: Partial<PHAuthState>;
+    document?: Partial<PHDocumentState>;
+    global?: Partial<SourceGlobalState>;
+    local?: Partial<SourceLocalState>;
+}>): SourceDocument;
+//# sourceMappingURL=ph-factories.d.ts.map

package/dist/document-models/source/v1/gen/ph-factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ph-factories.d.ts","sourceRoot":"","sources":["../../../../../document-models/source/v1/gen/ph-factories.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,wBAAgB,kBAAkB,IAAI,iBAAiB,CAatD;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD;AAED,wBAAgB,cAAc,IAAI,aAAa,CAM9C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACjC,iBAAiB,CAKnB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAChC,gBAAgB,CAKlB;AAED,wBAAgB,WAAW,CACzB,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAChC,WAAW,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACxC,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACrC,aAAa,CAMf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnC,CAAC,GACD,cAAc,CAYhB"}