[kentcdodds]

Intent

Keep contributing docs aligned with the finished PackageServiceInstance delete, and point leftover kind='service' storage inventory purge at a tracked issue so it is not forgotten.

Summary

• Garden the runtime-worker runbook: keep the Cloudflare 10061 / 10064 / 10074 transferred-class delete procedure, and describe PackageServiceInstance as already deleted on production (v2; no stub).
• Update ADR 0025 consequences to record the completed Defer runtime PackageServiceInstance class deletion (Cloudflare 10061) #1558 / Export PackageServiceInstance stub so runtime can drop its binding #1559 / Delete PackageServiceInstance on kody-runtime #1560 sequence instead of a live follow-up.
• Track remaining operational work in Confirm leftover kind='service' storage inventory is purged, then remove the retired-service purge lane #1565 (confirm leftover kind='service' inventory is gone, then remove the purge lane).

Testing

Docs-only. Relevant local checks passed:

• npm run docs:check-temporal
• npm run format:check
• npm run primitives:check
• npm run migrations:check
• npm run deploy-guardrails:check

Full npm run validate was started; the docs-adjacent jobs above passed. Parallel e2e / mock-API timeouts on this Cloud Agent VM are unrelated to the two markdown files.

System changes

Docs only. Wrangler history, deletion allowlist, durable-object baseline, and the leftover-service purge lane are unchanged.

System recap — composes existing primitives (low risk)

Mode: recap · Base: main @ 3cd38054 · Head: 0465d9fa

Classification: composes — no primitives added or changed; this PR gardens two contributing docs.

Primitives touched

Primitive	Group	Impact
(none)	—	docs-only; classifier matched no code roots

Unmatched paths: docs/contributing/architecture/runtime-worker-migration-runbook.md, docs/contributing/decisions/0025-no-package-services-primitive.md.

Change flow

Contributors reading the runtime-worker runbook see the completed class-delete state; ADR 0025 points leftover inventory purge at #1565.

sequenceDiagram
	actor Contributor
	participant runbook as runtime-worker-migration-runbook
	participant adr as adr-0025
	Contributor->>runbook: read Deleting a transferred class
	Note over runbook: PackageServiceInstance gone on production (v2; no stub)
	Contributor->>adr: read 0025 consequences
	Note over adr: leftover kind=service purge tracked in #1565

Loading

  

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 36a2edb3-9f08-4453-bfb5-59241a7bbba6

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[kody-bot]

The runbook + ADR 0025 gardens here are included in #1569 (leftover-service purge removal). This docs-only PR can close once that lands, or close now as superseded.