@astrasyncai/verification-gateway 5.10.0 → 5.12.0

package/dist/cursor/extension.mjs

@@ -1,3 +1,7 @@
+// src/cursor/extension.ts
+import { homedir as homedir3 } from "os";
+import { join as join3 } from "path";
+
 // src/adapter-interface/interface.ts
 var ADAPTER_INTERFACE_VERSION = 1;
 
@@ -3965,7 +3969,7 @@ function getTrustLevel(score) {
 }
 
 // src/version.ts
-var SDK_VERSION = "5.10.0";
+var SDK_VERSION = "5.12.0";
 
 // src/http.ts
 var SDK_USER_AGENT = `astrasync-sdk/${SDK_VERSION}`;
@@ -3992,6 +3996,14 @@ function getCachedWellKnownUrls(apiBaseUrl) {
   return cache.get(apiBaseUrl)?.data;
 }
 
+// src/failure-posture.ts
+var REJECTED_IDENTITY_DIMENSIONS = /* @__PURE__ */ new Set([
+  "identity.invalid_agent_id",
+  "identity.unknown_agent",
+  "agent.lookup"
+]);
+var UNKNOWN_AGENT_GUIDANCE = "Register your agent with AstraSync (or, inside an MCP host, add the AstraSync MCP connector for keyless, human-approved registration), then present the canonical ASTRA-* id issued after owner approval.";
+
 // src/verify.ts
 var DEFAULT_CONFIG = {
   apiBaseUrl: "https://astrasync.ai/api",
@@ -4203,11 +4215,44 @@ function createGuidanceResponse(_config, reason, options = {}) {
     // coercing the absent recommendation to a policy 'deny'. Misconfig is
     // deterministic and intentionally NOT marked retryable.
     ...isApiError && { retryable: true },
+    ...options.httpStatus !== void 0 && { httpStatus: options.httpStatus },
+    ...options.retryAfterMs !== void 0 && { retryAfterMs: options.retryAfterMs },
     correlationId: options.correlationId,
     attemptId: options.attemptId,
     verifiedAt: /* @__PURE__ */ new Date()
   };
 }
+async function readJsonSafe(response) {
+  try {
+    const parsed = await response.json();
+    return parsed && typeof parsed === "object" ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function rejectedIdentityGuidance(failures) {
+  const f = failures?.find((x) => REJECTED_IDENTITY_DIMENSIONS.has(x.dimension));
+  if (!f) return void 0;
+  if (f.dimension === "agent.lookup") {
+    return `The presented agent identifier is not registered with AstraSync. ${UNKNOWN_AGENT_GUIDANCE}`;
+  }
+  return f.guidance ? `${f.message} ${f.guidance}` : f.message;
+}
+var MAX_RETRY_AFTER_MS = 15 * 60 * 1e3;
+function parseRetryAfterMs(response) {
+  const raw = response.headers?.get?.("retry-after");
+  if (!raw) return void 0;
+  const trimmed = raw.trim();
+  let ms;
+  if (/^\d+(\.\d+)?$/.test(trimmed)) {
+    ms = Number(trimmed) * 1e3;
+  } else {
+    const at = Date.parse(trimmed);
+    if (Number.isNaN(at)) return void 0;
+    ms = at - Date.now();
+  }
+  return Math.min(MAX_RETRY_AFTER_MS, Math.max(0, Math.round(ms)));
+}
 async function callVerifyAccessAPI(config, request) {
   const { credentials, ...requestData } = request;
   const body = {
@@ -4264,7 +4309,8 @@ async function callVerifyAccessAPI(config, request) {
       body: JSON.stringify(body),
       signal: AbortSignal.timeout(config.verifyTimeoutMs ?? 1e4)
     });
-    const data = await response.json();
+    const data = await readJsonSafe(response);
+    const retryAfterMs = parseRetryAfterMs(response);
     if (response.status === 410) {
       return {
         success: true,
@@ -4302,6 +4348,23 @@ async function callVerifyAccessAPI(config, request) {
         }
       };
     }
+    if (response.status === 404 && credentials.astraId && (data?.error === "AGENT_NOT_FOUND" || typeof data?.message === "string" && /agent/i.test(data.message))) {
+      return {
+        success: true,
+        attemptId: typeof data?.attemptId === "string" ? data.attemptId : void 0,
+        access: {
+          allowed: false,
+          reason: "unknown_agent",
+          failures: [
+            {
+              dimension: "identity.unknown_agent",
+              message: "The presented agent identifier is not registered with AstraSync.",
+              guidance: UNKNOWN_AGENT_GUIDANCE
+            }
+          ]
+        }
+      };
+    }
     if (!response.ok) {
       if (response.status === 401) {
         return {
@@ -4316,9 +4379,11 @@ async function callVerifyAccessAPI(config, request) {
       }
       return {
         success: false,
-        error: data.message || data.error || `API returned ${response.status}`,
+        error: typeof data?.message === "string" && data.message || typeof data?.error === "string" && data.error || `API returned ${response.status}`,
         correlationId: typeof data?.correlationId === "string" ? data.correlationId : void 0,
-        attemptId: typeof data?.attemptId === "string" ? data.attemptId : void 0
+        attemptId: typeof data?.attemptId === "string" ? data.attemptId : void 0,
+        httpStatus: response.status,
+        ...retryAfterMs !== void 0 && { retryAfterMs }
       };
     }
     return data;
@@ -4390,12 +4455,14 @@ async function verify(config, request, options) {
       correlationId: apiResponse.correlationId,
       attemptId: apiResponse.attemptId,
       remediation: apiResponse.remediation,
+      httpStatus: apiResponse.httpStatus,
+      retryAfterMs: apiResponse.retryAfterMs,
       urls
     });
   }
   if (!apiResponse.access?.allowed) {
     const aggregatedFailures = apiResponse.access?.failures;
-    const idVerifiedFromBackend = apiResponse.verificationContext?.idVerified === true;
+    const idVerifiedFromBackend = apiResponse.verificationContext?.idVerified === true && !aggregatedFailures?.some((f) => REJECTED_IDENTITY_DIMENSIONS.has(f.dimension));
     const result2 = {
       identityVerified: idVerifiedFromBackend,
       policyAllowed: false,
@@ -4407,7 +4474,10 @@ async function verify(config, request, options) {
       requiresStepUp: apiResponse.access?.requiresStepUp,
       requiresApproval: apiResponse.access?.requiresApproval,
       guidance: {
-        message: apiResponse.access?.reason || "Access denied by PDLSS policy",
+        // 5.12.0: a presented-but-rejected id (malformed / unknown) carries
+        // actionable registration guidance on its failure — surface it
+        // instead of the bare machine reason ('unknown_agent').
+        message: rejectedIdentityGuidance(aggregatedFailures) ?? (apiResponse.access?.reason || "Access denied by PDLSS policy"),
         registrationUrl: urls?.registrationUrl ?? "",
         documentationUrl: urls?.documentationUrl ?? "",
         // 5.1.0: anonymous callers land on this branch — steer MCP-hosted
@@ -4507,7 +4577,7 @@ async function verify(config, request, options) {
       registrationUrl: urls?.registrationUrl ?? "",
       documentationUrl: urls?.documentationUrl ?? ""
     };
-  } else if (result.recommendation === "step_up_required") {
+  } else if (result.recommendation === "step_up_required" && result.identityVerified) {
     result.requiresStepUp = true;
     result.denialReasons = serverDenialReasons ?? result.recommendationReasons ?? ["Step-up verification required"];
   }
@@ -4536,6 +4606,217 @@ var DEFAULT_EDGE_CONFIG = Object.freeze({
 var DEFAULT_TTL_MS = 60 * 1e3;
 var DEFAULT_MAX_STALE_MS = 24 * 60 * 60 * 1e3;
 
+// src/edge-core/events.ts
+async function withBudget(promise, ms) {
+  let timer;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(void 0), ms);
+      })
+    ]);
+  } catch {
+    return void 0;
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+var destKeyOf = (d) => `${d.apiBaseUrl}\0${d.apiKey ?? ""}\0${d.counterparty}\0${d.adapter ?? ""}`;
+var BeaconBuffer = class {
+  constructor(options = {}) {
+    this.queue = [];
+    this.droppedSinceLast = 0;
+    this.droppedTotal = 0;
+    this.deliveredTotal = 0;
+    this.backoffUntil = 0;
+    this.collapse = /* @__PURE__ */ new Map();
+    /** Keys the backend answered 401 for — later batches go unauthenticated. */
+    this.rejectedKeys = /* @__PURE__ */ new Set();
+    this.opts = {
+      maxItems: options.maxItems ?? 1e3,
+      maxBatch: options.maxBatch ?? 100,
+      maxAttempts: options.maxAttempts ?? 3,
+      collapseWindowMs: options.collapseWindowMs ?? 6e4,
+      collapseMaxKeys: options.collapseMaxKeys ?? 1e3,
+      requestTimeoutMs: options.requestTimeoutMs ?? 1e4,
+      retryBackoffMs: options.retryBackoffMs ?? 1e3,
+      now: options.now ?? Date.now
+    };
+  }
+  /**
+   * Queue one beacon. With a `collapseKey`, a repeat inside the window is
+   * merged into a held aggregate (sent when the window closes) instead of
+   * becoming its own item.
+   */
+  enqueue(dest, item, collapseKey) {
+    const now = this.opts.now();
+    if (collapseKey) {
+      const entry = this.collapse.get(collapseKey);
+      if (entry && now - entry.firstSeenAt < this.opts.collapseWindowMs) {
+        for (const target of [entry.first, entry.held]) {
+          if (target && !target.inFlight && this.queue.includes(target)) {
+            target.item.repeatCount = (target.item.repeatCount ?? 1) + 1;
+            return;
+          }
+        }
+        const held = this.push(
+          dest,
+          { ...item, repeatCount: 1 },
+          entry.firstSeenAt + this.opts.collapseWindowMs
+        );
+        entry.held = held;
+        return;
+      }
+      this.collapse.delete(collapseKey);
+      if (this.collapse.size >= this.opts.collapseMaxKeys) {
+        const oldest = this.collapse.keys().next().value;
+        if (oldest !== void 0) this.collapse.delete(oldest);
+      }
+      const fresh = { firstSeenAt: now };
+      this.collapse.set(collapseKey, fresh);
+      fresh.first = this.push(dest, item, now);
+      return;
+    }
+    this.push(dest, item, now);
+  }
+  /**
+   * Deliver every eligible queued item. Concurrent callers share ONE
+   * in-flight drain (it survives the caller's budget and a Lambda freeze),
+   * so nothing in flight is ever sent twice; items queued while it runs are
+   * picked up by the same drain.
+   */
+  flush() {
+    if (!this.inFlight) {
+      this.inFlight = this.drain().finally(() => {
+        this.inFlight = void 0;
+      });
+    }
+    return this.inFlight;
+  }
+  /** Counters for tests and diagnostics. */
+  stats() {
+    return {
+      queueDepth: this.queue.length,
+      droppedSinceLast: this.droppedSinceLast,
+      droppedTotal: this.droppedTotal,
+      deliveredTotal: this.deliveredTotal,
+      flushing: this.inFlight !== void 0
+    };
+  }
+  push(dest, item, eligibleAt) {
+    while (this.queue.length >= this.opts.maxItems) this.dropOldest();
+    const entry = {
+      dest,
+      destKey: destKeyOf(dest),
+      item,
+      attempts: 0,
+      eligibleAt,
+      inFlight: false
+    };
+    this.queue.push(entry);
+    return entry;
+  }
+  dropOldest() {
+    if (this.queue.shift()) this.countDropped(1);
+  }
+  countDropped(n) {
+    this.droppedSinceLast += n;
+    this.droppedTotal += n;
+  }
+  async drain() {
+    for (; ; ) {
+      const now = this.opts.now();
+      if (now < this.backoffUntil) return;
+      const batch = this.takeBatch(now);
+      if (batch.length === 0) return;
+      const ok = await this.send(batch);
+      if (!ok) return;
+    }
+  }
+  /** Oldest eligible item + up to maxBatch-1 more for the same destination. */
+  takeBatch(now) {
+    const first = this.queue.find((q) => q.eligibleAt <= now);
+    if (!first) return [];
+    const batch = [];
+    const rest = [];
+    for (const q of this.queue) {
+      if (batch.length < this.opts.maxBatch && q.destKey === first.destKey && q.eligibleAt <= now) {
+        q.inFlight = true;
+        batch.push(q);
+      } else {
+        rest.push(q);
+      }
+    }
+    this.queue = rest;
+    return batch;
+  }
+  /** POST one batch. Returns false when the drain should pause (backoff). */
+  async send(batch) {
+    const dest = batch[0].dest;
+    const useKey = dest.apiKey && !this.rejectedKeys.has(dest.apiKey) ? dest.apiKey : void 0;
+    const reportedDropped = this.droppedSinceLast;
+    const meta = {
+      droppedSinceLast: reportedDropped,
+      queueDepth: this.queue.length,
+      adapter: dest.adapter ?? "edge-core",
+      version: SDK_VERSION
+    };
+    const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
+    const response = await withBudget(
+      sdkFetch(`${dest.apiBaseUrl}/verification-activity/edge-events`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...useKey && { Authorization: `Bearer ${useKey}` }
+        },
+        body: JSON.stringify({ events: batch.map((q) => q.item), meta }),
+        ...controller && { signal: controller.signal }
+      }),
+      this.opts.requestTimeoutMs
+    );
+    if (!response) controller?.abort();
+    const status = response?.status;
+    for (const q of batch) q.inFlight = false;
+    if (status !== void 0 && status >= 200 && status < 300) {
+      this.droppedSinceLast = Math.max(0, this.droppedSinceLast - reportedDropped);
+      this.deliveredTotal += batch.length;
+      return true;
+    }
+    if (status === 401 && useKey) {
+      this.rejectedKeys.add(useKey);
+      this.requeue(batch, false);
+      return true;
+    }
+    if (status === 429) {
+      const retryAfter = Number(response?.headers.get("retry-after"));
+      const waitMs = Number.isFinite(retryAfter) && retryAfter > 0 ? Math.min(retryAfter, 120) * 1e3 : 3e4;
+      this.backoffUntil = this.opts.now() + waitMs;
+      this.requeue(batch, false);
+      return false;
+    }
+    if (status !== void 0 && status >= 400 && status < 500) {
+      this.countDropped(batch.length);
+      return true;
+    }
+    this.backoffUntil = this.opts.now() + this.opts.retryBackoffMs;
+    this.requeue(batch, true);
+    return false;
+  }
+  /** Put a failed batch back at the head of the queue (order preserved). */
+  requeue(batch, countAttempt) {
+    const keep = [];
+    for (const q of batch) {
+      if (countAttempt) q.attempts += 1;
+      if (q.attempts >= this.opts.maxAttempts) this.countDropped(1);
+      else keep.push(q);
+    }
+    this.queue = [...keep, ...this.queue];
+    while (this.queue.length > this.opts.maxItems) this.dropOldest();
+  }
+};
+var beaconBuffer = new BeaconBuffer();
+
 // src/adapters/express.ts
 var DEFAULT_ROUTES_REFRESH_MS = 5 * 60 * 1e3;
 
@@ -5132,11 +5413,445 @@ var AstraSyncGateway = class {
   }
 };
 
+// src/claude-code/guard-config.ts
+import { homedir as homedir2 } from "os";
+
+// src/fleet/enrolment-store.ts
+import { chmodSync, existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { homedir } from "os";
+import { dirname as dirname2, join as join2 } from "path";
+function machineScopeDir(platform = process.platform, env = process.env) {
+  if (platform === "darwin") return "/Library/Application Support/AstraSync";
+  if (platform === "win32") return join2(env.ProgramData || "C:\\ProgramData", "AstraSync");
+  return "/etc/astrasync";
+}
+function fleetPaths(options = {}) {
+  const home = options.home ?? homedir();
+  const machineDir = options.machineDir ?? options.env?.ASTRASYNC_FLEET_MACHINE_DIR ?? machineScopeDir(options.platform, options.env);
+  const userDir = join2(home, ".astrasync", "fleet");
+  return {
+    machineDevice: join2(machineDir, "fleet.json"),
+    machinePolicy: join2(machineDir, "policy.jws"),
+    userDir,
+    userDevice: join2(userDir, "device.json"),
+    userPolicy: join2(userDir, "policy.jws"),
+    userKeyChain: join2(userDir, "keychain.json"),
+    state: join2(userDir, "state.json")
+  };
+}
+function isEnrolment(value) {
+  const v = value;
+  return !!v && typeof v.deviceId === "string" && typeof v.credential === "string" && typeof v.apiBaseUrl === "string" && !!v.org && typeof v.org.ownerId === "string" && !!v.jwks && Array.isArray(v.jwks.keys);
+}
+function loadEnrolment(paths) {
+  const candidates = [
+    [paths.machineDevice, "machine"],
+    [paths.userDevice, "user"]
+  ];
+  for (const [path, scope] of candidates) {
+    if (!existsSync3(path)) continue;
+    try {
+      const parsed = JSON.parse(readFileSync3(path, "utf-8"));
+      if (isEnrolment(parsed)) return { enrolment: parsed, scope };
+    } catch {
+    }
+    return { corrupt: true, path };
+  }
+  return null;
+}
+function writeFileMode(path, content, mode) {
+  mkdirSync3(dirname2(path), { recursive: true, mode: 448 });
+  writeFileSync2(path, content, { encoding: "utf-8", mode });
+  try {
+    chmodSync(path, mode);
+  } catch {
+  }
+}
+function readCachedPolicies(paths) {
+  const out = [];
+  for (const p of [paths.userPolicy, paths.machinePolicy]) {
+    try {
+      if (existsSync3(p)) out.push(readFileSync3(p, "utf-8").trim());
+    } catch {
+    }
+  }
+  return out.filter(Boolean);
+}
+function writeCachedPolicy(paths, jws) {
+  writeFileMode(paths.userPolicy, jws, 384);
+}
+function readKeyChain(paths) {
+  try {
+    const parsed = JSON.parse(readFileSync3(paths.userKeyChain, "utf-8"));
+    return Array.isArray(parsed) ? parsed.filter((j) => typeof j === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function writeKeyChain(paths, chain) {
+  writeFileMode(paths.userKeyChain, JSON.stringify(chain), 384);
+}
+function readState(paths) {
+  try {
+    const parsed = JSON.parse(readFileSync3(paths.state, "utf-8"));
+    const c = parsed.counts;
+    return {
+      ...parsed,
+      counts: { allow: c?.allow ?? 0, deny: c?.deny ?? 0, ask: c?.ask ?? 0 }
+    };
+  } catch {
+    return { counts: { allow: 0, deny: 0, ask: 0 } };
+  }
+}
+function writeState(paths, state) {
+  try {
+    writeFileMode(paths.state, JSON.stringify(state, null, 2), 384);
+  } catch {
+  }
+}
+
+// src/claude-code/guard-config.ts
+var FLEET_ENROL_INSTRUCTION = "This machine must be enrolled: run `astrasync guard enroll <token>` (token from your organisation admin)";
+function resolveFleet(env, home = homedir2(), paths = fleetPaths({ home, env })) {
+  const loaded = loadEnrolment(paths);
+  if (loaded && "corrupt" in loaded) {
+    return {
+      kind: "fleet-missing",
+      reason: `fleet enrolment at ${loaded.path} is unreadable \u2014 ${FLEET_ENROL_INSTRUCTION}`,
+      paths
+    };
+  }
+  if (loaded) return { kind: "fleet", enrolment: loaded.enrolment, scope: loaded.scope, paths };
+  if (env.ASTRASYNC_FLEET_REQUIRED === "1") {
+    return { kind: "fleet-missing", reason: FLEET_ENROL_INSTRUCTION, paths };
+  }
+  return null;
+}
+
+// src/fleet/client.ts
+var FleetApiError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "FleetApiError";
+  }
+};
+function base(url) {
+  return url.replace(/\/+$/, "");
+}
+async function call(url, init, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await sdkFetch(url, { ...init, signal: controller.signal });
+    const text = await res.text();
+    let body = text;
+    try {
+      body = text ? JSON.parse(text) : null;
+    } catch {
+    }
+    return { status: res.status, body, headers: res.headers };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function apiError(status, body, what) {
+  const b = body ?? {};
+  const code = b.code ?? (typeof b.error === "string" ? b.error : void 0);
+  return new FleetApiError(`${what} failed (${status}${code ? ` ${code}` : ""})`, status, code);
+}
+function deviceHeaders(enrolment) {
+  return { Authorization: `Device ${enrolment.credential}` };
+}
+function policyEtag(sha256, kid) {
+  return `${sha256}.${kid ?? ""}`;
+}
+async function fetchFleetPolicy(enrolment, ifNoneMatch, timeoutMs = 1500) {
+  const headers = deviceHeaders(enrolment);
+  if (ifNoneMatch) headers["If-None-Match"] = `"${ifNoneMatch}"`;
+  const r = await call(`${base(enrolment.apiBaseUrl)}/fleet/policy`, { headers }, timeoutMs);
+  if (r.status === 304) return { status: "unchanged" };
+  if (r.status !== 200) throw apiError(r.status, r.body, "Policy fetch");
+  const data = r.body;
+  if (!data?.policyJws) throw new FleetApiError("Policy response has no policyJws", r.status);
+  return {
+    status: "ok",
+    policyJws: data.policyJws,
+    sha256: data.sha256 ?? "",
+    version: data.version ?? 0,
+    keyChain: Array.isArray(data.keyChain) ? data.keyChain.filter((j) => typeof j === "string") : []
+  };
+}
+async function sendHeartbeat(enrolment, request, timeoutMs = 1500) {
+  const r = await call(
+    `${base(enrolment.apiBaseUrl)}/fleet/heartbeat`,
+    {
+      method: "POST",
+      headers: { ...deviceHeaders(enrolment), "Content-Type": "application/json" },
+      body: JSON.stringify(request)
+    },
+    timeoutMs
+  );
+  if (r.status !== 200) throw apiError(r.status, r.body, "Heartbeat");
+  return r.body;
+}
+
+// src/fleet/policy-verify.ts
+import { createHash as createHash4 } from "crypto";
+import { compactVerify, createLocalJWKSet } from "jose";
+
+// src/fleet/types.ts
+var FLEET_POLICY_TYP = "fleet-policy+jwt";
+var FLEET_POLICY_AUD = "astrasync:fleet-policy";
+var FLEET_POLICY_ISS = "astrasync.ai";
+var FLEET_KEYS_TYP = "fleet-keys+jwt";
+var FLEET_KEYS_AUD = "astrasync:fleet-keys";
+var DEFAULT_HEARTBEAT_INTERVAL_SEC = 900;
+
+// src/fleet/policy-verify.ts
+var FleetPolicyError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "FleetPolicyError";
+  }
+};
+function sha256Hex(text) {
+  return createHash4("sha256").update(text, "utf8").digest("hex");
+}
+function parseSettings(raw) {
+  if (!raw || typeof raw !== "object") throw new FleetPolicyError("settings missing");
+  const s = raw;
+  if (s.posture !== "active" && s.posture !== "passive") {
+    throw new FleetPolicyError("settings.posture must be active or passive");
+  }
+  if (s.failOpen !== void 0 && typeof s.failOpen !== "boolean") {
+    throw new FleetPolicyError("settings.failOpen must be a boolean");
+  }
+  if (s.governMcp !== void 0 && typeof s.governMcp !== "boolean") {
+    throw new FleetPolicyError("settings.governMcp must be a boolean");
+  }
+  if (s.skipTools !== void 0 && !(Array.isArray(s.skipTools) && s.skipTools.every((t) => typeof t === "string"))) {
+    throw new FleetPolicyError("settings.skipTools must be a string array");
+  }
+  const num = (v) => typeof v === "number" && Number.isFinite(v) && v > 0 ? v : void 0;
+  return {
+    posture: s.posture,
+    failOpen: s.failOpen === true,
+    ...typeof s.governMcp === "boolean" && { governMcp: s.governMcp },
+    ...Array.isArray(s.skipTools) && { skipTools: s.skipTools },
+    ...num(s.heartbeatIntervalSec) && { heartbeatIntervalSec: num(s.heartbeatIntervalSec) },
+    ...num(s.staleAfterSec) && { staleAfterSec: num(s.staleAfterSec) }
+  };
+}
+async function verifyFleetPolicy(jws, jwks, options) {
+  let payloadBytes;
+  let header;
+  try {
+    const keySet = createLocalJWKSet(jwks);
+    const result = await compactVerify(jws, keySet, { algorithms: ["ES256"] });
+    payloadBytes = result.payload;
+    header = result.protectedHeader;
+  } catch (err) {
+    throw new FleetPolicyError(
+      `signature verification failed (${err instanceof Error ? err.message : String(err)})`
+    );
+  }
+  if (header.typ !== FLEET_POLICY_TYP) throw new FleetPolicyError(`unexpected typ ${header.typ}`);
+  let claims;
+  try {
+    claims = JSON.parse(new TextDecoder().decode(payloadBytes));
+  } catch {
+    throw new FleetPolicyError("payload is not JSON");
+  }
+  if (claims.aud !== FLEET_POLICY_AUD) throw new FleetPolicyError(`unexpected aud ${claims.aud}`);
+  if (claims.iss !== FLEET_POLICY_ISS) throw new FleetPolicyError(`unexpected iss ${claims.iss}`);
+  if (!options.expectedSubs.includes(claims.sub)) {
+    throw new FleetPolicyError("policy was issued for a different organisation or device");
+  }
+  if (!Number.isInteger(claims.ver) || claims.ver < 1) {
+    throw new FleetPolicyError("ver must be a positive integer");
+  }
+  if (options.minVer !== void 0 && claims.ver < options.minVer) {
+    throw new FleetPolicyError(
+      `policy version ${claims.ver} is older than the accepted version ${options.minVer} (rollback)`
+    );
+  }
+  if (typeof claims.yaml !== "string" || sha256Hex(claims.yaml) !== claims.sha256) {
+    throw new FleetPolicyError("policy hash mismatch");
+  }
+  const settings = parseSettings(claims.settings);
+  const parsed = parseYaml(claims.yaml);
+  if (!parsed.policy) {
+    const first = parsed.validation.errors[0];
+    throw new FleetPolicyError(
+      `signed policy is invalid${first ? ` (${first.path}: ${first.message})` : ""}`
+    );
+  }
+  return { kid: header.kid, claims: { ...claims, settings }, policy: parsed.policy, settings, jws };
+}
+async function resolveFleetJwks(pinned, chain, ownerId) {
+  let trusted = pinned;
+  let lastSeq = 0;
+  for (const link of chain) {
+    try {
+      const { payload, protectedHeader } = await compactVerify(
+        link,
+        createLocalJWKSet(trusted),
+        { algorithms: ["ES256"] }
+      );
+      if (protectedHeader.typ !== FLEET_KEYS_TYP) continue;
+      const c = JSON.parse(new TextDecoder().decode(payload));
+      if (c.aud !== FLEET_KEYS_AUD || c.iss !== FLEET_POLICY_ISS || c.sub !== ownerId) continue;
+      if (!Number.isInteger(c.seq) || c.seq <= lastSeq) continue;
+      const keys = Array.isArray(c.keys) ? c.keys.filter((k) => k && k.kty === "EC" && k.crv === "P-256" && !("d" in k)) : [];
+      if (keys.length === 0) continue;
+      trusted = { keys };
+      lastSeq = c.seq;
+    } catch {
+    }
+  }
+  return trusted;
+}
+async function pickNewestValid(candidates, jwks, options) {
+  let best = null;
+  let lastError = new FleetPolicyError("no cached fleet policy");
+  for (const jws of candidates) {
+    try {
+      const v = await verifyFleetPolicy(jws, jwks, options);
+      if (!best || v.claims.ver > best.claims.ver) best = v;
+    } catch (err) {
+      lastError = err instanceof Error ? err : new FleetPolicyError(String(err));
+    }
+  }
+  if (!best) throw lastError;
+  return best;
+}
+
+// src/fleet/runtime.ts
+var FLEET_SYNC_BUDGET_MS = 1500;
+function expectedSubs(enrolment) {
+  return [enrolment.org.ownerId, enrolment.deviceId];
+}
+function fleetJwks(ctx, chain = readKeyChain(ctx.paths)) {
+  return resolveFleetJwks(ctx.enrolment.jwks, chain, ctx.enrolment.org.ownerId);
+}
+async function acceptFetched(ctx, fetched, verifyOpts) {
+  const jwks = await fleetJwks(ctx, fetched.keyChain);
+  const verified = await verifyFleetPolicy(fetched.policyJws, jwks, verifyOpts);
+  if (fetched.keyChain.length > 0) writeKeyChain(ctx.paths, fetched.keyChain);
+  writeCachedPolicy(ctx.paths, fetched.policyJws);
+  return verified;
+}
+function remember(paths, state, verified) {
+  state.appliedSha256 = verified.claims.sha256;
+  state.maxVer = Math.max(state.maxVer ?? 0, verified.claims.ver);
+  writeState(paths, state);
+}
+async function loadFleetPolicy(ctx, options = {}) {
+  const state = readState(ctx.paths);
+  const verifyOpts = { expectedSubs: expectedSubs(ctx.enrolment), minVer: state.maxVer };
+  const cached = readCachedPolicies(ctx.paths);
+  let cacheError = null;
+  if (cached.length > 0) {
+    try {
+      const verified = await pickNewestValid(cached, await fleetJwks(ctx), verifyOpts);
+      if (verified.claims.sha256 !== state.appliedSha256 || verified.claims.ver !== state.maxVer) {
+        remember(ctx.paths, state, verified);
+      }
+      return verified;
+    } catch (err) {
+      cacheError = err instanceof Error ? err : new FleetPolicyError(String(err));
+    }
+  }
+  try {
+    const fetched = await fetchFleetPolicy(
+      ctx.enrolment,
+      null,
+      options.fetchTimeoutMs ?? FLEET_SYNC_BUDGET_MS
+    );
+    if (fetched.status === "ok") {
+      const verified = await acceptFetched(ctx, fetched, verifyOpts);
+      remember(ctx.paths, state, verified);
+      return verified;
+    }
+  } catch (err) {
+    if (err instanceof FleetApiError && err.code === "DEVICE_REVOKED") {
+      state.revoked = true;
+      writeState(ctx.paths, state);
+    }
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new FleetPolicyError(
+      cacheError ? `${cacheError.message}; refresh failed (${detail})` : `no fleet policy (${detail})`
+    );
+  }
+  throw cacheError ?? new FleetPolicyError("no fleet policy available");
+}
+async function recordDecisionAndHeartbeat(ctx, applied, decision, options) {
+  const now = options.now ?? Date.now;
+  const state = readState(ctx.paths);
+  if (decision) state.counts[decision] += 1;
+  const intervalSec = applied.settings.heartbeatIntervalSec ?? ctx.enrolment.heartbeatIntervalSec ?? DEFAULT_HEARTBEAT_INTERVAL_SEC;
+  const last = state.lastHeartbeatAt ? Date.parse(state.lastHeartbeatAt) : 0;
+  if (now() - last < intervalSec * 1e3) {
+    writeState(ctx.paths, state);
+    return "throttled";
+  }
+  const deadline = now() + (options.budgetMs ?? FLEET_SYNC_BUDGET_MS);
+  const remaining = () => Math.max(1, deadline - now());
+  state.lastHeartbeatAt = new Date(now()).toISOString();
+  let outcome = "sent";
+  try {
+    const hb = await sendHeartbeat(
+      ctx.enrolment,
+      {
+        appliedSha256: applied.claims.sha256,
+        guardVersion: options.guardVersion,
+        adapters: [{ kind: options.adapterKind, managed: true }],
+        posture: applied.settings.posture,
+        decisionCounts: { ...state.counts }
+      },
+      remaining()
+    );
+    state.counts = { allow: 0, deny: 0, ask: 0 };
+    state.revoked = false;
+    delete state.lastError;
+    const policyChanged = !!hb.activeSha256 && hb.activeSha256 !== applied.claims.sha256;
+    const keyChanged = !!hb.activeKid && !!applied.kid && hb.activeKid !== applied.kid;
+    if (policyChanged || keyChanged) {
+      const fetched = await fetchFleetPolicy(
+        ctx.enrolment,
+        policyEtag(applied.claims.sha256, applied.kid),
+        remaining()
+      );
+      if (fetched.status === "ok") {
+        const verified = await acceptFetched(ctx, fetched, {
+          expectedSubs: expectedSubs(ctx.enrolment),
+          minVer: Math.max(state.maxVer ?? 0, applied.claims.ver)
+        });
+        state.appliedSha256 = verified.claims.sha256;
+        state.maxVer = Math.max(state.maxVer ?? 0, verified.claims.ver);
+        outcome = "refreshed";
+      }
+    }
+  } catch (err) {
+    if (err instanceof FleetApiError && err.code === "DEVICE_REVOKED") {
+      state.revoked = true;
+      outcome = "revoked";
+    } else {
+      state.lastError = err instanceof Error ? err.message : String(err);
+      outcome = "failed";
+    }
+  }
+  writeState(ctx.paths, state);
+  return outcome;
+}
+
 // src/cursor/extension.ts
 var adapter = null;
 var gateway = null;
-async function activate(vscodeApi) {
-  const config = loadConfiguration();
+async function activate(vscodeApi, options = {}) {
+  const config = await loadConfiguration(options);
   gateway = new AstraSyncGateway(config.gatewayConfig);
   adapter = new CursorAdapter({
     vscode: vscodeApi,
@@ -5159,10 +5874,18 @@ Action: ${context.action} \u2192 ${context.target}`,
     const channel = vscodeApi.window.createOutputChannel("AstraSync Policy");
     channel.appendLine(`Mode: ${gateway.mode}`);
     channel.appendLine(`Posture: ${gateway.posture}`);
-    channel.appendLine(`Policy file: ${config.gatewayConfig.policyFile || "(inline/none)"}`);
+    channel.appendLine(
+      config.fleetManaged ? `Policy: organisation fleet policy (${config.fleetManaged})` : `Policy file: ${config.gatewayConfig.policyFile || "(inline/none)"}`
+    );
     channel.show();
   });
   vscodeApi.commands.registerCommand("astrasync.switchMode", async () => {
+    if (config.fleetManaged) {
+      vscodeApi.window.showInformationMessage(
+        "AstraSync: this machine is governed by your organisation\u2019s fleet policy \u2014 mode is managed centrally."
+      );
+      return;
+    }
     if (!config.gatewayConfig.apiKey) {
       vscodeApi.window.showInformationMessage(
         "AstraSync: Set astrasync.apiKey in settings to enable online/hybrid mode."
@@ -5192,7 +5915,62 @@ async function deactivate() {
     gateway = null;
   }
 }
-function loadConfiguration() {
+function fleetLockdownPolicy() {
+  return {
+    version: "1.0",
+    name: "fleet-enrolment-required",
+    purposes: [
+      "file.read",
+      "file.write",
+      "file.delete",
+      "shell.exec",
+      "network.fetch",
+      "payment.execute",
+      "email.send"
+    ].map((id) => ({ id, allowed: false }))
+  };
+}
+async function loadConfiguration(options) {
+  const env = options.env ?? process.env;
+  const fleet = resolveFleet(env, options.home ?? homedir3(), options.fleetPaths);
+  if (fleet?.kind === "fleet") {
+    const ctx = { enrolment: fleet.enrolment, paths: fleet.paths };
+    try {
+      const verified = await loadFleetPolicy(ctx);
+      void recordDecisionAndHeartbeat(ctx, verified, null, {
+        guardVersion: SDK_VERSION,
+        adapterKind: "cursor"
+      }).catch(() => void 0);
+      return {
+        fleetManaged: `${fleet.enrolment.org.name ?? fleet.enrolment.org.ownerId} v${verified.claims.ver}`,
+        gatewayConfig: {
+          mode: "local",
+          policy: verified.policy,
+          posture: verified.settings.posture,
+          traceEnabled: true,
+          tracePath: join3(fleet.paths.userDir, "traces"),
+          debug: false
+        }
+      };
+    } catch {
+    }
+  }
+  if (fleet) {
+    return {
+      fleetManaged: "unavailable \u2014 enrol this machine with `astrasync guard enroll <token>`",
+      gatewayConfig: {
+        mode: "local",
+        policy: fleetLockdownPolicy(),
+        posture: "active",
+        traceEnabled: true,
+        tracePath: join3(fleet.paths.userDir, "traces"),
+        debug: false
+      }
+    };
+  }
+  return loadLocalConfiguration();
+}
+function loadLocalConfiguration() {
   return {
     gatewayConfig: {
       mode: "local",