Wires this repo onto the api-contract package via file: dependency and
adds a recipe-platform sibling clone step to all three Forgejo
workflows so npm ci can resolve it, per
recipe-platform/docs/adr/2026-09-19-contract-ci-strategy.md.

@@ -5,0 +18,4 @@
+breaks both sibling repos at compile time. Run `/check-platform` if `npm install`/`npm ci`
+fails to resolve it (checks whether `recipe-platform` and `api-contract` are present at the
+expected path, offering to clone with consent). Migration status: no domain has been
+migrated to `@recipe/contract` types yet — see `docs/audit-domains.md` for the full

@@ -5,0 +22,4 @@
+field-by-field audit against every contract domain, including which domains are ready to
+migrate and which need a coordinated backend change first.
+
+**Cross-repo feature workflow** (spec → contract → architecture → plans → implementation →

@@ -11,2 +9,4 @@
  * Fetches all tags as plain models.
  * Used where only the tag ID and description are needed (e.g. recipe editor).
+ *
+ * Consumes the `{ tags: TagDto[] }` wrapper per the list-wrapper convention

@@ -16,3 +16,2 @@
             ...this.mapDtoToBaseModel(dto),
-            body: dto.body,
-            recipeId: dto.recipeId,
+            // The contract types body/recipeId as optional to cover write payloads too,

@@ -20,3 +20,3 @@
         return {
             ...this.mapDtoToBaseModel(dto),
-            title: dto.title,
+            // title is optional on the contract type but always populated on reads.

@@ -15,2 +15,2 @@
-            ingredientList: dto.ingredients
-                .sort((a, b) => a.sortOrder - b.sortOrder)
+            // ingredients is optional on the contract type but always populated on reads.
+            ingredientList: (dto.ingredients ?? [])

@@ -8,2 +8,3 @@
             ...this.mapDtoToBaseModel(dto),
-            text: dto.text,
+            // text is optional on the contract type but always populated on reads.
+            text: dto.text!,

@@ -25,3 +27,3 @@
             recipeTitle: dto.recipeTitle,
             recipeAmountDescription: dto.recipeAmountDescription,
-            servings: dto.servings,
+            servings: dto.servings!,

@@ -32,3 +32,3 @@
             // Base fields: id, createdAt, updatedAt, createdBy, version
             ...this.mapDtoToBaseModel(dto),
-            title: dto.title,
+            // title is optional on the contract type but always populated by the backend.

@@ -26,1 +26,3 @@
-            sharedWithUserId: dto.sharedWithUserId,
+            // sharedWithUserId/permission are optional on the contract type but always
+            // populated by the backend on reads.
+            sharedWithUserId: dto.sharedWithUserId!,

@@ -17,3 +17,2 @@
             ...this.mapDtoToBaseModel(dto),
-            rating: dto.rating,
-            recipeId: dto.recipeId,
+            // rating/recipeId are optional on the contract type (shared with write payloads)

@@ -20,3 +20,1 @@
-            url: `${API_BASE_URL}${dto.url}`,
-            mimeType: dto.mimeType,
-            recipeId: dto.recipeId,
+            // url/mimeType/recipeId are optional on the contract type but always

@@ -24,3 +24,2 @@
             },
-            instructionStepList: dto.instructions
-                .sort((a, b) => a.sortOrder - b.sortOrder)
+            // instructions/ingredientGroups are optional on the contract type (it also

@@ -22,2 +21,3 @@
             ...this.mapDtoToBaseModel(dto),
-            description: dto.description,
+            // description is optional on the contract type but always populated on reads.
+            description: dto.description!,

@@ -22,3 +22,2 @@
             ...this.mapDtoToBaseModel(dto),
-            userName: dto.userName,
-            email: dto.email,
+            // userName/email are optional on the contract type but always populated on reads.

@@ -1,5 +1,4 @@
-import type {RecipeImportStatus} from "../api/enums/RecipeImportStatus.ts";
-import type {RecipeImportReason} from "../api/enums/RecipeImportReason.ts";
+import type {RecipeImportStatus, RecipeImportReason} from "@recipe/contract";