update-public-docs

name	update-public-docs
description	Update public API reference docs to match Python source code. Compares client.py, schema files, and config models against MDX docs and fixes any gaps. Triggers on: update docs, sync docs, update public docs, update api reference, refresh documentation.

Update Public Docs

Keep the public documentation at reflexio/public_docs/ in sync with the Python source code (client library, schemas, config models).

Source Files (authoritative)

Read these files to understand the current API surface:

• reflexio/reflexio_client/reflexio/client.py — All public client methods (defines what's client-facing)
• reflexio/reflexio_commons/reflexio_commons/api_schema/service_schemas.py — Data models, enums, request/response schemas
• reflexio/reflexio_commons/reflexio_commons/api_schema/retriever_schema.py — Search/get request/response models
• reflexio/reflexio_commons/reflexio_commons/config_schema.py — Configuration models

Documentation Files (to update)

Read all MDX docs under reflexio/public_docs/content/docs/:

• api-reference/client-*.mdx — Client method documentation
• api-reference/schemas-*.mdx — Schema/model documentation
• concepts/ — Core concept pages
• getting-started/ — Quickstart and setup guides
• examples/ — Usage examples

Workflow

Step 1: Read All Sources

Read every source file listed above. Extract:

• All public methods from ReflexioClient (name, parameters with types/defaults, return type, docstring)
• All public Pydantic models used by those methods (field name, type, required/optional, default, description)
• All enum classes and their values
• All config model fields

Step 2: Read All Documentation

Read every MDX file under reflexio/public_docs/content/docs/.

Step 3: Compare and Update

For each doc category, compare source against docs and fix discrepancies:

Client methods (client-*.mdx):

• Every public method in client.py must be documented
• Parameters: correct name, type, required/optional, default value
• Return type and response schema must match
• Remove docs for methods that no longer exist

Schema docs (schemas-*.mdx):

• Every field in each Pydantic model must appear in the documentation tables
• Field name, type, required/optional, default, and description must match source
• Remove docs for models/fields that no longer exist

Enums (schemas-enums.mdx):

• All enum values must be listed with correct string values

Config docs (schemas-config.mdx):

• All config model fields must match source

Concepts/examples (concepts/, getting-started/, examples/):

• Check for references to deprecated or renamed features, methods, or fields
• Update any stale code snippets

Step 4: Scope Rules

INCLUDE:

• All methods in ReflexioClient
• All public Pydantic models used by those methods
• All enums
• Config models

EXCLUDE:

• Internal API endpoints (api.py internals) — only document what's exposed through client.py
• Skill-related features (disabled)
• Private/internal helper methods
• Implementation details

Step 5: Verify Build

Run the docs build to ensure no errors:

cd reflexio/public_docs && npx next build

Fix any build errors before finishing.

Step 6: Report

Summarize what changed:

• New methods/models/fields documented
• Updated parameters, types, or defaults
• Removed stale documentation
• Any build issues encountered and how they were resolved