[neelneelneel]

Description

Make backend declarations the source of truth for REST and Pixel descriptions, inputs, outputs, and SDK inclusion policies.

Changes Made

• Add shared annotations and immutable contract types under prerna.contract.
• Support inline response fields, records, collections, maps, enums, unions, recursive references, and generic root types.
• Preserve optionality, nullability, wire names, HTTP statuses, and Pixel invocation conventions.
• Add ignore, internal, and deprecation policies with diagnostics for incomplete or contradictory metadata.
• Introduce AbstractReactor2, which derives input keys, required flags, descriptions, and Help/MCP schemas from class annotations.
• Convert StopPixelExecutionReactor to the new base while preserving its execution logic.
• Add focused tests and a backend contract development guide.

How to Test

1. With JDK 21, run mvn -Dlicense.skip=true compile.
2. Run mvn -Dtest=ContractReaderUnitTests,AbstractReactor2UnitTests test.
3. Verify coverage for deterministic reads, policy handling, complex wire types, REST bindings, and derived reactor metadata.
4. Confirm cancellation requires an id and retains its string output contract.

Notes

• Production compilation and all 25 focused tests passed.
• Standard Maven test compilation encountered an existing missing AskStringModelEngineResponse.fromJson method. The development guide documents the isolated compilation workflow used to run the focused tests.
• Existing reactors can continue using AbstractReactor.
• The contract model is language-neutral; SDK generation is implemented separately in semoss-ui.

[snyk-io]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.