run402 4.93.2 → 4.95.0

package/core-dist/control-plane-session.js

@@ -10,6 +10,14 @@ export function getControlPlaneSessionPath() {
     return (process.env.RUN402_CONTROL_PLANE_SESSION_PATH ||
         join(getConfigBaseDir(), "control-plane-session.json"));
 }
+/**
+ * Read a wire grade. An unknown or absent value is treated as `device` (the
+ * read-only grade) so a cache the client cannot classify never claims more
+ * authority than the gateway will grant.
+ */
+function toGrade(raw) {
+    return raw === "browser" || raw === "loopback" || raw === "device" ? raw : "device";
+}
 /** Tighten 0600 if group/other-readable, warning once. Best-effort, POSIX-only. */
 function selfHealPermissions(p) {
     if (process.platform === "win32")
@@ -50,20 +58,20 @@ export function readControlPlaneSession(path) {
         return null;
     }
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error("control-plane-session.json must contain a JSON object. Delete it and run 'run402 operator login --loopback' to recreate it.");
+        throw new Error("control-plane-session.json must contain a JSON object. Delete it and run 'run402 login' to recreate it.");
     }
     const data = parsed;
     if (typeof data.control_plane_session_token !== "string" ||
         data.control_plane_session_token.length === 0) {
-        throw new Error("control-plane-session.json missing valid 'control_plane_session_token'. Run 'run402 operator login --loopback' to refresh it.");
+        throw new Error("control-plane-session.json missing valid 'control_plane_session_token'. Run 'run402 login' to refresh it.");
     }
     if (typeof data.expires_at !== "number" || !Number.isFinite(data.expires_at)) {
-        throw new Error("control-plane-session.json missing valid 'expires_at'. Run 'run402 operator login --loopback' to refresh it.");
+        throw new Error("control-plane-session.json missing valid 'expires_at'. Run 'run402 login' to refresh it.");
     }
     return {
         control_plane_session_token: data.control_plane_session_token,
         token_type: typeof data.token_type === "string" ? data.token_type : "Bearer",
-        provenance: typeof data.provenance === "string" ? data.provenance : "loopback_pkce",
+        grade: toGrade(data.grade),
         principal_id: typeof data.principal_id === "string" ? data.principal_id : "",
         amr: Array.isArray(data.amr) ? data.amr.filter((a) => typeof a === "string") : [],
         expires_at: data.expires_at,
@@ -79,7 +87,7 @@ export function saveControlPlaneSession(data, path) {
     renameSync(tmp, p);
     chmodSync(p, 0o600);
 }
-/** Delete the cached control-plane session — local half of `operator logout`. Idempotent. */
+/** Delete the cached sign-in session — local half of `run402 logout`. Idempotent. */
 export function clearControlPlaneSession(path) {
     const p = path ?? getControlPlaneSessionPath();
     try {
@@ -105,10 +113,27 @@ export function controlPlaneSessionFromTokenResponse(resp, nowMs = Date.now()) {
     return {
         control_plane_session_token: resp.control_plane_session_token,
         token_type: resp.token_type ?? "Bearer",
-        provenance: resp.provenance ?? "loopback_pkce",
+        grade: toGrade(resp.grade),
         principal_id: resp.principal_id ?? "",
         amr: Array.isArray(resp.amr) ? resp.amr.filter((a) => typeof a === "string") : [],
         expires_at: nowMs + (typeof resp.expires_in === "number" ? resp.expires_in : 0) * 1000,
     };
 }
+/**
+ * Delete the session caches of the retired email-scoped session
+ * (`{base}/operator-session.json`) and the retired approval cache file
+ * (`{base}/write-auth-session.json`). Neither is read any more; `run402 login`
+ * and `run402 logout` call this so a stale token does not linger on disk.
+ * Best-effort and idempotent.
+ */
+export function clearRetiredSessionCaches() {
+    for (const name of ["operator-session.json", "write-auth-session.json"]) {
+        try {
+            rmSync(join(getConfigBaseDir(), name), { force: true });
+        }
+        catch {
+            // Best-effort: a failed unlink never blocks login or logout.
+        }
+    }
+}
 //# sourceMappingURL=control-plane-session.js.map

package/core-dist/keystore.js

@@ -3,7 +3,7 @@ import { dirname, join } from "node:path";
 import { randomBytes } from "node:crypto";
 import { getLegacyProjectsPath, getProjectCredentialsPath } from "./config.js";
 import { clearActiveProjectId as clearProfileActiveProjectId, getActiveProjectId as getProfileActiveProjectId, recordMigration, setActiveProjectId as setProfileActiveProjectId, } from "./profile-state.js";
-import { readAllowance } from "./allowance.js";
+import { readWallet } from "./wallet.js";
 function withFileLock(path, fn, { retries = 200, delayMs = 20 } = {}) {
     const lockDir = path + ".lock";
     mkdirSync(dirname(path), { recursive: true });
@@ -99,7 +99,7 @@ function migrateLegacyProjectsJson(targetPath) {
         // Scoped the same way every other write in this module now is (see
         // `currentPrincipal`'s doc comment) — an unscoped write here is exactly
         // what poisons the "unknown"-principal bucket for good on a machine that
-        // migrates before its wallet allowance exists yet.
+        // migrates before its wallet exists yet.
         setProfileActiveProjectId(legacy.active_project_id, undefined, { principal: currentPrincipal() });
     }
     recordMigration("projects_json_import", {
@@ -174,7 +174,7 @@ export function removeProject(projectId, path) {
 }
 /**
  * The active-project scope's `principal`, derived from the CURRENT wallet's
- * allowance — matching exactly what `NodeCredentialsProvider.setActiveProject`
+ * wallet — matching exactly what `NodeCredentialsProvider.setActiveProject`
  * (sdk/src/node/credentials.ts) writes after `projects.provision` /
  * `projects.use`. Without this, every reader here used the profile-state
  * module's own default (empty) scope, which resolves to a FIXED
@@ -185,7 +185,7 @@ export function removeProject(projectId, path) {
  * `profile-state.ts#getActiveProjectId` happens to agree), but once the
  * "unknown" bucket is EVER populated by any principal-less write — the
  * one-time legacy `projects.json` migration below, or any provision/`use`
- * call made before this machine had a wallet allowance — it never gets
+ * call made before this machine had a wallet — it never gets
  * updated again (real wallet operations write to the principal-keyed
  * bucket, not "unknown") and PERMANENTLY shadows every later wallet-scoped
  * activation for every caller that reads through this module: `resolveProjectId`
@@ -197,13 +197,13 @@ export function removeProject(projectId, path) {
  * stale "unknown"-bucket entry first and never falls through to the
  * freshly-updated flat value.
  *
- * Best-effort: an unreadable/malformed allowance degrades to `null` (the
+ * Best-effort: an unreadable/malformed wallet degrades to `null` (the
  * "unknown" bucket callers tolerate), never a
- * throw — this is a read-scoping concern, not an allowance-validity one.
+ * throw — this is a read-scoping concern, not a wallet-validity one.
  */
 function currentPrincipal() {
     try {
-        return readAllowance()?.address ?? null;
+        return readWallet()?.address ?? null;
     }
     catch {
         return null;

package/core-dist/profiles.js

@@ -3,7 +3,7 @@
  *
  * A "wallet" is a whole config directory. The reserved `default` wallet lives
  * at the base config dir (zero migration for existing installs); every named
- * wallet lives under `{base}/profiles/<name>/` with its own `allowance.json`,
+ * wallet lives under `{base}/profiles/<name>/` with its own `wallet.json`,
  * `projects.json`, and this module's non-secret `meta.json`.
  *
  * Two levels of active state, mirroring the wallet → project model:
@@ -17,7 +17,7 @@
 import { readFileSync, writeFileSync, mkdirSync, renameSync, chmodSync, existsSync, readdirSync, rmSync, } from "node:fs";
 import { dirname, join } from "node:path";
 import { randomBytes } from "node:crypto";
-import { getConfigBaseDir, getProfilesDir, DEFAULT_PROFILE, isValidProfileName, } from "./config.js";
+import { getConfigBaseDir, getProfilesDir, DEFAULT_PROFILE, isValidProfileName, moveWalletFiles, WALLET_FILE_NAME, } from "./config.js";
 import { describeRejectedValue } from "./redact.js";
 function atomicWrite(p, content, mode) {
     const dir = dirname(p);
@@ -114,17 +114,19 @@ export function writeMeta(name, meta) {
     atomicWrite(metaPath(name), JSON.stringify(meta, null, 2), 0o600);
 }
 // --- enumeration + lifecycle ---
-/** True when a wallet's `allowance.json` exists on disk. */
+/** True when a wallet's `wallet.json` exists on disk. */
 export function profileExists(name) {
-    return existsSync(join(profileDir(name), "allowance.json"));
+    moveWalletFiles();
+    return existsSync(join(profileDir(name), WALLET_FILE_NAME));
 }
 /**
- * All wallet names on disk: `default` (only if a root allowance.json exists)
+ * All wallet names on disk: `default` (only if a root wallet.json exists)
  * plus every valid directory under `profiles/`.
  */
 export function listProfileNames() {
+    moveWalletFiles();
     const names = [];
-    if (existsSync(join(getConfigBaseDir(), "allowance.json"))) {
+    if (existsSync(join(getConfigBaseDir(), WALLET_FILE_NAME))) {
         names.push(DEFAULT_PROFILE);
     }
     try {
@@ -184,7 +186,7 @@ export function renameProfile(oldName, newName) {
             /* best-effort */
         }
         const base = getConfigBaseDir();
-        for (const f of ["allowance.json", "projects.json", "meta.json"]) {
+        for (const f of [WALLET_FILE_NAME, "projects.json", "meta.json"]) {
             const src = join(base, f);
             if (existsSync(src))
                 renameSync(src, join(dest, f));

package/core-dist/{allowance-auth.js → wallet-auth.js}

@@ -1,12 +1,12 @@
 /**
- * Allowance auth helper — generates SIWX (Sign-In With X / EIP-4361) headers for Run402 API.
+ * SIWX auth helper — generates SIWX (Sign-In With X / EIP-4361) headers for Run402 API.
  * Uses @noble/curves (lighter than viem) for signing.
  */
 import { randomBytes } from "node:crypto";
 import { secp256k1 } from "@noble/curves/secp256k1.js";
 import { keccak_256 } from "@noble/hashes/sha3.js";
 import { bytesToHex } from "@noble/hashes/utils.js";
-import { readAllowance } from "./allowance.js";
+import { readWallet } from "./wallet.js";
 import { getApiBase } from "./config.js";
 /**
  * EIP-55 mixed-case checksum encoding.
@@ -21,7 +21,7 @@ export function toChecksumAddress(address) {
     return checksummed;
 }
 /**
- * EIP-191 personal_sign: sign a message with the allowance's private key.
+ * EIP-191 personal_sign: sign a message with the wallet's private key.
  */
 function personalSign(privateKeyHex, address, message) {
     const msgBytes = new TextEncoder().encode(message);
@@ -86,11 +86,11 @@ export function formatSIWEMessage(opts, address) {
     return lines.join("\n");
 }
 export function buildSIWxAuthHeaders(opts) {
-    const message = formatSIWEMessage(opts, opts.allowance.address);
-    const signature = personalSign(opts.allowance.privateKey, opts.allowance.address, message);
+    const message = formatSIWEMessage(opts, opts.wallet.address);
+    const signature = personalSign(opts.wallet.privateKey, opts.wallet.address, message);
     const payload = {
         domain: opts.domain,
-        address: toChecksumAddress(opts.allowance.address),
+        address: toChecksumAddress(opts.wallet.address),
         statement: opts.statement,
         uri: opts.uri,
         version: opts.version ?? "1",
@@ -110,18 +110,18 @@ export function buildSIWxAuthHeaders(opts) {
 }
 /**
  * Get SIWX auth headers for the Run402 API.
- * Returns null if no allowance is configured.
+ * Returns null if no local wallet is configured.
  *
  * @param path - API path (e.g. "/projects/v1") used to build the SIWE uri field.
  */
-export function getAllowanceAuthHeaders(path, allowancePath) {
-    // readAllowance throws on a malformed-shape allowance file. The
-    // CLI's higher-level readAllowance wrapper surfaces this as a structured
-    // BAD_ALLOWANCE_FILE envelope; here we preserve the public contract that
+export function getWalletAuthHeaders(path, walletPath) {
+    // readWallet throws on a malformed-shape wallet file. The
+    // CLI's higher-level readWallet wrapper surfaces this as a structured
+    // BAD_WALLET_FILE envelope; here we preserve the public contract that
     // this helper returns SIWxAuthHeaders | null. Re-throw so callers above
     // the CLI's wrapper (e.g. SDK paid-fetch) can decide whether to swallow it.
-    const allowance = readAllowance(allowancePath);
-    if (!allowance || !allowance.address || !allowance.privateKey)
+    const localWallet = readWallet(walletPath);
+    if (!localWallet || !localWallet.address || !localWallet.privateKey)
         return null;
     const apiBase = getApiBase();
     const url = new URL(apiBase);
@@ -132,7 +132,7 @@ export function getAllowanceAuthHeaders(path, allowancePath) {
     const issuedAt = now.toISOString();
     const expirationTime = new Date(now.getTime() + 5 * 60 * 1000).toISOString();
     return buildSIWxAuthHeaders({
-        allowance,
+        wallet: localWallet,
         domain,
         uri,
         statement: "Sign in to Run402",
@@ -151,4 +151,4 @@ function messageChainId(chainId) {
 function payloadChainId(chainId) {
     return typeof chainId === "number" ? `eip155:${chainId}` : chainId;
 }
-//# sourceMappingURL=allowance-auth.js.map
+//# sourceMappingURL=wallet-auth.js.map

package/{sdk/core-dist/allowance.js → core-dist/wallet.js}

@@ -1,36 +1,36 @@
 import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync, renameSync, statSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { randomBytes } from "node:crypto";
-import { getAllowancePath } from "./config.js";
+import { getWalletPath } from "./config.js";
 // 0x-prefixed 40-hex EVM address.
 const ADDRESS_RE = /^0x[a-fA-F0-9]{40}$/;
 // 0x-prefixed 64-hex secp256k1 private key (32 bytes).
 const PRIVATE_KEY_RE = /^0x[a-fA-F0-9]{64}$/;
 /**
- * Load the agent allowance from disk.
+ * Load the agent wallet from disk.
  *
- * Returns `null` for the two "no allowance configured" cases:
+ * Returns `null` for the two "no local wallet configured" cases:
  *   - the file does not exist
  *   - the file exists but is not parseable JSON (preserve existing UX —
- *     consumers print "no_allowance" and tell the user to run init)
+ *     consumers print "no_wallet" and tell the user to run init)
  *
  * Throws a structured `Error` when the file parses as JSON but the
  * shape is wrong (missing/wrong-type/wrong-length fields). Without this guard
  * downstream callers crash with raw stack traces:
- *   - `cli/lib/status.mjs` reaches for `allowance.address.toLowerCase()`
+ *   - `cli/lib/status.mjs` reaches for `wallet.address.toLowerCase()`
  *     and crashes with `TypeError: Cannot read properties of undefined`.
- *   - `core/src/allowance-auth.ts` passes a malformed `privateKey` to
+ *   - `core/src/wallet-auth.ts` passes a malformed `privateKey` to
  *     `@noble/curves` which throws "expected 32 bytes, got N".
  *
- * The CLI's `cli/lib/config.mjs:readAllowance()` wrapper and the MCP
+ * The CLI's `cli/lib/config.mjs:readWallet()` wrapper and the MCP
  * `src/tools/{status,init}.ts` callers translate the throw into their own
- * structured envelopes (`code: BAD_ALLOWANCE_FILE`).
+ * structured envelopes (`code: BAD_WALLET_FILE`).
  */
 /**
- * If an allowance file is readable by group or other (any of the low 0o077
+ * If a wallet file is readable by group or other (any of the low 0o077
  * bits set), tighten it to 0600 and warn once on stderr. This self-heals the
  * historical case where a legacy world-readable `wallet.json` (mode 0644) was
- * migrated to `allowance.json` via a mode-preserving rename, leaving the
+ * migrated to `wallet.json` via a mode-preserving rename, leaving the
  * private key exposed on a shared machine. Best-effort: POSIX-only and silent
  * on platforms without meaningful Unix modes (e.g. Windows).
  */
@@ -48,8 +48,8 @@ function selfHealPermissions(p) {
         // Best-effort; never block a read on a chmod/stat failure.
     }
 }
-export function readAllowance(path) {
-    const p = path ?? getAllowancePath();
+export function readWallet(path) {
+    const p = path ?? getWalletPath();
     if (!existsSync(p))
         return null;
     selfHealPermissions(p);
@@ -66,31 +66,31 @@ export function readAllowance(path) {
     }
     catch {
         // Preserve historical UX — completely unparseable input reads as "no
-        // allowance configured" rather than as an error. Consumers already handle
+        // wallet configured" rather than as an error. Consumers already handle
         // null with a friendly "run 'run402 init'" message.
         return null;
     }
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error(`allowance.json must contain a JSON object (got ${Array.isArray(parsed) ? "array" : parsed === null ? "null" : typeof parsed}). Back up the file and run 'run402 init' to recreate it.`);
+        throw new Error(`wallet.json must contain a JSON object (got ${Array.isArray(parsed) ? "array" : parsed === null ? "null" : typeof parsed}). Back up the file and run 'run402 init' to recreate it.`);
     }
     const data = parsed;
     if (typeof data.address !== "string" || !ADDRESS_RE.test(data.address)) {
-        throw new Error("allowance.json missing valid 'address' (expected 0x-prefixed 40-hex string). " +
+        throw new Error("wallet.json missing valid 'address' (expected 0x-prefixed 40-hex string). " +
             "Back up the file and run 'run402 init' to recreate it.");
     }
     if (typeof data.privateKey !== "string" || !PRIVATE_KEY_RE.test(data.privateKey)) {
-        throw new Error("allowance.json missing valid 'privateKey' (expected 0x-prefixed 64-hex string). " +
+        throw new Error("wallet.json missing valid 'privateKey' (expected 0x-prefixed 64-hex string). " +
             "Back up the file and run 'run402 init' to recreate it.");
     }
     return data;
 }
-export function saveAllowance(data, path) {
-    const p = path ?? getAllowancePath();
+export function saveWallet(data, path) {
+    const p = path ?? getWalletPath();
     const dir = dirname(p);
     mkdirSync(dir, { recursive: true });
-    const tmp = join(dir, `.allowance.${randomBytes(4).toString("hex")}.tmp`);
+    const tmp = join(dir, `.wallet.${randomBytes(4).toString("hex")}.tmp`);
     writeFileSync(tmp, JSON.stringify(data, null, 2), { mode: 0o600 });
     renameSync(tmp, p);
     chmodSync(p, 0o600);
 }
-//# sourceMappingURL=allowance.js.map
+//# sourceMappingURL=wallet.js.map

package/{sdk/core-dist/write-auth-session.js → core-dist/write-approvals.js}

@@ -4,12 +4,12 @@ import { randomBytes, createHash } from "node:crypto";
 import { getConfigBaseDir } from "./config.js";
 const DEFAULT_TTL_MS = 30 * 60 * 1000;
 /**
- * Path to the approval cache: `{base}/write-auth-session.json`.
- * `RUN402_WRITE_AUTH_SESSION_PATH` overrides for testing.
+ * Path to the approval cache: `{base}/write-approvals.json`.
+ * `RUN402_WRITE_APPROVALS_PATH` overrides for testing.
  */
-export function getWriteAuthSessionPath() {
-    return (process.env.RUN402_WRITE_AUTH_SESSION_PATH ||
-        join(getConfigBaseDir(), "write-auth-session.json"));
+export function getWriteApprovalsPath() {
+    return (process.env.RUN402_WRITE_APPROVALS_PATH ||
+        join(getConfigBaseDir(), "write-approvals.json"));
 }
 /** Stable short hash binding an approval to a control-plane session token. */
 export function hashControlPlaneSession(token) {
@@ -34,8 +34,8 @@ function isApproval(x) {
     if (!x || typeof x !== "object")
         return false;
     const a = x;
-    return (typeof a.write_auth_token === "string" &&
-        a.write_auth_token.length > 0 &&
+    return (typeof a.write_approval_token === "string" &&
+        a.write_approval_token.length > 0 &&
         typeof a.action === "string" &&
         typeof a.api_origin === "string" &&
         typeof a.control_plane_session_hash === "string" &&
@@ -48,7 +48,7 @@ function isApproval(x) {
  * is wrong, so a corrupted cache surfaces a clear fix-it.
  */
 export function readApprovals(path) {
-    const p = path ?? getWriteAuthSessionPath();
+    const p = path ?? getWriteApprovalsPath();
     if (!existsSync(p))
         return [];
     selfHealPermissions(p);
@@ -67,19 +67,19 @@ export function readApprovals(path) {
         return [];
     }
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error("write-auth-session.json must contain a JSON object. Delete it and re-run 'run402 operator approve' to recreate it.");
+        throw new Error("write-approvals.json must contain a JSON object. Delete it and re-run 'run402 approve' to recreate it.");
     }
     const approvals = parsed.approvals;
     if (!Array.isArray(approvals)) {
-        throw new Error("write-auth-session.json missing an 'approvals' array. Delete it and re-run 'run402 operator approve'.");
+        throw new Error("write-approvals.json missing an 'approvals' array. Delete it and re-run 'run402 approve'.");
     }
     return approvals.filter(isApproval);
 }
 function writeApprovals(approvals, path) {
-    const p = path ?? getWriteAuthSessionPath();
+    const p = path ?? getWriteApprovalsPath();
     const dir = dirname(p);
     mkdirSync(dir, { recursive: true });
-    const tmp = join(dir, `.write-auth-session.${randomBytes(4).toString("hex")}.tmp`);
+    const tmp = join(dir, `.write-approvals.${randomBytes(4).toString("hex")}.tmp`);
     writeFileSync(tmp, JSON.stringify({ approvals }, null, 2), { mode: 0o600 });
     renameSync(tmp, p);
     chmodSync(p, 0o600);
@@ -103,9 +103,9 @@ export function saveApproval(approval, path) {
     existing.push(approval);
     writeApprovals(existing, path);
 }
-/** Delete the whole approval cache — local half of `operator logout`. Idempotent. */
+/** Delete the whole approval cache — local half of `run402 logout`. Idempotent. */
 export function clearApprovals(path) {
-    const p = path ?? getWriteAuthSessionPath();
+    const p = path ?? getWriteApprovalsPath();
     try {
         rmSync(p, { force: true });
     }
@@ -137,7 +137,7 @@ export function loadLiveApproval(q, path, nowMs = Date.now()) {
 }
 /** Parse a gateway-returned session expiry (ISO string or epoch) to epoch ms. */
 function sessionExpiryMs(session, nowMs) {
-    const raw = session?.expires_at ?? session?.absolute_expires_at;
+    const raw = session?.idle_expires_at ?? session?.expires_at ?? session?.absolute_expires_at;
     if (typeof raw === "number" && Number.isFinite(raw))
         return raw > 1e12 ? raw : raw * 1000;
     if (typeof raw === "string") {
@@ -157,9 +157,9 @@ export function approvalFromTokenResponse(resp, binding, nowMs = Date.now()) {
         ? resp.session.amr.filter((a) => typeof a === "string")
         : undefined;
     return {
-        write_auth_token: resp.write_auth_token,
-        token_type: typeof resp.token_type === "string" ? resp.token_type : "write_auth",
-        header: typeof resp.header === "string" ? resp.header : "X-Run402-Write-Auth",
+        write_approval_token: resp.write_approval_token,
+        token_type: typeof resp.token_type === "string" ? resp.token_type : "write_approval",
+        header: typeof resp.header === "string" ? resp.header : "X-Run402-Write-Approval",
         action: binding.action,
         ...(binding.target.org_id ? { org_id: binding.target.org_id } : {}),
         ...(binding.target.project_id ? { project_id: binding.target.project_id } : {}),
@@ -171,4 +171,4 @@ export function approvalFromTokenResponse(resp, binding, nowMs = Date.now()) {
         minted_at: nowMs,
     };
 }
-//# sourceMappingURL=write-auth-session.js.map
+//# sourceMappingURL=write-approvals.js.map

package/gitvault-surface.json

@@ -1,5 +1,5 @@
 {
-  "surface_version": "4.93.2",
+  "surface_version": "4.95.0",
   "verbs": [
     "repos create",
     "repos list",
@@ -26,7 +26,7 @@
   "retired_spellings": [
     {
       "spelling": "gitvault init",
-      "successor": "moved to `repos create --project <id>`"
+      "successor": "moved to `repos create --project <project_id>`"
     },
     {
       "spelling": "gitvault status",

package/lib/admin.mjs

@@ -17,12 +17,12 @@ Subcommands:
                                          (\`reactivated: true\` in the response).
                                          Replaces the v1.56 per-project pin.
 
-  archive [--project <id>] [--reason "..."]  Moderate-archive a single project. Sets
+  archive [--project <project_id>] [--reason "..."]  Moderate-archive a single project. Sets
                                          projects.archived_at = NOW(). Independent
                                          of organization lifecycle; the rest of the
                                          organization's projects keep serving.
 
-  reactivate [--project <id>]            Un-archive a project (flips archived_at
+  reactivate [--project <project_id>]            Un-archive a project (flips archived_at
                                          back to NULL). In v1.57 this no longer
                                          touches organization-level lifecycle — to
                                          reactivate a grace-state account, use
@@ -30,7 +30,7 @@ Subcommands:
                                          lease-perpetual above.
 
 Notes:
-  - All admin subcommands require platform-admin auth — the configured allowance
+  - All admin subcommands require platform-admin auth — the configured wallet
     wallet must be a platform admin, or an admin OAuth session cookie must be
     available. Regular project owners cannot run these.
   - Output is JSON.
@@ -65,7 +65,7 @@ Examples:
   archive: `run402 admin archive — Moderate-archive a single project
 
 Usage:
-  run402 admin archive [--project <id>] [--reason "..."]
+  run402 admin archive [--project <project_id>] [--reason "..."]
 
 Legacy (still supported):
   run402 admin archive <project_id> [--reason "..."]
@@ -87,7 +87,7 @@ Examples:
   reactivate: `run402 admin reactivate — Un-archive a project
 
 Usage:
-  run402 admin reactivate [--project <id>]
+  run402 admin reactivate [--project <project_id>]
 
 Legacy (still supported):
   run402 admin reactivate <project_id>
@@ -143,7 +143,7 @@ async function leasePerpetual(args) {
 }
 
 async function archive(args) {
-  // Canonical: --project <id>; legacy leading prj_... positional kept.
+  // Canonical: --project <project_id>; legacy leading prj_... positional kept.
   const { projectId, rest } = resolveProjectSelector(args, { valueFlags: FLAGS_BY_SUB.archive.values });
   let reason;
   for (let i = 0; i < rest.length; i++) {

package/lib/agent.mjs

@@ -1,4 +1,4 @@
-import { allowanceAuthHeaders } from "./config.mjs";
+import { walletAuthHeaders } from "./config.mjs";
 import { getSdk } from "./sdk.mjs";
 import { reportSdkError, fail } from "./sdk-errors.mjs";
 import { assertKnownFlags, flagValue, normalizeArgv, positionalArgs, validateWebhookUrl, failUnknownSubcommand } from "./argparse.mjs";
@@ -12,7 +12,7 @@ Usage:
   run402 agent passkey enroll
 
 Notes:
-  - Free with allowance auth
+  - Free with SIWX auth
   - Registers contact info so Run402 can reach your agent
   - Only name is required; email and webhook are optional
   - New or changed emails start reply verification
@@ -39,7 +39,7 @@ Options:
                       agent
 
 Notes:
-  - Free with allowance auth (run an 'allowance create' first)
+  - Free with SIWX auth (run 'run402 init' first)
   - Registers contact info so Run402 can reach your agent
   - New or changed emails start a reply challenge and return
     assurance_level without exposing the challenge secret
@@ -65,13 +65,15 @@ Usage:
 Sends or reuses a reply challenge for the active contact email. The challenge
 secret is emailed and never printed.
 `,
-  passkey: `run402 agent passkey — Manage operator passkey binding
+  passkey: `run402 agent passkey — Bind a passkey to the contact
 
 Usage:
   run402 agent passkey enroll
 
-Sends a short-lived Run402 operator passkey enrollment link to the verified
-contact email. Requires assurance_level=email_verified first.
+Sends a short-lived Run402 passkey enrollment link to the verified
+contact email. Requires assurance_level=email_verified first. A person
+signed in with 'run402 login' already has passkey assurance for a contact
+whose verified email their principal holds.
 `,
 };
 
@@ -93,12 +95,12 @@ async function contact(args) {
   if (!name) {
     fail({ code: "BAD_USAGE", message: "Missing --name <name>" });
   }
-  // validate webhook scheme locally BEFORE the allowance check so
-  // bad URLs fail fast even without an allowance configured. No-op when
+  // validate webhook scheme locally BEFORE the wallet check so
+  // bad URLs fail fast even without a wallet configured. No-op when
   // --webhook is omitted (it's optional).
   validateWebhookUrl(webhook, "--webhook");
-  // Preserve the aggressive early exit when no allowance is configured.
-  allowanceAuthHeaders("/agent/v1/contact");
+  // Preserve the aggressive early exit when no local wallet is configured.
+  walletAuthHeaders("/agent/v1/contact");
 
   try {
     const data = await getSdk().admin.setAgentContact({
@@ -119,20 +121,20 @@ async function status(args = []) {
   if (extra.length > 0) {
     fail({ code: "BAD_USAGE", message: `Unexpected argument for agent status: ${extra[0]}` });
   }
-  allowanceAuthHeaders("/agent/v1/contact/status");
+  walletAuthHeaders("/agent/v1/contact/status");
 
   try {
     const sdk = getSdk();
     const data = await sdk.admin.getAgentContactStatus();
     // v1.56: augment the response with email_verification.last_challenge from
-    // /agent/v1/operator/status so the operator sees per-attempt status
+    // /agent/v1/me/status so the reader sees per-attempt status
     // (trust_rejected with which verdicts, attempts remaining, hint) without
     // a second command. Best-effort — older gateways without the v1.55+ route
     // skip the augment silently.
     try {
-      const opStatus = await sdk.admin.getOperatorStatus();
-      if (opStatus && opStatus.email_verification) {
-        data.email_verification = opStatus.email_verification;
+      const meStatus = await sdk.me.status();
+      if (meStatus && meStatus.email_verification) {
+        data.email_verification = meStatus.email_verification;
       }
     } catch {
       // Older gateway — keep the original response shape.
@@ -150,7 +152,7 @@ async function verifyEmail(args = []) {
   if (extra.length > 0) {
     fail({ code: "BAD_USAGE", message: `Unexpected argument for agent verify-email: ${extra[0]}` });
   }
-  allowanceAuthHeaders("/agent/v1/contact/verify-email");
+  walletAuthHeaders("/agent/v1/contact/verify-email");
 
   try {
     const data = await getSdk().admin.verifyAgentContactEmail();
@@ -171,10 +173,10 @@ async function passkey(args) {
   if (action !== "enroll") {
     fail({ code: "BAD_USAGE", message: "Usage: run402 agent passkey enroll" });
   }
-  allowanceAuthHeaders("/agent/v1/contact/passkey/enroll");
+  walletAuthHeaders("/agent/v1/contact/passkey/enroll");
 
   try {
-    const data = await getSdk().admin.startOperatorPasskeyEnrollment();
+    const data = await getSdk().admin.startContactPasskeyEnrollment();
     console.log(JSON.stringify(data, null, 2));
   } catch (err) {
     reportSdkError(err);