azdo-cli 0.2.0-develop.137 → 0.2.0-develop.141

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`)
@@ -65,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
@@ -77,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` |
@@ -189,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
@@ -206,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.
@@ -257,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."

package/dist/index.js

@@ -1391,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) {
@@ -1403,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) {
@@ -1417,11 +1417,26 @@ 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
   };
 }
@@ -1456,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);
@@ -1472,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azdo-cli",
-  "version": "0.2.0-develop.137",
+  "version": "0.2.0-develop.141",
   "description": "Azure DevOps CLI tool",
   "type": "module",
   "bin": {