@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,162 +0,0 @@
1
- [
2
- {
3
- "title": "Overview",
4
- "description": "Explains what AIGNE DocSmith does, the problems it solves, and its main capabilities based on your project's code.",
5
- "path": "/overview",
6
- "sourceIds": ["README.md", "aigne.yaml", ".aigne/doc-smith/config.yaml"],
7
- "parentId": ""
8
- },
9
- {
10
- "title": "Getting Started",
11
- "description": "Provides a step-by-step guide to installing the tool and generating your first set of documents.",
12
- "path": "/getting-started",
13
- "sourceIds": ["README.md", "agents/init/index.mjs", "media.md"],
14
- "parentId": ""
15
- },
16
- {
17
- "title": "Guides",
18
- "description": "Contains step-by-step instructions for performing common documentation tasks.",
19
- "path": "/guides",
20
- "sourceIds": [
21
- "aigne.yaml",
22
- "README.md",
23
- "agents/generate/index.yaml",
24
- "agents/update/index.yaml",
25
- "agents/translate/index.yaml",
26
- "agents/publish/index.yaml",
27
- "agents/clear/index.yaml",
28
- "agents/evaluate/index.yaml",
29
- "agents/history/index.yaml",
30
- "agents/chat/index.yaml"
31
- ],
32
- "parentId": ""
33
- },
34
- {
35
- "title": "Configuration",
36
- "description": "Details how to set up the tool and manage personal preferences for document generation.",
37
- "path": "/configuration",
38
- "sourceIds": [
39
- "aigne.yaml",
40
- "agents/init/index.mjs",
41
- "agents/prefs/index.mjs",
42
- ".aigne/doc-smith/config.yaml"
43
- ],
44
- "parentId": ""
45
- },
46
- {
47
- "title": "Release Notes",
48
- "description": "Lists new features, improvements, and bug fixes for each version of the tool.",
49
- "path": "/release-notes",
50
- "sourceIds": ["CHANGELOG.md"],
51
- "parentId": ""
52
- },
53
- {
54
- "title": "Generating Documentation",
55
- "description": "Walks through the process of creating a new set of documents from your source files from start to finish.",
56
- "path": "/guides/generating-documentation",
57
- "sourceIds": [
58
- "agents/generate/index.yaml",
59
- "agents/generate/generate-structure.yaml",
60
- "agents/generate/user-review-document-structure.mjs",
61
- "agents/update/batch-generate-document.yaml",
62
- "README.md",
63
- "agents/generate/check-need-generate-structure.mjs",
64
- "agents/generate/refine-document-structure.yaml",
65
- "agents/generate/check-document-structure.yaml"
66
- ],
67
- "parentId": "/guides"
68
- },
69
- {
70
- "title": "Updating Documentation",
71
- "description": "Explains how to modify existing documents based on code changes or new feedback.",
72
- "path": "/guides/updating-documentation",
73
- "sourceIds": [
74
- "agents/update/index.yaml",
75
- "agents/update/update-single-document.yaml",
76
- "agents/update/batch-update-document.yaml",
77
- "agents/update/user-review-document.mjs",
78
- "README.md",
79
- "agents/update/check-update-is-single.mjs",
80
- "agents/update/handle-document-update.yaml",
81
- "agents/update/generate-document.yaml"
82
- ],
83
- "parentId": "/guides"
84
- },
85
- {
86
- "title": "Translating Documentation",
87
- "description": "Details the steps to translate your documents into multiple supported languages.",
88
- "path": "/guides/translating-documentation",
89
- "sourceIds": [
90
- "agents/translate/index.yaml",
91
- "agents/translate/translate-multilingual.yaml",
92
- "agents/translate/choose-language.mjs",
93
- "README.md",
94
- "agents/translate/translate-document.yaml",
95
- "agents/translate/record-translation-history.mjs"
96
- ],
97
- "parentId": "/guides"
98
- },
99
- {
100
- "title": "Publishing Your Docs",
101
- "description": "Shows how to make your generated documentation live and accessible online.",
102
- "path": "/guides/publishing-your-docs",
103
- "sourceIds": ["agents/publish/index.yaml", "agents/publish/publish-docs.mjs", "README.md"],
104
- "parentId": "/guides"
105
- },
106
- {
107
- "title": "Initial Setup",
108
- "description": "Guides you through the interactive setup process to create your initial configuration file.",
109
- "path": "/configuration/initial-setup",
110
- "sourceIds": ["agents/init/index.mjs", "README.md", ".aigne/doc-smith/config.yaml"],
111
- "parentId": "/configuration"
112
- },
113
- {
114
- "title": "Managing Preferences",
115
- "description": "Explains how to view, remove, and toggle your saved preferences for documentation generation.",
116
- "path": "/configuration/managing-preferences",
117
- "sourceIds": ["agents/prefs/index.mjs", "README.md"],
118
- "parentId": "/configuration"
119
- },
120
- {
121
- "title": "Managing History",
122
- "description": "Shows how to view the history of updates made to your documentation.",
123
- "path": "/guides/managing-history",
124
- "sourceIds": ["agents/history/view.mjs", "aigne.yaml", "agents/history/index.yaml"],
125
- "parentId": "/guides"
126
- },
127
- {
128
- "title": "Evaluating Documents",
129
- "description": "Details how to use the evaluation command to assess the quality and completeness of your generated documentation.",
130
- "path": "/guides/evaluating-documents",
131
- "sourceIds": [
132
- "agents/evaluate/index.yaml",
133
- "aigne.yaml",
134
- "agents/evaluate/document-structure.yaml",
135
- "agents/evaluate/document.yaml",
136
- "agents/evaluate/generate-report.mjs"
137
- ],
138
- "parentId": "/guides"
139
- },
140
- {
141
- "title": "Cleaning Up",
142
- "description": "Provides instructions on how to use the clear command to remove generated files, configurations, and cached data.",
143
- "path": "/guides/cleaning-up",
144
- "sourceIds": [
145
- "agents/clear/index.yaml",
146
- "aigne.yaml",
147
- "agents/clear/choose-contents.mjs",
148
- "agents/clear/clear-generated-docs.mjs",
149
- "agents/clear/clear-document-structure.mjs",
150
- "agents/clear/clear-document-config.mjs",
151
- "agents/clear/clear-auth-tokens.mjs"
152
- ],
153
- "parentId": "/guides"
154
- },
155
- {
156
- "title": "Interactive Chat",
157
- "description": "Explains how to use the interactive chat assistant to generate, modify, and manage your documentation.",
158
- "path": "/guides/interactive-chat",
159
- "sourceIds": ["agents/chat/index.yaml", "aigne.yaml"],
160
- "parentId": "/guides"
161
- }
162
- ]
@@ -1,97 +0,0 @@
1
- rules:
2
- - id: pref_cbc8005011c08ca0
3
- active: true
4
- scope: translation
5
- rule: In the table titled 'Cleanup Targets', the 'Target' column must retain the original text and should not be translated.
6
- feedback: Do not translate the Target column in the Cleanup Targets table.
7
- createdAt: 2025-10-11T13:22:06.529Z
8
- - id: pref_545cabc521ecd4a5
9
- active: true
10
- scope: translation
11
- rule: The proprietary term 'AIGNE Framework' must not be translated and must be retained in its original form.
12
- feedback: AIGNE Framework is a proper noun and has its own link; no translation is required.
13
- createdAt: 2025-10-11T12:26:37.517Z
14
- - id: pref_6e612d7ca8b7f3b6
15
- active: true
16
- scope: document
17
- rule: When describing publishing options, should use plain text instead of custom components, and recommend users to run
18
- their own Discuss Kit instance while providing relevant links.
19
- feedback: "Publishing options should not use custom components: recommend users to run their own Discuss Kit instance in
20
- the text, and add Discuss Kit related links"
21
- createdAt: 2025-09-07T02:18:22.237Z
22
- - id: pref_039b58c47bdf95c9
23
- active: true
24
- scope: document
25
- rule: In the "Prerequisites" section, should briefly introduce Node.js installation, specify using npm instead of pnpm,
26
- and guide users to the official website for detailed instructions.
27
- feedback: In the prerequisites section, provide a simple introduction on how to install Node.js, no need to install pnpm
28
- but use npm instead, guide users to the product official website for detailed installation instructions
29
- createdAt: 2025-09-07T02:06:39.559Z
30
- - id: pref_03a45a593f645ce2
31
- active: true
32
- scope: document
33
- rule: When describing Discuss Kit, must clearly state that it is a non-open-source service running on the official
34
- platform, not a self-hosted instance.
35
- feedback: "In the core features description about document publishing, show the official platform link, run your own
36
- Discuss Kit instance, not self-hosted: Discuss Kit is not open source."
37
- createdAt: 2025-09-07T01:59:12.876Z
38
- - id: pref_0c239f619329089f
39
- active: true
40
- scope: document
41
- rule: In the core features section, should use plain list format and add descriptions and links for AIGNE Hub and
42
- Discuss Kit.
43
- feedback: Core features section should not use custom component lists, change to plain lists, add descriptions and links
44
- for AIGNE Hub and Discuss Kit to help users understand these two products
45
- createdAt: 2025-09-07T01:53:22.969Z
46
- paths:
47
- - /overview
48
- - id: pref_4e8aa735b11d8484
49
- active: true
50
- scope: document
51
- rule: In the 'How It Works' document, only show DocSmith implementation details, should not include AIGNE Framework
52
- information.
53
- feedback: How it works section does not need to show AIGNE Framework, only need to show DocSmith implementation
54
- createdAt: 2025-09-06T13:15:10.272Z
55
- paths:
56
- - /advanced/how-it-works
57
- - id: pref_4ad26164f1f4fbf6
58
- active: true
59
- scope: document
60
- rule: When describing multi-language support features, must clearly state support for 12 languages and list two to three
61
- mainstream languages as examples.
62
- feedback: Multi-language support related features, clearly support 12 languages, no above statement, and give examples
63
- of two or three mainstream languages
64
- createdAt: 2025-09-06T12:55:42.678Z
65
- - id: pref_c84baec514ca5c60
66
- active: true
67
- scope: document
68
- rule: Core features list must describe product functionality characteristics, not promotional value or importance.
69
- feedback: Core features list should describe DocSmith's functional characteristics, not describe product importance like
70
- a promotional brochure
71
- createdAt: 2025-09-06T12:47:46.583Z
72
- - id: pref_6da200d8e6fec09e
73
- active: true
74
- scope: structure
75
- rule: Do not generate documentation about contribution guidelines.
76
- feedback: Remove contribution guidelines related documentation, this content is not ready yet
77
- createdAt: 2025-08-30T14:46:32.741Z
78
- - id: pref_8c619b5228f791e5
79
- active: true
80
- scope: document
81
- rule: Do not generate content about Mermaid chart validation, as charts have been changed to use D2.
82
- feedback: Remove mermaid chart validation related descriptions, charts now use D2
83
- createdAt: 2025-08-30T14:29:04.068Z
84
- - id: pref_0e154f58c22329fb
85
- active: true
86
- scope: document
87
- rule: Do not generate documentation content about development commands that are no longer supported.
88
- feedback: Remove development command related documentation, these development commands are no longer supported
89
- createdAt: 2025-08-30T14:13:50.446Z
90
- - id: pref_0112657e4103ba88
91
- active: true
92
- scope: structure
93
- rule: Update documentation structure based on the latest source code, can add new documents and modify document
94
- dependencies on source code, but prohibit modifying any existing document paths.
95
- feedback: Update documentation structure based on the latest source code, allow adding new documents and modifying
96
- document dependencies on source code, cannot modify existing document paths
97
- createdAt: 2025-08-30T14:03:47.434Z