@hangox/pm-cli 0.2.3 → 0.2.5

package/dist/index.js

@@ -1148,10 +1148,183 @@ function parsePmLink(url) {
   return null;
 }
 
+// src/utils/issue-exporter.ts
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync2, statSync } from "fs";
+import { join as join2 } from "path";
+
+// src/utils/preset-extractor.ts
+var SUMMARY_CUSTOM_FIELD_IDS = [84];
+var STANDARD_CUSTOM_FIELD_IDS = [
+  84,
+  // 预计提测时间
+  286,
+  // 需求大类
+  186,
+  // 业务目标
+  77,
+  // 需求来源
+  274,
+  // 开发结束时间
+  19,
+  // 跟进QA
+  86,
+  // 需求延误
+  87
+  // 需求变更
+];
+function extractSummaryFields(issue) {
+  const rawIssue = issue;
+  const rawStatus = rawIssue.status;
+  const status = rawStatus ? { id: rawStatus.id ?? 0, name: rawStatus.name ?? "" } : { id: 0, name: "" };
+  const rawAssignedTo = rawIssue.assigned_to;
+  const assigned_to = rawAssignedTo ? { id: rawAssignedTo.id ?? 0, name: rawAssignedTo.name ?? "" } : void 0;
+  const rawCustomFields = rawIssue.custom_fields;
+  const custom_fields = (rawCustomFields || []).filter((cf) => SUMMARY_CUSTOM_FIELD_IDS.includes(cf.id)).map((cf) => ({ id: cf.id, name: cf.name, value: cf.value }));
+  return {
+    id: issue.id,
+    subject: issue.subject,
+    status,
+    assigned_to,
+    estimated_hours: issue.estimated_hours,
+    spent_hours: issue.spent_hours,
+    done_ratio: issue.done_ratio,
+    custom_fields
+  };
+}
+function extractStandardFields(issue) {
+  const rawIssue = issue;
+  const rawStatus = rawIssue.status;
+  const status = rawStatus ? { id: rawStatus.id ?? 0, name: rawStatus.name ?? "", is_closed: rawStatus.is_closed } : { id: 0, name: "" };
+  const rawAssignedTo = rawIssue.assigned_to;
+  const assigned_to = rawAssignedTo ? { id: rawAssignedTo.id ?? 0, name: rawAssignedTo.name ?? "", mail: rawAssignedTo.mail } : void 0;
+  const rawPriority = rawIssue.priority;
+  const priority = rawPriority ? { id: rawPriority.id ?? 0, name: rawPriority.name ?? "" } : void 0;
+  const rawTracker = rawIssue.tracker;
+  const tracker = rawTracker ? { id: rawTracker.id ?? 0, name: rawTracker.name ?? "" } : void 0;
+  const rawProject = rawIssue.project;
+  const project = rawProject ? { id: rawProject.id ?? 0, name: rawProject.name ?? "" } : void 0;
+  const rawCustomFields = rawIssue.custom_fields;
+  const custom_fields = (rawCustomFields || []).filter((cf) => STANDARD_CUSTOM_FIELD_IDS.includes(cf.id)).map((cf) => ({ id: cf.id, name: cf.name, value: cf.value }));
+  return {
+    id: issue.id,
+    subject: issue.subject,
+    status,
+    assigned_to,
+    estimated_hours: issue.estimated_hours,
+    spent_hours: issue.spent_hours,
+    done_ratio: issue.done_ratio,
+    priority,
+    tracker,
+    project,
+    created_on: issue.created_on,
+    updated_on: issue.updated_on,
+    custom_fields
+  };
+}
+function extractCompleteFields(issue) {
+  const rawIssue = issue;
+  const result = {};
+  for (const key of Object.keys(rawIssue)) {
+    if (key !== "children") {
+      result[key] = rawIssue[key];
+    }
+  }
+  return result;
+}
+function generateSummaryTree(issue, currentDepth = 0, maxDepth = -1) {
+  const node = extractSummaryFields(issue);
+  if (maxDepth !== -1 && currentDepth >= maxDepth) {
+    node.children = [];
+    return node;
+  }
+  if (issue.children && issue.children.length > 0) {
+    node.children = issue.children.map(
+      (child) => generateSummaryTree(child, currentDepth + 1, maxDepth)
+    );
+  } else {
+    node.children = [];
+  }
+  return node;
+}
+function flattenIssues(issue, result = []) {
+  result.push(issue);
+  if (issue.children) {
+    for (const child of issue.children) {
+      flattenIssues(child, result);
+    }
+  }
+  return result;
+}
+
+// src/utils/issue-exporter.ts
+function generateExportDir(command, identifier) {
+  const now = /* @__PURE__ */ new Date();
+  const timestamp = now.getFullYear().toString() + (now.getMonth() + 1).toString().padStart(2, "0") + now.getDate().toString().padStart(2, "0") + now.getHours().toString().padStart(2, "0") + now.getMinutes().toString().padStart(2, "0") + now.getSeconds().toString().padStart(2, "0");
+  return `/tmp/pm-cli_${command}_${identifier}_${timestamp}`;
+}
+async function exportIssuePresets(issue, exportDir, options = {}) {
+  const { depth = -1, pretty = false } = options;
+  const indent = pretty ? 2 : 0;
+  mkdirSync2(exportDir, { recursive: true });
+  mkdirSync2(join2(exportDir, "standard"), { recursive: true });
+  mkdirSync2(join2(exportDir, "complete"), { recursive: true });
+  const resultFiles = [];
+  const summaryTree = generateSummaryTree(issue, 0, depth);
+  const summaryPath = join2(exportDir, "tree.summary.json");
+  writeFileSync3(summaryPath, JSON.stringify(summaryTree, null, indent), "utf-8");
+  const summarySize = statSync(summaryPath).size;
+  resultFiles.push({ path: "tree.summary.json", size: summarySize, type: "tree" });
+  const allIssues = flattenIssues(issue);
+  for (const iss of allIssues) {
+    const standardData = extractStandardFields(iss);
+    const standardPath = join2(exportDir, "standard", `${iss.id}.json`);
+    writeFileSync3(standardPath, JSON.stringify(standardData, null, indent), "utf-8");
+    const standardSize = statSync(standardPath).size;
+    resultFiles.push({ path: `standard/${iss.id}.json`, size: standardSize, type: "standard" });
+  }
+  for (const iss of allIssues) {
+    const completeData = extractCompleteFields(iss);
+    const completePath = join2(exportDir, "complete", `${iss.id}.json`);
+    writeFileSync3(completePath, JSON.stringify(completeData, null, indent), "utf-8");
+    const completeSize = statSync(completePath).size;
+    resultFiles.push({ path: `complete/${iss.id}.json`, size: completeSize, type: "complete" });
+  }
+  const totalSize = resultFiles.reduce((sum, f) => sum + f.size, 0);
+  return {
+    success: true,
+    exportDir,
+    fileCount: resultFiles.length,
+    totalSize,
+    files: resultFiles
+  };
+}
+function generateAIGuideOutput(exportDir, fileCount, totalSize) {
+  const sizeKB = (totalSize / 1024).toFixed(2);
+  return `
+\u2705 \u5BFC\u51FA\u5B8C\u6210\uFF01
+  \u{1F4C2} ${exportDir}/
+  \u{1F4CA} ${fileCount} \u4E2A\u6587\u4EF6, ${sizeKB} KB
+
+\u{1F916} AI \u8BFB\u53D6\u6307\u5357:
+  1\uFE0F\u20E3 \u5148\u8BFB tree.summary.json \u2192 \u83B7\u53D6\u4EFB\u52A1\u6811 + \u7236\u5B50\u5173\u7CFB + \u57FA\u672C\u4FE1\u606F
+  2\uFE0F\u20E3 \u9700\u8981\u8BE6\u60C5\u65F6 \u2192 \u8BFB standard/{id}.json \u6216 complete/{id}.json
+
+  \u{1F4D6} \u5B57\u6BB5\u7EA7\u522B:
+     \u2022 summary  = id, subject, status, assigned_to, \u5DE5\u65F6, \u9884\u8BA1\u63D0\u6D4B\u65F6\u95F4
+     \u2022 standard = summary + priority, tracker, project, \u65F6\u95F4\u6233, 8\u4E2A\u81EA\u5B9A\u4E49\u5B57\u6BB5
+     \u2022 complete = \u5168\u90E8\u5B57\u6BB5\uFF08\u542B description, author, journals \u7B49\uFF09
+
+  \u{1F4A1} Token \u4F18\u5316:
+     \u2022 \u53EA\u770B\u4EFB\u52A1\u5217\u8868/\u8FDB\u5EA6 \u2192 tree.summary.json (~5k tokens)
+     \u2022 \u5355\u4EFB\u52A1\u4F18\u5148\u7EA7/\u6765\u6E90 \u2192 standard/{id}.json (~3k tokens)
+     \u2022 \u4EFB\u52A1\u8BE6\u7EC6\u63CF\u8FF0/\u5386\u53F2 \u2192 complete/{id}.json (~11k tokens)
+`.trim();
+}
+
 // src/commands/issue/index.ts
 function createIssueCommand() {
   const issueCmd = new Command3("issue").description("\u95EE\u9898\u7BA1\u7406");
-  issueCmd.command("get [id]").description("\u83B7\u53D6\u95EE\u9898\u8BE6\u60C5\uFF08\u9ED8\u8BA4\u9012\u5F52\u83B7\u53D6\u5B50\u5355\uFF0C\u8F93\u51FA\u5230\u6587\u4EF6\uFF09").option("--url <url>", "PM \u94FE\u63A5").option("--token <token>", "API Token").option("--host <host>", "PM \u4E3B\u673A\u5730\u5740").option("--project <project>", "\u9879\u76EE\u540D\u79F0").option("--profile <name>", "\u4F7F\u7528\u914D\u7F6E profile").option("--config <path>", "\u81EA\u5B9A\u4E49\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--depth <depth>", "\u9012\u5F52\u83B7\u53D6\u5B50\u5355\u7684\u6DF1\u5EA6\uFF080 \u8868\u793A\u4E0D\u83B7\u53D6\u5B50\u5355\uFF09", "10").option("-o, --output <path>", "\u8F93\u51FA JSON \u5230\u6307\u5B9A\u6587\u4EF6\uFF08\u9ED8\u8BA4\u8F93\u51FA\u5230 /tmp\uFF09").option("--stdout", "\u5F3A\u5236\u8F93\u51FA\u5230\u63A7\u5236\u53F0\u800C\u975E\u6587\u4EF6").option("--include-relations", "\u5305\u542B\u5173\u8054\u95EE\u9898").option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09").action(async (id, options) => {
+  issueCmd.command("get [id]").description("\u83B7\u53D6\u95EE\u9898\u8BE6\u60C5\uFF08\u9ED8\u8BA4\u5206\u7EA7\u5BFC\u51FA\uFF0C--raw \u8F93\u51FA\u5B8C\u6574 JSON\uFF09").option("--url <url>", "PM \u94FE\u63A5").option("--token <token>", "API Token").option("--host <host>", "PM \u4E3B\u673A\u5730\u5740").option("--project <project>", "\u9879\u76EE\u540D\u79F0").option("--profile <name>", "\u4F7F\u7528\u914D\u7F6E profile").option("--config <path>", "\u81EA\u5B9A\u4E49\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--depth <depth>", "\u9012\u5F52\u83B7\u53D6\u5B50\u5355\u7684\u6DF1\u5EA6\uFF080 \u8868\u793A\u4E0D\u83B7\u53D6\u5B50\u5355\uFF09", "10").option("-o, --output <path>", "\u8F93\u51FA\u76EE\u5F55\u6216\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 /tmp\uFF09").option("--stdout", "\u5F3A\u5236\u8F93\u51FA\u5230\u63A7\u5236\u53F0\u800C\u975E\u6587\u4EF6").option("--raw", "\u8F93\u51FA\u5B8C\u6574 JSON \u6587\u4EF6\uFF08\u4E0D\u5206\u7EA7\uFF0C\u539F\u884C\u4E3A\uFF09").option("--include-relations", "\u5305\u542B\u5173\u8054\u95EE\u9898").option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09").action(async (id, options) => {
     let issueId;
     let host;
     if (options.url) {
@@ -1192,13 +1365,31 @@ function createIssueCommand() {
         depth
       );
       if (result.success && result.data) {
-        smartOutput(result.data, {
-          stdout: options.stdout,
-          output: options.output,
-          command: "issue-get",
-          identifier: issueId.toString(),
-          pretty: options.pretty
-        });
+        if (options.raw || options.stdout) {
+          smartOutput(result.data, {
+            stdout: options.stdout,
+            output: options.output,
+            command: "issue-get",
+            identifier: issueId.toString(),
+            pretty: options.pretty
+          });
+        } else {
+          const exportDir = options.output || generateExportDir("issue-get", issueId.toString());
+          const exportResult = await exportIssuePresets(result.data, exportDir, {
+            depth,
+            pretty: options.pretty
+          });
+          if (exportResult.success) {
+            console.log(generateAIGuideOutput(
+              exportResult.exportDir,
+              exportResult.fileCount,
+              exportResult.totalSize
+            ));
+          } else {
+            outputError("\u5BFC\u51FA\u5931\u8D25", options.pretty);
+            process.exit(1);
+          }
+        }
       } else {
         outputError(result.message || result.msg || result.api_error_msg || "\u83B7\u53D6\u95EE\u9898\u5931\u8D25", options.pretty);
         process.exit(1);
@@ -1847,7 +2038,7 @@ function getWeekDateRange(week) {
 }
 function createTimeCommand() {
   const timeCmd = new Command4("time").description("\u5DE5\u65F6\u7BA1\u7406");
-  timeCmd.command("list").description("\u67E5\u8BE2\u5DE5\u65F6\u6761\u76EE").option("--from <date>", "\u5F00\u59CB\u65E5\u671F (YYYY-MM-DD)").option("--to <date>", "\u7ED3\u675F\u65E5\u671F (YYYY-MM-DD)").option("--user-id <id>", "\u7528\u6237 ID").option("--activity-id <id>", "\u6D3B\u52A8\u7C7B\u578B ID").option("--limit <limit>", "\u8FD4\u56DE\u6570\u91CF\u9650\u5236").option("--offset <offset>", "\u504F\u79FB\u91CF").option("--all-projects", "\u67E5\u8BE2\u6240\u6709\u9879\u76EE\u7684\u5DE5\u65F6").option("--token <token>", "API Token").option("--host <host>", "PM \u4E3B\u673A\u5730\u5740").option("--project <project>", "\u9879\u76EE\u540D\u79F0").option("--profile <name>", "\u4F7F\u7528\u914D\u7F6E profile").option("--config <path>", "\u81EA\u5B9A\u4E49\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09").action(async (options) => {
+  timeCmd.command("list").description("\u67E5\u8BE2\u5DE5\u65F6\u6761\u76EE").option("--from <date>", "\u5F00\u59CB\u65E5\u671F (YYYY-MM-DD)").option("--to <date>", "\u7ED3\u675F\u65E5\u671F (YYYY-MM-DD)").option("--user-id <id>", "\u7528\u6237 ID").option("--activity-id <id>", "\u6D3B\u52A8\u7C7B\u578B ID").option("--limit <limit>", "\u8FD4\u56DE\u6570\u91CF\u9650\u5236").option("--offset <offset>", "\u504F\u79FB\u91CF").option("--all-projects", "\u67E5\u8BE2\u6240\u6709\u9879\u76EE\u7684\u5DE5\u65F6").option("--all-user", "\u67E5\u8BE2\u6240\u6709\u7528\u6237\u7684\u5DE5\u65F6\uFF08\u4E0D\u7B5B\u9009\uFF0C\u9ED8\u8BA4\u53EA\u67E5\u8BE2\u5F53\u524D\u7528\u6237\uFF09").option("--token <token>", "API Token").option("--host <host>", "PM \u4E3B\u673A\u5730\u5740").option("--project <project>", "\u9879\u76EE\u540D\u79F0").option("--profile <name>", "\u4F7F\u7528\u914D\u7F6E profile").option("--config <path>", "\u81EA\u5B9A\u4E49\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84").option("--pretty", "\u683C\u5F0F\u5316\u8F93\u51FA JSON\uFF08\u9ED8\u8BA4\u538B\u7F29\uFF09").action(async (options) => {
     const creds = resolveCredentials(options);
     const requiredFields = options.allProjects ? ["token", "host"] : ["token", "host", "project"];
     const validation = validateCredentials(creds, requiredFields);
@@ -1865,6 +2056,24 @@ function createTimeCommand() {
       const projects = projectsResult.data;
       const projectNames = Object.values(projects).map((p) => p.name);
       logger_default.info(`\u627E\u5230 ${projectNames.length} \u4E2A\u9879\u76EE`);
+      let userId;
+      if (!options.allUser) {
+        if (options.userId) {
+          userId = parseInt(options.userId, 10);
+        } else {
+          const configUserId = getConfigValue("userId", options.config);
+          if (configUserId) {
+            userId = parseInt(configUserId, 10);
+            logger_default.info(`\u4F7F\u7528\u914D\u7F6E\u4E2D\u7684\u7528\u6237 ID: ${userId}`);
+          } else {
+            outputError("\u672A\u914D\u7F6E\u7528\u6237 ID\uFF0C\u8BF7\u5148\u8BBE\u7F6E: pm-cli config set user-id <\u60A8\u7684\u7528\u6237ID>\uFF0C\u6216\u4F7F\u7528 --all-user \u67E5\u8BE2\u6240\u6709\u7528\u6237", options.pretty);
+            process.exit(1);
+          }
+        }
+      } else if (options.userId) {
+        userId = parseInt(options.userId, 10);
+        logger_default.info(`\u4F7F\u7528\u6307\u5B9A\u7684\u7528\u6237 ID: ${userId}`);
+      }
       const allTimeEntries = [];
       let totalCount = 0;
       const projectSummary = [];
@@ -1875,7 +2084,7 @@ function createTimeCommand() {
           project: projectName,
           from_date: options.from,
           to_date: options.to,
-          user_id: options.userId ? parseInt(options.userId, 10) : void 0,
+          user_id: userId,
           activity_id: options.activityId ? parseInt(options.activityId, 10) : void 0,
           limit: options.limit ? parseInt(options.limit, 10) : 100,
           offset: options.offset ? parseInt(options.offset, 10) : void 0
@@ -2233,11 +2442,11 @@ function createProjectCommand() {
 
 // src/index.ts
 import { readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
+import { dirname as dirname2, join as join3 } from "path";
 import { fileURLToPath } from "url";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname2(__filename);
-var packageJson = JSON.parse(readFileSync2(join2(__dirname, "../package.json"), "utf-8"));
+var packageJson = JSON.parse(readFileSync2(join3(__dirname, "../package.json"), "utf-8"));
 var version = packageJson.version;
 var program = new Command6();
 program.name("pm-cli").description("\u7F51\u6613\u6613\u534F\u4F5C (PM NetEase) \u547D\u4EE4\u884C\u5DE5\u5177").version(version).option("--verbose", "\u8BE6\u7EC6\u8F93\u51FA").option("--debug", "\u8C03\u8BD5\u6A21\u5F0F").option("--no-mapping", "\u4E0D\u8F93\u51FA key \u6620\u5C04\u8868\uFF08\u9ED8\u8BA4\u8F93\u51FA\uFF09").hook("preAction", (thisCommand) => {