feat: add signifiers to notes

Author: gruberb

CHANGELOG.md

@@ -15,7 +15,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
  - Meeting Notes (Attendees / Discussion / Action Items) with auto-tag `#meeting`
  - Learning Log (What I Learned / Source / How to Apply) with auto-tag `#learning`
 - Saved filters — save the current tag + text filter combination as a named quick-access filter in the sidebar
-- Pin entries — star icon on entry cards to pin important entries; pinned entries float to the top in a dedicated "Pinned" section above day groups
+- Pin entries — pin icon on entry cards to keep important entries at the top in a dedicated "Pinned" section above day groups
+- Entry signifiers — optional colored label (Note, Decision, Task, Question, Idea) on each entry; click the dot in the header to pick
 
 ## [2.2.3] - 2026-02-15
 

src/app/App.tsx

@@ -26,7 +26,7 @@ export default function App() {
 function AppContent() {
  const isMobile = useIsMobile();
  const { loading } = useEntriesData();
- const { createEntry, updateEntry, updateEntryTags, archiveEntry, unarchiveEntry, deleteEntry, pinEntry, unpinEntry } = useEntriesActions();
+ const { createEntry, updateEntry, updateEntryTags, archiveEntry, unarchiveEntry, deleteEntry, pinEntry, unpinEntry, updateEntrySignifier } = useEntriesActions();
  const { isOpen: sidebarOpen, archiveView } = useSidebarUI();
  const { textQuery, selectedTags, hasActiveFilters, removeTag, clearAllFilters, saveCurrentFilter, savedFilters } = useSidebarFilter();
  const { displayEntriesByDay, displayArchivedEntriesByDay } = useSidebarData();
@@ -80,6 +80,7 @@ function AppContent() {
  savedFilters={!archiveView ? savedFilters : undefined}
  onPin={archiveView ? undefined : pinEntry}
  onUnpin={archiveView ? undefined : unpinEntry}
+ onSignifierChange={archiveView ? undefined : updateEntrySignifier}
  onOpenAI={aiSettings.enabled && aiAvailable && !isMobile ? handleOpenAI : undefined}
  focusedEntryId={focusedEntryId}
  onFocusEntry={handleFocusEntry}

src/features/entries/components/EntryCard.tsx

@@ -6,6 +6,7 @@ import { TagEditor } from "./TagEditor.tsx";
 import { ConfirmAction } from "../../../components/ui/ConfirmAction.tsx";
 import { ErrorBoundary } from "../../../components/ui/ErrorBoundary.tsx";
 import { CheckIcon, ArchiveIcon, TrashIcon, AIIcon } from "../../../components/ui/Icons.tsx";
+import { SignifierPicker } from "./SignifierPicker.tsx";
 
 interface EntryCardProps {
  entry: WorkLedgerEntry;
@@ -17,12 +18,13 @@ interface EntryCardProps {
  onUnarchive?: (id: string) => void;
  onPin?: (id: string) => void;
  onUnpin?: (id: string) => void;
+ onSignifierChange?: (id: string, signifier: string | undefined) => void;
  isArchiveView?: boolean;
  onOpenAI?: (entry: WorkLedgerEntry) => void;
  onFocus?: (entry: WorkLedgerEntry) => void;
 }
 
-export const EntryCard = memo(function EntryCard({ entry, isLatest, onSave, onTagsChange, onArchive, onDelete, onUnarchive, onPin, onUnpin, isArchiveView, onOpenAI, onFocus }: EntryCardProps) {
+export const EntryCard = memo(function EntryCard({ entry, isLatest, onSave, onTagsChange, onArchive, onDelete, onUnarchive, onPin, onUnpin, onSignifierChange, isArchiveView, onOpenAI, onFocus }: EntryCardProps) {
  const isOld = entry.dayKey < todayKey();
  const [confirmArchive, setConfirmArchive] = useState(false);
  const [confirmDelete, setConfirmDelete] = useState(false);
@@ -52,6 +54,19 @@ export const EntryCard = memo(function EntryCard({ entry, isLatest, onSave, onTa
  archived
  </span>
  )}
+ {onSignifierChange && !isArchiveView && (
+ <SignifierPicker
+ value={entry.signifier}
+ onChange={(s) => onSignifierChange(entry.id, s)}
+ />
+ )}
+ {isArchiveView && entry.signifier && (
+ <span className={`text-[11px] font-medium ${
+ { note: "text-blue-500", decision: "text-emerald-500", task: "text-violet-500", question: "text-amber-500", idea: "text-pink-500" }[entry.signifier]
+ }`}>
+ {entry.signifier}
+ </span>
+ )}
 
  {/* Action buttons */}
  <div className="ml-auto flex items-center gap-1">

src/features/entries/components/EntryStream.tsx

@@ -23,13 +23,14 @@ interface EntryStreamProps {
  savedFilters?: SavedFilter[];
  onPin?: (id: string) => void;
  onUnpin?: (id: string) => void;
+ onSignifierChange?: (id: string, signifier: string | undefined) => void;
  onOpenAI?: (entry: WorkLedgerEntry) => void;
  focusedEntryId?: string | null;
  onFocusEntry?: (entry: WorkLedgerEntry) => void;
  onExitFocus?: () => void;
 }
 
-export function EntryStream({ entriesByDay, onSave, onTagsChange, onArchive, onDelete, onUnarchive, isArchiveView, textQuery, selectedTags, hasActiveFilters, onRemoveTag, onClearAllFilters, onSaveFilter, savedFilters, onPin, onUnpin, onOpenAI, focusedEntryId, onFocusEntry, onExitFocus }: EntryStreamProps) {
+export function EntryStream({ entriesByDay, onSave, onTagsChange, onArchive, onDelete, onUnarchive, isArchiveView, textQuery, selectedTags, hasActiveFilters, onRemoveTag, onClearAllFilters, onSaveFilter, savedFilters, onPin, onUnpin, onSignifierChange, onOpenAI, focusedEntryId, onFocusEntry, onExitFocus }: EntryStreamProps) {
  // Focus mode: render only the focused entry
  if (focusedEntryId) {
  let focusedEntry: WorkLedgerEntry | undefined;
@@ -79,6 +80,7 @@ export function EntryStream({ entriesByDay, onSave, onTagsChange, onArchive, onD
  onUnarchive={isArchiveView ? onUnarchive : undefined}
  onPin={isArchiveView ? undefined : onPin}
  onUnpin={isArchiveView ? undefined : onUnpin}
+ onSignifierChange={isArchiveView ? undefined : onSignifierChange}
  isArchiveView={isArchiveView}
  onOpenAI={isArchiveView ? undefined : onOpenAI}
  />
@@ -159,6 +161,7 @@ export function EntryStream({ entriesByDay, onSave, onTagsChange, onArchive, onD
  onDelete={onDelete}
  onPin={onPin}
  onUnpin={onUnpin}
+ onSignifierChange={onSignifierChange}
  onOpenAI={onOpenAI}
  onFocus={onFocusEntry}
  />
@@ -188,6 +191,7 @@ export function EntryStream({ entriesByDay, onSave, onTagsChange, onArchive, onD
  onUnarchive={isArchiveView ? onUnarchive : undefined}
  onPin={isArchiveView ? undefined : onPin}
  onUnpin={isArchiveView ? undefined : onUnpin}
+ onSignifierChange={isArchiveView ? undefined : onSignifierChange}
  isArchiveView={isArchiveView}
  onOpenAI={isArchiveView ? undefined : onOpenAI}
  onFocus={isArchiveView ? undefined : onFocusEntry}

src/features/entries/components/SignifierPicker.tsx

@@ -0,0 +1,79 @@
+import { useState, useRef, useEffect } from "react";
+import { SIGNIFIER_CONFIG, type EntrySignifier } from "../types/entry.ts";
+
+interface SignifierPickerProps {
+ value: EntrySignifier | undefined;
+ onChange: (signifier: EntrySignifier | undefined) => void;
+}
+
+const SIGNIFIERS = Object.entries(SIGNIFIER_CONFIG) as [EntrySignifier, typeof SIGNIFIER_CONFIG[EntrySignifier]][];
+
+export function SignifierPicker({ value, onChange }: SignifierPickerProps) {
+ const [open, setOpen] = useState(false);
+ const ref = useRef<HTMLDivElement>(null);
+
+ useEffect(() => {
+ if (!open) return;
+ function handleClick(e: MouseEvent) {
+ if (ref.current && !ref.current.contains(e.target as Node)) {
+ setOpen(false);
+ }
+ }
+ document.addEventListener("mousedown", handleClick);
+ return () => document.removeEventListener("mousedown", handleClick);
+ }, [open]);
+
+ const config = value ? SIGNIFIER_CONFIG[value] : null;
+
+ return (
+ <div className="relative" ref={ref}>
+ <button
+ onClick={() => setOpen((p) => !p)}
+ className={`flex items-center gap-1 px-1.5 py-0.5 rounded-md text-[11px] transition-colors ${
+ config
+ ? `${config.color} hover:bg-gray-100 dark:hover:bg-gray-800`
+ : "text-gray-300 dark:text-gray-600 hover:text-gray-400 dark:hover:text-gray-500 hover:bg-gray-100 dark:hover:bg-gray-800"
+ }`}
+ title={config ? `Signifier: ${config.label}` : "Add signifier"}
+ aria-label={config ? `Signifier: ${config.label}` : "Add signifier"}
+ >
+ {config ? (
+ <>
+ <span className={`w-2 h-2 rounded-full bg-current`} />
+ <span className="font-medium">{config.label}</span>
+ </>
+ ) : (
+ <span className="w-2 h-2 rounded-full border border-current" />
+ )}
+ </button>
+
+ {open && (
+ <div className="absolute left-0 top-full mt-1 bg-[var(--color-notebook-surface)] border border-[var(--color-notebook-border)] rounded-lg shadow-xl py-1 z-50 w-32">
+ {SIGNIFIERS.map(([key, cfg]) => (
+ <button
+ key={key}
+ onClick={() => { onChange(key === value ? undefined : key); setOpen(false); }}
+ className={`w-full text-left px-3 py-1.5 text-xs flex items-center gap-2 transition-colors hover:bg-[var(--color-notebook-surface-alt)] ${
+ key === value ? "font-medium" : ""
+ }`}
+ >
+ <span className={`w-2 h-2 rounded-full ${cfg.color} ${key === value ? "bg-current" : "bg-current opacity-60"}`} />
+ <span className={cfg.color}>{cfg.label}</span>
+ </button>
+ ))}
+ {value && (
+ <>
+ <div className="border-t border-[var(--color-notebook-border)] my-1" />
+ <button
+ onClick={() => { onChange(undefined); setOpen(false); }}
+ className="w-full text-left px-3 py-1.5 text-xs text-gray-400 hover:bg-[var(--color-notebook-surface-alt)] transition-colors"
+ >
+ Remove signifier
+ </button>
+ </>
+ )}
+ </div>
+ )}
+ </div>
+ );
+}

src/features/entries/context/EntriesContext.tsx

@@ -19,6 +19,7 @@ interface EntriesActions {
  deleteEntry: (id: string) => Promise<void>;
  pinEntry: (id: string) => Promise<void>;
  unpinEntry: (id: string) => Promise<void>;
+ updateEntrySignifier: (id: string, signifier: string | undefined) => Promise<void>;
  refreshArchive: () => Promise<void>;
  refresh: () => Promise<void>;
  loadEntryById: (entryId: string) => Promise<WorkLedgerEntry | null>;
@@ -40,6 +41,7 @@ export function EntriesProvider({ children }: { children: ReactNode }) {
  deleteEntry,
  pinEntry,
  unpinEntry,
+ updateEntrySignifier,
  archivedEntries,
  refreshArchive,
  refresh,
@@ -60,11 +62,12 @@ export function EntriesProvider({ children }: { children: ReactNode }) {
  deleteEntry,
  pinEntry,
  unpinEntry,
+ updateEntrySignifier,
  refreshArchive,
  refresh,
  loadEntryById,
  }),
- [createEntry, updateEntry, updateEntryTags, archiveEntry, unarchiveEntry, deleteEntry, pinEntry, unpinEntry, refreshArchive, refresh, loadEntryById],
+ [createEntry, updateEntry, updateEntryTags, archiveEntry, unarchiveEntry, deleteEntry, pinEntry, unpinEntry, updateEntrySignifier, refreshArchive, refresh, loadEntryById],
  );
 
  return (

src/features/entries/hooks/useEntries.ts

@@ -10,6 +10,7 @@ import {
  deleteEntry as dbDeleteEntry,
  pinEntry as dbPinEntry,
  unpinEntry as dbUnpinEntry,
+ updateEntrySignifier as dbUpdateEntrySignifier,
  getArchivedEntries,
  getAllDayKeys,
 } from "../storage/entries.ts";
@@ -175,6 +176,15 @@ export function useEntries() {
  [refresh],
  );
 
+ const updateEntrySignifier = useCallback(
+ async (id: string, signifier: string | undefined) => {
+ await dbUpdateEntrySignifier(id, signifier);
+ emit("entry-changed", { entryId: id });
+ await refresh();
+ },
+ [refresh],
+ );
+
  const loadEntryById = useCallback(
  async (entryId: string): Promise<WorkLedgerEntry | null> => {
  const entry = await dbGetEntry(entryId);
@@ -205,6 +215,7 @@ export function useEntries() {
  deleteEntry,
  pinEntry,
  unpinEntry,
+ updateEntrySignifier,
  archivedEntries,
  refreshArchive,
  refresh,

src/features/entries/index.ts

@@ -11,7 +11,8 @@ export { EntryCard } from "./components/EntryCard.tsx";
 export { NewEntryButton } from "./components/NewEntryButton.tsx";
 
 // Types
-export type { WorkLedgerEntry, SearchIndexEntry } from "./types/entry.ts";
+export type { WorkLedgerEntry, SearchIndexEntry, EntrySignifier } from "./types/entry.ts";
+export { SIGNIFIER_CONFIG } from "./types/entry.ts";
 
 // Storage operations (for cross-feature use)
 export { getEntry, getAllEntries, pinEntry, unpinEntry } from "./storage/entries.ts";

src/features/entries/storage/entries.ts

@@ -111,6 +111,17 @@ export async function pinEntry(id: string): Promise<void> {
  }
 }
 
+export async function updateEntrySignifier(id: string, signifier: string | undefined): Promise<void> {
+ const db = await getDB();
+ const raw = await db.get("entries", id);
+ if (raw) {
+ const entry = normalizeEntry(raw as Record<string, unknown>);
+ entry.signifier = signifier as WorkLedgerEntry["signifier"];
+ entry.updatedAt = Date.now();
+ await db.put("entries", entry);
+ }
+}
+
 export async function unpinEntry(id: string): Promise<void> {
  const db = await getDB();
  const raw = await db.get("entries", id);

src/features/entries/types/entry.ts

@@ -9,8 +9,19 @@ export interface WorkLedgerEntry {
  isArchived: boolean;
  tags: string[];
  isPinned?: boolean;
+ signifier?: EntrySignifier;
 }
 
+export type EntrySignifier = "note" | "decision" | "task" | "question" | "idea";
+
+export const SIGNIFIER_CONFIG: Record<EntrySignifier, { label: string; color: string; icon: string }> = {
+ note: { label: "Note", color: "text-blue-500", icon: "N" },
+ decision: { label: "Decision", color: "text-emerald-500", icon: "D" },
+ task: { label: "Task", color: "text-violet-500", icon: "T" },
+ question: { label: "Question", color: "text-amber-500", icon: "?" },
+ idea: { label: "Idea", color: "text-pink-500", icon: "!" },
+};
+
 export interface SearchIndexEntry {
  entryId: string;
  dayKey: string;