Initial commit

skills/az-cli/references/repos.md

@@ -0,0 +1,274 @@
+# Azure Repos CLI Reference
+
+## Repository Management
+
+### az repos list
+
+List repositories in a project.
+
+```bash
+az repos list [--org] [--project] [--detect {false,true}]
+```
+
+### az repos show
+
+Get repository details.
+
+```bash
+az repos show --repository <name-or-id> [--open] [--org] [--project]
+```
+
+### az repos create
+
+Create a new repository.
+
+```bash
+az repos create --name <repo-name> [--org] [--project] [--open]
+```
+
+### az repos delete
+
+Delete a repository.
+
+```bash
+az repos delete --id <repo-id> [--yes] [--org] [--project]
+```
+
+### az repos update
+
+Update repository settings.
+
+```bash
+az repos update --repository <name-or-id> --name <new-name> [--default-branch <branch>]
+```
+
+## Pull Requests
+
+### az repos pr list
+
+List pull requests.
+
+```bash
+# All open PRs
+az repos pr list
+
+# Filter by creator
+az repos pr list --creator <email-or-name>
+
+# Filter by reviewer
+az repos pr list --reviewer <email-or-name>
+
+# Filter by status
+az repos pr list --status active|completed|abandoned|all
+
+# Filter by source/target branch
+az repos pr list --source-branch <branch> --target-branch <branch>
+
+# Limit results
+az repos pr list --top 10 --skip 0
+```
+
+### az repos pr show
+
+Show PR details.
+
+```bash
+az repos pr show --id <pr-id> [--open]
+```
+
+### az repos pr create
+
+Create a pull request.
+
+```bash
+az repos pr create \
+  --source-branch <branch> \
+  --target-branch <branch> \
+  --title "PR Title" \
+  --description "Description" \
+  [--reviewers user1@email.com user2@email.com] \
+  [--work-items 123 456] \
+  [--draft] \
+  [--auto-complete] \
+  [--squash] \
+  [--delete-source-branch]
+```
+
+### az repos pr update
+
+Update a pull request.
+
+```bash
+# Update title/description
+az repos pr update --id <pr-id> --title "New Title" --description "New desc"
+
+# Add reviewers
+az repos pr update --id <pr-id> --reviewers user@email.com
+
+# Set auto-complete
+az repos pr update --id <pr-id> --auto-complete true
+
+# Complete (merge) PR
+az repos pr update --id <pr-id> --status completed
+
+# Abandon PR
+az repos pr update --id <pr-id> --status abandoned
+```
+
+### az repos pr set-vote
+
+Vote on a pull request.
+
+```bash
+# Vote values:
+# 10 = approve
+# 5 = approve with suggestions
+# 0 = no vote
+# -5 = wait for author
+# -10 = reject
+
+az repos pr set-vote --id <pr-id> --vote 10
+```
+
+### az repos pr checkout
+
+Checkout PR branch locally.
+
+```bash
+az repos pr checkout --id <pr-id>
+```
+
+## PR Reviewers
+
+### az repos pr reviewer list
+
+List PR reviewers.
+
+```bash
+az repos pr reviewer list --id <pr-id>
+```
+
+### az repos pr reviewer add
+
+Add reviewers.
+
+```bash
+az repos pr reviewer add --id <pr-id> --reviewers user@email.com
+```
+
+### az repos pr reviewer remove
+
+Remove a reviewer.
+
+```bash
+az repos pr reviewer remove --id <pr-id> --reviewer user@email.com
+```
+
+## PR Work Items
+
+### az repos pr work-item list
+
+List linked work items.
+
+```bash
+az repos pr work-item list --id <pr-id>
+```
+
+### az repos pr work-item add
+
+Link work item to PR.
+
+```bash
+az repos pr work-item add --id <pr-id> --work-items 123 456
+```
+
+### az repos pr work-item remove
+
+Unlink work item.
+
+```bash
+az repos pr work-item remove --id <pr-id> --work-items 123
+```
+
+## Branch Policies
+
+### az repos policy list
+
+List branch policies.
+
+```bash
+az repos policy list --repository <repo> --branch <branch>
+```
+
+### az repos policy create
+
+Create a policy (various types available).
+
+```bash
+# Require minimum reviewers
+az repos policy approver-count create \
+  --repository <repo> \
+  --branch main \
+  --minimum-approver-count 2 \
+  --creator-vote-counts false \
+  --enabled true \
+  --blocking true
+
+# Require linked work items
+az repos policy work-item-linking create \
+  --repository <repo> \
+  --branch main \
+  --enabled true \
+  --blocking true
+
+# Build validation
+az repos policy build create \
+  --repository <repo> \
+  --branch main \
+  --build-definition-id <id> \
+  --enabled true \
+  --blocking true
+```
+
+## Git References
+
+### az repos ref list
+
+List branches and tags.
+
+```bash
+az repos ref list --repository <repo> [--filter heads/] [--filter tags/]
+```
+
+### az repos ref create
+
+Create a branch or tag.
+
+```bash
+az repos ref create \
+  --name refs/heads/new-branch \
+  --repository <repo> \
+  --object-id <commit-sha>
+```
+
+### az repos ref delete
+
+Delete a branch or tag.
+
+```bash
+az repos ref delete --name refs/heads/branch-name --repository <repo> --object-id <sha>
+```
+
+## Import Repository
+
+### az repos import create
+
+Import a repository from external source.
+
+```bash
+az repos import create \
+  --git-source-url https://github.com/user/repo.git \
+  --repository <target-repo-name> \
+  [--requires-authorization] \
+  [--user-name <git-username>]
+```