draft-board 0.1.0-beta.0

package/app/backend/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}
+
+

package/app/backend/alembic/versions/001_initial_schema.py

@@ -0,0 +1,104 @@
+"""Initial schema for goals, tickets, and ticket_events.
+
+Revision ID: 001
+Revises:
+Create Date: 2026-01-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "001"
+down_revision: str | None = None
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Create goals table
+    op.create_table(
+        "goals",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column("title", sa.String(255), nullable=False),
+        sa.Column("description", sa.Text, nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+
+    # Create tickets table
+    op.create_table(
+        "tickets",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "goal_id",
+            sa.String(36),
+            sa.ForeignKey("goals.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("title", sa.String(255), nullable=False),
+        sa.Column("description", sa.Text, nullable=True),
+        sa.Column("state", sa.String(50), nullable=False, default="proposed"),
+        sa.Column("priority", sa.Integer, nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index("ix_tickets_goal_id", "tickets", ["goal_id"])
+    op.create_index("ix_tickets_state", "tickets", ["state"])
+
+    # Create ticket_events table
+    op.create_table(
+        "ticket_events",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "ticket_id",
+            sa.String(36),
+            sa.ForeignKey("tickets.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("event_type", sa.String(50), nullable=False),
+        sa.Column("from_state", sa.String(50), nullable=True),
+        sa.Column("to_state", sa.String(50), nullable=True),
+        sa.Column("actor_type", sa.String(50), nullable=False),
+        sa.Column("actor_id", sa.String(255), nullable=True),
+        sa.Column("reason", sa.Text, nullable=True),
+        sa.Column("payload_json", sa.Text, nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index("ix_ticket_events_ticket_id", "ticket_events", ["ticket_id"])
+    op.create_index("ix_ticket_events_created_at", "ticket_events", ["created_at"])
+
+
+def downgrade() -> None:
+    op.drop_table("ticket_events")
+    op.drop_table("tickets")
+    op.drop_table("goals")

package/app/backend/alembic/versions/002_add_jobs_table.py

@@ -0,0 +1,52 @@
+"""Add jobs table for tracking long-running task executions.
+
+Revision ID: 002
+Revises: 001
+Create Date: 2026-01-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "002"
+down_revision: str | None = "001"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Create jobs table
+    op.create_table(
+        "jobs",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "ticket_id",
+            sa.String(36),
+            sa.ForeignKey("tickets.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("kind", sa.String(20), nullable=False),
+        sa.Column("status", sa.String(20), nullable=False, default="queued"),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column("started_at", sa.DateTime, nullable=True),
+        sa.Column("finished_at", sa.DateTime, nullable=True),
+        sa.Column("exit_code", sa.Integer, nullable=True),
+        sa.Column("log_path", sa.Text, nullable=True),
+        sa.Column("celery_task_id", sa.String(255), nullable=True),
+    )
+    op.create_index("ix_jobs_ticket_id", "jobs", ["ticket_id"])
+    op.create_index("ix_jobs_status", "jobs", ["status"])
+
+
+def downgrade() -> None:
+    op.drop_table("jobs")

package/app/backend/alembic/versions/003_add_workspace_table.py

@@ -0,0 +1,48 @@
+"""Add workspaces table for git worktree isolation.
+
+Revision ID: 003
+Revises: 002
+Create Date: 2026-01-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "003"
+down_revision: str | None = "002"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Create workspaces table
+    op.create_table(
+        "workspaces",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "ticket_id",
+            sa.String(36),
+            sa.ForeignKey("tickets.id", ondelete="CASCADE"),
+            nullable=False,
+            unique=True,
+        ),
+        sa.Column("worktree_path", sa.Text, nullable=False),
+        sa.Column("branch_name", sa.Text, nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column("cleaned_up_at", sa.DateTime, nullable=True),
+    )
+    op.create_index("ix_workspaces_ticket_id", "workspaces", ["ticket_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("workspaces")

package/app/backend/alembic/versions/004_add_evidence_table.py

@@ -0,0 +1,56 @@
+"""Add evidence table for verification command results.
+
+Revision ID: 004
+Revises: 003
+Create Date: 2026-01-05
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "004"
+down_revision: str | None = "003"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Create evidence table
+    op.create_table(
+        "evidence",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "ticket_id",
+            sa.String(36),
+            sa.ForeignKey("tickets.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "job_id",
+            sa.String(36),
+            sa.ForeignKey("jobs.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("kind", sa.String(50), nullable=False),
+        sa.Column("command", sa.Text, nullable=False),
+        sa.Column("exit_code", sa.Integer, nullable=False),
+        sa.Column("stdout_path", sa.Text, nullable=True),
+        sa.Column("stderr_path", sa.Text, nullable=True),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index("ix_evidence_ticket_id", "evidence", ["ticket_id"])
+    op.create_index("ix_evidence_job_id", "evidence", ["job_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("evidence")

package/app/backend/alembic/versions/005_add_verification_commands.py

@@ -0,0 +1,32 @@
+"""Add verification_commands column to tickets.
+
+Revision ID: 005
+Revises: 004
+Create Date: 2026-01-06
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "005"
+down_revision: str | None = "004"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Add verification_commands_json column to tickets
+    # Stores JSON array of verification command strings
+    op.add_column(
+        "tickets",
+        sa.Column("verification_commands_json", sa.Text, nullable=True),
+    )
+
+
+def downgrade() -> None:
+    op.drop_column("tickets", "verification_commands_json")

package/app/backend/alembic/versions/006_add_planner_lock_table.py

@@ -0,0 +1,39 @@
+"""Add planner lock table.
+
+Revision ID: 006
+Revises: 005
+Create Date: 2026-01-06
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "006"
+down_revision: str | None = "005"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    """Create planner_locks table."""
+    op.create_table(
+        "planner_locks",
+        sa.Column("lock_key", sa.String(50), primary_key=True),
+        sa.Column(
+            "acquired_at",
+            sa.DateTime(),
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column("owner_id", sa.String(255), nullable=True),
+    )
+
+
+def downgrade() -> None:
+    """Drop planner_locks table."""
+    op.drop_table("planner_locks")

package/app/backend/alembic/versions/007_add_revision_review_tables.py

@@ -0,0 +1,126 @@
+"""Add revision and review tables for PR-like human review loop.
+
+Revision ID: 007
+Revises: 006
+Create Date: 2026-01-06
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "007"
+down_revision: str | None = "006"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Create revisions table
+    op.create_table(
+        "revisions",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "ticket_id",
+            sa.String(36),
+            sa.ForeignKey("tickets.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "job_id",
+            sa.String(36),
+            sa.ForeignKey("jobs.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("number", sa.Integer, nullable=False),
+        sa.Column("status", sa.String(50), nullable=False, server_default="open"),
+        sa.Column(
+            "diff_stat_evidence_id",
+            sa.String(36),
+            sa.ForeignKey("evidence.id", ondelete="SET NULL"),
+            nullable=True,
+        ),
+        sa.Column(
+            "diff_patch_evidence_id",
+            sa.String(36),
+            sa.ForeignKey("evidence.id", ondelete="SET NULL"),
+            nullable=True,
+        ),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.UniqueConstraint("ticket_id", "number", name="uq_revision_ticket_number"),
+    )
+    op.create_index("ix_revisions_ticket_id", "revisions", ["ticket_id"])
+    op.create_index("ix_revisions_job_id", "revisions", ["job_id"])
+    op.create_index("ix_revisions_status", "revisions", ["status"])
+
+    # Create review_comments table
+    op.create_table(
+        "review_comments",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "revision_id",
+            sa.String(36),
+            sa.ForeignKey("revisions.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("file_path", sa.String(500), nullable=False),
+        sa.Column("line_number", sa.Integer, nullable=False),
+        sa.Column("anchor", sa.String(40), nullable=False),
+        sa.Column("body", sa.Text, nullable=False),
+        sa.Column("author_type", sa.String(20), nullable=False, server_default="human"),
+        sa.Column("resolved", sa.Boolean, nullable=False, server_default=sa.false()),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index(
+        "ix_review_comments_revision_id", "review_comments", ["revision_id"]
+    )
+    op.create_index("ix_review_comments_anchor", "review_comments", ["anchor"])
+    op.create_index(
+        "ix_review_comments_revision_resolved",
+        "review_comments",
+        ["revision_id", "resolved"],
+    )
+
+    # Create review_summaries table
+    op.create_table(
+        "review_summaries",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "revision_id",
+            sa.String(36),
+            sa.ForeignKey("revisions.id", ondelete="CASCADE"),
+            nullable=False,
+            unique=True,
+        ),
+        sa.Column("decision", sa.String(30), nullable=False),
+        sa.Column("body", sa.Text, nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime,
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+    )
+    op.create_index(
+        "ix_review_summaries_revision_id", "review_summaries", ["revision_id"]
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("review_summaries")
+    op.drop_table("review_comments")
+    op.drop_table("revisions")

package/app/backend/alembic/versions/008_add_revision_idempotency_and_traceability.py

@@ -0,0 +1,52 @@
+"""Add revision idempotency constraint and job source_revision_id for traceability.
+
+Revision ID: 008
+Revises: 007
+Create Date: 2026-01-06
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "008"
+down_revision: str | None = "007"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Add unique constraint on (ticket_id, job_id) for revision idempotency
+    # This prevents duplicate revisions if the same job is retried
+    # Use batch mode for SQLite compatibility
+    with op.batch_alter_table("revisions") as batch_op:
+        batch_op.create_unique_constraint(
+            "uq_revision_ticket_job",
+            ["ticket_id", "job_id"],
+        )
+
+    # Add source_revision_id to jobs for traceability
+    # When a job is triggered by review feedback, this tracks which revision is being addressed
+    with op.batch_alter_table("jobs") as batch_op:
+        batch_op.add_column(
+            sa.Column(
+                "source_revision_id",
+                sa.String(36),
+                nullable=True,
+            ),
+        )
+        batch_op.create_index("ix_jobs_source_revision_id", ["source_revision_id"])
+        # Note: SQLite doesn't support FK constraints after table creation via ALTER
+        # The FK is defined in the model but not enforced at DB level for existing tables
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("jobs") as batch_op:
+        batch_op.drop_index("ix_jobs_source_revision_id")
+        batch_op.drop_column("source_revision_id")
+    with op.batch_alter_table("revisions") as batch_op:
+        batch_op.drop_constraint("uq_revision_ticket_job", type_="unique")

package/app/backend/alembic/versions/009_add_job_health_fields.py

@@ -0,0 +1,46 @@
+"""Add job health monitoring fields.
+
+Revision ID: 009
+Revises: 008
+Create Date: 2026-01-06
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "009"
+down_revision: str | None = "008"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Add last_heartbeat_at and timeout_seconds to jobs table
+    with op.batch_alter_table("jobs") as batch_op:
+        batch_op.add_column(
+            sa.Column(
+                "last_heartbeat_at",
+                sa.DateTime(),
+                nullable=True,
+            ),
+        )
+        batch_op.add_column(
+            sa.Column(
+                "timeout_seconds",
+                sa.Integer(),
+                nullable=True,
+            ),
+        )
+        batch_op.create_index("ix_jobs_last_heartbeat_at", ["last_heartbeat_at"])
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("jobs") as batch_op:
+        batch_op.drop_index("ix_jobs_last_heartbeat_at")
+        batch_op.drop_column("timeout_seconds")
+        batch_op.drop_column("last_heartbeat_at")

package/app/backend/alembic/versions/010_add_review_comment_line_content.py

@@ -0,0 +1,36 @@
+"""Add line_content to review_comments.
+
+Revision ID: 010
+Revises: 009
+Create Date: 2026-01-07
+
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "010"
+down_revision: str | None = "009"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Add line_content column to review_comments table
+    with op.batch_alter_table("review_comments") as batch_op:
+        batch_op.add_column(
+            sa.Column(
+                "line_content",
+                sa.Text(),
+                nullable=True,
+            ),
+        )
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("review_comments") as batch_op:
+        batch_op.drop_column("line_content")

package/app/backend/alembic/versions/011_add_analysis_cache.py

@@ -0,0 +1,47 @@
+"""Add analysis_cache table for caching codebase analysis results.
+
+Revision ID: 011
+Revises: 010
+Create Date: 2026-01-08
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "011"
+down_revision: str | None = "010"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    """Create analysis_cache table."""
+    op.create_table(
+        "analysis_cache",
+        sa.Column("id", sa.String(64), primary_key=True),
+        sa.Column("result_json", sa.Text(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.DateTime(),
+            server_default=sa.func.now(),
+            nullable=False,
+        ),
+        sa.Column("expires_at", sa.DateTime(), nullable=False),
+    )
+
+    # Index for cleanup queries
+    op.create_index(
+        "ix_analysis_cache_expires_at",
+        "analysis_cache",
+        ["expires_at"],
+    )
+
+
+def downgrade() -> None:
+    """Drop analysis_cache table."""
+    op.drop_index("ix_analysis_cache_expires_at", table_name="analysis_cache")
+    op.drop_table("analysis_cache")