diffbutler 0.5.0__py3-none-any.whl

diffbutler/store/migrations/versions/0001_initial.py

@@ -0,0 +1,147 @@
+"""Initial local identity and review-cycle ledger."""
+
+from uuid import UUID
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0001"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "account",
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("forge", sa.String(length=32), nullable=False),
+        sa.Column("login", sa.String(length=255), nullable=False),
+        sa.Column("display_name", sa.String(length=255), nullable=False),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_account")),
+    )
+    op.create_table(
+        "repository",
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("forge", sa.String(length=255), nullable=False),
+        sa.Column("namespace", sa.String(length=255), nullable=False),
+        sa.Column("name", sa.String(length=255), nullable=False),
+        sa.Column("default_branch", sa.String(length=255), nullable=False),
+        sa.Column("config_json", sa.JSON(), nullable=False),
+        sa.Column("enabled", sa.Boolean(), nullable=False),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_repository")),
+        sa.UniqueConstraint("forge", "namespace", "name", name=op.f("uq_repository_forge")),
+    )
+    op.create_table(
+        "pull_request",
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("repository_id", sa.Uuid(), nullable=False),
+        sa.Column("number", sa.Integer(), nullable=False),
+        sa.Column("title", sa.String(length=1024), nullable=False),
+        sa.Column("author", sa.String(length=255), nullable=False),
+        sa.Column("head_sha", sa.String(length=64), nullable=False),
+        sa.Column("base_sha", sa.String(length=64), nullable=False),
+        sa.Column("head_ref", sa.String(length=255), nullable=False),
+        sa.Column("base_ref", sa.String(length=255), nullable=False),
+        sa.Column("is_draft", sa.Boolean(), nullable=False),
+        sa.Column("url", sa.String(length=2048), nullable=False),
+        sa.Column("state", sa.String(length=32), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("fetched_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("extra_json", sa.JSON(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["repository_id"],
+            ["repository.id"],
+            name=op.f("fk_pull_request_repository_id_repository"),
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_pull_request")),
+        sa.UniqueConstraint("repository_id", "number", name=op.f("uq_pull_request_repository_id")),
+    )
+    op.create_table(
+        "review_task",
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("pull_request_id", sa.Uuid(), nullable=False),
+        sa.Column("account_id", sa.Uuid(), nullable=False),
+        sa.Column("cycle_number", sa.Integer(), nullable=False),
+        sa.Column("state", sa.String(length=32), nullable=False),
+        sa.Column("snoozed_until", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("priority", sa.Integer(), nullable=False),
+        sa.Column("notes", sa.String(length=16384), nullable=True),
+        sa.Column("first_seen_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("opened_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("posted_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("updated_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("following", sa.Boolean(), nullable=False),
+        sa.Column("request_sources_json", sa.JSON(), nullable=False),
+        sa.Column("last_request_event", sa.String(length=255), nullable=True),
+        sa.Column("last_activity_cursor", sa.String(length=1024), nullable=True),
+        sa.Column("last_reviewed_sha", sa.String(length=64), nullable=True),
+        sa.Column("approved_sha", sa.String(length=64), nullable=True),
+        sa.Column("completion_reason", sa.String(length=64), nullable=True),
+        sa.Column("completion_source", sa.String(length=64), nullable=True),
+        sa.Column("completion_event_watermark", sa.String(length=1024), nullable=True),
+        sa.Column("action_version", sa.Integer(), nullable=False),
+        sa.Column("state_source", sa.String(length=64), nullable=True),
+        sa.Column("state_event_watermark", sa.String(length=1024), nullable=True),
+        sa.Column("completed_at", sa.DateTime(timezone=True), nullable=True),
+        sa.CheckConstraint("cycle_number > 0", name=op.f("ck_review_task_positive_cycle")),
+        sa.ForeignKeyConstraint(
+            ["account_id"], ["account.id"], name=op.f("fk_review_task_account_id_account")
+        ),
+        sa.ForeignKeyConstraint(
+            ["pull_request_id"],
+            ["pull_request.id"],
+            name=op.f("fk_review_task_pull_request_id_pull_request"),
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_review_task")),
+        sa.UniqueConstraint(
+            "pull_request_id",
+            "account_id",
+            "cycle_number",
+            name=op.f("uq_review_task_pull_request_id"),
+        ),
+    )
+    op.create_table(
+        "cleanup_job",
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("review_task_id", sa.Uuid(), nullable=False),
+        sa.Column("status", sa.String(length=32), nullable=False),
+        sa.Column("attempts", sa.Integer(), nullable=False),
+        sa.Column("next_retry_at", sa.DateTime(timezone=True), nullable=True),
+        sa.Column("last_error", sa.String(length=4096), nullable=True),
+        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("completed_at", sa.DateTime(timezone=True), nullable=True),
+        sa.ForeignKeyConstraint(
+            ["review_task_id"],
+            ["review_task.id"],
+            name=op.f("fk_cleanup_job_review_task_id_review_task"),
+        ),
+        sa.PrimaryKeyConstraint("id", name=op.f("pk_cleanup_job")),
+        sa.UniqueConstraint("review_task_id", name=op.f("uq_cleanup_job_review_task_id")),
+    )
+    op.bulk_insert(
+        sa.table(
+            "account",
+            sa.column("id", sa.Uuid()),
+            sa.column("forge", sa.String()),
+            sa.column("login", sa.String()),
+            sa.column("display_name", sa.String()),
+        ),
+        [
+            {
+                "id": UUID("00000000-0000-0000-0000-000000000001"),
+                "forge": "local",
+                "login": "local",
+                "display_name": "Local account",
+            }
+        ],
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("cleanup_job")
+    op.drop_table("review_task")
+    op.drop_table("pull_request")
+    op.drop_table("repository")
+    op.drop_table("account")

diffbutler/store/migrations/versions/0002_monitoring.py

@@ -0,0 +1,38 @@
+"""Account-scoped monitoring and persistent activity watermarks."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0002"
+down_revision = "0001"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("review_task", sa.Column("completed_head_sha", sa.String(64), nullable=True))
+    op.create_table(
+        "forge_account",
+        sa.Column("account_id", sa.Uuid(), sa.ForeignKey("account.id"), primary_key=True),
+        sa.Column("forge", sa.String(255), nullable=False),
+        sa.Column("login", sa.String(255), nullable=False),
+        sa.Column("version", sa.Integer(), nullable=False),
+        sa.UniqueConstraint("forge", "login", name="uq_forge_account_forge"),
+    )
+    op.create_table(
+        "pr_monitor",
+        sa.Column("account_id", sa.Uuid(), sa.ForeignKey("account.id"), primary_key=True),
+        sa.Column("pull_request_id", sa.Uuid(), sa.ForeignKey("pull_request.id"), primary_key=True),
+        sa.Column("task_id", sa.Uuid(), sa.ForeignKey("review_task.id"), nullable=False),
+        sa.Column("following", sa.Boolean(), nullable=False),
+        sa.Column("sources", sa.JSON(), nullable=False),
+        sa.Column("snapshot_json", sa.JSON(), nullable=False),
+        sa.Column("request_key", sa.String(1024), nullable=False),
+        sa.Column("review_key", sa.String(1024), nullable=False),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("pr_monitor")
+    op.drop_table("forge_account")
+    op.drop_column("review_task", "completed_head_sha")

diffbutler/store/migrations/versions/0003_reviews.py

@@ -0,0 +1,72 @@
+"""Durable conversation identity and analysis attempts; no automatic dispatch."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0003"
+down_revision = "0002"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "review_session",
+        sa.Column("id", sa.Uuid(), primary_key=True),
+        sa.Column("review_task_id", sa.Uuid(), sa.ForeignKey("review_task.id"), nullable=False),
+        sa.Column("reviewer_id", sa.String(255), nullable=False),
+        sa.Column("generation", sa.Integer(), nullable=False),
+        sa.Column("display_name", sa.String(1024), nullable=False),
+        sa.Column("backend_session_id", sa.String(1024)),
+        sa.Column("repository_path", sa.String(4096)),
+        sa.Column("status", sa.String(32), nullable=False),
+        sa.Column("transcript_ref", sa.String(4096)),
+        sa.Column("resource_manifest_json", sa.JSON(), nullable=False),
+        sa.Column("cleanup_status", sa.String(32), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("resumed_at", sa.DateTime(timezone=True)),
+        sa.Column("cleaned_at", sa.DateTime(timezone=True)),
+        sa.UniqueConstraint("review_task_id", "reviewer_id", "generation"),
+        sa.UniqueConstraint("id", "review_task_id", "reviewer_id"),
+        sa.CheckConstraint("generation > 0", name="positive_generation"),
+        sa.CheckConstraint("status IN ('ready', 'suspended', 'cleaned')", name="session_status"),
+    )
+    op.create_table(
+        "ai_run",
+        sa.Column("id", sa.Uuid(), primary_key=True),
+        sa.Column("review_task_id", sa.Uuid(), sa.ForeignKey("review_task.id"), nullable=False),
+        sa.Column("review_session_id", sa.Uuid(), nullable=False),
+        sa.Column("reviewer_id", sa.String(255), nullable=False),
+        sa.Column("prompt_version", sa.String(255), nullable=False),
+        sa.Column("config_hash", sa.String(64), nullable=False),
+        sa.Column("head_sha", sa.String(64), nullable=False),
+        sa.Column("base_sha", sa.String(64), nullable=False),
+        sa.Column("analysis_key", sa.String(64), nullable=False),
+        sa.Column("attempt", sa.Integer(), nullable=False),
+        sa.Column("status", sa.String(32), nullable=False),
+        sa.Column("parse_status", sa.String(32), nullable=False),
+        sa.Column("requested_at", sa.DateTime(timezone=True), nullable=False),
+        sa.Column("started_at", sa.DateTime(timezone=True)),
+        sa.Column("finished_at", sa.DateTime(timezone=True)),
+        sa.Column("exit_code", sa.Integer()),
+        sa.Column("stdout_blob", sa.LargeBinary()),
+        sa.Column("stderr_blob", sa.LargeBinary()),
+        sa.UniqueConstraint("analysis_key", "attempt"),
+        sa.ForeignKeyConstraint(
+            ["review_session_id", "review_task_id", "reviewer_id"],
+            ["review_session.id", "review_session.review_task_id", "review_session.reviewer_id"],
+        ),
+        sa.CheckConstraint("attempt > 0", name="positive_attempt"),
+        sa.CheckConstraint(
+            "status IN ('queued', 'running', 'succeeded', 'failed', 'cancelled', 'stale')",
+            name="run_status",
+        ),
+        sa.CheckConstraint(
+            "parse_status IN ('pending', 'succeeded', 'failed')", name="parse_status"
+        ),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("ai_run")
+    op.drop_table("review_session")

diffbutler/store/migrations/versions/0004_claims.py

@@ -0,0 +1,22 @@
+"""Durable exclusive worker ownership, separate from analysis validity."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0004"
+down_revision = "0003"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "run_claim",
+        sa.Column("token", sa.Uuid(), primary_key=True),
+        sa.Column("run_id", sa.Uuid(), sa.ForeignKey("ai_run.id"), nullable=False),
+        sa.UniqueConstraint("run_id"),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("run_claim")

diffbutler/store/migrations/versions/0005_results.py

@@ -0,0 +1,27 @@
+"""Retain parsed analysis independently of cleanup-eligible process output."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0005"
+down_revision = "0004"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "review_result",
+        sa.Column("run_id", sa.Uuid(), sa.ForeignKey("ai_run.id"), primary_key=True),
+        sa.Column("document_json", sa.Text(), nullable=True),
+        sa.Column("parse_tier", sa.String(32), nullable=True),
+        sa.Column("error", sa.String(255), nullable=True),
+        sa.Column("notes", sa.JSON(), nullable=False),
+        sa.Column("selected_indices", sa.JSON(), nullable=False),
+        sa.Column("min_confidence", sa.Float(), nullable=False),
+        sa.Column("findings_threshold", sa.String(32), nullable=False),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("review_result")

diffbutler/store/migrations/versions/0006_anchors.py

@@ -0,0 +1,17 @@
+"""Retain original and validated anchors separately from model findings."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0006"
+down_revision = "0005"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("review_result", sa.Column("anchors_json", sa.Text(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("review_result", "anchors_json")

diffbutler/store/migrations/versions/0007_lifecycle.py

@@ -0,0 +1,36 @@
+"""Durable foreground ownership and exclusive cleanup claims."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0007"
+down_revision = "0006"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "foreground_lease",
+        sa.Column("token", sa.Uuid(), primary_key=True),
+        sa.Column(
+            "session_id", sa.Uuid(), sa.ForeignKey("review_session.id"), nullable=False, unique=True
+        ),
+        sa.Column("backend_session_id", sa.String(1024), nullable=False),
+        sa.Column("head_sha", sa.String(128), nullable=False),
+        sa.Column("task_version", sa.Integer(), nullable=False),
+        sa.Column("acquired_at", sa.DateTime(timezone=True), nullable=False),
+    )
+    op.create_table(
+        "cleanup_claim",
+        sa.Column("token", sa.Uuid(), primary_key=True),
+        sa.Column(
+            "job_id", sa.Uuid(), sa.ForeignKey("cleanup_job.id"), nullable=False, unique=True
+        ),
+        sa.Column("acquired_at", sa.DateTime(timezone=True), nullable=False),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("cleanup_claim")
+    op.drop_table("foreground_lease")

diffbutler/store/migrations/versions/0008_processes.py

@@ -0,0 +1,30 @@
+"""Durable pre-launch identity for conservative restart recovery."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0008"
+down_revision = "0007"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "process_launch",
+        sa.Column("token", sa.Uuid(), primary_key=True),
+        sa.Column("kind", sa.String(32), nullable=False),
+        sa.Column("host_id", sa.Uuid(), nullable=False),
+        sa.Column("boot_id", sa.Uuid(), nullable=False),
+        sa.Column("launcher_pid", sa.Integer(), nullable=True),
+        sa.CheckConstraint(
+            "kind IN ('background', 'foreground', 'cleanup')", name="operation_kind"
+        ),
+        sa.CheckConstraint(
+            "launcher_pid IS NULL OR launcher_pid > 0", name="positive_launcher_pid"
+        ),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("process_launch")

diffbutler/store/migrations/versions/0009_dashboard.py

@@ -0,0 +1,43 @@
+"""Retained forge receipts, cycle snapshots, and dashboard preferences."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0009"
+down_revision = "0008"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("review_task", sa.Column("snapshot_json", sa.JSON(), nullable=True))
+    op.add_column("pr_monitor", sa.Column("activity_json", sa.Text(), nullable=True))
+    op.add_column(
+        "pr_monitor",
+        sa.Column("refresh_pending", sa.Boolean(), nullable=False, server_default=sa.false()),
+    )
+    op.add_column(
+        "pr_monitor", sa.Column("notice", sa.String(255), nullable=False, server_default="")
+    )
+    op.create_table(
+        "observed_activity",
+        sa.Column("account_id", sa.Uuid(), sa.ForeignKey("account.id"), primary_key=True),
+        sa.Column("pull_request_id", sa.Uuid(), sa.ForeignKey("pull_request.id"), primary_key=True),
+        sa.Column("event_id", sa.String(255), primary_key=True),
+        sa.Column("review_task_id", sa.Uuid(), sa.ForeignKey("review_task.id"), nullable=False),
+        sa.Column("payload_json", sa.Text(), nullable=False),
+    )
+    op.create_table(
+        "ui_preference",
+        sa.Column("key", sa.String(255), primary_key=True),
+        sa.Column("value", sa.Text(), nullable=False),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("ui_preference")
+    op.drop_table("observed_activity")
+    op.drop_column("pr_monitor", "notice")
+    op.drop_column("pr_monitor", "refresh_pending")
+    op.drop_column("pr_monitor", "activity_json")
+    op.drop_column("review_task", "snapshot_json")

diffbutler/store/migrations/versions/0010_run_reasons.py

@@ -0,0 +1,17 @@
+"""Keep review failure and invalidation reasons across refreshes and cleanup."""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "0010"
+down_revision = "0009"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.add_column("ai_run", sa.Column("status_reason", sa.Text(), nullable=True))
+
+
+def downgrade() -> None:
+    op.drop_column("ai_run", "status_reason")

diffbutler/store/migrations/versions/__init__.py

@@ -0,0 +1 @@
+"""Immutable migration revisions."""