ai-git-tools 2.1.6 → 2.1.8

package/README.md

@@ -350,9 +350,13 @@ ai-git-tools redmine-update --apply --from redmine-update.json
 
 `--pr <number>` 是可選的補充 evidence，會加入 PR title、body、URL、merge state、commits 與 changed files；沒有 PR 仍可完整分析本機 Git diff。沒有 PR 時，工具不會自動推論已 merge、已部署或必須關閉 Issue。
 
-Preview 會以色彩分開顯示每個 Issue 的開發內容、程式修改重點、API 變更、重要技術細節、修改檔案與實際 note。狀態由 Redmine API 提供選單，只有使用者選擇的 status 才會寫入。
+執行過程會顯示目前階段，例如 Redmine 設定、Git evidence、PR 搜尋、每個 Issue 讀取、Copilot 分析與草稿產生進度。未指定 `--pr` 時，工具會依目前 branch 自動尋找對應的 GitHub PR；找不到時只省略 PR 資訊，不會影響本機 Git 分析。
 
-原始 Issue description 會保留原始內容；AI 可產生多張流程圖，每張流程圖都有穩定的用途 ID。相同 ID 會更新原流程圖，不同 ID 會追加新流程圖；既有沒有 ID 的 Mermaid 會保留，內容相同時不重複追加。更新摘要會寫入 notes，並使用 Markdown 標題、項目符號與雙反引號標示程式路徑、API path、function 與 class。只有找到明確測試或驗證證據時才會加入驗證段落；流程圖會使用 Redmine Mermaid macro 並放在 description（公司 Redmine 的 notes 不支援 Mermaid）：
+notes 的 `### Git` 區塊會將 Branch 與 Base 連到對應的 GitHub branch；找到 PR 時也會顯示可點擊的 PR URL，找不到 PR 時不會顯示 PR 欄位。
+
+Preview 會以色彩分開顯示每個 Issue 的開發內容、程式修改重點、API 變更、重要技術細節、修改檔案與實際 note。工具會從 Redmine API 找到 `已解決` 狀態並直接套用，不顯示互動式狀態選單。
+
+原始 Issue description 會保留原始內容，供未來其它內容使用。AI 可產生多張流程圖，每張流程圖都有穩定的用途 ID，流程圖會放在 notes（公司 Redmine 已支援 notes Mermaid）。更新摘要會使用 Markdown 標題、項目符號與雙反引號標示程式路徑、API path、function 與 class。只有找到明確測試或驗證證據時才會加入驗證段落：
 
 ```text
 {{mermaid
@@ -362,9 +366,9 @@ flowchart TD
 }}
 ```
 
-Issue note 的基本責任分工如下：`description` 保存原始需求，`status` 保存目前狀態，`notes` 保存 Git 開發與同步紀錄。
+Issue 的基本責任分工如下：`description` 保存原始需求與未來其它內容，`status` 保存目前狀態，`notes` 保存 Git 開發紀錄與 Mermaid 流程圖。
 
-當 preview 選擇「已解決」後套用，工具會同步將完成百分比設為 `100%`，並依欄位名稱找到 `程式碼更版進度` custom field，勾選測試機選項 `測`。custom field ID 會從 Issue API 動態取得，不會寫死公司 Redmine 的 ID。
+當 preview 套用時，工具會直接將狀態設為 `已解決`，並同步將完成百分比設為 `100%`、完成日期設為執行當天，依欄位名稱找到 `程式碼更版進度` custom field，勾選測試機選項 `測`。custom field ID 會從 Issue API 動態取得，不會寫死公司 Redmine 的 ID。
 
 同一個 Issue 若已經有先前的 notes，後續再次執行更新仍會新增一筆新的 Redmine journal，不會因為已有 notes 而略過；只有 Issue 的需求內容或狀態在產生草稿後被其他人修改時，才會停下來要求重新確認。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.1.6",
+  "version": "2.1.8",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",

package/src/commands/redmine-update.js

@@ -4,9 +4,14 @@
 
 import { readFileSync, writeFileSync } from 'fs';
 import { loadConfig } from '../core/config-loader.js';
-import { collectGitEvidence, collectPullRequestEvidence } from '../redmine/git-evidence.js';
+import {
+  collectGitEvidence,
+  collectPullRequestEvidence,
+  findCurrentPullRequestEvidence,
+} from '../redmine/git-evidence.js';
 import { buildRedmineConfig } from '../redmine/config.js';
 import { RedmineClient } from '../redmine/redmine-client.js';
+import { Logger } from '../utils/logger.js';
 import {
   applyRedmineDraft,
   generateRedmineDraft,
@@ -15,6 +20,37 @@ import {
 } from '../redmine/issue-sync.js';
 import { formatRedminePreview as renderPreview } from '../redmine/redmine-formatters.js';
 
+const logger = new Logger();
+
+function countLines(value) {
+  return String(value || '').split('\n').filter(Boolean).length;
+}
+
+function printProgress(progress) {
+  switch (progress.phase) {
+    case 'read-issue':
+      logger.step(`[${progress.index}/${progress.total}] 讀取 Redmine Issue #${progress.issueId}...`);
+      break;
+    case 'issue-read':
+      logger.success(`Issue #${progress.issueId} 已取得：${progress.subject || '無標題'}`);
+      break;
+    case 'analyze-issue':
+      logger.step(`[${progress.index}/${progress.total}] 使用 Copilot 分析 Issue #${progress.issueId}...`);
+      break;
+    case 'issue-analyzed':
+      logger.success(`Issue #${progress.issueId} AI 分析完成`);
+      break;
+    case 'issue-complete':
+      logger.success(`Issue #${progress.issueId} 更新草稿完成`);
+      break;
+    case 'apply-issue':
+      logger.step(`[${progress.index}/${progress.total}] 更新 Redmine Issue #${progress.issueId}...`);
+      break;
+    default:
+      break;
+  }
+}
+
 function printApplyResults(results) {
   for (const result of results) {
     if (result.applied) {
@@ -82,13 +118,23 @@ export function validateGeneratedDraft(draft = {}) {
  */
 export async function redmineUpdateCommand(options = {}) {
   validateRedmineOptions(options);
+  logger.header('Redmine Issue 更新分析');
   const config = await loadConfig();
+  logger.step('檢查 Redmine 設定...');
   const redmineConfig = buildRedmineConfig(config, process.env);
   const client = new RedmineClient(redmineConfig);
+  logger.success('Redmine 設定已載入');
 
   if (options.apply) {
+    logger.step(`讀取已審核草稿：${options.from}`);
     const draft = parseDraft(readFileSync(options.from, 'utf-8'));
-    const results = await applyRedmineDraft({ draft, client, force: options.force });
+    logger.success(`草稿已載入，共 ${draft.drafts.length} 個 Issue`);
+    const results = await applyRedmineDraft({
+      draft,
+      client,
+      force: options.force,
+      onProgress: printProgress,
+    });
     printApplyResults(results);
     if (hasApplyFailures(results)) {
       throw new Error('部分 Redmine Issue 更新失敗，請查看上方結果並重新處理失敗項目');
@@ -96,8 +142,31 @@ export async function redmineUpdateCommand(options = {}) {
     return results;
   }
 
+  logger.step('收集 Git branch、Base、commits、修改檔案與 diff...');
   const evidence = collectGitEvidence({ baseBranch: options.base });
-  const pullRequest = options.pr ? collectPullRequestEvidence(options.pr) : null;
+  logger.success(
+    `Git evidence 已取得：${countLines(evidence.commits)} 個 commits、${evidence.changedFiles.length} 個修改檔案；Base：${evidence.baseBranch}`
+  );
+
+  let pullRequest = null;
+  if (options.pr) {
+    logger.step(`讀取指定 GitHub PR #${options.pr}...`);
+    pullRequest = collectPullRequestEvidence(options.pr);
+  } else {
+    logger.step(`尋找 branch ${evidence.currentBranch} 對應的 GitHub PR...`);
+    try {
+      pullRequest = findCurrentPullRequestEvidence(evidence.currentBranch);
+    } catch {
+      pullRequest = null;
+    }
+  }
+  if (pullRequest) {
+    logger.success(`已找到 PR #${pullRequest.number}：${pullRequest.title || '無標題'}`);
+    console.log(`🔗 ${pullRequest.url}`);
+  } else {
+    logger.info('目前 branch 沒有找到對應的 GitHub PR，略過 PR 資訊');
+  }
+
   const draft = await generateRedmineDraft({
     issueIds: options.issue,
     client,
@@ -105,9 +174,11 @@ export async function redmineUpdateCommand(options = {}) {
     pullRequest,
     model: config.ai.model,
     maxRetries: config.ai.maxRetries,
+    onProgress: printProgress,
   });
 
   validateGeneratedDraft(draft);
+  logger.success(`已完成 ${draft.drafts.length} 個 Issue 的更新草稿分析`);
   console.log(renderPreview(draft.drafts));
   for (const failure of draft.failures) {
     console.log(`❌ Issue #${failure.issueId} 無法產生更新：${failure.error}`);

package/src/redmine/git-evidence.js

@@ -184,3 +184,42 @@ export function collectPullRequestEvidence(pullRequestNumber, execImpl = execFil
     changedFiles: pullRequest.files || [],
   };
 }
+
+/**
+ * 依目前 branch 找到對應的 GitHub Pull Request
+ * @param {string} branchName
+ * @param {Function} execImpl
+ * @returns {object|null}
+ */
+export function findCurrentPullRequestEvidence(branchName, execImpl = execFileSync) {
+  const raw = run(
+    'gh',
+    [
+      'pr',
+      'list',
+      '--head',
+      branchName,
+      '--state',
+      'all',
+      '--limit',
+      '1',
+      '--json',
+      'number,title,body,url,state,mergedAt,commits,files',
+    ],
+    execImpl
+  );
+  const pullRequests = JSON.parse(raw);
+  if (!Array.isArray(pullRequests) || pullRequests.length === 0) return null;
+
+  const pullRequest = pullRequests[0];
+  return {
+    number: Number(pullRequest.number),
+    title: pullRequest.title || '',
+    body: pullRequest.body || '',
+    url: pullRequest.url || '',
+    state: pullRequest.state || '',
+    mergedAt: pullRequest.mergedAt || null,
+    commits: pullRequest.commits || [],
+    changedFiles: pullRequest.files || [],
+  };
+}

package/src/redmine/issue-sync.js

@@ -1,16 +1,21 @@
 import { analyzeIssue as defaultAnalyzeIssue } from './issue-analyzer.js';
-import { createHash } from 'crypto';
 import {
   formatRedmineNote,
-  formatRedmineDescription,
   formatRedminePreview,
-  selectIssueStatus,
+  resolveIssueStatus,
 } from './redmine-formatters.js';
 
 function uniqueIssueIds(issueIds = []) {
   return [...new Set(issueIds.map(id => Number(id)).filter(Number.isInteger))];
 }
 
+function getCurrentDate() {
+  const now = new Date();
+  const month = String(now.getMonth() + 1).padStart(2, '0');
+  const day = String(now.getDate()).padStart(2, '0');
+  return `${now.getFullYear()}-${month}-${day}`;
+}
+
 /**
  * 判斷 Redmine 狀態是否代表已解決
  * @param {string} statusName
@@ -35,6 +40,7 @@ export function buildCompletionUpdate(issue, selectedStatus) {
   if (!progressField) {
     return {
       doneRatio: 100,
+      dueDate: getCurrentDate(),
       customFields: [],
       warning: '找不到 custom field「程式碼更版進度」，已略過 checkbox 更新',
     };
@@ -42,25 +48,11 @@ export function buildCompletionUpdate(issue, selectedStatus) {
 
   return {
     doneRatio: 100,
+    dueDate: getCurrentDate(),
     customFields: [{ id: progressField.id, value: ['測'] }],
   };
 }
 
-/**
- * 建立單一 Issue 的同步識別
- * @param {{issueId: number|string, evidence: object, pullRequest?: object|null}}
- * @returns {string}
- */
-export function createSyncId({ issueId, evidence = {}, pullRequest = null }) {
-  const identity = pullRequest?.number
-    ? `pr-${pullRequest.url || pullRequest.number}`
-    : `${evidence.repository || 'local'}-${evidence.currentBranch || 'branch'}-${createHash('sha256')
-      .update(`${evidence.commits || ''}\n${evidence.diff || ''}`)
-      .digest('hex')
-      .slice(0, 12)}`;
-  return `redmine-sync:${issueId}:${identity}`;
-}
-
 /**
  * 產生一份待審核的 Redmine 更新草稿
  * @param {object} options
@@ -72,27 +64,33 @@ export async function generateRedmineDraft({
   evidence,
   pullRequest = null,
   analyzeIssueFn = defaultAnalyzeIssue,
-  selectStatusFn = selectIssueStatus,
+  selectStatusFn = resolveIssueStatus,
   model,
   maxRetries,
+  onProgress = () => {},
 }) {
   const drafts = [];
   const failures = [];
-  for (const issueId of uniqueIssueIds(issueIds)) {
+  const uniqueIds = uniqueIssueIds(issueIds);
+  for (const [index, issueId] of uniqueIds.entries()) {
     try {
+      onProgress({ phase: 'read-issue', index: index + 1, total: uniqueIds.length, issueId });
       const issue = await client.getIssue(issueId);
+      onProgress({ phase: 'issue-read', index: index + 1, total: uniqueIds.length, issueId, subject: issue.subject });
+      onProgress({ phase: 'analyze-issue', index: index + 1, total: uniqueIds.length, issueId });
       const analysis = await analyzeIssueFn({ issue, evidence: { ...evidence, pullRequest }, model, maxRetries });
-      const selectedStatus = await selectStatusFn(issue, { client });
+      onProgress({ phase: 'issue-analyzed', index: index + 1, total: uniqueIds.length, issueId });
+      const fallbackStatuses = issue.allowedStatuses?.length ? [] : await client.getIssueStatuses();
+      const selectedStatus = selectStatusFn === resolveIssueStatus
+        ? resolveIssueStatus(issue, fallbackStatuses)
+        : await selectStatusFn(issue, { client });
+      onProgress({ phase: 'issue-complete', index: index + 1, total: uniqueIds.length, issueId });
       const completion = buildCompletionUpdate(issue, selectedStatus);
-      const description = formatRedmineDescription(issue.description, analysis.flowcharts);
-      const syncId = createSyncId({ issueId, evidence, pullRequest });
       const note = formatRedmineNote({
-        issueId,
         issue,
         analysis,
         evidence,
         pullRequest,
-        syncId,
       });
 
       drafts.push({
@@ -104,12 +102,11 @@ export async function generateRedmineDraft({
         statusId: selectedStatus.statusId,
         statusName: selectedStatus.statusName,
         doneRatio: completion.doneRatio,
+        dueDate: completion.dueDate,
         customFields: completion.customFields,
         customFieldWarning: completion.warning || null,
-        description: description !== issue.description ? description : undefined,
         analysis,
         note,
-        syncId,
       });
     } catch (error) {
       failures.push({ issueId, error: error.message });
@@ -131,14 +128,15 @@ export async function generateRedmineDraft({
  * @param {{draft: object, client: object, force?: boolean}} options
  * @returns {Promise<Array<object>>}
  */
-export async function applyRedmineDraft({ draft, client, force = false }) {
+export async function applyRedmineDraft({ draft, client, force = false, onProgress = () => {} }) {
   if (!draft || !Array.isArray(draft.drafts)) {
     throw new Error('無效的 Redmine draft');
   }
 
   const results = [];
-  for (const item of draft.drafts) {
+  for (const [index, item] of draft.drafts.entries()) {
     try {
+      onProgress({ phase: 'apply-issue', index: index + 1, total: draft.drafts.length, issueId: item.issueId });
       const current = await client.getIssue(item.issueId, { include: 'allowed_statuses,journals' });
 
       const statusChanged = item.originalStatusId !== null && current.status?.id !== item.originalStatusId;
@@ -150,6 +148,7 @@ export async function applyRedmineDraft({ draft, client, force = false }) {
 
       const update = { statusId: item.statusId, notes: item.note };
       if (item.doneRatio !== undefined) update.doneRatio = item.doneRatio;
+      if (item.dueDate !== undefined) update.dueDate = item.dueDate;
       if (item.description !== undefined) update.description = item.description;
       if (item.customFields?.length) update.customFields = item.customFields;
 

package/src/redmine/redmine-client.js

@@ -131,13 +131,14 @@ export class RedmineClient {
 
   /**
   * @param {number|string} issueId
-  * @param {{statusId?: number, doneRatio?: number, description?: string, notes?: string, customFields?: Array<object>}} update
+  * @param {{statusId?: number, doneRatio?: number, dueDate?: string, description?: string, notes?: string, customFields?: Array<object>}} update
    * @returns {Promise<object>}
    */
-  async updateIssue(issueId, { statusId, doneRatio, description, notes, customFields }) {
+  async updateIssue(issueId, { statusId, doneRatio, dueDate, description, notes, customFields }) {
     const issue = {};
     if (statusId !== undefined && statusId !== null) issue.status_id = statusId;
     if (doneRatio !== undefined && doneRatio !== null) issue.done_ratio = doneRatio;
+    if (dueDate !== undefined && dueDate !== null) issue.due_date = dueDate;
     if (description !== undefined) issue.description = description;
     if (notes) issue.notes = notes;
     if (Array.isArray(customFields) && customFields.length > 0) {

package/src/redmine/redmine-formatters.js

@@ -20,6 +20,21 @@ function formatBehaviorRules(rules = []) {
   return `### 行為規則\n\n| 情境 | 行為 |\n|---|---|\n${rows.join('\n')}\n`;
 }
 
+function formatFlowcharts(flowcharts = []) {
+  if (!Array.isArray(flowcharts) || flowcharts.length === 0) return '';
+
+  return flowcharts
+    .map((flowchart, index) => {
+      const mermaid = formatMermaid(flowchart?.source);
+      if (!mermaid) return '';
+      const id = normalizeFlowchartId(flowchart?.id, index);
+      const title = flowchart?.title?.trim() || '開發流程';
+      return `### 流程圖：${title}\n\n<!-- flowchart-id: ${id} -->\n${mermaid}\n`;
+    })
+    .filter(Boolean)
+    .join('\n');
+}
+
 const MERMAID_START = '<!-- ai-git-tools:mermaid:start';
 const MERMAID_END = '<!-- ai-git-tools:mermaid:end';
 
@@ -136,7 +151,7 @@ export function formatRedmineDescription(description = '', source = null) {
  * @param {{issueId: number|string, analysis: object, evidence: object, pullRequest?: object|null, syncId?: string}} input
  * @returns {string}
  */
-export function formatRedmineNote({ issueId, issue = {}, analysis = {}, evidence = {}, pullRequest = null, syncId }) {
+export function formatRedmineNote({ issue = {}, analysis = {}, evidence = {}, pullRequest = null }) {
   const sections = ['## 開發內容', ''];
   const development = Array.isArray(analysis.developmentSummary)
     ? analysis.developmentSummary.join('\n\n')
@@ -156,6 +171,7 @@ export function formatRedmineNote({ issueId, issue = {}, analysis = {}, evidence
   const unresolved = analysis.unresolvedItems?.length
     ? `### 待確認\n${analysis.unresolvedItems.map(item => `- [ ] ${item}`).join('\n')}\n`
     : '';
+  const flowcharts = formatFlowcharts(analysis.flowcharts);
 
   sections.push(
     development,
@@ -165,22 +181,30 @@ export function formatRedmineNote({ issueId, issue = {}, analysis = {}, evidence
     codeChanges,
     apiChanges,
     technicalDetails,
+    flowcharts,
     verification
   );
   sections.push(unresolved);
 
-  if (evidence.currentBranch || evidence.baseBranch) {
-    sections.push(
-      `### Git\n\n- Branch：\`\`${evidence.currentBranch || '—'}\`\``,
-      `- Base：\`\`${evidence.baseBranch || '—'}\`\``,
-      ''
-    );
-  }
-
-  if (pullRequest) {
+  if (evidence.currentBranch || evidence.baseBranch || pullRequest) {
+    const branch = evidence.currentBranch || '—';
+    const branchUrl = evidence.repository
+      ? `https://github.com/${evidence.repository}/tree/${encodeURI(branch)}`
+      : '';
+    const gitLines = [
+      '### Git',
+      '',
+      `- Branch：${branchUrl ? `[${branch}](${branchUrl})` : `\`\`${branch}\`\``}`,
+      `- Base：${branchUrl ? `[${evidence.baseBranch || '—'}](https://github.com/${evidence.repository}/tree/${encodeURI(evidence.baseBranch || '')})` : evidence.baseBranch || '—'}`,
+    ];
+    if (pullRequest) {
+      gitLines.push(
+        `- PR：${pullRequest.url ? `[${pullRequest.url}](${pullRequest.url})` : `#${pullRequest.number}`}`,
+        `- PR 狀態：${pullRequest.state || '—'}${pullRequest.mergedAt ? `（合併於 ${pullRequest.mergedAt}）` : ''}`
+      );
+    }
     sections.push(
-      `GitHub PR：${pullRequest.url || `#${pullRequest.number}`}`,
-      `PR 狀態：${pullRequest.state || '—'}${pullRequest.mergedAt ? `（合併於 ${pullRequest.mergedAt}）` : ''}`,
+      gitLines.join('\n'),
       ''
     );
   }
@@ -189,7 +213,6 @@ export function formatRedmineNote({ issueId, issue = {}, analysis = {}, evidence
     sections.push(`分析依據：${analysis.evidence.join('、')}`, '');
   }
 
-  if (syncId) sections.push(`<!-- ${syncId} issue:${issueId} -->`);
   return sections.filter((section, index) => section || index === 1).join('\n').trim();
 }
 
@@ -240,6 +263,19 @@ export async function selectIssueStatus(issue, { client, prompt = inquirer.promp
   return { statusId: answer.statusId, statusName: selected?.name || String(answer.statusId) };
 }
 
+/**
+ * 直接取得已解決狀態，不啟動互動式選單
+ * @param {object} issue
+ * @param {Array<object>} fallbackStatuses
+ * @returns {{statusId: number, statusName: string}}
+ */
+export function resolveIssueStatus(issue, fallbackStatuses = []) {
+  const statuses = getAvailableStatuses(issue, fallbackStatuses);
+  const resolved = statuses.find(status => /已解決|resolved/i.test(status.name || ''));
+  if (!resolved) throw new Error(`Issue #${issue.id} 找不到「已解決」狀態`);
+  return { statusId: resolved.id, statusName: resolved.name };
+}
+
 /**
  * 產生有色 terminal preview
  * @param {Array<object>} drafts
@@ -254,6 +290,7 @@ export function formatRedminePreview(drafts = []) {
       `${chalk.dim('目前狀態：')} ${draft.currentStatusName || draft.originalStatusName || '—'}`,
       `${chalk.green('更新狀態：')} ${draft.statusName || '未選擇'}`,
       draft.doneRatio !== undefined ? `${chalk.green('完成百分比：')} ${draft.doneRatio}%` : '',
+      draft.dueDate ? `${chalk.green('完成日期：')} ${draft.dueDate}` : '',
       draft.customFields?.length
         ? `${chalk.green('程式碼更版進度：')} ${draft.customFields.flatMap(field => field.value || []).join('、')}`
         : '',