✨ Add a priority score value for ozone subjects

.changeset/fifty-seals-prove.md

@@ -0,0 +1,7 @@
+---
+"@atproto/ozone": patch
+"@atproto/api": patch
+"@atproto/pds": patch
+---
+
+Add a priority score to ozone subjects

lexicons/tools/ozone/moderation/defs.json

@@ -34,7 +34,8 @@
             "#modEventTag",
             "#accountEvent",
             "#identityEvent",
-            "#recordEvent"
+            "#recordEvent",
+            "#modEventPriorityScore"
           ]
         },
         "subject": {
@@ -84,7 +85,8 @@
             "#modEventTag",
             "#accountEvent",
             "#identityEvent",
-            "#recordEvent"
+            "#recordEvent",
+            "#modEventPriorityScore"
           ]
         },
         "subject": {
@@ -143,6 +145,12 @@
           "type": "string",
           "description": "Sticky comment on the subject."
         },
+        "priorityScore": {
+          "type": "integer",
+          "description": "Numeric value representing the level of priority. Higher score means higher priority.",
+          "minimum": 0,
+          "maximum": 100
+        },
         "muteUntil": {
           "type": "string",
           "format": "datetime"
@@ -381,6 +389,21 @@
         }
       }
     },
+    "modEventPriorityScore": {
+      "type": "object",
+      "description": "Set priority score of the subject. Higher score means higher priority.",
+      "required": ["score"],
+      "properties": {
+        "comment": {
+          "type": "string"
+        },
+        "score": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100
+        }
+      }
+    },
     "modEventAcknowledge": {
       "type": "object",
       "properties": {

lexicons/tools/ozone/moderation/emitEvent.json

@@ -30,7 +30,8 @@
                 "tools.ozone.moderation.defs#modEventTag",
                 "tools.ozone.moderation.defs#accountEvent",
                 "tools.ozone.moderation.defs#identityEvent",
-                "tools.ozone.moderation.defs#recordEvent"
+                "tools.ozone.moderation.defs#recordEvent",
+                "tools.ozone.moderation.defs#modEventPriorityScore"
               ]
             },
             "subject": {

lexicons/tools/ozone/moderation/queryStatuses.json

@@ -111,7 +111,8 @@
               "lastReviewedAt",
               "lastReportedAt",
               "reportedRecordsCount",
-              "takendownRecordsCount"
+              "takendownRecordsCount",
+              "priorityScore"
             ]
           },
           "sortDirection": {
@@ -175,6 +176,12 @@
           "minTakendownRecordsCount": {
             "type": "integer",
             "description": "If specified, only subjects that belong to an account that has at least this many taken down records will be returned."
+          },
+          "minPriorityScore": {
+            "minimum": 0,
+            "maximum": 100,
+            "type": "integer",
+            "description": "If specified, only subjects that have priority score value above the given value will be returned."
           }
         }
       },

packages/api/src/client/lexicons.ts

@@ -11148,6 +11148,7 @@ export const schemaDict = {
               'lex:tools.ozone.moderation.defs#accountEvent',
               'lex:tools.ozone.moderation.defs#identityEvent',
               'lex:tools.ozone.moderation.defs#recordEvent',
+              'lex:tools.ozone.moderation.defs#modEventPriorityScore',
             ],
           },
           subject: {
@@ -11215,6 +11216,7 @@ export const schemaDict = {
               'lex:tools.ozone.moderation.defs#accountEvent',
               'lex:tools.ozone.moderation.defs#identityEvent',
               'lex:tools.ozone.moderation.defs#recordEvent',
+              'lex:tools.ozone.moderation.defs#modEventPriorityScore',
             ],
           },
           subject: {
@@ -11294,6 +11296,13 @@ export const schemaDict = {
             type: 'string',
             description: 'Sticky comment on the subject.',
           },
+          priorityScore: {
+            type: 'integer',
+            description:
+              'Numeric value representing the level of priority. Higher score means higher priority.',
+            minimum: 0,
+            maximum: 100,
+          },
           muteUntil: {
             type: 'string',
             format: 'datetime',
@@ -11556,6 +11565,22 @@ export const schemaDict = {
           },
         },
       },
+      modEventPriorityScore: {
+        type: 'object',
+        description:
+          'Set priority score of the subject. Higher score means higher priority.',
+        required: ['score'],
+        properties: {
+          comment: {
+            type: 'string',
+          },
+          score: {
+            type: 'integer',
+            minimum: 0,
+            maximum: 100,
+          },
+        },
+      },
       modEventAcknowledge: {
         type: 'object',
         properties: {
@@ -12179,6 +12204,7 @@ export const schemaDict = {
                   'lex:tools.ozone.moderation.defs#accountEvent',
                   'lex:tools.ozone.moderation.defs#identityEvent',
                   'lex:tools.ozone.moderation.defs#recordEvent',
+                  'lex:tools.ozone.moderation.defs#modEventPriorityScore',
                 ],
               },
               subject: {
@@ -12675,6 +12701,7 @@ export const schemaDict = {
                 'lastReportedAt',
                 'reportedRecordsCount',
                 'takendownRecordsCount',
+                'priorityScore',
               ],
             },
             sortDirection: {
@@ -12745,6 +12772,13 @@ export const schemaDict = {
               description:
                 'If specified, only subjects that belong to an account that has at least this many taken down records will be returned.',
             },
+            minPriorityScore: {
+              minimum: 0,
+              maximum: 100,
+              type: 'integer',
+              description:
+                'If specified, only subjects that have priority score value above the given value will be returned.',
+            },
           },
         },
         output: {

packages/api/src/client/types/tools/ozone/moderation/defs.ts

@@ -33,6 +33,7 @@ export interface ModEventView {
     | AccountEvent
     | IdentityEvent
     | RecordEvent
+    | ModEventPriorityScore
     | { $type: string; [k: string]: unknown }
   subject:
     | ComAtprotoAdminDefs.RepoRef
@@ -80,6 +81,7 @@ export interface ModEventViewDetail {
     | AccountEvent
     | IdentityEvent
     | RecordEvent
+    | ModEventPriorityScore
     | { $type: string; [k: string]: unknown }
   subject:
     | RepoView
@@ -124,6 +126,8 @@ export interface SubjectStatusView {
   reviewState: SubjectReviewState
   /** Sticky comment on the subject. */
   comment?: string
+  /** Numeric value representing the level of priority. Higher score means higher priority. */
+  priorityScore?: number
   muteUntil?: string
   muteReportingUntil?: string
   lastReviewedBy?: string
@@ -364,6 +368,30 @@ export function validateModEventLabel(v: unknown): ValidationResult {
   return lexicons.validate('tools.ozone.moderation.defs#modEventLabel', v)
 }
 
+/** Set priority score of the subject. Higher score means higher priority. */
+export interface ModEventPriorityScore {
+  comment?: string
+  score: number
+  [k: string]: unknown
+}
+
+export function isModEventPriorityScore(
+  v: unknown,
+): v is ModEventPriorityScore {
+  return (
+    isObj(v) &&
+    hasProp(v, '$type') &&
+    v.$type === 'tools.ozone.moderation.defs#modEventPriorityScore'
+  )
+}
+
+export function validateModEventPriorityScore(v: unknown): ValidationResult {
+  return lexicons.validate(
+    'tools.ozone.moderation.defs#modEventPriorityScore',
+    v,
+  )
+}
+
 export interface ModEventAcknowledge {
   comment?: string
   /** If true, all other reports on content authored by this account will be resolved (acknowledged). */

packages/api/src/client/types/tools/ozone/moderation/emitEvent.ts

@@ -31,6 +31,7 @@ export interface InputSchema {
     | ToolsOzoneModerationDefs.AccountEvent
     | ToolsOzoneModerationDefs.IdentityEvent
     | ToolsOzoneModerationDefs.RecordEvent
+    | ToolsOzoneModerationDefs.ModEventPriorityScore
     | { $type: string; [k: string]: unknown }
   subject:
     | ComAtprotoAdminDefs.RepoRef

packages/api/src/client/types/tools/ozone/moderation/queryStatuses.ts

@@ -53,6 +53,7 @@ export interface QueryParams {
     | 'lastReportedAt'
     | 'reportedRecordsCount'
     | 'takendownRecordsCount'
+    | 'priorityScore'
   sortDirection?: 'asc' | 'desc'
   /** Get subjects that were taken down */
   takendown?: boolean
@@ -72,6 +73,8 @@ export interface QueryParams {
   minReportedRecordsCount?: number
   /** If specified, only subjects that belong to an account that has at least this many taken down records will be returned. */
   minTakendownRecordsCount?: number
+  /** If specified, only subjects that have priority score value above the given value will be returned. */
+  minPriorityScore?: number
 }
 
 export type InputSchema = undefined

packages/ozone/src/api/util.ts

@@ -157,6 +157,7 @@ const eventTypes = new Set([
   'tools.ozone.moderation.defs#accountEvent',
   'tools.ozone.moderation.defs#identityEvent',
   'tools.ozone.moderation.defs#recordEvent',
+  'tools.ozone.moderation.defs#modEventPriorityScore',
 ])
 
 export const getMemberRole = (role: string) => {

packages/ozone/src/db/migrations/20250204T003647759Z-add-subject-priority-score.ts

@@ -0,0 +1,22 @@
+import { Kysely } from 'kysely'
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+  await db.schema
+    .alterTable('moderation_subject_status')
+    .addColumn('priorityScore', 'integer', (col) =>
+      col.notNull().defaultTo('0'),
+    )
+    .execute()
+  await db.schema
+    .createIndex('moderation_subject_status_priority_score_index')
+    .on('moderation_subject_status')
+    .column('priorityScore')
+    .execute()
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+  await db.schema
+    .alterTable('moderation_subject_status')
+    .dropColumn('priorityScore')
+    .execute()
+}

packages/ozone/src/db/migrations/index.ts

@@ -18,3 +18,4 @@ export * as _20241008T205730722Z from './20241008T205730722Z-sets'
 export * as _20241018T205730722Z from './20241018T205730722Z-setting'
 export * as _20241026T205730722Z from './20241026T205730722Z-add-hosting-status-to-subject-status'
 export * as _20241220T144630860Z from './20241220T144630860Z-stats-materialized-views'
+export * as _20250204T003647759Z from './20250204T003647759Z-add-subject-priority-score'

packages/ozone/src/db/schema/moderation_event.ts

@@ -22,6 +22,7 @@ export interface ModerationEvent {
     | 'tools.ozone.moderation.defs#accountEvent'
     | 'tools.ozone.moderation.defs#identityEvent'
     | 'tools.ozone.moderation.defs#recordEvent'
+    | 'tools.ozone.moderation.defs#modEventPriorityScore'
   subjectType:
     | 'com.atproto.admin.defs#repoRef'
     | 'com.atproto.repo.strongRef'
@@ -38,7 +39,7 @@ export interface ModerationEvent {
   createdBy: string
   durationInHours: number | null
   expiresAt: string | null
-  meta: Record<string, string | boolean> | null
+  meta: Record<string, string | boolean | number> | null
   addedTags: string[] | null
   removedTags: string[] | null
   legacyRefId: number | null

packages/ozone/src/db/schema/moderation_subject_status.ts

@@ -38,6 +38,7 @@ export interface ModerationSubjectStatus {
   appealed: boolean | null
   comment: string | null
   tags: string[] | null
+  priorityScore?: number
 }
 
 export type PartialDB = {