Skip to content

Add agent documentation and API references#168

Open
raghul-velt wants to merge 8 commits into
mainfrom
raghul/agent-docs
Open

Add agent documentation and API references#168
raghul-velt wants to merge 8 commits into
mainfrom
raghul/agent-docs

Conversation

@raghul-velt

Copy link
Copy Markdown
Contributor
  • Introduced new sections for "Agents" in the documentation, including an overview and setup guide.
  • Added API references for creating, updating, deleting, and extracting agents.
  • Included analytics and execution details for agents, enhancing the overall API documentation.
  • Structured the content to improve clarity and usability for developers working with AI agents.

- Introduced new sections for "Agents" in the documentation, including an overview and setup guide.
- Added API references for creating, updating, deleting, and extracting agents.
- Included analytics and execution details for agents, enhancing the overall API documentation.
- Structured the content to improve clarity and usability for developers working with AI agents.
@mintlify

mintlify Bot commented May 15, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
velt 🟢 Ready View Preview May 15, 2026, 7:19 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…n provider configurations

- Introduced `activityconfig-get` and `activityconfig-update` for managing activity logs.
- Added `notificationconfig-get` and `notificationconfig-update` for in-app notification settings.
- Implemented `permissionproviderconfig-get` and `permissionproviderconfig-update` for permission provider configurations.
- Updated existing API documentation to reflect changes and new endpoints.
…umentation

- Added new parameters for adding comment annotations, including `createOrganization`, `createDocument`, and `agent` block for agent-authored comments.
- Updated the `get-comment-annotations-v2` endpoint to include filters for agent annotations and added detailed response structure for agent-related data.
- Enhanced the `add-comments` endpoint to support agent replies with a structured `agent` object.
- Included default behavior notes for activity logs, email service, notification service, permission provider, and webhook configurations in their respective documentation.
- Improved clarity and completeness of existing API documentation.
…cumentation

- Clarified the structure of agent annotations in the `get-comment-annotations-v2` response, specifying the location of the `agent` block.
- Added details about opt-in triggers for suggestion accept/reject events in the `activityconfig-update` and `webhookconfig-update` documentation.
- Enhanced clarity regarding default settings for webhook configurations and activity log triggers.
…v2 response

- Updated the description of agent annotations to specify the presence of the `agent` block at both the annotation root and within agent-authored comments.
- Clarified that the internal `agentFields` filter tokens are omitted from both `agent` blocks in the response.
… documentation

- Enhanced the default behavior notes for activity logs, email service, notification service, and webhook configurations to clarify trigger settings and merging behavior.
- Updated response structures to reflect the latest post-write state for activity, email, notification, and webhook configurations.
- Improved clarity regarding the presence of default triggers and the merging of user-specified values in the respective configurations.
- Updated the documentation for `add-comment-annotations` and `add-comments` to specify that the agent name is **required** when the `agentSource` is `external`, emphasizing its role as the source of truth for external agents.
- Removed the `agentFields` parameter from the `get-comment-annotations-v2` documentation to streamline the agent filter options.
rakesh-snippyly added a commit that referenced this pull request Jun 6, 2026
Port the workspace-related docs.json navigation changes from raghul/agent-docs
(PR #168) that accompany the ported v2/workspace pages:
- Remove the deleted apikeymetadata-get entry (renamed to permissionproviderconfig-get)
- Add API Key Configuration, Activity Configuration, Notification Configuration,
  and Permission Provider Configuration groups

Unrelated navigation changes (suggestions, AI Agents, REST Agents) are intentionally
excluded since those pages are not part of this branch.

Co-authored-by: Cursor <cursoragent@cursor.com>
rakesh-snippyly added a commit that referenced this pull request Jun 10, 2026
…Memory overview (#199)

* v5.0.2-beta.23

* v5.0.2-beta.24

* v5.0.2-beta.25

* v5.0.2-beta.26

* ci: remove skills-sync-drift-check workflow

Redundant with docs-sync-skills which handles syncing on push to main.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* docs: add Chat SDK Bot integration page

Quickstart for building bots on Velt comment threads with the Chat SDK and
@velt-js/chat-sdk-adapter. Wired into the Integrations nav group.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: move Chat SDK Adapter page under AI group, rename from chat-sdk-bot

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: ignore scripts/ in Mintlify build (fixes format-guide.md MDX parse error)

scripts/skills-sync/reference-artifacts/format-guide.md is a template artifact,
not a docs page; its <optional ...**bold**...> syntax broke the MDX parser and
failed the deploy. Excluding scripts/** from the Mintlify build.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: add .mintignore to exclude scripts/ from the Mintlify build

The docs.json 'ignore' field is not honored by Mintlify for page parsing; the
build explicitly fetches .mintignore. Excludes scripts/ (skills-sync pipeline +
reference-artifacts/format-guide.md) whose template syntax broke the MDX parser.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* chore: trigger Mintlify redeploy

Retry after 'Failed to revalidate subdomain: velt' on prior deploy.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* chore: retrigger Mintlify deploy

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* test: revert .mintignore + scripts/** ignore to isolate Mintlify revalidation failure

scripts/ files (incl. format-guide.md) predate the last known-good deploy
(98c6ed0), so the .mintignore could not have fixed a real new break. Reverting
to test whether the .mintignore itself triggers 'Failed to revalidate subdomain'.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* test: return docs content to last-good 98c6ed0 state + .mintignore

Isolates the 'Failed to revalidate subdomain: velt' failure. Restores .mintignore
(proven to fix the format-guide.md parse error) and removes the chat-sdk page so
docs content matches the last known-good deploy byte-for-byte. If revalidation
STILL fails here, the cause is Mintlify-side, not our commits. Chat-sdk page is
preserved in history (3dbafaf) and will be re-added once the deploy is green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: re-add Chat SDK Adapter page (cleared as cause of revalidation failure)

Isolation test (99aa37d) proved the 'Failed to revalidate subdomain: velt'
failure reproduces with docs content byte-identical to the last-good commit
98c6ed0 — so the page is not the cause. Restoring it and the AI-group nav entry.
The revalidation failure is Mintlify-side and tracked separately.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(chat-sdk-adapter): rename package scope @velt-js@veltdev

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(chat-sdk-adapter): add live demo + sample app links

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(chat-sdk-adapter): remove em-dashes for more natural phrasing

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: remove internal customPlanInfo fields from apikey-create

* docs: remove planInfo from apikey-create

* docs(backend-sdks): document velt-py v0.1.10 self-hosting data models

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): mark Suggestions as Beta and refine setup/behavior docs

Restructure setup and customize-behavior into method-named sections with
React/Other Frameworks tabs, rename approved -> accepted lifecycle, and
simplify the Suggestions changelog entry.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): rewrite customize-behavior and align reference with SDK

Reviewed the Suggestions feature source in velt-js/sdk and sdk-react and
corrected the docs to match shipped behavior:

- customize-behavior.mdx: concept-first rewrite explaining the suggestion
  pipeline (enable -> snapshot -> diff -> pending -> accept/reject -> apply),
  getters and the edit-time-state gotcha, the three commit paths, applying
  accepted changes (with idempotency), and a lifecycle/events reference.
- Fix registerTarget: it returns void (remove via unregisterTarget), not an
  unsubscribe function (setup.mdx, customize-behavior.mdx, api-methods.mdx).
- Fix SuggestionStatus value accepted (was approved) and document apply_failed
  as implemented via ApprovedSuggestion (data-models.mdx).
- Fix overview event name back to suggestionApproved (was suggestionAccepted).

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): use comment-element suggestionAccepted/suggestionRejected events

The accept/reject outcome is emitted on the comment element
(CommentEventTypes.SUGGESTION_ACCEPTED / SUGGESTION_REJECTED), not the
SuggestionElement: acceptSuggestion/rejectSuggestion flip annotation.type to
'comment' before SuggestionActionsService.projectAndTrigger, which early-returns
on non-suggestion type, so the SuggestionElement's suggestionApproved/
suggestionRejected never fire on resolve.

Switch setup, customize-behavior, and overview to the comment-element events
(useCommentEventCallback('suggestionAccepted') / commentElement.on(...)) and read
commentAnnotation.suggestion.newValue. SuggestionElement still owns create/read/
edit-capture plus suggestionCreated and suggestionStale.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): consolidate the three pages into one

Merge overview, setup, and customize-behavior into a single Suggestions page
(overview.mdx): feature pitch, how-it-works pipeline, define targets, enable
mode, capture options, apply-on-accept, read for custom UI, behavior notes
(drift / stale-wins), lifecycle + events reference, and data model.

- Delete setup.mdx and customize-behavior.mdx.
- Collapse the docs.json Suggestions group to the single page.
- Repoint Full Documentation links from /suggestions/setup to /suggestions/overview
  in api-methods.mdx (14) and react-hooks.mdx (11).

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): drop MutationObserver implementation detail

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(suggestions): add a clear step-by-step Setup section

Restructure the page so the how-to lives under one numbered Setup section
(1. define targets, 2. enable mode, 3. capture edits, 4. apply on accept),
folding the former standalone sections in as steps. Remove redundant behavior
notes (one-per-session and mode-not-persisted are already covered inline) and
move the get-SuggestionElement snippet into Setup.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(rest-apis): add and update v2 comments-feature and workspace API references

Port changes from raghul/agent-docs (PR #168) scoped to:
- api-reference/rest-apis/v2/comments-feature
- api-reference/rest-apis/v2/workspace

Includes new activity/apikey/notification/permission-provider config
endpoints and renames apikeymetadata-get to permissionproviderconfig-get.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(rest-apis): add workspace config endpoints to navigation

Port the workspace-related docs.json navigation changes from raghul/agent-docs
(PR #168) that accompany the ported v2/workspace pages:
- Remove the deleted apikeymetadata-get entry (renamed to permissionproviderconfig-get)
- Add API Key Configuration, Activity Configuration, Notification Configuration,
  and Permission Provider Configuration groups

Unrelated navigation changes (suggestions, AI Agents, REST Agents) are intentionally
excluded since those pages are not part of this branch.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(rest-apis): remove legacy apikeymetadata path notes from apikeyconfig pages

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs(rest-apis): remove legacy x-velt-auth-token header fallback notes

Co-authored-by: Cursor <cursoragent@cursor.com>

* v5.0.2-beta.33

* Bump Agent 1 max turns to 80 and pre-filter out-of-scope docs paths

Agent 1 (docs-diff-planner) was hitting the 40-turn limit when processing
large diffs. Bump to 80 and add shell-level pre-filtering in compute-diff.sh
to drop paths that mapping.md marks as out-of-scope before the agent sees them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add suggestion accept/reject webhook events

* save

* v5.0.2-beta.27 (#173)

* v5.0.2-beta.26

* v5.0.2-beta.27

* updaet

---------

Co-authored-by: Rakesh <rakesh@snippyly.com>

* Fix pipeline gaps: watch api-reference/sdk + ai paths, add 6 missing skills to dispatcher, bump Agent 2 turns

- Add api-reference/sdk/** and ai/** to workflow watched paths and compute-diff
- Remove ai/* and api-reference/sdk/* from out-of-scope pre-filter
- Add velt-reactions, velt-arrows, velt-area, velt-view-analytics, velt-node-sdk,
  velt-approval-engine to dispatch-updater-variant.sh
- Bump Agent 2 max turns from 40 to 80
- Update mapping.md: add new mapped paths, remove stale unmapped entries,
  sync variant dispatch table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* v5.0.2-beta.28 (#178)

Co-authored-by: Rakesh <rakesh@snippyly.com>

* v5.0.2-beta.29 (#174)

* v5.0.2-beta.29

* save

---------

Co-authored-by: Rakesh <rakesh@snippyly.com>

* v5.0.2-beta.30 (#179)

* v5.0.2-beta.30

* docs: tighten 5.0.2-beta.30 changelog entries

Rewrite the beta.30 New Features, Improvements, and Bug Fixes bullets into
crisp, user-facing language and drop internal service/implementation details.

Co-authored-by: Cursor <cursoragent@cursor.com>

* save

---------

Co-authored-by: Rakesh <rakesh@snippyly.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

* v5.0.2-beta.32 (#182)

* v5.0.2-beta.32

* docs: remove Comment Dialog Primitives section from api-methods

API methods reference should document methods only, not primitive
components. Removed the duplicated "Comment Dialog Primitives" section
(90+ VeltCommentDialog* entries) from api-methods.mdx; these remain
fully documented in comment-dialog/primitives.mdx (usage) and
data-models.mdx (types). Updated three links that pointed to the
removed #comment-dialog-primitives anchor.

Co-authored-by: Cursor <cursoragent@cursor.com>

* save

---------

Co-authored-by: Rakesh <rakesh@snippyly.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

* velt-py-v0.1.10 (#175)

* v5.0.2-beta.33 (#183)

* v5.0.2-beta.33

* Bump Agent 1 max turns to 80 and pre-filter out-of-scope docs paths

Agent 1 (docs-diff-planner) was hitting the 40-turn limit when processing
large diffs. Bump to 80 and add shell-level pre-filtering in compute-diff.sh
to drop paths that mapping.md marks as out-of-scope before the agent sees them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* save

* save

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Rakesh <rakesh@snippyly.com>

* velt-node-v1.0.2 (#177)

Co-authored-by: Rakesh <rakesh@snippyly.com>

* fix(skills-sync): fix 3 pipeline bugs that silently dropped docs changes (#186)

Bug 1: apply-patches.sh searched for changes.json inside $INCOMING_DIR
(agent-skills-patches/) but artifacts extract changes.json to a sibling
path (incoming/outputs/). Added $DOWNLOAD_ROOT to search the correct
location, fixing 3 runs that produced patches but created no PR.

Bug 2: data-models.mdx changes routed by "match type prefix to skill"
but PermissionRequest had no matching prefix. Added an explicit
model-family routing table to mapping.md so the planner can resolve
types like PermissionRequest → velt-setup-best-practices.

Bug 3: Pipeline reported success even when no PR was created. Added
an assertion step that fails when tickets exist but no PR was produced,
and an annotation step that warns on unmapped changes.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

* save (#187)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* Update README.md

* Update agent-comments.mdx

* Update customize-behavior.mdx

* Docs/agent comments (#188)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: link add/get comment annotation APIs and comment events from Agent Comments guide

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix(skills-sync): prepend execution instruction to agent prompts (#189)

Agent 4 (skill-pr-composer) intermittently treats its prompt as
informational context rather than instructions to execute, responding
with "what would you like me to do?" instead of reading input files
and creating a PR. This caused two consecutive pipeline failures.

Prepend an explicit imperative instruction to the agent body so the
model unambiguously treats it as a task to execute.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

* Docs/agent comments (#190)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: link add/get comment annotation APIs and comment events from Agent Comments guide

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: add self-host data field inventory page and link from overview

Move the exhaustive field inventory into its own Self-Host Data page,
add it to the nav, and replace the duplicated inventory section in the
overview with a link to the new reference.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* Docs/agent comments (#191)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: link add/get comment annotation APIs and comment events from Agent Comments guide

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: add self-host data field inventory page and link from overview

Move the exhaustive field inventory into its own Self-Host Data page,
add it to the nav, and replace the duplicated inventory section in the
overview with a link to the new reference.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: trim self-host field inventory intro and drop DB-engine names

Remove the framing/omitted-by-design notes and the cross-cutting rules
section, and replace Firestore/Firebase mentions with generic "Velt's DB".

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: remove built-in agent references from Agent Comments

Drop built-in agent mentions and the agentType filter; the agent block
now documents only custom (velt) and external agents.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: document the agent reason object fields

Add a reason-object field table (with types, descriptions, examples), a
suggestion vs suggestedFix note, and a fully-populated JSON example.

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* Docs/agent comments (#192)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: link add/get comment annotation APIs and comment events from Agent Comments guide

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: add self-host data field inventory page and link from overview

Move the exhaustive field inventory into its own Self-Host Data page,
add it to the nav, and replace the duplicated inventory section in the
overview with a link to the new reference.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: trim self-host field inventory intro and drop DB-engine names

Remove the framing/omitted-by-design notes and the cross-cutting rules
section, and replace Firestore/Firebase mentions with generic "Velt's DB".

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: remove built-in agent references from Agent Comments

Drop built-in agent mentions and the agentType filter; the agent block
now documents only custom (velt) and external agents.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: document the agent reason object fields

Add a reason-object field table (with types, descriptions, examples), a
suggestion vs suggestedFix note, and a fully-populated JSON example.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: drop closing omitted-fields note from field inventory

Co-authored-by: Cursor <cursoragent@cursor.com>

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* refactor(skills-sync): convention-based mapping for future-proof routing

* Docs/agent comments (#193)

* docs: add Agent Comments guide and document agent comments under comments customize behavior

Add a new AI > Agent Comments page covering how AI agents can leave comments
and findings via the Comment Annotations REST APIs, with explanation, examples,
and accept/reject event handling. Also document agent comments and the
suggestionAccepted/suggestionRejected events in the comments Customize Behavior
reference, and wire the new page into navigation.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: link add/get comment annotation APIs and comment events from Agent Comments guide

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: add self-host data field inventory page and link from overview

Move the exhaustive field inventory into its own Self-Host Data page,
add it to the nav, and replace the duplicated inventory section in the
overview with a link to the new reference.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: trim self-host field inventory intro and drop DB-engine names

Remove the framing/omitted-by-design notes and the cross-cutting rules
section, and replace Firestore/Firebase mentions with generic "Velt's DB".

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: remove built-in agent references from Agent Comments

Drop built-in agent mentions and the agentType filter; the agent block
now documents only custom (velt) and external agents.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: document the agent reason object fields

Add a reason-object field table (with types, descriptions, examples), a
suggestion vs suggestedFix note, and a fully-populated JSON example.

Co-authored-by: Cursor <cursoragent@cursor.com>

* docs: drop closing omitted-fields note from field inventory

Co-authored-by: Cursor <cursoragent@cursor.com>

* save

---------

Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: update Docs MCP URLs to velt.dev/docs (#195)

* fix: correct VS Code install button URL on Docs MCP page

* fix: update Docs MCP URLs to velt.dev/docs/mcp

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>

* docs(approval-engine,memory): align beta.31 PR with house style and add Memory overview

Style and accuracy pass over PR #180 against the internal developer guides
(approval-engine-developer-guide.md, memory-developer-guide.md):

- Add ai/memory/overview.mdx: concept-first page (what Memory is, how it
  works pipeline, core concepts, data provenance, limitations) so a new web
  dev gets the what/why before the hands-on guide; wire into docs.json.
- Slim ai/memory/developer-guide.mdx to the hands-on journey; concepts now
  live in the overview. Keep the full add-knowledge -> ask -> search ->
  suggest tutorial.
- Remove em-dashes and en-dash ranges across all beta.31 pages; switch
  "We'll" to second person; convert bold Important-style asides to callouts.
- Drop internal terminology from public docs: onRequest/onCall Cloud
  Function naming, Firestore collection name knowledge_chunks.
- Changelog beta.31: reposition entry chronologically (merge with main had
  stranded it next to beta.22), remove backend-only bullets per changelog
  rules (Stripe billing fan-out, FieldValue sentinels, log-level change,
  Firestore path normalization), reframe remaining bullets to observable
  behavior, and link Memory bullets to the new overview/guide.
- Move APPROVAL-ENGINE-MEMORY-DOC-GAPS.md from repo root to .claude/logs/
  (build-ignored) and refresh its fixed/open status.

https://claude.ai/code/session_015qRRK7w4nbVX64YSGJDWZn

---------

Co-authored-by: yoen-velt <yoen@velt.dev>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Cursor <cursoragent@cursor.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