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

{footprinter_cli-1.0.4 → footprinter_cli-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: footprinter-cli
-Version: 1.0.4
+Version: 1.1.0
 Summary: A local context layer for your files, browser history, chats, and email — searchable, user-owned, MCP-served.
 Author: SwellCity Group
 License: MIT
@@ -59,6 +59,12 @@ Requires-Dist: httpx<1.0,>=0.27.0; extra == "dev"
 
 **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/).**
 
+> ⚠️ **Install with `pipx`, not `pip`.** `pipx` puts the `fp` command on your PATH automatically; bare `pip` often doesn't — which leaves you with `fp: command not found` even though the install succeeded.
+
+```bash
+pipx install footprinter-cli
+```
+
 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.
 
 ## Install
@@ -75,7 +81,7 @@ Or install with **pipx** directly:
 pipx install footprinter-cli
 ```
 
-Either method gives you the `fp` command with the indexing pipeline, CLI, MCP server, and HTTP API. Optional extras add more:
+Either method installs three commands: `fp` (the CLI and indexing pipeline), `fp-mcp` (the MCP server for AI agents), and `fp-api` (the HTTP API). Optional extras add more:
 
 | Extra | What it adds |
 |-------|-------------|
@@ -100,6 +106,8 @@ To install with extras: use the [full install script](https://raw.githubusercont
 
 **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).
 
+**Apple Silicon (Rosetta):** If `fp doctor` warns about x86_64 Python on arm64 hardware, recreate the venv with a native interpreter: `pipx reinstall footprinter-cli --python /opt/homebrew/bin/python3`. This avoids compatibility issues with native-extension dependencies.
+
 </details>
 
 ### Uninstall
@@ -160,14 +168,12 @@ All commands use the `fp` entry point.
 | `fp status` | System health and data counts |
 | `fp search` | Search across all indexed sources |
 | `fp connect` | Manage optional integrations |
-| `fp mcp` | MCP server and access policies |
-| `fp api` | Start the HTTP API server |
+| `fp permission` | Manage access policies (visibility, permissions) |
 | `fp view` | Browse indexed data (files, folders, projects, clients, chats, emails, visits) |
-| `fp upsert` | Create/update records, assign relationships, or soft-delete via `--status removed` |
-| `fp data` | Export data, generate templates, or import metadata corrections |
+| `fp add` | Create new entity records or import from CSV |
+| `fp update` | Update existing records by ID — status, assignments, metadata |
 | `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 doctor` | Post-install health check (Python version, platform, FDA, MCP wiring) |
 | `fp uninstall` | Remove Footprinter — MCP entry, user data, package |
 
 Run `fp <command> --help` for full usage.
@@ -176,7 +182,7 @@ Run `fp <command> --help` for full usage.
 
 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.
+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 + access) — you decide what agents can see.
 
 ## Documentation
 
@@ -184,7 +190,7 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 - [Data Model](https://github.com/harringjohn/footprinter-cli/blob/main/reference/data-model.md) — database schema
 - [Pipeline](https://github.com/harringjohn/footprinter-cli/blob/main/reference/pipeline.md) — indexing stages and configuration
 - [Content Storage](https://github.com/harringjohn/footprinter-cli/blob/main/reference/content-storage.md) — metadata vs. snippet vs. full-content tiers
-- [Access Control](https://github.com/harringjohn/footprinter-cli/blob/main/reference/mcp-access-control.md) — MCP security model
+- [Permission Policies and Access Control](https://github.com/harringjohn/footprinter-cli/blob/main/reference/permission-policies-and-access-control.md) — permission policies and access control
 
 ## Contributing
 
@@ -194,7 +200,7 @@ Bug fixes, documentation, and tests welcome. For new features or architectural c
 
 ```bash
 git clone https://github.com/harringjohn/footprinter-cli.git
-cd footprinter
+cd footprinter-cli
 python3 -m venv venv
 ./venv/bin/pip install -e ".[dev]"
 ```

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

@@ -5,6 +5,12 @@
 
 **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/).**
 
+> ⚠️ **Install with `pipx`, not `pip`.** `pipx` puts the `fp` command on your PATH automatically; bare `pip` often doesn't — which leaves you with `fp: command not found` even though the install succeeded.
+
+```bash
+pipx install footprinter-cli
+```
+
 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.
 
 ## Install
@@ -21,7 +27,7 @@ Or install with **pipx** directly:
 pipx install footprinter-cli
 ```
 
-Either method gives you the `fp` command with the indexing pipeline, CLI, MCP server, and HTTP API. Optional extras add more:
+Either method installs three commands: `fp` (the CLI and indexing pipeline), `fp-mcp` (the MCP server for AI agents), and `fp-api` (the HTTP API). Optional extras add more:
 
 | Extra | What it adds |
 |-------|-------------|
@@ -46,6 +52,8 @@ To install with extras: use the [full install script](https://raw.githubusercont
 
 **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).
 
+**Apple Silicon (Rosetta):** If `fp doctor` warns about x86_64 Python on arm64 hardware, recreate the venv with a native interpreter: `pipx reinstall footprinter-cli --python /opt/homebrew/bin/python3`. This avoids compatibility issues with native-extension dependencies.
+
 </details>
 
 ### Uninstall
@@ -106,14 +114,12 @@ All commands use the `fp` entry point.
 | `fp status` | System health and data counts |
 | `fp search` | Search across all indexed sources |
 | `fp connect` | Manage optional integrations |
-| `fp mcp` | MCP server and access policies |
-| `fp api` | Start the HTTP API server |
+| `fp permission` | Manage access policies (visibility, permissions) |
 | `fp view` | Browse indexed data (files, folders, projects, clients, chats, emails, visits) |
-| `fp upsert` | Create/update records, assign relationships, or soft-delete via `--status removed` |
-| `fp data` | Export data, generate templates, or import metadata corrections |
+| `fp add` | Create new entity records or import from CSV |
+| `fp update` | Update existing records by ID — status, assignments, metadata |
 | `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 doctor` | Post-install health check (Python version, platform, FDA, MCP wiring) |
 | `fp uninstall` | Remove Footprinter — MCP entry, user data, package |
 
 Run `fp <command> --help` for full usage.
@@ -122,7 +128,7 @@ Run `fp <command> --help` for full usage.
 
 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.
+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 + access) — you decide what agents can see.
 
 ## Documentation
 
@@ -130,7 +136,7 @@ Sources are scanned into SQLite with bidirectional links connecting local files
 - [Data Model](https://github.com/harringjohn/footprinter-cli/blob/main/reference/data-model.md) — database schema
 - [Pipeline](https://github.com/harringjohn/footprinter-cli/blob/main/reference/pipeline.md) — indexing stages and configuration
 - [Content Storage](https://github.com/harringjohn/footprinter-cli/blob/main/reference/content-storage.md) — metadata vs. snippet vs. full-content tiers
-- [Access Control](https://github.com/harringjohn/footprinter-cli/blob/main/reference/mcp-access-control.md) — MCP security model
+- [Permission Policies and Access Control](https://github.com/harringjohn/footprinter-cli/blob/main/reference/permission-policies-and-access-control.md) — permission policies and access control
 
 ## Contributing
 
@@ -140,7 +146,7 @@ Bug fixes, documentation, and tests welcome. For new features or architectural c
 
 ```bash
 git clone https://github.com/harringjohn/footprinter-cli.git
-cd footprinter
+cd footprinter-cli
 python3 -m venv venv
 ./venv/bin/pip install -e ".[dev]"
 ```

{footprinter_cli-1.0.4 → footprinter_cli-1.1.0}/footprinter/access_stamper.py

@@ -2,7 +2,7 @@
 
 Maps a policy scope (e.g. "global", "project:3", "folder:~/Work/") to affected
 entity rows, calls the existing batch resolve functions, and writes resolved
-values back to mcp_view / mcp_read columns.
+values back to visibility / access columns.
 """
 
 from __future__ import annotations
@@ -45,8 +45,8 @@ def _is_inherit_source(source: str) -> bool:
 # ---------------------------------------------------------------------------
 # Each entry describes an entity type's table and capabilities.
 #   table:          SQL table name
-#   has_visibility: has mcp_view column
-#   has_permissions: has mcp_read column
+#   has_visibility: has visibility column
+#   has_permissions: has access column
 #   has_status:     has status column (filter WHERE status = 'listed')
 #   has_project_id: has project_id FK
 #   has_client_id:  has client_id FK
@@ -102,7 +102,7 @@ ENTITY_META: dict[str, dict[str, Any]] = {
         "has_project_id": False,
         "has_client_id": True,
         "has_account": False,
-        "path_column": "root_path",
+        "path_column": None,
     },
     "client": {
         "table": "clients",
@@ -305,31 +305,34 @@ def _get_ids_for_scope(conn: sqlite3.Connection, scope: str) -> dict[str, list[i
 
 
 def _write_back_visibility(conn: sqlite3.Connection, entity_type: str, results: dict[int, tuple]) -> None:
-    """Batch UPDATE mcp_view from resolve results.
+    """Batch UPDATE visibility and visibility_source from resolve results.
 
     Entities whose visibility comes from the global policy or the hardcoded
-    baseline are written as ``'inherit'`` — the MCP layer resolves them at
-    query time.  Entities with a specific policy get the resolved value.
+    baseline are written as ``'inherit'`` with ``visibility_source = NULL``.
+    Entities with a specific policy get the resolved value and source scope.
     """
     table = ENTITY_META[entity_type]["table"]
     conn.executemany(
-        f"UPDATE {table} SET mcp_view = ? WHERE id = ?",
-        [("inherit" if _is_inherit_source(source) else state, eid) for eid, (state, source) in results.items()],
+        f"UPDATE {table} SET visibility = ?, visibility_source = ? WHERE id = ?",
+        [
+            ("inherit", None, eid) if _is_inherit_source(source) else (state, source, eid)
+            for eid, (state, source) in results.items()
+        ],
     )
 
 
 def _write_back_permissions(conn: sqlite3.Connection, entity_type: str, results: dict[int, tuple]) -> None:
-    """Batch UPDATE mcp_read from resolve results.
+    """Batch UPDATE access and access_source from resolve results.
 
     Entities whose permission comes from the global policy or the hardcoded
-    baseline are written as ``'inherit'`` — the MCP layer resolves them at
-    query time.  Entities with a specific policy get the resolved value.
+    baseline are written as ``'inherit'`` with ``access_source = NULL``.
+    Entities with a specific policy get the resolved value and source scope.
     """
     table = ENTITY_META[entity_type]["table"]
     conn.executemany(
-        f"UPDATE {table} SET mcp_read = ? WHERE id = ?",
+        f"UPDATE {table} SET access = ?, access_source = ? WHERE id = ?",
         [
-            ("inherit" if _is_inherit_source(source) else ("allow" if allowed else "deny"), eid)
+            ("inherit", None, eid) if _is_inherit_source(source) else ("allow" if allowed else "deny", source, eid)
             for eid, (allowed, source) in results.items()
         ],
     )
@@ -350,18 +353,26 @@ def count_affected_entities(conn: sqlite3.Connection, scope: str) -> dict[str, i
     return {etype: len(ids) for etype, ids in _get_ids_for_scope(conn, scope).items() if ids}
 
 
-def stamp_entities(conn: sqlite3.Connection, ids_by_type: dict[str, list[int]]) -> dict[str, int]:
+def stamp_entities(
+    conn: sqlite3.Connection,
+    ids_by_type: dict[str, list[int]],
+    *,
+    commit: bool = True,
+) -> dict[str, int]:
     """Resolve and write visibility + permissions for the given entity IDs.
 
     Used by ``recalculate_access`` (full scope resolution) and the incremental
     pipeline path in ``processing.run_access_resolution``.  The batched variant
     (``recalculate_access_batched``) uses its own loop for per-chunk commits.
 
-    Always commits before returning, even when *ids_by_type* is empty.
+    Commits before returning by default, even when *ids_by_type* is empty.
+    When *commit* is False the caller is responsible for committing the
+    transaction.
 
     Args:
         conn: SQLite connection with row_factory = sqlite3.Row
         ids_by_type: Mapping of entity type to list of row IDs to stamp.
+        commit: If False, skip the final ``conn.commit()``.
 
     Returns:
         Dict mapping entity type to count of rows stamped.
@@ -384,22 +395,26 @@ def stamp_entities(conn: sqlite3.Connection, ids_by_type: dict[str, list[int]])
 
         stats[entity_type] = len(ids)
 
-    conn.commit()
+    if commit:
+        conn.commit()
     return stats
 
 
-def recalculate_access(conn: sqlite3.Connection, scope: str) -> dict[str, int]:
+def recalculate_access(
+    conn: sqlite3.Connection, scope: str, *, commit: bool = True,
+) -> dict[str, int]:
     """Recalculate visibility and permissions for all entities affected by *scope*.
 
     Args:
         conn: SQLite connection with row_factory = sqlite3.Row
         scope: Policy scope string (e.g. "global", "project:3", "folder:~/Work/")
+        commit: If False, skip committing — caller manages the transaction.
 
     Returns:
         Dict mapping entity type to count of rows updated.
     """
     ids_by_type = _get_ids_for_scope(conn, scope)
-    return stamp_entities(conn, ids_by_type)
+    return stamp_entities(conn, ids_by_type, commit=commit)
 
 
 def recalculate_access_batched(
@@ -408,18 +423,24 @@ def recalculate_access_batched(
     *,
     batch_size: int = 5000,
     on_batch: Callable[[int], None] | None = None,
+    commit: bool = True,
 ) -> dict[str, int]:
     """Recalculate visibility and permissions in batches with progress callback.
 
     Same semantics as ``recalculate_access()`` but commits after each batch
-    and calls *on_batch* with the count of entities processed per chunk.
-    Designed for large scopes where a progress bar is needed.
+    (when *commit* is True) and calls *on_batch* with the count of entities
+    processed per chunk.  Designed for large scopes where a progress bar is
+    needed.
 
     Args:
         conn: SQLite connection with row_factory = sqlite3.Row
         scope: Policy scope string (e.g. "global", "folder:~/Work/")
         batch_size: Number of entity IDs per chunk (default 5000)
         on_batch: Optional callback receiving the count processed per chunk
+        commit: If False, skip per-batch commits — all batches accumulate
+            in the caller's transaction.  This trades incremental commit
+            boundaries for atomicity; the caller is responsible for the
+            final commit.
 
     Returns:
         Dict mapping entity type to total count of rows updated.
@@ -443,7 +464,8 @@ def recalculate_access_batched(
                 perm_results = batch_resolve_permissions(conn, entity_type, chunk)
                 _write_back_permissions(conn, entity_type, perm_results)
 
-            conn.commit()
+            if commit:
+                conn.commit()
 
             if on_batch is not None:
                 on_batch(len(chunk))

footprinter_cli-1.1.0/footprinter/api/__init__.py

@@ -0,0 +1,19 @@
+"""Footprinter HTTP API — FastAPI routers calling the service layer."""
+
+import logging
+
+_logger = logging.getLogger(__name__)
+
+
+def _get_api_max_limit() -> int:
+    try:
+        from footprinter.source_registry import get_config
+
+        return get_config().get("limits", {}).get("api_max_limit", 200)
+    except Exception:
+        _logger.debug("Config unavailable for api_max_limit, using default 200")
+        return 200
+
+
+MAX_LIMIT = _get_api_max_limit()
+"""Upper bound for `limit` query params on HTTP list/search endpoints."""

footprinter_cli-1.1.0/footprinter/api/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as: python -m footprinter.api"""
+
+from footprinter.api.server import cli
+
+cli()

{footprinter_cli-1.0.4 → footprinter_cli-1.1.0}/footprinter/api/entities.py

@@ -137,7 +137,6 @@ def list_projects(
     include: Optional[str] = Query(None, description="Comma-separated includes"),
     status: Optional[str] = Query(None, description="Comma-separated status filter"),
     client: Optional[str] = None,
-    project_type: Optional[str] = None,
     limit: int = Query(50, ge=1, le=MAX_LIMIT),
     page: int = 1,
 ):
@@ -149,7 +148,6 @@ def list_projects(
         include=include_list,
         status=status_list,
         client=client,
-        project_type=project_type,
         limit=limit,
         page=page,
     )

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

@@ -1,10 +1,17 @@
 """Footprinter HTTP API — FastAPI app factory and server entry point."""
 
+from __future__ import annotations
+
+import argparse
+import sys
+
 from fastapi import FastAPI, Request
 from fastapi.responses import JSONResponse
 
 from footprinter.utils.exceptions import DatabaseNotInitializedError
 
+_LOOPBACK_HOSTS = {"127.0.0.1", "localhost", "::1"}
+
 
 def create_app() -> "FastAPI":
     """Create and configure the FastAPI application.
@@ -62,5 +69,40 @@ def main(host: str = "127.0.0.1", port: int = 8000) -> None:
     uvicorn.run(app, host=host, port=port)
 
 
+def cli(argv: list[str] | None = None) -> None:
+    """Console_script entry point — parse CLI args, validate host, start server."""
+    parser = argparse.ArgumentParser(
+        prog="fp-api",
+        description="Start the Footprinter HTTP API server.",
+    )
+    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 (no authentication!).",
+    )
+    args = parser.parse_args(argv)
+
+    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,
+        )
+
+    main(host=args.host, port=args.port)
+
+
 if __name__ == "__main__":
-    main()
+    cli()

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

@@ -33,7 +33,7 @@ exclusions:
     - ".*/\\.venv/.*"            # Python virtualenvs (hidden)
     - ".*/site-packages/.*"      # Python packages
     - ".*\\.pyc$"                # Python compiled files
-    - ".*/\\.vscode/extensions/.*"  # VS Code extensions (reinstallable)
+    - ".*/\\.vscode/.*"             # VS Code config and extensions
     - ".*/\\.npm/.*"             # npm cache
     - ".*/\\.nvm/.*"             # Node version manager
     - ".*/\\.cache/.*"           # Generic caches
@@ -44,6 +44,13 @@ exclusions:
     - ".*/\\.browser_state/.*"   # Playwright/Puppeteer browser state
     - ".*/\\.context/.*"         # IDE/agent context directories
     - ".*/\\.ai-dev/.*"          # AI dev tool scratch dirs
+    # Build output and tool config dot-folders (no archival value)
+    - ".*/\\.next/.*"             # Next.js build output
+    - ".*/\\.husky/.*"            # Git hooks manager
+    - ".*/\\.astro/.*"            # Astro build cache
+    - ".*/\\.githooks/.*"         # Custom git hooks
+    - ".*/\\.aesthetic/.*"        # Aesthetic tool config
+    - ".*/\\.users/.*"            # IDE user preferences
     # Home-level Claude dirs only (keep .claude within Work/Personal)
     - "^~/\\.claude/.*"           # Home-level .claude (includes session-env snapshots)
     - "^~/\\.claude-worktrees/.*" # Home-level .claude-worktrees
@@ -81,9 +88,6 @@ indexing:
   max_file_size_mb: 50      # MB; 0 = no size limit. 50 is generous for prose/docs.
   lookback_days: 14         # Browser history window (days back to index)
   content_snippets: false   # Extract file/email content previews for keyword search
-  # `fp ingest --preview` (FPR-1723) — pre-scan summary tuning
-  preview_top_n: 10                # rows shown for top files / top directories
-  preview_size_threshold_mb: 50    # files at or above this size are flagged as outliers
 
 # Semantic search — stores content as embeddings in a local ChromaDB database
 # Enables finding files and chats by meaning, not just keywords
@@ -91,6 +95,10 @@ indexing:
 semantic:
   file_vectorization: false
   chat_vectorization: false
+  # File statuses eligible for vectorization. Default: [listed].
+  # Add 'unlisted' to also embed hidden/dot-files.
+  # vectorize_statuses:
+  #   - listed
 
 # Vectorization — controls what gets embedded for semantic search
 # Requires semantic.file_vectorization: true to take effect for files
@@ -140,6 +148,21 @@ vectorization:
     - "**/.github/**"                       # GitHub workflow files (FTS-only)
     - "**/.ai-dev/**"                       # AI dev tool scratch dirs
 
+# Operational limits — tune for your data volume
+# All values have sensible defaults; omit the section entirely to use them.
+limits:
+  # Zip upload safety checks (chat imports via fp upload)
+  zip:
+    max_decompressed_size_mb: 2048    # 2 GB; raise for very large exports
+    max_entries: 10000                # Maximum files in a zip archive
+    max_compression_ratio: 100        # Ratio ceiling (100:1) for zip bomb detection
+  # HTTP API pagination cap — requires server restart to take effect
+  api_max_limit: 200
+  # MCP search result cap per source (protocol payload limit)
+  mcp_search_limit_cap: 200
+  # Embedding batch size for vector rebuild
+  vector_batch_size: 100
+
 # Source registry seeds — loaded into the sources table on init
 # Connector sources added by: fp connect install <name>
 source_seeds:
@@ -163,12 +186,3 @@ source_seeds:
     account: null
     label: "Chat"
     icon: message
-
-# Display labels for the group/project hierarchy
-# Customize these to match your organization's terminology
-domain:
-  labels:
-    group_singular: "Client"
-    group_plural: "Clients"
-    project_singular: "Project"
-    project_plural: "Projects"

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

@@ -39,7 +39,6 @@ def main(argv=None) -> None:
         epilog=(
             "getting started:\n"
             "  fp setup                   Run the configuration wizard\n"
-            "  fp setup --check           Validate existing configuration\n"
             "  fp connect list            Show available data source connectors\n"
             "\n"
             "data commands:\n"
@@ -57,13 +56,23 @@ def main(argv=None) -> None:
             "  fp view emails              List indexed emails\n"
             "  fp view visits              List browser history\n"
             "\n"
-            "servers:\n"
-            "  fp mcp                     Start the MCP server\n"
-            "  fp api                     Start the HTTP API server\n"
-            "  fp mcp check ~/Work/file   Check access resolution for a path\n"
+            "manage records:\n"
+            "  fp add client --name Acme   Create a new entity record\n"
+            "  fp update client 5 --name X Update an existing record by ID\n"
+            "  fp update file 42 --project-id 3  Assign a file to a project\n"
+            "  fp update files data.csv    Bulk update from CSV\n"
+            "\n"
+            "access control:\n"
+            "  fp permission list         Show all configured access policies\n"
+            "  fp permission set          Set visibility and/or access for a scope\n"
+            "  fp permission check        Check access resolution for a target\n"
+            "  fp permission reset        Remove policy (fall back to inheritance)\n"
+            "  fp permission recalculate  Re-resolve access stamps from the policy chain\n"
             "\n"
             "diagnostics:\n"
             "  fp doctor                  Check installation health\n"
+            "  fp doctor search           Rebuild FTS search indexes\n"
+            "  fp doctor semantic         Rebuild vector store\n"
             "\n"
             "cleanup:\n"
             "  fp uninstall               Remove Footprinter (MCP entry, data, package)\n"
@@ -81,35 +90,31 @@ def main(argv=None) -> None:
     subparsers.required = False
 
     from footprinter.cli import (
-        api_cmd,
+        add,
         connect,
-        data,
         delete,
         doctor,
         ingest,
-        mcp_cmd,
+        permission_cmd,
         search,
         setup,
         status,
         uninstall,
-        upsert,
-        vectorize,
+        update,
         view,
     )
 
     for mod in [
+        add,
         ingest,
-        mcp_cmd,
-        api_cmd,
+        permission_cmd,
         status,
         search,
         setup,
         connect,
         view,
-        upsert,
-        data,
+        update,
         delete,
-        vectorize,
         uninstall,
         doctor,
     ]:
@@ -128,7 +133,10 @@ def main(argv=None) -> None:
     from footprinter.cli._prompt import PromptCancelled
 
     try:
-        args.func(args)
+        # A handler may signal its exit status by returning an int; None means
+        # success. This complements the raise SystemExit(n) pattern used
+        # elsewhere — those bubble out before the wrapper here ever runs.
+        raise SystemExit(args.func(args) or 0)
     except _ConfigError as e:
         print(str(e), file=_sys.stderr)
         _sys.exit(1)