docs: record the identification field in the changelogs

Author: gnidan

CHANGELOG.md

@@ -53,6 +53,26 @@ The sections do not signal obligations; the prefixes do.
 
 ## Unreleased
 
+### Added
+
+- An `ethdebug` field on **ethdebug/format/info**,
+  **ethdebug/format/info/resources** and **ethdebug/format/program** names
+  the schema the object conforms to and the specification version that
+  defines it, through the new **ethdebug/format/data/identification**
+  schema. The field is optional now and becomes required at `0.1.0`. An
+  object without it predates the field ([#305]).
+  - Schemas: **ethdebug/format/data/identification**,
+    **ethdebug/format/info**, **ethdebug/format/info/resources**,
+    **ethdebug/format/program**
+  - Producers: optional: emit `ethdebug: { schema, version }`; a program
+    inside a container may omit it, and when both carry it the versions
+    must be equal.
+  - Consumers: optional: a consumer may read the field.
+    **ethdebug/format/program** and **ethdebug/format/info** are closed
+    objects (`unevaluatedProperties: false`), so a consumer that
+    validates against the previous release's schemas rejects an
+    identified object until it updates its schemas.
+
 ### Changed
 
 - The `offset` of a segment counts bytes from the most significant byte of the
@@ -632,4 +652,5 @@ First published version of the specification.
 [#285]: https://github.com/ethdebug/format/pull/285
 [#286]: https://github.com/ethdebug/format/pull/286
 [#303]: https://github.com/ethdebug/format/pull/303
+[#305]: https://github.com/ethdebug/format/pull/305
 [#309]: https://github.com/ethdebug/format/pull/309

packages/bugc/CHANGELOG.md

@@ -7,6 +7,11 @@ support. Changes to the specification itself are tracked in the root
 
 ## Unreleased
 
+### Changed
+
+- Every program `bugc` emits carries an `ethdebug` field naming
+  **ethdebug/format/program** and the specification version ([#305]).
+
 ## 0.1.0-preview.0 — 2026-09-21
 
 The version scheme changed: prerelease versions are now `preview.<n>`, and
@@ -35,3 +40,4 @@ First publication.
 [#286]: https://github.com/ethdebug/format/pull/286
 [#298]: https://github.com/ethdebug/format/pull/298
 [#300]: https://github.com/ethdebug/format/pull/300
+[#305]: https://github.com/ethdebug/format/pull/305

packages/format/CHANGELOG.md

@@ -6,6 +6,15 @@ tracked in the root [`CHANGELOG.md`](../../CHANGELOG.md).
 
 ## Unreleased
 
+### Added
+
+- `version`, the package's own version string, generated at build time from
+  `package.json` ([#305]).
+- `Data.Identification` and `Data.isIdentification`, the type and guard for
+  the new **ethdebug/format/data/identification** schema;
+  `identify(schema)` builds one from `version` ([#305]).
+- `Program.ethdebug`, an optional `Data.Identification` ([#305]).
+
 ## 0.1.0-draft.0 — 2026-09-21
 
 The version scheme changed: prerelease versions are now `draft.<n>`, matching
@@ -116,6 +125,7 @@ First publication.
 [#293]: https://github.com/ethdebug/format/pull/293
 [#300]: https://github.com/ethdebug/format/pull/300
 [#303]: https://github.com/ethdebug/format/pull/303
+[#305]: https://github.com/ethdebug/format/pull/305
 [`0ef2f37`]: https://github.com/ethdebug/format/commit/0ef2f37
 [`10ab103`]: https://github.com/ethdebug/format/commit/10ab103
 [`21e532e`]: https://github.com/ethdebug/format/commit/21e532e