local-kanban 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 Notable changes, newest first. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and the project uses [semantic versioning](https://semver.org/).
 
+Anything not shipped yet is collected under **Unreleased**; releasing renames that section to the
+version it goes out as and opens an empty one again. Released sections are history and stay as they are.
+
+## [Unreleased]
+
+## [1.13.0]
+
+### Added
+
+- **The board tells you what's new.** The changelog was written for every release and shown nowhere:
+  the only place to read it was the package page on npm. The About screen now has a "What's new"
+  block. For the version you are running it reads the `CHANGELOG.md` that ships next to the code, so
+  it needs no network at all. When an update is waiting, it shows the notes of the version you do
+  *not* have yet, read from that release's page on GitHub — the decision to update is made on what
+  actually changed, not on a version number. Releases now get such a page: publishing puts the
+  changelog section for that version into it, which also gives the npm page real releases to link to.
+
+### Fixed
+
+- **A folder the board is not allowed to read is no longer reported as missing.** The Check button
+  next to the project folder answered every refusal the same way — "no such folder on this computer" —
+  whether the folder was absent, was a file, or simply could not be read. For a folder without
+  permissions that is plainly untrue: it is there, the board was not let in, and the answer sent you
+  off to fix a path that was already correct. Each case now says what actually happened, and a check
+  that could not reach the server says so instead of blaming the path.
+
 ## [1.12.0]
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-kanban",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "license": "MIT",
   "author": "Dannylamao",
   "repository": {

package/public/js/core.js

@@ -375,9 +375,11 @@ const I18N_RU = {
   'Claude moves these columns itself': 'эти колонки двигает сам Claude',
   'no file': 'файла нет',
   'no folders inside': 'внутри нет папок',
+  'no notes for this version': 'для этой версии заметок нет',
   'no such folder on this computer': 'такой папки на этом компьютере нет',
   'not deleted': 'не удалено',
   'not installed': 'не установлен',
+  'not installed yet': 'ещё не установлена',
   'not set': 'не задан',
   'not set — no deploy': 'не задан — деплоя нет',
   'not there': 'нет файла',
@@ -425,11 +427,13 @@ const I18N_RU = {
   'subfolders': 'подпапок',
   'key is free': 'ключ свободен',
   'task prefix': 'префикс задач',
+  'the folder is there, but the board cannot read it — check its permissions': 'папка есть, но доска не может её прочитать — посмотри права доступа',
   'this key is already taken by': 'этот ключ уже занят проектом',
   'no such host — check the name, or add it to your ~/.ssh/config': 'такого хоста нет — проверь имя или добавь его в свой ~/.ssh/config',
   'the server refused the key — a password will not help here, the key has to be authorized': 'сервер не принял ключ — пароль тут не поможет, ключ надо разрешить на сервере',
   'the host key is unknown — connect once from your terminal and confirm the fingerprint': 'ключ хоста неизвестен — подключись разок из терминала и подтверди отпечаток',
   'the server did not answer — wrong address, wrong port, or it is down': 'сервер не ответил — не тот адрес, не тот порт или он лежит',
+  'could not check the folder': 'не удалось проверить папку',
   'could not connect': 'подключиться не вышло',
   'on create, git clone puts it on THIS computer at': 'при создании git clone положит его на ЭТОТ компьютер в',
   'An existing folder is refused, not overwritten. Git credentials are not asked here — access comes from your own git and ssh setup.': 'Если папка уже есть — откажет, а не перезапишет. Логин git тут не спрашивается: доступ берётся из твоих git-настроек и ssh-ключей.',
@@ -535,6 +539,7 @@ const I18N_RU = {
   'recovered on retry': 'починилось повторной попыткой',
   'related': 'связана',
   'Read': 'Открыть',
+  'release page': 'страница релиза',
   'Reload now': 'Обновить сейчас',
   'Reload the page': 'Обновить страницу',
   'remove': 'убрать',
@@ -636,6 +641,7 @@ const I18N_RU = {
   'The board could not reach the server — the change was not saved': 'доска не достучалась до сервера — правка не сохранена',
   'capped: the task sat in a working column too long': 'урезано: задача слишком долго лежала в рабочей колонке',
   'To do': 'Сделать',
+  'this path is not a folder': 'по этому пути не папка',
   'Today': 'Сегодня',
   'Top projects': 'Топ проектов',
   'Tue': 'Вт',
@@ -657,6 +663,7 @@ const I18N_RU = {
   'waiting for the board to come back…': 'жду, пока доска поднимется…',
   'Waiting for you': 'Ждёт тебя',
   'Wed': 'Ср',
+  "What's new": 'Что нового',
   'Week': 'Неделя',
   'Weeks': 'Недели',
   'Welcome!': 'Добро пожаловать!',

package/public/js/settings.js

@@ -6,6 +6,35 @@ import { checkVersion, pendingReload } from './init.js';
 import { loadProjects, popLayer, pushLayer, setupPromptBlockHTML, styledAlert, styledConfirm, styledPrompt, wireSetupPrompt } from './sidebar.js';
 import { SHORT_MONTHS, SOUND_LIB, STATUS_LABELS, audioCtx, lastMissedAt, lastSseAt, missedSounds, pageLoadedAt, playNamedSound, refresh, relTime, titleOr, updateSoundBadge } from './sse.js';
 
+function mdInline(text) {
+  return esc(text)
+    .replace(/`([^`]+)`/g, '<code>$1</code>')
+    .replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
+    .replace(/\*([^*\n]+)\*/g, '<em>$1</em>')
+    .replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>');
+}
+export function mdLite(md) {
+  const out = [];
+  let list = false;
+  const closeList = () => { if (list) { out.push('</ul>'); list = false; } };
+  for (const block of String(md || '').split(/\n\s*\n/).map((b) => b.trim()).filter(Boolean)) {
+    const flat = block.split('\n').map((l) => l.trim()).join(' ');
+    const head = flat.match(/^#{1,6}\s+(.*)$/);
+    if (head) { closeList(); out.push(`<h4>${mdInline(head[1])}</h4>`); continue; }
+    if (/^[-*]\s+/.test(block)) {
+      if (!list) { out.push('<ul>'); list = true; }
+      for (const item of block.split(/\n(?=[-*]\s)/)) {
+        out.push(`<li>${mdInline(item.replace(/^[-*]\s+/, '').split('\n').map((l) => l.trim()).join(' '))}</li>`);
+      }
+      continue;
+    }
+    closeList();
+    out.push(`<p>${mdInline(flat)}</p>`);
+  }
+  closeList();
+  return out.join('');
+}
+
 const SETTINGS_DEFAULTS = { sound: true, soundReview: 'ding', soundDone: 'click', startScreen: 'dashboard', dashRange: 'week', theme: 'system', keepDrawer: false, notifyReview: false, compactCards: false, linkLines: true, keymap: {} };
 export function getSetting(k) {
   const v = localStorage.getItem('kb.set.' + k);
@@ -424,6 +453,7 @@ async function renderSection(sec) {
       + `<div class="set-col hidden" id="about-upd-fail"><span class="set-lab">${tr('Run it yourself')}<small>${tr('the board is not allowed to do this — the command is the same one it just tried')}</small></span>`
       + '<pre class="onb-code" id="about-upd-cmd"></pre></div>'
       + `<div class="set-row hidden" id="about-dev-row"><span class="set-lab">${tr('dev branch')}<small id="about-dev-sub">…</small></span><span class="about-fresh" id="about-dev"></span></div>`
+      + `<div class="set-col"><span class="set-lab">${tr("What's new")}<small id="about-news-sub">…</small></span><div class="about-news" id="about-news">…</div></div>`
       + `<div class="set-row"><span class="set-lab">${tr('Check for updates')}<small id="about-recheck-sub">${tr('re-read branch state from GitHub')}</small></span><button class="btn-ghost" id="about-recheck">${tr('Check')}</button></div>`
       + `<div class="set-row"><span class="set-lab">${tr('Reload the page')}<small>${tr('re-read the board code right now')}</small></span><button class="btn-ghost" id="about-reload">${tr('Reload now')}</button></div>`
       + `<div class="set-row"><span class="set-lab">${tr('Using the board at work')}<small>${tr('free for everyone, nothing switched off — if it earns you money, $12 a year per person keeps it maintained')}</small></span>`
@@ -475,8 +505,21 @@ async function renderSection(sec) {
         ? `${u.dev.sha}${u.dev.date ? ` ${tr('at')} ${fmtDbTime(u.dev.date.slice(0, 19).replace('T', ' '))}` : ''}${u.dev.message ? ` · ${u.dev.message}` : ''}`
         : tr('dev has no commits beyond main');
     };
+    const loadNews = async (upd, forced) => {
+      const box = $('about-news'); const sub = $('about-news-sub');
+      if (!box || !sub) return;
+      try {
+        const remote = upd?.update_available === true ? `?remote=1${forced ? '&refresh=1' : ''}` : '';
+        const n = await api('GET', `/api/whats-new${remote}`, null, { quiet: true });
+        box.innerHTML = n?.notes ? mdLite(n.notes) : `<p class="muted">${esc(tr('no notes for this version'))}</p>`;
+        const ver = n?.version ? `${tr('version')} ${n.version}${n.source === 'github' ? ` · ${tr('not installed yet')}` : ''}` : '';
+        const link = /^https:\/\//.test(n?.url || '')
+          ? ` · <a href="${esc(n.url)}" target="_blank" rel="noopener noreferrer">${esc(tr('release page'))}</a>` : '';
+        sub.innerHTML = esc(ver) + link;
+      } catch { box.textContent = '—'; sub.textContent = ''; }
+    };
     api('GET', '/api/about').catch(() => null).then((a) => { about = a; })
-      .then(() => api('GET', '/api/update-check')).then(renderUpd)
+      .then(() => api('GET', '/api/update-check')).then((u) => { renderUpd(u); return loadNews(u); })
       .catch(() => { const s = $('about-upd-sub'); if (s) s.textContent = '—'; });
     const showFailCmd = (cmd) => {
       const wrap = $('about-upd-fail');
@@ -531,7 +574,7 @@ async function renderSection(sec) {
     $('about-recheck').onclick = async () => {
       const btn = $('about-recheck');
       btn.disabled = true; $('about-upd-sub').textContent = tr('checking…');
-      try { renderUpd(await api('GET', '/api/update-check?refresh=1')); }
+      try { const u = await api('GET', '/api/update-check?refresh=1'); renderUpd(u); await loadNews(u, true); }
       catch { $('about-upd-sub').textContent = '—'; }
       btn.disabled = false;
     };

package/public/js/sidebar.js

@@ -374,7 +374,10 @@ export async function checkPath(path) {
     setState('wiz-path-state', `${tr('the folder is there')} · ${r.dirs.length} ${tr('subfolders')}`, 'ok');
     return true;
   } catch (e) {
-    setState('wiz-path-state', `${tr('no such folder on this computer')}: ${e.message || path}`, 'bad');
+    const said = { 404: tr('no such folder on this computer'),
+      400: tr('this path is not a folder'),
+      403: tr('the folder is there, but the board cannot read it — check its permissions') }[e.status];
+    setState('wiz-path-state', said || `${tr('could not check the folder')}: ${e.message || path}`, 'bad');
     return false;
   }
 }

package/public/style.css

@@ -995,6 +995,19 @@ body.dragging-board .col-add-ghost { display: none; }
 .theme-opt { border: none; background: var(--panel); color: var(--muted); font: inherit; font-size: 12.5px; padding: 6px 12px; cursor: pointer; }
 .theme-opt + .theme-opt { border-left: 1px solid var(--border); }
 .theme-opt.active { background: var(--accent); color: #fff; }
+.about-news {
+  max-height: 260px; overflow-y: auto; font-size: 12.5px; line-height: 1.5;
+  border: 1px solid var(--border-soft); border-radius: 8px; padding: 10px 12px; background: var(--panel);
+}
+.about-news h4 { font-size: 12.5px; font-weight: 600; margin: 12px 0 6px; color: var(--muted); }
+.about-news h4:first-child { margin-top: 0; }
+.about-news p { margin: 0 0 8px; }
+.about-news ul { margin: 0 0 8px; padding-left: 18px; }
+.about-news li { margin-bottom: 7px; }
+.about-news li:last-child, .about-news p:last-child { margin-bottom: 0; }
+.about-news code { font-size: 11.5px; background: var(--border-soft); border-radius: 4px; padding: 1px 4px; }
+.about-news a { color: var(--accent); }
+
 .bk-list { display: flex; flex-direction: column; gap: 0; margin-top: 6px; }
 .bk-row { display: flex; justify-content: space-between; gap: 12px; font-size: 12.5px; padding: 7px 0; border-top: 1px solid var(--border-soft); }
 .bk-row:first-child { border-top: none; }

package/src/routes/system.js

@@ -20,8 +20,8 @@ let selfPkgCache;
 function selfPkg() {
   if (selfPkgCache === undefined) {
     try {
-      const { name, version } = JSON.parse(readFileSync(join(ROOT_DIR, 'package.json'), 'utf8'));
-      selfPkgCache = name && version ? { name, version } : null;
+      const { name, version, repository } = JSON.parse(readFileSync(join(ROOT_DIR, 'package.json'), 'utf8'));
+      selfPkgCache = name && version ? { name, version, repository: repository?.url || repository || null } : null;
     } catch { selfPkgCache = null; }
   }
   return selfPkgCache;
@@ -82,6 +82,32 @@ export async function registryCheck() {
   } catch { return null; }
 }
 
+export async function ghApi(path) {
+  try {
+    const res = await fetch(`https://api.github.com/${path}`, {
+      headers: { 'User-Agent': 'local-kanban', Accept: 'application/vnd.github+json' },
+      signal: AbortSignal.timeout(8000),
+    });
+    if (res.ok) return await res.json();
+  } catch {  }
+  try { return JSON.parse(await ghCli(['api', path], { timeout: 10000 })); }
+  catch { return null; }
+}
+
+export function changelogSection(text, version) {
+  const head = new RegExp(`^##\\s*\\[?${String(version).replace(/\./g, '\\.')}\\]?`, 'm');
+  const m = head.exec(String(text || ''));
+  if (!m) return null;
+  const rest = text.slice(m.index + m[0].length);
+  const end = rest.search(/^## /m);
+  return (end === -1 ? rest : rest.slice(0, end)).trim() || null;
+}
+
+export function repoSlug(url) {
+  const m = String(url || '').match(/github\.com[:/]([\w.-]+)\/([\w.-]+?)(?:\.git)?(?:#.*)?$/);
+  return m ? `${m[1]}/${m[2]}` : null;
+}
+
 const UPLOAD_FLOOR = 64 * 1024 * 1024;
 function uploadLimit() {
   try { return Math.max(UPLOAD_FLOOR, statSync(join(DATA_DIR, 'kanban.db')).size * 4); } catch { return UPLOAD_FLOOR; }
@@ -255,17 +281,6 @@ export default async function systemRoutes(app) {
     const git = (args) => new Promise((resolve) => {
       execFile('git', args, { cwd: ROOT, timeout: 8000 }, (err, out) => resolve(err ? null : out.trim()));
     });
-    const ghApi = async (path) => {
-      try {
-        const res = await fetch(`https://api.github.com/${path}`, {
-          headers: { 'User-Agent': 'local-kanban', Accept: 'application/vnd.github+json' },
-          signal: AbortSignal.timeout(8000),
-        });
-        if (res.ok) return await res.json();
-      } catch {  }
-      try { return JSON.parse(await ghCli(['api', path], { timeout: 10000 })); }
-      catch { return null; }
-    };
     let data = { update_available: null, local: null, remote: null, branch: null, tag: null, dev: null };
     try {
       const [local, branch, origin, tag] = await Promise.all([
@@ -300,6 +315,30 @@ export default async function systemRoutes(app) {
     return data;
   });
 
+  const NEWS_OK_MS = 3600000;
+  const NEWS_FAIL_MS = 60000;
+  let newsCache = { at: 0, ttl: 0, data: null };
+  app.get('/api/whats-new', async (req) => {
+    const version = selfPkg()?.version || null;
+    const own = () => {
+      let text = null;
+      try { text = readFileSync(join(ROOT_DIR, 'CHANGELOG.md'), 'utf8'); } catch {  }
+      return { version, notes: (text && version) ? changelogSection(text, version) : null, source: 'changelog', url: null };
+    };
+    if (!req.query?.remote) return own();
+    if (!req.query?.refresh && newsCache.data && Date.now() - newsCache.at < newsCache.ttl) return newsCache.data;
+    const repo = repoSlug(selfPkg()?.repository);
+    const rel = repo ? await ghApi(`repos/${repo}/releases/latest`) : null;
+    const tag = String(rel?.tag_name || '').replace(/^v/, '');
+    const body = String(rel?.body || '').trim();
+    const got = Boolean(tag && body);
+    const data = got
+      ? { version: tag, notes: body, source: 'github', url: rel.html_url || null }
+      : own();
+    newsCache = { at: Date.now(), ttl: got ? NEWS_OK_MS : NEWS_FAIL_MS, data };
+    return data;
+  });
+
   let updateRunning = null;
   app.post('/api/update', async (req, reply) => {
     if (updateRunning) return reply.code(409).send({ error: 'an update is already running' });