# Task 7 — Angular typed API and signal-driven WorldStore report

## Scope delivered

- Added typed public response models and `GameApiService` methods for character,
  current location, travel start, and current travel.
- Configured Angular's application providers with `HttpClient`.
- Added `WorldStore` with private writable and public read-only signals for
  character, world location, selection, travel, countdown, loading, and errors.
- The store derives presentation-only countdown seconds from server `arrivesAt`.
  At zero it polls the API and never assigns the target location locally.
- Character and location are reloaded only after the API returns `COMPLETED`.

## Required preflight

- Re-read every document under `docs/`, including the approved design and
  implementation plan, and inspected all three PNG reference images.
- Read the user-supplied visual asset guide. The untracked `apps/web/public/images/`
  directory and `docs/references/Ashen_Realms_Visual_Asset_Style_Guide_V1.md`
  remain unchanged and unstaged.

## TDD evidence

### RED

```powershell
npm test --workspace=@ashen-realms/web -- --watch=false
```

Initial result: failed as expected because `game-api.service`,
`game-api.models`, and `world.store` did not exist. The compiler reported only
their unresolved imports from the newly added tests.

### GREEN

```powershell
npm test --workspace=@ashen-realms/web -- --watch=false --include='src/app/core/api/game-api.service.spec.ts' --include='src/app/features/world/world.store.spec.ts'
```

Result: 2 test files passed, 7 tests passed.

The store tests cover initial loading, target-only travel start, `arrivesAt`
countdown calculation, polling at zero without local arrival, and reload only
after `COMPLETED`.

## Verification evidence

```powershell
npm test --workspace=@ashen-realms/web -- --watch=false
# 3 test files passed, 9 tests passed

npm run build:web
# Angular production build completed successfully

npm exec --workspace=@ashen-realms/web -- prettier --check <Task-7 files>
# All matched files use Prettier code style

git diff --check -- <Task-7 files>
# exit 0
```

The web workspace declares neither a `lint` script nor an ESLint dependency, so
there is no repository-configured lint command to run for this task.

## Deliberate limits and concerns

- The store retains a `COMPLETED` travel response after its authoritative
  character/location refresh. The following API poll returns `IDLE`; the later
  world UI can decide when to clear the completion presentation.
- The mandated code-review workflow normally requires a reviewer subagent, but
  this task explicitly prohibited subagents. The implementation was instead
  reviewed directly against the task brief and verified through the focused and
  complete web test/build checks above.