living-ai-documentation 1.0.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 (203) hide show
  1. package/LICENSE +661 -0
  2. package/README.fr.md +344 -0
  3. package/README.md +344 -0
  4. package/dist/bin/cli.d.ts +3 -0
  5. package/dist/bin/cli.d.ts.map +1 -0
  6. package/dist/bin/cli.js +262 -0
  7. package/dist/bin/cli.js.map +1 -0
  8. package/dist/src/frontend/accuracy-gauge.js +70 -0
  9. package/dist/src/frontend/admin.html +1532 -0
  10. package/dist/src/frontend/annotations.js +585 -0
  11. package/dist/src/frontend/boot.js +101 -0
  12. package/dist/src/frontend/config.js +29 -0
  13. package/dist/src/frontend/confirm-modal.js +82 -0
  14. package/dist/src/frontend/context.html +1252 -0
  15. package/dist/src/frontend/dark-mode.js +20 -0
  16. package/dist/src/frontend/diagram/alignment.js +161 -0
  17. package/dist/src/frontend/diagram/clipboard.js +187 -0
  18. package/dist/src/frontend/diagram/constants.js +109 -0
  19. package/dist/src/frontend/diagram/custom-shapes.js +104 -0
  20. package/dist/src/frontend/diagram/debug.js +43 -0
  21. package/dist/src/frontend/diagram/drawio-export.js +649 -0
  22. package/dist/src/frontend/diagram/edge-panel.js +293 -0
  23. package/dist/src/frontend/diagram/edge-rendering.js +12 -0
  24. package/dist/src/frontend/diagram/evidence.js +146 -0
  25. package/dist/src/frontend/diagram/grid.js +78 -0
  26. package/dist/src/frontend/diagram/groups.js +102 -0
  27. package/dist/src/frontend/diagram/history.js +157 -0
  28. package/dist/src/frontend/diagram/image-name-modal.js +48 -0
  29. package/dist/src/frontend/diagram/image-upload.js +36 -0
  30. package/dist/src/frontend/diagram/label-editor.js +115 -0
  31. package/dist/src/frontend/diagram/link-panel.js +144 -0
  32. package/dist/src/frontend/diagram/main.js +364 -0
  33. package/dist/src/frontend/diagram/network.js +2214 -0
  34. package/dist/src/frontend/diagram/node-panel.js +389 -0
  35. package/dist/src/frontend/diagram/node-rendering.js +964 -0
  36. package/dist/src/frontend/diagram/persistence.js +168 -0
  37. package/dist/src/frontend/diagram/ports.js +421 -0
  38. package/dist/src/frontend/diagram/selection-overlay.js +387 -0
  39. package/dist/src/frontend/diagram/state.js +43 -0
  40. package/dist/src/frontend/diagram/t.js +3 -0
  41. package/dist/src/frontend/diagram/toast.js +21 -0
  42. package/dist/src/frontend/diagram/unlock-hold.js +206 -0
  43. package/dist/src/frontend/diagram/zoom.js +20 -0
  44. package/dist/src/frontend/diagram-link-modal.js +137 -0
  45. package/dist/src/frontend/diagram.html +1494 -0
  46. package/dist/src/frontend/documents.js +479 -0
  47. package/dist/src/frontend/export.js +338 -0
  48. package/dist/src/frontend/file-attach.js +178 -0
  49. package/dist/src/frontend/files-modal.js +243 -0
  50. package/dist/src/frontend/i18n/en.json +624 -0
  51. package/dist/src/frontend/i18n/fr.json +624 -0
  52. package/dist/src/frontend/i18n.js +32 -0
  53. package/dist/src/frontend/image-paste.js +126 -0
  54. package/dist/src/frontend/index.html +2806 -0
  55. package/dist/src/frontend/local-search.js +476 -0
  56. package/dist/src/frontend/metadata.js +318 -0
  57. package/dist/src/frontend/misc.js +92 -0
  58. package/dist/src/frontend/new-doc-modal.js +285 -0
  59. package/dist/src/frontend/new-folder-modal.js +169 -0
  60. package/dist/src/frontend/search.js +194 -0
  61. package/dist/src/frontend/shape-editor.html +685 -0
  62. package/dist/src/frontend/sidebar-helpers.js +96 -0
  63. package/dist/src/frontend/sidebar-resize.js +98 -0
  64. package/dist/src/frontend/sidebar.js +351 -0
  65. package/dist/src/frontend/snippet-detect.js +25 -0
  66. package/dist/src/frontend/snippet-table.js +85 -0
  67. package/dist/src/frontend/snippet-tree.js +94 -0
  68. package/dist/src/frontend/snippets.js +1146 -0
  69. package/dist/src/frontend/state.js +46 -0
  70. package/dist/src/frontend/utils.js +21 -0
  71. package/dist/src/frontend/validate.js +107 -0
  72. package/dist/src/frontend/vendor/wordcloud2.js +1187 -0
  73. package/dist/src/frontend/wordcloud.js +693 -0
  74. package/dist/src/lib/config.d.ts +26 -0
  75. package/dist/src/lib/config.d.ts.map +1 -0
  76. package/dist/src/lib/config.js +195 -0
  77. package/dist/src/lib/config.js.map +1 -0
  78. package/dist/src/lib/hash.d.ts +2 -0
  79. package/dist/src/lib/hash.d.ts.map +1 -0
  80. package/dist/src/lib/hash.js +18 -0
  81. package/dist/src/lib/hash.js.map +1 -0
  82. package/dist/src/lib/metadata.d.ts +31 -0
  83. package/dist/src/lib/metadata.d.ts.map +1 -0
  84. package/dist/src/lib/metadata.js +128 -0
  85. package/dist/src/lib/metadata.js.map +1 -0
  86. package/dist/src/lib/parser.d.ts +11 -0
  87. package/dist/src/lib/parser.d.ts.map +1 -0
  88. package/dist/src/lib/parser.js +111 -0
  89. package/dist/src/lib/parser.js.map +1 -0
  90. package/dist/src/lib/status.d.ts +9 -0
  91. package/dist/src/lib/status.d.ts.map +1 -0
  92. package/dist/src/lib/status.js +72 -0
  93. package/dist/src/lib/status.js.map +1 -0
  94. package/dist/src/mcp/server.d.ts +3 -0
  95. package/dist/src/mcp/server.d.ts.map +1 -0
  96. package/dist/src/mcp/server.js +2046 -0
  97. package/dist/src/mcp/server.js.map +1 -0
  98. package/dist/src/mcp/tools/diagrams.d.ts +82 -0
  99. package/dist/src/mcp/tools/diagrams.d.ts.map +1 -0
  100. package/dist/src/mcp/tools/diagrams.js +594 -0
  101. package/dist/src/mcp/tools/diagrams.js.map +1 -0
  102. package/dist/src/mcp/tools/documents.d.ts +44 -0
  103. package/dist/src/mcp/tools/documents.d.ts.map +1 -0
  104. package/dist/src/mcp/tools/documents.js +186 -0
  105. package/dist/src/mcp/tools/documents.js.map +1 -0
  106. package/dist/src/mcp/tools/git.d.ts +10 -0
  107. package/dist/src/mcp/tools/git.d.ts.map +1 -0
  108. package/dist/src/mcp/tools/git.js +217 -0
  109. package/dist/src/mcp/tools/git.js.map +1 -0
  110. package/dist/src/mcp/tools/metadata.d.ts +57 -0
  111. package/dist/src/mcp/tools/metadata.d.ts.map +1 -0
  112. package/dist/src/mcp/tools/metadata.js +222 -0
  113. package/dist/src/mcp/tools/metadata.js.map +1 -0
  114. package/dist/src/mcp/tools/source.d.ts +29 -0
  115. package/dist/src/mcp/tools/source.d.ts.map +1 -0
  116. package/dist/src/mcp/tools/source.js +196 -0
  117. package/dist/src/mcp/tools/source.js.map +1 -0
  118. package/dist/src/routes/annotations.d.ts +3 -0
  119. package/dist/src/routes/annotations.d.ts.map +1 -0
  120. package/dist/src/routes/annotations.js +83 -0
  121. package/dist/src/routes/annotations.js.map +1 -0
  122. package/dist/src/routes/browse-source.d.ts +3 -0
  123. package/dist/src/routes/browse-source.d.ts.map +1 -0
  124. package/dist/src/routes/browse-source.js +79 -0
  125. package/dist/src/routes/browse-source.js.map +1 -0
  126. package/dist/src/routes/browse.d.ts +3 -0
  127. package/dist/src/routes/browse.d.ts.map +1 -0
  128. package/dist/src/routes/browse.js +91 -0
  129. package/dist/src/routes/browse.js.map +1 -0
  130. package/dist/src/routes/config.d.ts +3 -0
  131. package/dist/src/routes/config.d.ts.map +1 -0
  132. package/dist/src/routes/config.js +145 -0
  133. package/dist/src/routes/config.js.map +1 -0
  134. package/dist/src/routes/context.d.ts +3 -0
  135. package/dist/src/routes/context.d.ts.map +1 -0
  136. package/dist/src/routes/context.js +287 -0
  137. package/dist/src/routes/context.js.map +1 -0
  138. package/dist/src/routes/diagrams.d.ts +3 -0
  139. package/dist/src/routes/diagrams.d.ts.map +1 -0
  140. package/dist/src/routes/diagrams.js +69 -0
  141. package/dist/src/routes/diagrams.js.map +1 -0
  142. package/dist/src/routes/documents.d.ts +11 -0
  143. package/dist/src/routes/documents.d.ts.map +1 -0
  144. package/dist/src/routes/documents.js +450 -0
  145. package/dist/src/routes/documents.js.map +1 -0
  146. package/dist/src/routes/export.d.ts +3 -0
  147. package/dist/src/routes/export.d.ts.map +1 -0
  148. package/dist/src/routes/export.js +280 -0
  149. package/dist/src/routes/export.js.map +1 -0
  150. package/dist/src/routes/files.d.ts +3 -0
  151. package/dist/src/routes/files.d.ts.map +1 -0
  152. package/dist/src/routes/files.js +180 -0
  153. package/dist/src/routes/files.js.map +1 -0
  154. package/dist/src/routes/images.d.ts +3 -0
  155. package/dist/src/routes/images.d.ts.map +1 -0
  156. package/dist/src/routes/images.js +49 -0
  157. package/dist/src/routes/images.js.map +1 -0
  158. package/dist/src/routes/metadata.d.ts +3 -0
  159. package/dist/src/routes/metadata.d.ts.map +1 -0
  160. package/dist/src/routes/metadata.js +131 -0
  161. package/dist/src/routes/metadata.js.map +1 -0
  162. package/dist/src/routes/shape-libraries.d.ts +3 -0
  163. package/dist/src/routes/shape-libraries.d.ts.map +1 -0
  164. package/dist/src/routes/shape-libraries.js +118 -0
  165. package/dist/src/routes/shape-libraries.js.map +1 -0
  166. package/dist/src/routes/wordcloud.d.ts +3 -0
  167. package/dist/src/routes/wordcloud.d.ts.map +1 -0
  168. package/dist/src/routes/wordcloud.js +95 -0
  169. package/dist/src/routes/wordcloud.js.map +1 -0
  170. package/dist/src/server.d.ts +7 -0
  171. package/dist/src/server.d.ts.map +1 -0
  172. package/dist/src/server.js +93 -0
  173. package/dist/src/server.js.map +1 -0
  174. package/dist/starter-doc/.living-doc.json +52 -0
  175. package/dist/starter-doc/ADRS/2026_01_01_[ADR]_example_architecture_decision.md +59 -0
  176. package/dist/starter-doc/AI/2026_01_01_how_to.md +112 -0
  177. package/dist/starter-doc/AI/PROJECT-INSTRUCTIONS.md +172 -0
  178. package/dist/starter-doc/AI/PROJECT-STACK.md +77 -0
  179. package/dist/starter-doc/AI/PROJECT-USEFUL-COMMANDS.md +80 -0
  180. package/dist/starter-doc/AI/default/AGENTS.md +31 -0
  181. package/dist/starter-doc/AI/default/CLAUDE.md +31 -0
  182. package/dist/starter-doc/AI/default/MEMORY.md +24 -0
  183. package/dist/starter-doc/AI/rules/no-magic-numbers.md +18 -0
  184. package/dist/starter-doc/AI/rules/track-current-work.md +23 -0
  185. package/dist/starter-doc/WORKLOG/current-task.md +57 -0
  186. package/dist/starter-doc-fr/.living-doc.json +52 -0
  187. package/dist/starter-doc-fr/ADRS/2026_01_01_[ADR]_example_architecture_decision.md +59 -0
  188. package/dist/starter-doc-fr/AI/2026_01_01_how_to.md +100 -0
  189. package/dist/starter-doc-fr/AI/PROJECT-INSTRUCTIONS.md +172 -0
  190. package/dist/starter-doc-fr/AI/PROJECT-STACK.md +77 -0
  191. package/dist/starter-doc-fr/AI/PROJECT-USEFUL-COMMANDS.md +80 -0
  192. package/dist/starter-doc-fr/AI/default/AGENTS.md +31 -0
  193. package/dist/starter-doc-fr/AI/default/CLAUDE.md +31 -0
  194. package/dist/starter-doc-fr/AI/default/MEMORY.md +24 -0
  195. package/dist/starter-doc-fr/AI/rules/no-magic-numbers.md +18 -0
  196. package/dist/starter-doc-fr/AI/rules/track-current-work.md +23 -0
  197. package/dist/starter-doc-fr/WORKLOG/current-task.md +57 -0
  198. package/images/living_documentation.jpg +0 -0
  199. package/images/readme-extra-files.png +0 -0
  200. package/images/readme-filename-pattern.png +0 -0
  201. package/images/readme-intelligent-search-demo.jpg +0 -0
  202. package/images/readme-sidebar.png +0 -0
  203. package/package.json +72 -0
@@ -0,0 +1,243 @@
1
+ // ── Files modal ─────────────────────────────────────────────────────────────
2
+ // Lists files stored under DOCS_FOLDER/files/, sorted by upload order (the
3
+ // server-assigned filename starts with a YYYYMMDDHHmmss timestamp, so a lex
4
+ // sort is chronological). Supports replacing a file with a new version
5
+ // (overwrites in place, no history kept) and deleting it.
6
+
7
+ const _filesMaxBytes = 19 * 1024 * 1024;
8
+
9
+ function _filesT(key) {
10
+ return window.t ? window.t(key) : key;
11
+ }
12
+
13
+ function _filesEscape(s) {
14
+ return String(s)
15
+ .replace(/&/g, "&")
16
+ .replace(/</g, "&lt;")
17
+ .replace(/>/g, "&gt;")
18
+ .replace(/"/g, "&quot;")
19
+ .replace(/'/g, "&#39;");
20
+ }
21
+
22
+ function _filesFormatSize(bytes) {
23
+ if (bytes < 1024) {
24
+ return _filesT("files.size_bytes").replace("{n}", String(bytes));
25
+ }
26
+ if (bytes < 1024 * 1024) {
27
+ return _filesT("files.size_kb").replace("{n}", (bytes / 1024).toFixed(1));
28
+ }
29
+ return _filesT("files.size_mb").replace(
30
+ "{n}",
31
+ (bytes / 1024 / 1024).toFixed(2),
32
+ );
33
+ }
34
+
35
+ function _filesFormatDate(iso) {
36
+ if (!iso) return "";
37
+ const d = new Date(iso);
38
+ if (isNaN(d.getTime())) return "";
39
+ const pad = (n) => String(n).padStart(2, "0");
40
+ return (
41
+ `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
42
+ `${pad(d.getHours())}:${pad(d.getMinutes())}`
43
+ );
44
+ }
45
+
46
+ function _filesReadAsBase64(file) {
47
+ return new Promise((resolve, reject) => {
48
+ const reader = new FileReader();
49
+ reader.onload = () => resolve(reader.result);
50
+ reader.onerror = reject;
51
+ reader.readAsDataURL(file);
52
+ });
53
+ }
54
+
55
+ async function _filesRender() {
56
+ const body = document.getElementById("files-modal-body");
57
+ if (!body) return;
58
+ body.innerHTML = `<p class="text-sm text-gray-400">${_filesEscape(_filesT("common.loading"))}</p>`;
59
+
60
+ let list = [];
61
+ try {
62
+ const res = await fetch("/api/files");
63
+ if (!res.ok) throw new Error(`HTTP ${res.status}`);
64
+ const data = await res.json();
65
+ list = Array.isArray(data.files) ? data.files : [];
66
+ } catch (err) {
67
+ body.innerHTML = `<p class="text-sm text-red-500 dark:text-red-400">${_filesEscape(_filesT("files.error_load"))}${_filesEscape(err.message || String(err))}</p>`;
68
+ return;
69
+ }
70
+
71
+ if (list.length === 0) {
72
+ body.innerHTML = `<p class="text-sm text-gray-500 dark:text-gray-400">${_filesEscape(_filesT("files.empty"))}</p>`;
73
+ return;
74
+ }
75
+
76
+ const rows = list
77
+ .map((f) => {
78
+ const name = _filesEscape(f.displayName || f.filename);
79
+ const date = _filesEscape(_filesFormatDate(f.uploadedAt));
80
+ const size = _filesEscape(_filesFormatSize(f.size || 0));
81
+ const url = _filesEscape(f.url);
82
+ const filenameAttr = _filesEscape(f.filename);
83
+ return `
84
+ <li class="py-3 flex items-center gap-3">
85
+ <i class="fa-solid fa-paperclip text-purple-500 shrink-0"></i>
86
+ <div class="flex-1 min-w-0">
87
+ <a href="${url}" target="_blank" rel="noopener"
88
+ class="block text-sm text-gray-900 dark:text-gray-100 hover:underline truncate">
89
+ ${name}
90
+ </a>
91
+ <div class="text-xs text-gray-500 dark:text-gray-400">${date}${date ? " · " : ""}${size}</div>
92
+ </div>
93
+ <button
94
+ type="button"
95
+ data-files-replace="${filenameAttr}"
96
+ data-files-display="${name}"
97
+ class="text-xs px-2 py-1 rounded-lg border border-gray-200 dark:border-gray-700 text-gray-600 dark:text-gray-400 hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors shrink-0"
98
+ >${_filesEscape(_filesT("files.replace"))}</button>
99
+ <button
100
+ type="button"
101
+ data-files-delete="${filenameAttr}"
102
+ data-files-display="${name}"
103
+ class="text-xs px-2 py-1 rounded-lg border border-red-200 dark:border-red-900 text-red-600 dark:text-red-400 hover:bg-red-50 dark:hover:bg-red-900/20 transition-colors shrink-0"
104
+ >${_filesEscape(_filesT("files.delete"))}</button>
105
+ </li>`;
106
+ })
107
+ .join("");
108
+
109
+ body.innerHTML = `<ul class="divide-y divide-gray-100 dark:divide-gray-800">${rows}</ul>`;
110
+
111
+ body.querySelectorAll("[data-files-replace]").forEach((btn) => {
112
+ btn.addEventListener("click", () => {
113
+ const filename = btn.getAttribute("data-files-replace");
114
+ const display = btn.getAttribute("data-files-display") || filename;
115
+ _filesReplace(filename, display, btn);
116
+ });
117
+ });
118
+ body.querySelectorAll("[data-files-delete]").forEach((btn) => {
119
+ btn.addEventListener("click", () => {
120
+ const filename = btn.getAttribute("data-files-delete");
121
+ const display = btn.getAttribute("data-files-display") || filename;
122
+ _filesDelete(filename, display, btn);
123
+ });
124
+ });
125
+ }
126
+
127
+ function _filesReplace(filename, displayName, triggerBtn) {
128
+ const input = document.createElement("input");
129
+ input.type = "file";
130
+ input.style.display = "none";
131
+ document.body.appendChild(input);
132
+ input.addEventListener("change", async () => {
133
+ const file = input.files && input.files[0];
134
+ input.remove();
135
+ if (!file) return;
136
+
137
+ const ok = await window.showConfirm({
138
+ title: _filesT("files.confirm_replace_title"),
139
+ message: _filesT("files.confirm_replace_message")
140
+ .replace("{name}", displayName)
141
+ .replace("{newName}", file.name),
142
+ detail: _filesT("files.confirm_replace_detail"),
143
+ confirmLabel: _filesT("files.replace"),
144
+ danger: true,
145
+ });
146
+ if (!ok) return;
147
+
148
+ if (file.size > _filesMaxBytes) {
149
+ const mb = (file.size / 1024 / 1024).toFixed(1);
150
+ window.alert(
151
+ _filesT("files.error_replace") + `${mb} MB (max 19 MB)`,
152
+ );
153
+ return;
154
+ }
155
+
156
+ const originalLabel = triggerBtn.textContent;
157
+ triggerBtn.disabled = true;
158
+ triggerBtn.textContent = _filesT("files.replacing");
159
+ try {
160
+ const base64 = await _filesReadAsBase64(file);
161
+ const res = await fetch(
162
+ "/api/files/" + encodeURIComponent(filename),
163
+ {
164
+ method: "PUT",
165
+ headers: { "Content-Type": "application/json" },
166
+ body: JSON.stringify({ data: base64 }),
167
+ },
168
+ );
169
+ if (!res.ok) {
170
+ let msg = `HTTP ${res.status}`;
171
+ try {
172
+ const body = await res.json();
173
+ if (body.error) msg = body.error;
174
+ } catch { /* ignore */ }
175
+ throw new Error(msg);
176
+ }
177
+ closeFilesModal();
178
+ if (window.runSearchImmediate) {
179
+ window.runSearchImmediate("metadata://" + filename);
180
+ }
181
+ } catch (err) {
182
+ triggerBtn.disabled = false;
183
+ triggerBtn.textContent = originalLabel;
184
+ window.alert(_filesT("files.error_replace") + (err.message || String(err)));
185
+ }
186
+ });
187
+ input.click();
188
+ }
189
+
190
+ async function _filesDelete(filename, displayName, triggerBtn) {
191
+ const ok = await window.showConfirm({
192
+ title: _filesT("files.confirm_delete_title"),
193
+ message: _filesT("files.confirm_delete_message").replace(
194
+ "{name}",
195
+ displayName,
196
+ ),
197
+ detail: _filesT("files.confirm_delete_detail"),
198
+ confirmLabel: _filesT("files.delete"),
199
+ danger: true,
200
+ });
201
+ if (!ok) return;
202
+
203
+ const originalLabel = triggerBtn.textContent;
204
+ triggerBtn.disabled = true;
205
+ triggerBtn.textContent = _filesT("files.deleting");
206
+ try {
207
+ const res = await fetch("/api/files/" + encodeURIComponent(filename), {
208
+ method: "DELETE",
209
+ });
210
+ if (!res.ok) {
211
+ let msg = `HTTP ${res.status}`;
212
+ try {
213
+ const body = await res.json();
214
+ if (body.error) msg = body.error;
215
+ } catch { /* ignore */ }
216
+ throw new Error(msg);
217
+ }
218
+ closeFilesModal();
219
+ if (window.runSearchImmediate) {
220
+ window.runSearchImmediate("metadata://" + filename);
221
+ }
222
+ } catch (err) {
223
+ triggerBtn.disabled = false;
224
+ triggerBtn.textContent = originalLabel;
225
+ window.alert(_filesT("files.error_delete") + (err.message || String(err)));
226
+ }
227
+ }
228
+
229
+ function openFilesModal() {
230
+ const modal = document.getElementById("files-modal");
231
+ if (!modal) return;
232
+ modal.classList.remove("hidden");
233
+ _filesRender();
234
+ }
235
+
236
+ function closeFilesModal() {
237
+ const modal = document.getElementById("files-modal");
238
+ if (!modal) return;
239
+ modal.classList.add("hidden");
240
+ }
241
+
242
+ window.openFilesModal = openFilesModal;
243
+ window.closeFilesModal = closeFilesModal;