crudkit 0.6.0__tar.gz → 0.6.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. {crudkit-0.6.0 → crudkit-0.6.2}/CHANGELOG.md +28 -0
  2. {crudkit-0.6.0 → crudkit-0.6.2}/PKG-INFO +1 -1
  3. {crudkit-0.6.0 → crudkit-0.6.2}/pyproject.toml +1 -1
  4. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/authorization.py +1 -1
  5. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/models.py +6 -2
  6. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/metadata.py +36 -1
  7. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/services.py +18 -5
  8. crudkit-0.6.2/src/crudkit_api/tests/test_reorder.py +48 -0
  9. crudkit-0.6.2/src/crudkit_api/tests/test_search.py +48 -0
  10. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/views.py +39 -14
  11. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/agent.py +5 -0
  12. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_sidebar.py +27 -1
  13. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tools.py +23 -15
  14. crudkit-0.6.0/src/crudkit_frontend/static/crudkit_frontend/assets/index-BJRt310o.js → crudkit-0.6.2/src/crudkit_frontend/static/crudkit_frontend/assets/index-Q2WMdfSq.js +187 -187
  15. crudkit-0.6.2/src/crudkit_frontend/static/crudkit_frontend/assets/index-aBiOgiJ7.css +1 -0
  16. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/templates/crudkit_frontend/index.html +2 -2
  17. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_mcp.py +4 -0
  18. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/tools.py +5 -2
  19. crudkit-0.6.2/tests/testapp/migrations/0004_topic_sort_order.py +17 -0
  20. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/models.py +1 -0
  21. crudkit-0.6.0/src/crudkit_frontend/static/crudkit_frontend/assets/index-BEOWlk3y.css +0 -1
  22. {crudkit-0.6.0 → crudkit-0.6.2}/.gitignore +0 -0
  23. {crudkit-0.6.0 → crudkit-0.6.2}/README.md +0 -0
  24. {crudkit-0.6.0 → crudkit-0.6.2}/manage.py +0 -0
  25. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/__init__.py +0 -0
  26. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/admin.py +0 -0
  27. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/ai_backend.py +0 -0
  28. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/apps.py +0 -0
  29. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/audit.py +0 -0
  30. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/checks.py +0 -0
  31. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/decorators.py +0 -0
  32. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/fields.py +0 -0
  33. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/llm.py +0 -0
  34. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/management/__init__.py +0 -0
  35. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/management/commands/__init__.py +0 -0
  36. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/management/commands/add_default_exchange_rates.py +0 -0
  37. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/management/commands/backfill_ai_fields.py +0 -0
  38. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/management/commands/set_exchange_rate.py +0 -0
  39. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0001_squashed.py +0 -0
  40. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0002_workspace.py +0 -0
  41. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0003_enforce_data_invariants.py +0 -0
  42. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0004_changelog_audit.py +0 -0
  43. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0005_aicontext.py +0 -0
  44. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/0006_changelog_audit_indexes.py +0 -0
  45. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/migrations/__init__.py +0 -0
  46. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/profile.py +0 -0
  47. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/realtime.py +0 -0
  48. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/signals.py +0 -0
  49. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tasks.py +0 -0
  50. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/templatetags/__init__.py +0 -0
  51. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/templatetags/crm_forms.py +0 -0
  52. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/templatetags/crm_time.py +0 -0
  53. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/templatetags/gravatar.py +0 -0
  54. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/templatetags/model_magic.py +0 -0
  55. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/__init__.py +0 -0
  56. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_ai_backend.py +0 -0
  57. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_ai_context.py +0 -0
  58. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_ai_fields.py +0 -0
  59. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_ai_tasks.py +0 -0
  60. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_audit.py +0 -0
  61. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_authorization.py +0 -0
  62. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_backfill_command.py +0 -0
  63. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_fields.py +0 -0
  64. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_hardening.py +0 -0
  65. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_integrity.py +0 -0
  66. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_llm.py +0 -0
  67. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_money.py +0 -0
  68. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_tasks.py +0 -0
  69. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_view_filters.py +0 -0
  70. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/tests/test_workspace.py +0 -0
  71. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/utils.py +0 -0
  72. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit/widgets.py +0 -0
  73. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/__init__.py +0 -0
  74. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/authentication.py +0 -0
  75. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/consumers.py +0 -0
  76. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/filters.py +0 -0
  77. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/pagination.py +0 -0
  78. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/permissions.py +0 -0
  79. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/records.py +0 -0
  80. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/routing.py +0 -0
  81. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/serializers.py +0 -0
  82. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/__init__.py +0 -0
  83. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_authorization.py +0 -0
  84. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_email_id_serialization.py +0 -0
  85. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_filters.py +0 -0
  86. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_list_serialization.py +0 -0
  87. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_merge.py +0 -0
  88. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_metadata.py +0 -0
  89. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_realtime.py +0 -0
  90. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/tests/test_user_profile.py +0 -0
  91. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/urls.py +0 -0
  92. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_api/ws_auth.py +0 -0
  93. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/__init__.py +0 -0
  94. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/admin.py +0 -0
  95. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/apps.py +0 -0
  96. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/background.py +0 -0
  97. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/consumers.py +0 -0
  98. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/deps.py +0 -0
  99. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/execution.py +0 -0
  100. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0001_initial.py +0 -0
  101. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0002_assistantconversation.py +0 -0
  102. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0003_proposal_revert.py +0 -0
  103. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0004_proposal_sources.py +0 -0
  104. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/0005_agent_agentrun.py +0 -0
  105. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/migrations/__init__.py +0 -0
  106. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/models.py +0 -0
  107. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/proposals.py +0 -0
  108. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/routing.py +0 -0
  109. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/runner.py +0 -0
  110. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/screen.py +0 -0
  111. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/signals.py +0 -0
  112. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tasks.py +0 -0
  113. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/__init__.py +0 -0
  114. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_agents.py +0 -0
  115. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_approvals.py +0 -0
  116. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_hardening.py +0 -0
  117. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/tests/test_proposals.py +0 -0
  118. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_assistant/utils.py +0 -0
  119. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/__init__.py +0 -0
  120. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/apps.py +0 -0
  121. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/context_processors.py +0 -0
  122. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/static/crudkit_frontend/assets/favicon-Cit_9t8D.svg +0 -0
  123. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/tests/__init__.py +0 -0
  124. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/tests/templates/crudkit_frontend/index.html +0 -0
  125. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/tests/test_frontend.py +0 -0
  126. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/tests/urls.py +0 -0
  127. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/urls.py +0 -0
  128. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_frontend/views.py +0 -0
  129. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/__init__.py +0 -0
  130. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/admin.py +0 -0
  131. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/apps.py +0 -0
  132. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/authentication.py +0 -0
  133. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/checks.py +0 -0
  134. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/conf.py +0 -0
  135. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/migrations/0001_initial.py +0 -0
  136. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/migrations/__init__.py +0 -0
  137. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/models.py +0 -0
  138. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/oauth.py +0 -0
  139. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/server.py +0 -0
  140. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/templates/crudkit_mcp/authorize.html +0 -0
  141. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/tests/__init__.py +0 -0
  142. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_hardening.py +0 -0
  143. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/tests/test_oauth.py +0 -0
  144. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/urls.py +0 -0
  145. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/views.py +0 -0
  146. {crudkit-0.6.0 → crudkit-0.6.2}/src/crudkit_mcp/well_known_urls.py +0 -0
  147. {crudkit-0.6.0 → crudkit-0.6.2}/tests/__init__.py +0 -0
  148. {crudkit-0.6.0 → crudkit-0.6.2}/tests/celery.py +0 -0
  149. {crudkit-0.6.0 → crudkit-0.6.2}/tests/settings.py +0 -0
  150. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/__init__.py +0 -0
  151. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/adapters.py +0 -0
  152. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/ai.py +0 -0
  153. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/apps.py +0 -0
  154. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/migrations/0001_initial.py +0 -0
  155. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/migrations/0002_customer_currency.py +0 -0
  156. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/migrations/0003_ticket_watchers.py +0 -0
  157. {crudkit-0.6.0 → crudkit-0.6.2}/tests/testapp/migrations/__init__.py +0 -0
  158. {crudkit-0.6.0 → crudkit-0.6.2}/tests/urls.py +0 -0
@@ -1,5 +1,33 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.6.2 (2026-10-01)
4
+
5
+ - The assistant and agents can find the records that point at a record (association rows,
6
+ children): `describe_object` lists them under `related` with their counts, `get_related`
7
+ accepts the relation's accessor name, related name or TYPE_ID and names the valid relations
8
+ when it can't match, and leaves out soft-deleted rows. The default `get_ai_context()` shows
9
+ a foreign key's id next to its label (`case: Refund missing (CAS12)`), so the assistant can
10
+ follow it. Agents previously guessed relation names and concluded there were none. (#64)
11
+ - Workspace views in the sidebar get a colored dot like My Views instead of the grid icon.
12
+ (#63)
13
+
14
+ ## 0.6.1 (2026-10-01)
15
+
16
+ - Kanban card order persists: when a kanban view's `order_by` is a numeric field (e.g.
17
+ `sort_order`), dropping a card renumbers its column in that field through the new
18
+ `POST /api/v1/<TYPE>/reorder/` (`{"field", "ids"}`; needs change permission, one change
19
+ set). Without such a field, a card dropped within its own column snaps back instead of
20
+ showing an order that's lost on reload. (#60)
21
+ - Search by CRM ID. Every model's list search (`_q`), the global `/api/v1/search/`, FK
22
+ pickers, the MCP `search`/`list_records` tools and the assistant now match a record's CK-ID
23
+ exactly and case-insensitively (`cus123` finds `CUS123`), alongside its `search_fields`.
24
+ Models without `search_fields` are now included in global search (ID matches only), and a
25
+ list search on them no longer returns every row. A `TYPE:` scoped search with a second colon
26
+ no longer errors. (#56)
27
+ - `CRUDKIT_FRONTEND_CONFIG["brand_color"]` (any CSS color) replaces the indigo accent across
28
+ the UI in both themes. The sidebar logo no longer sits on an accent-colored tile; `logo_url`
29
+ is shown as-is. (#61)
30
+
3
31
  ## 0.6.0 (2026-09-29)
4
32
 
5
33
  - Hardening of proposals, undo and agents (#58):
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: crudkit
3
- Version: 0.6.0
3
+ Version: 0.6.2
4
4
  Summary: A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API.
5
5
  Project-URL: Homepage, https://github.com/fenerum/crudkit
6
6
  Project-URL: Changelog, https://github.com/fenerum/crudkit/blob/main/backend/CHANGELOG.md
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "crudkit"
3
- version = "0.6.0"
3
+ version = "0.6.2"
4
4
  description = "A metadata-driven CRUD framework for Django: typed object IDs, soft delete, merge, change log, activity feed, saved views, AI fields and a generic REST API."
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -7,7 +7,7 @@ from crudkit.utils import get_model_types
7
7
  def get_permission_action(method: str, view_action: str | None = None) -> str:
8
8
  if view_action in {"create", "initial_data"}:
9
9
  return "add"
10
- if view_action in {"update", "partial_update", "merge", "call_action", "restore"}:
10
+ if view_action in {"update", "partial_update", "merge", "reorder", "call_action", "restore"}:
11
11
  return "change"
12
12
  if view_action == "destroy":
13
13
  return "delete"
@@ -314,8 +314,12 @@ class BaseCrudKitModel(models.Model):
314
314
  if isinstance(field, (models.ImageField, models.FileField)):
315
315
  continue
316
316
  value = getattr(self, field.name, None)
317
- if value is not None:
318
- parts.append(f"{field.verbose_name}: {value}")
317
+ if value is None:
318
+ continue
319
+ # The id lets the assistant follow the link (get_object).
320
+ if hasattr(value, "TYPE_ID"):
321
+ value = f"{value} ({value.pk})"
322
+ parts.append(f"{field.verbose_name}: {value}")
319
323
  return "\n".join(parts)
320
324
 
321
325
  def get_fields(self):
@@ -18,6 +18,7 @@ from crudkit.authorization import get_authorized_queryset, has_model_permission
18
18
  from crudkit.fields import ModelField
19
19
  from crudkit.models import ExternalObject, FeedItem
20
20
  from crudkit.utils import get_model_types
21
+ from crudkit_api.records import SKIPPED_FIELDS
21
22
 
22
23
  # Fields that are housekeeping/audit — never useful patch targets and not
23
24
  # worth showing the LLM.
@@ -219,10 +220,35 @@ def _coerce_current_value(value: Any) -> Any:
219
220
  return str(value)
220
221
 
221
222
 
223
+ def reverse_relations(model, user=None) -> list:
224
+ """The relations through which CrudKit records point at a row of `model`
225
+ (reverse foreign keys and many-to-manys), limited to types `user` may view."""
226
+ return [
227
+ relation
228
+ for relation in model._meta.related_objects
229
+ if (relation.one_to_many or relation.many_to_many)
230
+ and not relation.hidden
231
+ and relation.field.name not in SKIPPED_FIELDS
232
+ and hasattr(relation.related_model, "TYPE_ID")
233
+ and (user is None or has_model_permission(user, relation.related_model, "view"))
234
+ ]
235
+
236
+
237
+ def related_queryset(instance: Model, relation, user=None):
238
+ """The live records pointing at `instance` through `relation` that `user` may view."""
239
+ queryset = getattr(instance, relation.get_accessor_name()).all()
240
+ if user is not None:
241
+ queryset = get_authorized_queryset(user, queryset, "view")
242
+ if "deleted" in {f.name for f in relation.related_model._meta.fields}:
243
+ queryset = queryset.filter(deleted=False)
244
+ return queryset
245
+
246
+
222
247
  def build_instance_metadata(instance: Model, user=None) -> dict[str, Any]:
223
248
  """Return a slim, LLM-friendly projection of the writable fields on an
224
249
  instance: name, type, current value, valid choices, FK options, plus
225
- the available @crm_action names. Skips audit/housekeeping fields."""
250
+ the available @crm_action names and the records pointing at it. Skips
251
+ audit/housekeeping fields."""
226
252
  base = build_model_metadata(instance.__class__)
227
253
  fields_out: dict[str, Any] = {}
228
254
  for name, meta in base["fields"].items():
@@ -250,4 +276,13 @@ def build_instance_metadata(instance: Model, user=None) -> dict[str, Any]:
250
276
  "type": base["type"],
251
277
  "fields": fields_out,
252
278
  "actions": [a["action"] for a in base["actions"]],
279
+ "related": [
280
+ {
281
+ "relation": relation.get_accessor_name(),
282
+ "type": relation.related_model.TYPE_ID,
283
+ "field": relation.field.name,
284
+ "count": related_queryset(instance, relation, user).count(),
285
+ }
286
+ for relation in (reverse_relations(instance.__class__, user) if instance.pk else [])
287
+ ],
253
288
  }
@@ -24,7 +24,15 @@ from crudkit.authorization import (
24
24
  require_object_permission,
25
25
  requires_approval,
26
26
  )
27
- from crudkit.models import ChangeLog, FeedItem, field_value, same_value
27
+ from crudkit.models import (
28
+ ChangeLog,
29
+ FeedItem,
30
+ ck_id_regex,
31
+ field_value,
32
+ get_accepted_type_ids,
33
+ parse_ck_id,
34
+ same_value,
35
+ )
28
36
  from crudkit.utils import get_model_types
29
37
  from crudkit_api.serializers import get_serializer
30
38
 
@@ -58,10 +66,15 @@ def get_search_fields(model) -> list[str]:
58
66
 
59
67
 
60
68
  def search_filter(model, query: str) -> Q:
61
- """Case-insensitive match of `query` against the model's `CrudKitSettings.search_fields`."""
62
- q = Q()
69
+ """Case-insensitive match of `query` against the model's CRM ID (exact) and its
70
+ `CrudKitSettings.search_fields` (substring). Matches nothing if neither applies."""
71
+ query = query.strip()
72
+ q = Q(pk__in=[])
73
+ ck_id = query.upper()
74
+ if ck_id_regex.fullmatch(ck_id) and ck_id[:3] in get_accepted_type_ids(model):
75
+ q |= Q(pk=parse_ck_id(ck_id)[1])
63
76
  for field in get_search_fields(model):
64
- q |= Q(**{f"{field}__icontains": query.strip()})
77
+ q |= Q(**{f"{field}__icontains": query})
65
78
  return q
66
79
 
67
80
 
@@ -71,7 +84,7 @@ def search_objects(user, query: str, models_to_search=None, limit_per_model: int
71
84
  models_to_search = get_model_types().values()
72
85
  results = []
73
86
  for mdl in models_to_search:
74
- if not get_search_fields(mdl) or not has_model_permission(user, mdl, "view"):
87
+ if not has_model_permission(user, mdl, "view"):
75
88
  continue
76
89
  serializer_cls = get_serializer(mdl, depth=0, fields=["id", "label", "object_images"])
77
90
  qs = get_authorized_queryset(user, mdl.objects.all(), "view").filter(search_filter(mdl, query))
@@ -0,0 +1,48 @@
1
+ from django.contrib.auth.models import User
2
+ from django.test import TestCase
3
+ from rest_framework.test import APIClient
4
+
5
+ from crudkit.models import ChangeLog
6
+ from crudkit_api.tests.test_authorization import grant
7
+ from crudkit_api.views import CHANGE_SET_HEADER
8
+ from tests.testapp.models import Topic
9
+
10
+
11
+ class ReorderTests(TestCase):
12
+ def setUp(self):
13
+ self.user = User.objects.create_superuser(username="admin", password="pw")
14
+ self.a, self.b, self.c = (
15
+ Topic.objects.create(name=name, created_by=self.user, updated_by=self.user) for name in ("a", "b", "c")
16
+ )
17
+ self.client = APIClient()
18
+ self.client.force_authenticate(self.user)
19
+
20
+ def reorder(self, field, ids):
21
+ return self.client.post("/api/v1/TOP/reorder/", {"field": field, "ids": ids}, format="json")
22
+
23
+ def sort_orders(self):
24
+ return dict(Topic.objects.values_list("name", "sort_order"))
25
+
26
+ def test_sets_field_to_position_in_one_change_set(self):
27
+ response = self.reorder("sort_order", [self.c.pk, self.a.pk, self.b.pk])
28
+
29
+ self.assertEqual(response.status_code, 204)
30
+ self.assertEqual(self.sort_orders(), {"c": 0, "a": 1, "b": 2})
31
+ # `c` already had 0, so only `a` and `b` changed.
32
+ entries = ChangeLog.objects.filter(field_changes__has_key="sort_order")
33
+ self.assertEqual(entries.count(), 2)
34
+ self.assertEqual({str(e.change_set) for e in entries}, {response[CHANGE_SET_HEADER]})
35
+
36
+ def test_rejects_invalid_field_or_ids(self):
37
+ for field in ("name", "id", "missing", None):
38
+ self.assertEqual(self.reorder(field, [self.a.pk]).status_code, 400, field)
39
+ for ids in ("nope", ["nope"], [1], ["CUS1"]):
40
+ self.assertEqual(self.reorder("sort_order", ids).status_code, 400, ids)
41
+
42
+ def test_requires_change_permission(self):
43
+ viewer = User.objects.create_user(username="viewer", password="pw")
44
+ grant(viewer, Topic, "view")
45
+ self.client.force_authenticate(viewer)
46
+
47
+ self.assertEqual(self.reorder("sort_order", [self.c.pk, self.b.pk, self.a.pk]).status_code, 403)
48
+ self.assertEqual(set(self.sort_orders().values()), {0})
@@ -0,0 +1,48 @@
1
+ from django.contrib.auth.models import User
2
+ from django.test import TestCase
3
+ from rest_framework.test import APIClient
4
+
5
+ from crudkit_api.tests.test_authorization import grant
6
+ from tests.testapp.models import Comment, Customer, Ticket
7
+
8
+
9
+ class SearchByIdTests(TestCase):
10
+ def setUp(self):
11
+ self.user = User.objects.create_user(username="searcher", password="pw")
12
+ for model in (Customer, Ticket, Comment):
13
+ grant(self.user, model, "view")
14
+ self.customer = Customer.objects.create(name="Acme", created_by=self.user, updated_by=self.user)
15
+ Customer.objects.create(name="Other", created_by=self.user, updated_by=self.user)
16
+ self.ticket = Ticket.objects.create(subject="Broken", created_by=self.user, updated_by=self.user)
17
+ self.comment = Comment.objects.create(
18
+ ticket=self.ticket, body="Looking into it", created_by=self.user, updated_by=self.user
19
+ )
20
+ self.client = APIClient()
21
+ self.client.force_authenticate(self.user)
22
+
23
+ def list_ids(self, type_id, query):
24
+ response = self.client.get(f"/api/v1/{type_id}/", {"_q": query})
25
+ self.assertEqual(response.status_code, 200)
26
+ return [row["id"] for row in response.data["results"]]
27
+
28
+ def search_ids(self, query):
29
+ response = self.client.get("/api/v1/search/", {"q": query})
30
+ self.assertEqual(response.status_code, 200)
31
+ return [row["id"] for row in response.data["results"]]
32
+
33
+ def test_list_search_matches_id_case_insensitively(self):
34
+ self.assertEqual(self.list_ids("CUS", self.customer.pk), [self.customer.pk])
35
+ self.assertEqual(self.list_ids("CUS", f" {self.customer.pk.lower()} "), [self.customer.pk])
36
+
37
+ def test_list_search_ignores_other_types_ids(self):
38
+ self.assertEqual(self.list_ids("CUS", self.ticket.pk), [])
39
+ self.assertEqual(self.list_ids("CUS", "acm"), [self.customer.pk])
40
+
41
+ def test_model_without_search_fields(self):
42
+ self.assertEqual(self.list_ids("COM", "Looking"), [])
43
+ self.assertEqual(self.list_ids("COM", self.comment.pk), [self.comment.pk])
44
+
45
+ def test_global_search_by_id(self):
46
+ self.assertEqual(self.search_ids(self.comment.pk.lower()), [self.comment.pk])
47
+ self.assertEqual(self.search_ids(f"TIC:{self.ticket.pk}"), [self.ticket.pk])
48
+ self.assertEqual(self.search_ids("CUS:a:b"), [])
@@ -3,7 +3,7 @@ import re
3
3
 
4
4
  from django.contrib.auth.models import User
5
5
  from django.contrib.contenttypes.fields import GenericForeignKey, GenericRelation
6
- from django.core.exceptions import ValidationError
6
+ from django.core.exceptions import FieldDoesNotExist, ValidationError
7
7
  from django.db import connection, models, reset_queries, transaction
8
8
  from django.db.models import ProtectedError
9
9
  from django.http import HttpResponseRedirect
@@ -24,7 +24,7 @@ from crudkit.authorization import (
24
24
  has_action_permission,
25
25
  has_model_permission,
26
26
  )
27
- from crudkit.models import BaseCrudKitModel, ChangeLog
27
+ from crudkit.models import BaseCrudKitModel, ChangeLog, ck_id_regex
28
28
  from crudkit.utils import get_model_types
29
29
  from crudkit_api.metadata import build_model_metadata
30
30
  from crudkit_api.permissions import CrudKitModelPermissions
@@ -44,6 +44,7 @@ from crudkit_api.services import (
44
44
  # agents), and no request can claim it.
45
45
  SPA_CLIENT_ID = "CrudKitAPIClient"
46
46
  CHANGE_SET_HEADER = "X-CrudKit-Change-Set"
47
+ ORDERABLE_FIELDS = (models.IntegerField, models.FloatField, models.DecimalField)
47
48
 
48
49
 
49
50
  class AuditedViewMixin:
@@ -240,6 +241,39 @@ class GenericViewSet(AuditedViewMixin, viewsets.ModelViewSet):
240
241
  except (ValidationError, ProtectedError) as e:
241
242
  return Response({"errors": [str(e)]}, status=400)
242
243
 
244
+ @action(["POST"], detail=False)
245
+ def reorder(self, request):
246
+ """Set the numeric `field` of each record in `ids` (CK-IDs) to its position,
247
+ e.g. after a card is dragged within a kanban column sorted by that field."""
248
+ field_name, ids = request.data.get("field"), request.data.get("ids")
249
+ model = self.queryset.model
250
+ try:
251
+ field = model._meta.get_field(field_name)
252
+ except (FieldDoesNotExist, TypeError):
253
+ field = None
254
+ if (
255
+ not isinstance(field, ORDERABLE_FIELDS)
256
+ or not field.concrete
257
+ or not field.editable
258
+ or field.primary_key
259
+ or not isinstance(ids, list)
260
+ or not all(isinstance(pk, str) and ck_id_regex.fullmatch(pk) and pk[:3] == model.TYPE_ID for pk in ids)
261
+ ):
262
+ return Response({"errors": [f"Cannot reorder by {field_name!r}"]}, status=400)
263
+
264
+ with transaction.atomic():
265
+ objects = {obj.pk: obj for obj in self.filter_queryset(self.get_queryset()).filter(pk__in=ids)}
266
+ for position, pk in enumerate(ids):
267
+ obj = objects.get(pk)
268
+ if obj is None or getattr(obj, field.name) == position:
269
+ continue
270
+ before = copy.copy(obj)
271
+ setattr(obj, field.name, position)
272
+ obj.updated_by = request.user
273
+ obj.save()
274
+ ChangeLog.objects.create_from_objects(before, obj)
275
+ return Response(status=204)
276
+
243
277
  @action(["POST"], detail=True, url_path="action")
244
278
  def call_action(self, request, pk=None):
245
279
  instance = self.get_object()
@@ -325,19 +359,10 @@ class SearchViewSet(viewsets.ViewSet):
325
359
  if not query:
326
360
  return Response({"results": []})
327
361
 
362
+ possible_searches = list(get_model_types().values())
328
363
  if len(query) > 3 and CRM_TYPE_REGEX.match(query) and ":" in query:
329
- search_type, query = query.split(":")
330
- possible_searches = [
331
- mdl
332
- for mdl in get_model_types().values()
333
- if hasattr(mdl, "CrudKitSettings") and mdl.CrudKitSettings.search_fields and mdl.TYPE_ID == search_type
334
- ]
335
- else:
336
- possible_searches = [
337
- mdl
338
- for mdl in get_model_types().values()
339
- if hasattr(mdl, "CrudKitSettings") and mdl.CrudKitSettings.search_fields
340
- ]
364
+ search_type, query = query.split(":", 1)
365
+ possible_searches = [mdl for mdl in possible_searches if mdl.TYPE_ID == search_type]
341
366
 
342
367
  # One more than the palette shows per type, so it knows when to offer "Show all".
343
368
  results = search_objects(request.user, query, possible_searches, 21 if len(possible_searches) == 1 else 6)
@@ -70,6 +70,11 @@ The ONLY tools you may call are exactly these — never invent another name:
70
70
  Record and propose tools take an optional `id` (e.g. CUS123); without it they
71
71
  use the record open on screen. Use `get_screen_rows` to read the selected or
72
72
  visible rows of a list, and `list_records(view=...)` for a whole saved view.
73
+ Records that point at a record (its children, links and association rows)
74
+ are listed under `related` in `describe_object`, with their counts: read them
75
+ with `get_related(relation)` and follow the ids in what it returns with
76
+ `get_object(id)`. Never conclude a record has no related records without
77
+ checking `related`.
73
78
 
74
79
  Proposals do NOT take effect immediately — they pop up as a Confirm/Skip
75
80
  card in the user's chat. You will be told the outcome in a later turn
@@ -23,7 +23,7 @@ from crudkit_assistant.deps import AssistantDeps
23
23
  from crudkit_assistant.models import AssistantConversation, AssistantProposal
24
24
  from crudkit_assistant.routing import websocket_urlpatterns
25
25
  from crudkit_assistant.screen import MAX_IDS, Screen, describe_screen, parse_screen
26
- from tests.testapp.models import Customer
26
+ from tests.testapp.models import Comment, Customer, Ticket
27
27
 
28
28
  User = get_user_model()
29
29
 
@@ -150,6 +150,32 @@ class CrossRecordToolTests(TestCase):
150
150
  self.assertTrue(self.run_tool(tools.get_related, "notes", id=self.other.pk).startswith("ERROR: Unknown"))
151
151
  self.assertIn("Other", self.run_tool(tools.get_object, id=self.other.pk))
152
152
 
153
+ def test_related_records_are_listed_and_followable(self):
154
+ grant(self.user, "view_ticket", "view_comment")
155
+ ticket = Ticket.objects.create(
156
+ customer=self.other, subject="Broken", created_by=self.user, updated_by=self.user
157
+ )
158
+ Ticket.objects.create(
159
+ customer=self.other, subject="Gone", deleted=True, created_by=self.user, updated_by=self.user
160
+ )
161
+ Comment.objects.create(ticket=ticket, body="Still broken", created_by=self.user, updated_by=self.user)
162
+
163
+ related = self.run_tool(tools.describe_object, id=self.other.pk)["related"]
164
+ self.assertEqual(related, [{"relation": "ticket_set", "type": "TIC", "field": "customer", "count": 1}])
165
+ for name in ("ticket_set", "ticket", "TIC"):
166
+ rows = self.run_tool(tools.get_related, name, id=self.other.pk)
167
+ self.assertEqual([row["id"] for row in rows], [ticket.pk])
168
+ error = self.run_tool(tools.get_related, "case_set", id=self.other.pk)
169
+ self.assertIn("Valid: ['ticket_set (TIC)']", error)
170
+ # Rows name the records they point at by id, so the assistant can follow them.
171
+ comment = self.run_tool(tools.get_related, "comment_set", id=ticket.pk)[0]
172
+ self.assertIn(f"ticket: Broken ({ticket.pk})", comment["context"])
173
+
174
+ def test_related_types_the_user_cannot_view_are_left_out(self):
175
+ Ticket.objects.create(customer=self.other, subject="Broken", created_by=self.user, updated_by=self.user)
176
+ self.assertEqual(self.run_tool(tools.describe_object, id=self.other.pk)["related"], [])
177
+ self.assertTrue(self.run_tool(tools.get_related, "ticket_set", id=self.other.pk).startswith("ERROR"))
178
+
153
179
  def test_screen_rows_skip_hidden_records(self):
154
180
  with hide(self.other):
155
181
  rows = self.run_tool(tools.get_screen_rows)
@@ -27,13 +27,12 @@ from pydantic_ai import RunContext
27
27
 
28
28
  from crudkit.authorization import (
29
29
  get_authorized_instance,
30
- get_authorized_queryset,
31
30
  has_action_permission,
32
31
  has_model_permission,
33
32
  )
34
33
  from crudkit.models import ChangeLog, parse_ck_id
35
34
  from crudkit_api import records, services
36
- from crudkit_api.metadata import build_instance_metadata
35
+ from crudkit_api.metadata import build_instance_metadata, related_queryset, reverse_relations
37
36
  from crudkit_assistant.deps import AssistantDeps
38
37
  from crudkit_assistant.models import AssistantProposal
39
38
  from crudkit_assistant.proposals import create_proposal, patch_label
@@ -159,23 +158,32 @@ async def get_feed(
159
158
  async def get_related(
160
159
  ctx: RunContext[AssistantDeps], relation_name: str, id: str | None = None, limit: int = 20
161
160
  ) -> list[dict[str, Any]] | str:
162
- """Walk a reverse FK relation on a record (default: the one open on screen),
163
- e.g. 'activity_set', 'opportunityproduct_set', 'message_set'. Returns up
164
- to `limit` rows summarised via get_ai_context()."""
161
+ """List the records pointing at a record (default: the one open on screen)
162
+ through one of the relations in describe_object's `related`, e.g.
163
+ 'ticket_set' (or its TYPE_ID, 'TIC'). Returns up to `limit` rows
164
+ summarised via get_ai_context()."""
165
165
 
166
166
  def _run():
167
167
  instance, error = _load_instance(ctx.deps, id)
168
168
  if instance is None:
169
169
  return f"ERROR: {error}"
170
- manager = getattr(instance, relation_name, None)
171
- if manager is None or not hasattr(manager, "all"):
172
- return f"ERROR: Unknown relation {relation_name!r}"
173
- out = []
174
- queryset = get_authorized_queryset(_load_user(ctx.deps), manager.all(), "view")
175
- for obj in queryset[:limit]:
176
- ctx_text = obj.get_ai_context() if hasattr(obj, "get_ai_context") else str(obj)
177
- out.append({"id": str(getattr(obj, "id", obj.pk)), "context": ctx_text})
178
- return out
170
+ user = _load_user(ctx.deps)
171
+ relations = reverse_relations(instance.__class__, user)
172
+ relation = next(
173
+ (
174
+ rel
175
+ for rel in relations
176
+ if relation_name in (rel.get_accessor_name(), rel.name, rel.related_model.TYPE_ID)
177
+ ),
178
+ None,
179
+ )
180
+ if relation is None:
181
+ valid = [f"{rel.get_accessor_name()} ({rel.related_model.TYPE_ID})" for rel in relations]
182
+ return f"ERROR: Unknown relation {relation_name!r}. Valid: {valid}"
183
+ return [
184
+ {"id": str(obj.pk), "context": obj.get_ai_context()}
185
+ for obj in related_queryset(instance, relation, user)[:limit]
186
+ ]
179
187
 
180
188
  return await sync_to_async(_run)()
181
189
 
@@ -193,7 +201,7 @@ async def _records_call(ctx: RunContext[AssistantDeps], fn, *args, **kwargs):
193
201
 
194
202
 
195
203
  async def search(ctx: RunContext[AssistantDeps], query: str) -> list[dict[str, Any]] | dict:
196
- """Search all record types by text. Returns matching records as {id, label}."""
204
+ """Search all record types by text or record ID (e.g. CUS123). Returns matching records as {id, label}."""
197
205
  return await _records_call(ctx, records.search, query)
198
206
 
199
207