usememos/memos
53.8
Adequate · 9 October 2026
86k
lines of production code
Go
with TypeScript
4
measurements over time
What this system is
Memos is a self-hosted, lightweight knowledge base and note-taking platform that supports collaborative workspaces, granular access control, and rich markdown content including math and diagrams. It provides a modern web interface with real-time updates, calendar and map views, and extensive media handling, backed by a modular Go server that supports multiple database drivers and secure authentication. The system also exposes an MCP endpoint for AI agent integration and offers robust features like export, webhooks, and rate limiting for self-hosted deployments.
How it got here
2021–2023 — Architecture modernization and multi-backend support
32 changes.
The project underwent a comprehensive architectural overhaul, restructuring the backend into a strict layered design with a driver-based store interface to support SQLite, MySQL, and PostgreSQL. Simultaneously, the frontend was rebuilt using React 19, React Router v6, and Connect RPC, replacing legacy tooling and state management with a modern, modular stack. This period also standardized development workflows through Buf for protocol buffers and introduced robust build, release, and deployment tooling.
2024–2025 — Architecture modernization and feature expansion
31 changes.
This period focused on a comprehensive architectural overhaul of the web client, modularizing the MemoEditor and MemoView components while introducing a unified UI kit and theme system. Concurrently, the backend expanded its capabilities with new spaces, SSO, and memo sharing features, supported by significant database schema updates and improved authentication mechanisms.
2026 — API v1 removal and frontend redesign
32 changes.
This period focused on removing the v1 API version marker and centralizing access control, while significantly redesigning the frontend with new calendar, map, and multi-column grid views. The work also introduced robust security measures like SSRF protection and rate limiting, alongside new features for memo relations, attachments, and AI agent integration.
Features
Add image dimension limit to prevent excessive memory allocation
A new \imagelimit\ package has been introduced to bound the decoded size of untrusted images before full memory allocation occurs. This change adds a check that rejects images exceeding 50 megapixels (declared as \MaxPixels\) by reading only the image header, thereby preventing potential denial-of-service attacks via maliciously sized image headers. The implementation includes logic to handle standard formats (PNG, JPEG, GIF) and defers to the full decoder for unknown formats, accompanied by unit tests verifying the dimension checks and error handling.
internal/imagelimit · high confidence
Add ink-style placeholder illustrations for empty states
The Placeholder component now renders custom SVG ink illustrations instead of previous placeholder assets. It supports three distinct empty-state scenes—memo, search, and inbox—each displaying a unique illustration alongside a configurable message, providing a more polished visual experience for users when content is absent.
web/src/components/Placeholder · high confidence
Add theme type definition
The application now defines a specific set of available themes for user selection, including system, default, default-dark, and paper modes.
web/src/types/modules · high confidence
Added PWA manifest for web app installation support
A new site.webmanifest file has been added to the public directory, enabling Progressive Web App (PWA) capabilities. This configuration allows users to install the Memos application on their devices, providing a standalone display mode and defining the app's name, description, and theme colors.
web/public · high confidence
Introduce Memo Detail Sidebar with outline navigation and share link management
A new Memo Detail Sidebar component has been added to provide a dedicated panel for memo metadata and actions. This sidebar includes an outline navigation feature that tracks the user's reading position within the memo content, allowing for quick jumps to specific headings. It also features a share link management dialog, enabling users to create, copy, and revoke shareable links for memos with configurable expiration periods (1 day, 7 days, 30 days, or never). Additionally, the sidebar displays backlinks to other memos that reference the current memo and provides navigation to the memo's origin or parent.
web/src/components/MemoDetailSidebar · high confidence
Introduce MemoPreview component for compact memo summaries
A new MemoPreview component has been added to display compact summaries of memos, supporting both truncated text and attachment thumbnails. It renders creator names and memo IDs when enabled, handles inline attachments with visual indicators for Live/Motion photos, and provides a count for non-visual files in compact mode. The component is inert (non-interactive) and uses a static CSS height limit for content truncation, making it suitable for use in lists or sidebars where full interactivity is not required.
web/src/components/MemoPreview · high confidence
Introduce centralized version and commit tracking
The internal/version package now provides a single source of truth for the application's version and build commit information. The Version variable defaults to 'dev' and the Commit variable defaults to 'unknown', allowing release and CI processes to inject the actual values at build time. A new GetCurrentVersion function exposes the current version string, standardizing how version information is accessed across the codebase.
internal/version · high confidence
Introduce month-based navigation and calendar view in Statistics
The StatisticsView component now features a new MonthNavigator header that allows users to switch between months, with the month label dynamically formatted according to the current language setting. The view renders a MonthCalendar that displays activity stats for the selected month, respects the configured time basis, and allows users to click on specific dates to navigate to a date filter. This replaces the previous static or less granular statistics display with an interactive, time-basis-aware calendar interface.
web/src/components/StatisticsView · high confidence
Introduce multi-column memo grid layout
Added a new \ColumnGrid\ component that arranges memos into a multi-column, absolute-positioned layout similar to Google Keep. The grid calculates the optimal number of columns based on container width and minimum column size, assigns items to columns using estimated heights to ensure balanced packing, and uses \ResizeObserver\ to handle dynamic resizing. It includes a context provider (\ColumnGridUntrappedProvider\) to allow specific tiles (like the inline editor) to opt out of transform-based positioning, preventing \position: fixed\ elements from being clipped. The component supports features like a leading tile (e.g., composer), a spanning header, priority key pinning, and RTL layout support.
web/src/components/ColumnGrid · high confidence
Introduce structured store schemas for attachments, identity providers, notifications, and user settings
This change defines the foundational protobuf schemas for the application's data layer, replacing ad-hoc storage with explicit, versioned messages. It introduces \AttachmentPayload\ to support named S3 storage drivers, motion media (Live/Motion Photos), and media metadata (EXIF, location). Identity providers are now modeled via \IdentityProvider\ with dedicated \OAuth2Config\ and field mapping for avatar URLs. Notifications are standardized into \InboxMessage\ with typed payloads for memo comments, mentions, and space invitations. Instance and user settings are formalized: \InstanceSetting\ covers storage, AI providers, transcription, and tag metadata, while \UserSetting\ manages personal access tokens, refresh tokens with client info, memo views with icons, webhooks with signing secrets, and per-user tag metadata. Memo storage is updated with \MemoPayload\ to include extracted titles, incomplete task flags, and location data.
proto/store · high confidence
Introduce thread-safe in-memory cache with TTL and eviction
Added a new thread-safe in-memory cache implementation in the store/cache package that supports time-to-live (TTL) expiration, configurable maximum item limits with oldest-item eviction, and optional eviction callbacks. The cache uses atomic operations for item counting to prevent race conditions and provides standard operations including Set, Get, Delete, Clear, and Close, along with comprehensive tests covering basic operations, eviction logic, and concurrent access.
store/cache · high confidence
Introduces configurable log level and version reporting flags
The Memos CLI now supports a \--log-level\ flag (accepting debug, info, warn, or error) to control log verbosity, defaulting to info. It also adds a \--version\ flag with the \-V\ shorthand, alongside the existing \version\ subcommand, to display the current build version. These changes are implemented in the \cmd/memos\ package, including new logging utilities and corresponding tests.
cmd · high confidence
Introduces secure client IP resolution for rate limiting
A new \clientip\ package has been added to reliably determine the true client IP address by resolving connection peers and trusted proxy headers (X-Forwarded-For, X-Real-Ip). This resolves the client address once per request and stores it in the context, ensuring that rate limits and session records are keyed on the actual user address rather than a spoofed header. The implementation defaults to trusting private network ranges (loopback, RFC 1918, etc.) to support common reverse-proxy deployments, but allows operators to configure specific trusted proxies or disable proxy trust entirely to prevent users from manipulating their apparent address.
internal/clientip · high confidence
Memo content rendering is rebuilt with a new modular component architecture
The \MemoContent\ component has been completely rewritten to use a new, modular structure that enhances security, performance, and feature support. Code blocks now feature theme-aware syntax highlighting via highlight.js, a copy-to-clipboard button, and native support for rendering Mermaid diagrams. The renderer now supports LaTeX math via KaTeX, link metadata cards, and inline @mentions that link to user profiles. Security is improved through a strict sanitization schema that allows only trusted iframe sources (e.g., YouTube, Vimeo) and prevents XSS. Additionally, the new architecture includes a dedicated pipeline for markdown processing, context providers for mention resolution, and optimized lazy-loading of heavy dependencies like math and diagram renderers.
web/src/components/MemoContent · high confidence
Memo editor rebuilt on CodeMirror 6 with native Markdown formatting and tag suggestions
The MemoEditor component has been replaced with a new CodeMirror 6-based implementation that provides a richer editing experience. Users now benefit from native Markdown formatting shortcuts (such as Ctrl+B for bold and Ctrl+I for italic), improved list indentation behavior, and contextual tag and mention suggestions. The editor also supports file attachments via drag-and-drop or paste, and includes a distraction-free Focus Mode. This change replaces the previous textarea-based editor with a fully featured, syntax-aware Markdown editor.
web/src/components/MemoEditor/Editor · high confidence
MySQL store implementation for memos, attachments, and identity providers
The MySQL database layer has been implemented to support core application features, including memo creation and listing with custom timestamps and filtering, attachment management with space-aware access controls, inbox notifications, and identity provider (SSO) configuration. This implementation introduces serializable transaction handling for authentication mutations to prevent race conditions, enforces strict memo write policies based on space membership and visibility, and supports atomic memo mutations that bind or remove attachments and reference relations in a single operation.
store/db/mysql · high confidence
New Activity Calendar component with month-grid view and date selection
The ActivityCalendar module has been refactored into a new set of components (CalendarCell, MonthCalendar, cellStyles, monthDays, utils) that render a month-based grid of activity cells. Users can now view their memo activity in a calendar matrix format, where cells are color-coded by activity intensity (0-4 levels) and support interaction. The component respects the instance's first day of the week setting, displays localized weekday labels, and allows clicking on a specific date to select it (triggering an onClick callback). Tooltips show memo counts for each day, and the calendar supports different time bases (create\_time vs update\_time) for counting memos.
web/src/components/ActivityCalendar · high confidence
New Calendar View for browsing memos by date
A new CalendarView component has been added, allowing users to browse their memos in a month-grid layout. The view displays daily snapshots with text excerpts and image previews, supports multiple authors with author avatars, and includes a floating MemoPanel for reading and composing memos on a selected day. Navigation is handled via URL paths (e.g., /calendar/:year/:month/:day), and the layout adapts to different screen sizes, showing a bottom sheet on mobile and a resizable side panel on desktop.
web/src/components/CalendarView · high confidence
New MCP server endpoint for agent tool integration
The server now exposes a Model Context Protocol (MCP) endpoint at \/mcp\ using the Streamable HTTP transport. This allows external AI agents to interact with Memos through a curated set of tools focused on memos, attachments, and spaces. The implementation translates MCP tool calls into in-process requests against the existing REST API, reusing the same authentication, authorization, and client-address resolution logic. The tool surface includes operations for listing, creating, updating, and deleting memos and attachments, as well as managing spaces and their members. The service is stateless and supports protocol versions from 2024-11-05 to 2026-07-28.
server/mcp · high confidence
New Map view for location-tagged memos
A new Map page has been added to display memos that have location data attached. The view uses Leaflet to render markers for each memo, showing the memo's thumbnail or the author's avatar depending on whether multiple creators are present. Users can select multiple memos to view them in a shared floating panel, and the map viewport (latitude, longitude, zoom) is persisted in the URL to allow deep-linking and sharing of specific map views. The map respects existing memo filters and sorts by time.
web/src/components/MapView · high confidence
New Memo Action Menu with move, share-as-image, and task management
The MemoActionMenu component has been introduced to centralize memo actions, adding the ability to move memos between spaces via a new dialog, share memos as downloadable or native-shareable images, and manage task lists (check/uncheck all items). The menu also consolidates existing actions like pinning, editing, archiving, and deleting, while restricting certain operations based on memo state (e.g., archived memos) and user permissions.
web/src/components/MemoActionMenu · high confidence
New Memo Editor Toolbar Components
The MemoEditor now includes a dedicated Toolbar directory containing four new components: EditorToolbar, which manages the main save/cancel actions and hosts the InsertMenu and VisibilitySelector; FormattingToolbar, which provides a responsive row of formatting commands (headings, marks, and blocks) with focus-mode exit controls; InsertMenu, a dropdown for inserting attachments, images, audio, links, and locations; and VisibilitySelector, a chip for setting memo visibility. These components replace the previous inline toolbar logic with a modular, reusable structure.
web/src/components/MemoEditor/Toolbar · high confidence
New MemoEditor component architecture with audio, timestamp, and suggestion features
The MemoEditor now uses a modularized component structure in web/src/components/MemoEditor/components, introducing several new capabilities: an AudioRecorderPanel with VoiceWaveform visualization for recording and transcribing audio, a TimestampPopover for editing memo creation and update times, an EditorSuggestions component for contextual tag, checklist, and visibility suggestions, and a FocusModeOverlay for distraction-free writing. The EditorContent component hosts the CodeMirror-based editor, while EditorMetadata manages attachments, relations, and location display within the editor context.
web/src/components/MemoEditor/components · high confidence
New OverflowTip and SquareDiv kit components
The component kit now includes two new utilities: OverflowTip, which displays a tooltip containing the full text when a truncated element overflows its container, and SquareDiv, which dynamically maintains a square aspect ratio by adjusting width or height based on the other dimension during resize events.
web/src/components/kit · high confidence
New React Query-based hooks and real-time live refresh via Server-Sent Events
The web application now uses a comprehensive set of new React hooks in \web/src/hooks\ to manage data fetching, caching, and real-time updates. Data access for memos, attachments, users, and instance settings is now handled by \@tanstack/react-query\ hooks (e.g., \useMemoQueries\, \useAttachmentQueries\, \useInstanceQueries\), replacing previous state management patterns. Additionally, \useLiveMemoRefresh\ introduces Server-Sent Events (SSE) to automatically invalidate the React Query cache and update the UI in real-time when memos or spaces change. Supporting utilities like \useMemoFilters\ and \useMemoSorting\ now build and apply these filters and sorting rules consistently across the application.
web/src/hooks · high confidence
New build, installation, and release tooling for Memos
The repository now includes a dedicated \scripts/\ directory containing the core infrastructure for building, installing, and releasing Memos. This adds a multi-stage Dockerfile (\scripts/Dockerfile\) that builds the Go backend using Go 1.27 and packages it into a minimal Alpine-based image running as a non-root user. A new \install.sh\ script allows users to install the binary directly from GitHub releases with checksum verification. The \entrypoint.sh\ script handles runtime initialization, including fixing file permissions and safely dropping privileges to a non-root user (preventing restart loops when \MEMOS\_UID=0\). Additionally, \release\_version.sh\ implements calendar versioning logic to determine previous stable releases and image tags, while \compose.yaml\ provides a quick-start Docker Compose configuration. These scripts replace older development tools (e.g., \.air.toml\) and standardize the release and deployment process.
scripts · high confidence
New centralized authentication package with JWT and Personal Access Token support
The server/auth package has been introduced to centralize authentication and authorization logic for the API and file server. This change implements a new authentication flow using short-lived JWT access tokens (15 minutes) validated statelessly, long-lived JWT refresh tokens (30 days) with database-backed revocation checks, and Personal Access Tokens (PATs) for programmatic access. The Authenticator struct provides a unified entry point for resolving user identity from Bearer tokens or refresh token cookies, ensuring consistent behavior across all endpoints.
server/auth · high confidence
New in-memory rate limiting for API abuse protection
The application now includes a built-in rate limiter to protect against abuse on sign-in, sign-up, content writes, uploads, and other sensitive operations. This new internal component enforces sliding-window limits (e.g., 30 failed sign-ins per IP in 15 minutes, 10 registrations per IP per hour) using an in-memory policy table. Users may encounter temporary restrictions if they exceed these thresholds, with the system providing specific retry-after times to guide recovery.
internal/ratelimit · high confidence
New inbox notification components for comments, mentions, and space invitations
The Inbox now renders specific UI cards for different notification types. MemoCommentMessage displays comment notifications with the original memo snippet and navigation to the memo. MemoMentionMessage handles @-mentions, distinguishing between mentions in memos versus comments, and provides navigation to the relevant content. SpaceInvitationMessage allows users to accept or decline space invitations directly from the inbox, showing space details and role badges. All components support archiving and deleting notifications, with visual indicators for unread status and error handling for failed loads.
web/src/components/Inbox · high confidence
New internal SMTP email plugin for self-hosted instances
The internal/email package now provides SMTP-based email sending capabilities for self-hosted Memos instances. Administrators can configure SMTP settings (host, port, credentials, TLS/SSL) to send notifications via providers like Gmail, SendGrid, or AWS SES. The implementation supports both synchronous and asynchronous sending, HTML and plain text emails, multiple recipients (To, Cc, Bcc), and includes validation and header sanitization to prevent injection attacks.
internal/email · high confidence
New markdown parsing engine with support for math, mentions, and tags
The markdown engine has been replaced with a new implementation that parses content into an AST using goldmark. This change introduces support for inline and block math (dollar-delimited), @username mentions, and \#tags. It also includes stricter validation for usernames and resource UIDs, and handles GFM email autolinks and link reference definitions more robustly. Users will see these new syntax elements parsed and rendered correctly in memos.
internal/identifier, markdown, provider · high confidence
New memo export format and memo access control logic
The core package now includes the \memoexport\ library, which implements the Memos Export Format (version 1.0) for exporting and importing user memos and attachments as a ZIP archive, including validation against decompression bombs. Additionally, the \access\ package introduces a new transport-independent authorization system for memos, defining granular read denials (such as \MemoReadDenialNotFound\ and \MemoReadDenialPermission\) and enforcing strict audience rules for Public, Protected, Private, and SpaceAudience memos, while granting instance administrators superuser read and management privileges.
core · high confidence
New memo filter engine with dialect-specific SQL generation
The \filter\ package now provides a dedicated engine that compiles Common Expression Language (CEL) filter expressions into SQL fragments for SQLite, MySQL, and Postgres. This engine validates expressions against the memo schema, converts them into a dialect-agnostic intermediate representation, and renders them using dialect-specific helpers for JSON access, boolean semantics, and placeholder formatting. It supports features such as tag membership checks, text matching, regex, timestamp accessors, and arithmetic folding, and exposes a singleton via \DefaultEngine()\ for use by store drivers.
filter · high confidence
New memo relation management UI components
This change introduces a new set of React components in the MemoMetadata/Relation directory to handle memo relationships. It adds LinkMemoDialog for searching and linking memos, RelationListEditor for editing existing relations with remove controls, and RelationRows/RelationRow for displaying referencing and referenced memos with direction indicators. The implementation includes helper functions to bucket relations by direction and a custom hook (useResolvedRelationMemos) to fetch and cache memo details for related items.
web/src/components/MemoMetadata/Relation · high confidence
New shared utility library for web client logic
The web client now includes a new \web/src/lib\ directory containing shared utilities that standardize core behaviors across the application. This includes browser helpers for file handling and URL validation, a robust error-handling system that parses Connect RPC details to display user-friendly messages (such as rate-limit wait times), and a new React Query configuration that optimizes caching and retry logic. Additionally, the library introduces a new calendar utility for local time-zone-aware date filtering, a markdown styling system for consistent read-only rendering, and context-aware suggestion engines that intelligently propose tags, checklists, and visibility settings based on the current user filters.
web/src/lib · high confidence
New theme system with OKLCH colors and multiple presets
The application now uses a unified theme system built on the OKLCH color space for better perceptual uniformity and accessibility. This introduces a new color token architecture (primary, secondary, destructive, etc.) that automatically adapts between light and dark modes. Three theme presets are now available: 'default' (light/dark), 'default-dark' (dark-only with graphite surfaces), and 'paper' (warm, sepia-toned light theme). A new COLOR\_GUIDE.md document explains how to use these semantic tokens correctly.
web/src/themes · high confidence
New type definitions for markdown parsing, API errors, and UI components
This change introduces a new set of TypeScript type definitions in the \web/src/types\ directory to support recent feature additions. It adds types for handling Markdown AST nodes, specifically \TagNode\ and \MentionNode\, along with helper functions to identify these elements in the DOM, enabling the new mention parsing and rendering capabilities. It also defines types for API error handling (\ApiError\), statistics view props and data (including \MemoTimeBasis\), and extends React's JSX namespace to support the \relative-time\ web component. Additionally, common utility types like \FunctionType\ and \DialogProps\ are standardized.
web/src/types · high confidence
New utility modules for attachments, localization, and markdown parsing
The web application introduces a suite of new utility modules in \web/src/utils\ to support enhanced media handling, internationalization, and content editing. \attachment.ts\ and \media-item.ts\ provide logic for generating attachment URLs, detecting motion media types (such as Apple Live Photos and Android Motion Photos), and building visual preview items. \i18n.ts\ centralizes locale management, including early application to prevent language flash, direction handling for RTL languages, and searchable locale selection. \markdown-manipulation.ts\, \markdown-task-actions.ts\, and \markdown-source-boundaries.ts\ implement AST-based parsing for accurate task list toggling and heading slugification that preserves Unicode combining marks. Additionally, \gfm-email.ts\ and \gfm-url.ts\ add robust detection for GFM-style email autolinks and URLs within markdown, while \auth-redirect.ts\ standardizes authentication failure redirects and \lazy.ts\ ensures automatic page reloads on chunk load errors.
web/src/utils · high confidence
PostgreSQL database store implementation
This change introduces the complete PostgreSQL database driver for the application's data layer. It adds the necessary store implementations to handle core entities including memos, attachments, identity providers (IDPs), inboxes, and instance settings, along with the specific SQL queries and transaction logic required for these operations on a PostgreSQL backend.
store/db/postgres · high confidence
Redesigned Settings UI with new confirmation dialog and sectioned layout
The Settings page has been restructured into distinct sections (AI, Access Tokens, Instance, Member, Memo Export, etc.) to improve organization. A new \ConfirmDialog\ component standardizes confirmation flows, replacing ad-hoc prompts with an accessible, themeable dialog that supports asynchronous operations and error handling. The UI now uses a consistent \SettingSection\ and \SettingGroup\ structure, and includes new features like AI provider configuration, space member invitations, and linked identity management.
web/src/components/Settings · high confidence
SSRF protection and HMAC webhook signing
Webhook deliveries now include built-in SSRF (Server-Side Request Forgery) protection that blocks outbound requests to reserved and private IP ranges (such as loopback, RFC-1918, CGNAT, and cloud metadata endpoints) by default, while allowing administrators to explicitly allowlist specific hostnames or CIDRs via the new \ConfigurePrivateDestinationAllowlist\ API. Additionally, webhooks now support optional HMAC-SHA256 payload signing using the Standard Webhooks format (including \whsec\_\ prefixed secrets), ensuring payload integrity for receivers.
internal/webhook · high confidence
Support for detecting and extracting embedded video from Motion Photos
The application now includes a new internal module capable of identifying Motion Photos (such as those from Google Camera) by scanning JPEG metadata for specific markers and locating the embedded MP4 video stream. This change enables the system to detect these composite images and extract the hidden video component, laying the groundwork for handling motion-based media attachments.
internal/motionphoto · high confidence
Support for multiple database backends via driver abstraction
The store/db module now supports SQLite, MySQL, and PostgreSQL through a unified driver interface. Users can configure their preferred database backend via the profile driver setting, and the system will automatically initialize the corresponding database driver.
store/db · high confidence
Removals
Removal of SQLite database schema definition
The SQLite database schema file has been removed from the project resources. This file previously defined the structure for the \users\, \memos\, and \queries\ tables, including their columns, primary keys, and foreign key relationships. Users relying on this specific schema file for database initialization or migration will need to use an alternative source or method.
resources · high confidence
Removal of common error handling and utility packages
The common error handling logic and utility functions have been removed from the codebase. Specifically, the \common/error\ package, which previously provided error code mappings (such as \NOT\_AUTH\, \REQUEST\_BODY\_ERROR\, and \DATABASE\_ERROR\) and an HTTP error handler, has been deleted. Additionally, the \common/utils.go\ file containing UUID generation and date-time formatting utilities has been removed. This change eliminates the centralized error response structure and helper functions previously available to other parts of the application.
common · high confidence
Removal of legacy API route handlers
The legacy API implementation files (auth.go, memo.go, user.go, middlewares.go, utils.go) have been removed from the api package. This eliminates the previous cookie-based authentication mechanism and the associated route registrations for user sign-up, sign-in, sign-out, memo management, and user profile updates that relied on the gorilla/mux router.
api · high confidence
Security
SSRF-safe link preview metadata extraction
The link preview system now uses a new internal fetcher that blocks requests to internal and CGNAT IP addresses, preventing Server-Side Request Forgery (SSRF) attacks when fetching metadata. It extracts preview data from multiple sources (Open Graph, Twitter, JSON-LD, and semantic HTML) with a defined precedence order, and includes comprehensive tests for metadata extraction and security validation.
internal/linkmeta · high confidence
Architecture
MemoEditor hooks restructured into modular custom hooks
The MemoEditor component logic has been reorganized into a dedicated \hooks\ directory, extracting specific capabilities into reusable custom hooks. This includes \useAudioRecorder\ and \useAudioWaveform\ for voice note capture and display, \useFileUpload\ and \useInlineImageUpload\ for handling media attachments and Live Photos, \useAutoSave\ for draft persistence, and \useMemoInit\/\useMemoSave\ for managing the editor's lifecycle and save transactions. This modularization centralizes the editor's state management and side effects, improving maintainability and separation of concerns within the MemoEditor component.
web/src/components/MemoEditor/hooks · high confidence
MemoEditor types consolidated into modular type definitions
The type definitions for the MemoEditor component have been reorganized into a dedicated \types\ directory, introducing modular files for attachments, component props, editor controllers, and insert menus. This change introduces a unified \AttachmentItem\ type that standardizes how images, videos, audio (including voice notes), and motion media are represented, supporting features like Live Photo grouping and local file handling. It also defines a clean \EditorController\ interface that abstracts the underlying CodeMirror implementation, exposing only markdown-based operations and formatting capabilities to the rest of the application. Additionally, new types for \MemoEditorProps\ and \InsertMenu\ support enhanced features such as focus mode, location selection, and audio recording integration.
web/src/components/MemoEditor/types · high confidence
Refactored MemoView into modular subcomponents
The MemoView component has been restructured into distinct, reusable subcomponents (MemoBody, MemoHeader, MemoCommentListView, MemoPinnedMark, MemoSpaceBadge) to improve maintainability and separation of concerns. This change introduces a dedicated header for author and time display, a body component handling content blurring and attachments, and a list view for inline comment previews, while consolidating metadata and space badge logic into their own modules.
web/src/components/MemoView/components · high confidence
Repository restructured with enforced layering and new developer documentation
The project has been reorganized into a strict layered architecture (cmd, server, core, store, provider, markdown, filter, internal) with import direction enforced by golangci-lint's depguard rules. This change replaces the previous monolithic entry point with a modular structure, accompanied by new documentation files (AGENTS.md, CONTEXT.md) that define terminology and development workflows, and updated configuration files (.golangci.yaml, .dockerignore) to support the new layout.
(repo-wide) · high confidence
Store layer refactored into a Driver interface with deployment configuration and hardened attachment handling
The store layer has been restructured to use a Driver interface, separating database-specific logic (SQLite, MySQL, Postgres, Cloudflare D1) from the store facade. This change introduces atomic authentication configuration mutations to prevent locking users out, enforces attachment ownership policies for safer deletion, and adds a deployment configuration system that loads Identity Providers and instance settings from secret files (e.g., /etc/secrets) to shadow database-stored values. Additionally, email addresses are now normalized to lowercase for canonical uniqueness, and attachment storage usage is exposed in account settings.
store · high confidence
Behavioural changes
API v1 version marker removed with breaking schema and path changes
The public API no longer carries a \v1\ version marker, requiring clients to update REST routes from \/api/v1/...\ to \/api/...\ and gRPC/Connect procedures from \memos.api.v1\ to \memos.api\. This release also introduces breaking schema changes: field numbers are renumbered, \reserved\ ranges are removed, and names now follow AIP conventions (e.g., \MemoService\ methods take \parent\ instead of \name\, \PersonalAccessToken\ timestamps are renamed to \\*\time\, and \BatchGetUsersRequest\ uses resource names). For this release only, requests to the old \/api/v1/...\ and \memos.api.v1.\\ endpoints return \410 Gone\ to guide migration.
proto/api, proto/gen/api, web/src/types/proto/api · high confidence
Attachment library UI is refactored into a modular component structure
The Attachment Library interface has been restructured into distinct, reusable components to improve maintainability and visual consistency. The new layout includes a toolbar for filtering by media, documents, and audio, alongside dedicated views for media grids (featuring video posters and motion photo previews), file rows, and empty/error states. This refactor introduces specific UI primitives such as source chips that link back to memos, metadata lines, and an unused assets panel, while also ensuring video attachments display proper posters on mobile devices.
web/src/components/AttachmentLibrary · high confidence
Centralized formatting command catalog for the Memo Editor
The Memo Editor now uses a single, backend-agnostic source of truth for all formatting actions (bold, italic, strikethrough, code, code block, lists, headings, and links). This new \commands.ts\ module defines the complete set of editor verbs, their icons, labels, and grouping, allowing the toolbar, active-state highlighting, and future slash menus to derive their behavior from this catalog rather than duplicating definitions. This change ensures that formatting commands are consistently defined and easily extensible across all editor surfaces.
web/src/components/MemoEditor/formatting · high confidence
Consolidated memo metadata components for attachments, relations, and location
The memo metadata display has been reorganized into a unified component structure under \web/src/components/MemoMetadata\. This change introduces \MemoMetadataRows\ to render a single, compact list of non-content attachments (audio, documents), memo relations, and location data, ensuring empty sections are not rendered. It also provides \MetadataSection\ for titled lists and a shared set of row styling classes (\METADATA\ROW\\*\) that enforce a consistent 28px row height, hover interactions, and control visibility across the memo card and sidebar rail.
web/src/components/MemoMetadata · high confidence
Database schema updated to support new spaces, SSO, and memo sharing features
The SQLite database schema has been updated to include new tables and columns required for recent feature additions. This includes the addition of a \space\_member\ table to manage space memberships with specific roles (ADMIN, USER), a \memo\_share\ table to support private memo sharing links, and a \user\_identity\ table to enable SSO user identity linkage. The schema also introduces a \reaction\ table for memo reactions, updates the \user\ table to support optional email addresses, and renames the \resource\ table to \attachment\ for clarity. These changes reflect the underlying structural requirements for the new collaboration and identity features.
store/migration/sqlite · high confidence
Demo instance seed data reorganized into Spaces with realistic multi-user content
The demo instance now seeds four distinct Spaces (Updates, Dev, Travel, Reading) with custom icons and specific member assignments, replacing the previous flat structure. Seed memos are distributed across four realistic user personas (Steven, Johnny, Bob, Sam) and organized by visibility: Public memos populate the Explore feed for visitors, while Protected memos are hidden until sign-in to demonstrate the visibility model. The data includes diverse content types such as pinned welcome and sponsor notes, code snippets, task lists, image attachments with location data, and threaded comments to showcase full application features.
store/seed · high confidence
Drop v1 API version marker and centralize access control
The API no longer uses the /api/v1/ URL prefix; requests to the old v1 routes now return HTTP 410 Gone. Access control is now managed by a single source of truth in server/api/acl\_config.go, which defines public endpoints (no authentication required) and a subset of those that remain accessible on private instances (sign-in, registration, SSO, and shared memos). This configuration is enforced by both the Connect and gRPC-Gateway interceptors via a shared authorizer, ensuring consistent authentication and anonymous-access policies across transports.
server/api · high confidence
Extracted memo interaction and image preview logic into reusable hooks
The MemoView component now uses dedicated hooks to manage user interactions and media preview state. The new \useMemoHandlers\ hook centralizes logic for clicking images to open previews and double-clicking to edit memos (respecting the \enableDoubleClickEdit\ setting), while \useImagePreview\ manages the state for the image preview modal. This refactoring improves code maintainability by separating these concerns from the main component.
web/src/components/MemoView/hooks · high confidence
Frontend service with SEO and caching improvements
The server now embeds and serves the frontend static assets directly, replacing the previous external dependency model. This change introduces a Single Page Application (SPA) fallback middleware to handle client-side routing, ensuring that missing assets return a 404 instead of incorrectly falling back to the index page. It also adds dedicated routes for /robots.txt and /sitemap.xml to improve search engine discoverability for public memos, while implementing specific cache-control headers: HTML files are marked as no-cache to prevent stale content, while hashed static assets are cached as immutable for one month.
server/frontend · high confidence
Improved Markdown parsing accuracy for tags, lists, and math
The markdown parser now correctly handles several edge cases that previously caused rendering issues. Tags are now supported in compound forms (including ampersands), Unicode characters, and on the first line of a document, while being properly ignored when they appear inside links. Mixed task and bullet lists are now split into separate lists to prevent formatting conflicts. Additionally, single-dollar inline math is protected from being incorrectly triggered by currency symbols, and setext-style headers (using underlines) are disabled to ensure consistent heading rendering.
web/src/utils/remark-plugins · high confidence
Introduce MemoView component with context-driven display logic
The MemoView component has been restructured to use a dedicated MemoViewContext, centralizing memo state and display options. This change enables users to choose whether memos display their creation or update time via the new timeBasis setting, and allows content to be automatically blurred based on user-specific tag settings (blur\_content). Additionally, the component now supports inline comment previews in list views and manages focus mode within grid layouts more effectively.
web/src/components/MemoView · high confidence
Introduce PagedMemoList component with multi-column grid and error handling
The memo list rendering has been refactored into a new PagedMemoList component that supports a responsive multi-column grid layout (switching to a single column on narrow screens) and includes a dedicated MemoListError component for handling search and load failures with retry, edit, and clear actions. The component also features an auto-fetch mechanism that paginates content when the page is not scrollable, and uses a memo card height estimation utility to optimize grid layout calculations.
web/src/components/PagedMemoList · high confidence
Introduce dedicated Location Picker with vector basemaps and reverse geocoding
The map component area now features a new Location Picker that replaces the previous generic map implementation. This change introduces a dedicated UI for selecting map coordinates, complete with custom glass-style zoom controls and an option to open the selected location in Google Maps. Under the hood, the map rendering has shifted to use MapLibre GL for vector basemaps (Positron/Dark) via OpenFreeMap, which automatically restyles based on the user's theme. To ensure reliability, the component includes a fallback to standard OpenStreetMap tile layers if the vector tiles fail to load, and it integrates reverse geocoding via Nominatim to display human-readable addresses for selected points. The picker is also lazy-loaded to reduce initial bundle size.
web/src/components/map · high confidence
Major frontend architecture overhaul: React Router, Connect RPC, and i18next
The web frontend has been rebuilt with a new core stack: routing now uses \react-router-dom\ (replacing the previous router), API communication has migrated from gRPC-Web to \@connectrpc/connect\ with binary protocol support, and internationalization now relies on \i18next\ with lazy-loaded locale files. Authentication is managed via a new \auth-state\ module that persists tokens in \localStorage\ and synchronizes them across tabs using \BroadcastChannel\, while the app shell (\App.tsx\) handles instance setup redirects, custom profile metadata, and dynamic style/script injection. The UI layer now uses Tailwind CSS for styling and \react-hot-toast\ for notifications, with early application of theme and locale to prevent visual flashes.
web/src · high confidence
Memo editor now persists drafts with attachments and location, and validates save conditions
The memo editor now saves drafts to local storage that include not just text content, but also attached files and location data, ensuring these details are preserved if the tab is suspended or the editor remounts. A new validation service prevents saving while the editor is loading, uploading files, or recording audio, and blocks invalid attachment references. Additionally, file uploads now use resumable chunking to handle large files more reliably.
web/src/components/MemoEditor/services · high confidence
Memo editor state management refactored to a modular, slice-based store
The MemoEditor's internal state logic has been restructured into a dedicated, modular state machine located in the \state/\ directory. This change introduces a new \EditorStore\ that uses an external store pattern with \useSyncExternalStore\ to allow components to subscribe to specific slices of state (such as content, metadata, or UI flags) rather than re-rendering on every keystroke. The update includes a new set of typed actions (e.g., \UPDATE\_CONTENT\, \SET\_METADATA\, \ADD\_LOCAL\_FILE\) and a reducer that tracks content sources and manages local file attachments, providing a more performant and maintainable foundation for the editor's complex interactions.
web/src/components/MemoEditor/state · high confidence
MemoEditor component architecture and implementation
The MemoEditor component has been restructured into a three-layer architecture (Presentation, State, Service) centered on a CodeMirror 6 'decorated source' editor that stores memos as raw markdown. This change introduces a new state management system using an external store with per-slice subscriptions to optimize rendering performance, a dedicated EditorController interface for document manipulation, and a formatting command catalog. The editor now supports focus mode, inline vs. hosted presentation modes, tag/mention autocomplete, and audio recording with transcription. The component also includes hooks for save workflows, focus mode lifecycle, and auto-save functionality, along with a lazy-loading entry point for efficient bundle management.
web/src/components/MemoEditor · high confidence
Memos created from calendar views inherit the selected date
A new utility function now derives the default creation time for new memos based on active filter context. When a user creates a memo while viewing a specific date in the calendar (indicated by a displayTime filter), the memo is automatically timestamped with that selected date combined with the current time, ensuring proper chronological ordering within the selected day.
web/src/components/MemoEditor/utils · high confidence
Migrate frontend tooling to Biome, pnpm, and Vite 6
The web frontend has been reconfigured to use pnpm as the package manager, Biome for linting and formatting (replacing ESLint and Prettier), and Vite 6 (via rolldown) for the build pipeline. This change introduces new configuration files including biome.json, pnpm-workspace.yaml, vite.config.mts, and vitest.config.mts, while updating index.html with modern meta tags and favicon formats. The build system now uses a separate Vitest configuration to keep test dependencies out of production bundles, and the project structure aligns with shadcn/ui conventions via components.json.
web · high confidence
Migrate to React Router v6 with guard-based authentication and Space-scoped routing
The application routing has been rewritten to use React Router v6, replacing the previous implementation with a declarative route configuration. This introduces a guard-based authentication flow: unauthenticated users are redirected to the sign-in page (preserving the intended destination), while authenticated users are gated behind initialization checks for instance settings and user data. A new Space-scoped routing structure allows Spaces to be addressed via URL paths (e.g., \/spaces/:spaceUid\), enabling collection pages like Home, Explore, Calendar, and Map to exist both globally and within specific Spaces. The router also includes dedicated components for handling loading states, permission errors, and chunk load failures, along with backward compatibility redirects for legacy paths like \/home\.
web/src/router · high confidence
New React Context providers for application state management
The application now uses a set of dedicated React Context providers to manage global state, replacing previous ad-hoc or less structured approaches. These include AppSidebarContext for sidebar UI state (mobile open, quick find, memo detail, attachment/inbox filters), AuthContext for handling authentication lifecycle, identity initialization, and user settings synchronization with React Query, GlobalMemoEditorContext for managing the global memo composer dialog and focus behavior, InstanceContext for loading and managing instance-wide settings (access, general, AI, storage, notification), MemoFilterContext for URL-synced memo filtering and view state, NewMemoContext for tracking the most recently created memo, SpaceContext for managing space selection and collection scoping, and ViewContext for persisting user view preferences (compact mode, link preview, max columns, time basis) to localStorage.
web/src/contexts · high confidence
New UI Kit with Base UI primitives and unified styling rules
The \web/src/components/ui\ folder now provides a unified set of UI primitives (Button, Dialog, Select, DropdownMenu, Popover, Tooltip, Badge, Tabs, etc.) built on top of the \@base-ui/react\ library. This establishes a single source of styling truth for the application, enforcing a strict rule that consumers style kit components through \variant\, \size\, and \shape\ props rather than passing arbitrary \className\ overrides. The kit introduces new component behaviors and variants, such as a \quiet\ button variant for subtle controls, \warning\ and \pill\ badge shapes, and specific size options for selects and dropdowns. It also standardizes visual layering via z-index tokens and ensures consistent popup animations and focus management across all interactive surfaces.
web/src/components/ui · high confidence
New dedicated HTTP file server and refined CORS policy
Binary content (attachments and avatars) is now served via a new HTTP file server instead of gRPC, enabling native HTTP range requests for reliable video and audio playback in browsers like Safari. The server's CORS configuration has been updated to allow token-authenticated API calls from any origin while restricting credentialed (cookie) access to trusted hosts, and the server now supports binding to a UNIX socket with restricted file permissions.
server · high confidence
New location metadata components for memos
The memo location metadata display and editing have been refactored into a new set of components within the MemoMetadata module. Users can now view a memo's location as a metadata row that opens a popover containing a map and coordinate details, and edit location data via a dedicated dialog with a map picker and manual coordinate inputs. This change consolidates the previous location handling logic into reusable pieces (LocationDialog, LocationDisplayEditor, LocationDisplayView) and helper functions for formatting display text and coordinates.
web/src/components/MemoMetadata/Location · high confidence
New memo reaction list view with React Query cache invalidation
The memo reaction list has been reorganized into a new \MemoReactionListView\ component that groups reactions by type and displays them as interactive pills. This change introduces a \ReactionSelector\ for adding reactions and a \ReactionView\ for displaying existing ones with tooltips. Crucially, the underlying \useReactionActions\ hook now explicitly invalidates the React Query cache for the memo detail, memo lists, and parent comment lists after adding or removing a reaction, ensuring the UI updates immediately without requiring a full page refresh.
web/src/components/MemoReactionListView · high confidence
New modular markdown rendering components
The memo content renderer now uses a dedicated set of React components (AnchorLink, Blockquote, Details, Heading, HorizontalRule, Image, InlineCode, Link, List, ListItem, Paragraph) to style markdown output. This change introduces specific behaviors: in-page anchor links (footnotes, headings) now scroll smoothly within the memo container or navigate to the detail page if the memo is collapsed; GFM task lists are rendered in a two-column grid to keep checkboxes and text aligned; single-link paragraphs can display deferred link metadata cards when the preview setting is enabled; and images support explicit height/width attributes with responsive sizing.
web/src/components/MemoContent/markdown · high confidence
New store schema definitions for attachments, memos, spaces, and settings
The \proto/gen/store\ package now includes generated Go code for several new protobuf definitions that underpin recent product capabilities. \attachment.pb.go\ introduces support for motion media (Apple Live Photo, Android Motion Photo) and named storage drivers (Local, S3, External). \memo.pb.go\ adds a \MemoPayload\ structure that stores memo properties (such as extracted titles and incomplete task flags), location data, and tags. \space.pb.go\ defines \SpacePayload\ to allow spaces to display custom icons via emoji or Lucide names. \inbox.pb.go\ establishes the data model for the new notification inbox, supporting memo comments, mentions, and space invitations. \instance\_setting.pb.go\ and \user\_setting.pb.go\ define the configuration schemas for instance-level settings (including AI providers and storage) and user-level preferences (including memo views, webhooks, and tag metadata).
proto/gen/store · high confidence
Patch protobuf to prevent prototype pollution and add Unicode data generation script
A patch for @bufbuild/protobuf@2.12.0 is introduced to mitigate prototype pollution by using Object.defineProperty when handling '\_\proto\\_' keys in ReflectMap and object value conversion. Additionally, a new script is added to generate and write Unicode 17.0.0 data (including XID\_Continue, Default\_Ignorable, Combining Marks, and Emoji ranges) to src/utils/tag-unicode-data.ts, supporting improved tag recognition.
web/patches, web/scripts · high confidence
Redesigned attachment gallery and audio playback controls
The memo attachment display has been restructured into a new visual gallery that renders images, videos, and Live/Motion Photos in responsive grid layouts (single, 2-up, 3-mosaic, or 2x3 collage) with hover effects and play badges. Audio attachments now feature a dedicated player interface that supports variable playback speeds (0.5x, 0.75x, 1x, 1.5x, 2x), a seek bar, and skip controls, while video attachments display poster images to improve mobile rendering and reduce bandwidth usage.
web/src/components/MemoMetadata/Attachment · high confidence
Redesigned authentication and settings pages with new system pages
The sign-in and sign-up pages have been redesigned with a panel layout, and a dedicated Admin sign-in page has been added. The Settings page has been restructured into a sectioned layout with admin-specific sections. Additionally, new system pages have been introduced: a 404 Not Found page, a 403 Permission Denied page, and a redesigned About page that displays instance branding, version, and project links.
web/src/pages · high confidence
Redesigned authentication pages with unified layout and challenge support
The sign-in and sign-up experience has been redesigned with a new centered card layout (AuthPageLayout) that includes a dedicated footer for locale and theme selection (AuthFooter). The system now supports proof-of-humanity verification via Cloudflare Turnstile or hCaptcha (ChallengeWidget) when required by the instance profile. Additionally, the authentication flow now includes a dialog for administrators to change member passwords (ChangeMemberPasswordDialog) and a new dialog for creating access tokens with configurable expiration (CreateAccessTokenDialog).
web/src/components · high confidence
Regenerated TypeScript types for Google API and Type protos
The TypeScript type definitions in web/src/types/proto/google have been regenerated using protoc-gen-es v2.12.1. This update refreshes the generated code for core Google API protos (including annotations, client settings, field behavior, HTTP rules, HTTP body, launch stages, and resource descriptors) as well as the google.type.Color message, ensuring the frontend's type system stays aligned with the latest protobuf specifications.
web/src/types/proto/google · high confidence
SQLite store implementation with Unicode search and concurrency fixes
The SQLite database layer has been implemented to support core application features. This includes full CRUD operations for memos, attachments, identity providers, and inboxes, along with robust access control and memo mutation policies. A key behavioral improvement is the addition of a custom \memos\_unicode\_lower\ function, enabling proper case-insensitive Unicode text search in SQLite, which lacks native ICU support. Additionally, memo mutations now use \BEGIN IMMEDIATE\ transactions to prevent \SQLITE\_BUSY\ locking errors during concurrent writes, and a bounded cache for the custom \regexp\ function prevents unbounded memory growth from pattern compilation.
store/db/sqlite · high confidence
Secure client IP resolution and improved server configuration defaults
The server now includes a dedicated client IP resolver that safely identifies the true client address by trusting only configured proxies (defaulting to private network ranges) and ignoring client-supplied forwarding headers, preventing IP spoofing for rate limiting and session tracking. Additionally, the default data directory handling has been refined to prefer /var/opt/memos when writable (supporting Docker deployments) and fall back to the current directory otherwise, while demo mode is now strictly validated to require the SQLite driver.
internal/profile · high confidence
Sidebar navigation and layout redesigned
The sidebar has been completely rebuilt to support a unified, route-aware navigation system. It now features a resizable desktop rail (SidebarResizeHandle), a space switcher (SpaceSwitcher) for navigating between workspaces, and a Quick Find dialog that supports both text and expression-based search modes. The layout is organized into distinct sections for views, tags, and attachments, with a new CommonSidebarContent area for resources and settings. This change also introduces a global memo composer and improves the overall visual consistency and spacing of the sidebar elements.
web/src/components/AppSidebar · high confidence
Standardized protobuf code generation with Buf and added OpenAPI embedding
The project now uses Buf v2 to manage protobuf dependencies and generate code, replacing previous ad-hoc generation methods. This change introduces a standardized build pipeline (buf.yaml, buf.gen.yaml, buf.lock) that generates Go, gRPC, Connect-RPC, and TypeScript types, while also producing an OpenAPI v2 specification. Additionally, the generated OpenAPI YAML is now embedded directly into the Go binary via openapi\_embed.go, making the API documentation available at runtime without requiring external file access.
proto · high confidence
Unify navigation and layout structure with new RootLayout and MainLayout components
The application's layout architecture has been consolidated into two new components: RootLayout and MainLayout. RootLayout now serves as the primary shell, integrating the responsive sidebar (with desktop resizing capabilities), mobile navigation, quick-find dialog, and global providers for space, memo filtering, and the global memo editor. It also handles instance-specific behaviors such as gating access for private instances and displaying a demo mode banner. MainLayout provides a simpler, centered container for content pages. This change centralizes routing guards, layout styling, and context providers, improving consistency across the application.
web/src/layouts · high confidence
Updated database schema for MySQL and PostgreSQL
The latest migration scripts for MySQL and PostgreSQL have been updated to reflect the current database structure. This includes the addition of new tables for memo sharing (memo\_share) and user identity linkage (user\_identity), as well as the definition of tables for spaces, space membership, attachments, and reactions. The schema also enforces unique constraints on usernames and emails, supports JSON payloads for spaces and memos, and includes indexes to optimize queries related to space membership, memo relations, and memo sharing.
store/migration/mysql · high confidence
Test coverage
Added integration tests for server startup and rate limiting; Added test utilities for S3 storage and media metadata; Expanded store test coverage for attachments, identity providers, and inbox; Expanded test coverage for web components and utilities.
Dependencies
Major dependency and toolchain upgrades across web and backend
The web frontend has been upgraded to React 19, TypeScript 7, Vite 8, and Tailwind CSS 4, with the build tooling migrating from ESLint/Prettier to Biome and the package manager to pnpm 11. On the backend, the Go toolchain has been upgraded to 1.27, the module path has been renamed to github.com/usememos/memos, and the HTTP router has been migrated from gorilla/mux to Echo v5, alongside significant updates to AWS SDK v2, gRPC, and SQLite dependencies.
(dependencies) · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 49 → 54 (+5.1)
- Rubric changed (rubric-2026.09.15 → rubric-2026.10.5) — scores are not directly comparable.
Lenses
- Code Health 89 → 77 (-12.1)
- Architecture 40 → 51 (+10.9)
- Maturity 72 → 69 (-3.4)
- Readiness 75 → 75 (+0.5)
- Security 48 → 54 (+5.1)
- Accessibility 49 → 49 (+0.0)
- Performance 88 (new)
Resolved (14)
- ADR not followed: Unique Email Design (docs/design/unique-email.md)
- Documentation: no installation or build instructions (README.md)
- Documentation: no usage examples (README.md)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Medium: security finding (details withheld)
- Off-boarding risk: anonymized user #1
- Secret: jwt (store/seed/sqlite/01__dump.sql)
- Secret: password-hash-credential (store/db/sqlite/seed/dump.sql)
- TodoComment (server/api/v1/instance_service.go)
New (899)
- AISection.AISection (cognitive 21) (web/src/components/Settings/AISection.tsx)
- AISection.AISection (cyclomatic 21) (web/src/components/Settings/AISection.tsx)
- APIService.BatchDeleteAttachments (cognitive 18) (server/api/attachment_service.go)
- APIService.CreateMemoComment (cognitive 22) (server/api/memo_service_comments.go)
- APIService.CreateMemoComment (cyclomatic 22) (server/api/memo_service_comments.go)
- APIService.CreateUser (cognitive 70) (server/api/user_service.go)
- APIService.CreateUser (cyclomatic 34) (server/api/user_service.go)
- APIService.DeleteMemo (cognitive 22) (server/api/memo_service.go)
- APIService.DeleteMemo (cyclomatic 19) (server/api/memo_service.go)
- APIService.GetUserStats (cognitive 47) (server/api/user_service_stats.go)
- APIService.GetUserStats (cyclomatic 20) (server/api/user_service_stats.go)
- APIService.ImportMemoExport (cognitive 18) (server/api/user_service_memo_import.go)
- APIService.ImportMemos (cognitive 24) (server/api/user_service_memo_transfer.go)
- APIService.ImportMemos (cyclomatic 18) (server/api/user_service_memo_transfer.go)
- APIService.ListMemoComments (cognitive 29) (server/api/memo_service_comments.go)
- APIService.ListMemoComments (cyclomatic 24) (server/api/memo_service_comments.go)
- APIService.ListMemos (cognitive 38) (server/api/memo_service.go)
- APIService.ListMemos (cyclomatic 28) (server/api/memo_service.go)
- APIService.ListSpaceInvitations (cognitive 16) (server/api/space_service.go)
- APIService.ListUserNotifications (cognitive 18) (server/api/user_service_notifications.go)
- …and 879 more
Changes since last survey
- 35 commits — 24 feature/other, 11 fixes
By area
- web/src — 25 commits
- (root) — 2 commits
- .agents/skills — 1 commit
- .github/workflows — 1 commit
- filter/README.md — 1 commit
- internal/linkmeta — 1 commit
- internal/ratelimit — 1 commit
- server/api — 1 commit
- store/db — 1 commit
- store/test — 1 commit
Notable commits
- fix: fix(filter): match memos without the flag in JSON bool comparisons (#6382)
- fix: fix(linkmeta): read further for missing preview metadata
- fix: fix(version): derive development CalVer from HEAD commit date
- fix: fix(web): adapt react-hot-toast to dark mode (#6377)
- fix: fix(web): keep preference submenus on screen in narrow viewports
- fix: fix(web): only honor pinned memos in single-creator feeds
- fix: fix(web): pan zoomed images in the preview dialog (#6414)
- fix: fix(web): show the Space mark beside the creator in the sidebar switcher
- fix: fix: delete comment subtree when a memo is deleted (#6424)
- fix: fix: image preview controls not being accessible on mobile (#6401)
- fix: fix: prevent reaction picker from flashing at page origin (#6402)
- change: chore(go): modernize source and enforce go fix in CI
- change: chore(views): remove built-in Tasks and improve empty states
- change: chore: add agent release playbook
- change: chore: add migration tests
- change: chore: apply BRAND.md copy to the app (#6417)
- change: chore: make individual memos easier to open
- change: chore: open calendar and map to guests, simplify navigation
- change: chore: polish markdown rendering rhythm and heading scale
- change: chore: polish space selector from the visibility menu
- …and 15 more
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
usememos/memos was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 9 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit d566184a45c5bd0e515aef1a32f45659c8bf44ae — the exact code this score is about.
- Scored under rubric-2026.10.5 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-fe8540b5da9b.