docs: update spectrum-ts documentation for v12.5.0

[photon-action-bot]

Documentation Update: spectrum-ts v12.5.0

This PR updates documentation for spectrum-ts based on the v12.5.0 release.

Release Notes

New Features

• iMessage now surfaces inbound read receipts on app.messages: when someone reads a message your app sent, you’ll receive a read message with message.sender as the reader and message.content.target as your original outbound message.
• Read receipt targets are fully built Message objects, so you can inspect the original content and still use outbound affordances like edit() and unsend().
• readSchema is now exported from @spectrum-ts/core/authoring for callers that build or validate read content directly.

Improvement

• Read receipt docs are now much clearer, including DM vs group behavior, timestamp meaning, high-volume caveats, and examples for tracking who has read a message. 👀
• iMessage now reuses the same target-resolution path for reactions and read receipts, which improves cache behavior and avoids extra lookups when multiple events point at the same message.

---

Version: 12.5.0

---

🤖 This PR was auto-generated by Claude Code via the update-docs action in buildspace.

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

---

Note

Low Risk
Dependency-only change with no application logic edits in this diff; risk is limited to possible breakage in docs tooling or examples if 12.5.0 introduces incompatible API changes.

Overview
Bumps the spectrum-ts dev dependency from 12.0.0 to 12.5.0 in package.json, with the corresponding pnpm-lock.yaml refresh.

The lockfile moves the whole @spectrum-ts/* stack to 12.5.0 and pulls in transitive updates—notably @photon-ai/advanced-imessage 2.0.2 (with optional gRPC peers) and @photon-ai/otel 3.3.0—plus routine bumps such as postcss, minimatch, and brace-expansion.

This diff does not include edits to markdown/MDX or other doc sources; it only changes how the docs repo pins the package used for sync, typecheck, and examples (see scripts/sources.json for the synced spectrum-ts docs from photon-hq/spectrum-ts).

^{Reviewed by Cursor Bugbot for commit 182a42b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Merge conflicts resolved

Merged origin/main (ecc00e5) into docs/update-spectrum-ts-v12.5.0. The conflict came from #129 and #130 landing on main, which added the chat and eve dev dependencies and re-resolved the lockfile while this branch was bumping spectrum-ts.

Conflicts found

package.json — merged cleanly, no manual resolution needed. Kept spectrum-ts 12.5.0 from this branch alongside chat 4.34.0 and eve 0.30.8 from main.

pnpm-lock.yaml — 2 conflicting hunks, both in the @eslint-community/eslint-utils peer-dependency keys:

Hunk	This branch	main	Resolution
snapshots: key	4.10.1(eslint@9.39.4(jiti@2.6.1)) + 4.9.1(eslint@9.39.4(jiti@2.6.1))	4.9.1(eslint@9.39.4)	main
@typescript-eslint/utils@8.58.1 dep ref	4.10.1(eslint@9.39.4(jiti@2.6.1))	4.9.1(eslint@9.39.4)	main

Took main's side for both, per the convention of preferring incoming changes for lockfiles and generated files. This was also the internally consistent choice: the non-conflicting body lines that git auto-merged around both hunks read eslint: 9.39.4 with no jiti suffix, so keeping this branch's jiti-suffixed keys would have left the snapshot keys disagreeing with their own dependency entries.

One follow-on cleanup: the packages: metadata block still carried a @eslint-community/eslint-utils@4.10.1 entry (resolution + integrity) that nothing referenced after the above resolution, so it was dropped to match what pnpm itself would emit.

No authored documentation content conflicted, so there was nothing to prefer from the PR side beyond the version pin — this branch's spectrum-ts 12.5.0 bump is fully intact.

Verification

All green on the merge commit (182a42b):

• pnpm install --frozen-lockfile — passes, confirming the resolved lockfile is consistent with the merged package.json (installs spectrum-ts 12.5.0, chat 4.34.0, eve 0.30.8)
• pnpm lint — clean
• pnpm typecheck:docs — all 20 code blocks type-check, all 21 formatted correctly

No errors needed fixing. Note that the spectrum-ts v12.5.0 read-receipt surface described in the PR body isn't covered by any of the three typecheck.config.ts files, so the typecheck run doesn't exercise it either way.

🤖 Generated with Claude Code