Skip to content

chore: realign post-landing — surface regenerate, doc 0.0.28 break, harden gate#207

Merged
blove merged 1 commit into
mainfrom
fix/landed-changes-cleanup
May 7, 2026
Merged

chore: realign post-landing — surface regenerate, doc 0.0.28 break, harden gate#207
blove merged 1 commit into
mainfrom
fix/landed-changes-cleanup

Conversation

@blove
Copy link
Copy Markdown
Contributor

@blove blove commented May 7, 2026

Summary

Post-landing cleanup for the five PRs (#202#206) that landed on 2026-05-07. Four items, one commit:

  • libs/langgraph — declare regenerate(assistantMessageIndex) on the public LangGraphAgent type. It was implemented (agent.fn.ts:270), tested, and consumed by <ngaf-chat> (chat.component.ts:405), but missing from the public surface in agent.types.ts. The JSDoc on chat-message-actions.component.ts:94 was technically pointing users at an undeclared method.
  • CHANGELOG — backfill 0.0.28 entry. PR [codex] Align public agent API docs #202 was labeled docs: but silently removed AgentOptions.messagesKey; consumers passing it would have it ignored at runtime with no warning.
  • docs/superpowers/plans — three historical plan files still reference apps/website/public/api-docs.json, which PR docs: align chat public context #203 deleted. Added a one-line "post-PR docs: align chat public context #203" banner pointing readers at the new per-library path under content/docs/{lib}/api/api-docs.json.
  • ci — replace the hand-maintained ^libs/(chat|langgraph|ag-ui|render|a2ui|partial-json|example-layouts)/' allow-list in the examples-deploy gate with ^libs/. The previous list silently broke whenever a new publishable lib was added (it still tracked the long-deleted angular lib). Spurious example rebuild is cheap; missed deploy is silent breakage.

Skipped from the original analysis: squashing the PR #205 (retire whitepaper) → PR #206 (restore whitepaper) churn — already on main, not worth rewriting public history.

Test plan

  • nx run langgraph:test passes (29 specs)
  • nx run langgraph:lint passes (44 pre-existing warnings, 0 errors)
  • Verify CI examples-deploy gate still triggers on a libs/ change in this PR (it should, since libs/langgraph/src/lib/agent.types.ts is touched)
  • Confirm CHANGELOG renders correctly on the website CHANGELOG page

🤖 Generated with Claude Code

…arden gate

- libs/langgraph: declare `regenerate(index)` on the public LangGraphAgent
  surface (it was implemented + tested but missing from agent.types.ts, so
  the chat-message-actions JSDoc pointer to `agent.regenerate(index)` was
  technically referencing an undeclared method).
- CHANGELOG: backfill 0.0.28 entry documenting the silent removal of
  AgentOptions.messagesKey from PR #202 (was labeled `docs:`).
- docs/superpowers/plans: add post-PR #203 path-note banners to three
  plans that still reference the deleted apps/website/public/api-docs.json
  (now generated per-library under content/docs/{lib}/api/).
- ci: drop the hand-maintained libs allow-list in the examples-deploy gate
  in favor of `^libs/`. The previous list silently broke whenever a new
  publishable lib was added; cost of a spurious example rebuild is far
  cheaper than a missed deploy.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
cacheplane Ready Ready Preview, Comment May 7, 2026 8:04pm

Request Review

@blove blove merged commit d9fce58 into main May 7, 2026
13 of 14 checks passed
blove added a commit that referenced this pull request May 7, 2026
…#208)

PR #207 merged with admin override while CI's stale-api-docs gate was
red — the gate is now red on main. The shorter JSDoc on
LangGraphAgent.regenerate (added in #207) caused TypeDoc to emit a
description that diverges from the committed agent/api/api-docs.json.

Match the canonical text from libs/chat/src/lib/agent/agent.ts:38-46
so the regenerated docs are byte-identical to what's already on main.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
blove added a commit that referenced this pull request May 8, 2026
Documents the fix landed in #209 (regenerate via as_node='__start__'),
the public-surface addition from #207/#208 (LangGraphAgent.regenerate
declared + canonical JSDoc), and the new optional asNode option on
AgentTransport.updateState.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
blove added a commit that referenced this pull request May 8, 2026
Sourced from PR #196#200 bodies and commits. Restores continuity
between 0.0.22 (already on file) and 0.0.28+0.0.29 (added in #207
and #211).

No code changes.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant