@knowttl/ado-axi 0.0.0-stage → 0.5.0

package/dist/help.js

@@ -0,0 +1,383 @@
+export const DESCRIPTION = "Work with Azure DevOps work items, pull requests, and pipelines from the current profile";
+const AUDIT_HELP = {
+    repo: [
+        "ado-axi repo policy list --repo <id> [--branch <branch>] [--limit 100] [--full]",
+        "ado-axi repo policy show <id> [--limit 100] [--full]",
+        "ado-axi repo show <name|id> [--limit 100] [--full]",
+    ],
+    security: [
+        "ado-axi security group list [--scope <descriptor>] [--limit 100] [--full]",
+        "ado-axi security group show <descriptor> [--full]",
+        "ado-axi security membership list <descriptor> [--direction up|down] [--limit 100] [--full]",
+        "ado-axi security permission list --namespace <id> [--token <token>] [--subject <descriptor>] [--limit 100] [--full]",
+        "ado-axi security permission show --namespace <id> --token <token> [--subject <descriptor>] [--limit 100] [--full]",
+        "Aliases: security group membership list = security membership list.",
+    ],
+    "service-endpoint": [
+        "ado-axi service-endpoint list [--limit 100] [--full]",
+        "ado-axi service-endpoint show <id> [--full]",
+    ],
+    "variable-group": [
+        "ado-axi variable-group list [--limit 100] [--full]",
+        "ado-axi variable-group show <id> [--limit 100] [--full]",
+        "Alias: pipeline variable-group list|show.",
+    ],
+    pipeline: [
+        "ado-axi pipeline variable-group list [--limit 100] [--full]",
+        "ado-axi pipeline variable-group show <id> [--limit 100] [--full]",
+        "ado-axi pipeline variable list --pipeline <id> [--limit 100] [--full]",
+        "ado-axi pipeline show <id> [--limit 100] [--full]",
+        "ado-axi pipeline agent list --pool <id> [--limit 100] [--full]",
+        "ado-axi pipeline agent show <id> --pool <id> [--full]",
+        "ado-axi pipeline pool list [--limit 100] [--full]",
+        "ado-axi pipeline pool show <id> [--full]",
+        "ado-axi pipeline queue list [--limit 100] [--full]",
+        "ado-axi pipeline queue show <id> [--full]",
+    ],
+    agent: [
+        "ado-axi agent list --pool <id> [--limit 100] [--full]",
+        "ado-axi agent show <id> --pool <id> [--full]",
+    ],
+    pool: [
+        "ado-axi pool list [--limit 100] [--full]",
+        "ado-axi pool show <id> [--full]",
+    ],
+    queue: [
+        "ado-axi queue list [--limit 100] [--full]",
+        "ado-axi queue show <id> [--full]",
+    ],
+    user: [
+        "ado-axi user list [--limit 100] [--full]",
+        "ado-axi user show <entitlement-id> [--full]",
+    ],
+    team: [
+        "ado-axi team list [--limit 100] [--full]",
+        "ado-axi team member list --team <name|id> [--limit 100] [--full]",
+        "Alias: team list-member = team member list.",
+    ],
+    project: ["ado-axi project show [<name|id>] [--limit 100] [--full]"],
+};
+export const TOP_LEVEL_HELP = [
+    "Writes default off: set ADO_AXI_WRITES=1 to enable mutations (including config init|add and raw API non-GET/HEAD/OPTIONS). Reads and help remain available.",
+    "ado-axi                                  # dashboard: your work items, project-active PRs, recent runs",
+    "ado-axi work-item list                   # open work items (WIQL under the hood)",
+    "ado-axi work-item get <id>               # detail view [--comments] [--full]",
+    'ado-axi work-item create --type Task --title "..."',
+    "ado-axi work-item update <id> --state <state>",
+    "ado-axi work-item delete <id> --if-rev <n> # recycle bin; [--destroy --confirm-destroy] is permanent",
+    'ado-axi work-item comment <id> --body "..." [--format markdown|html]',
+    "ado-axi work-item link list|add|remove <id> # parent/child/related, pull request, commit, branch",
+    "ado-axi work-item link types             # available relation types [--limit 50] [--full]",
+    "ado-axi work-item attach <id> --file <path> [--comment ...] [--if-rev <n>]",
+    "ado-axi work-item attachment get <id> --name <file> [--out <path>] [--force]",
+    "ado-axi query run <id|path>               # saved query results [--limit 30] [--fields a,b]",
+    "ado-axi area list                        # area paths [--depth 10] [--limit 50] [--full]",
+    "ado-axi iteration list                   # iteration paths and dates [--depth 10] [--limit 50] [--full]",
+    "ado-axi pr list                          # active pull requests [--repo <r>] [--status <s>]",
+    "ado-axi pr get <id>                      # detail + reviewers [--threads] [--full]",
+    'ado-axi pr create --repo <r> --source <branch> --title "..."',
+    'ado-axi pr update <id> --title "..."     # draft/auto-complete/description updates',
+    "ado-axi pr complete <id> [--squash]      # guarded merge; never bypasses policy",
+    "ado-axi pr checks <id> | diff <id>       # bounded readiness/change summaries",
+    "ado-axi pr reviewer list|add|remove <id>",
+    "ado-axi pr approve <id>                  # [--vote approve|reject|wait-for-author|reset]",
+    'ado-axi pr comment <id> --body "..."     # [--file <path> --line <n>] [--thread <id>]',
+    "ado-axi pr thread list|resolve|reply <id>  # close out review comment threads",
+    "ado-axi pipeline list                    # pipeline definitions",
+    "ado-axi pipeline runs [--pipeline <id>]  # recent runs [--result failed]",
+    "ado-axi pipeline run --pipeline <id> --branch <branch>",
+    "ado-axi pipeline create|update|delete   # definition administration (writes default off)",
+    "ado-axi pipeline build tag|cancel      # runs tag is an alias for build tag",
+    "ado-axi pipeline folder list|create|delete",
+    "ado-axi pipeline runs artifact list|download <run-id>",
+    "ado-axi pipeline release list|show|create # Classic releases; create requires writes enabled",
+    "ado-axi pipeline logs <run-id>           # [--log <id>] [--tail N] [--full] [--failed-only]",
+    "ado-axi pipeline timeline <run-id>       # stages/jobs + failing steps with log ids",
+    "ado-axi pipeline watch <run-id>          # [--interval 10] [--timeout 1800]",
+    "ado-axi test results <run-id>            # failed tests of a pipeline run [--outcome all]",
+    "ado-axi repo list                        # repositories [--name <filter>]",
+    "ado-axi repo create|update|delete|import # all mutations require ADO_AXI_WRITES=1",
+    "ado-axi repo policy create|update|delete # configurations; revision prechecks and confirmed deletion",
+    "ado-axi repo branches --repo <name>",
+    "ado-axi repo file <path> --repo <name>   # file content at a branch or commit [--ref] [--commit]",
+    "ado-axi ref list|create|delete --repo <name>",
+    "ado-axi project list                     # projects, 30 most recently updated",
+    ...Object.values(AUDIT_HELP).flat(),
+    "ado-axi api <path|url>                   # raw REST escape hatch for everything else",
+    "ado-axi doctor                           # authentication check for every profile",
+    "ado-axi config list | init | path        # profiles in ~/.ado-axi/config.json",
+    "",
+    "Profiles: --profile <name> selects a configured org/project/auth pair (also allowed before the command).",
+    "Overrides: --org <org> --project <project> (or $ADO_AXI_ORG / $ADO_AXI_PROJECT).",
+    "--org accepts a name or organization-root URL; project context must be supplied separately.",
+    "Auth per profile: az CLI login, or a PAT read from an env var.",
+    "Output: TOON on stdout. --full expands detail output (see command help for limits), --fields a,b limits list columns.",
+].join("\n");
+export const COMMAND_HELP = {
+    "work-item": [
+        "ado-axi work-item <list|get|create|update|delete|comment|link>",
+        "",
+        "list    [--state open|all|<State>] [--type <type>] [--assigned-to @me|<name>]",
+        "        [--iteration @current|<path>] [--area <path>] [--tag <tag>] [--search <text>]",
+        '        [--query "<raw WIQL>"] [--limit 30] [--fields id,title,state]',
+        "        --limit bounds displayed items; count reports only the number shown, not an exhaustive total.",
+        "        --fields accepts id,type,title,state,assignee,created,changed or any field reference name.",
+        "        Example: --fields System.AssignedTo,System.CreatedDate,Custom.EventSeverity",
+        "get     <id> [--comments] [--relations] [--full]   # includes rev for --if-rev updates",
+        "        --full includes the complete description and every non-System field by reference name (1200 chars per extra text field).",
+        'create  --type <type> --title "..." [--description "..."] [--description-format markdown|html] [--assigned-to <user>]',
+        "        # when --description is omitted, piped stdin is used",
+        '        [--area <path>] [--iteration <path>] [--parent <id>] [--tags "a; b"] [--set \'{"Field.Ref": value}\']',
+        'update  <id> [--state <state>] [--title "..."] [--assigned-to <user>] [--area <path>]',
+        '        [--iteration <path>] [--description "..."] [--description-format markdown|html] [--tags "a; b"] [--reason <reason>] [--set \'{...}\']',
+        "        # when --description is omitted, piped stdin is used",
+        "        [--add-tags a,b] [--remove-tags c]  # automatically revision-guarded tag changes",
+        "        [--if-rev <n>]                      # compare-and-swap: fails if the item changed",
+        "delete  <id> --if-rev <n> [--destroy --confirm-destroy] # recycle bin by default; destroy is permanent",
+        "        Reads and compares rev immediately before DELETE; not atomic: another writer can change the item in that gap.",
+        'comment <id> [--body "..."] [--format markdown|html]',
+        "        # pipe stdin when --body is omitted; required for Markdown/multiline with `, $, !, or quotes",
+        "        # Markdown by default; use --format html only for raw HTML",
+        "link list <id> [--limit 50]               # every relation, resolved to ids/artifacts",
+        "link types [--limit 50] [--full] [--fields reference,name,usage,enabled]",
+        "link add  <id> (--parent <id> | --child <id> | --related <id> | --pr <id>",
+        "                | --commit <40-hex> --repo <name> | --branch <name> --repo <name>)",
+        '          [--comment "..."] [--if-rev <n>]  # duplicate links are reported as no-ops',
+        "link remove <id> --index <n> --if-rev <n> # index and rev from link list; atomic revision guard",
+        'attach <id> --file <path> [--comment "..."] [--if-rev <n>] # upload then add a revision-guarded AttachedFile relation',
+        "attachment get <id> --name <file> [--out <path>] [--force] # default ./<name>; refuses ambiguous names",
+        "        Attachments: 25 MiB maximum in either direction; downloads never overwrite without --force and report SHA-256.",
+        "Writes: create, update, delete (including --destroy), comment, link add, link remove, attach. Default off; set ADO_AXI_WRITES=1 to enable.",
+        "",
+        "Examples:",
+        "  ado-axi work-item list --assigned-to @me --state open",
+        "  ado-axi work-item get 4211 --comments",
+        '  ado-axi work-item update 4211 --state "In Progress"',
+        '  ado-axi work-item create --type Task --title "Documentation" --description "# Goal" --description-format markdown',
+        "  ado-axi work-item update 4211 --assigned-to me@corp.com --add-tags agent-claimed --if-rev 7",
+        "  ado-axi work-item link add 4211 --pr 812",
+        "  ado-axi work-item link list 4211",
+        '  ado-axi work-item attach 4211 --file ./evidence.png --comment "Test evidence" --if-rev 7',
+        "  ado-axi work-item attachment get 4211 --name evidence.png --out ./download.png",
+        "  ado-axi work-item link remove 4211 --index 0 --if-rev 7",
+        "  ado-axi work-item delete 4211 --if-rev 7",
+        "  ado-axi work-item delete 4211 --if-rev 7 --destroy --confirm-destroy",
+        "  ado-axi work-item comment 4211 --body \"**Ready**\"",
+        "  # comments use Markdown by default; pass --format html only for raw HTML",
+    ].join("\n"),
+    query: [
+        "ado-axi query run <id|path> [--limit 30] [--fields id,type,title,state,assignee,changed]",
+        "Runs a saved query by GUID or project-relative path using GET requests only.",
+        "Field aliases and reference names match work-item list; the server-side limit stays in effect with --full.",
+        "Count reports items shown, not an exhaustive total. Linked queries show distinct source/target work items.",
+        "Examples:",
+        '  ado-axi query run "Shared Queries/Open bugs" --limit 10',
+        "  ado-axi query run 11111111-1111-4111-8111-111111111111 --fields id,title,Custom.Priority",
+    ].join("\n"),
+    area: [
+        "ado-axi area list [--depth 10] [--limit 50] [--full] [--fields id,path]",
+        "Shows area paths within the requested depth (0 includes only the project root).",
+        "--full removes the display limit; depth still applies. left-out counts fetched paths omitted from output.",
+        "Examples:",
+        "  ado-axi area list --depth 2",
+        "  ado-axi area list --depth 3 --full",
+    ].join("\n"),
+    iteration: [
+        "ado-axi iteration list [--depth 10] [--limit 50] [--full] [--fields id,path,start,finish]",
+        "Shows iteration paths with start/finish dates within the requested depth (0 includes only the root).",
+        "--full removes the display limit; depth still applies. left-out counts fetched paths omitted from output.",
+        "Examples:",
+        "  ado-axi iteration list --depth 2",
+        "  ado-axi iteration list --limit 100 --full",
+    ].join("\n"),
+    pr: [
+        "ado-axi pr <list|get|comments|create|update|complete|abandon|checks|diff|reviewer|approve|comment|thread>",
+        "",
+        "list    [--repo <repo>] [--status active|draft|completed|abandoned|all] [--creator @me|<name>]",
+        "        [--reviewer @me|<name>] [--target <branch>] [--source <branch>] [--limit 30]",
+        "get     <id> [--repo <repo>] [--threads] [--full]",
+        "comments <id> [--repo <repo>] [--full]   # alias for `get <id> --threads`",
+        'create  --repo <repo> --source <branch> [--target main] --title "..." [--description "..."]',
+        "        # when --description is omitted, piped stdin is used",
+        "        [--reviewers a,b] [--draft] [--work-items 1,2]",
+        'update  <id> [--title "..."] [--description "..."] [--draft true|false] [--auto-complete true|false]',
+        "        # when --description is omitted, piped stdin is used as the description",
+        "complete <id> [--squash true|false] [--delete-source-branch true|false] [--repo <repo>]",
+        "abandon  <id> [--repo <repo>]",
+        "checks  <id> [--limit 10] [--full] [--repo <repo>]",
+        "diff    <id> [--limit 20] [--full] [--repo <repo>]",
+        "reviewer list <id> [--repo <repo>]",
+        "reviewer add|remove <id> --reviewer <identity> [--required] [--repo <repo>]",
+        "approve <id> [--vote approve|approve-with-suggestions|wait-for-author|reject|reset] [--repo <repo>]",
+        'comment <id> [--body "..."] [--file <path> --line <n>] [--thread <id>] [--repo <repo>]',
+        "        # pipe stdin when --body is omitted; required for Markdown/multiline with `, $, !, or quotes",
+        "thread list <id> [--limit 20] [--full]   # non-system threads, status, file, last comment",
+        'thread reply <id> --thread <n> [--body "..."] [--resolve] [--status <status>]',
+        "        # pipe stdin when --body is omitted; required for Markdown/multiline with `, $, !, or quotes",
+        "thread resolve|reopen <id> --thread <n> [--status active|fixed|wont-fix|closed|by-design|pending]",
+        "",
+        "Examples:",
+        "  ado-axi pr list --reviewer @me",
+        "  ado-axi pr get 812 --threads --full",
+        "  ado-axi pr checks 812",
+        "  ado-axi pr diff 812 --limit 50",
+        "  ado-axi pr complete 812 --squash --delete-source-branch",
+        "  ado-axi pr abandon 812",
+        "  ado-axi pr approve 812",
+        "  ado-axi pr thread list 812",
+        '  ado-axi pr thread reply 812 --thread 5 --body "Fixed in 3f2a1c9" --resolve',
+        "  MSYS_NO_PATHCONV=1 ado-axi pr comment 812 --file /src/File.cs --line 10 --body \"...\"  # Git Bash",
+    ].join("\n"),
+    pipeline: [
+        "ado-axi pipeline <list|show|create|update|delete|runs|run|build|folder|release|logs|timeline|watch>",
+        "",
+        "list  [--name <filter>] [--limit 100]",
+        "create --definition '<BuildDefinition JSON object>' # include name, repository, process, queue",
+        "update <id> --definition '<changed fields JSON object>' [--if-rev <n>] # merges into fetched definition; revision CAS",
+        "delete <id> --if-rev <n> --confirm-delete # revision precheck; DELETE is not atomic",
+        "build tag add|remove <run-id> --tag <tag> # alias: runs tag",
+        "build cancel <run-id> # completed/cancelling builds are a no-op",
+        "folder list [--path <folder>] [--limit 100] [--full] # full expands fields, not the limit",
+        "folder create --path <absolute-folder> # e.g. '\\Team'",
+        "folder delete --path <absolute-folder> --confirm-delete # existence precheck; no atomic guard",
+        "runs artifact list <run-id> [--limit 100] [--full] # id, name, type, byte size; signed URLs withheld",
+        "runs artifact download <run-id> --name <name> --out <path> [--force] # ZIP; 100 MiB cap, bytes reported; read-only remotely",
+        "release list [--definition <id>] [--limit 100] [--full] # Classic releases, newest first",
+        "release show <id> [--limit 100] [--full] # bounded collections; secret variables and URLs masked",
+        "release create --definition <id> [--description <text>] [--draft true|false] [--artifacts '<JSON array>']",
+        "  artifacts: [{\"alias\":\"_CI\",\"instanceReference\":{\"id\":\"42\"}}]; omit to use definition defaults",
+        "  release create requires ADO_AXI_WRITES=1; non-draft releases may trigger deployments",
+        "  Artifact upload is not exposed: the Build Artifacts create API registers resources, not local file bytes.",
+        "runs  [--pipeline <id>] [--branch <branch>] [--status <status>] [--result failed] [--limit 20]",
+        "run   --pipeline <id> [--branch <branch>] [--variables '{\"k\":\"v\"}'] [--parameters '{\"k\":\"v\"}']",
+        "logs  <run-id> [--log <log-id>] [--tail 120] [--full] [--failed-only]",
+        "timeline <run-id> [--limit 20] [--full]  # stage/job outline + failed steps, issues, log ids",
+        "watch <run-id> [--interval 10] [--timeout 1800]  # seconds; deadline includes auth/HTTP; failures exit 1",
+        "",
+        "Examples:",
+        "  ado-axi pipeline runs --result failed --limit 5",
+        "  ado-axi pipeline update 42 --definition '{\"name\":\"CI\"}' --if-rev 7",
+        "  ado-axi pipeline build tag add 42 --tag verified",
+        "  ado-axi pipeline folder list --limit 20",
+        "  ado-axi pipeline runs artifact list 42 --limit 10",
+        "  ado-axi pipeline runs artifact download 42 --name drop --out ./drop.zip",
+        "  ado-axi pipeline release create --definition 4 --draft true",
+        "  ado-axi pipeline timeline 98231",
+        "  ado-axi pipeline logs 98231 --failed-only --tail 200",
+        "  ado-axi pipeline watch 98231 --interval 10 --timeout 1800",
+    ].join("\n"),
+    test: [
+        "ado-axi test results <run-id>",
+        "",
+        "results <run-id> [--outcome failed|passed|aborted|not-executed|all] [--limit 20] [--full]",
+        "        [--run <test-run-id>]   # read one published test run instead of a pipeline run",
+        "",
+        "<run-id> is the pipeline run id from `pipeline runs`. Totals are aggregated across every",
+        "test run published by that pipeline run; all pages are read, including run details.",
+        "--limit bounds displayed results, not totals; --full expands error messages, not the result limit.",
+        "",
+        "Examples:",
+        "  ado-axi test results 98231",
+        "  ado-axi test results 98231 --full",
+        "  ado-axi test results 98231 --outcome all --limit 50",
+    ].join("\n"),
+    repo: [
+        "ado-axi repo <list|show|branches|file|create|update|delete|import|policy>",
+        "",
+        "list     [--name <filter>] [--limit 200]",
+        "create   --name <name> # create in selected project",
+        "update   --repo <id|name> [--name <name>] [--default-branch <branch>] [--disabled true|false]",
+        "delete   --repo <id|name> --confirm-delete # existence precheck, then delete by resolved id",
+        "import   --repo <id|name> --source-url <https-git-url> [--service-endpoint <id>] # queues an import into an existing empty repository",
+        "  Source URLs must not include credentials, queries, or fragments; use a service endpoint for authentication.",
+        "policy create --policy-json '<JSON object>' # type.id GUID, settings object, isEnabled/isBlocking booleans",
+        "policy update <id> --policy-json '<changed fields JSON object>' [--if-rev <n>] # sends fetched revision",
+        "policy delete <id> --if-rev <n> --confirm-delete # revision precheck; DELETE has no atomic guard",
+        "  --config <path> selects the profile file; --profile <name> selects a saved profile.",
+        "  Policy JSON accepts type, settings, isEnabled, isBlocking; omit id/revision. Nested settings are replaced as a whole.",
+        "  Repository PATCH/DELETE and policy DELETE have no documented atomic revision predicate; prechecks have a race window.",
+        "branches --repo <name> [--name <filter>] [--limit 50]",
+        "file     <path> --repo <name> [--ref <branch> | --commit <40-hex>] [--limit <lines>] [--full]",
+        "",
+        "`file` returns a single file's content at a branch tip (default branch when --ref is omitted)",
+        "or an exact commit. Content is truncated with a --full escape hatch; binaries are not returned.",
+        "",
+        "Examples:",
+        "  ado-axi repo file /src/Program.cs --repo Web",
+        "  ado-axi repo create --name SyntheticRepo",
+        "  ado-axi repo update --repo SyntheticRepo --default-branch main",
+        "  ado-axi repo policy update 7 --policy-json '{\"isEnabled\":false}' --if-rev 3",
+        "  ado-axi repo file /src/Program.cs --repo Web --ref feature/x --limit 80",
+    ].join("\n"),
+    ref: [
+        "ado-axi ref <list|create|delete>",
+        "",
+        "list   --repo <repo> [--name <prefix>] [--limit 50] [--full]",
+        "create --repo <repo> --name <branch> (--source <branch> | --source-object-id <40-hex>)",
+        "delete --repo <repo> --name <branch> [--old-object-id <40-hex>]",
+        "",
+        "Create never overwrites an existing ref. Delete reads the current object id and uses it as",
+        "Azure DevOps' concurrency guard; --old-object-id adds an explicit caller-side guard.",
+    ].join("\n"),
+    project: ["ado-axi project list [--name <filter>] [--limit 30]"].join("\n"),
+    api: [
+        "ado-axi api [GET|POST|PATCH|PUT|DELETE] <path|url> [--body '<json>'] [--query 'k=v&k2=v2']",
+        "            [--api-version 7.1] [--host dev|vsrm|vssps|almsearch|vsaex] [--no-project] [--raw] [--full]",
+        "            [--content-type json|json-patch|merge-patch|text|<media type>]",
+        "",
+        "Raw Azure DevOps REST escape hatch. Paths are relative to",
+        "https://dev.azure.com/<org>/<project>/ — pass --no-project for organization-level paths.",
+        "Full HTTPS REST URLs on dev.azure.com, vsrm.dev.azure.com, vssps.dev.azure.com, and",
+        "almsearch.dev.azure.com, and vsaex.dev.azure.com select org/project/host/query without inheriting default project context.",
+        "Conflicting flags or a --profile from another org are rejected before authentication.",
+        "URLs with credentials, custom ports, fragments, dot segments, or duplicate query keys are rejected.",
+        "Work item writes require --content-type json-patch.",
+        "Use --raw for endpoints that return plain text, such as build logs.",
+        "When --body is omitted and stdin is piped, stdin is sent as the raw request body (use --content-type as needed).",
+        "",
+        "Examples:",
+        "  ado-axi api _apis/wiki/wikis",
+        "  ado-axi api 'https://vsrm.dev.azure.com/acme/Platform/_apis/release/releases?api-version=7.1'",
+        "  ado-axi api _apis/testplan/plans --query 'filterActivePlans=true'",
+        "  ado-axi api POST _apis/search/codesearchresults --host almsearch --body '{\"searchText\":\"TODO\"}'",
+        "  ado-axi api PATCH _apis/wit/workitems/4211 --content-type json-patch \\",
+        "    --body '[{\"op\":\"test\",\"path\":\"/rev\",\"value\":7},{\"op\":\"add\",\"path\":\"/fields/System.State\",\"value\":\"Active\"}]'",
+    ].join("\n"),
+    doctor: [
+        "ado-axi doctor [--config <path>]",
+        "",
+        "Verifies authentication for every configured profile and reports the identity",
+        "each one resolves to. Exit code 0 even when a profile fails — read `status`.",
+    ].join("\n"),
+    config: [
+        "ado-axi config <list|init|path>",
+        "",
+        "list  [--config <path>]",
+        "init  --org <org> [--project <project>] [--name <profile>] [--auth az|pat] [--pat-env <VAR>] [--default]",
+        "path  prints the resolved config file location",
+        "--org also accepts https://dev.azure.com/<org> or https://<org>.visualstudio.com; no project/API path.",
+        "",
+        "Config lives in ~/.ado-axi/config.json (or ./ado-axi.config.json, or $ADO_AXI_CONFIG):",
+        '  { "defaultProfile": "acme", "profiles": {',
+        '      "acme": { "org": "acme", "project": "Platform", "auth": "az" },',
+        '      "contoso": { "org": "contoso", "project": "Web", "auth": "pat", "patEnv": "ADO_CONTOSO_PAT" } } }',
+    ].join("\n"),
+};
+for (const [command, lines] of Object.entries(AUDIT_HELP)) {
+    COMMAND_HELP[command] = [
+        COMMAND_HELP[command] ?? `ado-axi ${command}`,
+        "",
+        "Read-only audit commands (TD-064):",
+        ...lines,
+        "Lists default to --limit 100 and report omitted records; --full expands details without lifting limits.",
+        "All audit commands accept --limit (also for nested detail collections) and --fields a,b on lists.",
+        "Detail identifiers also accept --id <id>; membership --direction defaults to up.",
+        "Secret variables are masked; endpoint authorization, data, URLs, and agent capabilities are withheld, including --full.",
+        "API error details are withheld to protect credentials. Empty lists report 0 of 0 and omitted: 0.",
+    ].join("\n");
+}
+for (const command of ["pr", "pipeline", "repo", "ref", "config", "api"]) {
+    COMMAND_HELP[command] += "\nWrites default off: set ADO_AXI_WRITES=1 to enable mutations. Reads and help remain available.";
+}
+COMMAND_HELP.api += "\nRaw API methods other than GET, HEAD, and OPTIONS require enablement, including implicit POST from a body or piped stdin.";
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"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"}

package/dist/lib/adoUrl.d.ts

@@ -0,0 +1,19 @@
+export declare const ADO_HOSTS: {
+    readonly dev: "dev.azure.com";
+    readonly vsrm: "vsrm.dev.azure.com";
+    readonly vssps: "vssps.dev.azure.com";
+    readonly almsearch: "almsearch.dev.azure.com";
+    readonly vsaex: "vsaex.dev.azure.com";
+};
+export type AdoHost = keyof typeof ADO_HOSTS;
+export declare function normalizeOrg(input: string): string;
+export declare function assertRelativeApiPath(path: string): void;
+export interface AdoApiUrl {
+    org: string;
+    project?: string;
+    host: AdoHost;
+    path: string;
+    query: Record<string, string>;
+}
+export declare function parseAdoApiUrl(input: string): AdoApiUrl | undefined;
+//# sourceMappingURL=adoUrl.d.ts.map

package/dist/lib/adoUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoUrl.d.ts","sourceRoot":"","sources":["../../src/lib/adoUrl.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,SAAS,CAAC;AA2B7C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBlD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBxD;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CA6BnE"}

package/dist/lib/adoUrl.js

@@ -0,0 +1,104 @@
+import { AxiError } from "axi-sdk-js";
+export const ADO_HOSTS = {
+    dev: "dev.azure.com",
+    vsrm: "vsrm.dev.azure.com",
+    vssps: "vssps.dev.azure.com",
+    almsearch: "almsearch.dev.azure.com",
+    vsaex: "vsaex.dev.azure.com",
+};
+function urlError(message) {
+    throw new AxiError(message, "VALIDATION_ERROR", [
+        "Use an HTTPS Azure DevOps REST URL on dev.azure.com, vsrm.dev.azure.com, vssps.dev.azure.com, almsearch.dev.azure.com, or vsaex.dev.azure.com",
+        "Or pass a relative API path with --org <org> [--project <project>] [--host <host>]",
+    ]);
+}
+function parseUrl(input) {
+    if (!/^https:\/\/[^/?#]+/i.test(input) || input !== input.trim() || /[\\\u0000-\u001f\u007f]/.test(input)) {
+        urlError("invalid Azure DevOps URL");
+    }
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        return urlError("invalid Azure DevOps URL");
+    }
+    if (url.protocol !== "https:" || url.username || url.password || url.port || input.includes("#")) {
+        urlError("Azure DevOps URLs require HTTPS without credentials, custom ports, or fragments");
+    }
+    const rawPath = input.match(/^https:\/\/[^/?#]+([^?#]*)/i)?.[1] ?? "";
+    assertRelativeApiPath(rawPath);
+    return url;
+}
+export function normalizeOrg(input) {
+    if (/^[a-z0-9][a-z0-9-]*$/i.test(input))
+        return input;
+    if (/^https:\/\//i.test(input)) {
+        const url = parseUrl(input);
+        let org;
+        if (url.hostname === ADO_HOSTS.dev) {
+            org = /^\/([a-z0-9][a-z0-9-]*)\/?$/i.exec(url.pathname)?.[1];
+        }
+        else {
+            org = /^([a-z0-9][a-z0-9-]*)\.visualstudio\.com$/i.exec(url.hostname)?.[1];
+            if (url.pathname !== "/")
+                org = undefined;
+        }
+        if (org && !url.search)
+            return org;
+    }
+    throw new AxiError("organization must be a name or an Azure DevOps organization-root URL", "VALIDATION_ERROR", [
+        "Use --org acme, --org https://dev.azure.com/acme, or --org https://acme.visualstudio.com",
+        "Pass the project separately with --project <project>; do not include project or API paths in --org",
+    ]);
+}
+export function assertRelativeApiPath(path) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(path) || path.startsWith("//") || /[\\\u0000-\u001f\u007f]/.test(path)) {
+        urlError("expected a relative API path, not a URL or Windows path");
+    }
+    let decoded;
+    try {
+        decoded = decodeURIComponent(path.split(/[?#]/, 1)[0] ?? "");
+    }
+    catch {
+        return urlError("API path contains invalid percent encoding");
+    }
+    // Build folder identifiers are absolute backslash paths in an encoded route value.
+    const buildFolder = /^_apis\/build\/folders\/%5c/i.test(path);
+    if ((decoded.includes("\\") && !buildFolder)
+        || decoded.replaceAll("\\", "/").split("/").some((part) => part === "." || part === "..")) {
+        urlError("API paths must not contain backslashes or dot segments");
+    }
+}
+export function parseAdoApiUrl(input) {
+    if (!/^[a-z][a-z0-9+.-]*:/i.test(input)) {
+        assertRelativeApiPath(input);
+        return undefined;
+    }
+    const url = parseUrl(input);
+    const host = Object.keys(ADO_HOSTS).find((key) => ADO_HOSTS[key] === url.hostname);
+    if (!host)
+        urlError("unsupported Azure DevOps API URL host");
+    const segments = url.pathname.slice(1).split("/");
+    const apiIndex = segments.indexOf("_apis");
+    if (apiIndex < 1 || !segments[apiIndex + 1]) {
+        urlError("expected an Azure DevOps REST URL containing /_apis/<resource>");
+    }
+    const org = normalizeOrg(segments[0] ?? "");
+    const project = apiIndex > 1 ? decodeURIComponent(segments[1] ?? "") : undefined;
+    if (project !== undefined && (!project || /[/\\]/.test(project))) {
+        urlError("invalid project segment in Azure DevOps API URL");
+    }
+    const query = Object.fromEntries(url.searchParams);
+    if (Object.keys(query).length !== url.searchParams.size) {
+        urlError("duplicate query parameters in the API URL are not supported");
+    }
+    return {
+        org,
+        project,
+        host,
+        path: segments.slice(project === undefined ? 1 : 2).join("/"),
+        query,
+    };
+}
+//# sourceMappingURL=adoUrl.js.map

package/dist/lib/adoUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoUrl.js","sourceRoot":"","sources":["../../src/lib/adoUrl.ts"],"names":[],"mappings":"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"}

package/dist/lib/args.d.ts

@@ -0,0 +1,14 @@
+export interface ParsedArgs {
+    flags: Record<string, string | boolean>;
+    positionals: string[];
+}
+export declare function argsToArgv(args: ParsedArgs): string[];
+export declare function parseArgs(argv: readonly string[]): ParsedArgs;
+export declare function flagString(args: ParsedArgs, name: string): string | undefined;
+export declare function flagBool(args: ParsedArgs, name: string): boolean;
+export declare function flagNumber(args: ParsedArgs, name: string): number | undefined;
+export declare function flagList(args: ParsedArgs, name: string): string[] | undefined;
+/** Flags accepted by every command, never reported as unknown. */
+export declare const GLOBAL_FLAGS: readonly ["profile", "org", "project", "help", "full", "fields"];
+export declare function assertKnownFlags(args: ParsedArgs, known: readonly string[], commandName: string, helpText?: string): void;
+//# sourceMappingURL=args.d.ts.map

package/dist/lib/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/lib/args.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAGrD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CA6B7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU7E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAO7E;AAED,kEAAkE;AAClE,eAAO,MAAM,YAAY,kEAAmE,CAAC;AAU7F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAWN"}