# Analysis

## Query analysis result summaries

> Retrieve lightweight analysis summaries for a repository. Returns only the fields needed for list/table views — no markdown content or raw linter data.\
> \
> \*\*Use cases:\*\*\
> \- Table view: list all recent analyses with status badges\
> \- Filter by base branch to see analyses targeting a specific branch\
> \- Filter by PR number to see summary for a specific PR\
> \
> Results are ordered by most recent first.

```json
{"openapi":"3.0.0","info":{"title":"sfp server","version":"51.9.0"},"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","in":"header"}}},"paths":{"/sfp/api/analysis/results":{"get":{"operationId":"AnalysisController_getResults","summary":"Query analysis result summaries","description":"Retrieve lightweight analysis summaries for a repository. Returns only the fields needed for list/table views — no markdown content or raw linter data.\n\n**Use cases:**\n- Table view: list all recent analyses with status badges\n- Filter by base branch to see analyses targeting a specific branch\n- Filter by PR number to see summary for a specific PR\n\nResults are ordered by most recent first.","parameters":[{"name":"repositoryIdentifier","required":true,"in":"query","description":"Repository identifier (e.g., flxbl-io/sf-core)","schema":{"type":"string"}},{"name":"pullRequestNumber","required":false,"in":"query","description":"Filter by PR number","schema":{"type":"string"}},{"name":"baseBranch","required":false,"in":"query","description":"Filter by target/base branch (e.g., main, release/1.0)","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum results to return (default: 20, max: 100)","schema":{"type":"number"}}],"responses":{"200":{"description":"Lightweight analysis summaries (no markdown or raw data)"},"400":{"description":"Missing repositoryIdentifier"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Requires role: member, owner, application"}},"tags":["Analysis"]}}}}
```

## Publish analysis results

> Store analysis results from \`sfp analyze\`. Called by the CLI when \`--publish-results\` is used.\
> \
> \*\*Dual write:\*\* Stores full results (with markdown and linter data) in the results table and a lightweight summary in the summary table.\
> \
> \*\*Duplicate handling:\*\* If results already exist for the same PR + commit, they are overwritten (same commit = updated analysis).\
> \
> \*\*Retention:\*\* Keeps last 500 results per repository.

```json
{"openapi":"3.0.0","info":{"title":"sfp server","version":"51.9.0"},"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","in":"header"}},"schemas":{"PublishAnalysisDto":{"type":"object","properties":{"repositoryIdentifier":{"type":"string","description":"Repository identifier (e.g., flxbl-io/sf-core)"},"pullRequestNumber":{"type":"string","description":"Pull request number (if PR context)"},"commitSha":{"type":"string","description":"Git commit SHA that was analyzed"},"branchName":{"type":"string","description":"Source branch name"},"baseBranch":{"type":"string","description":"Target branch name (for PRs)"},"status":{"type":"string","description":"Analysis status","enum":["completed","failed"]},"hasIssues":{"type":"boolean","description":"Whether any linter found issues"},"hasFailedLinters":{"type":"boolean","description":"Whether any linter in the fail-on list found issues"},"linters":{"description":"Linters that were executed","type":"array","items":{"type":"string"}},"results":{"description":"Per-linter results","type":"array","items":{"$ref":"#/components/schemas/AnalysisLinterResultDto"}},"executionTimeMs":{"type":"number","description":"Total execution time in milliseconds"},"markdownSummary":{"type":"string","description":"Pre-rendered markdown summary of the analysis results. Used for PR comments and UI rendering."},"prUrl":{"type":"string","description":"Direct URL to the pull request on the git provider"},"commitUrl":{"type":"string","description":"Direct URL to the commit on the git provider"}},"required":["repositoryIdentifier","commitSha","status","hasIssues","hasFailedLinters","linters","results"]},"AnalysisLinterResultDto":{"type":"object","properties":{"type":{"type":"string","description":"Linter type","enum":["duplicates","compliance","architecture","code-analyzer"]},"hasIssues":{"type":"boolean","description":"Whether the linter found issues"},"data":{"type":"object","description":"Linter-specific result data (violations, insights, etc.)"},"notes":{"description":"Additional notes from the linter","type":"array","items":{"type":"string"}}},"required":["type","hasIssues","data"]}}},"paths":{"/sfp/api/analysis/results":{"post":{"operationId":"AnalysisController_publishResults","summary":"Publish analysis results","description":"Store analysis results from `sfp analyze`. Called by the CLI when `--publish-results` is used.\n\n**Dual write:** Stores full results (with markdown and linter data) in the results table and a lightweight summary in the summary table.\n\n**Duplicate handling:** If results already exist for the same PR + commit, they are overwritten (same commit = updated analysis).\n\n**Retention:** Keeps last 500 results per repository.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishAnalysisDto"}}}},"responses":{"201":{"description":"Results stored successfully"},"400":{"description":"Invalid request body"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden - Requires role: application"}},"tags":["Analysis"]}}}}
```

## Get full analysis results for a pull request

> Retrieve all analysis runs for a specific PR with full data including markdown content and raw linter results.\
> \
> \*\*Use cases:\*\*\
> \- PR detail view: show full linter markdown reports per tab\
> \- Compare analysis results between commits on the same PR\
> \
> Each entry represents a separate analysis run (typically one per commit push).\
> Same commit re-analyzed = latest result only (overwritten on publish).

```json
{"openapi":"3.0.0","info":{"title":"sfp server","version":"51.9.0"},"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","in":"header"}}},"paths":{"/sfp/api/analysis/pr/{prNumber}":{"get":{"operationId":"AnalysisController_getPRAnalysis","summary":"Get full analysis results for a pull request","description":"Retrieve all analysis runs for a specific PR with full data including markdown content and raw linter results.\n\n**Use cases:**\n- PR detail view: show full linter markdown reports per tab\n- Compare analysis results between commits on the same PR\n\nEach entry represents a separate analysis run (typically one per commit push).\nSame commit re-analyzed = latest result only (overwritten on publish).","parameters":[{"name":"prNumber","required":true,"in":"path","description":"Pull request number","schema":{"type":"string"}},{"name":"repositoryIdentifier","required":true,"in":"query","description":"Repository identifier (e.g., flxbl-io/sf-core)","schema":{"type":"string"}}],"responses":{"200":{"description":"PR analysis runs with full data, sorted by most recent commit first"},"400":{"description":"Missing repositoryIdentifier"},"403":{"description":"Forbidden - Requires role: member, owner, application"}},"tags":["Analysis"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flxbl.io/flxbl/sfp-server/api-reference/analysis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.