[gsmith85]

Summary

Implements Task 2 (PR 1b) of the two-layer ucp-schema code-generation pipeline: directional schema slicing and reference alignment passes in src/codegen/normalizer.rs, stacked on #81.

Changes

• normalize_def_schema: strip UCP keywords, rewrite $ref targets to #/$defs/<PascalName>, synchronize canonical top-level titles, and normalize additionalProperties: true onto open object definitions.
• has_directional_annotations and schema_supports_complete: detect ucp_request/ucp_response annotations and "complete" lifecycle operations via loader::for_each_schema_object (skipping instance data inside const/enum/default/examples).
• slice_directional_schemas: resolve CreateRequest, UpdateRequest, optional CompleteRequest, and Response ("read") slices via resolver::resolve, omitting empty request slices for response-only nested value types.
• align_directional_refs: rewrite #/$defs/<Target> inside directional request slices to #/$defs/<Target><Suffix> when present in known_defs (falling back to <Target>UpdateRequest for CompleteRequest slices).

Stacked PR Series Roadmap

1. PR 1a (feat(codegen): add identifier naming, UCP keyword stripping, and $defs ref rewriting #81): Identifier qualification, UCP keyword stripping, $ref rewriting (src/codegen/normalizer.rs)
2. PR 1b (this PR): Directional schema slicing & $ref alignment (src/codegen/normalizer.rs)
3. PR 1c (feat(codegen): add capability reachability, composition, and generate_types() API #83): Capability/extension reachability, composition & generate_types() library API (src/codegen/{mod,reachability,hoist,compose}.rs)
4. PR 1d (feat(cli): add generate-types subcommand #84): CLI generate-types subcommand (src/bin/ucp-schema.rs, tests/generate_types_test.rs)
5. PR 2 (feat(codegen): add self-contained .well-known/ucp profile scoping for generate-types #85): Self-contained .well-known/ucp --profile scoping (src/codegen/profile.rs)
6. PR 3a (feat(codegen): add AST shape normalizers and inline conditional variant hoisting #86): Codegen AST shape normalizers & inline conditional variant hoisting (src/codegen/normalizer.rs, src/codegen/reify.rs)
7. PR 3b (feat(codegen): lower open string discriminator unions into ordered anyOf with <Union>Base #87): Open string discriminator union lowering (<Union>Base) (src/codegen/reify.rs)
8. PR 3c (feat(codegen): discover and register decentralized extended subtypes into open unions #88): Cross-file extended subtype discovery & registration (src/codegen/reify.rs)
9. PR 4a (python-sdk#101): Python SDK direct JSON Schema codegen (generate_models.sh, postprocess_models.py, src/ucp_sdk/models/)
10. PR 4b (js-sdk#87): JS/TS SDK direct JSON Schema codegen (generate_models.sh, scripts/generate-zod-from-types.mjs, src/spec_generated.ts)
11. PR 5 (feat(openapi): add profile-driven OpenAPI 3.1 service and type binding (generate-openapi) #89): OpenAPI 3.1 REST service & type binding (ucp-schema generate-openapi, src/openapi/mod.rs)

Test Plan

• cargo fmt --check
• cargo test --all-targets
• cargo clippy --all-targets -- -D warnings

[damaz91]

LGTM! Clean separation between directional slicing and $ref alignment, and nice handling of the CompleteRequest -> UpdateRequest fallback.

(Noted while reading ahead that the total.json / totals.json / order.json edge cases in is_non_empty_request_slice and has_directional_annotations are already addressed up-stack in #86.)