generated from coulomb/repo-seed
tegwick
b3a44fb4f3
Adds a structured dispute mechanism when capability request routing is wrong:
- New `routing_disputed` status with four DB columns (dispute_reason, disputed_by,
dispute_suggested_domain, disputed_at) via Alembic migration m0h1i2j3k4l5
- POST /capability-requests/{id}/dispute — any party can flag misrouting with a reason
and optional suggested domain; notifies custodian + current fulfilling domain
- POST /capability-requests/{id}/reroute — custodian re-routes to correct domain via
catalog_entry_id or direct slug; appends audit trail to routing_note; resets to requested
- Two new MCP tools: dispute_capability_routing and reroute_capability_request
- Dashboard: amber disputed-banner at top of Summary, routing_disputed Kanban column,
dispute details (reason, suggested domain, raised-by) shown on disputed cards
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
105 lines
3.0 KiB
Python
105 lines
3.0 KiB
Python
import uuid
|
|
from datetime import datetime
|
|
|
|
from pydantic import BaseModel, ConfigDict
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Capability Catalog schemas
|
|
# ---------------------------------------------------------------------------
|
|
|
|
class CatalogCreate(BaseModel):
|
|
domain: str # slug, resolved to domain_id in router
|
|
capability_type: str
|
|
title: str
|
|
description: str | None = None
|
|
keywords: list[str] = []
|
|
|
|
|
|
class CatalogRead(BaseModel):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
id: uuid.UUID
|
|
domain_slug: str
|
|
capability_type: str
|
|
title: str
|
|
description: str | None = None
|
|
keywords: list[str] = []
|
|
status: str
|
|
created_at: datetime
|
|
updated_at: datetime
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Capability Request schemas
|
|
# ---------------------------------------------------------------------------
|
|
|
|
class CapabilityRequestCreate(BaseModel):
|
|
title: str
|
|
description: str | None = None
|
|
capability_type: str
|
|
priority: str = "medium"
|
|
requesting_domain: str # slug, resolved to domain_id in router
|
|
requesting_agent: str
|
|
requesting_workstream_id: uuid.UUID | None = None
|
|
blocking_task_id: uuid.UUID | None = None
|
|
|
|
|
|
class CapabilityRequestAccept(BaseModel):
|
|
fulfilling_agent: str
|
|
fulfilling_workstream_id: uuid.UUID | None = None
|
|
|
|
|
|
class CapabilityRequestStatusPatch(BaseModel):
|
|
status: str # in_progress | ready_for_review | completed | rejected | withdrawn
|
|
note: str | None = None
|
|
|
|
|
|
class CapabilityRequestPatch(BaseModel):
|
|
catalog_entry_id: uuid.UUID | None = None
|
|
priority: str | None = None
|
|
blocking_task_id: uuid.UUID | None = None
|
|
fulfilling_workstream_id: uuid.UUID | None = None
|
|
|
|
|
|
class CapabilityRequestDispute(BaseModel):
|
|
reason: str
|
|
disputed_by: str
|
|
suggested_domain: str | None = None
|
|
|
|
|
|
class CapabilityRequestReroute(BaseModel):
|
|
note: str
|
|
rerouted_by: str
|
|
domain: str | None = None # slug — used if catalog_entry_id not given
|
|
catalog_entry_id: uuid.UUID | None = None # preferred: re-derives domain
|
|
|
|
|
|
class CapabilityRequestRead(BaseModel):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
id: uuid.UUID
|
|
title: str
|
|
description: str | None = None
|
|
capability_type: str
|
|
priority: str
|
|
status: str
|
|
requesting_domain_slug: str
|
|
requesting_agent: str
|
|
requesting_workstream_id: uuid.UUID | None = None
|
|
fulfilling_domain_slug: str | None = None
|
|
fulfilling_agent: str | None = None
|
|
fulfilling_workstream_id: uuid.UUID | None = None
|
|
blocking_task_id: uuid.UUID | None = None
|
|
catalog_entry_id: uuid.UUID | None = None
|
|
resolution_note: str | None = None
|
|
routing_note: str | None = None
|
|
dispute_reason: str | None = None
|
|
disputed_by: str | None = None
|
|
dispute_suggested_domain: str | None = None
|
|
disputed_at: datetime | None = None
|
|
accepted_at: datetime | None = None
|
|
completed_at: datetime | None = None
|
|
created_at: datetime
|
|
updated_at: datetime
|