refactor(server): standardize practice groups and feedback responses (#1539)

Author: FelixTJDietrich

.changeset/a-practice-says-why-it-has-nothing-to-say.md

@@ -4,4 +4,4 @@
 
 Your practice feedback now lists every practice your workspace reviews, not only the ones that raised something. A practice with nothing to report says which kind of nothing it is: either no review has reached it yet, or the reviews ran and your work offered no relevant occasion. Those are different answers to "how am I doing here", and until now both looked like an absent row. Practices with actual feedback still come first, worst first; the quiet ones sort to the end.
 
-An area's standing is now read straight off its practices, including the quiet ones, so the summary at the top of an area and the cards beneath it can no longer tell different stories.
+A group's standing is now read straight off its practices, including the quiet ones, so the summary at the top of a group and the practices beneath it can no longer tell different stories.

.changeset/a-trend-only-claims-what-it-can-show.md

@@ -3,5 +3,3 @@
 ---
 
 A comment written alongside "not helpful" is no longer lost. Explaining why a piece of feedback missed the mark, without also saying whether you addressed or disputed it, stored the text and then never showed it again — the next answer overwrote the reading with its own empty comment. The words now stay with the answer they came with.
-
-Areas whose practices carry different weights also stop overstating how sure they are: a weight above one made an area's trend read as a confident improvement or decline where the evidence only supported "uncertain".

.changeset/an-answer-keeps-the-words-that-came-with-it.md

@@ -6,6 +6,6 @@ Workspace administrators now choose which practices their workspace reviews, ins
 
 Adding never starts sending feedback on its own. A practice Hephaestus can review starts at **Review before sending**, and a practice it cannot review stays **Off** until you connect what it reads.
 
-You can also add a whole area at once. Hephaestus shows every practice it would add, reuse, or skip first, and applies the result in one step or not at all. Adding is refused if the library or your workspace changed while you were reading the preview, so you always act on what you saw.
+You can also add a whole group at once. Hephaestus shows every practice it would add, reuse, or skip first, and applies the result in one step or not at all. Adding is refused if the library or your workspace changed while you were reading the preview, so you always act on what you saw.
 
 Workspaces you already have keep everything in them, and a workspace that has never recorded a catalog installation still receives one at the next start, so nothing goes missing.

.changeset/an-undecided-review-still-shows-up.md

@@ -2,4 +2,4 @@
 "hephaestus": patch
 ---
 
-Feedback about a practice no longer disappears when a later review of the same work never got to that practice. A review that was skipped for partial evidence, refused, timed out or ran out of budget covers fewer practices than the one before it, and the untouched practices' earlier findings were being dropped as though the newer review had reconsidered them — so an interrupted review looked exactly like a fixed habit. A later review now replaces only what it actually re-examined. The same holds per person: a review that had something to say about one contributor no longer clears what an earlier one found about another. Re-reviewing the same work with the same practice still replaces the earlier verdict, as before.
+Feedback about a practice no longer disappears when a later review of the same work never got to that practice. A review that was skipped for partial evidence, refused, timed out or ran out of budget covers fewer practices than the one before it, and the untouched practices' earlier observations were being dropped as though the newer review had reconsidered them — so an interrupted review looked exactly like a fixed habit. A later review now replaces only what it actually re-examined. The same holds per person: a review that had something to say about one contributor no longer clears what an earlier one found about another. Re-reviewing the same work with the same practice still replaces the earlier verdict, as before.

.changeset/calm-practices-adopt.md

@@ -2,6 +2,6 @@
 "hephaestus": patch
 ---
 
-Creating or editing a practice area now lets you pick its icon and colour, the same way the instance library does. Left alone, both still follow the area's name.
+Creating or editing a practice group now lets you pick its icon and colour, the same way the instance library does. Left alone, both still follow the group's name.
 
 A practice's "What to look for" is written in markdown — the editor says so — and the read view now renders it. Headings, lists, emphasis and inline code used to reach you as literal `##` and `-` characters in one long paragraph of bold text.

.changeset/feedback-survives-an-interrupted-review.md

@@ -2,4 +2,4 @@
 "hephaestus": patch
 ---
 
-When the library changes while you are reading an area's plan, the panel now stays open and shows you the refreshed plan, the same way a single practice already did. It used to close and leave you a message asking you to go and look at the area again.
+When the library changes while you are reading a group's plan, the panel now stays open and shows you the refreshed plan, the same way a single practice already did. It used to close and leave you a message asking you to go and look at the group again.

…areas-get-an-icon-and-criteria-render.md …roups-get-an-icon-and-criteria-render.md.changeset/areas-get-an-icon-and-criteria-render.md renamed to .changeset/groups-get-an-icon-and-criteria-render.md .changeset/areas-get-an-icon-and-criteria-render.md renamed to .changeset/groups-get-an-icon-and-criteria-render.md

@@ -0,0 +1,7 @@
+---
+"hephaestus": minor
+---
+
+The application API can now answer where a developer stands in each practice group: the current standing and its guidance, how the group has developed across recently reviewed work, which kinds of work contributed feedback, a filterable observation history, and the complete review runs behind it. An undecided observation remains visible in that history without being presented as a verdict. Developers can also replace or delete their response to delivered feedback, recording whether it was helpful, how they handled it, and an optional explanation. Every endpoint answers only for the signed-in developer.
+
+**Operators:** direct API callers must replace `/practice-areas` with `/practice-groups`, use the corresponding group schema and field names, replace `/practices/learner` with `/practices/reviewed`, and move from the older reaction endpoint to the combined response endpoint. Existing response history is preserved; `MIGRATION.md` lists the contract changes. The generated Hephaestus web client is updated in the same release.