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,32 @@
1
+ // ── i18n loader ───────────────────────────────────────────────────────────────
2
+ // Regular script (not ES module) — works in all three pages.
3
+ // Exposes window.t(key), window.initI18n(lang), window.applyI18n().
4
+ (function () {
5
+ let _dict = {};
6
+
7
+ window.t = function (key) {
8
+ return _dict[key] !== undefined ? _dict[key] : key;
9
+ };
10
+
11
+ window.initI18n = async function (lang) {
12
+ try {
13
+ const res = await fetch('/i18n/' + (lang || 'en') + '.json');
14
+ if (res.ok) _dict = await res.json();
15
+ } catch { /* keep empty dict — keys used as fallback text */ }
16
+ };
17
+
18
+ window.applyI18n = function () {
19
+ document.querySelectorAll('[data-i18n]').forEach(function (el) {
20
+ el.textContent = window.t(el.dataset.i18n);
21
+ });
22
+ document.querySelectorAll('[data-i18n-title]').forEach(function (el) {
23
+ el.title = window.t(el.dataset.i18nTitle);
24
+ });
25
+ document.querySelectorAll('[data-i18n-placeholder]').forEach(function (el) {
26
+ el.placeholder = window.t(el.dataset.i18nPlaceholder);
27
+ });
28
+ document.querySelectorAll('[data-i18n-html]').forEach(function (el) {
29
+ el.innerHTML = window.t(el.dataset.i18nHtml);
30
+ });
31
+ };
32
+ })();
@@ -0,0 +1,126 @@
1
+ // ── Image paste + lightbox ──────────────────────────────────────────────────
2
+ // Handles Cmd/Ctrl+V image paste in the markdown editor and the image
3
+ // lightbox overlay used when clicking an image in a rendered document.
4
+
5
+ // State for the image paste confirmation flow
6
+ let _imgPasteBlob = null;
7
+ let _imgPasteExt = "png";
8
+ let _imgPasteCursorStart = 0;
9
+ let _imgPasteCursorEnd = 0;
10
+
11
+ // Strip diacritics (é → e, à → a, ç → c), lowercase, then replace anything
12
+ // that isn't [a-z0-9] by "_". Length is preserved so the input caret stays put.
13
+ const _LD_DIACRITICS_RE = new RegExp("[\\u0300-\\u036f]", "g");
14
+ function _sanitizeImageName(s) {
15
+ return (s || "")
16
+ .normalize("NFD")
17
+ .replace(_LD_DIACRITICS_RE, "")
18
+ .toLowerCase()
19
+ .replace(/[^a-z0-9]/g, "_");
20
+ }
21
+
22
+ function _wireImageNameSanitizer() {
23
+ const input = document.getElementById("img-paste-name");
24
+ if (!input || input.dataset.ldSanitizerWired === "1") return;
25
+ input.dataset.ldSanitizerWired = "1";
26
+ input.addEventListener("input", () => {
27
+ const pos = input.selectionStart;
28
+ const cleaned = _sanitizeImageName(input.value);
29
+ if (cleaned !== input.value) {
30
+ input.value = cleaned;
31
+ input.setSelectionRange(pos, pos);
32
+ }
33
+ });
34
+ }
35
+
36
+ async function handleEditorPaste(e) {
37
+ const items = Array.from(e.clipboardData?.items ?? []);
38
+ const imageItem = items.find((item) => item.type.startsWith("image/"));
39
+ if (!imageItem) return;
40
+
41
+ e.preventDefault();
42
+
43
+ const editor = document.getElementById("doc-editor");
44
+ _imgPasteCursorStart = editor.selectionStart;
45
+ _imgPasteCursorEnd = editor.selectionEnd;
46
+ _imgPasteExt =
47
+ imageItem.type.split("/")[1].replace("jpeg", "jpg") || "png";
48
+ _imgPasteBlob = imageItem.getAsFile();
49
+ if (!_imgPasteBlob) return;
50
+
51
+ // Propose a default name: timestamp in ms (already [0-9]+, so sanitization-safe)
52
+ const defaultName = _sanitizeImageName(Date.now().toString());
53
+ document.getElementById("img-paste-name").value = defaultName;
54
+ document.getElementById("img-paste-ext").textContent =
55
+ "." + _imgPasteExt;
56
+ document.getElementById("img-paste-modal").classList.remove("hidden");
57
+
58
+ // Focus the name input and select all for quick renaming
59
+ const nameInput = document.getElementById("img-paste-name");
60
+ _wireImageNameSanitizer();
61
+ nameInput.focus();
62
+ nameInput.select();
63
+ }
64
+
65
+ function imgPasteCancel() {
66
+ document.getElementById("img-paste-modal").classList.add("hidden");
67
+ _imgPasteBlob = null;
68
+ }
69
+
70
+ async function imgPasteConfirm() {
71
+ const raw = document.getElementById("img-paste-name").value.trim();
72
+ const name = _sanitizeImageName(raw) || Date.now().toString();
73
+ document.getElementById("img-paste-modal").classList.add("hidden");
74
+
75
+ const editor = document.getElementById("doc-editor");
76
+ const msgEl = document.getElementById("edit-save-msg");
77
+
78
+ msgEl.textContent = window.t('doc.uploading_image');
79
+ msgEl.className = "text-xs text-gray-400";
80
+
81
+ try {
82
+ const base64 = await new Promise((resolve, reject) => {
83
+ const reader = new FileReader();
84
+ reader.onload = () => resolve(reader.result);
85
+ reader.onerror = reject;
86
+ reader.readAsDataURL(_imgPasteBlob);
87
+ });
88
+
89
+ const res = await fetch("/api/images/upload", {
90
+ method: "POST",
91
+ headers: { "Content-Type": "application/json" },
92
+ body: JSON.stringify({ data: base64, ext: _imgPasteExt, name }),
93
+ });
94
+ if (!res.ok) throw new Error(await res.text());
95
+
96
+ const { filename } = await res.json();
97
+ const mdImage = `![image](./images/${filename})`;
98
+
99
+ const before = editor.value.slice(0, _imgPasteCursorStart);
100
+ const after = editor.value.slice(_imgPasteCursorEnd);
101
+ editor.value = before + mdImage + after;
102
+ editor.selectionStart = editor.selectionEnd =
103
+ _imgPasteCursorStart + mdImage.length;
104
+ editor.focus();
105
+ msgEl.textContent = "";
106
+ } catch (err) {
107
+ msgEl.textContent = window.t('doc.image_upload_failed') + err.message;
108
+ msgEl.className = "text-xs text-red-500 dark:text-red-400";
109
+ } finally {
110
+ _imgPasteBlob = null;
111
+ }
112
+ }
113
+
114
+ // ── Lightbox ────────────────────────────────────────────────────────────────
115
+ function openLightbox(src, alt) {
116
+ const lb = document.getElementById("img-lightbox");
117
+ document.getElementById("img-lightbox-img").src = src;
118
+ document.getElementById("img-lightbox-img").alt = alt || "";
119
+ lb.classList.remove("hidden");
120
+ }
121
+
122
+ function closeLightbox() {
123
+ const lb = document.getElementById("img-lightbox");
124
+ lb.classList.add("hidden");
125
+ document.getElementById("img-lightbox-img").src = "";
126
+ }