nitor 1.5.0 → 1.7.0

package/CHANGELOG.md

@@ -46,3 +46,40 @@ For a complete list of changes and discussion, see [Issue #1](https://github.com
 - Add table display for get-task command.
 
 - [Issue #9](https://github.com/codebynithin/nitor/issues/9)
+
+## [1.6.0] - 2026-04-20
+
+### New Features
+
+- Added `mr-status` command to list GitLab repositories you contribute to and
+  view their merge requests rendered as a branch tree (with filtering by state
+  and repository search).
+- `task-stats` and `get-task` output now render GitLab issue IDs, merge request
+  IDs, and Zoho task IDs as clickable terminal hyperlinks (OSC 8) for
+  supporting terminals.
+- New env variables `ZOHO_WORKSPACE` and `ZOHO_PROJECT_PREFIX` for building
+  Zoho Sprints task URLs used by the clickable `Task` column.
+
+### Enhancements
+
+- `printTable` is now ANSI/hyperlink-aware and computes visible column widths
+  correctly when cell values contain escape sequences.
+- Autocomplete updated to include the new `mr-status` command and its
+  `-state` / `-search` options.
+
+- [Issue #10](https://github.com/codebynithin/nitor/issues/10)
+
+## [1.7.0] - 2026-04-20
+
+### New Features
+
+### Security & Packaging
+
+- Bumped `axios` to `~1.15.1` to resolve high-severity advisories
+  (GHSA-43fc-jf86-j433, GHSA-3p68-rc4w-qgx5, GHSA-fvcv-3m26-pcqx) and a
+  moderate `follow-redirects` advisory pulled in transitively.
+- Added a top-level `LICENSE` file (ISC) and a `files` allowlist in
+  `package.json` so published tarballs only ship runtime assets.
+- Removed unused `commander` and `compression` dependencies.
+- Declared `engines.node >= 18` to reflect the actual minimum supported by
+  runtime dependencies (notably `@google/generative-ai`).

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025 Nithin V <mails2nithin@gmail.com>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -29,11 +29,13 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
 - Task statistics with merge request details
 - Extract Zoho task IDs from GitLab issue descriptions
 - Merge request status tracking for active tasks
+- Branch-tree view of GitLab merge requests across repositories (`mr-status`)
+- Clickable terminal hyperlinks for task IDs, GitLab issues and merge requests in stats output
 
 ## Requirements
 
-- Node.js >= 14.x
-- npm >= 6.x
+- Node.js >= 18.x
+- npm >= 9.x
 - A properly configured `.env.nu` file in your `~/Desktop` directory with required tokens and URLs:
   - `CSRF_TOKEN` - CSRF token for Gitlab (Copy from browser)
   - `COOKIE` - Cookie for Gitlab (Copy from browser)
@@ -57,6 +59,8 @@ A CLI utility toolkit for automating and managing build, deploy, and status oper
   - `ZOHO_TOKEN` - Zoho CSRF token
   - `ZOHO_URI` - Zoho API URL
   - `ZOHO_USERID` - Zoho user ID
+  - `ZOHO_WORKSPACE` - Zoho workspace name (used to build clickable task links)
+  - `ZOHO_PROJECT_PREFIX` - Zoho project prefix, e.g. `P29` (used to build clickable task links)
 
 ## Installation
 
@@ -184,6 +188,18 @@ Once enabled, you can use Tab to autocomplete:
   ```bash
   nitor get-task -task <task numbers with space>
   ```
+- **Merge Request Status (Tree View):**
+
+  ```bash
+  # Interactive: pick a repository, then view MRs as a branch tree
+  nitor mr-status
+
+  # Filter by MR state (opened | merged | closed | all)
+  nitor mr-status -state opened
+
+  # Pre-filter repositories by name
+  nitor mr-status -search <text>
+  ```
 
 ### Command Reference
 
@@ -211,6 +227,7 @@ Once enabled, you can use Tab to autocomplete:
 - `time-switch` : Switch between default projects
 - `task-stats` : View task statistics with GitLab merge request details
 - `get-task` : Extract Zoho task IDs from GitLab issue descriptions
+- `mr-status` : List GitLab repositories you contribute to and view merge requests as a branch tree
 
 ## MongoDB Backup & Restore
 
@@ -359,6 +376,8 @@ The backup service is designed to work on Windows, macOS, and Linux:
 - `-mergeId` or `-mId` : Merge ID
 - `-source` or `-so` : Source branch name
 - `-target` or `-ta` : Target branch name
+- `-state` or `-st` : MR state filter for `mr-status` (`opened`, `merged`, `closed`, `all`)
+- `-search` or `-q` : Repository search text for `mr-status`
 
 #### Time Entry Options
 

package/package.json

@@ -1,10 +1,21 @@
 {
   "name": "nitor",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "A comprehensive CLI toolkit for automating GitLab operations, AI-powered code review, build/deploy automation, MongoDB backup/restore, and developer productivity tools",
   "main": "index.js",
   "author": "Nithin V <mails2nithin@gmail.com>",
   "bin": "index.js",
+  "files": [
+    "index.js",
+    "services/",
+    "favicon.png",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "start": "node index",
     "start:dev": "nodemon index",
@@ -53,11 +64,9 @@
   "homepage": "https://github.com/codebynithin/nitor#readme",
   "dependencies": {
     "@google/generative-ai": "~0.24.1",
-    "axios": "~1.12.2",
+    "axios": "~1.15.1",
     "chalk": "~4.1.2",
     "cheerio": "~1.0.0-rc.12",
-    "commander": "~14.0.1",
-    "compression": "~1.8.1",
     "date-fns": "~2.30.0",
     "date-fns-tz": "~2.0.1",
     "dotenv": "~16.4.5",

package/services/autocomplete.js

@@ -228,6 +228,14 @@ const setupAutocomplete = () => {
       '-help': [],
       '--h': [],
     },
+    [ACTIONS.MR_STATUS]: {
+      '-state': ['opened', 'merged', 'closed', 'all'],
+      '-st': ['opened', 'merged', 'closed', 'all'],
+      '-search': [],
+      '-q': [],
+      '-help': [],
+      '--h': [],
+    },
     [ACTIONS.TIME_INIT]: [],
     [ACTIONS.TIME_SWITCH]: [],
     [ACTIONS.TIME_ADD]: [],

package/services/enums/actions.enum.js

@@ -13,6 +13,7 @@ module.exports = {
     VERSION: 'version',
     TASK_STATS: 'task-stats',
     GET_TASK: 'get-task',
+    MR_STATUS: 'mr-status',
 
     // Time entry commands
     TIME_INIT: 'time-init',

package/services/mr-status.js

@@ -0,0 +1,306 @@
+const axios = require('axios');
+const readline = require('readline');
+const { gitlabConfig, createSpinner } = require('./utils');
+
+const STATES = ['opened', 'merged', 'closed', 'all'];
+
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  magenta: '\x1b[35m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+};
+
+const apiBase = () => `${(gitlabConfig.url || '').replace(/\/+$/, '')}/api/v4`;
+
+const gitlabGet = async (path, params = {}) => {
+  const response = await axios.get(`${apiBase()}${path}`, {
+    headers: { 'PRIVATE-TOKEN': gitlabConfig.token },
+    params,
+    timeout: 20000,
+  });
+
+  return response.data;
+};
+
+const fetchProjects = async (search = '') => {
+  return gitlabGet('/projects', {
+    membership: true,
+    order_by: 'last_activity_at',
+    sort: 'desc',
+    per_page: 100,
+    simple: true,
+    search: search || undefined,
+  });
+};
+
+const fetchMergeRequests = async (projectId, state = 'opened') => {
+  return gitlabGet(`/projects/${encodeURIComponent(String(projectId))}/merge_requests`, {
+    state,
+    per_page: 100,
+    order_by: 'updated_at',
+    sort: 'desc',
+    scope: 'all',
+  });
+};
+
+const buildTree = (mrs) => {
+  const byTarget = new Map();
+  const sourceSet = new Set(mrs.map((m) => m.source_branch));
+
+  for (const mr of mrs) {
+    if (!byTarget.has(mr.target_branch)) {
+      byTarget.set(mr.target_branch, []);
+    }
+
+    byTarget.get(mr.target_branch).push(mr);
+  }
+
+  const rootTargets = [...byTarget.keys()].filter((t) => !sourceSet.has(t));
+  const roots = rootTargets.length ? rootTargets : [...byTarget.keys()];
+
+  const buildNode = (branch, visited = new Set()) => {
+    if (visited.has(branch)) {
+      return { branch, mrs: [], cyclic: true };
+    }
+
+    visited.add(branch);
+
+    const list = byTarget.get(branch) || [];
+
+    return {
+      branch,
+      mrs: list.map((mr) => ({
+        mr,
+        child: byTarget.has(mr.source_branch)
+          ? buildNode(mr.source_branch, new Set(visited))
+          : null,
+      })),
+    };
+  };
+
+  return roots.sort().map((b) => buildNode(b));
+};
+
+const stateColor = (state) => {
+  switch (state) {
+    case 'opened':
+      return C.green;
+    case 'merged':
+      return C.blue;
+    case 'closed':
+      return C.red;
+    default:
+      return C.dim;
+  }
+};
+
+const fmtDate = (s) => {
+  if (!s) return '';
+
+  return new Date(s).toISOString().replace('T', ' ').slice(0, 16);
+};
+
+const TREE = {
+  branch: '├── ',
+  lastBranch: '└── ',
+  vertical: '│   ',
+  space: '    ',
+};
+
+// Render tree connectors at normal brightness (not dim) so the hierarchy is
+// clearly visible against the rest of the output.
+const treeStyle = (s) => s;
+
+const printMR = (mr, prefix, connector, continuation) => {
+  const draft = mr.draft || mr.work_in_progress ? ` ${C.yellow}[draft]${C.reset}` : '';
+  const state = `${stateColor(mr.state)}${mr.state}${C.reset}`;
+  const author = mr.author?.name || mr.author?.username || '-';
+  const linePrefix = `${prefix}${treeStyle(continuation)}`;
+
+  console.log(
+    `${prefix}${treeStyle(connector)}${C.cyan}!${mr.iid}${C.reset} ${C.bold}${mr.title}${C.reset}${draft}`,
+  );
+  console.log(
+    `${linePrefix}  ${C.dim}${mr.source_branch} → ${mr.target_branch}${C.reset}  [${state}]  ${C.magenta}${author}${C.reset}  ${C.dim}${fmtDate(mr.updated_at)}${C.reset}`,
+  );
+  console.log(`${linePrefix}  ${C.dim}${mr.web_url}${C.reset}`);
+};
+
+const printBranchNode = (node, prefix = '') => {
+  const count = node.mrs.length;
+  const cyclic = node.cyclic ? ` ${C.yellow}(cycle)${C.reset}` : '';
+
+  console.log(
+    `${prefix}${C.bold}${C.blue}⎇ ${node.branch}${C.reset} ${C.dim}(${count} MR${count === 1 ? '' : 's'})${C.reset}${cyclic}`,
+  );
+
+  node.mrs.forEach(({ mr, child }, idx) => {
+    const isLast = idx === node.mrs.length - 1;
+    const connector = isLast ? TREE.lastBranch : TREE.branch;
+    // When an MR has a child branch, keep the vertical in the continuation so
+    // the child is visibly connected to the MR even if this MR is the last
+    // sibling at its level.
+    const continuation = isLast ? TREE.space : TREE.vertical;
+    // const continuation = isLast && !child ? TREE.space : TREE.vertical;
+
+    printMR(mr, prefix, connector, continuation);
+
+    if (child) {
+      printBranchNode(child, `${prefix}${treeStyle(continuation)}`);
+    }
+  });
+};
+
+const askQuestion = (question) =>
+  new Promise((resolve) => {
+    // terminal: false keeps stdin in cooked mode so the terminal itself handles
+    // echo. Using the default (terminal: true) alongside tooling that tweaks
+    // the TTY (e.g. the spinner's cursor-hide escapes) can cause each typed
+    // character to render twice (e.g. "1" appearing as "11").
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false,
+    });
+
+    process.stdout.write(question);
+
+    rl.question('', (answer) => {
+      rl.close();
+      resolve((answer || '').trim());
+    });
+  });
+
+const selectRepo = async (projects) => {
+  console.log('');
+
+  projects.forEach((p, i) => {
+    console.log(
+      `  ${C.cyan}${String(i + 1).padStart(3)}${C.reset}. ${C.bold}${p.name}${C.reset} ${C.dim}(${p.path_with_namespace})${C.reset}`,
+    );
+  });
+
+  console.log('');
+
+  for (;;) {
+    const answer = await askQuestion(`Select repository (1-${projects.length}) [default: 1]: `);
+
+    if (!answer) {
+      return projects[0];
+    }
+
+    const idx = parseInt(answer, 10);
+
+    if (Number.isInteger(idx) && idx >= 1 && idx <= projects.length) {
+      return projects[idx - 1];
+    }
+
+    console.log(`${C.yellow}Invalid selection. Try again.${C.reset}`);
+  }
+};
+
+const selectState = async (preset) => {
+  const lower = (preset || '').toLowerCase();
+
+  if (STATES.includes(lower)) {
+    return lower;
+  }
+
+  console.log('');
+
+  STATES.forEach((s, i) => console.log(`  ${C.cyan}${i + 1}${C.reset}. ${s}`));
+
+  const answer = await askQuestion(`Select MR state (1-${STATES.length}) [default: 1=opened]: `);
+
+  if (!answer) {
+    return 'opened';
+  }
+
+  const idx = parseInt(answer, 10);
+
+  return Number.isInteger(idx) && idx >= 1 && idx <= STATES.length ? STATES[idx - 1] : 'opened';
+};
+
+const getMr = async (values = {}) => {
+  if (!gitlabConfig.url || !gitlabConfig.token) {
+    console.log(
+      `${C.yellow}GitLab configuration missing.${C.reset} Set GITLAB_URI and GITLAB_TOKEN in your env file.`,
+    );
+
+    process.exit(1);
+  }
+
+  const repoSpinner = createSpinner('Fetching repositories');
+
+  repoSpinner.start();
+
+  let projects;
+
+  try {
+    projects = await fetchProjects(values.search || '');
+
+    repoSpinner.stop(
+      `Loaded ${projects.length} repositor${projects.length === 1 ? 'y' : 'ies'}`,
+      projects.length > 0,
+    );
+  } catch (error) {
+    repoSpinner.stop('Failed to fetch repositories', false);
+    console.error(error.response?.data?.message || error.message);
+
+    return;
+  }
+
+  if (!projects.length) {
+    console.log('No repositories found.');
+
+    return;
+  }
+
+  const selected = await selectRepo(projects);
+  const state = await selectState(values.state);
+
+  const mrSpinner = createSpinner(`Fetching ${state} merge requests for ${selected.name}`);
+
+  mrSpinner.start();
+
+  let mrs;
+
+  try {
+    mrs = await fetchMergeRequests(selected.id, state);
+    mrSpinner.stop(
+      `Found ${mrs.length} merge request${mrs.length === 1 ? '' : 's'}`,
+      mrs.length > 0,
+    );
+  } catch (error) {
+    mrSpinner.stop('Failed to fetch merge requests', false);
+    console.error(error.response?.data?.message || error.message);
+
+    return;
+  }
+
+  if (!mrs.length) {
+    console.log(`${C.dim}No ${state} merge requests.${C.reset}`);
+
+    return;
+  }
+
+  console.log('');
+  console.log(
+    `${C.bold}${selected.name}${C.reset} ${C.dim}${selected.path_with_namespace}${C.reset}`,
+  );
+  console.log('');
+
+  const tree = buildTree(mrs);
+
+  tree.forEach((node) => printBranchNode(node));
+
+  console.log('');
+};
+
+module.exports = { getMr };

package/services/process-commands.js

@@ -2,13 +2,14 @@ const axios = require('axios');
 const { build, buildStatus } = require('./build');
 const { deploy } = require('./deploy');
 const { ACTIONS } = require('./enums/actions.enum');
-const { convertParamsToMap, wait, printTable, createSpinner } = require('./utils');
+const { convertParamsToMap, wait, printTable, createSpinner, makeLink } = require('./utils');
 const { createBranch } = require('./create-branch');
 const { mrAIReview } = require('./review');
 const { refactor } = require('./refactor');
 const { backup } = require('./mongodb-backup');
 const { merge } = require('./merge');
 const { cleanup } = require('./cleanup');
+const { getMr } = require('./mr-status');
 
 // Time entry imports
 const { getSprints } = require('./time-entry/utils');
@@ -23,6 +24,7 @@ const {
   getGitIdStats,
   getGitlabIssueMergeRequests,
   getGitMergeRequestDetails,
+  getTaskBrowserUrl,
 } = require('./task-stats');
 
 const processArgs = async (type, value) => {
@@ -333,8 +335,10 @@ Options:
 
               const mrDetails = await getGitlabIssueMergeRequests(gitIdDetails);
 
+              const taskUrl = getTaskBrowserUrl(task);
+
               return mrDetails.map((mrDetail) => ({
-                Task: task,
+                Task: taskUrl ? makeLink(taskUrl, task) : task,
                 Owner: taskDetail.owner,
                 ...mrDetail,
               }));
@@ -355,6 +359,25 @@ Options:
         break;
       }
 
+      case ACTIONS.MR_STATUS: {
+        if (value === '-help' || value === '--h') {
+          console.log(`usage: \tnu mr-status [-state <opened|merged|closed|all>] [-search <text>]
+\tnu mr-status [-st <state>] [-q <text>]
+
+List GitLab repositories you are a member of, select one, and view its merge requests in a branch tree view.
+
+Options:
+  -st, --state <state>     MR state filter | opened (default), merged, closed, all
+  -q,  --search <text>     Pre-filter repositories by name`);
+
+          break;
+        }
+
+        await getMr(values || {});
+
+        break;
+      }
+
       case ACTIONS.GET_TASK: {
         if (value === '-help' || value === '--h') {
           console.log(`usage: \tnu get-task [-task <task numbers with space>]
@@ -539,7 +562,7 @@ Options:
         \t[${ACTIONS.BUILD}] [${ACTIONS.DEPLOY}] [${ACTIONS.BUILD_DEPLOY}]
         \t[${ACTIONS.CREATE_BRANCH}] [${ACTIONS.REVIEW}] [${ACTIONS.MERGE}]
         \t[${ACTIONS.CLEANUP}] [${ACTIONS.BACKUP}] [${ACTIONS.REFACTOR}]
-        \t[${ACTIONS.TASK_STATS}] [${ACTIONS.GET_TASK}]
+        \t[${ACTIONS.TASK_STATS}] [${ACTIONS.GET_TASK}] [${ACTIONS.MR_STATUS}]
         \t[${ACTIONS.TIME_INIT}] [${ACTIONS.TIME_ADD}] [${ACTIONS.TIME_STATUS}]\n
 Available commands:\n
   backup        : Backup MongoDB databases
@@ -549,6 +572,7 @@ Available commands:\n
   completion    : Setup shell autocomplete
   create-branch : Create git branch
   deploy        : Deploy specified components
+  mr-status        : List GitLab repos you contribute to and view merge requests as a tree
   get-task      : Get task details from GitLab merge requests
   merge         : Merge source branch into target branch
   refactor      : Refactor the provided text for improved clarity, conciseness, and professional quality
@@ -577,6 +601,8 @@ Example usage:\n
   nitor cleanup
   nitor create-branch -task <task number> -type <feat|fix> -description <description> -project <project short name>
   nitor deploy -project <project> -components <components> -instance <instance>
+  nitor mr-status
+  nitor mr-status -state opened
   nitor get-task -task <task numbers with space>
   nitor merge -source <source branch> -target <target branch>
   nitor refactor <text>

package/services/task-stats.js

@@ -1,5 +1,5 @@
 const axios = require('axios');
-const { zohoConfig, gitlabConfig } = require('./utils');
+const { zohoConfig, gitlabConfig, makeLink } = require('./utils');
 
 const getZohoUrl = (type, taskNumber) => {
   switch (type) {
@@ -11,6 +11,20 @@ const getZohoUrl = (type, taskNumber) => {
   }
 };
 
+// Browser URL for a Zoho Sprints task, e.g.
+// https://externalusers.zohosprints.com/workspace/4medica/client/wmoku#P29/itemdetails/I8856
+// Requires ZOHO_WORKSPACE (e.g. "4medica") and ZOHO_PROJECT_PREFIX (e.g. "P29")
+// to be set in the env file; returns an empty string if either is missing.
+const getTaskBrowserUrl = (taskNumber) => {
+  const { url, workspace, projectPrefix } = zohoConfig;
+
+  if (!url || !workspace || !projectPrefix || !taskNumber) {
+    return '';
+  }
+
+  return `${url}/workspace/${workspace}/client/wmoku#${projectPrefix}/itemdetails/I${taskNumber}`;
+};
+
 const getZohoConfig = (type, taskNumber) => {
   return {
     method: 'get',
@@ -153,10 +167,14 @@ const getGitlabIssueMergeRequests = async (gitDetails) => {
               const approvalResponse = await axios.request(approvalConfig);
               const approvalData = approvalResponse.data;
 
+              // Build browser URLs for IDs so they render as clickable links.
+              const issueUrl = gitDetail.web_url;
+              const mrUrl = mrData.web_url;
+
               // Merge approval data with MR data
               return {
-                GitID: gitDetail.iid,
-                MRID: mrData.iid,
+                GitID: issueUrl ? makeLink(issueUrl, gitDetail.iid) : gitDetail.iid,
+                MRID: mrUrl ? makeLink(mrUrl, mrData.iid) : mrData.iid,
                 MRStatus: mrData.state,
                 MRAssignedTo: mrData.assignee?.name,
                 MRTarget: mrData.target_branch,
@@ -202,4 +220,5 @@ module.exports = {
   getGitlabIssueDetails,
   getGitlabIssueMergeRequests,
   getGitMergeRequestDetails,
+  getTaskBrowserUrl,
 };