@aigne/doc-smith 0.8.12-beta.8 → 0.8.12

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 (264) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/agents/publish/index.yaml +4 -0
  3. package/agents/publish/publish-docs.mjs +77 -5
  4. package/agents/publish/translate-meta.mjs +103 -0
  5. package/agents/update/generate-document.yaml +30 -28
  6. package/agents/update/update-document-detail.yaml +3 -1
  7. package/agents/utils/update-branding.mjs +69 -0
  8. package/package.json +16 -2
  9. package/prompts/common/document/role-and-personality.md +3 -1
  10. package/prompts/detail/d2-diagram/guide.md +7 -1
  11. package/prompts/detail/d2-diagram/user-prompt.md +3 -0
  12. package/prompts/detail/generate/system-prompt.md +6 -7
  13. package/prompts/detail/generate/user-prompt.md +12 -3
  14. package/prompts/detail/update/user-prompt.md +0 -2
  15. package/prompts/structure/update/user-prompt.md +0 -4
  16. package/utils/file-utils.mjs +69 -24
  17. package/utils/markdown-checker.mjs +0 -20
  18. package/utils/request.mjs +7 -0
  19. package/utils/upload-files.mjs +231 -0
  20. package/utils/utils.mjs +11 -1
  21. package/.aigne/doc-smith/config.yaml +0 -77
  22. package/.aigne/doc-smith/history.yaml +0 -37
  23. package/.aigne/doc-smith/media-description.yaml +0 -91
  24. package/.aigne/doc-smith/output/structure-plan.json +0 -162
  25. package/.aigne/doc-smith/preferences.yml +0 -97
  26. package/.aigne/doc-smith/upload-cache.yaml +0 -1830
  27. package/.github/PULL_REQUEST_TEMPLATE.md +0 -28
  28. package/.github/workflows/ci.yml +0 -54
  29. package/.github/workflows/create-release-pr.yaml +0 -21
  30. package/.github/workflows/publish-docs.yml +0 -65
  31. package/.github/workflows/release.yml +0 -49
  32. package/.github/workflows/reviewer.yml +0 -54
  33. package/.release-please-manifest.json +0 -3
  34. package/RELEASE.md +0 -9
  35. package/assets/screenshots/doc-complete-setup.png +0 -0
  36. package/assets/screenshots/doc-generate-docs.png +0 -0
  37. package/assets/screenshots/doc-generate.png +0 -0
  38. package/assets/screenshots/doc-generated-successfully.png +0 -0
  39. package/assets/screenshots/doc-publish.png +0 -0
  40. package/assets/screenshots/doc-regenerate.png +0 -0
  41. package/assets/screenshots/doc-translate-langs.png +0 -0
  42. package/assets/screenshots/doc-translate.png +0 -0
  43. package/assets/screenshots/doc-update.png +0 -0
  44. package/biome.json +0 -73
  45. package/codecov.yml +0 -15
  46. package/docs/_sidebar.md +0 -15
  47. package/docs/configuration-initial-setup.ja.md +0 -179
  48. package/docs/configuration-initial-setup.md +0 -198
  49. package/docs/configuration-initial-setup.zh-TW.md +0 -179
  50. package/docs/configuration-initial-setup.zh.md +0 -179
  51. package/docs/configuration-managing-preferences.ja.md +0 -100
  52. package/docs/configuration-managing-preferences.md +0 -100
  53. package/docs/configuration-managing-preferences.zh-TW.md +0 -100
  54. package/docs/configuration-managing-preferences.zh.md +0 -100
  55. package/docs/configuration.ja.md +0 -69
  56. package/docs/configuration.md +0 -69
  57. package/docs/configuration.zh-TW.md +0 -69
  58. package/docs/configuration.zh.md +0 -69
  59. package/docs/getting-started.ja.md +0 -107
  60. package/docs/getting-started.md +0 -107
  61. package/docs/getting-started.zh-TW.md +0 -107
  62. package/docs/getting-started.zh.md +0 -107
  63. package/docs/guides-cleaning-up.ja.md +0 -51
  64. package/docs/guides-cleaning-up.md +0 -52
  65. package/docs/guides-cleaning-up.zh-TW.md +0 -51
  66. package/docs/guides-cleaning-up.zh.md +0 -51
  67. package/docs/guides-evaluating-documents.ja.md +0 -66
  68. package/docs/guides-evaluating-documents.md +0 -107
  69. package/docs/guides-evaluating-documents.zh-TW.md +0 -66
  70. package/docs/guides-evaluating-documents.zh.md +0 -66
  71. package/docs/guides-generating-documentation.ja.md +0 -151
  72. package/docs/guides-generating-documentation.md +0 -89
  73. package/docs/guides-generating-documentation.zh-TW.md +0 -151
  74. package/docs/guides-generating-documentation.zh.md +0 -151
  75. package/docs/guides-interactive-chat.ja.md +0 -85
  76. package/docs/guides-interactive-chat.md +0 -93
  77. package/docs/guides-interactive-chat.zh-TW.md +0 -85
  78. package/docs/guides-interactive-chat.zh.md +0 -85
  79. package/docs/guides-managing-history.ja.md +0 -48
  80. package/docs/guides-managing-history.md +0 -53
  81. package/docs/guides-managing-history.zh-TW.md +0 -48
  82. package/docs/guides-managing-history.zh.md +0 -48
  83. package/docs/guides-publishing-your-docs.ja.md +0 -78
  84. package/docs/guides-publishing-your-docs.md +0 -83
  85. package/docs/guides-publishing-your-docs.zh-TW.md +0 -78
  86. package/docs/guides-publishing-your-docs.zh.md +0 -78
  87. package/docs/guides-translating-documentation.ja.md +0 -95
  88. package/docs/guides-translating-documentation.md +0 -100
  89. package/docs/guides-translating-documentation.zh-TW.md +0 -95
  90. package/docs/guides-translating-documentation.zh.md +0 -95
  91. package/docs/guides-updating-documentation.ja.md +0 -77
  92. package/docs/guides-updating-documentation.md +0 -79
  93. package/docs/guides-updating-documentation.zh-TW.md +0 -77
  94. package/docs/guides-updating-documentation.zh.md +0 -77
  95. package/docs/guides.ja.md +0 -32
  96. package/docs/guides.md +0 -32
  97. package/docs/guides.zh-TW.md +0 -32
  98. package/docs/guides.zh.md +0 -32
  99. package/docs/overview.ja.md +0 -61
  100. package/docs/overview.md +0 -61
  101. package/docs/overview.zh-TW.md +0 -61
  102. package/docs/overview.zh.md +0 -61
  103. package/docs/release-notes.ja.md +0 -255
  104. package/docs/release-notes.md +0 -288
  105. package/docs/release-notes.zh-TW.md +0 -255
  106. package/docs/release-notes.zh.md +0 -255
  107. package/prompts/common/afs/afs-tools-usage.md +0 -5
  108. package/prompts/common/afs/use-afs-instruction.md +0 -1
  109. package/release-please-config.json +0 -14
  110. package/tests/agents/chat/chat.test.mjs +0 -46
  111. package/tests/agents/clear/choose-contents.test.mjs +0 -284
  112. package/tests/agents/clear/clear-auth-tokens.test.mjs +0 -268
  113. package/tests/agents/clear/clear-document-config.test.mjs +0 -167
  114. package/tests/agents/clear/clear-document-structure.test.mjs +0 -380
  115. package/tests/agents/clear/clear-generated-docs.test.mjs +0 -222
  116. package/tests/agents/evaluate/code-snippet.test.mjs +0 -163
  117. package/tests/agents/evaluate/fixtures/api-services.md +0 -87
  118. package/tests/agents/evaluate/fixtures/js-sdk.md +0 -94
  119. package/tests/agents/evaluate/generate-report.test.mjs +0 -312
  120. package/tests/agents/generate/check-document-structure.test.mjs +0 -45
  121. package/tests/agents/generate/check-need-generate-structure.test.mjs +0 -279
  122. package/tests/agents/generate/document-structure-tools/add-document.test.mjs +0 -449
  123. package/tests/agents/generate/document-structure-tools/delete-document.test.mjs +0 -410
  124. package/tests/agents/generate/document-structure-tools/generate-sub-structure.test.mjs +0 -277
  125. package/tests/agents/generate/document-structure-tools/move-document.test.mjs +0 -476
  126. package/tests/agents/generate/document-structure-tools/update-document.test.mjs +0 -548
  127. package/tests/agents/generate/generate-structure.test.mjs +0 -45
  128. package/tests/agents/generate/user-review-document-structure.test.mjs +0 -319
  129. package/tests/agents/history/view.test.mjs +0 -97
  130. package/tests/agents/init/init.test.mjs +0 -1657
  131. package/tests/agents/prefs/prefs.test.mjs +0 -431
  132. package/tests/agents/publish/publish-docs.test.mjs +0 -787
  133. package/tests/agents/translate/choose-language.test.mjs +0 -311
  134. package/tests/agents/translate/translate-document.test.mjs +0 -51
  135. package/tests/agents/update/check-document.test.mjs +0 -463
  136. package/tests/agents/update/check-update-is-single.test.mjs +0 -300
  137. package/tests/agents/update/document-tools/update-document-content.test.mjs +0 -329
  138. package/tests/agents/update/generate-document.test.mjs +0 -51
  139. package/tests/agents/update/save-and-translate-document.test.mjs +0 -369
  140. package/tests/agents/update/user-review-document.test.mjs +0 -582
  141. package/tests/agents/utils/action-success.test.mjs +0 -54
  142. package/tests/agents/utils/check-detail-result.test.mjs +0 -743
  143. package/tests/agents/utils/check-feedback-refiner.test.mjs +0 -478
  144. package/tests/agents/utils/choose-docs.test.mjs +0 -406
  145. package/tests/agents/utils/exit.test.mjs +0 -70
  146. package/tests/agents/utils/feedback-refiner.test.mjs +0 -51
  147. package/tests/agents/utils/find-item-by-path.test.mjs +0 -517
  148. package/tests/agents/utils/find-user-preferences-by-path.test.mjs +0 -382
  149. package/tests/agents/utils/format-document-structure.test.mjs +0 -364
  150. package/tests/agents/utils/fs.test.mjs +0 -267
  151. package/tests/agents/utils/load-sources.test.mjs +0 -1470
  152. package/tests/agents/utils/save-docs.test.mjs +0 -109
  153. package/tests/agents/utils/save-output.test.mjs +0 -315
  154. package/tests/agents/utils/save-single-doc.test.mjs +0 -364
  155. package/tests/agents/utils/transform-detail-datasources.test.mjs +0 -320
  156. package/tests/utils/auth-utils.test.mjs +0 -596
  157. package/tests/utils/blocklet.test.mjs +0 -336
  158. package/tests/utils/conflict-detector.test.mjs +0 -355
  159. package/tests/utils/constants.test.mjs +0 -295
  160. package/tests/utils/d2-utils.test.mjs +0 -437
  161. package/tests/utils/deploy.test.mjs +0 -399
  162. package/tests/utils/docs-finder-utils.test.mjs +0 -650
  163. package/tests/utils/file-utils.test.mjs +0 -521
  164. package/tests/utils/history-utils.test.mjs +0 -206
  165. package/tests/utils/kroki-utils.test.mjs +0 -646
  166. package/tests/utils/linter/fixtures/css/keyword-error.css +0 -1
  167. package/tests/utils/linter/fixtures/css/missing-semicolon.css +0 -1
  168. package/tests/utils/linter/fixtures/css/syntax-error.css +0 -1
  169. package/tests/utils/linter/fixtures/css/undeclare-variable.css +0 -1
  170. package/tests/utils/linter/fixtures/css/unused-variable.css +0 -2
  171. package/tests/utils/linter/fixtures/css/valid-code.css +0 -1
  172. package/tests/utils/linter/fixtures/dockerfile/keyword-error.dockerfile +0 -1
  173. package/tests/utils/linter/fixtures/dockerfile/missing-semicolon.dockerfile +0 -2
  174. package/tests/utils/linter/fixtures/dockerfile/syntax-error.dockerfile +0 -2
  175. package/tests/utils/linter/fixtures/dockerfile/undeclare-variable.dockerfile +0 -1
  176. package/tests/utils/linter/fixtures/dockerfile/unused-variable.dockerfile +0 -1
  177. package/tests/utils/linter/fixtures/dockerfile/valid-code.dockerfile +0 -2
  178. package/tests/utils/linter/fixtures/go/keyword-error.go +0 -5
  179. package/tests/utils/linter/fixtures/go/missing-semicolon.go +0 -5
  180. package/tests/utils/linter/fixtures/go/syntax-error.go +0 -6
  181. package/tests/utils/linter/fixtures/go/undeclare-variable.go +0 -5
  182. package/tests/utils/linter/fixtures/go/unused-variable.go +0 -5
  183. package/tests/utils/linter/fixtures/go/valid-code.go +0 -7
  184. package/tests/utils/linter/fixtures/js/keyword-error.js +0 -3
  185. package/tests/utils/linter/fixtures/js/missing-semicolon.js +0 -6
  186. package/tests/utils/linter/fixtures/js/syntax-error.js +0 -4
  187. package/tests/utils/linter/fixtures/js/undeclare-variable.js +0 -3
  188. package/tests/utils/linter/fixtures/js/unused-variable.js +0 -7
  189. package/tests/utils/linter/fixtures/js/valid-code.js +0 -15
  190. package/tests/utils/linter/fixtures/json/keyword-error.json +0 -1
  191. package/tests/utils/linter/fixtures/json/missing-semicolon.json +0 -1
  192. package/tests/utils/linter/fixtures/json/syntax-error.json +0 -1
  193. package/tests/utils/linter/fixtures/json/undeclare-variable.json +0 -1
  194. package/tests/utils/linter/fixtures/json/unused-variable.json +0 -1
  195. package/tests/utils/linter/fixtures/json/valid-code.json +0 -1
  196. package/tests/utils/linter/fixtures/jsx/keyword-error.jsx +0 -5
  197. package/tests/utils/linter/fixtures/jsx/missing-semicolon.jsx +0 -5
  198. package/tests/utils/linter/fixtures/jsx/syntax-error.jsx +0 -5
  199. package/tests/utils/linter/fixtures/jsx/undeclare-variable.jsx +0 -5
  200. package/tests/utils/linter/fixtures/jsx/unused-variable.jsx +0 -4
  201. package/tests/utils/linter/fixtures/jsx/valid-code.jsx +0 -5
  202. package/tests/utils/linter/fixtures/python/keyword-error.py +0 -3
  203. package/tests/utils/linter/fixtures/python/missing-semicolon.py +0 -2
  204. package/tests/utils/linter/fixtures/python/syntax-error.py +0 -3
  205. package/tests/utils/linter/fixtures/python/undeclare-variable.py +0 -3
  206. package/tests/utils/linter/fixtures/python/unused-variable.py +0 -6
  207. package/tests/utils/linter/fixtures/python/valid-code.py +0 -12
  208. package/tests/utils/linter/fixtures/ruby/keyword-error.rb +0 -2
  209. package/tests/utils/linter/fixtures/ruby/missing-semicolon.rb +0 -1
  210. package/tests/utils/linter/fixtures/ruby/syntax-error.rb +0 -2
  211. package/tests/utils/linter/fixtures/ruby/undeclare-variable.rb +0 -1
  212. package/tests/utils/linter/fixtures/ruby/unused-variable.rb +0 -2
  213. package/tests/utils/linter/fixtures/ruby/valid-code.rb +0 -1
  214. package/tests/utils/linter/fixtures/sass/keyword-error.sass +0 -2
  215. package/tests/utils/linter/fixtures/sass/missing-semicolon.sass +0 -3
  216. package/tests/utils/linter/fixtures/sass/syntax-error.sass +0 -3
  217. package/tests/utils/linter/fixtures/sass/undeclare-variable.sass +0 -2
  218. package/tests/utils/linter/fixtures/sass/unused-variable.sass +0 -4
  219. package/tests/utils/linter/fixtures/sass/valid-code.sass +0 -2
  220. package/tests/utils/linter/fixtures/scss/keyword-error.scss +0 -1
  221. package/tests/utils/linter/fixtures/scss/missing-semicolon.scss +0 -1
  222. package/tests/utils/linter/fixtures/scss/syntax-error.scss +0 -1
  223. package/tests/utils/linter/fixtures/scss/undeclare-variable.scss +0 -1
  224. package/tests/utils/linter/fixtures/scss/unused-variable.scss +0 -2
  225. package/tests/utils/linter/fixtures/scss/valid-code.scss +0 -1
  226. package/tests/utils/linter/fixtures/shell/keyword-error.sh +0 -5
  227. package/tests/utils/linter/fixtures/shell/missing-semicolon.sh +0 -3
  228. package/tests/utils/linter/fixtures/shell/syntax-error.sh +0 -4
  229. package/tests/utils/linter/fixtures/shell/undeclare-variable.sh +0 -3
  230. package/tests/utils/linter/fixtures/shell/unused-variable.sh +0 -4
  231. package/tests/utils/linter/fixtures/shell/valid-code.sh +0 -3
  232. package/tests/utils/linter/fixtures/ts/keyword-error.ts +0 -1
  233. package/tests/utils/linter/fixtures/ts/missing-semicolon.ts +0 -1
  234. package/tests/utils/linter/fixtures/ts/syntax-error.ts +0 -1
  235. package/tests/utils/linter/fixtures/ts/undeclare-variable.ts +0 -1
  236. package/tests/utils/linter/fixtures/ts/unused-variable.ts +0 -3
  237. package/tests/utils/linter/fixtures/ts/valid-code.ts +0 -3
  238. package/tests/utils/linter/fixtures/tsx/keyword-error.tsx +0 -5
  239. package/tests/utils/linter/fixtures/tsx/missing-semicolon.tsx +0 -5
  240. package/tests/utils/linter/fixtures/tsx/syntax-error.tsx +0 -5
  241. package/tests/utils/linter/fixtures/tsx/undeclare-variable.tsx +0 -6
  242. package/tests/utils/linter/fixtures/tsx/unused-variable.tsx +0 -6
  243. package/tests/utils/linter/fixtures/tsx/valid-code.tsx +0 -5
  244. package/tests/utils/linter/fixtures/vue/keyword-error.vue +0 -6
  245. package/tests/utils/linter/fixtures/vue/missing-semicolon.vue +0 -6
  246. package/tests/utils/linter/fixtures/vue/syntax-error.vue +0 -6
  247. package/tests/utils/linter/fixtures/vue/undeclare-variable.vue +0 -6
  248. package/tests/utils/linter/fixtures/vue/unused-variable.vue +0 -7
  249. package/tests/utils/linter/fixtures/vue/valid-code.vue +0 -6
  250. package/tests/utils/linter/fixtures/yaml/keyword-error.yml +0 -1
  251. package/tests/utils/linter/fixtures/yaml/missing-semicolon.yml +0 -2
  252. package/tests/utils/linter/fixtures/yaml/syntax-error.yml +0 -1
  253. package/tests/utils/linter/fixtures/yaml/undeclare-variable.yml +0 -1
  254. package/tests/utils/linter/fixtures/yaml/unused-variable.yml +0 -2
  255. package/tests/utils/linter/fixtures/yaml/valid-code.yml +0 -3
  256. package/tests/utils/linter/index.test.mjs +0 -440
  257. package/tests/utils/linter/scan-results.mjs +0 -42
  258. package/tests/utils/load-config.test.mjs +0 -141
  259. package/tests/utils/markdown/index.test.mjs +0 -478
  260. package/tests/utils/mermaid-validator.test.mjs +0 -541
  261. package/tests/utils/mock-chat-model.mjs +0 -12
  262. package/tests/utils/preferences-utils.test.mjs +0 -465
  263. package/tests/utils/save-value-to-config.test.mjs +0 -483
  264. package/tests/utils/utils.test.mjs +0 -941
@@ -1,521 +0,0 @@
1
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2
- import { mkdir, rm, writeFile } from "node:fs/promises";
3
- import { dirname, join } from "node:path";
4
- import { fileURLToPath } from "node:url";
5
- import {
6
- buildSourcesContent,
7
- calculateFileStats,
8
- getFilesWithGlob,
9
- loadFilesFromPaths,
10
- loadGitignore,
11
- pathExists,
12
- readFileContents,
13
- resolveToAbsolute,
14
- toDisplayPath,
15
- } from "../../utils/file-utils.mjs";
16
-
17
- const __dirname = dirname(fileURLToPath(import.meta.url));
18
-
19
- describe("file-utils", () => {
20
- let testDir;
21
-
22
- beforeEach(async () => {
23
- // Create a temporary test directory
24
- testDir = join(__dirname, "test-file-utils");
25
- await mkdir(testDir, { recursive: true });
26
- });
27
-
28
- afterEach(async () => {
29
- // Clean up test directory
30
- try {
31
- await rm(testDir, { recursive: true, force: true });
32
- } catch {
33
- // Ignore cleanup errors since they don't affect test results
34
- }
35
- });
36
-
37
- describe("loadGitignore", () => {
38
- test("should load gitignore patterns from current directory", async () => {
39
- const gitignorePath = join(testDir, ".gitignore");
40
- const gitignoreContent = `
41
- node_modules/
42
- dist/
43
- *.log
44
- .env
45
- # Comment line
46
- `.trim();
47
-
48
- await writeFile(gitignorePath, gitignoreContent);
49
-
50
- const patterns = await loadGitignore(testDir);
51
-
52
- expect(patterns).toBeDefined();
53
- expect(Array.isArray(patterns)).toBe(true);
54
- expect(patterns.length).toBeGreaterThan(0);
55
-
56
- // Should convert gitignore patterns to glob patterns
57
- expect(patterns.some((p) => p.includes("node_modules"))).toBe(true);
58
- expect(patterns.some((p) => p.includes("dist"))).toBe(true);
59
- expect(patterns.some((p) => p.includes("*.log"))).toBe(true);
60
- expect(patterns.some((p) => p.includes(".env"))).toBe(true);
61
- });
62
-
63
- test("should load gitignore patterns from git repository", async () => {
64
- const patterns = await loadGitignore(testDir);
65
- // Since we're in a git repository, it should load patterns
66
- expect(patterns).not.toBeNull();
67
- expect(Array.isArray(patterns)).toBe(true);
68
- });
69
-
70
- test("should handle empty gitignore file", async () => {
71
- const gitignorePath = join(testDir, ".gitignore");
72
- await writeFile(gitignorePath, "");
73
-
74
- const patterns = await loadGitignore(testDir);
75
- // Even with empty gitignore, parent git repo patterns are loaded
76
- expect(patterns).not.toBeNull();
77
- expect(Array.isArray(patterns)).toBe(true);
78
- });
79
-
80
- test("should ignore comment lines and empty lines", async () => {
81
- const gitignorePath = join(testDir, ".gitignore");
82
- const gitignoreContent = `
83
- # This is a comment
84
- node_modules/
85
-
86
- # Another comment
87
- *.log
88
- `.trim();
89
-
90
- await writeFile(gitignorePath, gitignoreContent);
91
-
92
- const patterns = await loadGitignore(testDir);
93
-
94
- expect(patterns).toBeDefined();
95
- // Should not contain empty strings or comments
96
- expect(patterns.every((p) => p.trim().length > 0 && !p.startsWith("#"))).toBe(true);
97
- });
98
-
99
- test("should handle various gitignore pattern formats", async () => {
100
- const gitignorePath = join(testDir, ".gitignore");
101
- const gitignoreContent = `
102
- /absolute-path
103
- relative-path
104
- directory/
105
- *.extension
106
- **/*.js
107
- temp*
108
- `.trim();
109
-
110
- await writeFile(gitignorePath, gitignoreContent);
111
-
112
- const patterns = await loadGitignore(testDir);
113
-
114
- expect(patterns).toBeDefined();
115
- expect(patterns.length).toBeGreaterThan(0);
116
-
117
- // Should handle different pattern types
118
- expect(patterns.some((p) => p.includes("absolute-path"))).toBe(true);
119
- expect(patterns.some((p) => p.includes("relative-path"))).toBe(true);
120
- expect(patterns.some((p) => p.includes("directory"))).toBe(true);
121
- expect(patterns.some((p) => p.includes("*.extension"))).toBe(true);
122
- });
123
- });
124
-
125
- describe("getFilesWithGlob", () => {
126
- beforeEach(async () => {
127
- // Create test file structure
128
- await mkdir(join(testDir, "src"), { recursive: true });
129
- await mkdir(join(testDir, "lib"), { recursive: true });
130
- await mkdir(join(testDir, "node_modules"), { recursive: true });
131
-
132
- await writeFile(join(testDir, "src", "index.js"), "// main file");
133
- await writeFile(join(testDir, "src", "utils.ts"), "// utils file");
134
- await writeFile(join(testDir, "lib", "helper.js"), "// helper file");
135
- await writeFile(join(testDir, "README.md"), "# readme");
136
- await writeFile(join(testDir, "package.json"), "{}");
137
- await writeFile(join(testDir, "node_modules", "dep.js"), "// dependency");
138
- });
139
-
140
- test("should find files with basic include patterns", async () => {
141
- const files = await getFilesWithGlob(testDir, ["*.js"], [], []);
142
-
143
- expect(files).toBeDefined();
144
- expect(Array.isArray(files)).toBe(true);
145
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
146
- expect(files.some((f) => f.includes("helper.js"))).toBe(true);
147
- });
148
-
149
- test("should exclude files based on exclude patterns", async () => {
150
- const files = await getFilesWithGlob(testDir, ["**/*.js"], ["node_modules/**"], []);
151
-
152
- expect(files).toBeDefined();
153
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
154
- expect(files.some((f) => f.includes("helper.js"))).toBe(true);
155
- expect(files.some((f) => f.includes("node_modules"))).toBe(false);
156
- });
157
-
158
- test("should handle multiple include patterns", async () => {
159
- const files = await getFilesWithGlob(testDir, ["*.js", "*.ts"], [], []);
160
-
161
- expect(files).toBeDefined();
162
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
163
- expect(files.some((f) => f.includes("utils.ts"))).toBe(true);
164
- expect(files.some((f) => f.includes("helper.js"))).toBe(true);
165
- });
166
-
167
- test("should handle gitignore patterns", async () => {
168
- const gitignorePatterns = ["node_modules/**"];
169
- const files = await getFilesWithGlob(testDir, ["**/*.js"], [], gitignorePatterns);
170
-
171
- expect(files).toBeDefined();
172
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
173
- expect(files.some((f) => f.includes("node_modules"))).toBe(false);
174
- });
175
-
176
- test("should return empty array for empty include patterns", async () => {
177
- const files = await getFilesWithGlob(testDir, [], [], []);
178
-
179
- expect(files).toBeDefined();
180
- expect(Array.isArray(files)).toBe(true);
181
- expect(files.length).toBe(0);
182
- });
183
-
184
- test("should return absolute paths", async () => {
185
- const files = await getFilesWithGlob(testDir, ["*.js"], [], []);
186
-
187
- expect(files).toBeDefined();
188
- files.forEach((file) => {
189
- expect(file.startsWith("/")).toBe(true);
190
- });
191
- });
192
-
193
- test("should handle nested directory patterns", async () => {
194
- await mkdir(join(testDir, "src", "components"), { recursive: true });
195
- await writeFile(join(testDir, "src", "components", "button.js"), "// button");
196
-
197
- const files = await getFilesWithGlob(testDir, ["src/**/*.js"], [], []);
198
-
199
- expect(files).toBeDefined();
200
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
201
- expect(files.some((f) => f.includes("button.js"))).toBe(true);
202
- });
203
-
204
- test("should handle complex glob patterns", async () => {
205
- const files = await getFilesWithGlob(testDir, ["**/*.{js,ts,md}"], ["node_modules/**"], []);
206
-
207
- expect(files).toBeDefined();
208
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
209
- expect(files.some((f) => f.includes("utils.ts"))).toBe(true);
210
- expect(files.some((f) => f.includes("README.md"))).toBe(true);
211
- expect(files.some((f) => f.includes("node_modules"))).toBe(false);
212
- });
213
-
214
- test("should handle non-existent directory gracefully", async () => {
215
- const nonExistentDir = join(testDir, "non-existent");
216
- const files = await getFilesWithGlob(nonExistentDir, ["*.js"], [], []);
217
-
218
- expect(files).toBeDefined();
219
- expect(Array.isArray(files)).toBe(true);
220
- expect(files.length).toBe(0);
221
- });
222
- });
223
-
224
- describe("pathExists", () => {
225
- test("should return true for existing file", async () => {
226
- const testFile = join(testDir, "exists.txt");
227
- await writeFile(testFile, "test");
228
-
229
- const exists = await pathExists(testFile);
230
- expect(exists).toBe(true);
231
- });
232
-
233
- test("should return true for existing directory", async () => {
234
- const exists = await pathExists(testDir);
235
- expect(exists).toBe(true);
236
- });
237
-
238
- test("should return false for non-existent path", async () => {
239
- const nonExistent = join(testDir, "does-not-exist.txt");
240
- const exists = await pathExists(nonExistent);
241
- expect(exists).toBe(false);
242
- });
243
- });
244
-
245
- describe("toDisplayPath", () => {
246
- test("should return relative path for paths inside cwd", () => {
247
- const testPath = join(process.cwd(), "test", "file.txt");
248
- const display = toDisplayPath(testPath);
249
- expect(display.startsWith("..")).toBe(false);
250
- expect(display).toContain("test");
251
- });
252
-
253
- test("should return absolute path for paths outside cwd", () => {
254
- const testPath = "/some/other/path/file.txt";
255
- const display = toDisplayPath(testPath);
256
- expect(display.startsWith("/") || display.startsWith("..")).toBe(true);
257
- });
258
-
259
- test("should return . for current directory", () => {
260
- const display = toDisplayPath(process.cwd());
261
- expect(display).toBe(".");
262
- });
263
- });
264
-
265
- describe("resolveToAbsolute", () => {
266
- test("should return absolute path as-is", () => {
267
- const absolutePath = "/absolute/path/file.txt";
268
- const resolved = resolveToAbsolute(absolutePath);
269
- expect(resolved).toBe(absolutePath);
270
- });
271
-
272
- test("should resolve relative path to absolute", () => {
273
- const relativePath = "relative/file.txt";
274
- const resolved = resolveToAbsolute(relativePath);
275
- expect(resolved).toBeDefined();
276
- expect(resolved?.startsWith("/")).toBe(true);
277
- expect(resolved).toContain("relative");
278
- });
279
-
280
- test("should return undefined for empty value", () => {
281
- expect(resolveToAbsolute("")).toBeUndefined();
282
- expect(resolveToAbsolute(null)).toBeUndefined();
283
- expect(resolveToAbsolute(undefined)).toBeUndefined();
284
- });
285
- });
286
-
287
- describe("loadFilesFromPaths", () => {
288
- beforeEach(async () => {
289
- await mkdir(join(testDir, "src"), { recursive: true });
290
- await mkdir(join(testDir, "docs"), { recursive: true });
291
- await writeFile(join(testDir, "src", "index.js"), "// index");
292
- await writeFile(join(testDir, "src", "utils.ts"), "// utils");
293
- await writeFile(join(testDir, "docs", "readme.md"), "# readme");
294
- await writeFile(join(testDir, "config.json"), "{}");
295
- });
296
-
297
- test("should load single file path", async () => {
298
- const filePath = join(testDir, "config.json");
299
- const files = await loadFilesFromPaths(filePath);
300
-
301
- expect(files).toBeDefined();
302
- expect(files.length).toBe(1);
303
- expect(files[0]).toBe(filePath);
304
- });
305
-
306
- test("should load multiple file paths", async () => {
307
- const file1 = join(testDir, "config.json");
308
- const file2 = join(testDir, "docs", "readme.md");
309
- const files = await loadFilesFromPaths([file1, file2]);
310
-
311
- expect(files.length).toBe(2);
312
- expect(files).toContain(file1);
313
- expect(files).toContain(file2);
314
- });
315
-
316
- test("should load files from directory with default patterns", async () => {
317
- const files = await loadFilesFromPaths(testDir, {
318
- useDefaultPatterns: true,
319
- defaultIncludePatterns: ["**/*.js", "**/*.ts"],
320
- defaultExcludePatterns: [],
321
- });
322
-
323
- expect(files.length).toBeGreaterThan(0);
324
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
325
- expect(files.some((f) => f.includes("utils.ts"))).toBe(true);
326
- });
327
-
328
- test("should handle glob patterns", async () => {
329
- const files = await loadFilesFromPaths(join(testDir, "**/*.js"));
330
-
331
- expect(files).toBeDefined();
332
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
333
- });
334
-
335
- test("should handle invalid paths gracefully", async () => {
336
- const files = await loadFilesFromPaths([123, null, "valid-but-not-exist"], {
337
- useDefaultPatterns: false,
338
- });
339
-
340
- expect(Array.isArray(files)).toBe(true);
341
- });
342
-
343
- test("should apply include and exclude patterns", async () => {
344
- const files = await loadFilesFromPaths(testDir, {
345
- includePatterns: ["**/*.js", "**/*.ts"],
346
- excludePatterns: ["**/*.ts"],
347
- useDefaultPatterns: false,
348
- });
349
-
350
- expect(files.some((f) => f.includes("index.js"))).toBe(true);
351
- expect(files.some((f) => f.includes("utils.ts"))).toBe(false);
352
- });
353
-
354
- test("should handle string patterns as array", async () => {
355
- const files = await loadFilesFromPaths(testDir, {
356
- includePatterns: "**/*.js",
357
- excludePatterns: "**/*.ts",
358
- useDefaultPatterns: false,
359
- });
360
-
361
- expect(Array.isArray(files)).toBe(true);
362
- });
363
- });
364
-
365
- describe("readFileContents", () => {
366
- beforeEach(async () => {
367
- await mkdir(join(testDir, "src"), { recursive: true });
368
- await writeFile(join(testDir, "src", "file1.js"), "const x = 1;");
369
- await writeFile(join(testDir, "src", "file2.js"), "const y = 2;");
370
- });
371
-
372
- test("should read multiple files with content", async () => {
373
- const files = [join(testDir, "src", "file1.js"), join(testDir, "src", "file2.js")];
374
- const contents = await readFileContents(files, testDir);
375
-
376
- expect(contents.length).toBe(2);
377
- expect(contents[0].sourceId).toContain("file1.js");
378
- expect(contents[0].content).toContain("const x = 1");
379
- expect(contents[1].sourceId).toContain("file2.js");
380
- expect(contents[1].content).toContain("const y = 2");
381
- });
382
-
383
- test("should use custom baseDir for relative paths", async () => {
384
- const files = [join(testDir, "src", "file1.js")];
385
- const contents = await readFileContents(files, testDir);
386
-
387
- expect(contents[0].sourceId).not.toContain(testDir);
388
- expect(contents[0].sourceId).toContain("src");
389
- });
390
-
391
- test("should skip binary files by default", async () => {
392
- const binaryFile = join(testDir, "binary.bin");
393
- await writeFile(binaryFile, Buffer.from([0xff, 0xfe, 0xfd, 0xfc]));
394
- const textFile = join(testDir, "text.txt");
395
- await writeFile(textFile, "text content");
396
-
397
- const contents = await readFileContents([binaryFile, textFile], testDir);
398
-
399
- expect(contents.length).toBeGreaterThanOrEqual(1);
400
- expect(contents.some((c) => c.sourceId.includes("text.txt"))).toBe(true);
401
- });
402
-
403
- test("should include binary files when skipBinaryFiles is false", async () => {
404
- const binaryFile = join(testDir, "binary.bin");
405
- await writeFile(binaryFile, Buffer.from([0x48, 0x65, 0x6c, 0x6c, 0x6f]));
406
-
407
- const contents = await readFileContents([binaryFile], testDir, {
408
- skipBinaryFiles: false,
409
- });
410
-
411
- expect(contents.length).toBeGreaterThanOrEqual(0);
412
- });
413
-
414
- test("should handle empty file array", async () => {
415
- const contents = await readFileContents([], testDir);
416
- expect(contents.length).toBe(0);
417
- });
418
- });
419
-
420
- describe("calculateFileStats", () => {
421
- test("should calculate tokens and lines correctly", () => {
422
- const sourceFiles = [
423
- { content: "const x = 1;\nconst y = 2;" },
424
- { content: "function test() {\n return true;\n}" },
425
- ];
426
-
427
- const stats = calculateFileStats(sourceFiles);
428
-
429
- expect(stats.totalTokens).toBeGreaterThan(0);
430
- expect(stats.totalLines).toBeGreaterThan(0);
431
- expect(stats.totalLines).toBeGreaterThan(3);
432
- });
433
-
434
- test("should handle empty content", () => {
435
- const sourceFiles = [{ content: "" }, { content: "" }];
436
- const stats = calculateFileStats(sourceFiles);
437
-
438
- expect(stats.totalTokens).toBe(0);
439
- expect(stats.totalLines).toBe(0);
440
- });
441
-
442
- test("should exclude empty lines from line count", () => {
443
- const sourceFiles = [{ content: "line1\n\nline2\n\n\nline3" }];
444
- const stats = calculateFileStats(sourceFiles);
445
-
446
- expect(stats.totalLines).toBe(3);
447
- });
448
-
449
- test("should handle files without content property", () => {
450
- const sourceFiles = [{ noContent: true }, { content: "test" }];
451
- const stats = calculateFileStats(sourceFiles);
452
-
453
- expect(stats.totalTokens).toBeGreaterThan(0);
454
- expect(stats.totalLines).toBe(1);
455
- });
456
- });
457
-
458
- describe("buildSourcesContent", () => {
459
- test("should build sources for normal context", () => {
460
- const sourceFiles = [
461
- { sourceId: "file1.js", content: "const x = 1;" },
462
- { sourceId: "file2.js", content: "const y = 2;" },
463
- ];
464
-
465
- const sources = buildSourcesContent(sourceFiles, false);
466
-
467
- expect(sources).toContain("// sourceId: file1.js");
468
- expect(sources).toContain("const x = 1;");
469
- expect(sources).toContain("// sourceId: file2.js");
470
- expect(sources).toContain("const y = 2;");
471
- expect(sources).not.toContain("Note: Context is large");
472
- });
473
-
474
- test("should filter core files for large context", () => {
475
- const sourceFiles = [
476
- { sourceId: "package.json", content: '{"name": "test"}' },
477
- { sourceId: "README.md", content: "# Test" },
478
- { sourceId: "random.js", content: "const x = 1;" },
479
- ];
480
-
481
- const sources = buildSourcesContent(sourceFiles, true);
482
-
483
- expect(sources).toContain("Note: Context is large");
484
- expect(sources).toContain("package.json");
485
- expect(sources).toContain("README.md");
486
- });
487
-
488
- test("should include core files matching patterns", () => {
489
- const sourceFiles = [
490
- { sourceId: "index.js", content: "// entry" },
491
- { sourceId: "main.ts", content: "// main" },
492
- { sourceId: "types.d.ts", content: "// types" },
493
- { sourceId: "api/routes.js", content: "// routes" },
494
- ];
495
-
496
- const sources = buildSourcesContent(sourceFiles, true);
497
-
498
- expect(sources).toContain("index.js");
499
- expect(sources).toContain("main.ts");
500
- expect(sources).toContain("types.d.ts");
501
- expect(sources).toContain("routes.js");
502
- });
503
-
504
- test("should handle empty sourceFiles array", () => {
505
- const sources = buildSourcesContent([], false);
506
- expect(sources).toBe("");
507
- });
508
-
509
- test("should use all files as fallback when no core files in large context", () => {
510
- const sourceFiles = [
511
- { sourceId: "random1.xyz", content: "test1" },
512
- { sourceId: "random2.xyz", content: "test2" },
513
- ];
514
-
515
- const sources = buildSourcesContent(sourceFiles, true);
516
-
517
- expect(sources).toContain("Note: Context is large");
518
- expect(sources).toContain("showing a sample of files");
519
- });
520
- });
521
- });