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.
- package/LICENSE +661 -0
- package/README.fr.md +344 -0
- package/README.md +344 -0
- package/dist/bin/cli.d.ts +3 -0
- package/dist/bin/cli.d.ts.map +1 -0
- package/dist/bin/cli.js +262 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/src/frontend/accuracy-gauge.js +70 -0
- package/dist/src/frontend/admin.html +1532 -0
- package/dist/src/frontend/annotations.js +585 -0
- package/dist/src/frontend/boot.js +101 -0
- package/dist/src/frontend/config.js +29 -0
- package/dist/src/frontend/confirm-modal.js +82 -0
- package/dist/src/frontend/context.html +1252 -0
- package/dist/src/frontend/dark-mode.js +20 -0
- package/dist/src/frontend/diagram/alignment.js +161 -0
- package/dist/src/frontend/diagram/clipboard.js +187 -0
- package/dist/src/frontend/diagram/constants.js +109 -0
- package/dist/src/frontend/diagram/custom-shapes.js +104 -0
- package/dist/src/frontend/diagram/debug.js +43 -0
- package/dist/src/frontend/diagram/drawio-export.js +649 -0
- package/dist/src/frontend/diagram/edge-panel.js +293 -0
- package/dist/src/frontend/diagram/edge-rendering.js +12 -0
- package/dist/src/frontend/diagram/evidence.js +146 -0
- package/dist/src/frontend/diagram/grid.js +78 -0
- package/dist/src/frontend/diagram/groups.js +102 -0
- package/dist/src/frontend/diagram/history.js +157 -0
- package/dist/src/frontend/diagram/image-name-modal.js +48 -0
- package/dist/src/frontend/diagram/image-upload.js +36 -0
- package/dist/src/frontend/diagram/label-editor.js +115 -0
- package/dist/src/frontend/diagram/link-panel.js +144 -0
- package/dist/src/frontend/diagram/main.js +364 -0
- package/dist/src/frontend/diagram/network.js +2214 -0
- package/dist/src/frontend/diagram/node-panel.js +389 -0
- package/dist/src/frontend/diagram/node-rendering.js +964 -0
- package/dist/src/frontend/diagram/persistence.js +168 -0
- package/dist/src/frontend/diagram/ports.js +421 -0
- package/dist/src/frontend/diagram/selection-overlay.js +387 -0
- package/dist/src/frontend/diagram/state.js +43 -0
- package/dist/src/frontend/diagram/t.js +3 -0
- package/dist/src/frontend/diagram/toast.js +21 -0
- package/dist/src/frontend/diagram/unlock-hold.js +206 -0
- package/dist/src/frontend/diagram/zoom.js +20 -0
- package/dist/src/frontend/diagram-link-modal.js +137 -0
- package/dist/src/frontend/diagram.html +1494 -0
- package/dist/src/frontend/documents.js +479 -0
- package/dist/src/frontend/export.js +338 -0
- package/dist/src/frontend/file-attach.js +178 -0
- package/dist/src/frontend/files-modal.js +243 -0
- package/dist/src/frontend/i18n/en.json +624 -0
- package/dist/src/frontend/i18n/fr.json +624 -0
- package/dist/src/frontend/i18n.js +32 -0
- package/dist/src/frontend/image-paste.js +126 -0
- package/dist/src/frontend/index.html +2806 -0
- package/dist/src/frontend/local-search.js +476 -0
- package/dist/src/frontend/metadata.js +318 -0
- package/dist/src/frontend/misc.js +92 -0
- package/dist/src/frontend/new-doc-modal.js +285 -0
- package/dist/src/frontend/new-folder-modal.js +169 -0
- package/dist/src/frontend/search.js +194 -0
- package/dist/src/frontend/shape-editor.html +685 -0
- package/dist/src/frontend/sidebar-helpers.js +96 -0
- package/dist/src/frontend/sidebar-resize.js +98 -0
- package/dist/src/frontend/sidebar.js +351 -0
- package/dist/src/frontend/snippet-detect.js +25 -0
- package/dist/src/frontend/snippet-table.js +85 -0
- package/dist/src/frontend/snippet-tree.js +94 -0
- package/dist/src/frontend/snippets.js +1146 -0
- package/dist/src/frontend/state.js +46 -0
- package/dist/src/frontend/utils.js +21 -0
- package/dist/src/frontend/validate.js +107 -0
- package/dist/src/frontend/vendor/wordcloud2.js +1187 -0
- package/dist/src/frontend/wordcloud.js +693 -0
- package/dist/src/lib/config.d.ts +26 -0
- package/dist/src/lib/config.d.ts.map +1 -0
- package/dist/src/lib/config.js +195 -0
- package/dist/src/lib/config.js.map +1 -0
- package/dist/src/lib/hash.d.ts +2 -0
- package/dist/src/lib/hash.d.ts.map +1 -0
- package/dist/src/lib/hash.js +18 -0
- package/dist/src/lib/hash.js.map +1 -0
- package/dist/src/lib/metadata.d.ts +31 -0
- package/dist/src/lib/metadata.d.ts.map +1 -0
- package/dist/src/lib/metadata.js +128 -0
- package/dist/src/lib/metadata.js.map +1 -0
- package/dist/src/lib/parser.d.ts +11 -0
- package/dist/src/lib/parser.d.ts.map +1 -0
- package/dist/src/lib/parser.js +111 -0
- package/dist/src/lib/parser.js.map +1 -0
- package/dist/src/lib/status.d.ts +9 -0
- package/dist/src/lib/status.d.ts.map +1 -0
- package/dist/src/lib/status.js +72 -0
- package/dist/src/lib/status.js.map +1 -0
- package/dist/src/mcp/server.d.ts +3 -0
- package/dist/src/mcp/server.d.ts.map +1 -0
- package/dist/src/mcp/server.js +2046 -0
- package/dist/src/mcp/server.js.map +1 -0
- package/dist/src/mcp/tools/diagrams.d.ts +82 -0
- package/dist/src/mcp/tools/diagrams.d.ts.map +1 -0
- package/dist/src/mcp/tools/diagrams.js +594 -0
- package/dist/src/mcp/tools/diagrams.js.map +1 -0
- package/dist/src/mcp/tools/documents.d.ts +44 -0
- package/dist/src/mcp/tools/documents.d.ts.map +1 -0
- package/dist/src/mcp/tools/documents.js +186 -0
- package/dist/src/mcp/tools/documents.js.map +1 -0
- package/dist/src/mcp/tools/git.d.ts +10 -0
- package/dist/src/mcp/tools/git.d.ts.map +1 -0
- package/dist/src/mcp/tools/git.js +217 -0
- package/dist/src/mcp/tools/git.js.map +1 -0
- package/dist/src/mcp/tools/metadata.d.ts +57 -0
- package/dist/src/mcp/tools/metadata.d.ts.map +1 -0
- package/dist/src/mcp/tools/metadata.js +222 -0
- package/dist/src/mcp/tools/metadata.js.map +1 -0
- package/dist/src/mcp/tools/source.d.ts +29 -0
- package/dist/src/mcp/tools/source.d.ts.map +1 -0
- package/dist/src/mcp/tools/source.js +196 -0
- package/dist/src/mcp/tools/source.js.map +1 -0
- package/dist/src/routes/annotations.d.ts +3 -0
- package/dist/src/routes/annotations.d.ts.map +1 -0
- package/dist/src/routes/annotations.js +83 -0
- package/dist/src/routes/annotations.js.map +1 -0
- package/dist/src/routes/browse-source.d.ts +3 -0
- package/dist/src/routes/browse-source.d.ts.map +1 -0
- package/dist/src/routes/browse-source.js +79 -0
- package/dist/src/routes/browse-source.js.map +1 -0
- package/dist/src/routes/browse.d.ts +3 -0
- package/dist/src/routes/browse.d.ts.map +1 -0
- package/dist/src/routes/browse.js +91 -0
- package/dist/src/routes/browse.js.map +1 -0
- package/dist/src/routes/config.d.ts +3 -0
- package/dist/src/routes/config.d.ts.map +1 -0
- package/dist/src/routes/config.js +145 -0
- package/dist/src/routes/config.js.map +1 -0
- package/dist/src/routes/context.d.ts +3 -0
- package/dist/src/routes/context.d.ts.map +1 -0
- package/dist/src/routes/context.js +287 -0
- package/dist/src/routes/context.js.map +1 -0
- package/dist/src/routes/diagrams.d.ts +3 -0
- package/dist/src/routes/diagrams.d.ts.map +1 -0
- package/dist/src/routes/diagrams.js +69 -0
- package/dist/src/routes/diagrams.js.map +1 -0
- package/dist/src/routes/documents.d.ts +11 -0
- package/dist/src/routes/documents.d.ts.map +1 -0
- package/dist/src/routes/documents.js +450 -0
- package/dist/src/routes/documents.js.map +1 -0
- package/dist/src/routes/export.d.ts +3 -0
- package/dist/src/routes/export.d.ts.map +1 -0
- package/dist/src/routes/export.js +280 -0
- package/dist/src/routes/export.js.map +1 -0
- package/dist/src/routes/files.d.ts +3 -0
- package/dist/src/routes/files.d.ts.map +1 -0
- package/dist/src/routes/files.js +180 -0
- package/dist/src/routes/files.js.map +1 -0
- package/dist/src/routes/images.d.ts +3 -0
- package/dist/src/routes/images.d.ts.map +1 -0
- package/dist/src/routes/images.js +49 -0
- package/dist/src/routes/images.js.map +1 -0
- package/dist/src/routes/metadata.d.ts +3 -0
- package/dist/src/routes/metadata.d.ts.map +1 -0
- package/dist/src/routes/metadata.js +131 -0
- package/dist/src/routes/metadata.js.map +1 -0
- package/dist/src/routes/shape-libraries.d.ts +3 -0
- package/dist/src/routes/shape-libraries.d.ts.map +1 -0
- package/dist/src/routes/shape-libraries.js +118 -0
- package/dist/src/routes/shape-libraries.js.map +1 -0
- package/dist/src/routes/wordcloud.d.ts +3 -0
- package/dist/src/routes/wordcloud.d.ts.map +1 -0
- package/dist/src/routes/wordcloud.js +95 -0
- package/dist/src/routes/wordcloud.js.map +1 -0
- package/dist/src/server.d.ts +7 -0
- package/dist/src/server.d.ts.map +1 -0
- package/dist/src/server.js +93 -0
- package/dist/src/server.js.map +1 -0
- package/dist/starter-doc/.living-doc.json +52 -0
- package/dist/starter-doc/ADRS/2026_01_01_[ADR]_example_architecture_decision.md +59 -0
- package/dist/starter-doc/AI/2026_01_01_how_to.md +112 -0
- package/dist/starter-doc/AI/PROJECT-INSTRUCTIONS.md +172 -0
- package/dist/starter-doc/AI/PROJECT-STACK.md +77 -0
- package/dist/starter-doc/AI/PROJECT-USEFUL-COMMANDS.md +80 -0
- package/dist/starter-doc/AI/default/AGENTS.md +31 -0
- package/dist/starter-doc/AI/default/CLAUDE.md +31 -0
- package/dist/starter-doc/AI/default/MEMORY.md +24 -0
- package/dist/starter-doc/AI/rules/no-magic-numbers.md +18 -0
- package/dist/starter-doc/AI/rules/track-current-work.md +23 -0
- package/dist/starter-doc/WORKLOG/current-task.md +57 -0
- package/dist/starter-doc-fr/.living-doc.json +52 -0
- package/dist/starter-doc-fr/ADRS/2026_01_01_[ADR]_example_architecture_decision.md +59 -0
- package/dist/starter-doc-fr/AI/2026_01_01_how_to.md +100 -0
- package/dist/starter-doc-fr/AI/PROJECT-INSTRUCTIONS.md +172 -0
- package/dist/starter-doc-fr/AI/PROJECT-STACK.md +77 -0
- package/dist/starter-doc-fr/AI/PROJECT-USEFUL-COMMANDS.md +80 -0
- package/dist/starter-doc-fr/AI/default/AGENTS.md +31 -0
- package/dist/starter-doc-fr/AI/default/CLAUDE.md +31 -0
- package/dist/starter-doc-fr/AI/default/MEMORY.md +24 -0
- package/dist/starter-doc-fr/AI/rules/no-magic-numbers.md +18 -0
- package/dist/starter-doc-fr/AI/rules/track-current-work.md +23 -0
- package/dist/starter-doc-fr/WORKLOG/current-task.md +57 -0
- package/images/living_documentation.jpg +0 -0
- package/images/readme-extra-files.png +0 -0
- package/images/readme-filename-pattern.png +0 -0
- package/images/readme-intelligent-search-demo.jpg +0 -0
- package/images/readme-sidebar.png +0 -0
- 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 = ``;
|
|
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
|
+
}
|