trueppm-api 0.4.0b2__py3-none-any.whl
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.
- trueppm_api/__init__.py +14 -0
- trueppm_api/apps/access/__init__.py +0 -0
- trueppm_api/apps/access/apps.py +19 -0
- trueppm_api/apps/access/groups.py +518 -0
- trueppm_api/apps/access/management/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/__init__.py +0 -0
- trueppm_api/apps/access/management/commands/create_admin.py +164 -0
- trueppm_api/apps/access/management/commands/migrate_locked.py +96 -0
- trueppm_api/apps/access/management/commands/revoke_api_tokens.py +209 -0
- trueppm_api/apps/access/migrations/0001_initial.py +61 -0
- trueppm_api/apps/access/migrations/0001_squashed_0012_programmembership_role_title.py +167 -0
- trueppm_api/apps/access/migrations/0002_alter_projectmembership_id.py +29 -0
- trueppm_api/apps/access/migrations/0003_projectmembership_soft_delete.py +24 -0
- trueppm_api/apps/access/migrations/0004_alter_projectmembership_role.py +34 -0
- trueppm_api/apps/access/migrations/0005_program_entity_and_membership.py +76 -0
- trueppm_api/apps/access/migrations/0006_role_ordinal_spacing.py +113 -0
- trueppm_api/apps/access/migrations/0007_projectmembership_joined_at_and_more.py +35 -0
- trueppm_api/apps/access/migrations/0008_projectmembership_source_group.py +25 -0
- trueppm_api/apps/access/migrations/0009_projectmembership_pm_proj_serverver_idx.py +20 -0
- trueppm_api/apps/access/migrations/0010_programmembership_joined_at_and_more.py +38 -0
- trueppm_api/apps/access/migrations/0011_alter_programmembership_unique_together_and_more.py +36 -0
- trueppm_api/apps/access/migrations/0012_programmembership_role_title.py +17 -0
- trueppm_api/apps/access/migrations/0013_userdefinedmentiongroup.py +82 -0
- trueppm_api/apps/access/migrations/0014_programmembership_progm_serverver_idx.py +19 -0
- trueppm_api/apps/access/migrations/0015_programuserdefinedmentiongroup.py +86 -0
- trueppm_api/apps/access/migrations/0016_externalstakeholder.py +67 -0
- trueppm_api/apps/access/migrations/0017_viewer_ordinal_one.py +132 -0
- trueppm_api/apps/access/migrations/0018_programmembership_sync_seq_and_more.py +52 -0
- trueppm_api/apps/access/migrations/0019_programmembership_reinstated_at_and_more.py +22 -0
- trueppm_api/apps/access/migrations/__init__.py +0 -0
- trueppm_api/apps/access/models.py +588 -0
- trueppm_api/apps/access/permissions.py +2837 -0
- trueppm_api/apps/access/serializers.py +946 -0
- trueppm_api/apps/access/services.py +667 -0
- trueppm_api/apps/access/signals.py +103 -0
- trueppm_api/apps/access/tasks.py +50 -0
- trueppm_api/apps/access/throttles.py +95 -0
- trueppm_api/apps/access/urls.py +191 -0
- trueppm_api/apps/access/views.py +1931 -0
- trueppm_api/apps/agents/__init__.py +6 -0
- trueppm_api/apps/agents/apps.py +11 -0
- trueppm_api/apps/agents/canonical.py +73 -0
- trueppm_api/apps/agents/deferred.py +108 -0
- trueppm_api/apps/agents/management/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/__init__.py +0 -0
- trueppm_api/apps/agents/management/commands/audit_prune.py +137 -0
- trueppm_api/apps/agents/management/commands/audit_verify.py +101 -0
- trueppm_api/apps/agents/middleware.py +44 -0
- trueppm_api/apps/agents/migrations/0001_initial.py +231 -0
- trueppm_api/apps/agents/migrations/0002_agentactioncheckpoint.py +71 -0
- trueppm_api/apps/agents/migrations/0003_agentactionrefusaldetail.py +58 -0
- trueppm_api/apps/agents/migrations/__init__.py +0 -0
- trueppm_api/apps/agents/models.py +371 -0
- trueppm_api/apps/agents/refusal.py +103 -0
- trueppm_api/apps/agents/serializers.py +85 -0
- trueppm_api/apps/agents/services.py +397 -0
- trueppm_api/apps/agents/signals.py +30 -0
- trueppm_api/apps/agents/urls.py +15 -0
- trueppm_api/apps/agents/views.py +108 -0
- trueppm_api/apps/csvimport/__init__.py +12 -0
- trueppm_api/apps/csvimport/apps.py +11 -0
- trueppm_api/apps/csvimport/mapping.py +363 -0
- trueppm_api/apps/csvimport/migrations/0001_initial.py +74 -0
- trueppm_api/apps/csvimport/migrations/0002_schedule_outline_batch_operations.py +37 -0
- trueppm_api/apps/csvimport/migrations/0003_csvimportrequest_date_order_and_more.py +26 -0
- trueppm_api/apps/csvimport/migrations/__init__.py +0 -0
- trueppm_api/apps/csvimport/models.py +111 -0
- trueppm_api/apps/csvimport/parser.py +1825 -0
- trueppm_api/apps/csvimport/services.py +48 -0
- trueppm_api/apps/csvimport/tasks.py +418 -0
- trueppm_api/apps/csvimport/template.py +37 -0
- trueppm_api/apps/csvimport/urls.py +50 -0
- trueppm_api/apps/csvimport/views.py +793 -0
- trueppm_api/apps/history/__init__.py +0 -0
- trueppm_api/apps/history/apps.py +12 -0
- trueppm_api/apps/history/changelog.py +359 -0
- trueppm_api/apps/history/diff_policy.py +177 -0
- trueppm_api/apps/history/serializers.py +104 -0
- trueppm_api/apps/history/signals.py +82 -0
- trueppm_api/apps/history/tasks.py +105 -0
- trueppm_api/apps/history/urls.py +38 -0
- trueppm_api/apps/history/views.py +443 -0
- trueppm_api/apps/idempotency/__init__.py +0 -0
- trueppm_api/apps/idempotency/apps.py +11 -0
- trueppm_api/apps/idempotency/migrations/0001_initial.py +71 -0
- trueppm_api/apps/idempotency/migrations/__init__.py +0 -0
- trueppm_api/apps/idempotency/mixins.py +226 -0
- trueppm_api/apps/idempotency/models.py +75 -0
- trueppm_api/apps/idempotency/tasks.py +61 -0
- trueppm_api/apps/integrations/__init__.py +13 -0
- trueppm_api/apps/integrations/apps.py +59 -0
- trueppm_api/apps/integrations/connections.py +806 -0
- trueppm_api/apps/integrations/encryption.py +92 -0
- trueppm_api/apps/integrations/external_sources.py +837 -0
- trueppm_api/apps/integrations/git_automation_services.py +231 -0
- trueppm_api/apps/integrations/git_webhook_auth.py +243 -0
- trueppm_api/apps/integrations/http.py +403 -0
- trueppm_api/apps/integrations/me_work.py +218 -0
- trueppm_api/apps/integrations/migrations/0001_initial.py +64 -0
- trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py +187 -0
- trueppm_api/apps/integrations/migrations/0002_tasklink.py +67 -0
- trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py +17 -0
- trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py +25 -0
- trueppm_api/apps/integrations/migrations/0005_boardautomation.py +56 -0
- trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py +40 -0
- trueppm_api/apps/integrations/migrations/0007_tasklink_created_at.py +23 -0
- trueppm_api/apps/integrations/migrations/0008_integrationcredential_config_externalworkitem.py +66 -0
- trueppm_api/apps/integrations/migrations/0009_externalsyncrequest_and_more.py +96 -0
- trueppm_api/apps/integrations/migrations/0010_externalworkitem_due_date.py +17 -0
- trueppm_api/apps/integrations/migrations/0011_tasklink_sync_seq_tasklink_tasklink_syncseq_idx.py +22 -0
- trueppm_api/apps/integrations/migrations/0012_boardautomation_last_delivery_at_and_more.py +42 -0
- trueppm_api/apps/integrations/migrations/0013_externalsyncrequest_attempt_count_and_more.py +26 -0
- trueppm_api/apps/integrations/migrations/__init__.py +0 -0
- trueppm_api/apps/integrations/models.py +622 -0
- trueppm_api/apps/integrations/notification_channels.py +57 -0
- trueppm_api/apps/integrations/opengraph.py +229 -0
- trueppm_api/apps/integrations/outgoing.py +201 -0
- trueppm_api/apps/integrations/providers.py +519 -0
- trueppm_api/apps/integrations/registry.py +345 -0
- trueppm_api/apps/integrations/serializers.py +453 -0
- trueppm_api/apps/integrations/services.py +171 -0
- trueppm_api/apps/integrations/tasks.py +731 -0
- trueppm_api/apps/integrations/throttles.py +165 -0
- trueppm_api/apps/integrations/urls.py +77 -0
- trueppm_api/apps/integrations/views.py +1106 -0
- trueppm_api/apps/jiraimport/__init__.py +8 -0
- trueppm_api/apps/jiraimport/apps.py +11 -0
- trueppm_api/apps/jiraimport/migrations/0001_initial.py +72 -0
- trueppm_api/apps/jiraimport/migrations/__init__.py +0 -0
- trueppm_api/apps/jiraimport/models.py +70 -0
- trueppm_api/apps/jiraimport/parser.py +350 -0
- trueppm_api/apps/jiraimport/services.py +46 -0
- trueppm_api/apps/jiraimport/tasks.py +277 -0
- trueppm_api/apps/jiraimport/urls.py +15 -0
- trueppm_api/apps/jiraimport/views.py +153 -0
- trueppm_api/apps/msproject/__init__.py +0 -0
- trueppm_api/apps/msproject/apps.py +11 -0
- trueppm_api/apps/msproject/dataclasses.py +153 -0
- trueppm_api/apps/msproject/exporter.py +500 -0
- trueppm_api/apps/msproject/extended_attributes.py +77 -0
- trueppm_api/apps/msproject/importer.py +1095 -0
- trueppm_api/apps/msproject/migrations/0001_import_request.py +77 -0
- trueppm_api/apps/msproject/migrations/0001_squashed_0002_importrequest_creates_project.py +80 -0
- trueppm_api/apps/msproject/migrations/0002_importrequest_creates_project.py +15 -0
- trueppm_api/apps/msproject/migrations/__init__.py +0 -0
- trueppm_api/apps/msproject/models.py +81 -0
- trueppm_api/apps/msproject/parser.py +1231 -0
- trueppm_api/apps/msproject/serializers.py +136 -0
- trueppm_api/apps/msproject/services.py +58 -0
- trueppm_api/apps/msproject/tasks.py +436 -0
- trueppm_api/apps/msproject/urls.py +39 -0
- trueppm_api/apps/msproject/views.py +531 -0
- trueppm_api/apps/notifications/__init__.py +7 -0
- trueppm_api/apps/notifications/apps.py +15 -0
- trueppm_api/apps/notifications/backfill.py +79 -0
- trueppm_api/apps/notifications/categories.py +112 -0
- trueppm_api/apps/notifications/delivery_limits.py +258 -0
- trueppm_api/apps/notifications/digests.py +447 -0
- trueppm_api/apps/notifications/email_backend.py +330 -0
- trueppm_api/apps/notifications/email_health.py +128 -0
- trueppm_api/apps/notifications/migrations/0001_initial.py +207 -0
- trueppm_api/apps/notifications/migrations/0001_squashed_0006_notification_task.py +294 -0
- trueppm_api/apps/notifications/migrations/0002_project_notification_preference.py +67 -0
- trueppm_api/apps/notifications/migrations/0003_projectnotificationpreference_paused.py +17 -0
- trueppm_api/apps/notifications/migrations/0004_clean_unknown_matrix_keys.py +30 -0
- trueppm_api/apps/notifications/migrations/0005_notification_body_notification_event_type_and_more.py +27 -0
- trueppm_api/apps/notifications/migrations/0006_notification_task.py +25 -0
- trueppm_api/apps/notifications/migrations/0007_workspaceemailsettings.py +80 -0
- trueppm_api/apps/notifications/migrations/0008_notification_snoozed_until.py +17 -0
- trueppm_api/apps/notifications/migrations/0009_usernotificationsettings.py +43 -0
- trueppm_api/apps/notifications/migrations/0010_projectnotificationpreference_schema_version.py +20 -0
- trueppm_api/apps/notifications/migrations/0011_usernotificationsettings_digest_hour_and_more.py +96 -0
- trueppm_api/apps/notifications/migrations/__init__.py +0 -0
- trueppm_api/apps/notifications/models.py +1197 -0
- trueppm_api/apps/notifications/receivers.py +155 -0
- trueppm_api/apps/notifications/schema_migrations.py +56 -0
- trueppm_api/apps/notifications/serializers.py +961 -0
- trueppm_api/apps/notifications/services.py +1451 -0
- trueppm_api/apps/notifications/tasks.py +711 -0
- trueppm_api/apps/notifications/throttles.py +98 -0
- trueppm_api/apps/notifications/urls.py +97 -0
- trueppm_api/apps/notifications/views.py +904 -0
- trueppm_api/apps/observability/__init__.py +0 -0
- trueppm_api/apps/observability/apps.py +31 -0
- trueppm_api/apps/observability/logging.py +213 -0
- trueppm_api/apps/observability/migrations/0001_initial.py +35 -0
- trueppm_api/apps/observability/migrations/0001_squashed_0003_alter_purgerun_trigger.py +154 -0
- trueppm_api/apps/observability/migrations/0002_purgerun_retentionpolicy_retentionschedule.py +131 -0
- trueppm_api/apps/observability/migrations/0003_alter_purgerun_trigger.py +21 -0
- trueppm_api/apps/observability/migrations/0004_alter_retentionpolicy_key.py +28 -0
- trueppm_api/apps/observability/migrations/__init__.py +0 -0
- trueppm_api/apps/observability/models.py +141 -0
- trueppm_api/apps/observability/otel/__init__.py +45 -0
- trueppm_api/apps/observability/otel/attributes.py +247 -0
- trueppm_api/apps/observability/otel/export_health.py +533 -0
- trueppm_api/apps/observability/otel/instrumentation.py +351 -0
- trueppm_api/apps/observability/otel/metrics.py +551 -0
- trueppm_api/apps/observability/otel/provider.py +511 -0
- trueppm_api/apps/observability/otel/request_attributes.py +204 -0
- trueppm_api/apps/observability/purge_registry.py +124 -0
- trueppm_api/apps/observability/retention.py +139 -0
- trueppm_api/apps/observability/selectors.py +969 -0
- trueppm_api/apps/observability/serializers.py +142 -0
- trueppm_api/apps/observability/services.py +407 -0
- trueppm_api/apps/observability/tasks.py +266 -0
- trueppm_api/apps/observability/urls.py +27 -0
- trueppm_api/apps/observability/views.py +523 -0
- trueppm_api/apps/profiles/__init__.py +0 -0
- trueppm_api/apps/profiles/apps.py +15 -0
- trueppm_api/apps/profiles/constants.py +54 -0
- trueppm_api/apps/profiles/migrations/0001_initial.py +55 -0
- trueppm_api/apps/profiles/migrations/0001_squashed_0004_userprofile_role_context.py +125 -0
- trueppm_api/apps/profiles/migrations/0002_userprofile_hidden_views.py +17 -0
- trueppm_api/apps/profiles/migrations/0003_projectvisit.py +63 -0
- trueppm_api/apps/profiles/migrations/0004_userprofile_role_context.py +26 -0
- trueppm_api/apps/profiles/migrations/0005_userprofile_schedule_in_deliver.py +20 -0
- trueppm_api/apps/profiles/migrations/0006_userprofile_date_format_userprofile_timezone.py +36 -0
- trueppm_api/apps/profiles/migrations/0007_userpin.py +91 -0
- trueppm_api/apps/profiles/migrations/0008_remove_userprofile_schedule_in_deliver.py +71 -0
- trueppm_api/apps/profiles/migrations/0009_auth_user_email_upper_idx.py +81 -0
- trueppm_api/apps/profiles/migrations/__init__.py +0 -0
- trueppm_api/apps/profiles/models.py +276 -0
- trueppm_api/apps/profiles/serializers.py +199 -0
- trueppm_api/apps/profiles/services.py +466 -0
- trueppm_api/apps/profiles/views.py +124 -0
- trueppm_api/apps/projects/__init__.py +0 -0
- trueppm_api/apps/projects/actual_date_rules.py +163 -0
- trueppm_api/apps/projects/amend.py +133 -0
- trueppm_api/apps/projects/apps.py +38 -0
- trueppm_api/apps/projects/asset_feed.py +459 -0
- trueppm_api/apps/projects/asset_views.py +317 -0
- trueppm_api/apps/projects/attachment_policy.py +278 -0
- trueppm_api/apps/projects/authentication.py +449 -0
- trueppm_api/apps/projects/backfill.py +287 -0
- trueppm_api/apps/projects/backlog_services.py +324 -0
- trueppm_api/apps/projects/backlog_views.py +302 -0
- trueppm_api/apps/projects/batch_operation_views.py +264 -0
- trueppm_api/apps/projects/blocker_services.py +510 -0
- trueppm_api/apps/projects/board_activity.py +462 -0
- trueppm_api/apps/projects/board_activity_views.py +186 -0
- trueppm_api/apps/projects/board_lanes.py +134 -0
- trueppm_api/apps/projects/bulk_settings.py +194 -0
- trueppm_api/apps/projects/bundled_templates.py +215 -0
- trueppm_api/apps/projects/calendar_settings.py +180 -0
- trueppm_api/apps/projects/ceremony_views.py +244 -0
- trueppm_api/apps/projects/commit_moment.py +204 -0
- trueppm_api/apps/projects/config_notice.py +1325 -0
- trueppm_api/apps/projects/custom_field_values.py +266 -0
- trueppm_api/apps/projects/decisions_services.py +93 -0
- trueppm_api/apps/projects/decisions_views.py +94 -0
- trueppm_api/apps/projects/estimation_scale.py +126 -0
- trueppm_api/apps/projects/export_bundle.py +353 -0
- trueppm_api/apps/projects/fixtures/seeds/atlas-platform-launch.json +4256 -0
- trueppm_api/apps/projects/fixtures/seeds/aurora-mobile-app.json +2000 -0
- trueppm_api/apps/projects/fixtures/seeds/bayside-civic-center.json +1825 -0
- trueppm_api/apps/projects/fixtures/seeds/ga-launch.json +1905 -0
- trueppm_api/apps/projects/fixtures/seeds/helios-crm-replacement.json +1409 -0
- trueppm_api/apps/projects/guardrail_policy_source.py +269 -0
- trueppm_api/apps/projects/inbound_sync.py +555 -0
- trueppm_api/apps/projects/iteration_label.py +85 -0
- trueppm_api/apps/projects/lifecycle.py +191 -0
- trueppm_api/apps/projects/management/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/__init__.py +0 -0
- trueppm_api/apps/projects/management/commands/backfill_in_progress_status.py +92 -0
- trueppm_api/apps/projects/management/commands/create_demo_share_link.py +368 -0
- trueppm_api/apps/projects/management/commands/export_program.py +50 -0
- trueppm_api/apps/projects/management/commands/import_seed.py +165 -0
- trueppm_api/apps/projects/management/commands/load_sample_project.py +247 -0
- trueppm_api/apps/projects/management/commands/seed_capacity.py +405 -0
- trueppm_api/apps/projects/management/commands/seed_integration_fixtures.py +178 -0
- trueppm_api/apps/projects/management/commands/shift_sample_dates.py +120 -0
- trueppm_api/apps/projects/mcp_settings.py +305 -0
- trueppm_api/apps/projects/methodology.py +178 -0
- trueppm_api/apps/projects/migrations/0001_initial.py +208 -0
- trueppm_api/apps/projects/migrations/0001_squashed_0094_project_decisions_policy.py +5595 -0
- trueppm_api/apps/projects/migrations/0002_alter_uuid_pk_serialize_false.py +57 -0
- trueppm_api/apps/projects/migrations/0003_rename_task_project_index.py +25 -0
- trueppm_api/apps/projects/migrations/0004_soft_delete_and_dependency_versioned.py +70 -0
- trueppm_api/apps/projects/migrations/0005_task_assignee.py +33 -0
- trueppm_api/apps/projects/migrations/0006_task_utilization_index.py +31 -0
- trueppm_api/apps/projects/migrations/0007_task_is_milestone.py +28 -0
- trueppm_api/apps/projects/migrations/0008_baseline.py +119 -0
- trueppm_api/apps/projects/migrations/0009_historicaldependency_historicalproject_and_more.py +210 -0
- trueppm_api/apps/projects/migrations/0010_risk.py +229 -0
- trueppm_api/apps/projects/migrations/0011_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0012_task_status.py +27 -0
- trueppm_api/apps/projects/migrations/0013_task_planned_start.py +24 -0
- trueppm_api/apps/projects/migrations/0014_short_hex_ids.py +74 -0
- trueppm_api/apps/projects/migrations/0015_backfill_short_ids.py +48 -0
- trueppm_api/apps/projects/migrations/0016_task_actual_dates.py +42 -0
- trueppm_api/apps/projects/migrations/0017_boardcolumnconfig.py +43 -0
- trueppm_api/apps/projects/migrations/0018_estimation_governance.py +62 -0
- trueppm_api/apps/projects/migrations/0019_backfill_wbs_paths.py +28 -0
- trueppm_api/apps/projects/migrations/0020_task_status_5col.py +65 -0
- trueppm_api/apps/projects/migrations/0021_boardsavedview.py +64 -0
- trueppm_api/apps/projects/migrations/0022_task_status_changed_at_priority_rank.py +35 -0
- trueppm_api/apps/projects/migrations/0023_risk_framework_fields.py +96 -0
- trueppm_api/apps/projects/migrations/0024_riskcomment.py +52 -0
- trueppm_api/apps/projects/migrations/0025_sprint.py +352 -0
- trueppm_api/apps/projects/migrations/0026_project_methodology.py +30 -0
- trueppm_api/apps/projects/migrations/0027_sprint_retro.py +89 -0
- trueppm_api/apps/projects/migrations/0028_normalize_notes_field.py +42 -0
- trueppm_api/apps/projects/migrations/0029_complete_implies_full_progress.py +38 -0
- trueppm_api/apps/projects/migrations/0030_review_implies_full_progress.py +37 -0
- trueppm_api/apps/projects/migrations/0031_task_remaining_points.py +22 -0
- trueppm_api/apps/projects/migrations/0032_task_is_subtask_and_sprint_scope_change.py +90 -0
- trueppm_api/apps/projects/migrations/0033_task_my_work_index.py +38 -0
- trueppm_api/apps/projects/migrations/0034_inbound_task_sync.py +313 -0
- trueppm_api/apps/projects/migrations/0035_retro_versioned_and_suggested_assignee.py +173 -0
- trueppm_api/apps/projects/migrations/0036_program_entity_and_membership.py +157 -0
- trueppm_api/apps/projects/migrations/0037_sprint_capacity_points.py +20 -0
- trueppm_api/apps/projects/migrations/0038_taskcomment_commentreaction_commentacknowledgement_and_more.py +233 -0
- trueppm_api/apps/projects/migrations/0039_apitoken_and_more.py +88 -0
- trueppm_api/apps/projects/migrations/0040_program_general_fields.py +119 -0
- trueppm_api/apps/projects/migrations/0041_ceremony_template_and_phase_gate_config.py +210 -0
- trueppm_api/apps/projects/migrations/0041_project_general_fields.py +106 -0
- trueppm_api/apps/projects/migrations/0042_merge_20260522_0410.py +12 -0
- trueppm_api/apps/projects/migrations/0042_program_rollup_config.py +95 -0
- trueppm_api/apps/projects/migrations/0042_workflow_color_and_custom_fields.py +94 -0
- trueppm_api/apps/projects/migrations/0043_merge_20260522_1118.py +10 -0
- trueppm_api/apps/projects/migrations/0044_merge_20260522_rollup.py +10 -0
- trueppm_api/apps/projects/migrations/0044_project_archive_program_close.py +119 -0
- trueppm_api/apps/projects/migrations/0045_program_risk_policy.py +78 -0
- trueppm_api/apps/projects/migrations/0046_merge_20260523_2248.py +12 -0
- trueppm_api/apps/projects/migrations/0047_apitokenauditentry_program_and_more.py +55 -0
- trueppm_api/apps/projects/migrations/0048_historicalprogram_color_program_color.py +32 -0
- trueppm_api/apps/projects/migrations/0049_backlog_item.py +112 -0
- trueppm_api/apps/projects/migrations/0050_backlog_item_trgm_search.py +26 -0
- trueppm_api/apps/projects/migrations/0051_alter_calendar_working_days_alter_dependency_lag_and_more.py +144 -0
- trueppm_api/apps/projects/migrations/0052_recurring_tasks.py +278 -0
- trueppm_api/apps/projects/migrations/0053_dependency_dep_pred_serverver_idx_and_more.py +56 -0
- trueppm_api/apps/projects/migrations/0054_sprintscopechange_goal_impact_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0055_historicaltask_sprint_pending_and_more.py +51 -0
- trueppm_api/apps/projects/migrations/0056_historicalproject_prioritization_model_and_more.py +276 -0
- trueppm_api/apps/projects/migrations/0057_historicalsprint_binding_committed_snapshot_and_more.py +58 -0
- trueppm_api/apps/projects/migrations/0058_historicaltask_delivery_mode_and_more.py +72 -0
- trueppm_api/apps/projects/migrations/0059_forecastsnapshot.py +80 -0
- trueppm_api/apps/projects/migrations/0060_historicalprojectsignalprivacypolicy_and_more.py +90 -0
- trueppm_api/apps/projects/migrations/0061_baselinetask_story_points.py +17 -0
- trueppm_api/apps/projects/migrations/0062_project_is_sample.py +22 -0
- trueppm_api/apps/projects/migrations/0063_historicalsprint_wip_limit_sprint_wip_limit.py +22 -0
- trueppm_api/apps/projects/migrations/0064_sprinttaskoutcome.py +97 -0
- trueppm_api/apps/projects/migrations/0065_historicalsprint_goal_outcome_sprint_goal_outcome.py +32 -0
- trueppm_api/apps/projects/migrations/0066_historicalproject_lead_project_lead.py +38 -0
- trueppm_api/apps/projects/migrations/0067_sprint_exclude_from_velocity.py +22 -0
- trueppm_api/apps/projects/migrations/0068_project_recalculated_at.py +23 -0
- trueppm_api/apps/projects/migrations/0069_iteration_label.py +22 -0
- trueppm_api/apps/projects/migrations/0070_historicalprogram_iteration_label_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0071_backfill_iteration_label_inherit.py +35 -0
- trueppm_api/apps/projects/migrations/0072_pulseresponse_retroboarditem.py +129 -0
- trueppm_api/apps/projects/migrations/0073_sprinttaskoutcome_demo_ready.py +17 -0
- trueppm_api/apps/projects/migrations/0074_historicaltask_blocked_reason_task_blocked_reason.py +30 -0
- trueppm_api/apps/projects/migrations/0075_risk_decimal_short_id.py +42 -0
- trueppm_api/apps/projects/migrations/0076_sprinttaskoutcome_review_polish.py +45 -0
- trueppm_api/apps/projects/migrations/0077_task_blocker_fields.py +111 -0
- trueppm_api/apps/projects/migrations/0078_alter_risktask_unique_together_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0079_historicalproject_status_date_project_status_date.py +22 -0
- trueppm_api/apps/projects/migrations/0080_alter_historicaltask_type_alter_task_type.py +46 -0
- trueppm_api/apps/projects/migrations/0081_historicalprogram_allow_guests_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0082_project_last_sync_version.py +90 -0
- trueppm_api/apps/projects/migrations/0083_historicalprogram_mc_history_attribution_audience_and_more.py +108 -0
- trueppm_api/apps/projects/migrations/0084_tasknote.py +71 -0
- trueppm_api/apps/projects/migrations/0085_sprint_ix_sprint_velocity.py +33 -0
- trueppm_api/apps/projects/migrations/0086_board_card_search_trgm.py +33 -0
- trueppm_api/apps/projects/migrations/0087_historicalprogram_task_duration_change_percent_policy_and_more.py +155 -0
- trueppm_api/apps/projects/migrations/0088_historicalprogram_allowed_attachment_types_and_more.py +61 -0
- trueppm_api/apps/projects/migrations/0089_signalceilingraiseproposal_signalceilingraisevote_and_more.py +157 -0
- trueppm_api/apps/projects/migrations/0090_historicaltask_proj_histdate_index.py +44 -0
- trueppm_api/apps/projects/migrations/0091_project_board_cadence.py +39 -0
- trueppm_api/apps/projects/migrations/0092_program_target_date.py +22 -0
- trueppm_api/apps/projects/migrations/0093_cross_project_dependency_consent.py +58 -0
- trueppm_api/apps/projects/migrations/0094_project_decisions_policy.py +90 -0
- trueppm_api/apps/projects/migrations/0095_poker_session_vote.py +127 -0
- trueppm_api/apps/projects/migrations/0095_squashed_0097_release_0_3.py +225 -0
- trueppm_api/apps/projects/migrations/0096_crossprojectslipconflict.py +91 -0
- trueppm_api/apps/projects/migrations/0097_backlogitem_backlogitem_tags_gin_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0098_historicalproject_show_baselines_and_more.py +52 -0
- trueppm_api/apps/projects/migrations/0099_apitoken_scopes.py +48 -0
- trueppm_api/apps/projects/migrations/0100_task_dep_serverver_idx_concurrent.py +61 -0
- trueppm_api/apps/projects/migrations/0101_dependency_deleted_at_task_deleted_at.py +22 -0
- trueppm_api/apps/projects/migrations/0102_project_deleted_at_project_proj_isdel_deletedat_idx.py +25 -0
- trueppm_api/apps/projects/migrations/0103_taskdurationchangeevent_task_dur_evt_sprint_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0104_historicalproject_stale_task_threshold_days_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0104_trash_restore_1113.py +38 -0
- trueppm_api/apps/projects/migrations/0105_historical_changelog_indexes.py +62 -0
- trueppm_api/apps/projects/migrations/0106_boardsavedview_schema_version.py +20 -0
- trueppm_api/apps/projects/migrations/0107_task_activity_event.py +70 -0
- trueppm_api/apps/projects/migrations/0108_remove_apitoken_api_token_scope_xor_and_more.py +117 -0
- trueppm_api/apps/projects/migrations/0109_projectexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0110_sharelink.py +123 -0
- trueppm_api/apps/projects/migrations/0111_projectcalendarlayer.py +67 -0
- trueppm_api/apps/projects/migrations/0112_sharelink_expires_at_alter_sharelink_content_kind.py +31 -0
- trueppm_api/apps/projects/migrations/0113_alter_historicaltask_percent_complete_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0114_historicalproject_default_member_role_and_more.py +28 -0
- trueppm_api/apps/projects/migrations/0115_historicalproject_end_date_shift_threshold_days_and_more.py +22 -0
- trueppm_api/apps/projects/migrations/0116_alter_taskactivityevent_event_type.py +28 -0
- trueppm_api/apps/projects/migrations/0117_label_tasklabel_label_tasks_and_more.py +126 -0
- trueppm_api/apps/projects/migrations/0118_programexportjob.py +82 -0
- trueppm_api/apps/projects/migrations/0119_historicalprogram_calendar_program_calendar.py +36 -0
- trueppm_api/apps/projects/migrations/0120_alter_backlogitem_item_type.py +29 -0
- trueppm_api/apps/projects/migrations/0121_task_three_point_estimate_ordered.py +64 -0
- trueppm_api/apps/projects/migrations/0122_task_relation.py +173 -0
- trueppm_api/apps/projects/migrations/0123_remove_historicalproject_agile_features_and_more.py +20 -0
- trueppm_api/apps/projects/migrations/0124_dependency_is_driving.py +17 -0
- trueppm_api/apps/projects/migrations/0125_historicalprogram_estimation_scale_and_more.py +68 -0
- trueppm_api/apps/projects/migrations/0126_projectcustomfield_show_on_card_taskcustomfieldvalue.py +80 -0
- trueppm_api/apps/projects/migrations/0127_historicalprogram_mcp_enabled_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0128_acceptancecriterion_sync_seq_apitoken_sync_seq_and_more.py +192 -0
- trueppm_api/apps/projects/migrations/0129_sharelink_show_milestone_dates.py +20 -0
- trueppm_api/apps/projects/migrations/0130_programimportjob.py +85 -0
- trueppm_api/apps/projects/migrations/0131_historicalprogram_sprint_picker_ready_only_default_and_more.py +32 -0
- trueppm_api/apps/projects/migrations/0132_task_scheduled_start.py +17 -0
- trueppm_api/apps/projects/migrations/0133_project_status_date_floor_armed_at.py +17 -0
- trueppm_api/apps/projects/migrations/0134_task_edited_at_task_seeded_at_task_source_id_and_more.py +65 -0
- trueppm_api/apps/projects/migrations/0135_projecttemplate_templateapplication_and_more.py +175 -0
- trueppm_api/apps/projects/migrations/0136_schedule_outline_batch_operations.py +118 -0
- trueppm_api/apps/projects/migrations/0137_collapse_dual_scope_api_tokens.py +54 -0
- trueppm_api/apps/projects/migrations/0138_apitokenauditentry_api_token_audit_owner_idx.py +18 -0
- trueppm_api/apps/projects/migrations/0139_historicaltask_duration_unit_task_duration_unit.py +32 -0
- trueppm_api/apps/projects/migrations/0140_historicaltask_auto_container_and_more.py +113 -0
- trueppm_api/apps/projects/migrations/0141_historicalproject_draft_started_at_and_more.py +44 -0
- trueppm_api/apps/projects/migrations/0142_baseline_calendar_hours_per_day_and_more.py +31 -0
- trueppm_api/apps/projects/migrations/0143_sprintcloserequest_failure_reason_and_more.py +42 -0
- trueppm_api/apps/projects/migrations/0144_projecttemplate_source_project_and_more.py +35 -0
- trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py +65 -0
- trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py +32 -0
- trueppm_api/apps/projects/migrations/0147_structuraloperation.py +128 -0
- trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py +76 -0
- trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py +42 -0
- trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py +130 -0
- trueppm_api/apps/projects/migrations/0151_config_notice_request.py +70 -0
- trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py +20 -0
- trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py +22 -0
- trueppm_api/apps/projects/migrations/__init__.py +0 -0
- trueppm_api/apps/projects/models.py +8946 -0
- trueppm_api/apps/projects/poker_services.py +154 -0
- trueppm_api/apps/projects/poker_views.py +398 -0
- trueppm_api/apps/projects/product_backlog_services.py +450 -0
- trueppm_api/apps/projects/program_label_services.py +94 -0
- trueppm_api/apps/projects/program_label_views.py +189 -0
- trueppm_api/apps/projects/program_rollup.py +575 -0
- trueppm_api/apps/projects/program_schedule.py +745 -0
- trueppm_api/apps/projects/program_views.py +3220 -0
- trueppm_api/apps/projects/project_templates.py +422 -0
- trueppm_api/apps/projects/receivers.py +234 -0
- trueppm_api/apps/projects/refusal_codes.py +140 -0
- trueppm_api/apps/projects/reorder_services.py +145 -0
- trueppm_api/apps/projects/restructure_hooks.py +54 -0
- trueppm_api/apps/projects/retro_board_services.py +368 -0
- trueppm_api/apps/projects/retro_services.py +285 -0
- trueppm_api/apps/projects/risk_import.py +396 -0
- trueppm_api/apps/projects/row_identity.py +113 -0
- trueppm_api/apps/projects/schema_migrations.py +228 -0
- trueppm_api/apps/projects/schemas/seed_v1.json +493 -0
- trueppm_api/apps/projects/schemas/seed_v2.json +892 -0
- trueppm_api/apps/projects/seed/__init__.py +61 -0
- trueppm_api/apps/projects/seed/exporter.py +1644 -0
- trueppm_api/apps/projects/seed/forecast_backfill.py +247 -0
- trueppm_api/apps/projects/seed/importer.py +2390 -0
- trueppm_api/apps/projects/seed/reanchor.py +551 -0
- trueppm_api/apps/projects/seed/reldates.py +126 -0
- trueppm_api/apps/projects/seed/replace.py +126 -0
- trueppm_api/apps/projects/seed/replay.py +1691 -0
- trueppm_api/apps/projects/seed/replay_ctx.py +41 -0
- trueppm_api/apps/projects/seed/samples.py +427 -0
- trueppm_api/apps/projects/seed/validation.py +1149 -0
- trueppm_api/apps/projects/serializers.py +12310 -0
- trueppm_api/apps/projects/services.py +6966 -0
- trueppm_api/apps/projects/share_serializers.py +132 -0
- trueppm_api/apps/projects/share_services.py +325 -0
- trueppm_api/apps/projects/share_views.py +374 -0
- trueppm_api/apps/projects/sharing_settings.py +187 -0
- trueppm_api/apps/projects/signal_privacy_services.py +909 -0
- trueppm_api/apps/projects/signal_privacy_views.py +476 -0
- trueppm_api/apps/projects/signals.py +132 -0
- trueppm_api/apps/projects/slip_conflict.py +266 -0
- trueppm_api/apps/projects/sprint_cadence.py +453 -0
- trueppm_api/apps/projects/sprint_picker_settings.py +132 -0
- trueppm_api/apps/projects/standup.py +304 -0
- trueppm_api/apps/projects/standup_views.py +99 -0
- trueppm_api/apps/projects/structural_operation_services.py +727 -0
- trueppm_api/apps/projects/structural_operation_views.py +311 -0
- trueppm_api/apps/projects/surface_visibility.py +126 -0
- trueppm_api/apps/projects/task_batch_services.py +379 -0
- trueppm_api/apps/projects/task_bulk.py +1152 -0
- trueppm_api/apps/projects/task_classification.py +561 -0
- trueppm_api/apps/projects/task_classification_defaults.py +95 -0
- trueppm_api/apps/projects/task_duration_settings.py +142 -0
- trueppm_api/apps/projects/task_grouping.py +754 -0
- trueppm_api/apps/projects/tasks.py +1917 -0
- trueppm_api/apps/projects/template_divergence.py +168 -0
- trueppm_api/apps/projects/template_services.py +160 -0
- trueppm_api/apps/projects/template_tasks.py +258 -0
- trueppm_api/apps/projects/template_views.py +799 -0
- trueppm_api/apps/projects/throttles.py +311 -0
- trueppm_api/apps/projects/urls.py +1011 -0
- trueppm_api/apps/projects/utilization.py +885 -0
- trueppm_api/apps/projects/views.py +20572 -0
- trueppm_api/apps/projects/wbs_paths.py +119 -0
- trueppm_api/apps/resources/__init__.py +0 -0
- trueppm_api/apps/resources/apps.py +8 -0
- trueppm_api/apps/resources/capacity.py +121 -0
- trueppm_api/apps/resources/migrations/0001_initial.py +68 -0
- trueppm_api/apps/resources/migrations/0001_squashed_0013_alter_projectresource_unique_together_and_more.py +281 -0
- trueppm_api/apps/resources/migrations/0002_alter_uuid_pk_serialize_false.py +36 -0
- trueppm_api/apps/resources/migrations/0003_resource_soft_delete.py +30 -0
- trueppm_api/apps/resources/migrations/0004_add_taskresource_resource_index.py +25 -0
- trueppm_api/apps/resources/migrations/0005_resource_job_role.py +20 -0
- trueppm_api/apps/resources/migrations/0006_skill.py +34 -0
- trueppm_api/apps/resources/migrations/0007_resource_skill.py +63 -0
- trueppm_api/apps/resources/migrations/0008_project_resource.py +63 -0
- trueppm_api/apps/resources/migrations/0009_task_skill_requirement.py +60 -0
- trueppm_api/apps/resources/migrations/0010_alter_resourceskill_options_and_more.py +20 -0
- trueppm_api/apps/resources/migrations/0011_alter_projectresource_notes.py +17 -0
- trueppm_api/apps/resources/migrations/0012_add_resource_user_fk.py +26 -0
- trueppm_api/apps/resources/migrations/0013_alter_projectresource_unique_together_and_more.py +53 -0
- trueppm_api/apps/resources/migrations/0014_projectresource_sync_seq_resource_sync_seq_and_more.py +37 -0
- trueppm_api/apps/resources/migrations/0015_projectresource_deactivated_with_resource.py +17 -0
- trueppm_api/apps/resources/migrations/__init__.py +0 -0
- trueppm_api/apps/resources/models.py +298 -0
- trueppm_api/apps/resources/serializers.py +426 -0
- trueppm_api/apps/resources/services.py +465 -0
- trueppm_api/apps/resources/urls.py +28 -0
- trueppm_api/apps/resources/views.py +1749 -0
- trueppm_api/apps/scheduling/__init__.py +0 -0
- trueppm_api/apps/scheduling/apps.py +153 -0
- trueppm_api/apps/scheduling/calendars.py +119 -0
- trueppm_api/apps/scheduling/deadletter.py +91 -0
- trueppm_api/apps/scheduling/forecast_history_settings.py +215 -0
- trueppm_api/apps/scheduling/forecast_staleness.py +313 -0
- trueppm_api/apps/scheduling/graph_guard.py +263 -0
- trueppm_api/apps/scheduling/management/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/__init__.py +0 -0
- trueppm_api/apps/scheduling/management/commands/prune_forecast_snapshots.py +53 -0
- trueppm_api/apps/scheduling/migrations/0001_failed_task.py +62 -0
- trueppm_api/apps/scheduling/migrations/0001_squashed_0007_projectforecastsnapshot.py +309 -0
- trueppm_api/apps/scheduling/migrations/0002_schedulerequest.py +78 -0
- trueppm_api/apps/scheduling/migrations/0003_add_schedule_request_reason.py +27 -0
- trueppm_api/apps/scheduling/migrations/0004_velocity_suggestion.py +94 -0
- trueppm_api/apps/scheduling/migrations/0005_montecarlorun.py +61 -0
- trueppm_api/apps/scheduling/migrations/0006_montecarlorun_distribution.py +17 -0
- trueppm_api/apps/scheduling/migrations/0007_projectforecastsnapshot.py +65 -0
- trueppm_api/apps/scheduling/migrations/0008_alter_schedulerequest_reason.py +28 -0
- trueppm_api/apps/scheduling/migrations/0008_folded_schedulerequest_reason.py +34 -0
- trueppm_api/apps/scheduling/migrations/0009_alter_schedulerequest_reason.py +29 -0
- trueppm_api/apps/scheduling/migrations/0010_failedtask_resolution_note_failedtask_resolved_at_and_more.py +43 -0
- trueppm_api/apps/scheduling/migrations/0011_failedtask_project.py +26 -0
- trueppm_api/apps/scheduling/migrations/0012_montecarlorun_diagnostic.py +17 -0
- trueppm_api/apps/scheduling/migrations/0013_montecarlorun_status_date.py +17 -0
- trueppm_api/apps/scheduling/migrations/0014_montecarlorun_plan_version.py +17 -0
- trueppm_api/apps/scheduling/migrations/__init__.py +0 -0
- trueppm_api/apps/scheduling/models.py +516 -0
- trueppm_api/apps/scheduling/receivers.py +160 -0
- trueppm_api/apps/scheduling/risk_premium.py +283 -0
- trueppm_api/apps/scheduling/serializers.py +564 -0
- trueppm_api/apps/scheduling/services.py +1182 -0
- trueppm_api/apps/scheduling/signals.py +56 -0
- trueppm_api/apps/scheduling/tasks.py +1984 -0
- trueppm_api/apps/scheduling/telemetry.py +80 -0
- trueppm_api/apps/scheduling/units.py +35 -0
- trueppm_api/apps/scheduling/urls.py +57 -0
- trueppm_api/apps/scheduling/views.py +2564 -0
- trueppm_api/apps/sso/__init__.py +0 -0
- trueppm_api/apps/sso/apps.py +19 -0
- trueppm_api/apps/sso/extensions.py +130 -0
- trueppm_api/apps/sso/management/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/__init__.py +0 -0
- trueppm_api/apps/sso/management/commands/seed_sso_keycloak.py +172 -0
- trueppm_api/apps/sso/migrations/0001_initial.py +119 -0
- trueppm_api/apps/sso/migrations/0002_remove_oidcprovider_workspace_ssoproviderpolicy_and_more.py +169 -0
- trueppm_api/apps/sso/migrations/__init__.py +0 -0
- trueppm_api/apps/sso/models.py +148 -0
- trueppm_api/apps/sso/serializers.py +437 -0
- trueppm_api/apps/sso/services.py +1385 -0
- trueppm_api/apps/sso/urls.py +47 -0
- trueppm_api/apps/sso/views.py +935 -0
- trueppm_api/apps/sync/__init__.py +0 -0
- trueppm_api/apps/sync/apps.py +15 -0
- trueppm_api/apps/sync/backfill.py +208 -0
- trueppm_api/apps/sync/broadcast.py +320 -0
- trueppm_api/apps/sync/conflict.py +262 -0
- trueppm_api/apps/sync/consumers.py +471 -0
- trueppm_api/apps/sync/migrations/0001_initial.py +59 -0
- trueppm_api/apps/sync/migrations/0001_squashed_0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +77 -0
- trueppm_api/apps/sync/migrations/0002_remove_syncbatch_syncbatch_project_client_batch_uniq_and_more.py +41 -0
- trueppm_api/apps/sync/migrations/0003_boardevent.py +46 -0
- trueppm_api/apps/sync/migrations/0004_seed_sync_seq.py +24 -0
- trueppm_api/apps/sync/migrations/0005_program_sync_sequence.py +35 -0
- trueppm_api/apps/sync/migrations/__init__.py +0 -0
- trueppm_api/apps/sync/models.py +225 -0
- trueppm_api/apps/sync/pagination.py +231 -0
- trueppm_api/apps/sync/sequence.py +371 -0
- trueppm_api/apps/sync/serializers.py +687 -0
- trueppm_api/apps/sync/tasks.py +260 -0
- trueppm_api/apps/sync/throttles.py +175 -0
- trueppm_api/apps/sync/upload.py +501 -0
- trueppm_api/apps/sync/urls.py +17 -0
- trueppm_api/apps/sync/views.py +930 -0
- trueppm_api/apps/sync/ws_auth.py +193 -0
- trueppm_api/apps/taskruns/__init__.py +0 -0
- trueppm_api/apps/taskruns/apps.py +11 -0
- trueppm_api/apps/taskruns/migrations/0001_initial.py +92 -0
- trueppm_api/apps/taskruns/migrations/__init__.py +0 -0
- trueppm_api/apps/taskruns/models.py +68 -0
- trueppm_api/apps/taskruns/serializers.py +92 -0
- trueppm_api/apps/taskruns/tasks.py +60 -0
- trueppm_api/apps/taskruns/tracker.py +286 -0
- trueppm_api/apps/taskruns/urls.py +46 -0
- trueppm_api/apps/taskruns/views.py +195 -0
- trueppm_api/apps/teams/__init__.py +8 -0
- trueppm_api/apps/teams/apps.py +16 -0
- trueppm_api/apps/teams/migrations/0001_initial.py +139 -0
- trueppm_api/apps/teams/migrations/0001_squashed_0002_default_teams.py +142 -0
- trueppm_api/apps/teams/migrations/0002_default_teams.py +62 -0
- trueppm_api/apps/teams/migrations/0003_team_sync_seq_teammembership_sync_seq.py +22 -0
- trueppm_api/apps/teams/migrations/__init__.py +0 -0
- trueppm_api/apps/teams/models.py +145 -0
- trueppm_api/apps/teams/permissions.py +149 -0
- trueppm_api/apps/teams/serializers.py +95 -0
- trueppm_api/apps/teams/services.py +434 -0
- trueppm_api/apps/teams/signals.py +61 -0
- trueppm_api/apps/teams/urls.py +34 -0
- trueppm_api/apps/teams/views.py +201 -0
- trueppm_api/apps/timetracking/__init__.py +0 -0
- trueppm_api/apps/timetracking/apps.py +9 -0
- trueppm_api/apps/timetracking/migrations/0001_initial.py +117 -0
- trueppm_api/apps/timetracking/migrations/0002_timesheetsubmission.py +46 -0
- trueppm_api/apps/timetracking/migrations/0003_timeentry_deleted_at_timeentry_deleted_by.py +31 -0
- trueppm_api/apps/timetracking/migrations/0004_timeentry_sync_seq_and_more.py +24 -0
- trueppm_api/apps/timetracking/migrations/__init__.py +0 -0
- trueppm_api/apps/timetracking/models.py +178 -0
- trueppm_api/apps/timetracking/serializers.py +175 -0
- trueppm_api/apps/timetracking/services.py +117 -0
- trueppm_api/apps/timetracking/urls.py +47 -0
- trueppm_api/apps/timetracking/views.py +526 -0
- trueppm_api/apps/webhooks/__init__.py +0 -0
- trueppm_api/apps/webhooks/apps.py +8 -0
- trueppm_api/apps/webhooks/backfill.py +90 -0
- trueppm_api/apps/webhooks/dispatch.py +144 -0
- trueppm_api/apps/webhooks/migrations/0001_initial.py +146 -0
- trueppm_api/apps/webhooks/migrations/0001_squashed_0007_sprint_lifecycle_events.py +243 -0
- trueppm_api/apps/webhooks/migrations/0002_alter_webhook_events.py +32 -0
- trueppm_api/apps/webhooks/migrations/0003_delivery_status_created_idx.py +17 -0
- trueppm_api/apps/webhooks/migrations/0004_webhook_program_alter_webhook_project_and_more.py +64 -0
- trueppm_api/apps/webhooks/migrations/0005_webhook_delivery_sequence_numbers.py +30 -0
- trueppm_api/apps/webhooks/migrations/0006_webhook_format_alter_webhook_events_and_more.py +61 -0
- trueppm_api/apps/webhooks/migrations/0007_sprint_lifecycle_events.py +63 -0
- trueppm_api/apps/webhooks/migrations/0008_risk_baseline_comment_events.py +73 -0
- trueppm_api/apps/webhooks/migrations/0009_encrypt_webhook_secret_and_failure_counters.py +90 -0
- trueppm_api/apps/webhooks/migrations/__init__.py +0 -0
- trueppm_api/apps/webhooks/models.py +372 -0
- trueppm_api/apps/webhooks/serializers.py +318 -0
- trueppm_api/apps/webhooks/tasks.py +663 -0
- trueppm_api/apps/webhooks/urls.py +22 -0
- trueppm_api/apps/webhooks/views.py +383 -0
- trueppm_api/apps/workflow_engine/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/apps.py +23 -0
- trueppm_api/apps/workflow_engine/migrations/0001_initial.py +230 -0
- trueppm_api/apps/workflow_engine/migrations/0001_squashed_0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +234 -0
- trueppm_api/apps/workflow_engine/migrations/0002_remove_workflowhistoryevent_workflow_history_lookup_idx.py +16 -0
- trueppm_api/apps/workflow_engine/migrations/0003_workflowoutboxrow_workflow_outbox_recovery_idx.py +21 -0
- trueppm_api/apps/workflow_engine/migrations/__init__.py +0 -0
- trueppm_api/apps/workflow_engine/models.py +265 -0
- trueppm_api/apps/workflow_engine/tasks.py +368 -0
- trueppm_api/apps/workspace/__init__.py +0 -0
- trueppm_api/apps/workspace/apps.py +10 -0
- trueppm_api/apps/workspace/backfill.py +111 -0
- trueppm_api/apps/workspace/export.py +242 -0
- trueppm_api/apps/workspace/migrations/0001_initial.py +326 -0
- trueppm_api/apps/workspace/migrations/0001_squashed_0014_workspacemembership_availability_effective_from_and_more.py +829 -0
- trueppm_api/apps/workspace/migrations/0002_remove_workspace_fiscal_year_start_and_more.py +85 -0
- trueppm_api/apps/workspace/migrations/0003_workspaceexportjob.py +73 -0
- trueppm_api/apps/workspace/migrations/0004_alter_workspaceinvite_status.py +27 -0
- trueppm_api/apps/workspace/migrations/0005_workspace_iteration_label_and_more.py +26 -0
- trueppm_api/apps/workspace/migrations/0006_alter_groupmembership_unique_together_and_more.py +45 -0
- trueppm_api/apps/workspace/migrations/0007_workspace_public_sharing_override_policy.py +21 -0
- trueppm_api/apps/workspace/migrations/0008_workspace_mc_history_attribution_audience_and_more.py +44 -0
- trueppm_api/apps/workspace/migrations/0009_workspace_methodology_and_more.py +186 -0
- trueppm_api/apps/workspace/migrations/0010_workspace_logo.py +38 -0
- trueppm_api/apps/workspace/migrations/0011_historicalworkspace_task_duration_change_percent_override_policy_and_more.py +56 -0
- trueppm_api/apps/workspace/migrations/0012_historicalworkspace_allowed_attachment_types_and_more.py +64 -0
- trueppm_api/apps/workspace/migrations/0013_auditevent.py +70 -0
- trueppm_api/apps/workspace/migrations/0014_workspacemembership_availability_effective_from_and_more.py +39 -0
- trueppm_api/apps/workspace/migrations/0015_trash_restore_1113.py +34 -0
- trueppm_api/apps/workspace/migrations/0016_historicalworkspace_calendar_and_more.py +55 -0
- trueppm_api/apps/workspace/migrations/0017_historicalworkspace_estimation_scale_and_more.py +38 -0
- trueppm_api/apps/workspace/migrations/0018_historicalworkspace_feedback_enabled_and_more.py +32 -0
- trueppm_api/apps/workspace/migrations/0019_historicalworkspace_mcp_enabled_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0020_viewer_ordinal_one.py +34 -0
- trueppm_api/apps/workspace/migrations/0021_group_sync_seq_groupmembership_sync_seq_and_more.py +27 -0
- trueppm_api/apps/workspace/migrations/0022_historicalworkspace_sprint_picker_ready_only_default_and_more.py +22 -0
- trueppm_api/apps/workspace/migrations/0023_alter_auditevent_event_type.py +32 -0
- trueppm_api/apps/workspace/migrations/0024_alter_auditevent_event_type.py +33 -0
- trueppm_api/apps/workspace/migrations/0025_alter_auditevent_event_type.py +36 -0
- trueppm_api/apps/workspace/migrations/0026_alter_auditevent_event_type.py +37 -0
- trueppm_api/apps/workspace/migrations/0027_alter_auditevent_event_type.py +42 -0
- trueppm_api/apps/workspace/migrations/__init__.py +0 -0
- trueppm_api/apps/workspace/models.py +857 -0
- trueppm_api/apps/workspace/permissions.py +187 -0
- trueppm_api/apps/workspace/serializers.py +590 -0
- trueppm_api/apps/workspace/services.py +919 -0
- trueppm_api/apps/workspace/signals.py +37 -0
- trueppm_api/apps/workspace/tasks.py +555 -0
- trueppm_api/apps/workspace/urls.py +113 -0
- trueppm_api/apps/workspace/views.py +1502 -0
- trueppm_api/asgi.py +42 -0
- trueppm_api/celery.py +31 -0
- trueppm_api/core/__init__.py +0 -0
- trueppm_api/core/admin_site.py +206 -0
- trueppm_api/core/auth_views.py +916 -0
- trueppm_api/core/constant_time.py +51 -0
- trueppm_api/core/csp.py +54 -0
- trueppm_api/core/db.py +87 -0
- trueppm_api/core/db_session.py +37 -0
- trueppm_api/core/exception_handlers.py +157 -0
- trueppm_api/core/export_downloads.py +56 -0
- trueppm_api/core/extension_providers.py +56 -0
- trueppm_api/core/extension_signals.py +147 -0
- trueppm_api/core/idempotent.py +260 -0
- trueppm_api/core/metadata.py +42 -0
- trueppm_api/core/middleware.py +51 -0
- trueppm_api/core/openapi.py +949 -0
- trueppm_api/core/password_reset.py +500 -0
- trueppm_api/core/protect_conflict.py +100 -0
- trueppm_api/core/ratelimit.py +148 -0
- trueppm_api/core/redis_throttle.py +82 -0
- trueppm_api/core/refresh_cookie_policy.py +156 -0
- trueppm_api/core/request_body.py +86 -0
- trueppm_api/core/security_checks.py +884 -0
- trueppm_api/core/storage_config.py +105 -0
- trueppm_api/core/text_decode.py +168 -0
- trueppm_api/core/throttling.py +344 -0
- trueppm_api/core/valkey.py +214 -0
- trueppm_api/core/valkey_cache.py +66 -0
- trueppm_api/core/valkey_checks.py +104 -0
- trueppm_api/core/valkey_config.py +39 -0
- trueppm_api/core/worker_broker_wait.py +149 -0
- trueppm_api/core/worker_heartbeat.py +134 -0
- trueppm_api/fields.py +36 -0
- trueppm_api/permissions.py +30 -0
- trueppm_api/py.typed +0 -0
- trueppm_api/routing.py +11 -0
- trueppm_api/settings/__init__.py +0 -0
- trueppm_api/settings/base.py +2455 -0
- trueppm_api/settings/dev.py +273 -0
- trueppm_api/settings/prod.py +228 -0
- trueppm_api/urls.py +153 -0
- trueppm_api/workflows/__init__.py +38 -0
- trueppm_api/workflows/backends/__init__.py +6 -0
- trueppm_api/workflows/backends/default.py +297 -0
- trueppm_api/workflows/consumers/__init__.py +11 -0
- trueppm_api/workflows/consumers/requeue_failed_task.py +65 -0
- trueppm_api/workflows/interface.py +148 -0
- trueppm_api/workflows/registry.py +106 -0
- trueppm_api/workflows/services.py +90 -0
- trueppm_api/wsgi.py +11 -0
- trueppm_api-0.4.0b2.dist-info/METADATA +70 -0
- trueppm_api-0.4.0b2.dist-info/RECORD +759 -0
- trueppm_api-0.4.0b2.dist-info/WHEEL +4 -0
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
"""The one constant-time comparison primitive for caller-controlled input (#2881, #2929).
|
|
2
|
+
|
|
3
|
+
``hmac.compare_digest`` (which ``secrets.compare_digest`` *is*) raises
|
|
4
|
+
``TypeError`` when either ``str`` argument contains a non-ASCII character. DRF
|
|
5
|
+
does not convert ``TypeError``, so any site that hands it a request-derived
|
|
6
|
+
string turns one byte of Latin-1 into an unhandled 500 — on precisely the
|
|
7
|
+
endpoints that are reachable anonymously, because those are the ones that
|
|
8
|
+
compare a secret against something a caller sent.
|
|
9
|
+
|
|
10
|
+
That defect shipped twice: once in the Git-webhook receiver (#2881), where the
|
|
11
|
+
500 was also an oracle — it is only reachable *after* the "is automation
|
|
12
|
+
configured?" check, so its mere shape told an anonymous caller that a project
|
|
13
|
+
has automation enabled with a secret set, exactly the fact the receiver's
|
|
14
|
+
uniform 404 exists to hide — and again in the SSO OIDC callback (#2929), where
|
|
15
|
+
the same line had the same flaw and the same-named test exercised it with an
|
|
16
|
+
ASCII value.
|
|
17
|
+
|
|
18
|
+
Two copies of the guard is how a third site appears silently, so this module is
|
|
19
|
+
the single home. ``tests/test_constant_time_compare_sites.py`` enforces that:
|
|
20
|
+
no other module in ``trueppm_api`` may call ``compare_digest`` directly.
|
|
21
|
+
|
|
22
|
+
Comparing **bytes** removes the raising path entirely rather than special-casing
|
|
23
|
+
the input. WSGI/ASGI hand header values over as ``Latin-1``-decoded text
|
|
24
|
+
(RFC 9110 §5.5), so ``latin-1`` round-trips the bytes a client actually sent;
|
|
25
|
+
the ``utf-8`` fallback covers input that carries a real code point above U+00FF
|
|
26
|
+
(a query parameter, a cookie, or a synthetic caller such as a test). Every
|
|
27
|
+
``expected`` value at our call sites is ASCII — a hex HMAC digest, a
|
|
28
|
+
``secrets.token_urlsafe`` secret, or a server-minted OAuth ``state`` — so no
|
|
29
|
+
encoding choice can make a mismatched value compare equal.
|
|
30
|
+
"""
|
|
31
|
+
|
|
32
|
+
from __future__ import annotations
|
|
33
|
+
|
|
34
|
+
import hmac
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def constant_time_equal(provided: str, expected: str) -> bool:
|
|
38
|
+
"""Constant-time compare caller-controlled ``provided`` against ``expected``.
|
|
39
|
+
|
|
40
|
+
Never raises on non-ASCII input. Both arguments may be attacker-controlled:
|
|
41
|
+
the SSO callback compares a query parameter against a cookie, and both sides
|
|
42
|
+
of that come from the request.
|
|
43
|
+
"""
|
|
44
|
+
return hmac.compare_digest(_to_bytes(provided), _to_bytes(expected))
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
def _to_bytes(value: str) -> bytes:
|
|
48
|
+
try:
|
|
49
|
+
return value.encode("latin-1")
|
|
50
|
+
except UnicodeEncodeError:
|
|
51
|
+
return value.encode("utf-8")
|
trueppm_api/core/csp.py
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"""Content-Security-Policy response-header middleware (#897).
|
|
2
|
+
|
|
3
|
+
A strict CSP is the primary defense-in-depth control against XSS: even if an
|
|
4
|
+
injection lands, ``script-src 'self'`` forbids inline and remote script
|
|
5
|
+
execution, ``base-uri 'none'`` blocks base-tag hijacking, and
|
|
6
|
+
``frame-ancestors 'none'`` prevents clickjacking. The policy is assembled from
|
|
7
|
+
settings so the ``connect-src`` host (e.g. the wss:// endpoint) and the
|
|
8
|
+
theme-init script hash can be overridden per deploy without code changes.
|
|
9
|
+
|
|
10
|
+
The CSP is set as an HTTP response header (not only a ``<meta>`` tag) because
|
|
11
|
+
``frame-ancestors`` and a handful of other directives are ignored when delivered
|
|
12
|
+
via ``<meta>`` — the header is authoritative.
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
from __future__ import annotations
|
|
16
|
+
|
|
17
|
+
from collections.abc import Callable
|
|
18
|
+
|
|
19
|
+
from django.conf import settings
|
|
20
|
+
from django.http import HttpRequest, HttpResponse
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def _build_policy() -> str:
|
|
24
|
+
"""Assemble the CSP header value from ``settings.CSP_DIRECTIVES``.
|
|
25
|
+
|
|
26
|
+
Each directive maps to a list of source expressions; they are joined into the
|
|
27
|
+
standard ``name src1 src2; name2 ...`` header syntax. Centralizing the policy
|
|
28
|
+
in settings keeps per-deploy overrides (connect-src host, script hash) in one
|
|
29
|
+
place rather than scattered string concatenation.
|
|
30
|
+
"""
|
|
31
|
+
directives: dict[str, list[str]] = settings.CSP_DIRECTIVES
|
|
32
|
+
parts = []
|
|
33
|
+
for name, sources in directives.items():
|
|
34
|
+
if sources:
|
|
35
|
+
parts.append(f"{name} {' '.join(sources)}")
|
|
36
|
+
else:
|
|
37
|
+
# Valueless directive (e.g. nothing) is uncommon; emit the name alone.
|
|
38
|
+
parts.append(name)
|
|
39
|
+
return "; ".join(parts)
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
class ContentSecurityPolicyMiddleware:
|
|
43
|
+
"""Attach a ``Content-Security-Policy`` header to every response."""
|
|
44
|
+
|
|
45
|
+
def __init__(self, get_response: Callable[[HttpRequest], HttpResponse]) -> None:
|
|
46
|
+
self.get_response = get_response
|
|
47
|
+
# Build once at process start — the policy is static per deploy.
|
|
48
|
+
self.policy = _build_policy()
|
|
49
|
+
|
|
50
|
+
def __call__(self, request: HttpRequest) -> HttpResponse:
|
|
51
|
+
response = self.get_response(request)
|
|
52
|
+
# Do not clobber a per-view CSP if one was already set deliberately.
|
|
53
|
+
response.setdefault("Content-Security-Policy", self.policy)
|
|
54
|
+
return response
|
trueppm_api/core/db.py
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
"""The one interpolated-SQL site in the API: atomic counter allocation (#2567).
|
|
2
|
+
|
|
3
|
+
Two counters are drawn the same way and must be: ``VersionedModel.server_version``
|
|
4
|
+
(a row's own save count, ADR-0142) and ``Project.last_sync_version`` (the allocator
|
|
5
|
+
for a project's ``sync_seq`` sequence, ADR-0686). Both need the *new* value in the
|
|
6
|
+
same statement that produces it::
|
|
7
|
+
|
|
8
|
+
UPDATE <table> SET <col> = <col> + 1 WHERE <pk> = %s RETURNING <col>
|
|
9
|
+
|
|
10
|
+
The Django ORM cannot express that. ``QuerySet.update()`` returns a row count, not
|
|
11
|
+
values, and ``db_returning`` applies to INSERT only — so the alternative is
|
|
12
|
+
``update(**{col: F(col) + 1})`` followed by a separate ``SELECT``. That is two
|
|
13
|
+
statements, and outside an explicit transaction the re-read can observe a *different*
|
|
14
|
+
writer's allocation. For ``sync_seq`` that is #2491 — the delta permanently skipping
|
|
15
|
+
rows — reintroduced as a race; the single statement is also what takes and holds the
|
|
16
|
+
row write lock that ADR-0686 documents as load-bearing. So this module keeps the raw
|
|
17
|
+
SQL, and keeps it in exactly one place.
|
|
18
|
+
|
|
19
|
+
**Why one place.** Both call sites carried their own copy of the statement until
|
|
20
|
+
#2567. `sonar-project.properties` documents the pattern as a reviewed false positive
|
|
21
|
+
under a path-pinned `python:S2077` criterion, and when #2491 added the second copy in
|
|
22
|
+
a new file the glob did not follow it — a reviewed-safe pattern resurfaced as a
|
|
23
|
+
new-code Security finding. One helper means one criterion with nowhere to drift to.
|
|
24
|
+
|
|
25
|
+
**Why it is safe.** Nothing user-controlled reaches the statement. The interpolated
|
|
26
|
+
parts are *identifiers* read off the model ``_meta`` and passed through the backend's
|
|
27
|
+
own quoter (``connection.ops.quote_name``); the pk is bound as a parameter. Callers
|
|
28
|
+
name the field, not the column, so a caller cannot supply a column name at all.
|
|
29
|
+
"""
|
|
30
|
+
|
|
31
|
+
from __future__ import annotations
|
|
32
|
+
|
|
33
|
+
from typing import Any
|
|
34
|
+
|
|
35
|
+
from django.db import connections, models, router
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
def increment_returning(
|
|
39
|
+
model: type[models.Model],
|
|
40
|
+
field_name: str,
|
|
41
|
+
pk: Any,
|
|
42
|
+
*,
|
|
43
|
+
instance: models.Model | None = None,
|
|
44
|
+
) -> int | None:
|
|
45
|
+
"""Atomically add 1 to one integer column and return its new value.
|
|
46
|
+
|
|
47
|
+
Args:
|
|
48
|
+
model: The concrete model owning the column.
|
|
49
|
+
field_name: Model field name (not a column name) to increment.
|
|
50
|
+
pk: Primary key of the row to increment.
|
|
51
|
+
instance: Passed to the database router when the write target depends on
|
|
52
|
+
the row itself; omit when the model alone decides.
|
|
53
|
+
|
|
54
|
+
Returns:
|
|
55
|
+
The post-increment value, or ``None`` when the ``UPDATE`` matched no row.
|
|
56
|
+
A caller sees ``None`` when the pk vanished under it (a concurrent hard
|
|
57
|
+
delete) or never existed — each decides what that means, so this function
|
|
58
|
+
does not guess.
|
|
59
|
+
"""
|
|
60
|
+
# Forward ``instance`` as a router hint only when there is one — a router that
|
|
61
|
+
# reads ``hints["instance"]`` would trip over a present-but-None value.
|
|
62
|
+
hints: dict[str, Any] = {} if instance is None else {"instance": instance}
|
|
63
|
+
connection = connections[router.db_for_write(model, **hints)]
|
|
64
|
+
quote = connection.ops.quote_name
|
|
65
|
+
pk_field = model._meta.pk
|
|
66
|
+
field = model._meta.get_field(field_name)
|
|
67
|
+
# ``get_field`` also yields reverse relations, which have no column at all.
|
|
68
|
+
# Callers name a concrete integer counter, so narrow the union rather than
|
|
69
|
+
# letting a typo reach the SQL as ``None``.
|
|
70
|
+
assert isinstance(field, models.Field)
|
|
71
|
+
column_name = field.column
|
|
72
|
+
# A concrete model always has a pk and real column names; narrow the stubs'
|
|
73
|
+
# broadened ``str | None`` so the quoted identifiers are str.
|
|
74
|
+
assert pk_field is not None and pk_field.column is not None
|
|
75
|
+
assert column_name is not None
|
|
76
|
+
table = quote(model._meta.db_table)
|
|
77
|
+
column = quote(column_name)
|
|
78
|
+
pk_col = quote(pk_field.column)
|
|
79
|
+
with connection.cursor() as cursor:
|
|
80
|
+
# nosemgrep: formatted-sql-query, sqlalchemy-execute-raw-query
|
|
81
|
+
cursor.execute(
|
|
82
|
+
f"UPDATE {table} SET {column} = {column} + 1 " # nosec B608
|
|
83
|
+
f"WHERE {pk_col} = %s RETURNING {column}",
|
|
84
|
+
[pk],
|
|
85
|
+
)
|
|
86
|
+
row = cursor.fetchone()
|
|
87
|
+
return int(row[0]) if row is not None else None
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
"""Session settings applied to every PostgreSQL connection the API or a worker opens.
|
|
2
|
+
|
|
3
|
+
**Why JIT is off (#3829).** PostgreSQL JIT-compiles any query whose *estimated* cost
|
|
4
|
+
crosses ``jit_above_cost`` (default 100,000), and also optimizes and inlines it past
|
|
5
|
+
``jit_optimize_above_cost`` / ``jit_inline_above_cost`` (500,000). The task list's
|
|
6
|
+
annotated page query crosses all three once planner statistics describe a ~2,000-task
|
|
7
|
+
project, and PostgreSQL then spends ~4.4 s compiling a query that executes in ~50 ms —
|
|
8
|
+
on every page the Schedule fetches, so opening that project took ~41 s. JIT pays off on
|
|
9
|
+
long analytic scans; every query this application issues is short and repeated, so the
|
|
10
|
+
compile cost is never recovered.
|
|
11
|
+
|
|
12
|
+
**Why a ``SET`` on connect rather than ``OPTIONS={"options": "-c jit=off"}``.** A startup
|
|
13
|
+
parameter is rejected outright by PgBouncer in transaction-pooling mode, which the
|
|
14
|
+
sizing guide recommends for large installs — that would turn a performance fix into a
|
|
15
|
+
connection failure. A ``SET`` cannot fail to connect. Behind a transaction pooler it is
|
|
16
|
+
best-effort (the setting lands on whichever server connection served it), so operators
|
|
17
|
+
running one are told to set it server-side as well.
|
|
18
|
+
"""
|
|
19
|
+
|
|
20
|
+
from __future__ import annotations
|
|
21
|
+
|
|
22
|
+
from typing import Any
|
|
23
|
+
|
|
24
|
+
from django.db.backends.base.base import BaseDatabaseWrapper
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def disable_jit(sender: Any, connection: BaseDatabaseWrapper, **kwargs: Any) -> None:
|
|
28
|
+
"""``connection_created`` receiver: turn PostgreSQL JIT off for this session.
|
|
29
|
+
|
|
30
|
+
Django sets autocommit before sending ``connection_created``, so the ``SET`` is
|
|
31
|
+
session-scoped rather than confined to a transaction that ``ATOMIC_REQUESTS`` or a
|
|
32
|
+
rollback would discard.
|
|
33
|
+
"""
|
|
34
|
+
if connection.vendor != "postgresql":
|
|
35
|
+
return
|
|
36
|
+
with connection.cursor() as cursor:
|
|
37
|
+
cursor.execute("SET jit = off")
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
"""Project-wide DRF exception handler.
|
|
2
|
+
|
|
3
|
+
The single custom ``EXCEPTION_HANDLER`` DRF invokes for every unhandled
|
|
4
|
+
exception raised inside a view. It translates non-``APIException`` failures that
|
|
5
|
+
DRF's stock handler would return as HTTP 500 into the clean 4xx they actually are.
|
|
6
|
+
|
|
7
|
+
Two families are handled. First, the two failure modes a malformed UUID produces
|
|
8
|
+
(#2125):
|
|
9
|
+
|
|
10
|
+
* ``uuid.UUID("<garbage>")`` raises ``ValueError("badly formed hexadecimal UUID
|
|
11
|
+
string")``; and
|
|
12
|
+
* filtering a queryset on a ``UUIDField`` with a non-UUID value raises Django's
|
|
13
|
+
``django.core.exceptions.ValidationError`` ("... is not a valid UUID").
|
|
14
|
+
|
|
15
|
+
Neither is a subclass of DRF's ``APIException``, so DRF's default handler returns
|
|
16
|
+
``None`` for them and the request bubbles up as a 500. This fired on essentially
|
|
17
|
+
every endpoint that reads a UUID from a *nested* path segment (``project_pk`` in
|
|
18
|
+
``/projects/<project_pk>/labels/``), a custom action (which uses Django's
|
|
19
|
+
``get_object_or_404`` — that shortcut, unlike DRF's, does not catch
|
|
20
|
+
``ValidationError``), or a query/filter param (``/tasks/?project=<garbage>``).
|
|
21
|
+
Plain DRF detail routes were already safe because ``GenericAPIView.get_object``
|
|
22
|
+
routes through DRF's ``get_object_or_404``, which does catch these.
|
|
23
|
+
|
|
24
|
+
A single handler is the smallest-blast-radius systemic fix: it covers router
|
|
25
|
+
routes, hand-registered nested routes, and query params at once, without editing
|
|
26
|
+
~20 url modules or risking the non-UUID lookup routes (share tokens, etc.).
|
|
27
|
+
|
|
28
|
+
Second, ``ProtectedError`` from a delete blocked by an ``on_delete=PROTECT``
|
|
29
|
+
foreign key (#2364). The refusal is correct — a live schedule must not lose the
|
|
30
|
+
calendar it was computed against — but reporting it as a server error is not; it
|
|
31
|
+
is a 409. This is a **net, not the primary guard**: endpoints where the caller can
|
|
32
|
+
act on the blocker list catch ``ProtectedError`` themselves and return the richer
|
|
33
|
+
``reference_count``/``references`` body from
|
|
34
|
+
:mod:`trueppm_api.core.protect_conflict`. The net exists because the same bug was
|
|
35
|
+
found three times — a delete path written against the FKs that existed at the
|
|
36
|
+
time, silently rotting as new ``PROTECT`` FKs landed. It guarantees the next one
|
|
37
|
+
is a 409 rather than a 500 even if nobody remembers to update the view.
|
|
38
|
+
"""
|
|
39
|
+
|
|
40
|
+
from __future__ import annotations
|
|
41
|
+
|
|
42
|
+
import uuid
|
|
43
|
+
from typing import Any
|
|
44
|
+
|
|
45
|
+
from django.core.exceptions import ValidationError as DjangoValidationError
|
|
46
|
+
from django.db.models import ProtectedError
|
|
47
|
+
from rest_framework.exceptions import NotFound
|
|
48
|
+
from rest_framework.exceptions import ValidationError as DRFValidationError
|
|
49
|
+
from rest_framework.response import Response
|
|
50
|
+
from rest_framework.views import exception_handler as drf_exception_handler
|
|
51
|
+
|
|
52
|
+
from trueppm_api.core.protect_conflict import protected_error_response
|
|
53
|
+
|
|
54
|
+
#: Generic refusal for a ``PROTECT``-ed delete no view claimed. Deliberately does
|
|
55
|
+
#: not name the referencing model — the net fires on paths that have not decided
|
|
56
|
+
#: how to describe their blockers, and leaking an internal model name reads as an
|
|
57
|
+
#: implementation detail rather than something the caller can act on.
|
|
58
|
+
_PROTECTED_DELETE_DETAIL = "This item is still referenced by other records and cannot be deleted."
|
|
59
|
+
|
|
60
|
+
# Stable substrings emitted by the two malformed-UUID code paths. Matching on the
|
|
61
|
+
# message keeps the handler narrowly scoped to genuine UUID-coercion failures, so
|
|
62
|
+
# an unrelated ``ValueError``/``ValidationError`` still falls through to the
|
|
63
|
+
# default 500 rather than being silently reclassified as client error.
|
|
64
|
+
_UUID_ERROR_MARKERS = (
|
|
65
|
+
"is not a valid uuid", # django.db.models.UUIDField.to_python
|
|
66
|
+
"badly formed hexadecimal uuid", # uuid.UUID(<garbage>)
|
|
67
|
+
)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
def _is_malformed_uuid_error(exc: Exception) -> bool:
|
|
71
|
+
"""Return True when *exc* is Django/stdlib's malformed-UUID failure."""
|
|
72
|
+
if isinstance(exc, DjangoValidationError):
|
|
73
|
+
message = " ".join(exc.messages)
|
|
74
|
+
elif isinstance(exc, ValueError):
|
|
75
|
+
message = str(exc)
|
|
76
|
+
else:
|
|
77
|
+
return False
|
|
78
|
+
message = message.lower()
|
|
79
|
+
return any(marker in message for marker in _UUID_ERROR_MARKERS)
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def _path_has_malformed_uuid(context: dict[str, Any]) -> bool:
|
|
83
|
+
"""Return True when a captured URL path kwarg is not a parseable UUID.
|
|
84
|
+
|
|
85
|
+
A malformed UUID in the *path* addresses an object that cannot exist, so 404
|
|
86
|
+
is the correct status (parity with DRF's own ``DoesNotExist`` -> 404). A
|
|
87
|
+
malformed UUID that is *not* in the path came from a query/filter param — bad
|
|
88
|
+
client input — and maps to 400. We only reach this check for a genuine
|
|
89
|
+
UUID-coercion error, so a non-UUID path segment (e.g. a share ``token``) never
|
|
90
|
+
trips it: those routes never coerce the segment to a UUID in the first place.
|
|
91
|
+
"""
|
|
92
|
+
for value in (context.get("kwargs") or {}).values():
|
|
93
|
+
if not isinstance(value, str):
|
|
94
|
+
continue
|
|
95
|
+
try:
|
|
96
|
+
uuid.UUID(value)
|
|
97
|
+
except (ValueError, AttributeError, TypeError):
|
|
98
|
+
return True
|
|
99
|
+
return False
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
def _attach_refusal(response: Response | None, context: dict[str, Any]) -> Response | None:
|
|
103
|
+
"""Add the refusal taxonomy to a 401/403 answered to an API-token caller (#2689).
|
|
104
|
+
|
|
105
|
+
The taxonomy exists, is recorded, and is hash-chained — and never reached the
|
|
106
|
+
caller that triggered it, who saw DRF's constant ``PermissionDenied``
|
|
107
|
+
detail and had to make a second call to ``GET /agent-actions/?constraint=…``
|
|
108
|
+
to learn why. This is the one place it goes on the wire.
|
|
109
|
+
|
|
110
|
+
Centralised here rather than at each guard for two reasons: the guards stay
|
|
111
|
+
fail-closed ``return False`` (a richer body is not worth restructuring them
|
|
112
|
+
for), and a guard that forgets to mark still refuses — it just refuses with
|
|
113
|
+
the generic detail, exactly as before.
|
|
114
|
+
|
|
115
|
+
Deliberately scoped to token callers. A human JWT/session 403 is untouched, so
|
|
116
|
+
this adds no contract change for the web client; the envelope exists for the
|
|
117
|
+
agent surface, which has no other channel.
|
|
118
|
+
"""
|
|
119
|
+
|
|
120
|
+
if response is None or response.status_code not in (401, 403):
|
|
121
|
+
return response
|
|
122
|
+
request = context.get("request")
|
|
123
|
+
if request is None:
|
|
124
|
+
return response
|
|
125
|
+
|
|
126
|
+
from trueppm_api.apps.agents.refusal import build_refusal_payload, refusal_marks
|
|
127
|
+
|
|
128
|
+
# The mark IS the token-caller signal, and it has to be: an identity refusal
|
|
129
|
+
# is raised by the authenticator, so `request.auth` is still None at that
|
|
130
|
+
# point and testing it would silently drop the envelope on exactly the case
|
|
131
|
+
# the issue was filed about. Only token-path code calls `mark_refusal`, so an
|
|
132
|
+
# unmarked failure — a human with an expired JWT, an anonymous 401 — falls
|
|
133
|
+
# through with its body untouched.
|
|
134
|
+
marks = refusal_marks(request)
|
|
135
|
+
if marks is None:
|
|
136
|
+
return response
|
|
137
|
+
|
|
138
|
+
if isinstance(response.data, dict):
|
|
139
|
+
response.data["refusal"] = build_refusal_payload(*marks)
|
|
140
|
+
return response
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
def trueppm_exception_handler(exc: Exception, context: dict[str, Any]) -> Response | None:
|
|
144
|
+
"""Map malformed-UUID failures to 404/400 and PROTECT-ed deletes to 409.
|
|
145
|
+
|
|
146
|
+
Also attaches the agent refusal taxonomy to a token caller's 401/403 (#2689).
|
|
147
|
+
Delegates everything else to DRF's default handler unchanged.
|
|
148
|
+
"""
|
|
149
|
+
if _is_malformed_uuid_error(exc):
|
|
150
|
+
exc = NotFound() if _path_has_malformed_uuid(context) else DRFValidationError()
|
|
151
|
+
elif isinstance(exc, ProtectedError):
|
|
152
|
+
return protected_error_response(
|
|
153
|
+
exc.protected_objects,
|
|
154
|
+
detail=_PROTECTED_DELETE_DETAIL,
|
|
155
|
+
code="protected_reference",
|
|
156
|
+
)
|
|
157
|
+
return _attach_refusal(drf_exception_handler(exc, context), context)
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
"""Shared response for a completed-or-not async export bundle download.
|
|
2
|
+
|
|
3
|
+
The project, program, and workspace export-download endpoints each queue a
|
|
4
|
+
``.tar.gz`` bundle asynchronously (ADR-0219/ADR-0174) and poll it here. Once
|
|
5
|
+
the caller has fetched and object-scoped its own job row (each app's own
|
|
6
|
+
``get_object_or_404`` — left to the caller, since the query differs per
|
|
7
|
+
scope), the status check and file stream that follow are identical (#3903).
|
|
8
|
+
"""
|
|
9
|
+
|
|
10
|
+
from __future__ import annotations
|
|
11
|
+
|
|
12
|
+
from typing import TYPE_CHECKING, Any
|
|
13
|
+
|
|
14
|
+
from django.http import FileResponse, Http404
|
|
15
|
+
from django.utils import timezone
|
|
16
|
+
from rest_framework import status
|
|
17
|
+
from rest_framework.response import Response
|
|
18
|
+
|
|
19
|
+
if TYPE_CHECKING:
|
|
20
|
+
from datetime import datetime
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def stream_export_job_or_error(
|
|
24
|
+
job: Any,
|
|
25
|
+
*,
|
|
26
|
+
success_status: str,
|
|
27
|
+
filename: str,
|
|
28
|
+
) -> Response | FileResponse:
|
|
29
|
+
"""Stream ``job``'s archive, or the not-ready/expired refusal.
|
|
30
|
+
|
|
31
|
+
``success_status`` is the caller's own ``ExportJobStatus.SUCCESS`` value —
|
|
32
|
+
each app keeps its own copy of that four-value enum by design (see
|
|
33
|
+
``apps.projects.models.ExportJobStatus``'s docstring on the one-way
|
|
34
|
+
``workspace -> projects`` import direction), so this takes the resolved
|
|
35
|
+
string rather than importing either.
|
|
36
|
+
"""
|
|
37
|
+
if job.status != success_status or not job.file_path:
|
|
38
|
+
return Response({"detail": "Export is not ready yet."}, status=status.HTTP_409_CONFLICT)
|
|
39
|
+
expires_at: datetime | None = job.expires_at
|
|
40
|
+
if expires_at is not None and expires_at < timezone.now():
|
|
41
|
+
return Response(
|
|
42
|
+
{"detail": "This export has expired. Request a new one."},
|
|
43
|
+
status=status.HTTP_410_GONE,
|
|
44
|
+
)
|
|
45
|
+
from django.core.files.storage import default_storage
|
|
46
|
+
|
|
47
|
+
try:
|
|
48
|
+
handle = default_storage.open(job.file_path, "rb")
|
|
49
|
+
except (FileNotFoundError, OSError) as exc:
|
|
50
|
+
raise Http404("Export archive is no longer available.") from exc
|
|
51
|
+
return FileResponse(
|
|
52
|
+
handle,
|
|
53
|
+
as_attachment=True,
|
|
54
|
+
filename=filename,
|
|
55
|
+
content_type="application/gzip",
|
|
56
|
+
)
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
"""Duplicate-registration guard for the single-provider extension hooks (#2859, #3779).
|
|
2
|
+
|
|
3
|
+
Most extension points are registries keyed by name, and ``ProviderRegistry`` raises
|
|
4
|
+
on a duplicate key. Eleven hooks are instead a module-global ``Callable | None`` with
|
|
5
|
+
an unconditional-assignment setter — the shape that fits a hook where at most one
|
|
6
|
+
provider can be meaningful (is enforcement active? what is the default posture?).
|
|
7
|
+
All eleven route through this guard as of #3779 (#2859 introduced it but converted
|
|
8
|
+
only 6 of the 11 slots).
|
|
9
|
+
|
|
10
|
+
Unconditional assignment makes them **last-write-wins**: two registrations silently
|
|
11
|
+
overwrite, and the winner is import order. That is the wrong failure mode for a
|
|
12
|
+
cross-repo seam. OSS registers nothing, so the realistic conflict is an Enterprise
|
|
13
|
+
build registering twice — from an ``AppConfig.ready()`` that runs more than once, or
|
|
14
|
+
from two apps that each think they own the hook — and the symptom would be an
|
|
15
|
+
enforcement policy that silently stops applying, with nothing in any log.
|
|
16
|
+
|
|
17
|
+
The guard is deliberately narrow, because the existing call patterns are legitimate:
|
|
18
|
+
|
|
19
|
+
* clearing (``None``) is always allowed — every test teardown does it;
|
|
20
|
+
* re-registering the *same* callable is a no-op, so an idempotent ``ready()`` is fine;
|
|
21
|
+
* only replacing a live provider with a *different* one raises.
|
|
22
|
+
"""
|
|
23
|
+
|
|
24
|
+
from __future__ import annotations
|
|
25
|
+
|
|
26
|
+
from typing import TypeVar
|
|
27
|
+
|
|
28
|
+
_T = TypeVar("_T")
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
class DuplicateProviderError(RuntimeError):
|
|
32
|
+
"""Raised when a second, different provider is registered against a single-provider hook."""
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def guard_single_provider(current: _T | None, incoming: _T | None, hook: str) -> _T | None:
|
|
36
|
+
"""Return ``incoming``, or raise if it would silently displace a different provider.
|
|
37
|
+
|
|
38
|
+
Args:
|
|
39
|
+
current: The provider currently registered, or ``None``.
|
|
40
|
+
incoming: The provider being registered, or ``None`` to clear.
|
|
41
|
+
hook: The hook's name, for the error message.
|
|
42
|
+
|
|
43
|
+
Returns:
|
|
44
|
+
``incoming``, so a setter can write ``_PROVIDER = guard_single_provider(...)``.
|
|
45
|
+
|
|
46
|
+
Raises:
|
|
47
|
+
DuplicateProviderError: If a *different* provider is already registered.
|
|
48
|
+
"""
|
|
49
|
+
if incoming is None or current is None or current is incoming:
|
|
50
|
+
return incoming
|
|
51
|
+
raise DuplicateProviderError(
|
|
52
|
+
f"{hook} already has a provider registered ({current!r}); refusing to replace it "
|
|
53
|
+
f"with {incoming!r}. This hook holds at most one provider, so an unconditional "
|
|
54
|
+
f"overwrite would make the winner depend on import order and silently disable the "
|
|
55
|
+
f"loser. Clear it explicitly (register None) if the replacement is intended."
|
|
56
|
+
)
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
"""Dispatch helper for the OSS→Enterprise extension signals.
|
|
2
|
+
|
|
3
|
+
The Apache 2.0 boundary is one-way: enterprise registers receivers against OSS
|
|
4
|
+
extension points, and OSS knows nothing about enterprise. That contract only
|
|
5
|
+
holds if a receiver *cannot* affect the OSS write path that fired it — which is
|
|
6
|
+
a property of how the signal is sent, not of how it is declared.
|
|
7
|
+
|
|
8
|
+
``Signal.send()`` propagates a receiver's exception to the sender. On a signal
|
|
9
|
+
wired to a model's ``post_save``, that means a bug in enterprise code fails the
|
|
10
|
+
OSS save. ``history_record_created`` is fired from the ``post_save`` of the
|
|
11
|
+
``Historical*`` models for Project, Task and Dependency, so a raising receiver
|
|
12
|
+
there breaks **every task save in the product** — not one feature (#2606).
|
|
13
|
+
|
|
14
|
+
``send_robust()`` is the correct primitive: it collects each receiver's
|
|
15
|
+
exception into its return value instead of raising. But it swallows silently,
|
|
16
|
+
and a receiver that has been failing for a week with nothing in the log is its
|
|
17
|
+
own kind of defect — one call site's docstring already claimed the failures were
|
|
18
|
+
"swallowed-and-logged" when nothing logged them. This helper is the pairing:
|
|
19
|
+
robust dispatch, and every receiver failure recorded with enough context to
|
|
20
|
+
identify which receiver, on which signal, from which sender.
|
|
21
|
+
|
|
22
|
+
**The exception is a signal that is deliberately fail-closed.** A veto — a
|
|
23
|
+
receiver that raises to *stop* the operation, like the ``agent_action_prune_requested``
|
|
24
|
+
legal-hold check — must keep using ``send()``. Making it robust would let the
|
|
25
|
+
operation proceed past a hold that failed to register, inverting the safety
|
|
26
|
+
property. Those sites are annotated in place; see
|
|
27
|
+
``scripts/check-extension-signals.sh``, which enforces this helper everywhere else.
|
|
28
|
+
|
|
29
|
+
The ``sender`` convention
|
|
30
|
+
-------------------------
|
|
31
|
+
|
|
32
|
+
**``sender`` is the OSS model class the signal is about, or ``None`` when the
|
|
33
|
+
signal is not about a model row. Never a string, never an instance.** (#3777)
|
|
34
|
+
|
|
35
|
+
Django's dispatcher filters receivers on ``sender`` *identity*, and it has no
|
|
36
|
+
notion of a wrong one: a receiver registered against a sender that never
|
|
37
|
+
arrives simply does not run. There is no error, no warning, and nothing on the
|
|
38
|
+
Enterprise side that could notice. Before this rule was written down, ten sites
|
|
39
|
+
passed a model class and six passed a string (``type(task).__name__``,
|
|
40
|
+
``task_name``), so ``@receiver(celery_task_started, sender=RecalculateScheduleTask)``
|
|
41
|
+
was silently dead code — which is why the form is fixed here rather than left to
|
|
42
|
+
each call site.
|
|
43
|
+
|
|
44
|
+
``None`` is the honest value where no model class exists. The five Celery-bridge
|
|
45
|
+
signals are the only such family: they are about a *worker run*, not a row, and
|
|
46
|
+
the terminal one (``celery_task_permanently_failed``) is dispatched from the
|
|
47
|
+
dead-letter recorder, which has the task's **name** and no task object at all —
|
|
48
|
+
so the family could not supply a class uniformly even if one were wanted. Their
|
|
49
|
+
discriminator is the ``task_name`` kwarg, present in every one of their
|
|
50
|
+
payloads; a receiver connects without a sender filter and branches on it.
|
|
51
|
+
|
|
52
|
+
The ``**kwargs`` convention
|
|
53
|
+
---------------------------
|
|
54
|
+
|
|
55
|
+
**Identifiers and plain scalars by default. A model instance only on a signal
|
|
56
|
+
dispatched inline — never on one dispatched from ``transaction.on_commit()``.**
|
|
57
|
+
|
|
58
|
+
An id is the looser coupling: Enterprise binds to a UUID rather than to the
|
|
59
|
+
shape of an OSS model, and the payload survives an OSS model refactor. But
|
|
60
|
+
"always ids" is wrong here, because the two dispatch timings give a receiver
|
|
61
|
+
different things to work with, and ``ATOMIC_REQUESTS`` is on:
|
|
62
|
+
|
|
63
|
+
- **Dispatched from** ``transaction.on_commit()`` — the row is durable, so a
|
|
64
|
+
receiver can fetch exactly the fields it needs by id. Pass identifiers
|
|
65
|
+
(``project_id``, ``milestone_id``, …), stringified UUIDs, and scalars.
|
|
66
|
+
``milestone_forecast_recomputed``, ``team_signal_consent_changed`` and
|
|
67
|
+
``team_signal_ceiling_proposal_changed`` are the model.
|
|
68
|
+
- **Dispatched inline**, inside the transaction that produced the row — the row
|
|
69
|
+
is *not* durable and may still roll back, and a receiver that re-read it by id
|
|
70
|
+
would be reading uncommitted state through the same connection. Here the
|
|
71
|
+
instance the sender hands over is the only safe form, and it is a **read-only
|
|
72
|
+
snapshot**: a receiver must not save it, and must defer any I/O with
|
|
73
|
+
``transaction.on_commit()``. ``task_status_changed``, ``risk_changed``,
|
|
74
|
+
``sprint_scope_changed`` and ``history_record_created`` are the model.
|
|
75
|
+
|
|
76
|
+
Two signals predate the rule and violate it: ``agent_action_recorded``
|
|
77
|
+
(``action=``) and ``audit_event_created`` (``audit_event=``) both fire from
|
|
78
|
+
``on_commit`` carrying an instance. Their own declarations pin them as
|
|
79
|
+
additive-only (ADR-0112) and "payload schema is STABLE" (ADR-0157), so the
|
|
80
|
+
instance kwarg cannot be withdrawn on this side of an Enterprise-coordinated
|
|
81
|
+
window; #3807 tracks adding the id sibling and retiring the instance. Do not
|
|
82
|
+
copy them.
|
|
83
|
+
"""
|
|
84
|
+
|
|
85
|
+
from __future__ import annotations
|
|
86
|
+
|
|
87
|
+
import logging
|
|
88
|
+
from typing import Any
|
|
89
|
+
|
|
90
|
+
from django.dispatch import Signal
|
|
91
|
+
|
|
92
|
+
logger = logging.getLogger(__name__)
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def dispatch_extension_signal(signal: Signal, *, sender: type[Any] | None, **kwargs: Any) -> None:
|
|
96
|
+
"""Fire an OSS→Enterprise extension signal without letting a receiver break OSS.
|
|
97
|
+
|
|
98
|
+
Args:
|
|
99
|
+
signal: The extension-point ``Signal`` to fire.
|
|
100
|
+
sender: The OSS model class the signal is about, or ``None`` when the
|
|
101
|
+
signal is not about a model row. Never a string and never an
|
|
102
|
+
instance — see the module docstring for why the form is fixed.
|
|
103
|
+
**kwargs: The signal's declared payload. Identifiers and scalars, except
|
|
104
|
+
on a signal dispatched inline; see the module docstring.
|
|
105
|
+
|
|
106
|
+
Note:
|
|
107
|
+
Never raises on a receiver's behalf. A receiver that fails is logged at
|
|
108
|
+
``exception`` level and the remaining receivers still run — that is
|
|
109
|
+
``send_robust``'s guarantee, and it is what keeps a third-party bug from
|
|
110
|
+
becoming an OSS outage.
|
|
111
|
+
|
|
112
|
+
A ``sender`` that breaks the convention is logged and then dispatched
|
|
113
|
+
anyway, deliberately. Raising here would give a dispatch-site bug the
|
|
114
|
+
power to break the OSS write path that fired the signal, which is the
|
|
115
|
+
exact property this helper exists to protect — a contract violation must
|
|
116
|
+
not be more destructive than the receiver failures it guards against.
|
|
117
|
+
The enforcement that actually stops one reaching main is static and runs
|
|
118
|
+
before the code does: ``mypy --strict`` rejects a non-class at the call
|
|
119
|
+
site, and ``scripts/check-extension-signals.sh`` re-checks the *shape* of
|
|
120
|
+
every ``sender=`` expression, catching the ``Any``-typed cases mypy is
|
|
121
|
+
blind to.
|
|
122
|
+
|
|
123
|
+
Do **not** use this for a fail-closed veto signal, where a raising
|
|
124
|
+
receiver is the mechanism rather than a fault.
|
|
125
|
+
"""
|
|
126
|
+
if sender is not None and not isinstance(sender, type):
|
|
127
|
+
# Logged, not raised: see the Note above. This is unreachable from a
|
|
128
|
+
# tree that passes the static gates, so a line here means one was
|
|
129
|
+
# bypassed — say so loudly enough to be greppable.
|
|
130
|
+
logger.error(
|
|
131
|
+
"Extension-signal sender breaks the convention (#3777): "
|
|
132
|
+
"expected a model class or None, got %r (%s). Receivers registered "
|
|
133
|
+
"against a class will not fire for this dispatch.",
|
|
134
|
+
sender,
|
|
135
|
+
type(sender).__name__,
|
|
136
|
+
)
|
|
137
|
+
for receiver, response in signal.send_robust(sender=sender, **kwargs):
|
|
138
|
+
if isinstance(response, Exception):
|
|
139
|
+
# exc_info explicitly: send_robust hands back the exception object
|
|
140
|
+
# rather than re-raising, so there is no active exception for
|
|
141
|
+
# logger.exception() to pick up from context.
|
|
142
|
+
logger.error(
|
|
143
|
+
"Extension-signal receiver failed: receiver=%s sender=%s",
|
|
144
|
+
getattr(receiver, "__qualname__", repr(receiver)),
|
|
145
|
+
getattr(sender, "__name__", repr(sender)),
|
|
146
|
+
exc_info=response,
|
|
147
|
+
)
|