@llodev/pm-tasks-clickup 0.0.0-pr-130-7078a2a → 0.0.0-stage

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/README.md +2 -195
  2. package/package.json +3 -61
  3. package/LICENSE +0 -21
  4. package/SKILL.md +0 -258
  5. package/anti-patterns/clickup.md +0 -73
  6. package/dist/adapter.d.ts +0 -39
  7. package/dist/adapter.d.ts.map +0 -1
  8. package/dist/adapter.js +0 -83
  9. package/dist/adapter.js.map +0 -1
  10. package/dist/bin/init.d.ts +0 -3
  11. package/dist/bin/init.d.ts.map +0 -1
  12. package/dist/bin/init.js +0 -20
  13. package/dist/bin/init.js.map +0 -1
  14. package/dist/doctor-cli.d.ts +0 -27
  15. package/dist/doctor-cli.d.ts.map +0 -1
  16. package/dist/doctor-cli.js +0 -315
  17. package/dist/doctor-cli.js.map +0 -1
  18. package/dist/env.d.ts +0 -6
  19. package/dist/env.d.ts.map +0 -1
  20. package/dist/env.js +0 -11
  21. package/dist/env.js.map +0 -1
  22. package/dist/envelope.d.ts +0 -44
  23. package/dist/envelope.d.ts.map +0 -1
  24. package/dist/envelope.js +0 -95
  25. package/dist/envelope.js.map +0 -1
  26. package/dist/errors.d.ts +0 -30
  27. package/dist/errors.d.ts.map +0 -1
  28. package/dist/errors.js +0 -60
  29. package/dist/errors.js.map +0 -1
  30. package/dist/estimation.d.ts +0 -20
  31. package/dist/estimation.d.ts.map +0 -1
  32. package/dist/estimation.js +0 -40
  33. package/dist/estimation.js.map +0 -1
  34. package/dist/index.d.ts +0 -5
  35. package/dist/index.d.ts.map +0 -1
  36. package/dist/index.js +0 -3
  37. package/dist/index.js.map +0 -1
  38. package/dist/init-api.d.ts +0 -67
  39. package/dist/init-api.d.ts.map +0 -1
  40. package/dist/init-api.js +0 -271
  41. package/dist/init-api.js.map +0 -1
  42. package/dist/init-flow.d.ts +0 -27
  43. package/dist/init-flow.d.ts.map +0 -1
  44. package/dist/init-flow.js +0 -206
  45. package/dist/init-flow.js.map +0 -1
  46. package/dist/status-map.d.ts +0 -31
  47. package/dist/status-map.d.ts.map +0 -1
  48. package/dist/status-map.js +0 -38
  49. package/dist/status-map.js.map +0 -1
  50. package/dist/status.d.ts +0 -17
  51. package/dist/status.d.ts.map +0 -1
  52. package/dist/status.js +0 -21
  53. package/dist/status.js.map +0 -1
  54. package/dist/transport-clickup.d.ts +0 -99
  55. package/dist/transport-clickup.d.ts.map +0 -1
  56. package/dist/transport-clickup.js +0 -676
  57. package/dist/transport-clickup.js.map +0 -1
  58. package/docs/i18n/README.es-ES.md +0 -196
  59. package/docs/i18n/README.pt-BR.md +0 -196
  60. package/i18n/en-US.json +0 -62
  61. package/i18n/es-ES.json +0 -62
  62. package/i18n/pt-BR.json +0 -62
  63. package/manifest.json +0 -14
  64. package/references/autonomous.md +0 -85
  65. package/references/estimation.md +0 -115
  66. package/references/operations.md +0 -128
  67. package/schemas/config.json +0 -140
@@ -1,44 +0,0 @@
1
- /**
2
- * Response shapes of the ClickUp MCP. Writes return an envelope
3
- * `{success, task_id, custom_id, task_url}`; `clickup_get_task` returns a bare,
4
- * flat task; failures are `{"error": "<text>"}`, either thrown or resolved.
5
- */
6
- import type { McpCaller } from "./transport-clickup.js";
7
- /** The task fields the verbs read, normalized from either response shape. */
8
- export interface ClickUpTaskView {
9
- id: string;
10
- url?: string;
11
- status?: string;
12
- listId?: string;
13
- parentId: string | null;
14
- assigneeIds: string[];
15
- tagNames: string[];
16
- /** ISO instant of the stored epoch-millisecond due date, or null. */
17
- dueDate: string | null;
18
- subtaskCount: number;
19
- /** `space.id`; absent on a write envelope. */
20
- spaceId?: string;
21
- /** The native `time_estimate` in milliseconds, or null when unset or unreadable. */
22
- timeEstimateMs: number | null;
23
- }
24
- type Obj = Record<string, unknown>;
25
- export declare function isObj(value: unknown): value is Obj;
26
- export declare function nonEmptyString(value: unknown): string | undefined;
27
- /** A non-empty string id, or a finite number id stringified (user ids are numbers). */
28
- export declare function idString(value: unknown): string | undefined;
29
- /** A finite number given as a number or a numeric string (ClickUp sends both); else null. */
30
- export declare function finiteNumber(value: unknown): number | null;
31
- /** ISO instant of an epoch-millisecond string or number; null when absent or unreadable. */
32
- export declare function epochToIso(value: unknown): string | null;
33
- /** `https://app.clickup.com/t/<id>`: the task URL shape ClickUp returns (no workspace segment). */
34
- export declare function taskUrl(id: string): string;
35
- /** Normalize a bare task or a write envelope; null when neither carries an id. */
36
- export declare function unwrapTask(resp: unknown): ClickUpTaskView | null;
37
- /**
38
- * Call a ClickUp MCP tool and turn a resolved failure (`{error}` without
39
- * `success: true`, or `success: false`) into a thrown error, so every verb
40
- * handles a resolved and a thrown failure the same way.
41
- */
42
- export declare function callTool(mcp: McpCaller, tool: string, args: Obj): Promise<unknown>;
43
- export {};
44
- //# sourceMappingURL=envelope.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAElD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED,uFAAuF;AACvF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG3D;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAK1D;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED,mGAAmG;AACnG,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAsChE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAUxF"}
package/dist/envelope.js DELETED
@@ -1,95 +0,0 @@
1
- /**
2
- * Response shapes of the ClickUp MCP. Writes return an envelope
3
- * `{success, task_id, custom_id, task_url}`; `clickup_get_task` returns a bare,
4
- * flat task; failures are `{"error": "<text>"}`, either thrown or resolved.
5
- */
6
- export function isObj(value) {
7
- return typeof value === "object" && value !== null && !Array.isArray(value);
8
- }
9
- export function nonEmptyString(value) {
10
- return typeof value === "string" && value !== "" ? value : undefined;
11
- }
12
- /** A non-empty string id, or a finite number id stringified (user ids are numbers). */
13
- export function idString(value) {
14
- if (typeof value === "number" && Number.isFinite(value))
15
- return String(value);
16
- return nonEmptyString(value);
17
- }
18
- /** A finite number given as a number or a numeric string (ClickUp sends both); else null. */
19
- export function finiteNumber(value) {
20
- if (typeof value !== "string" && typeof value !== "number")
21
- return null;
22
- if (value === "")
23
- return null;
24
- const n = Number(value);
25
- return Number.isFinite(n) ? n : null;
26
- }
27
- /** ISO instant of an epoch-millisecond string or number; null when absent or unreadable. */
28
- export function epochToIso(value) {
29
- const ms = finiteNumber(value);
30
- return ms === null ? null : new Date(ms).toISOString();
31
- }
32
- /** `https://app.clickup.com/t/<id>`: the task URL shape ClickUp returns (no workspace segment). */
33
- export function taskUrl(id) {
34
- return `https://app.clickup.com/t/${id}`;
35
- }
36
- /** Normalize a bare task or a write envelope; null when neither carries an id. */
37
- export function unwrapTask(resp) {
38
- if (!isObj(resp))
39
- return null;
40
- const id = nonEmptyString(resp.id) ?? nonEmptyString(resp.task_id);
41
- if (id === undefined)
42
- return null;
43
- const url = nonEmptyString(resp.url) ?? nonEmptyString(resp.task_url);
44
- const status = nonEmptyString(resp.status);
45
- const listId = isObj(resp.list) ? idString(resp.list.id) : undefined;
46
- const assigneeIds = Array.isArray(resp.assignees)
47
- ? resp.assignees.flatMap((a) => {
48
- const aid = isObj(a) ? idString(a.id) : undefined;
49
- return aid === undefined ? [] : [aid];
50
- })
51
- : [];
52
- const tagNames = Array.isArray(resp.tags)
53
- ? resp.tags.flatMap((t) => {
54
- const name = isObj(t) ? nonEmptyString(t.name) : undefined;
55
- return name === undefined ? [] : [name];
56
- })
57
- : [];
58
- let subtaskCount = 0;
59
- if (typeof resp.subtasks_count === "number")
60
- subtaskCount = resp.subtasks_count;
61
- else if (Array.isArray(resp.subtasks))
62
- subtaskCount = resp.subtasks.length;
63
- const spaceId = isObj(resp.space) ? idString(resp.space.id) : undefined;
64
- return {
65
- id,
66
- ...(url !== undefined ? { url } : {}),
67
- ...(status !== undefined ? { status } : {}),
68
- ...(listId !== undefined ? { listId } : {}),
69
- parentId: nonEmptyString(resp.parent) ?? null,
70
- assigneeIds,
71
- tagNames,
72
- dueDate: epochToIso(resp.due_date),
73
- subtaskCount,
74
- ...(spaceId !== undefined ? { spaceId } : {}),
75
- timeEstimateMs: finiteNumber(resp.time_estimate),
76
- };
77
- }
78
- /**
79
- * Call a ClickUp MCP tool and turn a resolved failure (`{error}` without
80
- * `success: true`, or `success: false`) into a thrown error, so every verb
81
- * handles a resolved and a thrown failure the same way.
82
- */
83
- export async function callTool(mcp, tool, args) {
84
- const resp = await mcp(tool, args);
85
- if (isObj(resp)) {
86
- if ("error" in resp && resp.success !== true) {
87
- const err = resp.error;
88
- throw new Error(typeof err === "string" ? err : JSON.stringify(err));
89
- }
90
- if (resp.success === false)
91
- throw new Error(`${tool} reported success: false`);
92
- }
93
- return resp;
94
- }
95
- //# sourceMappingURL=envelope.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"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"}
package/dist/errors.d.ts DELETED
@@ -1,30 +0,0 @@
1
- /**
2
- * Error helpers shared by the ClickUp transport verbs. Details carry the server
3
- * message only: request arguments (names, descriptions, tokens) are never echoed.
4
- */
5
- import type { TransportErrorCode } from "@llodev/pm-tasks-core/runtime";
6
- export interface TransportFailure {
7
- ok: false;
8
- code: TransportErrorCode;
9
- details: Record<string, unknown>;
10
- }
11
- /**
12
- * Classify a thrown error (or a resolved `{error}` already turned into one by
13
- * `callTool`) into a TransportErrorCode. Status codes match as whole words, so an
14
- * id that merely contains "404" is not a 404. "Status does not exist" stays
15
- * MCP_ERROR here: the status verbs map it to INVALID_REQUEST `status_rejected`.
16
- */
17
- export declare function classifyError(e: unknown): {
18
- code: TransportErrorCode;
19
- details: Record<string, unknown>;
20
- };
21
- /** The MCP answered, but not with the shape the verb needs. */
22
- export declare function shapeError(verb: string): TransportFailure;
23
- /**
24
- * A request ClickUp cannot honor. `reason` is a stable machine-readable token.
25
- * `extra` carries ids and pinned status names from config or a task read (such
26
- * as `listId`, `status`, `role`), never request arguments; it cannot replace
27
- * `verb`, `reason` or `message`.
28
- */
29
- export declare function invalidRequest(verb: string, reason: string, message: string, extra?: Record<string, unknown>): TransportFailure;
30
- //# sourceMappingURL=errors.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAaD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG;IACzC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAmBA;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,gBAAgB,CAElB"}
package/dist/errors.js DELETED
@@ -1,60 +0,0 @@
1
- /**
2
- * Error helpers shared by the ClickUp transport verbs. Details carry the server
3
- * message only: request arguments (names, descriptions, tokens) are never echoed.
4
- */
5
- function messageOf(e) {
6
- if (e instanceof Error)
7
- return e.message;
8
- if (typeof e === "string")
9
- return e;
10
- if (typeof e === "object" && e !== null) {
11
- const { error, message } = e;
12
- if (typeof error === "string")
13
- return error;
14
- if (typeof message === "string")
15
- return message;
16
- }
17
- return String(e);
18
- }
19
- /**
20
- * Classify a thrown error (or a resolved `{error}` already turned into one by
21
- * `callTool`) into a TransportErrorCode. Status codes match as whole words, so an
22
- * id that merely contains "404" is not a 404. "Status does not exist" stays
23
- * MCP_ERROR here: the status verbs map it to INVALID_REQUEST `status_rejected`.
24
- */
25
- export function classifyError(e) {
26
- const message = messageOf(e);
27
- const msg = message.toLowerCase();
28
- let code = "MCP_ERROR";
29
- // ClickUp auth failures also read "not authorized", "Oauth token not found" or
30
- // carry an `OAUTH_<n>` code; checked before "not found" so they stay AUTH.
31
- if (/\b(401|403)\b/.test(msg) ||
32
- ["unauthorized", "forbidden", "not authorized", "token not found", "oauth_"].some((s) => msg.includes(s))) {
33
- code = "AUTH_ERROR";
34
- }
35
- else if (/\b429\b/.test(msg) || msg.includes("rate limit")) {
36
- code = "RATE_LIMITED";
37
- }
38
- else if (/\b404\b/.test(msg) || msg.includes("not found")) {
39
- code = "NOT_FOUND";
40
- }
41
- return { code, details: { message } };
42
- }
43
- /** The MCP answered, but not with the shape the verb needs. */
44
- export function shapeError(verb) {
45
- return {
46
- ok: false,
47
- code: "MCP_ERROR",
48
- details: { message: "ClickUp MCP returned an unexpected response shape", verb },
49
- };
50
- }
51
- /**
52
- * A request ClickUp cannot honor. `reason` is a stable machine-readable token.
53
- * `extra` carries ids and pinned status names from config or a task read (such
54
- * as `listId`, `status`, `role`), never request arguments; it cannot replace
55
- * `verb`, `reason` or `message`.
56
- */
57
- export function invalidRequest(verb, reason, message, extra = {}) {
58
- return { ok: false, code: "INVALID_REQUEST", details: { ...extra, verb, reason, message } };
59
- }
60
- //# sourceMappingURL=errors.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,YAAY,KAAK;QAAE,OAAO,CAAC,CAAC,OAAO,CAAC;IACzC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAA2C,CAAC;QACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,CAAU;IAItC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,IAAI,GAAuB,WAAW,CAAC;IAC3C,+EAA+E;IAC/E,2EAA2E;IAC3E,IACE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;QACzB,CAAC,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACtF,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAChB,EACD,CAAC;QACD,IAAI,GAAG,YAAY,CAAC;IACtB,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7D,IAAI,GAAG,cAAc,CAAC;IACxB,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,IAAI,GAAG,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;AACxC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE,IAAI,EAAE;KAChF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,MAAc,EACd,OAAe,EACf,QAAiC,EAAE;IAEnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;AAC9F,CAAC"}
@@ -1,20 +0,0 @@
1
- /** Hours in one ideal day when `estimation.hoursPerDay` is unset (core's focused day). */
2
- export declare const DEFAULT_HOURS_PER_DAY = 6;
3
- /**
4
- * Core's normalizeEstimate yields a time only for these strategies, so only they
5
- * can target ClickUp's native time estimate; every other strategy yields points.
6
- */
7
- export declare const TIME_STRATEGIES: ReadonlySet<unknown>;
8
- /**
9
- * Minutes in `<n>m`, `<n>h` or `<n>d` (one day is `hoursPerDay` hours), rounded to a
10
- * whole minute: `"2h"` → 120, `"1.5d"` at 6 hours a day → 540. NaN for any other form
11
- * (a negative, NaN, Infinity or an exponent such as `1e-9h`); the caller rejects a
12
- * result that is not a positive whole number.
13
- */
14
- export declare function toMinutes(timeString: string, hoursPerDay: number): number;
15
- /**
16
- * A tag-safe slug: lowercase, runs of anything but [a-z0-9] become one "-", no
17
- * leading or trailing "-". `"1.5 ideal days"` → `"1-5-ideal-days"`.
18
- */
19
- export declare function slugify(s: string): string;
20
- //# sourceMappingURL=estimation.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"estimation.d.ts","sourceRoot":"","sources":["../src/estimation.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,OAAO,CAG/C,CAAC;AAOH;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzE;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASzC"}
@@ -1,40 +0,0 @@
1
- /** Hours in one ideal day when `estimation.hoursPerDay` is unset (core's focused day). */
2
- export const DEFAULT_HOURS_PER_DAY = 6;
3
- /**
4
- * Core's normalizeEstimate yields a time only for these strategies, so only they
5
- * can target ClickUp's native time estimate; every other strategy yields points.
6
- */
7
- export const TIME_STRATEGIES = new Set([
8
- "ideal_hours",
9
- "ideal_days",
10
- ]);
11
- /** The time strings core's normalizeEstimate emits (`<n>h`, `<n>d`), plus minutes. */
12
- const TIME_STRING = /^(\d+(?:\.\d+)?)([mhd])$/;
13
- const UNIT_MINUTES = { m: 1, h: 60 };
14
- /**
15
- * Minutes in `<n>m`, `<n>h` or `<n>d` (one day is `hoursPerDay` hours), rounded to a
16
- * whole minute: `"2h"` → 120, `"1.5d"` at 6 hours a day → 540. NaN for any other form
17
- * (a negative, NaN, Infinity or an exponent such as `1e-9h`); the caller rejects a
18
- * result that is not a positive whole number.
19
- */
20
- export function toMinutes(timeString, hoursPerDay) {
21
- const match = TIME_STRING.exec(timeString);
22
- if (!match)
23
- return Number.NaN;
24
- const unit = match[2];
25
- const perUnit = unit === "d" ? hoursPerDay * 60 : UNIT_MINUTES[unit];
26
- return Math.round(Number(match[1]) * perUnit);
27
- }
28
- /**
29
- * A tag-safe slug: lowercase, runs of anything but [a-z0-9] become one "-", no
30
- * leading or trailing "-". `"1.5 ideal days"` → `"1-5-ideal-days"`.
31
- */
32
- export function slugify(s) {
33
- return (s
34
- .toLowerCase()
35
- .replace(/[^a-z0-9]+/g, "-")
36
- // The previous replace already collapsed runs to one dash, so no `+` here
37
- // (avoids polynomial ReDoS).
38
- .replace(/^-|-$/g, ""));
39
- }
40
- //# sourceMappingURL=estimation.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"estimation.js","sourceRoot":"","sources":["../src/estimation.ts"],"names":[],"mappings":"AAMA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB,IAAI,GAAG,CAAqB;IAC/E,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AAEH,sFAAsF;AACtF,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAW,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,WAAmB;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAoB,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,OAAO,CACL,CAAC;SACE,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;QAC5B,0EAA0E;QAC1E,6BAA6B;SAC5B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CACzB,CAAC;AACJ,CAAC"}
package/dist/index.d.ts DELETED
@@ -1,5 +0,0 @@
1
- export { createClickUpTransport } from "./transport-clickup.js";
2
- export type { McpCaller, ClickUpConfig, ClickUpListConfig, ClickUpEstimationConfig, ClickUpTaskEstimateSetRequest, ClickUpTransport, CreateClickUpTransportOptions, } from "./transport-clickup.js";
3
- export { createAdapter } from "./adapter.js";
4
- export type { CreateAdapterOptions } from "./adapter.js";
5
- //# sourceMappingURL=index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}
package/dist/index.js DELETED
@@ -1,3 +0,0 @@
1
- export { createClickUpTransport } from "./transport-clickup.js";
2
- export { createAdapter } from "./adapter.js";
3
- //# sourceMappingURL=index.js.map
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAUhE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}
@@ -1,67 +0,0 @@
1
- /**
2
- * Read-only discovery for `init` and `doctor`: workspaces, lists (with their
3
- * space and folder), list statuses and members. One interface, two sources:
4
- * the ClickUp MCP inside an agent session, and the REST API v2 with a personal
5
- * token in a terminal. Nothing here prompts, writes or logs.
6
- */
7
- import type { ClickUpStatus } from "./status-map.js";
8
- import type { McpCaller } from "./transport-clickup.js";
9
- export interface ClickUpWorkspace {
10
- id: string;
11
- name: string;
12
- }
13
- export interface ClickUpListSummary {
14
- id: string;
15
- name: string;
16
- space: {
17
- id: string;
18
- name: string;
19
- };
20
- /** Absent for a folderless list (ClickUp's hidden container is never a folder). */
21
- folder?: {
22
- id: string;
23
- name: string;
24
- };
25
- }
26
- export interface ClickUpMember {
27
- id: string;
28
- name: string;
29
- email?: string;
30
- }
31
- export interface ClickUpInitApi {
32
- getWorkspaces(): Promise<ClickUpWorkspace[]>;
33
- /** Every non-archived list of the workspace: folder lists, then folderless lists, per space. */
34
- getLists(workspaceId: string): Promise<ClickUpListSummary[]>;
35
- getListStatuses(listId: string): Promise<ClickUpStatus[]>;
36
- getMembers(workspaceId: string): Promise<ClickUpMember[]>;
37
- }
38
- /**
39
- * - `AUTH`: the token is malformed, or the API answered 401/403.
40
- * - `RATE_LIMIT`: the API answered 429.
41
- * - `HTTP`: any other non-2xx answer (`status` holds the code).
42
- * - `NETWORK`: the request failed or timed out.
43
- * - `PARSE`: the answer is not JSON or lacks the expected shape.
44
- * - `INVALID_ID`: an id meant for a URL path is not a digit string.
45
- * - `NOT_FOUND`: the workspace is not among the token's workspaces.
46
- *
47
- * Messages never carry the token, a response body, a name or an id.
48
- */
49
- export type ClickUpInitErrorCode = "AUTH" | "RATE_LIMIT" | "HTTP" | "NETWORK" | "PARSE" | "INVALID_ID" | "NOT_FOUND";
50
- export declare class ClickUpInitError extends Error {
51
- readonly code: ClickUpInitErrorCode;
52
- readonly status?: number;
53
- constructor(code: ClickUpInitErrorCode, message: string, status?: number);
54
- }
55
- /**
56
- * REST discovery with a personal token. The token is sent only as the raw
57
- * `Authorization` header value (no `Bearer`), only on GET requests to the
58
- * ClickUp API; it is never logged, put in a URL, returned or echoed in an error.
59
- * Default requests return non-archived items only, which is what `init` offers.
60
- */
61
- export declare function createRestInitApi(token: string, fetchFn?: typeof fetch): ClickUpInitApi;
62
- /**
63
- * MCP discovery. The session is bound to one workspace: the hierarchy root.
64
- * `workspace_id` is passed where the call is workspace-scoped (lists, members).
65
- */
66
- export declare function createMcpInitApi(mcp: McpCaller): ClickUpInitApi;
67
- //# sourceMappingURL=init-api.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"init-api.d.ts","sourceRoot":"","sources":["../src/init-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,mFAAmF;IACnF,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7C,gGAAgG;IAChG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC7D,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1D,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAC9B,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,CAAC;AAEpF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAMzE;AAoGD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,GAAG,cAAc,CA4GvF;AAsBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,cAAc,CA0D/D"}