dsh-loci 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -4,6 +4,86 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); the project follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html) from 1.0.0.
 
+## [3.1.0] — 2026-11-15
+
+Four things from looking at the live sidebar and panel.
+
+### Changed
+
+- **The sidebar icon now has the same weight as the menu it sits in.** Native
+  `sidebar.panellist` entries receive `{ size, active }`; this one used `size` correctly but
+  drew inside 4–20 of a 24 viewBox with a small off-centre dot, so beside the shipped icons
+  it read thinner and smaller. Redrawn as a symmetric **layers** glyph spanning 3–21 at
+  stroke 1.8 — the optical weight of its neighbours, and a shape that says layered memory.
+
+- **The panel is a readable column, not edge-to-edge text.** The scroll container's
+  horizontal padding became `max(16px, calc((100% - 860px) / 2))`, so rows sit in a centred
+  measure on a wide window without touching any tab component.
+
+- **"N item(s) waiting for you in Review" is now a way in.** It was a sentence telling a
+  person to go somewhere else and find the tab. It is a button: it opens the panel already
+  on Review. The card and the panel mount separately, so the request travels through module
+  scope and is consumed once.
+
+- **The card says what it knows, not only how much.** Commit `4065c98` (2026-11-13) recorded
+  the brief for this surface: *"not a dashboard … read the card and think 'it got that, it
+  recorded that, we agreed on that'"*, with one short paragraph of what the agent
+  understands in this project and pending work as one quiet line, never a number. 3.0.0
+  replaced that paragraph with counters. The counters stay — they were asked for and they
+  are useful — and one line of content goes back under them: a `Latest` row showing the most
+  recently trusted entry, from `GET /api/loci/knowledge?limit=1`.
+
+### Not changed
+
+- `docs/PRIOR-ART.md` still records that the card should be scoped to **this project's read
+  set** rather than every scope. It currently is not: `/stats` and `/knowledge` called
+  without parameters enumerate the whole store, and the sidebar card has no access to the
+  session's cwd. Scoping the card is a real open item, not something to assert.
+
+## [3.0.1] — 2026-11-15
+
+The 3.0.0 card was correct markup with no stylesheet, and the screenshot showed it.
+
+### Fixed
+
+- **The card was never styled outside the panel.** Every `.loci-*` rule lives in one CSS
+  template string that only `MemoryPanel` and `SettingsSection` render as a `<style>`
+  element. In the sidebar, with the panel closed, no `<style>` existed — so the card's DOM
+  was right and its layout was simply absent. That is what "bare text in the sidebar"
+  looked like, and it predates 3.0.0: the first screenshot showed it too. The card now
+  renders the stylesheet itself, and so does its rail variant.
+
+- **`card.pending` was defined twice.** The old value was the sentence
+  `'{n} still need your review'`; 3.0.0 added a bare `'Pending'` label for the metric row,
+  and the later definition won — so the card printed the sentence with an unsubstituted
+  `{n}`. The sentence is now `card.pendingSentence` and the label stays `Pending`.
+
+- **The version chip rendered as `v3. 0. 0`.** The chip used
+  `ui-monospace, SFMono-Regular, Menlo, monospace`, which on Windows falls back to a
+  monospace face whose period is centred in a wide advance; at 8.5px that reads as gaps
+  between the digits. Measured with `getComputedStyle`: `letter-spacing: normal`,
+  `word-spacing: 0`, width 25.50 — the spacing was correct, the **glyph** was not. The chip
+  now inherits the UI font with tabular figures, at 9px.
+
+### Added
+
+- **`scripts/shot-card.mjs`** renders the sidebar card to a PNG using the stylesheet
+  extracted from `client.js` and the DOM the component produces, through headless Edge. It
+  cannot catch a logic mistake, only a drawing one — but a drawing mistake is exactly what
+  shipped twice, and a screenshot is the only review that shows it.
+
+### Not added
+
+Four guard files from the previous draft (a separate client-i18n test, an English-only test,
+a CSS-shape assertion and a manifest check) were collapsed into **one** test file and one
+manifest assertion. Guards that outnumber the behaviour they protect get deleted by the next
+person, which is worse than not having them.
+
+### Corrected in the record
+
+The 3.0.0 log entry said the card had been verified. It had not been looked at. The entry
+above records what the screenshot showed.
+
 ## [3.0.0] — 2026-11-15
 
 The sidebar card was not a card, and the plugin had a second language it did not need.

package/client.js

@@ -27,6 +27,9 @@ window.__ModuleLoader__.load({
     const API = '/api/loci';
     const ENTRY_ID = 'dsh-loci';
     const PANEL_ID = 'loci';
+    // The card and the panel mount separately, so a request to open a specific tab has
+    // to travel through module scope. The panel consumes it once, then clears it.
+    let requestedTab;
 
     const EN = {
       'meta.title': 'Loci memory palace',
@@ -44,8 +47,9 @@ window.__ModuleLoader__.load({
       'card.opened': 'Opened',
       'card.dead': 'Dead',
       'card.pendingHint': '{n} item(s) waiting for you in Review.',
+      'card.latest': 'Latest',
       'card.updated': 'updated',
-      'card.pending': '{n} still need your review',
+      'card.pendingSentence': '{n} still need your review',
       'card.pinned': 'pinned',
       'card.open': 'Open memory',
       'card.check': 'Check for updates',
@@ -172,7 +176,7 @@ window.__ModuleLoader__.load({
 .loci-card-root.is-rail { flex: 0 0 auto; padding: 6px; align-items: center; justify-content: center; }
 .loci-card-head { display: flex; align-items: center; gap: 6px; min-width: 0; width: 100%; }
 .loci-card-title { font-size: 13px; font-weight: 700; letter-spacing: -.01em; white-space: nowrap; }
-.loci-card-ver { flex: 0 0 auto; margin: 0; padding: 0; border: 0; background: transparent; color: var(--dsw-alias-label-secondary); font-size: 8.5px; line-height: 1.2; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; cursor: pointer; white-space: nowrap; }
+.loci-card-ver { flex: 0 0 auto; margin: 0; padding: 0; border: 0; background: transparent; color: var(--dsw-alias-label-secondary); font-size: 9px; line-height: 1.2; font-family: inherit; font-variant-numeric: tabular-nums; cursor: pointer; white-space: nowrap; }
 .loci-card-ver:hover { color: var(--dsw-alias-label-primary); }
 .loci-card-dot { width: 5px; height: 5px; border-radius: 50%; background: var(--dsw-alias-brand-primary); flex: 0 0 auto; }
 .loci-card-dot.is-warn { background: var(--dsw-alias-state-warn-primary); }
@@ -194,6 +198,11 @@ window.__ModuleLoader__.load({
 .loci-card-foot-grow { flex: 1 1 auto; }
 .loci-card-empty { font-size: 9.5px; color: var(--dsw-alias-label-secondary); }
 .loci-card-hint { font-size: 9px; color: var(--dsw-alias-label-secondary); }
+.loci-card-known { display: flex; gap: 5px; align-items: baseline; min-width: 0; }
+.loci-card-known-tag { flex: 0 0 auto; font-size: 8px; letter-spacing: .05em; text-transform: uppercase; color: var(--dsw-alias-label-secondary); }
+.loci-card-known-text { min-width: 0; font-size: 9.5px; color: var(--dsw-alias-label-primary); overflow: hidden; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; }
+.loci-card-hint-action { align-self: flex-start; margin: 0; padding: 2px 6px; border: 1px solid var(--dsw-alias-border-l1); border-radius: 6px; background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font: inherit; font-size: 9px; line-height: 1.2; cursor: pointer; text-align: left; }
+.loci-card-hint-action:hover { border-color: var(--dsw-alias-brand-primary); color: var(--dsw-alias-brand-primary); }
 .loci-dot { width: 6px; height: 6px; border-radius: 50%; background: var(--dsw-alias-brand-primary); flex: 0 0 auto; }
 
 .loci-bar { display: flex; align-items: center; gap: 12px; padding: 10px 16px; border-bottom: 1px solid var(--dsw-alias-border-l1); }
@@ -203,7 +212,7 @@ window.__ModuleLoader__.load({
 .loci-tab:hover { background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); }
 .loci-tab.is-active { background: var(--dsw-alias-bg-layer-2); color: var(--dsw-alias-label-primary); font-weight: 600; }
 .loci-grow { flex: 1 1 auto; }
-.loci-body { flex: 1 1 auto; min-height: 0; overflow: auto; padding: 12px 16px 24px; }
+.loci-body { flex: 1 1 auto; min-height: 0; overflow: auto; padding: 14px max(16px, calc((100% - 860px) / 2)) 28px; }
 .loci-btn { border: 1px solid var(--dsw-alias-border-l1); background: var(--dsw-alias-bg-layer-1); color: var(--dsw-alias-label-primary); border-radius: 6px; padding: 3px 9px; font: inherit; cursor: pointer; }
 .loci-btn:hover { border-color: var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-2); }
 .loci-btn:disabled { opacity: .5; cursor: default; }
@@ -438,6 +447,7 @@ window.__ModuleLoader__.load({
       // read as bare text inside the sidebar rather than as a card — and the audit's own
       // "no dashboard" objection was about refusing to interrupt, not about hiding data.
       const stats = useJson('/stats', { intervalMs: 30_000 });
+      const knowledge = useJson('/knowledge?limit=1', { intervalMs: 30_000 });
       const config = useJson('/config');
       const update = useJson('/update');
       const [checking, setChecking] = useState(false);
@@ -468,6 +478,10 @@ window.__ModuleLoader__.load({
       const injected = usage.reduce((total, row) => total + Number(row.injections ?? 0), 0);
       const opened = usage.reduce((total, row) => total + Number(row.reads ?? 0), 0);
       const dead = usage.filter((row) => Number(row.injections ?? 0) > 0 && Number(row.reads ?? 0) === 0).length;
+      // What the agent currently understands, newest first. Numbers answer "how much";
+      // this answers "what".
+      const top = knowledge.data?.items?.[0];
+      const latest = typeof top?.title === 'string' && top.title.length > 0 ? top.title : null;
 
       if (!wide) {
         return h(
@@ -479,6 +493,7 @@ window.__ModuleLoader__.load({
             'aria-label': t('card.open'),
             onClick: () => open?.(),
           },
+          h('style', null, CSS),
           h('svg', { width: 18, height: 18, viewBox: '0 0 24 24', fill: 'none', 'aria-hidden': true },
             h('path', { d: 'M4 6.5h16M4 12h16M4 17.5h10', stroke: 'currentColor', strokeWidth: 1.7, strokeLinecap: 'round' }),
             h('circle', { cx: 18.5, cy: 17.5, r: 2.2, stroke: 'currentColor', strokeWidth: 1.5 }),
@@ -507,6 +522,7 @@ window.__ModuleLoader__.load({
             if (event.key === 'Enter' || event.key === ' ') open?.();
           },
         },
+        h('style', null, CSS),
         h(
           'div',
           { className: 'loci-card-head' },
@@ -546,6 +562,14 @@ window.__ModuleLoader__.load({
                   metric(t('card.pending'), pending, pending > 0 ? 'is-warn' : ''),
                   metric(t('card.disputed'), disputed, disputed > 0 ? 'is-error' : ''),
                 ),
+        data !== undefined && latest !== null
+          ? h(
+              'div',
+              { className: 'loci-card-known' },
+              h('span', { className: 'loci-card-known-tag' }, t('card.latest')),
+              h('span', { className: 'loci-card-known-text' }, latest),
+            )
+          : null,
         data !== undefined && entries > 0 && budget > 0
           ? h(
               'div',
@@ -571,7 +595,21 @@ window.__ModuleLoader__.load({
               h('span', { className: 'loci-card-foot-grow' }),
             )
           : null,
-        pending > 0 ? h('div', { className: 'loci-card-hint' }, t('card.pendingHint').replace('{n}', String(pending))) : null,
+        pending > 0
+          ? h(
+              'button',
+              {
+                type: 'button',
+                className: 'loci-card-hint loci-card-hint-action',
+                onClick: (event) => {
+                  event.stopPropagation();
+                  requestedTab = 'review';
+                  open?.();
+                },
+              },
+              t('card.pendingHint').replace('{n}', String(pending)),
+            )
+          : null,
       );
     }
     // ---------------------------------------------------------------- panel
@@ -1134,7 +1172,12 @@ window.__ModuleLoader__.load({
     }
 
     function MemoryPanel({ t }) {
-      const [tab, setTab] = useState('feed');
+      const [tab, setTab] = useState(() => {
+        // "N item(s) waiting for you in Review" in the card is a way in, not a remark.
+        const wanted = requestedTab;
+        requestedTab = undefined;
+        return wanted ?? 'feed';
+      });
       const [selected, setSelected] = useState(undefined);
       const [nonce, setNonce] = useState(0);
       const tabs = useMemo(
@@ -1178,6 +1221,10 @@ window.__ModuleLoader__.load({
     }
 
     function PanelIcon({ size, active }) {
+      // Three stacked sheets: the product is a layered index, and the glyph has to read at
+      // the same optical weight as the shipped icons beside it. The previous drawing lived
+      // in 4–20 of the viewBox with a small off-centre dot, which made it look thinner and
+      // smaller than its neighbours in the sidebar.
       return h(
         'svg',
         {
@@ -1186,10 +1233,28 @@ window.__ModuleLoader__.load({
           viewBox: '0 0 24 24',
           fill: 'none',
           'aria-hidden': true,
-          style: { opacity: active ? 1 : 0.75, display: 'block' },
+          style: { opacity: active ? 1 : 0.72, display: 'block' },
         },
-        h('path', { d: 'M4 6.5h16M4 12h16M4 17.5h10', stroke: 'currentColor', strokeWidth: 1.7, strokeLinecap: 'round' }),
-        h('circle', { cx: 18.5, cy: 17.5, r: 2.2, stroke: 'currentColor', strokeWidth: 1.5 }),
+        h('path', {
+          d: 'M12 3 21 7.5 12 12 3 7.5 12 3Z',
+          stroke: 'currentColor',
+          strokeWidth: 1.8,
+          strokeLinejoin: 'round',
+        }),
+        h('path', {
+          d: 'M3.6 12.2 12 16.4l8.4-4.2',
+          stroke: 'currentColor',
+          strokeWidth: 1.8,
+          strokeLinecap: 'round',
+          strokeLinejoin: 'round',
+        }),
+        h('path', {
+          d: 'M3.6 16.8 12 21l8.4-4.2',
+          stroke: 'currentColor',
+          strokeWidth: 1.8,
+          strokeLinecap: 'round',
+          strokeLinejoin: 'round',
+        }),
       );
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-loci",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Layered long-term memory for DeepSeek Harness: the prompt sees only a stable index, full text is one lookup away. Bi-temporal facts, strict scope isolation, verified-only injection.",
   "type": "module",
   "license": "MIT",

package/src/host/index.js

@@ -23,7 +23,7 @@ import { registerCommands } from './commands.js';
 import { runDoctor } from './doctor.js';
 
 /** Version stamped into the database and diagnostics. */
-export const VERSION = '3.0.0';
+export const VERSION = '3.1.0';
 
 /** Optional collaborators; without them the plugin still serves tools. */
 export const inject = ['systemPrompt', 'tools'];

package/src/mcp/store-facade.js

@@ -36,7 +36,7 @@ export function openFacadeStore(options = {}) {
     memoryRoot: root,
     paths,
     config,
-    pluginVersion: '3.0.0',
+    pluginVersion: '3.1.0',
     readOnly: options.readOnly === true,
   });
   return { store, paths };