trueppm-api 0.4.0b2__py3-none-any.whl

trueppm_api/apps/projects/migrations/0145_seed_bundled_templates.py

@@ -0,0 +1,65 @@
+"""Seed the starter templates that ship with the install (#2909).
+
+A data migration rather than a management command because the failure being fixed
+is that a **fresh install** has an empty Template way-in. Anything an operator has
+to remember to run leaves the default install exactly as broken as it was.
+
+Idempotent on name, and additive: an operator who has deleted or unpublished a
+starter does not get it back on the next migrate, because `get_or_create` matches
+the row whether it is published or not. Reversing drops only untouched starters —
+a row somebody has adopted from is left alone.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from django.db import migrations
+
+
+def seed(apps: Any, schema_editor: Any) -> None:
+    ProjectTemplate = apps.get_model("projects", "ProjectTemplate")
+    from trueppm_api.apps.projects.bundled_templates import BUNDLED_TEMPLATES
+
+    for name, description, build in BUNDLED_TEMPLATES:
+        structure = build()
+        ProjectTemplate.objects.get_or_create(
+            name=name,
+            defaults={
+                "description": description,
+                # COMMUNITY is what the gallery labels "Bundled" and sorts last.
+                "source_kind": "community",
+                "structure": structure,
+                "carries": structure.get("carries", []),
+                "is_published": True,
+                # No owner and no source project: nobody in this workspace
+                # published them, and claiming otherwise would put a name on the
+                # provenance line that means nothing to the reader.
+                "owner": None,
+                "published_by": None,
+                "program": None,
+            },
+        )
+
+
+def unseed(apps: Any, schema_editor: Any) -> None:
+    ProjectTemplate = apps.get_model("projects", "ProjectTemplate")
+    from trueppm_api.apps.projects.bundled_templates import BUNDLED_TEMPLATE_NAMES
+
+    # Only starters nobody has adopted from. Deleting a template that seeded a
+    # running project would strip the adoption record's only remaining pointer.
+    ProjectTemplate.objects.filter(
+        name__in=BUNDLED_TEMPLATE_NAMES,
+        source_kind="community",
+        applications__isnull=True,
+    ).delete()
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0144_projecttemplate_source_project_and_more"),
+    ]
+
+    operations = [
+        migrations.RunPython(seed, unseed),
+    ]

trueppm_api/apps/projects/migrations/0146_historicaltask_board_lane_task_board_lane.py

@@ -0,0 +1,32 @@
+# Generated by Django 5.2.16 on 2026-08-22 16:08
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0145_seed_bundled_templates"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="historicaltask",
+            name="board_lane",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Named lane within this task's status column. Empty = the column's first lane. Presentation only — never affects scheduling or rollup.",
+                max_length=32,
+            ),
+        ),
+        migrations.AddField(
+            model_name="task",
+            name="board_lane",
+            field=models.CharField(
+                blank=True,
+                default="",
+                help_text="Named lane within this task's status column. Empty = the column's first lane. Presentation only — never affects scheduling or rollup.",
+                max_length=32,
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0147_structuraloperation.py

@@ -0,0 +1,128 @@
+# Generated by Django 5.2.16 on 2026-08-23 01:41
+
+import uuid
+
+import django.contrib.postgres.fields
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0146_historicaltask_board_lane_task_board_lane"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="StructuralOperation",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                (
+                    "kind",
+                    models.CharField(
+                        choices=[
+                            ("indent", "Indent"),
+                            ("outdent", "Outdent"),
+                            ("reparent", "Reparent"),
+                            ("reorder", "Reorder"),
+                            ("group", "Group"),
+                            ("ungroup", "Ungroup"),
+                        ],
+                        max_length=10,
+                    ),
+                ),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[("active", "Active"), ("undone", "Undone")],
+                        default="active",
+                        max_length=10,
+                    ),
+                ),
+                ("undoable", models.BooleanField(default=True)),
+                ("shape_before", models.JSONField(blank=True, default=dict)),
+                ("shape_after", models.JSONField(blank=True, default=dict)),
+                (
+                    "region_roots",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.TextField(), blank=True, default=list, size=None
+                    ),
+                ),
+                (
+                    "anchor_task_ids",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.UUIDField(), blank=True, default=list, size=None
+                    ),
+                ),
+                (
+                    "created_task_ids",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.UUIDField(), blank=True, default=list, size=None
+                    ),
+                ),
+                (
+                    "deleted_task_ids",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.UUIDField(), blank=True, default=list, size=None
+                    ),
+                ),
+                ("created_task_versions", models.JSONField(blank=True, default=dict)),
+                (
+                    "removed_dependency_ids",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.UUIDField(), blank=True, default=list, size=None
+                    ),
+                ),
+                ("result_summary", models.JSONField(blank=True, default=dict)),
+                ("created_at", models.DateTimeField(auto_now_add=True, db_index=True)),
+                ("undone_at", models.DateTimeField(blank=True, null=True)),
+                (
+                    "applied_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="structural_operations",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "project",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="structural_operations",
+                        to="projects.project",
+                    ),
+                ),
+                (
+                    "undone_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="structural_operations_undone",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "projects_structural_operation",
+                "ordering": ["-created_at"],
+                "indexes": [
+                    models.Index(fields=["created_at"], name="structop_created_idx"),
+                    models.Index(fields=["project", "created_at"], name="structop_proj_idx"),
+                    models.Index(
+                        fields=["project", "applied_by", "status", "created_at"],
+                        name="structop_stack_idx",
+                    ),
+                ],
+            },
+        ),
+    ]

trueppm_api/apps/projects/migrations/0148_task_unique_task_wbs_path_per_project_live.py

@@ -0,0 +1,76 @@
+# Generated by Django 5.2.16 on 2026-08-26 00:24
+
+from typing import Any
+
+import django.contrib.postgres.constraints
+import django.db.models.constraints
+from django.conf import settings
+from django.db import migrations, models
+
+from trueppm_api.apps.projects.backfill import repair_duplicate_wbs_paths
+
+
+def _repair_duplicate_wbs_paths(apps: Any, schema_editor: Any) -> None:
+    """Clear duplicate live ``(project, wbs_path)`` rows so ``AddConstraint`` can validate.
+
+    Without this, ``migrate`` aborts on any database that already holds two live tasks
+    sharing a path — and because migrations run on container start, that is an upgrade
+    crash-loop rather than an error an operator can step around (#3068).
+
+    A three-line wrapper on purpose. The repair AND its WARNING log both live in
+    ``projects.backfill`` so a test can reach them without importing this module by
+    name, which a squash would delete (CLAUDE.md migration rule 3).
+    """
+    repair_duplicate_wbs_paths(apps.get_model("projects", "Task"))
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0147_structuraloperation"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        # btree_gist adds GiST support for scalar equality (=) on ordinary types
+        # like the UUID `project` column below — ltree already has its own native
+        # GiST opclass, so only the UUID side of this exclusion constraint needs it.
+        #
+        # Forward is `IF NOT EXISTS`, so reverse must be a noop rather than
+        # `DROP EXTENSION IF EXISTS`: on a database where the extension was already
+        # present — installed by the operator, or by another schema sharing the
+        # database — this migration did not create it, and a rollback dropping it
+        # would take out whatever else depends on it. An unused extension left
+        # behind is the cheap mistake; a dropped one other objects need is not.
+        migrations.RunSQL(
+            sql="CREATE EXTENSION IF NOT EXISTS btree_gist;",
+            reverse_sql=migrations.RunSQL.noop,
+        ),
+        # Must precede AddConstraint: the constraint cannot validate while a
+        # duplicate exists, and this is what removes them.
+        migrations.RunPython(
+            _repair_duplicate_wbs_paths,
+            # Reverse is a noop by necessity rather than omission. The repair moved
+            # rows onto free paths, and those paths may since have been taken by newer
+            # work; re-creating the duplicate state is neither possible nor wanted.
+            # Dropping the constraint is what makes the old state legal again, and
+            # that is the reverse of AddConstraint, not of this.
+            migrations.RunPython.noop,
+            elidable=False,
+        ),
+        # LOCK WINDOW — read before upgrading a large install. `EXCLUDE USING GIST`
+        # takes ACCESS EXCLUSIVE on `projects_task` for the whole index build, which
+        # blocks reads as well as writes. Unlike the `CREATE INDEX CONCURRENTLY` in
+        # siblings 0090/0100/0105, an exclusion constraint cannot be built
+        # concurrently — PostgreSQL has no `ADD CONSTRAINT ... CONCURRENTLY` — so this
+        # is documented rather than fixed. Plan a maintenance window proportional to
+        # the row count.
+        migrations.AddConstraint(
+            model_name="task",
+            constraint=django.contrib.postgres.constraints.ExclusionConstraint(
+                condition=models.Q(("is_deleted", False)),
+                deferrable=django.db.models.constraints.Deferrable["DEFERRED"],
+                expressions=[("project", "="), ("wbs_path", "=")],
+                name="unique_task_wbs_path_per_project_live",
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0149_drop_workshops_tables.py

@@ -0,0 +1,42 @@
+"""Drop the workshops tables left behind by removing the workshops app (#3301).
+
+The ``workshops`` app is deleted, so its own migrations can no longer run — an app
+that is not in ``INSTALLED_APPS`` has no migration state and Django will never
+apply a ``DeleteModel`` for it. Without this the two tables would survive forever
+on every existing database as orphans that nothing owns and nothing can drop.
+
+Raw SQL rather than ``DeleteModel`` for the same reason: the models no longer
+exist to reference. This is one of the narrow cases the migration-discipline rule
+in CLAUDE.md carves out for ``RunSQL`` — the ORM genuinely cannot express it.
+
+The ``django_migrations`` cleanup matters as much as the ``DROP``: leaving the
+rows behind would make a later app with the same label inherit a phantom applied
+history and silently skip its own ``0001_initial``.
+
+Irreversible by design. Reversing would have to recreate two tables whose model
+definitions are gone from the tree; a database that needs them back should
+restore from a backup or check out a pre-removal ref.
+"""
+
+from __future__ import annotations
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0148_task_unique_task_wbs_path_per_project_live"),
+    ]
+
+    operations = [
+        migrations.RunSQL(
+            # Participant carries the FK, so it goes first. IF EXISTS keeps this a
+            # no-op on a database created after the app was removed.
+            sql=[
+                "DROP TABLE IF EXISTS workshops_participant;",
+                "DROP TABLE IF EXISTS workshops_session;",
+                "DELETE FROM django_migrations WHERE app = 'workshops';",
+            ],
+            reverse_sql=migrations.RunSQL.noop,
+        ),
+    ]

trueppm_api/apps/projects/migrations/0150_clear_uncommitted_cpm_output.py

@@ -0,0 +1,130 @@
+# Generated by Django 5.2.17 on 2026-09-09 17:09
+
+from typing import Any
+
+from django.db import migrations, models
+
+from trueppm_api.apps.projects.services import clear_all_uncommitted_cpm_output
+
+
+def _clear_uncommitted_cpm_output(apps: Any, schema_editor: Any) -> None:
+    """One-time clear of CPM output on rows that already left the committed set.
+
+    ADR-1152 makes the eight CPM columns non-null iff the row is in
+    ``Task.committed``, and the recompute now enforces that going forward. It does
+    not reach backwards: the rows carrying residue are by definition NOT in the
+    recompute's input, so a project only converges when it next recalculates — and
+    an archived or finished project never will. Its overview would keep serving
+    phantom late counts indefinitely (#3578).
+
+    A thin wrapper on purpose: the predicate lives in ``projects.services`` so a test
+    can reach it without importing this module by name, which a squash would delete
+    (CLAUDE.md migration rule 3).
+
+    It routes through ``clear_all_uncommitted_cpm_output``, which chunks by project
+    so each statement is index-served rather than sequentially scanning the whole
+    ``projects_task`` table — migrations run on container start, and that scan would
+    be unbounded upgrade latency for a residue expected to be small. That function's
+    docstring carries the full reasoning. It is idempotent, so an interrupted run is
+    safe to retry from the start.
+
+    No constraint is added, so ``api:migration-constraint-safety`` does not apply.
+    All eight columns are in ``_HISTORY_EXCLUDED_TASK``, so this writes no
+    ``HistoricalTask`` rows, and it deliberately does not bump ``server_version``
+    or trigger a recompute — it is the same derived-output write the CPM task
+    already performs (ADR-0091).
+    """
+    clear_all_uncommitted_cpm_output(
+        apps.get_model("projects", "Task"),
+        apps.get_model("projects", "Project"),
+    )
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0149_drop_workshops_tables"),
+    ]
+
+    operations = [
+        # Reverse is a noop by necessity, not omission: the cleared values were the
+        # engine's output from a run whose inputs no longer exist, and nothing
+        # retained them. Re-creating the residue is neither possible nor wanted —
+        # the next recompute is what repopulates any row that re-enters the
+        # committed set.
+        migrations.RunPython(
+            _clear_uncommitted_cpm_output,
+            reverse_code=migrations.RunPython.noop,
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="early_finish",
+            field=models.DateField(
+                blank=True,
+                help_text="CPM early finish. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="early_start",
+            field=models.DateField(
+                blank=True,
+                help_text="CPM early start. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="free_float",
+            field=models.IntegerField(
+                blank=True,
+                help_text="Free float in working days. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="is_critical",
+            field=models.BooleanField(
+                blank=True,
+                help_text="Critical-path membership. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="late_finish",
+            field=models.DateField(
+                blank=True,
+                help_text="CPM late finish. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="late_start",
+            field=models.DateField(
+                blank=True,
+                help_text="CPM late start. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="scheduled_start",
+            field=models.DateField(
+                blank=True,
+                help_text="CPM span start. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="task",
+            name="total_float",
+            field=models.IntegerField(
+                blank=True,
+                help_text="Total float in working days. Read-only engine output. Null when the task is outside the schedulable set (BACKLOG status, EPIC type, a recurring template or occurrence, or soft-deleted) or has not been scheduled yet.",
+                null=True,
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0151_config_notice_request.py

@@ -0,0 +1,70 @@
+# Generated by Django 5.2.17 on 2026-09-13 22:20
+
+import uuid
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0150_clear_uncommitted_cpm_output"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="ConfigNoticeRequest",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("kind", models.CharField(max_length=8)),
+                ("payload", models.JSONField()),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("pending", "Pending"),
+                            ("dispatched", "Dispatched"),
+                            ("running", "Running"),
+                            ("done", "Done"),
+                            ("dead", "Dead"),
+                        ],
+                        default="pending",
+                        max_length=12,
+                    ),
+                ),
+                ("attempt_count", models.PositiveIntegerField(default=0)),
+                ("celery_task_id", models.CharField(blank=True, default="", max_length=255)),
+                ("requested_at", models.DateTimeField(auto_now_add=True)),
+                ("claimed_at", models.DateTimeField(blank=True, null=True)),
+                ("completed_at", models.DateTimeField(blank=True, null=True)),
+                (
+                    "actor",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ["requested_at"],
+                "indexes": [
+                    models.Index(
+                        fields=["status", "requested_at"], name="config_notice_status_idx"
+                    ),
+                    models.Index(
+                        fields=["status", "claimed_at"], name="config_notice_recovery_idx"
+                    ),
+                ],
+            },
+        ),
+    ]

trueppm_api/apps/projects/migrations/0152_aggregate_task_wbs_name_idx.py

@@ -0,0 +1,20 @@
+# Generated by Django 5.2.17 on 2026-09-15 23:19
+
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0151_config_notice_request"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.AddIndex(
+            model_name="task",
+            index=models.Index(
+                fields=["project", "wbs_path", "name"], name="task_proj_wbs_name_idx"
+            ),
+        ),
+    ]

trueppm_api/apps/projects/migrations/0153_program_sample_anchor_date.py

@@ -0,0 +1,22 @@
+# Generated by Django 5.2.17 on 2026-09-15 23:30
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("projects", "0152_aggregate_task_wbs_name_idx"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="historicalprogram",
+            name="sample_anchor_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+        migrations.AddField(
+            model_name="program",
+            name="sample_anchor_date",
+            field=models.DateField(blank=True, null=True),
+        ),
+    ]