@reqquest/ui 1.10.0 → 1.12.0

package/dist/typed-client/schema.d.ts

@@ -8,6 +8,8 @@ export type Scalars = {
     String: string;
 };
 export interface Access {
+    /** Current user is permitted to create announcements. */
+    createAnnouncement: Scalars['Boolean'];
     /** Current user may create a new app request on behalf of another user and should be shown the Create App Request button on the reviewer dashboard or main app request list. */
     createAppRequestOther: Scalars['Boolean'];
     /** Current user may create a new app request for themselves and should be shown the Create App Request button. */
@@ -16,6 +18,10 @@ export interface Access {
     createPeriod: Scalars['Boolean'];
     /** Current user is permitted to create new roles in the role management UI. */
     createRole: Scalars['Boolean'];
+    /** Current user is permitted to delete announcements. */
+    deleteAnnouncement: Scalars['Boolean'];
+    /** Current user is permitted to update announcements. */
+    updateAnnouncement: Scalars['Boolean'];
     /** The current user, if any. */
     user: (AccessUser | null);
     /** Current user is permitted to view the app request list. */
@@ -154,6 +160,27 @@ export interface AccessUserIdentifier {
     label: Scalars['String'];
     __typename: 'AccessUserIdentifier';
 }
+/** A site-wide announcement shown to users, optionally limited to a date range. */
+export interface Announcement {
+    /** The content of the announcement in HTML. */
+    body: Scalars['String'];
+    /** Whether the announcement has been turned on. A disabled announcement never displays, regardless of its date range. */
+    enabled: Scalars['Boolean'];
+    /** The announcement will not display after this date. Null means it displays until it is disabled. */
+    end: (Scalars['DateTime'] | null);
+    id: Scalars['ID'];
+    /** URL the announcement directs the user to for more information. */
+    link: (Scalars['String'] | null);
+    /** The text to display for the link. */
+    linkText: (Scalars['String'] | null);
+    /** The announcement will not display before this date. Null means it displays as soon as it is enabled. */
+    start: (Scalars['DateTime'] | null);
+    /** Short headline for the announcement. */
+    subject: Scalars['String'];
+    /** The type of announcement, toggleable or date range */
+    type: Scalars['String'];
+    __typename: 'Announcement';
+}
 /** Represents a group of applications all being applied for at the same time. As part of the request, multiple applications will be created and either eliminated as ineligible or submitted for approval. */
 export interface AppRequest {
     /** Actions the user can take on this app request. */
@@ -295,6 +322,12 @@ export interface Application {
     /** The program key this application corresponds to. */
     programKey: Scalars['String'];
     requirements: ApplicationRequirement[];
+    /** The reason the application was rescinded */
+    rescindedReason: (Scalars['String'] | null);
+    /** The application rescinded status */
+    rescindedStatus: (ApplicationRescindedStatus | null);
+    /** The reason the application was restored after previously being rescinded */
+    restoredReason: (Scalars['String'] | null);
     status: ApplicationStatus;
     /** When one of the application's requirements is failing or throwing a warning, its reason will be copied here for convenience. If there is a warning and then later a failure, the failure reason will win. */
     statusReason: (Scalars['String'] | null);
@@ -308,6 +341,8 @@ export interface Application {
 }
 export interface ApplicationActions {
     advanceWorkflow: Scalars['Boolean'];
+    rescindApplication: Scalars['Boolean'];
+    restoreApplication: Scalars['Boolean'];
     reverseWorkflow: Scalars['Boolean'];
     viewAsReviewer: Scalars['Boolean'];
     __typename: 'ApplicationActions';
@@ -318,6 +353,7 @@ export interface ApplicationMetric {
     closed: Scalars['Float'];
     denied: Scalars['Float'];
     entries: ApplicationMetricEntry[];
+    rescinded: Scalars['Float'];
     started: Scalars['Float'];
     submitted: Scalars['Float'];
     toDecision: ApplicationMetricTiming;
@@ -361,6 +397,8 @@ export type ApplicationPhase = 'ACCEPTANCE' | 'APPROVAL' | 'COMPLETE' | 'PREAPPR
 /** The specific instance of a requirement on a particular application. Stores the status of the requirement, e.g. being satisfied or not. */
 export interface ApplicationRequirement {
     application: Application;
+    /** The prompt keys the requirement named as responsible for its current status. Used to attach status indicators to the specific answers at fault instead of every prompt the requirement consults. Null when the requirement did not name any, in which case all of its prompts are implicated. */
+    blame: (Scalars['String'][] | null);
     /** The configuration data for this requirement in the app request's period. */
     configurationData: (Scalars['JsonData'] | null);
     /** An internal description of the requirement. Probably not shown to users. */
@@ -385,6 +423,12 @@ export interface ApplicationRequirement {
     workflowStage: (PeriodWorkflowStage | null);
     __typename: 'ApplicationRequirement';
 }
+/**
+ *
+ *     The rescinded status of an application.
+ *
+ */
+export type ApplicationRescindedStatus = 'RESCINDED' | 'RESTORED';
 /**
  *
  *     The status of an application. This is usually a computed field, not stored in the database. The status
@@ -393,7 +437,7 @@ export interface ApplicationRequirement {
  *     closure / cancellation.
  *
  */
-export type ApplicationStatus = 'ACCEPTED' | 'ELIGIBLE' | 'INELIGIBLE' | 'PENDING' | 'REJECTED';
+export type ApplicationStatus = 'ACCEPTED' | 'ELIGIBLE' | 'INELIGIBLE' | 'PENDING' | 'REJECTED' | 'RESCINDED';
 export interface Category {
     /** This is indexed name of the category. Categories are indexed to allow for quick filtering of a list of items. e.g. institutionalRoles */
     category: Scalars['String'];
@@ -467,15 +511,23 @@ export interface Mutation {
     completeRequest: ValidatedAppRequestResponse;
     /** Make an offer on the app request. If all applications are ineligible, or if there are no acceptance requirements, the applications will advance to the non-blocking workflow, or absent that, be marked complete. */
     completeReview: ValidatedAppRequestResponse;
+    /** Create a new site-wide announcement. */
+    createAnnouncement: ValidatedAnnouncementResponse;
     /** Create a new app request. */
     createAppRequest: ValidatedAppRequestResponse;
     createPeriod: ValidatedPeriodResponse;
+    /** Delete an existing site-wide announcement. */
+    deleteAnnouncement: ValidatedResponse;
     /** Delete an existing note. */
     deleteNote: Scalars['Boolean'];
     deletePeriod: ValidatedResponse;
     markPeriodReviewed: ValidatedPeriodResponse;
     /** Reopen the app request. This is only available if the app request is in a state that allows reopening. */
     reopenAppRequest: ValidatedAppRequestResponse;
+    /** Rescinds the approved and/or accepted application. */
+    rescind: ValidatedAppRequestResponse;
+    /** Restores a previously rescinded application to its previous state. */
+    restore: ValidatedAppRequestResponse;
     /** Return the app request to the applicant phase. This is only available if the app request is in a state that allows returning. */
     returnToApplicant: ValidatedAppRequestResponse;
     /** If request is complete, undo and return to non-blocking workflow. */
@@ -496,6 +548,8 @@ export interface Mutation {
     submitAppRequest: ValidatedAppRequestResponse;
     /** Toggle an existing note's persistent status. */
     togglePersistence: ValidatedNoteResponse;
+    /** Update an existing site-wide announcement. */
+    updateAnnouncement: ValidatedAnnouncementResponse;
     updateConfiguration: ValidatedConfigurationResponse;
     /** Update the content of an existing note. */
     updateNote: ValidatedNoteResponse;
@@ -665,6 +719,8 @@ export interface Query {
      */
     access: Access;
     accessUsers: AccessUser[];
+    /** Retrieve site-wide announcements. Applicants only ever see currently active announcements; users with the Announcement view control see them all. */
+    announcements: Announcement[];
     /** The activity log for this app request. This is a list of actions taken on the app request, such as submission, updating prompts, make an offer, add a note, etc. It will be sorted by the date of the activity in descending order. */
     appRequestActivity: AppRequestActivity[];
     appRequestIndexes: IndexCategory[];
@@ -735,6 +791,14 @@ export interface RoleActions {
     update: Scalars['Boolean'];
     __typename: 'RoleActions';
 }
+export interface ValidatedAnnouncementResponse {
+    /** The created or updated announcement. Null when validateOnly was true or when validation errors prevented the operation. */
+    announcement: (Announcement | null);
+    messages: MutationMessage[];
+    /** True if the mutation succeeded (e.g. saved data or passed validation), even if there were warnings. */
+    success: Scalars['Boolean'];
+    __typename: 'ValidatedAnnouncementResponse';
+}
 export interface ValidatedAppRequestResponse {
     appRequest: (AppRequest | null);
     messages: MutationMessage[];
@@ -771,6 +835,8 @@ export interface ValidatedResponse {
     __typename: 'ValidatedResponse';
 }
 export interface AccessGenqlSelection {
+    /** Current user is permitted to create announcements. */
+    createAnnouncement?: boolean | number;
     /** Current user may create a new app request on behalf of another user and should be shown the Create App Request button on the reviewer dashboard or main app request list. */
     createAppRequestOther?: boolean | number;
     /** Current user may create a new app request for themselves and should be shown the Create App Request button. */
@@ -779,6 +845,10 @@ export interface AccessGenqlSelection {
     createPeriod?: boolean | number;
     /** Current user is permitted to create new roles in the role management UI. */
     createRole?: boolean | number;
+    /** Current user is permitted to delete announcements. */
+    deleteAnnouncement?: boolean | number;
+    /** Current user is permitted to update announcements. */
+    updateAnnouncement?: boolean | number;
     /** The current user, if any. */
     user?: AccessUserGenqlSelection;
     /** Current user is permitted to view the app request list. */
@@ -991,6 +1061,54 @@ export interface AccessUserIdentifierInput {
     id: Scalars['ID'];
     label: Scalars['String'];
 }
+/** A site-wide announcement shown to users, optionally limited to a date range. */
+export interface AnnouncementGenqlSelection {
+    /** The content of the announcement in HTML. */
+    body?: boolean | number;
+    /** Whether the announcement has been turned on. A disabled announcement never displays, regardless of its date range. */
+    enabled?: boolean | number;
+    /** The announcement will not display after this date. Null means it displays until it is disabled. */
+    end?: boolean | number;
+    id?: boolean | number;
+    /** URL the announcement directs the user to for more information. */
+    link?: boolean | number;
+    /** The text to display for the link. */
+    linkText?: boolean | number;
+    /** The announcement will not display before this date. Null means it displays as soon as it is enabled. */
+    start?: boolean | number;
+    /** Short headline for the announcement. */
+    subject?: boolean | number;
+    /** The type of announcement, toggleable or date range */
+    type?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+export interface AnnouncementFilters {
+    /** Return only the announcements that should be displayed at this moment: enabled OR within their date range. */
+    active?: (Scalars['Boolean'] | null);
+    /** Return only enabled (true) or only disabled (false) announcements. */
+    enabled?: (Scalars['Boolean'] | null);
+    /** Return the announcements with these IDs. */
+    ids?: (Scalars['ID'][] | null);
+}
+export interface AnnouncementUpdate {
+    /** The content of the announcement in HTML. Unsafe markup is stripped on save. */
+    body?: (Scalars['String'] | null);
+    /** Whether the announcement has been turned on. */
+    enabled?: (Scalars['Boolean'] | null);
+    /** The announcement will not display after this date. Null means it displays until it is disabled. */
+    end?: (Scalars['DateTime'] | null);
+    /** URL the announcement directs the user to for more information. */
+    link?: (Scalars['String'] | null);
+    /** The text to display for the link. Required when a link is given. */
+    linkText?: (Scalars['String'] | null);
+    /** The announcement will not display before this date. Null means it displays as soon as it is enabled. */
+    start?: (Scalars['DateTime'] | null);
+    /** Short headline for the announcement. */
+    subject?: (Scalars['String'] | null);
+    /** The type of announcement, toggleable or date range */
+    type?: (Scalars['Boolean'] | null);
+}
 /** Represents a group of applications all being applied for at the same time. As part of the request, multiple applications will be created and either eliminated as ineligible or submitted for approval. */
 export interface AppRequestGenqlSelection {
     /** Actions the user can take on this app request. */
@@ -1145,6 +1263,8 @@ export interface AppRequestFilter {
     /** Only return appRequests that are owned by the current user. */
     own?: (Scalars['Boolean'] | null);
     periodIds?: (Scalars['ID'][] | null);
+    /** Only return appRequests where at least one application is in one of the given rescinded states. Rescinding is per-application, so this is independent of the appRequest status. */
+    rescindedStatus?: (ApplicationRescindedStatus[] | null);
     /** Only return appRequests that have had their review started. true -> return review started, false -> return not started. Note that this is NOT mutually exclusive with complete or closed, it very simply means that a non-applicant has taken an action on it. */
     reviewStarted?: (Scalars['Boolean'] | null);
     /** Search for appRequests that match this search term. This will do a prefix search across all fields that are indexed. */
@@ -1214,6 +1334,12 @@ export interface ApplicationGenqlSelection {
     /** The program key this application corresponds to. */
     programKey?: boolean | number;
     requirements?: ApplicationRequirementGenqlSelection;
+    /** The reason the application was rescinded */
+    rescindedReason?: boolean | number;
+    /** The application rescinded status */
+    rescindedStatus?: boolean | number;
+    /** The reason the application was restored after previously being rescinded */
+    restoredReason?: boolean | number;
     status?: boolean | number;
     /** When one of the application's requirements is failing or throwing a warning, its reason will be copied here for convenience. If there is a warning and then later a failure, the failure reason will win. */
     statusReason?: boolean | number;
@@ -1228,6 +1354,8 @@ export interface ApplicationGenqlSelection {
 }
 export interface ApplicationActionsGenqlSelection {
     advanceWorkflow?: boolean | number;
+    rescindApplication?: boolean | number;
+    restoreApplication?: boolean | number;
     reverseWorkflow?: boolean | number;
     viewAsReviewer?: boolean | number;
     __typename?: boolean | number;
@@ -1239,6 +1367,7 @@ export interface ApplicationMetricGenqlSelection {
     closed?: boolean | number;
     denied?: boolean | number;
     entries?: ApplicationMetricEntryGenqlSelection;
+    rescinded?: boolean | number;
     started?: boolean | number;
     submitted?: boolean | number;
     toDecision?: ApplicationMetricTimingGenqlSelection;
@@ -1278,6 +1407,8 @@ export interface ApplicationMetricTimingGenqlSelection {
 /** The specific instance of a requirement on a particular application. Stores the status of the requirement, e.g. being satisfied or not. */
 export interface ApplicationRequirementGenqlSelection {
     application?: ApplicationGenqlSelection;
+    /** The prompt keys the requirement named as responsible for its current status. Used to attach status indicators to the specific answers at fault instead of every prompt the requirement consults. Null when the requirement did not name any, in which case all of its prompts are implicated. */
+    blame?: boolean | number;
     /** The configuration data for this requirement in the app request's period. */
     configurationData?: boolean | number;
     /** An internal description of the requirement. Probably not shown to users. */
@@ -1471,6 +1602,13 @@ export interface MutationGenqlSelection {
             appRequestId: Scalars['ID'];
         };
     });
+    /** Create a new site-wide announcement. */
+    createAnnouncement?: (ValidatedAnnouncementResponseGenqlSelection & {
+        __args: {
+            announcement: AnnouncementUpdate;
+            validateOnly?: (Scalars['Boolean'] | null);
+        };
+    });
     /** Create a new app request. */
     createAppRequest?: (ValidatedAppRequestResponseGenqlSelection & {
         __args: {
@@ -1486,6 +1624,12 @@ export interface MutationGenqlSelection {
             validateOnly?: (Scalars['Boolean'] | null);
         };
     });
+    /** Delete an existing site-wide announcement. */
+    deleteAnnouncement?: (ValidatedResponseGenqlSelection & {
+        __args: {
+            announcementId: Scalars['ID'];
+        };
+    });
     /** Delete an existing note. */
     deleteNote?: {
         __args: {
@@ -1509,6 +1653,22 @@ export interface MutationGenqlSelection {
             appRequestId: Scalars['ID'];
         };
     });
+    /** Rescinds the approved and/or accepted application. */
+    rescind?: (ValidatedAppRequestResponseGenqlSelection & {
+        __args: {
+            applicationId: Scalars['ID'];
+            reason: Scalars['String'];
+            validateOnly?: (Scalars['Boolean'] | null);
+        };
+    });
+    /** Restores a previously rescinded application to its previous state. */
+    restore?: (ValidatedAppRequestResponseGenqlSelection & {
+        __args: {
+            applicationId: Scalars['ID'];
+            reason: Scalars['String'];
+            validateOnly?: (Scalars['Boolean'] | null);
+        };
+    });
     /** Return the app request to the applicant phase. This is only available if the app request is in a state that allows returning. */
     returnToApplicant?: (ValidatedAppRequestResponseGenqlSelection & {
         __args: {
@@ -1589,6 +1749,14 @@ export interface MutationGenqlSelection {
             noteId: Scalars['ID'];
         };
     });
+    /** Update an existing site-wide announcement. */
+    updateAnnouncement?: (ValidatedAnnouncementResponseGenqlSelection & {
+        __args: {
+            announcement: AnnouncementUpdate;
+            announcementId: Scalars['ID'];
+            validateOnly?: (Scalars['Boolean'] | null);
+        };
+    });
     updateConfiguration?: (ValidatedConfigurationResponseGenqlSelection & {
         __args: {
             data: Scalars['JsonData'];
@@ -1848,6 +2016,12 @@ export interface QueryGenqlSelection {
             paged?: (Pagination | null);
         };
     });
+    /** Retrieve site-wide announcements. Applicants only ever see currently active announcements; users with the Announcement view control see them all. */
+    announcements?: (AnnouncementGenqlSelection & {
+        __args?: {
+            filter?: (AnnouncementFilters | null);
+        };
+    });
     /** The activity log for this app request. This is a list of actions taken on the app request, such as submission, updating prompts, make an offer, add a note, etc. It will be sorted by the date of the activity in descending order. */
     appRequestActivity?: (AppRequestActivityGenqlSelection & {
         __args: {
@@ -1994,6 +2168,15 @@ export interface RoleActionsGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+export interface ValidatedAnnouncementResponseGenqlSelection {
+    /** The created or updated announcement. Null when validateOnly was true or when validation errors prevented the operation. */
+    announcement?: AnnouncementGenqlSelection;
+    messages?: MutationMessageGenqlSelection;
+    /** True if the mutation succeeded (e.g. saved data or passed validation), even if there were warnings. */
+    success?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 export interface ValidatedAppRequestResponseGenqlSelection {
     appRequest?: AppRequestGenqlSelection;
     messages?: MutationMessageGenqlSelection;
@@ -2076,6 +2259,9 @@ export declare const isAccessUser: (obj?: {
 export declare const isAccessUserIdentifier: (obj?: {
     __typename?: any;
 } | null) => obj is AccessUserIdentifier;
+export declare const isAnnouncement: (obj?: {
+    __typename?: any;
+} | null) => obj is Announcement;
 export declare const isAppRequest: (obj?: {
     __typename?: any;
 } | null) => obj is AppRequest;
@@ -2178,6 +2364,9 @@ export declare const isRequirementPromptActions: (obj?: {
 export declare const isRoleActions: (obj?: {
     __typename?: any;
 } | null) => obj is RoleActions;
+export declare const isValidatedAnnouncementResponse: (obj?: {
+    __typename?: any;
+} | null) => obj is ValidatedAnnouncementResponse;
 export declare const isValidatedAppRequestResponse: (obj?: {
     __typename?: any;
 } | null) => obj is ValidatedAppRequestResponse;
@@ -2239,12 +2428,17 @@ export declare const enumApplicationPhase: {
     WORKFLOW_BLOCKING: "WORKFLOW_BLOCKING";
     WORKFLOW_NONBLOCKING: "WORKFLOW_NONBLOCKING";
 };
+export declare const enumApplicationRescindedStatus: {
+    RESCINDED: "RESCINDED";
+    RESTORED: "RESTORED";
+};
 export declare const enumApplicationStatus: {
     ACCEPTED: "ACCEPTED";
     ELIGIBLE: "ELIGIBLE";
     INELIGIBLE: "INELIGIBLE";
     PENDING: "PENDING";
     REJECTED: "REJECTED";
+    RESCINDED: "RESCINDED";
 };
 export declare const enumIneligiblePhases: {
     ACCEPTANCE: "ACCEPTANCE";

package/dist/typed-client/schema.graphql

@@ -1,4 +1,7 @@
 type Access {
+  """Current user is permitted to create announcements."""
+  createAnnouncement: Boolean!
+
   """
   Current user may create a new app request on behalf of another user and should be shown the Create App Request button on the reviewer dashboard or main app request list.
   """
@@ -19,6 +22,12 @@ type Access {
   """
   createRole: Boolean!
 
+  """Current user is permitted to delete announcements."""
+  deleteAnnouncement: Boolean!
+
+  """Current user is permitted to update announcements."""
+  updateAnnouncement: Boolean!
+
   """The current user, if any."""
   user: AccessUser
 
@@ -276,6 +285,87 @@ input AccessUserIdentifierInput {
   label: String!
 }
 
+"""
+A site-wide announcement shown to users, optionally limited to a date range.
+"""
+type Announcement {
+  """The content of the announcement in HTML."""
+  body: String!
+
+  """
+  Whether the announcement has been turned on. A disabled announcement never displays, regardless of its date range.
+  """
+  enabled: Boolean!
+
+  """
+  The announcement will not display after this date. Null means it displays until it is disabled.
+  """
+  end: DateTime
+  id: ID!
+
+  """URL the announcement directs the user to for more information."""
+  link: String
+
+  """The text to display for the link."""
+  linkText: String
+
+  """
+  The announcement will not display before this date. Null means it displays as soon as it is enabled.
+  """
+  start: DateTime
+
+  """Short headline for the announcement."""
+  subject: String!
+
+  """The type of announcement, toggleable or date range"""
+  type: String!
+}
+
+input AnnouncementFilters {
+  """
+  Return only the announcements that should be displayed at this moment: enabled OR within their date range.
+  """
+  active: Boolean
+
+  """Return only enabled (true) or only disabled (false) announcements."""
+  enabled: Boolean
+
+  """Return the announcements with these IDs."""
+  ids: [ID!]
+}
+
+input AnnouncementUpdate {
+  """
+  The content of the announcement in HTML. Unsafe markup is stripped on save.
+  """
+  body: String
+
+  """Whether the announcement has been turned on."""
+  enabled: Boolean = false
+
+  """
+  The announcement will not display after this date. Null means it displays until it is disabled.
+  """
+  end: DateTime
+
+  """URL the announcement directs the user to for more information."""
+  link: String
+
+  """The text to display for the link. Required when a link is given."""
+  linkText: String
+
+  """
+  The announcement will not display before this date. Null means it displays as soon as it is enabled.
+  """
+  start: DateTime
+
+  """Short headline for the announcement."""
+  subject: String
+
+  """The type of announcement, toggleable or date range"""
+  type: Boolean
+}
+
 """
 Represents a group of applications all being applied for at the same time. As part of the request, multiple applications will be created and either eliminated as ineligible or submitted for approval.
 """
@@ -533,6 +623,11 @@ input AppRequestFilter {
   own: Boolean
   periodIds: [ID!]
 
+  """
+  Only return appRequests where at least one application is in one of the given rescinded states. Rescinding is per-application, so this is independent of the appRequest status.
+  """
+  rescindedStatus: [ApplicationRescindedStatus!]
+
   """
   Only return appRequests that have had their review started. true -> return review started, false -> return not started. Note that this is NOT mutually exclusive with complete or closed, it very simply means that a non-applicant has taken an action on it.
   """
@@ -791,6 +886,17 @@ type Application {
   """The program key this application corresponds to."""
   programKey: String!
   requirements: [ApplicationRequirement!]!
+
+  """The reason the application was rescinded"""
+  rescindedReason: String
+
+  """The application rescinded status"""
+  rescindedStatus: ApplicationRescindedStatus
+
+  """
+  The reason the application was restored after previously being rescinded
+  """
+  restoredReason: String
   status: ApplicationStatus!
 
   """
@@ -814,6 +920,8 @@ type Application {
 
 type ApplicationActions {
   advanceWorkflow: Boolean!
+  rescindApplication: Boolean!
+  restoreApplication: Boolean!
   reverseWorkflow: Boolean!
   viewAsReviewer: Boolean!
 }
@@ -824,6 +932,7 @@ type ApplicationMetric {
   closed: Float!
   denied: Float!
   entries: [ApplicationMetricEntry!]!
+  rescinded: Float!
   started: Float!
   submitted: Float!
   toDecision: ApplicationMetricTiming!
@@ -936,6 +1045,11 @@ The specific instance of a requirement on a particular application. Stores the s
 type ApplicationRequirement {
   application: Application!
 
+  """
+  The prompt keys the requirement named as responsible for its current status. Used to attach status indicators to the specific answers at fault instead of every prompt the requirement consults. Null when the requirement did not name any, in which case all of its prompts are implicated.
+  """
+  blame: [String!]
+
   """
   The configuration data for this requirement in the app request's period.
   """
@@ -987,6 +1101,19 @@ type ApplicationRequirement {
   workflowStage: PeriodWorkflowStage
 }
 
+"\n    The rescinded status of an application.\n  "
+enum ApplicationRescindedStatus {
+  """
+  The application has been rescinded (pulled back from applicant) post approval.
+  """
+  RESCINDED
+
+  """
+  The application, which was previously rescinded, has now been restored to its state prior to rescinding.
+  """
+  RESTORED
+}
+
 "\n    The status of an application. This is usually a computed field, not stored in the database. The status\n    is computed based on the status of the appRequest and of the requirements for the program. If\n    the appRequest is CLOSED or CANCELLED, this status will remain frozen wherever it was before the\n    closure / cancellation.\n  "
 enum ApplicationStatus {
   """
@@ -1013,6 +1140,11 @@ enum ApplicationStatus {
   An offer was made to the applicant and at least one ACCEPTANCE requirement is not met (the applicant rejected the offer).
   """
   REJECTED
+
+  """
+  The application has been rescinded (pulled back from applicant) post approval.
+  """
+  RESCINDED
 }
 
 type Category {
@@ -1277,10 +1409,16 @@ type Mutation {
   """
   completeReview(appRequestId: ID!): ValidatedAppRequestResponse!
 
+  """Create a new site-wide announcement."""
+  createAnnouncement(announcement: AnnouncementUpdate!, validateOnly: Boolean): ValidatedAnnouncementResponse!
+
   """Create a new app request."""
   createAppRequest(login: String!, periodId: ID!, validateOnly: Boolean): ValidatedAppRequestResponse!
   createPeriod(copyPeriodId: String, period: PeriodUpdate!, validateOnly: Boolean): ValidatedPeriodResponse!
 
+  """Delete an existing site-wide announcement."""
+  deleteAnnouncement(announcementId: ID!): ValidatedResponse!
+
   """Delete an existing note."""
   deleteNote(noteId: ID!): Boolean!
   deletePeriod(periodId: ID!): ValidatedResponse!
@@ -1291,6 +1429,12 @@ type Mutation {
   """
   reopenAppRequest(appRequestId: ID!): ValidatedAppRequestResponse!
 
+  """Rescinds the approved and/or accepted application."""
+  rescind(applicationId: ID!, reason: String!, validateOnly: Boolean): ValidatedAppRequestResponse!
+
+  """Restores a previously rescinded application to its previous state."""
+  restore(applicationId: ID!, reason: String!, validateOnly: Boolean): ValidatedAppRequestResponse!
+
   """
   Return the app request to the applicant phase. This is only available if the app request is in a state that allows returning.
   """
@@ -1325,6 +1469,9 @@ type Mutation {
 
   """Toggle an existing note's persistent status."""
   togglePersistence(noteId: ID!): ValidatedNoteResponse!
+
+  """Update an existing site-wide announcement."""
+  updateAnnouncement(announcement: AnnouncementUpdate!, announcementId: ID!, validateOnly: Boolean): ValidatedAnnouncementResponse!
   updateConfiguration(data: JsonData!, key: String!, periodId: ID!, validateOnly: Boolean): ValidatedConfigurationResponse!
 
   """Update the content of an existing note."""
@@ -1683,6 +1830,11 @@ type Query {
   access: Access!
   accessUsers(filter: AccessUserFilter, paged: Pagination): [AccessUser!]!
 
+  """
+  Retrieve site-wide announcements. Applicants only ever see currently active announcements; users with the Announcement view control see them all.
+  """
+  announcements(filter: AnnouncementFilters): [Announcement!]!
+
   """
   The activity log for this app request. This is a list of actions taken on the app request, such as submission, updating prompts, make an offer, add a note, etc. It will be sorted by the date of the activity in descending order.
   """
@@ -1922,6 +2074,19 @@ type RoleActions {
   update: Boolean!
 }
 
+type ValidatedAnnouncementResponse {
+  """
+  The created or updated announcement. Null when validateOnly was true or when validation errors prevented the operation.
+  """
+  announcement: Announcement
+  messages: [MutationMessage!]!
+
+  """
+  True if the mutation succeeded (e.g. saved data or passed validation), even if there were warnings.
+  """
+  success: Boolean!
+}
+
 type ValidatedAppRequestResponse {
   appRequest: AppRequest
   messages: [MutationMessage!]!