footprinter-cli 1.0.1__tar.gz → 1.0.2__tar.gz

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.2
 Name: footprinter-cli
-Version: 1.0.1
+Version: 1.0.2
 Summary: A local context layer for your files, browser history, chats, and email — searchable, user-owned, MCP-served.
 Author: SwellCity Group
 License: MIT
-Project-URL: Homepage, https://github.com/swellcitygroup/footprinter
-Project-URL: Repository, https://github.com/swellcitygroup/footprinter
-Project-URL: Issues, https://github.com/swellcitygroup/footprinter/issues
-Project-URL: Documentation, https://github.com/swellcitygroup/footprinter/blob/main/README.md
+Project-URL: Homepage, https://github.com/harringjohn/footprinter-cli
+Project-URL: Repository, https://github.com/harringjohn/footprinter-cli
+Project-URL: Issues, https://github.com/harringjohn/footprinter-cli/issues
+Project-URL: Documentation, https://github.com/harringjohn/footprinter-cli/blob/main/README.md
+Project-URL: Changelog, https://github.com/harringjohn/footprinter-cli/blob/main/CHANGELOG.md
 Keywords: indexer,mcp,metadata,model-context-protocol,file-indexing,sqlite,context-engineering,personal-information-management
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -52,6 +53,7 @@ Requires-Dist: httpx<1.0,>=0.27.0; extra == "dev"
 # Footprinter
 
 [![Tests](https://github.com/swellcitygroup/footprinter/actions/workflows/test.yml/badge.svg)](https://github.com/swellcitygroup/footprinter/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/footprinter-cli)](https://pypi.org/project/footprinter-cli/)
 
 **A local context layer for your files, browser history, chats, and email — searchable, user-owned, and served to AI agents through [MCP](https://modelcontextprotocol.io/).**
 
@@ -75,7 +77,7 @@ curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scr
 curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install-full.sh | bash
 ```
 
-If you prefer to manage the install yourself, use **pipx** (recommended) — modern macOS Python ships PEP 668 enabled, which blocks bare `pip install`:
+If you prefer to manage the install yourself, use **pipx** (recommended) — it isolates Footprinter and sidesteps the macOS install caveats noted below:
 
 ```bash
 brew install pipx
@@ -84,6 +86,11 @@ pipx install footprinter-cli
 pipx install 'footprinter-cli[full]'   # with semantic + parse
 ```
 
+> **macOS caveats for manual installs:**
+> - **zsh** treats `[...]` as a glob, so keep the single quotes around any bracketed extras specifier (e.g. `'footprinter-cli[full]'`). Without quotes you'll see `zsh: no matches found`.
+> - **System and Homebrew Python** ship with PEP 668 enabled, which blocks bare `pip install` outside a venv. Use pipx (above) instead.
+> - **python.org-distributed Python** doesn't enforce PEP 668, so a bare `pip install footprinter-cli` outside pipx or a venv may succeed but place `fp` in `/Library/Frameworks/Python.framework/Versions/<x.y>/bin`, which isn't on `PATH` by default. Use pipx (above) or the install script.
+
 Inside an existing venv, `pip` works as expected:
 
 ```bash
@@ -171,9 +178,9 @@ All commands use the `fp` entry point.
 | `fp mcp` | MCP server and access policies |
 | `fp api` | Start the HTTP API server |
 | `fp view` | Browse indexed data (files, folders, projects, clients, chats, emails, visits) |
-| `fp upsert` | Create or update records and assign relationships |
+| `fp upsert` | Create/update records, assign relationships, or soft-delete via `--status removed` |
 | `fp data` | Export data, generate templates, or import metadata corrections |
-| `fp delete` | Soft-delete a record |
+| `fp delete` | Hard-delete a super entity (irreversible) |
 | `fp vectorize` | Manage per-record vectorization control |
 | `fp doctor` | Post-install health check (Python version, install location, FDA, MCP wiring) |
 | `fp uninstall` | Remove Footprinter — MCP entry, user data, package |

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/README.md

@@ -1,6 +1,7 @@
 # Footprinter
 
 [![Tests](https://github.com/swellcitygroup/footprinter/actions/workflows/test.yml/badge.svg)](https://github.com/swellcitygroup/footprinter/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/footprinter-cli)](https://pypi.org/project/footprinter-cli/)
 
 **A local context layer for your files, browser history, chats, and email — searchable, user-owned, and served to AI agents through [MCP](https://modelcontextprotocol.io/).**
 
@@ -24,7 +25,7 @@ curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scr
 curl -fsSL https://raw.githubusercontent.com/swellcitygroup/footprinter/main/scripts/release/install-full.sh | bash
 ```
 
-If you prefer to manage the install yourself, use **pipx** (recommended) — modern macOS Python ships PEP 668 enabled, which blocks bare `pip install`:
+If you prefer to manage the install yourself, use **pipx** (recommended) — it isolates Footprinter and sidesteps the macOS install caveats noted below:
 
 ```bash
 brew install pipx
@@ -33,6 +34,11 @@ pipx install footprinter-cli
 pipx install 'footprinter-cli[full]'   # with semantic + parse
 ```
 
+> **macOS caveats for manual installs:**
+> - **zsh** treats `[...]` as a glob, so keep the single quotes around any bracketed extras specifier (e.g. `'footprinter-cli[full]'`). Without quotes you'll see `zsh: no matches found`.
+> - **System and Homebrew Python** ship with PEP 668 enabled, which blocks bare `pip install` outside a venv. Use pipx (above) instead.
+> - **python.org-distributed Python** doesn't enforce PEP 668, so a bare `pip install footprinter-cli` outside pipx or a venv may succeed but place `fp` in `/Library/Frameworks/Python.framework/Versions/<x.y>/bin`, which isn't on `PATH` by default. Use pipx (above) or the install script.
+
 Inside an existing venv, `pip` works as expected:
 
 ```bash
@@ -120,9 +126,9 @@ All commands use the `fp` entry point.
 | `fp mcp` | MCP server and access policies |
 | `fp api` | Start the HTTP API server |
 | `fp view` | Browse indexed data (files, folders, projects, clients, chats, emails, visits) |
-| `fp upsert` | Create or update records and assign relationships |
+| `fp upsert` | Create/update records, assign relationships, or soft-delete via `--status removed` |
 | `fp data` | Export data, generate templates, or import metadata corrections |
-| `fp delete` | Soft-delete a record |
+| `fp delete` | Hard-delete a super entity (irreversible) |
 | `fp vectorize` | Manage per-record vectorization control |
 | `fp doctor` | Post-install health check (Python version, install location, FDA, MCP wiring) |
 | `fp uninstall` | Remove Footprinter — MCP entry, user data, package |

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/access.py

@@ -46,7 +46,7 @@ def _is_inherit_source(source: str) -> bool:
 #   table:          SQL table name
 #   has_visibility: has mcp_view column
 #   has_permissions: has mcp_read column
-#   has_status:     has status column (filter WHERE status != 'removed')
+#   has_status:     has status column (filter WHERE status = 'listed')
 #   has_project_id: has project_id FK
 #   has_client_id:  has client_id FK
 #   has_account:    has account column
@@ -129,7 +129,7 @@ def _get_all_ids(conn: sqlite3.Connection, entity_type: str) -> list[int]:
     meta = ENTITY_META[entity_type]
     table = meta["table"]
     if meta["has_status"]:
-        rows = conn.execute(f"SELECT id FROM {table} WHERE status != 'removed'").fetchall()
+        rows = conn.execute(f"SELECT id FROM {table} WHERE status = 'listed'").fetchall()
     else:
         rows = conn.execute(f"SELECT id FROM {table}").fetchall()
     return [r["id"] for r in rows]
@@ -162,7 +162,7 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
             table = meta["table"]
             where = "account = ?"
             if meta["has_status"]:
-                where += " AND status != 'removed'"
+                where += " AND status = 'listed'"
             rows = conn.execute(f"SELECT id FROM {table} WHERE {where}", (value,)).fetchall()
             ids = [r["id"] for r in rows]
             if ids:
@@ -183,7 +183,7 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
             table = meta["table"]
             where = f"{path_col} LIKE ? ESCAPE '\\'"
             if meta["has_status"]:
-                where += " AND status != 'removed'"
+                where += " AND status = 'listed'"
             rows = conn.execute(
                 f"SELECT id FROM {table} WHERE {where}",
                 (escaped + "%",),
@@ -210,7 +210,7 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
             table = meta["table"]
             where = "project_id = ?"
             if meta["has_status"]:
-                where += " AND status != 'removed'"
+                where += " AND status = 'listed'"
             rows = conn.execute(f"SELECT id FROM {table} WHERE {where}", (project_id,)).fetchall()
             ids = [r["id"] for r in rows]
             if ids:
@@ -248,7 +248,7 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
             table = meta["table"]
             where = "client_id = ?"
             if meta["has_status"]:
-                where += " AND status != 'removed'"
+                where += " AND status = 'listed'"
             rows = conn.execute(f"SELECT id FROM {table} WHERE {where}", (client_id,)).fetchall()
             if rows:
                 id_sets.setdefault(etype, {}).update({r["id"]: None for r in rows})

footprinter_cli-1.0.2/footprinter/api/__init__.py

@@ -0,0 +1,4 @@
+"""Footprinter HTTP API — FastAPI routers calling the service layer."""
+
+MAX_LIMIT = 200
+"""Upper bound for `limit` query params on HTTP list/search endpoints."""

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/api/entities.py

@@ -4,6 +4,7 @@ from typing import Optional
 
 from fastapi import APIRouter, Depends, HTTPException, Query
 
+from footprinter.api import MAX_LIMIT
 from footprinter.api.db import get_conn
 from footprinter.services import (
     chat_service,
@@ -36,7 +37,7 @@ def list_files(
     source: Optional[str] = Query(None, description="Comma-separated source filter"),
     status: Optional[str] = Query(None, description="Comma-separated status filter"),
     content_type: Optional[str] = None,
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
     source_list = [s.strip() for s in source.split(",")] if source else None
@@ -71,7 +72,7 @@ def list_emails(
     has_attachments: Optional[bool] = None,
     sort_by: str = "received_at",
     order: str = "desc",
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
     return email_service.list_(
@@ -105,7 +106,7 @@ def list_chats(
     sort_by: str = "modified_at",
     order: str = "desc",
     status: Optional[str] = Query(None, description="Comma-separated status filter"),
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
     status_list = [s.strip() for s in status.split(",")] if status else None
@@ -137,7 +138,7 @@ def list_projects(
     status: Optional[str] = Query(None, description="Comma-separated status filter"),
     client: Optional[str] = None,
     project_type: Optional[str] = None,
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
     include_list = [s.strip() for s in include.split(",")] if include else None
@@ -172,7 +173,7 @@ def list_clients(
     conn=Depends(get_conn),
     include: Optional[str] = Query(None, description="Comma-separated includes"),
     status: Optional[str] = Query(None, description="Comma-separated status filter"),
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
     include_list = [s.strip() for s in include.split(",")] if include else None
@@ -216,16 +217,19 @@ def list_folders(
     project_id: Optional[int] = None,
     depth: Optional[int] = 1,
     include_hidden: bool = False,
+    status: Optional[str] = Query(None, description="Comma-separated status filter"),
     sort_by: str = "size",
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
+    status_list = [s.strip() for s in status.split(",")] if status else None
     return folder_service.list_(
         conn,
         role=Role.ADMIN,
         project_id=project_id,
         depth=depth,
         include_hidden=include_hidden,
+        status=status_list,
         sort_by=sort_by,
         limit=limit,
         page=page,
@@ -241,7 +245,11 @@ def get_folder(folder_id: int, conn=Depends(get_conn)):
 
 
 @router.get("/visits")
-def list_visits(conn=Depends(get_conn), limit: int = 50, page: int = 1):
+def list_visits(
+    conn=Depends(get_conn),
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
+    page: int = 1,
+):
     return visit_service.list_(conn, role=Role.ADMIN, limit=limit, page=page)
 
 

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/api/search.py

@@ -4,6 +4,7 @@ from typing import Optional
 
 from fastapi import APIRouter, Depends, Query
 
+from footprinter.api import MAX_LIMIT
 from footprinter.api.db import get_conn
 from footprinter.services import search_service
 from footprinter.services.roles import Role
@@ -20,7 +21,7 @@ def search(
     client: Optional[str] = None,
     date_from: Optional[str] = None,
     date_to: Optional[str] = None,
-    limit: int = 50,
+    limit: int = Query(50, ge=1, le=MAX_LIMIT),
     account: Optional[str] = None,
     sender: Optional[str] = None,
     days_back: Optional[int] = None,

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/api/semantic.py

@@ -2,6 +2,7 @@
 
 from fastapi import APIRouter, Depends, HTTPException, Query
 
+from footprinter.api import MAX_LIMIT
 from footprinter.api.db import get_conn
 from footprinter.services import semantic_service
 from footprinter.services.roles import Role
@@ -16,7 +17,7 @@ def semantic_search(
     conn=Depends(get_conn),
     query: str = Query(..., min_length=3, description="Search query (minimum 3 characters)"),
     source: str = Query("all", description="Source to search: chats, files, or all"),
-    limit: int = 10,
+    limit: int = Query(10, ge=1, le=MAX_LIMIT),
 ):
     """Semantic (vector) search across indexed content."""
     if source not in _VALID_SOURCES:

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/bundled/config.example.yaml

@@ -17,7 +17,7 @@ browsers:
 #
 # Files matching these patterns are NEVER scanned — they don't appear in the
 # database at all. This is different from hidden files (dot-files/dot-directories),
-# which ARE scanned and indexed with status='hidden' so they appear in the catalog
+# which ARE scanned and indexed with status='unlisted' so they appear in the catalog
 # but are excluded from Drive sync.
 #
 # Two tiers: always (all folders), sensitive (all folders)
@@ -41,8 +41,11 @@ exclusions:
     - ".*/\\.sfdx/.*"            # Salesforce DX CLI
     - ".*/\\.docker/.*"          # Docker config
     - ".*/\\.cumulusci/.*"       # CumulusCI cache
+    - ".*/\\.browser_state/.*"   # Playwright/Puppeteer browser state
+    - ".*/\\.context/.*"         # IDE/agent context directories
+    - ".*/\\.ai-dev/.*"          # AI dev tool scratch dirs
     # Home-level Claude dirs only (keep .claude within Work/Personal)
-    - "^~/\\.claude/.*"           # Home-level .claude
+    - "^~/\\.claude/.*"           # Home-level .claude (includes session-env snapshots)
     - "^~/\\.claude-worktrees/.*" # Home-level .claude-worktrees
     # Git internals (but NOT .gitignore, .gitattributes - those are kept)
     - ".*/\\.git/.*"             # Git internal directory contents
@@ -115,17 +118,19 @@ vectorization:
   # but not embedded in the vector store.
   #
   # Common exclusions — system caches, IDE output, and tool output that
-  # match text file extensions but contain no meaningful prose content:
-  #   - "**/Photos Library.photoslibrary/**"  # macOS Spotlight index cache (.txt)
-  #   - "**/.claude/debug/**"                 # Claude Code debug logs
-  #   - "**/.claude/paste-cache/**"           # Claude Code paste cache
-  #   - "**/.claude/cache/**"                 # Claude Code cache
-  #   - "**/.claude/projects/**"              # Claude Code session data
-  #   - "**/.claude/plans/**"                 # Claude Code auto-generated plans
-  #   - "**/.claude/plugins/**"              # Claude Code plugin cache
-  #   - "**/.cci/**"                          # CumulusCI cache
-  #   - "**/.context/**"                      # IDE context directories
-  exclude_patterns: []
+  # match text file extensions but contain no meaningful prose content.
+  exclude_patterns:
+    - "**/Photos Library.photoslibrary/**"  # macOS Spotlight index cache (.txt)
+    - "**/.claude/debug/**"                 # Claude Code debug logs
+    - "**/.claude/paste-cache/**"           # Claude Code paste cache
+    - "**/.claude/cache/**"                 # Claude Code cache
+    - "**/.claude/projects/**"              # Claude Code session data
+    - "**/.claude/plans/**"                 # Claude Code auto-generated plans
+    - "**/.claude/plugins/**"               # Claude Code plugin cache
+    - "**/.cci/**"                          # CumulusCI cache
+    - "**/.context/**"                      # IDE context directories
+    - "**/.github/**"                       # GitHub workflow files (FTS-only)
+    - "**/.ai-dev/**"                       # AI dev tool scratch dirs
 
 # Source registry seeds — loaded into the sources table on init
 # Connector sources added by: fp connect install <name>

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/cli/_common.py

@@ -49,16 +49,7 @@ C_ERROR = "red"
 C_INFO = "cyan"
 C_DIM = "dim"
 
-VALID_STATUSES = frozenset(
-    {
-        "active",
-        "paused",
-        "completed",
-        "abandoned",
-        "archived",
-        "merged",
-    }
-)
+VALID_STATUSES = frozenset({"listed", "unlisted", "removed"})
 
 ALLOWED_TABLES = frozenset({"clients", "projects"})
 ALLOWED_COLUMNS = frozenset({"name", "project_name"})
@@ -113,7 +104,7 @@ def open_database(db_path=None):
 
     Like ``open_db`` but yields the full ``Database`` wrapper instead of a
     raw ``sqlite3.Connection``.  Use this when callers need methods only
-    available on the wrapper (e.g. ``ChatDedup``).
+    available on the wrapper.
 
     Exits with code 1 if the database file does not exist.
     """

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/cli/_policy_helpers.py

@@ -128,7 +128,7 @@ def check_file_path(conn: sqlite3.Connection, path: str, json_output: bool, verb
     expanded = os.path.expanduser(os.path.normpath(path))
 
     row = conn.execute(
-        "SELECT id, name, project_id FROM files WHERE path = ? AND status != 'removed'",
+        "SELECT id, name, project_id FROM files WHERE path = ? AND status = 'listed'",
         (expanded,),
     ).fetchone()
 
@@ -200,7 +200,7 @@ def check_folder(conn: sqlite3.Connection, path: str, json_output: bool, verbose
         expanded += os.sep
 
     rows = conn.execute(
-        "SELECT id, name FROM files WHERE path LIKE ? AND status != 'removed'",
+        "SELECT id, name FROM files WHERE path LIKE ? AND status = 'listed'",
         (expanded + "%",),
     ).fetchall()
 

footprinter_cli-1.0.2/footprinter/cli/api_cmd.py

@@ -0,0 +1,61 @@
+"""fp api — start the HTTP API server."""
+
+import sys
+
+from footprinter.cli._common import FORMATTER
+
+_LOOPBACK_HOSTS = {"127.0.0.1", "localhost", "::1"}
+
+
+def _start_api(args) -> None:
+    if args.host not in _LOOPBACK_HOSTS:
+        if not args.allow_insecure_bind:
+            print(
+                f"error: refusing to bind to non-loopback host {args.host!r}.\n"
+                "The Footprinter HTTP API has no authentication; binding outside "
+                "loopback exposes indexed data to anyone on the network.\n"
+                "Pass --allow-insecure-bind to override.",
+                file=sys.stderr,
+            )
+            raise SystemExit(2)
+        print(
+            f"WARNING: binding to {args.host} — the HTTP API has no authentication. "
+            "Anyone reachable on this network can read indexed files, emails, "
+            "chats, and browser history.",
+            file=sys.stderr,
+        )
+
+    from footprinter.api.server import main
+
+    main(host=args.host, port=args.port)
+
+
+def register(subparsers) -> None:
+    """Register the ``api`` subcommand."""
+    parser = subparsers.add_parser(
+        "api",
+        help="Start the HTTP API server",
+        description=(
+            "Start the Footprinter HTTP API server.\n\n"
+            "Provides REST endpoints for programmatic access to indexed data.\n"
+            "Auto-generated docs available at /docs (Swagger UI)."
+        ),
+        epilog=(
+            "examples:\n"
+            "  fp api                                       Start on localhost:8000\n"
+            "  fp api --port 9000                           Start on custom port\n"
+            "  fp api --host 0.0.0.0 --allow-insecure-bind  Listen on all interfaces (no auth!)"
+        ),
+        formatter_class=FORMATTER,
+    )
+    parser.add_argument("--host", default="127.0.0.1", help="Host to bind (default: 127.0.0.1)")
+    parser.add_argument("--port", type=int, default=8000, help="Port to bind (default: 8000)")
+    parser.add_argument(
+        "--allow-insecure-bind",
+        action="store_true",
+        help=(
+            "Allow binding to non-loopback interfaces. The HTTP API has no "
+            "authentication; anyone on the network can read indexed data."
+        ),
+    )
+    parser.set_defaults(func=_start_api)

{footprinter_cli-1.0.1 → footprinter_cli-1.0.2}/footprinter/cli/data.py

@@ -45,7 +45,7 @@ def _export_query(entity_type: str, status_filter: str | None) -> tuple[str, lis
             sql += " WHERE status = ?"
             params.append(status_filter)
         else:
-            sql += " WHERE status != 'removed'"
+            sql += " WHERE status = 'listed'"
         sql += " ORDER BY name"
     else:
         sql = (
@@ -58,7 +58,7 @@ def _export_query(entity_type: str, status_filter: str | None) -> tuple[str, lis
             sql += " WHERE p.status = ?"
             params.append(status_filter)
         else:
-            sql += " WHERE p.status != 'removed'"
+            sql += " WHERE p.status = 'listed'"
         sql += " ORDER BY p.project_name"
     return sql, params
 
@@ -74,10 +74,10 @@ TEMPLATE_ROWS: dict[str, list[dict]] = {
             "client_type": "external",
             "slug": "",
             "path_pattern": "~/Work/clients/acme/",
-            "status": "active",
+            "status": "listed",
         },
-        {"name": "Internal Tools", "client_type": "internal", "slug": "", "path_pattern": "", "status": "active"},
-        {"name": "Side Project", "client_type": "personal", "slug": "", "path_pattern": "", "status": "active"},
+        {"name": "Internal Tools", "client_type": "internal", "slug": "", "path_pattern": "", "status": "listed"},
+        {"name": "Side Project", "client_type": "personal", "slug": "", "path_pattern": "", "status": "listed"},
     ],
     "project": [
         {
@@ -87,7 +87,7 @@ TEMPLATE_ROWS: dict[str, list[dict]] = {
             "project_type": "python",
             "description": "A web application",
             "github_url": "",
-            "status": "active",
+            "status": "listed",
         },
         {
             "project_name": "Documentation",
@@ -96,7 +96,7 @@ TEMPLATE_ROWS: dict[str, list[dict]] = {
             "project_type": "docs",
             "description": "Internal documentation",
             "github_url": "",
-            "status": "active",
+            "status": "listed",
         },
         {
             "project_name": "Mobile App",
@@ -105,7 +105,7 @@ TEMPLATE_ROWS: dict[str, list[dict]] = {
             "project_type": "typescript",
             "description": "Mobile app",
             "github_url": "",
-            "status": "active",
+            "status": "listed",
         },
     ],
 }
@@ -113,10 +113,10 @@ TEMPLATE_ROWS: dict[str, list[dict]] = {
 VALID_VALUES_NOTES: dict[str, dict[str, str]] = {
     "client": {
         "client_type": "external, internal, personal",
-        "status": "active, hidden, removed",
+        "status": "listed, unlisted, removed",
     },
     "project": {
-        "status": "active, paused, completed, abandoned, removed",
+        "status": "listed, unlisted, removed",
     },
 }
 
@@ -165,7 +165,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "name": "readme.md",
                 "path": "/Users/me/Work/readme.md",
                 "source": "local",
-                "status": "active",
+                "status": "listed",
                 "content_type": "markdown",
                 "size_bytes": "1024",
                 "modified_at": "2026-01-15T10:00:00Z",
@@ -190,7 +190,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
             },
         ],
         valid_values={
-            "status": "active, hidden, removed",
+            "status": "listed, unlisted, removed",
             "mcp_view": "hidden, opaque, visible, inherit",
             "mcp_read": "allow, deny, inherit",
         },
@@ -219,7 +219,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "relative_path": "Work",
                 "name": "Work",
                 "source": "local",
-                "status": "active",
+                "status": "listed",
                 "project_id": "1",
                 "client_id": "",
                 "mcp_view": "visible",
@@ -231,7 +231,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "relative_path": "Personal",
                 "name": "Personal",
                 "source": "local",
-                "status": "active",
+                "status": "listed",
                 "project_id": "",
                 "client_id": "",
                 "mcp_view": "inherit",
@@ -239,7 +239,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
             },
         ],
         valid_values={
-            "status": "active, hidden, removed",
+            "status": "listed, unlisted, removed",
             "mcp_view": "hidden, opaque, visible, inherit",
             "mcp_read": "allow, deny, inherit",
         },
@@ -270,7 +270,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "subject": "Project Update",
                 "from_address": "sender@example.com",
                 "received_at": "2026-02-01T09:00:00Z",
-                "status": "active",
+                "status": "listed",
                 "project_id": "1",
                 "client_id": "1",
                 "mcp_view": "visible",
@@ -283,7 +283,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "subject": "Newsletter",
                 "from_address": "news@example.com",
                 "received_at": "2026-02-02T09:00:00Z",
-                "status": "active",
+                "status": "listed",
                 "project_id": "",
                 "client_id": "",
                 "mcp_view": "inherit",
@@ -291,7 +291,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
             },
         ],
         valid_values={
-            "status": "active, hidden, removed",
+            "status": "listed, unlisted, removed",
             "mcp_view": "hidden, opaque, visible, inherit",
             "mcp_read": "allow, deny, inherit",
         },
@@ -322,7 +322,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "account": "personal",
                 "title": "Architecture Chat",
                 "message_count": "5",
-                "status": "active",
+                "status": "listed",
                 "created_at": "2026-01-10T08:00:00Z",
                 "updated_at": "2026-01-10T09:00:00Z",
                 "project_id": "1",
@@ -336,7 +336,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "account": "personal",
                 "title": "Random Chat",
                 "message_count": "3",
-                "status": "active",
+                "status": "listed",
                 "created_at": "2026-01-11T08:00:00Z",
                 "updated_at": "2026-01-11T09:00:00Z",
                 "project_id": "",
@@ -346,7 +346,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
             },
         ],
         valid_values={
-            "status": "active, hidden, removed, merged",
+            "status": "listed, unlisted, removed",
             "mcp_view": "hidden, opaque, visible, inherit",
             "mcp_read": "allow, deny, inherit",
         },
@@ -414,7 +414,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "title": "Example",
                 "visit_time": "2026-03-01T12:00:00Z",
                 "browser": "safari",
-                "status": "active",
+                "status": "listed",
                 "project_id": "1",
                 "client_id": "1",
                 "mcp_view": "visible",
@@ -426,7 +426,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
                 "title": "News",
                 "visit_time": "2026-03-02T12:00:00Z",
                 "browser": "chrome",
-                "status": "active",
+                "status": "listed",
                 "project_id": "",
                 "client_id": "",
                 "mcp_view": "inherit",
@@ -434,7 +434,7 @@ DATA_SOURCE_SPECS: dict[str, DataSourceSpec] = {
             },
         ],
         valid_values={
-            "status": "active, hidden, removed",
+            "status": "listed, unlisted, removed",
             "mcp_view": "hidden, opaque, visible, inherit",
             "mcp_read": "allow, deny, inherit",
         },
@@ -541,7 +541,7 @@ def _handle_export_data_source(args) -> None:
             sql += " WHERE status = ?"
             params.append(status_filter)
         else:
-            sql += " WHERE status != 'removed'"
+            sql += " WHERE status = 'listed'"
     elif status_filter:
         print(
             f"Entity '{noun}' does not have a status column.",