@odla-ai/brand 0.8.4 → 0.8.5

package/README.md

@@ -35,6 +35,14 @@ The package is a **schema + rules + an agent skill + a color engine + a token co
   accepted/rejected decision across pending requests and retries. Proposal
   author names must come from a Registry-owned principal projection; mutable
   chat participants and raw ids are not identity presentation.
+- **Activation is the promotion checkpoint.** After palette and typography
+  approvals, `GET /books/:id/activate` returns the exact promotable revision a
+  human is reviewing. Posting that snapshot back with one stable mutation id
+  consumes a direct-human exact `brand.approve` external action, persists an
+  immutable `brand_activation_receipt`, and atomically marks only that revision
+  `active`. `exportBrandPromotion` refuses drafts and active rows without this
+  activation provenance. Any later accepted proposal returns the book to
+  `draft`, so the changed payload needs a new explicit activation.
 - **Vision happens through a semantic bridge.** `view_asset` asks the trusted
   host for bytes by asset id and returns image/PDF blocks inside the tool
   result when the model supports them. The rules-scoped agent credential
@@ -153,6 +161,22 @@ await fetch(`/api/brand/books/${book.id}/proposals/${proposal.id}/resolve`, {
 });
 ```
 
+Activate the resulting approved palette and typography revision before
+promotion. The POST must return exactly the snapshot rendered by the review UI:
+
+```ts
+const review = await fetch(`/api/brand/books/${book.id}/activate`).then((r) => r.json());
+const activated = await fetch(`/api/brand/books/${book.id}/activate`, {
+  method: "POST",
+  headers: { "content-type": "application/json" },
+  body: JSON.stringify({
+    mutationId: crypto.randomUUID(),
+    reviewedBook: review.reviewedBook,
+  }),
+}).then((r) => r.json());
+// activated.promotion is the adapter output; promotionDigest binds it exactly.
+```
+
 Wire the agent by attaching `brandSkill` to a persona (or let the chat-agent worker route a `brandBotTrigger` dispatch into `dispatchBrandTurn`):
 
 ```ts

package/dist/{index-r6SGidYT.d.cts → index-BBjMVilU.d.cts}

@@ -5,6 +5,7 @@ declare const BRAND_NS: {
     readonly palette: "brand_palette";
     readonly proposal: "brand_proposal";
     readonly approvalReceipt: "brand_approval_receipt";
+    readonly activationReceipt: "brand_activation_receipt";
     readonly asset: "brand_asset";
 };
 /** Brand-book lifecycle: authored → adopted → retired (delete is owner-only). */

package/dist/{index-r6SGidYT.d.ts → index-BBjMVilU.d.ts}

@@ -5,6 +5,7 @@ declare const BRAND_NS: {
     readonly palette: "brand_palette";
     readonly proposal: "brand_proposal";
     readonly approvalReceipt: "brand_approval_receipt";
+    readonly activationReceipt: "brand_activation_receipt";
     readonly asset: "brand_asset";
 };
 /** Brand-book lifecycle: authored → adopted → retired (delete is owner-only). */