feat: Add PHPDoc to SDK

[razor-x]

Motivation

• Emit rich PHPDoc for generated resource classes, properties and client methods to improve IDE hints and API discoverability.
• Propagate resource/method/property descriptions and deprecation metadata from the blueprint into the PHP SDK generation pipeline.
• Make generated client methods self-documenting so users can see parameter/return information and deprecation notices directly in the code.

Description

• Added Handlebars helpers to produce properly-formatted PHPDoc blocks (handlebars-helpers.ts) and a methodPhpDoc helper used by route-method.hbs to emit method docs for client methods.
• Extended codegen models to carry description and deprecation metadata (class-model.ts, resource-model.ts, routes.ts) and adjusted layout context builders (layouts/resource.ts, layouts/seam-client.ts) to include those fields for templates.
• Updated templates/layouts (codegen/layouts/partials/route-method.hbs, codegen/layouts/resource.hbs) and regenerated outputs to include class-level and property-level PHPDoc comments and annotated client methods, resulting in many resource files and SeamClient.php being enriched with docblocks.

Testing

• Built the TypeScript generator (tsc / project build) to ensure the changed codegen compiles successfully; build succeeded.
• Ran the test suite for the codegen (project tests) after the changes; tests passed.
• Generated the PHP SDK and ran a PHP syntax check (php -l) over the produced files to validate emitted code; no syntax errors found.

---

Codex Task