diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 59a00b7..31fe0fb 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -84,15 +84,15 @@ and explicitly apply the processed text before any Suno handoff. ## Suno Boundary -The initial requirement is browser/site handoff to the Suno Create page -in Custom mode. The integration attempts to fill the supported title, +The initial requirement is an app-managed web surface for the Suno +Create page in Custom mode. This avoids relying on a particular user +browser. The integration attempts to fill the supported title, lyrics and style fields but does not press Generate. If a field cannot be filled, it returns a field-specific result so Presentation can report it and offer the approved text for copying. Treat this integration as -replaceable because website UI/behavior can change. The macOS -Accessibility-based field filler is an adapter behind a protocol so it -can be replaced without changing SongProject, prompt compilation or UI -review logic. +replaceable because website UI/behavior can change. The field filler is +an adapter behind a protocol so it can be replaced without changing +SongProject, prompt compilation or UI review logic. ## Instrument Selector Boundary diff --git a/docs/OPEN_QUESTIONS.md b/docs/OPEN_QUESTIONS.md index c01fbd5..9bfb38c 100644 --- a/docs/OPEN_QUESTIONS.md +++ b/docs/OPEN_QUESTIONS.md @@ -15,8 +15,9 @@ finalized. - Exact list of supported languages/dialects for MVP. - Arabic diacritization policy: full tashkeel vs pronunciation-targeted tashkeel. -- Resolved: Suno handoff opens the browser-based Create page in Custom - mode and attempts to fill title, lyrics and style fields. It never +- Resolved: Suno handoff presents the Create page in an app-managed web + surface in Custom mode and attempts to fill title, lyrics and style + fields. It never starts generation. Field-fill failures are reported with the approved text available for copying. - Whether Suno integration is permitted/reliable under the intended diff --git a/docs/PRODUCT.md b/docs/PRODUCT.md index e8485e7..05d7e14 100644 --- a/docs/PRODUCT.md +++ b/docs/PRODUCT.md @@ -19,7 +19,8 @@ instructions for Suno. 4. User reviews and manually edits every generated component. 5. Project versions are saved. 6. User presses **Send to Suno**. -7. The app opens the Suno Create page in Custom mode and fills the +7. The app presents the Suno Create page in an app-managed web surface + in Custom mode and fills the supported title, lyrics and style fields. It does not trigger Generate. If a field cannot be filled, the app reports that result and keeps its approved text ready for the user to copy.