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

package/dist/tools/appendObjectLogTool.js

@@ -4,7 +4,33 @@ exports.appendObjectLogTool = void 0;
 exports.handleAppendObjectLog = handleAppendObjectLog;
 exports.appendObjectLogTool = {
     name: "append_object_log",
-    description: "Appends content to an object's log in the task trellis system",
+    description: `Appends content to an object's log in the task trellis system
+
+Use this tool to add progress updates, notes, or activity records to an object's audit trail. Essential for tracking work history, documenting decisions, and maintaining transparency in task execution.
+
+Log entry purposes:
+- Record progress milestones and status changes
+- Document challenges encountered and solutions applied
+- Note important decisions or changes in approach
+- Track time spent or resources used
+- Log external dependencies or blockers
+- Record completion details and outcomes
+
+Log content guidelines:
+- Use clear, descriptive entries with context
+- Include timestamps (automatically added by system)
+- Reference specific files, commits, or external resources when relevant
+- Note any changes to scope, requirements, or approach
+- Document lessons learned or insights gained
+
+Activity tracking patterns:
+- Starting work: "Started implementation of feature X"
+- Progress updates: "Completed database schema changes, moving to API layer"
+- Blocking issues: "Blocked on external API access, contacted team"
+- Problem resolution: "Resolved memory leak by optimizing data structure"
+- Completion: "Task completed, all tests passing, PR submitted"
+
+The log creates a permanent audit trail that helps with project retrospectives, debugging issues, and understanding work evolution over time.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/appendObjectLogTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"appendObjectLogTool.js","sourceRoot":"","sources":["../../src/tools/appendObjectLogTool.ts"],"names":[],"mappings":";;;AAqBA,sDAsDC;AAzEY,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,+DAA+D;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;KAC7B;CACO,CAAC;AAEJ,KAAK,UAAU,qBAAqB,CACzC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,IAGxB,CAAC;IAEF,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0BAA0B,EAAE,aAAa;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,MAAM,aAAa,GAAG;YACpB,GAAG,cAAc;YACjB,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC;SACvC,CAAC;QAEF,0BAA0B;QAC1B,MAAM,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAE3C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wCAAwC,IAAI,CAAC,SAAS,CAC1D,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAC3D,IAAI,EACJ,CAAC,CACF,EAAE;iBACJ;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACjG;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"appendObjectLogTool.js","sourceRoot":"","sources":["../../src/tools/appendObjectLogTool.ts"],"names":[],"mappings":";;;AA+CA,sDAsDC;AAnGY,QAAA,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;8IA0B+H;IAC5I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;KAC7B;CACO,CAAC;AAEJ,KAAK,UAAU,qBAAqB,CACzC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,IAGxB,CAAC;IAEF,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,cAAc,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,0BAA0B,EAAE,aAAa;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,MAAM,aAAa,GAAG;YACpB,GAAG,cAAc;YACjB,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC;SACvC,CAAC;QAEF,0BAA0B;QAC1B,MAAM,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAE3C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wCAAwC,IAAI,CAAC,SAAS,CAC1D,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAC3D,IAAI,EACJ,CAAC,CACF,EAAE;iBACJ;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACjG;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/claimTaskTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const claimTaskTool: {
     readonly name: "claim_task";
-    readonly description: "Claims a task in the task trellis system";
+    readonly description: "Claims a task in the task trellis system\n\nUse this tool to assign yourself to available tasks for execution. Essential for AI agents to pick up work items from the task queue and begin execution.\n\nClaiming behavior:\n- Without 'taskId': Claims the next available task based on priority and readiness\n- With 'taskId': Claims a specific task by ID if available and ready\n- 'scope': Limits claiming to tasks within a specific project or area\n- 'force': Overrides normal claiming restrictions (use with caution)\n\nTask readiness criteria:\n- Task status allows claiming (typically 'draft' or 'open' states)\n- All prerequisites are satisfied (prerequisite tasks completed)\n- Task is not already claimed by another agent\n- Task falls within specified scope if provided\n\nClaiming workflow:\n1. System evaluates available tasks against readiness criteria\n2. Selects highest priority task that meets requirements\n3. Updates task status to 'in-progress\n4. Associates task with the claiming agent\n5. Returns claimed task details for execution\n\nCommon patterns:\n- Claim any ready task: (no parameters)\n- Claim from project: scope='P-project-name'\n- Claim specific task: taskId='T-specific-task-id'\n- Force claim blocked task: taskId='T-task-id', force=true\n\nEssential for autonomous task execution workflows where agents need to discover and claim work items dynamically.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/claimTaskTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claimTaskTool.d.ts","sourceRoot":"","sources":["../../src/tools/claimTaskTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAEX,wBAAsB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAwC1E"}
+{"version":3,"file":"claimTaskTool.d.ts","sourceRoot":"","sources":["../../src/tools/claimTaskTool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;CAkDhB,CAAC;AAEX,wBAAsB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAwC1E"}

package/dist/tools/claimTaskTool.js

@@ -2,14 +2,44 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.claimTaskTool = void 0;
 exports.handleClaimTask = handleClaimTask;
-const TrellisObjectType_1 = require("../models/TrellisObjectType");
+const models_1 = require("../models");
 const TrellisObjectStatus_1 = require("../models/TrellisObjectStatus");
+const TrellisObjectType_1 = require("../models/TrellisObjectType");
+const checkPrerequisitesComplete_1 = require("../utils/checkPrerequisitesComplete");
 const filterUnavailableObjects_1 = require("../utils/filterUnavailableObjects");
 const sortTrellisObjects_1 = require("../utils/sortTrellisObjects");
-const checkPrerequisitesComplete_1 = require("../utils/checkPrerequisitesComplete");
 exports.claimTaskTool = {
     name: "claim_task",
-    description: "Claims a task in the task trellis system",
+    description: `Claims a task in the task trellis system
+
+Use this tool to assign yourself to available tasks for execution. Essential for AI agents to pick up work items from the task queue and begin execution.
+
+Claiming behavior:
+- Without 'taskId': Claims the next available task based on priority and readiness
+- With 'taskId': Claims a specific task by ID if available and ready
+- 'scope': Limits claiming to tasks within a specific project or area
+- 'force': Overrides normal claiming restrictions (use with caution)
+
+Task readiness criteria:
+- Task status allows claiming (typically 'draft' or 'open' states)
+- All prerequisites are satisfied (prerequisite tasks completed)
+- Task is not already claimed by another agent
+- Task falls within specified scope if provided
+
+Claiming workflow:
+1. System evaluates available tasks against readiness criteria
+2. Selects highest priority task that meets requirements
+3. Updates task status to 'in-progress
+4. Associates task with the claiming agent
+5. Returns claimed task details for execution
+
+Common patterns:
+- Claim any ready task: (no parameters)
+- Claim from project: scope='P-project-name'
+- Claim specific task: taskId='T-specific-task-id'
+- Force claim blocked task: taskId='T-task-id', force=true
+
+Essential for autonomous task execution workflows where agents need to discover and claim work items dynamically.`,
     inputSchema: {
         type: "object",
         properties: {
@@ -67,8 +97,7 @@ async function validateTaskForClaiming(task, taskId, force, repository) {
     }
     if (!force) {
         // Validate status is draft or open
-        if (task.status !== TrellisObjectStatus_1.TrellisObjectStatus.DRAFT &&
-            task.status !== TrellisObjectStatus_1.TrellisObjectStatus.OPEN) {
+        if (!(0, models_1.isClaimable)(task)) {
             throw new Error(`Task "${taskId}" cannot be claimed (status: ${task.status}). Task must be in draft or open status.`);
         }
         // Validate all prerequisites are complete

package/dist/tools/claimTaskTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"claimTaskTool.js","sourceRoot":"","sources":["../../src/tools/claimTaskTool.ts"],"names":[],"mappings":";;;AA+BA,0CAwCC;AArED,mEAAgE;AAChE,uEAAoE;AACpE,gFAA6E;AAC7E,oEAAiE;AACjE,oFAAiF;AAEpE,QAAA,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0CAA0C;IACvD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sCAAsC;gBACnD,OAAO,EAAE,KAAK;aACf;SACF;KACF;CACO,CAAC;AAEJ,KAAK,UAAU,eAAe,CAAC,UAAsB,EAAE,IAAa;IACzE,MAAM,EACJ,KAAK,EACL,MAAM,EACN,KAAK,GAAG,KAAK,GACd,GAAG,IAIH,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,WAA0B,CAAC;QAE/B,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,MAAM,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAEpE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8BAA8B,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBAC3E;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACvF;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,IAAmB,EACnB,MAAc,EACd,KAAc,EACd,UAAsB;IAEtB,uBAAuB;IACvB,IAAI,IAAI,CAAC,IAAI,KAAK,qCAAiB,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,0BAA0B,IAAI,CAAC,IAAI,GAAG,CAChE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,mCAAmC;QACnC,IACE,IAAI,CAAC,MAAM,KAAK,yCAAmB,CAAC,KAAK;YACzC,IAAI,CAAC,MAAM,KAAK,yCAAmB,CAAC,IAAI,EACxC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,gCAAgC,IAAI,CAAC,MAAM,0CAA0C,CACrG,CAAC;QACJ,CAAC;QAED,0CAA0C;QAC1C,MAAM,qBAAqB,GAAG,MAAM,IAAA,uDAA0B,EAC5D,IAAI,EACJ,UAAU,CACX,CAAC;QACF,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,0DAA0D,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,KAAc,EACd,UAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,KAAyB,EACzB,UAAsB;IAEtB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,CACzC,KAAK,EAAE,gBAAgB;IACvB,KAAK,EACL,qCAAiB,CAAC,IAAI,CACvB,CAAC;IAEF,qCAAqC;IACrC,MAAM,cAAc,GAAG,IAAA,mDAAwB,EAAC,OAAO,CAAC,CAAC;IAEzD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,0CAA0C;IAC1C,MAAM,WAAW,GAAG,IAAA,uCAAkB,EAAC,cAAc,CAAC,CAAC;IACvD,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,IAAmB,EACnB,UAAsB;IAEtB,MAAM,WAAW,GAAG;QAClB,GAAG,IAAI;QACP,MAAM,EAAE,yCAAmB,CAAC,WAAW;KACxC,CAAC;IAEF,MAAM,UAAU,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"claimTaskTool.js","sourceRoot":"","sources":["../../src/tools/claimTaskTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/completeTaskTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const completeTaskTool: {
     readonly name: "complete_task";
-    readonly description: "Completes a task in the task trellis system";
+    readonly description: "Completes a task in the task trellis system\n\nUse this tool to mark a task as finished and record completion details. Critical for task lifecycle management and maintaining accurate project status.\n\nRequired completion data:\n- 'taskId': Unique identifier of the task being completed\n- 'summary': Concise description of what was accomplished\n- 'filesChanged': Map of modified files with descriptions of changes made\n\nCompletion process:\n1. Validates task is in a completable state ('in-progress')\n2. Updates task status to 'done'\n3. Records completion timestamp and summary\n4. Associates file changes with the task for traceability\n5. Updates parent-child relationships and dependency chains\n6. Triggers any dependent tasks that were waiting for this completion\n\nFile change tracking:\n- Key: relative file path from project root\n- Value: description of changes made to that file\n- Example: {'src/api/users.ts': 'Added user authentication endpoints', 'tests/auth.test.ts': 'Added comprehensive auth test coverage'}\n\nBest practices:\n- Provide clear, actionable summaries that explain the outcome\n- Document all meaningful file changes for future reference  \n- Complete tasks only when all acceptance criteria are met\n- Verify dependent tasks can now proceed before completion\n- Include any important notes or lessons learned in the summary\n\nTask completion automatically notifies dependent tasks and may trigger workflow progression for related work items.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/completeTaskTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completeTaskTool.d.ts","sourceRoot":"","sources":["../../src/tools/completeTaskTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;CAwBnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA2Cd"}
+{"version":3,"file":"completeTaskTool.d.ts","sourceRoot":"","sources":["../../src/tools/completeTaskTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;CAqDnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA2Cd"}

package/dist/tools/completeTaskTool.js

@@ -5,7 +5,36 @@ exports.handleCompleteTask = handleCompleteTask;
 const models_1 = require("../models");
 exports.completeTaskTool = {
     name: "complete_task",
-    description: "Completes a task in the task trellis system",
+    description: `Completes a task in the task trellis system
+
+Use this tool to mark a task as finished and record completion details. Critical for task lifecycle management and maintaining accurate project status.
+
+Required completion data:
+- 'taskId': Unique identifier of the task being completed
+- 'summary': Concise description of what was accomplished
+- 'filesChanged': Map of modified files with descriptions of changes made
+
+Completion process:
+1. Validates task is in a completable state ('in-progress')
+2. Updates task status to 'done'
+3. Records completion timestamp and summary
+4. Associates file changes with the task for traceability
+5. Updates parent-child relationships and dependency chains
+6. Triggers any dependent tasks that were waiting for this completion
+
+File change tracking:
+- Key: relative file path from project root
+- Value: description of changes made to that file
+- Example: {'src/api/users.ts': 'Added user authentication endpoints', 'tests/auth.test.ts': 'Added comprehensive auth test coverage'}
+
+Best practices:
+- Provide clear, actionable summaries that explain the outcome
+- Document all meaningful file changes for future reference  
+- Complete tasks only when all acceptance criteria are met
+- Verify dependent tasks can now proceed before completion
+- Include any important notes or lessons learned in the summary
+
+Task completion automatically notifies dependent tasks and may trigger workflow progression for related work items.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/completeTaskTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"completeTaskTool.js","sourceRoot":"","sources":["../../src/tools/completeTaskTool.ts"],"names":[],"mappings":";;;AA6BA,gDA6CC;AAzED,sCAAgD;AAEnC,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6CAA6C;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE;oBACpB,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC;KAChD;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAIzC,CAAC;IAEF,sCAAsC;IACtC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,4BAAmB,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,yCAAyC,IAAI,CAAC,MAAM,GAAG,CACvE,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,MAAM,GAAG,4BAAmB,CAAC,IAAI,CAAC;IAEvC,+BAA+B;IAC/B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE;QAC/D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvB,wBAAwB;IACxB,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,MAAM,qCAAqC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,kBAAkB;aAC7G;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"completeTaskTool.js","sourceRoot":"","sources":["../../src/tools/completeTaskTool.ts"],"names":[],"mappings":";;;AA0DA,gDA6CC;AAvGD,sCAAgD;AAGnC,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oHA6BqG;IAClH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE;oBACpB,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC;KAChD;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAIzC,CAAC;IAEF,sCAAsC;IACtC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,4BAAmB,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,yCAAyC,IAAI,CAAC,MAAM,GAAG,CACvE,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,MAAM,GAAG,4BAAmB,CAAC,IAAI,CAAC;IAEvC,+BAA+B;IAC/B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE;QAC/D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvB,wBAAwB;IACxB,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAElC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,SAAS,MAAM,qCAAqC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,kBAAkB;aAC7G;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/createObjectTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const createObjectTool: {
     readonly name: "create_object";
-    readonly description: "Creates a new object in the task trellis system";
+    readonly description: "Creates a new object in the task trellis system\n\nUse this tool to create new objects such as tasks, projects, or other work items within the task management hierarchy. Objects can have parent-child relationships and dependencies through prerequisites.\n\nAvailable object types and hierarchy requirements:\n- 'project': Top-level containers, cannot have a parent\n- 'epic': Must have a project as a parent\n- 'feature': Can have no parent or an epic as a parent\n- 'task': Can have no parent or a feature as a parent\n\nSupported hierarchy structures:\n- Full hierarchy: project → epic → feature → task\n- Simplified: feature → task  \n- Standalone: task\n\nAvailable status values:\n- 'draft': Initial state for new objects (default)\n- 'open': Ready to begin work\n- 'in-progress': Currently being worked on\n- 'done': Completed successfully\n- 'wont-do': Cancelled or decided against\n\nAvailable priority values:\n- 'high': Critical or urgent work\n- 'medium': Standard priority (default)\n- 'low': Nice-to-have or future work\n\nKey aspects:\n- Objects support hierarchical organization via parent relationships\n- Prerequisites define execution order dependencies between objects\n- Parent-child relationships must follow the hierarchy rules above\n- The system validates parent types during creation\n\nBest practices:\n- Use descriptive titles that clearly indicate the work to be done\n- Follow the hierarchy constraints for proper organization\n- Set appropriate status based on current work state\n- Define prerequisites to ensure proper task ordering\n- Include detailed descriptions to provide context for the work";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/createObjectTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/createObjectTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA0Dd"}
+{"version":3,"file":"createObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/createObjectTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA6Dd"}

package/dist/tools/createObjectTool.js

@@ -6,7 +6,45 @@ const utils_1 = require("../utils");
 const validateObjectCreation_js_1 = require("../validation/validateObjectCreation.js");
 exports.createObjectTool = {
     name: "create_object",
-    description: "Creates a new object in the task trellis system",
+    description: `Creates a new object in the task trellis system
+
+Use this tool to create new objects such as tasks, projects, or other work items within the task management hierarchy. Objects can have parent-child relationships and dependencies through prerequisites.
+
+Available object types and hierarchy requirements:
+- 'project': Top-level containers, cannot have a parent
+- 'epic': Must have a project as a parent
+- 'feature': Can have no parent or an epic as a parent
+- 'task': Can have no parent or a feature as a parent
+
+Supported hierarchy structures:
+- Full hierarchy: project → epic → feature → task
+- Simplified: feature → task  
+- Standalone: task
+
+Available status values:
+- 'draft': Initial state for new objects (default)
+- 'open': Ready to begin work
+- 'in-progress': Currently being worked on
+- 'done': Completed successfully
+- 'wont-do': Cancelled or decided against
+
+Available priority values:
+- 'high': Critical or urgent work
+- 'medium': Standard priority (default)
+- 'low': Nice-to-have or future work
+
+Key aspects:
+- Objects support hierarchical organization via parent relationships
+- Prerequisites define execution order dependencies between objects
+- Parent-child relationships must follow the hierarchy rules above
+- The system validates parent types during creation
+
+Best practices:
+- Use descriptive titles that clearly indicate the work to be done
+- Follow the hierarchy constraints for proper organization
+- Set appropriate status based on current work state
+- Define prerequisites to ensure proper task ordering
+- Include detailed descriptions to provide context for the work`,
     inputSchema: {
         type: "object",
         properties: {
@@ -56,7 +94,8 @@ async function handleCreateObject(repository, args) {
     // Generate unique ID
     const objectType = type;
     const id = (0, utils_1.generateUniqueId)(title, objectType, existingIds);
-    // Create TrellisObject
+    // Create TrellisObject with current timestamp
+    const now = new Date().toISOString();
     const trellisObject = {
         id,
         type: objectType,
@@ -69,6 +108,8 @@ async function handleCreateObject(repository, args) {
         log: [],
         schema: "v1.0",
         childrenIds: [],
+        created: now,
+        updated: now,
         body: description,
     };
     // Validate object before saving

package/dist/tools/createObjectTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"createObjectTool.js","sourceRoot":"","sources":["../../src/tools/createObjectTool.ts"],"names":[],"mappings":";;;AAwDA,gDA4DC;AA7GD,oCAA4C;AAC5C,uFAAiF;AAEpE,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,iDAAiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,QAAQ;aAClB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;gBACzD,OAAO,EAAE,OAAO;aACjB;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,4DAA4D;gBAC9D,OAAO,EAAE,EAAE;aACZ;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,GAAG,QAAQ,EACnB,MAAM,GAAG,OAAO,EAChB,aAAa,GAAG,EAAE,EAClB,WAAW,GAAG,EAAE,GACjB,GAAG,IAQH,CAAC;IAEF,6CAA6C;IAC7C,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEzD,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAyB,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAA,wBAAgB,EAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE5D,uBAAuB;IACvB,MAAM,aAAa,GAAkB;QACnC,EAAE;QACF,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,MAAM,EAAE,MAA6B;QACrC,QAAQ,EAAE,QAAiC;QAC3C,MAAM;QACN,aAAa;QACb,aAAa,EAAE,IAAI,GAAG,EAAE;QACxB,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,WAAW;KAClB,CAAC;IAEF,gCAAgC;IAChC,MAAM,IAAA,kDAAsB,EAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAExD,0BAA0B;IAC1B,MAAM,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,2BAA2B,EAAE,EAAE;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createObjectTool.js","sourceRoot":"","sources":["../../src/tools/createObjectTool.ts"],"names":[],"mappings":";;;AA8FA,gDA+DC;AAtJD,oCAA4C;AAC5C,uFAAiF;AAEpE,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAsCiD;IAC9D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0BAA0B;aACxC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,QAAQ;aAClB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;gBACzD,OAAO,EAAE,OAAO;aACjB;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;iBACf;gBACD,WAAW,EACT,4DAA4D;gBAC9D,OAAO,EAAE,EAAE;aACZ;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,GAAG,QAAQ,EACnB,MAAM,GAAG,OAAO,EAChB,aAAa,GAAG,EAAE,EAClB,WAAW,GAAG,EAAE,GACjB,GAAG,IAQH,CAAC;IAEF,6CAA6C;IAC7C,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEzD,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAyB,CAAC;IAC7C,MAAM,EAAE,GAAG,IAAA,wBAAgB,EAAC,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAE5D,8CAA8C;IAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,aAAa,GAAkB;QACnC,EAAE;QACF,IAAI,EAAE,UAAU;QAChB,KAAK;QACL,MAAM,EAAE,MAA6B;QACrC,QAAQ,EAAE,QAAiC;QAC3C,MAAM;QACN,aAAa;QACb,aAAa,EAAE,IAAI,GAAG,EAAE;QACxB,GAAG,EAAE,EAAE;QACP,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,GAAG;QACZ,IAAI,EAAE,WAAW;KAClB,CAAC;IAEF,gCAAgC;IAChC,MAAM,IAAA,kDAAsB,EAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAExD,0BAA0B;IAC1B,MAAM,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,2BAA2B,EAAE,EAAE;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/deleteObjectTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const deleteObjectTool: {
     readonly name: "delete_object";
-    readonly description: "Deletes an object from the task trellis system";
+    readonly description: "Deletes an object from the task trellis system\n\nUse this tool to permanently remove objects from the task hierarchy. Exercise caution as deletion affects related objects and cannot be easily undone.\n\nSafety considerations:\n- Standard deletion validates relationships and prevents deletion of objects with dependencies\n- Objects with children or that serve as prerequisites for other objects may be protected\n- Use 'force=true' to bypass safety checks for administrative cleanup\n- Consider updating status to 'cancelled' instead of deletion for audit trail preservation\n\nDeletion impacts:\n- Removes object and all associated metadata permanently\n- Updates parent-child relationships by removing deleted object from parent's children list\n- Other objects referencing this as a prerequisite may become invalid\n- Historical references in logs and activity trails are preserved but point to non-existent object\n\nBest practices:\n- Verify object has no active dependencies before deletion\n- Use list/get tools to understand relationships before deletion\n- Prefer status updates to 'cancelled' over deletion for important work items\n- Use force deletion only for cleanup of test data or administrative maintenance\n\nThis operation is irreversible - ensure you have the correct object ID before proceeding.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/deleteObjectTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/deleteObjectTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;CAkBnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA4Bd"}
+{"version":3,"file":"deleteObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/deleteObjectTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;CAwCnB,CAAC;AAEX,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,OAAO;;;;;GA4Bd"}

package/dist/tools/deleteObjectTool.js

@@ -4,7 +4,29 @@ exports.deleteObjectTool = void 0;
 exports.handleDeleteObject = handleDeleteObject;
 exports.deleteObjectTool = {
     name: "delete_object",
-    description: "Deletes an object from the task trellis system",
+    description: `Deletes an object from the task trellis system
+
+Use this tool to permanently remove objects from the task hierarchy. Exercise caution as deletion affects related objects and cannot be easily undone.
+
+Safety considerations:
+- Standard deletion validates relationships and prevents deletion of objects with dependencies
+- Objects with children or that serve as prerequisites for other objects may be protected
+- Use 'force=true' to bypass safety checks for administrative cleanup
+- Consider updating status to 'cancelled' instead of deletion for audit trail preservation
+
+Deletion impacts:
+- Removes object and all associated metadata permanently
+- Updates parent-child relationships by removing deleted object from parent's children list
+- Other objects referencing this as a prerequisite may become invalid
+- Historical references in logs and activity trails are preserved but point to non-existent object
+
+Best practices:
+- Verify object has no active dependencies before deletion
+- Use list/get tools to understand relationships before deletion
+- Prefer status updates to 'cancelled' over deletion for important work items
+- Use force deletion only for cleanup of test data or administrative maintenance
+
+This operation is irreversible - ensure you have the correct object ID before proceeding.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/deleteObjectTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"deleteObjectTool.js","sourceRoot":"","sources":["../../src/tools/deleteObjectTool.ts"],"names":[],"mappings":";;;AAsBA,gDA8BC;AAlDY,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gDAAgD;IAC7D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAG7B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC,EAAE,EAAE;iBAC3C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzG;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"deleteObjectTool.js","sourceRoot":"","sources":["../../src/tools/deleteObjectTool.ts"],"names":[],"mappings":";;;AA4CA,gDA8BC;AAxEY,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;0FAsB2E;IACxF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;CACO,CAAC;AAEJ,KAAK,UAAU,kBAAkB,CACtC,UAAsB,EACtB,IAAa;IAEb,MAAM,EAAE,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAG7B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAEzC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC,EAAE,EAAE;iBAC3C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACzG;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/getObjectTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const getObjectTool: {
     readonly name: "get_object";
-    readonly description: "Gets an object from the task trellis system";
+    readonly description: "Gets an object from the task trellis system\n\nUse this tool to retrieve detailed information about a specific object by its unique ID. Returns the complete object data including metadata, relationships, content, and activity history.\n\nKey information retrieved:\n- Object metadata (type, title, status, priority, timestamps)\n- Hierarchical relationships (parent, children, prerequisites)\n- Content body and description\n- Activity log and change history\n- File associations and modifications\n- Current state and progress indicators\n\nUsage scenarios:\n- Review task details before starting work\n- Check object status and dependencies\n- Examine change history and activity logs\n- Understand parent-child relationships\n- Verify prerequisite completion\n- Access associated file changes\n\nEssential for understanding the full context of a work item before making modifications or planning next steps.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/getObjectTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/getObjectTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAahB,CAAC;AAEX,wBAAsB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAqC1E"}
+{"version":3,"file":"getObjectTool.d.ts","sourceRoot":"","sources":["../../src/tools/getObjectTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAiChB,CAAC;AAEX,wBAAsB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAqC1E"}

package/dist/tools/getObjectTool.js

@@ -4,7 +4,27 @@ exports.getObjectTool = void 0;
 exports.handleGetObject = handleGetObject;
 exports.getObjectTool = {
     name: "get_object",
-    description: "Gets an object from the task trellis system",
+    description: `Gets an object from the task trellis system
+
+Use this tool to retrieve detailed information about a specific object by its unique ID. Returns the complete object data including metadata, relationships, content, and activity history.
+
+Key information retrieved:
+- Object metadata (type, title, status, priority, timestamps)
+- Hierarchical relationships (parent, children, prerequisites)
+- Content body and description
+- Activity log and change history
+- File associations and modifications
+- Current state and progress indicators
+
+Usage scenarios:
+- Review task details before starting work
+- Check object status and dependencies
+- Examine change history and activity logs
+- Understand parent-child relationships
+- Verify prerequisite completion
+- Access associated file changes
+
+Essential for understanding the full context of a work item before making modifications or planning next steps.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/getObjectTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"getObjectTool.js","sourceRoot":"","sources":["../../src/tools/getObjectTool.ts"],"names":[],"mappings":";;;AAiBA,0CAqCC;AApDY,QAAA,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6CAA6C;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;CACO,CAAC;AAEJ,KAAK,UAAU,eAAe,CAAC,UAAsB,EAAE,IAAa;IACzE,MAAM,EAAE,EAAE,EAAE,GAAG,IAEd,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,EAAE,aAAa;qBACzC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qBAAqB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBAC7D;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oCAAoC,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC3G;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"getObjectTool.js","sourceRoot":"","sources":["../../src/tools/getObjectTool.ts"],"names":[],"mappings":";;;AAqCA,0CAqCC;AAxEY,QAAA,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;gHAoBiG;IAC9G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;CACO,CAAC;AAEJ,KAAK,UAAU,eAAe,CAAC,UAAsB,EAAE,IAAa;IACzE,MAAM,EAAE,EAAE,EAAE,GAAG,IAEd,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,EAAE,aAAa;qBACzC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qBAAqB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBAC7D;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,oCAAoC,EAAE,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC3G;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -8,4 +8,5 @@ export { claimTaskTool, handleClaimTask } from "./claimTaskTool.js";
 export { completeTaskTool, handleCompleteTask } from "./completeTaskTool.js";
 export { pruneClosedTool, handlePruneClosed } from "./pruneClosedTool.js";
 export { activateTool, handleActivate } from "./activateTool.js";
+export { replaceObjectBodyRegexTool, handleReplaceObjectBodyRegex, } from "./replaceObjectBodyRegexTool.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,iCAAiC,CAAC"}

package/dist/tools/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleActivate = exports.activateTool = exports.handlePruneClosed = exports.pruneClosedTool = exports.handleCompleteTask = exports.completeTaskTool = exports.handleClaimTask = exports.claimTaskTool = exports.handleAppendObjectLog = exports.appendObjectLogTool = exports.handleListObjects = exports.listObjectsTool = exports.handleDeleteObject = exports.deleteObjectTool = exports.handleGetObject = exports.getObjectTool = exports.handleUpdateObject = exports.updateObjectTool = exports.handleCreateObject = exports.createObjectTool = void 0;
+exports.handleReplaceObjectBodyRegex = exports.replaceObjectBodyRegexTool = exports.handleActivate = exports.activateTool = exports.handlePruneClosed = exports.pruneClosedTool = exports.handleCompleteTask = exports.completeTaskTool = exports.handleClaimTask = exports.claimTaskTool = exports.handleAppendObjectLog = exports.appendObjectLogTool = exports.handleListObjects = exports.listObjectsTool = exports.handleDeleteObject = exports.deleteObjectTool = exports.handleGetObject = exports.getObjectTool = exports.handleUpdateObject = exports.updateObjectTool = exports.handleCreateObject = exports.createObjectTool = void 0;
 var createObjectTool_js_1 = require("./createObjectTool.js");
 Object.defineProperty(exports, "createObjectTool", { enumerable: true, get: function () { return createObjectTool_js_1.createObjectTool; } });
 Object.defineProperty(exports, "handleCreateObject", { enumerable: true, get: function () { return createObjectTool_js_1.handleCreateObject; } });
@@ -31,4 +31,7 @@ Object.defineProperty(exports, "handlePruneClosed", { enumerable: true, get: fun
 var activateTool_js_1 = require("./activateTool.js");
 Object.defineProperty(exports, "activateTool", { enumerable: true, get: function () { return activateTool_js_1.activateTool; } });
 Object.defineProperty(exports, "handleActivate", { enumerable: true, get: function () { return activateTool_js_1.handleActivate; } });
+var replaceObjectBodyRegexTool_js_1 = require("./replaceObjectBodyRegexTool.js");
+Object.defineProperty(exports, "replaceObjectBodyRegexTool", { enumerable: true, get: function () { return replaceObjectBodyRegexTool_js_1.replaceObjectBodyRegexTool; } });
+Object.defineProperty(exports, "handleReplaceObjectBodyRegex", { enumerable: true, get: function () { return replaceObjectBodyRegexTool_js_1.handleReplaceObjectBodyRegex; } });
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,uDAAoE;AAA3D,iHAAA,aAAa,OAAA;AAAE,mHAAA,eAAe,OAAA;AACvC,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,2DAA0E;AAAjE,qHAAA,eAAe,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAC3C,mEAGkC;AAFhC,6HAAA,mBAAmB,OAAA;AACnB,+HAAA,qBAAqB,OAAA;AAEvB,uDAAoE;AAA3D,iHAAA,aAAa,OAAA;AAAE,mHAAA,eAAe,OAAA;AACvC,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,2DAA0E;AAAjE,qHAAA,eAAe,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAC3C,qDAAiE;AAAxD,+GAAA,YAAY,OAAA;AAAE,iHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;;AAAA,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,uDAAoE;AAA3D,iHAAA,aAAa,OAAA;AAAE,mHAAA,eAAe,OAAA;AACvC,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,2DAA0E;AAAjE,qHAAA,eAAe,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAC3C,mEAGkC;AAFhC,6HAAA,mBAAmB,OAAA;AACnB,+HAAA,qBAAqB,OAAA;AAEvB,uDAAoE;AAA3D,iHAAA,aAAa,OAAA;AAAE,mHAAA,eAAe,OAAA;AACvC,6DAA6E;AAApE,uHAAA,gBAAgB,OAAA;AAAE,yHAAA,kBAAkB,OAAA;AAC7C,2DAA0E;AAAjE,qHAAA,eAAe,OAAA;AAAE,uHAAA,iBAAiB,OAAA;AAC3C,qDAAiE;AAAxD,+GAAA,YAAY,OAAA;AAAE,iHAAA,cAAc,OAAA;AACrC,iFAGyC;AAFvC,2IAAA,0BAA0B,OAAA;AAC1B,6IAAA,4BAA4B,OAAA"}

package/dist/tools/listObjectsTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const listObjectsTool: {
     readonly name: "list_objects";
-    readonly description: "Lists objects from the task trellis system";
+    readonly description: "Lists objects from the task trellis system\n\nUse this tool to retrieve and filter objects based on various criteria. Essential for discovering existing work items, understanding project structure, and finding objects that need attention.\n\nAvailable object types:\n- 'project': Top-level containers\n- 'epic': Large features within projects  \n- 'feature': Specific functionality within epics\n- 'task': Individual work items\n\nAvailable status values:\n- 'draft': Initial state for new objects\n- 'open': Ready to begin work\n- 'in-progress': Currently being worked on\n- 'done': Completed successfully\n- 'wont-do': Cancelled or decided against\n\nAvailable priority values:\n- 'high': Critical or urgent work\n- 'medium': Standard priority\n- 'low': Nice-to-have or future work\n\nKey filtering options:\n- 'type': Filter by object category (project, epic, feature, task)\n- 'scope': Limit results to a specific project or area of work\n- 'status': Find objects in particular states (draft, open, in-progress, done, wont-do)\n- 'priority': Filter by importance level (high, medium, low)\n- 'includeClosed': Whether to show completed/archived objects (defaults to false)\n\nUsage patterns:\n- List all tasks in progress: type='task', status='in-progress'\n- Find high priority work: priority='high', includeClosed=false\n- Review project scope: type='project', scope='specific-project'\n- Audit completed work: includeClosed=true, status='done'\n- Find cancelled items: status='wont-do', includeClosed=true\n\nThe results provide object metadata including IDs, titles, relationships, and current status to help navigate the work hierarchy effectively.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {

package/dist/tools/listObjectsTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listObjectsTool.d.ts","sourceRoot":"","sources":["../../src/tools/listObjectsTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BlB,CAAC;AAEX,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAkF5E"}
+{"version":3,"file":"listObjectsTool.d.ts","sourceRoot":"","sources":["../../src/tools/listObjectsTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkElB,CAAC;AAEX,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GAkF5E"}

package/dist/tools/listObjectsTool.js

@@ -5,7 +5,43 @@ exports.handleListObjects = handleListObjects;
 const models_1 = require("../models");
 exports.listObjectsTool = {
     name: "list_objects",
-    description: "Lists objects from the task trellis system",
+    description: `Lists objects from the task trellis system
+
+Use this tool to retrieve and filter objects based on various criteria. Essential for discovering existing work items, understanding project structure, and finding objects that need attention.
+
+Available object types:
+- 'project': Top-level containers
+- 'epic': Large features within projects  
+- 'feature': Specific functionality within epics
+- 'task': Individual work items
+
+Available status values:
+- 'draft': Initial state for new objects
+- 'open': Ready to begin work
+- 'in-progress': Currently being worked on
+- 'done': Completed successfully
+- 'wont-do': Cancelled or decided against
+
+Available priority values:
+- 'high': Critical or urgent work
+- 'medium': Standard priority
+- 'low': Nice-to-have or future work
+
+Key filtering options:
+- 'type': Filter by object category (project, epic, feature, task)
+- 'scope': Limit results to a specific project or area of work
+- 'status': Find objects in particular states (draft, open, in-progress, done, wont-do)
+- 'priority': Filter by importance level (high, medium, low)
+- 'includeClosed': Whether to show completed/archived objects (defaults to false)
+
+Usage patterns:
+- List all tasks in progress: type='task', status='in-progress'
+- Find high priority work: priority='high', includeClosed=false
+- Review project scope: type='project', scope='specific-project'
+- Audit completed work: includeClosed=true, status='done'
+- Find cancelled items: status='wont-do', includeClosed=true
+
+The results provide object metadata including IDs, titles, relationships, and current status to help navigate the work hierarchy effectively.`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/tools/listObjectsTool.js.map

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

package/dist/tools/pruneClosedTool.d.ts

@@ -1,7 +1,7 @@
 import { Repository } from "../repositories";
 export declare const pruneClosedTool: {
     readonly name: "prune_closed";
-    readonly description: "Prunes closed objects from the task trellis system";
+    readonly description: "Prunes closed objects from the task trellis system\n\nUse this tool for maintenance and cleanup of completed, cancelled, or otherwise closed objects that are no longer needed. Essential for system hygiene and performance optimization.\n\nPruning criteria:\n- 'age': Minimum age in minutes since object closure (required)\n- 'scope': Limit pruning to specific project or area (optional)\n- Objects must be in closed states (completed, cancelled, archived)\n- Objects must not have active dependencies or relationships\n\nSafety mechanisms:\n- Only removes truly closed objects (completed, cancelled, etc.)\n- Validates no active objects depend on pruned items\n- Preserves objects referenced by active work\n- Maintains referential integrity of remaining system\n\nCommon usage patterns:\n- Daily cleanup: age=1440 (24 hours)\n- Weekly maintenance: age=10080 (7 days) \n- Project closure: scope='project-name', age=4320 (3 days)\n- System cleanup: age=43200 (30 days)\n\nPruning benefits:\n- Reduces database size and improves query performance\n- Removes clutter from active task views\n- Prevents accumulation of obsolete work items\n- Maintains focus on current and relevant tasks\n\nUse regularly as part of system maintenance to keep the task trellis clean and performant. Consider project lifecycles and audit requirements when setting age thresholds.\n\nThis operation is permanent - pruned objects cannot be recovered.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -17,10 +17,10 @@ export declare const pruneClosedTool: {
         readonly required: readonly ["age"];
     };
 };
-export declare function handlePruneClosed(repository: Repository, args: unknown): {
+export declare function handlePruneClosed(repository: Repository, args: unknown): Promise<{
     content: {
         type: string;
         text: string;
     }[];
-};
+}>;
 //# sourceMappingURL=pruneClosedTool.d.ts.map

package/dist/tools/pruneClosedTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pruneClosedTool.d.ts","sourceRoot":"","sources":["../../src/tools/pruneClosedTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CAiBlB,CAAC;AAEX,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;EAmBtE"}
+{"version":3,"file":"pruneClosedTool.d.ts","sourceRoot":"","sources":["../../src/tools/pruneClosedTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;CA+ClB,CAAC;AAEX,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;;;;;GA6D5E"}