framework-m-core 0.35.1__tar.gz → 0.36.1__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 (308) hide show
  1. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/.gitignore +7 -0
  2. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/CHANGELOG.md +27 -0
  3. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/PKG-INFO +4 -4
  4. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/pyproject.toml +4 -4
  5. framework_m_core-0.36.1/src/framework_m_core/cli/completers.py +127 -0
  6. framework_m_core-0.36.1/src/framework_m_core/cli/completion.py +182 -0
  7. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/cli/main.py +10 -4
  8. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/cli/plugin_loader.py +1 -1
  9. framework_m_core-0.36.1/src/framework_m_core/cli/tenant_resolver.py +185 -0
  10. framework_m_core-0.36.1/src/framework_m_core/cli/tenants.py +217 -0
  11. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/config.py +4 -0
  12. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/container.py +8 -2
  13. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/__init__.py +4 -0
  14. framework_m_core-0.36.1/src/framework_m_core/doctypes/naming_counter.py +5 -0
  15. framework_m_core-0.36.1/src/framework_m_core/doctypes/outbox.py +127 -0
  16. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/base_doctype.py +11 -0
  17. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/navigation.py +3 -0
  18. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/exceptions.py +40 -0
  19. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/__init__.py +14 -0
  20. framework_m_core-0.36.1/src/framework_m_core/interfaces/inference.py +126 -0
  21. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/notification.py +7 -2
  22. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/repository.py +1 -0
  23. {framework_m_core-0.35.1/src/framework_m_core/locales/fr → framework_m_core-0.36.1/src/framework_m_core/locales/en}/common.json +2 -0
  24. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/locales/es/common.json +2 -0
  25. {framework_m_core-0.35.1/src/framework_m_core/locales/hi → framework_m_core-0.36.1/src/framework_m_core/locales/fr}/common.json +2 -0
  26. {framework_m_core-0.35.1/src/framework_m_core/locales/en → framework_m_core-0.36.1/src/framework_m_core/locales/hi}/common.json +2 -0
  27. framework_m_core-0.36.1/src/framework_m_core/locales/mr/common.json +379 -0
  28. framework_m_core-0.36.1/src/framework_m_core/locales/ta/common.json +379 -0
  29. framework_m_core-0.36.1/src/framework_m_core/locales/ur/common.json +379 -0
  30. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/permissions.py +39 -6
  31. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/rls.py +15 -2
  32. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_cli_init.py +1 -2
  33. framework_m_core-0.36.1/tests/cli/test_completers.py +89 -0
  34. framework_m_core-0.36.1/tests/cli/test_completion.py +135 -0
  35. framework_m_core-0.36.1/tests/cli/test_tenants.py +285 -0
  36. framework_m_core-0.36.1/tests/core/doctypes/test_naming_counter_discovery.py +36 -0
  37. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_outbox.py +20 -10
  38. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_repository.py +1 -0
  39. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_smoke_interfaces.py +32 -0
  40. framework_m_core-0.36.1/tests/unit/core/test_config_schema.py +116 -0
  41. framework_m_core-0.35.1/src/framework_m_core/cli/config.py +0 -131
  42. framework_m_core-0.35.1/src/framework_m_core/domain/outbox.py +0 -87
  43. framework_m_core-0.35.1/src/framework_m_core/locales/mr/common.json +0 -377
  44. framework_m_core-0.35.1/src/framework_m_core/locales/ta/common.json +0 -377
  45. framework_m_core-0.35.1/src/framework_m_core/locales/ur/common.json +0 -377
  46. framework_m_core-0.35.1/tests/cli/test_config.py +0 -368
  47. framework_m_core-0.35.1/tests/unit/core/test_config_schema.py +0 -49
  48. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/LICENSE +0 -0
  49. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/README.md +0 -0
  50. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/__init__.py +0 -0
  51. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/cli/__init__.py +0 -0
  52. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/cli/utility.py +0 -0
  53. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/constants.py +0 -0
  54. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/crypto/__init__.py +0 -0
  55. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/crypto/dual_signature.py +0 -0
  56. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/crypto/jcs.py +0 -0
  57. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/crypto/key_provider.py +0 -0
  58. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/crypto/registry.py +0 -0
  59. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/decorators.py +0 -0
  60. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/di.py +0 -0
  61. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/activity_log.py +0 -0
  62. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/alpe_nonce.py +0 -0
  63. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/api_key.py +0 -0
  64. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/auto_report.py +0 -0
  65. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/crypto.py +0 -0
  66. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/custom_permission.py +0 -0
  67. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/document_share.py +0 -0
  68. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/email_queue.py +0 -0
  69. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/error_log.py +0 -0
  70. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/file.py +0 -0
  71. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/idempotency_key.py +0 -0
  72. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/job_log.py +0 -0
  73. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/landing_candidate.py +0 -0
  74. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/letterhead.py +0 -0
  75. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/notification.py +0 -0
  76. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/print_format.py +0 -0
  77. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/recent_document.py +0 -0
  78. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/report.py +0 -0
  79. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/saved_view.py +0 -0
  80. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/scheduled_job.py +0 -0
  81. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/session.py +0 -0
  82. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/social_account.py +0 -0
  83. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/system_settings.py +0 -0
  84. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/tenant_translation.py +0 -0
  85. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/todo.py +0 -0
  86. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/translation.py +0 -0
  87. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/user.py +0 -0
  88. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/webhook.py +0 -0
  89. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/webhook_log.py +0 -0
  90. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/workflow.py +0 -0
  91. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/workflow_state.py +0 -0
  92. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/workflow_state_definition.py +0 -0
  93. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/workflow_transition.py +0 -0
  94. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/doctypes/workflow_transition_definition.py +0 -0
  95. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/__init__.py +0 -0
  96. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/base_controller.py +0 -0
  97. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/diff.py +0 -0
  98. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/landing.py +0 -0
  99. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/meta.py +0 -0
  100. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/migration_engine.py +0 -0
  101. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/mixins.py +0 -0
  102. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/naming_counter.py +0 -0
  103. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/domain/redactor.py +0 -0
  104. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/events/__init__.py +0 -0
  105. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/events/handlers.py +0 -0
  106. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/audit.py +0 -0
  107. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/auth_context.py +0 -0
  108. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/authentication.py +0 -0
  109. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/base_doctype.py +0 -0
  110. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/bootstrap.py +0 -0
  111. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/cache.py +0 -0
  112. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/composition.py +0 -0
  113. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/controller.py +0 -0
  114. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/db_resolver.py +0 -0
  115. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/defaults.py +0 -0
  116. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/discovery.py +0 -0
  117. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/email_queue.py +0 -0
  118. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/email_sender.py +0 -0
  119. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/event_bus.py +0 -0
  120. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/feature_entitlement.py +0 -0
  121. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/i18n.py +0 -0
  122. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/idempotency.py +0 -0
  123. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/identity.py +0 -0
  124. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/introspection.py +0 -0
  125. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/job_logger.py +0 -0
  126. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/job_queue.py +0 -0
  127. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/landing.py +0 -0
  128. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/logging.py +0 -0
  129. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/metering.py +0 -0
  130. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/navigation.py +0 -0
  131. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/nonce.py +0 -0
  132. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/oauth.py +0 -0
  133. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/payload_crypto.py +0 -0
  134. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/permission.py +0 -0
  135. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/print.py +0 -0
  136. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/read_model.py +0 -0
  137. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/redactor.py +0 -0
  138. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/registry.py +0 -0
  139. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/rehydration.py +0 -0
  140. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/report_engine.py +0 -0
  141. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/schema_mapper.py +0 -0
  142. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/search.py +0 -0
  143. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/secrets.py +0 -0
  144. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/session.py +0 -0
  145. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/sms_gateway.py +0 -0
  146. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/socket.py +0 -0
  147. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/storage.py +0 -0
  148. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/template.py +0 -0
  149. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/tenant.py +0 -0
  150. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/ticker.py +0 -0
  151. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/webhook.py +0 -0
  152. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/worker.py +0 -0
  153. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/interfaces/workflow.py +0 -0
  154. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/jobs_registry.py +0 -0
  155. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/metadata_decorator.py +0 -0
  156. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/permission_lookup.py +0 -0
  157. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/pii.py +0 -0
  158. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/py.typed +0 -0
  159. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/registry.py +0 -0
  160. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/rpc_registry.py +0 -0
  161. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/schema_enrichment.py +0 -0
  162. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/security.py +0 -0
  163. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/__init__.py +0 -0
  164. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/defaults_service.py +0 -0
  165. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/document_id.py +0 -0
  166. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/health_server.py +0 -0
  167. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/landing.py +0 -0
  168. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/secrets_service.py +0 -0
  169. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/user_manager.py +0 -0
  170. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/services/webhook_dispatcher.py +0 -0
  171. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/system_context.py +0 -0
  172. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/types/job_context.py +0 -0
  173. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/src/framework_m_core/unit_of_work.py +0 -0
  174. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_cli_commands.py +0 -0
  175. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_cli_main.py +0 -0
  176. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_info_plugins.py +0 -0
  177. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_plugin_loader.py +0 -0
  178. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/cli/test_utility.py +0 -0
  179. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/conftest.py +0 -0
  180. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_api_key.py +0 -0
  181. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_job_log.py +0 -0
  182. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_report.py +0 -0
  183. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_scheduled_job.py +0 -0
  184. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_social_account.py +0 -0
  185. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_user.py +0 -0
  186. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_webhook.py +0 -0
  187. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_webhook_log.py +0 -0
  188. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/doctypes/test_workflow_ui.py +0 -0
  189. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/domain/test_meta_discovery.py +0 -0
  190. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/domain/test_naming_counter.py +0 -0
  191. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/events/test_doc_events.py +0 -0
  192. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_cache.py +0 -0
  193. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_email_queue_protocol.py +0 -0
  194. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_idempotency.py +0 -0
  195. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_identity.py +0 -0
  196. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_repository_temporal.py +0 -0
  197. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_sms_gateway.py +0 -0
  198. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_socket.py +0 -0
  199. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/interfaces/test_workflow.py +0 -0
  200. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/services/test_user_manager.py +0 -0
  201. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/services/test_webhook_dispatcher.py +0 -0
  202. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_activity_log.py +0 -0
  203. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_child_table_permissions.py +0 -0
  204. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_container.py +0 -0
  205. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_container_async.py +0 -0
  206. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_crypto_registry.py +0 -0
  207. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_custom_permission.py +0 -0
  208. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_custom_protocols.py +0 -0
  209. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_di.py +0 -0
  210. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_document_share.py +0 -0
  211. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_email_queue.py +0 -0
  212. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_error_log.py +0 -0
  213. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_exceptions.py +0 -0
  214. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_exports.py +0 -0
  215. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_file.py +0 -0
  216. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_job_decorator.py +0 -0
  217. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_landing_candidate.py +0 -0
  218. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_link_field_leakage.py +0 -0
  219. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_meta_registry_baking.py +0 -0
  220. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_meta_registry_overrides.py +0 -0
  221. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_metadata_decorator.py +0 -0
  222. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_metadata_runtime_patch.py +0 -0
  223. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_notification.py +0 -0
  224. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_object_level_permissions.py +0 -0
  225. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_permission_config.py +0 -0
  226. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_permission_conveniences.py +0 -0
  227. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_permission_lookup.py +0 -0
  228. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_permissions.py +0 -0
  229. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_pii.py +0 -0
  230. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_print_format.py +0 -0
  231. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_registry_edge_cases.py +0 -0
  232. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_rls.py +0 -0
  233. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_rls_list_filters.py +0 -0
  234. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_rpc_decorator.py +0 -0
  235. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_schema_extension.py +0 -0
  236. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_security.py +0 -0
  237. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_session.py +0 -0
  238. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_share_lookup.py +0 -0
  239. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_singles.py +0 -0
  240. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_system_context.py +0 -0
  241. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_system_settings.py +0 -0
  242. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_table_alteration.py +0 -0
  243. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_team_based_access.py +0 -0
  244. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_tenant.py +0 -0
  245. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_ui_context_registry.py +0 -0
  246. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_unit_of_work.py +0 -0
  247. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_user_preferences_locale.py +0 -0
  248. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/test_whitelist_decorator.py +0 -0
  249. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/core/types/test_job_context.py +0 -0
  250. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/domain/test_base_doctype_edge_cases.py +0 -0
  251. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/domain/test_landing_models.py +0 -0
  252. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/domain/test_navigation_models.py +0 -0
  253. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/domain/test_registry_roles.py +0 -0
  254. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/events/test_auth_events.py +0 -0
  255. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_activity_registry.py +0 -0
  256. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_authentication.py +0 -0
  257. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_discovery_port.py +0 -0
  258. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_logging_protocol.py +0 -0
  259. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_redactor_port.py +0 -0
  260. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/interfaces/test_worker_protocol.py +0 -0
  261. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/services/test_health_server.py +0 -0
  262. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/doctypes/test_auto_report.py +0 -0
  263. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/doctypes/test_saved_view.py +0 -0
  264. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_base_controller.py +0 -0
  265. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_base_controller_audit.py +0 -0
  266. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_base_controller_submitted.py +0 -0
  267. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_base_doctype_implements_protocol.py +0 -0
  268. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_diff.py +0 -0
  269. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_migration_engine.py +0 -0
  270. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_mixins.py +0 -0
  271. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/domain/test_redactor_logic.py +0 -0
  272. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/events/test_read_model_projector.py +0 -0
  273. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_audit.py +0 -0
  274. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_auth_context.py +0 -0
  275. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_base_doctype_protocol.py +0 -0
  276. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_bootstrap_protocol.py +0 -0
  277. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_controller_protocol.py +0 -0
  278. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_core_report_engine.py +0 -0
  279. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_db_resolver.py +0 -0
  280. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_defaults.py +0 -0
  281. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_event_bus.py +0 -0
  282. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_feature_entitlement.py +0 -0
  283. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_i18n.py +0 -0
  284. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_introspection.py +0 -0
  285. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_job_queue.py +0 -0
  286. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_landing.py +0 -0
  287. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_metering.py +0 -0
  288. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_navigation.py +0 -0
  289. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_permission.py +0 -0
  290. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_print.py +0 -0
  291. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_schema_mapper_protocol.py +0 -0
  292. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_search.py +0 -0
  293. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_storage.py +0 -0
  294. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/interfaces/test_ticker.py +0 -0
  295. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/services/test_defaults_service.py +0 -0
  296. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/services/test_document_id.py +0 -0
  297. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/services/test_landing_service.py +0 -0
  298. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/services/test_secrets_service.py +0 -0
  299. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_config_expansion.py +0 -0
  300. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_meta_indexes.py +0 -0
  301. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_registry.py +0 -0
  302. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_registry_discovery.py +0 -0
  303. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_schema_enrichment.py +0 -0
  304. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_selective_apps.py +0 -0
  305. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/core/test_webhooks.py +0 -0
  306. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/crypto/test_dual_signature.py +0 -0
  307. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/crypto/test_jcs.py +0 -0
  308. {framework_m_core-0.35.1 → framework_m_core-0.36.1}/tests/unit/test_base_doctype.py +0 -0
@@ -31,6 +31,7 @@ env/
31
31
 
32
32
  # UV
33
33
  .uv/
34
+ .uv_cache/
34
35
  uv.lock
35
36
 
36
37
  # IDE
@@ -138,3 +139,9 @@ website/node_modules/
138
139
 
139
140
  # Framework M
140
141
  framework_config.toml
142
+
143
+ # MCPs
144
+ .codegraph
145
+
146
+ # Local directory for agents
147
+ .agents.local
@@ -1,3 +1,30 @@
1
+ ## framework-m-core v0.36.1
2
+
3
+ ### Bug Fixes
4
+
5
+ - update dependencies (26284c1)
6
+
7
+ ## framework-m-core v0.36.0
8
+
9
+ ### Features
10
+
11
+ - register NamingCounter in core doctypes for auto-discovery (3c8e21e)
12
+ - outbox retry backoff and attempt scheduling (e57b20f)
13
+ - implement outbox doctype and controller (af49e58)
14
+ - support navigation order and resource attributes in permissions (12b7bac)
15
+ - support optimistic concurrency metadata and outbox processing state (5531f65)
16
+ - add shell completions, tenant resolver, and multi-tenant cli commands (bd68b7c)
17
+
18
+ ### Bug Fixes
19
+
20
+ - move OutboxEntry from domain to doctypes module (9785512)
21
+ - strip legacy twin fields and syncing validator from outbox (a3b0f4f)
22
+ - remove field descriptions to prevent translation extraction (f59dbe7)
23
+ - update dependencies (f3f054c)
24
+ - update dependencies (b531d5e)
25
+ - extract translations (31ddf67)
26
+ - update dependencies (e87a319)
27
+
1
28
  ## framework-m-core v0.35.1
2
29
 
3
30
  ### Bug Fixes
@@ -1,14 +1,14 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: framework-m-core
3
- Version: 0.35.1
3
+ Version: 0.36.1
4
4
  Summary: Core protocols and dependency injection for Framework M
5
5
  Author: Framework M Contributors
6
6
  License: Apache-2.0
7
7
  License-File: LICENSE
8
8
  Requires-Python: >=3.12
9
- Requires-Dist: cyclopts>=5.1.1
10
- Requires-Dist: pydantic-settings>=2.15.0
11
- Requires-Dist: pydantic>=2.13.5
9
+ Requires-Dist: cyclopts>=5.3.0
10
+ Requires-Dist: pydantic-settings>=2.16.1
11
+ Requires-Dist: pydantic>=2.14.1
12
12
  Description-Content-Type: text/markdown
13
13
 
14
14
  # Framework M Core
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "framework-m-core"
3
- version = "0.35.1"
3
+ version = "0.36.1"
4
4
  description = "Core protocols and dependency injection for Framework M"
5
5
  readme = "README.md"
6
6
  license = { text = "Apache-2.0" }
@@ -9,9 +9,9 @@ authors = [
9
9
  { name = "Framework M Contributors" }
10
10
  ]
11
11
  dependencies = [
12
- "pydantic>=2.13.5",
13
- "pydantic-settings>=2.15.0",
14
- "cyclopts>=5.1.1",
12
+ "pydantic>=2.14.1",
13
+ "pydantic-settings>=2.16.1",
14
+ "cyclopts>=5.3.0",
15
15
  ]
16
16
 
17
17
  [build-system]
@@ -0,0 +1,127 @@
1
+ """Dynamic shell-completion candidate providers for the ``m`` CLI.
2
+
3
+ Cyclopts invokes the registered ``Parameter.completer`` callables when a user
4
+ presses ``<TAB>`` (through the reserved ``__complete`` command). Each completer
5
+ receives a :class:`~cyclopts.core.CompletionContext` and returns an iterable of
6
+ candidates.
7
+
8
+ The helpers in this module are intentionally defensive: a completer must never
9
+ raise into the shell (a broken completion is far worse than no completion), so
10
+ discovery failures degrade to an empty candidate list.
11
+
12
+ Candidate sources provided here:
13
+
14
+ - ``complete_apps``: installed business apps / CLI plugin names.
15
+ - ``complete_doctypes``: DocTypes registered in the ``MetaRegistry``.
16
+ - ``complete_config_keys``: dotted config keys from ``framework_config.toml``
17
+ and the built-in defaults.
18
+ - ``complete_tenants``: tenant identifiers from the ``[tenants]`` config section.
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import contextlib
24
+ from collections.abc import Iterable
25
+ from typing import TYPE_CHECKING, Any
26
+
27
+ if TYPE_CHECKING: # pragma: no cover - typing only
28
+ from cyclopts.completion import CompletionContext
29
+
30
+ __all__ = [
31
+ "complete_apps",
32
+ "complete_config_keys",
33
+ "complete_doctypes",
34
+ "complete_tenants",
35
+ ]
36
+
37
+
38
+ def _iter_entry_point_names(group: str) -> Iterable[str]:
39
+ """Yield entry-point names for ``group`` without raising."""
40
+ with contextlib.suppress(Exception):
41
+ from importlib.metadata import entry_points
42
+
43
+ for ep in entry_points(group=group):
44
+ yield ep.name
45
+
46
+
47
+ def complete_apps(context: CompletionContext | None = None) -> list[str]:
48
+ """Return installed business app / CLI plugin names as completion candidates.
49
+
50
+ Combines ``framework_m.apps`` (business apps) with the
51
+ ``framework_m_core.cli_commands`` entry-point group (CLI plugins) so that
52
+ both produce sensible tab-completion suggestions.
53
+ """
54
+ names: set[str] = set()
55
+ names.update(_iter_entry_point_names("framework_m.apps"))
56
+ names.update(_iter_entry_point_names("framework_m_core.cli_commands"))
57
+
58
+ # Fall back to the configured installed-app list when entry points are sparse.
59
+ with contextlib.suppress(Exception):
60
+ from framework_m_core.config import get_installed_apps
61
+
62
+ for app in get_installed_apps() or []:
63
+ names.add(app)
64
+
65
+ return sorted(names)
66
+
67
+
68
+ def complete_doctypes(context: CompletionContext | None = None) -> list[str]:
69
+ """Return registered DocType names as completion candidates."""
70
+ with contextlib.suppress(Exception):
71
+ from framework_m_core.registry import MetaRegistry
72
+
73
+ registry = MetaRegistry.get_instance()
74
+ with contextlib.suppress(Exception):
75
+ # Ensure DocTypes from installed apps are discovered before listing.
76
+ from framework_m_core.config import get_installed_apps
77
+
78
+ apps = get_installed_apps()
79
+ if apps:
80
+ registry.load_apps(apps)
81
+ return sorted(registry.list_doctypes())
82
+ return []
83
+
84
+
85
+ def complete_config_keys(context: CompletionContext | None = None) -> list[str]:
86
+ """Return dotted configuration keys as completion candidates.
87
+
88
+ Merges the built-in default keys with whatever is present in the resolved
89
+ ``framework_config.toml``.
90
+ """
91
+ keys: set[str] = set()
92
+
93
+ def _flatten(prefix: str, value: Any) -> None:
94
+ if isinstance(value, dict):
95
+ for sub_key, sub_value in value.items():
96
+ child = f"{prefix}.{sub_key}" if prefix else str(sub_key)
97
+ keys.add(child)
98
+ _flatten(child, sub_value)
99
+ elif prefix:
100
+ keys.add(prefix)
101
+
102
+ with contextlib.suppress(Exception):
103
+ from framework_m_core.config import (
104
+ DEFAULT_CONFIG,
105
+ find_config_file,
106
+ load_config,
107
+ )
108
+
109
+ _flatten("", DEFAULT_CONFIG)
110
+ config = load_config(find_config_file())
111
+ if config:
112
+ _flatten("", config)
113
+
114
+ return sorted(keys)
115
+
116
+
117
+ def complete_tenants(context: CompletionContext | None = None) -> list[str]:
118
+ """Return configured tenant identifiers as completion candidates.
119
+
120
+ Reads the tenant registry from the ``[tenants]`` section of
121
+ ``framework_config.toml`` or discovered sites.
122
+ """
123
+ with contextlib.suppress(Exception):
124
+ from framework_m_core.cli.tenant_resolver import list_configured_tenants
125
+
126
+ return list_configured_tenants()
127
+ return []
@@ -0,0 +1,182 @@
1
+ """Shell auto-completion command for the ``m`` CLI.
2
+
3
+ Provides:
4
+
5
+ - ``m completion [bash|zsh|fish]``: print (or install) a completion script for
6
+ the given shell. When no shell is given it is auto-detected.
7
+ - ``m completion install [bash|zsh|fish]``: drop the completion script into the
8
+ shell's standard completions directory and, where required, wire it into the
9
+ shell's startup file.
10
+
11
+ Dynamic candidate completion (apps/plugins, DocTypes, config keys, tenants) is
12
+ driven by the completers in :mod:`framework_m_core.cli.completers`, which are
13
+ attached to the relevant CLI parameters. Cyclopts routes ``<TAB>`` presses to
14
+ those callables through its reserved ``__complete`` sub-command.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ from pathlib import Path
20
+ from typing import TYPE_CHECKING, Annotated, Literal
21
+
22
+ import cyclopts
23
+
24
+ from framework_m_core.cli.utility import console
25
+
26
+ if TYPE_CHECKING: # pragma: no cover - typing only
27
+ from cyclopts import App
28
+
29
+ ShellName = Literal["bash", "zsh", "fish"]
30
+
31
+ completion_app = cyclopts.App(
32
+ name="completion",
33
+ help="Generate and install shell tab-completion for the 'm' CLI",
34
+ )
35
+
36
+ # Module-level reference to the root ``m`` app, bound at CLI assembly time.
37
+ _root_app: App | None = None
38
+
39
+
40
+ def bind_root_app(root_app: App) -> None:
41
+ """Attach the root CLI app so completion can be generated from it.
42
+
43
+ Called from :mod:`framework_m_core.cli.main` once the root app and all of
44
+ its sub-commands have been registered. Completion must be generated from
45
+ the root app so that every command is included.
46
+ """
47
+ global _root_app
48
+ _root_app = root_app
49
+
50
+
51
+ def _get_root_app() -> App | None:
52
+ """Return the root ``m`` application bound via :func:`bind_root_app`."""
53
+ return _root_app
54
+
55
+
56
+ def _detect_shell() -> ShellName | None:
57
+ """Best-effort detection of the current interactive shell."""
58
+ try:
59
+ from cyclopts.completion.detect import detect_shell
60
+
61
+ detected = detect_shell()
62
+ if detected in ("bash", "zsh", "fish"):
63
+ return detected
64
+ return None
65
+ except Exception:
66
+ return None
67
+
68
+
69
+ def _resolve_shell(shell: ShellName | None) -> ShellName:
70
+ """Resolve the target shell, exiting with a helpful error when unknown."""
71
+ target = shell or _detect_shell()
72
+ if target is None:
73
+ console.error(
74
+ "Could not auto-detect your shell. "
75
+ "Specify one explicitly: m completion [bash|zsh|fish]"
76
+ )
77
+ raise SystemExit(1)
78
+ return target
79
+
80
+
81
+ def _require_root_app() -> App:
82
+ """Return the root app, exiting with a helpful error when unbound."""
83
+ root = _get_root_app()
84
+ if root is None: # pragma: no cover - only when CLI assembled atypically
85
+ console.error(
86
+ "Completion is not wired to the root CLI app. "
87
+ "This is a framework bug; please report it."
88
+ )
89
+ raise SystemExit(1)
90
+ return root
91
+
92
+
93
+ @completion_app.default
94
+ @completion_app.command(name="generate")
95
+ def completion_generate(
96
+ shell: Annotated[
97
+ ShellName | None,
98
+ cyclopts.Parameter(
99
+ help="Target shell (bash, zsh, or fish). Auto-detected when omitted.",
100
+ ),
101
+ ] = None,
102
+ ) -> None:
103
+ """Print the completion script for a shell to stdout.
104
+
105
+ Examples:
106
+ m completion bash > framework-m-completion.bash
107
+ m completion # auto-detect shell
108
+ """
109
+ root = _require_root_app()
110
+ target = _resolve_shell(shell)
111
+
112
+ try:
113
+ # ``shell`` is the cyclopts Literal["bash","zsh","fish"], not a
114
+ # subprocess shell=True flag. Bandit B604 is a false positive here.
115
+ script = root.generate_completion(shell=target) # nosec B604
116
+ except Exception as exc: # pragma: no cover - defensive
117
+ console.error(f"Failed to generate completion for '{target}': {exc}")
118
+ raise SystemExit(1) from exc
119
+
120
+ # Print the raw script to stdout (composability with shells/redirects).
121
+ console.print(script, markup=False, highlight=False)
122
+
123
+
124
+ @completion_app.command(name="install")
125
+ def completion_install(
126
+ shell: Annotated[
127
+ ShellName | None,
128
+ cyclopts.Parameter(
129
+ help="Target shell (bash, zsh, or fish). Auto-detected when omitted.",
130
+ ),
131
+ ] = None,
132
+ output: Annotated[
133
+ Path | None,
134
+ cyclopts.Parameter(
135
+ name=["--output", "-o"],
136
+ help="Custom path for the completion script",
137
+ ),
138
+ ] = None,
139
+ add_to_startup: Annotated[
140
+ bool,
141
+ cyclopts.Parameter(
142
+ name="--add-to-startup",
143
+ negative="--no-add-to-startup",
144
+ help="Wire the completion into the shell's startup file (bash/zsh)",
145
+ ),
146
+ ] = True,
147
+ ) -> None:
148
+ """Install the completion script into the shell's standard directory.
149
+
150
+ Drops the script into the correct location for the target shell
151
+ (e.g. ``~/.local/share/bash-completion/completions/m`` or
152
+ ``~/.config/fish/completions/m.fish``) and, for bash/zsh, sources it from
153
+ the shell's startup file.
154
+
155
+ Examples:
156
+ m completion install
157
+ m completion install fish
158
+ m completion install zsh --output ~/.zfunc/_m
159
+ """
160
+ root = _require_root_app()
161
+ target = _resolve_shell(shell)
162
+
163
+ try:
164
+ # ``shell`` is the cyclopts Literal["bash","zsh","fish"], not a
165
+ # subprocess shell=True flag. Bandit B604 is a false positive here.
166
+ installed_path = root.install_completion( # nosec B604
167
+ shell=target,
168
+ output=output,
169
+ add_to_startup=add_to_startup,
170
+ )
171
+ except Exception as exc: # pragma: no cover - defensive
172
+ console.error(f"Failed to install completion for '{target}': {exc}")
173
+ raise SystemExit(1) from exc
174
+
175
+ console.success(f"Installed {target} completion: {installed_path}")
176
+ if target in ("bash", "zsh") and add_to_startup:
177
+ console.info(
178
+ "Restart your shell (or re-source your RC file) to activate completion."
179
+ )
180
+
181
+
182
+ __all__ = ["bind_root_app", "completion_app"]
@@ -1,8 +1,9 @@
1
1
  import cyclopts
2
2
 
3
3
  from framework_m_core import __version__
4
- from framework_m_core.cli.config import config_set_command, config_show_command
4
+ from framework_m_core.cli.completion import bind_root_app, completion_app
5
5
  from framework_m_core.cli.plugin_loader import load_plugins
6
+ from framework_m_core.cli.tenants import tenants_app
6
7
  from framework_m_core.cli.utility import info_command
7
8
 
8
9
  app = cyclopts.App(
@@ -14,13 +15,18 @@ app = cyclopts.App(
14
15
  # Register core commands
15
16
  app.command(info_command, name="info")
16
17
 
17
- # Config commands
18
- app.command(config_show_command, name="config:show")
19
- app.command(config_set_command, name="config:set")
18
+ # Shell auto-completion
19
+ app.command(completion_app, name="completion")
20
+
21
+ # Multi-tenant management
22
+ app.command(tenants_app, name="tenants")
20
23
 
21
24
  # Load plugins
22
25
  load_plugins(app)
23
26
 
27
+ # Bind the fully-assembled root app so `m completion` can enumerate every command.
28
+ bind_root_app(app)
29
+
24
30
 
25
31
  def main() -> None:
26
32
  app()
@@ -74,7 +74,7 @@ def register_plugins(app: cyclopts.App, plugins: list[EntryPoint]) -> None:
74
74
  try:
75
75
  plugin = ep.load()
76
76
  except ModuleNotFoundError as e:
77
- logger.debug(
77
+ logger.warning(
78
78
  "Skipping CLI plugin '%s' (missing optional dependency: %s)",
79
79
  ep.name,
80
80
  e.name,
@@ -0,0 +1,185 @@
1
+ """Tenant Resolution and Multi-Tenancy Strategy for Framework M CLI.
2
+
3
+ This module provides utilities to resolve database URLs and schema contexts
4
+ for multi-tenant and multi-site environments:
5
+
6
+ 1. Flag parsing and fallback:
7
+ - `--database-url` / `-d` (or DATABASE_URL env)
8
+ - `--tenant`: schema-scoped isolation (PostgreSQL schema or tenant identifier)
9
+ - `--site` / `--config`: tenant/site configuration file or directory resolution
10
+
11
+ 2. Tenant Resolution:
12
+ - Resolves tenant DB URL and schema from `framework_config.toml` (`[tenants]` section)
13
+ - Supports site-based resolution (e.g. `sites/<site_name>/config.toml`)
14
+ - Lists active configured tenants for batch fan-out operations.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ import os
20
+ from dataclasses import dataclass
21
+ from pathlib import Path
22
+ from typing import Any
23
+
24
+ from framework_m_core.config import (
25
+ find_config_file,
26
+ get_nested_value,
27
+ load_config,
28
+ )
29
+
30
+
31
+ @dataclass(frozen=True)
32
+ class TenantResolution:
33
+ """Resolved tenant connection details for CLI execution."""
34
+
35
+ tenant_id: str | None
36
+ database_url: str | None
37
+ schema: str | None = None
38
+ config_file: Path | None = None
39
+ extra_config: dict[str, Any] | None = None
40
+
41
+
42
+ def resolve_tenant(
43
+ *,
44
+ tenant: str | None = None,
45
+ site: str | Path | None = None,
46
+ config: str | Path | None = None,
47
+ database_url: str | None = None,
48
+ ) -> TenantResolution:
49
+ """Resolve database URL and schema for a tenant/site.
50
+
51
+ Resolution Priority:
52
+ 1. Direct ``database_url`` flag (if provided).
53
+ 2. Site or config path if ``--site`` or ``--config`` is specified:
54
+ - If ``site`` is a string that doesn't end with .toml, checks:
55
+ - ``sites/<site>/config.toml``
56
+ - ``sites/<site>/framework_config.toml``
57
+ - ``<site>/config.toml``
58
+ - Or loads the specified config file directly.
59
+ 3. Look up ``tenant`` in ``framework_config.toml``:
60
+ - ``[tenants.databases.<tenant>]`` (database-per-tenant)
61
+ - ``[tenants.schemas.<tenant>]`` (schema-per-tenant)
62
+ - Fallback to ``--tenant`` as the PostgreSQL schema name if schema-per-tenant.
63
+ 4. Fallback to default ``database_url`` from environment / main config.
64
+ """
65
+ resolved_tenant = tenant.strip() if tenant and tenant.strip() else None
66
+ resolved_db_url = (
67
+ database_url.strip() if database_url and database_url.strip() else None
68
+ )
69
+ resolved_schema: str | None = None
70
+ resolved_config_file: Path | None = None
71
+ extra_config: dict[str, Any] | None = None
72
+
73
+ # 1. Check --site / --config
74
+ target_site_or_config = config or site
75
+ if target_site_or_config:
76
+ site_path = Path(target_site_or_config)
77
+ candidate_files: list[Path] = []
78
+ if site_path.is_file():
79
+ candidate_files.append(site_path)
80
+ else:
81
+ candidate_files.extend(
82
+ [
83
+ site_path / "config.toml",
84
+ site_path / "framework_config.toml",
85
+ Path("sites") / site_path / "config.toml",
86
+ Path("sites") / site_path / "framework_config.toml",
87
+ ]
88
+ )
89
+
90
+ for cand in candidate_files:
91
+ if cand.exists() and cand.is_file():
92
+ resolved_config_file = cand.resolve()
93
+ site_conf = load_config(resolved_config_file)
94
+ extra_config = site_conf
95
+ if not resolved_db_url:
96
+ resolved_db_url = site_conf.get("database_url") or get_nested_value(
97
+ site_conf, "database.url"
98
+ )
99
+ if not resolved_tenant:
100
+ resolved_tenant = (
101
+ site_conf.get("tenant_id")
102
+ or get_nested_value(site_conf, "tenancy.default_tenant_id")
103
+ or (site_path.name if not site_path.suffix else site_path.stem)
104
+ )
105
+ break
106
+
107
+ # 2. Check main framework_config.toml for [tenants] section
108
+ main_config = load_config(find_config_file())
109
+
110
+ if resolved_tenant and not resolved_db_url:
111
+ # Check database-per-tenant mapping in config:
112
+ # [tenants.databases]
113
+ # acme = "postgresql+asyncpg://user:pass@localhost/acme_db"
114
+ tenant_db = get_nested_value(
115
+ main_config, f"tenants.databases.{resolved_tenant}"
116
+ )
117
+ if tenant_db:
118
+ resolved_db_url = str(tenant_db)
119
+
120
+ # 3. Determine schema-scoped isolation:
121
+ # If a specific schema is configured for this tenant, use it;
122
+ # otherwise, if tenant is specified, treat tenant as schema in schema-per-tenant setups.
123
+ if resolved_tenant:
124
+ schema_override = get_nested_value(
125
+ main_config, f"tenants.schemas.{resolved_tenant}"
126
+ )
127
+ resolved_schema = str(schema_override) if schema_override else resolved_tenant
128
+
129
+ # 4. Final database_url fallback
130
+ if not resolved_db_url:
131
+ resolved_db_url = os.environ.get("DATABASE_URL")
132
+ if not resolved_db_url:
133
+ resolved_db_url = main_config.get("database_url")
134
+
135
+ return TenantResolution(
136
+ tenant_id=resolved_tenant,
137
+ database_url=resolved_db_url,
138
+ schema=resolved_schema,
139
+ config_file=resolved_config_file,
140
+ extra_config=extra_config,
141
+ )
142
+
143
+
144
+ def list_configured_tenants() -> list[str]:
145
+ """Return all configured tenant identifiers from the configuration.
146
+
147
+ Collects from:
148
+ 1. ``[tenants].registry`` list
149
+ 2. ``[tenants.databases]`` dictionary keys
150
+ 3. ``[tenants.schemas]`` dictionary keys
151
+ 4. Subdirectories in ``sites/`` containing a config.toml
152
+ """
153
+ tenants: set[str] = set()
154
+ config = load_config(find_config_file())
155
+
156
+ registry = get_nested_value(config, "tenants.registry")
157
+ if isinstance(registry, list):
158
+ tenants.update(str(item) for item in registry if str(item).strip())
159
+
160
+ databases = get_nested_value(config, "tenants.databases")
161
+ if isinstance(databases, dict):
162
+ tenants.update(str(k) for k in databases)
163
+
164
+ schemas = get_nested_value(config, "tenants.schemas")
165
+ if isinstance(schemas, dict):
166
+ tenants.update(str(k) for k in schemas)
167
+
168
+ # Check sites/ directory
169
+ sites_dir = Path("sites")
170
+ if sites_dir.exists() and sites_dir.is_dir():
171
+ for sub in sites_dir.iterdir():
172
+ if sub.is_dir() and (
173
+ (sub / "config.toml").exists()
174
+ or (sub / "framework_config.toml").exists()
175
+ ):
176
+ tenants.add(sub.name)
177
+
178
+ return sorted(tenants)
179
+
180
+
181
+ __all__ = [
182
+ "TenantResolution",
183
+ "list_configured_tenants",
184
+ "resolve_tenant",
185
+ ]