---
title: "Reports Search Workbench"
status: "stable"
source_status: "user-confirmed"
last_reviewed_utc: "2026-06-05T00:00:00Z"
mapped_uai_memory: ".uai/reports-search-workbench.uai"
---

# Reports Search Workbench

The `/reports/` page is a research-only research-search workbench for visitors and AI assistants working on MikeKappel.com.

## Purpose

The report archive is a retrieval layer for background reports, prompts, audits, and exploratory research. It is intentionally **not** the same layer as `/docs/` long-term memory.

## Search capabilities

- Local browser search over `/reports/search-index.json`.
- Category facets and topic tags.
- Sort modes for relevance, title, category, word count, and reading time.
- Display modes for cards, list, and dense review.
- Browser-side raw Markdown preview.
- Copyable result links and AI assistant research packets.
- URL-state support with `q`, `category`, `match`, `sort`, `limit`, and `view` parameters.
- REST discovery through `/wp-json/mk/v1/report-search`.

## Boundary

Reports are raw research references. They may be useful for discovery, but they can contain obsolete, speculative, generated, conflicting, or quarantined material.

Keep a report-derived claim into resume copy, page copy, project metadata, `/docs/`, static JSON, REST output, or SEO-facing content until evidence review review approves it.

## Agent use

Agents may use the archive to:

1. search for prior research,
2. cite report filenames and raw URLs,
3. summarize report candidates for human review,
4. propose promotion into `/docs/` with implementation context.

Agents must not treat research archive items as approved truth.
