# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Code Repo API
  version: 1.0.0
extends: openapi/harness-coderepo-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/v1/orgs/{org}/projects/{project}/code-repos/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List code repositories scanned for supply chain
      effect: read
      questions:
      - Which code repositories are tracked for supply chain security in a project?
      - Can I filter scanned repos by a dependency or license?
      instructions:
      - text: List scanned code repositories in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: Find repos in project {project}, org {org}, that use dependency {dependency}.
        slots:
          project: path.project
          org: path.org
          dependency: requestBody.dependency_filter
      - text: Show code repositories in {org}/{project} with license {license}.
        slots:
          org: path.org
          project: path.project
          license: requestBody.license_filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/code-repos/{code-repo}/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a scanned code repository's overview
      effect: read
      questions:
      - What's the supply chain overview for one code repository?
      - Where can I see a single scanned repo's details?
      instructions:
      - text: Get the overview of code repo {repo} in {org}/{project}.
        slots:
          repo: path.code-repo
          org: path.org
          project: path.project
      - text: Show supply chain details for repository {repo} in project {project}, org {org}.
        slots:
          repo: path.code-repo
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/code-repos/{code-repo}/rules/evalution-trend'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repo's rule evaluation trend
      effect: read
      questions:
      - How have a repository's rule evaluations changed over time?
      - Can I see a repo's rule pass and fail trend for a date range?
      instructions:
      - text: Show the rule evaluation trend for repo {repo} in {org}/{project} since {start}.
        slots:
          repo: path.code-repo
          org: path.org
          project: path.project
          start: query.start_time
      - text: Get rules trend for code repo {repo} from {start} to {end} in project {project}, org {org}.
        slots:
          repo: path.code-repo
          start: query.start_time
          end: query.end_time
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/orgs/{org}/projects/{project}/code-repos/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize all scanned repositories in a project
      effect: read
      questions:
      - What's the overall supply chain summary across a project's repositories?
      - How many code repositories are tracked in a project?
      instructions:
      - text: Summarize all code repositories in {org}/{project}.
        slots:
          org: path.org
          project: path.project
      - text: Give me a repository summary for project {project} in org {org}.
        slots:
          project: path.project
          org: path.org
      method: generated
      generated: '2026-09-26'