@powerhousedao/knowledge-note 1.0.0

package/dist/tests/unit/knowledge-note-reducers.test.js

@@ -0,0 +1,215 @@
+import { describe, it, expect } from "vitest";
+import { reducer, utils, actions, } from "@powerhousedao/knowledge-note/document-models/knowledge-note/v1";
+// ─── Content Module ──────────────────────────────────────────────────────────
+describe("Content module — state mutations", () => {
+    it("SET_TITLE — updates state.global.title", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setTitle({ title: "My Note Title", updatedAt: "2026-01-01T00:00:00Z" }));
+        expect(updated.state.global.title).toBe("My Note Title");
+    });
+    it("SET_DESCRIPTION — updates state.global.description", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setDescription({
+            description: "A short description",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.state.global.description).toBe("A short description");
+    });
+    it("SET_DESCRIPTION with >200 chars — records error and leaves state unchanged", () => {
+        const document = utils.createDocument();
+        const longDescription = "x".repeat(201);
+        const updated = reducer(document, actions.setDescription({
+            description: longDescription,
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.operations.global[0].error).toBeTruthy();
+        expect(updated.state.global.description).toBeNull();
+    });
+    it("SET_CONTENT — updates state.global.content", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setContent({
+            content: "Hello world",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.state.global.content).toBe("Hello world");
+    });
+    it("PATCH_CONTENT — splices content at the given offset", () => {
+        const document = utils.createDocument();
+        // First set some content
+        const withContent = reducer(document, actions.setContent({
+            content: "Hello world",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        // Patch: replace " world" (offset 5, removeCount 6) with " there"
+        const patched = reducer(withContent, actions.patchContent({
+            offset: 5,
+            removeCount: 6,
+            insert: " there",
+            updatedAt: "2026-01-02T00:00:00Z",
+        }));
+        expect(patched.state.global.content).toBe("Hello there");
+    });
+    it("PATCH_CONTENT out-of-bounds — records error and leaves content unchanged", () => {
+        const document = utils.createDocument();
+        // Set content first (op index 0)
+        const withContent = reducer(document, actions.setContent({
+            content: "Hi",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        // Patch beyond content length (op index 1)
+        const patched = reducer(withContent, actions.patchContent({
+            offset: 100,
+            removeCount: 1,
+            insert: "x",
+            updatedAt: "2026-01-02T00:00:00Z",
+        }));
+        expect(patched.operations.global[1].error).toBeTruthy();
+        expect(patched.state.global.content).toBe("Hi");
+    });
+    it("SET_NOTE_TYPE — updates state.global.noteType", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setNoteType({
+            noteType: "concept",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.state.global.noteType).toBe("concept");
+    });
+    it("SET_METADATA_FIELD with valid field — updates state.global.confidence", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setMetadataField({
+            field: "confidence",
+            value: "high",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.state.global.confidence).toBe("high");
+    });
+    it("SET_METADATA_FIELD with invalid field — records error and leaves state unchanged", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setMetadataField({
+            field: "nonExistentField",
+            value: "someValue",
+            updatedAt: "2026-01-01T00:00:00Z",
+        }));
+        expect(updated.operations.global[0].error).toBeTruthy();
+        // confidence should remain at its initial null value
+        expect(updated.state.global.confidence).toBeNull();
+    });
+    it("SET_TITLE with existing provenance — updates provenance.updatedAt", () => {
+        const document = utils.createDocument();
+        // Establish provenance first
+        const withProvenance = reducer(document, actions.setProvenance({
+            author: "Alice",
+            sourceOrigin: "MANUAL",
+            createdAt: "2026-01-01T00:00:00Z",
+        }));
+        // Now update title — provenance.updatedAt should be bumped
+        const updated = reducer(withProvenance, actions.setTitle({
+            title: "Updated Title",
+            updatedAt: "2026-02-01T00:00:00Z",
+        }));
+        expect(updated.state.global.title).toBe("Updated Title");
+        expect(updated.state.global.provenance?.updatedAt).toBe("2026-02-01T00:00:00Z");
+    });
+});
+// ─── Linking Module ──────────────────────────────────────────────────────────
+describe("Linking module — state mutations", () => {
+    it("ADD_LINK — adds a link entry to state.global.links", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.addLink({
+            id: "link-001",
+            targetDocumentId: "doc-abc",
+            targetTitle: "Target Note",
+            linkType: "RELATES_TO",
+        }));
+        expect(updated.state.global.links).toHaveLength(1);
+        expect(updated.state.global.links[0]).toMatchObject({
+            id: "link-001",
+            targetDocumentId: "doc-abc",
+            targetTitle: "Target Note",
+            linkType: "RELATES_TO",
+        });
+    });
+    it("ADD_LINK with duplicate ID — records error and leaves links unchanged", () => {
+        const document = utils.createDocument();
+        const withLink = reducer(document, actions.addLink({
+            id: "link-001",
+            targetDocumentId: "doc-abc",
+            linkType: "BUILDS_ON",
+        }));
+        // Second ADD_LINK with same id (op index 1)
+        const withDuplicate = reducer(withLink, actions.addLink({
+            id: "link-001",
+            targetDocumentId: "doc-xyz",
+            linkType: "CONTRADICTS",
+        }));
+        expect(withDuplicate.operations.global[1].error).toBeTruthy();
+        expect(withDuplicate.state.global.links).toHaveLength(1);
+    });
+    it("REMOVE_LINK — removes the link from state.global.links", () => {
+        const document = utils.createDocument();
+        const withLink = reducer(document, actions.addLink({
+            id: "link-001",
+            targetDocumentId: "doc-abc",
+            linkType: "RELATES_TO",
+        }));
+        const withRemoval = reducer(withLink, actions.removeLink({ id: "link-001" }));
+        expect(withRemoval.state.global.links).toHaveLength(0);
+    });
+    it("REMOVE_LINK for nonexistent ID — records error", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.removeLink({ id: "does-not-exist" }));
+        expect(updated.operations.global[0].error).toBeTruthy();
+    });
+    it("UPDATE_LINK_TYPE — changes the linkType of an existing link", () => {
+        const document = utils.createDocument();
+        const withLink = reducer(document, actions.addLink({
+            id: "link-001",
+            targetDocumentId: "doc-abc",
+            linkType: "RELATES_TO",
+        }));
+        const updated = reducer(withLink, actions.updateLinkType({ id: "link-001", linkType: "SUPERSEDES" }));
+        expect(updated.state.global.links[0].linkType).toBe("SUPERSEDES");
+    });
+    it("ADD_TOPIC — adds a topic entry to state.global.topics", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.addTopic({
+            id: "topic-001",
+            name: "TypeScript",
+            topicDocumentId: "topic-doc-1",
+        }));
+        expect(updated.state.global.topics).toHaveLength(1);
+        expect(updated.state.global.topics[0]).toMatchObject({
+            id: "topic-001",
+            name: "TypeScript",
+            topicDocumentId: "topic-doc-1",
+        });
+    });
+    it("ADD_TOPIC with duplicate name — records error and leaves topics unchanged", () => {
+        const document = utils.createDocument();
+        const withTopic = reducer(document, actions.addTopic({ id: "topic-001", name: "TypeScript" }));
+        // Second ADD_TOPIC with same name (op index 1)
+        const withDuplicate = reducer(withTopic, actions.addTopic({ id: "topic-002", name: "TypeScript" }));
+        expect(withDuplicate.operations.global[1].error).toBeTruthy();
+        expect(withDuplicate.state.global.topics).toHaveLength(1);
+    });
+});
+// ─── Provenance Module ───────────────────────────────────────────────────────
+describe("Provenance module — state mutations", () => {
+    it("SET_PROVENANCE — populates all provenance fields", () => {
+        const document = utils.createDocument();
+        const updated = reducer(document, actions.setProvenance({
+            author: "Alice",
+            sourceOrigin: "SESSION_MINE",
+            sessionId: "session-xyz",
+            createdAt: "2026-01-01T00:00:00Z",
+        }));
+        const provenance = updated.state.global.provenance;
+        expect(provenance).not.toBeNull();
+        expect(provenance?.author).toBe("Alice");
+        expect(provenance?.sourceOrigin).toBe("SESSION_MINE");
+        expect(provenance?.sessionId).toBe("session-xyz");
+        expect(provenance?.createdAt).toBe("2026-01-01T00:00:00Z");
+        // updatedAt is initialised to createdAt by the reducer
+        expect(provenance?.updatedAt).toBe("2026-01-01T00:00:00Z");
+    });
+});

package/dist/tests/unit/lifecycle-state-machine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle-state-machine.test.d.ts.map

package/dist/tests/unit/lifecycle-state-machine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-state-machine.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/lifecycle-state-machine.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/lifecycle-state-machine.test.js

@@ -0,0 +1,212 @@
+import { describe, it, expect } from "vitest";
+import { reducer, utils, actions, } from "@powerhousedao/knowledge-note/document-models/knowledge-note/v1";
+// Helper: build a document with provenance set (author "alice") and a title set.
+// provenance = op 0, title = op 1 — lifecycle ops start at index 2.
+function makeNoteWithProvenance() {
+    const doc = utils.createDocument();
+    const withProvenance = reducer(doc, actions.setProvenance({
+        author: "alice",
+        sourceOrigin: "MANUAL",
+        createdAt: "2026-01-01T00:00:00Z",
+    }));
+    return reducer(withProvenance, actions.setTitle({
+        title: "Test Note",
+        updatedAt: "2026-01-01T00:00:00Z",
+    }));
+}
+describe("Lifecycle state machine — DRAFT → IN_REVIEW → CANONICAL → ARCHIVED", () => {
+    // ── Test 1 ──────────────────────────────────────────────────────────────────
+    it("SUBMIT_FOR_REVIEW transitions status from DRAFT to IN_REVIEW", () => {
+        const doc = makeNoteWithProvenance();
+        expect(doc.state.global.status).toBe("DRAFT");
+        const updated = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        expect(updated.state.global.status).toBe("IN_REVIEW");
+        // A lifecycle event was appended
+        expect(updated.state.global.lifecycleEvents).toHaveLength(1);
+        expect(updated.state.global.lifecycleEvents[0]).toMatchObject({
+            id: "evt-1",
+            fromStatus: "DRAFT",
+            toStatus: "IN_REVIEW",
+            actor: "alice",
+        });
+    });
+    // ── Test 2 ──────────────────────────────────────────────────────────────────
+    it("APPROVE_NOTE transitions status from IN_REVIEW to CANONICAL when actor differs from author", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        // actor "bob" ≠ author "alice"
+        const approved = reducer(inReview, actions.approveNote({
+            id: "evt-2",
+            actor: "bob",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        expect(approved.state.global.status).toBe("CANONICAL");
+        expect(approved.state.global.lifecycleEvents).toHaveLength(2);
+        expect(approved.state.global.lifecycleEvents[1]).toMatchObject({
+            id: "evt-2",
+            fromStatus: "IN_REVIEW",
+            toStatus: "CANONICAL",
+            actor: "bob",
+        });
+    });
+    // ── Test 3 ──────────────────────────────────────────────────────────────────
+    it("APPROVE_NOTE with same actor as author records error 'Actor cannot approve their own note', status stays IN_REVIEW", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        // actor "alice" == author "alice" → self-approval error
+        // provenance(0), title(1), submitForReview(2), approveNote(3)
+        const selfApproved = reducer(inReview, actions.approveNote({
+            id: "evt-2",
+            actor: "alice",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        expect(selfApproved.operations.global[3].error).toBeTruthy();
+        expect(selfApproved.operations.global[3].error).toContain("Actor cannot approve their own note");
+        expect(selfApproved.state.global.status).toBe("IN_REVIEW");
+    });
+    // ── Test 4 ──────────────────────────────────────────────────────────────────
+    it("REJECT_NOTE transitions status from IN_REVIEW back to DRAFT (comment required)", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        const rejected = reducer(inReview, actions.rejectNote({
+            id: "evt-2",
+            actor: "bob",
+            comment: "Needs more context",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        expect(rejected.state.global.status).toBe("DRAFT");
+        expect(rejected.state.global.lifecycleEvents).toHaveLength(2);
+        expect(rejected.state.global.lifecycleEvents[1]).toMatchObject({
+            id: "evt-2",
+            fromStatus: "IN_REVIEW",
+            toStatus: "DRAFT",
+            actor: "bob",
+            comment: "Needs more context",
+        });
+    });
+    // ── Test 5 ──────────────────────────────────────────────────────────────────
+    it("ARCHIVE_NOTE transitions status from CANONICAL to ARCHIVED (comment required)", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        const canonical = reducer(inReview, actions.approveNote({
+            id: "evt-2",
+            actor: "bob",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        const archived = reducer(canonical, actions.archiveNote({
+            id: "evt-3",
+            actor: "bob",
+            comment: "Superseded by new note",
+            timestamp: "2026-01-01T03:00:00Z",
+        }));
+        expect(archived.state.global.status).toBe("ARCHIVED");
+        expect(archived.state.global.lifecycleEvents).toHaveLength(3);
+        expect(archived.state.global.lifecycleEvents[2]).toMatchObject({
+            id: "evt-3",
+            fromStatus: "CANONICAL",
+            toStatus: "ARCHIVED",
+            actor: "bob",
+            comment: "Superseded by new note",
+        });
+    });
+    // ── Test 6 ──────────────────────────────────────────────────────────────────
+    it("RESTORE_NOTE transitions status from ARCHIVED back to DRAFT", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        const canonical = reducer(inReview, actions.approveNote({
+            id: "evt-2",
+            actor: "bob",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        const archived = reducer(canonical, actions.archiveNote({
+            id: "evt-3",
+            actor: "bob",
+            comment: "Archiving this note",
+            timestamp: "2026-01-01T03:00:00Z",
+        }));
+        const restored = reducer(archived, actions.restoreNote({
+            id: "evt-4",
+            actor: "alice",
+            timestamp: "2026-01-01T04:00:00Z",
+        }));
+        expect(restored.state.global.status).toBe("DRAFT");
+        expect(restored.state.global.lifecycleEvents).toHaveLength(4);
+        expect(restored.state.global.lifecycleEvents[3]).toMatchObject({
+            id: "evt-4",
+            fromStatus: "ARCHIVED",
+            toStatus: "DRAFT",
+            actor: "alice",
+        });
+    });
+    // ── Test 7 ──────────────────────────────────────────────────────────────────
+    it("APPROVE_NOTE from DRAFT (invalid transition) records an error and status stays DRAFT", () => {
+        const doc = makeNoteWithProvenance();
+        // doc is in DRAFT — trying to approve directly is invalid
+        // provenance(0), title(1), approveNote(2)
+        const updated = reducer(doc, actions.approveNote({
+            id: "evt-1",
+            actor: "bob",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        expect(updated.operations.global[2].error).toBeTruthy();
+        expect(updated.operations.global[2].error).toContain("Can only approve from IN_REVIEW status");
+        expect(updated.state.global.status).toBe("DRAFT");
+        expect(updated.state.global.lifecycleEvents).toHaveLength(0);
+    });
+    // ── Test 8 ──────────────────────────────────────────────────────────────────
+    it("Full lifecycle DRAFT→IN_REVIEW→CANONICAL→ARCHIVED→DRAFT produces 4 lifecycle events", () => {
+        const doc = makeNoteWithProvenance();
+        const inReview = reducer(doc, actions.submitForReview({
+            id: "evt-1",
+            actor: "alice",
+            timestamp: "2026-01-01T01:00:00Z",
+        }));
+        const canonical = reducer(inReview, actions.approveNote({
+            id: "evt-2",
+            actor: "bob",
+            timestamp: "2026-01-01T02:00:00Z",
+        }));
+        const archived = reducer(canonical, actions.archiveNote({
+            id: "evt-3",
+            actor: "bob",
+            comment: "Archiving",
+            timestamp: "2026-01-01T03:00:00Z",
+        }));
+        const restored = reducer(archived, actions.restoreNote({
+            id: "evt-4",
+            actor: "alice",
+            timestamp: "2026-01-01T04:00:00Z",
+        }));
+        expect(restored.state.global.status).toBe("DRAFT");
+        expect(restored.state.global.lifecycleEvents).toHaveLength(4);
+        const events = restored.state.global.lifecycleEvents;
+        expect(events[0]).toMatchObject({ fromStatus: "DRAFT", toStatus: "IN_REVIEW" });
+        expect(events[1]).toMatchObject({ fromStatus: "IN_REVIEW", toStatus: "CANONICAL" });
+        expect(events[2]).toMatchObject({ fromStatus: "CANONICAL", toStatus: "ARCHIVED" });
+        expect(events[3]).toMatchObject({ fromStatus: "ARCHIVED", toStatus: "DRAFT" });
+    });
+});

package/dist/tests/unit/moc-reducers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=moc-reducers.test.d.ts.map

package/dist/tests/unit/moc-reducers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moc-reducers.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/moc-reducers.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/moc-reducers.test.js

@@ -0,0 +1,196 @@
+import { describe, it, expect } from "vitest";
+import { reducer, utils, actions } from "@powerhousedao/knowledge-note/document-models/moc/v1";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Create a fresh MOC document with CREATE_MOC already applied. */
+function makeInitialisedMoc() {
+    const doc = utils.createDocument();
+    return reducer(doc, actions.createMoc({
+        title: "Test MOC",
+        description: "Test description",
+        orientation: "Test orientation",
+        tier: "TOPIC",
+        createdAt: "2026-01-01T00:00:00Z",
+    }));
+}
+/** Create a MOC document with one core idea already added. */
+function makeDocWithCoreIdea(ideaId = "idea-001", noteRef = "note://abc") {
+    const moc = makeInitialisedMoc();
+    return reducer(moc, actions.addCoreIdea({
+        id: ideaId,
+        noteRef,
+        contextPhrase: "A central concept",
+        sortOrder: 0,
+        addedAt: "2026-01-02T00:00:00Z",
+    }));
+}
+// ─── Test suite ───────────────────────────────────────────────────────────────
+describe("MOC — CREATE_MOC", () => {
+    it("initialises title, description, orientation, tier, createdAt and noteCount = 0", () => {
+        const doc = utils.createDocument();
+        const moc = reducer(doc, actions.createMoc({
+            title: "My Hub",
+            description: "Hub description",
+            orientation: "North-South",
+            tier: "HUB",
+            createdAt: "2026-01-01T00:00:00Z",
+        }));
+        const g = moc.state.global;
+        expect(g.title).toBe("My Hub");
+        expect(g.description).toBe("Hub description");
+        expect(g.orientation).toBe("North-South");
+        expect(g.tier).toBe("HUB");
+        expect(g.createdAt).toBe("2026-01-01T00:00:00Z");
+        expect(g.noteCount).toBe(0);
+    });
+    it("stores an optional parentRef when provided", () => {
+        const doc = utils.createDocument();
+        const moc = reducer(doc, actions.createMoc({
+            title: "Child MOC",
+            description: "D",
+            orientation: "O",
+            tier: "TOPIC",
+            createdAt: "2026-01-01T00:00:00Z",
+            parentRef: "moc://parent-hub",
+        }));
+        expect(moc.state.global.parentRef).toBe("moc://parent-hub");
+    });
+});
+// ─── ADD_CORE_IDEA ────────────────────────────────────────────────────────────
+describe("MOC — ADD_CORE_IDEA", () => {
+    it("increments noteCount and appends to coreIdeas", () => {
+        const moc = makeInitialisedMoc();
+        const updated = reducer(moc, actions.addCoreIdea({
+            id: "idea-001",
+            noteRef: "note://abc",
+            contextPhrase: "Core concept",
+            sortOrder: 0,
+            addedAt: "2026-01-02T00:00:00Z",
+        }));
+        expect(updated.state.global.noteCount).toBe(1);
+        expect(updated.state.global.coreIdeas).toHaveLength(1);
+        expect(updated.state.global.coreIdeas[0]).toMatchObject({
+            id: "idea-001",
+            noteRef: "note://abc",
+            contextPhrase: "Core concept",
+            sortOrder: 0,
+            addedAt: "2026-01-02T00:00:00Z",
+        });
+    });
+    it("adding a second idea increments noteCount to 2", () => {
+        const withOne = makeDocWithCoreIdea();
+        const updated = reducer(withOne, actions.addCoreIdea({
+            id: "idea-002",
+            noteRef: "note://def",
+            contextPhrase: "Another concept",
+            sortOrder: 1,
+            addedAt: "2026-01-03T00:00:00Z",
+        }));
+        expect(updated.state.global.noteCount).toBe(2);
+        expect(updated.state.global.coreIdeas).toHaveLength(2);
+    });
+    it("duplicate noteRef — records error and leaves state unchanged", () => {
+        const withOne = makeDocWithCoreIdea("idea-001", "note://abc");
+        // Second ADD_CORE_IDEA for the same noteRef (op index 2 — CREATE_MOC is 0, ADD_CORE_IDEA is 1)
+        const withDuplicate = reducer(withOne, actions.addCoreIdea({
+            id: "idea-002",
+            noteRef: "note://abc", // same noteRef
+            contextPhrase: "Duplicate",
+            sortOrder: 1,
+            addedAt: "2026-01-03T00:00:00Z",
+        }));
+        expect(withDuplicate.operations.global[2].error).toBeTruthy();
+        expect(withDuplicate.state.global.coreIdeas).toHaveLength(1);
+        expect(withDuplicate.state.global.noteCount).toBe(1);
+    });
+});
+// ─── REMOVE_CORE_IDEA ─────────────────────────────────────────────────────────
+describe("MOC — REMOVE_CORE_IDEA", () => {
+    it("decrements noteCount and removes the idea from the array", () => {
+        const withOne = makeDocWithCoreIdea("idea-001");
+        const updated = reducer(withOne, actions.removeCoreIdea({ id: "idea-001" }));
+        expect(updated.state.global.noteCount).toBe(0);
+        expect(updated.state.global.coreIdeas).toHaveLength(0);
+    });
+    it("nonexistent ID — records error and leaves state unchanged", () => {
+        const moc = makeInitialisedMoc();
+        // First op is CREATE_MOC (index 0), REMOVE_CORE_IDEA is index 1
+        const updated = reducer(moc, actions.removeCoreIdea({ id: "does-not-exist" }));
+        expect(updated.operations.global[1].error).toBeTruthy();
+        expect(updated.state.global.coreIdeas).toHaveLength(0);
+        expect(updated.state.global.noteCount).toBe(0);
+    });
+});
+// ─── ADD_OPEN_QUESTION ────────────────────────────────────────────────────────
+describe("MOC — ADD_OPEN_QUESTION", () => {
+    it("appends question to openQuestions array", () => {
+        const moc = makeInitialisedMoc();
+        const updated = reducer(moc, actions.addOpenQuestion({ question: "What is the core tension here?" }));
+        expect(updated.state.global.openQuestions).toContain("What is the core tension here?");
+        expect(updated.state.global.openQuestions).toHaveLength(1);
+    });
+    it("multiple questions accumulate in order", () => {
+        const moc = makeInitialisedMoc();
+        const withFirst = reducer(moc, actions.addOpenQuestion({ question: "Question one?" }));
+        const withSecond = reducer(withFirst, actions.addOpenQuestion({ question: "Question two?" }));
+        expect(withSecond.state.global.openQuestions).toEqual([
+            "Question one?",
+            "Question two?",
+        ]);
+    });
+});
+// ─── REMOVE_OPEN_QUESTION ─────────────────────────────────────────────────────
+describe("MOC — REMOVE_OPEN_QUESTION", () => {
+    it("removes the matching question from openQuestions", () => {
+        const moc = makeInitialisedMoc();
+        const withQ = reducer(moc, actions.addOpenQuestion({ question: "To remove?" }));
+        const removed = reducer(withQ, actions.removeOpenQuestion({ question: "To remove?" }));
+        expect(removed.state.global.openQuestions).toHaveLength(0);
+    });
+    it("removing a non-existent question leaves the array unchanged", () => {
+        const moc = makeInitialisedMoc();
+        const withQ = reducer(moc, actions.addOpenQuestion({ question: "Stays here" }));
+        const unchanged = reducer(withQ, actions.removeOpenQuestion({ question: "Not present" }));
+        expect(unchanged.state.global.openQuestions).toEqual(["Stays here"]);
+    });
+});
+// ─── ADD_CHILD_MOC ────────────────────────────────────────────────────────────
+describe("MOC — ADD_CHILD_MOC", () => {
+    it("adds childRef to childRefs array", () => {
+        const moc = makeInitialisedMoc();
+        const updated = reducer(moc, actions.addChildMoc({ childRef: "moc://child-topic-1" }));
+        expect(updated.state.global.childRefs).toContain("moc://child-topic-1");
+        expect(updated.state.global.childRefs).toHaveLength(1);
+    });
+    it("duplicate childRef — records error and leaves childRefs unchanged", () => {
+        const moc = makeInitialisedMoc();
+        const withChild = reducer(moc, actions.addChildMoc({ childRef: "moc://child-topic-1" }));
+        // Second ADD_CHILD_MOC with same ref (op index 2)
+        const withDuplicate = reducer(withChild, actions.addChildMoc({ childRef: "moc://child-topic-1" }));
+        expect(withDuplicate.operations.global[2].error).toBeTruthy();
+        expect(withDuplicate.state.global.childRefs).toHaveLength(1);
+    });
+});
+// ─── UPDATE_ORIENTATION ───────────────────────────────────────────────────────
+describe("MOC — UPDATE_ORIENTATION", () => {
+    it("changes orientation field", () => {
+        const moc = makeInitialisedMoc();
+        const updated = reducer(moc, actions.updateOrientation({
+            orientation: "East-West",
+            updatedAt: "2026-02-01T00:00:00Z",
+        }));
+        expect(updated.state.global.orientation).toBe("East-West");
+        expect(updated.state.global.updatedAt).toBe("2026-02-01T00:00:00Z");
+    });
+});
+// ─── UPDATE_DESCRIPTION ───────────────────────────────────────────────────────
+describe("MOC — UPDATE_DESCRIPTION", () => {
+    it("changes description field", () => {
+        const moc = makeInitialisedMoc();
+        const updated = reducer(moc, actions.updateDescription({
+            description: "New and improved description",
+            updatedAt: "2026-02-01T00:00:00Z",
+        }));
+        expect(updated.state.global.description).toBe("New and improved description");
+        expect(updated.state.global.updatedAt).toBe("2026-02-01T00:00:00Z");
+    });
+});

package/dist/tests/unit/pipeline-queue-reducers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline-queue-reducers.test.d.ts.map

package/dist/tests/unit/pipeline-queue-reducers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-queue-reducers.test.d.ts","sourceRoot":"","sources":["../../../tests/unit/pipeline-queue-reducers.test.ts"],"names":[],"mappings":""}