@aryacode/dsh-aryacode-polish 0.19.0 → 0.21.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.21.2] - 2026-10-28
+
+Fixed: the folders-only density showed a zero count because it read the hidden session list instead of the real one.
+
+ - 2026-10-28
+
+Added: a folders-only density that hides session rows, and [ / ] to hop between workspaces.
+
+## [0.20.0] - 2026-10-28
+
+Added: session flags and notes, shown on the row and on hover; the whole tree can be copied as indented text from the header.
+
 ## [0.19.0] - 2026-10-28
 
 ### Added

package/client/workspace.js

@@ -371,6 +371,23 @@ export function flattenRows(rows, expanded, query) {
   return flat
 }
 
+/** Where the cursor lands when hopping to the next or previous workspace head. */
+export function jumpWorkspace(list, cursor, step) {
+  const flat = Array.isArray(list) ? list : []
+  const heads = []
+  flat.forEach((item, index) => {
+    if (item && item.kind === 'workspace') heads.push(index)
+  })
+  if (heads.length === 0) return -1
+  if (cursor === undefined || cursor < 0) return step > 0 ? heads[0] : heads[heads.length - 1]
+  if (step > 0) {
+    const after = heads.find(index => index > cursor)
+    return after === undefined ? heads[0] : after
+  }
+  const before = heads.filter(index => index < cursor)
+  return before.length === 0 ? heads[heads.length - 1] : before[before.length - 1]
+}
+
 export function moveBefore(list, movingId, beforeId) {
   const from = list.findIndex(item => item.id === movingId)
   const to = list.findIndex(item => item.id === beforeId)
@@ -387,6 +404,79 @@ const ORDER_KEY = 'aryacode-polish:workspace-order.v1'
 const FOLD_KEY = 'aryacode-polish:folded.v1'
 const DENSITY_KEY = 'aryacode-polish:density.v1'
 const FOLDER_KEY = 'aryacode-polish:folders.v1'
+const MARK_KEY = 'aryacode-polish:session-marks.v1'
+
+export function markOf(map, sessionId) {
+  const entry = (map && map[String(sessionId)]) || {}
+  return {
+    flag: entry.flag === true,
+    note: typeof entry.note === 'string' && entry.note.length > 0 ? entry.note : undefined,
+  }
+}
+
+export function withMark(map, sessionId, patch) {
+  const next = Object.assign({}, map || {})
+  const key = String(sessionId)
+  const merged = Object.assign({}, markOf(next, key), patch || {})
+  const entry = {}
+  if (merged.flag === true) entry.flag = true
+  if (merged.note) entry.note = merged.note
+  if (Object.keys(entry).length === 0) delete next[key]
+  else next[key] = entry
+  return next
+}
+
+export function readMarks(storage) {
+  try {
+    const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+    if (!store) return {}
+    const parsed = JSON.parse(store.getItem(MARK_KEY) || '{}')
+    return parsed && typeof parsed === 'object' ? parsed : {}
+  } catch {
+    return {}
+  }
+}
+
+export function writeMarks(map, storage) {
+  try {
+    const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+    if (!store) return
+    store.setItem(MARK_KEY, JSON.stringify(map || {}))
+  } catch {
+    /* a mark is a nicety */
+  }
+}
+
+/** The whole tree as indented text, for pasting into a prompt or an issue. */
+export function treeText(rows, folderNames, markOfSession) {
+  const lines = []
+  const seen = new Set()
+  const pushGroup = (folder) => {
+    if (seen.has(folder)) return
+    seen.add(folder)
+    lines.push(folder)
+    for (const row of rows || []) {
+      const name = folderKey(row.workspace)
+      if (name !== folder) continue
+      lines.push('  ' + workspaceLabel(row.workspace))
+      for (const session of row.sessions || []) {
+        const mark = typeof markOfSession === 'function' ? markOfSession(session.id) : { flag: false }
+        lines.push('    ' + (mark && mark.flag ? '⚑ ' : '') + String(session.displayTitle || session.title || session.id))
+      }
+    }
+  }
+  for (const folder of folderNames || []) pushGroup(folder)
+  for (const row of rows || []) {
+    const name = folderKey(row.workspace)
+    if (name !== undefined) continue
+    lines.push(workspaceLabel(row.workspace))
+    for (const session of row.sessions || []) {
+      const mark = typeof markOfSession === 'function' ? markOfSession(session.id) : { flag: false }
+      lines.push('  ' + (mark && mark.flag ? '⚑ ' : '') + String(session.displayTitle || session.title || session.id))
+    }
+  }
+  return lines.join('\n')
+}
 
 const cleanFolder = (name) => {
   const value = String(name || '').trim().replace(/^\/+|\/+$/g, '')
@@ -449,16 +539,34 @@ export function folderNamesOf(rows, declared) {
   return seen
 }
 
-export const DENSITIES = ['comfortable', 'compact']
+export const DENSITIES = ['comfortable', 'compact', 'folders']
 
 /** Row height per density: the tree fits more rows without shrinking the text. */
 export const DENSITY_METRICS = {
-  comfortable: { row: '28px' },
-  compact: { row: '22px' },
+  comfortable: { row: '28px', sessions: true },
+  compact: { row: '22px', sessions: true },
+  folders: { row: '24px', sessions: false },
+}
+
+export const DENSITY_TITLES = {
+  comfortable: 'Use compact rows',
+  compact: 'Show folders only',
+  folders: 'Use comfortable rows',
+}
+
+export const DENSITY_GLYPHS = {
+  comfortable: '\u2263',
+  compact: '\u2261',
+  folders: '\u25a4',
 }
 
 export function densityOf(value) {
-  return value === 'compact' ? 'compact' : 'comfortable'
+  return DENSITIES.indexOf(value) >= 0 ? value : 'comfortable'
+}
+
+export function nextDensity(value) {
+  const list = DENSITIES
+  return list[(list.indexOf(densityOf(value)) + 1) % list.length]
 }
 
 export function readDensity(storage) {
@@ -937,11 +1045,14 @@ export function BetterWorkspace(props) {
   const [folders, setFolders] = React.useState(folded.folders)
   const [declared, setDeclared] = React.useState(() => readFolders())
   const [folderDraft, setFolderDraft] = React.useState('')
+  const [marks, setMarks] = React.useState(() => readMarks())
+  const [markDraft, setMarkDraft] = React.useState('')
   const [switcher, setSwitcher] = React.useState(null)
   const [density, setDensity] = React.useState(() => readDensity())
   const [archiveOpen, setArchiveOpen] = React.useState(false)
   React.useEffect(() => { writeFolded({ workspaces: expanded, folders }) }, [expanded, folders])
   React.useEffect(() => { writeFolders(declared) }, [declared])
+  React.useEffect(() => { writeMarks(marks) }, [marks])
   const [renaming, setRenaming] = React.useState(null)
   const commitRename = async () => {
     const draft = renaming
@@ -1117,7 +1228,17 @@ export function BetterWorkspace(props) {
     if (item.kind === 'workspace') toggleWorkspace(item.workspaceId)
     else services.openSession(item.id)
   }
+  /** [ and ] hop between workspace heads: the fast way through a long tree. */
+  const hopWorkspace = (step) => {
+    const next = jumpWorkspace(walk, cursor, step)
+    if (next >= 0) setCursor(next)
+  }
   const onKeyDown = (event) => {
+    if (event.key === '[' || event.key === ']') {
+      event.preventDefault()
+      hopWorkspace(event.key === ']' ? 1 : -1)
+      return
+    }
     if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
       if (walk.length === 0) return
       event.preventDefault()
@@ -1355,6 +1476,28 @@ export function BetterWorkspace(props) {
       React.createElement('div', { style: WS_MENU_HINT }, 'Renames every workspace inside it'))
     : null
 
+  const markMenu = menu && menu.kind === 'mark'
+    ? React.createElement(RowMenu, { anchor: menu.anchor, onClose: closeMenu },
+      React.createElement('input', {
+        'data-polish-mark-input': 'true',
+        type: 'text',
+        value: markDraft,
+        placeholder: 'A note for this session',
+        autoFocus: true,
+        style: WS_NOTE_INPUT,
+        onChange: (event) => setMarkDraft(event.target.value),
+        onKeyDown: (event) => {
+          if (event.key === 'Escape') { event.stopPropagation(); closeMenu(); return }
+          if (event.key !== 'Enter') return
+          const id = menu.row.id
+          const value = markDraft.trim()
+          closeMenu()
+          setMarks((prev) => withMark(prev, id, { note: value }))
+        },
+      }),
+      React.createElement('div', { style: WS_MENU_HINT }, 'Enter saves, Escape cancels'))
+    : null
+
   const glyphMenu = menu && menu.kind === 'glyph'
     ? React.createElement(RowMenu, { anchor: menu.anchor, onClose: closeMenu },
       React.createElement('div', { style: WS_GLYPH_GRID },
@@ -1463,7 +1606,29 @@ export function BetterWorkspace(props) {
           workspacesSnapshot: workspaceState,
           session: { sessionId: menu.row.id, displayTitle: menu.row.displayTitle, session: menu.row },
         }))),
-      null)
+      React.createElement('button', {
+        type: 'button',
+        'data-polish-session-flag': menu.row.id,
+        style: WS_MENU_ITEM,
+        onClick: () => {
+          const row = menu.row
+          const current = markOf(marks, row.id)
+          closeMenu()
+          setMarks((prev) => withMark(prev, row.id, { flag: !current.flag }))
+        },
+      }, markOf(marks, menu.row.id).flag ? 'Remove flag' : 'Flag this session'),
+      React.createElement('button', {
+        type: 'button',
+        'data-polish-session-note': menu.row.id,
+        style: WS_MENU_ITEM,
+        onClick: () => {
+          const row = menu.row
+          const anchor = menu.anchor
+          closeMenu()
+          setMarkDraft(markOf(marks, row.id).note || '')
+          setMenu({ kind: 'mark', row, anchor })
+        },
+      }, 'Session note…'))
     : null
 
   const switcherCard = switcher
@@ -1529,19 +1694,33 @@ export function BetterWorkspace(props) {
       style: WS_ADD,
       onClick: foldAll,
     }, allFolded ? '⌄' : '⌃'),
+    React.createElement('button', {
+      key: 'copy',
+      type: 'button',
+      'data-polish-ws-copy': 'tree',
+      title: 'Copy the tree as text',
+      'aria-label': 'Copy the tree as text',
+      style: WS_ADD,
+      onClick: () => {
+        const text = treeText(rows, folderNames, (id) => markOf(marks, id))
+        Promise.resolve(navigator.clipboard.writeText(text))
+          .then(() => setNotice('Tree copied.'))
+          .catch(() => setNotice('Could not copy the tree.'))
+      },
+    }, '⧉'),
     React.createElement('button', {
       key: 'density',
       type: 'button',
       'data-polish-ws-density': densityOf(density),
-      title: densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
-      'aria-label': densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
+      title: DENSITY_TITLES[densityOf(density)],
+      'aria-label': DENSITY_TITLES[densityOf(density)],
       style: WS_ADD,
       onClick: () => {
-        const next = densityOf(density) === 'compact' ? 'comfortable' : 'compact'
+        const next = nextDensity(density)
         setDensity(next)
         writeDensity(next)
       },
-    }, densityOf(density) === 'compact' ? '≡' : '≣'),
+    }, DENSITY_GLYPHS[densityOf(density)]),
     React.createElement('button', {
       key: 'add',
       type: 'button',
@@ -1638,8 +1817,14 @@ export function BetterWorkspace(props) {
       }),
       onClick: () => services.openSession(row.id),
       onContextMenu: (event) => openMenu(event, row, workspace),
-      onMouseEnter: () => setHover('session:' + row.id),
-      onMouseLeave: () => setHover(null),
+      onMouseEnter: (event) => {
+        setHover('session:' + row.id)
+        const note = markOf(marks, row.id).note
+        if (!note) return
+        const box = event.currentTarget.getBoundingClientRect()
+        setCard({ text: note, top: box.bottom + 6, left: Math.max(8, box.left) })
+      },
+      onMouseLeave: () => { setHover(null); setCard(null) },
       onDragStart: () => setDrag({ kind: 'session', id: row.id, workspaceId: workspace.workspaceId }),
       onDragOver: (event) => {
         if (!drag || drag.kind !== 'session' || drag.id === row.id) return
@@ -1651,7 +1836,14 @@ export function BetterWorkspace(props) {
     },
     row.running ? React.createElement('span', { style: WS_DOT, title: 'Running' }) : null,
     pinned.has(row.id) ? React.createElement('span', { style: WS_PIN, title: 'Pinned' }, '\u2605') : null,
-    React.createElement('span', { style: WS_TITLE }, row.displayTitle || row.id),
+    markOf(marks, row.id).flag
+      ? React.createElement('span', { 'data-polish-mark-flag': row.id, style: WS_PIN, title: 'Flagged' }, '⚑')
+      : null,
+    React.createElement('span', {
+      style: Object.assign({}, WS_TITLE, {
+        fontStyle: markOf(marks, row.id).note ? 'italic' : undefined,
+      }),
+    }, row.displayTitle || row.id),
     rowHovered || rowFocused
       ? React.createElement('button', {
         type: 'button',
@@ -1789,7 +1981,7 @@ export function BetterWorkspace(props) {
       : null)))
 
     if (open) {
-      sessions.forEach((row) => {
+      (metrics.sessions ? sessions : []).forEach((row) => {
         index += 1
         children.push(sessionRow(workspace, row, index))
       })
@@ -1907,6 +2099,7 @@ export function BetterWorkspace(props) {
   noteMenu,
   folderMenu,
   renameFolderMenu,
+  markMenu,
   noteCard,
   archivedMenu,
   paintMenu,

package/docs/better-workspace.md

@@ -225,3 +225,35 @@ a renamed folder does not suddenly spring open.
 and does the inverse: `unfiled('Work/Alpha')` is `Alpha`, renamed through the Host like any
 other title change. A folder left with nothing in it simply stops being drawn, unless it was
 declared empty on purpose.
+
+## Flags and notes on sessions
+
+A session can carry a flag (`⚑`, shown before its title) and a note (shown on hover, in the same
+card the workspace notes use). Both live in `aryacode-polish:session-marks.v1`, keyed by session
+id, and both are set from the session's own menu: **Flag this session** / **Remove flag** and
+**Session note…** (Enter saves, Escape cancels). The tree never invents a session, so a mark for a
+session that no longer exists is simply never drawn.
+
+## Copy the tree
+
+The header's `⧉` copies the whole tree as indented text — folders, workspaces, sessions, with
+`⚑` before a flagged session — through `navigator.clipboard.writeText`. It is meant for pasting
+into a prompt or an issue: "here is what I am looking at", without screenshots.
+
+## Folders only
+
+The density button walks three states, not two: comfortable, compact, and **folders only**. The
+last one keeps every folder and workspace row (with its real session count) and drops the session
+rows entirely — useful when you are navigating the shape of your work rather than a specific
+session. Nothing is lost: one more click returns to comfortable, and the mode is remembered in
+`aryacode-polish:density.v1`.
+
+One trap it exposed: the workspace count must come from the unfiltered session list. Reading the
+list the tree was about to draw made every workspace read `0` in this mode, which looked like the
+feature had eaten the sessions.
+
+## Hopping between workspaces
+
+With the tree focused, `[` and `]` move the keyboard cursor to the previous / next workspace head
+and wrap at the ends. It is a second gear next to ArrowUp/ArrowDown: arrows walk rows, brackets
+walk groups, so a long flat list of sessions stops being a scroll-and-squint exercise.

package/lib/client.js

@@ -53,7 +53,7 @@ window.__ModuleLoader__.load({
     ]
     const ROW_ID = "polish"
     const ROW_KEY = "@aryacode/dsh-aryacode-polish" + '#' + ROW_ID
-    const CLIENT_VERSION = "0.19.0"
+    const CLIENT_VERSION = "0.21.2"
 
 /* html2canvas 1.4.1 — MIT, vendored from vendor/html2canvas.min.js.
  * A UMD build, so it assigns itself to globalThis; face.js reads it lazily. */
@@ -572,6 +572,23 @@ window.__ModuleLoader__.load({
       return flat
     }
 
+    /** Where the cursor lands when hopping to the next or previous workspace head. */
+    function jumpWorkspace(list, cursor, step) {
+      const flat = Array.isArray(list) ? list : []
+      const heads = []
+      flat.forEach((item, index) => {
+        if (item && item.kind === 'workspace') heads.push(index)
+      })
+      if (heads.length === 0) return -1
+      if (cursor === undefined || cursor < 0) return step > 0 ? heads[0] : heads[heads.length - 1]
+      if (step > 0) {
+        const after = heads.find(index => index > cursor)
+        return after === undefined ? heads[0] : after
+      }
+      const before = heads.filter(index => index < cursor)
+      return before.length === 0 ? heads[heads.length - 1] : before[before.length - 1]
+    }
+
     function moveBefore(list, movingId, beforeId) {
       const from = list.findIndex(item => item.id === movingId)
       const to = list.findIndex(item => item.id === beforeId)
@@ -588,6 +605,79 @@ window.__ModuleLoader__.load({
     const FOLD_KEY = 'aryacode-polish:folded.v1'
     const DENSITY_KEY = 'aryacode-polish:density.v1'
     const FOLDER_KEY = 'aryacode-polish:folders.v1'
+    const MARK_KEY = 'aryacode-polish:session-marks.v1'
+
+    function markOf(map, sessionId) {
+      const entry = (map && map[String(sessionId)]) || {}
+      return {
+        flag: entry.flag === true,
+        note: typeof entry.note === 'string' && entry.note.length > 0 ? entry.note : undefined,
+      }
+    }
+
+    function withMark(map, sessionId, patch) {
+      const next = Object.assign({}, map || {})
+      const key = String(sessionId)
+      const merged = Object.assign({}, markOf(next, key), patch || {})
+      const entry = {}
+      if (merged.flag === true) entry.flag = true
+      if (merged.note) entry.note = merged.note
+      if (Object.keys(entry).length === 0) delete next[key]
+      else next[key] = entry
+      return next
+    }
+
+    function readMarks(storage) {
+      try {
+        const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+        if (!store) return {}
+        const parsed = JSON.parse(store.getItem(MARK_KEY) || '{}')
+        return parsed && typeof parsed === 'object' ? parsed : {}
+      } catch {
+        return {}
+      }
+    }
+
+    function writeMarks(map, storage) {
+      try {
+        const store = storage || (typeof localStorage === 'undefined' ? undefined : localStorage)
+        if (!store) return
+        store.setItem(MARK_KEY, JSON.stringify(map || {}))
+      } catch {
+        /* a mark is a nicety */
+      }
+    }
+
+    /** The whole tree as indented text, for pasting into a prompt or an issue. */
+    function treeText(rows, folderNames, markOfSession) {
+      const lines = []
+      const seen = new Set()
+      const pushGroup = (folder) => {
+        if (seen.has(folder)) return
+        seen.add(folder)
+        lines.push(folder)
+        for (const row of rows || []) {
+          const name = folderKey(row.workspace)
+          if (name !== folder) continue
+          lines.push('  ' + workspaceLabel(row.workspace))
+          for (const session of row.sessions || []) {
+            const mark = typeof markOfSession === 'function' ? markOfSession(session.id) : { flag: false }
+            lines.push('    ' + (mark && mark.flag ? '⚑ ' : '') + String(session.displayTitle || session.title || session.id))
+          }
+        }
+      }
+      for (const folder of folderNames || []) pushGroup(folder)
+      for (const row of rows || []) {
+        const name = folderKey(row.workspace)
+        if (name !== undefined) continue
+        lines.push(workspaceLabel(row.workspace))
+        for (const session of row.sessions || []) {
+          const mark = typeof markOfSession === 'function' ? markOfSession(session.id) : { flag: false }
+          lines.push('  ' + (mark && mark.flag ? '⚑ ' : '') + String(session.displayTitle || session.title || session.id))
+        }
+      }
+      return lines.join('\n')
+    }
 
     const cleanFolder = (name) => {
       const value = String(name || '').trim().replace(/^\/+|\/+$/g, '')
@@ -650,16 +740,34 @@ window.__ModuleLoader__.load({
       return seen
     }
 
-    const DENSITIES = ['comfortable', 'compact']
+    const DENSITIES = ['comfortable', 'compact', 'folders']
 
     /** Row height per density: the tree fits more rows without shrinking the text. */
     const DENSITY_METRICS = {
-      comfortable: { row: '28px' },
-      compact: { row: '22px' },
+      comfortable: { row: '28px', sessions: true },
+      compact: { row: '22px', sessions: true },
+      folders: { row: '24px', sessions: false },
+    }
+
+    const DENSITY_TITLES = {
+      comfortable: 'Use compact rows',
+      compact: 'Show folders only',
+      folders: 'Use comfortable rows',
+    }
+
+    const DENSITY_GLYPHS = {
+      comfortable: '\u2263',
+      compact: '\u2261',
+      folders: '\u25a4',
     }
 
     function densityOf(value) {
-      return value === 'compact' ? 'compact' : 'comfortable'
+      return DENSITIES.indexOf(value) >= 0 ? value : 'comfortable'
+    }
+
+    function nextDensity(value) {
+      const list = DENSITIES
+      return list[(list.indexOf(densityOf(value)) + 1) % list.length]
     }
 
     function readDensity(storage) {
@@ -1138,11 +1246,14 @@ window.__ModuleLoader__.load({
       const [folders, setFolders] = React.useState(folded.folders)
       const [declared, setDeclared] = React.useState(() => readFolders())
       const [folderDraft, setFolderDraft] = React.useState('')
+      const [marks, setMarks] = React.useState(() => readMarks())
+      const [markDraft, setMarkDraft] = React.useState('')
       const [switcher, setSwitcher] = React.useState(null)
       const [density, setDensity] = React.useState(() => readDensity())
       const [archiveOpen, setArchiveOpen] = React.useState(false)
       React.useEffect(() => { writeFolded({ workspaces: expanded, folders }) }, [expanded, folders])
       React.useEffect(() => { writeFolders(declared) }, [declared])
+      React.useEffect(() => { writeMarks(marks) }, [marks])
       const [renaming, setRenaming] = React.useState(null)
       const commitRename = async () => {
         const draft = renaming
@@ -1318,7 +1429,17 @@ window.__ModuleLoader__.load({
         if (item.kind === 'workspace') toggleWorkspace(item.workspaceId)
         else services.openSession(item.id)
       }
+      /** [ and ] hop between workspace heads: the fast way through a long tree. */
+      const hopWorkspace = (step) => {
+        const next = jumpWorkspace(walk, cursor, step)
+        if (next >= 0) setCursor(next)
+      }
       const onKeyDown = (event) => {
+        if (event.key === '[' || event.key === ']') {
+          event.preventDefault()
+          hopWorkspace(event.key === ']' ? 1 : -1)
+          return
+        }
         if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
           if (walk.length === 0) return
           event.preventDefault()
@@ -1556,6 +1677,28 @@ window.__ModuleLoader__.load({
           React.createElement('div', { style: WS_MENU_HINT }, 'Renames every workspace inside it'))
         : null
 
+      const markMenu = menu && menu.kind === 'mark'
+        ? React.createElement(RowMenu, { anchor: menu.anchor, onClose: closeMenu },
+          React.createElement('input', {
+            'data-polish-mark-input': 'true',
+            type: 'text',
+            value: markDraft,
+            placeholder: 'A note for this session',
+            autoFocus: true,
+            style: WS_NOTE_INPUT,
+            onChange: (event) => setMarkDraft(event.target.value),
+            onKeyDown: (event) => {
+              if (event.key === 'Escape') { event.stopPropagation(); closeMenu(); return }
+              if (event.key !== 'Enter') return
+              const id = menu.row.id
+              const value = markDraft.trim()
+              closeMenu()
+              setMarks((prev) => withMark(prev, id, { note: value }))
+            },
+          }),
+          React.createElement('div', { style: WS_MENU_HINT }, 'Enter saves, Escape cancels'))
+        : null
+
       const glyphMenu = menu && menu.kind === 'glyph'
         ? React.createElement(RowMenu, { anchor: menu.anchor, onClose: closeMenu },
           React.createElement('div', { style: WS_GLYPH_GRID },
@@ -1664,7 +1807,29 @@ window.__ModuleLoader__.load({
               workspacesSnapshot: workspaceState,
               session: { sessionId: menu.row.id, displayTitle: menu.row.displayTitle, session: menu.row },
             }))),
-          null)
+          React.createElement('button', {
+            type: 'button',
+            'data-polish-session-flag': menu.row.id,
+            style: WS_MENU_ITEM,
+            onClick: () => {
+              const row = menu.row
+              const current = markOf(marks, row.id)
+              closeMenu()
+              setMarks((prev) => withMark(prev, row.id, { flag: !current.flag }))
+            },
+          }, markOf(marks, menu.row.id).flag ? 'Remove flag' : 'Flag this session'),
+          React.createElement('button', {
+            type: 'button',
+            'data-polish-session-note': menu.row.id,
+            style: WS_MENU_ITEM,
+            onClick: () => {
+              const row = menu.row
+              const anchor = menu.anchor
+              closeMenu()
+              setMarkDraft(markOf(marks, row.id).note || '')
+              setMenu({ kind: 'mark', row, anchor })
+            },
+          }, 'Session note…'))
         : null
 
       const switcherCard = switcher
@@ -1730,19 +1895,33 @@ window.__ModuleLoader__.load({
           style: WS_ADD,
           onClick: foldAll,
         }, allFolded ? '⌄' : '⌃'),
+        React.createElement('button', {
+          key: 'copy',
+          type: 'button',
+          'data-polish-ws-copy': 'tree',
+          title: 'Copy the tree as text',
+          'aria-label': 'Copy the tree as text',
+          style: WS_ADD,
+          onClick: () => {
+            const text = treeText(rows, folderNames, (id) => markOf(marks, id))
+            Promise.resolve(navigator.clipboard.writeText(text))
+              .then(() => setNotice('Tree copied.'))
+              .catch(() => setNotice('Could not copy the tree.'))
+          },
+        }, '⧉'),
         React.createElement('button', {
           key: 'density',
           type: 'button',
           'data-polish-ws-density': densityOf(density),
-          title: densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
-          'aria-label': densityOf(density) === 'compact' ? 'Use comfortable rows' : 'Use compact rows',
+          title: DENSITY_TITLES[densityOf(density)],
+          'aria-label': DENSITY_TITLES[densityOf(density)],
           style: WS_ADD,
           onClick: () => {
-            const next = densityOf(density) === 'compact' ? 'comfortable' : 'compact'
+            const next = nextDensity(density)
             setDensity(next)
             writeDensity(next)
           },
-        }, densityOf(density) === 'compact' ? '≡' : '≣'),
+        }, DENSITY_GLYPHS[densityOf(density)]),
         React.createElement('button', {
           key: 'add',
           type: 'button',
@@ -1839,8 +2018,14 @@ window.__ModuleLoader__.load({
           }),
           onClick: () => services.openSession(row.id),
           onContextMenu: (event) => openMenu(event, row, workspace),
-          onMouseEnter: () => setHover('session:' + row.id),
-          onMouseLeave: () => setHover(null),
+          onMouseEnter: (event) => {
+            setHover('session:' + row.id)
+            const note = markOf(marks, row.id).note
+            if (!note) return
+            const box = event.currentTarget.getBoundingClientRect()
+            setCard({ text: note, top: box.bottom + 6, left: Math.max(8, box.left) })
+          },
+          onMouseLeave: () => { setHover(null); setCard(null) },
           onDragStart: () => setDrag({ kind: 'session', id: row.id, workspaceId: workspace.workspaceId }),
           onDragOver: (event) => {
             if (!drag || drag.kind !== 'session' || drag.id === row.id) return
@@ -1852,7 +2037,14 @@ window.__ModuleLoader__.load({
         },
         row.running ? React.createElement('span', { style: WS_DOT, title: 'Running' }) : null,
         pinned.has(row.id) ? React.createElement('span', { style: WS_PIN, title: 'Pinned' }, '\u2605') : null,
-        React.createElement('span', { style: WS_TITLE }, row.displayTitle || row.id),
+        markOf(marks, row.id).flag
+          ? React.createElement('span', { 'data-polish-mark-flag': row.id, style: WS_PIN, title: 'Flagged' }, '⚑')
+          : null,
+        React.createElement('span', {
+          style: Object.assign({}, WS_TITLE, {
+            fontStyle: markOf(marks, row.id).note ? 'italic' : undefined,
+          }),
+        }, row.displayTitle || row.id),
         rowHovered || rowFocused
           ? React.createElement('button', {
             type: 'button',
@@ -1990,7 +2182,7 @@ window.__ModuleLoader__.load({
           : null)))
 
         if (open) {
-          sessions.forEach((row) => {
+          (metrics.sessions ? sessions : []).forEach((row) => {
             index += 1
             children.push(sessionRow(workspace, row, index))
           })
@@ -2108,6 +2300,7 @@ window.__ModuleLoader__.load({
       noteMenu,
       folderMenu,
       renameFolderMenu,
+      markMenu,
       noteCard,
       archivedMenu,
       paintMenu,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aryacode/dsh-aryacode-polish",
-  "version": "0.19.0",
+  "version": "0.21.2",
   "description": "AryaCode Polish: one install for the small things that make AryaCode feel finished. One Plugins row, one switch per quality-of-life feature.",
   "keywords": [
     "dsh",