@omnicoreos/planka-mcp 0.2.0 → 0.3.0

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 (195) hide show
  1. package/.agents/plugins/marketplace.json +20 -0
  2. package/.claude-plugin/marketplace.json +26 -0
  3. package/.claude-plugin/plugin.json +45 -0
  4. package/.codex-plugin/mcp.json +16 -0
  5. package/.codex-plugin/plugin.json +27 -0
  6. package/.mcp.json +17 -0
  7. package/CHANGELOG.md +510 -0
  8. package/README.es.md +294 -55
  9. package/README.md +293 -55
  10. package/dist/cli/init.d.ts +101 -0
  11. package/dist/cli/init.d.ts.map +1 -0
  12. package/dist/cli/init.js +481 -0
  13. package/dist/cli/init.js.map +1 -0
  14. package/dist/client.d.ts +32 -4
  15. package/dist/client.d.ts.map +1 -1
  16. package/dist/client.js +106 -32
  17. package/dist/client.js.map +1 -1
  18. package/dist/config/policy.d.ts +82 -0
  19. package/dist/config/policy.d.ts.map +1 -0
  20. package/dist/config/policy.js +226 -0
  21. package/dist/config/policy.js.map +1 -0
  22. package/dist/errors.d.ts +5 -1
  23. package/dist/errors.d.ts.map +1 -1
  24. package/dist/errors.js +62 -5
  25. package/dist/errors.js.map +1 -1
  26. package/dist/identity.generated.d.ts +2 -1
  27. package/dist/identity.generated.d.ts.map +1 -1
  28. package/dist/identity.generated.js +2 -1
  29. package/dist/identity.generated.js.map +1 -1
  30. package/dist/index.js +85 -10
  31. package/dist/index.js.map +1 -1
  32. package/dist/instructions.d.ts +21 -0
  33. package/dist/instructions.d.ts.map +1 -0
  34. package/dist/instructions.js +37 -0
  35. package/dist/instructions.js.map +1 -0
  36. package/dist/operations/actions.d.ts +654 -0
  37. package/dist/operations/actions.d.ts.map +1 -0
  38. package/dist/operations/actions.js +154 -0
  39. package/dist/operations/actions.js.map +1 -0
  40. package/dist/operations/archive.d.ts +28 -0
  41. package/dist/operations/archive.d.ts.map +1 -0
  42. package/dist/operations/archive.js +74 -0
  43. package/dist/operations/archive.js.map +1 -0
  44. package/dist/operations/attachments.d.ts +1 -1
  45. package/dist/operations/attachments.d.ts.map +1 -1
  46. package/dist/operations/attachments.js +3 -1
  47. package/dist/operations/attachments.js.map +1 -1
  48. package/dist/operations/board-id.d.ts +1 -1
  49. package/dist/operations/board-id.d.ts.map +1 -1
  50. package/dist/operations/board-id.js +13 -7
  51. package/dist/operations/board-id.js.map +1 -1
  52. package/dist/operations/boards.d.ts +96 -19
  53. package/dist/operations/boards.d.ts.map +1 -1
  54. package/dist/operations/boards.js +377 -93
  55. package/dist/operations/boards.js.map +1 -1
  56. package/dist/operations/card-brief.d.ts +91 -0
  57. package/dist/operations/card-brief.d.ts.map +1 -0
  58. package/dist/operations/card-brief.js +79 -0
  59. package/dist/operations/card-brief.js.map +1 -0
  60. package/dist/operations/cards.d.ts +34 -9
  61. package/dist/operations/cards.d.ts.map +1 -1
  62. package/dist/operations/cards.js +60 -14
  63. package/dist/operations/cards.js.map +1 -1
  64. package/dist/operations/comments.d.ts +61 -4
  65. package/dist/operations/comments.d.ts.map +1 -1
  66. package/dist/operations/comments.js +91 -8
  67. package/dist/operations/comments.js.map +1 -1
  68. package/dist/operations/duplicate.d.ts +16 -0
  69. package/dist/operations/duplicate.d.ts.map +1 -0
  70. package/dist/operations/duplicate.js +43 -0
  71. package/dist/operations/duplicate.js.map +1 -0
  72. package/dist/operations/labels.d.ts +1 -1
  73. package/dist/operations/labels.d.ts.map +1 -1
  74. package/dist/operations/labels.js +7 -4
  75. package/dist/operations/labels.js.map +1 -1
  76. package/dist/operations/lists.d.ts +63 -1
  77. package/dist/operations/lists.d.ts.map +1 -1
  78. package/dist/operations/lists.js +97 -2
  79. package/dist/operations/lists.js.map +1 -1
  80. package/dist/operations/members.d.ts +39 -0
  81. package/dist/operations/members.d.ts.map +1 -0
  82. package/dist/operations/members.js +107 -0
  83. package/dist/operations/members.js.map +1 -0
  84. package/dist/operations/projects.d.ts +16 -0
  85. package/dist/operations/projects.d.ts.map +1 -1
  86. package/dist/operations/projects.js +54 -9
  87. package/dist/operations/projects.js.map +1 -1
  88. package/dist/operations/tasks.d.ts +1 -1
  89. package/dist/operations/tasks.d.ts.map +1 -1
  90. package/dist/operations/tasks.js +5 -3
  91. package/dist/operations/tasks.js.map +1 -1
  92. package/dist/operations/users.d.ts +123 -0
  93. package/dist/operations/users.d.ts.map +1 -0
  94. package/dist/operations/users.js +180 -0
  95. package/dist/operations/users.js.map +1 -0
  96. package/dist/operations/verify.d.ts +84 -0
  97. package/dist/operations/verify.d.ts.map +1 -0
  98. package/dist/operations/verify.js +124 -0
  99. package/dist/operations/verify.js.map +1 -0
  100. package/dist/prompts.d.ts +48 -0
  101. package/dist/prompts.d.ts.map +1 -0
  102. package/dist/prompts.js +155 -0
  103. package/dist/prompts.js.map +1 -0
  104. package/dist/resources.d.ts +38 -0
  105. package/dist/resources.d.ts.map +1 -0
  106. package/dist/resources.js +127 -0
  107. package/dist/resources.js.map +1 -0
  108. package/dist/schemas/entities.d.ts +115 -24
  109. package/dist/schemas/entities.d.ts.map +1 -1
  110. package/dist/schemas/entities.js +48 -0
  111. package/dist/schemas/entities.js.map +1 -1
  112. package/dist/schemas/requests.d.ts +121 -46
  113. package/dist/schemas/requests.d.ts.map +1 -1
  114. package/dist/schemas/requests.js +57 -12
  115. package/dist/schemas/requests.js.map +1 -1
  116. package/dist/schemas/responses.d.ts +541 -186
  117. package/dist/schemas/responses.d.ts.map +1 -1
  118. package/dist/schemas/responses.js +13 -2
  119. package/dist/schemas/responses.js.map +1 -1
  120. package/dist/tools/activity.d.ts +150 -0
  121. package/dist/tools/activity.d.ts.map +1 -0
  122. package/dist/tools/activity.js +198 -0
  123. package/dist/tools/activity.js.map +1 -0
  124. package/dist/tools/annotations.d.ts +52 -0
  125. package/dist/tools/annotations.d.ts.map +1 -0
  126. package/dist/tools/annotations.js +214 -0
  127. package/dist/tools/annotations.js.map +1 -0
  128. package/dist/tools/attachments.d.ts +28 -4
  129. package/dist/tools/attachments.d.ts.map +1 -1
  130. package/dist/tools/attachments.js +53 -34
  131. package/dist/tools/attachments.js.map +1 -1
  132. package/dist/tools/card-ops.d.ts +232 -0
  133. package/dist/tools/card-ops.d.ts.map +1 -0
  134. package/dist/tools/card-ops.js +333 -0
  135. package/dist/tools/card-ops.js.map +1 -0
  136. package/dist/tools/cards.d.ts +90 -8
  137. package/dist/tools/cards.d.ts.map +1 -1
  138. package/dist/tools/cards.js +411 -128
  139. package/dist/tools/cards.js.map +1 -1
  140. package/dist/tools/comments.d.ts +226 -22
  141. package/dist/tools/comments.d.ts.map +1 -1
  142. package/dist/tools/comments.js +163 -134
  143. package/dist/tools/comments.js.map +1 -1
  144. package/dist/tools/dispatch.d.ts +47 -0
  145. package/dist/tools/dispatch.d.ts.map +1 -0
  146. package/dist/tools/dispatch.js +63 -0
  147. package/dist/tools/dispatch.js.map +1 -0
  148. package/dist/tools/guard.d.ts +9 -0
  149. package/dist/tools/guard.d.ts.map +1 -0
  150. package/dist/tools/guard.js +20 -0
  151. package/dist/tools/guard.js.map +1 -0
  152. package/dist/tools/index.d.ts +748 -450
  153. package/dist/tools/index.d.ts.map +1 -1
  154. package/dist/tools/index.js +136 -17
  155. package/dist/tools/index.js.map +1 -1
  156. package/dist/tools/labels.d.ts +213 -18
  157. package/dist/tools/labels.d.ts.map +1 -1
  158. package/dist/tools/labels.js +218 -203
  159. package/dist/tools/labels.js.map +1 -1
  160. package/dist/tools/lists.d.ts +222 -15
  161. package/dist/tools/lists.d.ts.map +1 -1
  162. package/dist/tools/lists.js +175 -156
  163. package/dist/tools/lists.js.map +1 -1
  164. package/dist/tools/members.d.ts +128 -0
  165. package/dist/tools/members.d.ts.map +1 -0
  166. package/dist/tools/members.js +150 -0
  167. package/dist/tools/members.js.map +1 -0
  168. package/dist/tools/navigation.d.ts +22 -2
  169. package/dist/tools/navigation.d.ts.map +1 -1
  170. package/dist/tools/navigation.js +60 -15
  171. package/dist/tools/navigation.js.map +1 -1
  172. package/dist/tools/queries.d.ts +196 -166
  173. package/dist/tools/queries.d.ts.map +1 -1
  174. package/dist/tools/queries.js +125 -155
  175. package/dist/tools/queries.js.map +1 -1
  176. package/dist/tools/tasks.d.ts +26 -6
  177. package/dist/tools/tasks.d.ts.map +1 -1
  178. package/dist/tools/tasks.js +110 -55
  179. package/dist/tools/tasks.js.map +1 -1
  180. package/dist/tools/users.d.ts +130 -0
  181. package/dist/tools/users.d.ts.map +1 -0
  182. package/dist/tools/users.js +165 -0
  183. package/dist/tools/users.js.map +1 -0
  184. package/docs/planka-2x-gotchas.md +121 -5
  185. package/docs/tools.md +771 -187
  186. package/docs/troubleshooting.md +137 -5
  187. package/hooks/hooks.json +15 -0
  188. package/hooks/preflight.mjs +100 -0
  189. package/package.json +6 -1
  190. package/scripts/setup.sh +8 -26
  191. package/scripts/sync-identity.mjs +55 -1
  192. package/server.json +87 -6
  193. package/tests/smoke/planka-smoke.mjs +512 -72
  194. package/workflow/skills/planka-close-card/SKILL.md +18 -5
  195. package/workflow/skills/planka-orchestrator/SKILL.md +36 -7
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "planka-mcp",
3
+ "interface": {
4
+ "displayName": "Planka MCP"
5
+ },
6
+ "plugins": [
7
+ {
8
+ "name": "planka",
9
+ "source": {
10
+ "source": "local",
11
+ "path": "./"
12
+ },
13
+ "policy": {
14
+ "installation": "AVAILABLE",
15
+ "authentication": "ON_INSTALL"
16
+ },
17
+ "category": "Productivity"
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "planka-mcp",
3
+ "description": "The planka-mcp repository as its own Claude Code marketplace.",
4
+ "owner": {
5
+ "name": "planka-mcp contributors",
6
+ "url": "https://github.com/omnicoreos/planka-mcp"
7
+ },
8
+ "plugins": [
9
+ {
10
+ "name": "planka",
11
+ "source": "./",
12
+ "description": "Planka 2.x kanban over MCP, with the optional board workflow as skills.",
13
+ "version": "0.3.0",
14
+ "displayName": "Planka",
15
+ "homepage": "https://github.com/omnicoreos/planka-mcp#readme",
16
+ "repository": "https://github.com/omnicoreos/planka-mcp",
17
+ "license": "MIT",
18
+ "category": "Productivity",
19
+ "keywords": [
20
+ "planka",
21
+ "kanban",
22
+ "mcp"
23
+ ]
24
+ }
25
+ ]
26
+ }
@@ -0,0 +1,45 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
3
+ "name": "planka",
4
+ "displayName": "Planka",
5
+ "version": "0.3.0",
6
+ "description": "Planka 2.x kanban over MCP: digest-first reads, verified writes, and the optional board workflow as skills.",
7
+ "author": {
8
+ "name": "planka-mcp contributors",
9
+ "url": "https://github.com/omnicoreos/planka-mcp"
10
+ },
11
+ "homepage": "https://github.com/omnicoreos/planka-mcp#readme",
12
+ "repository": "https://github.com/omnicoreos/planka-mcp",
13
+ "license": "MIT",
14
+ "keywords": [
15
+ "planka",
16
+ "kanban",
17
+ "mcp",
18
+ "board",
19
+ "workflow"
20
+ ],
21
+ "skills": "./workflow/skills/",
22
+ "mcpServers": "./.mcp.json",
23
+ "hooks": "./hooks/hooks.json",
24
+ "userConfig": {
25
+ "planka_base_url": {
26
+ "type": "string",
27
+ "title": "Planka base URL",
28
+ "description": "Origin of your Planka instance, e.g. https://planka.example.com. Use the final https:// URL: an http:// redirect drops POST bodies.",
29
+ "required": true
30
+ },
31
+ "planka_api_key": {
32
+ "type": "string",
33
+ "title": "Planka API key",
34
+ "description": "API key of the agent user (X-Api-Key). An admin creates it with POST /api/users/<id>/api-key and it is shown only once. Leave empty to fall back to PLANKA_AGENT_EMAIL + PLANKA_AGENT_PASSWORD in your environment.",
35
+ "sensitive": true,
36
+ "required": false
37
+ },
38
+ "planka_default_board_id": {
39
+ "type": "string",
40
+ "title": "Default board ID",
41
+ "description": "Optional. Board used when a tool call omits boardId, so the agent stops spending a call to recover an ID that never changes.",
42
+ "required": false
43
+ }
44
+ }
45
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "mcp_servers": {
3
+ "planka": {
4
+ "command": "npx",
5
+ "args": [
6
+ "-y",
7
+ "@omnicoreos/planka-mcp@0.3.0"
8
+ ],
9
+ "env": {
10
+ "PLANKA_BASE_URL": "${PLANKA_BASE_URL}",
11
+ "PLANKA_API_KEY": "${PLANKA_API_KEY}",
12
+ "PLANKA_DEFAULT_BOARD_ID": "${PLANKA_DEFAULT_BOARD_ID}"
13
+ }
14
+ }
15
+ }
16
+ }
@@ -0,0 +1,27 @@
1
+ {
2
+ "name": "planka",
3
+ "version": "0.3.0",
4
+ "description": "Planka 2.x kanban over MCP: digest-first reads, verified writes, and the optional board workflow as skills.",
5
+ "author": {
6
+ "name": "planka-mcp contributors",
7
+ "url": "https://github.com/omnicoreos/planka-mcp"
8
+ },
9
+ "homepage": "https://github.com/omnicoreos/planka-mcp#readme",
10
+ "repository": "https://github.com/omnicoreos/planka-mcp",
11
+ "license": "MIT",
12
+ "keywords": [
13
+ "planka",
14
+ "kanban",
15
+ "mcp"
16
+ ],
17
+ "skills": "./workflow/skills/",
18
+ "mcpServers": "./.codex-plugin/mcp.json",
19
+ "interface": {
20
+ "displayName": "Planka",
21
+ "shortDescription": "Planka kanban boards over MCP",
22
+ "longDescription": "Reads a Planka 2.x board as digests instead of dumps, re-reads every write to report what actually landed, and ships the optional director/worker board workflow as skills.",
23
+ "developerName": "planka-mcp contributors",
24
+ "category": "Productivity",
25
+ "websiteURL": "https://github.com/omnicoreos/planka-mcp"
26
+ }
27
+ }
package/.mcp.json ADDED
@@ -0,0 +1,17 @@
1
+ {
2
+ "mcpServers": {
3
+ "planka": {
4
+ "type": "stdio",
5
+ "command": "npx",
6
+ "args": [
7
+ "-y",
8
+ "@omnicoreos/planka-mcp@0.3.0"
9
+ ],
10
+ "env": {
11
+ "PLANKA_BASE_URL": "${user_config.planka_base_url}",
12
+ "PLANKA_API_KEY": "${user_config.planka_api_key}",
13
+ "PLANKA_DEFAULT_BOARD_ID": "${user_config.planka_default_board_id}"
14
+ }
15
+ }
16
+ }
17
+ }