vikunja-mcp-ng 0.4.0

package/dist/tools/projects/sharing.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Project Link Sharing Module
+ *
+ * Handles link sharing operations for projects: `create-share`,
+ * `list-shares`, `get-share`, `delete-share`, `auth-share`.
+ *
+ * Migrated off the legacy client (Wave D domain migration, tracking issue #28)
+ * onto `vikunjaRestRequest` + types generated from the vendored OpenAPI
+ * spec. the legacy client's `LinkSharing` type is stale — it models
+ * `right`/`label`/`password_enabled`/`expires`, none of which the real API
+ * accepts or returns; the spec's `models.LinkSharing` uses `permission` and
+ * `name`, and has no `expires`/`password_enabled`/`shares` field at all. See
+ * docs/API_NOTES.md "Project Sharing" and docs/API-COVERAGE.md.
+ *
+ * Endpoints (verified against docs/vikunja-openapi.json):
+ *   - PUT    /projects/{project}/shares         create
+ *   - GET    /projects/{project}/shares         list
+ *   - GET    /projects/{project}/shares/{share} get
+ *   - DELETE /projects/{project}/shares/{share} delete
+ *   - POST   /shares/{share}/auth               auth
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectShare = createProjectShare;
+exports.listProjectShares = listProjectShares;
+exports.getProjectShare = getProjectShare;
+exports.deleteProjectShare = deleteProjectShare;
+exports.authProjectShare = authProjectShare;
+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 permission_1 = require("./permission");
+const response_formatter_1 = require("./response-formatter");
+const response_factory_1 = require("../../utils/response-factory");
+/**
+ * Re-throws a REST-layer 404 as a friendlier "project not found" message;
+ * everything else is re-thrown unchanged (MCPError as-is, anything else
+ * through `transformApiError`).
+ */
+function rethrowProjectNotFound(error, projectId, context) {
+    if (error instanceof types_1.MCPError) {
+        if (error.details?.statusCode === 404) {
+            throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Project with ID ${projectId} not found`);
+        }
+        throw error;
+    }
+    throw (0, error_handler_1.transformApiError)(error, context);
+}
+/**
+ * Creates a new link share for a project
+ */
+async function createProjectShare(args, authManager) {
+    const { projectId, right, name, password, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        (0, validation_1.validateId)(projectId, 'project id');
+        const numericRight = (0, permission_1.resolvePermission)(right);
+        // Verify the project exists before writing (verify-then-apply) so a
+        // missing project produces a friendly NOT_FOUND rather than whatever
+        // the shares endpoint itself happens to return for an absent project.
+        await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${projectId}`);
+        // models.LinkSharing's request shape is {permission, name, password}.
+        const body = {
+            permission: numericRight,
+        };
+        if (name !== undefined) {
+            body.name = name.trim();
+        }
+        if (password !== undefined) {
+            body.password = password;
+        }
+        const createdShare = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'PUT', `/projects/${projectId}/shares`, body);
+        const result = (0, response_formatter_1.createProjectResponse)('create_project_share', `Share created successfully for project ID ${projectId}`, { share: createdShare }, {
+            projectId,
+            shareRight: right,
+            hasPassword: !!password
+        }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError && error.code === types_1.ErrorCode.VALIDATION_ERROR) {
+            throw error;
+        }
+        rethrowProjectNotFound(error, projectId, 'Failed to create share');
+    }
+}
+/**
+ * Lists all link shares for a project
+ */
+async function listProjectShares(args, authManager) {
+    const { projectId, page = 1, perPage = 50, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        (0, validation_1.validateId)(projectId, 'project id');
+        // Verify the project exists first (same verify-then-apply shape as create).
+        await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${projectId}`);
+        const params = new URLSearchParams();
+        if (page !== 1)
+            params.set('page', String(page));
+        if (perPage !== 50)
+            params.set('per_page', String(perPage));
+        const query = params.toString();
+        const shares = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${projectId}/shares${query ? `?${query}` : ''}`);
+        const shareList = Array.isArray(shares) ? shares : [];
+        const result = (0, response_formatter_1.createProjectResponse)('list_project_shares', `Retrieved ${shareList.length} shares for project ${projectId}`, { shares: shareList }, {
+            projectId,
+            page,
+            perPage,
+            count: shareList.length,
+            totalShares: shareList.length
+        }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError && error.code === types_1.ErrorCode.VALIDATION_ERROR) {
+            throw error;
+        }
+        rethrowProjectNotFound(error, projectId, 'Failed to list shares');
+    }
+}
+/**
+ * Gets a specific link share by ID
+ */
+async function getProjectShare(args, authManager) {
+    const { shareId, projectId, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        if (!shareId || typeof shareId !== 'string' || shareId.trim().length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Share ID must be a non-empty string');
+        }
+        if (!projectId || typeof projectId !== 'number' || projectId <= 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project ID is required');
+        }
+        const share = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${projectId}/shares/${Number(shareId)}`);
+        const shareDisplayName = share.name || `Share #${shareId}`;
+        const result = (0, response_formatter_1.createProjectResponse)('get_project_share', `Retrieved link share: ${shareDisplayName}`, { share }, { shareId }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            if (error.details?.statusCode === 404) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Share with ID ${shareId} not found for project ${projectId}`);
+            }
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to get share');
+    }
+}
+/**
+ * Deletes a link share
+ */
+async function deleteProjectShare(args, authManager) {
+    const { shareId, projectId, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        if (!shareId || typeof shareId !== 'string' || shareId.trim().length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Share ID must be a non-empty string');
+        }
+        if (!projectId || typeof projectId !== 'number' || projectId <= 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project ID is required');
+        }
+        // Get share details before deletion so the response can report the
+        // share's name and project id.
+        const share = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'GET', `/projects/${projectId}/shares/${Number(shareId)}`);
+        await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'DELETE', `/projects/${projectId}/shares/${Number(shareId)}`);
+        const result = (0, response_formatter_1.createProjectResponse)('delete_project_share', `Share with ID ${shareId} deleted successfully`, {
+            deleted: true,
+            shareId,
+            shareName: share.name,
+            projectId,
+        }, {
+            projectId,
+            shareId,
+            shareName: share.name
+        }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            if (error.details?.statusCode === 404) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Share with ID ${shareId} not found for project ${projectId}`);
+            }
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to delete share');
+    }
+}
+/**
+ * Authenticates access to a shared project
+ */
+async function authProjectShare(args, authManager) {
+    const { shareHash, password, verbosity, useOptimizedFormat, useAorp } = args;
+    try {
+        if (!shareHash || typeof shareHash !== 'string' || shareHash.trim().length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Share hash must be a non-empty string');
+        }
+        // v1.LinkShareAuth: {password}. Unauthenticated endpoint (no share-scoped
+        // JWT needed yet — this call obtains one), but vikunjaRestRequest is
+        // still used since it uses the same host/breaker/retry plumbing as every
+        // other authenticated call; the session's Authorization header is simply
+        // unused server-side for this specific route.
+        const authResult = await (0, vikunja_rest_1.vikunjaRestRequest)(authManager, 'POST', `/shares/${shareHash}/auth`, { password: password || '' });
+        const result = (0, response_formatter_1.createProjectResponse)('auth_project_share', `Successfully authenticated to share`, { auth: authResult }, {
+            shareHash,
+            hasPassword: !!password,
+            authenticated: true
+        }, verbosity, useOptimizedFormat, useAorp);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: (0, response_factory_1.formatAorpAsMarkdown)(result.response),
+                }
+            ]
+        };
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError) {
+            if (error.code === types_1.ErrorCode.VALIDATION_ERROR) {
+                throw error;
+            }
+            if (error.details?.statusCode === 401) {
+                throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Invalid password for share`);
+            }
+            if (error.details?.statusCode === 404) {
+                throw new types_1.MCPError(types_1.ErrorCode.NOT_FOUND, `Share with hash ${shareHash} not found`);
+            }
+            throw error;
+        }
+        throw (0, error_handler_1.transformApiError)(error, 'Failed to authenticate to share');
+    }
+}
+//# sourceMappingURL=sharing.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sharing.js","sourceRoot":"","sources":["../../../src/tools/projects/sharing.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAsGH,gDAqEC;AAKD,8CA6DC;AAKD,0CAuDC;AAKD,gDAuEC;AAKD,4CAgEC;AAvbD,uCAAkD;AAClD,2DAA8D;AAC9D,6DAA8D;AAC9D,6CAA0C;AAC1C,6CAAuE;AACvE,6DAA6D;AAC7D,mEAAoE;AA2EpE;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,KAAc,EAAE,SAAiB,EAAE,OAAe;IAChF,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;YACtC,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,SAAS,YAAY,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAqB,EACrB,WAAwB;IAExB,MAAM,EACJ,SAAS,EACT,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,OAAO,EACR,GAAG,IAAI,CAAC;IAET,IAAI,CAAC;QACH,IAAA,uBAAU,EAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,YAAY,GAAG,IAAA,8BAAiB,EAAC,KAAK,CAAC,CAAC;QAE9C,oEAAoE;QACpE,qEAAqE;QACrE,sEAAsE;QACtE,MAAM,IAAA,iCAAkB,EAAiB,WAAW,EAAE,KAAK,EAAE,aAAa,SAAS,EAAE,CAAC,CAAC;QAEvF,sEAAsE;QACtE,MAAM,IAAI,GAA6D;YACrE,UAAU,EAAE,YAAY;SACzB,CAAC;QACF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAA,iCAAkB,EAC3C,WAAW,EACX,KAAK,EACL,aAAa,SAAS,SAAS,EAC/B,IAAI,CACL,CAAC;QAEF,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,sBAAsB,EACtB,6CAA6C,SAAS,EAAE,EACxD,EAAE,KAAK,EAAE,YAAY,EAAE,EACvB;YACE,SAAS;YACT,UAAU,EAAE,KAAK;YACjB,WAAW,EAAE,CAAC,CAAC,QAAQ;SACxB,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,IAAI,KAAK,YAAY,gBAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAS,CAAC,gBAAgB,EAAE,CAAC;YAC3E,MAAM,KAAK,CAAC;QACd,CAAC;QACD,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CACrC,IAAoB,EACpB,WAAwB;IAExB,MAAM,EACJ,SAAS,EACT,IAAI,GAAG,CAAC,EACR,OAAO,GAAG,EAAE,EACZ,SAAS,EACT,kBAAkB,EAClB,OAAO,EACR,GAAG,IAAI,CAAC;IAET,IAAI,CAAC;QACH,IAAA,uBAAU,EAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEpC,4EAA4E;QAC5E,MAAM,IAAA,iCAAkB,EAAiB,WAAW,EAAE,KAAK,EAAE,aAAa,SAAS,EAAE,CAAC,CAAC;QAEvF,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,IAAI,OAAO,KAAK,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAkB,EACrC,WAAW,EACX,KAAK,EACL,aAAa,SAAS,UAAU,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3D,CAAC;QACF,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtD,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,qBAAqB,EACrB,aAAa,SAAS,CAAC,MAAM,uBAAuB,SAAS,EAAE,EAC/D,EAAE,MAAM,EAAE,SAAS,EAAE,EACrB;YACE,SAAS;YACT,IAAI;YACJ,OAAO;YACP,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,WAAW,EAAE,SAAS,CAAC,MAAM;SAC9B,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,IAAI,KAAK,YAAY,gBAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAS,CAAC,gBAAgB,EAAE,CAAC;YAC3E,MAAM,KAAK,CAAC;QACd,CAAC;QACD,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACnC,IAAkB,EAClB,WAAwB;IAExB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5E,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,qCAAqC,CACtC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAA,iCAAkB,EACpC,WAAW,EACX,KAAK,EACL,aAAa,SAAS,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE,CACnD,CAAC;QAEF,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,IAAI,UAAU,OAAO,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,mBAAmB,EACnB,yBAAyB,gBAAgB,EAAE,EAC3C,EAAE,KAAK,EAAE,EACT,EAAE,OAAO,EAAE,EACX,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,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,iBAAiB,OAAO,0BAA0B,SAAS,EAAE,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAqB,EACrB,WAAwB;IAExB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE5E,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,qCAAqC,CACtC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAED,mEAAmE;QACnE,+BAA+B;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAA,iCAAkB,EACpC,WAAW,EACX,KAAK,EACL,aAAa,SAAS,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE,CACnD,CAAC;QAEF,MAAM,IAAA,iCAAkB,EACtB,WAAW,EACX,QAAQ,EACR,aAAa,SAAS,WAAW,MAAM,CAAC,OAAO,CAAC,EAAE,CACnD,CAAC;QAEF,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,sBAAsB,EACtB,iBAAiB,OAAO,uBAAuB,EAC/C;YACE,OAAO,EAAE,IAAI;YACb,OAAO;YACP,SAAS,EAAE,KAAK,CAAC,IAAI;YACrB,SAAS;SACV,EACD;YACE,SAAS;YACT,OAAO;YACP,SAAS,EAAE,KAAK,CAAC,IAAI;SACtB,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,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,iBAAiB,OAAO,0BAA0B,SAAS,EAAE,CAAC,CAAC;YACzG,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CACpC,IAAmB,EACnB,WAAwB;IAExB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE7E,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,gBAAQ,CAChB,iBAAS,CAAC,gBAAgB,EAC1B,uCAAuC,CACxC,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,qEAAqE;QACrE,yEAAyE;QACzE,yEAAyE;QACzE,8CAA8C;QAC9C,MAAM,UAAU,GAAG,MAAM,IAAA,iCAAkB,EACzC,WAAW,EACX,MAAM,EACN,WAAW,SAAS,OAAO,EAC3B,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE,CAC7B,CAAC;QAEF,MAAM,MAAM,GAAG,IAAA,0CAAqB,EAClC,oBAAoB,EACpB,qCAAqC,EACrC,EAAE,IAAI,EAAE,UAAU,EAAE,EACpB;YACE,SAAS;YACT,WAAW,EAAE,CAAC,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI;SACpB,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,IAAI,KAAK,YAAY,gBAAQ,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAS,CAAC,gBAAgB,EAAE,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;gBACtC,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;YAC/E,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,EAAE,CAAC;gBACtC,MAAM,IAAI,gBAAQ,CAAC,iBAAS,CAAC,SAAS,EAAE,mBAAmB,SAAS,YAAY,CAAC,CAAC;YACpF,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAA,iCAAiB,EAAC,KAAK,EAAE,iCAAiC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,51 @@
+/**
+ * Project Validation Module
+ * Handles all validation logic for project operations
+ */
+import type { components } from '../../types/generated/vikunja-openapi';
+import { validateId as validateSharedId } from '../../utils/validation';
+type Project = components['schemas']['models.Project'];
+/**
+ * Maximum allowed depth for project hierarchy to prevent excessive nesting
+ */
+export declare const MAX_PROJECT_DEPTH = 10;
+/**
+ * Validates that an ID is a positive integer
+ */
+export declare const validateId: typeof validateSharedId;
+/**
+ * Validates that a hex color is in the correct format (#RRGGBB)
+ */
+export declare function validateHexColor(hexColor: string): void;
+/**
+ * Calculates the depth of a project in the hierarchy
+ */
+export declare function calculateProjectDepth(projectId: number, allProjects: Project[]): number;
+/**
+ * Gets the maximum depth of a project's subtree
+ *
+ * Cycle detection is path-based (an "ancestors in the current DFS branch"
+ * set, popped on backtrack) rather than a single set shared across the
+ * whole traversal. A global set would flag legitimate non-cyclic data —
+ * e.g. two sibling branches that happen to reach the same (duplicate or
+ * corrupted) id — as a false-positive cycle. Path-based detection still
+ * catches every genuine cycle: a real cycle always revisits a node that is
+ * its own ancestor somewhere along a single branch.
+ */
+export declare function getMaxSubtreeDepth(projectId: number, allProjects: Project[]): number;
+/**
+ * Validates move constraints for a project: self-parenting, circular
+ * references, and the resulting depth of the moved project's subtree once
+ * it is reparented.
+ */
+export declare function validateMoveConstraints(projectId: number, newParentId: number | undefined, allProjects: Project[]): void;
+/**
+ * Validates project create/update data
+ */
+export declare function validateProjectData(data: {
+    title?: string;
+    hexColor?: string;
+    parentProjectId?: number;
+}, allProjects?: Project[]): void;
+export {};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/tools/projects/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAKxE,KAAK,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,UAAU,yBAAmB,CAAC;AAE3C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAwBvF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAiCpF;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,OAAO,EAAE,GACrB,IAAI,CA+CN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CA0ChC"}

package/dist/tools/projects/validation.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Project Validation Module
+ * Handles all validation logic for project operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateId = exports.MAX_PROJECT_DEPTH = void 0;
+exports.validateHexColor = validateHexColor;
+exports.calculateProjectDepth = calculateProjectDepth;
+exports.getMaxSubtreeDepth = getMaxSubtreeDepth;
+exports.validateMoveConstraints = validateMoveConstraints;
+exports.validateProjectData = validateProjectData;
+const types_1 = require("../../types");
+const validation_1 = require("../../utils/validation");
+/**
+ * Maximum allowed depth for project hierarchy to prevent excessive nesting
+ */
+exports.MAX_PROJECT_DEPTH = 10;
+/**
+ * Validates that an ID is a positive integer
+ */
+exports.validateId = validation_1.validateId;
+/**
+ * Validates that a hex color is in the correct format (#RRGGBB)
+ */
+function validateHexColor(hexColor) {
+    // Validates hex color in format #RRGGBB (6 hex digits)
+    if (!/^#[0-9A-Fa-f]{6}$/.test(hexColor)) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Invalid hex color format. Expected format: #RRGGBB (e.g., #4287f5, #FF0000, #00ff00)');
+    }
+}
+/**
+ * Calculates the depth of a project in the hierarchy
+ */
+function calculateProjectDepth(projectId, allProjects) {
+    let depth = 0;
+    let currentId = projectId;
+    const visitedIds = new Set();
+    while (currentId !== undefined) {
+        if (visitedIds.has(currentId)) {
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'Circular reference detected in project hierarchy');
+        }
+        visitedIds.add(currentId);
+        const project = allProjects.find((p) => p.id === currentId);
+        if (!project) {
+            break;
+        }
+        currentId = typeof project.parent_project_id === 'number' ? project.parent_project_id : undefined;
+        depth++;
+    }
+    return depth;
+}
+/**
+ * Gets the maximum depth of a project's subtree
+ *
+ * Cycle detection is path-based (an "ancestors in the current DFS branch"
+ * set, popped on backtrack) rather than a single set shared across the
+ * whole traversal. A global set would flag legitimate non-cyclic data —
+ * e.g. two sibling branches that happen to reach the same (duplicate or
+ * corrupted) id — as a false-positive cycle. Path-based detection still
+ * catches every genuine cycle: a real cycle always revisits a node that is
+ * its own ancestor somewhere along a single branch.
+ */
+function getMaxSubtreeDepth(projectId, allProjects) {
+    function dfs(currentId, currentDepth, path) {
+        if (path.has(currentId)) {
+            throw new types_1.MCPError(types_1.ErrorCode.INTERNAL_ERROR, 'Circular reference detected in project hierarchy');
+        }
+        if (currentDepth > exports.MAX_PROJECT_DEPTH) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Project hierarchy depth exceeds maximum allowed depth of ${exports.MAX_PROJECT_DEPTH}`);
+        }
+        path.add(currentId);
+        let maxDepth = currentDepth;
+        const children = allProjects.filter((p) => p.parent_project_id === currentId);
+        for (const child of children) {
+            if (child.id === undefined) {
+                continue; // Skip children without valid IDs
+            }
+            const childDepth = dfs(child.id, currentDepth + 1, path);
+            maxDepth = Math.max(maxDepth, childDepth);
+        }
+        path.delete(currentId);
+        return maxDepth;
+    }
+    return dfs(projectId, 0, new Set());
+}
+/**
+ * Validates move constraints for a project: self-parenting, circular
+ * references, and the resulting depth of the moved project's subtree once
+ * it is reparented.
+ */
+function validateMoveConstraints(projectId, newParentId, allProjects) {
+    if (newParentId === projectId) {
+        throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Cannot move a project to be its own parent');
+    }
+    // Check if moving would create a circular reference. Reassigning
+    // projectId's parent_project_id to newParentId and then walking
+    // projectId's own descendants (via child links) will revisit projectId
+    // itself if newParentId is one of projectId's descendants — the moved
+    // project's own (updated) record shows up as "a child of" whichever node
+    // in its old subtree it would now be parented under.
+    const updatedProjects = allProjects.map((p) => p.id === projectId ? { ...p, parent_project_id: newParentId } : p);
+    let subtreeDepth;
+    try {
+        subtreeDepth = getMaxSubtreeDepth(projectId, updatedProjects);
+    }
+    catch (error) {
+        if (error instanceof types_1.MCPError && error.code === types_1.ErrorCode.INTERNAL_ERROR) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Move would create a circular reference in project hierarchy');
+        }
+        throw error;
+    }
+    // Moving under a new parent can push the project's subtree past the
+    // maximum allowed depth even when neither the project's own subtree nor
+    // the new parent's ancestor chain is individually too deep. newParentId's
+    // depth is computed against the original (pre-move) hierarchy — by this
+    // point it's confirmed not to be a descendant of projectId, so it can't
+    // have been affected by the reparenting.
+    if (newParentId !== undefined) {
+        const newParentDepth = calculateProjectDepth(newParentId, allProjects);
+        const resultingDepth = newParentDepth + 1 + subtreeDepth;
+        if (resultingDepth > exports.MAX_PROJECT_DEPTH) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Moving this project would exceed the maximum depth of ${exports.MAX_PROJECT_DEPTH} levels`);
+        }
+    }
+}
+/**
+ * Validates project create/update data
+ */
+function validateProjectData(data, allProjects) {
+    if (data.title !== undefined) {
+        if (typeof data.title !== 'string' || data.title.trim().length === 0) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project title must be a non-empty string');
+        }
+        if (data.title.length > 250) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, 'Project title must not exceed 250 characters');
+        }
+    }
+    if (data.hexColor !== undefined) {
+        validateHexColor(data.hexColor);
+    }
+    // parentProjectId === 0 is Vikunja's own "no parent / root project"
+    // sentinel, never a real project id to validate — the caller-facing Zod
+    // schema already enforces `.positive()` for a genuinely *supplied*
+    // parentProjectId, so a 0 reaching here only ever comes from
+    // updateProject's merge-preserve default (buildProjectUpdatePayload
+    // resolving an omitted parentProjectId to the current project's own
+    // parent_project_id, which is 0 for a root project — see
+    // ENDPOINT-PLAYBOOK.md §4). Treating it as "must be a positive integer
+    // AND must exist in allProjects" broke every no-op update of a
+    // already-root-level project.
+    if (data.parentProjectId !== undefined && data.parentProjectId !== 0 && allProjects) {
+        (0, exports.validateId)(data.parentProjectId, 'parentProjectId');
+        const parentProject = allProjects.find((p) => p.id === data.parentProjectId);
+        if (!parentProject) {
+            throw new types_1.MCPError(types_1.ErrorCode.VALIDATION_ERROR, `Parent project with ID ${data.parentProjectId} not found`);
+        }
+    }
+}
+//# sourceMappingURL=validation.js.map

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

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

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

@@ -0,0 +1,161 @@
+/**
+ * Project view operations
+ *
+ * Implements `list-views`, `get-view`, `create-view`, `update-view`,
+ * `delete-view`, and the `set-done-bucket` composite, against Vikunja's
+ * project view endpoints (`/projects/{project}/views[/{id}]`). legacy client
+ * has no support for project views at all, so — like `buckets.ts` — this
+ * calls the Vikunja REST API directly via the shared `vikunja-rest` helper.
+ *
+ * `POST /projects/{project}/views/{id}` replaces the entire ProjectView
+ * resource (see docs/ENDPOINT-PLAYBOOK.md §4), so `update-view` and
+ * `set-done-bucket` both fetch the current view first and merge requested
+ * changes onto it (`buildViewUpdatePayload`) rather than sending a bare
+ * partial object — the same fetch-merge-POST pattern as
+ * `buildProjectUpdatePayload` in `crud.ts`.
+ */
+import type { AuthManager } from '../../auth/AuthManager';
+import type { components } from '../../types/generated/vikunja-openapi';
+type VikunjaProjectView = components['schemas']['models.ProjectView'];
+type ViewKind = 'list' | 'gantt' | 'table' | 'kanban';
+type BucketConfigurationMode = 'none' | 'manual' | 'filter';
+export interface ListViewsArgs {
+    /** Project whose views should be listed. */
+    id?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface GetViewArgs {
+    /** Project the view belongs to. */
+    id?: number;
+    /** Id of the view to fetch. */
+    viewId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface CreateViewArgs {
+    /** Project the new view should belong to. */
+    id?: number;
+    /** Title of the new view. */
+    title?: string;
+    /** Kind of view to create (`list`, `gantt`, `table`, or `kanban`). */
+    viewKind?: ViewKind;
+    /** Bucket configuration mode. Only meaningful for kanban-style views. */
+    bucketConfigurationMode?: BucketConfigurationMode;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface UpdateViewArgs {
+    /** Project the view belongs to. */
+    id?: number;
+    /** Id of the view to update. */
+    viewId?: number;
+    /** New title, if changing. */
+    title?: string;
+    /** New view kind, if changing. */
+    viewKind?: ViewKind;
+    /** New bucket configuration mode, if changing. */
+    bucketConfigurationMode?: BucketConfigurationMode;
+    /** New done-bucket id, if changing. Also settable via `set-done-bucket`. */
+    doneBucketId?: number;
+    /** New default-bucket id, if changing. */
+    defaultBucketId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface DeleteViewArgs {
+    /** Project the view belongs to. */
+    id?: number;
+    /** Id of the view to delete. */
+    viewId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+export interface SetDoneBucketArgs {
+    /** Project whose Kanban view's done bucket should be set. */
+    id?: number;
+    /** Optional Kanban view id. Auto-resolved from the project when omitted. */
+    viewId?: number;
+    /** Id of the bucket that should become the done bucket. */
+    bucketId?: number;
+    /** Session id for response tracking. */
+    sessionId?: string;
+}
+/**
+ * Builds a project view update payload by merging the current view with
+ * requested field changes, so fields the caller didn't mention survive the
+ * full-model-replace `POST /projects/{project}/views/{id}` round trip.
+ */
+export declare function buildViewUpdatePayload(currentView: VikunjaProjectView, updates: {
+    title?: string;
+    viewKind?: ViewKind;
+    bucketConfigurationMode?: BucketConfigurationMode;
+    doneBucketId?: number;
+    defaultBucketId?: number;
+}): VikunjaProjectView;
+/**
+ * Lists the views of a project.
+ */
+export declare function listViews(args: ListViewsArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Gets a single project view by id.
+ */
+export declare function getView(args: GetViewArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Creates a new view on a project.
+ */
+export declare function createView(args: CreateViewArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Updates a project view. `POST /projects/{project}/views/{id}` is a
+ * full-model-replace endpoint, so the current view is fetched first and
+ * merged with the requested changes (see `buildViewUpdatePayload`).
+ */
+export declare function updateView(args: UpdateViewArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Deletes a project view.
+ */
+export declare function deleteView(args: DeleteViewArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/**
+ * Composite: sets a Kanban view's done bucket.
+ *
+ * `models.Bucket` has no `is_done_bucket` field of its own (see
+ * docs/API_NOTES.md "Kanban 'Done' Bucket") — the done bucket is a property
+ * of the ProjectView (`done_bucket_id`), not the bucket. This is the only
+ * way to *set* it (list-buckets can only read it). Steps: resolve the
+ * project's Kanban view (or use an explicit `viewId`), fetch-merge-POST the
+ * `done_bucket_id` change onto it, then verify the response reflects the
+ * requested bucket before reporting success.
+ */
+export declare function setDoneBucket(args: SetDoneBucketArgs, authManager: AuthManager): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export {};
+//# sourceMappingURL=views.d.ts.map