kingkont 0.20.13 → 0.20.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.13",
+  "version": "0.20.15",
   "description": "KingKont \u00b7 Chatium \u2014 \u043d\u043e\u0434-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0441\u0446\u0435\u043d \u0441 AI-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 (\u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438/\u0432\u0438\u0434\u0435\u043e/\u0433\u043e\u043b\u043e\u0441/SFX/\u043c\u0443\u0437\u044b\u043a\u0430/\u0442\u0435\u043a\u0441\u0442)",
   "main": "main.js",
   "bin": {

package/renderer/board.js

@@ -1643,11 +1643,13 @@ async function openShareModal(p) {
         // В Electron location.origin === http://localhost:17893 — кому
         // отправлять такую ссылку? Принимающий открывает в обычном браузере,
         // там приложение живёт на kingkont.ru. В web используем origin.
-        // Канонический путь — /static/web.html. /app/spaces/client/index.html
-        // остался как auth-aware redirect-stub (для backwards-compat).
+        // Через /app/spaces/client/index.html (auth-aware stub) — он редиректит
+        // на свежую версионированную /static/web-<sha>.html. /static/web.html
+        // напрямую chatium edge-cache намертво держит stale, шарить эту ссылку
+        // нельзя — получатель увидит старую версию.
         const isLocal = /^https?:\/\/(localhost|127\.0\.0\.1)/.test(location.origin);
         const base = isLocal ? 'https://kingkont.ru' : location.origin;
-        return base + '/static/web.html#template=' + proj.id;
+        return base + '/app/spaces/client/index.html#template=' + proj.id;
     }
     function render() {
         const isPub = !!proj.isPublic;

package/renderer/cloudProjects.js

@@ -351,9 +351,11 @@
             // canModify. Юзер видит лишние edit-кнопки на view-only-link.
             if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
             if (window.__KINGKONT_WEB__ && !/^#template=/.test(location.hash)) location.hash = '#project=' + projectId;
-            // Background — узнаём актуальный canModify. Если расширились
-            // shared-edit права или наоборот отозвали — обновится здесь.
-            fetch('/api/projects/' + encodeURIComponent(projectId)).then(r => r.ok ? r.json() : null).then(p => {
+            // Background — узнаём актуальный canModify + докачиваем тексты
+            // (если кэш был «частичный» из view-only-сессии, .md мог не быть).
+            // После download'а перечитываем text-ноды из FS и обновляем
+            // currentBoard, чтобы textarea-ноды показали свежий контент.
+            fetch('/api/projects/' + encodeURIComponent(projectId)).then(r => r.ok ? r.json() : null).then(async p => {
               if (!p) return;
               state.cloudPermission = p.permission || (p.mine ? 'owner' : null);
               state.cloudMine = !!p.mine;
@@ -361,6 +363,10 @@
               state.cloudIsPublic = !!p.isPublic;
               setCloudButtonsVisibility();
               if (typeof window.renderTemplateOverlay === 'function') window.renderTemplateOverlay();
+              const bgBoards = Array.isArray(p.manifest?.boards) ? p.manifest.boards : [];
+              await _downloadAllTexts(projectId, bgBoards).catch(() => {});
+              // Перечитываем тексты ТЕКУЩЕЙ доски (другие — при switchBoard).
+              await _refreshCurrentBoardTexts().catch(() => {});
             }).catch(() => {});
             return;
           }
@@ -399,6 +405,11 @@
             new TextEncoder().encode(JSON.stringify(board.scene, null, 2)));
         }
       }
+      // a.5) Тексты (texts/*.md) — тоже синхронно ДО openFilm. loadBoardMetadata
+      // при открытии доски ходит к каждому n.file через resolveBoardFile —
+      // если файла нет локально, n.text=''. View-only (canModify=false) раньше
+      // вообще не докачивал → юзер видел пустые text-ноды.
+      await _downloadAllTexts(projectId, boards);
       // CDN-карта — будет и в state, и в meta (чтобы пережила reload).
       // Конвертируем /get/<hash> → /thumbnail/<hash>/1024x для лучшего
       // кеширования на CDN (юзер: «/get плохо кешируется, /thumbnail
@@ -461,6 +472,60 @@
     }
   }
 
+  // Параллельная синхронная загрузка всех .md-контентов всех бордов.
+  // Тексты маленькие (1-10KB обычно), качаем сразу — иначе при открытии
+  // доски юзер видит пустые text-ноды до завершения _backgroundDownload
+  // (который не запускается в view-only).
+  async function _downloadAllTexts(projectId, boards) {
+    const tasks = [];
+    for (const board of boards) {
+      const boardDir = boardKindToDir(board.kind, board.name);
+      for (const [relPath, textId] of Object.entries(board.texts || {})) {
+        tasks.push({ boardDir, relPath, textId });
+      }
+    }
+    if (!tasks.length) return;
+    const CONCURRENCY = 8;
+    let i = 0;
+    async function worker() {
+      while (i < tasks.length) {
+        const t = tasks[i++];
+        try {
+          const tr = await fetch('/api/project-texts/' + encodeURIComponent(t.textId));
+          if (!tr.ok) continue;
+          const td = await tr.json();
+          const buf = new TextEncoder().encode(td.content || '');
+          await writeCloudFile(projectId, joinPath(t.boardDir, t.relPath), buf);
+        } catch {}
+      }
+    }
+    await Promise.all(Array.from({ length: CONCURRENCY }, worker));
+  }
+
+  // Перечитать .md-контент text-нод текущей доски из FS и обновить DOM.
+  // Используется после фонового _downloadAllTexts — если тексты пришли
+  // ПОСЛЕ openFilm, ноды показывают пустые textarea, пока этот хук не
+  // обновит node.text + refreshNodeDOM.
+  async function _refreshCurrentBoardTexts() {
+    const board = state.currentBoard;
+    if (!board?.handle) return;
+    const nodes = board.metadata?.nodes || [];
+    let changed = 0;
+    for (const n of nodes) {
+      if (n.type !== 'text' || !n.file) continue;
+      try {
+        const fh = await resolveBoardFile(board.handle, n.file);
+        const content = await (await fh.getFile()).text();
+        if (n.text !== content) {
+          n.text = content;
+          changed++;
+          if (typeof refreshNodeDOM === 'function') await refreshNodeDOM(n.id);
+        }
+      } catch {}
+    }
+    if (changed) console.log('[cloudProjects] refreshed', changed, 'text-нод после фоновой загрузки');
+  }
+
   // Подложить CDN-URL'ы под state.currentBoard.urls — рендеру медиа-нод
   // в settings.js достаточно непустого `urls[node.file]`, чтобы не лезть
   // в FS (см. settings.js:405).
@@ -665,12 +730,13 @@
                 body: JSON.stringify({ content, relPath: f.relPath }),
               });
               if (!ur.ok) {
-                if (ur.status === 404) {
-                  // Либо id протух, либо эндпоинт ещё не задеплоен — пробуем create.
-                  textId = null;
-                } else {
-                  throw new Error(`update text ${f.relPath} failed: ${ur.status}`);
-                }
+                // Любая non-2xx ошибка на UPDATE — текст-id мог протухнуть
+                // (запись удалена/очищена через cleanup) или chatium framework
+                // вернул 502 из-за временной ошибки. Любой случай → fallback
+                // на CREATE (получаем свежий id, сохраняем content). Раньше
+                // throw'или на всё кроме 404 — юзер видел «502» и save падал.
+                console.warn(`[cloudProjects] update text ${f.relPath} (id=${textId}) → ${ur.status} → fallback CREATE`);
+                textId = null;
               }
             }
             if (!textId) {
@@ -682,12 +748,11 @@
               if (cr.ok) {
                 const j = await cr.json();
                 textId = j.id;
-              } else if (cr.status === 404 || cr.status === 502) {
-                // Эндпоинт ещё не задеплоен на chatium-стороне → fallback на CDN.
-                console.warn(`[cloudProjects] /api/project-texts ${cr.status} → fallback на CDN-upload для ${f.relPath}`);
-                dbPathFailed = true;
               } else {
-                throw new Error(`create text ${f.relPath} failed: ${cr.status}`);
+                // Любая ошибка CREATE — даём .md уйти через CDN. Не теряем
+                // данные юзера из-за временного 502/500 backend'а.
+                console.warn(`[cloudProjects] /api/project-texts ${cr.status} → fallback CDN-upload для ${f.relPath}`);
+                dbPathFailed = true;
               }
             }
             if (textId) {

package/skill/SKILL.md

@@ -395,6 +395,10 @@ open -a "Google Chrome" "http://localhost:17893/"
       },
       "status": "generating" | "draft" | "error",  // отсутствует если нода готова
       "error": "...",
+      "linkedBoard": {                       // опц., ссылка на другую доску
+        "kind": "episode" | "character" | "location",
+        "name": "Сцена 2"                    // имя целевой доски (handle резолвится в runtime)
+      },
       "history": [...],                      // история правок (через ⇄ Заменить)
       "historyIndex": 0
     }
@@ -475,6 +479,35 @@ open -a "Google Chrome" "http://localhost:17893/"
    }
    ```
 
+## Ссылки на доски (link-to-scene)
+
+Нода может содержать ссылку на другую сцену/персонажа/локацию того же
+проекта. Используется для нелинейной навигации — например, story-board
+с миниатюрами сцен, по которым юзер кликает чтобы перейти.
+
+**Формат** (поле в ноде):
+```json5
+"linkedBoard": {
+  "kind": "episode" | "character" | "location",
+  "name": "Сцена 2"
+}
+```
+
+**UI**:
+- ПКМ на ноде → «🔗 Сделать ссылку на сцену…» (picker всех досок проекта,
+  кроме текущей). Меняется на «🔗 Перейти → <имя>» + «⛓️‍💥 Убрать ссылку»
+  когда ссылка уже есть.
+- На ноде со ссылкой — значок 🔗 в правом-верхнем углу.
+- Дабл-клик на ноде = переход (перебивает обычное действие dblclick типа
+  fullscreen-просмотра).
+- Если целевая доска переименована/удалена — алерт «не найдена».
+
+**Handle не сериализуется** — хранится только `{kind, name}`. При переходе
+редактор резолвит через `listEpisodes/listCharacters/listLocations`.
+Поэтому ссылка переживает clone-проекта (новые директории, та же
+структура). Но переименование целевой доски ломает ссылку — нужно
+обновлять вручную в scene.json или пересоздавать через ПКМ.
+
 ## Файловые операции
 
 - **Удаление ноды**: файл переезжает в `<root>/_deleted/<уникальное-имя>`.