docs: update changelogs for sheaves and kernel-utils

Author: grypez

packages/kernel-utils/CHANGELOG.md

@@ -7,16 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
-
-- Add `@metamask/kernel-utils/sheaf` subpath export ([#870](https://github.com/MetaMask/ocap-kernel/pull/870))
-  - `sheafify()` for building a `Sheaf` capability authority from a collection of `PresheafSection`s, each an exo with optional invocation-dependent metadata
-  - `constant()`, `source()`, `callable()` for constructing metadata specs (static value, compartment-evaluated code string, and per-call function respectively)
-  - `noopLift()`, `proxyLift()`, `withFilter()`, `withRanking()`, `fallthrough()` for composing lifts to route and rank sections at dispatch time
-  - `makeSection()` for constructing a typed exo section from a guard and handler map
-  - `makeRemoteSection()` for wrapping a remote CapTP reference as a `PresheafSection`, fetching its interface guard once at construction and forwarding method calls via `E()`
-  - Types: `Sheaf<M>`, `Section`, `PresheafSection<M>`, `EvaluatedSection<M>`, `MetadataSpec<M>`, `Lift<M>`, `LiftContext<M>`
-
 ## [0.5.0]
 
 ### Added

packages/sheaves/CHANGELOG.md

@@ -11,4 +11,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Initial release, extracted from `@metamask/kernel-utils`
+- Initial release, extracted from `@metamask/kernel-utils`.
+- `sheafify({ name, providers })` — constructs a sheaf authority manager over a
+  set of capability providers.
+- `Provider<M>` type — an input to `sheafify`: a `{ handler, metadata? }` pair
+  where `handler` is an exo and `metadata` is an optional `MetadataSpec<M>`.
+- `Candidate<M>` type — a post-evaluation entry in the stalk: `{ handler,
+metadata }` with metadata already resolved from its spec.
+- `Handler` type — an exo capability covering a region of the interface
+  topology.
+- `Policy<M>` type — an `async function*` coroutine that receives candidates
+  and yields them in preference order; drives the sheaf dispatch loop.
+- `PolicyContext<M>` type — context passed to the policy: `{ method, args,
+constraints }`.
+- `MetadataSpec<M>` discriminated union with three variants: `constant`,
+  `source`, and `callable`.
+- `constant(value)` — static metadata spec; value is fixed at construction.
+- `source(src)` — source-string metadata spec; compiled via the optional
+  compartment at `sheafify` construction time.
+- `callable(fn)` — callable metadata spec; evaluated per-dispatch with the
+  invocation arguments.
+- `makeHandler(name, guard, methods)` — creates a named, guarded exo handler.
+- `makeRemoteSection(tag, remoteRef, metadata?)` — builds a provider that
+  wraps a remote capability, fetching its interface guard via `E`.
+- `noopPolicy` — a policy that yields candidates in the order received.
+- `proxyPolicy(gen)` — wraps an existing generator to satisfy the `Policy`
+  call signature.
+- `withFilter(predicate)` — higher-order policy combinator that pre-filters
+  the candidate list before passing it to the inner policy.
+- `withRanking(comparator)` — higher-order policy combinator that pre-sorts
+  the candidate list before passing it to the inner policy.
+- `fallthrough(policyA, policyB)` — composes two policies so that `policyB`
+  is tried only after `policyA` is exhausted.
+- `Sheaf<M>` type — the authority manager returned by `sheafify`; exposes
+  `getSection`, `getDiscoverableSection`, `getGlobalSection`, and
+  `getDiscoverableGlobalSection`.
+- `documents/POLICY.md` — documents the policy coroutine protocol,
+  `PolicyContext`, and the semantic equivalence assumption.
+- `documents/USAGE.md` — annotated usage examples.