vikunja-mcp-ng 0.4.0

package/dist/tools/projects/hierarchy.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * Project Hierarchy Operations Module
+ * Handles complex hierarchical operations like tree building, breadcrumbs, and moves
+ *
+ * Migrated off the legacy client (Wave D domain migration, tracking issue #28)
+ * onto `vikunjaRestRequest` + types generated from the vendored OpenAPI spec.
+ * `moveProject` reuses `buildProjectUpdatePayload` from `crud.ts` — see that
+ * module's doc comment and docs/API_NOTES.md "Project Operations" for why an
+ * omitted `parentProjectId` on move means "move to root" rather than "leave
+ * untouched" (the one exception to the merge-preserves-untouched-fields
+ * default).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectChildren = getProjectChildren;
+exports.getProjectTree = getProjectTree;
+exports.getProjectBreadcrumb = getProjectBreadcrumb;
+exports.moveProject = moveProject;
+const types_1 = require("../../types");
+const vikunja_rest_1 = require("../../utils/vikunja-rest");
+const error_handler_1 = require("../../utils/error-handler");
+const validation_1 = require("./validation");
+const response_formatter_1 = require("./response-formatter");
+const response_factory_1 = require("../../utils/response-factory");
+const crud_1 = require("./crud");
+/**
+ * Gets direct children of a project
+ */
+async function getProjectChildren(args, _context, authManager) {
+    const { id, includeArchived = false, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        (0, validation_1.validateId)(id, 'project id');
+        // Verify the project exists
+        await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${id}`);
+        // Get all projects and filter for children
+        const allProjects = await (0, crud_1.fetchAllProjects)(authManager);
+        let children = allProjects.filter((p) => p.parent_project_id === id);
+        if (!includeArchived) {
+            children = children.filter((p) => !p.is_archived);
+        }
+        const childWord = children.length === 1 ? 'child project' : 'child projects';
+        const response = (0, response_formatter_1.createProjectResponse)('get-project-children', `Found ${children.length} ${childWord} for project ID ${id}`, { children }, { parentId: id, count: children.length }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(response.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to get project children');
+    }
+}
+/**
+ * Builds a complete project tree
+ */
+async function getProjectTree(args, _context, authManager) {
+    const { id, maxDepth = 10, includeArchived = false, verbosity, useOptimizedFormat, useAorp } = args;
+    // Validate that project ID is provided for tree operations
+    if (id === undefined || id === null) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project ID is required');
+    }
+    (0, validation_1.validateId)(id, 'id');
+    try {
+        // Get all projects
+        const allProjects = await (0, crud_1.fetchAllProjects)(authManager);
+        const rootProjects = allProjects.filter((p) => !p.parent_project_id);
+        // If specific ID is provided, find that project and its subtree
+        let rootNode;
+        let treeData;
+        let totalNodes = 0;
+        let actualDepth = 0;
+        if (id) {
+            (0, validation_1.validateId)(id, 'project id');
+            const rootProject = allProjects.find((p) => p.id === id);
+            if (!rootProject) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Project with ID ${id} not found`);
+            }
+            rootNode = buildProjectTree(rootProject, allProjects, 0, maxDepth, includeArchived);
+            if (rootNode) {
+                treeData = [rootNode];
+                totalNodes = countTreeNodes(rootNode);
+                actualDepth = getTreeDepth(rootNode);
+            }
+            else {
+                treeData = [];
+                totalNodes = 0;
+                actualDepth = 0;
+            }
+        }
+        else {
+            // Build forest of all root projects
+            treeData = rootProjects
+                .map((project) => buildProjectTree(project, allProjects, 0, maxDepth, includeArchived))
+                .filter(Boolean);
+            totalNodes = treeData.reduce((sum, node) => sum + countTreeNodes(node), 0);
+            actualDepth = treeData.reduce((max, node) => Math.max(max, getTreeDepth(node)), 0);
+        }
+        // Build options object, only including defined properties to satisfy exactOptionalPropertyTypes
+        const options1 = {};
+        if (verbosity !== undefined) {
+            options1.verbosity = verbosity;
+        }
+        if (useOptimizedFormat !== undefined) {
+            options1.useOptimizedFormat = useOptimizedFormat;
+        }
+        if (useAorp !== undefined) {
+            options1.useAorp = useAorp;
+        }
+        const result = (0, response_formatter_1.createProjectTreeResponse)(treeData, actualDepth, totalNodes, options1);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to get project tree');
+    }
+}
+/**
+ * Gets breadcrumb path from root to specified project
+ */
+async function getProjectBreadcrumb(args, _context, authManager) {
+    const { id, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        (0, validation_1.validateId)(id, 'project id');
+        // Get all projects for navigation
+        const allProjects = await (0, crud_1.fetchAllProjects)(authManager);
+        const targetProject = allProjects.find((p) => p.id === id);
+        if (!targetProject) {
+            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Project with ID ${id} not found`);
+        }
+        const breadcrumb = buildBreadcrumb(id, allProjects);
+        // Build options object, only including defined properties to satisfy exactOptionalPropertyTypes
+        const options2 = {};
+        if (verbosity !== undefined) {
+            options2.verbosity = verbosity;
+        }
+        if (useOptimizedFormat !== undefined) {
+            options2.useOptimizedFormat = useOptimizedFormat;
+        }
+        if (useAorp !== undefined) {
+            options2.useAorp = useAorp;
+        }
+        const result = (0, response_formatter_1.createBreadcrumbResponse)(breadcrumb, options2);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to get project breadcrumb');
+    }
+}
+/**
+ * Moves a project to a new parent
+ */
+async function moveProject(args, _context, authManager) {
+    const { id, parentProjectId, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        (0, validation_1.validateId)(id, 'project id');
+        // Fetch all projects once: this both validates that the project exists
+        // and provides the hierarchy data validateMoveConstraints needs, so a
+        // separate getProject(id) round-trip isn't required.
+        const allProjects = await (0, crud_1.fetchAllProjects)(authManager);
+        const currentProject = allProjects.find((p) => p.id === id);
+        if (!currentProject) {
+            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Project with ID ${id} not found`);
+        }
+        // Validate move constraints (self-parenting, circular references, depth)
+        (0, validation_1.validateMoveConstraints)(id, parentProjectId, allProjects);
+        // Validate parent project ID if provided
+        if (parentProjectId !== undefined) {
+            (0, validation_1.validateId)(parentProjectId, 'parentProjectId');
+        }
+        // If parent is specified, validate it exists
+        if (parentProjectId) {
+            const parentProject = allProjects.find((p) => p.id === parentProjectId);
+            if (!parentProject) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Parent project with ID ${parentProjectId} not found`);
+            }
+        }
+        // POST /projects/{id} is a full-model-replace endpoint: merge through
+        // the current project (like crud.ts's updateProject/archiveProject) so
+        // title/description/hex_color/etc. survive the move. Unlike a regular
+        // update, an omitted parentProjectId here means "move to root" — so
+        // parent_project_id is always set explicitly (0 clears it), never left
+        // to buildProjectUpdatePayload's "only touch what's provided" default.
+        const updateData = (0, crud_1.buildProjectUpdatePayload)(currentProject, {
+            parentProjectId: parentProjectId ?? 0,
+        });
+        const updatedProject = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/projects/${id}`, updateData);
+        const parentInfo = parentProjectId
+            ? ` to parent project ${parentProjectId}`
+            : ' to root level';
+        const result = (0, response_formatter_1.createProjectResponse)('move_project', `Moved project "${updatedProject.title}"${parentInfo}`, { project: updatedProject }, {
+            oldParentProjectId: currentProject.parent_project_id,
+            newParentProjectId: parentProjectId,
+            movedProjectId: id
+        }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        // `vikunjaRestRequest` throws MCPError with the HTTP status under
+        // `details.statusCode` (not a bare `.statusCode` property
+        // `handleStatusCodeError` looks for), so a REST-layer 404 from the
+        // terminal update call is translated explicitly here — matching
+        // crud.ts's `rethrowProjectNotFound`. Errors already thrown above as
+        // MCPError (e.g. the NOT_FOUND checks against the fetched project list)
+        // carry no `details.statusCode` and pass through unchanged.
+        if (error instanceof types_1.MCPError) {
+            if (error.details?.statusCode === 404) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Project with ID ${id} not found`);
+            }
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to move project');
+    }
+}
+/**
+ * Builds a project tree recursively
+ */
+function buildProjectTree(project, allProjects, currentDepth, maxDepth, includeArchived = false) {
+    if (currentDepth >= maxDepth) {
+        return null;
+    }
+    const children = allProjects
+        .filter((p) => p.parent_project_id === project.id)
+        .filter((p) => includeArchived || !p.is_archived)
+        .map((child) => buildProjectTree(child, allProjects, currentDepth + 1, maxDepth, includeArchived))
+        .filter(Boolean);
+    return {
+        ...project,
+        children,
+        depth: currentDepth,
+    };
+}
+/**
+ * Counts total nodes in a tree
+ */
+function countTreeNodes(node) {
+    return 1 + node.children.reduce((sum, child) => sum + countTreeNodes(child), 0);
+}
+/**
+ * Gets the maximum depth of a tree
+ */
+function getTreeDepth(node) {
+    if (node.children.length === 0) {
+        return node.depth;
+    }
+    return Math.max(...node.children.map(child => getTreeDepth(child)));
+}
+/**
+ * Builds breadcrumb path from root to target project
+ */
+function buildBreadcrumb(targetId, allProjects) {
+    const breadcrumb = [];
+    const visited = new Set();
+    let currentId = targetId;
+    while (currentId !== undefined) {
+        if (visited.has(currentId)) {
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'Circular reference detected in project hierarchy while building breadcrumb');
+        }
+        const project = allProjects.find((p) => p.id === currentId);
+        if (!project) {
+            break;
+        }
+        visited.add(currentId);
+        breadcrumb.unshift(project);
+        currentId = project.parent_project_id;
+    }
+    return breadcrumb;
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/tools/projects/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../../src/tools/projects/hierarchy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AA0EH,gDA8CC;AAKD,wCAwFC;AAKD,oDAsDC;AAKD,kCA8FC;AAjXD,uCAAkD;AAClD,2DAA8D;AAE9D,6DAA8D;AAC9D,6CAAmE;AACnE,6DAAkH;AAClH,mEAAoE;AACpE,iCAA0F;AA8D1F;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAqB,EACrB,QAAiB,EACjB,WAAwB;IAExB,MAAM,EAAE,EAAE,EAAE,eAAe,GAAG,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAErF,IAAI,CAAC;QACH,IAAA,uBAAU,EAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAE7B,4BAA4B;QAC5B,MAAM,IAAA,iCAAkB,EAAiB,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QAEhF,2CAA2C;QAC3C,MAAM,WAAW,GAAG,MAAM,IAAA,uBAAgB,EAAC,WAAW,CAAC,CAAC;QACxD,IAAI,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,EAAE,CAAC,CAAC;QAErF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAA,0CAAqB,EACpC,sBAAsB,EACtB,SAAS,QAAQ,CAAC,MAAM,IAAI,SAAS,mBAAmB,EAAE,EAAE,EAC5D,EAAE,QAAQ,EAAE,EACZ,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,EACxC,SAAS,EACT,kBAAkB,EAClB,OAAO,CACR,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,QAAQ,CAAC,QAAQ,CAAC;iBAC9C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAClC,IAAiB,EACjB,QAAiB,EACjB,WAAwB;IAExB,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,eAAe,GAAG,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEpG,2DAA2D;IAC3D,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;IAC3E,CAAC;IACD,IAAA,uBAAU,EAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAErB,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,WAAW,GAAG,MAAM,IAAA,uBAAgB,EAAC,WAAW,CAAC,CAAC;QAExD,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAErF,gEAAgE;QAChE,IAAI,QAAgC,CAAC;QACrC,IAAI,QAA2B,CAAC;QAChC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,IAAI,EAAE,EAAE,CAAC;YACP,IAAA,uBAAU,EAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YAC7B,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;YAC7E,CAAC;YAED,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;YACpF,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtB,UAAU,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;gBACtC,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,EAAE,CAAC;gBACd,UAAU,GAAG,CAAC,CAAC;gBACf,WAAW,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,QAAQ,GAAG,YAAY;iBACpB,GAAG,CAAC,CAAC,OAAuB,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;iBACtG,MAAM,CAAC,OAAO,CAAsB,CAAC;YAExC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3E,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QAED,gGAAgG;QAChG,MAAM,QAAQ,GAA4E,EAAE,CAAC;QAE7F,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,QAAQ,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,8CAAyB,EACtC,QAAQ,EACR,WAAW,EACX,UAAU,EACV,QAAQ,CACT,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,MAAM,CAAC,QAAQ,CAAC;iBAC5C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,IAAuB,EACvB,QAAiB,EACjB,WAAwB;IAExB,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5D,IAAI,CAAC;QACH,IAAA,uBAAU,EAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAE7B,kCAAkC;QAClC,MAAM,WAAW,GAAG,MAAM,IAAA,uBAAgB,EAAC,WAAW,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAE3E,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAEpD,gGAAgG;QAChG,MAAM,QAAQ,GAA4E,EAAE,CAAC;QAE7F,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;YACrC,QAAQ,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC7B,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,6CAAwB,EACrC,UAAU,EACV,QAAQ,CACT,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,MAAM,CAAC,QAAQ,CAAC;iBAC5C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAqB,EACrB,QAAiB,EACjB,WAAwB;IAExB,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE7E,IAAI,CAAC;QACH,IAAA,uBAAU,EAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAE7B,uEAAuE;QACvE,sEAAsE;QACtE,qDAAqD;QACrD,MAAM,WAAW,GAAG,MAAM,IAAA,uBAAgB,EAAC,WAAW,CAAC,CAAC;QAExD,MAAM,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC7E,CAAC;QAED,yEAAyE;QACzE,IAAA,oCAAuB,EAAC,EAAE,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC;QAE1D,yCAAyC;QACzC,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,IAAA,uBAAU,EAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;QACjD,CAAC;QAED,6CAA6C;QAC7C,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;YACxF,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,0BAA0B,eAAe,YAAY,CAAC,CAAC;YACjG,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,oEAAoE;QACpE,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,UAAU,GAAG,IAAA,gCAAyB,EAAC,cAAc,EAAE;YAC3D,eAAe,EAAE,eAAe,IAAI,CAAC;SACtC,CAAC,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,IAAA,iCAAkB,EAC7C,WAAW,EACX,MAAM,EACN,aAAa,EAAE,EAAE,EACjB,UAAU,CACX,CAAC;QAEF,MAAM,UAAU,GAAG,eAAe;YAChC,CAAC,CAAC,sBAAsB,eAAe,EAAE;YACzC,CAAC,CAAC,gBAAgB,CAAC;QAErB,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,cAAc,EACd,kBAAkB,cAAc,CAAC,KAAK,IAAI,UAAU,EAAE,EACtD,EAAE,OAAO,EAAE,cAAc,EAAE,EAC3B;YACE,kBAAkB,EAAE,cAAc,CAAC,iBAAiB;YACpD,kBAAkB,EAAE,eAAe;YACnC,cAAc,EAAE,EAAE;SACnB,EACD,SAAS,EACT,kBAAkB,EAClB,OAAO,CACR,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAA,uCAAoB,EAAC,MAAM,CAAC,QAAQ,CAAC;iBAC5C;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kEAAkE;QAClE,0DAA0D;QAC1D,mEAAmE;QACnE,gEAAgE;QAChE,qEAAqE;QACrE,wEAAwE;QACxE,4DAA4D;QAC5D,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;gBACtC,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,OAAuB,EACvB,WAA6B,EAC7B,YAAoB,EACpB,QAAgB,EAChB,kBAA2B,KAAK;IAEhC,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW;SACzB,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,OAAO,CAAC,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;SAChE,GAAG,CAAC,CAAC,KAAqB,EAAE,EAAE,CAC7B,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,GAAG,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAClF;SACA,MAAM,CAAC,OAAO,CAAsB,CAAC;IAExC,OAAO;QACL,GAAG,OAAO;QACV,QAAQ;QACR,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAqB;IAC3C,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAqB;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,WAA6B;IACtE,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,SAAS,GAAuB,QAAQ,CAAC;IAE7C,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,cAAc,EACxB,4EAA4E,CAC7E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;QAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM;QACR,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5B,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Projects Tool Module - Main Orchestrator
+ * Coordinates all project-related operations through specialized submodules
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { AuthManager } from '../../auth/AuthManager';
+import type { VikunjaClientFactory } from '../../client/VikunjaClientFactory';
+import { listProjects, getProject, createProject, updateProject, deleteProject, archiveProject, unarchiveProject, type ListProjectsArgs, type GetProjectArgs, type CreateProjectArgs, type UpdateProjectArgs, type DeleteProjectArgs, type ArchiveProjectArgs } from './crud';
+import { getProjectChildren, getProjectTree, getProjectBreadcrumb, moveProject, type GetChildrenArgs, type GetTreeArgs, type GetBreadcrumbArgs, type MoveProjectArgs } from './hierarchy';
+import { createProjectShare, listProjectShares, getProjectShare, deleteProjectShare, authProjectShare, type CreateShareArgs, type ListSharesArgs, type GetShareArgs, type DeleteShareArgs, type AuthShareArgs } from './sharing';
+import { listBuckets, createBucket, updateBucket, deleteBucket, listViewTasks, type ListBucketsArgs, type CreateBucketArgs, type UpdateBucketArgs, type DeleteBucketArgs, type ListViewTasksArgs } from './buckets';
+import { listViews, getView, createView, updateView, deleteView, setDoneBucket, type ListViewsArgs, type GetViewArgs, type CreateViewArgs, type UpdateViewArgs, type DeleteViewArgs, type SetDoneBucketArgs } from './views';
+import { duplicateProject, type DuplicateProjectArgs } from './duplicate';
+import { removeProjectBackground, setUnsplashBackground, searchUnsplashBackgrounds, type RemoveBackgroundArgs, type SetUnsplashBackgroundArgs, type SearchUnsplashArgs } from './backgrounds';
+import { listProjectUsers, searchProjectUsers, addProjectUser, updateProjectUserPermission, removeProjectUser, listProjectTeams, addProjectTeam, updateProjectTeamPermission, removeProjectTeam, shareProjectWithUser, shareProjectWithTeam, listProjectMembers, type ListProjectUsersArgs, type SearchProjectUsersArgs, type AddProjectUserArgs, type UpdateProjectUserPermissionArgs, type RemoveProjectUserArgs, type ListProjectTeamsArgs, type AddProjectTeamArgs, type UpdateProjectTeamPermissionArgs, type RemoveProjectTeamArgs, type ShareWithUserArgs, type ShareWithTeamArgs, type ListMembersArgs } from './sharing-access';
+/**
+ * Resolves whether the `backgrounds` module is enabled, failing safe to
+ * disabled (matching the schema default and the "opt-in" contract) rather
+ * than fatal — same fail-safe rationale as `resolveModulesConfig` in
+ * `src/tools/index.ts`. `override` lets `registerTools` pass down a value
+ * it already computed once (avoiding a second `loadConfiguration()` call);
+ * omitted, this resolves independently — used by direct unit-test call
+ * sites that instantiate `registerProjectsTool` without going through
+ * `registerTools`.
+ */
+export declare function resolveBackgroundsEnabled(override?: boolean): boolean;
+/**
+ * Legacy single-tool interface for backward compatibility
+ * Registers a single tool with all subcommands like the original implementation
+ */
+export declare function registerProjectsTool(server: McpServer, authManager: AuthManager, clientFactory?: VikunjaClientFactory, backgroundsEnabledOverride?: boolean): void;
+export type { ListProjectsArgs, GetProjectArgs, CreateProjectArgs, UpdateProjectArgs, DeleteProjectArgs, ArchiveProjectArgs, GetChildrenArgs, GetTreeArgs, GetBreadcrumbArgs, MoveProjectArgs, CreateShareArgs, ListSharesArgs, GetShareArgs, DeleteShareArgs, AuthShareArgs, ListBucketsArgs, CreateBucketArgs, UpdateBucketArgs, DeleteBucketArgs, ListViewTasksArgs, ListViewsArgs, GetViewArgs, CreateViewArgs, UpdateViewArgs, DeleteViewArgs, SetDoneBucketArgs, DuplicateProjectArgs, ListProjectUsersArgs, SearchProjectUsersArgs, AddProjectUserArgs, UpdateProjectUserPermissionArgs, RemoveProjectUserArgs, ListProjectTeamsArgs, AddProjectTeamArgs, UpdateProjectTeamPermissionArgs, RemoveProjectTeamArgs, ShareWithUserArgs, ShareWithTeamArgs, ListMembersArgs, RemoveBackgroundArgs, SetUnsplashBackgroundArgs, SearchUnsplashArgs };
+export { listProjects, getProject, createProject, updateProject, deleteProject, archiveProject, unarchiveProject, getProjectChildren, getProjectTree, getProjectBreadcrumb, moveProject, createProjectShare, listProjectShares, getProjectShare, deleteProjectShare, authProjectShare, listBuckets, createBucket, updateBucket, deleteBucket, listViewTasks, listViews, getView, createView, updateView, deleteView, setDoneBucket, duplicateProject, listProjectUsers, searchProjectUsers, addProjectUser, updateProjectUserPermission, removeProjectUser, listProjectTeams, addProjectTeam, updateProjectTeamPermission, removeProjectTeam, shareProjectWithUser, shareProjectWithTeam, listProjectMembers, removeProjectBackground, setUnsplashBackground, searchUnsplashBackgrounds };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAU9E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAqB1B;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAcrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,oBAAoB,EACpC,0BAA0B,CAAC,EAAE,OAAO,GACnC,IAAI,CAidN;AAGD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,+BAA+B,EAC/B,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,+BAA+B,EAC/B,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EACnB,CAAC;AAGF,OAAO,EAEL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAGhB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,EAGX,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAGhB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EAGb,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EAGb,gBAAgB,EAGhB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAGlB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EAC1B,CAAC"}