@cat-factory/contracts 0.259.0 → 0.261.0

package/dist/audit.d.ts

@@ -12,7 +12,7 @@ import * as v from 'valibot';
  * run start/stop/retry, the notification `act` (which performs a real merge), and API-key
  * mint/revoke.
  */
-export declare const auditActionSchema: v.PicklistSchema<["account.member_added", "account.member_roles_changed", "account.budget_changed", "account.settings_changed", "account.invitation_created", "account.invitation_revoked", "account.invitation_accepted", "workspace.member_added", "workspace.member_role_changed", "workspace.member_removed", "workspace.access_mode_changed"], undefined>;
+export declare const auditActionSchema: v.PicklistSchema<["account.member_added", "account.member_roles_changed", "account.budget_changed", "account.settings_changed", "account.invitation_created", "account.invitation_revoked", "account.invitation_accepted", "account.member_sessions_revoked", "workspace.member_added", "workspace.member_role_changed", "workspace.member_removed", "workspace.access_mode_changed"], undefined>;
 export type AuditAction = v.InferOutput<typeof auditActionSchema>;
 /**
  * WHAT KIND of thing an audited action acted on: the type `targetId` is an id WITHIN.
@@ -97,4 +97,117 @@ export declare function isAuditTargetType(value: string): value is AuditTargetTy
 export declare function readAuditAction(value: string): AuditAction | RetiredAuditValue;
 /** A stored `targetType` as either a current member or the retired value it is. */
 export declare function readAuditTargetType(value: string): AuditTargetType | RetiredAuditValue;
+/** A persisted vocabulary member this build no longer declares, on the wire. */
+export declare const retiredAuditValueSchema: v.ObjectSchema<{
+    readonly retired: v.StringSchema<undefined>;
+}, undefined>;
+/**
+ * The acting principal, as the three shapes it can take.
+ *
+ * A union rather than `{ kind, id }`, so the id's MEANING travels with it: `usr_*` resolves
+ * against the user roster and `pak_*` against the API-key list, and a viewer handed a bare id
+ * would have to guess which. `system` carries no id at all, which is what stops it being confused
+ * with a principal whose name merely failed to resolve.
+ */
+export declare const auditActorSchema: v.VariantSchema<"kind", [v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"user", undefined>;
+    readonly userId: v.StringSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"apiKey", undefined>;
+    readonly apiKeyId: v.StringSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly kind: v.LiteralSchema<"system", undefined>;
+}, undefined>], undefined>;
+/** One audit event as the viewer renders it. */
+export declare const auditEventViewSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    /** Epoch ms the action committed. */
+    readonly at: v.NumberSchema<undefined>;
+    /** The board it happened on, when the action was board-scoped. */
+    readonly workspaceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly actor: v.VariantSchema<"kind", [v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"user", undefined>;
+        readonly userId: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"apiKey", undefined>;
+        readonly apiKeyId: v.StringSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly kind: v.LiteralSchema<"system", undefined>;
+    }, undefined>], undefined>;
+    /**
+     * Unions with the retired shape for the reason stated on {@link RetiredAuditValue}: the row
+     * outlives the vocabulary it was written against, and a viewer mapping actions to copy through
+     * an exhaustive `Record` would otherwise splice `undefined` into an admin's screen.
+     */
+    readonly action: v.UnionSchema<[v.PicklistSchema<["account.member_added", "account.member_roles_changed", "account.budget_changed", "account.settings_changed", "account.invitation_created", "account.invitation_revoked", "account.invitation_accepted", "account.member_sessions_revoked", "workspace.member_added", "workspace.member_role_changed", "workspace.member_removed", "workspace.access_mode_changed"], undefined>, v.ObjectSchema<{
+        readonly retired: v.StringSchema<undefined>;
+    }, undefined>], undefined>;
+    readonly targetType: v.UnionSchema<[v.PicklistSchema<["user", "invitation", "workspace", "account"], undefined>, v.ObjectSchema<{
+        readonly retired: v.StringSchema<undefined>;
+    }, undefined>], undefined>;
+    readonly targetId: v.StringSchema<undefined>;
+    /** Machine-readable values, interpolated into translated copy. See {@link AUDIT_ACTION_DETAIL_KEYS}. */
+    readonly details: v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>], undefined>, undefined>, undefined>;
+    /**
+     * Display name for the ACTOR, resolved server-side, or null.
+     *
+     * Null is a real and expected answer, not a failure: an audit log outlives the people in it, and
+     * "the user who did this no longer exists" is exactly the kind of thing it is kept to record. The
+     * viewer renders the id in that case rather than an empty space, so a row never reads as though
+     * nobody performed it.
+     */
+    readonly actorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /** Display name for the TARGET when it is a user, resolved server-side, or null. As above. */
+    readonly targetName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type AuditEventWire = v.InferOutput<typeof auditEventViewSchema>;
+/** One page of an account's audit log, newest first. */
+export declare const auditEventPageSchema: v.ObjectSchema<{
+    readonly events: v.ArraySchema<v.ObjectSchema<{
+        readonly id: v.StringSchema<undefined>;
+        /** Epoch ms the action committed. */
+        readonly at: v.NumberSchema<undefined>;
+        /** The board it happened on, when the action was board-scoped. */
+        readonly workspaceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly actor: v.VariantSchema<"kind", [v.ObjectSchema<{
+            readonly kind: v.LiteralSchema<"user", undefined>;
+            readonly userId: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly kind: v.LiteralSchema<"apiKey", undefined>;
+            readonly apiKeyId: v.StringSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly kind: v.LiteralSchema<"system", undefined>;
+        }, undefined>], undefined>;
+        /**
+         * Unions with the retired shape for the reason stated on {@link RetiredAuditValue}: the row
+         * outlives the vocabulary it was written against, and a viewer mapping actions to copy through
+         * an exhaustive `Record` would otherwise splice `undefined` into an admin's screen.
+         */
+        readonly action: v.UnionSchema<[v.PicklistSchema<["account.member_added", "account.member_roles_changed", "account.budget_changed", "account.settings_changed", "account.invitation_created", "account.invitation_revoked", "account.invitation_accepted", "account.member_sessions_revoked", "workspace.member_added", "workspace.member_role_changed", "workspace.member_removed", "workspace.access_mode_changed"], undefined>, v.ObjectSchema<{
+            readonly retired: v.StringSchema<undefined>;
+        }, undefined>], undefined>;
+        readonly targetType: v.UnionSchema<[v.PicklistSchema<["user", "invitation", "workspace", "account"], undefined>, v.ObjectSchema<{
+            readonly retired: v.StringSchema<undefined>;
+        }, undefined>], undefined>;
+        readonly targetId: v.StringSchema<undefined>;
+        /** Machine-readable values, interpolated into translated copy. See {@link AUDIT_ACTION_DETAIL_KEYS}. */
+        readonly details: v.RecordSchema<v.StringSchema<undefined>, v.NullableSchema<v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>, v.BooleanSchema<undefined>], undefined>, undefined>, undefined>;
+        /**
+         * Display name for the ACTOR, resolved server-side, or null.
+         *
+         * Null is a real and expected answer, not a failure: an audit log outlives the people in it, and
+         * "the user who did this no longer exists" is exactly the kind of thing it is kept to record. The
+         * viewer renders the id in that case rather than an empty space, so a row never reads as though
+         * nobody performed it.
+         */
+        readonly actorName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /** Display name for the TARGET when it is a user, resolved server-side, or null. As above. */
+        readonly targetName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    /**
+     * Opaque cursor for the next (older) page, or null at the end. Keyset, never an offset: the
+     * log grows while it is being read, and an offset would re-serve or skip rows at every boundary.
+     */
+    readonly nextCursor: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
 //# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4B5B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,gWAuB5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,6EAShC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,2DAO/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAY3E,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AAE/D,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,KAAK,EAAE,CAAC,GAAG,iBAAiB,GAC3B,KAAK,IAAI,iBAAiB,CAE5B;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAE9E;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,iBAAiB,CAEtF"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AA4B5B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,mYA8B5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,6EAShC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,2DAO/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAiB3E,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;AAE/D,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,KAAK,EAAE,CAAC,GAAG,iBAAiB,GAC3B,KAAK,IAAI,iBAAiB,CAE5B;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAE9E;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,iBAAiB,CAEtF;AAOD,gFAAgF;AAChF,eAAO,MAAM,uBAAuB;;aAAoC,CAAA;AAExE;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;0BAI3B,CAAA;AAEF,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;IAE/B,qCAAqC;;IAErC,kEAAkE;;;;;;;;;;;IAGlE;;;;OAIG;;;;;;;;IAIH,wGAAwG;;IAExG;;;;;;;OAOG;;IAEH,8FAA8F;;aAE9F,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,wDAAwD;AACxD,eAAO,MAAM,oBAAoB;;;QA9B/B,qCAAqC;;QAErC,kEAAkE;;;;;;;;;;;QAGlE;;;;WAIG;;;;;;;;QAIH,wGAAwG;;QAExG;;;;;;;WAOG;;QAEH,8FAA8F;;;IAQ9F;;;OAGG;;aAEH,CAAA"}

package/dist/audit.js

@@ -52,6 +52,13 @@ export const auditActionSchema = v.picklist([
     'account.invitation_revoked',
     /** An invitation was accepted, creating the membership it granted. */
     'account.invitation_accepted',
+    /**
+     * An admin ended every session a member currently held (offboarding, a lost device). Distinct
+     * from a role change: this withdraws AUTHENTICATION, not permissions, and the member keeps their
+     * roles. Self-serve "sign out everywhere" is deliberately NOT recorded as this action — nobody's
+     * admin performed it, and there is no account it belongs to.
+     */
+    'account.member_sessions_revoked',
     /** A member was added to one workspace (board-level roster, not the account roster). */
     'workspace.member_added',
     /** A workspace member's role was changed. */
@@ -123,6 +130,11 @@ export const AUDIT_ACTION_DETAIL_KEYS = {
     'account.invitation_created': ['email', 'roles'],
     'account.invitation_revoked': ['email'],
     'account.invitation_accepted': ['email', 'roles', 'invitedBy'],
+    // No values: WHO revoked WHOSE sessions and WHEN is the whole fact, and all three are columns
+    // already. The new generation is deliberately not recorded — it is an internal counter, and a
+    // reader comparing two of them would be inferring how many revocations went unlogged rather
+    // than reading the rows that state them.
+    'account.member_sessions_revoked': [],
     'workspace.member_added': ['role'],
     'workspace.member_role_changed': ['previousRole', 'role'],
     'workspace.member_removed': ['role'],
@@ -153,4 +165,62 @@ export function readAuditAction(value) {
 export function readAuditTargetType(value) {
     return isAuditTargetType(value) ? value : { retired: value };
 }
+// ---------------------------------------------------------------------------
+// The WIRE shapes the viewer reads. Separate from the vocabulary above because a read must cope
+// with values a write cannot produce: a member retired since the row was written.
+// ---------------------------------------------------------------------------
+/** A persisted vocabulary member this build no longer declares, on the wire. */
+export const retiredAuditValueSchema = v.object({ retired: v.string() });
+/**
+ * The acting principal, as the three shapes it can take.
+ *
+ * A union rather than `{ kind, id }`, so the id's MEANING travels with it: `usr_*` resolves
+ * against the user roster and `pak_*` against the API-key list, and a viewer handed a bare id
+ * would have to guess which. `system` carries no id at all, which is what stops it being confused
+ * with a principal whose name merely failed to resolve.
+ */
+export const auditActorSchema = v.variant('kind', [
+    v.object({ kind: v.literal('user'), userId: v.string() }),
+    v.object({ kind: v.literal('apiKey'), apiKeyId: v.string() }),
+    v.object({ kind: v.literal('system') }),
+]);
+/** One audit event as the viewer renders it. */
+export const auditEventViewSchema = v.object({
+    id: v.string(),
+    /** Epoch ms the action committed. */
+    at: v.number(),
+    /** The board it happened on, when the action was board-scoped. */
+    workspaceId: v.nullable(v.string()),
+    actor: auditActorSchema,
+    /**
+     * Unions with the retired shape for the reason stated on {@link RetiredAuditValue}: the row
+     * outlives the vocabulary it was written against, and a viewer mapping actions to copy through
+     * an exhaustive `Record` would otherwise splice `undefined` into an admin's screen.
+     */
+    action: v.union([auditActionSchema, retiredAuditValueSchema]),
+    targetType: v.union([auditTargetTypeSchema, retiredAuditValueSchema]),
+    targetId: v.string(),
+    /** Machine-readable values, interpolated into translated copy. See {@link AUDIT_ACTION_DETAIL_KEYS}. */
+    details: v.record(v.string(), v.nullable(v.union([v.string(), v.number(), v.boolean()]))),
+    /**
+     * Display name for the ACTOR, resolved server-side, or null.
+     *
+     * Null is a real and expected answer, not a failure: an audit log outlives the people in it, and
+     * "the user who did this no longer exists" is exactly the kind of thing it is kept to record. The
+     * viewer renders the id in that case rather than an empty space, so a row never reads as though
+     * nobody performed it.
+     */
+    actorName: v.nullable(v.string()),
+    /** Display name for the TARGET when it is a user, resolved server-side, or null. As above. */
+    targetName: v.nullable(v.string()),
+});
+/** One page of an account's audit log, newest first. */
+export const auditEventPageSchema = v.object({
+    events: v.array(auditEventViewSchema),
+    /**
+     * Opaque cursor for the next (older) page, or null at the end. Keyset, never an offset: the
+     * log grows while it is being read, and an offset would re-serve or skip rows at every boundary.
+     */
+    nextCursor: v.nullable(v.string()),
+});
 //# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}

package/dist/documents.d.ts

@@ -74,6 +74,72 @@ export declare function isHostPinnedSource(source: DocumentSourceKind): boolean;
 export declare function orderSourcesByClaimConfidence<T extends {
     kind: DocumentSourceKind;
 }>(sources: readonly T[]): T[];
+/**
+ * Why the platform could not confirm a source-backed document against its source. Each member
+ * needs a DIFFERENT fix, which is the whole reason they are not one value:
+ *
+ * - `not_connected`: the workspace's connection to the source is gone (revoked/disconnected), so
+ *   reconnecting it is the remedy.
+ * - `credentials_unreadable`: the connection could not be READ at all, so the platform never got
+ *   as far as asking the source. Distinct from `not_connected` (a definite "there is no
+ *   connection") because the remedy is the deployment's, not the workspace's, and distinct from
+ *   `source_unreachable` because the source is not the thing that failed. What makes it
+ *   load-bearing rather than defensive is MOTHERSHIP MODE, where a document-source connection is
+ *   sealed with the mothership's key and therefore cannot be served to a node at all: the read
+ *   fails permanently and by design there, and reporting it as an outage would send an operator
+ *   hunting a Figma incident that does not exist.
+ * - `unversioned`: the source answered but exposes no version token to compare, so there is
+ *   nothing to fix. Saying so beats implying the copy was checked.
+ * - `source_unreachable`: the probe or the re-fetch failed (a 403, a rate limit, an outage). The
+ *   stored body is still served; the operator's log line carries the cause.
+ *
+ * It lives HERE rather than in kernel because both sides have to agree about it: the engine
+ * renders the agent-facing warning from it, and the SPA states the same verdict to a human in
+ * their own language off an exhaustive `Record` keyed by these members (the backend does not
+ * localize prose).
+ */
+export declare const documentFreshnessGapSchema: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+export type DocumentFreshnessGap = v.InferOutput<typeof documentFreshnessGapSchema>;
+/**
+ * What a confirmed check found had changed in the board's copy. None of the three is a degradation
+ * (all leave the reader on the live revision), but they answer "did my edit land" differently and
+ * the middle one is the reason this is not a boolean:
+ *
+ * - `unchanged`: the source is still at the revision the stored copy was taken from. Nothing was
+ *   fetched and nothing was written.
+ * - `reimported`: the source had moved on, and the copy an agent reads was rewritten from it.
+ * - `revision_only`: the source's revision token moved, but nothing an agent reads differs. This is
+ *   the NORMAL case for a whole-file source with a per-file version: a Figma file's version bumps on
+ *   any edit anywhere in it, including frames a given document does not cover. Folding it into
+ *   `reimported` would tell a person their design was pulled in when their own edit may not have
+ *   been touched at all, and it is exactly the false confidence this vocabulary exists to remove.
+ *
+ * A closed picklist rather than a boolean for the same reason `DocumentFreshnessGap` is: the SPA
+ * keys translated copy off these members, and adding one has to fail a build rather than render an
+ * empty line.
+ */
+export declare const documentFreshnessChangeSchema: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+export type DocumentFreshnessChange = v.InferOutput<typeof documentFreshnessChangeSchema>;
+/**
+ * What a refresh attempt concluded about one linked document.
+ *
+ * A source-backed document is a PROJECTION of a page someone else keeps editing, so "is the copy
+ * we are about to read the current one" is a question with THREE answers, not two. "No source to
+ * confirm against" and "tried and failed" are different facts: an `upload` has nothing to be stale
+ * relative to, while a Figma file the API refused may well be behind the live design. Only the
+ * second is a warning, and only a `confirmed` verdict can name a revision.
+ */
+export declare const documentFreshnessSchema: v.VariantSchema<"status", [v.ObjectSchema<{
+    readonly status: v.LiteralSchema<"confirmed", undefined>;
+    readonly version: v.StringSchema<undefined>;
+    readonly change: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly status: v.LiteralSchema<"not-applicable", undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly status: v.LiteralSchema<"unconfirmed", undefined>;
+    readonly reason: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+}, undefined>], undefined>;
+export type DocumentFreshness = v.InferOutput<typeof documentFreshnessSchema>;
 /**
  * The role a workspace+`DocKind`-scoped document link plays for the forward document-authoring
  * track (WS1 items 2–4). A `template` link's parsed sections REPLACE the built-in skeleton for
@@ -315,6 +381,68 @@ export type ResolvedDocumentRef = v.InferOutput<typeof resolvedDocumentRefSchema
  */
 export declare const documentRefReasonSchema: v.PicklistSchema<["document_ref_unrecognized", "document_ref_claimed_by_other_source"], undefined>;
 export type DocumentRefReason = v.InferOutput<typeof documentRefReasonSchema>;
+/**
+ * Re-confirm ONE stored document against its source right now: probe, and re-import if the page
+ * moved. The same ladder every dispatch runs, asked for by a person instead of by a run.
+ *
+ * `source` is the NARROW union, so an `upload` is refused at the boundary rather than answered
+ * with a `not-applicable` verdict. There is no provider to ask about a body the platform was
+ * handed directly, and a 200 saying so would leave the caller unable to tell "this document has no
+ * source" from "the check ran and found nothing to compare", which is exactly the distinction the
+ * freshness vocabulary exists to keep.
+ */
+export declare const refreshDocumentSchema: v.ObjectSchema<{
+    readonly source: v.PicklistSchema<["confluence", "notion", "github", "figma", "zeplin", "linear"], undefined>;
+    readonly externalId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type RefreshDocumentInput = v.InferOutput<typeof refreshDocumentSchema>;
+/**
+ * The refreshed projection plus what the check concluded about it.
+ *
+ * Both halves, because neither answers on its own: the document carries the (possibly rewritten)
+ * title/excerpt/`syncedAt` a caller has to re-render, and the verdict is the only thing that says
+ * whether the copy was CONFIRMED current. An unchanged document with an `unconfirmed` verdict and
+ * one with a `confirmed` one are byte-for-byte identical rows and opposite facts.
+ */
+export declare const refreshedDocumentViewSchema: v.ObjectSchema<{
+    readonly document: v.ObjectSchema<{
+        readonly source: v.PicklistSchema<["confluence", "notion", "github", "figma", "zeplin", "linear", "upload"], undefined>;
+        /** The source's stable id for the page (Confluence page id, Notion page id). */
+        readonly externalId: v.StringSchema<undefined>;
+        readonly title: v.StringSchema<undefined>;
+        /**
+         * Canonical URL of the page on the source, or EMPTY for an `upload`, which has no page to
+         * link back to. Readers render the origin only when there is one: an empty parenthetical or a
+         * bare `Source:` line reads as a broken link rather than as a document that never had one.
+         */
+        readonly url: v.StringSchema<undefined>;
+        /** A short plain-text excerpt of the body (full body stays in storage). */
+        readonly excerpt: v.StringSchema<undefined>;
+        /** The board block this document is attached to as context, if any. */
+        readonly linkedBlockId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The workspace+`DocKind` link role this document plays, if any — `template` (its parsed
+         * sections override the kind's built-in skeleton) or `exemplar` (a good example to emulate).
+         * Null for a plain imported/block-linked document. Paired with {@link docKind}.
+         */
+        readonly role: v.NullableSchema<v.PicklistSchema<["template", "exemplar"], undefined>, undefined>;
+        /** The document kind a `role`-tagged link is scoped to (null when the document carries no role). */
+        readonly docKind: v.NullableSchema<v.PicklistSchema<readonly ["prd", "rfc", "adr", "design", "technical", "api", "runbook", "research", "reference", "other"], undefined>, undefined>;
+        /** When this projection row was last refreshed (epoch ms). */
+        readonly syncedAt: v.NumberSchema<undefined>;
+    }, undefined>;
+    readonly freshness: v.VariantSchema<"status", [v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"confirmed", undefined>;
+        readonly version: v.StringSchema<undefined>;
+        readonly change: v.PicklistSchema<["unchanged", "reimported", "revision_only"], undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"not-applicable", undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly status: v.LiteralSchema<"unconfirmed", undefined>;
+        readonly reason: v.PicklistSchema<["not_connected", "credentials_unreadable", "unversioned", "source_unreachable"], undefined>;
+    }, undefined>], undefined>;
+}, undefined>;
+export type RefreshedDocumentView = v.InferOutput<typeof refreshedDocumentViewSchema>;
 /** Search a source's catalogue by free text (title/content). */
 export declare const searchDocumentsSchema: v.ObjectSchema<{
     readonly query: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;

package/dist/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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"}

package/dist/documents.js

@@ -96,6 +96,88 @@ export function orderSourcesByClaimConfidence(sources) {
         ...sources.filter((s) => !isHostPinnedSource(s.kind)),
     ];
 }
+// ---- Freshness: how current a stored projection is ------------------------
+/**
+ * Why the platform could not confirm a source-backed document against its source. Each member
+ * needs a DIFFERENT fix, which is the whole reason they are not one value:
+ *
+ * - `not_connected`: the workspace's connection to the source is gone (revoked/disconnected), so
+ *   reconnecting it is the remedy.
+ * - `credentials_unreadable`: the connection could not be READ at all, so the platform never got
+ *   as far as asking the source. Distinct from `not_connected` (a definite "there is no
+ *   connection") because the remedy is the deployment's, not the workspace's, and distinct from
+ *   `source_unreachable` because the source is not the thing that failed. What makes it
+ *   load-bearing rather than defensive is MOTHERSHIP MODE, where a document-source connection is
+ *   sealed with the mothership's key and therefore cannot be served to a node at all: the read
+ *   fails permanently and by design there, and reporting it as an outage would send an operator
+ *   hunting a Figma incident that does not exist.
+ * - `unversioned`: the source answered but exposes no version token to compare, so there is
+ *   nothing to fix. Saying so beats implying the copy was checked.
+ * - `source_unreachable`: the probe or the re-fetch failed (a 403, a rate limit, an outage). The
+ *   stored body is still served; the operator's log line carries the cause.
+ *
+ * It lives HERE rather than in kernel because both sides have to agree about it: the engine
+ * renders the agent-facing warning from it, and the SPA states the same verdict to a human in
+ * their own language off an exhaustive `Record` keyed by these members (the backend does not
+ * localize prose).
+ */
+export const documentFreshnessGapSchema = v.picklist([
+    'not_connected',
+    'credentials_unreadable',
+    'unversioned',
+    'source_unreachable',
+]);
+/**
+ * What a confirmed check found had changed in the board's copy. None of the three is a degradation
+ * (all leave the reader on the live revision), but they answer "did my edit land" differently and
+ * the middle one is the reason this is not a boolean:
+ *
+ * - `unchanged`: the source is still at the revision the stored copy was taken from. Nothing was
+ *   fetched and nothing was written.
+ * - `reimported`: the source had moved on, and the copy an agent reads was rewritten from it.
+ * - `revision_only`: the source's revision token moved, but nothing an agent reads differs. This is
+ *   the NORMAL case for a whole-file source with a per-file version: a Figma file's version bumps on
+ *   any edit anywhere in it, including frames a given document does not cover. Folding it into
+ *   `reimported` would tell a person their design was pulled in when their own edit may not have
+ *   been touched at all, and it is exactly the false confidence this vocabulary exists to remove.
+ *
+ * A closed picklist rather than a boolean for the same reason `DocumentFreshnessGap` is: the SPA
+ * keys translated copy off these members, and adding one has to fail a build rather than render an
+ * empty line.
+ */
+export const documentFreshnessChangeSchema = v.picklist([
+    'unchanged',
+    'reimported',
+    'revision_only',
+]);
+/**
+ * What a refresh attempt concluded about one linked document.
+ *
+ * A source-backed document is a PROJECTION of a page someone else keeps editing, so "is the copy
+ * we are about to read the current one" is a question with THREE answers, not two. "No source to
+ * confirm against" and "tried and failed" are different facts: an `upload` has nothing to be stale
+ * relative to, while a Figma file the API refused may well be behind the live design. Only the
+ * second is a warning, and only a `confirmed` verdict can name a revision.
+ */
+export const documentFreshnessSchema = v.variant('status', [
+    /**
+     * Checked against the source, which is now known to be the revision named here. What the check
+     * had to DO to get there is {@link DocumentFreshnessChange}.
+     */
+    v.object({
+        status: v.literal('confirmed'),
+        version: v.string(),
+        change: documentFreshnessChangeSchema,
+    }),
+    /**
+     * Nothing to confirm against: an `upload` body the platform was handed directly, or a source
+     * this deployment has no provider wired for. Not a gap and not a warning, because no fresher
+     * copy exists.
+     */
+    v.object({ status: v.literal('not-applicable') }),
+    /** The platform tried and could not confirm. The stored body stands; see the reason. */
+    v.object({ status: v.literal('unconfirmed'), reason: documentFreshnessGapSchema }),
+]);
 /**
  * The role a workspace+`DocKind`-scoped document link plays for the forward document-authoring
  * track (WS1 items 2–4). A `template` link's parsed sections REPLACE the built-in skeleton for
@@ -292,6 +374,33 @@ export const documentRefReasonSchema = v.picklist([
     'document_ref_unrecognized',
     'document_ref_claimed_by_other_source',
 ]);
+// ---- Manual refresh (the human dual of the dispatch-time one) --------------
+/**
+ * Re-confirm ONE stored document against its source right now: probe, and re-import if the page
+ * moved. The same ladder every dispatch runs, asked for by a person instead of by a run.
+ *
+ * `source` is the NARROW union, so an `upload` is refused at the boundary rather than answered
+ * with a `not-applicable` verdict. There is no provider to ask about a body the platform was
+ * handed directly, and a 200 saying so would leave the caller unable to tell "this document has no
+ * source" from "the check ran and found nothing to compare", which is exactly the distinction the
+ * freshness vocabulary exists to keep.
+ */
+export const refreshDocumentSchema = v.object({
+    source: documentSourceKindSchema,
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+/**
+ * The refreshed projection plus what the check concluded about it.
+ *
+ * Both halves, because neither answers on its own: the document carries the (possibly rewritten)
+ * title/excerpt/`syncedAt` a caller has to re-render, and the verdict is the only thing that says
+ * whether the copy was CONFIRMED current. An unchanged document with an `unconfirmed` verdict and
+ * one with a `confirmed` one are byte-for-byte identical rows and opposite facts.
+ */
+export const refreshedDocumentViewSchema = v.object({
+    document: sourceDocumentSchema,
+    freshness: documentFreshnessSchema,
+});
 /** Search a source's catalogue by free text (title/content). */
 export const searchDocumentsSchema = v.object({
     query: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200)),

package/dist/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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"}

package/dist/merge.d.ts

@@ -2818,6 +2818,13 @@ export declare const mergeDecisionSchema: v.ObjectSchema<{
      *  - `within_thresholds`: auto-merged; every axis at/below the preset ceiling.
      *  - `exceeded_thresholds`: review; one or more axes over the ceiling (`exceededAxes`).
      *  - `auto_merge_disabled`: review; the preset routes every PR to a human.
+     *  - `no_policy_configured`: review; NO preset resolved at all (no preset library is wired),
+     *    so the run fell back to the built-in `FALLBACK_RISK_POLICY`, which auto-merges nothing. A
+     *    board's library is written when it is created, so this is a deployment-level fact rather
+     *    than a board nobody had opened yet. Kept apart from `auto_merge_disabled`
+     *    because the remedies have nothing in common: that one names a preset somebody chose and is
+     *    fixed by editing it, while this one says the deployment has stated no merge policy, and a
+     *    reader sent looking for the preset that held their PR back would not find one.
      *  - `no_rationale`: review; the merger returned scores but no rationale, so the verdict
      *    can't be trusted to auto-merge (the assessment IS present, just not credible).
      *  - `no_assessment`: review; the merger produced no parseable assessment at all.
@@ -2847,7 +2854,7 @@ export declare const mergeDecisionSchema: v.ObjectSchema<{
      *    a preset that would otherwise auto-merge must not report a dry run's PR as "held back by
      *    the scores", which would send someone editing thresholds that were never consulted.
      */
-    readonly reason: v.PicklistSchema<["within_thresholds", "exceeded_thresholds", "auto_merge_disabled", "no_rationale", "no_assessment", "merge_failed", "merge_partial", "class_auto_merge", "class_requires_review", "role_requires_review", "submission_not_allowed", "dry_run"], undefined>;
+    readonly reason: v.PicklistSchema<["within_thresholds", "exceeded_thresholds", "auto_merge_disabled", "no_policy_configured", "no_rationale", "no_assessment", "merge_failed", "merge_partial", "class_auto_merge", "class_requires_review", "role_requires_review", "submission_not_allowed", "dry_run"], undefined>;
     /** The merger's assessment (absent only when it produced no parseable one). */
     readonly assessment: v.OptionalSchema<v.ObjectSchema<{
         /** How intricate the change is (size, coupling, subtlety). */