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

package/dist/repositories/local/__tests__/scopeFilter.test.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const filterByScope_1 = require("../filterByScope");
+const scopeFilter_1 = require("../scopeFilter");
+describe("scopeFilter", () => {
+    describe("matchesScope", () => {
+        it("should return true when no scope is provided", () => {
+            const filePath = "/path/to/project/P-test-project/file.md";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, "");
+            expect(result).toBe(true);
+        });
+        it("should match files within project scope", () => {
+            const filePath = "/path/to/project/P-ecommerce-platform/epic/file.md";
+            const scope = "P-ecommerce-platform";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(true);
+        });
+        it("should match files within epic scope", () => {
+            const filePath = "/path/to/project/E-user-management/feature/file.md";
+            const scope = "E-user-management";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(true);
+        });
+        it("should match files within feature scope", () => {
+            const filePath = "/path/to/project/F-user-registration/task/file.md";
+            const scope = "F-user-registration";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(true);
+        });
+        it("should not match files outside of scope", () => {
+            const filePath = "/path/to/project/P-different-project/file.md";
+            const scope = "P-ecommerce-platform";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(false);
+        });
+        it("should handle paths with multiple directory separators correctly", () => {
+            const filePath = "/root/p/P-project/e/E-epic/f/F-feature/t/open/T-task.md";
+            const scope = "P-project";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(true);
+        });
+        it("should not match partial scope names", () => {
+            const filePath = "/path/to/project/P-ecommerce-platform-extended/file.md";
+            const scope = "P-ecommerce-platform";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(false);
+        });
+        it("should match scope at the end of path", () => {
+            const filePath = "/path/to/F-user-auth/F-user-auth.md";
+            const scope = "F-user-auth";
+            const result = (0, scopeFilter_1.matchesScope)(filePath, scope);
+            expect(result).toBe(true);
+        });
+    });
+    describe("filterByScope", () => {
+        const testPaths = [
+            "/root/p/P-ecommerce/e/E-users/E-users.md",
+            "/root/p/P-ecommerce/e/E-products/E-products.md",
+            "/root/p/P-mobile/e/E-sync/E-sync.md",
+            "/root/f/F-standalone/F-standalone.md",
+            "/root/t/open/T-standalone-task.md",
+        ];
+        it("should return all paths when no scope is provided", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths);
+            expect(result).toEqual(testPaths);
+            expect(result).toHaveLength(5);
+        });
+        it("should return all paths when scope is undefined", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths, undefined);
+            expect(result).toEqual(testPaths);
+            expect(result).toHaveLength(5);
+        });
+        it("should filter by project scope", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths, "P-ecommerce");
+            expect(result).toHaveLength(2);
+            expect(result).toContain("/root/p/P-ecommerce/e/E-users/E-users.md");
+            expect(result).toContain("/root/p/P-ecommerce/e/E-products/E-products.md");
+            expect(result).not.toContain("/root/p/P-mobile/e/E-sync/E-sync.md");
+        });
+        it("should filter by epic scope", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths, "E-users");
+            expect(result).toHaveLength(1);
+            expect(result).toContain("/root/p/P-ecommerce/e/E-users/E-users.md");
+        });
+        it("should filter by feature scope", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths, "F-standalone");
+            expect(result).toHaveLength(1);
+            expect(result).toContain("/root/f/F-standalone/F-standalone.md");
+        });
+        it("should return empty array for non-existent scope", () => {
+            const result = (0, filterByScope_1.filterByScope)(testPaths, "P-non-existent");
+            expect(result).toEqual([]);
+        });
+        it("should handle empty file paths array", () => {
+            const result = (0, filterByScope_1.filterByScope)([], "P-test");
+            expect(result).toEqual([]);
+        });
+        it("should preserve order of matching files", () => {
+            const orderedPaths = [
+                "/root/p/P-test/a.md",
+                "/root/p/P-test/b.md",
+                "/root/p/P-test/c.md",
+            ];
+            const result = (0, filterByScope_1.filterByScope)(orderedPaths, "P-test");
+            expect(result).toEqual(orderedPaths);
+        });
+    });
+});
+//# sourceMappingURL=scopeFilter.test.js.map

package/dist/repositories/local/__tests__/scopeFilter.test.js.map

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

package/dist/repositories/local/deleteObjectById.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deletes a TrellisObject by its ID, including both the markdown file and associated folder
+ *
+ * By default, the function checks if the object is required by other objects (as a prerequisite)
+ * and throws an error if it is. This safety check can be bypassed using the force parameter.
+ *
+ * @param id The ID of the object to delete
+ * @param planningRoot The root directory to search for markdown files
+ * @param force Optional. If true, bypasses dependency checks and deletes the object even if required by others. Defaults to false.
+ * @returns Promise resolving when the object is successfully deleted
+ * @throws Error if no object with the given ID is found
+ * @throws Error if object is required by other objects and force is false
+ * @throws Error if deletion fails due to file system issues
+ */
+export declare function deleteObjectById(id: string, planningRoot: string, force?: boolean): Promise<void>;
+//# sourceMappingURL=deleteObjectById.d.ts.map

package/dist/repositories/local/deleteObjectById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteObjectById.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/deleteObjectById.ts"],"names":[],"mappings":"AAkFA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/repositories/local/deleteObjectById.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deleteObjectById = deleteObjectById;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const utils_1 = require("../../utils");
+const findMarkdownFiles_1 = require("./findMarkdownFiles");
+async function findObjectById(id, planningRoot) {
+    const markdownFiles = await (0, findMarkdownFiles_1.findMarkdownFiles)(planningRoot);
+    for (const filePath of markdownFiles) {
+        try {
+            const fileContent = await (0, promises_1.readFile)(filePath, "utf-8");
+            const trellisObject = (0, utils_1.deserializeTrellisObject)(fileContent);
+            if (trellisObject.id === id) {
+                return { filePath, object: trellisObject };
+            }
+        }
+        catch (error) {
+            console.warn(`Warning: Could not deserialize file ${filePath}:`, error);
+            continue;
+        }
+    }
+    throw new Error(`No object found with ID: ${id}`);
+}
+async function checkObjectDependencies(targetObject, planningRoot) {
+    const { LocalRepository } = await Promise.resolve().then(() => __importStar(require("./LocalRepository")));
+    const config = {
+        mode: "local",
+        planningRootFolder: planningRoot,
+    };
+    const repository = new LocalRepository(config);
+    const isRequired = await (0, utils_1.isRequiredForOtherObjects)(targetObject, repository);
+    if (isRequired) {
+        throw new Error(`Cannot delete object ${targetObject.id} because it is required by other objects. Use force=true to override.`);
+    }
+}
+async function deleteObjectFile(filePath) {
+    await (0, promises_1.unlink)(filePath);
+}
+async function deleteAssociatedFolder(id, filePath) {
+    if (!id.startsWith("P-") && !id.startsWith("E-") && !id.startsWith("F-")) {
+        return;
+    }
+    const associatedFolderPath = (0, path_1.dirname)(filePath);
+    try {
+        await (0, promises_1.rm)(associatedFolderPath, { recursive: true, force: true });
+    }
+    catch (error) {
+        console.warn(`Warning: Could not delete associated folder ${associatedFolderPath}:`, error);
+    }
+}
+/**
+ * Deletes a TrellisObject by its ID, including both the markdown file and associated folder
+ *
+ * By default, the function checks if the object is required by other objects (as a prerequisite)
+ * and throws an error if it is. This safety check can be bypassed using the force parameter.
+ *
+ * @param id The ID of the object to delete
+ * @param planningRoot The root directory to search for markdown files
+ * @param force Optional. If true, bypasses dependency checks and deletes the object even if required by others. Defaults to false.
+ * @returns Promise resolving when the object is successfully deleted
+ * @throws Error if no object with the given ID is found
+ * @throws Error if object is required by other objects and force is false
+ * @throws Error if deletion fails due to file system issues
+ */
+async function deleteObjectById(id, planningRoot, force) {
+    const foundObject = await findObjectById(id, planningRoot);
+    const { filePath, object } = foundObject;
+    if (!force) {
+        await checkObjectDependencies(object, planningRoot);
+    }
+    await deleteObjectFile(filePath);
+    await deleteAssociatedFolder(id, filePath);
+}
+//# sourceMappingURL=deleteObjectById.js.map

package/dist/repositories/local/deleteObjectById.js.map

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

package/dist/repositories/local/extractMarkdownIds.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Extracts IDs from markdown file paths based on the Trellis naming convention
+ *
+ * In Trellis, all markdown files represent objects with IDs that match their filename (without .md).
+ * This works for all object types:
+ * - Projects: .trellis/p/P-project-name/P-project-name.md -> P-project-name
+ * - Epics: .trellis/p/P-project/e/E-epic-name/E-epic-name.md -> E-epic-name
+ * - Features: .trellis/p/P-project/e/E-epic/f/F-feature-name/F-feature-name.md -> F-feature-name
+ * - Hierarchical tasks: .trellis/p/P-project/e/E-epic/f/F-feature/t/open/T-task-name.md -> T-task-name
+ * - Standalone tasks: .trellis/t/open/T-task-name.md -> T-task-name
+ * - Feature tasks: .trellis/f/F-feature/t/open/T-task-name.md -> T-task-name
+ *
+ * @param filePaths Array of file paths from findMarkdownFiles
+ * @returns Array of extracted IDs (sorted alphabetically)
+ */
+export declare function extractMarkdownIds(filePaths: string[]): string[];
+//# sourceMappingURL=extractMarkdownIds.d.ts.map

package/dist/repositories/local/extractMarkdownIds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractMarkdownIds.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/extractMarkdownIds.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAiBhE"}

package/dist/repositories/local/extractMarkdownIds.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMarkdownIds = extractMarkdownIds;
+const path_1 = require("path");
+/**
+ * Extracts IDs from markdown file paths based on the Trellis naming convention
+ *
+ * In Trellis, all markdown files represent objects with IDs that match their filename (without .md).
+ * This works for all object types:
+ * - Projects: .trellis/p/P-project-name/P-project-name.md -> P-project-name
+ * - Epics: .trellis/p/P-project/e/E-epic-name/E-epic-name.md -> E-epic-name
+ * - Features: .trellis/p/P-project/e/E-epic/f/F-feature-name/F-feature-name.md -> F-feature-name
+ * - Hierarchical tasks: .trellis/p/P-project/e/E-epic/f/F-feature/t/open/T-task-name.md -> T-task-name
+ * - Standalone tasks: .trellis/t/open/T-task-name.md -> T-task-name
+ * - Feature tasks: .trellis/f/F-feature/t/open/T-task-name.md -> T-task-name
+ *
+ * @param filePaths Array of file paths from findMarkdownFiles
+ * @returns Array of extracted IDs (sorted alphabetically)
+ */
+function extractMarkdownIds(filePaths) {
+    const ids = [];
+    for (const filePath of filePaths) {
+        // Normalize path separators to forward slashes for consistent handling
+        const normalizedPath = filePath.replace(/\\/g, "/");
+        // Extract the filename without .md extension as the ID
+        const fileName = (0, path_1.basename)(normalizedPath, ".md");
+        // Only include files that follow the Trellis naming convention (P-, E-, F-, T- prefixes)
+        if (/^[PEFT]-/.test(fileName)) {
+            ids.push(fileName);
+        }
+    }
+    return ids.sort();
+}
+//# sourceMappingURL=extractMarkdownIds.js.map

package/dist/repositories/local/extractMarkdownIds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractMarkdownIds.js","sourceRoot":"","sources":["../../../src/repositories/local/extractMarkdownIds.ts"],"names":[],"mappings":";;AAiBA,gDAiBC;AAlCD,+BAAgC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,SAAmB;IACpD,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,uEAAuE;QACvE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAEpD,uDAAuD;QACvD,MAAM,QAAQ,GAAG,IAAA,eAAQ,EAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QAEjD,yFAAyF;QACzF,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/repositories/local/filterByScope.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Filters an array of file paths to only include those within the specified scope
+ * @param filePaths Array of file paths to filter
+ * @param scope Optional scope ID to filter by (e.g., "P-project-id", "E-epic-id", "F-feature-id")
+ * @returns Filtered array of file paths that match the scope
+ */
+export declare function filterByScope(filePaths: string[], scope?: string): string[];
+//# sourceMappingURL=filterByScope.d.ts.map

package/dist/repositories/local/filterByScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterByScope.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/filterByScope.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAM3E"}

package/dist/repositories/local/filterByScope.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterByScope = filterByScope;
+const scopeFilter_1 = require("./scopeFilter");
+/**
+ * Filters an array of file paths to only include those within the specified scope
+ * @param filePaths Array of file paths to filter
+ * @param scope Optional scope ID to filter by (e.g., "P-project-id", "E-epic-id", "F-feature-id")
+ * @returns Filtered array of file paths that match the scope
+ */
+function filterByScope(filePaths, scope) {
+    if (!scope) {
+        return filePaths;
+    }
+    return filePaths.filter((filePath) => (0, scopeFilter_1.matchesScope)(filePath, scope));
+}
+//# sourceMappingURL=filterByScope.js.map

package/dist/repositories/local/filterByScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterByScope.js","sourceRoot":"","sources":["../../../src/repositories/local/filterByScope.ts"],"names":[],"mappings":";;AASA,sCAMC;AAfD,+CAA6C;AAE7C;;;;;GAKG;AAEH,SAAgB,aAAa,CAAC,SAAmB,EAAE,KAAc;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,0BAAY,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/repositories/local/findMarkdownFiles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Recursively finds all markdown files in a directory and its subdirectories
+ * @param folderPath The root folder path to search
+ * @param includeClosed Optional flag to include files in closed task folders (paths containing "/t/closed"), defaults to true
+ * @param scope Optional scope ID to filter results to children of that scope object (e.g., "P-project-id", "E-epic-id", "F-feature-id")
+ * @returns Promise resolving to an array of full paths to markdown files
+ */
+export declare function findMarkdownFiles(folderPath: string, includeClosed?: boolean, scope?: string): Promise<string[]>;
+//# sourceMappingURL=findMarkdownFiles.d.ts.map

package/dist/repositories/local/findMarkdownFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findMarkdownFiles.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/findMarkdownFiles.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,OAAO,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB"}

package/dist/repositories/local/findMarkdownFiles.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMarkdownFiles = findMarkdownFiles;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const scopeFilter_1 = require("./scopeFilter");
+/**
+ * Recursively finds all markdown files in a directory and its subdirectories
+ * @param folderPath The root folder path to search
+ * @param includeClosed Optional flag to include files in closed task folders (paths containing "/t/closed"), defaults to true
+ * @param scope Optional scope ID to filter results to children of that scope object (e.g., "P-project-id", "E-epic-id", "F-feature-id")
+ * @returns Promise resolving to an array of full paths to markdown files
+ */
+async function findMarkdownFiles(folderPath, includeClosed, scope) {
+    const markdownFiles = [];
+    async function scanDirectory(currentPath) {
+        try {
+            const entries = await (0, promises_1.readdir)(currentPath);
+            for (const entry of entries) {
+                const fullPath = (0, path_1.join)(currentPath, entry);
+                const stats = await (0, promises_1.stat)(fullPath);
+                if (stats.isDirectory()) {
+                    await scanDirectory(fullPath);
+                }
+                else if (stats.isFile() && entry.toLowerCase().endsWith(".md")) {
+                    // If includeClosed is false, skip files in closed task folders
+                    if (includeClosed === false && fullPath.includes("/t/closed")) {
+                        return;
+                    }
+                    // If scope is provided, filter files to only include those within the scope
+                    if (scope && !(0, scopeFilter_1.matchesScope)(fullPath, scope)) {
+                        // console.log(`Skipping file ${fullPath} not in scope ${scope}`);
+                        continue;
+                    }
+                    markdownFiles.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            // Skip directories that can't be read (permissions, etc.)
+            console.warn(`Warning: Could not read directory ${currentPath}:`, error);
+        }
+    }
+    await scanDirectory(folderPath);
+    return markdownFiles.sort();
+}
+//# sourceMappingURL=findMarkdownFiles.js.map

package/dist/repositories/local/findMarkdownFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findMarkdownFiles.js","sourceRoot":"","sources":["../../../src/repositories/local/findMarkdownFiles.ts"],"names":[],"mappings":";;AAWA,8CAwCC;AAnDD,0CAA4C;AAC5C,+BAA4B;AAC5B,+CAA6C;AAE7C;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,aAAuB,EACvB,KAAc;IAEd,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,UAAU,aAAa,CAAC,WAAmB;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,WAAW,CAAC,CAAC;YAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,QAAQ,CAAC,CAAC;gBAEnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAChC,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjE,+DAA+D;oBAC/D,IAAI,aAAa,KAAK,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC9D,OAAO;oBACT,CAAC;oBAED,4EAA4E;oBAC5E,IAAI,KAAK,IAAI,CAAC,IAAA,0BAAY,EAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;wBAC5C,kEAAkE;wBAClE,SAAS;oBACX,CAAC;oBAED,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0DAA0D;YAC1D,OAAO,CAAC,IAAI,CAAC,qCAAqC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAChC,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC"}

package/dist/repositories/local/getObjectByFilePath.d.ts

@@ -0,0 +1,9 @@
+import { TrellisObject } from "../../models";
+/**
+ * Gets a TrellisObject by reading and deserializing a specific markdown file
+ * @param filePath The full path to the markdown file to read
+ * @returns Promise resolving to the TrellisObject from the file
+ * @throws Error if file reading fails or deserialization fails
+ */
+export declare function getObjectByFilePath(filePath: string): Promise<TrellisObject>;
+//# sourceMappingURL=getObjectByFilePath.d.ts.map

package/dist/repositories/local/getObjectByFilePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectByFilePath.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/getObjectByFilePath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAGxB"}

package/dist/repositories/local/getObjectByFilePath.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObjectByFilePath = getObjectByFilePath;
+const promises_1 = require("fs/promises");
+const deserializeTrellisObject_1 = require("../../utils/deserializeTrellisObject");
+/**
+ * Gets a TrellisObject by reading and deserializing a specific markdown file
+ * @param filePath The full path to the markdown file to read
+ * @returns Promise resolving to the TrellisObject from the file
+ * @throws Error if file reading fails or deserialization fails
+ */
+async function getObjectByFilePath(filePath) {
+    const fileContent = await (0, promises_1.readFile)(filePath, "utf-8");
+    return (0, deserializeTrellisObject_1.deserializeTrellisObject)(fileContent);
+}
+//# sourceMappingURL=getObjectByFilePath.js.map

package/dist/repositories/local/getObjectByFilePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectByFilePath.js","sourceRoot":"","sources":["../../../src/repositories/local/getObjectByFilePath.ts"],"names":[],"mappings":";;AAUA,kDAKC;AAfD,0CAAuC;AAEvC,mFAAgF;AAEhF;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB,CACvC,QAAgB;IAEhB,MAAM,WAAW,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,IAAA,mDAAwB,EAAC,WAAW,CAAC,CAAC;AAC/C,CAAC"}

package/dist/repositories/local/getObjectById.d.ts

@@ -0,0 +1,10 @@
+import { TrellisObject } from "../../models";
+/**
+ * Gets a TrellisObject by its ID by searching through markdown files
+ * @param id The ID of the object to find
+ * @param planningRoot The root directory to search for markdown files
+ * @returns Promise resolving to the TrellisObject with the matching ID, or null if not found
+ * @throws Error if file reading fails
+ */
+export declare function getObjectById(id: string, planningRoot: string): Promise<TrellisObject | null>;
+//# sourceMappingURL=getObjectById.d.ts.map

package/dist/repositories/local/getObjectById.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectById.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/getObjectById.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAuB/B"}

package/dist/repositories/local/getObjectById.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObjectById = getObjectById;
+const promises_1 = require("fs/promises");
+const deserializeTrellisObject_1 = require("../../utils/deserializeTrellisObject");
+const findMarkdownFiles_1 = require("./findMarkdownFiles");
+/**
+ * Gets a TrellisObject by its ID by searching through markdown files
+ * @param id The ID of the object to find
+ * @param planningRoot The root directory to search for markdown files
+ * @returns Promise resolving to the TrellisObject with the matching ID, or null if not found
+ * @throws Error if file reading fails
+ */
+async function getObjectById(id, planningRoot) {
+    // Find all markdown files in the planning root
+    const markdownFiles = await (0, findMarkdownFiles_1.findMarkdownFiles)(planningRoot);
+    // Search through each markdown file to find the one with the matching ID
+    for (const filePath of markdownFiles) {
+        try {
+            const fileContent = await (0, promises_1.readFile)(filePath, "utf-8");
+            const trellisObject = (0, deserializeTrellisObject_1.deserializeTrellisObject)(fileContent);
+            // Check if this object has the ID we're looking for
+            if (trellisObject.id === id) {
+                return trellisObject;
+            }
+        }
+        catch (error) {
+            // Skip files that can't be deserialized (might not be valid Trellis objects)
+            console.warn(`Warning: Could not deserialize file ${filePath}:`, error);
+            continue;
+        }
+    }
+    // If we get here, no object with the given ID was found
+    return null;
+}
+//# sourceMappingURL=getObjectById.js.map

package/dist/repositories/local/getObjectById.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectById.js","sourceRoot":"","sources":["../../../src/repositories/local/getObjectById.ts"],"names":[],"mappings":";;AAYA,sCA0BC;AAtCD,0CAAuC;AAEvC,mFAAgF;AAChF,2DAAwD;AAExD;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,EAAU,EACV,YAAoB;IAEpB,+CAA+C;IAC/C,MAAM,aAAa,GAAG,MAAM,IAAA,qCAAiB,EAAC,YAAY,CAAC,CAAC;IAE5D,yEAAyE;IACzE,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAA,mBAAQ,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,aAAa,GAAG,IAAA,mDAAwB,EAAC,WAAW,CAAC,CAAC;YAE5D,oDAAoD;YACpD,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC5B,OAAO,aAAa,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6EAA6E;YAC7E,OAAO,CAAC,IAAI,CAAC,uCAAuC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/repositories/local/getObjectFilePath.d.ts

@@ -0,0 +1,7 @@
+import { TrellisObject } from "../../models/TrellisObject";
+/**
+ * Generates the file path for a Trellis object based on its type, hierarchy, and status.
+ * This function assumes the object is new and doesn't have an existing file.
+ */
+export declare function getObjectFilePath(trellisObject: TrellisObject, planningRoot: string): Promise<string>;
+//# sourceMappingURL=getObjectFilePath.d.ts.map

package/dist/repositories/local/getObjectFilePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getObjectFilePath.d.ts","sourceRoot":"","sources":["../../../src/repositories/local/getObjectFilePath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK3D;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAoDjB"}

package/dist/repositories/local/getObjectFilePath.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getObjectFilePath = getObjectFilePath;
+const path_1 = require("path");
+const TrellisObjectType_1 = require("../../models/TrellisObjectType");
+const TrellisObjectStatus_1 = require("../../models/TrellisObjectStatus");
+const getObjectById_1 = require("./getObjectById");
+/**
+ * Generates the file path for a Trellis object based on its type, hierarchy, and status.
+ * This function assumes the object is new and doesn't have an existing file.
+ */
+async function getObjectFilePath(trellisObject, planningRoot) {
+    const { id, type, parent } = trellisObject;
+    switch (type) {
+        case TrellisObjectType_1.TrellisObjectType.PROJECT:
+            return (0, path_1.join)(planningRoot, "p", id, `${id}.md`);
+        case TrellisObjectType_1.TrellisObjectType.EPIC:
+            if (!parent) {
+                throw new Error(`Epic ${id} must have a parent project`);
+            }
+            return (0, path_1.join)(planningRoot, "p", parent, "e", id, `${id}.md`);
+        case TrellisObjectType_1.TrellisObjectType.FEATURE: {
+            if (!parent) {
+                // Feature without parent - standalone feature
+                return (0, path_1.join)(planningRoot, "f", id, `${id}.md`);
+            }
+            // Feature with parent - need to determine if parent is epic or project
+            const parentObject = await (0, getObjectById_1.getObjectById)(parent, planningRoot);
+            if (!parentObject) {
+                throw new Error(`Parent object with ID '${parent}' not found`);
+            }
+            if (parentObject.type === TrellisObjectType_1.TrellisObjectType.EPIC) {
+                // Feature under epic - need to get the project ID from the epic
+                if (!parentObject.parent) {
+                    throw new Error(`Epic ${parent} must have a parent project`);
+                }
+                return (0, path_1.join)(planningRoot, "p", parentObject.parent, "e", parent, "f", id, `${id}.md`);
+            }
+            else {
+                throw new Error(`Feature ${id} parent must be an epic`);
+            }
+        }
+        case TrellisObjectType_1.TrellisObjectType.TASK:
+            return await getTaskFilePath(trellisObject, planningRoot);
+        default:
+            throw new Error(`Unknown object type: ${String(type)}`);
+    }
+}
+/**
+ * Helper function to determine the file path for a task based on its parent hierarchy and status.
+ */
+async function getTaskFilePath(trellisObject, planningRoot) {
+    const { id, parent, status } = trellisObject;
+    // Determine if status is closed (done or wont-do)
+    const isClosed = status === TrellisObjectStatus_1.TrellisObjectStatus.DONE ||
+        status === TrellisObjectStatus_1.TrellisObjectStatus.WONT_DO;
+    const statusFolder = isClosed ? "closed" : "open";
+    if (!parent) {
+        // Task without parent - standalone task
+        return (0, path_1.join)(planningRoot, "t", statusFolder, `${id}.md`);
+    }
+    // Task with parent - need to determine parent type and hierarchy
+    const parentObject = await (0, getObjectById_1.getObjectById)(parent, planningRoot);
+    if (!parentObject) {
+        throw new Error(`Parent object with ID '${parent}' not found`);
+    }
+    if (parentObject.type === TrellisObjectType_1.TrellisObjectType.FEATURE) {
+        if (!parentObject.parent) {
+            // Feature doesn't have parent - task goes under standalone feature
+            return (0, path_1.join)(planningRoot, "f", parent, "t", statusFolder, `${id}.md`);
+        }
+        // Feature has parent (epic) - need to get full hierarchy
+        const epicObject = await (0, getObjectById_1.getObjectById)(parentObject.parent, planningRoot);
+        if (!epicObject) {
+            throw new Error(`Epic object with ID '${parentObject.parent}' not found`);
+        }
+        if (epicObject.type !== TrellisObjectType_1.TrellisObjectType.EPIC) {
+            throw new Error(`Feature parent ${parentObject.parent} must be an epic`);
+        }
+        if (!epicObject.parent) {
+            throw new Error(`Epic ${epicObject.id} must have a parent project`);
+        }
+        // Task under feature under epic under project
+        return (0, path_1.join)(planningRoot, "p", epicObject.parent, "e", epicObject.id, "f", parent, "t", statusFolder, `${id}.md`);
+    }
+    else {
+        throw new Error(`Task ${id} parent must be a feature`);
+    }
+}
+//# sourceMappingURL=getObjectFilePath.js.map

package/dist/repositories/local/getObjectFilePath.js.map

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