memos-engine 0.2.0__tar.gz → 0.3.0__tar.gz

memos_engine-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+        # TODO: verify tree-sitter/fastembed/sqlite-vec have wheels for 3.13
+        # If not, document limitation in README and keep only 3.12
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync
+      - run: uv run ruff check .
+      - run: uv run pytest --cov=memos --cov-report=xml --cov-fail-under=70 -m "not slow"
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  packaging-smoke-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+      - run: uv build
+      - name: install from built wheel in isolated venv
+        run: |
+          python -m venv /tmp/smoke-venv
+          /tmp/smoke-venv/bin/pip install dist/*.whl
+          /tmp/smoke-venv/bin/memos --help
+      - name: verify entry point works end-to-end
+        run: |
+          mkdir -p /tmp/smoke-project/src
+          echo 'def foo(): return 1' > /tmp/smoke-project/src/a.py
+          cd /tmp/smoke-project
+          /tmp/smoke-venv/bin/memos index --path .
+          /tmp/smoke-venv/bin/memos query symbol foo --path . | grep -q '"name": "foo"'

memos_engine-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.12"
+      - name: verify tag matches pyproject version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PYPROJECT_VERSION=$(grep -Po '(?<=^version = ")[^"]+' pyproject.toml)
+          if [ "$TAG_VERSION" != "$PYPROJECT_VERSION" ]; then
+            echo "Tag $TAG_VERSION does not match pyproject.toml version $PYPROJECT_VERSION"
+            exit 1
+          fi
+      - run: uv sync
+      - run: uv run ruff check .
+      - run: uv run pytest
+      - run: uv build
+      - run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+      - name: extract changelog for this version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          awk -v ver="$TAG_VERSION" \
+            '/^## / { if (found) exit; if (index($0, "## " ver) == 1) found=1; next } \
+             found { print }' CHANGELOG.md > /tmp/release_body.md
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          body_path: /tmp/release_body.md

{memos_engine-0.2.0 → memos_engine-0.3.0}/.gitignore

@@ -6,7 +6,7 @@ __pycache__/
 # memos local index database
 .memos/
 
-MEMORY_OS_ARCHITECTURE.md
+TZ.md
 
 # C extensions
 *.so

{memos_engine-0.2.0 → memos_engine-0.3.0}/AGENTS.md

@@ -97,7 +97,7 @@ call edges, imports) с episodic memory. Инструмент доступен
 | `memory_prune_tool(older_than_days?, kind?, apply?)` | Удаление устаревших записей (dry-run по умолчанию) |
 | `reindex_file_tool(path)` | Переиндексировать один файл после правки |
 
-Индексируются файлы с расширениями `.ts`, `.tsx`, `.go`. Индекс лежит в
+Индексируются файлы с расширениями `.ts`, `.tsx`, `.go`, `.py`, `.js`, `.jsx`. Индекс лежит в
 `.memos/memory.db` в корне проекта и обновляется через `memos index --path .`
 (инкрементально, по content hash — быстро на повторных запусках). Для
 переиндексации одного файла после правки используй `reindex_file_tool(path)`
@@ -117,6 +117,8 @@ a short descriptive title and all details in the commit body.
 
 | Command | What |
 |---------|------|
+| `memos --version` | show version |
+| `memos tools` | list available MCP tools |
 | `uv run pytest` | all tests |
 | `uv run pytest -v` | verbose |
 | `uv run pytest tests/test_crud.py::test_symbol_crud` | single test |
@@ -126,13 +128,21 @@ a short descriptive title and all details in the commit body.
 | `uv run memos query module <path>` | show everything for a file |
 | `uv run memos serve --path . --port 8000` | start FastAPI server |
 | `uv run memos serve-mcp --path .` | start MCP server (stdio) |
+| `uv run memos doctor --path .` | Run project diagnostics |
+| `uv run memos watch --path .` | Watch files and auto-reindex |
 | `uv run pytest tests/test_mcp.py` | MCP server tests |
 | `uv run pytest tests/test_llm_summary.py` | LLM summary tests |
 | `uv run pytest tests/test_impact.py` | Impact analysis tests |
 | `uv run pytest tests/test_hygiene.py` | Dead code / hygiene tests |
 | `uv run pytest tests/test_dependency_graph.py` | Dependency graph tests |
 | `uv run pytest tests/test_memory_hygiene.py` | Memory search & prune tests |
+| `uv run pytest tests/test_javascript_indexer.py` | JavaScript indexer tests |
+| `uv run pytest tests/test_query_efficiency.py` | Query N+1 regression guard |
+| `uv run pytest tests/test_packaging.py` | Packaging smoke tests |
 | `uv run pytest tests/test_reindex.py` | Reindex tool tests |
+| `uv run pytest tests/test_cli_doctor.py` | Doctor CLI tests |
+| `uv run pytest tests/test_watch.py` | Watch (slow) tests |
+| `uv run pytest --cov=memos --cov-report=term-missing -m "not slow"` | Tests with coverage report |
 | `curl http://localhost:8000/symbols/{id}/context` | API: get context for symbol |
 | `uv add <pkg>` | add dependency |
 | `uv add --dev <pkg>` | add dev dependency |
@@ -150,13 +160,16 @@ memos/
       0001_init.sql # authoritative DDL
       0002_vec.sql
       0003_prompt_version.sql
-      0004_memory_fts.sql
+       0004_memory_fts.sql
+       0005_symbol_name_file_index.sql
   indexer/
     base.py         # LanguageIndexer ABC + ParsedSymbol/Call/Import/Result dataclasses
-    typescript.py   # TypeScriptIndexer (tree-sitter, handles .ts + .tsx)
+    typescript.py   # TypeScriptIndexer (tree-sitter, handles .ts + .tsx + .js + .jsx via language_override)
     go.py           # GoIndexer (tree-sitter, export by name case)
     python.py       # PythonIndexer (tree-sitter, export by _ prefix)  # NEW
     diff.py         # compute_file_hash, should_reindex
+  scripts/
+    benchmark_index.py  # performance benchmark harness
   query/
     core.py         # find_symbol, find_calls, get_module, find_calls_by_id, semantic_search,
                     # list_files, list_symbols, get_or_generate_summary, get_context,
@@ -173,15 +186,23 @@ memos/
     embeddings.py   # FastEmbedEmbedding (all-MiniLM-L6-v2, 384-dim)
     sqlite_vec_store.py  # SqliteVecStore (sqlite-vec vec0 table)
   cli/
-    main.py         # argparse: "memos index [--path .] [--full] [--no-embed]"
+    doctor.py       # run_diagnostics(), DiagnosticResult — pure functions for `memos doctor`
+    main.py         # argparse: "memos [--version]"
+                    #          "memos index [--path .] [--full] [--no-embed] [--profile]"
                     #          "memos query (symbol|calls|module)"
                     #          "memos serve [--path] [--port]"
                     #          "memos serve-mcp [--path]"
+                    #          "memos tools"
+                    #          "memos doctor"
+                    #          "memos watch"
 tests/
   conftest.py       # fixture: in-memory sqlite with migrations applied
   test_schema.py    # table existence checks
   test_crud.py      # CRUD + cascade delete
-  test_migrations.py# idempotent re-run
+   test_migrations.py# idempotent re-run
+    test_javascript_indexer.py  # 11 unit tests on JS parsing
+    test_query_efficiency.py    # 1 query N+1 regression guard
+    test_packaging.py           # 1 packaging smoke test
    test_typescript_indexer.py  # 18 unit tests on TS parsing
    test_go_indexer.py          # 18 unit tests on Go parsing
    test_python_indexer.py      # 18 unit tests on Python parsing
@@ -204,6 +225,7 @@ tests/
     go_mini/src/            # 3 .go files for integration testing
     python_mini/src/        # 3 .py files for integration testing  # NEW
     import_cycle/src/       # 2 .ts files with circular import
+    javascript_mini/src/    # 2 .js files for integration testing
 ```
 
 ## Dependencies
@@ -216,9 +238,11 @@ tests/
 - **fastembed** — ONNX embeddings (all-MiniLM-L6-v2, 384-dim)
 - **sqlite-vec** — vector search extension for sqlite
 - **rich** — CLI progress bars
+- **watchdog** — file system watcher for `memos watch`
 - **pytest** (dev)
 - **httpx** (dev, for TestClient)
 - **pytest-anyio** (dev, for async MCP tests)
+- **ruff** (dev)
 - **hatchling** (build)
 
 ## Architecture conventions
@@ -261,3 +285,6 @@ tests/
 14. ✅ Section 3: Dependency graph (graph + cycle detection, MCP, API, tests)
 15. ✅ Section 4: Memory search & hygiene (FTS5 search, prune, MCP, API, tests)
 16. ✅ Section 5: Reindex file tool (per-file reindex via MCP, tests)
+17. ✅ Section 0 (Phase 3): Packaging hardening — CI smoke-test, migration test, Python 3.13 matrix, README fix
+18. ✅ Section 1 (Phase 3): JavaScript .js/.jsx support — require()→import, language_override, fixtures, tests
+19. ✅ Section 3 (Phase 3): Performance — batch embedding, profile flag, benchmark script, N+1 fix, migration 0005

{memos_engine-0.2.0 → memos_engine-0.3.0}/AGENTS_EXAMPLE.md

@@ -101,8 +101,9 @@ call edges, imports) с episodic memory. Инструмент доступен
 | `memory_search_tool(query, top_k?)` | Полнотекстовый поиск по memory entries |
 | `memory_prune_tool(older_than_days?, kind?, apply?)` | Удаление устаревших записей (dry-run по умолчанию) |
 | `reindex_file_tool(path)` | Переиндексировать один файл после правки |
+| `usage_stats_tool()` | Показать счётчики вызовов тулов за сессию |
 
-Индексируются файлы с расширениями `.ts`, `.tsx`, `.go`. Индекс лежит в
+Индексируются файлы с расширениями `.ts`, `.tsx`, `.go`, `.py`, `.js`, `.jsx`. Индекс лежит в
 `.memos/memory.db` в корне проекта и обновляется через `memos index --path .`
 (инкрементально, по content hash — быстро на повторных запусках). Для
 переиндексации одного файла после правки используй `reindex_file_tool(path)`

memos_engine-0.3.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## 0.3.0 — 2026-07-22
+
+- JavaScript (.js/.jsx) support: `require()` → import (not call), `module.exports` ignored
+- Packaging hardening: CI smoke-test, migration presence test, Python 3.12+3.13 matrix
+- Performance: batch embedding (single model, chunked by 256, rich Progress bar)
+- Benchmarks: `--profile` flag, `scripts/benchmark_index.py`, query-efficiency regression test
+- Migration 0005: composite index `symbols(name, file_id)` for faster resolve
+- Fixed N+1 in `resolve_call_edges` (batch SELECT vs per-edge loop)
+- Adoption tooling: `memos doctor`, `memos watch`, `usage_stats_tool`
+- Diagnostics: `memos doctor` checks index freshness, schema, embeddings, unresolved edges
+- MCP: `_tracked` decorator counts per-session tool usage via `usage_stats_tool`
+- File watching: `memos watch` auto-reindexes on file changes (watchdog, 500ms debounce)
+
+## 0.2.0 — 2026-07-21
+
+- Python language support (indexer, tests, fixtures)
+- Self-indexed: memos-engine uses memos for its own development
+- PyPI package `memos-engine` with MIT license
+- CI: GitHub Actions release workflow (tag → build → publish)
+- GitHub Release automation with changelog categorization
+
+## 0.1.0 — 2026-07-21
+
+- Initial release
+- TypeScript/Go structural index via tree-sitter
+- MCP server with 20 tools
+- FastAPI with 15 endpoints
+- Semantic search (fastembed + sqlite-vec)
+- Episodic memory (FTS5)
+- Impact analysis, dead code, dependency graph, memory hygiene

{memos_engine-0.2.0 → memos_engine-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memos-engine
-Version: 0.2.0
+Version: 0.3.0
 Summary: Memory OS for AI coding agents — structural code index with episodic memory
 Project-URL: Repository, https://github.com/TAskMAster339/memos-engine
 Author: TAskMAster339
@@ -22,6 +22,7 @@ Requires-Dist: tree-sitter-python>=0.23.0
 Requires-Dist: tree-sitter-typescript>=0.23.2
 Requires-Dist: tree-sitter>=0.26.0
 Requires-Dist: uvicorn[standard]>=0.34.0
+Requires-Dist: watchdog>=4.0.0
 Description-Content-Type: text/markdown
 
 # memos — Structural code index for AI agents
@@ -34,14 +35,17 @@ Description-Content-Type: text/markdown
 ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff)
 ![TSX](https://img.shields.io/badge/TSX-3178C6?logo=react&logoColor=fff)
 ![Go](https://img.shields.io/badge/Go-00ADD8?logo=go&logoColor=fff)
+![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=000)
+
+[![codecov](https://codecov.io/gh/TAskMAster339/memos-engine/branch/main/graph/badge.svg)](https://codecov.io/gh/TAskMAster339/memos-engine)
 
 </div>
 
 `memos` builds a **structural index** (symbols, call edges, imports) of a
-TypeScript / TSX / Go / Python codebase using tree-sitter and stores it in
-SQLite. It is the first layer of a larger *Memory OS* for AI coding agents
-— instead of grepping text, agents query **structure** (definitions,
-callers, callees).
+TypeScript / TSX / Go / Python / JavaScript codebase using tree-sitter and
+stores it in SQLite. It is the first layer of a larger *Memory OS* for AI
+coding agents — instead of grepping text, agents query **structure**
+(definitions, callers, callees).
 
 ## Integrating memos into your project
 
@@ -64,13 +68,6 @@ cd memos-engine
 uv tool install -e .
 ```
 
-Or install from PyPI (no clone needed):
-
-```bash
-pip install memos-engine
-# or via uv:
-uv tool install memos-engine
-```
 
 **2. Index your project**
 
@@ -107,11 +104,23 @@ git clone https://github.com/TAskMAster339/memos-engine.git
 cd memos-engine
 uv tool install -e .
 
+# Check version
+memos --version
+
 # Index a project
 memos index --path /path/to/your/project
 
+# List all available MCP tools
+memos tools
+
 # Start the MCP server for AI agents
 memos serve-mcp
+
+# Run project diagnostics
+memos doctor --path /path/to/your/project
+
+# Watch files and auto-reindex
+memos watch --path /path/to/your/project
 ```
 
 Or using `uv run` without global install:
@@ -120,6 +129,8 @@ Or using `uv run` without global install:
 uv sync                            # install deps
 uv run memos index --path .        # index current project
 uv run memos index --path . --full # force reindex (ignore hashes)
+uv run memos index --path . --no-embed  # skip embeddings (faster)
+uv run memos index --path . --profile   # print phase timings
 ```
 
 ## Query
@@ -248,6 +259,7 @@ Available tools:
 | `memory_search_tool` | Full-text search over memory entries |
 | `memory_prune_tool` | Delete stale memory entries (dry-run by default) |
 | `reindex_file_tool` | Re-index a single file after editing |
+| `usage_stats_tool` | Show per-session tool call counters (resets on server restart) |
 
 Each query tool accepts an optional `project` parameter to target a specific opened project (defaults to the most recently opened one).
 
@@ -289,6 +301,9 @@ Configure in `claude_desktop_config.json`:
 
 ```bash
 uv run pytest -v
+
+# With coverage (excludes slow tests)
+uv run pytest --cov=memos --cov-report=term-missing -m "not slow"
 ```
 
 ## Architecture notes
@@ -302,6 +317,7 @@ uv run pytest -v
 - The CLI (`memos index`) is a thin adapter over `indexer/` + `core/db.py` —
   no business logic.
 - Semantic search: sqlite-vec vec0 table, lazy-loaded fastembed model, cascade
-  cleanup on reindex (`--no-embed` flag to skip).
+  cleanup on reindex (`--no-embed` flag to skip). Embeddings computed in
+  batches of 256 with rich progress bar (`--profile` for phase timings).
 - MCP server (`memos serve-mcp`) is a thin FastMCP adapter over `query/core.py`
   — same pattern as the FastAPI adapter.

{memos_engine-0.2.0 → memos_engine-0.3.0}/README.md

@@ -8,14 +8,17 @@
 ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff)
 ![TSX](https://img.shields.io/badge/TSX-3178C6?logo=react&logoColor=fff)
 ![Go](https://img.shields.io/badge/Go-00ADD8?logo=go&logoColor=fff)
+![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript&logoColor=000)
+
+[![codecov](https://codecov.io/gh/TAskMAster339/memos-engine/branch/main/graph/badge.svg)](https://codecov.io/gh/TAskMAster339/memos-engine)
 
 </div>
 
 `memos` builds a **structural index** (symbols, call edges, imports) of a
-TypeScript / TSX / Go / Python codebase using tree-sitter and stores it in
-SQLite. It is the first layer of a larger *Memory OS* for AI coding agents
-— instead of grepping text, agents query **structure** (definitions,
-callers, callees).
+TypeScript / TSX / Go / Python / JavaScript codebase using tree-sitter and
+stores it in SQLite. It is the first layer of a larger *Memory OS* for AI
+coding agents — instead of grepping text, agents query **structure**
+(definitions, callers, callees).
 
 ## Integrating memos into your project
 
@@ -38,13 +41,6 @@ cd memos-engine
 uv tool install -e .
 ```
 
-Or install from PyPI (no clone needed):
-
-```bash
-pip install memos-engine
-# or via uv:
-uv tool install memos-engine
-```
 
 **2. Index your project**
 
@@ -81,11 +77,23 @@ git clone https://github.com/TAskMAster339/memos-engine.git
 cd memos-engine
 uv tool install -e .
 
+# Check version
+memos --version
+
 # Index a project
 memos index --path /path/to/your/project
 
+# List all available MCP tools
+memos tools
+
 # Start the MCP server for AI agents
 memos serve-mcp
+
+# Run project diagnostics
+memos doctor --path /path/to/your/project
+
+# Watch files and auto-reindex
+memos watch --path /path/to/your/project
 ```
 
 Or using `uv run` without global install:
@@ -94,6 +102,8 @@ Or using `uv run` without global install:
 uv sync                            # install deps
 uv run memos index --path .        # index current project
 uv run memos index --path . --full # force reindex (ignore hashes)
+uv run memos index --path . --no-embed  # skip embeddings (faster)
+uv run memos index --path . --profile   # print phase timings
 ```
 
 ## Query
@@ -222,6 +232,7 @@ Available tools:
 | `memory_search_tool` | Full-text search over memory entries |
 | `memory_prune_tool` | Delete stale memory entries (dry-run by default) |
 | `reindex_file_tool` | Re-index a single file after editing |
+| `usage_stats_tool` | Show per-session tool call counters (resets on server restart) |
 
 Each query tool accepts an optional `project` parameter to target a specific opened project (defaults to the most recently opened one).
 
@@ -263,6 +274,9 @@ Configure in `claude_desktop_config.json`:
 
 ```bash
 uv run pytest -v
+
+# With coverage (excludes slow tests)
+uv run pytest --cov=memos --cov-report=term-missing -m "not slow"
 ```
 
 ## Architecture notes
@@ -276,6 +290,7 @@ uv run pytest -v
 - The CLI (`memos index`) is a thin adapter over `indexer/` + `core/db.py` —
   no business logic.
 - Semantic search: sqlite-vec vec0 table, lazy-loaded fastembed model, cascade
-  cleanup on reindex (`--no-embed` flag to skip).
+  cleanup on reindex (`--no-embed` flag to skip). Embeddings computed in
+  batches of 256 with rich progress bar (`--profile` for phase timings).
 - MCP server (`memos serve-mcp`) is a thin FastMCP adapter over `query/core.py`
   — same pattern as the FastAPI adapter.

memos_engine-0.3.0/memos/cli/doctor.py

@@ -0,0 +1,175 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Literal
+
+from memos.core.db import MIGRATIONS_DIR, get_connection
+from memos.indexer.diff import compute_file_hash
+
+Status = Literal["ok", "warn", "error"]
+_WARN_PCT_UNRESOLVED = 50
+_WARN_PCT_EMBEDDING = 80
+
+
+@dataclass
+class DiagnosticResult:
+    check: str
+    status: Status
+    detail: str
+
+
+def _get_schema_version(conn) -> int:
+    cur = conn.execute(
+        "SELECT name FROM sqlite_master WHERE type='table' AND name='schema_version'",
+    )
+    if cur.fetchone() is None:
+        return 0
+    return conn.execute(
+        "SELECT COALESCE(MAX(version), 0) FROM schema_version",
+    ).fetchone()[0]
+
+
+def run_diagnostics(  # noqa: C901, PLR0912, PLR0915
+    conn, project, root_path: str,
+) -> list[DiagnosticResult]:
+    results: list[DiagnosticResult] = []
+
+    db_path = str(Path(root_path) / ".memos" / "memory.db")
+    if not Path(db_path).exists():
+        results.append(DiagnosticResult(
+            check="Index file exists",
+            status="error",
+            detail=f".memos/memory.db not found at {root_path}"
+            " — run 'memos index --path .'",
+        ))
+    else:
+        results.append(DiagnosticResult(
+            check="Index file exists",
+            status="ok",
+            detail=".memos/memory.db found",
+        ))
+
+    try:
+        test_conn = get_connection(db_path)
+        test_conn.close()
+        vec_ok = True
+    except Exception as e:
+        vec_ok = False
+        results.append(DiagnosticResult(
+            check="sqlite-vec extension",
+            status="error",
+            detail=f"sqlite_vec failed to load: {e}",
+        ))
+    if vec_ok:
+        results.append(DiagnosticResult(
+            check="sqlite-vec extension",
+            status="ok",
+            detail="sqlite_vec loaded successfully",
+        ))
+
+    latest_migration = sorted(MIGRATIONS_DIR.glob("*.sql"))
+    expected = int(latest_migration[-1].stem.split("_")[0]) if latest_migration else 0
+    current = _get_schema_version(conn)
+    if current < expected:
+        results.append(DiagnosticResult(
+            check="Schema version",
+            status="warn",
+            detail=f"schema version {current} < expected {expected}"
+            " — run any memos command to auto-migrate",
+        ))
+    else:
+        results.append(DiagnosticResult(
+            check="Schema version",
+            status="ok",
+            detail=f"schema version {current} (latest)",
+        ))
+
+    files = conn.execute(
+        "SELECT f.id, f.path, f.content_hash FROM files f WHERE f.project_id = ?",
+        (project.id,),
+    ).fetchall()
+    stale = 0
+    for f in files:
+        full_path = str(Path(root_path) / f["path"])
+        if not Path(full_path).exists():
+            stale += 1
+            continue
+        current_hash = compute_file_hash(full_path)
+        if current_hash != f["content_hash"]:
+            stale += 1
+    if stale > 0:
+        results.append(DiagnosticResult(
+            check="Index freshness",
+            status="warn",
+            detail=f"{stale} of {len(files)} files stale"
+            " — run 'memos index --path .'",
+        ))
+    else:
+        results.append(DiagnosticResult(
+            check="Index freshness",
+            status="ok",
+            detail=f"all {len(files)} files up to date",
+        ))
+
+    total_edges = conn.execute(
+        "SELECT COUNT(*) FROM call_edges ce "
+        "JOIN symbols s ON s.id = ce.caller_symbol_id "
+        "JOIN files f ON f.id = s.file_id WHERE f.project_id = ?",
+        (project.id,),
+    ).fetchone()[0]
+    unresolved = conn.execute(
+        "SELECT COUNT(*) FROM call_edges ce "
+        "JOIN symbols s ON s.id = ce.caller_symbol_id "
+        "JOIN files f ON f.id = s.file_id "
+        "WHERE f.project_id = ? AND ce.callee_symbol_id IS NULL",
+        (project.id,),
+    ).fetchone()[0]
+    if total_edges > 0:
+        pct = unresolved / total_edges * 100
+        if pct > _WARN_PCT_UNRESOLVED:
+            results.append(DiagnosticResult(
+                check="Unresolved call edges",
+                status="warn",
+                detail=f"{unresolved}/{total_edges} ({pct:.0f}%) unresolved"
+                " — run 'memos index' to trigger resolution",
+            ))
+        else:
+            results.append(DiagnosticResult(
+                check="Unresolved call edges",
+                status="ok",
+                detail=f"{unresolved}/{total_edges} ({pct:.0f}%) unresolved",
+            ))
+    else:
+        results.append(DiagnosticResult(
+            check="Unresolved call edges",
+            status="ok",
+            detail="no call edges",
+        ))
+
+    sym_count = conn.execute(
+        "SELECT COUNT(*) FROM symbols s "
+        "JOIN files f ON f.id = s.file_id WHERE f.project_id = ?",
+        (project.id,),
+    ).fetchone()[0]
+    vec_count = conn.execute(
+        "SELECT COUNT(*) FROM vec_symbols vs "
+        "JOIN symbols s ON s.id = vs.rowid "
+        "JOIN files f ON f.id = s.file_id WHERE f.project_id = ?",
+        (project.id,),
+    ).fetchone()[0]
+    if sym_count > 0 and vec_count / sym_count * 100 < _WARN_PCT_EMBEDDING:
+        results.append(DiagnosticResult(
+            check="Embedding coverage",
+            status="warn",
+            detail=f"{vec_count}/{sym_count} symbols have embeddings (<80%)"
+            " — reindex without --no-embed",
+        ))
+    else:
+        results.append(DiagnosticResult(
+            check="Embedding coverage",
+            status="ok",
+            detail=f"{vec_count}/{sym_count} symbols have embeddings",
+        ))
+
+    return results