@relipa/ai-flow-kit 0.0.9 → 0.1.0-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.0.9",
+  "version": "0.1.0-beta.0",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Example Team",
   "publishConfig": {
@@ -41,7 +41,7 @@
   },
   "scripts": {
     "aiflow": "node bin/aiflow.js",
-    "test": "echo \"Add tests in future\" && exit 0",
+    "test": "jest",
     "lint": "echo \"Add linting in future\" && exit 0",
     "docs": "echo \"Documentation available in ./docs\"",
     "publish:beta": "npm publish --tag beta",
@@ -55,6 +55,13 @@
     "semver": "^7.7.4"
   },
   "devDependencies": {
+    "exceljs": "^4.4.0",
+    "jest": "^30.4.2",
     "typescript": "^6.0.2"
+  },
+  "jest": {
+    "testMatch": [
+      "<rootDir>/tests/**/*.test.js"
+    ]
   }
-}
+}

package/scripts/create-score-excel.js

@@ -0,0 +1,354 @@
+const fs = require('fs');
+const path = require('path');
+const ExcelJS = require('exceljs');
+
+// ── Normalize command aliases ──────────────────────────────────────────────
+const ALIAS_MAP = {
+  u: 'update', up: 'update',
+  i: 'init',
+  v: 'version',
+  h: 'help',
+  p: 'prompt', promt: 'prompt', prmopt: 'prompt', promlist: 'prompt', propt: 'prompt',
+  g: 'guide', guid: 'guide',
+  t: 'task', st: 'status', s: 'status',
+  sw: 'switch', l: 'list', ls: 'list',
+  ctx: 'context',
+};
+
+const EXPLORE_CMDS = new Set(['init', 'update', 'version', 'help', 'status', 'unknown_flag']);
+const USE_CMDS = new Set(['use', 'use.help', 'prompt', 'guide', 'guideline', 'sync-skills', 'detect']);
+
+function norm(cmd) {
+  if (!cmd || cmd === '-' || cmd.trim() === '') return null;
+  const c = cmd.toLowerCase().trim();
+  return ALIAS_MAP[c] || c;
+}
+
+// ── Parse log file ─────────────────────────────────────────────────────────
+function parseLog(filePath) {
+  const lines = fs.readFileSync(filePath, 'utf-8').split(/\r?\n/);
+  const users = {};
+
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!line) continue;
+    const cols = line.split('\t');
+    // Cols: Timestamp[0] Repo[1] User[2] OS[3] Node[4] Version[5] Command[6]
+    //       AI Tool[7] Gate[8] Ticket[9] ...
+    const user = cols[2];
+    if (!user || user === '-' || user === '') continue;
+
+    const timestamp = cols[0] || '';
+    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: [] };
+    }
+    const u = users[user];
+    u.events++;
+    if (date) u.days.add(date);
+
+    const cmd = norm(command);
+    if (cmd) u.rawCmds.add(cmd);
+
+    const gateMatch = command.match(/^gate(\d+)\.(start|approved)$/i);
+    if (gateMatch) {
+      u.gateCmds.push({ gateNum: +gateMatch[1], type: gateMatch[2].toLowerCase(), ticket });
+    }
+    // generic "gate.approved" (no number)
+    if (/^gate\.approved$/i.test(command)) {
+      u.gateCmds.push({ gateNum: 0, type: 'approved', ticket });
+    }
+  }
+  return users;
+}
+
+// ── Score calculator ───────────────────────────────────────────────────────
+function calcScore(u) {
+  const { events, days, rawCmds, gateCmds } = u;
+  const activeDays = days.size;
+
+  if (events === 0) return 0;
+
+  // Gate aggregation
+  const gateStarted   = new Set(); // gate numbers
+  const gateApproved  = new Set();
+  const ticketsStarted    = new Set();
+  const ticketsCompleted  = new Set(); // gate4.approved or gate5.start
+
+  for (const g of gateCmds) {
+    const hasTicket = g.ticket && g.ticket !== '-' && g.ticket !== '';
+    if (g.type === 'start') {
+      gateStarted.add(g.gateNum);
+      if (hasTicket) ticketsStarted.add(g.ticket);
+    }
+    if (g.type === 'approved') {
+      gateApproved.add(g.gateNum);
+      if (hasTicket && g.gateNum >= 4) ticketsCompleted.add(g.ticket);
+    }
+  }
+  // gate5.start also counts as completed
+  for (const g of gateCmds) {
+    if (g.gateNum === 5 && g.type === 'start' && g.ticket && g.ticket !== '-') {
+      ticketsCompleted.add(g.ticket);
+    }
+  }
+
+  const hasUse     = USE_CMDS.has('use') && rawCmds.has('use');
+  const hasPrompt  = rawCmds.has('prompt');
+  const hasGuide   = rawCmds.has('guide') || rawCmds.has('guideline') || rawCmds.has('sync-skills');
+  const hasGateHighApproved = gateApproved.has(3) || gateApproved.has(4);
+
+  // Score 5: gate 3-5 approved + ≥ 3 tickets completed
+  if (hasGateHighApproved && ticketsCompleted.size >= 3) return 5;
+
+  // Score 4: gate.approved ≥ 1 + ≥ 1 ticket completed
+  if (gateApproved.size > 0 && ticketsCompleted.size >= 1) return 4;
+
+  // Score 3: gate.start with real ticket + ≥ 3 active days
+  if (ticketsStarted.size > 0 && activeDays >= 3) return 3;
+
+  // Score 2: has use/prompt/guide OR ≥ 2 active days
+  if (hasUse || hasPrompt || hasGuide || activeDays >= 2) return 2;
+
+  // Score 1: only exploration commands
+  const onlyExplore = [...rawCmds].every(c => EXPLORE_CMDS.has(c));
+  if (onlyExplore && rawCmds.size > 0) return 1;
+
+  return 0;
+}
+
+const SCORE_LABELS = [
+  'Không hoạt động',
+  'Mới khám phá',
+  'Bắt đầu dùng',
+  'Dùng có workflow',
+  'Hoàn thành workflow',
+  'Sử dụng thường xuyên workflow',
+];
+
+// ── Build summary row for each user ───────────────────────────────────────
+function buildRow(email, u) {
+  const { events, days, rawCmds, gateCmds } = u;
+  const activeDays = days.size;
+  const score = calcScore(u);
+
+  // Key commands: deduplicated, meaningful, sorted
+  const ignoredCmds = new Set([
+    'unknown_flag', 'use.help', 'tel', 'tel.help', 'telementry',
+    'flush', 'flush.help', 'reset', 'context', 'memory.search',
+    'upgrade', 'gate.help', 'prompt.help', 'task.help',
+  ]);
+  const gatePattern = /^gate\d*\.(start|approved|help)$|^gate\.(approved|help)$/i;
+
+  const displayCmds = [...rawCmds]
+    .filter(c => !ignoredCmds.has(c) && !gatePattern.test(c))
+    .sort();
+
+  // Compact gate summary
+  const startedGates  = [...new Set(gateCmds.filter(g => g.type === 'start').map(g => g.gateNum))].sort((a, b) => a - b);
+  const approvedGates = [...new Set(gateCmds.filter(g => g.type === 'approved').map(g => g.gateNum))].sort((a, b) => a - b);
+
+  const ticketsStarted   = [...new Set(gateCmds.filter(g => g.type === 'start'   && g.ticket && g.ticket !== '-').map(g => g.ticket))];
+  const ticketsApproved  = [...new Set(gateCmds.filter(g => g.type === 'approved' && g.ticket && g.ticket !== '-').map(g => g.ticket))];
+  const ticketsCompleted = [...new Set(gateCmds.filter(g =>
+    ((g.type === 'approved' && g.gateNum >= 4) || (g.gateNum === 5 && g.type === 'start'))
+    && g.ticket && g.ticket !== '-'
+  ).map(g => g.ticket))];
+
+  const gateStartStr    = startedGates.length ? `G${startedGates.join(',')} / ${ticketsStarted.length} ticket(s)` : '';
+  const gateApprovedStr = approvedGates.length ? `G${approvedGates.join(',')} / ${ticketsApproved.length} ticket(s)` : '';
+  const ticketsStr      = ticketsCompleted.length ? ticketsCompleted.join(', ') : '';
+
+  // Notes
+  let notes = '';
+  if (score === 0) notes = 'Không có event nào trong tuần';
+  else if (score === 1) notes = 'Chỉ có lệnh khám phá cơ bản (init/update/version/help)';
+  else if (score === 2) {
+    if (ticketsStarted.length > 0) notes = `Có gate.start nhưng chưa gate4.approved, ${activeDays} ngày active`;
+    else notes = `${displayCmds.slice(0, 3).join('/')}, ${activeDays} ngày active, chưa dùng gate workflow`;
+  }
+  else if (score === 3) notes = `Gate workflow bắt đầu, ${ticketsStarted.length} ticket(s), chưa hoàn thành`;
+  else if (score === 4) notes = `${ticketsCompleted.length} ticket hoàn thành (gate4+)`;
+  else if (score === 5) notes = `Gate 3-5 approved, ${ticketsCompleted.length} tickets hoàn thành`;
+
+  return {
+    email,
+    events,
+    activeDays,
+    keyCommands: displayCmds.join(', '),
+    gateStart: gateStartStr,
+    gateApproved: gateApprovedStr,
+    tickets: ticketsStr,
+    depthScore: score,
+    depthLabel: SCORE_LABELS[score],
+    impactScore: '',
+    impactLabel: '',
+    totalScore: score,
+    notes,
+  };
+}
+
+// ── Excel writer ───────────────────────────────────────────────────────────
+async function writeExcel(rows, outputPath) {
+  const workbook = new ExcelJS.Workbook();
+  const sheet = workbook.addWorksheet('Score 18-24.05.2026');
+
+  sheet.columns = [
+    { key: 'no',           width: 5  },
+    { key: 'email',        width: 30 },
+    { key: 'events',       width: 8  },
+    { key: 'activeDays',   width: 10 },
+    { key: 'keyCommands',  width: 40 },
+    { key: 'gateStart',    width: 24 },
+    { key: 'gateApproved', width: 24 },
+    { key: 'tickets',      width: 44 },
+    { key: 'depthScore',   width: 8  },
+    { key: 'depthLabel',   width: 28 },
+    { key: 'impactScore',  width: 8  },
+    { key: 'impactLabel',  width: 18 },
+    { key: 'totalScore',   width: 8  },
+    { key: 'notes',        width: 54 },
+  ];
+
+  const border = {
+    top: { style: 'thin' }, left: { style: 'thin' },
+    bottom: { style: 'thin' }, right: { style: 'thin' },
+  };
+
+  // Title row
+  sheet.addRow(['AI Flow Kit — Weekly Score Report: 18/05/2026 – 24/05/2026']);
+  sheet.mergeCells('A1:N1');
+  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;
+
+  // Header row
+  const HEADERS = [
+    '#', 'Email', 'Events', 'Active\nDays', 'Key Commands',
+    'Gate Start', 'Gate Approved', 'Tickets Processed',
+    'Depth\nScore', 'Depth Label', 'Impact\nScore', 'Impact Label',
+    'Total\nScore', 'Notes',
+  ];
+  const hRow = sheet.addRow(HEADERS);
+  hRow.height = 36;
+  hRow.eachCell(cell => {
+    cell.fill      = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4472C4' } };
+    cell.font      = { bold: true, color: { argb: 'FFFFFFFF' }, size: 11 };
+    cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
+    cell.border    = border;
+  });
+
+  // Score → row color
+  const COLORS = {
+    0: 'FFFFC7CE',
+    1: 'FFFFEB9C',
+    2: 'FFFFFFCC',
+    3: 'FFD9EAD3',
+    4: 'FF93C47D',
+    5: 'FF6AA84F',
+  };
+
+  rows.forEach((row, idx) => {
+    const excelRowNum = idx + 3; // 1=title, 2=header
+    const r = sheet.addRow([
+      idx + 1, row.email, row.events, row.activeDays,
+      row.keyCommands, row.gateStart, row.gateApproved, row.tickets,
+      row.depthScore, row.depthLabel, row.impactScore, row.impactLabel,
+      null, row.notes,
+    ]);
+    r.height = 20;
+
+    const fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: COLORS[row.depthScore] || 'FFFFFFFF' } };
+    r.eachCell({ includeEmpty: true }, (cell, col) => {
+      cell.border = border;
+      cell.fill   = fill;
+      cell.alignment = (col <= 4 || (col >= 9 && col <= 13))
+        ? { vertical: 'middle', horizontal: 'center' }
+        : { vertical: 'middle', horizontal: 'left', wrapText: false };
+    });
+
+    // Total Score = Depth + Impact formula
+    r.getCell(13).value = { formula: `I${excelRowNum}+K${excelRowNum}` };
+  });
+
+  sheet.views      = [{ state: 'frozen', ySplit: 2 }];
+  sheet.autoFilter = { from: 'A2', to: 'N2' };
+
+  await workbook.xlsx.writeFile(outputPath);
+  console.log(`Written: ${outputPath} (${rows.length} users)`);
+}
+
+// ── Canonical user list (fixed order) ─────────────────────────────────────
+const CANONICAL_USERS = [
+  'anhtt@relipasoft.com',
+  'hoangdv@relipasoft.com',
+  'chinhtt@relipasoft.com',
+  'hieptv@relipasoft.com',
+  'phongnx@relipasoft.com',
+  'dungha@relipasoft.com',
+  'thangnv@relipasoft.com',
+  'nguyenlt@relipasoft.com',
+  'thuongvv@relipasoft.com',
+  'yenvtb@relipasoft.com',
+  'tructth@relipasoft.com',
+  'thainq@relipasoft.com',
+  'tuoittx@relipasoft.com',
+  'hungdv@relipasoft.com',
+  'hiepnk@relipasoft.com',
+  'khoihn@relipasoft.com',
+  'huynq@relipasoft.com',
+  'thinhvq@relipasoft.com',
+  'banv@relipasoft.com',
+  'duongnt@relipasoft.com',
+  'anhnt@relipasoft.com',
+  'khanhdd@relipasoft.com',
+  'hieunv@relipasoft.com',
+];
+
+// Log email → canonical email (for slight mismatches)
+const LOG_EMAIL_ALIAS = {
+  'tructh@relipasoft.com':   'tructth@relipasoft.com',
+  'duongnt1@relipasoft.com': 'duongnt@relipasoft.com',
+};
+
+const EMPTY_USER = (email) => ({
+  email, events: 0, days: new Set(), rawCmds: new Set(), gateCmds: [],
+});
+
+// ── Main ───────────────────────────────────────────────────────────────────
+(async () => {
+  const logFile    = path.join(__dirname, '..', 'tellog', 'log_18-05-2026_24-05-2026');
+  const outputFile = path.join(__dirname, '..', 'tellog', 'log_18-05-2026_24-05-2026_new.xlsx');
+
+  const rawUsers = parseLog(logFile);
+
+  // Re-key log users using alias map (tructh → tructth, duongnt1 → duongnt)
+  const users = {};
+  for (const [logEmail, data] of Object.entries(rawUsers)) {
+    const canonical = LOG_EMAIL_ALIAS[logEmail] || logEmail;
+    if (!users[canonical]) {
+      users[canonical] = { ...data, email: canonical };
+    } else {
+      // merge (shouldn't happen but just in case)
+      const u = users[canonical];
+      u.events += data.events;
+      data.days.forEach(d => u.days.add(d));
+      data.rawCmds.forEach(c => u.rawCmds.add(c));
+      u.gateCmds.push(...data.gateCmds);
+    }
+  }
+
+  // Build rows in canonical order; fill score 0 for absent users
+  const rows = CANONICAL_USERS.map(email => {
+    const u = users[email] || EMPTY_USER(email);
+    return buildRow(email, u);
+  });
+
+  await writeExcel(rows, outputFile);
+})();

package/scripts/guide.js

@@ -164,6 +164,7 @@ function showCommands() {
             group: 'Workflow (use per task)',
             items: [
                 ['aiflow use <TICKET-ID>', '', 'Load context from Backlog/Jira'],
+                ['aiflow use <T1> <T2> ...', '', 'Multi-target: 1st is primary, rest supplementary (v0.1.0+)'],
                 ['aiflow use', '--fast', 'Fast Mode: minimal Q&A (Default)'],
                 ['aiflow use', '--full', 'Full Mode: deep analysis with Q&A'],
                 ['aiflow use', '--file <path>', 'Load from local text/json file'],
@@ -171,6 +172,7 @@ function showCommands() {
                 ['aiflow use', '--with-comments', 'Include all comments'],
                 ['aiflow use', '--comments-last <n>', 'Only get last N comments'],
                 ['aiflow use', '--comments-from <n>', 'Get comments from index N onward'],
+                ['aiflow fetch-links <url>', '', 'Fetch Backlog/Jira link → SupplementaryContext JSON (v0.1.0+)'],
                 ['aiflow prompt <type>', '', 'Generate AI prompt'],
                 ['aiflow prompt', '--list', 'View all prompt types'],
                 ['aiflow prompt', '--output <file>', 'Save prompt to file'],