feat(goals): add domain/repo goal tracking and update_workstream MCP tool

- Migration c5d6e7f8a9b0: domain_goals and repo_goals tables, repo_goal_id FK on workstreams
- DomainGoal: one active per domain (partial unique index), status active/archived/superseded
- RepoGoal: integer priority, status active/paused/completed/archived, optional domain_goal_id link
- WorkstreamUpdate schema and router extended with repo_goal_id and repo_goal_id filter
- 6 new MCP goal tools: create_domain_goal, get_domain_goals, activate_domain_goal, create_repo_goal, get_repo_goals, update_repo_goal
- update_workstream MCP tool: patch any subset of workstream fields (title, description, owner, due_date, repo_goal_id, status)
- get_domain_summary extended with goal_guidance (needs_workplan, alignment_warnings) signals
- Dashboard goals.md page and docs/goals.md reference page
- CLAUDE.md template updated to act on goal_guidance signals at session start
- CUST-WP-0010 workplan for this feature

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

api/models/__init__.py

@@ -1,6 +1,9 @@
 from api.models.base import Base
 from api.models.domain import Domain
+from api.models.domain_goal import DomainGoal, DomainGoalStatus
 from api.models.topic import Topic, TopicStatus
+from api.models.managed_repo import ManagedRepo
+from api.models.repo_goal import RepoGoal, RepoGoalStatus
 from api.models.workstream import Workstream, WorkstreamStatus
 from api.models.workstream_dependency import WorkstreamDependency
 from api.models.task import Task, TaskStatus, TaskPriority
@@ -8,7 +11,6 @@ from api.models.decision import Decision, DecisionType, DecisionStatus
 from api.models.progress_event import ProgressEvent
 from api.models.extension_point import ExtensionPoint, EPStatus
 from api.models.technical_debt import TechnicalDebt, TDStatus
-from api.models.managed_repo import ManagedRepo
 from api.models.contribution import Contribution, ContributionType, ContributionStatus
 from api.models.sbom_snapshot import SBOMSnapshot
 from api.models.sbom_entry import SBOMEntry, Ecosystem
@@ -16,7 +18,10 @@ from api.models.sbom_entry import SBOMEntry, Ecosystem
 __all__ = [
     "Base",
     "Domain",
+    "DomainGoal", "DomainGoalStatus",
     "Topic", "TopicStatus",
+    "ManagedRepo",
+    "RepoGoal", "RepoGoalStatus",
     "Workstream", "WorkstreamStatus",
     "WorkstreamDependency",
     "Task", "TaskStatus", "TaskPriority",
@@ -24,7 +29,6 @@ __all__ = [
     "ProgressEvent",
     "ExtensionPoint", "EPStatus",
     "TechnicalDebt", "TDStatus",
-    "ManagedRepo",
     "Contribution", "ContributionType", "ContributionStatus",
     "SBOMSnapshot",
     "SBOMEntry", "Ecosystem",

api/models/domain.py

@@ -24,3 +24,6 @@ class Domain(Base, TimestampMixin):
     repos: Mapped[list["ManagedRepo"]] = relationship(  # noqa: F821
         "ManagedRepo", back_populates="domain", lazy="selectin"
     )
+    goals: Mapped[list["DomainGoal"]] = relationship(  # noqa: F821
+        "DomainGoal", back_populates="domain", lazy="selectin"
+    )

api/models/domain_goal.py

@@ -0,0 +1,41 @@
+import enum
+import uuid
+
+from sqlalchemy import ForeignKey, String, Text
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from api.models.base import Base, TimestampMixin, new_uuid
+
+
+class DomainGoalStatus(str, enum.Enum):
+    active = "active"
+    archived = "archived"
+    superseded = "superseded"
+
+
+class DomainGoal(Base, TimestampMixin):
+    __tablename__ = "domain_goals"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    domain_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("domains.id", ondelete="RESTRICT"), nullable=False, index=True
+    )
+    title: Mapped[str] = mapped_column(String(500), nullable=False)
+    description: Mapped[str] = mapped_column(Text, nullable=False)
+    status: Mapped[str] = mapped_column(
+        String(20), nullable=False, default=DomainGoalStatus.active.value, server_default="active"
+    )
+
+    domain: Mapped["Domain"] = relationship(  # noqa: F821
+        "Domain", back_populates="goals", lazy="selectin"
+    )
+    repo_goals: Mapped[list["RepoGoal"]] = relationship(  # noqa: F821
+        "RepoGoal", back_populates="domain_goal", lazy="selectin"
+    )
+
+    @property
+    def domain_slug(self) -> str:
+        return self.domain.slug if self.domain is not None else ""

api/models/managed_repo.py

@@ -35,6 +35,10 @@ class ManagedRepo(Base, TimestampMixin):
         "Domain", back_populates="repos", lazy="selectin"
     )
 
+    goals: Mapped[list["RepoGoal"]] = relationship(  # noqa: F821
+        "RepoGoal", back_populates="repo", lazy="selectin"
+    )
+
     @property
     def domain_slug(self) -> str:
         return self.domain.slug if self.domain is not None else ""

api/models/repo_goal.py

@@ -0,0 +1,49 @@
+import enum
+import uuid
+
+from sqlalchemy import ForeignKey, Integer, String, Text
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+
+from api.models.base import Base, TimestampMixin, new_uuid
+
+
+class RepoGoalStatus(str, enum.Enum):
+    active = "active"
+    paused = "paused"
+    completed = "completed"
+    archived = "archived"
+
+
+class RepoGoal(Base, TimestampMixin):
+    __tablename__ = "repo_goals"
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), primary_key=True, default=new_uuid
+    )
+    repo_id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("managed_repos.id", ondelete="RESTRICT"), nullable=False, index=True
+    )
+    domain_goal_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True), ForeignKey("domain_goals.id", ondelete="SET NULL"), nullable=True, index=True
+    )
+    title: Mapped[str] = mapped_column(String(500), nullable=False)
+    description: Mapped[str] = mapped_column(Text, nullable=False)
+    priority: Mapped[int] = mapped_column(Integer, nullable=False, default=100, server_default="100")
+    status: Mapped[str] = mapped_column(
+        String(20), nullable=False, default=RepoGoalStatus.active.value, server_default="active"
+    )
+
+    repo: Mapped["ManagedRepo"] = relationship(  # noqa: F821
+        "ManagedRepo", back_populates="goals", lazy="selectin"
+    )
+    domain_goal: Mapped["DomainGoal"] = relationship(  # noqa: F821
+        "DomainGoal", back_populates="repo_goals", lazy="selectin"
+    )
+    workstreams: Mapped[list["Workstream"]] = relationship(  # noqa: F821
+        "Workstream", back_populates="repo_goal", lazy="selectin"
+    )
+
+    @property
+    def repo_slug(self) -> str:
+        return self.repo.slug if self.repo is not None else ""

api/models/workstream.py

@@ -40,9 +40,16 @@ class Workstream(Base, TimestampMixin):
         nullable=True,
         index=True,
     )
+    repo_goal_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("repo_goals.id", ondelete="SET NULL"),
+        nullable=True,
+        index=True,
+    )
 
     topic: Mapped["Topic"] = relationship("Topic", back_populates="workstreams")  # noqa: F821
     repo: Mapped["ManagedRepo"] = relationship("ManagedRepo", lazy="selectin")  # noqa: F821
+    repo_goal: Mapped["RepoGoal"] = relationship("RepoGoal", back_populates="workstreams", lazy="selectin")  # noqa: F821
     tasks: Mapped[list["Task"]] = relationship(  # noqa: F821
         "Task", back_populates="workstream", lazy="selectin"
     )