Remove deprecated MCP and gateway aliases

resources/scripts/nap_install.py

@@ -617,12 +617,11 @@ def handle_gateway(args):
         print("  nap gateway vault process             Complete pending setup requests.")
         print("  nap gateway vault rotate-secret --kind chat|tabs|gateway|memory")
         return 0
-    if subcommand in {"vault", "vault-setup", "vault_setup", "project-vault"} and rest and rest[0] in {"help", "-h", "--help"}:
+    if subcommand == "vault" and rest and rest[0] in {"help", "-h", "--help"}:
         print("Usage: nap gateway vault [status|list|process|rotate-secret] [--kind chat|tabs|gateway|memory] [--all] [--project-id ID]")
         print("  status        Show configured/locked state and pending setup requests.")
         print("  process       Upload opaque client-wrapped key bundle records for backend-owned HashiCorp storage.")
         print("  rotate-secret Rotate one encrypted project secret.")
-        print("  vault-setup   Deprecated alias for vault.")
         return 0
     if subcommand == "start":
         return print_json(start_service("gateway", ["--no-browser", *rest])) or 0
@@ -634,7 +633,7 @@ def handle_gateway(args):
         return print_json(service_logs("gateway", rest)) or 0
     if subcommand in {"configure", "config"}:
         return run_wrapper("gateway", ["configure", *rest])
-    if subcommand in {"setup", "unlock", "lock", "restart", "kill", "vault", "vault-setup", "vault_setup", "project-vault", "terminal", "schedule", "service"}:
+    if subcommand in {"setup", "unlock", "lock", "restart", "kill", "vault", "terminal", "schedule", "service"}:
         return run_wrapper("gateway", [subcommand, *rest])
     raise RuntimeError("unknown gateway command; use nap gateway start|stop|configure|setup|unlock|lock|restart|kill|logs|status|vault|terminal|schedule|service")
 
@@ -697,10 +696,10 @@ def main(argv):
         print("Usage: nap [auth|project|gateway|agent|feedback|status|update|where|install]")
         print("  auth        Auth commands: login-local, status.")
         print("              Example: nap auth login-local")
-        print("  project     Project commands: create, status, encryption, encrypted, plaintext.")
+        print("  project     Project commands: create, status, encryption status, plaintext.")
-        print("              Examples: nap project create --encrypted, nap project encrypted, nap project plaintext")
+        print("              Examples: nap project create, nap project status, nap project encryption set plaintext")
-        print("              Project encryption uses a project passphrase; use --passphrase or NAPSEER_PROJECT_PASSPHRASE for automation.")
+        print("              Direct encrypted project enablement is disabled; use gateway vault setup flows.")
-        print("              Equivalent explicit form: nap project encryption set encrypted|plaintext")
+        print("              Equivalent explicit form: nap project encryption set plaintext")
         print("  gateway     Gateway commands: start, stop, configure, setup, unlock, lock, restart, kill, logs, status, vault.")
         print("              Start auto-selects a local port; use --port to pin one.")
         print("              Examples: nap gateway start, nap gateway vault, nap gateway vault rotate-secret --kind chat")

resources/scripts/napseer_mcp_server.py

@@ -49,6 +49,46 @@ import webbrowser
 from datetime import datetime, timedelta, timezone
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 
+DISCOVERY_VIEWS = {"paths", "summary", "metadata", "full"}
+ACTIVE_EXCLUDED_STATUSES = {
+    "completed",
+    "complete_verified_uncommitted",
+    "complete_pending_human_e2e",
+    "superseded",
+    "cancelled",
+    "archived",
+    "done",
+}
+KNOWN_LIFECYCLE_STATUSES = {
+    "active",
+    "archived",
+    "backlog",
+    "blocked",
+    "cancelled",
+    "completed",
+    "complete_pending_human_e2e",
+    "complete_verified_uncommitted",
+    "current",
+    "doing",
+    "done",
+    "draft",
+    "in_progress",
+    "pending",
+    "planned",
+    "review",
+    "reviewed_plan",
+    "superseded",
+    "todo",
+}
+SUMMARY_METADATA_KEYS = {
+    "/plans": ["status", "priority", "scope", "owner", "agent_owner", "implementation_allowed", "blocked_by"],
+    "/decisions": ["status", "date", "decision_category", "decision_area", "supersedes", "superseded_by"],
+    "/implementation-notes": ["status", "date", "repos", "verification_summary"],
+    "/reviews": ["status", "date", "severity_counts"],
+    "/rules": ["status", "scope", "source"],
+    "/tasks": ["status", "priority", "blocked_by", "owner", "assignee"],
+}
+
 from napseer_spake2 import (
     relay_aad,
     relay_context_hash,
@@ -359,8 +399,8 @@ PUBLIC_TOOLS = {
     "nap_gateway_unlock",
     "nap_gateway_lock",
     "nap_gateway_configure",
-    "nap_gateway_vault_setup_ls",
+    "nap_gateway_vault_ls",
-    "nap_gateway_vault_setup_process",
+    "nap_gateway_vault_process",
     "nap_gateway_vault_secret_rotate",
     "nap_gateway_restart",
     "nap_gateway_kill",
@@ -412,64 +452,6 @@ PUBLIC_TOOLS = {
     "nap_crontab_register_key",
     "nap_crontab_put",
 }
-OLD_TOOL_RENAMES = {
-    "napseer_auth_status": "nap_whoami",
-    "napseer_gateway_status": "nap_gateway_status",
-    "napseer_gateway_setup": "nap_gateway_setup",
-    "napseer_gateway_configure": "nap_gateway_configure",
-    "napseer_gateway_unlock": "nap_gateway_unlock",
-    "napseer_gateway_lock": "nap_gateway_lock",
-    "napseer_gateway_restart": "nap_gateway_restart",
-    "napseer_gateway_kill": "nap_gateway_kill",
-    "napseer_renew_auth": "nap_login",
-    "napseer_update_status": "nap_update_status",
-    "napseer_update_self": "nap_update_self",
-    "napseer_explore_tools": "nap_apropos",
-    "napseer_contract_profile": "nap_contract",
-    "napseer_acquire_lock": "nap_lock_acquire",
-    "napseer_renew_lock": "nap_lock_renew",
-    "napseer_release_lock": "nap_lock_release",
-    "napseer_list_locks": "nap_lock_ls",
-    "napseer_reindex_project": "nap_reindex_project",
-    "napseer_search_local": "nap_grep_local",
-    "napseer_index_status": "nap_index_status",
-    "napseer_clear_local_index": "nap_index_clear",
-    "napseer_search_memory": "nap_grep",
-    "napseer_get_memory_context": "nap_context",
-    "napseer_find_related_nodes": "nap_find_related",
-    "napseer_recent_memory": "nap_recent",
-    "napseer_list_folders": "nap_ls_folders",
-    "napseer_list_tags": "nap_ls_tags",
-    "napseer_move_node": "nap_mv",
-    "napseer_move_folder": "nap_mv_folder",
-    "napseer_bulk_upsert_nodes": "nap_bulk",
-    "napseer_create_project": "nap_project_create",
-    "napseer_create_node": "nap_create_node",
-    "napseer_upsert_node": "nap_tee",
-    "napseer_update_node_by_path": "nap_patch",
-    "napseer_get_node_edit": "nap_node_get",
-    "napseer_patch_node_guarded": "nap_node_patch",
-    "napseer_archive_node_by_path": "nap_rm",
-    "napseer_get_node_by_path": "nap_cat",
-    "napseer_link_nodes": "nap_ln",
-    "napseer_get_backlinks": "nap_backlinks",
-    "napseer_list_nodes": "nap_ls",
-    "napseer_list_agent_nodes": "nap_agent_ls",
-    "napseer_get_agent_node": "nap_agent_cat",
-    "napseer_upsert_agent_node": "nap_agent_tee",
-    "napseer_update_agent_node": "nap_agent_patch",
-    "napseer_archive_agent_node": "nap_agent_rm",
-    "napseer_link_agent_node": "nap_agent_ln",
-    "napseer_submit_feedback": "nap_feedback_submit",
-    "napseer_list_feedback": "nap_feedback_ls",
-    "napseer_admin_list_feedback": "nap_feedback_admin_ls",
-    "napseer_update_feedback_status": "nap_feedback_resolve",
-    "napseer_claim_account": "nap_claim_account",
-    "napseer_register_project_signing_key": "nap_crontab_register_key",
-    "napseer_create_signed_schedule": "nap_crontab_put",
-    "napseer_open_ui": "nap_ui_open",
-}
-NEW_TOOL_REPLACES = {new: old for old, new in OLD_TOOL_RENAMES.items()}
 VAULT_SCHEMA = "napseer.vault.v1"
 GATEWAY_RELAY_SECRET_SCHEMA = "napseer.gateway-relay-secret.v1"
 GATEWAY_RELAY_STATE_SCHEMA = "napseer.gateway-relay-state.v1"
@@ -3777,10 +3759,13 @@ def gateway_rotate_project_vault_secret(args=None):
     if current.get("secret_kind") != secret_kind:
         raise RuntimeError("active project secret is unavailable")
     account_id = current_account_id()
-    current_bundle = unwrap_project_key_bundle(current.get("wrapped_key_bundle"))
+    current_wrapped_bundle = current.get("wrapped_key_bundle")
+    current_bundle = unwrap_project_key_bundle(current_wrapped_bundle)
     wrapping_epoch = int(current.get("wrapping_epoch") or 0)
-    bundle_version = int(current.get("bundle_version") or 0) + 1
+    previous_bundle_version = int(current.get("bundle_version") or 0)
-    data_key_epoch = int(current.get("data_key_epoch") or 0) + 1
+    previous_data_key_epoch = int(current.get("data_key_epoch") or 0)
+    bundle_version = previous_bundle_version + 1
+    data_key_epoch = previous_data_key_epoch + 1
     if wrapping_epoch <= 0 or bundle_version <= 1 or data_key_epoch <= 1:
         raise RuntimeError("active project secret is unavailable")
     plaintext_bundle = generate_project_data_key_bundle(
@@ -3794,6 +3779,11 @@ def gateway_rotate_project_vault_secret(args=None):
         "POST",
         f"/v1/projects/{project_id}/vault/secrets/{urllib.parse.quote(secret_kind, safe='')}/rotate",
         {
+            "previous_wrapping_epoch": wrapping_epoch,
+            "previous_bundle_version": previous_bundle_version,
+            "previous_data_key_epoch": previous_data_key_epoch,
+            "previous_aad_hash": current_wrapped_bundle.get("aad_hash"),
+            "previous_ciphertext_sha256": current_wrapped_bundle.get("ciphertext_sha256"),
             "wrapped_key_bundle": wrapped_project_key_bundle_record(
                 project_id,
                 account_id,
@@ -3846,7 +3836,7 @@ def start_gateway_vault_setup_thread():
     if GATEWAY_VAULT_SETUP_THREAD_STARTED:
         return
     GATEWAY_VAULT_SETUP_THREAD_STARTED = True
-    threading.Thread(target=gateway_vault_setup_loop, name="napseer-gateway-vault-setup", daemon=True).start()
+    threading.Thread(target=gateway_vault_setup_loop, name="napseer-gateway-vault", daemon=True).start()
 
 
 def handle_gateway_relay_session(connect_request, listener_sock=None):
@@ -5045,6 +5035,188 @@ def filter_project_nodes(nodes):
     return [node for node in (nodes or []) if not is_agent_namespace_path(node.get("full_path") or "")]
 
 
+def as_bool(value, default=False):
+    if value is None:
+        return default
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, str):
+        normalized = value.strip().lower()
+        if normalized in {"1", "true", "yes", "on"}:
+            return True
+        if normalized in {"0", "false", "no", "off"}:
+            return False
+    return bool(value)
+
+
+def normalize_int(value, default, minimum, maximum):
+    try:
+        parsed = int(value)
+    except (TypeError, ValueError):
+        parsed = default
+    return max(minimum, min(parsed, maximum))
+
+
+def normalize_string_list(value):
+    if value in (None, ""):
+        return []
+    values = value if isinstance(value, list) else [value]
+    normalized = []
+    for item in values:
+        for part in str(item).split(","):
+            part = part.strip()
+            if part:
+                normalized.append(part)
+    return unique_preserve_order(normalized)
+
+
+def normalize_discovery_view(args, default="summary"):
+    requested = str(args.get("view") or "").strip().lower()
+    warnings = []
+    if requested:
+        if requested not in DISCOVERY_VIEWS:
+            raise RuntimeError("view must be paths, summary, metadata, or full")
+        return requested, warnings
+    if as_bool(args.get("include_content"), False):
+        return "full", warnings
+    return default, warnings
+
+
+def node_metadata(node):
+    metadata = node.get("metadata")
+    return metadata if isinstance(metadata, dict) else {}
+
+
+def node_status(node):
+    if node.get("status") not in (None, ""):
+        return str(node.get("status")).strip()
+    value = node_metadata(node).get("status")
+    if value in (None, "") and isinstance(node.get("metadata_summary"), dict):
+        value = node["metadata_summary"].get("status")
+    return str(value).strip() if value not in (None, "") else None
+
+
+def node_archived(node):
+    return bool(node.get("archived_at")) or node_status(node) == "archived"
+
+
+def status_filter_from_args(args):
+    statuses = normalize_string_list(args.get("status"))
+    excluded = normalize_string_list(args.get("exclude_status"))
+    active_only = as_bool(args.get("active_only"), False)
+    warnings = []
+    for status in statuses + excluded:
+        if status not in KNOWN_LIFECYCLE_STATUSES:
+            warnings.append(f"unknown metadata.status filter: {status}")
+    return {"status": statuses, "exclude_status": excluded, "active_only": active_only, "warnings": warnings}
+
+
+def apply_status_filters(nodes, filters):
+    items = []
+    status_set = set(filters.get("status") or [])
+    excluded = set(filters.get("exclude_status") or [])
+    if filters.get("active_only"):
+        excluded = excluded | ACTIVE_EXCLUDED_STATUSES
+    for node in nodes:
+        status = node_status(node)
+        if filters.get("active_only") and node_archived(node):
+            continue
+        if status_set and status not in status_set:
+            continue
+        if status and status in excluded:
+            continue
+        items.append(node)
+    return items
+
+
+def preview_text(value, limit):
+    text = re.sub(r"\s+", " ", str(value or "")).strip()
+    if len(text) <= limit:
+        return text
+    return text[: max(0, limit - 3)].rstrip() + "..."
+
+
+def metadata_summary(node):
+    metadata = node_metadata(node)
+    if not metadata and isinstance(node.get("metadata_summary"), dict):
+        return dict(node["metadata_summary"])
+    folder = node.get("folder_path") or ""
+    keys = []
+    for prefix, prefix_keys in SUMMARY_METADATA_KEYS.items():
+        if folder == prefix or folder.startswith(f"{prefix}/"):
+            keys.extend(prefix_keys)
+            break
+    keys.extend(["status", "date", "priority", "scope", "owner"])
+    return {key: metadata[key] for key in unique_preserve_order(keys) if key in metadata}
+
+
+def summarize_node(node, view="summary", preview_chars=240):
+    if view == "full":
+        return node
+    metadata = node_metadata(node)
+    status = node_status(node)
+    if view == "paths":
+        item = {
+            "full_path": node.get("full_path"),
+            "type": node.get("type"),
+            "status": status,
+            "updated_at": node.get("updated_at"),
+        }
+        if node_archived(node):
+            item["archived"] = True
+        return {key: value for key, value in item.items() if value not in (None, "")}
+
+    item = {
+        "id": node.get("id"),
+        "project_id": node.get("project_id"),
+        "full_path": node.get("full_path"),
+        "type": node.get("type"),
+        "name": node.get("name"),
+        "folder_path": node.get("folder_path"),
+        "tags": node.get("tags") or [],
+        "status": status,
+        "metadata_summary": metadata_summary(node),
+        "updated_at": node.get("updated_at"),
+        "links_count": len(node.get("links") or []) if isinstance(node.get("links"), list) else 0,
+        "archived": node_archived(node),
+    }
+    content = node.get("snippet") or node.get("preview") or node.get("content_text")
+    if content:
+        item["preview"] = preview_text(content, preview_chars)
+    for key in ("search_source", "matched_query", "matched_strategy", "indexed_at", "rank"):
+        if key in node:
+            item[key] = node[key]
+    if view == "metadata":
+        item["metadata"] = metadata
+    return {key: value for key, value in item.items() if value not in (None, "")}
+
+
+def discovery_envelope(project_id, items, args, *, view=None, next_cursor=None, has_more=None, diagnostics=None, query_analysis=None, warnings=None):
+    view = view or normalize_discovery_view(args)[0]
+    limit = normalize_int(args.get("limit"), 25, 1, 100 if view != "full" else 200)
+    preview_chars = normalize_int(args.get("preview_chars"), 240, 80, 1000)
+    summarized = [summarize_node(node, view=view, preview_chars=preview_chars) for node in items]
+    response = {
+        "ok": True,
+        "project_id": project_id,
+        "view": view,
+        "items": summarized,
+        "next_cursor": next_cursor,
+        "has_more": bool(has_more) if has_more is not None else bool(next_cursor),
+        "truncated": False,
+        "omitted_fields": [] if view == "full" else ["content_text"],
+        "budget": {"limit": limit, "max_limit": 100 if view != "full" else 200, "preview_chars": preview_chars},
+    }
+    if as_bool(args.get("verbose"), False):
+        if query_analysis is not None:
+            response["query_analysis"] = query_analysis
+        if diagnostics is not None:
+            response["diagnostics"] = diagnostics
+        if warnings:
+            response["warnings"] = warnings
+    return response
+
+
 def agent_slug_from_args(args):
     slug = str(args.get("agent_slug") or "").strip().strip("/")
     if not slug:
@@ -6596,7 +6768,7 @@ def cli_project_create(args):
     positionals = cli_positionals(args)
     slug = cli_option(args, "--slug", default=positionals[0] if positionals else default_project_slug())
     name = cli_option(args, "--name", default=default_project_name(slug))
-    encryption = cli_option(args, "--encryption", default="encrypted" if cli_flag(args, "--encrypted") else "plaintext")
+    encryption = cli_option(args, "--encryption", default="plaintext")
     payload = {
         "slug": slug,
         "name": name,
@@ -7150,12 +7322,18 @@ def get_backlinks_by_path(args):
 
 def list_project_nodes(args):
     project_id = resolve_project_id(args)
+    view, view_warnings = normalize_discovery_view(args)
+    filters = status_filter_from_args(args)
+    limit = normalize_int(args.get("limit"), 25, 1, 100 if view != "full" else 200)
     allowed = {"tag", "folder_path", "q", "limit", "cursor", "updated_before", "updated_after", "type", "include_archived", "archived_only"}
     base_query = {key: value for key, value in args.items() if key in allowed and value not in (None, "")}
+    base_query["limit"] = limit
+    if filters["active_only"]:
+        base_query["include_archived"] = False
+        base_query["archived_only"] = False
     raw_q = str(base_query.get("q") or "").strip()
     if raw_q and not base_query.get("cursor"):
         query_analysis = analyze_search_query(raw_q)
-        limit = max(1, min(int(base_query.get("limit", 50)), 200))
         collected = []
         diagnostics = {"server_queries": []}
         for server_query in server_search_queries(query_analysis):
@@ -7172,17 +7350,34 @@ def list_project_nodes(args):
                 node = dict(node)
                 node["matched_query"] = server_query
                 collected.append(node)
+        items = apply_status_filters(unique_nodes(collected), filters)[:limit]
         return {
-            "items": unique_nodes(collected)[:limit],
+            **discovery_envelope(
-            "query_analysis": query_analysis,
+                project_id,
-            "diagnostics": diagnostics,
+                items,
+                {**args, "limit": limit},
+                view=view,
+                diagnostics=diagnostics,
+                query_analysis=query_analysis,
+                warnings=view_warnings + filters["warnings"],
+            ),
         }
 
     query = urllib.parse.urlencode(base_query)
     suffix = f"?{query}" if query else ""
     result = request_json("GET", f"/v1/projects/{project_id}/nodes{suffix}")
-    result["items"] = decrypt_nodes_for_return(filter_project_nodes(result.get("items", [])), project_id=project_id)
+    items = decrypt_nodes_for_return(filter_project_nodes(result.get("items", [])), project_id=project_id)
-    return result
+    items = apply_status_filters(items, filters)
+    return discovery_envelope(
+        project_id,
+        items[:limit],
+        {**args, "limit": limit},
+        view=view,
+        next_cursor=result.get("next_cursor"),
+        has_more=bool(result.get("next_cursor")),
+        query_analysis=result.get("query_analysis"),
+        warnings=view_warnings + filters["warnings"],
+    )
 
 
 def list_folders(args):
@@ -7361,10 +7556,12 @@ def search_memory(args):
         raise RuntimeError("q is required")
     query_analysis = analyze_search_query(q)
     limit = max(1, min(int(args.get("limit", 25)), 100))
+    view, view_warnings = normalize_discovery_view(args)
+    filters = status_filter_from_args(args)
     mode = str(args.get("mode") or "hybrid").strip().lower()
     if mode not in {"hybrid", "server", "local"}:
         raise RuntimeError("mode must be hybrid, server, or local")
-    include_content = bool(args.get("include_content", False))
+    include_content = view == "full"
     encryption_state = project_encryption_state(project_id)
     collected = []
     sources = []
@@ -7405,10 +7602,11 @@ def search_memory(args):
         for server_query in server_search_queries(query_analysis):
             if len(unique_nodes(collected)) >= limit:
                 break
-            server = list_project_nodes({"q": server_query, "limit": remaining}).get("items", [])
+            server_args = {**args, "q": server_query, "limit": remaining, "view": view}
+            server = list_project_nodes(server_args).get("items", [])
             diagnostics["server_queries"].append({"q": server_query, "matched": len(server)})
             for node in server:
-                node = strip_node_content(node, include_content=include_content)
+                node = summarize_node(node, view=view) if view != "full" else node
                 node["search_source"] = "server"
                 node["matched_query"] = server_query
                 collected.append(node)
@@ -7416,30 +7614,33 @@ def search_memory(args):
                 sources.append("server")
             remaining = max(1, limit - len(unique_nodes(collected)))
 
-    items = unique_nodes(collected)[:limit]
+    items = apply_status_filters(unique_nodes(collected), filters)[:limit]
     if not items and query_analysis["is_long_query"]:
         diagnostics["hint"] = "Long natural-language query produced no matches; retry with quoted exact phrases or 2-5 distinctive nouns if the target memory exists."
-    return {
+    response = discovery_envelope(
-        "project_id": project_id,
+        project_id,
-        "query": q,
+        items,
-        "query_analysis": query_analysis,
+        {**args, "limit": limit},
-        "mode": mode,
+        view=view,
-        "encryption_state": encryption_state,
+        diagnostics=diagnostics,
-        "sources": sources,
+        query_analysis=query_analysis,
-        "diagnostics": diagnostics,
+        warnings=view_warnings + filters["warnings"],
-        "items": items,
+    )
-    }
+    response["query"] = q
+    response["mode"] = mode
+    response["encryption_state"] = encryption_state
+    response["sources"] = sources
+    return response
 
 
 def recent_memory(args):
     limit = max(1, min(int(args.get("limit", 25)), 100))
-    query = {"limit": limit}
+    view, _warnings = normalize_discovery_view(args)
+    query = {**args, "limit": limit, "view": view}
     for key in ["folder_path", "tag", "updated_before", "updated_after", "cursor"]:
         if args.get(key):
             query[key] = args[key]
-    result = list_project_nodes(query)
+    return list_project_nodes(query)
-    result["items"] = [strip_node_content(node, include_content=bool(args.get("include_content", False))) for node in result.get("items", [])]
-    return result
 
 
 def get_memory_context(args):
@@ -7448,7 +7649,8 @@ def get_memory_context(args):
         raise RuntimeError("path or paths is required")
     max_nodes = max(1, min(int(args.get("max_nodes", 20)), 100))
     depth = max(0, min(int(args.get("depth", 1)), 2))
-    include_content = bool(args.get("include_content", True))
+    default_view = "full" if as_bool(args.get("include_content"), True) and not args.get("view") else "summary"
+    view, _warnings = normalize_discovery_view(args, default=default_view)
     queue_paths = [normalize_node_path(path) for path in raw_paths]
     nodes = []
     edges = []
@@ -7464,7 +7666,7 @@ def get_memory_context(args):
                 node = get_node_by_path({"path": path}, allow_agent=is_agent_namespace_path(path))
             except Exception:
                 continue
-            nodes.append(strip_node_content(node, include_content=include_content))
+            nodes.append(summarize_node(node, view=view, preview_chars=normalize_int(args.get("preview_chars"), 240, 80, 1000)))
             links = node.get("links") if isinstance(node.get("links"), list) else []
             for link in links:
                 target_path = link.get("path") if isinstance(link, dict) else None
@@ -7484,12 +7686,12 @@ def get_memory_context(args):
                     pass
         queue_paths = next_paths
         current_depth += 1
-    return {"items": unique_nodes(nodes), "edges": edges[: max_nodes * 4]}
+    return {"items": unique_nodes(nodes), "edges": edges[: max_nodes * 4], "view": view}
 
 
 def find_related_nodes(args):
     path = args["path"]
-    include_content = bool(args.get("include_content", False))
+    view, _warnings = normalize_discovery_view(args)
     limit = max(1, min(int(args.get("limit", 25)), 100))
     target = get_node_by_path({"path": path}, allow_agent=is_agent_namespace_path(path))
     related = []
@@ -7505,12 +7707,13 @@ def find_related_nodes(args):
             except Exception:
                 pass
     for tag in target.get("tags") or []:
-        related.extend(list_project_nodes({"tag": tag, "limit": limit}).get("items", []))
+        related.extend(list_project_nodes({"tag": tag, "limit": limit, "view": view}).get("items", []))
     folder = target.get("folder_path")
     if folder:
-        related.extend(list_project_nodes({"folder_path": folder, "limit": limit}).get("items", []))
+        related.extend(list_project_nodes({"folder_path": folder, "limit": limit, "view": view}).get("items", []))
-    items = [strip_node_content(node, include_content=include_content) for node in unique_nodes(related) if node.get("full_path") != target.get("full_path")]
+    preview_chars = normalize_int(args.get("preview_chars"), 240, 80, 1000)
-    return {"target": strip_node_content(target, include_content=include_content), "items": items[:limit]}
+    items = [summarize_node(node, view=view, preview_chars=preview_chars) for node in unique_nodes(related) if node.get("full_path") != target.get("full_path")]
+    return {"target": summarize_node(target, view=view, preview_chars=preview_chars), "items": items[:limit], "view": view}
 
 
 def inbound_reference_plan(path):
@@ -8272,9 +8475,9 @@ def start_local_ui(args):
                 return gateway_setup(payload)
             if route == "/local-api/gateway/configure":
                 return gateway_tmux_configure(payload)
-            if route == "/local-api/gateway/vault-setup/list":
+            if route == "/local-api/gateway/vault/list":
                 return gateway_vault_setup_requests(payload)
-            if route == "/local-api/gateway/vault-setup/process":
+            if route == "/local-api/gateway/vault/process":
                 return gateway_process_vault_setup_requests(payload)
             if route == "/local-api/gateway/vault-secret/rotate":
                 return gateway_rotate_project_vault_secret(payload)
@@ -8648,7 +8851,7 @@ def raw_tools():
             },
         },
         {
-            "name": "nap_gateway_vault_setup_ls",
+            "name": "nap_gateway_vault_ls",
             "description": "List project vault setup requests assigned to this gateway worker. Does not reveal secret material.",
             "inputSchema": {
                 "type": "object",
@@ -8657,7 +8860,7 @@ def raw_tools():
             },
         },
         {
-            "name": "nap_gateway_vault_setup_process",
+            "name": "nap_gateway_vault_process",
             "description": "Complete pending project vault setup requests assigned to this unlocked gateway by uploading opaque client-wrapped key bundle records for backend-owned HashiCorp storage.",
             "inputSchema": {
                 "type": "object",
@@ -8864,23 +9067,37 @@ def raw_tools():
                     "q": {"type": "string", "description": "Search text. Natural language is accepted; distinctive nouns, paths, tags, or quoted phrases produce better matches than full instructions."},
                     "mode": {"type": "string", "enum": ["hybrid", "server", "local"], "default": "hybrid"},
                     "limit": {"type": "integer", "minimum": 1, "maximum": 100},
-                    "include_content": {"type": "boolean", "default": False},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "summary"},
+                    "include_content": {"type": "boolean", "default": False, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
+                    "active_only": {"type": "boolean", "default": False},
+                    "status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "exclude_status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "verbose": {"type": "boolean", "default": False},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
         },
         {
             "name": "nap_find",
-            "description": "Structured active memory search by folder, tag, path, or query.",
+            "description": "Structured active memory search by folder, tag, path, or query. Returns compact summaries by default; use view='full' or nap_cat for body text.",
             "inputSchema": {
                 "type": "object",
                 "properties": {
                     "folder_path": {"type": "string"},
                     "tag": {"type": "string"},
                     "q": {"type": "string"},
+                    "cursor": {"type": "string"},
                     "limit": {"type": "integer", "minimum": 1, "maximum": 100},
-                    "include_content": {"type": "boolean", "default": False},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "summary"},
+                    "include_content": {"type": "boolean", "default": False, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
                     "include_archived": {"type": "boolean", "default": False},
+                    "archived_only": {"type": "boolean", "default": False},
+                    "active_only": {"type": "boolean", "default": False},
+                    "status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "exclude_status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "verbose": {"type": "boolean", "default": False},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
@@ -8895,7 +9112,9 @@ def raw_tools():
                     "paths": {"type": "array", "items": {"type": "string"}},
                     "depth": {"type": "integer", "minimum": 0, "maximum": 2},
                     "max_nodes": {"type": "integer", "minimum": 1, "maximum": 100},
-                    "include_content": {"type": "boolean", "default": True},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "full"},
+                    "include_content": {"type": "boolean", "default": True, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
@@ -8919,7 +9138,9 @@ def raw_tools():
                 "properties": {
                     "path": {"type": "string"},
                     "limit": {"type": "integer", "minimum": 1, "maximum": 100},
-                    "include_content": {"type": "boolean", "default": False},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "summary"},
+                    "include_content": {"type": "boolean", "default": False, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
@@ -8936,7 +9157,13 @@ def raw_tools():
                     "updated_before": {"type": "string"},
                     "updated_after": {"type": "string"},
                     "limit": {"type": "integer", "minimum": 1, "maximum": 100},
-                    "include_content": {"type": "boolean", "default": False},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "summary"},
+                    "include_content": {"type": "boolean", "default": False, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
+                    "active_only": {"type": "boolean", "default": False},
+                    "status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "exclude_status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "verbose": {"type": "boolean", "default": False},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
@@ -9193,7 +9420,17 @@ def raw_tools():
                     "tag": {"type": "string"},
                     "folder_path": {"type": "string"},
                     "q": {"type": "string", "description": "Search phrase. Distinctive nouns, paths, tags, and quoted phrases work best; long sentences are decomposed automatically."},
-                    "limit": {"type": "integer", "minimum": 1, "maximum": 200},
+                    "cursor": {"type": "string"},
+                    "limit": {"type": "integer", "minimum": 1, "maximum": 100},
+                    "view": {"type": "string", "enum": ["paths", "summary", "metadata", "full"], "default": "summary"},
+                    "include_content": {"type": "boolean", "default": False, "description": "Legacy; use view='full' for body text. Ignored when view is set."},
+                    "include_archived": {"type": "boolean", "default": False},
+                    "archived_only": {"type": "boolean", "default": False},
+                    "active_only": {"type": "boolean", "default": False},
+                    "status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "exclude_status": {"oneOf": [{"type": "string"}, {"type": "array", "items": {"type": "string"}}]},
+                    "verbose": {"type": "boolean", "default": False},
+                    "preview_chars": {"type": "integer", "minimum": 80, "maximum": 1000, "default": 240},
                 },
                 "additionalProperties": False,
             },
@@ -9457,8 +9694,8 @@ TOOL_CATEGORIES = {
         "nap_gateway_status",
         "nap_gateway_setup",
         "nap_gateway_configure",
-        "nap_gateway_vault_setup_ls",
+        "nap_gateway_vault_ls",
-        "nap_gateway_vault_setup_process",
+        "nap_gateway_vault_process",
         "nap_gateway_vault_secret_rotate",
         "nap_gateway_unlock",
         "nap_gateway_restart",
@@ -9523,7 +9760,7 @@ LOCAL_FILE_TOOLS = {
     "nap_index_clear",
     "nap_gateway_setup",
     "nap_gateway_configure",
-    "nap_gateway_vault_setup_process",
+    "nap_gateway_vault_process",
     "nap_gateway_vault_secret_rotate",
     "nap_gateway_unlock",
     "nap_gateway_lock",
@@ -9588,7 +9825,7 @@ def tool_contract_metadata(name):
         "idempotency": "safe" if side_effect == "none" else "not-idempotent",
         "dangerous": side_effect in {"process-control", "terminal-control"} or name in SECRET_ACCEPTING_TOOLS,
         "dry_run_supported": dry_run_supported,
-        "replaces": NEW_TOOL_REPLACES.get(name),
+        "replaces": None,
         "requires_local": tool_auth_mode(name) != "public",
     }
 
@@ -9707,14 +9944,6 @@ def explore_tools(args):
 
 def man_tool(args):
     name = str(args.get("tool") or args.get("name") or "").strip()
-    if name in OLD_TOOL_RENAMES:
-        replacement = OLD_TOOL_RENAMES[name]
-        return {
-            "ok": False,
-            "tool": name,
-            "renamed_to": replacement,
-            "message": f"{name} was renamed to {replacement}; call {replacement} instead",
-        }
     for tool in tools():
         if tool["name"] == name:
             return tool_card(tool, include_schema=True)
@@ -9742,7 +9971,7 @@ def du_memory(args):
 
 def lint_memory(args):
     limit = max(1, min(int(args.get("limit", 200)), 500))
-    result = list_project_nodes({"limit": limit, "include_content": False})
+    result = list_project_nodes({"limit": limit, "view": "full"})
     warnings = []
     for node in result.get("items", []):
         for link in node.get("links") or []:
@@ -9772,8 +10001,6 @@ def doctor(args):
 
 def call_tool_impl(name, args):
     args = args or {}
-    if name in OLD_TOOL_RENAMES:
-        raise RuntimeError(f"{name} was renamed to {OLD_TOOL_RENAMES[name]}; call {OLD_TOOL_RENAMES[name]} instead")
     if name not in PUBLIC_TOOLS and name in PROTECTED_TOOLS:
         require_unlocked(name)
     if name == "nap_whoami":
@@ -9784,9 +10011,9 @@ def call_tool_impl(name, args):
         return gateway_setup(args)
     if name == "nap_gateway_configure":
         return mcp_gateway_configure(args)
-    if name == "nap_gateway_vault_setup_ls":
+    if name == "nap_gateway_vault_ls":
         return gateway_vault_setup_requests(args)
-    if name == "nap_gateway_vault_setup_process":
+    if name == "nap_gateway_vault_process":
         return gateway_process_vault_setup_requests(args)
     if name == "nap_gateway_vault_secret_rotate":
         return gateway_rotate_project_vault_secret(args)
@@ -10080,13 +10307,7 @@ def cli_main(argv):
         if subcommand in {"plaintext", "plain", "unencrypt", "decrypt", "disable-encryption"}:
             print(json.dumps(project_encryption_transition({"state": "plaintext"}), indent=2))
             return
-        if subcommand in {"encrypted", "encrypt", "enable-encryption"}:
+        print("Usage: napseer_mcp_server.py project [create [slug] [--name NAME] [--description TEXT] [--encryption plaintext] [--passphrase TEXT]|claim [--no-browser] [--timeout SECONDS] [--return-url URL]|status|encryption [status|set plaintext|plaintext] [--passphrase TEXT]|plaintext [--passphrase TEXT]]")
-            print(json.dumps(project_encryption_transition({
-                "state": "encrypted",
-                "passphrase": cli_option(argv[3:], "--passphrase", default=None),
-            }), indent=2))
-            return
-        print("Usage: napseer_mcp_server.py project [create [slug] [--name NAME] [--description TEXT] [--encrypted|--encryption plaintext|encrypted] [--passphrase TEXT]|claim [--no-browser] [--timeout SECONDS] [--return-url URL]|status|encryption [status|set plaintext|set encrypted|plaintext|encrypted] [--passphrase TEXT]|plaintext|encrypted [--passphrase TEXT]]")
         return
     if command == "gateway":
         subcommand = argv[2] if len(argv) > 2 else "status"
@@ -10219,7 +10440,7 @@ def cli_main(argv):
                 gateway_service_run(payload)
                 return
             raise RuntimeError("unknown gateway service action; use preregister|activate|run")
-        if subcommand in {"vault", "vault-setup", "vault_setup", "project-vault"}:
+        if subcommand == "vault":
             action = args[0] if args else "status"
             vault_args = args[1:] if args else []
             if action in {"help", "-h", "--help"}:

scripts/nap_install.py

@@ -617,12 +617,11 @@ def handle_gateway(args):
         print("  nap gateway vault process             Complete pending setup requests.")
         print("  nap gateway vault rotate-secret --kind chat|tabs|gateway|memory")
         return 0
-    if subcommand in {"vault", "vault-setup", "vault_setup", "project-vault"} and rest and rest[0] in {"help", "-h", "--help"}:
+    if subcommand == "vault" and rest and rest[0] in {"help", "-h", "--help"}:
         print("Usage: nap gateway vault [status|list|process|rotate-secret] [--kind chat|tabs|gateway|memory] [--all] [--project-id ID]")
         print("  status        Show configured/locked state and pending setup requests.")
         print("  process       Upload opaque client-wrapped key bundle records for backend-owned HashiCorp storage.")
         print("  rotate-secret Rotate one encrypted project secret.")
-        print("  vault-setup   Deprecated alias for vault.")
         return 0
     if subcommand == "start":
         return print_json(start_service("gateway", ["--no-browser", *rest])) or 0
@@ -634,7 +633,7 @@ def handle_gateway(args):
         return print_json(service_logs("gateway", rest)) or 0
     if subcommand in {"configure", "config"}:
         return run_wrapper("gateway", ["configure", *rest])
-    if subcommand in {"setup", "unlock", "lock", "restart", "kill", "vault", "vault-setup", "vault_setup", "project-vault", "terminal", "schedule", "service"}:
+    if subcommand in {"setup", "unlock", "lock", "restart", "kill", "vault", "terminal", "schedule", "service"}:
         return run_wrapper("gateway", [subcommand, *rest])
     raise RuntimeError("unknown gateway command; use nap gateway start|stop|configure|setup|unlock|lock|restart|kill|logs|status|vault|terminal|schedule|service")
 
@@ -697,10 +696,10 @@ def main(argv):
         print("Usage: nap [auth|project|gateway|agent|feedback|status|update|where|install]")
         print("  auth        Auth commands: login-local, status.")
         print("              Example: nap auth login-local")
-        print("  project     Project commands: create, status, encryption, encrypted, plaintext.")
+        print("  project     Project commands: create, status, encryption status, plaintext.")
-        print("              Examples: nap project create --encrypted, nap project encrypted, nap project plaintext")
+        print("              Examples: nap project create, nap project status, nap project encryption set plaintext")
-        print("              Project encryption uses a project passphrase; use --passphrase or NAPSEER_PROJECT_PASSPHRASE for automation.")
+        print("              Direct encrypted project enablement is disabled; use gateway vault setup flows.")
-        print("              Equivalent explicit form: nap project encryption set encrypted|plaintext")
+        print("              Equivalent explicit form: nap project encryption set plaintext")
         print("  gateway     Gateway commands: start, stop, configure, setup, unlock, lock, restart, kill, logs, status, vault.")
         print("              Start auto-selects a local port; use --port to pin one.")
         print("              Examples: nap gateway start, nap gateway vault, nap gateway vault rotate-secret --kind chat")

tests/test_gateway_vault_setup_payload.py

@@ -72,8 +72,16 @@ def run():
     assert "secret_b64" not in str(mod.VAULT_SECRETS)
 
     tools = {tool["name"]: tool for tool in mod.raw_tools()}
-    assert "transient secret_b64" not in tools["nap_gateway_vault_setup_process"]["description"]
+    assert "nap_gateway_vault_ls" in tools
-    assert "opaque client-wrapped key bundle records" in tools["nap_gateway_vault_setup_process"]["description"]
+    assert "nap_gateway_vault_process" in tools
+    assert "nap_gateway_vault_" + "setup_ls" not in tools
+    assert "nap_gateway_vault_" + "setup_process" not in tools
+    assert not [name for name in tools if name.startswith("napseer_")]
+    assert not [
+        tool for tool in mod.tools() if tool.get("napseer", {}).get("replaces")
+    ]
+    assert "transient secret_b64" not in tools["nap_gateway_vault_process"]["description"]
+    assert "opaque client-wrapped key bundle records" in tools["nap_gateway_vault_process"]["description"]
     assert "transient secret_b64" not in tools["nap_gateway_vault_secret_rotate"]["description"]
     assert "opaque client-wrapped key bundle record" in tools["nap_gateway_vault_secret_rotate"]["description"]
 
@@ -165,7 +173,19 @@ def run():
     assert calls[0][0] == "POST"
     assert calls[0][1] == f"/v1/projects/{PROJECT_ID}/vault/secrets/chat/rotate"
     assert calls[0][5] == "encryption"
-    assert set(calls[0][2]) == {"wrapped_key_bundle"}
+    assert set(calls[0][2]) == {
+        "previous_wrapping_epoch",
+        "previous_bundle_version",
+        "previous_data_key_epoch",
+        "previous_aad_hash",
+        "previous_ciphertext_sha256",
+        "wrapped_key_bundle",
+    }
+    assert calls[0][2]["previous_wrapping_epoch"] == 1
+    assert calls[0][2]["previous_bundle_version"] == 1
+    assert calls[0][2]["previous_data_key_epoch"] == 1
+    assert calls[0][2]["previous_aad_hash"] == active_bundle["aad_hash"]
+    assert calls[0][2]["previous_ciphertext_sha256"] == active_bundle["ciphertext_sha256"]
     assert_wrapped_record(mod, calls[0][2]["wrapped_key_bundle"], "chat", data_key_epoch=2)
     assert "secret_b64" not in str(calls[0][2])
     assert mod.VAULT_SECRETS == local_before

tests/test_mcp_memory_node_encryption.py

@@ -255,10 +255,53 @@ def run():
     moved["full_path"] = "/renamed/alpha"
     moved["folder_path"] = "/renamed"
     mod.request_json = lambda method, path, payload=None, **kwargs: {"items": [moved]}
-    listed = mod.list_project_nodes({"limit": 10})
+    listed = mod.list_project_nodes({"limit": 10, "include_content": True})
     assert listed["items"][0]["content_text"] == "secret needle"
     assert listed["items"][0]["metadata"] == {"private": "secret metadata"}
 
+    mod.request_json = lambda method, path, payload=None, **kwargs: {"items": [moved]}
+    compact = mod.list_project_nodes({"limit": 10})
+    assert compact["ok"] is True
+    assert compact["view"] == "summary"
+    assert "content_text" not in compact["items"][0]
+    assert compact["items"][0]["preview"] == "secret needle"
+    assert compact["items"][0]["metadata_summary"] == {}
+    full = mod.list_project_nodes({"limit": 10, "view": "full"})
+    assert full["items"][0]["content_text"] == "secret needle"
+
+    plan_base = {
+        "project_id": "project-1",
+        "folder_path": "/plans",
+        "name": "plan",
+        "type": "note",
+        "tags": ["plan"],
+        "links": [],
+        "content_text": "plan body",
+        "encryption_state": "legacy_plaintext",
+    }
+    active_nodes = [
+        {**plan_base, "id": "active", "full_path": "/plans/active", "metadata": {"status": "planned"}},
+        {**plan_base, "id": "done", "full_path": "/plans/done", "metadata": {"status": "completed"}},
+        {**plan_base, "id": "archived", "full_path": "/plans/archived", "metadata": {"status": "planned"}, "archived_at": "2026-05-06T00:00:00Z"},
+    ]
+    mod.request_json = lambda method, path, payload=None, **kwargs: {"items": active_nodes}
+    active = mod.list_project_nodes({"folder_path": "/plans", "active_only": True})
+    assert [item["full_path"] for item in active["items"]] == ["/plans/active"]
+    status_filtered = mod.list_project_nodes({"folder_path": "/plans", "status": ["completed"], "view": "paths"})
+    assert status_filtered["items"] == [{"full_path": "/plans/done", "type": "note", "status": "completed"}]
+
+    def search_response(method, path, payload=None, **kwargs):
+        assert "q=" in path
+        return {"items": [dict(moved)]}
+
+    mod.request_json = search_response
+    found = mod.list_project_nodes({"q": "secret needle", "limit": 5})
+    assert "query_analysis" not in found
+    assert "diagnostics" not in found
+    verbose_found = mod.list_project_nodes({"q": "secret needle", "limit": 5, "verbose": True})
+    assert "query_analysis" in verbose_found
+    assert "diagnostics" in verbose_found
+
     legacy_moved = encrypted_node(mod, full_path="/notes/legacy", content="old")
     legacy_moved["encrypted_content_envelope"].pop("aad_subject")
     legacy_moved["full_path"] = "/renamed/legacy"

tests/test_nap_install_gateway_routes.py

@@ -33,8 +33,12 @@ def run():
     assert mod.handle_gateway(["vault", "rotate-secret", "--kind", "chat"]) == 0
     assert calls[-1] == ("gateway", ["vault", "rotate-secret", "--kind", "chat"])
 
-    assert mod.handle_gateway(["vault-setup", "list"]) == 0
+    try:
-    assert calls[-1] == ("gateway", ["vault-setup", "list"])
+        mod.handle_gateway(["vault-setup", "list"])
+    except RuntimeError as exc:
+        assert "unknown gateway command" in str(exc)
+    else:
+        raise AssertionError("deprecated gateway vault-setup alias must not route")
 
     assert mod.handle_gateway(["terminal", "list"]) == 0
     assert calls[-1] == ("gateway", ["terminal", "list"])

tests/test_project_encryption_enable_payload.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
-"""Smoke-test project encryption enable payload generation."""
+"""Smoke-test project encryption enable fail-closed behavior."""
 
-import base64
 import importlib.util
 import pathlib
 import sys
@@ -17,6 +16,18 @@ def load_module():
     return module
 
 
+def assert_raises_hashicorp_closed(fn):
+    try:
+        fn()
+    except RuntimeError as exc:
+        message = str(exc)
+        assert "HashiCorp" in message
+        assert "disabled" in message
+        assert "setup-request" in message
+    else:
+        raise AssertionError("CLI direct project encryption enable must fail closed")
+
+
 def run():
     mod = load_module()
     calls = []
@@ -25,34 +36,28 @@ def run():
     mod.AUTH = {"agent_id": "agent-1"}
     mod.request_project_write = lambda method, path, body, project_id, purpose, scope_type="project": calls.append(
         (method, path, body, project_id, purpose, scope_type)
-    ) or {"state": "encrypted", "active_project_key_version": {"version": 1}}
+    ) or {"state": "plaintext"}
+    mod.create_project_with_state = lambda args: ({"id": "project-1"}, "created", "created")
     mod.save_auth = lambda payload: None
 
-    result = mod.project_encryption_transition({"state": "encrypted", "passphrase": "pw"})
+    assert_raises_hashicorp_closed(lambda: mod.project_encryption_transition({"state": "encrypted", "passphrase": "pw"}))
-    assert result["status"] == "updated"
+    assert calls == []
-    assert calls, "encryption enable should call backend"
+
-    method, path, body, project_id, purpose, scope_type = calls[0]
+    assert_raises_hashicorp_closed(lambda: mod.bootstrap_project({"encryption": "encrypted", "passphrase": "pw"}))
-    assert method == "POST"
+    assert calls == []
-    assert path == "/v1/projects/project-1/encryption/enable"
-    assert project_id == "project-1"
-    assert scope_type == "encryption"
-    assert body["state"] == "encrypted"
-    wrapped = body["wrapped_project_key"]
-    assert wrapped["credential_id"] == "local-passphrase:agent-1"
-    assert wrapped["wrap_alg"] == "AES-GCM-256"
-    assert wrapped["kdf_alg"] == "PBKDF2-SHA256"
-    assert wrapped["kdf_params"]["source"] == "local_passphrase"
-    assert wrapped["kdf_params"]["iterations"] == mod.PROJECT_KEY_KDF_ITERATIONS
-    assert len(base64.b64decode(wrapped["salt_b64"])) == 16
-    assert len(base64.b64decode(wrapped["kdf_params"]["nonce_b64"])) == 12
-    assert len(base64.b64decode(wrapped["wrapped_project_key_b64"])) == 48
 
-    calls.clear()
     result = mod.project_encryption_transition({"state": "plaintext"})
     assert result["status"] == "updated"
-    assert "wrapped_project_key" not in calls[0][2]
+    assert calls, "plaintext transition should still call backend"
+    method, path, body, project_id, purpose, scope_type = calls[0]
+    assert method == "POST"
+    assert path == "/v1/projects/project-1/encryption/disable"
+    assert project_id == "project-1"
+    assert scope_type == "encryption"
+    assert body == {"state": "plaintext"}
+    assert "wrapped" not in str(body)
 
-    print("ok: project encryption enable payload smoke passed")
+    print("ok: project encryption enable fail-closed smoke passed")
 
 
 if __name__ == "__main__":