@leeguoo/zentao-mcp 0.5.0 → 0.5.1

package/README.md

@@ -46,24 +46,48 @@ List products:
 zentao products list
 ```
 
+Full JSON output:
+
+```bash
+zentao products list --json
+```
+
 List bugs for a product:
 
 ```bash
 zentao bugs list --product 1
 ```
 
+Full JSON output:
+
+```bash
+zentao bugs list --product 1 --json
+```
+
 Get bug details:
 
 ```bash
 zentao bug get --id 123
 ```
 
+Full JSON output:
+
+```bash
+zentao bug get --id 123 --json
+```
+
 List my bugs:
 
 ```bash
 zentao bugs mine --scope assigned --status active
 ```
 
+Full JSON output:
+
+```bash
+zentao bugs mine --scope assigned --status active --json
+```
+
 Self test:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeguoo/zentao-mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "ZenTao CLI for products + bugs",
   "keywords": [
     "zentao",

package/skills/zentao-cli.md

@@ -42,24 +42,48 @@ Or via CLI flags:
 zentao products list
 ```
 
+Full JSON output:
+
+```bash
+zentao products list --json
+```
+
 ### List bugs for a product
 
 ```bash
 zentao bugs list --product 1
 ```
 
+Full JSON output:
+
+```bash
+zentao bugs list --product 1 --json
+```
+
 ### Get bug details
 
 ```bash
 zentao bug get --id 123
 ```
 
+Full JSON output:
+
+```bash
+zentao bug get --id 123 --json
+```
+
 ### List my bugs
 
 ```bash
 zentao bugs mine --scope assigned --status active
 ```
 
+Full JSON output:
+
+```bash
+zentao bugs mine --scope assigned --status active --json
+```
+
 Common options:
 
 - `--scope`: `assigned|opened|resolved|all`

package/src/cli/help.js

@@ -4,10 +4,10 @@ export function printRootHelp() {
   process.stdout.write(`Usage:\n`);
   process.stdout.write(`  zentao login [--zentao-url ... --zentao-account ... --zentao-password ...] [--yes]\n`);
   process.stdout.write(`  zentao whoami\n`);
-  process.stdout.write(`  zentao products list [--page N] [--limit N]\n`);
-  process.stdout.write(`  zentao bugs list --product <id> [--page N] [--limit N]\n`);
-  process.stdout.write(`  zentao bug get --id <bugId>\n`);
-  process.stdout.write(`  zentao bugs mine [--scope ...] [--status ...] [--include-details]\n`);
+  process.stdout.write(`  zentao products list [--page N] [--limit N] [--json]\n`);
+  process.stdout.write(`  zentao bugs list --product <id> [--page N] [--limit N] [--json]\n`);
+  process.stdout.write(`  zentao bug get --id <bugId> [--json]\n`);
+  process.stdout.write(`  zentao bugs mine [--scope ...] [--status ...] [--include-details] [--json]\n`);
   process.stdout.write(`  zentao self-test [--expected N]\n`);
   process.stdout.write(`  zentao release [patch|minor|major] [--dry-run] [--yes]\n\n`);
   process.stdout.write(`Auth options:\n`);

package/src/commands/bug.js

@@ -3,9 +3,40 @@ import { extractCommand, hasHelpFlag, parseCliArgs } from "../cli/args.js";
 import { createClientFromCli } from "../zentao/client.js";
 
 function printHelp() {
-  process.stdout.write(`zentao-mcp bug get\n\n`);
+  process.stdout.write(`zentao bug get\n\n`);
   process.stdout.write(`Usage:\n`);
-  process.stdout.write(`  zentao-mcp bug get --id <bugId>\n`);
+  process.stdout.write(`  zentao bug get --id <bugId> [--json]\n`);
+}
+
+function formatAccount(value) {
+  if (!value) return "";
+  if (typeof value === "string" || typeof value === "number") return String(value);
+  if (typeof value === "object") return String(value.account || value.name || value.realname || "");
+  return "";
+}
+
+export function formatBugSimple(bug) {
+  const header = [
+    "id",
+    "title",
+    "status",
+    "pri",
+    "severity",
+    "assignedTo",
+    "openedBy",
+    "resolvedBy",
+  ].join("\t");
+  const row = [
+    String(bug?.id ?? ""),
+    String(bug?.title ?? ""),
+    String(bug?.status ?? ""),
+    String(bug?.pri ?? ""),
+    String(bug?.severity ?? ""),
+    formatAccount(bug?.assignedTo),
+    formatAccount(bug?.openedBy),
+    formatAccount(bug?.resolvedBy),
+  ].join("\t");
+  return `${header}\n${row}\n`;
 }
 
 export async function runBug({ argv = [], env = process.env } = {}) {
@@ -23,5 +54,16 @@ export async function runBug({ argv = [], env = process.env } = {}) {
 
   const api = createClientFromCli({ argv: argvWithoutSub, env });
   const result = await api.getBug({ id });
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  if (cliArgs.json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  const bug = result?.result?.bug;
+  if (!bug || typeof bug !== "object") {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  process.stdout.write(formatBugSimple(bug));
 }

package/src/commands/bugs.js

@@ -18,10 +18,62 @@ function parseCsvIntegers(value) {
 }
 
 function printHelp() {
-  process.stdout.write(`zentao-mcp bugs <subcommand>\n\n`);
+  process.stdout.write(`zentao bugs <subcommand>\n\n`);
   process.stdout.write(`Usage:\n`);
-  process.stdout.write(`  zentao-mcp bugs list --product <id> [--page N] [--limit N]\n`);
-  process.stdout.write(`  zentao-mcp bugs mine [--scope assigned|opened|resolved|all] [--status active|resolved|closed|all] [--include-details]\n`);
+  process.stdout.write(`  zentao bugs list --product <id> [--page N] [--limit N] [--json]\n`);
+  process.stdout.write(`  zentao bugs mine [--scope assigned|opened|resolved|all] [--status active|resolved|closed|all] [--include-details] [--json]\n`);
+}
+
+function formatAccount(value) {
+  if (!value) return "";
+  if (typeof value === "string" || typeof value === "number") return String(value);
+  if (typeof value === "object") return String(value.account || value.name || value.realname || "");
+  return "";
+}
+
+export function formatBugsSimple(bugs) {
+  const rows = [];
+  rows.push(["id", "title", "status", "pri", "severity", "assignedTo"].join("\t"));
+  for (const bug of bugs) {
+    rows.push(
+      [
+        String(bug?.id ?? ""),
+        String(bug?.title ?? ""),
+        String(bug?.status ?? ""),
+        String(bug?.pri ?? ""),
+        String(bug?.severity ?? ""),
+        formatAccount(bug?.assignedTo),
+      ].join("\t")
+    );
+  }
+  return `${rows.join("\n")}\n`;
+}
+
+export function formatBugsMineSimple(result) {
+  const total = result?.total ?? 0;
+  const products = Array.isArray(result?.products) ? result.products : [];
+  const rows = [];
+  rows.push(`total\t${total}`);
+  rows.push(["id", "name", "myBugs", "totalBugs"].join("\t"));
+  for (const product of products) {
+    rows.push(
+      [
+        String(product?.id ?? ""),
+        String(product?.name ?? ""),
+        String(product?.myBugs ?? ""),
+        String(product?.totalBugs ?? ""),
+      ].join("\t")
+    );
+  }
+
+  const bugs = Array.isArray(result?.bugs) ? result.bugs : [];
+  if (bugs.length) {
+    rows.push("");
+    rows.push("bugs");
+    rows.push(formatBugsSimple(bugs).trimEnd());
+  }
+
+  return `${rows.join("\n")}\n`;
 }
 
 export async function runBugs({ argv = [], env = process.env } = {}) {
@@ -42,7 +94,19 @@ export async function runBugs({ argv = [], env = process.env } = {}) {
       page: cliArgs.page,
       limit: cliArgs.limit,
     });
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+
+    if (cliArgs.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+      return;
+    }
+
+    const bugs = result?.result?.bugs;
+    if (!Array.isArray(bugs)) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+      return;
+    }
+
+    process.stdout.write(formatBugsSimple(bugs));
     return;
   }
 
@@ -60,7 +124,13 @@ export async function runBugs({ argv = [], env = process.env } = {}) {
       maxItems: cliArgs["max-items"],
       includeDetails,
     });
-    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+
+    if (cliArgs.json) {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+      return;
+    }
+
+    process.stdout.write(formatBugsMineSimple(result?.result));
     return;
   }
 

package/src/commands/products.js

@@ -3,9 +3,28 @@ import { extractCommand, hasHelpFlag, parseCliArgs } from "../cli/args.js";
 import { createClientFromCli } from "../zentao/client.js";
 
 function printHelp() {
-  process.stdout.write(`zentao-mcp products list\n\n`);
+  process.stdout.write(`zentao products list\n\n`);
   process.stdout.write(`Usage:\n`);
-  process.stdout.write(`  zentao-mcp products list [--page N] [--limit N] [--json]\n`);
+  process.stdout.write(`  zentao products list [--page N] [--limit N] [--json]\n`);
+  process.stdout.write(`\n`);
+  process.stdout.write(`Options:\n`);
+  process.stdout.write(`  --json               print full JSON payload\n`);
+}
+
+export function formatProductsSimple(products) {
+  const rows = [];
+  rows.push(["id", "name", "totalBugs", "status"].join("\t"));
+  for (const product of products) {
+    rows.push(
+      [
+        String(product.id ?? ""),
+        String(product.name ?? ""),
+        String(product.totalBugs ?? product.totalBugsCount ?? ""),
+        String(product.status ?? product.productStatus ?? ""),
+      ].join("\t")
+    );
+  }
+  return `${rows.join("\n")}\n`;
 }
 
 export async function runProducts({ argv = [], env = process.env } = {}) {
@@ -23,5 +42,17 @@ export async function runProducts({ argv = [], env = process.env } = {}) {
     page: cliArgs.page,
     limit: cliArgs.limit,
   });
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+
+  if (cliArgs.json) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  const products = result?.result?.products;
+  if (!Array.isArray(products)) {
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+    return;
+  }
+
+  process.stdout.write(formatProductsSimple(products));
 }