# Confluence System Info & Cross-Entity Search — Agent Guidance

Covers `src/tools/system.ts` (7 tools) — audit records, cluster status, instance metrics,
long-running task tracking, cross-entity search, and server information. All read-only, all
confirmed live 2026-08-20; see `docs/plans/2026-08-20-full-api-coverage.md` batch 14.

## `search_entities` vs. `search_content`

`search_content` (`skill://spaces-pages`) is content-only — pages, blog posts, comments. `search_entities`
uses the same CQL syntax but searches **across entity types**: content, spaces, and users all
appear in one result set, distinguished by `entityType`. Confirmed live: a query for `space = CAS`
returned the space itself, its pages, comments, and attachments together — reach for
`search_entities` when a caller's request isn't obviously content-scoped, or when they want spaces/
users in the same query.

## `admin_list_long_tasks` is a genuinely useful audit trail

It surfaces recently completed background operations instance-wide — user deletion, space removal,
bulk page delete, backup jobs, and more — each with a human-readable `name.translation` and
`messages`. Useful for confirming an async operation (space deletion, bulk delete, backup) actually
finished, beyond just polling that operation's own status endpoint if one exists.

## `admin_get_cluster_node_statuses` returns empty on a single-node instance

Not an error — a non-clustered Data Center instance (like this project's own debug stack) simply
has no cluster nodes to report. An empty result here means "not clustered," not "request failed."

## `get_server_information` is the fastest way to confirm what you're talking to

Returns `version`/`buildNumber`/`buildDate` — useful as a first call when debugging whether a tool
is behaving differently than documented (this project's own vendored OpenAPI spec is pinned to a
specific point release; if the live instance's version differs, check
`docs/plans/2026-08-20-full-api-coverage.md`'s spec-sourcing note for how to re-pull a matching
spec).