Migrate Ruby SDK route generation to Metalsmith-based codegen

[razor-x]

Summary

Replaces the direct dependency on @seamapi/nextlove-sdk-generator with an internal Metalsmith-based code generation pipeline. The new implementation ports the route, client, and resource file generation logic while maintaining byte-identical output to the previous generator.

Key Changes

• New codegen pipeline: Implemented codegen/smith.ts as the main Metalsmith orchestrator that replaces generate-routes.js
• Route generation: Ported core logic from nextlove generator into codegen/lib/routes.ts, which:
  • Processes blueprint routes and OpenAPI endpoints
  • Generates client classes with methods
  • Creates resource files from OpenAPI schemas
  • Maintains parent-child resource relationships
• Layout system: Added Handlebars templates and context builders for:
  • Client files (client.hbs, codegen/lib/layouts/client.ts)
  • Resource files (resource.hbs, codegen/lib/layouts/resource.ts)
  • Import index files (imports.hbs, codegen/lib/layouts/imports.ts)
  • Routes file (routes.hbs, codegen/lib/layouts/routes-file.ts)
• OpenAPI utilities: Ported frozen output-parity workarounds from nextlove:
  • get-parameter-and-response-schema.ts
  • deep-flatten-one-of-and-all-of-schema.ts
  • flatten-obj-schema.ts
  • map-parent-to-children-resource.ts
  • get-filtered-routes.ts
• Static resources: Extracted hardcoded Ruby resource classes into static-resources.ts
• Build configuration: Added TypeScript config, ESLint config, and updated npm scripts
• Documentation: Added .prettierignore and updated .gitignore for codegen artifacts

Implementation Details

• All OpenAPI parsing logic is marked as TEMPORARY with TODO comments indicating migration paths to @seamapi/blueprint once output changes are permitted
• The implementation preserves the exact output structure and ordering from the previous generator to ensure compatibility
• Client method parameter sorting includes a preserved quirk from the original implementation (operator precedence bug) to maintain identical output
• Handlebars partials are loaded dynamically from layouts/partials/
• The codegen now runs via tsx codegen/smith.ts instead of direct Node.js execution

https://claude.ai/code/session_016XEpBuyVgLx5jvB4zygya6