docs(analysis): clarify unbounded page analysis cost

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: tae2089

internal/analysis/changes/service.go

@@ -84,7 +84,8 @@ func (s *Service) Analyze(ctx context.Context, repoDir, baseRef string) ([]RiskE
 }
 
 // AnalyzePage detects changed functions and returns one bounded page of risk entries.
-// @intent push pagination into the change-risk service so handlers expose stable limit/offset windows.
+// @intent bound the response size for handlers while Analyze still materializes the full risk list before slicing.
+// @domainRule pagination limits returned items, but compute cost still scales with the full diff-to-risk pipeline.
 // @domainRule entries are sorted by descending risk_score, then file_path, then qualified_name for stable ordering.
 func (s *Service) AnalyzePage(ctx context.Context, repoDir, baseRef string, req paging.Request) (Result, error) {
 	normalized, err := paging.Normalize(req)

internal/analysis/coupling/service.go

@@ -118,7 +118,8 @@ func (s *Service) Analyze(ctx context.Context) ([]CouplingPair, error) {
 }
 
 // AnalyzePage returns one bounded page of coupling pairs.
-// @intent push pagination into the coupling service so handlers expose stable limit/offset windows without slicing unbounded slices.
+// @intent bound the response size for handlers while Analyze still aggregates the full coupling set before slicing.
+// @domainRule pagination limits returned items, but compute cost still scales with the full edge aggregation.
 // @domainRule pairs are sorted by descending strength, then descending edge count, then from/to community for stable pagination.
 func (s *Service) AnalyzePage(ctx context.Context, req paging.Request) (Result, error) {
 	normalized, err := paging.Normalize(req)