@langadventurellc/task-trellis-mcp 0.1.0-rc.3

package/dist/utils/__tests__/serializeTrellisObject.test.d.ts

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

package/dist/utils/__tests__/serializeTrellisObject.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeTrellisObject.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/serializeTrellisObject.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/serializeTrellisObject.test.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const yaml_1 = require("yaml");
+const models_1 = require("../../models");
+const serializeTrellisObject_1 = require("../serializeTrellisObject");
+describe("serializeTrellisObject", () => {
+    it("should serialize a basic TrellisObject to markdown with YAML frontmatter", () => {
+        const trellisObject = {
+            id: "test-id-123",
+            title: "Test Task",
+            status: models_1.TrellisObjectStatus.IN_PROGRESS,
+            priority: models_1.TrellisObjectPriority.HIGH,
+            prerequisites: ["prereq-1", "prereq-2"],
+            affectedFiles: new Map([
+                ["src/file1.ts", "modified"],
+                ["src/file2.ts", "created"],
+            ]),
+            log: ["Initial commit", "Updated implementation"],
+            schema: "v1.0",
+            childrenIds: ["child-1", "child-2"],
+            body: "This is the main content of the task.",
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        // Check that it starts and ends correctly
+        expect(result).toMatch(/^---\n/);
+        expect(result).toMatch(/\n---\n\nThis is the main content of the task\.$/);
+        // Parse the YAML frontmatter to verify structure
+        const yamlPart = result.split("---\n")[1];
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        expect(parsedYaml).toEqual({
+            id: "test-id-123",
+            title: "Test Task",
+            status: models_1.TrellisObjectStatus.IN_PROGRESS,
+            priority: models_1.TrellisObjectPriority.HIGH,
+            prerequisites: ["prereq-1", "prereq-2"],
+            affectedFiles: {
+                "src/file1.ts": "modified",
+                "src/file2.ts": "created",
+            },
+            log: ["Initial commit", "Updated implementation"],
+            schema: "v1.0",
+            childrenIds: ["child-1", "child-2"],
+        });
+    });
+    it("should handle multi-line log entries correctly", () => {
+        const trellisObject = {
+            id: "multiline-test",
+            title: "Multi-line Log Test",
+            status: models_1.TrellisObjectStatus.OPEN,
+            priority: models_1.TrellisObjectPriority.MEDIUM,
+            prerequisites: [],
+            affectedFiles: new Map(),
+            log: [
+                "Single line entry",
+                "Multi-line entry:\nThis spans multiple lines\nWith various details\nAnd even more information",
+                "Another single line",
+                "Complex multi-line:\n- Bullet point 1\n- Bullet point 2\n  - Nested point\n- Final point",
+            ],
+            schema: "v1.0",
+            childrenIds: [],
+            body: "Test body content",
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        // Parse the YAML frontmatter
+        const yamlPart = result.split("---\n")[1];
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        // Verify that multi-line log entries are preserved correctly
+        expect(parsedYaml.log).toHaveLength(4);
+        expect(parsedYaml.log[0]).toBe("Single line entry");
+        expect(parsedYaml.log[1]).toBe("Multi-line entry:\nThis spans multiple lines\nWith various details\nAnd even more information");
+        expect(parsedYaml.log[2]).toBe("Another single line");
+        expect(parsedYaml.log[3]).toBe("Complex multi-line:\n- Bullet point 1\n- Bullet point 2\n  - Nested point\n- Final point");
+        // Verify the structure is still valid YAML
+        expect(() => (0, yaml_1.parse)(yamlPart)).not.toThrow();
+    });
+    it("should handle empty arrays and Map correctly", () => {
+        const trellisObject = {
+            id: "empty-test",
+            title: "Empty Collections Test",
+            status: models_1.TrellisObjectStatus.DRAFT,
+            priority: models_1.TrellisObjectPriority.LOW,
+            prerequisites: [],
+            affectedFiles: new Map(),
+            log: [],
+            schema: "v1.0",
+            childrenIds: [],
+            body: "",
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        const yamlPart = result.split("---\n")[1];
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        expect(parsedYaml.prerequisites).toEqual([]);
+        expect(parsedYaml.affectedFiles).toEqual({});
+        expect(parsedYaml.log).toEqual([]);
+        expect(parsedYaml.childrenIds).toEqual([]);
+    });
+    it("should handle special characters in strings", () => {
+        const trellisObject = {
+            id: "special-chars-test",
+            title: 'Title with "quotes" and symbols: @#$%',
+            status: models_1.TrellisObjectStatus.IN_PROGRESS,
+            priority: models_1.TrellisObjectPriority.HIGH,
+            prerequisites: ["prereq with spaces", "prereq-with-dashes"],
+            affectedFiles: new Map([
+                ["src/file with spaces.ts", 'status with "quotes"'],
+                ["src/file-with-dashes.ts", "status: with: colons"],
+            ]),
+            log: [
+                'Log entry with "double quotes"',
+                "Log entry with 'single quotes'",
+                "Log entry with: colons and @symbols",
+            ],
+            schema: "v2.0-beta",
+            childrenIds: ["child-with-dashes", "child with spaces"],
+            body: 'Body with "quotes", symbols: @#$%, and other special characters!',
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        const yamlPart = result.split("---\n")[1];
+        // Should parse without errors
+        expect(() => (0, yaml_1.parse)(yamlPart)).not.toThrow();
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        expect(parsedYaml.title).toBe('Title with "quotes" and symbols: @#$%');
+        expect(parsedYaml.affectedFiles["src/file with spaces.ts"]).toBe('status with "quotes"');
+        expect(parsedYaml.log[0]).toBe('Log entry with "double quotes"');
+    });
+    it("should preserve the body content separately from frontmatter", () => {
+        const bodyContent = `# Main Task Description
+
+    This is a detailed description of the task.
+    
+    ## Steps to Complete
+    
+    1. First step
+    2. Second step
+    3. Final step
+    
+    > Important note about the implementation`;
+        const trellisObject = {
+            id: "body-test",
+            title: "Body Content Test",
+            status: models_1.TrellisObjectStatus.OPEN,
+            priority: models_1.TrellisObjectPriority.MEDIUM,
+            prerequisites: [],
+            affectedFiles: new Map(),
+            log: [],
+            schema: "v1.0",
+            childrenIds: [],
+            body: bodyContent,
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        // Check that body is not in the YAML frontmatter
+        const yamlPart = result.split("---\n")[1];
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        expect(parsedYaml.body).toBeUndefined();
+        // Check that body appears after the frontmatter
+        const bodyPart = result.split(/---\n.*?\n---\n\n/s)[1];
+        expect(bodyPart).toBe(bodyContent);
+    });
+    it("should handle Map with complex keys and values", () => {
+        const trellisObject = {
+            id: "complex-map-test",
+            title: "Complex Map Test",
+            status: models_1.TrellisObjectStatus.IN_PROGRESS,
+            priority: models_1.TrellisObjectPriority.HIGH,
+            prerequisites: [],
+            affectedFiles: new Map([
+                ["path/to/complex file name.ts", "created"],
+                ["another/path/file.js", "modified"],
+                ["config/settings.json", "deleted"],
+            ]),
+            log: [],
+            schema: "v1.0",
+            childrenIds: [],
+            body: "Test content",
+            type: models_1.TrellisObjectType.PROJECT,
+        };
+        const result = (0, serializeTrellisObject_1.serializeTrellisObject)(trellisObject);
+        const yamlPart = result.split("---\n")[1];
+        const parsedYaml = (0, yaml_1.parse)(yamlPart);
+        expect(parsedYaml.affectedFiles).toEqual({
+            "path/to/complex file name.ts": "created",
+            "another/path/file.js": "modified",
+            "config/settings.json": "deleted",
+        });
+    });
+});
+//# sourceMappingURL=serializeTrellisObject.test.js.map

package/dist/utils/__tests__/serializeTrellisObject.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeTrellisObject.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/serializeTrellisObject.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/__tests__/sortTrellisObjects.test.d.ts

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

package/dist/utils/__tests__/sortTrellisObjects.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortTrellisObjects.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/sortTrellisObjects.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/sortTrellisObjects.test.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const models_1 = require("../../models");
+const sortTrellisObjects_1 = require("../sortTrellisObjects");
+describe("sortTrellisObjects", () => {
+    const createMockObject = (id, priority) => ({
+        id,
+        title: `Task ${id}`,
+        status: models_1.TrellisObjectStatus.OPEN,
+        priority,
+        prerequisites: [],
+        affectedFiles: new Map(),
+        log: [],
+        schema: "v1.0",
+        childrenIds: [],
+        body: `Body for ${id}`,
+        type: models_1.TrellisObjectType.TASK,
+    });
+    it("should sort objects by priority: high, medium, low", () => {
+        const objects = [
+            createMockObject("low-1", models_1.TrellisObjectPriority.LOW),
+            createMockObject("high-1", models_1.TrellisObjectPriority.HIGH),
+            createMockObject("medium-1", models_1.TrellisObjectPriority.MEDIUM),
+            createMockObject("low-2", models_1.TrellisObjectPriority.LOW),
+            createMockObject("high-2", models_1.TrellisObjectPriority.HIGH),
+        ];
+        const sorted = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(sorted).toHaveLength(5);
+        expect(sorted[0].priority).toBe(models_1.TrellisObjectPriority.HIGH);
+        expect(sorted[1].priority).toBe(models_1.TrellisObjectPriority.HIGH);
+        expect(sorted[2].priority).toBe(models_1.TrellisObjectPriority.MEDIUM);
+        expect(sorted[3].priority).toBe(models_1.TrellisObjectPriority.LOW);
+        expect(sorted[4].priority).toBe(models_1.TrellisObjectPriority.LOW);
+        expect(sorted[0].id).toBe("high-1");
+        expect(sorted[1].id).toBe("high-2");
+        expect(sorted[2].id).toBe("medium-1");
+        expect(sorted[3].id).toBe("low-1");
+        expect(sorted[4].id).toBe("low-2");
+    });
+    it("should return a new array without modifying the original", () => {
+        const objects = [
+            createMockObject("low", models_1.TrellisObjectPriority.LOW),
+            createMockObject("high", models_1.TrellisObjectPriority.HIGH),
+        ];
+        const originalOrder = objects.map((obj) => obj.id);
+        const sorted = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(objects.map((obj) => obj.id)).toEqual(originalOrder);
+        expect(sorted).not.toBe(objects);
+        expect(sorted[0].id).toBe("high");
+        expect(sorted[1].id).toBe("low");
+    });
+    it("should handle empty array", () => {
+        const result = (0, sortTrellisObjects_1.sortTrellisObjects)([]);
+        expect(result).toEqual([]);
+    });
+    it("should handle single object", () => {
+        const objects = [createMockObject("single", models_1.TrellisObjectPriority.MEDIUM)];
+        const result = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(result).toHaveLength(1);
+        expect(result[0].id).toBe("single");
+        expect(result[0].priority).toBe(models_1.TrellisObjectPriority.MEDIUM);
+    });
+    it("should handle all objects with same priority", () => {
+        const objects = [
+            createMockObject("first", models_1.TrellisObjectPriority.HIGH),
+            createMockObject("second", models_1.TrellisObjectPriority.HIGH),
+            createMockObject("third", models_1.TrellisObjectPriority.HIGH),
+        ];
+        const result = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(result).toHaveLength(3);
+        result.forEach((obj) => {
+            expect(obj.priority).toBe(models_1.TrellisObjectPriority.HIGH);
+        });
+    });
+    it("should maintain stable sort for objects with same priority", () => {
+        const objects = [
+            createMockObject("high-first", models_1.TrellisObjectPriority.HIGH),
+            createMockObject("high-second", models_1.TrellisObjectPriority.HIGH),
+            createMockObject("medium-first", models_1.TrellisObjectPriority.MEDIUM),
+            createMockObject("medium-second", models_1.TrellisObjectPriority.MEDIUM),
+        ];
+        const result = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(result[0].id).toBe("high-first");
+        expect(result[1].id).toBe("high-second");
+        expect(result[2].id).toBe("medium-first");
+        expect(result[3].id).toBe("medium-second");
+    });
+    it("should work with mixed object types", () => {
+        const objects = [
+            {
+                ...createMockObject("project", models_1.TrellisObjectPriority.LOW),
+                type: models_1.TrellisObjectType.PROJECT,
+            },
+            {
+                ...createMockObject("epic", models_1.TrellisObjectPriority.HIGH),
+                type: models_1.TrellisObjectType.EPIC,
+            },
+            {
+                ...createMockObject("feature", models_1.TrellisObjectPriority.MEDIUM),
+                type: models_1.TrellisObjectType.FEATURE,
+            },
+            {
+                ...createMockObject("task", models_1.TrellisObjectPriority.HIGH),
+                type: models_1.TrellisObjectType.TASK,
+            },
+        ];
+        const result = (0, sortTrellisObjects_1.sortTrellisObjects)(objects);
+        expect(result[0].priority).toBe(models_1.TrellisObjectPriority.HIGH);
+        expect(result[1].priority).toBe(models_1.TrellisObjectPriority.HIGH);
+        expect(result[2].priority).toBe(models_1.TrellisObjectPriority.MEDIUM);
+        expect(result[3].priority).toBe(models_1.TrellisObjectPriority.LOW);
+    });
+});
+//# sourceMappingURL=sortTrellisObjects.test.js.map

package/dist/utils/__tests__/sortTrellisObjects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortTrellisObjects.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/sortTrellisObjects.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/checkPrerequisitesComplete.d.ts

@@ -0,0 +1,12 @@
+import { TrellisObject } from "../models/TrellisObject";
+import { Repository } from "../repositories/Repository";
+/**
+ * Checks if all prerequisites for a trellis object are complete (closed).
+ * A prerequisite is considered complete if its status is DONE or WONT_DO.
+ *
+ * @param trellisObject - The trellis object to check prerequisites for
+ * @param repository - The repository to load prerequisite objects from
+ * @returns Promise<boolean> - true if all prerequisites are complete or no prerequisites exist, false otherwise
+ */
+export declare function checkPrerequisitesComplete(trellisObject: TrellisObject, repository: Repository): Promise<boolean>;
+//# sourceMappingURL=checkPrerequisitesComplete.d.ts.map

package/dist/utils/checkPrerequisitesComplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPrerequisitesComplete.d.ts","sourceRoot":"","sources":["../../src/utils/checkPrerequisitesComplete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,OAAO,CAAC,CAiClB"}

package/dist/utils/checkPrerequisitesComplete.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPrerequisitesComplete = checkPrerequisitesComplete;
+const TrellisObjectStatus_1 = require("../models/TrellisObjectStatus");
+/**
+ * Checks if all prerequisites for a trellis object are complete (closed).
+ * A prerequisite is considered complete if its status is DONE or WONT_DO.
+ *
+ * @param trellisObject - The trellis object to check prerequisites for
+ * @param repository - The repository to load prerequisite objects from
+ * @returns Promise<boolean> - true if all prerequisites are complete or no prerequisites exist, false otherwise
+ */
+async function checkPrerequisitesComplete(trellisObject, repository) {
+    // If no prerequisites, return true
+    if (!trellisObject.prerequisites ||
+        trellisObject.prerequisites.length === 0) {
+        return true;
+    }
+    // Use bulk getObjects call for better performance
+    const allObjects = await repository.getObjects();
+    const objectMap = new Map();
+    allObjects.forEach((obj) => objectMap.set(obj.id, obj));
+    // Check if any prerequisite that exists in our system is not complete
+    for (const prerequisiteId of trellisObject.prerequisites) {
+        const prerequisiteObj = objectMap.get(prerequisiteId);
+        // If prerequisite is not in our system, it's fine (external dependency)
+        if (!prerequisiteObj) {
+            continue;
+        }
+        // If prerequisite is in our system but not done or wont-do, it's blocking
+        if (prerequisiteObj.status !== TrellisObjectStatus_1.TrellisObjectStatus.DONE &&
+            prerequisiteObj.status !== TrellisObjectStatus_1.TrellisObjectStatus.WONT_DO) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=checkPrerequisitesComplete.js.map

package/dist/utils/checkPrerequisitesComplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPrerequisitesComplete.js","sourceRoot":"","sources":["../../src/utils/checkPrerequisitesComplete.ts"],"names":[],"mappings":";;AAYA,gEAoCC;AA/CD,uEAAoE;AAGpE;;;;;;;GAOG;AACI,KAAK,UAAU,0BAA0B,CAC9C,aAA4B,EAC5B,UAAsB;IAEtB,mCAAmC;IACnC,IACE,CAAC,aAAa,CAAC,aAAa;QAC5B,aAAa,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EACxC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kDAAkD;IAClD,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAExD,sEAAsE;IACtE,KAAK,MAAM,cAAc,IAAI,aAAa,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAEtD,wEAAwE;QACxE,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,IACE,eAAe,CAAC,MAAM,KAAK,yCAAmB,CAAC,IAAI;YACnD,eAAe,CAAC,MAAM,KAAK,yCAAmB,CAAC,OAAO,EACtD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/deserializeTrellisObject.d.ts

@@ -0,0 +1,9 @@
+import { TrellisObject } from "../models";
+/**
+ * Deserializes a markdown string with YAML frontmatter back to a TrellisObject
+ * @param markdownString - The markdown string with YAML frontmatter to deserialize
+ * @returns A TrellisObject reconstructed from the markdown string
+ * @throws Error if the input string is not properly formatted or missing required fields
+ */
+export declare function deserializeTrellisObject(markdownString: string): TrellisObject;
+//# sourceMappingURL=deserializeTrellisObject.d.ts.map

package/dist/utils/deserializeTrellisObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializeTrellisObject.d.ts","sourceRoot":"","sources":["../../src/utils/deserializeTrellisObject.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EAGd,MAAM,WAAW,CAAC;AA4InB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,GACrB,aAAa,CAuBf"}

package/dist/utils/deserializeTrellisObject.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deserializeTrellisObject = deserializeTrellisObject;
+const yaml_1 = require("yaml");
+const models_1 = require("../models");
+const inferObjectType_1 = require("./inferObjectType");
+/**
+ * Extracts frontmatter and body content from markdown string
+ */
+function extractFrontmatterAndBody(markdownString) {
+    const frontmatterStart = markdownString.indexOf("---");
+    if (frontmatterStart === -1) {
+        throw new Error("Invalid format: Expected YAML frontmatter delimited by --- markers");
+    }
+    const frontmatterEnd = markdownString.indexOf("---", frontmatterStart + 3);
+    if (frontmatterEnd === -1) {
+        throw new Error("Invalid format: Expected YAML frontmatter delimited by --- markers");
+    }
+    const yamlContent = markdownString
+        .substring(frontmatterStart + 3, frontmatterEnd)
+        .trim();
+    const bodyContent = markdownString
+        .substring(frontmatterEnd + 3)
+        .replace(/^\n+/, "");
+    return { yamlContent, bodyContent };
+}
+/**
+ * Parses YAML content and validates it's an object
+ */
+function parseFrontmatter(yamlContent) {
+    let frontmatter;
+    try {
+        frontmatter = (0, yaml_1.parse)(yamlContent);
+    }
+    catch (error) {
+        throw new Error(`Invalid YAML frontmatter: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    if (typeof frontmatter !== "object" || frontmatter === null) {
+        throw new Error("Invalid frontmatter: Expected an object");
+    }
+    return frontmatter;
+}
+/**
+ * Validates required fields in frontmatter
+ */
+function validateRequiredFields(fm) {
+    const requiredFields = [
+        "id",
+        "title",
+        "status",
+        "priority",
+        "schema",
+    ];
+    for (const field of requiredFields) {
+        if (fm[field] === undefined || fm[field] === null) {
+            throw new Error(`Missing required field: ${field}`);
+        }
+        if (typeof fm[field] !== "string") {
+            throw new Error(`Invalid type for field ${field}: Expected string`);
+        }
+    }
+}
+/**
+ * Converts affectedFiles object to Map
+ */
+function processAffectedFiles(fm) {
+    const affectedFilesMap = new Map();
+    if (fm.affectedFiles &&
+        typeof fm.affectedFiles === "object" &&
+        fm.affectedFiles !== null) {
+        for (const [key, value] of Object.entries(fm.affectedFiles)) {
+            if (typeof value === "string") {
+                affectedFilesMap.set(key, value);
+            }
+        }
+    }
+    return affectedFilesMap;
+}
+/**
+ * Safely converts value to string array
+ */
+function toStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string");
+    }
+    return [];
+}
+/**
+ * Converts status string to enum
+ */
+function toStatus(statusString) {
+    const status = statusString;
+    if (Object.values(models_1.TrellisObjectStatus).includes(status)) {
+        return status;
+    }
+    throw new Error(`Invalid status value: ${status}`);
+}
+/**
+ * Converts priority string to enum
+ */
+function toPriority(priorityString) {
+    const priority = priorityString;
+    if (Object.values(models_1.TrellisObjectPriority).includes(priority)) {
+        return priority;
+    }
+    throw new Error(`Invalid priority value: ${priority}`);
+}
+/**
+ * Deserializes a markdown string with YAML frontmatter back to a TrellisObject
+ * @param markdownString - The markdown string with YAML frontmatter to deserialize
+ * @returns A TrellisObject reconstructed from the markdown string
+ * @throws Error if the input string is not properly formatted or missing required fields
+ */
+function deserializeTrellisObject(markdownString) {
+    const { yamlContent, bodyContent } = extractFrontmatterAndBody(markdownString);
+    const fm = parseFrontmatter(yamlContent);
+    validateRequiredFields(fm);
+    const affectedFilesMap = processAffectedFiles(fm);
+    const trellisObject = {
+        id: fm.id,
+        type: (0, inferObjectType_1.inferObjectType)(fm.id),
+        title: fm.title,
+        status: toStatus(fm.status),
+        priority: toPriority(fm.priority),
+        prerequisites: toStringArray(fm.prerequisites),
+        affectedFiles: affectedFilesMap,
+        log: toStringArray(fm.log),
+        schema: fm.schema,
+        childrenIds: toStringArray(fm.childrenIds),
+        body: bodyContent,
+    };
+    return trellisObject;
+}
+//# sourceMappingURL=deserializeTrellisObject.js.map

package/dist/utils/deserializeTrellisObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deserializeTrellisObject.js","sourceRoot":"","sources":["../../src/utils/deserializeTrellisObject.ts"],"names":[],"mappings":"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"}

package/dist/utils/filterUnavailableObjects.d.ts

@@ -0,0 +1,13 @@
+import { TrellisObject } from "../models/TrellisObject";
+/**
+ * Filters a list of TrellisObjects to return only those that are available to work on.
+ *
+ * An object is considered unavailable if:
+ * 1. It doesn't have a status of "open"
+ * 2. It has prerequisites that refer to objects in the same list that are not "done" or "wont-do"
+ *
+ * @param objects - Array of TrellisObjects to filter
+ * @returns Array of available TrellisObjects
+ */
+export declare function filterUnavailableObjects(objects: TrellisObject[]): TrellisObject[];
+//# sourceMappingURL=filterUnavailableObjects.d.ts.map

package/dist/utils/filterUnavailableObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterUnavailableObjects.d.ts","sourceRoot":"","sources":["../../src/utils/filterUnavailableObjects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,EAAE,GACvB,aAAa,EAAE,CA+BjB"}

package/dist/utils/filterUnavailableObjects.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterUnavailableObjects = filterUnavailableObjects;
+const TrellisObjectStatus_1 = require("../models/TrellisObjectStatus");
+/**
+ * Filters a list of TrellisObjects to return only those that are available to work on.
+ *
+ * An object is considered unavailable if:
+ * 1. It doesn't have a status of "open"
+ * 2. It has prerequisites that refer to objects in the same list that are not "done" or "wont-do"
+ *
+ * @param objects - Array of TrellisObjects to filter
+ * @returns Array of available TrellisObjects
+ */
+function filterUnavailableObjects(objects) {
+    // Create a map for quick lookup of objects by ID
+    const objectMap = new Map();
+    objects.forEach((obj) => objectMap.set(obj.id, obj));
+    return objects.filter((obj) => {
+        // Rule 1: Object must have status "open"
+        if (obj.status !== TrellisObjectStatus_1.TrellisObjectStatus.OPEN) {
+            return false;
+        }
+        // Rule 2: Check prerequisites
+        for (const prerequisiteId of obj.prerequisites) {
+            const prerequisiteObj = objectMap.get(prerequisiteId);
+            // If prerequisite is not in the list, it's fine (external dependency)
+            if (!prerequisiteObj) {
+                continue;
+            }
+            // If prerequisite is in the list but not done or wont-do, exclude this object
+            if (prerequisiteObj.status !== TrellisObjectStatus_1.TrellisObjectStatus.DONE &&
+                prerequisiteObj.status !== TrellisObjectStatus_1.TrellisObjectStatus.WONT_DO) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=filterUnavailableObjects.js.map

package/dist/utils/filterUnavailableObjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterUnavailableObjects.js","sourceRoot":"","sources":["../../src/utils/filterUnavailableObjects.ts"],"names":[],"mappings":";;AAaA,4DAiCC;AA7CD,uEAAoE;AAEpE;;;;;;;;;GASG;AACH,SAAgB,wBAAwB,CACtC,OAAwB;IAExB,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5B,yCAAyC;QACzC,IAAI,GAAG,CAAC,MAAM,KAAK,yCAAmB,CAAC,IAAI,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8BAA8B;QAC9B,KAAK,MAAM,cAAc,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YAC/C,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAEtD,sEAAsE;YACtE,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,8EAA8E;YAC9E,IACE,eAAe,CAAC,MAAM,KAAK,yCAAmB,CAAC,IAAI;gBACnD,eAAe,CAAC,MAAM,KAAK,yCAAmB,CAAC,OAAO,EACtD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/generateUniqueId.d.ts

@@ -0,0 +1,10 @@
+import { TrellisObjectType } from "../models/TrellisObjectType";
+/**
+ * Generates a unique ID for a Trellis object
+ * @param title - The title to generate an ID from
+ * @param type - The type of Trellis object
+ * @param existingIds - List of existing IDs to avoid duplicates
+ * @returns A unique ID with appropriate prefix
+ */
+export declare function generateUniqueId(title: string, type: TrellisObjectType, existingIds: string[]): string;
+//# sourceMappingURL=generateUniqueId.d.ts.map

package/dist/utils/generateUniqueId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateUniqueId.d.ts","sourceRoot":"","sources":["../../src/utils/generateUniqueId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AA4ChE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CAyBR"}