code-context-control 2.57.1__py3-none-any.whl → 2.59.0__py3-none-any.whl

cli/c3.py

@@ -92,7 +92,7 @@ console = Console() if HAS_RICH else None
 # Config
 CONFIG_DIR = ".c3"
 CONFIG_FILE = ".c3/config.json"
-__version__ = "2.57.1"
+__version__ = "2.59.0"
 
 
 def _command_deps() -> CommandDeps:
@@ -248,7 +248,7 @@ _C3_MCP_ALLOW = [
     "mcp__c3__c3_memory", "mcp__c3__c3_validate", "mcp__c3__c3_edit",
     "mcp__c3__c3_agent", "mcp__c3__c3_delegate", "mcp__c3__c3_edits",
     "mcp__c3__c3_impact", "mcp__c3__c3_shell", "mcp__c3__c3_bitbucket",
-    "mcp__c3__c3_jira",
+    "mcp__c3__c3_jira", "mcp__c3__c3_credentials",
     "mcp__c3__c3_project", "mcp__c3__c3_task", "mcp__c3__c3_artifacts",
 ]
 
@@ -5738,6 +5738,150 @@ def _bb_cmd_set_default(args, project_path: str) -> None:
     print(f"[OK] Default repo: {args.project}/{args.repo}")
 
 
+def cmd_creds(args):
+    """Credential vault management (global + per-project scopes)."""
+    sub = getattr(args, "creds_cmd", None)
+    if not sub:
+        print("Usage: c3 creds {set,get,list,rm,import} [args]")
+        return
+
+    project_path = getattr(args, "project_path", ".") or "."
+
+    if sub == "set":
+        _creds_cmd_set(args, project_path)
+    elif sub == "get":
+        _creds_cmd_get(args, project_path)
+    elif sub == "list":
+        _creds_cmd_list(args, project_path)
+    elif sub == "rm":
+        _creds_cmd_rm(args, project_path)
+    elif sub == "import":
+        _creds_cmd_import(args, project_path)
+    else:
+        print(f"Unknown creds subcommand: {sub}")
+
+
+def _creds_scope(args) -> str:
+    return "global" if getattr(args, "use_global", False) else "project"
+
+
+def _creds_entry_line(name: str, entry: dict) -> str:
+    flags = [f for f in ("inject", "agent_readable") if entry.get(f)]
+    parts = [
+        f"{name:<24} {entry.get('scope', '?'):<8} {entry.get('type', 'token'):<10}"
+        f" len={entry.get('value_len', '?')}",
+    ]
+    if entry.get("env_var"):
+        parts.append(f"env_var={entry['env_var']}")
+    if flags:
+        parts.append("[" + ",".join(flags) + "]")
+    if entry.get("description"):
+        parts.append(f"-- {entry['description']}")
+    return "  ".join(parts)
+
+
+def _creds_cmd_set(args, project_path: str) -> None:
+    import getpass
+
+    from services import credential_store as cred_store
+
+    value = getattr(args, "value", "") or ""
+    if getattr(args, "stdin", False):
+        value = sys.stdin.read().rstrip("\n")
+    if not value:
+        value = getpass.getpass(f"Value for {args.name}: ")
+    if not value:
+        print("Cancelled -- value required.")
+        return
+    scope = _creds_scope(args)
+    try:
+        entry = cred_store.set_credential(
+            args.name, value,
+            scope=scope, project_path=project_path,
+            description=getattr(args, "desc", "") or "",
+            ctype=getattr(args, "ctype", "token") or "token",
+            env_var=getattr(args, "env_var", "") or "",
+            agent_readable=bool(getattr(args, "agent_readable", False)),
+            inject=bool(getattr(args, "inject", False)),
+        )
+    except (cred_store.CredentialError, RuntimeError) as exc:
+        print(f"[error] {exc}")
+        return
+    print(f"[OK] Stored credential '{args.name}' "
+          f"(scope={scope}, storage={entry['storage']}, len={entry['value_len']})")
+    if entry["agent_readable"]:
+        print("[warn] agent_readable=true -- the agent can read this value "
+              "into its context and transcripts.")
+
+
+def _creds_cmd_get(args, project_path: str) -> None:
+    from services import credential_store as cred_store
+
+    entry = cred_store.get_entry(args.name, project_path=project_path)
+    if not entry:
+        print(f"[error] no credential named '{args.name}'")
+        return
+    print(_creds_entry_line(args.name, entry))
+    print(f"storage={entry.get('storage', 'keyring')}  "
+          f"created={entry.get('created', '?')}  updated={entry.get('updated', '?')}")
+    fp = cred_store.fingerprint(args.name, project_path=project_path)
+    print(f"fingerprint={fp or 'unresolvable'}")
+    if getattr(args, "show", False):
+        value = cred_store.get_value(args.name, project_path=project_path)
+        print(value if value is not None else "[error] value missing from store")
+
+
+def _creds_cmd_list(args, project_path: str) -> None:
+    from services import credential_store as cred_store
+
+    entries = cred_store.list_entries(project_path)
+    if not entries:
+        print("No credentials registered. Use `c3 creds set NAME` "
+              "(add --global for all projects).")
+        return
+    print(f"{len(entries)} credential(s) — project scope shadows global:")
+    for name, entry in entries.items():
+        print("  " + _creds_entry_line(name, entry))
+
+
+def _creds_cmd_rm(args, project_path: str) -> None:
+    from services import credential_store as cred_store
+
+    scope = _creds_scope(args)
+    entry = cred_store.get_entry(args.name, project_path=project_path)
+    if entry and entry["scope"] == "global" and scope == "project":
+        print(f"[error] '{args.name}' is a global credential -- "
+              "re-run with --global to delete it.")
+        return
+    if cred_store.delete_credential(args.name, scope=scope, project_path=project_path):
+        print(f"[OK] Removed credential '{args.name}' (scope={scope})")
+    else:
+        print(f"[error] no credential named '{args.name}' in {scope} scope")
+
+
+def _creds_cmd_import(args, project_path: str) -> None:
+    from services import credential_store as cred_store
+
+    env_path = Path(getattr(args, "env_file", ""))
+    if not env_path.exists():
+        print(f"[error] file not found: {env_path}")
+        return
+    try:
+        text = env_path.read_text(encoding="utf-8")
+        result = cred_store.import_env(
+            text, scope=_creds_scope(args), project_path=project_path,
+            overwrite=bool(getattr(args, "overwrite", False)),
+        )
+    except (cred_store.CredentialError, RuntimeError) as exc:
+        print(f"[error] {exc}")
+        return
+    print(f"[OK] Imported {len(result['created'])} credential(s): "
+          f"{', '.join(result['created']) or '-'}")
+    if result["skipped"]:
+        print(f"Skipped {len(result['skipped'])}: {', '.join(result['skipped'])} "
+              "(use --overwrite to replace)")
+
+
 def cmd_jira(args):
     """Jira Cloud / Data Center credential + workspace management."""
     sub = getattr(args, "jira_cmd", None)
@@ -7036,6 +7180,7 @@ def main():
         "hub": cmd_hub,
         "bitbucket": cmd_bitbucket,
         "jira": cmd_jira,
+        "creds": cmd_creds,
         "oracle": cmd_oracle,
         "upgrade": cmd_upgrade,
     }

cli/commands/parser.py

@@ -401,6 +401,48 @@ def build_parser(version: str, parse_cli_ide_arg):
     jr_default.add_argument("--name", default="", help="Account name (defaults to the default account)")
     jr_default.add_argument("project_path", nargs="?", default=".")
 
+    # ── Credential vault (v2.58.0) ──────────────────────────────────────
+    p_creds = subparsers.add_parser(
+        "creds",
+        help="Credential vault — named secrets for agents (global + per-project)",
+    )
+    creds_subs = p_creds.add_subparsers(dest="creds_cmd")
+
+    cr_set = creds_subs.add_parser(
+        "set", help="Create or update a credential (value via hidden prompt)"
+    )
+    cr_set.add_argument("name", help="Entry name (env-var safe: [A-Za-z_][A-Za-z0-9_]*)")
+    cr_set.add_argument("--value", default="", help="Secret value (prompted via getpass if omitted — preferred)")
+    cr_set.add_argument("--stdin", action="store_true", help="Read the value from stdin (piped/multiline values)")
+    cr_set.add_argument("--type", dest="ctype", choices=["token", "env", "multiline"], default="token", help="Entry type")
+    cr_set.add_argument("--desc", default="", help="Human description shown in list/UI")
+    cr_set.add_argument("--env-var", default="", help="Env var name used at injection (default: entry name)")
+    cr_set.add_argument("--agent-readable", action="store_true", help="Allow the agent to reveal the decoded value into its context (default: injection-only)")
+    cr_set.add_argument("--inject", action="store_true", help="Auto-inject into every c3_shell run")
+    cr_set.add_argument("--global", dest="use_global", action="store_true", help="Store in the global scope (~/.c3) so every C3 project can use it")
+    # --path (not a trailing positional): a second positional after options
+    # breaks argparse on py<3.12 ("unrecognized arguments").
+    cr_set.add_argument("--path", dest="project_path", default=".", help="Project directory (default: current)")
+
+    cr_get = creds_subs.add_parser("get", help="Show entry metadata (masked; --show prints the value)")
+    cr_get.add_argument("name")
+    cr_get.add_argument("--show", action="store_true", help="Print the decoded value to the terminal")
+    cr_get.add_argument("--path", dest="project_path", default=".", help="Project directory (default: current)")
+
+    cr_list = creds_subs.add_parser("list", help="List credentials visible to this project")
+    cr_list.add_argument("--path", dest="project_path", default=".", help="Project directory (default: current)")
+
+    cr_rm = creds_subs.add_parser("rm", help="Delete a credential (value + registry entry)")
+    cr_rm.add_argument("name")
+    cr_rm.add_argument("--global", dest="use_global", action="store_true", help="Delete from the global scope")
+    cr_rm.add_argument("--path", dest="project_path", default=".", help="Project directory (default: current)")
+
+    cr_import = creds_subs.add_parser("import", help="Import KEY=VALUE lines from a .env file")
+    cr_import.add_argument("env_file", help="Path to the .env file")
+    cr_import.add_argument("--global", dest="use_global", action="store_true", help="Import into the global scope")
+    cr_import.add_argument("--overwrite", action="store_true", help="Replace entries already registered in the target scope")
+    cr_import.add_argument("--path", dest="project_path", default=".", help="Project directory (default: current)")
+
     # ── Oracle Discovery API (v2.32.0) ──────────────────────────────────
     p_oracle = subparsers.add_parser(
         "oracle",

cli/guide/tools.html

@@ -125,6 +125,7 @@
       <div class="sidebar-label">SCM</div>
       <a href="#c3_task" class="sidebar-link"><span class="icon">✅</span> c3_task</a>
       <a href="#c3_bitbucket" class="sidebar-link"><span class="icon">🪣</span> c3_bitbucket</a>
+      <a href="#c3_credentials" class="sidebar-link"><span class="icon">🔐</span> c3_credentials</a>
     </div>
     <div class="sidebar-section">
       <div class="sidebar-label">Cross-project</div>
@@ -161,6 +162,7 @@
         <a href="#c3_task" class="toc-item">c3_task <span class="cat">PM</span></a>
         <a href="#c3_artifacts" class="toc-item">c3_artifacts <span class="cat">Config</span></a>
         <a href="#c3_bitbucket" class="toc-item">c3_bitbucket <span class="cat">SCM</span></a>
+        <a href="#c3_credentials" class="toc-item">c3_credentials <span class="cat">Secrets</span></a>
         <a href="#c3_project"  class="toc-item">c3_project  <span class="cat">Multi-project</span></a>
       </div>
     </div>
@@ -1239,6 +1241,45 @@ c3_bitbucket(action=<span class="str">'merge_pr'</span>, pr_id=<span class="num"
           <p class="tool-desc"><strong>Audit trail:</strong> mutating actions (<code>merge_pr</code>, <code>create_branch</code>, <code>delete_branch</code>, webhook writes, etc.) are appended to the C3 edit ledger so the local audit log covers platform-side state changes too.</p>
         </div>
       </div>
+
+      <!-- c3_credentials -->
+      <div class="tool-card" id="c3_credentials">
+        <div class="tool-card-header">
+          <span class="tool-name">c3_credentials</span>
+          <div class="tag-row">
+            <span class="badge badge-purple">secrets</span>
+            <span class="badge">v2.58.0</span>
+          </div>
+          <span class="tool-tagline">Credential vault — the agent uses secrets by name, never by value</span>
+        </div>
+        <div class="tool-card-body">
+          <p class="tool-desc">A user-managed secret store, <strong>global</strong> (<code>~/.c3</code>, visible in every project) or <strong>per-project</strong> (<code>.c3</code>, shadows the same-named global). Values live in the OS keyring (service <code>c3-creds</code>; values over ~1KB in a Fernet-encrypted <code>.c3/secrets.enc</code> whose random master key is itself a keyring entry) — never in config files, and <em>never in the model's context</em>. <strong>Injection-first:</strong> the agent addresses secrets by name and C3 decodes them only at the subprocess boundary — <code>c3_shell(env_creds='A,B')</code> injects env vars, <code>{{cred:NAME}}</code> inside <code>cmd</code> expands server-side, and <code>inject</code>-flagged entries auto-inject into every shell run; echoed values are redacted back to <code>[cred:NAME]</code>. Resolution is <strong>realm-atomic</strong>: a project-registered name resolves in the project realm or not at all, so a hostile repo's committed config can never siphon your global values (tested).</p>
+
+          <h4>Actions</h4>
+          <table class="params-table">
+            <thead><tr><th>Action</th><th>Group</th><th>Description</th></tr></thead>
+            <tbody>
+              <tr><td class="param-name">list</td><td>Read</td><td class="param-desc">Merged registry (project shadows global) — names, scope, type, flags, usage. Never values</td></tr>
+              <tr><td class="param-name">describe</td><td>Read</td><td class="param-desc">Metadata + storage + live fingerprint (first 8 hex of SHA-256, computed on demand, never persisted)</td></tr>
+              <tr><td class="param-name">check</td><td>Read</td><td class="param-desc">Resolvability probe — does the stored value decode?</td></tr>
+              <tr><td class="param-name">set</td><td>Write</td><td class="param-desc">Create/replace an entry. <code>agent_readable</code> may be set at creation only — raising it on an existing entry is user-only</td></tr>
+              <tr><td class="param-name">delete</td><td>Write</td><td class="param-desc">Remove value + registry entry (owning scope inferred when omitted)</td></tr>
+              <tr><td class="param-name">reveal</td><td>Gated</td><td class="param-desc">The only value-returning action — refused unless the user enabled <code>agent_readable</code> on that entry</td></tr>
+            </tbody>
+          </table>
+
+          <h4>Examples</h4>
+          <pre><code><span class="com"># What can I use? (names and metadata only)</span>
+c3_credentials(action=<span class="str">'list'</span>)
+c3_credentials(action=<span class="str">'check'</span>, name=<span class="str">'NPM_TOKEN'</span>)
+
+<span class="com"># USE a secret without ever seeing it</span>
+c3_shell(cmd=<span class="str">'npm publish'</span>, env_creds=<span class="str">'NPM_TOKEN'</span>)
+c3_shell(cmd=<span class="str">'curl -H "Authorization: Bearer {{cred:API_KEY}}" https://api.example.com'</span>)</code></pre>
+
+          <p class="tool-desc"><strong>Surfaces:</strong> the <code>c3 creds</code> CLI (<code>set</code> / <code>get</code> / <code>list</code> / <code>rm</code> / <code>import .env</code>, <code>--global</code> for the shared scope), a per-project dashboard <strong>Credentials</strong> tab, and — since v2.59.0 — a top-level <strong>Credentials</strong> view in the Hub: a Global-vault manager plus a per-project browser with shadowing shown both ways ("shadows global" on project entries, "shadowed in N projects" on globals); the Hub's per-project drill panel manages too. No HTTP route ever returns a stored value (write-only wire contract, endpoint-sweep tested), every mutation is ledger-logged by name, the vault is hard-excluded from the Oracle Discovery API, and cross-project (<code>c3_project</code>) shells run with credentials disabled.</p>
+        </div>
+      </div>
     </div>
 
     <!-- ═══════════════════════════════════════ CROSS-PROJECT ═════ -->

cli/hub_server.py

@@ -333,6 +333,7 @@ _HUB_JS_FILES = [
     "hub_ui/components/session_drawer.js",
     "hub_ui/components/drill_panel.js",
     "hub_ui/components/drill_views.js",
+    "hub_ui/components/hub_credentials.js",
     "hub_ui/components/drill_subprojects.js",
     "hub_ui/components/drill_health.js",
     "hub_ui/components/drill_tasks.js",
@@ -437,8 +438,8 @@ def api_hub_config_set():
         cfg["projects_view"] = projects_view
     if "main_view" in data:
         main_view = str(data["main_view"]).strip().lower()
-        if main_view not in {"projects", "board"}:
-            return jsonify({"error": "main_view must be 'projects' or 'board'"}), 400
+        if main_view not in {"projects", "board", "creds"}:
+            return jsonify({"error": "main_view must be 'projects', 'board' or 'creds'"}), 400
         cfg["main_view"] = main_view
     if "oracle_url" in data:
         cfg["oracle_url"] = str(data["oracle_url"]).strip()
@@ -1773,6 +1774,276 @@ def api_projects_config_get():
                     "defaults": {k: _config_defaults(k) for k in _CONFIG_READ_SECTIONS}})
 
 
+# ── Credentials (hub) ────────────────────────────────────────────────────────
+# Write-only wire contract, hub edition: values go IN over POST and are never
+# returned by any hub route (no reveal exists here). `credentials` stays out of
+# _CONFIG_WRITE_SECTIONS — these dedicated routes are the only hub write path.
+
+_CRED_PUBLIC_FIELDS = ("scope", "type", "value_len", "env_var", "inject",
+                       "agent_readable", "description", "storage", "created",
+                       "updated")
+
+
+def _cred_entry_public(name, entry, *, usage=None, shadows_global=None):
+    """Explicit allowlist serializer — structurally cannot emit a value."""
+    rec = {"name": name}
+    for key in _CRED_PUBLIC_FIELDS:
+        rec[key] = entry.get(key, "")
+    rec["value_len"] = entry.get("value_len", 0)
+    rec["inject"] = bool(entry.get("inject"))
+    rec["agent_readable"] = bool(entry.get("agent_readable"))
+    if usage is not None:
+        rec["last_used"] = (usage.get(name) or {}).get("last_used", "")
+        rec["use_count"] = (usage.get(name) or {}).get("use_count", 0)
+    if shadows_global is not None:
+        rec["shadows_global"] = bool(shadows_global)
+    return rec
+
+
+def _resolve_cred_target(path: str, scope: str, *, mutation: bool):
+    """Resolve a credentials request target to (project, store_path, error).
+
+    scope='global' with no path targets the shared vault (~/.c3) directly;
+    project scope requires a registered path. Mutations on a path without a
+    .c3/ dir get 409 needs_init so the hub can't scatter .c3 dirs around."""
+    from services import credential_store as cred_store
+    if scope not in ("project", "global"):
+        return None, "", (jsonify({"error": "scope must be 'project' or 'global'"}), 400)
+    if not path:
+        if scope == "project":
+            return None, "", (jsonify({"error": "path is required for project scope"}), 400)
+        home = cred_store.global_base()
+        if home is None:
+            return None, "", (jsonify({"error": "global scope unresolvable (no home dir)"}), 500)
+        return None, str(home), None
+    try:
+        resolved = _resolve_project_path(path)
+    except ValueError as e:
+        return None, "", (jsonify({"error": str(e)}), 404)
+    if mutation and not (resolved / ".c3").is_dir():
+        return None, "", (jsonify({"error": "not initialized", "needs_init": True}), 409)
+    return resolved, str(resolved), None
+
+
+def _hub_cred_audit(action: str, name: str, scope: str, project) -> None:
+    """Names only — never values. Failure-safe. Project mutations audit to the
+    target project's ActivityLog + EditLedger; global-scope mutations also land
+    in ~/.c3/activity_log.jsonl so the shared vault keeps its own trail."""
+    if project is not None:
+        try:
+            from services.activity_log import ActivityLog
+            ActivityLog(str(project)).log("cred_action", {
+                "kind": "creds", "action": action, "name": name,
+                "scope": scope, "via": "hub",
+            })
+        except Exception:
+            pass
+        try:
+            from services.edit_ledger import EditLedger
+            EditLedger(str(project)).log_edit(
+                file=f"cred://{name}", change_type=f"cred_{action}",
+                summary=f"{action} {name} ({scope}) via Hub",
+                tags=["creds", action],
+                detail={"kind": "creds", "action": action, "name": name,
+                        "scope": scope},
+            )
+        except Exception:
+            pass
+    if scope == "global" or project is None:
+        try:
+            from services import credential_store as cred_store
+            from services.activity_log import ActivityLog
+            home = cred_store.global_base()
+            if home is not None:
+                ActivityLog(str(home)).log("cred_action", {
+                    "kind": "creds", "action": action, "name": name,
+                    "scope": scope, "via": "hub",
+                })
+        except Exception:
+            pass
+
+
+@app.route("/api/projects/credentials", methods=["GET"])
+def api_projects_credentials():
+    """Masked credential registry for a project (global entries + project
+    shadows). Values never transit the hub outbound — the allowlist serializer
+    returns metadata, usage and shadow info only."""
+    path = (request.args.get("path") or "").strip()
+    if not path:
+        return jsonify({"error": "path is required"}), 400
+    try:
+        resolved = _resolve_project_path(path)
+    except ValueError as e:
+        return jsonify({"error": str(e)}), 404
+    from services import credential_store as cred_store
+    usage = cred_store.read_usage_state(str(resolved))
+    home = cred_store.global_base()
+    global_names = set(cred_store.list_entries(str(home))) if home else set()
+    entries = []
+    for name, entry in cred_store.list_entries(str(resolved)).items():
+        entries.append(_cred_entry_public(
+            name, entry, usage=usage,
+            shadows_global=(entry.get("scope") == "project"
+                            and name in global_names)))
+    return jsonify({"path": str(resolved), "entries": entries})
+
+
+@app.route("/api/projects/credentials", methods=["POST"])
+def api_projects_credentials_set():
+    """Create/update an entry from the hub. `value` optional — metadata-only
+    update when absent, touching ONLY the keys present in the payload; a
+    submitted value is stored and never echoed back. scope='global' with no
+    `path` targets the shared vault directly."""
+    from services import credential_store as cred_store
+    data = request.get_json(force=True) or {}
+    name = str(data.get("name") or "").strip()
+    scope = str(data.get("scope") or "project").strip().lower()
+    project, store_path, err = _resolve_cred_target(
+        str(data.get("path") or "").strip(), scope, mutation=True)
+    if err:
+        return err
+    value = str(data.get("value") or "")
+    ctype = str(data.get("type") or data.get("ctype") or "token")
+    try:
+        if value:
+            entry = cred_store.set_credential(
+                name, value, scope=scope, project_path=store_path, ctype=ctype,
+                description=str(data.get("description") or ""),
+                env_var=str(data.get("env_var") or ""),
+                agent_readable=bool(data.get("agent_readable")),
+                inject=bool(data.get("inject")))
+        else:
+            # Metadata-only update: touch ONLY the keys present in the payload
+            # so a single-field toggle can't clobber the others.
+            fields = {}
+            for key in ("description", "env_var"):
+                if key in data:
+                    fields[key] = str(data[key] or "")
+            for key in ("agent_readable", "inject"):
+                if key in data:
+                    fields[key] = bool(data[key])
+            if "type" in data or "ctype" in data:
+                fields["type"] = ctype
+            entry = cred_store.update_metadata(
+                name, scope=scope, project_path=store_path, **fields)
+    except cred_store.CredentialError as exc:
+        return jsonify({"error": str(exc)}), 400
+    except RuntimeError as exc:
+        return jsonify({"error": str(exc)}), 500
+    _hub_cred_audit("set" if value else "update", name, scope, project)
+    return jsonify({"entry": _cred_entry_public(name, {**entry, "scope": scope})})
+
+
+@app.route("/api/projects/credentials/import", methods=["POST"])
+def api_projects_credentials_import():
+    """Import KEY=VALUE lines (.env paste). Values are stored, never echoed."""
+    from services import credential_store as cred_store
+    data = request.get_json(force=True) or {}
+    scope = str(data.get("scope") or "project").strip().lower()
+    project, store_path, err = _resolve_cred_target(
+        str(data.get("path") or "").strip(), scope, mutation=True)
+    if err:
+        return err
+    try:
+        result = cred_store.import_env(
+            str(data.get("text") or ""), scope=scope, project_path=store_path,
+            overwrite=bool(data.get("overwrite")))
+    except cred_store.CredentialError as exc:
+        return jsonify({"error": str(exc)}), 400
+    except RuntimeError as exc:
+        return jsonify({"error": str(exc)}), 500
+    for created in result["created"]:
+        _hub_cred_audit("set", created, scope, project)
+    return jsonify(result)
+
+
+@app.route("/api/projects/credentials/<name>", methods=["DELETE"])
+def api_projects_credentials_delete(name):
+    """Delete an entry (value + registry). Scope inferred from the owning
+    realm when omitted."""
+    from services import credential_store as cred_store
+    scope = str(request.args.get("scope") or "").strip().lower()
+    path = str(request.args.get("path") or "").strip()
+    project, store_path, err = _resolve_cred_target(
+        path, scope or ("project" if path else "global"), mutation=True)
+    if err:
+        return err
+    if not scope:
+        entry = cred_store.get_entry(name, project_path=store_path)
+        scope = (entry.get("scope") or "project") if entry else \
+            ("project" if path else "global")
+    try:
+        removed = cred_store.delete_credential(
+            name, scope=scope, project_path=store_path)
+    except cred_store.CredentialError as exc:
+        return jsonify({"error": str(exc)}), 400
+    if removed:
+        _hub_cred_audit("delete", name, scope, project)
+    return jsonify({"removed": bool(removed), "scope": scope})
+
+
+@app.route("/api/projects/credentials/<name>/check", methods=["POST"])
+def api_projects_credentials_check(name):
+    """Resolvability probe — returns a fingerprint, never the value."""
+    from services import credential_store as cred_store
+    data = request.get_json(silent=True) or {}
+    path = str(data.get("path") or "").strip()
+    project, store_path, err = _resolve_cred_target(
+        path, "project" if path else "global", mutation=False)
+    if err:
+        return err
+    entry = cred_store.get_entry(name, project_path=store_path)
+    if not entry:
+        return jsonify({"error": f"no credential named '{name}'"}), 404
+    return jsonify({
+        "name": name,
+        "scope": entry["scope"],
+        "storage": entry.get("storage", "keyring"),
+        "resolvable": cred_store.get_value(name, project_path=store_path) is not None,
+        "fingerprint": cred_store.fingerprint(name, project_path=store_path),
+    })
+
+
+@app.route("/api/hub/credentials/overview", methods=["GET"])
+def api_hub_credentials_overview():
+    """Cross-project credential inventory: the global vault plus each
+    registered project's project-scoped entries, with shadow info both ways.
+    Metadata only — the allowlist serializer structurally cannot emit a value."""
+    from services import credential_store as cred_store
+    home = cred_store.global_base()
+    global_entries = cred_store.list_entries(str(home)) if home else {}
+    shadowed_in = {name: [] for name in global_entries}
+    projects_out = []
+    for p in _pm().list_projects():
+        ppath = str(p.get("path") or "")
+        row = {"name": p.get("name") or "", "path": ppath,
+               "initialized": True, "error": None, "entries": []}
+        try:
+            if not (Path(ppath) / ".c3").is_dir():
+                row["initialized"] = False
+            else:
+                usage = cred_store.read_usage_state(ppath)
+                for name, entry in cred_store.list_entries(ppath).items():
+                    if entry.get("scope") != "project":
+                        continue
+                    row["entries"].append(_cred_entry_public(
+                        name, entry, usage=usage,
+                        shadows_global=name in global_entries))
+                    if name in shadowed_in:
+                        shadowed_in[name].append(
+                            {"name": row["name"], "path": ppath})
+        except Exception as e:  # per-row isolation, like /api/search/global
+            row["error"] = str(e)
+        projects_out.append(row)
+    global_usage = cred_store.read_usage_state(str(home)) if home else {}
+    global_out = [
+        {**_cred_entry_public(name, entry, usage=global_usage),
+         "shadowed_in": shadowed_in.get(name, [])}
+        for name, entry in global_entries.items()
+    ]
+    return jsonify({"global": {"entries": global_out}, "projects": projects_out})
+
+
 @app.route("/api/projects/config", methods=["PUT"])
 def api_projects_config_put():
     """Whitelisted section write: deep-merge, atomic replace, audited on the target."""

cli/hub_ui/app.js

@@ -17,7 +17,7 @@ function App() {
   const [version, setVersion] = useState('');
   const [projects, setProjects] = useState([]);
   const [loaded, setLoaded] = useState(false);
-  const [mainView, setMainView] = useState('projects'); // projects | board
+  const [mainView, setMainView] = useState('projects'); // projects | board | creds
   const [filter, setFilter] = useState('all');          // all | active | idle | tag:<x>
   const [search, setSearch] = useState('');
   const [view, setView] = useState('list');             // list | grid
@@ -44,7 +44,7 @@ function App() {
       if (cfg.projects_view === 'grid') setView('grid');
       if (cfg.sidebar_collapsed != null) setSidebarCollapsed(!!cfg.sidebar_collapsed);
       if (cfg.sidebar_group) setFilter(cfg.sidebar_group);
-      if (cfg.main_view === 'board') setMainView('board');
+      if (cfg.main_view === 'board' || cfg.main_view === 'creds') setMainView(cfg.main_view);
     } catch { }
     try { const v = await api.get('/api/version'); setVersion(v.c3_version || ''); } catch { }
   }, []);
@@ -112,6 +112,8 @@ function App() {
         }}>
           {mainView === 'board' ? (
             <TaskBoard projects={projects} onOpenDrill={openDrill} />
+          ) : mainView === 'creds' ? (
+            <HubCredentials projects={projects} onOpenDrill={openDrill} />
           ) : (
             <React.Fragment>
               <SummaryBar projects={projects} search={search} setSearch={setSearch}

cli/hub_ui/components/drill_panel.js

@@ -13,6 +13,7 @@ const DRILL_PANEL_TABS = [
   ['sessions', 'Sessions'],
   ['health', 'Health'],
   ['budget', 'Budget'],
+  ['creds', 'Credentials'],
   ['config', 'Config'],
   ['mcp', 'MCP'],
 ];
@@ -132,6 +133,7 @@ function DrillPanel({ project, tab, setTab, onClose, onChanged, onOpenModal, pro
       case 'sessions': return <DrillSessions project={project} />;
       case 'health': return <DrillHealth project={project} onChanged={onChanged} />;
       case 'budget': return <DrillBudget project={project} />;
+      case 'creds': return <DrillCredentials project={project} />;
       case 'config': return <ConfigEditor project={project} />;
       case 'mcp': return <McpManager project={project} onChanged={onChanged} />;
       default: return <DrillOverview project={project} onChanged={onChanged} setTab={setTab} />;

cli/hub_ui/components/drill_views.js

@@ -282,7 +282,13 @@ function DrillLedger({ project }) {
   );
 }
 
-// ── Sessions ───────────────────────────────────────────────────
+// ── Credentials ────────────────────────────────────────────────
+// Full management via the shared CredsManager (hub_credentials.js).
+// Write-only wire: values are submitted inbound-only and never returned.
+function DrillCredentials({ project }) {
+  return <CredsManager path={project.path} projectName={project.name} />;
+}
+
 function DrillSessions({ project }) {
   const [data, setData] = useState(null);
   const [needsInit, setNeedsInit] = useState(false);