pleach
ReferenceChangelog

@pleach/recipes changelog

Release history for @pleach/recipes — site-docs entries that materially touched the recipes surface, newest-first. Canonical runtime history lives upstream.

This page collects the site-content changelog entries that materially touched the @pleach/recipes docs surface, the Recipes cookbook page, or any of the per-recipe deep-dive pages under /docs/recipes/. It is not the runtime changelog — the canonical record of @pleach/recipes runtime behavior lives in the upstream package CHANGELOG.md and on npmjs.org/package/@pleach/recipes.

See the combined site changelog at /docs/changelog/combined for the chronological unified view across every SKU.

Unreleased

Changed

  • Internal persona codes removed from the recipe and use-case pages. The private planning codes (P0–P18, P-RAG, P-Eval, P-Code) and references to a private "persona doc" leaked into the shipped docs. Each recipe page's Persona fit: line is now Best fit: with the plain audience descriptor kept; the persona: frontmatter field is gone. Audience meaning is unchanged — only the internal codes were removed.

Fixed

  • Air-gapped empty-allowlist behavior corrected on Government and Air-gapped architecture. Both pages claimed the governmentAgent recipe validates at construction and throws PersonaFactoryNotYetImplementedError (with an internal personaId field). That class is real but is the unimplemented-stub error, not an allowlist guard. The real enforcement is in @pleach/core: an empty allowlist fails closed at the first provider-URL resolution via AirGappedHostRejectedError. Reframed to that behavior; dropped the construction-time claim and the personaId field.

Added

  • Agent instrumentation recipe added for the do-it-yourself instrumentation path — bare runtime.events.on(kind, handler) lifecycle subscription plus the observeSink({ destinations }) bridge from @pleach/observe. It sits alongside observable-chatbot (recipe-wrapper path) and BYOK observability (no-@pleach/core brownfield path). observable-chatbot gained a "Live lifecycle events" section linking to it. See the combined view for the full entry.

Fixed

  • Schema codeRepository + sameAs for @pleach/recipes corrected in the site's Organization + SoftwareApplication JSON-LD @graph (inlined in <head> on every page). Both fields now point at https://github.com/pleachhq/recipes (was https://github.com/pleachhq, a leftover from when the SKU schemas were drafted against an upstream monorepo). Load-bearing because sameAs is the field AI search engines use for entity reconciliation across the npm ↔ GitHub ↔ docs boundary. See the combined view for the full cross-SKU pack.

Added

  • Rank-2 per-recipe deep-dive pages — four additional pages under /docs/recipes/ covering the recipes excluded from the prior six because their peer SKUs were outside the first-publish wave: observableChatbot (composes @pleach/observe), instrumentedCodingAgent (composes @pleach/coding-agent + @pleach/sandbox + @pleach/observe), enterpriseAgent (composes @pleach/compliance + @pleach/observe, surfaces the procurement-visible ENTERPRISE_PERMITTED_FAMILIES_TAG envelope), and evalLab (composes @pleach/eval + @pleach/replay via DI-callback factories). Each page mirrors the prior six-page convention — best fit, quickstart, runtime composition, TypeScript config interface, common gotchas, cross-links.
  • Per-recipe deep-dive pages under /docs/recipes/ — six new pages covering the first-publish wave (@pleach/core, @pleach/tools, @pleach/compliance, @pleach/gateway) and the brownfield observability SDK: simpleChatbot, ragChatbot, compliantChatbot, verticalAgent, subagentSwarm, and BYOK observability. Each carries a quickstart, the runtime composition the recipe wires, a TypeScript config interface, common gotchas, and cross-links.

Changed

  • /docs/recipes jump-link table — 10-row index inserted after the lead so a reader scanning for one recipe doesn't sift through ~1,000 lines. Each row names the recipe's central primitive (@pleach/react + createPleachRoute, ProviderDecisionLedger, etc.) in 3-8 words.
  • /docs/recipes lead — count flipped Nine → Ten and the inline name list extended to include the regulated-host end-to-end recipe.

2026-06-08 — page-level restructuring

Added

  • Platform & operations recipes — extracts four platform-team recipes from Recipes (long-running async jobs, multi-step interrupts, per-call cost reporter, OpenTelemetry wiring) into a dedicated page under the Operations sidebar group. Lets a consumer reader on /docs/recipes skip patterns a platform team owns; lets a platform reader land directly on the four ops recipes without scrolling past chat/storage/BYOK.

Changed

  • Sidebar reorder in the Start group: Getting started → Agent shapes → Recipes → Reference apps → Comparison.
  • Recipes lead rewritten to reflect the consumer-facing split (chat, tools, storage, BYOK, moderation, multi-tenant, compliance, projections, hash chain) and to point at Platform & operations recipes for the platform-team patterns. Recipes 10–13 (multi-tenant, compliance, projection, hash-chain) renumbered to 6–9; anchor URLs for those four sections shift accordingly.

@pleach/react changelog

Release history for @pleach/react — site-docs entries that materially touched the @pleach/react surface, newest-first. Canonical runtime history lives upstream.

@pleach/replay changelog

Release history for @pleach/replay — site-docs entries that materially touched the @pleach/replay surface, newest-first. Canonical runtime history lives upstream.

On this page

UnreleasedChangedFixedAddedFixedAddedChanged2026-06-08 — page-level restructuringAddedChanged