# Evidence: Block 3 · Foundational (block-3)

- block type: block
- date: 2026-08-15
- resulting state: closed/verified
- story points (combined assembled cost): 4166
- execution id: 20260815.172349.042Z-3e42d88f

## Stories built
- Define shared presentation patterns for the reading-list interface. (ui-general) [story]

## Reusable compacts
- UI-GENERAL_compact.md

## Stacked context
- compass: COMPASS.md (SP 724)
- implements: UI-GENERAL.md (SP 759)
- stack: python_compact.md (SP 1534)
- stack: flask_compact.md (SP 1083)

## Build directory changes
- app/routes.py
- app/static/css/style.css
- app/templates/index.html
- tests/test_routes.py

## Pre-build acceptance observation
- RED: ui-patterns-form (UI-GENERAL.md)
  intent: The shared presentation includes labeled title and author controls and a submission control.
  return code: 1
  stderr:
    Traceback (most recent call last):
      File "ui-patterns-form.py", line 8, in <module>
        assert 'name="title"' in body
               ^^^^^^^^^^^^^^^^^^^^^^
    AssertionError
- GREEN (prepassed): ui-patterns-empty-state (UI-GENERAL.md)
  intent: The shared presentation provides a reader-visible empty-list state.
  return code: 0
- RED: ui-patterns-removal-control (UI-GENERAL.md)
  intent: The shared presentation provides a removal control for a listed book.
  return code: 1
  stderr:
    Traceback (most recent call last):
      File "ui-patterns-removal-control.py", line 8, in <module>
        assert response.status_code in (302, 303)
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    AssertionError

## Post-build programmatic acceptance
- PASS: ui-patterns-form (UI-GENERAL.md)
  intent: The shared presentation includes labeled title and author controls and a submission control.
  target interpreter: /mnt/c/Users/barlo/projects/drydock/uat/ReadingList/runs/20260815.171255/build/ReadingList/.venv/bin/python
  provisioning: not required
  return code: 0
- PASS: ui-patterns-empty-state (UI-GENERAL.md)
  intent: The shared presentation provides a reader-visible empty-list state.
  target interpreter: /mnt/c/Users/barlo/projects/drydock/uat/ReadingList/runs/20260815.171255/build/ReadingList/.venv/bin/python
  provisioning: not required
  return code: 0
- PASS: ui-patterns-removal-control (UI-GENERAL.md)
  intent: The shared presentation provides a removal control for a listed book.
  target interpreter: /mnt/c/Users/barlo/projects/drydock/uat/ReadingList/runs/20260815.171255/build/ReadingList/.venv/bin/python
  provisioning: not required
  return code: 0

## Build summary
<reusable-compact filename="UI-GENERAL.md">
- Single responsive reading-list screen with heading, required title/author form, submit control, ordered book list, per-book removal controls, empty state, and visible validation errors.
- Controls require labels and stable names; removal targets must use book identity, not position.
- Preserve insertion order and display understandable missing-field errors.
- CSS must provide readable typography, focus states, contrast, spacing, and responsive narrow-screen layout.
- Acceptance: GET `/` includes `name="title"`, `name="author"`, and a form; empty state mentions reading plus empty/no books; POST `/books` then GET `/` shows title, author, and removal control.
</reusable-compact>

RESULT: SUCCESS

FILES CHANGED:
- app/routes.py
- app/templates/index.html
- app/static/css/style.css
- tests/test_routes.py

SUMMARY:
Implemented the accessible reading-list presentation, add/remove routes, validation alert, empty state, responsive styling, and acceptance-focused tests. Full suite passes: 18 tests. Ruff checks pass.

BLOCKERS:
- None.