_cases.json

{
  "mcp-assistant-workflows": {
    "affects": [
      {
        "module": "mcp",
        "capability": "tool-groups"
      },
      {
        "module": "overview",
        "capability": "assistant-dashboard-snapshot"
      },
      {
        "module": "subscription",
        "capability": "batch-subscribe-by-codes"
      },
      {
        "module": "ical",
        "capability": "personal-calendar-subscription"
      },
      {
        "module": "todo",
        "capability": "todo-list"
      },
      {
        "module": "bus",
        "capability": "bus-dashboard"
      },
      {
        "module": "bus",
        "capability": "bus-route-search"
      },
      {
        "module": "bus",
        "capability": "bus-next-departures"
      }
    ],
    "rules": {
      "aggregate-first": [
        "Prefer get_my_dashboard or other task-oriented aggregate tools before stitching together multiple lower-level tool calls."
      ],
      "preview-before-write": [
        "Batch or fuzzy write flows should offer a read-only preview tool before the mutation tool."
      ],
      "focused-over-raw-for-common-questions": [
        "For prompts such as 'what is my next class?' or 'when is the next bus?', use focused extract tools instead of raw dataset mirrors."
      ],
      "summary-privacy-default": [
        "Summary/default outputs should stay compact and redact token-bearing URLs or repeated low-value nested objects."
      ]
    },
    "decisions": [
      "Assistant-oriented MCP additions should land as aggregate snapshots or filtered convenience tools, not only as raw dataset mirrors.",
      "Tool documentation should call out the preferred first tool, focused alternative, default parameters, and privacy redaction behavior for common prompts."
    ]
  },
  "semester": {
    "affects": [
      {
        "module": "overview",
        "capability": "authenticated-overview"
      },
      {
        "module": "subscription",
        "capability": "batch-subscribe-by-codes"
      },
      {
        "module": "subscribed-sections",
        "capability": "subscribed-sections-tab"
      }
    ],
    "rules": {
      "no-current-semester": [
        "The home page should display a recoverable empty state.",
        "Users should be guided to browse or import sections."
      ],
      "only-non-current-semester-subscriptions": [
        "The home page must not pretend to have current learning tasks.",
        "Must clearly indicate that no sections are subscribed for the current semester."
      ],
      "cross-semester-browsing": [
        "Courses must display semester.",
        "Sections must display semester.",
        "Homework must display semester.",
        "Exams must display semester."
      ]
    },
    "decisions": [
      "When the current semester does not exist, the home page should enter a recoverable empty state rather than rendering a misleading empty list.",
      "When only non-current-semester sections are subscribed, the user must be clearly told 'no content subscribed for the current semester' rather than pretending everything is normal."
    ]
  },
  "disambiguation": {
    "affects": [
      {
        "module": "course",
        "capability": "course-list"
      },
      {
        "module": "section",
        "capability": "section-list"
      },
      {
        "module": "subscription",
        "capability": "batch-subscribe-by-codes"
      }
    ],
    "rules": {
      "duplicate-course-names": [
        "Course code or other disambiguation information should be displayed."
      ],
      "multiple-sections-same-course": [
        "Section code and semester should be displayed."
      ],
      "required-disambiguation-contexts": [
        "Section search.",
        "Child sections in course detail.",
        "Batch import results."
      ]
    },
    "decisions": [
      "Whenever there is a risk of ambiguity, list views must prioritize displaying fields that help make a selection.",
      "Courses with the same name and multiple sections under the same course must not display only the course name.",
      "In cross-semester or multi-section scenarios, semester and section code are mandatory information to retain."
    ]
  },
  "missing-data": {
    "affects": [
      {
        "module": "schedule",
        "capability": "section-schedule"
      },
      {
        "module": "exam",
        "capability": "section-exam-info"
      },
      {
        "module": "homework",
        "capability": "section-homework-tab"
      },
      {
        "module": "ical"
      }
    ],
    "rules": {
      "section-missing-teacher-location-or-exam": [
        "A default empty state should be displayed.",
        "The entire object must not be hidden."
      ],
      "homework-no-due-date": [
        "Does not enter the 'upcoming due' sort.",
        "Can still be viewed in the homework list."
      ],
      "ical-no-events": [
        "A valid but empty or informational calendar content should be returned."
      ]
    },
    "decisions": [
      "When fields are missing, prefer showing a default empty state rather than hiding the entire object.",
      "Homework with no due date retains visibility but does not mix into upcoming due date sorting.",
      "When iCal has no events, a valid result should still be returned to prevent clients from failing on 'empty'."
    ]
  },
  "account": {
    "affects": [
      {
        "module": "user",
        "capability": "settings"
      },
      {
        "module": "user",
        "capability": "public-profile"
      }
    ],
    "rules": {
      "username-change": [
        "The new profile page should be accessible.",
        "The old username must not continue to represent the user."
      ],
      "oauth-connection-error": [
        "Duplicate OAuth connection should give a clear error response.",
        "Disconnecting the last account should give a clear error response."
      ],
      "account-deletion": [
        "The user must be required to enter a confirmation word.",
        "After successful deletion, the current session should be terminated and the settings page exited."
      ]
    },
    "decisions": [
      "After a username change, the new address should immediately become the canonical entry.",
      "The old username must not continue to represent the user for an extended period to avoid identity confusion.",
      "Disconnecting the last sign-in account is an error operation that must be blocked, not an ordinary failure-retry scenario.",
      "Account deletion carries higher risk than ordinary destructive operations; the current implementation requires entering the fixed confirmation word DELETE."
    ]
  },
  "content-security": {
    "affects": [
      {
        "module": "comment",
        "capability": "object-comment-section"
      },
      {
        "module": "upload",
        "capability": "comment-attachment-download"
      },
      {
        "module": "security",
        "capability": "destructive-action-confirmation"
      }
    ],
    "rules": {
      "suspended-user": ["Cannot post new comments."],
      "upload-attachment-download": ["Access permissions must be validated."],
      "destructive-actions": [
        "Deletion must have explicit feedback.",
        "Suspension must have explicit feedback.",
        "Hiding must have explicit feedback."
      ]
    },
    "decisions": [
      "Suspended users cannot post new comments; this restriction must hold at both the product layer and the permission layer.",
      "Upload attachment download must re-validate access permissions; it must not assume that having the link is sufficient to download.",
      "High-risk operations use explicit feedback mechanisms."
    ]
  }
}