John Dvorak
119 lines
4.7 KiB
Markdown
119 lines
4.7 KiB
Markdown
# APOPHIS Task Breakdown
|
|
|
|
## Completed (v1.1)
|
|
|
|
### Phase 1: Core Extension Points
|
|
- [x] Add `headers` field to `ApophisExtension` interface
|
|
- [x] Implement `getExtensionHeaders()` in ExtensionRegistry
|
|
- [x] Update parser to accept extension headers
|
|
- [x] Verify evaluator supports extension predicates
|
|
- [x] Add 14 tests
|
|
|
|
### Phase 2A: Multipart Uploads
|
|
- [x] Add `MultipartFile` and `MultipartPayload` types
|
|
- [x] Implement multipart schema-to-arbitrary handler
|
|
- [x] Update request builder for multipart payloads
|
|
- [x] Add multipart support to HTTP executor
|
|
- [x] Add `request_files` and `request_fields` parser operations
|
|
- [x] Add multipart operations to evaluator
|
|
- [x] File arrays: `maxCount > 1` generates arrays of files
|
|
- [x] Add 9 tests
|
|
|
|
### Phase 2B: Streaming / NDJSON
|
|
- [x] Add `chunks` and `streamDurationMs` to EvalContext.response
|
|
- [x] Add streaming config extraction from schema
|
|
- [x] Implement NDJSON parsing in HTTP executor
|
|
- [x] Add `stream_chunks` and `stream_duration` parser operations
|
|
- [x] Add streaming operations to evaluator
|
|
- [x] Integration tests with Fastify NDJSON routes
|
|
- [x] Add 7 tests
|
|
|
|
### Phase 2C: Extension System Polish
|
|
- [x] Update contract-validation.ts with extension headers
|
|
- [x] Update substitutor.ts with extension header support
|
|
- [x] Add integration tests for extension registration
|
|
- [x] Add 5 tests
|
|
|
|
### Phase 3A: SSE Extension
|
|
- [x] Create `src/extensions/sse/` module
|
|
- [x] Implement SSE format parser
|
|
- [x] Implement `sse_events` predicate
|
|
- [x] Add response transformer hook
|
|
- [x] Integration tests with Fastify SSE routes
|
|
- [x] Add 7 tests
|
|
|
|
### Phase 3B: Serializers Extension
|
|
- [x] Create `src/extensions/serializers/` module
|
|
- [x] Implement `SerializerRegistry`
|
|
- [x] Implement request/response transformers
|
|
- [x] Create `createSerializerExtension()` factory
|
|
- [x] Integration tests for request body transformation
|
|
- [x] Add 4 tests
|
|
|
|
### Phase 3C: WebSockets Extension
|
|
- [x] Create `src/extensions/websocket/` module
|
|
- [x] Implement `ws_message` and `ws_state` predicates
|
|
- [x] Add `onSuiteStart` pre-validation hook
|
|
- [x] Implement `runWebSocketTests()` runner
|
|
- [x] State transition validation
|
|
- [x] Add 5 tests
|
|
|
|
### Phase 4: TypeScript Strict Mode
|
|
- [x] Fix `src/domain/request-builder.ts`: multipart files type
|
|
- [x] Fix `src/extension/registry.ts`: type safety
|
|
- [x] Fix `src/extensions/sse/transformer.ts`: SSEEvent type
|
|
- [x] Fix `src/extensions/sse/test.ts`: predicate assertions
|
|
- [x] Fix `src/extensions/websocket/test.ts`: predicate assertions
|
|
- [x] Fix `src/formula/evaluator.ts`: accessor undefined checks, restore exports
|
|
- [x] Fix all extension tests: predicate return type narrowing
|
|
- [x] Fix all test helpers: HttpMethod casting
|
|
- [x] `npx tsc --noEmit` passes with zero errors
|
|
- [x] All 468 tests passing
|
|
|
|
### Phase 5: Extension System Hardening
|
|
- [x] Dependency ordering: `dependsOn` with topological sort
|
|
- [x] Async boot: `onSuiteStart` hooks run in dependency order
|
|
- [x] Health checks: `healthCheck` field with `runHealthChecks()`
|
|
- [x] State isolation with `Object.freeze()`
|
|
- [x] Redaction of sensitive data before passing to extensions
|
|
- [x] Timeout guards on all hooks
|
|
- [x] Prototype pollution prevention in accessor resolution
|
|
- [x] `validateFormula()`: error messages with suggestions
|
|
|
|
### Phase 7: Schema-to-Contract Inference
|
|
- [x] Create `src/domain/schema-to-contract.ts` module
|
|
- [x] Infer `!= null` from `required` fields
|
|
- [x] Infer `>=` / `<=` from `minimum` / `maximum` bounds
|
|
- [x] Infer `matches` from `pattern` regexes
|
|
- [x] Infer `==` from `const` values
|
|
- [x] Infer `==` / `||` chains from small `enum` sets
|
|
- [x] Recurse into nested objects and arrays
|
|
- [x] Merge inferred + explicit contracts in `extractContract()`
|
|
- [x] Deduplicate inferred against explicit `x-ensures`
|
|
- [x] Add 15 tests for inference logic
|
|
- [x] Add integration tests for `extractContract` merging
|
|
- [x] Build passes with 0 TypeScript errors
|
|
- [x] 482 tests passing
|
|
|
|
### Phase 6: Code Cleanup
|
|
- [x] Evaluator deduplication: operation lookup table, shared `resolveAccessor()`
|
|
- [x] Error suggestions: imperative if-chain to pattern matchers
|
|
- [x] Extension registry: `handleHookError()` utility
|
|
- [x] Shared test utilities: `src/test/helpers.ts`
|
|
- [x] Shared runner utilities: `src/test/runner-utils.ts`
|
|
- [x] Test deduplication: convert test files to shared helpers
|
|
- [x] Remove duplicate `scope auto-discovery` test
|
|
- [x] Shared security utilities: `src/infrastructure/security.ts`
|
|
- [x] Deduplicate error handling: `getErrorMessage()` replaces 19 instances
|
|
- [x] Deduplicate path param extraction: shared `extractPathParams()`
|
|
|
|
## Release Criteria
|
|
|
|
- [x] TypeScript strict mode passes
|
|
- [x] All integration tests pass
|
|
- [x] Performance benchmarks within 5% of v1.0
|
|
- [x] Documentation complete
|
|
- [x] CHANGELOG.md updated
|
|
- [x] README.md updated
|
|
- [x] Version bumped in package.json
|