API Evangelist conversational phrasing for Harness Repository API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Repository API
  version: 1.0.0
extends: openapi/harness-repository-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: 49
- target: $.paths['/code/api/v1/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: List code repositories
      effect: read
      questions:
      - Which Git repositories exist in my Harness Code project?
      - Can I list only the repositories I've marked as favorites?
      - Is there a way to include repositories from child spaces when listing repos?
      instructions:
      - text: List the repositories in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Find repositories whose path contains {text}.
        slots:
          text: query.query
      - text: Show only my favorite repositories.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new code repository
      effect: write
      questions:
      - How do I create a new Git repository in Harness Code?
      - Can I initialize a new repo with a README, license and .gitignore?
      - Can a newly created repository be made public?
      instructions:
      - text: Create a repository named {identifier} with default branch {branch}.
        slots:
          identifier: requestBody.identifier
          branch: requestBody.default_branch
      - text: Create a new public repo {identifier} with a README and a {license} license.
        slots:
          identifier: requestBody.identifier
          license: requestBody.license
      - text: Set up an empty repository {identifier} described as {description}.
        slots:
          identifier: requestBody.identifier
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's details
      effect: read
      questions:
      - Where can I see the details of a single code repository?
      - What default branch and visibility does a given repo have?
      instructions:
      - text: Get the details of repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Show me the metadata for repo {repo}.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Soft delete a repository
      effect: destructive
      questions:
      - How do I delete a repository in Harness Code?
      - Does deleting a repo remove it permanently or can it be recovered later?
      instructions:
      - text: Soft delete repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Move repo {repo} to the deleted state so it can still be restored.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a repository's description or tags
      effect: write
      questions:
      - Can I change a repository's description after it's created?
      - How do I update the tags or state on an existing repository?
      instructions:
      - text: Change the description of repository {repo} to {description}.
        slots:
          repo: path.repo_identifier
          description: requestBody.description
      - text: Set the state of repo {repo} to {state}.
        slots:
          repo: path.repo_identifier
          state: requestBody.state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/activities'].get
  update:
    x-apievangelist-phrasing:
      intent: List activity on a repository
      effect: read
      questions:
      - What recent activity has happened in a repository?
      - Can I see a repository's activity feed within a time window?
      instructions:
      - text: Show the activity log for repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: List activity on repo {repo} after {after}.
        slots:
          repo: path.repo_identifier
          after: query.after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/archive/{git_ref}.{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a repository as an archive
      effect: read
      questions:
      - Can I download a snapshot of a repo at a specific branch or tag as a zip or tarball?
      - Is it possible to archive only one subdirectory of a repository?
      instructions:
      - text: Download repo {repo} at {ref} as a {format} archive.
        slots:
          repo: path.repo_identifier
          ref: path.git_ref
          format: path.format
      - text: Export only the {path} folder of repository {repo} at {ref} in {format} format.
        slots:
          path: query.path
          repo: path.repo_identifier
          ref: path.git_ref
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/blame/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Show git blame for a file
      effect: read
      questions:
      - Who last changed each line of a file in my repo?
      - Can I run blame for just a range of lines in a file?
      instructions:
      - text: Show git blame for {path} in repository {repo}.
        slots:
          path: path.path
          repo: path.repo_identifier
      - text: Blame lines {from} to {to} of {path} in repo {repo}.
        slots:
          from: query.line_from
          to: query.line_to
          path: path.path
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/branches'].get
  update:
    x-apievangelist-phrasing:
      intent: List branches in a repository
      effect: read
      questions:
      - Which branches exist in a repository?
      - Can I see pull request and check status alongside each branch?
      - Is it possible to filter a repo's branches by name?
      instructions:
      - text: List all branches in repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Find branches in repo {repo} matching {text}.
        slots:
          repo: path.repo_identifier
          text: query.query
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/branches'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a branch
      effect: write
      questions:
      - How do I create a new branch from an existing commit or branch?
      - Can I dry-run branch protection rules before creating a branch?
      instructions:
      - text: Create branch {name} in repository {repo} from {target}.
        slots:
          name: requestBody.name
          repo: path.repo_identifier
          target: requestBody.target
      - text: Cut a new branch {name} in repo {repo}.
        slots:
          name: requestBody.name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/branches/{branch_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single branch
      effect: read
      questions:
      - What's the latest commit on a particular branch?
      - How far has a specific branch diverged from the default branch?
      instructions:
      - text: Get branch {branch} in repository {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      - text: Show the details and checks for branch {branch} of repo {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/branches/{branch_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a branch
      effect: destructive
      questions:
      - How do I delete a branch that's already been merged?
      - Can I bypass branch rules when deleting a protected branch?
      instructions:
      - text: Delete branch {branch} from repository {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      - text: Remove the {branch} branch in repo {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/codeowners/validate'].get
  update:
    x-apievangelist-phrasing:
      intent: Validate a CODEOWNERS file
      effect: read
      questions:
      - Is my CODEOWNERS file valid?
      - Can I check the code owners file on a specific branch for errors?
      instructions:
      - text: Validate the CODEOWNERS file in repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Check the code owners file of repo {repo} on {ref}.
        slots:
          repo: path.repo_identifier
          ref: query.git_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/commits'].get
  update:
    x-apievangelist-phrasing:
      intent: List commits in a repository
      effect: read
      questions:
      - What commits were made to a branch recently?
      - Can I filter a repo's commit history by author or date range?
      - Which commits touched a specific file path?
      instructions:
      - text: List commits in repository {repo} on {ref}.
        slots:
          repo: path.repo_identifier
          ref: query.git_ref
      - text: Show commits by {author} in repo {repo}.
        slots:
          author: query.author
          repo: path.repo_identifier
      - text: List commits to {path} in repo {repo} since {since}.
        slots:
          path: query.path
          repo: path.repo_identifier
          since: query.since
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/commits'].post
  update:
    x-apievangelist-phrasing:
      intent: Commit file changes to a branch
      effect: write
      questions:
      - Can I create, update or delete files in a repo through the API without cloning it?
      - How do I commit file changes onto a new branch?
      instructions:
      - text: Commit these file changes to branch {branch} of repository {repo} with message {message}.
        slots:
          branch: requestBody.branch
          repo: path.repo_identifier
          message: requestBody.message
      - text: Push a commit to repo {repo} on a new branch {new_branch}.
        slots:
          repo: path.repo_identifier
          new_branch: requestBody.new_branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/commits/{commit_sha}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a commit
      effect: read
      questions:
      - Who authored a given commit and what was its message?
      - Where can I look up a single commit by its SHA?
      instructions:
      - text: Get commit {sha} in repository {repo}.
        slots:
          sha: path.commit_sha
          repo: path.repo_identifier
      - text: Show the author and message of commit {sha} in repo {repo}.
        slots:
          sha: path.commit_sha
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/commits/{commit_sha}/diff'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the raw diff of a commit
      effect: read
      questions:
      - Can I see exactly what changed in one commit as a raw patch?
      - What lines did a specific commit add and remove?
      instructions:
      - text: Get the raw diff for commit {sha} in repository {repo}.
        slots:
          sha: path.commit_sha
          repo: path.repo_identifier
      - text: Show the patch introduced by commit {sha} in repo {repo}.
        slots:
          sha: path.commit_sha
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/commits/calculate-divergence'].post
  update:
    x-apievangelist-phrasing:
      intent: Calculate how far branches have diverged
      effect: read
      questions:
      - How many commits ahead or behind is my branch compared to another?
      - Can I compute divergence for several branch pairs in one request?
      instructions:
      - text: Calculate commit divergence for these branch pairs in repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Count ahead and behind commits in repo {repo}, capped at {max}.
        slots:
          repo: path.repo_identifier
          max: requestBody.max_count
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/content/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the contents of a file or directory
      effect: read
      questions:
      - How do I read a file's contents from a repository?
      - Can I list what's inside a directory at a particular branch or commit?
      instructions:
      - text: Get the content of {path} in repository {repo}.
        slots:
          path: path.path
          repo: path.repo_identifier
      - text: Show what's in {path} of repo {repo} at {ref}, including the latest commit.
        slots:
          path: path.path
          repo: path.repo_identifier
          ref: query.git_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/default-branch'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a repository's default branch
      effect: write
      questions:
      - How do I change the default branch of a repo from master to main?
      - Can I point a repository's default branch at a different existing branch?
      instructions:
      - text: Set the default branch of repository {repo} to {name}.
        slots:
          repo: path.repo_identifier
          name: requestBody.name
      - text: Make {name} the default branch for repo {repo}.
        slots:
          name: requestBody.name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/diff-stats/{range}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get diff statistics between two refs
      effect: read
      questions:
      - How many files and lines changed between two branches?
      - Can I get just a summary of changes between commits without the full diff?
      instructions:
      - text: Get the diff stats for range {range} in repository {repo}.
        slots:
          range: path.range
          repo: path.repo_identifier
      - text: Summarize files and lines changed in {range} of repo {repo}.
        slots:
          range: path.range
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/diff/{range}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the raw diff between two refs
      effect: read
      questions:
      - What's the full raw diff between two branches in a repo?
      - Can I limit a branch comparison diff to one file path?
      instructions:
      - text: Compare {range} in repository {repo} and return the raw diff.
        slots:
          range: path.range
          repo: path.repo_identifier
      - text: Show the unified diff of {range} in repo {repo} for {path} only.
        slots:
          range: path.range
          repo: path.repo_identifier
          path: query.path
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/diff/{range}'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a raw diff for selected paths via POST
      effect: read
      questions:
      - Is there a POST variant of the raw diff that takes the file list in the body?
      - Can I request a raw diff for a long list of files that won't fit in a query string?
      instructions:
      - text: Fetch the raw diff for {range} in repository {repo} using the POST endpoint with a list of paths.
        slots:
          range: path.range
          repo: path.repo_identifier
      - text: Post a path list and return the raw diff of {range} in repo {repo}.
        slots:
          range: path.range
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/fork'].post
  update:
    x-apievangelist-phrasing:
      intent: Fork a repository
      effect: write
      questions:
      - How do I fork a repository in Harness Code?
      - Can I fork only a single branch of a repo?
      instructions:
      - text: Fork repository {repo} as {identifier}.
        slots:
          repo: path.repo_identifier
          identifier: requestBody.identifier
      - text: Create a fork of repo {repo} containing only branch {branch}.
        slots:
          repo: path.repo_identifier
          branch: requestBody.fork_branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/fork-sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync a fork branch with its upstream
      effect: write
      questions:
      - How do I pull upstream changes into my forked repository?
      - Can I bring a fork's branch up to date with the parent repo's branch?
      instructions:
      - text: Sync branch {branch} of fork {repo} with upstream {upstream}.
        slots:
          branch: requestBody.branch
          repo: path.repo_identifier
          upstream: requestBody.branch_upstream
      - text: Update my fork {repo} branch {branch} from its upstream.
        slots:
          repo: path.repo_identifier
          branch: requestBody.branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's language breakdown
      effect: read
      questions:
      - What programming languages is a repository written in?
      - What percentage of a repo's code is in each language?
      instructions:
      - text: Show the language statistics for repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Break down repo {repo} by programming language.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/linked/source'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the external source of a linked repo
      effect: read
      questions:
      - Where does a linked repository mirror its code from?
      - Which connector and upstream repo is a linked repository tied to?
      instructions:
      - text: Get the linked source for repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Show which external repo {repo} is linked to.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/linked/sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Sync branches of a linked repository
      effect: write
      questions:
      - Can I pull the latest branches into a linked repository from its external source?
      - How do I refresh a linked repo that's out of date with its upstream?
      instructions:
      - text: Sync linked repository {repo} from its source.
        slots:
          repo: path.repo_identifier
      - text: Refresh branches {branches} on linked repo {repo}.
        slots:
          branches: requestBody.branches
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/merge-check/{range}'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether two refs can merge cleanly
      effect: read
      questions:
      - Will my branch merge without conflicts?
      - Can I see which files would conflict before merging two branches?
      instructions:
      - text: Check mergeability of {range} in repository {repo}.
        slots:
          range: path.range
          repo: path.repo_identifier
      - text: Tell me if {range} in repo {repo} has merge conflicts.
        slots:
          range: path.range
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/merge-commit'].post
  update:
    x-apievangelist-phrasing:
      intent: Merge a base branch into a head branch
      effect: write
      questions:
      - How do I bring the latest changes from main into my feature branch with a merge commit?
      - Can I dry-run a merge commit before actually creating it?
      instructions:
      - text: Merge {base} into {head} in repository {repo}.
        slots:
          base: requestBody.base_branch
          head: requestBody.head_branch
          repo: path.repo_identifier
      - text: Create a merge commit on {head} from {base} in repo {repo} with message {message}.
        slots:
          head: requestBody.head_branch
          base: requestBody.base_branch
          repo: path.repo_identifier
          message: requestBody.message
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/mergequeue/{branch_name}'].get
  update:
    x-apievangelist-phrasing:
      intent: List entries in a branch's merge queue
      effect: read
      questions:
      - What pull requests are waiting in the merge queue for a branch?
      - Can I see the current merge queue for main?
      instructions:
      - text: List the merge queue for branch {branch} in repository {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      - text: Show what's queued to merge into {branch} of repo {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/mergequeue/{branch_name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Clear a branch's merge queue
      effect: destructive
      questions:
      - How do I empty a stuck merge queue?
      - Can I remove everything waiting in a branch's merge queue at once?
      instructions:
      - text: Clear the merge queue for branch {branch} in repository {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      - text: Empty the {branch} merge queue on repo {repo}.
        slots:
          branch: path.branch_name
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/path-details'].post
  update:
    x-apievangelist-phrasing:
      intent: Get last-commit details for file paths
      effect: read
      questions:
      - Which commit last touched each of these files?
      - Can I get the latest commit info for several paths in one call?
      instructions:
      - text: Get the last commit for paths {paths} in repository {repo}.
        slots:
          paths: requestBody.paths
          repo: path.repo_identifier
      - text: Show last-change details for these files in repo {repo} at {ref}.
        slots:
          repo: path.repo_identifier
          ref: query.git_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/paths'].get
  update:
    x-apievangelist-phrasing:
      intent: List all file paths in a repository
      effect: read
      questions:
      - Can I get a flat list of every file in a repository?
      - Is there a way to include directories when listing all paths in a repo?
      instructions:
      - text: List every file path in repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: List all paths in repo {repo} at {ref} including directories.
        slots:
          repo: path.repo_identifier
          ref: query.git_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/purge'].post
  update:
    x-apievangelist-phrasing:
      intent: Permanently purge a deleted repository
      effect: destructive
      questions:
      - How do I permanently remove a repository that was soft deleted?
      - Once a repo is purged, can it ever be restored?
      instructions:
      - text: Purge repository {repo} deleted at {deleted_at}.
        slots:
          repo: path.repo_identifier
          deleted_at: query.deleted_at
      - text: Permanently erase soft-deleted repo {repo} from {deleted_at}.
        slots:
          repo: path.repo_identifier
          deleted_at: query.deleted_at
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/raw/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a file's raw content
      effect: read
      questions:
      - Can I download the raw bytes of a file from a repo?
      - What's the endpoint for getting a file's plain raw content at a given branch?
      instructions:
      - text: Download the raw file {path} from repository {repo}.
        slots:
          path: path.path
          repo: path.repo_identifier
      - text: Get raw bytes of {path} in repo {repo} at {ref}.
        slots:
          path: path.path
          repo: path.repo_identifier
          ref: query.git_ref
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/rebase'].post
  update:
    x-apievangelist-phrasing:
      intent: Rebase a branch onto another branch
      effect: write
      questions:
      - How do I rebase my feature branch onto the latest main?
      - Can I rebase a branch onto a specific commit instead of a branch?
      instructions:
      - text: Rebase {head} onto {base} in repository {repo}.
        slots:
          head: requestBody.head_branch
          base: requestBody.base_branch
          repo: path.repo_identifier
      - text: Rebase branch {head} of repo {repo} onto commit {sha}.
        slots:
          head: requestBody.head_branch
          repo: path.repo_identifier
          sha: requestBody.base_commit_sha
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a soft-deleted repository
      effect: write
      questions:
      - Can I recover a repository I deleted by mistake?
      - Is it possible to restore a deleted repo under a new name?
      instructions:
      - text: Restore repository {repo} deleted at {deleted_at}.
        slots:
          repo: path.repo_identifier
          deleted_at: query.deleted_at
      - text: Bring back deleted repo {repo} from {deleted_at} as {new_identifier}.
        slots:
          repo: path.repo_identifier
          deleted_at: query.deleted_at
          new_identifier: requestBody.new_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/settings/general'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's general settings
      effect: read
      questions:
      - Is Git LFS or auto-merge turned on for a repository?
      - What file size limit is set on a repo?
      instructions:
      - text: Show the general settings of repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Get LFS, auto-merge and file size settings for repo {repo}.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/settings/general'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a repository's general settings
      effect: write
      questions:
      - How do I enable Git LFS on a repository?
      - Can I change the maximum file size allowed in a repo?
      instructions:
      - text: Enable Git LFS on repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Set the file size limit on repo {repo} to {limit}.
        slots:
          repo: path.repo_identifier
          limit: requestBody.file_size_limit
      - text: Turn auto-merge on for repo {repo}.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/settings/security'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository's security settings
      effect: read
      questions:
      - Is secret scanning enabled on a repository?
      - What vulnerability scanning mode does a repo use?
      instructions:
      - text: Show the security settings of repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Check whether secret scanning is on for repo {repo}.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/settings/security'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a repository's security settings
      effect: write
      questions:
      - How do I turn on secret scanning for a repository?
      - Can I require committers to match the authenticated principal on a repo?
      instructions:
      - text: Enable secret scanning on repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Set vulnerability scanning mode on repo {repo} to {mode}.
        slots:
          repo: path.repo_identifier
          mode: requestBody.vulnerability_scanning_mode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/squash'].post
  update:
    x-apievangelist-phrasing:
      intent: Squash a branch's commits into one
      effect: write
      questions:
      - How do I squash all the commits on my branch into a single commit?
      - Can I preview a squash with a dry run before rewriting the branch?
      instructions:
      - text: Squash the commits on {head} relative to {base} in repository {repo}.
        slots:
          head: requestBody.head_branch
          base: requestBody.base_branch
          repo: path.repo_identifier
      - text: Squash branch {head} of repo {repo} into one commit titled {title}.
        slots:
          head: requestBody.head_branch
          repo: path.repo_identifier
          title: requestBody.title
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository summary
      effect: read
      questions:
      - How many branches, tags, commits and pull requests does a repo have?
      - Where do I get quick counts for a repository's overview page?
      instructions:
      - text: Get the summary counts for repository {repo}.
        slots:
          repo: path.repo_identifier
      - text: Give me an at-a-glance summary of repo {repo}.
        slots:
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/harness/refs/heads/main/overlays/harness-repository-api-phrasing-overlay.yaml