@giveitsmaller/contracts 0.54.0 → 0.57.0

package/operations/schemas/compress.yaml

@@ -935,9 +935,17 @@ operation:
             max_input_size_bytes: 524288000        # 500 MiB
             max_output_size_bytes: 524288000
         long_form:
-          # planned -> beta (CON-1, ADR-0011): staging/internal proving
-          # gate before the stable claim (CON-2a). Per-tier caps per D3.
-          availability: beta
+          # planned -> beta (CON-1, ADR-0011) -> stable (CON-2a, 29eZATH0):
+          # staging-proven 2026-07-07 via long-form-compress-shrink.spec.ts
+          # (efficient-HEVC real-presigned-path run: routed long_form +
+          # terminal completed + 62.9% shrink — the BiubmEEJ source-relative
+          # maxrate cap engaged; a plain CRF pass would have inflated 2.43x).
+          # ADR-0006 Form-B (staging run + lambdas file:// cap-logic CI). The
+          # beta->stable flip is an API NO-OP: routing is band-INDEPENDENT
+          # (pure 300s duration + 256MiB size floor), and the eligibility gate
+          # treats beta==stable (only `planned` differs) — API-confirmed.
+          # Per-tier caps per D3.
+          availability: stable
           required_tier: pro
           constraints:                            # baseline = Pro (lowest permitted tier)
             max_input_duration: "PT12H"
@@ -1124,61 +1132,41 @@ operation:
             seconds from the end; with `trim_start` the kept clip is
             [`trim_start`, input_duration − `trim_end`]. See `trim_start`
             (short-form only; long-form is not supported).
-
-    document_pdf:
-      mimes:
-        - application/pdf
-      # DOCUMENT-COMPRESS (2026-06-22, Lw1LseYr): the worker honors `quality`
-      # (→ Ghostscript preset: 76-100=/prepress, 51-75=/printer, 26-50=/ebook,
-      # 0-25=/screen + a DPI-analysis fallback) PLUS three Acrobat-Pro PDF
-      # controls proven live on staging — `profile` (pins the GS preset),
-      # `grayscale` (force grayscale images), `image_dpi` (downsample images to a
-      # target DPI; worker rejects out-of-range as invalid_options). The
-      # detect-and-route behaviour (forms→qpdf preserve, signed→byte-identity
-      # passthrough) is internal — no contract surface. The remaining per-format
-      # options (`colorspace`/`pages`/`flatten_forms`) are spec-defined but NOT
-      # yet read by the worker, so they stay `availability: planned`
-      # (advertised-ahead; FE hides them per the bare-planned-hide rule) per
-      # ADR-0001 §1.4.
-      options:
-        quality:
-          type: integer
-          min: 1
-          max: 100
-          default: 50
-          description: "Compression quality (1 = smallest, 100 = best). Maps to a compression preset. Overridden by `profile` when that is set."
-        profile:
-          type: enum
-          values: [screen, ebook, printer, prepress]
-          description: >-
-            Compression preset, pinned directly (overrides the quality→preset
-            mapping). screen = lowest-res / smallest, ebook = mid, printer =
-            300dpi, prepress = print-production. Optional — omit to let `quality`
-            drive the preset.
-        grayscale:
-          type: boolean
-          default: false
-          description: "Convert all images to grayscale (smaller output; discards colour)."
-        image_dpi:
-          type: integer
-          min: 72
-          max: 600
-          description: "Downsample images above this DPI (72–600 inclusive). Omit to use automatic DPI analysis. Out-of-range is rejected."
-        colorspace:
-          type: enum
-          values: [unchanged, rgb, cmyk, grayscale]
-          default: unchanged
-          availability: planned
-          description: "Output color space. `planned` — not yet supported (use `grayscale` for grayscale conversion)."
-        pages:
-          type: string
-          availability: planned
-          description: "Page selection (e.g. '1-5,8,10-12'). Omit to keep all pages. `planned` — not yet supported."
-        flatten_forms:
-          type: boolean
-          default: false
+        speed:
+          type: float
+          min: 0.25
+          max: 4.0
+          default: 1.0
           availability: planned
-          description: "Flatten interactive form fields into static content. `planned` — not yet supported."
+          # SHORT-FORM only, mirroring trim: the long-form (Fargate) path does not
+          # apply speed, so it is rejected at create via the
+          # compress.video.speed.longform scope-exclude rather than silently
+          # ignored. `planned` (advertised-ahead, FE-hidden per the bare-planned-
+          # hide rule) until the encoder half lands (lambdas, parallel build) and
+          # it flips per ADR-0006 proof. Name/range/pitch/fps-order settled WITH
+          # lambdas — a pre-flip rename is cheap while planned. Audio pitch is
+          # PRESERVED via ffmpeg `atempo` (tempo-shift, NOT `asetrate` resample).
+          description: >
+            Playback speed multiplier. 1.0 = unchanged (default), 2.0 = twice as
+            fast (half the output duration), 0.5 = half speed (double the
+            duration); range 0.25–4.0. Audio PITCH IS PRESERVED (a tempo-shift,
+            not a resample — ffmpeg `atempo` semantics), so a 2.0x clip sounds
+            sped up, not chipmunked. Applied BEFORE an explicit `fps`: speed
+            re-times the stream, then `fps` (if set) resamples the retimed stream
+            to the target rate. SHORT-FORM only — long-form video returns
+            `feature_not_available` (adjust a short clip, or chain a `split`); see
+            the compress.video.speed.longform constraint.
+
+    # PDF compress REMOVED 2026-07-13: the document-compress worker's lossy PDF
+    # path was Ghostscript (AGPL/Artifex) — a legal launch-blocker. Product ruling
+    # (hub d8e13df6): REJECT-as-unsupported, not degrade. There is NO honest
+    # availability tag for a permanently-withdrawn capability (`planned` re-advertises
+    # in discovery + lies "coming soon"; ADR-0001 §L30 = tag-planned-OR-remove), so
+    # the `document_pdf` compress mime_group is REMOVED entirely — dropping it from
+    # discovery. The API maps compress + application/pdf → feature_not_available (422)
+    # rather than the generic unsupported-input reject. EPUB/office/ODF compress and
+    # PDF thumbnail/split/convert/transform are UNTOUCHED (Ghostscript's other uses,
+    # incl. PDF thumbnails, migrate to Poppler on the lambdas side — no contract change).
 
     document_office:
       mimes:

package/operations/schemas/merge.yaml

@@ -165,10 +165,14 @@ operation:
             max_total_duration: "PT5M"
             max_total_input_size_bytes: 1073741824   # 1 GiB combined
         long_form_re_encode:
-          # planned -> beta (CON-1, ADR-0011): staging proving gate before
-          # stable (CON-2b). Binding cap = max_total_duration (24h single-
-          # pass budget, SPIKE-0); size is the per-tier secondary cap.
-          availability: beta
+          # planned -> beta (CON-1, ADR-0011) -> stable (CON-2b, HWNXo1kk):
+          # staging-proven 2026-07-07 via long-form-merge.spec.ts Phase 2
+          # (uniform VP9 -> mp4 forces a VP9->h264 transcode; routing-class
+          # persisted to merge-fargate + terminal completed + output codec
+          # != vp9 = Form-B ADR-0006 conformance). Binding cap =
+          # max_total_duration (24h single-pass budget, SPIKE-0); size is the
+          # per-tier secondary cap.
+          availability: stable
           required_tier: pro
           constraints:                              # baseline = Pro (lowest permitted)
             max_total_duration: "PT24H"              # 24h (was PT12H) — binding Enterprise ceiling

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@giveitsmaller/contracts",
-  "version": "0.54.0",
+  "version": "0.57.0",
   "description": "Generated contract types for GISL (Give It Smaller)",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",