Platform Observability Tool¶

query_platform_observability projects bounded diagnostics from CodeClone's local observer store. It is intended only for CodeClone maintainers developing the product — not for users evaluating their analyzed repository.

Prerequisites

Observation is off by default. Set CODECLONE_OBSERVABILITY_ENABLED=1 on the CLI/MCP/worker process before reproduction. Without enablement the tool returns status=disabled or status=no_store and provides no repository-quality signal.

See Platform Observability for storage, privacy, configuration, and trust boundaries.

Parameters¶

Parameter	Contract
`root`	Absolute repository root.
`section`	One supported diagnostics section.
`detail_level`	`compact`, `normal`, or `full`; `full` currently downgrades to `normal`.
`limit`	Row cap, clamped to `1..50`.
`window`	`latest` or a correlation ID.
`operation_id`	Reserved; reported in `ignored_parameters`.
`span_id`	Reserved; reported in `ignored_parameters`.

Supported sections:

summary
slow_operations
memory_pipeline_cost
db_cost
agent_context
mcp_tool_matrix
correlated_chains
costly_noops
pipeline

Each call returns one section only. Compact detail is bounded to five rows; normal detail is bounded by limit.

Inert states¶

When observability is disabled, the tool returns a disabled status. When no local store exists, it returns a no-store status. Neither state changes analysis behavior.

An invalid section returns the available section names. Reserved parameters are echoed as ignored instead of changing the projection.

Interpretation boundary¶

The envelope states that:

the audience is CodeClone development;
the data is not user-facing repository quality evidence;
it does not affect reports, gates, baselines, memory facts, or edit authorization;
reported heuristics are diagnostic hints, not findings.

This anti-inference boundary is part of the tool contract. See Determinism and tests and the diagnostics guide.