@intelligo-dev/audit 1.0.0-beta.1 → 1.0.0-beta.13

package/NOTICE

@@ -0,0 +1,6 @@
+Intelligo
+Copyright 2026 Turtuvshin Byambaa and the Intelligo contributors
+
+This product is licensed under the Apache License, Version 2.0 (see
+LICENSE). The Intelligo name and logo are trademarks; see TRADEMARK.md
+in the source repository, https://github.com/intelligo-dev/intelligo.

package/README.md

@@ -0,0 +1,73 @@
+# @intelligo-dev/audit
+
+Append-only audit events for multi-tenant apps, with a Postgres trigger that refuses every update and delete.
+
+Part of [Intelligo](https://intelligo.dev), an application framework and
+operational platform for vertical AI SaaS products. Every `@intelligo-dev/*`
+package is released at one version and shares one database schema;
+`pnpm dlx @intelligo-dev/cli@beta create my-app` installs the set an
+application needs. Documentation:
+[intelligo.dev/docs/packages/audit](https://intelligo.dev/docs/packages/audit).
+
+## Install
+
+```bash
+pnpm add @intelligo-dev/audit@beta drizzle-orm
+```
+
+`drizzle-orm` is a peer. The `audit_events` table and its trigger are part of
+the framework's schema, which `intelligo migrate` from
+[`@intelligo-dev/cli`](https://www.npmjs.com/package/@intelligo-dev/cli)
+applies.
+
+## Use
+
+```ts
+import { recordAuditEvent } from "@intelligo-dev/audit";
+
+await recordAuditEvent({
+  workspaceId,
+  actorId: user.id,
+  action: "member.removed",
+  resourceKind: "member",
+  resourceId: memberId,
+  metadata: { role: "admin" },
+});
+```
+
+An event with no `actorId` is a system actor's — a cron, a webhook, the job
+runner; `actorKind: "support"` marks an operator acting on a tenant. `outcome`
+is `"ok"` unless the caller says `"failed"`.
+
+`recordAuditEvent` never throws — an audit failure must not fail the action it
+records. `recordAuditEventOrThrow` exists for the callers where the record _is_
+the action: impersonation, a destructive support operation.
+
+`queryAuditEvents({ workspaceId, action, resourceKind, resourceId, before, limit })`
+reads the trail most recent first, paginated by `before`.
+
+## Append-only, in the database
+
+`audit_events` refuses `UPDATE` and `DELETE` at the database level, with one
+exception: the `ON DELETE SET NULL` the foreign keys perform, so deleting a
+workspace does not require deleting its trail.
+
+## Sinks
+
+```ts
+import { registerAuditSink } from "@intelligo-dev/audit";
+
+registerAuditSink("siem", async (event) => {
+  await ship(event);
+});
+```
+
+A sink registered from the composition root receives every event after it is
+durably recorded, with failure isolation: an exporter with an expired
+credential breaks neither the audited operation nor the other sinks. It is how
+tamper-evidence, a retention policy or a SIEM export attaches without this
+package knowing about it.
+
+## Licence
+
+Apache-2.0

package/dist/db/schema.d.ts

@@ -1,15 +1,11 @@
 /**
- * @intelligo-dev/audit database schema.
- *
  * One append-only table recording who did what to which resource.
- * Owned by this package per ADR-0004; scanned by drizzle-kit alongside
- * the core schema directory (see packages/core/drizzle.config.ts) so
- * the migration history stays unified in one database.
+ * Scanned by drizzle-kit alongside the core schema directory (see
+ * packages/core/drizzle.config.ts) so the migration history stays
+ * unified in one database.
  *
  * Distinct from `user_memory_audit` in core/identity, which records
- * mutations to a user's memory graph and predates this table. That one
- * folds in here once the memory subsystem's ownership is settled
- * (see docs/inventory/export-classification.md).
+ * mutations to a user's memory graph.
  */
 export declare const auditEvents: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "audit_events";

package/dist/db/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC"}

package/dist/db/schema.js

@@ -1,23 +1,23 @@
 /**
- * @intelligo-dev/audit database schema.
- *
  * One append-only table recording who did what to which resource.
- * Owned by this package per ADR-0004; scanned by drizzle-kit alongside
- * the core schema directory (see packages/core/drizzle.config.ts) so
- * the migration history stays unified in one database.
+ * Scanned by drizzle-kit alongside the core schema directory (see
+ * packages/core/drizzle.config.ts) so the migration history stays
+ * unified in one database.
  *
  * Distinct from `user_memory_audit` in core/identity, which records
- * mutations to a user's memory graph and predates this table. That one
- * folds in here once the memory subsystem's ownership is settled
- * (see docs/inventory/export-classification.md).
+ * mutations to a user's memory graph.
  */
 import { pgTable, text, timestamp, jsonb, index } from "drizzle-orm/pg-core";
 import { organization, users } from "@intelligo-dev/core/db/schema";
 export const auditEvents = pgTable("audit_events", {
     id: text("id").primaryKey(),
-    /** Null for platform-level events with no tenant. */
+    /**
+     * Null for platform-level events with no tenant — and for events
+     * whose workspace was since deleted: the trail outlives the tenant
+     * (set null, not cascade).
+     */
     workspaceId: text("workspace_id").references(() => organization.id, {
-        onDelete: "cascade",
+        onDelete: "set null",
     }),
     /** Null for system actors (cron, webhook, job runner). */
     actorId: text("actor_id").references(() => users.id, {

package/dist/db/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAChC,cAAc,EACd;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,qDAAqD;IACrD,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;QAClE,QAAQ,EAAE,SAAS;KACpB,CAAC;IACF,0DAA0D;IAC1D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;QACnD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,gEAAgE;IAChE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACvD,gEAAgE;IAChE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,uEAAuE;IACvE,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC7C,kEAAkE;IAClE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/B,uDAAuD;IACvD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,EAA2B;IAC5D,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CAC1D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,oCAAoC,CAAC,CAAC,EAAE,CAC5C,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,SAAS,CAChB;IACD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IAClE,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC;CAC5E,CACF,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAChC,cAAc,EACd;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B;;;;OAIG;IACH,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE;QAClE,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,0DAA0D;IAC1D,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE;QACnD,QAAQ,EAAE,UAAU;KACrB,CAAC;IACF,gEAAgE;IAChE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IACvD,gEAAgE;IAChE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,uEAAuE;IACvE,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE;IAC7C,kEAAkE;IAClE,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/B,uDAAuD;IACvD,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,EAA2B;IAC5D,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE;CAC1D,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,oCAAoC,CAAC,CAAC,EAAE,CAC5C,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,SAAS,CAChB;IACD,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC;IAClE,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,CAAC;CAC5E,CACF,CAAC"}

package/dist/index.d.ts

@@ -4,18 +4,13 @@
  * Emitting is deliberately failure-tolerant: an audit write must never
  * break the operation being audited. `recordAuditEvent` swallows and
  * logs; callers that need the guarantee (impersonation, destructive
- * support actions — Phase 5) use `recordAuditEventOrThrow`.
+ * support actions) use `recordAuditEventOrThrow`.
  */
 /**
- * Called after an event is durably recorded.
- *
- * This is an extension point, not a plugin system: sinks are
- * registered by the composition root, never by being imported
- * (ADR-0005). What it exists for is the governance work that does not
- * belong in a permissively-licensed package — tamper-evidence,
- * retention policy, shipping the trail to a customer's SIEM — so that
- * a closed module can add it without this package knowing it exists,
- * and without anyone forking this file.
+ * Called after an event is durably recorded. Sinks are registered by
+ * the composition root, never by being imported; they exist for
+ * governance work outside this package — tamper-evidence, retention
+ * policy, shipping the trail to a SIEM.
  *
  * A sink runs after the write, so it cannot corrupt or delay the audit
  * row itself, and its failures are isolated: an exporter with an
@@ -83,7 +78,7 @@ export type QueryAuditEventsOptions = {
     before?: Date;
     limit?: number;
 };
-/** Most-recent-first query for the admin console (Phase 5). */
+/** Most-recent-first query for the admin console. */
 export declare function queryAuditEvents(options?: QueryAuditEventsOptions): Promise<{
     id: string;
     workspaceId: string | null;
@@ -96,7 +91,7 @@ export declare function queryAuditEvents(options?: QueryAuditEventsOptions): Pro
     metadata: Record<string, unknown> | null;
     createdAt: Date;
 }[]>;
-export { auditEvents } from "./db/schema";
-export type { AuditEvent, InsertAuditEvent } from "./db/schema";
-export type { AuditTargetKind as MemoryAuditTargetKind, AuditAction as MemoryAuditAction, AuditActorKind as MemoryAuditActorKind, UserMemoryAuditRow, InsertUserMemoryAudit, RecordMemoryAuditInput, } from "./memory-audit";
+export { auditEvents } from "./db/schema.js";
+export type { AuditEvent, InsertAuditEvent } from "./db/schema.js";
+export type { AuditTargetKind as MemoryAuditTargetKind, AuditAction as MemoryAuditAction, AuditActorKind as MemoryAuditActorKind, UserMemoryAuditRow, InsertUserMemoryAudit, RecordMemoryAuditInput, } from "./memory-audit.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAIF,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAErE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAoBD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAgBF;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5E;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,+DAA+D;AAC/D,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B;;;;;;;;;;;KAqB3E;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIhE,YAAY,EACV,eAAe,IAAI,qBAAqB,EACxC,WAAW,IAAI,iBAAiB,EAChC,cAAc,IAAI,oBAAoB,EACtC,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAIF,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAErE;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAoBD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG;IAC5B,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAgBF;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5E;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CASf;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,qDAAqD;AACrD,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B;;;;;;;;;;;KAqB3E;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIhE,YAAY,EACV,eAAe,IAAI,qBAAqB,EACxC,WAAW,IAAI,iBAAiB,EAChC,cAAc,IAAI,oBAAoB,EACtC,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,14 +4,15 @@
  * Emitting is deliberately failure-tolerant: an audit write must never
  * break the operation being audited. `recordAuditEvent` swallows and
  * logs; callers that need the guarantee (impersonation, destructive
- * support actions — Phase 5) use `recordAuditEventOrThrow`.
+ * support actions) use `recordAuditEventOrThrow`.
  */
 import { db } from "@intelligo-dev/core/db";
 import { createLogger } from "@intelligo-dev/core/logger";
+import { createRegistry } from "@intelligo-dev/core/registry";
 import { and, desc, eq, lt } from "drizzle-orm";
-import { auditEvents } from "./db/schema";
+import { auditEvents } from "./db/schema.js";
 const log = createLogger("Audit");
-const sinks = new Map();
+const sinks = createRegistry("audit/sinks");
 /** Register (or replace) a sink under a stable name. */
 export function registerAuditSink(name, sink) {
     sinks.set(name, sink);
@@ -84,7 +85,7 @@ export async function recordAuditEventOrThrow(event) {
     // and every destructive support action.
     await fanOut({ ...row, createdAt: new Date() });
 }
-/** Most-recent-first query for the admin console (Phase 5). */
+/** Most-recent-first query for the admin console. */
 export async function queryAuditEvents(options = {}) {
     const filters = [
         options.workspaceId
@@ -106,5 +107,5 @@ export async function queryAuditEvents(options = {}) {
         .orderBy(desc(auditEvents.createdAt))
         .limit(Math.min(options.limit ?? 50, 500));
 }
-export { auditEvents } from "./db/schema";
+export { auditEvents } from "./db/schema.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AA6ClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE3C,wDAAwD;AACxD,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAe;IAC7D,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,KAAyB;IAC7C,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IAE7B,MAAM,OAAO,CAAC,GAAG,CACf,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBAC7B,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAoBD,SAAS,KAAK,CAAC,KAAsB;IACnC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjE,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;KACjC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAsB;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAsB;IAEtB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzC,oEAAoE;IACpE,qEAAqE;IACrE,kEAAkE;IAClE,qEAAqE;IACrE,wCAAwC;IACxC,MAAM,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAYD,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IAC1E,MAAM,OAAO,GAAG;QACd,OAAO,CAAC,WAAW;YACjB,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC;YAClD,CAAC,CAAC,SAAS;QACb,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACnE,OAAO,CAAC,YAAY;YAClB,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC;YACpD,CAAC,CAAC,SAAS;QACb,OAAO,CAAC,UAAU;YAChB,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YAChD,CAAC,CAAC,SAAS;QACb,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;KACvE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO,EAAE;SACN,MAAM,EAAE;SACR,IAAI,CAAC,WAAW,CAAC;SACjB,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;SACvD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;SACpC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/memory-audit.d.ts

@@ -1,45 +1,18 @@
 /**
- * Memory-audit event contract (ADR-0008).
+ * Memory-audit event contract.
  *
- * ADR-0008 names `@intelligo-dev/audit` as `recordMemoryAudit`'s
- * destination ("`recordMemoryAudit` to `audit`"). The dependency
- * allowlist doesn't cooperate with a literal move, though
- * (tests/architecture/dependency-direction.test.ts): this package may
- * depend on `@intelligo-dev/core` (`audit: ["@intelligo-dev/core"]`), but
- * `@intelligo-dev/core` may depend on nothing (`core: []`) — the same
- * constraint `packages/core/src/documents/service.ts` and
- * `.../conversations/service.ts` already document for
- * `@intelligo-dev/auth`. `user_facts`/`user_memories`/
- * `user_profile_snapshots`/`user_memory_audit` are owned by
- * `packages/core/src/identity` (see that module's doc comment), and
- * that module cannot import this package to call a writer defined
- * here — the allowlist only grants the audit -> core edge, never
- * core -> audit.
- *
- * What actually lands here, then, is the event *contract*: the shape a
- * memory-audit write takes, re-exported from the schema module that
- * already owns it. The write itself is a faithful, in-package port at
- * `packages/core/src/identity/audit.ts`, used internally by the
- * identity service (`deleteFact`, `exportIdentity`) so it never
- * crosses the disallowed core -> audit edge. This module is the public
- * seam for anyone else who depends on `@intelligo-dev/audit` (executions,
- * admin, billing) and wants to describe a memory-audit event without
- * reaching into `@intelligo-dev/core/identity`'s internals.
- *
- * `packages/audit/src/db/schema.ts` already documents where this
- * settles: `user_memory_audit` folds into `audit_events` once the
- * memory subsystem's ownership question closes (see
- * docs/inventory/export-classification.md), and this contract
- * graduates to backing that table's writer directly.
+ * `@intelligo-dev/core` may depend on nothing, so the identity module
+ * that owns `user_memory_audit` cannot call a writer defined here; the
+ * write lives in `packages/core/src/identity/audit.ts`. This module is
+ * the public type for packages that depend on `@intelligo-dev/audit`
+ * and want to describe a memory-audit event without reaching into
+ * `@intelligo-dev/core/identity`'s internals.
  */
 import type { AuditTargetKind, AuditAction, AuditActorKind, UserMemoryAuditRow, InsertUserMemoryAudit } from "@intelligo-dev/core/db/schema";
 export type { AuditTargetKind, AuditAction, AuditActorKind, UserMemoryAuditRow, InsertUserMemoryAudit, };
 /**
- * The shape `recordMemoryAudit`
- * (`packages/core/src/identity/audit.ts`) accepts. Kept here — not in
- * `@intelligo-dev/core/identity` — so a package that depends on
- * `@intelligo-dev/audit` but not on the identity service directly has a
- * stable type to code against.
+ * The shape `recordMemoryAudit` (`packages/core/src/identity/audit.ts`)
+ * accepts.
  */
 export type RecordMemoryAuditInput = {
     userId: string;

package/dist/memory-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-audit.d.ts","sourceRoot":"","sources":["../src/memory-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"memory-audit.d.ts","sourceRoot":"","sources":["../src/memory-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/dist/memory-audit.js

@@ -1,36 +1,12 @@
 /**
- * Memory-audit event contract (ADR-0008).
+ * Memory-audit event contract.
  *
- * ADR-0008 names `@intelligo-dev/audit` as `recordMemoryAudit`'s
- * destination ("`recordMemoryAudit` to `audit`"). The dependency
- * allowlist doesn't cooperate with a literal move, though
- * (tests/architecture/dependency-direction.test.ts): this package may
- * depend on `@intelligo-dev/core` (`audit: ["@intelligo-dev/core"]`), but
- * `@intelligo-dev/core` may depend on nothing (`core: []`) — the same
- * constraint `packages/core/src/documents/service.ts` and
- * `.../conversations/service.ts` already document for
- * `@intelligo-dev/auth`. `user_facts`/`user_memories`/
- * `user_profile_snapshots`/`user_memory_audit` are owned by
- * `packages/core/src/identity` (see that module's doc comment), and
- * that module cannot import this package to call a writer defined
- * here — the allowlist only grants the audit -> core edge, never
- * core -> audit.
- *
- * What actually lands here, then, is the event *contract*: the shape a
- * memory-audit write takes, re-exported from the schema module that
- * already owns it. The write itself is a faithful, in-package port at
- * `packages/core/src/identity/audit.ts`, used internally by the
- * identity service (`deleteFact`, `exportIdentity`) so it never
- * crosses the disallowed core -> audit edge. This module is the public
- * seam for anyone else who depends on `@intelligo-dev/audit` (executions,
- * admin, billing) and wants to describe a memory-audit event without
- * reaching into `@intelligo-dev/core/identity`'s internals.
- *
- * `packages/audit/src/db/schema.ts` already documents where this
- * settles: `user_memory_audit` folds into `audit_events` once the
- * memory subsystem's ownership question closes (see
- * docs/inventory/export-classification.md), and this contract
- * graduates to backing that table's writer directly.
+ * `@intelligo-dev/core` may depend on nothing, so the identity module
+ * that owns `user_memory_audit` cannot call a writer defined here; the
+ * write lives in `packages/core/src/identity/audit.ts`. This module is
+ * the public type for packages that depend on `@intelligo-dev/audit`
+ * and want to describe a memory-audit event without reaching into
+ * `@intelligo-dev/core/identity`'s internals.
  */
 export {};
 //# sourceMappingURL=memory-audit.js.map

package/dist/memory-audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-audit.js","sourceRoot":"","sources":["../src/memory-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}
+{"version":3,"file":"memory-audit.js","sourceRoot":"","sources":["../src/memory-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,15 +1,26 @@
 {
   "name": "@intelligo-dev/audit",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.13",
+  "description": "Append-only audit events for multi-tenant apps, with a Postgres trigger that refuses every update and delete.",
+  "keywords": [
+    "intelligo",
+    "ai-saas",
+    "saas",
+    "typescript",
+    "audit-log",
+    "append-only",
+    "postgres"
+  ],
   "license": "Apache-2.0",
+  "author": "Turtuvshin Byambaa <toroo.byamba@gmail.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/intelligo-mn/framework.git",
+    "url": "git+https://github.com/intelligo-dev/intelligo.git",
     "directory": "packages/audit"
   },
-  "homepage": "https://github.com/intelligo-mn/framework#readme",
+  "homepage": "https://intelligo.dev/docs/packages/audit",
   "bugs": {
-    "url": "https://github.com/intelligo-mn/framework/issues"
+    "url": "https://github.com/intelligo-dev/intelligo/issues"
   },
   "type": "module",
   "exports": {
@@ -23,22 +34,37 @@
     }
   },
   "dependencies": {
-    "drizzle-orm": "^0.45.1",
-    "@intelligo-dev/core": "1.0.0-beta.1"
+    "@intelligo-dev/core": "1.0.0-beta.13"
+  },
+  "peerDependencies": {
+    "drizzle-orm": "^0.45.1"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.7.2"
+    "@types/node": "^26.6.1",
+    "drizzle-orm": "^0.45.2",
+    "typescript": "^5.9.3"
   },
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__/**",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22.14"
+  },
+  "sideEffects": false,
   "scripts": {
     "type-check": "tsc --noEmit",
     "lint": "eslint .",
-    "build": "tsc -p tsconfig.build.json"
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist"
   }
 }

package/src/db/schema.ts

@@ -0,0 +1,54 @@
+/**
+ * One append-only table recording who did what to which resource.
+ * Scanned by drizzle-kit alongside the core schema directory (see
+ * packages/core/drizzle.config.ts) so the migration history stays
+ * unified in one database.
+ *
+ * Distinct from `user_memory_audit` in core/identity, which records
+ * mutations to a user's memory graph.
+ */
+
+import { pgTable, text, timestamp, jsonb, index } from "drizzle-orm/pg-core";
+import { organization, users } from "@intelligo-dev/core/db/schema";
+
+export const auditEvents = pgTable(
+  "audit_events",
+  {
+    id: text("id").primaryKey(),
+    /**
+     * Null for platform-level events with no tenant — and for events
+     * whose workspace was since deleted: the trail outlives the tenant
+     * (set null, not cascade).
+     */
+    workspaceId: text("workspace_id").references(() => organization.id, {
+      onDelete: "set null",
+    }),
+    /** Null for system actors (cron, webhook, job runner). */
+    actorId: text("actor_id").references(() => users.id, {
+      onDelete: "set null",
+    }),
+    /** "user" | "system" | "support" — who initiated the action. */
+    actorKind: text("actor_kind").notNull().default("user"),
+    /** Dotted verb: "execution.completed", "credits.reserved", … */
+    action: text("action").notNull(),
+    /** Resource type the action applied to: "execution", "workspace", … */
+    resourceKind: text("resource_kind").notNull(),
+    /** Identifier of that resource; free-form (uuid, slug, email). */
+    resourceId: text("resource_id"),
+    /** "ok" | "failed" — outcome of the audited action. */
+    outcome: text("outcome").notNull().default("ok"),
+    metadata: jsonb("metadata").$type<Record<string, unknown>>(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("audit_events_workspace_created_idx").on(
+      table.workspaceId,
+      table.createdAt
+    ),
+    index("audit_events_action_idx").on(table.action, table.createdAt),
+    index("audit_events_resource_idx").on(table.resourceKind, table.resourceId),
+  ]
+);
+
+export type AuditEvent = typeof auditEvents.$inferSelect;
+export type InsertAuditEvent = typeof auditEvents.$inferInsert;

package/src/index.ts

@@ -0,0 +1,204 @@
+/**
+ * @intelligo-dev/audit — append-only record of who did what.
+ *
+ * Emitting is deliberately failure-tolerant: an audit write must never
+ * break the operation being audited. `recordAuditEvent` swallows and
+ * logs; callers that need the guarantee (impersonation, destructive
+ * support actions) use `recordAuditEventOrThrow`.
+ */
+
+import { db } from "@intelligo-dev/core/db";
+import { createLogger } from "@intelligo-dev/core/logger";
+import { createRegistry } from "@intelligo-dev/core/registry";
+import { and, desc, eq, lt } from "drizzle-orm";
+
+import { auditEvents } from "./db/schema";
+
+const log = createLogger("Audit");
+
+// ---------------------------------------------------------------------------
+// Sinks
+// ---------------------------------------------------------------------------
+
+/**
+ * Called after an event is durably recorded. Sinks are registered by
+ * the composition root, never by being imported; they exist for
+ * governance work outside this package — tamper-evidence, retention
+ * policy, shipping the trail to a SIEM.
+ *
+ * A sink runs after the write, so it cannot corrupt or delay the audit
+ * row itself, and its failures are isolated: an exporter with an
+ * expired credential must not break the operation being audited, nor
+ * the other sinks.
+ */
+export type AuditSink = (event: RecordedAuditEvent) => Promise<void> | void;
+
+/**
+ * The row as written, which is what a sink needs to act on.
+ *
+ * Spelled out rather than inferred from `toRow`: inference gives `id`
+ * the template-literal type of `crypto.randomUUID()`, which is not
+ * what comes back out of the database, so every consumer would have to
+ * widen it.
+ */
+export type RecordedAuditEvent = {
+  id: string;
+  workspaceId: string | null;
+  actorId: string | null;
+  actorKind: string;
+  action: string;
+  resourceKind: string;
+  resourceId: string | null;
+  outcome: string;
+  metadata: Record<string, unknown> | null;
+  createdAt: Date;
+};
+
+const sinks = createRegistry<AuditSink>("audit/sinks");
+
+/** Register (or replace) a sink under a stable name. */
+export function registerAuditSink(name: string, sink: AuditSink): void {
+  sinks.set(name, sink);
+}
+
+export function registeredAuditSinks(): string[] {
+  return [...sinks.keys()];
+}
+
+export function clearAuditSinks(): void {
+  sinks.clear();
+}
+
+async function fanOut(event: RecordedAuditEvent): Promise<void> {
+  if (sinks.size === 0) return;
+
+  await Promise.all(
+    [...sinks.entries()].map(async ([name, sink]) => {
+      try {
+        await sink(event);
+      } catch (error) {
+        log.error("Audit sink failed", {
+          sink: name,
+          action: event.action,
+          error: error instanceof Error ? error.message : String(error),
+        });
+      }
+    })
+  );
+}
+
+export type AuditActorKind = "user" | "system" | "support";
+export type AuditOutcome = "ok" | "failed";
+
+export type AuditEventInput = {
+  /** Omit for platform-level events with no tenant. */
+  workspaceId?: string | null;
+  /** Omit for system actors (cron, webhook, job runner). */
+  actorId?: string | null;
+  actorKind?: AuditActorKind;
+  /** Dotted verb, e.g. "execution.completed". */
+  action: string;
+  /** Resource type, e.g. "execution". */
+  resourceKind: string;
+  resourceId?: string | null;
+  outcome?: AuditOutcome;
+  metadata?: Record<string, unknown>;
+};
+
+function toRow(event: AuditEventInput) {
+  return {
+    id: crypto.randomUUID(),
+    workspaceId: event.workspaceId ?? null,
+    actorId: event.actorId ?? null,
+    actorKind: event.actorKind ?? (event.actorId ? "user" : "system"),
+    action: event.action,
+    resourceKind: event.resourceKind,
+    resourceId: event.resourceId ?? null,
+    outcome: event.outcome ?? "ok",
+    metadata: event.metadata ?? null,
+  };
+}
+
+/**
+ * Record an audit event. Never throws — a failed audit write is logged
+ * and swallowed so it cannot take down the audited operation.
+ */
+export async function recordAuditEvent(event: AuditEventInput): Promise<void> {
+  try {
+    const row = toRow(event);
+    await db.insert(auditEvents).values(row);
+    await fanOut({ ...row, createdAt: new Date() });
+  } catch (error) {
+    log.error("Audit write failed", {
+      action: event.action,
+      resourceKind: event.resourceKind,
+      error: error instanceof Error ? error.message : String(error),
+    });
+  }
+}
+
+/**
+ * Record an audit event, propagating failures. Use where the audit
+ * trail is part of the contract (impersonation, destructive support
+ * actions) and the operation must abort if it cannot be recorded.
+ */
+export async function recordAuditEventOrThrow(
+  event: AuditEventInput
+): Promise<void> {
+  const row = toRow(event);
+  await db.insert(auditEvents).values(row);
+  // Sinks stay failure-isolated even here. The contract this function
+  // adds is that the *event was recorded*; a downstream exporter being
+  // unreachable does not make it unrecorded, and failing the caller
+  // over it would mean an expired SIEM token could block impersonation
+  // and every destructive support action.
+  await fanOut({ ...row, createdAt: new Date() });
+}
+
+export type QueryAuditEventsOptions = {
+  workspaceId?: string;
+  action?: string;
+  resourceKind?: string;
+  resourceId?: string;
+  /** Keyset pagination: return events created strictly before this. */
+  before?: Date;
+  limit?: number;
+};
+
+/** Most-recent-first query for the admin console. */
+export async function queryAuditEvents(options: QueryAuditEventsOptions = {}) {
+  const filters = [
+    options.workspaceId
+      ? eq(auditEvents.workspaceId, options.workspaceId)
+      : undefined,
+    options.action ? eq(auditEvents.action, options.action) : undefined,
+    options.resourceKind
+      ? eq(auditEvents.resourceKind, options.resourceKind)
+      : undefined,
+    options.resourceId
+      ? eq(auditEvents.resourceId, options.resourceId)
+      : undefined,
+    options.before ? lt(auditEvents.createdAt, options.before) : undefined,
+  ].filter(Boolean);
+
+  return db
+    .select()
+    .from(auditEvents)
+    .where(filters.length > 0 ? and(...filters) : undefined)
+    .orderBy(desc(auditEvents.createdAt))
+    .limit(Math.min(options.limit ?? 50, 500));
+}
+
+export { auditEvents } from "./db/schema";
+export type { AuditEvent, InsertAuditEvent } from "./db/schema";
+
+// Memory-audit event contract — see ./memory-audit.ts for
+// why this is a type-only re-export rather than a second writer.
+export type {
+  AuditTargetKind as MemoryAuditTargetKind,
+  AuditAction as MemoryAuditAction,
+  AuditActorKind as MemoryAuditActorKind,
+  UserMemoryAuditRow,
+  InsertUserMemoryAudit,
+  RecordMemoryAuditInput,
+} from "./memory-audit";

package/src/memory-audit.ts

@@ -0,0 +1,43 @@
+/**
+ * Memory-audit event contract.
+ *
+ * `@intelligo-dev/core` may depend on nothing, so the identity module
+ * that owns `user_memory_audit` cannot call a writer defined here; the
+ * write lives in `packages/core/src/identity/audit.ts`. This module is
+ * the public type for packages that depend on `@intelligo-dev/audit`
+ * and want to describe a memory-audit event without reaching into
+ * `@intelligo-dev/core/identity`'s internals.
+ */
+
+import type {
+  AuditTargetKind,
+  AuditAction,
+  AuditActorKind,
+  UserMemoryAuditRow,
+  InsertUserMemoryAudit,
+} from "@intelligo-dev/core/db/schema";
+
+export type {
+  AuditTargetKind,
+  AuditAction,
+  AuditActorKind,
+  UserMemoryAuditRow,
+  InsertUserMemoryAudit,
+};
+
+/**
+ * The shape `recordMemoryAudit` (`packages/core/src/identity/audit.ts`)
+ * accepts.
+ */
+export type RecordMemoryAuditInput = {
+  userId: string;
+  workspaceId: string;
+  targetKind: AuditTargetKind;
+  targetId: string;
+  action: AuditAction;
+  actorKind: AuditActorKind;
+  actorId?: string;
+  beforeValue?: unknown;
+  afterValue?: unknown;
+  reason?: string;
+};