mdcontext 0.0.1 → 0.2.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 (337) hide show
  1. package/.changeset/README.md +28 -0
  2. package/.changeset/config.json +11 -0
  3. package/.claude/settings.local.json +25 -0
  4. package/.github/workflows/ci.yml +83 -0
  5. package/.github/workflows/claude-code-review.yml +44 -0
  6. package/.github/workflows/claude.yml +85 -0
  7. package/.github/workflows/release.yml +113 -0
  8. package/.tldrignore +112 -0
  9. package/BACKLOG.md +338 -0
  10. package/CONTRIBUTING.md +186 -0
  11. package/NOTES/NOTES +44 -0
  12. package/README.md +434 -11
  13. package/biome.json +36 -0
  14. package/cspell.config.yaml +14 -0
  15. package/dist/chunk-23UPXDNL.js +3044 -0
  16. package/dist/chunk-2W7MO2DL.js +1366 -0
  17. package/dist/chunk-3NUAZGMA.js +1689 -0
  18. package/dist/chunk-7TOWB2XB.js +366 -0
  19. package/dist/chunk-7XOTOADQ.js +3065 -0
  20. package/dist/chunk-AH2PDM2K.js +3042 -0
  21. package/dist/chunk-BNXWSZ63.js +3742 -0
  22. package/dist/chunk-BTL5DJVU.js +3222 -0
  23. package/dist/chunk-HDHYG7E4.js +104 -0
  24. package/dist/chunk-HLR4KZBP.js +3234 -0
  25. package/dist/chunk-IP3FRFEB.js +1045 -0
  26. package/dist/chunk-KHU56VDO.js +3042 -0
  27. package/dist/chunk-KRYIFLQR.js +88 -0
  28. package/dist/chunk-LBSDNLEM.js +287 -0
  29. package/dist/chunk-MNTQ7HCP.js +2643 -0
  30. package/dist/chunk-MUJELQQ6.js +1387 -0
  31. package/dist/chunk-MXJGMSLV.js +2199 -0
  32. package/dist/chunk-N6QJGC3Z.js +2636 -0
  33. package/dist/chunk-OBELGBPM.js +1713 -0
  34. package/dist/chunk-OT7R5XTA.js +3192 -0
  35. package/dist/chunk-P7X4RA2T.js +106 -0
  36. package/dist/chunk-PIDUQNC2.js +3185 -0
  37. package/dist/chunk-POGCDIH4.js +3187 -0
  38. package/dist/chunk-PSIEOQGZ.js +3043 -0
  39. package/dist/chunk-PVRT3IHA.js +3238 -0
  40. package/dist/chunk-QNN4TT23.js +1430 -0
  41. package/dist/chunk-RE3R45RJ.js +3042 -0
  42. package/dist/chunk-S7E6TFX6.js +803 -0
  43. package/dist/chunk-SG6GLU4U.js +1378 -0
  44. package/dist/chunk-SJCDV2ST.js +274 -0
  45. package/dist/chunk-SYE5XLF3.js +104 -0
  46. package/dist/chunk-T5VLYBZD.js +103 -0
  47. package/dist/chunk-TOQB7VWU.js +3238 -0
  48. package/dist/chunk-VFNMZ4ZQ.js +3228 -0
  49. package/dist/chunk-VVTGZNBT.js +1629 -0
  50. package/dist/chunk-W7Q4RFEV.js +104 -0
  51. package/dist/chunk-XTYYVRLO.js +3190 -0
  52. package/dist/chunk-Y6MDYVJD.js +3063 -0
  53. package/dist/cli/main.d.ts +1 -0
  54. package/dist/cli/main.js +5458 -0
  55. package/dist/index.d.ts +653 -0
  56. package/dist/index.js +79 -0
  57. package/dist/mcp/server.d.ts +1 -0
  58. package/dist/mcp/server.js +472 -0
  59. package/dist/schema-BAWSG7KY.js +22 -0
  60. package/dist/schema-E3QUPL26.js +20 -0
  61. package/dist/schema-EHL7WUT6.js +20 -0
  62. package/docs/019-USAGE.md +625 -0
  63. package/docs/020-current-implementation.md +364 -0
  64. package/docs/021-DOGFOODING-FINDINGS.md +175 -0
  65. package/docs/BACKLOG.md +80 -0
  66. package/docs/CONFIG.md +1123 -0
  67. package/docs/DESIGN.md +439 -0
  68. package/docs/ERRORS.md +383 -0
  69. package/docs/PROJECT.md +88 -0
  70. package/docs/ROADMAP.md +407 -0
  71. package/docs/summarization.md +320 -0
  72. package/docs/test-links.md +9 -0
  73. package/justfile +40 -0
  74. package/package.json +74 -9
  75. package/pnpm-workspace.yaml +5 -0
  76. package/research/INDEX.md +315 -0
  77. package/research/code-review/README.md +90 -0
  78. package/research/code-review/cli-error-handling-review.md +979 -0
  79. package/research/code-review/code-review-validation-report.md +464 -0
  80. package/research/code-review/main-ts-review.md +1128 -0
  81. package/research/config-analysis/01-current-implementation.md +470 -0
  82. package/research/config-analysis/02-strategy-recommendation.md +428 -0
  83. package/research/config-analysis/03-task-candidates.md +715 -0
  84. package/research/config-analysis/033-research-configuration-management.md +828 -0
  85. package/research/config-analysis/034-research-effect-cli-config.md +1504 -0
  86. package/research/config-analysis/04-consolidated-task-candidates.md +277 -0
  87. package/research/config-docs/SUMMARY.md +357 -0
  88. package/research/config-docs/TEST-RESULTS.md +776 -0
  89. package/research/config-docs/TODO.md +542 -0
  90. package/research/config-docs/analysis.md +744 -0
  91. package/research/config-docs/fix-validation.md +502 -0
  92. package/research/config-docs/help-audit.md +264 -0
  93. package/research/config-docs/help-system-analysis.md +890 -0
  94. package/research/dogfood/consolidated-tool-evaluation.md +373 -0
  95. package/research/dogfood/strategy-a/a-synthesis.md +184 -0
  96. package/research/dogfood/strategy-a/a1-docs.md +226 -0
  97. package/research/dogfood/strategy-a/a2-amorphic.md +156 -0
  98. package/research/dogfood/strategy-a/a3-llm.md +164 -0
  99. package/research/dogfood/strategy-b/b-synthesis.md +228 -0
  100. package/research/dogfood/strategy-b/b1-architecture.md +207 -0
  101. package/research/dogfood/strategy-b/b2-gaps.md +258 -0
  102. package/research/dogfood/strategy-b/b3-workflows.md +250 -0
  103. package/research/dogfood/strategy-c/c-synthesis.md +451 -0
  104. package/research/dogfood/strategy-c/c1-explorer.md +192 -0
  105. package/research/dogfood/strategy-c/c2-diver-memory.md +145 -0
  106. package/research/dogfood/strategy-c/c3-diver-control.md +148 -0
  107. package/research/dogfood/strategy-c/c4-diver-failure.md +151 -0
  108. package/research/dogfood/strategy-c/c5-diver-execution.md +221 -0
  109. package/research/dogfood/strategy-c/c6-diver-org.md +221 -0
  110. package/research/effect-cli-error-handling.md +845 -0
  111. package/research/effect-errors-as-values.md +943 -0
  112. package/research/errors-task-analysis/00-consolidated-tasks.md +207 -0
  113. package/research/errors-task-analysis/cli-commands-analysis.md +909 -0
  114. package/research/errors-task-analysis/embeddings-analysis.md +709 -0
  115. package/research/errors-task-analysis/index-search-analysis.md +812 -0
  116. package/research/frontmatter/COMMENTS-ARE-SKIPPED.md +149 -0
  117. package/research/frontmatter/LLM-CODE-NAVIGATION.md +276 -0
  118. package/research/issue-review.md +603 -0
  119. package/research/llm-summarization/agent-cli-tools-2026.md +1082 -0
  120. package/research/llm-summarization/alternative-providers-2026.md +1428 -0
  121. package/research/llm-summarization/anthropic-2026.md +367 -0
  122. package/research/llm-summarization/claude-cli-integration.md +1706 -0
  123. package/research/llm-summarization/cli-integration-patterns.md +3155 -0
  124. package/research/llm-summarization/openai-2026.md +473 -0
  125. package/research/llm-summarization/openai-compatible-providers-2026.md +1022 -0
  126. package/research/llm-summarization/opencode-cli-integration.md +1552 -0
  127. package/research/llm-summarization/prompt-engineering-2026.md +1426 -0
  128. package/research/llm-summarization/prototype-results.md +56 -0
  129. package/research/llm-summarization/provider-switching-patterns-2026.md +2153 -0
  130. package/research/llm-summarization/typescript-llm-libraries-2026.md +2436 -0
  131. package/research/mdcontext-error-analysis.md +521 -0
  132. package/research/mdcontext-pudding/00-EXECUTIVE-SUMMARY.md +282 -0
  133. package/research/mdcontext-pudding/01-index-embed.md +956 -0
  134. package/research/mdcontext-pudding/02-search-COMMANDS.md +142 -0
  135. package/research/mdcontext-pudding/02-search-SUMMARY.md +146 -0
  136. package/research/mdcontext-pudding/02-search.md +970 -0
  137. package/research/mdcontext-pudding/03-context.md +779 -0
  138. package/research/mdcontext-pudding/04-navigation-and-analytics.md +803 -0
  139. package/research/mdcontext-pudding/04-tree.md +704 -0
  140. package/research/mdcontext-pudding/05-config.md +1038 -0
  141. package/research/mdcontext-pudding/06-links-summary.txt +87 -0
  142. package/research/mdcontext-pudding/06-links.md +679 -0
  143. package/research/mdcontext-pudding/07-stats.md +693 -0
  144. package/research/mdcontext-pudding/BUG-FIX-PLAN.md +388 -0
  145. package/research/mdcontext-pudding/P0-BUG-VALIDATION.md +167 -0
  146. package/research/mdcontext-pudding/README.md +168 -0
  147. package/research/mdcontext-pudding/TESTING-SUMMARY.md +128 -0
  148. package/research/npm_publish/011-npm-workflow-research-agent2.md +792 -0
  149. package/research/npm_publish/012-npm-workflow-research-agent1.md +530 -0
  150. package/research/npm_publish/013-npm-workflow-research-agent3.md +722 -0
  151. package/research/npm_publish/014-npm-workflow-synthesis.md +556 -0
  152. package/research/npm_publish/031-npm-workflow-task-analysis.md +134 -0
  153. package/research/research-quality-review.md +834 -0
  154. package/research/semantic-search/002-research-embedding-models.md +490 -0
  155. package/research/semantic-search/003-research-rag-alternatives.md +523 -0
  156. package/research/semantic-search/004-research-vector-search.md +841 -0
  157. package/research/semantic-search/032-research-semantic-search.md +427 -0
  158. package/research/semantic-search/embedding-text-analysis.md +156 -0
  159. package/research/semantic-search/multi-word-failure-reproduction.md +171 -0
  160. package/research/semantic-search/query-processing-analysis.md +207 -0
  161. package/research/semantic-search/root-cause-and-solution.md +114 -0
  162. package/research/semantic-search/threshold-validation-report.md +69 -0
  163. package/research/semantic-search/vector-search-analysis.md +63 -0
  164. package/research/task-management-2026/00-synthesis-recommendations.md +295 -0
  165. package/research/task-management-2026/01-ai-workflow-tools.md +416 -0
  166. package/research/task-management-2026/02-agent-framework-patterns.md +476 -0
  167. package/research/task-management-2026/03-lightweight-file-based.md +567 -0
  168. package/research/task-management-2026/04-established-tools-ai-features.md +541 -0
  169. package/research/task-management-2026/linear/01-core-features-workflow.md +771 -0
  170. package/research/task-management-2026/linear/02-api-integrations.md +930 -0
  171. package/research/task-management-2026/linear/03-ai-features.md +368 -0
  172. package/research/task-management-2026/linear/04-pricing-setup.md +205 -0
  173. package/research/task-management-2026/linear/05-usage-patterns-best-practices.md +605 -0
  174. package/research/test-path-issues.md +276 -0
  175. package/review/ALP-76/1-error-type-design.md +962 -0
  176. package/review/ALP-76/2-error-handling-patterns.md +906 -0
  177. package/review/ALP-76/3-error-presentation.md +624 -0
  178. package/review/ALP-76/4-test-coverage.md +625 -0
  179. package/review/ALP-76/5-migration-completeness.md +440 -0
  180. package/review/ALP-76/6-effect-best-practices.md +755 -0
  181. package/scripts/apply-branch-protection.sh +47 -0
  182. package/scripts/branch-protection-templates.json +79 -0
  183. package/scripts/prototype-summarization.ts +346 -0
  184. package/scripts/rebuild-hnswlib.js +58 -0
  185. package/scripts/setup-branch-protection.sh +64 -0
  186. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/active-provider.json +7 -0
  187. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/bm25.json +541 -0
  188. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/bm25.meta.json +5 -0
  189. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/config.json +8 -0
  190. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/embeddings/openai_text-embedding-3-small_512/vectors.bin +0 -0
  191. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/embeddings/openai_text-embedding-3-small_512/vectors.meta.bin +0 -0
  192. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/indexes/documents.json +60 -0
  193. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/indexes/links.json +13 -0
  194. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/.mdcontext/indexes/sections.json +1197 -0
  195. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/configuration-management.md +99 -0
  196. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/distributed-systems.md +92 -0
  197. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/error-handling.md +78 -0
  198. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/failure-automation.md +55 -0
  199. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/job-context.md +69 -0
  200. package/src/__tests__/fixtures/semantic-search/multi-word-corpus/process-orchestration.md +99 -0
  201. package/src/cli/argv-preprocessor.test.ts +210 -0
  202. package/src/cli/argv-preprocessor.ts +202 -0
  203. package/src/cli/cli.test.ts +627 -0
  204. package/src/cli/commands/backlinks.ts +54 -0
  205. package/src/cli/commands/config-cmd.ts +642 -0
  206. package/src/cli/commands/context.ts +285 -0
  207. package/src/cli/commands/duplicates.ts +122 -0
  208. package/src/cli/commands/embeddings.ts +529 -0
  209. package/src/cli/commands/index-cmd.ts +480 -0
  210. package/src/cli/commands/index.ts +16 -0
  211. package/src/cli/commands/links.ts +52 -0
  212. package/src/cli/commands/search.ts +1281 -0
  213. package/src/cli/commands/stats.ts +149 -0
  214. package/src/cli/commands/tree.ts +128 -0
  215. package/src/cli/config-layer.ts +176 -0
  216. package/src/cli/error-handler.test.ts +235 -0
  217. package/src/cli/error-handler.ts +655 -0
  218. package/src/cli/flag-schemas.ts +341 -0
  219. package/src/cli/help.ts +588 -0
  220. package/src/cli/index.ts +9 -0
  221. package/src/cli/main.ts +435 -0
  222. package/src/cli/options.ts +41 -0
  223. package/src/cli/shared-error-handling.ts +199 -0
  224. package/src/cli/typo-suggester.test.ts +105 -0
  225. package/src/cli/typo-suggester.ts +130 -0
  226. package/src/cli/utils.ts +259 -0
  227. package/src/config/file-provider.test.ts +320 -0
  228. package/src/config/file-provider.ts +273 -0
  229. package/src/config/index.ts +72 -0
  230. package/src/config/integration.test.ts +667 -0
  231. package/src/config/precedence.test.ts +277 -0
  232. package/src/config/precedence.ts +451 -0
  233. package/src/config/schema.test.ts +414 -0
  234. package/src/config/schema.ts +603 -0
  235. package/src/config/service.test.ts +320 -0
  236. package/src/config/service.ts +243 -0
  237. package/src/config/testing.test.ts +264 -0
  238. package/src/config/testing.ts +110 -0
  239. package/src/core/index.ts +1 -0
  240. package/src/core/types.ts +113 -0
  241. package/src/duplicates/detector.test.ts +183 -0
  242. package/src/duplicates/detector.ts +414 -0
  243. package/src/duplicates/index.ts +18 -0
  244. package/src/embeddings/embedding-namespace.test.ts +300 -0
  245. package/src/embeddings/embedding-namespace.ts +947 -0
  246. package/src/embeddings/heading-boost.test.ts +222 -0
  247. package/src/embeddings/hnsw-build-options.test.ts +198 -0
  248. package/src/embeddings/hyde.test.ts +272 -0
  249. package/src/embeddings/hyde.ts +264 -0
  250. package/src/embeddings/index.ts +10 -0
  251. package/src/embeddings/openai-provider.ts +414 -0
  252. package/src/embeddings/pricing.json +22 -0
  253. package/src/embeddings/provider-constants.ts +204 -0
  254. package/src/embeddings/provider-errors.test.ts +967 -0
  255. package/src/embeddings/provider-errors.ts +565 -0
  256. package/src/embeddings/provider-factory.test.ts +240 -0
  257. package/src/embeddings/provider-factory.ts +225 -0
  258. package/src/embeddings/provider-integration.test.ts +788 -0
  259. package/src/embeddings/query-preprocessing.test.ts +187 -0
  260. package/src/embeddings/semantic-search-threshold.test.ts +508 -0
  261. package/src/embeddings/semantic-search.ts +1270 -0
  262. package/src/embeddings/types.ts +359 -0
  263. package/src/embeddings/vector-store.ts +708 -0
  264. package/src/embeddings/voyage-provider.ts +313 -0
  265. package/src/errors/errors.test.ts +845 -0
  266. package/src/errors/index.ts +533 -0
  267. package/src/index/ignore-patterns.test.ts +354 -0
  268. package/src/index/ignore-patterns.ts +305 -0
  269. package/src/index/index.ts +4 -0
  270. package/src/index/indexer.ts +684 -0
  271. package/src/index/storage.ts +260 -0
  272. package/src/index/types.ts +147 -0
  273. package/src/index/watcher.ts +189 -0
  274. package/src/index.ts +30 -0
  275. package/src/integration/search-keyword.test.ts +678 -0
  276. package/src/mcp/server.ts +612 -0
  277. package/src/parser/index.ts +1 -0
  278. package/src/parser/parser.test.ts +291 -0
  279. package/src/parser/parser.ts +394 -0
  280. package/src/parser/section-filter.test.ts +277 -0
  281. package/src/parser/section-filter.ts +392 -0
  282. package/src/search/__tests__/hybrid-search.test.ts +650 -0
  283. package/src/search/bm25-store.ts +366 -0
  284. package/src/search/cross-encoder.test.ts +253 -0
  285. package/src/search/cross-encoder.ts +406 -0
  286. package/src/search/fuzzy-search.test.ts +419 -0
  287. package/src/search/fuzzy-search.ts +273 -0
  288. package/src/search/hybrid-search.ts +448 -0
  289. package/src/search/path-matcher.test.ts +276 -0
  290. package/src/search/path-matcher.ts +33 -0
  291. package/src/search/query-parser.test.ts +260 -0
  292. package/src/search/query-parser.ts +319 -0
  293. package/src/search/searcher.test.ts +280 -0
  294. package/src/search/searcher.ts +724 -0
  295. package/src/search/wink-bm25.d.ts +30 -0
  296. package/src/summarization/cli-providers/claude.ts +202 -0
  297. package/src/summarization/cli-providers/detection.test.ts +273 -0
  298. package/src/summarization/cli-providers/detection.ts +118 -0
  299. package/src/summarization/cli-providers/index.ts +8 -0
  300. package/src/summarization/cost.test.ts +139 -0
  301. package/src/summarization/cost.ts +102 -0
  302. package/src/summarization/error-handler.test.ts +127 -0
  303. package/src/summarization/error-handler.ts +111 -0
  304. package/src/summarization/index.ts +102 -0
  305. package/src/summarization/pipeline.test.ts +498 -0
  306. package/src/summarization/pipeline.ts +231 -0
  307. package/src/summarization/prompts.test.ts +269 -0
  308. package/src/summarization/prompts.ts +133 -0
  309. package/src/summarization/provider-factory.test.ts +396 -0
  310. package/src/summarization/provider-factory.ts +178 -0
  311. package/src/summarization/types.ts +184 -0
  312. package/src/summarize/budget-bugs.test.ts +620 -0
  313. package/src/summarize/formatters.ts +419 -0
  314. package/src/summarize/index.ts +20 -0
  315. package/src/summarize/summarizer.test.ts +275 -0
  316. package/src/summarize/summarizer.ts +597 -0
  317. package/src/summarize/verify-bugs.test.ts +238 -0
  318. package/src/types/huggingface-transformers.d.ts +66 -0
  319. package/src/utils/index.ts +1 -0
  320. package/src/utils/tokens.test.ts +142 -0
  321. package/src/utils/tokens.ts +186 -0
  322. package/tests/fixtures/cli/.mdcontext/active-provider.json +7 -0
  323. package/tests/fixtures/cli/.mdcontext/config.json +8 -0
  324. package/tests/fixtures/cli/.mdcontext/embeddings/openai_text-embedding-3-small_512/vectors.bin +0 -0
  325. package/tests/fixtures/cli/.mdcontext/embeddings/openai_text-embedding-3-small_512/vectors.meta.bin +0 -0
  326. package/tests/fixtures/cli/.mdcontext/indexes/documents.json +33 -0
  327. package/tests/fixtures/cli/.mdcontext/indexes/links.json +12 -0
  328. package/tests/fixtures/cli/.mdcontext/indexes/sections.json +247 -0
  329. package/tests/fixtures/cli/README.md +9 -0
  330. package/tests/fixtures/cli/api-reference.md +11 -0
  331. package/tests/fixtures/cli/getting-started.md +11 -0
  332. package/tests/integration/embed-index.test.ts +712 -0
  333. package/tests/integration/search-context.test.ts +469 -0
  334. package/tests/integration/search-semantic.test.ts +522 -0
  335. package/tsconfig.json +26 -0
  336. package/vitest.config.ts +16 -0
  337. package/vitest.setup.ts +12 -0
@@ -0,0 +1,541 @@
1
+ # Established Task Management Tools: AI Features for 2026
2
+
3
+ > Research conducted: January 21, 2026
4
+
5
+ ## Executive Summary
6
+
7
+ The task management landscape has undergone a dramatic transformation in 2025-2026. What were once passive tools for tracking work have evolved into active AI teammates capable of autonomous task execution. This shift represents a fundamental change from AI-assisted to AI-native workflows, with established players like GitHub, Linear, Jira, and Notion racing to add agentic capabilities while maintaining their core strengths.
8
+
9
+ **Key Finding**: Linear has emerged as the leader in AI-agent integration, with native support for treating AI agents as "full teammates." GitHub's Copilot coding agent has transformed GitHub Issues into an AI-assignable work system. Meanwhile, Jira and Notion are catching up with their own AI agent platforms (Rovo and Notion Agent, respectively).
10
+
11
+ ---
12
+
13
+ ## Tool-by-Tool Analysis
14
+
15
+ ### 1. GitHub Projects + Copilot Coding Agent
16
+
17
+ **AI Feature Maturity**: ★★★★★ (5/5)
18
+
19
+ GitHub has made the most aggressive push into AI-native task management by integrating Copilot directly into GitHub Issues and Projects.
20
+
21
+ #### Current AI Capabilities (January 2026)
22
+
23
+ **Copilot Coding Agent**
24
+
25
+ - Assign GitHub Issues directly to Copilot as an "assignee"
26
+ - Copilot autonomously writes code, creates branches, and opens PRs
27
+ - Real-time progress tracking as Copilot pushes commits incrementally
28
+ - Responds to PR review comments and iterates on feedback
29
+ - Runs automated tests and linters; generates/updates tests as needed
30
+
31
+ **Specialized CLI Agents** (January 2026 release)
32
+
33
+ - **Explore Agent**: Codebase analysis without cluttering main context
34
+ - **Task Agent**: Runs commands, summarizes on success, full output on failure
35
+ - **Plan Agent**: Creates implementation plans for complex changes
36
+ - **Code-Review Agent**: Evaluates modifications with AI reasoning + static analysis
37
+
38
+ **Copilot Spaces**
39
+
40
+ - Organize code, docs, specs into project-specific "Spaces"
41
+ - Grounds Copilot responses in the right context for each task
42
+ - Accessible via MCP server for external AI tools
43
+
44
+ #### API Capabilities
45
+
46
+ | Feature | API Type | Notes |
47
+ | ------------------ | ---------------------------------------------- | ------------------------------------------------- |
48
+ | Project Management | GraphQL (V2) | Full CRUD for projects, items, fields |
49
+ | Issues & PRs | REST + GraphQL | Both available, GraphQL recommended for relations |
50
+ | Copilot Actions | GitHub Actions | Webhook-triggered automation |
51
+ | Webhooks | REST | Real-time notifications for project events |
52
+ | Rate Limits | 5,000 req/hr (REST), 5,000 points/hr (GraphQL) | GitHub Apps can get up to 15,000/hr |
53
+
54
+ **Key GraphQL Operations for Agents**:
55
+
56
+ ```graphql
57
+ # Create project item
58
+ mutation {
59
+ addProjectV2ItemById(input: { projectId: $projectId, contentId: $issueId }) {
60
+ item {
61
+ id
62
+ }
63
+ }
64
+ }
65
+
66
+ # Update item status
67
+ mutation {
68
+ updateProjectV2ItemFieldValue(
69
+ input: {
70
+ projectId: $projectId
71
+ itemId: $itemId
72
+ fieldId: $statusFieldId
73
+ value: { singleSelectOptionId: $optionId }
74
+ }
75
+ ) {
76
+ projectV2Item {
77
+ id
78
+ }
79
+ }
80
+ }
81
+ ```
82
+
83
+ #### Integration with AI Assistants
84
+
85
+ - **Native Copilot**: First-party, deepest integration
86
+ - **Claude Code**: Supported via GitHub MCP server
87
+ - **Cursor**: Can assign from Linear to Copilot
88
+ - **Azure DevOps**: Deep integration with VS Code + Boards
89
+ - **Slack/Teams**: Assign issues to Copilot directly from chat
90
+
91
+ #### Best For
92
+
93
+ - Teams already on GitHub who want seamless code-to-task integration
94
+ - Organizations wanting first-party AI coding agent support
95
+ - Workflows where issues should directly trigger autonomous coding
96
+
97
+ **Sources**:
98
+
99
+ - [GitHub Copilot Coding Agent Overview](https://github.blog/ai-and-ml/github-copilot/assigning-and-completing-issues-with-coding-agent-in-github-copilot/)
100
+ - [GitHub Copilot CLI January 2026 Update](https://github.blog/changelog/2026-01-14-github-copilot-cli-enhanced-agents-context-management-and-new-ways-to-install/)
101
+ - [GitHub Projects API Documentation](https://docs.github.com/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)
102
+
103
+ ---
104
+
105
+ ### 2. Linear
106
+
107
+ **AI Feature Maturity**: ★★★★★ (5/5)
108
+
109
+ Linear has positioned itself as the most AI-agent-friendly task management tool, explicitly building features for AI teammates.
110
+
111
+ #### Current AI Capabilities
112
+
113
+ **Agents as Teammates**
114
+
115
+ - Agents are "full members" of your Linear workspace
116
+ - Can be assigned issues like human teammates
117
+ - @mention agents in comments to trigger actions
118
+ - Build custom AI teammates with the Linear API
119
+ - Share agents with the Linear community or keep them private
120
+
121
+ **Native Integrations**
122
+
123
+ - **Cursor Integration**: Assign issues to @Cursor, which spins up a cloud agent
124
+ - **GitHub Copilot**: Delegate issues to Copilot directly from Linear
125
+ - **OpenAI Codex**: Turn issues into pull requests
126
+ - **Claude**: Connect via MCP for natural language queries
127
+
128
+ **"Agentic Backlog" (2026)**
129
+
130
+ - "Linear Asks" feature uses AI agent to monitor Slack and Email
131
+ - Auto-categorizes incoming requests
132
+ - Suggests issue creation and prioritization
133
+
134
+ **AI-Powered Search & Summaries**
135
+
136
+ - Semantic search across titles, descriptions, feedback, and tickets
137
+ - AI-generated daily/weekly project summaries
138
+ - Audio digest option for inbox updates
139
+
140
+ #### API Capabilities
141
+
142
+ | Feature | API Type | Notes |
143
+ | ---------------- | ------------------- | --------------------------------------- |
144
+ | Full CRUD | GraphQL | Same API Linear uses internally |
145
+ | Authentication | API Key, OAuth2 | OAuth2 recommended for apps |
146
+ | Webhooks | HTTP POST | Event-driven automation |
147
+ | Complexity Limit | 10,000 points/query | Generous for most operations |
148
+ | MCP Server | Available | Human-readable identifiers, SSE support |
149
+
150
+ **MCP Server Features** (tacticlaunch/mcp-linear):
151
+
152
+ - JSON-RPC 2.0 with full CRUD operations
153
+ - Smart content chunking for large descriptions
154
+ - Human-readable identifiers (team keys, issue names)
155
+ - UUID-free responses for LLM friendliness
156
+ - Server-Sent Events for real-time updates
157
+
158
+ #### Integration Patterns
159
+
160
+ ```javascript
161
+ // Example: Create issue and assign to AI agent via Linear API
162
+ const issue = await linearClient.createIssue({
163
+ teamId: "TEAM_ID",
164
+ title: "Implement feature X",
165
+ description: "Full specifications...",
166
+ assigneeId: "AI_AGENT_USER_ID", // AI agents have user IDs
167
+ });
168
+
169
+ // MCP command in Claude/Cursor
170
+ // "Create a Linear issue for team Engineering titled 'Fix login bug'"
171
+ ```
172
+
173
+ #### Best For
174
+
175
+ - Teams wanting the most polished AI-agent-native experience
176
+ - Workflows that delegate entire issues to AI end-to-end
177
+ - Organizations using Cursor as their primary AI coding tool
178
+ - Product teams who want AI to triage and summarize automatically
179
+
180
+ **Sources**:
181
+
182
+ - [Linear for Agents](https://linear.app/agents)
183
+ - [AI Agents in Linear Documentation](https://linear.app/docs/agents-in-linear)
184
+ - [Why Linear Built an API For Agents](https://thenewstack.io/why-linear-built-an-api-for-agents/)
185
+ - [Linear + Cursor Integration](https://cursor.com/en-US/blog/linear)
186
+
187
+ ---
188
+
189
+ ### 3. Jira + Atlassian Intelligence (Rovo)
190
+
191
+ **AI Feature Maturity**: ★★★★☆ (4/5)
192
+
193
+ Atlassian has integrated AI deeply into Jira through "Atlassian Intelligence" and the Rovo agent platform.
194
+
195
+ #### Current AI Capabilities
196
+
197
+ **Rovo Agents**
198
+
199
+ - Specialized out-of-the-box agents for common tasks
200
+ - Custom agent creation for organization-specific workflows
201
+ - Agents can execute tasks, manage details, and suggest next moves
202
+ - Available in Jira, Confluence, and Jira Service Management
203
+
204
+ **Natural Language Automation**
205
+
206
+ - Create automation rules using natural language
207
+ - "When a bug is assigned to me, move it to In Progress" becomes a rule
208
+ - Build custom workflows for any process in everyday language
209
+
210
+ **AI Work Breakdown**
211
+
212
+ - Automatically suggests how to break epics into stories
213
+ - Identifies sub-tasks from feature descriptions
214
+ - Reduces manual decomposition time from hours to minutes
215
+
216
+ **AI-Powered Features**
217
+
218
+ - **Summaries**: Condense long ticket threads, identify decisions and action items
219
+ - **Natural Language to JQL**: Plain English queries converted to JQL
220
+ - **Smart Links Summaries**: Summarize linked Confluence pages, Google Docs
221
+ - **Risk Prediction**: ML-based project risk assessment (Wrike-like)
222
+
223
+ **Virtual Service Agent (JSM)**
224
+
225
+ - Automates support interactions with NLP + generative AI
226
+ - Handles password resets, software access, FAQ responses
227
+ - Routes complex tickets to appropriate human agents
228
+ - Integrates with Slack, Teams, email, and help center
229
+
230
+ #### API Capabilities
231
+
232
+ | Feature | API Type | Notes |
233
+ | --------------- | ------------ | ------------------------------------ |
234
+ | Core Operations | REST v3 | Full issue, project, user management |
235
+ | Search | JQL via REST | Powerful query language |
236
+ | Webhooks | HTTP | Event-driven triggers |
237
+ | Automation | REST | Programmatic rule creation |
238
+ | MCP Server | Third-party | Available via tray.ai and others |
239
+
240
+ **Rate Limits**: Typically 5,000 requests/hour for authenticated users.
241
+
242
+ **MCP Integration**:
243
+
244
+ - Jira MCP servers translate natural language to Jira API requests
245
+ - Works with Claude Desktop, ChatGPT, and other MCP clients
246
+ - Respects user permissions and project security rules
247
+
248
+ #### Integration with AI Assistants
249
+
250
+ - **Atlassian Forge**: Build custom AI integrations
251
+ - **LangChain**: Official Jira toolkit wrapper
252
+ - **Tray.ai**: 700+ connectors for agent orchestration
253
+ - **Workato/Workday**: Enterprise automation triggers
254
+ - **ChatGPT/Claude**: Via third-party MCP servers
255
+
256
+ #### Best For
257
+
258
+ - Enterprise teams with complex approval workflows
259
+ - Organizations already invested in Atlassian ecosystem
260
+ - ITSM teams needing AI-powered service desk
261
+ - Companies wanting natural language automation
262
+
263
+ **Pricing Note**: Premium plan at ~$16/user/month includes Atlassian Intelligence. Rovo is a premium add-on.
264
+
265
+ **Sources**:
266
+
267
+ - [Atlassian Intelligence Features in Jira](https://support.atlassian.com/organization-administration/docs/atlassian-intelligence-features-in-jira-software/)
268
+ - [Rovo in Jira: AI Features](https://www.atlassian.com/software/jira/ai)
269
+ - [Jira REST API v3](https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/)
270
+ - [Jira MCP Integration Guide](https://www.workato.com/the-connector/jira-mcp/)
271
+
272
+ ---
273
+
274
+ ### 4. Notion + Notion Agent
275
+
276
+ **AI Feature Maturity**: ★★★★☆ (4/5)
277
+
278
+ Notion has evolved from a documentation tool to an AI-powered workspace with autonomous agent capabilities.
279
+
280
+ #### Current AI Capabilities (January 2026)
281
+
282
+ **Notion Agent**
283
+
284
+ - Personal AI that can "take on a whole project"
285
+ - Builds launch plans, breaks into tasks, assigns to team members
286
+ - Drafts documents automatically as part of project setup
287
+ - Works at scale: can update/create hundreds of pages at once
288
+ - Pulls context from workspace, Slack, Google Drive, GitHub, and web
289
+
290
+ **AI Autofill**
291
+
292
+ - Automatically extracts action items, risks, summaries from content
293
+ - Keeps extracted information updated as projects progress
294
+ - Reduces manual status update work
295
+
296
+ **Custom Agents (Coming Soon)**
297
+
298
+ - Create agents that run on autopilot (schedules or triggers)
299
+ - Examples: Daily feedback compilation, weekly status posts, IT triage
300
+ - Monitor databases and alert teams when conditions are met
301
+
302
+ **Mobile AI (January 2026)**
303
+
304
+ - Full Notion Agent capabilities on mobile
305
+ - AI note transcription (works when app is backgrounded)
306
+ - Automatic meeting summaries and action items
307
+
308
+ **Model Flexibility**
309
+
310
+ - Uses both OpenAI GPT-4 and Anthropic Claude
311
+ - New models added regularly (GPT-5 announced for agentic workflows)
312
+
313
+ #### API Capabilities
314
+
315
+ | Feature | API Type | Notes |
316
+ | ---------------- | -------- | ------------------------------------------ |
317
+ | Database CRUD | REST | Full database manipulation |
318
+ | Page Operations | REST | Create, update, archive pages |
319
+ | Search | REST | Workspace-wide search |
320
+ | MCP Server | Official | Enterprise audit logging, multi-DB queries |
321
+ | Block Operations | REST | Granular content editing |
322
+
323
+ **MCP Features for Enterprise**:
324
+
325
+ - Track MCP activity in audit logs
326
+ - Query multiple databases simultaneously
327
+ - Control which external AI tools can connect (coming soon)
328
+
329
+ **API Design for Agents**:
330
+
331
+ - "APIs designed for agentic workflows"
332
+ - Read and write structured content programmatically
333
+ - Supports ChatGPT, Claude, Cursor connections
334
+
335
+ #### Integration with AI Assistants
336
+
337
+ - **Native Agent**: First-party, most integrated
338
+ - **Claude/ChatGPT/Cursor**: Via Notion MCP server
339
+ - **Slack**: Automatic data pull for agent context
340
+ - **GitHub**: Code context for technical projects
341
+ - **Google Drive**: Document context integration
342
+
343
+ #### Best For
344
+
345
+ - Teams wanting all-in-one workspace with AI
346
+ - Organizations needing custom agent workflows
347
+ - Product teams managing docs + tasks in same place
348
+ - Companies wanting GPT-5 powered autonomous features
349
+
350
+ **Pricing Note**: Notion AI only available on Business and Enterprise plans (not Free or Plus).
351
+
352
+ **Sources**:
353
+
354
+ - [Notion January 2026 Release Notes](https://www.notion.com/releases/2026-01-20)
355
+ - [Notion's Rebuild for Agentic AI (OpenAI Case Study)](https://openai.com/index/notion/)
356
+ - [Notion Developers API](https://developers.notion.com/)
357
+ - [AI-Powered Notion Projects](https://www.notion.com/blog/new-ai-powered-notion-projects)
358
+
359
+ ---
360
+
361
+ ### 5. Other Notable Tools
362
+
363
+ #### Shortcut (formerly Clubhouse)
364
+
365
+ **AI Feature Status**: ★★★☆☆ (3/5)
366
+
367
+ - Integrates with Cursor and Claude Code for AI coding
368
+ - Korey integration for automated user stories and specs
369
+ - API available for custom automation
370
+ - Less native AI than competitors, but solid API-first approach
371
+
372
+ **Best For**: Teams wanting clean UI + third-party AI flexibility
373
+
374
+ **Source**: [Shortcut Integrations](https://www.softwareadvice.com/project-management/clubhouse-profile/)
375
+
376
+ #### Monday.com
377
+
378
+ **AI Feature Status**: ★★★★☆ (4/5)
379
+
380
+ - Uses OpenAI APIs for translations, summaries, sentiment analysis
381
+ - Auto-assigns tasks based on priorities, workloads, skills
382
+ - Flags risks due to task ownership or timeline delays
383
+ - Brain Max tier integrates with external apps (Dropbox, SharePoint)
384
+
385
+ **Best For**: Non-technical teams wanting visual AI assistance
386
+
387
+ #### ClickUp
388
+
389
+ **AI Feature Status**: ★★★★☆ (4/5)
390
+
391
+ - ClickUp Brain for AI chat experience
392
+ - AI agents as "machine teammates"
393
+ - Integrates with 1,000+ tools via Zapier
394
+ - Natural language task creation
395
+
396
+ **Best For**: Teams wanting everything-in-one with AI
397
+
398
+ #### Asana
399
+
400
+ **AI Feature Status**: ★★★☆☆ (3/5)
401
+
402
+ - AI Studio (beta) for creating custom AI agents
403
+ - Non-technical agent creation process
404
+ - Agents execute tasks and update workspace
405
+ - Slower AI adoption than competitors
406
+
407
+ **Best For**: Enterprise teams with existing Asana investment
408
+
409
+ #### Motion
410
+
411
+ **AI Feature Status**: ★★★★☆ (4/5)
412
+
413
+ - Leader in AI Scheduling for 2026
414
+ - "Predictive Delay" engine for timeline management
415
+ - Automatically reschedules based on team velocity
416
+ - Protects deep-focus time when behind on priorities
417
+
418
+ **Best For**: Individual productivity and calendar optimization
419
+
420
+ ---
421
+
422
+ ## Comparison Matrix
423
+
424
+ ### AI Features Comparison
425
+
426
+ | Tool | AI Agents as Teammates | Issue Auto-Assignment | Natural Language Rules | Autonomous Coding | MCP Server | Custom Agent Builder |
427
+ | ------------ | ---------------------- | --------------------- | ---------------------- | ----------------- | -------------- | -------------------- |
428
+ | **GitHub** | ✅ Copilot | ✅ Native | ❌ | ✅ Best-in-class | ✅ Official | ❌ |
429
+ | **Linear** | ✅ First-class | ✅ Native | ❌ | ✅ Via Cursor | ✅ Multiple | ✅ API-based |
430
+ | **Jira** | ✅ Rovo | ⚠️ Via Rovo | ✅ Excellent | ❌ | ✅ Third-party | ✅ Rovo Studio |
431
+ | **Notion** | ✅ Notion Agent | ⚠️ Via Agent | ❌ | ❌ | ✅ Official | ✅ Coming soon |
432
+ | **ClickUp** | ✅ Brain | ⚠️ Via Brain | ✅ | ❌ | ⚠️ Zapier | ✅ |
433
+ | **Monday** | ⚠️ Limited | ✅ Auto-assign | ❌ | ❌ | ⚠️ Zapier | ❌ |
434
+ | **Shortcut** | ⚠️ Third-party | ❌ | ❌ | ✅ Via Cursor | ⚠️ Pipedream | ❌ |
435
+
436
+ ### API Quality for AI Agents
437
+
438
+ | Tool | API Type | Rate Limits | Auth Methods | Agent-Friendly Design | Documentation Quality |
439
+ | ------------ | -------------- | ---------------------------- | ----------------- | --------------------- | --------------------- |
440
+ | **GitHub** | GraphQL + REST | Excellent (15K/hr for Apps) | OAuth, PAT, App | ★★★★★ | ★★★★★ |
441
+ | **Linear** | GraphQL | Excellent (10K points/query) | API Key, OAuth2 | ★★★★★ | ★★★★☆ |
442
+ | **Jira** | REST v3 | Good (5K/hr) | OAuth2, API Token | ★★★★☆ | ★★★★☆ |
443
+ | **Notion** | REST | Good | API Key, OAuth | ★★★★☆ | ★★★★☆ |
444
+ | **ClickUp** | REST | Good | API Key, OAuth | ★★★☆☆ | ★★★☆☆ |
445
+ | **Shortcut** | REST | Good | API Token | ★★★☆☆ | ★★★☆☆ |
446
+
447
+ ### Best Tool by Use Case
448
+
449
+ | Use Case | Recommended Tool | Reason |
450
+ | ------------------------------ | --------------------- | ------------------------------ |
451
+ | **AI writes code from issues** | GitHub + Copilot | Native, best autonomous coding |
452
+ | **AI as full team member** | Linear | Purpose-built for AI teammates |
453
+ | **Enterprise with approvals** | Jira + Rovo | Complex workflow support |
454
+ | **Docs + tasks unified** | Notion | All-in-one with AI agent |
455
+ | **Cursor-first workflow** | Linear | Deepest Cursor integration |
456
+ | **Claude Code workflow** | GitHub or Linear | Both have strong MCP support |
457
+ | **Non-technical teams** | Monday.com or ClickUp | Visual, accessible AI |
458
+ | **Calendar optimization** | Motion | Best AI scheduling |
459
+
460
+ ---
461
+
462
+ ## Recommendations for AI Workflows
463
+
464
+ ### For Autonomous AI Development
465
+
466
+ **Tier 1 (Best)**:
467
+
468
+ 1. **GitHub Issues + Copilot Coding Agent**: Best for teams where AI should own the entire code-to-PR workflow
469
+ 2. **Linear + Cursor**: Best for teams wanting the cleanest AI teammate experience
470
+
471
+ **Tier 2 (Good)**: 3. **Jira + Rovo**: Best for enterprise teams with compliance requirements 4. **Notion + Agent**: Best for product teams managing both docs and tasks
472
+
473
+ ### For API-First Agent Integration
474
+
475
+ **Recommended stack for custom AI agents**:
476
+
477
+ 1. **Primary**: Linear (cleanest GraphQL API, agent-first design)
478
+ 2. **Alternative**: GitHub (if already using GitHub for code)
479
+ 3. **Enterprise**: Jira (if Atlassian ecosystem is required)
480
+
481
+ **MCP Server Quality**:
482
+
483
+ - **Best**: Linear (multiple high-quality servers), GitHub (official)
484
+ - **Good**: Notion (official, enterprise features), Jira (third-party)
485
+ - **Limited**: ClickUp, Monday, Shortcut (Zapier-dependent)
486
+
487
+ ### For Claude Code / Claude Workflows Specifically
488
+
489
+ 1. **GitHub**: Official MCP server, can read issues, create PRs
490
+ 2. **Linear**: Excellent MCP servers (tacticlaunch, composio)
491
+ 3. **Notion**: Official MCP with enterprise audit logging
492
+ 4. **Jira**: Third-party MCP (tray.ai, workato)
493
+
494
+ ---
495
+
496
+ ## Market Trends & Predictions
497
+
498
+ ### 2026 State of the Market
499
+
500
+ - **85% of developers** now use AI tools for coding (up from ~40% in 2023)
501
+ - **AI agent market**: $7.6B (2025) projected to $50B+ (2030)
502
+ - **Gartner prediction**: 80% of PM work eliminated by AI by 2030
503
+ - **40% of enterprise apps** will use task-specific AI agents by end of 2026
504
+
505
+ ### Key Shifts Observed
506
+
507
+ 1. **From AI-assisted to AI-autonomous**: Tools no longer just suggest; they execute
508
+ 2. **Agents as team members**: Linear and GitHub treat AI as assignable teammates
509
+ 3. **MCP as standard**: Model Context Protocol becoming the integration standard
510
+ 4. **Natural language becoming UI**: Jira and ClickUp let you create automations in plain English
511
+ 5. **Parallel agent execution**: Tools like Conductor, Cursor support multiple agents simultaneously
512
+
513
+ ### What's Coming
514
+
515
+ - **GitHub**: Expanding Copilot to handle more complex multi-step tasks
516
+ - **Linear**: Custom agents marketplace
517
+ - **Notion**: Trigger-based autonomous agents
518
+ - **Jira**: Deeper Rovo integration across Atlassian suite
519
+ - **Industry-wide**: MCP adoption accelerating, more tools becoming "agent-accessible"
520
+
521
+ ---
522
+
523
+ ## Conclusion
524
+
525
+ For teams building AI-augmented development workflows in 2026:
526
+
527
+ 1. **If you're on GitHub**: Use Copilot coding agent. It's mature, integrated, and handles the full issue-to-PR workflow.
528
+
529
+ 2. **If you want the best AI-native experience**: Use Linear. It was designed from the ground up to treat AI agents as teammates.
530
+
531
+ 3. **If you're enterprise Atlassian**: Use Jira + Rovo. The natural language automation and agent platform are mature enough for production.
532
+
533
+ 4. **If you need docs + tasks**: Use Notion. The Agent features are powerful, especially with the January 2026 mobile updates.
534
+
535
+ 5. **For custom AI agents via API**: Linear's GraphQL API and MCP servers are the cleanest to work with. GitHub is a close second.
536
+
537
+ The tools have caught up to the vision of AI-augmented development. The question is no longer "can the tools support AI?" but "which tool matches your team's AI-first workflow best?"
538
+
539
+ ---
540
+
541
+ _Last updated: January 21, 2026_