Skip to content

docs: add bulk operations to auto-generated skills documentation#1151

Merged
pyramation merged 1 commit into
mainfrom
devin/1778708878-bulk-docs-generator
May 14, 2026
Merged

docs: add bulk operations to auto-generated skills documentation#1151
pyramation merged 1 commit into
mainfrom
devin/1778708878-bulk-docs-generator

Conversation

@pyramation
Copy link
Copy Markdown
Contributor

Summary

Updates the codegen docs-generators so that auto-generated skill files (ORM, React Query hooks, CLI) include bulk operation documentation when tables have bulk mutations enabled via @behavior smart tags.

Changes to three docs-generators:

  1. ORM docs-generator (graphql/codegen/src/core/codegen/orm/docs-generator.ts)

    • Models table now lists bulkCreate, bulkUpsert, bulkUpdate, bulkDelete when enabled
    • Per-table operations section includes bulk method examples
    • Skills reference files include bulk usage lines
    • SKILL.md overview mentions bulk methods when any table has them
  2. Hooks docs-generator (graphql/codegen/src/core/codegen/hooks-docs-generator.ts)

    • Hooks table includes useBulkCreate*Mutation, useBulkUpsert*Mutation, etc. when enabled
    • Per-table hooks section includes bulk create example
    • AGENTS.md conventions line mentions bulk hooks
    • Skills reference files include bulk hook entries
  3. CLI docs-generator (graphql/codegen/src/core/codegen/cli/docs-generator.ts)

    • Subcommand tables include bulk-create, bulk-upsert, bulk-update, bulk-delete when enabled
    • Skills reference usage includes bulk CLI command patterns
    • Multi-target README also includes bulk subcommands

All changes are conditional on table.query?.bulkInsert / bulkUpsert / bulkUpdate / bulkDelete — no output changes for tables without bulk enabled.

Review & Testing Checklist for Human

  • Run pnpm test in graphql/codegen to verify all 347 tests pass (snapshot updated)
  • Regenerate skills against a schema with @behavior +bulkInsert on a table and verify the bulk docs appear correctly in the generated output

Notes

Companion to constructive-io/constructive-db#1141 which adds DataBulk to the skill documentation in that repo.

Link to Devin session: https://app.devin.ai/sessions/b5701e74c8b44bbf89db370f3323acf2
Requested by: @pyramation

@devin-ai-integration
Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@pyramation pyramation merged commit 2b9fafe into main May 14, 2026
38 checks passed
@pyramation pyramation deleted the devin/1778708878-bulk-docs-generator branch May 14, 2026 01:03
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