@langadventurellc/task-trellis-mcp 0.1.0-rc.3 → 1.0.0-rc.2

package/README.md

@@ -1,15 +1,69 @@
 # Task Trellis MCP
 
-An MCP (Model Context Protocol) server for Task Trellis, a task management application for AI coding agents.
+An MCP (Model Context Protocol) server for Task Trellis, a tool to help AI coding agents break down complex work into manageable tasks that allow it to work effectively. This server provides a structured task hierarchy and workflow management system, enabling AI agents to claim, complete, and manage tasks efficiently.
 
-## Hello World Tool
+## Available Tools
 
-This implementation includes a simple `hello_world` tool that demonstrates basic MCP functionality.
+This MCP server provides comprehensive task management functionality through the following tools:
 
-### Available Tools
+### Core Object Management
 
-- **hello_world**: Returns a greeting message
-  - Optional parameter: `name` (string) - Name to greet (defaults to "World")
+- **create_object**: Creates new objects (projects, epics, features, tasks) in the task hierarchy
+  - Supports parent-child relationships and prerequisites
+  - Validates hierarchy constraints (project → epic → feature → task)
+  - Parameters: type, title, parent (optional), priority, status, prerequisites, description
+
+- **update_object**: Updates existing objects with new properties
+  - Change status, priority, prerequisites, or content
+  - Validates status transitions and maintains object integrity
+  - Parameters: id, priority, status, prerequisites, body, force
+
+- **replace_object_body_regex**: Performs targeted regex-based replacements within object body content
+  - Enables surgical text edits without recreating entire body content
+  - Safer and more efficient than wholesale body replacement for specific modifications
+  - Parameters: id, regex, replacement, allowMultipleOccurrences (optional)
+
+- **get_object**: Retrieves detailed information about a specific object by ID
+  - Returns complete object data including metadata, relationships, and history
+  - Parameters: id
+
+- **delete_object**: Permanently removes objects from the system
+  - Validates relationships and prevents deletion of objects with dependencies
+  - Parameters: id, force
+
+- **list_objects**: Retrieves and filters objects based on various criteria
+  - Filter by type, status, priority, scope, or closed status
+  - Essential for discovering and managing work items
+  - Parameters: type, scope (optional), status (optional), priority (optional), includeClosed
+
+### Task Workflow Management
+
+- **claim_task**: Claims available tasks for execution by AI agents
+  - Automatically selects highest priority ready tasks
+  - Validates prerequisites and readiness criteria
+  - Parameters: scope (optional), taskId (optional), force
+
+- **complete_task**: Marks tasks as completed and records completion details
+  - Documents file changes and completion summary
+  - Updates task status and triggers dependent task progression
+  - Parameters: taskId, summary, filesChanged
+
+- **append_object_log**: Adds progress updates and notes to object activity logs
+  - Essential for tracking work history and documenting decisions
+  - Creates permanent audit trail for retrospectives and debugging
+  - Parameters: id, contents
+
+### System Management
+
+- **activate**: Initializes the task trellis system in local or remote mode
+  - Only needs to be run if the server wasn't started with command line arguments (`--projectRootFolder` for local mode or `--mode remote` for remote mode)
+  - Configures data storage and validates connectivity
+  - Parameters: mode, projectRoot (local), apiToken (remote), remoteProjectId (remote), url (optional)
+
+- **prune_closed**: Maintenance tool to remove old completed/cancelled objects
+  - Improves system performance and reduces clutter
+  - Validates relationships before deletion to maintain integrity
+  - Parameters: age, scope (optional)
 
 ### Usage
 

package/dist/__tests__/e2e/configuration/activation.e2e.test.d.ts

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

package/dist/__tests__/e2e/configuration/activation.e2e.test.d.ts.map

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

package/dist/__tests__/e2e/configuration/activation.e2e.test.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const utils_1 = require("../utils");
+const path_1 = __importDefault(require("path"));
+describe("E2E Configuration - Activation", () => {
+    let testEnv;
+    let client = null;
+    let transport = null;
+    beforeEach(() => {
+        testEnv = new utils_1.TestEnvironment();
+        testEnv.setup();
+    });
+    afterEach(async () => {
+        if (client) {
+            await client.close();
+            client = null;
+        }
+        if (transport) {
+            await transport.close();
+            transport = null;
+        }
+        testEnv?.cleanup();
+    });
+    async function connectWithoutProjectRoot() {
+        transport = new stdio_js_1.StdioClientTransport({
+            command: "node",
+            args: ["dist/server.js", "--mode", "local"], // No --projectRootFolder
+        });
+        client = new index_js_1.Client({ name: "test-client", version: "1.0.0" }, { capabilities: {} });
+        await client.connect(transport);
+    }
+    async function callTool(name, args = {}) {
+        if (!client) {
+            throw new Error("Client not connected");
+        }
+        return client.request({
+            method: "tools/call",
+            params: { name, arguments: args },
+        }, types_js_1.CallToolResultSchema);
+    }
+    describe("Local Mode Activation", () => {
+        it("should activate server with local mode and create .trellis directory", async () => {
+            await connectWithoutProjectRoot();
+            const response = await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            expect(response.content[0].type).toBe("text");
+            expect(response.content[0].text).toMatch(/Activated in local mode/);
+            expect(response.content[0].text).toContain(testEnv.projectRoot);
+            expect(response.content[0].text).toContain("planningRootFolder");
+            // Verify .trellis directory exists after creating an object
+            await callTool("create_object", {
+                type: "project",
+                title: "Test Project",
+            });
+            const trellisDir = path_1.default.join(testEnv.projectRoot, ".trellis");
+            expect(await (0, utils_1.pathExists)(trellisDir)).toBe(true);
+        });
+        it("should allow tool usage after activation", async () => {
+            await connectWithoutProjectRoot();
+            // Try to use tool before activation - should fail
+            const errorResponse = await callTool("list_objects", {});
+            expect(errorResponse.content[0].text).toContain("Planning root folder is not configured");
+            // Activate
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Should now work
+            const response = await callTool("list_objects", { type: "project" });
+            expect(response.content[0].text).not.toContain("not configured");
+        });
+        it("should handle multiple activations with different paths", async () => {
+            await connectWithoutProjectRoot();
+            // First activation
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create an object
+            await callTool("create_object", {
+                type: "project",
+                title: "Test Project",
+            });
+            // Second activation with different path
+            const newPath = path_1.default.join(testEnv.projectRoot, "subdir");
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: newPath,
+            });
+            // Objects from first activation should not be visible
+            const response = await callTool("list_objects", { type: "project" });
+            expect(response.content[0].text).toBe("[]");
+        });
+    });
+    describe("Remote Mode Activation", () => {
+        it("should activate server with remote mode parameters", async () => {
+            await connectWithoutProjectRoot();
+            const response = await callTool("activate", {
+                mode: "remote",
+                apiToken: "test-token",
+                url: "https://api.example.com",
+                remoteProjectId: "proj-123",
+            });
+            expect(response.content[0].text).toMatch(/Activated in remote mode/);
+            expect(response.content[0].text).toContain("test-token");
+            expect(response.content[0].text).toContain("https://api.example.com");
+            expect(response.content[0].text).toContain("proj-123");
+        });
+    });
+    describe("Parameter Validation", () => {
+        it("should handle local mode without projectRoot", async () => {
+            await connectWithoutProjectRoot();
+            const response = await callTool("activate", {
+                mode: "local",
+            });
+            // Should succeed but planningRootFolder will be undefined
+            expect(response.content[0].text).toContain("Activated in local mode");
+            expect(response.content[0].text).not.toContain("planningRootFolder");
+        });
+    });
+});
+//# sourceMappingURL=activation.e2e.test.js.map

package/dist/__tests__/e2e/configuration/activation.e2e.test.js.map

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

package/dist/__tests__/e2e/configuration/commandLineArgs.e2e.test.d.ts

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

package/dist/__tests__/e2e/configuration/commandLineArgs.e2e.test.d.ts.map

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

package/dist/__tests__/e2e/configuration/commandLineArgs.e2e.test.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const utils_1 = require("../utils");
+const path_1 = __importDefault(require("path"));
+describe("E2E Configuration - Command Line Arguments", () => {
+    let testEnv;
+    let client = null;
+    let transport = null;
+    beforeEach(() => {
+        testEnv = new utils_1.TestEnvironment();
+        testEnv.setup();
+    });
+    afterEach(async () => {
+        if (client) {
+            await client.close();
+            client = null;
+        }
+        if (transport) {
+            await transport.close();
+            transport = null;
+        }
+        testEnv?.cleanup();
+    });
+    async function startServerWithArgs(args) {
+        transport = new stdio_js_1.StdioClientTransport({
+            command: "node",
+            args: ["dist/server.js", ...args],
+        });
+        client = new index_js_1.Client({ name: "test-client", version: "1.0.0" }, { capabilities: {} });
+        await client.connect(transport);
+    }
+    async function callTool(name, args = {}) {
+        if (!client) {
+            throw new Error("Client not connected");
+        }
+        return client.request({
+            method: "tools/call",
+            params: { name, arguments: args },
+        }, types_js_1.CallToolResultSchema);
+    }
+    it("should start server with --mode local", async () => {
+        await startServerWithArgs(["--mode", "local"]);
+        const toolsResponse = await client.request({ method: "tools/list" }, types_js_1.ListToolsResultSchema);
+        expect(toolsResponse).toBeDefined();
+        expect(Array.isArray(toolsResponse.tools)).toBe(true);
+    });
+    it("should start server with --projectRootFolder", async () => {
+        await startServerWithArgs([
+            "--mode",
+            "local",
+            "--projectRootFolder",
+            testEnv.projectRoot,
+        ]);
+        // Should be able to use tools without activation
+        const response = await callTool("list_objects", { type: "project" });
+        expect(response.content[0].text).not.toContain("not configured");
+    });
+    it("should default to local mode when --mode not specified", async () => {
+        await startServerWithArgs([]);
+        // Try to activate in local mode to verify default
+        const response = await callTool("activate", {
+            mode: "local",
+            projectRoot: testEnv.projectRoot,
+        });
+        expect(response.content[0].text).toContain("Activated in local mode");
+    });
+    it("should handle --mode remote", async () => {
+        await startServerWithArgs(["--mode", "remote"]);
+        const response = await callTool("activate", {
+            mode: "remote",
+            apiToken: "token",
+            remoteProjectId: "proj-1",
+        });
+        expect(response.content[0].text).toContain("Activated in remote mode");
+    });
+    it("should override CLI args with activate tool", async () => {
+        await startServerWithArgs([
+            "--mode",
+            "local",
+            "--projectRootFolder",
+            testEnv.projectRoot,
+        ]);
+        // Should work initially
+        let response = await callTool("list_objects", { type: "project" });
+        expect(response.content[0].text).not.toContain("not configured");
+        // Override with different path
+        const newPath = path_1.default.join(testEnv.projectRoot, "new");
+        await callTool("activate", {
+            mode: "local",
+            projectRoot: newPath,
+        });
+        // Should now use new path
+        response = await callTool("create_object", {
+            type: "project",
+            title: "Test",
+        });
+        expect(response).toBeDefined();
+    });
+    it("should preserve server configuration between tool calls", async () => {
+        await startServerWithArgs([
+            "--mode",
+            "local",
+            "--projectRootFolder",
+            testEnv.projectRoot,
+        ]);
+        // First tool call
+        await callTool("create_object", {
+            type: "project",
+            title: "Project 1",
+        });
+        // Second tool call should still work without re-activation
+        const response = await callTool("create_object", {
+            type: "project",
+            title: "Project 2",
+        });
+        expect(response.content[0].text).toContain("Created object");
+    });
+});
+//# sourceMappingURL=commandLineArgs.e2e.test.js.map

package/dist/__tests__/e2e/configuration/commandLineArgs.e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandLineArgs.e2e.test.js","sourceRoot":"","sources":["../../../../src/__tests__/e2e/configuration/commandLineArgs.e2e.test.ts"],"names":[],"mappings":";;;;;AAAA,wEAAmE;AACnE,wEAAiF;AACjF,iEAG4C;AAC5C,oCAA2C;AAC3C,gDAAwB;AAExB,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,IAAI,OAAwB,CAAC;IAC7B,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,SAAS,GAAgC,IAAI,CAAC;IAElD,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,uBAAe,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,KAAK,UAAU,mBAAmB,CAAC,IAAc;QAC/C,SAAS,GAAG,IAAI,+BAAoB,CAAC;YACnC,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,GAAG,IAAI,iBAAM,CACjB,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,EACzC,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;QAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAY,EAAE;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,MAAM,CAAC,OAAO,CACnB;YACE,MAAM,EAAE,YAAY;YACpB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SAClC,EACD,+BAAoB,CACrB,CAAC;IACJ,CAAC;IAED,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,mBAAmB,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAE/C,MAAM,aAAa,GAAG,MAAM,MAAO,CAAC,OAAO,CACzC,EAAE,MAAM,EAAE,YAAY,EAAE,EACxB,gCAAqB,CACtB,CAAC;QACF,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,mBAAmB,CAAC;YACxB,QAAQ;YACR,OAAO;YACP,qBAAqB;YACrB,OAAO,CAAC,WAAW;SACpB,CAAC,CAAC;QAEH,iDAAiD;QACjD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAE9B,kDAAkD;QAClD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE;YAC1C,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,mBAAmB,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEhD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE;YAC1C,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO;YACjB,eAAe,EAAE,QAAQ;SAC1B,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,mBAAmB,CAAC;YACxB,QAAQ;YACR,OAAO;YACP,qBAAqB;YACrB,OAAO,CAAC,WAAW;SACpB,CAAC,CAAC;QAEH,wBAAwB;QACxB,IAAI,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAEjE,+BAA+B;QAC/B,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,CAAC,UAAU,EAAE;YACzB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,OAAO;SACrB,CAAC,CAAC;QAEH,0BAA0B;QAC1B,QAAQ,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE;YACzC,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,mBAAmB,CAAC;YACxB,QAAQ;YACR,OAAO;YACP,qBAAqB;YACrB,OAAO,CAAC,WAAW;SACpB,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,QAAQ,CAAC,eAAe,EAAE;YAC9B,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QAEH,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE;YAC/C,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/e2e/configuration/directorySetup.e2e.test.d.ts

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

package/dist/__tests__/e2e/configuration/directorySetup.e2e.test.d.ts.map

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

package/dist/__tests__/e2e/configuration/directorySetup.e2e.test.js

@@ -0,0 +1,262 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const utils_1 = require("../utils");
+const promises_1 = require("fs/promises");
+const path_1 = __importDefault(require("path"));
+describe("E2E Configuration - Directory Setup", () => {
+    let testEnv;
+    let client = null;
+    let transport = null;
+    beforeEach(async () => {
+        testEnv = new utils_1.TestEnvironment();
+        testEnv.setup();
+        transport = new stdio_js_1.StdioClientTransport({
+            command: "node",
+            args: ["dist/server.js", "--mode", "local"],
+        });
+        client = new index_js_1.Client({ name: "test-client", version: "1.0.0" }, { capabilities: {} });
+        await client.connect(transport);
+    }, 30000);
+    afterEach(async () => {
+        if (client) {
+            await client.close();
+            client = null;
+        }
+        if (transport) {
+            await transport.close();
+            transport = null;
+        }
+        testEnv?.cleanup();
+    });
+    async function callTool(name, args = {}) {
+        if (!client) {
+            throw new Error("Client not connected");
+        }
+        return client.request({
+            method: "tools/call",
+            params: { name, arguments: args },
+        }, types_js_1.CallToolResultSchema);
+    }
+    describe(".trellis Directory Creation", () => {
+        it("should create .trellis directory on first object creation", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            const trellisPath = path_1.default.join(testEnv.projectRoot, ".trellis");
+            // Directory should not exist yet
+            expect(await (0, utils_1.pathExists)(trellisPath)).toBe(false);
+            // Create first object
+            await callTool("create_object", {
+                type: "project",
+                title: "Test Project",
+            });
+            // Now directory should exist
+            expect(await (0, utils_1.pathExists)(trellisPath)).toBe(true);
+            // Verify it's a directory
+            const stats = await (0, promises_1.stat)(trellisPath);
+            expect(stats.isDirectory()).toBe(true);
+        });
+        it("should create subdirectory structure for projects", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            await callTool("create_object", {
+                type: "project",
+                title: "Test Project",
+            });
+            const projectDir = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-test-project");
+            expect(await (0, utils_1.pathExists)(projectDir)).toBe(true);
+            const files = await (0, promises_1.readdir)(projectDir);
+            expect(files).toContain("P-test-project.md");
+        });
+        it("should create nested structure for epics", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create project first
+            await callTool("create_object", {
+                type: "project",
+                title: "Parent Project",
+            });
+            // Create epic
+            await callTool("create_object", {
+                type: "epic",
+                title: "Test Epic",
+                parent: "P-parent-project",
+            });
+            const epicDir = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-parent-project", "e", "E-test-epic");
+            expect(await (0, utils_1.pathExists)(epicDir)).toBe(true);
+        });
+        it("should create nested structure for features", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create hierarchy
+            await callTool("create_object", {
+                type: "project",
+                title: "Project",
+            });
+            await callTool("create_object", {
+                type: "epic",
+                title: "Epic",
+                parent: "P-project",
+            });
+            await callTool("create_object", {
+                type: "feature",
+                title: "Feature",
+                parent: "E-epic",
+            });
+            const featureDir = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-project", "e", "E-epic", "f", "F-feature");
+            expect(await (0, utils_1.pathExists)(featureDir)).toBe(true);
+        });
+        it("should create task structure within features", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create feature
+            await callTool("create_object", {
+                type: "feature",
+                title: "Feature",
+            });
+            // Create task
+            await callTool("create_object", {
+                type: "task",
+                title: "Open Task",
+                parent: "F-feature",
+                status: "open",
+            });
+            // Check task is in the correct location
+            const taskPath = path_1.default.join(testEnv.projectRoot, ".trellis", "f", "F-feature", "t");
+            expect(await (0, utils_1.pathExists)(taskPath)).toBe(true);
+            // Check task is created in status subdirectory
+            const files = await (0, promises_1.readdir)(taskPath);
+            expect(files).toContain("open");
+            // Check task file exists in the open subdirectory
+            const openTaskFiles = await (0, promises_1.readdir)(path_1.default.join(taskPath, "open"));
+            expect(openTaskFiles.some((f) => f.includes("open-task") || f.startsWith("T-"))).toBe(true);
+        });
+        it("should handle standalone tasks", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create standalone task
+            await callTool("create_object", {
+                type: "task",
+                title: "Standalone Task",
+                status: "open",
+            });
+            // Check task is in standalone location
+            const taskPath = path_1.default.join(testEnv.projectRoot, ".trellis", "t");
+            expect(await (0, utils_1.pathExists)(taskPath)).toBe(true);
+            const files = await (0, promises_1.readdir)(taskPath);
+            expect(files).toContain("open");
+            // Check task file exists in the open subdirectory
+            const openTaskFiles = await (0, promises_1.readdir)(path_1.default.join(taskPath, "open"));
+            expect(openTaskFiles.some((f) => f.includes("standalone-task") || f.startsWith("T-"))).toBe(true);
+        });
+    });
+    describe("Directory Permissions", () => {
+        it("should create directories with proper permissions", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            await callTool("create_object", {
+                type: "project",
+                title: "Test",
+            });
+            const trellisPath = path_1.default.join(testEnv.projectRoot, ".trellis");
+            const stats = await (0, promises_1.stat)(trellisPath);
+            // Check directory is readable and writable
+            expect(stats.mode & 0o400).toBeTruthy(); // Readable
+            expect(stats.mode & 0o200).toBeTruthy(); // Writable
+        });
+    });
+    describe("Existing Files Handling", () => {
+        it("should handle existing .trellis directory", async () => {
+            const trellisPath = path_1.default.join(testEnv.projectRoot, ".trellis");
+            await (0, promises_1.mkdir)(trellisPath, { recursive: true });
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Should work with existing directory
+            await callTool("create_object", {
+                type: "project",
+                title: "Test",
+            });
+            expect(await (0, utils_1.pathExists)(path_1.default.join(trellisPath, "p", "P-test"))).toBe(true);
+        });
+        it("should handle existing subdirectories and files", async () => {
+            const projectPath = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-existing");
+            await (0, promises_1.mkdir)(projectPath, { recursive: true });
+            await (0, promises_1.writeFile)(path_1.default.join(projectPath, "P-existing.md"), "---\nkind: project\nid: P-existing\ntitle: Existing\nstatus: open\npriority: normal\ncreated: 2025-01-01T00:00:00.000Z\nupdated: 2025-01-01T00:00:00.000Z\nschema_version: 1.1\n---\nExisting project\n");
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Should be able to read existing objects
+            const response = await callTool("get_object", {
+                id: "P-existing",
+            });
+            expect(response.content[0].text).toContain("P-existing");
+            // And create new ones
+            await callTool("create_object", {
+                type: "project",
+                title: "New",
+            });
+            const newProjectPath = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-new");
+            expect(await (0, utils_1.pathExists)(newProjectPath)).toBe(true);
+        });
+    });
+    describe("Complex Hierarchy Creation", () => {
+        it("should create full project hierarchy structure", async () => {
+            await callTool("activate", {
+                mode: "local",
+                projectRoot: testEnv.projectRoot,
+            });
+            // Create complete hierarchy
+            await callTool("create_object", {
+                type: "project",
+                title: "Full Project",
+            });
+            await callTool("create_object", {
+                type: "epic",
+                title: "Epic One",
+                parent: "P-full-project",
+            });
+            await callTool("create_object", {
+                type: "feature",
+                title: "Feature Alpha",
+                parent: "E-epic-one",
+            });
+            await callTool("create_object", {
+                type: "task",
+                title: "Task Beta",
+                parent: "F-feature-alpha",
+            });
+            // Verify complete path exists
+            const fullPath = path_1.default.join(testEnv.projectRoot, ".trellis", "p", "P-full-project", "e", "E-epic-one", "f", "F-feature-alpha", "t");
+            expect(await (0, utils_1.pathExists)(fullPath)).toBe(true);
+            // Verify task directory structure exists
+            const files = await (0, promises_1.readdir)(fullPath);
+            expect(files).toContain("open");
+            // Check task file exists in the open subdirectory
+            const openTaskFiles = await (0, promises_1.readdir)(path_1.default.join(fullPath, "open"));
+            expect(openTaskFiles.some((f) => f.includes("task-beta") || f.startsWith("T-"))).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=directorySetup.e2e.test.js.map