Add rules for aep-142 with docs and tests

[shakrav2]

Closes #46
Implements lint rules for AEP-142 (Time and Duration) to validate time-related fields in OpenAPI specifications.

Rules Implemented

• aep-142-time-field-type: Validates time-related field types
• aep-142-time-field-names: Warns about timestamp field naming
• aep-142-time-field-suffix: Enforces _time suffix for timestamp fields

Reference

• AEP Spec: https://aep.dev/142
• AEP Rules: https://aep.dev/tooling/linter/rules/0142/

Testing

• Added comprehensive test coverage in test/0142/
• All 164 tests pass (28 new tests for AEP-142)
• Code coverage: 89.65%
• Linter passes

Documentation

• Added rule documentation in docs/0142.md
• Updated docs/rules.md index

[mkistler]

Thank you for this PR! Overall it looks really good.

I think there are some problems with handling arrays -- I've suggested a few changes to the tests to suss those out.

I also want to point out that the current implementation misses date/time values passed in parameters and headers. The latter is an interesting case since AEP-142 isn't consistent with AEP-142 for headers (see #364). For parameters, I don't think there is an easy fix so I'm fine if we just create an issue for that and deal with it in a follow-on PR.

[mkistler]

I think this pattern could potentially generate some nasty false positives. This will help cut down on that:

Suggested change

	given: '$..[?(@property.match(/_(time|times|date|seconds|millis|micros|nanos)$/))]'
	given: '$..properties[?(@property.match(/_(time|times|date|seconds|millis|micros|nanos)$/))]'

[mkistler]

I think the following should pass but generates an error

Suggested change

	},
	},
	more_times: {
	type: 'array',
	items: {
	type: 'string',
	format: 'date-time',
	},
	},

[mkistler]

I think the following should pass but generates an error:

Suggested change

	},
	},
	more_times: {
	type: 'array',
	items: {
	type: 'string',
	format: 'date-time',
	},
	},

[shakrav2]

Thanks for the review! I've addressed both concerns you raised.

Changes Made

1. JSONPath Pattern (aep/0142.yaml:11)
✅ Updated from $..[?(@property.match(...))] to $..properties[?(@property.match(...))] as suggested.

This makes the pattern more specific by only targeting actual schema properties, reducing potential false positives.

2. Array Handling for _times Fields
✅ Added array support in functions/aep-142-time-field-type.js

Per AEP-142, fields ending in _times should be arrays of timestamps. The function now:

• Detects when a field with _times suffix has type: 'array'
• Validates that items.type === 'string' and items.format === 'date-time'
• Provides appropriate error messages for arrays vs. scalar fields

3. Test Coverage
✅ Added more_times array test case to test/0142/time-field-type.test.js

Note on test placement: I added the more_times test only to time-field-type.test.js, not to time-field-suffix.test.js. This is because the aep-142-time-field-suffix rule pattern ($..[?(@.type == "string" && @.format == "date-time")]~) matches fields that are directly type: string, so array fields are not checked by that rule—only by the type rule.

Test Results

All 28 AEP-142 tests passing ✓

Let me know if you'd like any adjustments!

[mkistler]

Looks good! 👍