Question: custom rules with assertions syntax

I’m writing a custom rule based on the example response-contains-property

I’m using OAS 3.0.3, my response is using a $ref to an external JSON Schema Draft-04. In order for this rule to work, do I need to dereference the definition prior to linting? It seems to be returning from the schema.type !== 'object' condition and doesn’t report any error when using the lint command.

"responses": {
	"200": {
		"description": "Ok",
		"content": {
			"application/json": {
				"schema": {
					"$ref": "./schemas/associate-activity-logs-response-schema_v01.json"
				},

/** @type { import('@redocly/cli').oasRule} */

const nextGenResponseModel = options => {
    const mustExist = options.mustExist || []
    
    return { 
        Response: { 
            skip: (_response, key) => {
                return ![200, 201, 202].includes(key.toString())
            },
            MediaType: { 
                skip: (_media, key) => {
                    return key !== 'application/json'
                },
                Schema(schema, { report, location }) { 
                    if (schema.type !== 'object') return

                    for (let element of mustExist) { 
                        if (!schema.properties[element]) {
                            report ({
                                message: `Next-Gen Response must have top-level "${element}"`,
                                location: location.child('properties')
                            })
                        }
                    }
                }
            }
        }
    }
}

module.exports = nextGenResponseModel

    custom-id/nextGenResponseModel:
      description: Ensure the Response model follows the API Style Guide
      message:  {{ error }}
      severity: error
      mustExist:
        - _confirmMessage
        - _meta

  plugins: 
    -  './plugins/index.js'

[jeremyfiel]

if i have a list of required properties, can I expect the error to output which property was not found?

message: "_confirmMessage" was not found

[adamaltman]

Side note: we have a built in rule: https://redocly.com/docs/cli/rules/response-contains-property/

Having template placeholders to available to use in messages would be good.