trueppm-api 0.4.0__py3-none-any.whl

trueppm_api/apps/integrations/me_work.py

@@ -0,0 +1,218 @@
+"""My Work integration side-blocks (ADR-0097 §4, #1422).
+
+Builds the ``external_items`` and ``external_sources`` first-page blocks that
+``GET /api/v1/me/work/`` returns, so a contributor sees their read-only Jira
+(and future-source) items alongside native TruePPM tasks in one feed.
+
+Kept in the integrations app on purpose: the Apache-2.0 / read-only isolation
+invariant (``ExternalWorkItem`` is a personal cache, never a ``Task``, ADR-0097
+§2) lives here, and the projects app only calls :func:`me_work_external_blocks`
+without ever touching ``ExternalWorkItem`` directly. Distinct from the standalone
+``/me/external-items/`` endpoint (``connections.ExternalWorkItemSerializer``),
+which predates #1422 and keeps its own field names; the web reads *this* block.
+"""
+
+from __future__ import annotations
+
+import logging
+import urllib.parse
+from datetime import timedelta
+from typing import Any
+
+from django.conf import settings
+from django.db.models import Case, F, IntegerField, QuerySet, Value, When
+from django.utils import timezone
+from rest_framework import serializers
+
+from .connections import STATUS_AUTH_FAILED, STATUS_CONNECTED, last_sync_summary
+from .external_sources import BUCKET_IN_PROGRESS, BUCKET_TODO, EXTERNAL_TASK_SOURCES
+from .models import ExternalSyncRequestReason, ExternalWorkItem, IntegrationCredential
+
+logger = logging.getLogger(__name__)
+
+# Bucket display-rank: in_progress first, then todo, then done — the order a
+# contributor scans (what am I on now → what's next → what's finished). Applied
+# as the secondary sort after the due-date cascade.
+_BUCKET_RANK = Case(
+    When(display_bucket=BUCKET_IN_PROGRESS, then=Value(0)),
+    When(display_bucket=BUCKET_TODO, then=Value(1)),
+    default=Value(2),
+    output_field=IntegerField(),
+)
+
+
+class MeWorkExternalItemSerializer(serializers.Serializer[Any]):
+    """One external work item in the My Work ``external_items`` block (#1422).
+
+    Field names are the My Work contract (``source_type`` / ``key`` /
+    ``status_category`` / ``synced_at`` / ``url``), distinct from the standalone
+    ``/me/external-items/`` serializer that predates it — the web binds this
+    block. Read-only throughout: an external item is a personal cache row, never
+    a ``Task`` (ADR-0097 §2), so it carries no schedule/board/action fields.
+    """
+
+    id = serializers.UUIDField(read_only=True)
+    # ``source_type`` is the cross-source discriminator ("jira", "github", …);
+    # ``source="source"`` maps it onto the model's ``source`` column (a field
+    # literally named ``source`` collides with DRF's internal ``Field.source``).
+    source_type = serializers.CharField(source="source", read_only=True)
+    key = serializers.CharField(source="external_id", read_only=True)
+    title = serializers.CharField(read_only=True, allow_blank=True)
+    external_status = serializers.CharField(read_only=True, allow_blank=True)
+    status_category = serializers.CharField(source="display_bucket", read_only=True)
+    due_date = serializers.DateField(read_only=True, allow_null=True)
+    url = serializers.CharField(source="external_url", read_only=True, allow_blank=True)
+    synced_at = serializers.DateTimeField(source="last_synced_at", read_only=True, allow_null=True)
+
+
+def external_items_queryset(user: Any) -> QuerySet[ExternalWorkItem]:
+    """Return the user's live external items, ordered for My Work (#1422).
+
+    Ordering: ``due_date`` ascending with nulls last (dated work first, then
+    undated), then bucket rank (in_progress → todo → done), then most-recently
+    synced. The live set is bounded (≤500 per connected source, ADR-0097 §4 — a
+    single OSS source today), so the trailing sort over the
+    ``(user, is_stale, display_bucket)`` index range is cheap and needs no extra
+    index. Strictly personal — filters ``user`` and hides soft-removed
+    (``is_stale``) rows so no other user can ever see another user's items.
+    """
+    return (
+        ExternalWorkItem.objects.filter(user=user, is_stale=False)
+        .annotate(_bucket_rank=_BUCKET_RANK)
+        .order_by(F("due_date").asc(nulls_last=True), "_bucket_rank", "-last_synced_at")
+    )
+
+
+def _site_url(base_url: str) -> str:
+    """Extract the bare host ("truescope.atlassian.net") from a stored base URL."""
+    if not base_url:
+        return ""
+    parsed = urllib.parse.urlparse(base_url if "//" in base_url else f"https://{base_url}")
+    return (parsed.hostname or "").lower()
+
+
+def external_source_summaries(user: Any) -> list[dict[str, Any]]:
+    """Per-source freshness/status for the My Work ``external_sources`` block.
+
+    One row per ``EXTERNAL_TASK_SOURCES`` provider the user has actually
+    connected, so the UI can render a "Jira · synced 2 min ago" freshness line
+    and swap to a "Reconnect" prompt when the #1419 pull worker flipped the
+    connection to ``auth_failed`` (ADR-0097 §5). A single query over the user's
+    credentials — no per-source round-trip.
+
+    Each row also carries the last pull's outcome (``last_sync``, #2925), because
+    this block is what My Work itself renders: a feed truncated at the source's
+    page size is otherwise indistinguishable from a complete one, and the place
+    that truth matters most is the list the user is actually looking at.
+    """
+    source_keys = EXTERNAL_TASK_SOURCES.keys()
+    creds = {
+        c.provider: c
+        for c in IntegrationCredential.objects.filter(user=user, provider__in=source_keys)
+    }
+    summaries: list[dict[str, Any]] = []
+    for key in source_keys:
+        row = creds.get(key)
+        if row is None:
+            continue  # only surface sources the user has connected
+        source_cls = EXTERNAL_TASK_SOURCES.get(key)
+        cfg = row.config or {}
+        summaries.append(
+            {
+                "source_type": key,
+                "label": getattr(source_cls, "label", key.title()),
+                "site_url": _site_url(row.base_url),
+                "status": cfg.get("status") or STATUS_CONNECTED,
+                "last_synced_at": row.last_used_at,
+                "last_sync": last_sync_summary(cfg),
+            }
+        )
+    return summaries
+
+
+def _maybe_enqueue_on_open_refresh(user: Any) -> None:
+    """Refresh-if-stale: enqueue a non-blocking ON_OPEN pull for stale connections.
+
+    ADR-0097 §4 names "an on-open refresh-if-stale when My Work loads" as the
+    feature's second trigger (alongside the user-hit-Refresh ``MANUAL`` one) but
+    it was never wired (#1921) — ``ExternalSyncRequestReason.ON_OPEN`` sat
+    defined-but-unused. This is that wiring.
+
+    Deliberately fire-and-forget and never allowed to affect the response:
+    ``enqueue_external_sync`` only writes a small outbox row and hands the
+    actual Jira fetch to Celery via a ``transaction.on_commit`` dispatch (see
+    ``services.py``) — no external HTTP call happens on this request's thread,
+    so a slow or unreachable Jira instance cannot slow down or fail My Work.
+    Any enqueue failure (unregistered source, broker hiccup inside
+    ``enqueue_external_sync``) is swallowed for the same reason: a background
+    refresh is a nice-to-have, not a condition of the page loading.
+
+    The staleness check below *is* the throttle, not a separate mechanism: a
+    connection whose ``last_used_at`` is inside
+    ``TRUEPPM_EXTERNAL_SYNC_ON_OPEN_STALE_SECONDS`` is fresh and skipped
+    outright, so a user bouncing in and out of My Work does not enqueue a pull
+    (let alone hit Jira) on every load — matching the "already low-frequency by
+    construction" exemption ``enqueue_external_sync`` already documents for
+    this reason. Once a pull *is* enqueued, the outbox's per-``(user, source)``
+    partial-unique-PENDING constraint coalesces any further opens onto that
+    same in-flight row instead of stacking a second fetch.
+    """
+    from .services import enqueue_external_sync
+
+    source_keys = EXTERNAL_TASK_SOURCES.keys()
+    if not source_keys:
+        return
+
+    stale_floor = timedelta(
+        seconds=getattr(settings, "TRUEPPM_EXTERNAL_SYNC_ON_OPEN_STALE_SECONDS", 300)
+    )
+    now = timezone.now()
+
+    creds = IntegrationCredential.objects.filter(user=user, provider__in=source_keys)
+    for cred in creds:
+        config = cred.config or {}
+        if config.get("status") == STATUS_AUTH_FAILED:
+            # A dead token needs "Reconnect", not a retry that will just fail
+            # again and needlessly burn the outbox/broker (mirrors the same
+            # skip in ``tasks._do_poll``).
+            continue
+        is_stale = cred.last_used_at is None or (now - cred.last_used_at) >= stale_floor
+        if not is_stale:
+            continue
+        try:
+            enqueue_external_sync(user.id, cred.provider, reason=ExternalSyncRequestReason.ON_OPEN)
+        except ValueError:
+            # Source de-registered since the credential was created — nothing
+            # to enqueue against.
+            continue
+        except Exception:
+            # Never let a refresh-if-stale hiccup break the My Work response.
+            logger.exception(
+                "me_work: on-open refresh enqueue failed for user=%s source=%s",
+                user.id,
+                cred.provider,
+            )
+
+
+def me_work_external_blocks(user: Any) -> dict[str, Any]:
+    """Build the ``external_items`` + ``external_sources`` My Work side-blocks.
+
+    Called once, on the first page of ``GET /me/work/`` (mirrors ``signals``).
+    Both keys are always present (possibly empty lists) so the web binds one
+    stable shape and can distinguish "no source connected" (empty
+    ``external_sources``) from "connected, nothing assigned" (a source present
+    with an empty ``external_items``).
+
+    Also fires the ADR-0097 §4 on-open refresh-if-stale (#1921): a best-effort,
+    non-blocking enqueue of an ``ON_OPEN`` pull for any connected source whose
+    cache has gone stale, so the *next* load picks up fresher data without the
+    user having to find the manual refresh control. See
+    :func:`_maybe_enqueue_on_open_refresh` for the non-blocking/throttle
+    contract.
+    """
+    items = list(external_items_queryset(user))
+    _maybe_enqueue_on_open_refresh(user)
+    return {
+        "external_items": MeWorkExternalItemSerializer(items, many=True).data,
+        "external_sources": external_source_summaries(user),
+    }

trueppm_api/apps/integrations/migrations/0001_initial.py

@@ -0,0 +1,64 @@
+"""Initial migration for ``apps.integrations`` — ``IntegrationCredential`` only.
+
+``TaskLink`` (#637), the outgoing webhook ``format`` field (#638), and
+``UserNotificationPreference`` table extensions (#639) ship in successor
+migrations that depend on this 0001 baseline.
+"""
+
+import uuid
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="IntegrationCredential",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4,
+                        editable=False,
+                        primary_key=True,
+                        serialize=False,
+                    ),
+                ),
+                ("provider", models.CharField(max_length=32)),
+                ("secret_ciphertext", models.BinaryField()),
+                ("base_url", models.CharField(blank=True, default="", max_length=512)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("last_used_at", models.DateTimeField(blank=True, null=True)),
+                ("expires_at", models.DateTimeField(blank=True, null=True)),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="integration_credentials",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Integration credential",
+                "verbose_name_plural": "Integration credentials",
+                "ordering": ("provider",),
+            },
+        ),
+        migrations.AddConstraint(
+            model_name="integrationcredential",
+            constraint=models.UniqueConstraint(
+                fields=("user", "provider"),
+                name="integrations_credential_unique_per_user_provider",
+            ),
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0001_squashed_0006_tasklink_description_tasklink_preview_type_and_more.py

@@ -0,0 +1,187 @@
+# Generated by Django 5.2.14 on 2026-06-23 21:38
+
+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):
+    replaces = [
+        ("integrations", "0001_initial"),
+        ("integrations", "0002_tasklink"),
+        ("integrations", "0003_tasklink_tasklink_serverver_idx"),
+        ("integrations", "0004_tasklink_custom_title_tasklink_labels"),
+        ("integrations", "0005_boardautomation"),
+        ("integrations", "0006_tasklink_description_tasklink_preview_type_and_more"),
+    ]
+
+    initial = True
+
+    dependencies = [
+        ("projects", "0051_alter_calendar_working_days_alter_dependency_lag_and_more"),
+        ("projects", "0053_dependency_dep_pred_serverver_idx_and_more"),
+        ("projects", "0088_historicalprogram_allowed_attachment_types_and_more"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="IntegrationCredential",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("provider", models.CharField(max_length=32)),
+                ("secret_ciphertext", models.BinaryField()),
+                ("base_url", models.CharField(blank=True, default="", max_length=512)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                ("last_used_at", models.DateTimeField(blank=True, null=True)),
+                ("expires_at", models.DateTimeField(blank=True, null=True)),
+                (
+                    "user",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="integration_credentials",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Integration credential",
+                "verbose_name_plural": "Integration credentials",
+                "ordering": ("provider",),
+                "constraints": [
+                    models.UniqueConstraint(
+                        fields=("user", "provider"),
+                        name="integrations_credential_unique_per_user_provider",
+                    )
+                ],
+            },
+        ),
+        migrations.CreateModel(
+            name="BoardAutomation",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("enabled", models.BooleanField(default=False)),
+                ("secret_ciphertext", models.BinaryField(blank=True, default=b"")),
+                ("secret_set_at", models.DateTimeField(blank=True, null=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "configured_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "project",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="git_automation",
+                        to="projects.project",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "board automation",
+                "verbose_name_plural": "board automations",
+            },
+        ),
+        migrations.CreateModel(
+            name="TaskLink",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("server_version", models.BigIntegerField(default=0, editable=False)),
+                ("is_deleted", models.BooleanField(db_index=True, default=False)),
+                ("deleted_version", models.BigIntegerField(blank=True, editable=False, null=True)),
+                ("url", models.URLField(max_length=2048)),
+                ("provider", models.CharField(max_length=32)),
+                ("title", models.CharField(blank=True, default="", max_length=512)),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("open", "open"),
+                            ("draft", "draft"),
+                            ("merged", "merged"),
+                            ("closed", "closed"),
+                            ("unknown", "unknown"),
+                        ],
+                        default="unknown",
+                        max_length=16,
+                    ),
+                ),
+                ("fetched_at", models.DateTimeField(blank=True, null=True)),
+                ("display_order", models.PositiveIntegerField(default=0)),
+                (
+                    "task",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="links",
+                        to="projects.task",
+                    ),
+                ),
+                ("custom_title", models.CharField(blank=True, default="", max_length=512)),
+                (
+                    "labels",
+                    django.contrib.postgres.fields.ArrayField(
+                        base_field=models.CharField(max_length=40),
+                        blank=True,
+                        default=list,
+                        size=None,
+                    ),
+                ),
+                ("description", models.CharField(blank=True, default="", max_length=1024)),
+                (
+                    "preview_type",
+                    models.CharField(
+                        blank=True,
+                        choices=[
+                            ("document", "document"),
+                            ("spreadsheet", "spreadsheet"),
+                            ("presentation", "presentation"),
+                            ("image", "image"),
+                            ("pdf", "pdf"),
+                            ("folder", "folder"),
+                            ("file", "file"),
+                        ],
+                        default="",
+                        max_length=16,
+                    ),
+                ),
+                ("thumbnail_url", models.URLField(blank=True, default="", max_length=2048)),
+            ],
+            options={
+                "verbose_name": "Task link",
+                "verbose_name_plural": "Task links",
+                "ordering": ("display_order", "id"),
+                "indexes": [
+                    models.Index(
+                        fields=["task", "display_order"], name="integrations_link_task_order"
+                    ),
+                    models.Index(fields=["task", "server_version"], name="tasklink_serverver_idx"),
+                ],
+            },
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0002_tasklink.py

@@ -0,0 +1,67 @@
+# Generated by Django 5.2.14 on 2026-05-26 18:06
+
+import uuid
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("integrations", "0001_initial"),
+        ("projects", "0051_alter_calendar_working_days_alter_dependency_lag_and_more"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="TaskLink",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("server_version", models.BigIntegerField(default=0, editable=False)),
+                ("is_deleted", models.BooleanField(db_index=True, default=False)),
+                ("deleted_version", models.BigIntegerField(blank=True, editable=False, null=True)),
+                ("url", models.URLField(max_length=2048)),
+                ("provider", models.CharField(max_length=32)),
+                ("title", models.CharField(blank=True, default="", max_length=512)),
+                (
+                    "status",
+                    models.CharField(
+                        choices=[
+                            ("open", "open"),
+                            ("draft", "draft"),
+                            ("merged", "merged"),
+                            ("closed", "closed"),
+                            ("unknown", "unknown"),
+                        ],
+                        default="unknown",
+                        max_length=16,
+                    ),
+                ),
+                ("fetched_at", models.DateTimeField(blank=True, null=True)),
+                ("display_order", models.PositiveIntegerField(default=0)),
+                (
+                    "task",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="links",
+                        to="projects.task",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "Task link",
+                "verbose_name_plural": "Task links",
+                "ordering": ("display_order", "id"),
+                "indexes": [
+                    models.Index(
+                        fields=["task", "display_order"], name="integrations_link_task_order"
+                    )
+                ],
+            },
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0003_tasklink_tasklink_serverver_idx.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.2.14 on 2026-05-29 17:01
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("integrations", "0002_tasklink"),
+        ("projects", "0053_dependency_dep_pred_serverver_idx_and_more"),
+    ]
+
+    operations = [
+        migrations.AddIndex(
+            model_name="tasklink",
+            index=models.Index(fields=["task", "server_version"], name="tasklink_serverver_idx"),
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0004_tasklink_custom_title_tasklink_labels.py

@@ -0,0 +1,25 @@
+# Generated by Django 5.2.14 on 2026-06-06 22:06
+
+import django.contrib.postgres.fields
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("integrations", "0003_tasklink_tasklink_serverver_idx"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="tasklink",
+            name="custom_title",
+            field=models.CharField(blank=True, default="", max_length=512),
+        ),
+        migrations.AddField(
+            model_name="tasklink",
+            name="labels",
+            field=django.contrib.postgres.fields.ArrayField(
+                base_field=models.CharField(max_length=40), blank=True, default=list, size=None
+            ),
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0005_boardautomation.py

@@ -0,0 +1,56 @@
+# Generated by Django 5.2.14 on 2026-06-21 02:18
+
+import uuid
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("integrations", "0004_tasklink_custom_title_tasklink_labels"),
+        ("projects", "0088_historicalprogram_allowed_attachment_types_and_more"),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="BoardAutomation",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False
+                    ),
+                ),
+                ("enabled", models.BooleanField(default=False)),
+                ("secret_ciphertext", models.BinaryField(blank=True, default=b"")),
+                ("secret_set_at", models.DateTimeField(blank=True, null=True)),
+                ("created_at", models.DateTimeField(auto_now_add=True)),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+                (
+                    "configured_by",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        related_name="+",
+                        to=settings.AUTH_USER_MODEL,
+                    ),
+                ),
+                (
+                    "project",
+                    models.OneToOneField(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="git_automation",
+                        to="projects.project",
+                    ),
+                ),
+            ],
+            options={
+                "verbose_name": "board automation",
+                "verbose_name_plural": "board automations",
+            },
+        ),
+    ]

trueppm_api/apps/integrations/migrations/0006_tasklink_description_tasklink_preview_type_and_more.py

@@ -0,0 +1,40 @@
+# Generated by Django 5.2.14 on 2026-06-22 19:58
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("integrations", "0005_boardautomation"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="tasklink",
+            name="description",
+            field=models.CharField(blank=True, default="", max_length=1024),
+        ),
+        migrations.AddField(
+            model_name="tasklink",
+            name="preview_type",
+            field=models.CharField(
+                blank=True,
+                choices=[
+                    ("document", "document"),
+                    ("spreadsheet", "spreadsheet"),
+                    ("presentation", "presentation"),
+                    ("image", "image"),
+                    ("pdf", "pdf"),
+                    ("folder", "folder"),
+                    ("file", "file"),
+                ],
+                default="",
+                max_length=16,
+            ),
+        ),
+        migrations.AddField(
+            model_name="tasklink",
+            name="thumbnail_url",
+            field=models.URLField(blank=True, default="", max_length=2048),
+        ),
+    ]