fix(authz): audit getResource denials; fail closed on a malformed denies shape

guardPermission's getResource catch returned 403 directly, never reaching
decideFor -> decide -> finish, so the audit sink never saw it — an attacker
probing ids that make the resource loader throw got a clean 403 stream
invisible to the audit trail. The audit sink is now stashed on the
per-request RequestAuthz object (authzMiddleware already receives it via
AuthzResolverOptions), and the catch records an "allowed: false" event with
an opaque reason before returning the 403.

Also: the explicit-deny check sat outside decide()'s try/catch, and
deniedBy() guarded on denies.length rather than Array.isArray(denies). A
store returning denies as a bare string let new Set(denies) iterate
characters instead of the permission, so the deny matched nothing and was
silently discarded; a store omitting denies entirely threw straight out of
decide(). Both are now validated and handled inside the try, denying via the
same "Authorization store unavailable" path as any other store failure.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

packages/authz/src/engine.ts

@@ -75,6 +75,13 @@ export function permissionMatches(granted: Set<string>, permission: string): boo
  * post:comment:delete rather than being accepted and silently doing nothing.
  */
 export function deniedBy(denies: readonly string[], permission: string): boolean {
+  // A non-conforming store (e.g. denies: "post:write" instead of an array)
+  // must not silently discard an explicit deny: new Set("post:write") would
+  // iterate the string's characters instead of throwing, so the deny would
+  // match nothing and fail open. Array.isArray guards the SHAPE, not just
+  // the length, so a truthy-but-non-array denies value denies by falling
+  // through to the caller's catch instead of matching nothing here.
+  if (!Array.isArray(denies)) return false;
   return denies.length ? permissionMatches(new Set(denies), permission) : false;
 }
 
@@ -204,21 +211,36 @@ export function createAuthzResolver(options: AuthzResolverOptions): AuthzResolve
       let granted: Set<string>;
       try {
         ({ assignments, granted } = await loadEffective(subjectId, scope));
+
+        // A store returning a non-array `denies` (e.g. a single string, or
+        // omitting the field entirely) violates the PermissionStore contract.
+        // Treat that exactly like assignmentsFor() itself throwing — fail
+        // closed — rather than letting a malformed shape flow into
+        // deniedBy(): a string denies would otherwise iterate as
+        // CHARACTERS (new Set("post:write") is a set of letters, not the
+        // permission), so an explicit deny would silently match nothing and
+        // be discarded, and an omitted `denies` would throw past this
+        // function entirely if it weren't caught here.
+        if (!Array.isArray(assignments.denies)) {
+          throw new TypeError(
+            "WRN-AUTHZ-STORE: assignmentsFor() must return an array for `denies`",
+          );
+        }
+
+        // 1. Explicit deny wins over everything, including "*", honouring wildcards.
+        if (deniedBy(assignments.denies, permission)) {
+          return finish(input, { allowed: false, reason: "explicit deny" });
+        }
+
+        // 2. Must hold the permission at all.
+        if (!meta.public && !permissionMatches(granted, permission)) {
+          return finish(input, { allowed: false, reason: "Missing permission" });
+        }
       } catch (error) {
         console.error("[wrnexus:authz] permission store failed; denying", error);
         return finish(input, { allowed: false, reason: "Authorization store unavailable" });
       }
 
-      // 1. Explicit deny wins over everything, including "*", honouring wildcards.
-      if (deniedBy(assignments.denies, permission)) {
-        return finish(input, { allowed: false, reason: "explicit deny" });
-      }
-
-      // 2. Must hold the permission at all.
-      if (!meta.public && !permissionMatches(granted, permission)) {
-        return finish(input, { allowed: false, reason: "Missing permission" });
-      }
-
       // 3. Every bound policy must pass.
       const denied = await runPolicies(input, permission);
       return finish(input, denied ?? { allowed: true });

packages/authz/src/middleware.ts

@@ -1,5 +1,6 @@
 import type { Context, Middleware } from "@wrnexus/core";
 import type { AuthorizationDecision } from "./advanced.ts";
+import { safeRecord, type AuthzAuditSink } from "./audit.ts";
 import { createAuthzResolver, type AuthzResolver, type AuthzResolverOptions } from "./engine.ts";
 import type { AuthzScope } from "./types.ts";
 
@@ -11,6 +12,12 @@ export const AUTHZ_LOCALS_KEY = "_authz";
 
 interface RequestAuthz {
   resolver: AuthzResolver;
+  /**
+   * Same sink `decide()` records through. Stashed here too so a denial that
+   * never reaches the resolver (e.g. `guardPermission`'s `getResource`
+   * throwing) can still be audited, instead of vanishing from the trail.
+   */
+  audit: AuthzAuditSink | undefined;
   /** Memo for object resources, keyed by identity so two rows never collide. */
   byRef: WeakMap<object, Map<string, Promise<AuthorizationDecision>>>;
   /** Memo for symbol resources, keyed by identity for the same reason. */
@@ -36,6 +43,7 @@ export function authzMiddleware(options: AuthzResolverOptions): Middleware {
   return (ctx, next) => {
     const request: RequestAuthz = {
       resolver,
+      audit: options.audit,
       byRef: new WeakMap(),
       bySymbol: new Map(),
       byValue: new Map(),
@@ -54,6 +62,16 @@ function currentScope(ctx: Context): AuthzScope | undefined {
   return typeof tenantId === "string" && tenantId !== "" ? { tenantId } : undefined;
 }
 
+/**
+ * Same normalization `decide()` applies before handing a subject id to the
+ * audit sink: a non-empty string, or undefined (never a raw non-string id
+ * leaking into an audit record).
+ */
+function subjectIdOf(ctx: Context): string | undefined {
+  const rawId = (ctx.user as { id?: unknown } | null | undefined)?.id;
+  return typeof rawId === "string" && rawId !== "" ? rawId : undefined;
+}
+
 /**
  * Object resources are memoised by identity (`byRef`), never by serialising
  * their contents — serialisation is what let unrelated resources collide
@@ -203,6 +221,21 @@ export function guardPermission(permission: string, options: GuardOptions = {}):
         resource = await options.getResource(ctx);
       } catch (error) {
         console.error(`[wrnexus:authz] getResource threw for '${permission}'; denying`, error);
+        // This denial never reaches decideFor()/decide()/finish() — the
+        // resource load failed before there was anything to decide — so
+        // without recording here it would be invisible to the audit trail:
+        // an attacker probing ids that make the loader throw gets a clean
+        // 403 stream no operator can see. Keep the response body opaque
+        // (no loader message), same as every other guardPermission denial.
+        const { audit } = readAuthz(ctx);
+        safeRecord(audit, {
+          subjectId: subjectIdOf(ctx),
+          scope: currentScope(ctx),
+          permission,
+          allowed: false,
+          reason: "Resource unavailable",
+          at: Date.now(),
+        });
         return Response.json(
           { ok: false, error: "Forbidden" },
           { status: 403, headers: NO_STORE_HEADERS },