footprinter-cli 1.0.3__tar.gz → 1.0.4__tar.gz

{footprinter_cli-1.0.3/footprinter_cli.egg-info → footprinter_cli-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: footprinter-cli
-Version: 1.0.3
+Version: 1.0.4
 Summary: A local context layer for your files, browser history, chats, and email — searchable, user-owned, MCP-served.
 Author: SwellCity Group
 License: MIT
@@ -20,6 +20,8 @@ Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Database
 Classifier: Topic :: Text Processing :: Indexing
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
@@ -59,67 +61,52 @@ Requires-Dist: httpx<1.0,>=0.27.0; extra == "dev"
 
 Your work lives across filesystems, browsers, inboxes, chat histories, and other tools. Footprinter indexes those sources into a single local store, organizes them into the projects and groupings you define, and serves the result to AI agents through a governed access layer. You control what the agent can see. Everything stays on your machine.
 
-## Prerequisites
-
-- **Python 3.11 or newer.** Stock macOS ships with Python 3.9, which won't work — install a newer Python from [python.org](https://www.python.org/downloads/) (recommended) or via `brew install python@3.11`.
-- **macOS 13+** or **Linux**.
-- **Full Disk Access on macOS** for browser history indexing. Grant it to your terminal app under *System Settings → Privacy & Security → Full Disk Access*. `fp setup` will guide you through this when needed.
-
 ## Install
 
-The fastest path on a clean machine is the install script — it ensures Python 3.11+ is present and installs `footprinter-cli`:
+Requires **Python 3.11+** and **macOS 13+** or **Linux**. The install script checks your Python version and handles the rest:
 
 ```bash
-# Base install (CLI + MCP + HTTP API)
 curl -fsSL https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install.sh | bash
-
-# Full install (adds semantic search + document parsing)
-curl -fsSL https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install-full.sh | bash
 ```
 
-If you prefer to manage the install yourself, use **pipx** (recommended) — it isolates Footprinter and sidesteps the macOS install caveats noted below:
+Or install with **pipx** directly:
 
 ```bash
-brew install pipx
-pipx ensurepath           # then restart your terminal
 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
-./venv/bin/pip install footprinter-cli
-./venv/bin/pip install 'footprinter-cli[full]'
 ```
 
-The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more:
+Either method gives you the `fp` command with the indexing pipeline, CLI, MCP server, and HTTP API. Optional extras add more:
 
 | Extra | What it adds |
 |-------|-------------|
 | `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
 | `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
-| `[full]` | All optional extras (semantic + parse) |
+| `[full]` | Both of the above |
 
-> **Privacy note:** The `[semantic]` extra installs ChromaDB. Footprinter initializes
-> the ChromaDB client with `anonymized_telemetry=False`, so no telemetry is sent
-> regardless of which version pip resolves. ChromaDB also removed product telemetry
-> entirely in version 1.5.4. See
-> [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss) for details.
+To install with extras: use the [full install script](https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install-full.sh), or `pipx install 'footprinter-cli[full]'`.
 
-### Uninstall
+<details>
+<summary>Troubleshooting & alternative install methods</summary>
+
+**Python version:** Stock macOS ships Python 3.9. Install 3.11+ from [python.org](https://www.python.org/downloads/) or `brew install python@3.11`.
+
+**macOS caveats:**
+- zsh treats `[...]` as a glob — quote extras specifiers: `'footprinter-cli[full]'`
+- System/Homebrew Python blocks bare `pip install` (PEP 668) — use pipx or a venv instead
+
+**Inside an existing venv:** `pip install footprinter-cli` works as expected.
+
+**Full Disk Access:** Required for browser history indexing on macOS. `fp setup` will prompt you when needed.
+
+**ChromaDB telemetry:** Footprinter sets `anonymized_telemetry=False`. ChromaDB also removed product telemetry in v1.5.4. See [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss).
 
-`fp uninstall` cleans up the MCP entry and user data first, then run the appropriate package uninstall:
+</details>
+
+### Uninstall
 
 ```bash
-fp uninstall                                    # remove MCP entry + user data
-pipx uninstall footprinter-cli                  # if you installed via pipx
-./venv/bin/pip uninstall footprinter-cli        # if you installed inside a venv
+fp uninstall                        # remove MCP entry + user data
+pipx uninstall footprinter-cli      # remove the package
 ```
 
 ## Quick Start
@@ -156,14 +143,12 @@ Once configured, Claude can search your files, browse projects, and find related
 | **Local files** | Path, type, size, timestamps, content hash |
 | **Browser history** | Safari and Chrome — URLs, titles, visit times |
 | **Chat exports** | Claude and ChatGPT conversation exports |
-| **Email** | Subject, sender, recipients, body, timestamps — ingested via [connector plugins](#connectors) |
+| **Email** | Subject, sender, recipients, body, timestamps |
 | **Documents** | PDF, Word, Excel, PowerPoint content (with `[parse]` extra) |
 | **Semantic embeddings** | Conceptual similarity across all sources (with `[semantic]` extra) |
 
 What lands in the database — and when — is controlled by the **content storage tier** you opt into. By default, Footprinter only indexes metadata; it does not read your file content until you explicitly enable it. See [Content Storage](https://github.com/harringjohn/footprinter-cli/blob/main/reference/content-storage.md) for the full breakdown.
 
-Additional sources are available through [connector plugins](#connectors).
-
 ## CLI Commands
 
 All commands use the `fp` entry point.
@@ -187,30 +172,12 @@ All commands use the `fp` entry point.
 
 Run `fp <command> --help` for full usage.
 
-## Connectors
-
-Connector plugins add external data sources like email, cloud storage, and third-party services. They install alongside Footprinter and register automatically:
-
-```bash
-pip install footprinter-<name>
-```
-
-First-party and community connectors are in development — check the repository for updates.
-
-Use `fp connect list` to see available connectors and their status.
-
 ## Architecture
 
 Single-process CLI with optional MCP server. SQLite database. No containers, no cloud, no accounts.
 
 Sources are scanned into SQLite with bidirectional links connecting local files to remote backups via content hash matching. Embeddings are generated at ingest time for semantic search. The MCP server exposes indexed data with two-layer access control (visibility + permissions) — you decide what agents can see.
 
-## Requirements
-
-- Python 3.11+
-- macOS 13+ or Linux
-- Full Disk Access on macOS (for browser history)
-
 ## Documentation
 
 - [Interfaces](https://github.com/harringjohn/footprinter-cli/blob/main/reference/interfaces.md) — CLI commands, MCP tools, Python API
@@ -223,8 +190,6 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 
 Bug fixes, documentation, and tests welcome. For new features or architectural changes, [open an issue](https://github.com/harringjohn/footprinter-cli/issues) first to discuss the approach.
 
-Connector plugins use an internal API that isn't stable yet — we're not accepting connector contributions at this time.
-
 ### Development setup
 
 ```bash

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/README.md

@@ -7,67 +7,52 @@
 
 Your work lives across filesystems, browsers, inboxes, chat histories, and other tools. Footprinter indexes those sources into a single local store, organizes them into the projects and groupings you define, and serves the result to AI agents through a governed access layer. You control what the agent can see. Everything stays on your machine.
 
-## Prerequisites
-
-- **Python 3.11 or newer.** Stock macOS ships with Python 3.9, which won't work — install a newer Python from [python.org](https://www.python.org/downloads/) (recommended) or via `brew install python@3.11`.
-- **macOS 13+** or **Linux**.
-- **Full Disk Access on macOS** for browser history indexing. Grant it to your terminal app under *System Settings → Privacy & Security → Full Disk Access*. `fp setup` will guide you through this when needed.
-
 ## Install
 
-The fastest path on a clean machine is the install script — it ensures Python 3.11+ is present and installs `footprinter-cli`:
+Requires **Python 3.11+** and **macOS 13+** or **Linux**. The install script checks your Python version and handles the rest:
 
 ```bash
-# Base install (CLI + MCP + HTTP API)
 curl -fsSL https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install.sh | bash
-
-# Full install (adds semantic search + document parsing)
-curl -fsSL https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install-full.sh | bash
 ```
 
-If you prefer to manage the install yourself, use **pipx** (recommended) — it isolates Footprinter and sidesteps the macOS install caveats noted below:
+Or install with **pipx** directly:
 
 ```bash
-brew install pipx
-pipx ensurepath           # then restart your terminal
 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
-./venv/bin/pip install footprinter-cli
-./venv/bin/pip install 'footprinter-cli[full]'
 ```
 
-The base install includes the indexing pipeline, CLI, MCP server, HTTP API, and token encryption. Optional extras add more:
+Either method gives you the `fp` command with the indexing pipeline, CLI, MCP server, and HTTP API. Optional extras add more:
 
 | Extra | What it adds |
 |-------|-------------|
 | `[semantic]` | Semantic search via ChromaDB + ONNX embeddings |
 | `[parse]` | PDF, Word, Excel, PowerPoint content extraction |
-| `[full]` | All optional extras (semantic + parse) |
+| `[full]` | Both of the above |
 
-> **Privacy note:** The `[semantic]` extra installs ChromaDB. Footprinter initializes
-> the ChromaDB client with `anonymized_telemetry=False`, so no telemetry is sent
-> regardless of which version pip resolves. ChromaDB also removed product telemetry
-> entirely in version 1.5.4. See
-> [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss) for details.
+To install with extras: use the [full install script](https://raw.githubusercontent.com/harringjohn/footprinter-cli/main/scripts/release/install-full.sh), or `pipx install 'footprinter-cli[full]'`.
 
-### Uninstall
+<details>
+<summary>Troubleshooting & alternative install methods</summary>
+
+**Python version:** Stock macOS ships Python 3.9. Install 3.11+ from [python.org](https://www.python.org/downloads/) or `brew install python@3.11`.
+
+**macOS caveats:**
+- zsh treats `[...]` as a glob — quote extras specifiers: `'footprinter-cli[full]'`
+- System/Homebrew Python blocks bare `pip install` (PEP 668) — use pipx or a venv instead
+
+**Inside an existing venv:** `pip install footprinter-cli` works as expected.
+
+**Full Disk Access:** Required for browser history indexing on macOS. `fp setup` will prompt you when needed.
+
+**ChromaDB telemetry:** Footprinter sets `anonymized_telemetry=False`. ChromaDB also removed product telemetry in v1.5.4. See [Chroma OSS overview](https://docs.trychroma.com/docs/overview/oss).
 
-`fp uninstall` cleans up the MCP entry and user data first, then run the appropriate package uninstall:
+</details>
+
+### Uninstall
 
 ```bash
-fp uninstall                                    # remove MCP entry + user data
-pipx uninstall footprinter-cli                  # if you installed via pipx
-./venv/bin/pip uninstall footprinter-cli        # if you installed inside a venv
+fp uninstall                        # remove MCP entry + user data
+pipx uninstall footprinter-cli      # remove the package
 ```
 
 ## Quick Start
@@ -104,14 +89,12 @@ Once configured, Claude can search your files, browse projects, and find related
 | **Local files** | Path, type, size, timestamps, content hash |
 | **Browser history** | Safari and Chrome — URLs, titles, visit times |
 | **Chat exports** | Claude and ChatGPT conversation exports |
-| **Email** | Subject, sender, recipients, body, timestamps — ingested via [connector plugins](#connectors) |
+| **Email** | Subject, sender, recipients, body, timestamps |
 | **Documents** | PDF, Word, Excel, PowerPoint content (with `[parse]` extra) |
 | **Semantic embeddings** | Conceptual similarity across all sources (with `[semantic]` extra) |
 
 What lands in the database — and when — is controlled by the **content storage tier** you opt into. By default, Footprinter only indexes metadata; it does not read your file content until you explicitly enable it. See [Content Storage](https://github.com/harringjohn/footprinter-cli/blob/main/reference/content-storage.md) for the full breakdown.
 
-Additional sources are available through [connector plugins](#connectors).
-
 ## CLI Commands
 
 All commands use the `fp` entry point.
@@ -135,30 +118,12 @@ All commands use the `fp` entry point.
 
 Run `fp <command> --help` for full usage.
 
-## Connectors
-
-Connector plugins add external data sources like email, cloud storage, and third-party services. They install alongside Footprinter and register automatically:
-
-```bash
-pip install footprinter-<name>
-```
-
-First-party and community connectors are in development — check the repository for updates.
-
-Use `fp connect list` to see available connectors and their status.
-
 ## Architecture
 
 Single-process CLI with optional MCP server. SQLite database. No containers, no cloud, no accounts.
 
 Sources are scanned into SQLite with bidirectional links connecting local files to remote backups via content hash matching. Embeddings are generated at ingest time for semantic search. The MCP server exposes indexed data with two-layer access control (visibility + permissions) — you decide what agents can see.
 
-## Requirements
-
-- Python 3.11+
-- macOS 13+ or Linux
-- Full Disk Access on macOS (for browser history)
-
 ## Documentation
 
 - [Interfaces](https://github.com/harringjohn/footprinter-cli/blob/main/reference/interfaces.md) — CLI commands, MCP tools, Python API
@@ -171,8 +136,6 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 
 Bug fixes, documentation, and tests welcome. For new features or architectural changes, [open an issue](https://github.com/harringjohn/footprinter-cli/issues) first to discuss the approach.
 
-Connector plugins use an internal API that isn't stable yet — we're not accepting connector contributions at this time.
-
 ### Development setup
 
 ```bash

footprinter_cli-1.0.3/footprinter/access.py → footprinter_cli-1.0.4/footprinter/access_stamper.py

@@ -12,6 +12,7 @@ import sqlite3
 from collections.abc import Callable
 from typing import Any
 
+from footprinter.db.policies import is_folder_path_scope
 from footprinter.permissions import batch_resolve_permissions
 from footprinter.visibility import batch_resolve_visibility
 
@@ -113,10 +114,21 @@ ENTITY_META: dict[str, dict[str, Any]] = {
         "has_account": False,
         "path_column": None,
     },
+    "visit": {
+        "table": "visits",
+        "has_visibility": True,
+        "has_permissions": True,
+        "has_status": False,
+        "has_project_id": False,
+        "has_client_id": False,
+        "has_account": False,
+        "path_column": None,
+    },
 }
 
 # Reverse map: source scope suffix → entity type (e.g. "files" → "file")
 _SOURCE_TO_ENTITY = {meta["table"]: etype for etype, meta in ENTITY_META.items()}
+_SOURCE_TO_ENTITY["browser"] = "visit"
 
 
 # ---------------------------------------------------------------------------
@@ -170,28 +182,58 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
         return result
 
     if prefix == "folder":
-        # folder:{path} → files/folders with matching path prefix
-        path = os.path.expanduser(value)
-        # Escape LIKE metacharacters so literal %, _ in paths match correctly
-        escaped = path.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
-        result = {}
-        for etype in ENTITY_META:
-            meta = ENTITY_META[etype]
-            path_col = meta["path_column"]
-            if path_col is None:
-                continue
-            table = meta["table"]
-            where = f"{path_col} LIKE ? ESCAPE '\\'"
-            if meta["has_status"]:
-                where += " AND status = 'listed'"
-            rows = conn.execute(
-                f"SELECT id FROM {table} WHERE {where}",
-                (escaped + "%",),
+        if is_folder_path_scope(scope):
+            # folder:{path} → files/folders with matching path prefix
+            path = os.path.expanduser(value)
+            # Escape LIKE metacharacters so literal %, _ in paths match correctly
+            escaped = path.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
+            result = {}
+            for etype in ENTITY_META:
+                meta = ENTITY_META[etype]
+                path_col = meta["path_column"]
+                if path_col is None:
+                    continue
+                table = meta["table"]
+                where = f"{path_col} LIKE ? ESCAPE '\\'"
+                if meta["has_status"]:
+                    where += " AND status = 'listed'"
+                rows = conn.execute(
+                    f"SELECT id FROM {table} WHERE {where}",
+                    (escaped + "%",),
+                ).fetchall()
+                ids = [r["id"] for r in rows]
+                if ids:
+                    result[etype] = ids
+            return result
+        else:
+            # folder:{id} → folder + all descendants via parent_folder_id
+            folder_id = int(value)
+            descendants_cte = """
+                WITH RECURSIVE descendants(id) AS (
+                    SELECT id FROM folders WHERE id = ?
+                    UNION ALL
+                    SELECT folder.id FROM folders folder
+                    JOIN descendants descendant ON folder.parent_folder_id = descendant.id
+                )
+            """
+            cursor = conn.cursor()
+            cursor.execute(
+                f"{descendants_cte} SELECT id FROM descendants",
+                (folder_id,),
+            )
+            desc_ids = [row["id"] for row in cursor.fetchall()]
+            if not desc_ids:
+                return {}
+            result: dict[str, list[int]] = {"folder": desc_ids}
+            ph = ",".join("?" * len(desc_ids))
+            file_rows = conn.execute(
+                f"SELECT id FROM files WHERE folder_id IN ({ph}) AND status = 'listed'",
+                tuple(desc_ids),
             ).fetchall()
-            ids = [r["id"] for r in rows]
-            if ids:
-                result[etype] = ids
-        return result
+            file_ids = [r["id"] for r in file_rows]
+            if file_ids:
+                result["file"] = file_ids
+            return result
 
     if prefix == "project":
         project_id = int(value)

footprinter_cli-1.0.4/footprinter/api/db.py

@@ -0,0 +1,38 @@
+"""Database connection for Footprinter HTTP API."""
+
+import sqlite3
+from contextlib import contextmanager
+from typing import Generator
+
+from footprinter.db_base import open_checked_connection
+
+
+@contextmanager
+def get_db() -> Generator[sqlite3.Connection, None, None]:
+    """Context manager for database connections.
+
+    Divergences from MCP's ``get_db()``:
+
+    - No ``PRAGMA query_only`` — the HTTP API uses Role.ADMIN and may need
+      write access for future endpoints.
+    - No ``handle_db_errors`` decorator — ``DatabaseNotInitializedError`` is
+      caught by a FastAPI exception handler registered in ``server.create_app()``.
+
+    Calls ``load_globals()`` to refresh the global visibility/permission
+    policy cache in ``access_service`` for the current request.
+    """
+    with open_checked_connection() as conn:
+        yield conn
+
+
+def get_conn():
+    """FastAPI dependency that yields a database connection.
+
+    Usage::
+
+        @router.get("/endpoint")
+        def handler(conn=Depends(get_conn)):
+            ...
+    """
+    with get_db() as conn:
+        yield conn

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/api/server.py

@@ -3,7 +3,7 @@
 from fastapi import FastAPI, Request
 from fastapi.responses import JSONResponse
 
-from footprinter.api.db import DatabaseNotInitializedError
+from footprinter.utils.exceptions import DatabaseNotInitializedError
 
 
 def create_app() -> "FastAPI":

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/bundled/config.example.yaml

@@ -116,9 +116,9 @@ vectorization:
   # ~1000 chars ≈ 250 tokens. Larger chunks get silently truncated by the model,
   # meaning content past the window is invisible to semantic search.
   chunk_size: 1000
-  # Overlap between consecutive chunks (fraction of chunk_size, 0.0 to 1.0).
-  # Applies to file vectorization only. Chat message chunking uses a fixed
-  # character overlap defined in footprinter/semantic/chunking.py.
+  # Fractional overlap between consecutive chunks (0.0–1.0).
+  # 0.15 = 15% of chunk_size chars shared between adjacent chunks.
+  # Legacy integer values (>= 1) are accepted but deprecated.
   chunk_overlap: 0.15
   # Patterns (fnmatch syntax) for file paths to skip during vectorization.
   # Matched against the full absolute path (e.g. ~/Work/file.json expands at runtime).

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/__init__.py

@@ -88,12 +88,12 @@ def main(argv=None) -> None:
         doctor,
         ingest,
         mcp_cmd,
-        search_cmd,
+        search,
         setup,
-        status_cmd,
+        status,
         uninstall,
         upsert,
-        vectorize_cmd,
+        vectorize,
         view,
     )
 
@@ -101,15 +101,15 @@ def main(argv=None) -> None:
         ingest,
         mcp_cmd,
         api_cmd,
-        status_cmd,
-        search_cmd,
+        status,
+        search,
         setup,
         connect,
         view,
         upsert,
         data,
         delete,
-        vectorize_cmd,
+        vectorize,
         uninstall,
         doctor,
     ]:

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/_common.py

@@ -80,6 +80,10 @@ def connect_db(db_path: Union[str, Path]) -> Optional[sqlite3.Connection]:
 def open_db(db_path=None):
     """Open the Footprinter DB; yields conn, closes on exit.
 
+    Calls :func:`~footprinter.services.access_service.load_globals` to
+    populate the global visibility/permission cache, mirroring the MCP
+    layer's ``get_db()``.
+
     Exits with code 1 if the database file does not exist.
     """
     if db_path is None:
@@ -92,6 +96,7 @@ def open_db(db_path=None):
             "[red]Database not found.[/red] Run [bold]fp setup[/bold] then [bold]fp ingest[/bold] to initialize."
         )
         sys.exit(1)
+    _access.load_globals(conn)
     try:
         yield conn
     finally:
@@ -261,8 +266,10 @@ def enrich_verbose_access(
     """Annotate rows in-place with access, access_source, visibility.
 
     Uses ``resolve_inherit_visibility`` / ``resolve_inherit_permission``
-    so that ``inherit`` values resolve to the global policy (when loaded
-    via ``load_globals``) or fall back to the hardcoded baseline.
+    so that ``inherit`` values resolve to the global policy.  Since
+    ``open_db()`` calls ``load_globals`` before yielding, ``inherit``
+    values resolve to the actual global policy in normal CLI usage.
+    The baseline fallback remains as a defence-in-depth measure.
 
     Three cases based on the ``mcp_read`` key in each row dict:
 

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/_policy_helpers.py

@@ -1,5 +1,5 @@
 """Shared MCP access-policy helpers used by ``setup.py`` and ``mcp_cmd.py``
-(``fp mcp view/read/check/bulk``).
+(``fp mcp check/set/reset/bulk``).
 """
 
 import os
@@ -7,7 +7,7 @@ import sqlite3
 
 from rich.table import Table
 
-from footprinter.access import (
+from footprinter.access_stamper import (
     count_affected_entities,
     recalculate_access,
     recalculate_access_batched,
@@ -22,6 +22,7 @@ from footprinter.db.policies import (
     set_visibility_policy,
 )
 from footprinter.paths import get_db_path
+from footprinter.utils.paths import abbreviate_home
 
 CONFIRM_THRESHOLD = 100
 """Entity count above which policy changes require interactive confirmation."""
@@ -105,16 +106,6 @@ def normalize_path(path: str) -> str:
     return normalized
 
 
-def abbreviate_home(path: str) -> str:
-    """Replace ``$HOME`` prefix with ``~`` for display."""
-    home = os.path.expanduser("~")
-    if path.startswith(home + os.sep):
-        return "~" + path[len(home) :]
-    elif path == home:
-        return "~"
-    return path
-
-
 # ---------------------------------------------------------------------------
 # Single-path check helpers
 # ---------------------------------------------------------------------------

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/_prompt.py

@@ -140,7 +140,7 @@ def _safe_readline(password: bool = False) -> str:
                 raise PromptCancelled("Ctrl+D")
 
             if byte in (0x0D, 0x0A):  # Enter
-                sys.stdout.write("\n")
+                sys.stdout.write("\r\n")
                 sys.stdout.flush()
                 return "".join(buf)
 

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/_vectorize_stage.py

@@ -99,7 +99,7 @@ def run_vectorization_stage(*, quiet: bool = False) -> None:
                 trail += f", {skipped_large} too large"
             console.print(f"  [green]✓[/green] Deep Read complete: {new} embedded" + trail)
         if skipped_large_files:
-            from footprinter.cli._policy_helpers import abbreviate_home
+            from footprinter.utils.paths import abbreviate_home
 
             console.print(
                 f"  [yellow]⚠[/yellow] Skipped {len(skipped_large_files)}"

{footprinter_cli-1.0.3 → footprinter_cli-1.0.4}/footprinter/cli/connect.py

@@ -57,7 +57,7 @@ def register(subparsers) -> None:
                 "Connectors add support for external data sources.\n"
                 "Each connector is a separate package.\n\n"
                 "No connectors are installed.\n\n"
-                "Learn more: https://github.com/swellcitygroup/footprinter"
+                "Learn more: https://github.com/harringjohn/footprinter-cli"
             )
             return
         _parser.print_help()
@@ -190,7 +190,7 @@ def _cmd_list(args) -> None:
             "No connectors installed.\n\n"
             "Connectors are separate packages that plug into Footprinter's\n"
             "ingest pipeline. To get started, visit:\n"
-            "  https://github.com/swellcitygroup/footprinter"
+            "  https://github.com/harringjohn/footprinter-cli"
         )
         return
 
@@ -240,7 +240,7 @@ def _cmd_install(args) -> None:
                 console.print(f"  [bold]{spec.name}[/bold] — {spec.description}")
             console.print("\nInstall one: [bold]fp connect install <name>[/bold]")
         else:
-            console.print("No connectors available.\n\nLearn more: https://github.com/swellcitygroup/footprinter")
+            console.print("No connectors available.\n\nLearn more: https://github.com/harringjohn/footprinter-cli")
         return
     spec = connectors.get(name)
     if spec is None: