Skip to main content

Engineering review

Render service, sprint 14

Where the work stands, what ships next quarter, and the evidence from the latest run.

Sprint board

  • To do2 cards

    • Retry artifact uploads with backoff

      Storage resets drop run_8123 uploads; retry with jitter before failing the run.

      Linhstoragereliabilitybug

    • Per-key rate limit dashboard

      Marcoapi

  • In progress2 cards

    • Validate roadmap periods at compile time

      Report unknown and reversed periods at the item path.

      Aikocompilernew

    • Stream compile logs to the run page

      Linhworkerui

  • Review1 card

    • Drop the legacy v0 runs endpoint

      Every client moved to /v1/runs in sprint 12.

      Marcoapiremoved

  • Done2 cards

    • Deterministic schema tree order

      Aikocompilergood

    • Cache spec hashes per key

      Linhworkerperformance

Roadmap

  1. 2026-Q3
  2. 2026-Q4
  3. 2027-Q1
  4. 2027-Q2

Compiler core

  1. Composition and datasets2026-Q3 – 2026-Q4Done
  2. Engineering widgets2026-Q4In progress
  3. Theme dialects2027-Q1 – 2027-Q2Planned

Platform

  1. Upload retries and backoff2026-Q4At risk
  2. Multi-region artifact storage2027-Q1 – 2027-Q2Planned
  1. 2026-Q3

    • Composition and datasetsCompiler core · until 2026-Q4Done
  2. 2026-Q4

    • Engineering widgetsCompiler coreIn progress
    • Upload retries and backoffPlatformAt risk
  3. 2027-Q1

    • Theme dialectsCompiler core · until 2027-Q2Planned
    • Multi-region artifact storagePlatform · until 2027-Q2Planned

Latest test run

2 of 10 tests failed

Failed
2
Flaky
1
Skipped
1
Passed
6
Duration
4.6 s
Coverage
87.4%
compiler/normalize1 failed, 3 passed · 122 ms
  • Failedrejects a reversed roadmap range18 ms
    tests/unit/engineering-widgets.test.ts:212
    expected diagnostic path "$.blocks[2].items[0].end"
    received "$.blocks[2].items[0].start"
  • Passedkeeps node ids stable across runs42 ms
  • Passedreports nested slot paths37 ms
  • Passedresolves datasets once25 ms
storage/uploads1 failed, 1 passed · 3.1 s
  • Failedretries a reset connection3 s
    tests/unit/storage-upload.test.ts:48
    Error: connection reset by peer (attempt 3 of 3)
  • Passedwrites the etag on success88 ms
render/engineering1 flaky, 1 skipped, 2 passed · 1.3 s
  • Flakylog viewer adds search past 20 lines1.2 s
    Passed on retry 2 of 3; first attempt timed out waiting for the input.
  • Passedkanban rows carry the filter contract61 ms
  • Passedroadmap renders no inline style33 ms
  • Skippedschema tree prints open

Service log

render-api, 10:00 to 10:08 UTC

40 lines ·

  • 7 debug
  • 23 info
  • 6 warn
  • 4 error
  1. INFOapiGET /v1/runs 200 in 41 ms
  2. INFOworkerpicked job run_8121 (queue=default)
  3. DEBUGworkercache lookup key=spec:9f2c hit=false
  4. INFOcompilercompiled dashboard.yaml in 118 ms (96.4 kB)
  5. INFOapiPOST /v1/runs 201 in 63 ms
  6. DEBUGschedulertick: 3 queued, 2 running, 0 delayed
  7. INFOworkerpicked job run_8122 (queue=default)
  8. WARNworkerjob run_8122 exceeded soft limit: 1.8 s > 1.5 s
  9. INFOcompilercompiled incident.yaml in 204 ms (131.0 kB)
  10. DEBUGstorageput artifacts/run_8121.html etag=7c1e
  11. INFOapiGET /v1/runs/run_8121 200 in 12 ms
  12. WARNapirate limit at 80% for key ci-bot
  13. INFOworkerpicked job run_8123 (queue=priority)
  14. ERRORstorageput artifacts/run_8123.html failed: connection reset by peer
  15. WARNworkerretrying run_8123 upload (attempt 2 of 3)
  16. ERRORstorageput artifacts/run_8123.html failed: connection reset by peer
  17. WARNworkerretrying run_8123 upload (attempt 3 of 3)
  18. INFOstorageput artifacts/run_8123.html etag=a40d
  19. INFOapiGET /v1/runs/run_8123 200 in 15 ms
  20. DEBUGschedulertick: 1 queued, 3 running, 0 delayed
  21. INFOworkerpicked job run_8124 (queue=default)
  22. INFOcompilercompiled plan.yaml in 88 ms (74.9 kB)
  23. ERRORcompilerrun_8124: SPEC_VALIDATION_ERROR at $.blocks[3].items[1].start
  24. INFOapiPOST /v1/runs 422 in 9 ms
  25. WARNapirate limit at 92% for key ci-bot
  26. INFOworkerpicked job run_8125 (queue=default)
  27. DEBUGworkercache lookup key=spec:41aa hit=true
  28. INFOapiGET /v1/runs/run_8125 200 in 11 ms
  29. ERRORapiPOST /v1/runs 429 for key ci-bot: rate limit exceeded
  30. INFOschedulerdelayed 4 jobs for key ci-bot by 30 s
  31. DEBUGschedulertick: 4 queued, 1 running, 4 delayed
  32. INFOworkerpicked job run_8126 (queue=default)
  33. INFOcompilercompiled recap.yaml in 97 ms (88.2 kB)
  34. INFOstorageput artifacts/run_8126.html etag=0be3
  35. INFOapiGET /v1/runs/run_8126 200 in 14 ms
  36. WARNworkerjob run_8127 waiting on lock spec:41aa for 2.1 s
  37. INFOworkerpicked job run_8127 (queue=default)
  38. INFOcompilercompiled diff.yaml in 76 ms (69.5 kB)
  39. INFOschedulerreleased 4 delayed jobs for key ci-bot
  40. DEBUGschedulertick: 0 queued, 2 running, 0 delayed

API reference

POST /v1/projects/{project}/runs

Queues a compile of one Page Spec and returns the run. The artifact is ready when status is done.

Parameters

Parameters
NameInTypeDescription
project requiredpathstringProject slug, such as docs-site.
priorityquerybooleanUse the priority queue. Counts double against the rate limit.
Idempotency-KeyheaderstringRepeat a request safely; the same key returns the same run for 24 hours.

Request body

Requestjson
{
  "spec": "version: 1\nmeta:\n  title: Weekly recap",
  "theme": "terminal-mono"
}

Responses

  • 201The run was queued.

    201 responsejson
    {
      "id": "run_8128",
      "status": "queued",
      "createdAt": "2026-10-06T10:08:12Z"
    }
  • 422The spec failed validation; diagnostics lists every problem with its path.

  • 429The key exceeded its rate limit. Retry after the Retry-After seconds.

Run payload schema

  • idstringrequired

    Run id, such as run_8128.

  • statusenumrequired

    queued, running, done or failed.

  • projectobject
    • slugstringrequired
    • namestring
  • specobject
    • hashstringrequired

      SHA-256 of the normalized spec.

    • bytesinteger
  • artifactobject
    • urlstring

      Present once the run is done.

    • bytesinteger
    • etagstring
  • timingobject
    • queuedMsinteger
    • compileMsinteger
  • diagnosticsarray

    Empty when the spec is valid.

    • codestringrequired
    • pathstringrequired

      JSON path of the problem, such as $.blocks[2].items[0].end.

    • messagestring