@relipa/ai-flow-kit 0.2.0-beta.0 → 0.2.0-beta.1

package/custom/skills/review-plan/SKILL.md

@@ -143,6 +143,8 @@ Create file `AK-Docs/04.Coding/04.Reviews/[functionId]/[ticketId].md`:
 **Breaking changes:** None / [description if any]
 ```
 
+Output language: auto-detect from the ticket/task input — see `custom/rules/output-language.md` (Vietnamese input → Vietnamese output; otherwise English).
+
 ### Step 2.5: Retrospect + propose memory drafts
 
 Synthesize what was learned this task. **Priority order — human corrections first:** if this is a repeat pass through Gate 4 (the developer already sent "BUG: ..." at least once this task), the developer's own correction is the single highest-value lesson — scan back through this session for it and draft it even if you already drafted something for the earlier BUG at Step 4 (dedup will catch an exact repeat; don't skip capturing it out of caution). Only after that, add anything else genuinely new: architecture facts discovered, decisions made and why. For each candidate, create a **local draft** (no approval needed yet — `_pending/` is local-only, doc `docs/common/Memory-Architecture-v1.0.md`):

package/custom/skills/script-sync/SKILL.md

@@ -205,4 +205,4 @@ Trả về danh sách kết quả cho `execute-flow`:
 - ❌ **Không overwrite** test block có hash match — skip hoàn toàn
 - ✅ Ưu tiên locator: `getByRole` > `getByLabel` > `getByPlaceholder` > `getByText` > `getByTestId` > CSS
 - ✅ Không tạo lại `BasePage.ts` / `fixtures/test.ts` nếu đã tồn tại
-- ✅ Viết test names và comments bằng tiếng Việt
+- ✅ Test names/comments theo ngôn ngữ của TC input (xem `custom/rules/output-language.md`) — TC tiếng Việt → tiếng Việt, TC tiếng Anh → tiếng Anh

package/custom/skills/test-analysis/SKILL.md

@@ -107,6 +107,8 @@ Dựa trên ticket/description, phân tích:
 
 Tạo `test-plan/test-analysis.md`:
 
+Ngôn ngữ output: auto-detect theo ngôn ngữ của ticket/testcase input — xem `custom/rules/output-language.md` và `custom/skills/test-skills/rules/qa-writing-standards.md` (input tiếng Việt → output tiếng Việt; ngược lại mặc định tiếng Anh; tiêu đề cột bảng vẫn giữ tiếng Anh).
+
 ```markdown
 # Test Analysis: [Ticket ID / Feature Name]
 

package/custom/skills/test-skills/rules/qa-writing-standards.md

@@ -8,8 +8,8 @@
 
 ## 1. Ngôn ngữ & văn phong
 
-- Nội dung mô tả/diễn giải bằng **tiếng Việt**.
-- **Tiêu đề cột của bảng (checklist, testcase) viết bằng tiếng Anh** theo quy ước team; **nội dung trong ô viết tiếng Việt**.
+- Ngôn ngữ nội dung mô tả/diễn giải **auto-detect theo ngôn ngữ của ticket/input** — xem `custom/rules/output-language.md`: input tiếng Việt → viết tiếng Việt (mặc định trước đây); input tiếng Anh → viết tiếng Anh.
+- **Tiêu đề cột của bảng (checklist, testcase) luôn viết bằng tiếng Anh** theo quy ước team, bất kể ngôn ngữ nội dung ô; **nội dung trong ô theo ngôn ngữ đã xác định ở trên**.
 - Thuật ngữ kỹ thuật/test có thể giữ tiếng Anh trong ngoặc khi cần (vd: kiểm thử biên (boundary)).
 - Viết ngắn gọn, rõ ràng, không lan man. Ưu tiên gạch đầu dòng và bảng.
 

package/custom/skills/train-model/SKILL.md

@@ -49,6 +49,8 @@ Log the following to MLflow or wandb for every run:
 
 Do not leave runs unnamed or untracked.
 
+Output language: auto-detect from the ticket/task input — see `custom/rules/output-language.md` (Vietnamese input → Vietnamese output; otherwise English).
+
 ### 5. Checkpointing
 
 Save the best checkpoint by the primary validation metric (not the final epoch). Store the config file alongside the artifact so the checkpoint is self-contained. Use the model registry (MLflow Model Registry or equivalent) when available.

package/custom/templates/shared/create-testcase-workflow.md

@@ -90,7 +90,7 @@ Ví dụ: `functionId = AD06` → thư mục gốc là `03.Testing/`
 ```
 (AI-Artifacts/ = 03.Testing/07.AI-Artifacts/ — viết tắt cho ngắn gọn)
 
-[Input: SRS / Jira / Backlog / Spec file] → Pre-flight: BẮT BUỘC xác định functionId
+[Input: UC Spec + System Requirement (bắt buộc, cảnh báo nếu thiếu) / SRS / Jira / Backlog / Spec file] → Pre-flight: BẮT BUỘC xác định functionId
     ↓
 Gate 1: Phân tích yêu cầu & Đánh giá rủi ro  → AI-Artifacts/[functionId]/
     ↓ APPROVED
@@ -169,8 +169,37 @@ Trước khi ghi bất kỳ file nào vào `03.Testing/`, đảm bảo AK-Docs
 
 > ❌ Không tự thêm `--yes` khi chưa thấy QA gõ xác nhận rõ ràng trong hội thoại.
 
+#### Bước 0.6: Kiểm tra UC Spec & System Requirement (input bắt buộc, cảnh báo non-blocking)
+
+**Mục tiêu:** Test Case phải được thiết kế dựa trên cả UC Spec (yêu cầu nghiệp vụ do BA chốt) **và** System Requirement (bản dịch kỹ thuật cho Dev — Validation Rule, Exception/Error Handling, Acceptance Test) — thiếu một trong hai, TC dễ bỏ sót case mà Dev đã implement hoặc case BA đã đặc tả.
+
+1. Tìm UC Spec: `AK-Docs/02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v{N}.md` (version cao nhất, không phải bản archive).
+2. Tìm System Requirement: `AK-Docs/02.BA-Specs/00.Requirements/[functionId]/System-Requirement_v*.md` (version cao nhất).
+3. Nếu tìm thấy System Requirement, đọc 2 header của nó: `UC-Spec-Version` (phải khớp version UC Spec tìm được ở bước 1) và `Status` (phải là `✅ Approved`).
+
+Nếu **bất kỳ** điều kiện sau không thỏa mãn → hiển thị cảnh báo tương ứng, **không dừng/không cancel Gate 1** — vẫn tiếp tục với dữ liệu hiện có:
+
+| Tình huống | Cảnh báo hiển thị |
+|---|---|
+| Không tìm thấy UC Spec | `⚠️ CẢNH BÁO: Không tìm thấy UC Spec cho [functionId] — Test Case sẽ chỉ dựa trên System Requirement (nếu có) + input khác, thiếu ngữ cảnh nghiệp vụ gốc.` |
+| Không tìm thấy System Requirement | `⚠️ CẢNH BÁO: Không tìm thấy System Requirement cho [functionId] — Test Case sẽ chỉ dựa trên UC Spec, có thể thiếu Validation Rule/Exception Handling/Acceptance Test mà Dev đã chốt riêng.` |
+| Có System Requirement nhưng `UC-Spec-Version` không khớp UC Spec hiện tại | `⚠️ CẢNH BÁO: System Requirement đang trace theo UC Spec v[X], nhưng UC Spec hiện tại là v[Y] — nội dung có thể lỗi thời.` |
+| Có System Requirement, khớp version, nhưng `Status` ≠ `✅ Approved` | `⚠️ CẢNH BÁO: System Requirement cho [functionId] chưa Approved (Status: [giá trị hiện tại]) — nội dung có thể còn thay đổi.` |
+
+→ Với mọi cảnh báo trên: ghi lại tình huống này vào `[functionId]_01_Requirement_Analysis_QA.md` (mục Assumptions, Bước 4) để QA/Dev biết rõ giới hạn của phân tích — không chỉ hiển thị rồi bỏ qua.
+
+Nếu tất cả điều kiện thỏa mãn → thông báo ngắn rồi tiếp tục:
+
+```
+✓ UC Spec: v[N]
+✓ System Requirement: v[N] (✅ Approved, khớp UC Spec v[N])
+→ Tiếp tục Gate 1...
+```
+
 #### Bước 1: Đọc và tổng hợp đầu vào
 - Đọc `.aiflow/context/current.json` — tiêu đề, mô tả, acceptance criteria, liên kết tài liệu
+- Đọc `UC-Spec_v{N}.md` (tìm thấy ở Bước 0.6) — yêu cầu nghiệp vụ gốc: Main/Alternative/Exception Flow, Business Rules (BR-NNN), UI Components
+- Nếu tìm thấy `System-Requirement_v{N}.md` ở Bước 0.6 → đọc toàn bộ, dùng làm input kỹ thuật bổ sung cho Bước 2 (Phân tích yêu cầu): đối chiếu Functional/Non-Functional Requirements (`FR-*`, `NFR-*`), Validation Rules (`VR-*`), Exception & Error Handling (`ER-*`), Acceptance Test Scenarios (`AT-*`) — TC ở Gate 3 phải bao phủ cả các `AT-*`/`ER-*` này, không chỉ Business Rules trong UC Spec
 - Nếu description có URL → chạy `ak fetch-links <url>` để tải nội dung
 - Nếu có `supplementaryContext[]` → đọc từng item (SRS file, Figma link, API spec, spec MD file)
 - Nếu có file yêu cầu thô được chỉ định → đọc file đó
@@ -227,6 +256,7 @@ Trước khi ghi bất kỳ file nào vào `03.Testing/`, đảm bảo AK-Docs
 
 **Definition of Done:**
 - [ ] `functionId` đã được xác định, thư mục đầu ra đã sẵn sàng
+- [ ] Đã chạy Bước 0.6 (kiểm tra UC Spec + System Requirement); nếu có cảnh báo, đã ghi vào `01_Requirement_Analysis_QA.md`
 - [ ] File `01_Requirement_Analysis_Result.md` có đủ 16 mục + Risk Matrix + Test Scope
 - [ ] Toàn bộ Critical/Major đã được hỏi trực tiếp (từng câu một) và có câu trả lời từ QA — không còn nghi vấn bỏ ngỏ
 - [ ] File `01_Requirement_Analysis_QA.md` đã tạo nếu có issue, ghi lại đầy đủ câu hỏi + câu trả lời (Bước 2b)
@@ -530,6 +560,7 @@ Sau khi Gate 4 đã APPROVED (bộ Test Case hoàn thành):
 - ❌ **KHÔNG** tiến gate tiếp theo khi còn issue Critical hoặc Major chưa giải quyết
 - ✅ **BẮT BUỘC** chạy Bước 0 ở Gate 1 — xác nhận `functionId` và thư mục đầu ra trước khi làm bất cứ điều gì
 - ✅ **BẮT BUỘC** chạy Bước 0.5 ở Gate 1 — đảm bảo AK-Docs đang ở branch `feature/[functionId]/[taskId]` trước khi ghi file đầu tiên
+- ✅ **BẮT BUỘC** chạy Bước 0.6 ở Gate 1 — kiểm tra UC Spec + System Requirement (tồn tại, khớp version, Approved); thiếu/lệch → cảnh báo yellow **không chặn Gate**, ghi vào QA artifact
 - ✅ **BẮT BUỘC** đọc skill từ `.claude/skills/test-skills/` — không suy luận từ bộ nhớ
 - ✅ **BẮT BUỘC** invoke `gate-review` cuối mỗi gate và chờ APPROVED
 - ✅ **BẮT BUỘC** tuân thủ 100% `testcase-template.md` ở Gate 3 và Gate 4

package/custom/templates/shared/gate-workflow.md

@@ -719,3 +719,18 @@ Bugs logged: [N] | Skipped: [N]
 7. Display: `GATE 2 DONE: Entry ghi vào AK-Docs/01.QnA/[file] — MR: [url hoặc "tạo thủ công"]`
 
 > **Telemetry:** Run `ak gate 2 start --ticket [ticket-id]` when starting. Run `ak gate 2 approved --ticket [ticket-id]` when Gate 2 completes.
+
+### GATE 3 — Sinh Task & Tạo Ticket (auto, chạy ngay sau Gate 2 xong)
+
+> Implements "Vấn đề 5" trong `docs/internal/PM Workflow_v1.0.md`. **Không chờ APPROVED để bắt đầu** — chạy tự động ngay sau Gate 2 Bước 7, không cần lệnh riêng và không cần chờ PM merge MR (merge là việc độc lập của PM). `INVOKE`: `ingest-data` skill § 5 cho toàn bộ logic phân tích/đề xuất — mục này chỉ nêu gate mechanics.
+
+1. Đọc lại entry vừa ghi + điều tra source/docs liên quan (skill § 5.1).
+2. Quyết định content này có cần task không (skill § 5.2). Nếu KHÔNG cần task → hiển thị thông báo tương ứng và **kết thúc luôn, không chạy `ak gate 3 start`, không có Gate 3 Display**.
+3. Nếu CẦN task → chạy `ak gate 3 start --ticket [ticket-id]`, rồi đề xuất danh sách task (skill § 5.3), cho PM sửa/thêm/xoá (skill § 5.4), lặp tới khi PM hài lòng.
+4. Điểm dừng xác nhận trước khi tạo ticket (skill § 5.5) — ❌ không tự thêm `--yes`, phải có xác nhận rõ ràng trong hội thoại.
+5. Xác định project đích trên Backlog/Jira (skill § 5.6, dùng `ak backlog-projects`/`ak jira-projects` + `ak backlog-set-default-project`/`ak jira-set-default-project`).
+6. Tạo ticket bằng `ak tasks create-tickets <file>.json --json` (skill § 5.7). Nếu thiếu WRITE credentials, hỏi PM nhập ngay trong chat rồi `ak credentials set <field> "<value>"` và thử lại đúng 1 lần.
+7. Ghi ngược link ticket vào entry gốc + hiển thị tổng kết (skill § 5.8).
+8. Run: `ak gate 3 approved --ticket [ticket-id]` để đóng task.
+
+> **Telemetry:** Run `ak gate 3 start --ticket [ticket-id]` chỉ khi Bước 2 kết luận CẦN task. Run `ak gate 3 approved --ticket [ticket-id]` khi Gate 3 hoàn tất.

package/docs/common/CHANGELOG.md

@@ -7,6 +7,19 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [0.2.1] - 2026-08-05
+
+### Added
+
+- **`ingest-data` gained Gate 3 — auto-triggered task proposal & real ticket creation on Backlog/Jira, closing the gap after Gate 2 where the flow used to just stop once an entry landed in `AK-Docs/01.QnA/`.** Implements "Vấn đề 5" in `docs/internal/PM Workflow_v1.0.md`, decided to run **automatically** right after Gate 2 (not on-demand as the doc's earlier tentative proposal had it):
+  - AI re-reads the entry just ingested plus related source code/docs to judge impact, then decides whether it needs a task at all — pure-reference content (FYI, status update) ends the gate with no task proposed, no ticket created.
+  - When action is needed, proposes a task list (`type`: spec/coding/test/other, `title`, `track`, `description` built from the PM Workflow §6.1 template — spec-type tasks additionally require a PM-supplied "Nguồn tham chiếu" link, never inferred). The user can add/edit/remove tasks directly during review — not just approve/reject the whole list — before the single explicit confirmation point ("Danh sách task như trên — đồng ý tạo trên Backlog/Jira?", never auto-`--yes`'d).
+  - New `scripts/ticket-writer.js` — `ak tasks create-tickets <file>.json [--json]` posts the approved list as real Backlog/Jira issues. `scripts/link-resolver.js` gained the write-side API calls it needed (`createBacklogIssue`, `createJiraIssue`, `fetchBacklogIssueTypes`, `fetchBacklogPriorities`) plus a generic `httpsPost` helper (form-encoded for Backlog, JSON for Jira) — the existing `httpsGet`-only file had no POST capability before this.
+  - **Deliberately separate WRITE credentials** (`BACKLOG_API_KEY_WRITE` / `JIRA_API_TOKEN_WRITE`) from the read-only keys `ak fetch-links`/`ak use` already rely on, per the PM Workflow doc's policy of never letting the read key create tickets. When missing, `ak tasks create-tickets` returns a structured `{"error":"missing-write-credentials", field, message}` instead of failing silently — the AI surfaces this in chat, asks the user to paste the key, saves it via the new `ak credentials set <key> <value>` (allowlisted to the keys this feature introduced — dedicated adapter credentials still go through `ak init --adapter`), and retries once.
+  - Project-id resolution reuses the existing `BACKLOG_DEFAULT_PROJECT_ID`/`ak backlog-projects`/`ak backlog-set-default-project` pattern; added the Jira equivalents (`ak jira-projects`, `ak jira-set-default-project`, `fetchJiraProjects` in `scripts/use.js`) so both adapters check local config before ever prompting.
+  - Approved tickets get their link written back into the originating `Meetings-Log`/`QnA-Log`/`Confirmations-Log` entry (`→ Tasks created: TICKET-101 (coding), ...`), keeping the traceability chain from PM Workflow §6 intact end-to-end.
+  - **Still open, tracked in the PM Workflow doc's Vấn đề 5 implementation note:** no fixed feedback→task-type rule table (AI still judges per-context); new tickets don't auto-attach `functionId`/labels (Dev/BA/QA still assign on `ak use TICKET-XXX`); Backlog issueType/priority default to the project's first issueType and a "Normal"-named priority unless overridden explicitly in the task JSON.
+
 ## [0.2.0] - 2026-08-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.1",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Example Team",
   "publishConfig": {

package/scripts/create-score-excel.js

@@ -24,25 +24,6 @@ function norm(cmd) {
   return ALIAS_MAP[c] || c;
 }
 
-// ── Version helpers ─────────────────────────────────────────────────────────
-const CURRENT_VERSION = '0.1.6';
-
-function parseVersion(v) {
-  if (!v || v === '-' || v === '' || v.toLowerCase() === 'unknown') return null;
-  const core = v.split('-')[0]; // strip prerelease suffix, e.g. 0.1.5-beta.1 -> 0.1.5
-  const parts = core.split('.').map(n => parseInt(n, 10));
-  if (parts.some(n => Number.isNaN(n))) return null;
-  return parts;
-}
-
-function compareVersion(a, b) {
-  for (let i = 0; i < Math.max(a.length, b.length); i++) {
-    const diff = (a[i] || 0) - (b[i] || 0);
-    if (diff !== 0) return diff;
-  }
-  return 0;
-}
-
 // ── Parse log file ─────────────────────────────────────────────────────────
 function parseLog(filePath) {
   const lines = fs.readFileSync(filePath, 'utf-8').split(/\r?\n/);
@@ -58,19 +39,17 @@ function parseLog(filePath) {
     if (!user || user === '-' || user === '') continue;
 
     const timestamp = cols[0] || '';
-    const version = cols[5] || '';
     const command = cols[6] || '';
     const ticket = cols[9] || '';
 
     const date = timestamp.split(' ')[0]; // dd/MM/yyyy
 
     if (!users[user]) {
-      users[user] = { email: user, days: new Set(), events: 0, rawCmds: new Set(), gateCmds: [], versions: new Set() };
+      users[user] = { email: user, days: new Set(), events: 0, rawCmds: new Set(), gateCmds: [] };
     }
     const u = users[user];
     u.events++;
     if (date) u.days.add(date);
-    if (version.trim()) u.versions.add(version.trim());
 
     const cmd = norm(command);
     if (cmd) u.rawCmds.add(cmd);
@@ -151,19 +130,6 @@ const SCORE_LABELS = [
   'Sử dụng thường xuyên workflow',
 ];
 
-// ── Version status for a user ──────────────────────────────────────────────
-function getVersionStatus(u) {
-  const all = [...u.versions];
-  const parsed = all.map(v => ({ raw: v, parts: parseVersion(v) })).filter(v => v.parts);
-  if (parsed.length === 0) {
-    return { status: all.length ? 'unknown' : 'none', latest: null, all };
-  }
-  parsed.sort((a, b) => compareVersion(a.parts, b.parts));
-  const latest = parsed[parsed.length - 1];
-  const isOutdated = compareVersion(latest.parts, parseVersion(CURRENT_VERSION)) < 0;
-  return { status: isOutdated ? 'outdated' : 'ok', latest: latest.raw, all };
-}
-
 // ── Build summary row for each user ───────────────────────────────────────
 function buildRow(email, u) {
   const { events, days, rawCmds, gateCmds } = u;
@@ -232,7 +198,6 @@ function buildRow(email, u) {
     impactLabel: '',
     totalScore: score,
     notes,
-    versionStatus: getVersionStatus(u),
   };
 }
 
@@ -331,78 +296,11 @@ function writeExcel(rows, workbook, sheetLabel, fromLabel, toLabel) {
   return sheet;
 }
 
-// ── Version warning sheet ───────────────────────────────────────────────────
-function writeVersionSheet(workbook, rows) {
-  const sheet = workbook.addWorksheet('Version Warning');
-  sheet.columns = [
-    { key: 'no', width: 5 },
-    { key: 'email', width: 30 },
-    { key: 'status', width: 16 },
-    { key: 'latest', width: 16 },
-    { key: 'allVersions', width: 30 },
-    { key: 'note', width: 50 },
-  ];
-
-  const border = {
-    top: { style: 'thin' }, left: { style: 'thin' },
-    bottom: { style: 'thin' }, right: { style: 'thin' },
-  };
-
-  sheet.addRow([`Cảnh báo phiên bản — Yêu cầu phiên bản hiện tại: ${CURRENT_VERSION}`]);
-  sheet.mergeCells('A1:F1');
-  const title = sheet.getCell('A1');
-  title.font = { bold: true, size: 13, color: { argb: 'FF1F3864' } };
-  title.alignment = { vertical: 'middle', horizontal: 'center' };
-  title.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFD6DCE4' } };
-  sheet.getRow(1).height = 28;
-
-  const HEADERS = ['#', 'Email', 'Trạng thái', 'Phiên bản mới nhất', 'Các phiên bản dùng trong tuần', 'Ghi chú'];
-  const hRow = sheet.addRow(HEADERS);
-  hRow.height = 20;
-  hRow.eachCell(cell => {
-    cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4F81BD' } };
-    cell.font = { bold: true, color: { argb: 'FFFFFFFF' }, size: 11 };
-    cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
-    cell.border = border;
-  });
-
-  const warnings = rows.filter(row => row.versionStatus.status === 'outdated' || row.versionStatus.status === 'unknown');
-
-  const STATUS_LABEL = { outdated: 'CŨ HƠN', unknown: 'KHÔNG XÁC ĐỊNH', ok: 'OK', none: 'Không có dữ liệu' };
-  const STATUS_COLOR = { outdated: 'FFFFC7CE', unknown: 'FFFFEB9C' };
-
-  warnings.forEach((row, idx) => {
-    const vs = row.versionStatus;
-    const note = vs.status === 'outdated'
-      ? `Đang dùng ${vs.latest}, chưa cập nhật lên ${CURRENT_VERSION}`
-      : 'Không đọc được phiên bản (giá trị "-" hoặc "unknown") — cần kiểm tra lại';
-    const r = sheet.addRow([
-      idx + 1, row.email, STATUS_LABEL[vs.status], vs.latest || '-', vs.all.join(', ') || '-', note,
-    ]);
-    r.height = 20;
-    const fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: STATUS_COLOR[vs.status] || 'FFFFFFFF' } };
-    r.eachCell({ includeEmpty: true }, (cell, col) => {
-      cell.border = border;
-      cell.fill = fill;
-      cell.alignment = (col <= 4)
-        ? { vertical: 'middle', horizontal: 'center' }
-        : { vertical: 'middle', horizontal: 'left', wrapText: false };
-    });
-  });
-
-  sheet.views = [{ state: 'frozen', ySplit: 2 }];
-  sheet.autoFilter = { from: 'A2', to: 'F2' };
-
-  return warnings;
-}
-
 async function writeExcelFile(rows, outputPath, sheetLabel, fromLabel, toLabel) {
   const workbook = new ExcelJS.Workbook();
   writeExcel(rows, workbook, sheetLabel, fromLabel, toLabel);
-  const warnings = writeVersionSheet(workbook, rows);
   await workbook.xlsx.writeFile(outputPath);
-  console.log(`Written: ${outputPath} (${rows.length} users, ${warnings.length} version warning(s))`);
-  return warnings;
+  console.log(`Written: ${outputPath} (${rows.length} users)`);
 }
 
 // ── Canonical user list (fixed order) ─────────────────────────────────────
@@ -437,7 +335,7 @@ const LOG_EMAIL_ALIAS = {
 };
 
 const EMPTY_USER = (email) => ({
-  email, events: 0, days: new Set(), rawCmds: new Set(), gateCmds: [], versions: new Set(),
+  email, events: 0, days: new Set(), rawCmds: new Set(), gateCmds: [],
 });
 
 // ── Main ───────────────────────────────────────────────────────────────────
@@ -471,7 +369,6 @@ const EMPTY_USER = (email) => ({
       u.events += data.events;
       data.days.forEach(d => u.days.add(d));
       data.rawCmds.forEach(c => u.rawCmds.add(c));
-      data.versions.forEach(v => u.versions.add(v));
       u.gateCmds.push(...data.gateCmds);
     }
   }
@@ -482,9 +379,5 @@ const EMPTY_USER = (email) => ({
     return buildRow(email, u);
   });
 
-  const warnings = await writeExcelFile(rows, outputFile, sheetLabel, fromLabel, toLabel);
-  if (warnings.length) {
-    console.log(`\n⚠️  Version warnings (< ${CURRENT_VERSION} or unknown):`);
-    warnings.forEach(w => console.log(`  - ${w.email}: ${w.versionStatus.latest || 'unknown'} (${w.versionStatus.status})`));
-  }
+  await writeExcelFile(rows, outputFile, sheetLabel, fromLabel, toLabel);
 })();

package/scripts/init.js

@@ -2,7 +2,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
 const chalk = require('chalk');
-const { input, checkbox, confirm } = require('@inquirer/prompts');
+const { input, checkbox, confirm, select } = require('@inquirer/prompts');
 const { syncDocsRepos } = require('./docs-repo');
 const memoryStore = require('./memory-store');
 
@@ -937,6 +937,29 @@ async function setupAdapter(projectDir, adapter) {
         console.log(chalk.green(`✓ Credentials verified successfully`));
     }
 
+    // Backlog: let the user pick a default project for tasks created manually (no ticket to
+    // derive one from otherwise) — kept for later use, e.g. syncing a local task up to Backlog.
+    if (adapter === 'backlog' && verifyResult.ok) {
+        const spaceKey = credentials.BACKLOG_SPACE_KEY;
+        const domain = spaceKey.includes('.') ? spaceKey : `${spaceKey}.backlog.com`;
+        try {
+            const { fetchBacklogProjects } = require('./use');
+            const projects = await fetchBacklogProjects(domain, credentials.BACKLOG_API_KEY);
+            if (projects.length > 0) {
+                const projectId = await select({
+                    message: 'Default Backlog project for tasks created manually (no ticket):',
+                    choices: projects.map((p) => ({ name: `${p.projectKey}  ${p.name}`, value: p.id })),
+                });
+                const picked = projects.find((p) => p.id === projectId);
+                credentials.BACKLOG_DEFAULT_PROJECT_ID = picked.id;
+                credentials.BACKLOG_DEFAULT_PROJECT_KEY = picked.projectKey;
+                console.log(chalk.green(`✓ Default project set to ${picked.projectKey}.`));
+            }
+        } catch (err) {
+            console.log(chalk.gray(`  (Could not fetch Backlog projects to pick a default: ${err.message} — skipping.)`));
+        }
+    }
+
     const claudeConfigDir = path.join(
         process.env.APPDATA ||
         (process.platform === 'darwin'

package/scripts/link-resolver.js

@@ -78,6 +78,41 @@ function httpsGet(url, headers) {
   });
 }
 
+// Generic POST — `bodyType` picks the wire format:
+//   'form' → application/x-www-form-urlencoded (Backlog's write API)
+//   'json' → application/json (Jira's write API)
+function httpsPost(url, payload, { headers = {}, bodyType = 'json' } = {}) {
+  return new Promise((resolve, reject) => {
+    const body = bodyType === 'form'
+      ? new URLSearchParams(payload).toString()
+      : JSON.stringify(payload);
+    const reqHeaders = {
+      ...headers,
+      'Content-Type': bodyType === 'form' ? 'application/x-www-form-urlencoded' : 'application/json',
+      'Content-Length': Buffer.byteLength(body),
+    };
+    const { hostname, pathname, search } = new URL(url);
+    const req = https.request(
+      { hostname, path: pathname + search, method: 'POST', headers: reqHeaders },
+      (res) => {
+        let data = '';
+        res.on('data', chunk => (data += chunk));
+        res.on('end', () => {
+          if (res.statusCode < 200 || res.statusCode >= 300) {
+            reject(new Error(`HTTP ${res.statusCode}: ${data.substring(0, 500)}`));
+            return;
+          }
+          try { resolve(data ? JSON.parse(data) : {}); }
+          catch (e) { reject(new Error('Invalid JSON from API')); }
+        });
+      }
+    );
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
 async function fetchBacklogTicket(domain, apiKey, ticketId) {
   const issue = await httpsGet(`https://${domain}/api/v2/issues/${ticketId}?apiKey=${apiKey}`);
   return {
@@ -148,6 +183,36 @@ async function fetchBacklogWiki(domain, apiKey, wikiId) {
   };
 }
 
+// ── Backlog WRITE — issue creation (PM Workflow_v1.0.md "Vấn đề 5") ──────────
+
+async function fetchBacklogIssueTypes(domain, apiKey, projectIdOrKey) {
+  return httpsGet(`https://${domain}/api/v2/projects/${projectIdOrKey}/issueTypes?apiKey=${apiKey}`);
+}
+
+async function fetchBacklogPriorities(domain, apiKey) {
+  return httpsGet(`https://${domain}/api/v2/priorities?apiKey=${apiKey}`);
+}
+
+/**
+ * Creates a Backlog issue. Requires an apiKey with WRITE permission — distinct from the
+ * read-only key used elsewhere in this file for `ak fetch-links`/`ak use`.
+ * `projectId`, `summary`, `issueTypeId`, `priorityId` are mandatory per Backlog's API.
+ */
+async function createBacklogIssue(domain, apiKeyWrite, { projectId, summary, description, issueTypeId, priorityId }) {
+  const issue = await httpsPost(
+    `https://${domain}/api/v2/issues?apiKey=${apiKeyWrite}`,
+    {
+      projectId: String(projectId),
+      summary,
+      issueTypeId: String(issueTypeId),
+      priorityId: String(priorityId),
+      description: description || '',
+    },
+    { bodyType: 'form' }
+  );
+  return { ticketId: issue.issueKey, url: `https://${domain}/view/${issue.issueKey}`, raw: issue };
+}
+
 function jiraAuth(email, token) {
   return `Basic ${Buffer.from(`${email}:${token}`).toString('base64')}`;
 }
@@ -191,6 +256,32 @@ async function fetchJiraComment(domain, email, token, ticketId, commentId) {
   };
 }
 
+// ── Jira WRITE — issue creation (PM Workflow_v1.0.md "Vấn đề 5") ────────────
+
+/**
+ * Creates a Jira issue. `apiTokenWrite`/`emailWrite` are distinct from the read-only
+ * credentials used elsewhere in this file — same "separate WRITE key" policy as Backlog.
+ */
+async function createJiraIssue(domain, emailWrite, apiTokenWrite, { projectKey, summary, description, issueTypeName }) {
+  const issue = await httpsPost(
+    `https://${domain}/rest/api/3/issue`,
+    {
+      fields: {
+        project: { key: projectKey },
+        summary,
+        issuetype: { name: issueTypeName || 'Task' },
+        description: {
+          type: 'doc',
+          version: 1,
+          content: [{ type: 'paragraph', content: [{ type: 'text', text: description || '' }] }],
+        },
+      },
+    },
+    { headers: { Authorization: jiraAuth(emailWrite, apiTokenWrite), Accept: 'application/json' }, bodyType: 'json' }
+  );
+  return { ticketId: issue.key, url: `https://${domain}/browse/${issue.key}`, raw: issue };
+}
+
 function linkDedupeKey(classified) {
   if (classified.kind === 'document') return 'doc:' + classified.documentId + (classified.commentId ? '#' + classified.commentId : '');
   if (classified.kind === 'wiki') return 'wiki:' + classified.wikiId;
@@ -270,4 +361,6 @@ module.exports = {
   fetchBacklogTicket, fetchBacklogComment,
   fetchBacklogDocument, fetchBacklogDocumentComment, fetchBacklogWiki,
   fetchJiraTicket, fetchJiraComment,
+  fetchBacklogIssueTypes, fetchBacklogPriorities, createBacklogIssue,
+  createJiraIssue,
 };