azdo-cli 0.4.0 → 0.5.0-develop.148

package/README.md

@@ -12,7 +12,7 @@ Azure DevOps CLI focused on work item read/write workflows.
 - Update work item state (`set-state`)
 - Assign and unassign work items (`assign`)
 - Set any work item field by reference name (`set-field`)
-- Create or update Tasks from markdown documents (`upsert`)
+- Create or update work items from markdown documents (`upsert`)
 - Read rich-text fields as markdown (`get-md-field`)
 - Set rich-text fields as markdown from inline text, file, or stdin (`set-md-field`)
 - Check branch pull request status, open PRs to `develop`, and review active comments (`pr`)
@@ -26,6 +26,20 @@ Azure DevOps CLI focused on work item read/write workflows.
 npm install -g azdo-cli
 ```
 
+## Utility Scripts
+
+The repository also includes a helper script for syncing local `.env` entries into GitHub Actions secrets for the current repository:
+
+```bash
+./scripts/sync-env-to-gh-secrets.zsh
+```
+
+It walks upward from the current directory until it finds a `.env`, then sets each valid `KEY=VALUE` entry with `gh secret set`. You can also limit the sync to selected keys:
+
+```bash
+./scripts/sync-env-to-gh-secrets.zsh FOO BAR
+```
+
 ## Authentication and Context Resolution
 
 PAT resolution order:
@@ -51,8 +65,8 @@ azdo get-item 12345
 # 3) Update state
 azdo set-state 12345 "Active"
 
-# 4) Create or update a Task from markdown
-azdo upsert --content $'---\nTitle: Improve markdown import UX\nState: New\n---'
+# 4) Create or update a work item from markdown
+azdo upsert --type "User Story" --content $'---\nTitle: Improve markdown import UX\nState: New\n---'
 ```
 
 ## Command Cheat Sheet
@@ -63,7 +77,7 @@ azdo upsert --content $'---\nTitle: Improve markdown import UX\nState: New\n---'
 | `azdo set-state <id> <state>` | Change work item state | `--json`, `--org`, `--project` |
 | `azdo assign <id> [name]` | Assign or unassign owner | `--unassign`, `--json`, `--org`, `--project` |
 | `azdo set-field <id> <field> <value>` | Update any field | `--json`, `--org`, `--project` |
-| `azdo upsert [id]` | Create or update a Task from markdown | `--content`, `--file`, `--json`, `--org`, `--project` |
+| `azdo upsert [id]` | Create or update a work item from markdown | `--content`, `--file`, `--type`, `--json`, `--org`, `--project` |
 | `azdo get-md-field <id> <field>` | Get field as markdown | `--org`, `--project` |
 | `azdo set-md-field <id> <field> [content]` | Set markdown field | `--file`, `--json`, `--org`, `--project` |
 | `azdo list-fields <id>` | List all fields of a work item | `--json`, `--org`, `--project` |
@@ -88,8 +102,6 @@ azdo get-item 12345 --fields "System.Tags,Microsoft.VSTS.Common.Priority"
 # Convert rich text fields to markdown
 azdo get-item 12345 --markdown
 
-# Disable markdown even if config is on
-azdo get-item 12345 --no-markdown
 ```
 
 ```bash
@@ -118,7 +130,7 @@ azdo list-fields 12345 --json
 
 The `get-item` command can convert HTML rich-text fields to readable markdown. Resolution order:
 
-1. `--markdown` / `--no-markdown` flag (highest priority)
+1. `--markdown` flag enables markdown for the current call
 2. Config setting: `azdo config set markdown true`
 3. Default: off (HTML stripped to plain text)
 
@@ -155,7 +167,7 @@ azdo pr comments
 
 `azdo pr status`
 
-- Lists all pull requests for the current branch, including active, completed, and abandoned PRs
+- Lists pull requests for the current branch
 - Prints `No pull requests found for branch <branch>.` when no PRs exist
 - Supports `--json` for machine-readable output
 
@@ -177,11 +189,14 @@ azdo pr comments
 
 ## azdo upsert
 
-`azdo upsert` accepts a single markdown task document and either creates a new Azure DevOps Task or updates an existing one. Omit `[id]` to create; pass `[id]` to update that work item in place.
+`azdo upsert` accepts a single markdown work-item document and either creates a new Azure DevOps work item or updates an existing one. Omit `[id]` to create; pass `[id]` to update that work item in place. Create mode defaults to `Task`, and `--type <work item type>` lets you create `Bug`, `User Story`, `Feature`, `Epic`, and other Azure DevOps work item types.
 
 ```bash
-# Create from inline content
-azdo upsert --content $'---\nTitle: Improve markdown import UX\nAssigned To: user@example.com\nState: New\n---'
+# Create a Bug from inline content
+azdo upsert --type Bug --content $'---\nTitle: Improve markdown import UX\nAssigned To: user@example.com\nState: New\n---'
+
+# Preserve the default Task create behavior
+azdo upsert --content $'---\nTitle: Follow-up task\nAssigned To: user@example.com\nState: New\n---'
 
 # Update from a file
 azdo upsert 12345 --file ./task-import.md
@@ -194,9 +209,16 @@ The command requires exactly one source flag:
 
 - `azdo upsert [id] --content <markdown>`
 - `azdo upsert [id] --file <path>`
+- `azdo upsert --type <work-item-type> --content <markdown>`
 
 If `--file` succeeds, the source file is deleted after the Azure DevOps write completes. If parsing, validation, or the API call fails, the file is preserved. If deletion fails after a successful write, the command still succeeds and prints a warning.
 
+Type rules:
+
+- `--type` is optional for create and defaults to `Task`.
+- `--type` is only valid when creating a new work item.
+- Human-readable and JSON success output include the resulting work item type.
+
 ### Task Document Format
 
 The document starts with YAML front matter for scalar fields, followed by optional `##` heading sections for markdown rich-text fields.
@@ -245,6 +267,7 @@ Clear semantics:
 {
   "action": "created",
   "id": 12345,
+  "workItemType": "User Story",
   "fields": {
     "System.Title": "Improve markdown import UX",
     "System.Description": "Implement a single-command task import flow."
@@ -288,6 +311,8 @@ These commands support `--json` for machine-readable output:
 - `assign`
 - `set-field`
 - `set-md-field`
+- `upsert`
+- `pr status|open|comments`
 - `config set|get|list|unset`
 
 ## Development

package/dist/index.js

@@ -39,7 +39,15 @@ async function fetchWithErrors(url, init) {
   }
   if (response.status === 401) throw new Error("AUTH_FAILED");
   if (response.status === 403) throw new Error("PERMISSION_DENIED");
-  if (response.status === 404) throw new Error("NOT_FOUND");
+  if (response.status === 404) {
+    let detail = "";
+    try {
+      const body = await response.text();
+      detail = ` | url=${url} | body=${body}`;
+    } catch {
+    }
+    throw new Error(`NOT_FOUND${detail}`);
+  }
   return response;
 }
 async function readResponseMessage(response) {
@@ -633,7 +641,7 @@ function handleCommandError(err, id, context, scope = "write", exit = true) {
       `Error: Access denied. Your PAT may lack ${scope} permissions for project "${context?.project}".
 `
     );
-  } else if (msg === "NOT_FOUND") {
+  } else if (msg.startsWith("NOT_FOUND")) {
     process.stderr.write(
       `Error: Work item ${id} not found in ${context?.org}/${context?.project}.
 `
@@ -1383,7 +1391,7 @@ function buildAppliedFields(fields) {
 function ensureTitleForCreate(fields) {
   const titleField = fields.find((field) => field.refName === "System.Title");
   if (!titleField || titleField.op === "clear" || titleField.value === null || titleField.value.trim() === "") {
-    fail2("Title is required when creating a task.");
+    fail2("Title is required when creating a work item.");
   }
 }
 function writeSuccess(result, options) {
@@ -1395,7 +1403,7 @@ function writeSuccess(result, options) {
   const verb = result.action === "created" ? "Created" : "Updated";
   const fields = Object.keys(result.fields).join(", ");
   const suffix = fields ? ` (${fields})` : "";
-  process.stdout.write(`${verb} task #${result.id}${suffix}
+  process.stdout.write(`${verb} ${result.workItemType} #${result.id}${suffix}
 `);
 }
 function cleanupSourceFile(sourceFile) {
@@ -1409,16 +1417,31 @@ function cleanupSourceFile(sourceFile) {
 `);
   }
 }
-function buildUpsertResult(action, writeResult, fields) {
+function resolveCreateType(id, options) {
+  if (options.type === void 0) {
+    return "Task";
+  }
+  if (id !== void 0) {
+    fail2("--type can only be used when creating a work item.");
+  }
+  const trimmedType = options.type.trim();
+  if (trimmedType === "") {
+    fail2("--type must be a non-empty work item type.");
+  }
+  return trimmedType;
+}
+function buildUpsertResult(action, writeResult, fields, fallbackWorkItemType) {
   const appliedFields = buildAppliedFields(fields);
+  const workItemType = writeResult.fields["System.WorkItemType"];
   return {
     action,
     id: writeResult.id,
+    workItemType: typeof workItemType === "string" && workItemType.trim() !== "" ? workItemType : fallbackWorkItemType,
     fields: appliedFields
   };
 }
 function isUpdateWriteError(err) {
-  return err.message === "AUTH_FAILED" || err.message === "PERMISSION_DENIED" || err.message === "NOT_FOUND" || err.message === "NETWORK_ERROR" || err.message.startsWith("BAD_REQUEST:") || err.message.startsWith("UPDATE_REJECTED:");
+  return err.message === "AUTH_FAILED" || err.message === "PERMISSION_DENIED" || err.message.startsWith("NOT_FOUND") || err.message === "NETWORK_ERROR" || err.message.startsWith("BAD_REQUEST:") || err.message.startsWith("UPDATE_REJECTED:");
 }
 function isCreateWriteError(err) {
   return err.message === "AUTH_FAILED" || err.message === "PERMISSION_DENIED" || err.message === "NETWORK_ERROR" || err.message.startsWith("BAD_REQUEST:") || err.message.startsWith("HTTP_");
@@ -1448,10 +1471,11 @@ function handleUpsertError(err, id, context) {
 }
 function createUpsertCommand() {
   const command = new Command9("upsert");
-  command.description("Create or update a Task from a markdown document").argument("[id]", "work item ID to update; omit to create a new Task").option("--content <markdown>", "task document content").option("--file <path>", "read task document from file").option("--json", "output result as JSON").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(async (idStr, options) => {
+  command.description("Create or update a work item from a markdown document").argument("[id]", "work item ID to update; omit to create a new work item").option("--content <markdown>", "task document content").option("--file <path>", "read task document from file").option("--type <workItemType>", "create mode work item type (defaults to Task)").option("--json", "output result as JSON").option("--org <org>", "Azure DevOps organization").option("--project <project>", "Azure DevOps project").action(async (idStr, options) => {
     validateOrgProjectPair(options);
     const id = idStr === void 0 ? void 0 : parseWorkItemId(idStr);
     const { content, sourceFile } = loadSourceContent(options);
+    const createType = resolveCreateType(id, options);
     let context;
     try {
       context = resolveContext(options);
@@ -1464,14 +1488,19 @@ function createUpsertCommand() {
       const credential = await resolvePat();
       let writeResult;
       if (action === "created") {
-        writeResult = await createWorkItem(context, "Task", credential.pat, operations);
+        writeResult = await createWorkItem(context, createType, credential.pat, operations);
       } else {
         if (id === void 0) {
           fail2("Work item ID is required for updates.");
         }
         writeResult = await applyWorkItemPatch(context, id, credential.pat, operations);
       }
-      const result = buildUpsertResult(action, writeResult, document.fields);
+      const result = buildUpsertResult(
+        action,
+        writeResult,
+        document.fields,
+        action === "created" ? createType : "Work item"
+      );
       writeSuccess(result, options);
       cleanupSourceFile(sourceFile);
     } catch (err) {
@@ -1684,7 +1713,7 @@ function handlePrCommandError(err, context, mode = "read") {
   if (error.message === "NETWORK_ERROR") {
     writeError("Could not connect to Azure DevOps. Check your network connection.");
   }
-  if (error.message === "NOT_FOUND") {
+  if (error.message.startsWith("NOT_FOUND")) {
     writeError(`Azure DevOps repository not found in ${context?.org}/${context?.project}.`);
   }
   if (error.message.startsWith("HTTP_")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.4.0",
+  "version": "0.5.0-develop.148",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
     "typecheck": "tsc --noEmit",
     "format": "prettier --check src/",
     "test": "npm run build && vitest run tests/unit",
-    "test:integration": "npm run build && vitest run tests/integration"
+    "test:integration": "npm run build && vitest run tests/integration",
+    "test:integration:full": "bash scripts/setup-keyring.sh && npm run test:integration"
   },
   "repository": {
     "type": "git",