mdcontext 0.0.1 → 0.1.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 (140) hide show
  1. package/.changeset/README.md +28 -0
  2. package/.changeset/config.json +11 -0
  3. package/.github/workflows/ci.yml +83 -0
  4. package/.github/workflows/release.yml +113 -0
  5. package/.tldrignore +112 -0
  6. package/AGENTS.md +46 -0
  7. package/BACKLOG.md +338 -0
  8. package/README.md +231 -11
  9. package/biome.json +36 -0
  10. package/cspell.config.yaml +14 -0
  11. package/dist/chunk-KRYIFLQR.js +92 -0
  12. package/dist/chunk-S7E6TFX6.js +742 -0
  13. package/dist/chunk-VVTGZNBT.js +1519 -0
  14. package/dist/cli/main.d.ts +1 -0
  15. package/dist/cli/main.js +2015 -0
  16. package/dist/index.d.ts +266 -0
  17. package/dist/index.js +86 -0
  18. package/dist/mcp/server.d.ts +1 -0
  19. package/dist/mcp/server.js +376 -0
  20. package/docs/019-USAGE.md +586 -0
  21. package/docs/020-current-implementation.md +364 -0
  22. package/docs/021-DOGFOODING-FINDINGS.md +175 -0
  23. package/docs/BACKLOG.md +80 -0
  24. package/docs/DESIGN.md +439 -0
  25. package/docs/PROJECT.md +88 -0
  26. package/docs/ROADMAP.md +407 -0
  27. package/docs/test-links.md +9 -0
  28. package/package.json +69 -10
  29. package/pnpm-workspace.yaml +5 -0
  30. package/research/config-analysis/01-current-implementation.md +470 -0
  31. package/research/config-analysis/02-strategy-recommendation.md +428 -0
  32. package/research/config-analysis/03-task-candidates.md +715 -0
  33. package/research/config-analysis/033-research-configuration-management.md +828 -0
  34. package/research/config-analysis/034-research-effect-cli-config.md +1504 -0
  35. package/research/config-analysis/04-consolidated-task-candidates.md +277 -0
  36. package/research/dogfood/consolidated-tool-evaluation.md +373 -0
  37. package/research/dogfood/strategy-a/a-synthesis.md +184 -0
  38. package/research/dogfood/strategy-a/a1-docs.md +226 -0
  39. package/research/dogfood/strategy-a/a2-amorphic.md +156 -0
  40. package/research/dogfood/strategy-a/a3-llm.md +164 -0
  41. package/research/dogfood/strategy-b/b-synthesis.md +228 -0
  42. package/research/dogfood/strategy-b/b1-architecture.md +207 -0
  43. package/research/dogfood/strategy-b/b2-gaps.md +258 -0
  44. package/research/dogfood/strategy-b/b3-workflows.md +250 -0
  45. package/research/dogfood/strategy-c/c-synthesis.md +451 -0
  46. package/research/dogfood/strategy-c/c1-explorer.md +192 -0
  47. package/research/dogfood/strategy-c/c2-diver-memory.md +145 -0
  48. package/research/dogfood/strategy-c/c3-diver-control.md +148 -0
  49. package/research/dogfood/strategy-c/c4-diver-failure.md +151 -0
  50. package/research/dogfood/strategy-c/c5-diver-execution.md +221 -0
  51. package/research/dogfood/strategy-c/c6-diver-org.md +221 -0
  52. package/research/effect-cli-error-handling.md +845 -0
  53. package/research/effect-errors-as-values.md +943 -0
  54. package/research/errors-task-analysis/00-consolidated-tasks.md +207 -0
  55. package/research/errors-task-analysis/cli-commands-analysis.md +909 -0
  56. package/research/errors-task-analysis/embeddings-analysis.md +709 -0
  57. package/research/errors-task-analysis/index-search-analysis.md +812 -0
  58. package/research/mdcontext-error-analysis.md +521 -0
  59. package/research/npm_publish/011-npm-workflow-research-agent2.md +792 -0
  60. package/research/npm_publish/012-npm-workflow-research-agent1.md +530 -0
  61. package/research/npm_publish/013-npm-workflow-research-agent3.md +722 -0
  62. package/research/npm_publish/014-npm-workflow-synthesis.md +556 -0
  63. package/research/npm_publish/031-npm-workflow-task-analysis.md +134 -0
  64. package/research/semantic-search/002-research-embedding-models.md +490 -0
  65. package/research/semantic-search/003-research-rag-alternatives.md +523 -0
  66. package/research/semantic-search/004-research-vector-search.md +841 -0
  67. package/research/semantic-search/032-research-semantic-search.md +427 -0
  68. package/research/task-management-2026/00-synthesis-recommendations.md +295 -0
  69. package/research/task-management-2026/01-ai-workflow-tools.md +416 -0
  70. package/research/task-management-2026/02-agent-framework-patterns.md +476 -0
  71. package/research/task-management-2026/03-lightweight-file-based.md +567 -0
  72. package/research/task-management-2026/04-established-tools-ai-features.md +541 -0
  73. package/research/task-management-2026/linear/01-core-features-workflow.md +771 -0
  74. package/research/task-management-2026/linear/02-api-integrations.md +930 -0
  75. package/research/task-management-2026/linear/03-ai-features.md +368 -0
  76. package/research/task-management-2026/linear/04-pricing-setup.md +205 -0
  77. package/research/task-management-2026/linear/05-usage-patterns-best-practices.md +605 -0
  78. package/scripts/rebuild-hnswlib.js +63 -0
  79. package/src/cli/argv-preprocessor.test.ts +210 -0
  80. package/src/cli/argv-preprocessor.ts +202 -0
  81. package/src/cli/cli.test.ts +430 -0
  82. package/src/cli/commands/backlinks.ts +54 -0
  83. package/src/cli/commands/context.ts +197 -0
  84. package/src/cli/commands/index-cmd.ts +300 -0
  85. package/src/cli/commands/index.ts +13 -0
  86. package/src/cli/commands/links.ts +52 -0
  87. package/src/cli/commands/search.ts +451 -0
  88. package/src/cli/commands/stats.ts +146 -0
  89. package/src/cli/commands/tree.ts +107 -0
  90. package/src/cli/flag-schemas.ts +275 -0
  91. package/src/cli/help.ts +386 -0
  92. package/src/cli/index.ts +9 -0
  93. package/src/cli/main.ts +145 -0
  94. package/src/cli/options.ts +31 -0
  95. package/src/cli/typo-suggester.test.ts +105 -0
  96. package/src/cli/typo-suggester.ts +130 -0
  97. package/src/cli/utils.ts +126 -0
  98. package/src/core/index.ts +1 -0
  99. package/src/core/types.ts +140 -0
  100. package/src/embeddings/index.ts +8 -0
  101. package/src/embeddings/openai-provider.ts +165 -0
  102. package/src/embeddings/semantic-search.ts +583 -0
  103. package/src/embeddings/types.ts +82 -0
  104. package/src/embeddings/vector-store.ts +299 -0
  105. package/src/index/index.ts +4 -0
  106. package/src/index/indexer.ts +446 -0
  107. package/src/index/storage.ts +196 -0
  108. package/src/index/types.ts +109 -0
  109. package/src/index/watcher.ts +131 -0
  110. package/src/index.ts +8 -0
  111. package/src/mcp/server.ts +483 -0
  112. package/src/parser/index.ts +1 -0
  113. package/src/parser/parser.test.ts +291 -0
  114. package/src/parser/parser.ts +395 -0
  115. package/src/parser/section-filter.ts +270 -0
  116. package/src/search/query-parser.test.ts +260 -0
  117. package/src/search/query-parser.ts +319 -0
  118. package/src/search/searcher.test.ts +182 -0
  119. package/src/search/searcher.ts +602 -0
  120. package/src/summarize/budget-bugs.test.ts +620 -0
  121. package/src/summarize/formatters.ts +419 -0
  122. package/src/summarize/index.ts +20 -0
  123. package/src/summarize/summarizer.test.ts +275 -0
  124. package/src/summarize/summarizer.ts +528 -0
  125. package/src/summarize/verify-bugs.test.ts +238 -0
  126. package/src/utils/index.ts +1 -0
  127. package/src/utils/tokens.test.ts +142 -0
  128. package/src/utils/tokens.ts +186 -0
  129. package/tests/fixtures/cli/.mdcontext/config.json +8 -0
  130. package/tests/fixtures/cli/.mdcontext/indexes/documents.json +33 -0
  131. package/tests/fixtures/cli/.mdcontext/indexes/links.json +12 -0
  132. package/tests/fixtures/cli/.mdcontext/indexes/sections.json +233 -0
  133. package/tests/fixtures/cli/.mdcontext/vectors.bin +0 -0
  134. package/tests/fixtures/cli/.mdcontext/vectors.meta.json +1264 -0
  135. package/tests/fixtures/cli/README.md +9 -0
  136. package/tests/fixtures/cli/api-reference.md +11 -0
  137. package/tests/fixtures/cli/getting-started.md +11 -0
  138. package/tsconfig.json +26 -0
  139. package/vitest.config.ts +21 -0
  140. package/vitest.setup.ts +12 -0
package/tests/fixtures/cli/.mdcontext/indexes/sections.json ADDED
@@ -0,0 +1,233 @@
1
+ {
2
+ "version": 1,
3
+ "sections": {
4
+ "04c6e90faac2-test-project": {
5
+ "id": "04c6e90faac2-test-project",
6
+ "documentId": "04c6e90faac2",
7
+ "documentPath": "README.md",
8
+ "heading": "Test Project",
9
+ "level": 1,
10
+ "startLine": 1,
11
+ "endLine": 3,
12
+ "tokenCount": 23,
13
+ "hasCode": false,
14
+ "hasList": false,
15
+ "hasTable": false
16
+ },
17
+ "04c6e90faac2-overview": {
18
+ "id": "04c6e90faac2-overview",
19
+ "documentId": "04c6e90faac2",
20
+ "documentPath": "README.md",
21
+ "heading": "Overview",
22
+ "level": 2,
23
+ "startLine": 5,
24
+ "endLine": 9,
25
+ "tokenCount": 50,
26
+ "hasCode": false,
27
+ "hasList": false,
28
+ "hasTable": false
29
+ },
30
+ "392e93c0f22d-api-reference": {
31
+ "id": "392e93c0f22d-api-reference",
32
+ "documentId": "392e93c0f22d",
33
+ "documentPath": "api-reference.md",
34
+ "heading": "API Reference",
35
+ "level": 1,
36
+ "startLine": 1,
37
+ "endLine": 3,
38
+ "tokenCount": 22,
39
+ "hasCode": false,
40
+ "hasList": false,
41
+ "hasTable": false
42
+ },
43
+ "392e93c0f22d-endpoints": {
44
+ "id": "392e93c0f22d-endpoints",
45
+ "documentId": "392e93c0f22d",
46
+ "documentPath": "api-reference.md",
47
+ "heading": "Endpoints",
48
+ "level": 2,
49
+ "startLine": 5,
50
+ "endLine": 11,
51
+ "tokenCount": 84,
52
+ "hasCode": false,
53
+ "hasList": false,
54
+ "hasTable": true
55
+ },
56
+ "b6885e1f8555-getting-started": {
57
+ "id": "b6885e1f8555-getting-started",
58
+ "documentId": "b6885e1f8555",
59
+ "documentPath": "getting-started.md",
60
+ "heading": "Getting Started",
61
+ "level": 1,
62
+ "startLine": 1,
63
+ "endLine": 3,
64
+ "tokenCount": 21,
65
+ "hasCode": false,
66
+ "hasList": false,
67
+ "hasTable": false
68
+ },
69
+ "b6885e1f8555-installation": {
70
+ "id": "b6885e1f8555-installation",
71
+ "documentId": "b6885e1f8555",
72
+ "documentPath": "getting-started.md",
73
+ "heading": "Installation",
74
+ "level": 2,
75
+ "startLine": 5,
76
+ "endLine": 7,
77
+ "tokenCount": 21,
78
+ "hasCode": false,
79
+ "hasList": false,
80
+ "hasTable": false
81
+ },
82
+ "b6885e1f8555-usage": {
83
+ "id": "b6885e1f8555-usage",
84
+ "documentId": "b6885e1f8555",
85
+ "documentPath": "getting-started.md",
86
+ "heading": "Usage",
87
+ "level": 2,
88
+ "startLine": 9,
89
+ "endLine": 11,
90
+ "tokenCount": 19,
91
+ "hasCode": false,
92
+ "hasList": false,
93
+ "hasTable": false
94
+ }
95
+ },
96
+ "byHeading": {
97
+ "test project": [
98
+ "04c6e90faac2-test-project",
99
+ "04c6e90faac2-test-project",
100
+ "04c6e90faac2-test-project",
101
+ "04c6e90faac2-test-project",
102
+ "04c6e90faac2-test-project",
103
+ "04c6e90faac2-test-project",
104
+ "04c6e90faac2-test-project",
105
+ "04c6e90faac2-test-project",
106
+ "04c6e90faac2-test-project",
107
+ "04c6e90faac2-test-project",
108
+ "04c6e90faac2-test-project",
109
+ "04c6e90faac2-test-project",
110
+ "04c6e90faac2-test-project",
111
+ "04c6e90faac2-test-project",
112
+ "04c6e90faac2-test-project",
113
+ "04c6e90faac2-test-project"
114
+ ],
115
+ "overview": [
116
+ "04c6e90faac2-overview",
117
+ "04c6e90faac2-overview",
118
+ "04c6e90faac2-overview",
119
+ "04c6e90faac2-overview",
120
+ "04c6e90faac2-overview",
121
+ "04c6e90faac2-overview",
122
+ "04c6e90faac2-overview",
123
+ "04c6e90faac2-overview",
124
+ "04c6e90faac2-overview",
125
+ "04c6e90faac2-overview",
126
+ "04c6e90faac2-overview",
127
+ "04c6e90faac2-overview",
128
+ "04c6e90faac2-overview",
129
+ "04c6e90faac2-overview",
130
+ "04c6e90faac2-overview",
131
+ "04c6e90faac2-overview"
132
+ ],
133
+ "api reference": [
134
+ "392e93c0f22d-api-reference",
135
+ "392e93c0f22d-api-reference",
136
+ "392e93c0f22d-api-reference",
137
+ "392e93c0f22d-api-reference",
138
+ "392e93c0f22d-api-reference",
139
+ "392e93c0f22d-api-reference",
140
+ "392e93c0f22d-api-reference",
141
+ "392e93c0f22d-api-reference",
142
+ "392e93c0f22d-api-reference",
143
+ "392e93c0f22d-api-reference",
144
+ "392e93c0f22d-api-reference",
145
+ "392e93c0f22d-api-reference",
146
+ "392e93c0f22d-api-reference",
147
+ "392e93c0f22d-api-reference",
148
+ "392e93c0f22d-api-reference",
149
+ "392e93c0f22d-api-reference"
150
+ ],
151
+ "endpoints": [
152
+ "392e93c0f22d-endpoints",
153
+ "392e93c0f22d-endpoints",
154
+ "392e93c0f22d-endpoints",
155
+ "392e93c0f22d-endpoints",
156
+ "392e93c0f22d-endpoints",
157
+ "392e93c0f22d-endpoints",
158
+ "392e93c0f22d-endpoints",
159
+ "392e93c0f22d-endpoints",
160
+ "392e93c0f22d-endpoints",
161
+ "392e93c0f22d-endpoints",
162
+ "392e93c0f22d-endpoints",
163
+ "392e93c0f22d-endpoints",
164
+ "392e93c0f22d-endpoints",
165
+ "392e93c0f22d-endpoints",
166
+ "392e93c0f22d-endpoints",
167
+ "392e93c0f22d-endpoints"
168
+ ],
169
+ "getting started": [
170
+ "b6885e1f8555-getting-started",
171
+ "b6885e1f8555-getting-started",
172
+ "b6885e1f8555-getting-started",
173
+ "b6885e1f8555-getting-started",
174
+ "b6885e1f8555-getting-started",
175
+ "b6885e1f8555-getting-started",
176
+ "b6885e1f8555-getting-started",
177
+ "b6885e1f8555-getting-started",
178
+ "b6885e1f8555-getting-started",
179
+ "b6885e1f8555-getting-started",
180
+ "b6885e1f8555-getting-started",
181
+ "b6885e1f8555-getting-started",
182
+ "b6885e1f8555-getting-started",
183
+ "b6885e1f8555-getting-started",
184
+ "b6885e1f8555-getting-started",
185
+ "b6885e1f8555-getting-started"
186
+ ],
187
+ "installation": [
188
+ "b6885e1f8555-installation",
189
+ "b6885e1f8555-installation",
190
+ "b6885e1f8555-installation",
191
+ "b6885e1f8555-installation",
192
+ "b6885e1f8555-installation",
193
+ "b6885e1f8555-installation",
194
+ "b6885e1f8555-installation",
195
+ "b6885e1f8555-installation",
196
+ "b6885e1f8555-installation",
197
+ "b6885e1f8555-installation",
198
+ "b6885e1f8555-installation",
199
+ "b6885e1f8555-installation",
200
+ "b6885e1f8555-installation",
201
+ "b6885e1f8555-installation",
202
+ "b6885e1f8555-installation",
203
+ "b6885e1f8555-installation"
204
+ ],
205
+ "usage": [
206
+ "b6885e1f8555-usage",
207
+ "b6885e1f8555-usage",
208
+ "b6885e1f8555-usage",
209
+ "b6885e1f8555-usage",
210
+ "b6885e1f8555-usage",
211
+ "b6885e1f8555-usage",
212
+ "b6885e1f8555-usage",
213
+ "b6885e1f8555-usage",
214
+ "b6885e1f8555-usage",
215
+ "b6885e1f8555-usage",
216
+ "b6885e1f8555-usage",
217
+ "b6885e1f8555-usage",
218
+ "b6885e1f8555-usage",
219
+ "b6885e1f8555-usage",
220
+ "b6885e1f8555-usage",
221
+ "b6885e1f8555-usage"
222
+ ]
223
+ },
224
+ "byDocument": {
225
+ "04c6e90faac2": ["04c6e90faac2-test-project", "04c6e90faac2-overview"],
226
+ "392e93c0f22d": ["392e93c0f22d-api-reference", "392e93c0f22d-endpoints"],
227
+ "b6885e1f8555": [
228
+ "b6885e1f8555-getting-started",
229
+ "b6885e1f8555-installation",
230
+ "b6885e1f8555-usage"
231
+ ]
232
+ }
233
+ }