trackops 2.0.4 → 2.0.6

package/bin/trackops.js

@@ -1,40 +1,61 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
+
+const nodeVersion = parseInt(process.versions.node, 10);
+if (nodeVersion < 18) {
+  console.error(`TrackOps requiere Node.js 18 o superior. Version actual: ${process.versions.node}`);
+  process.exit(1);
+}
 
 const path = require("path");
 const config = require("../lib/config");
 const runtimeState = require("../lib/runtime-state");
 const { setLocale, t } = require("../lib/i18n");
+const fmt = require("../lib/cli-format");
 const pkg = require("../package.json");
 
-const command = process.argv[2];
-const args = process.argv.slice(3);
-
-function initCliLocale() {
-  let projectLocale = null;
-  try {
-    const context = config.resolveWorkspaceContext();
-    if (context) {
-      projectLocale = config.getLocale(config.loadControl(context));
-    }
-  } catch (_error) {
-    projectLocale = null;
-  }
-  const doctor = runtimeState.doctorLocale(projectLocale);
-  setLocale(doctor.effectiveLocale);
+function parseCliTokens(argv) {
+  const plain = argv.includes("--plain") || argv.includes("--a11y");
+  const tokens = argv.filter((token) => !["--plain", "--a11y"].includes(token));
+  return {
+    plain,
+    command: tokens[0],
+    args: tokens.slice(1),
+  };
 }
 
-function resolveRoot() {
-  const context = config.resolveWorkspaceContext();
-  if (!context) {
-    console.error(t("cli.error.noWorkspace"));
-    process.exit(1);
-  }
-  return context.workspaceRoot;
-}
+const parsed = parseCliTokens(process.argv.slice(2));
+fmt.configure({ plain: parsed.plain });
 
-async function run() {
-  initCliLocale();
-  try {
+const command = parsed.command;
+const args = parsed.args;
+
+function initCliLocale() {
+  let projectLocale = null;
+  try {
+    const context = config.resolveWorkspaceContext();
+    if (context) {
+      projectLocale = config.getLocale(config.loadControl(context));
+    }
+  } catch (_error) {
+    projectLocale = null;
+  }
+  const doctor = runtimeState.doctorLocale(projectLocale);
+  setLocale(doctor.effectiveLocale);
+}
+
+function resolveRoot() {
+  const context = config.resolveWorkspaceContext();
+  if (!context) {
+    console.error(t("cli.error.noWorkspace"));
+    console.error(t("cli.help.initFirst"));
+    process.exit(1);
+  }
+  return context.workspaceRoot;
+}
+
+async function run() {
+  initCliLocale();
+  try {
     switch (command) {
       case "init":
         await require("../lib/init").cmdInit(args);
@@ -68,90 +89,90 @@ async function run() {
         require("../lib/control").cmdTask(resolveRoot(), args);
         break;
 
-      case "register":
-        require("../lib/registry").cmdRegister(config.resolveProjectRoot() || process.cwd());
-        break;
+      case "register":
+        require("../lib/registry").cmdRegister(config.resolveProjectRoot() || process.cwd());
+        break;
 
       case "projects":
         require("../lib/registry").cmdList();
         break;
 
-      case "workspace": {
-        const workspace = require("../lib/workspace");
-        const sub = args[0];
-        const root = config.resolveProjectRoot() || process.cwd();
-        if (sub === "status") workspace.cmdStatus(root);
-        else if (sub === "migrate") workspace.cmdMigrate(root, args.slice(1));
-        else console.log(t("cli.usage.workspace"));
-        break;
-      }
-
-      case "env": {
-        const env = require("../lib/env");
-        const sub = args[0];
-        const root = config.resolveProjectRoot() || process.cwd();
-        if (sub === "status") env.cmdStatus(root);
-        else if (sub === "sync") env.cmdSync(root);
-        else console.log(t("cli.usage.env"));
-        break;
-      }
-
-      case "release":
-        require("../lib/release").cmdRelease(config.resolveProjectRoot() || process.cwd(), args);
-        break;
-
-      case "locale":
-        require("../lib/preferences").cmdLocale(args, config.resolveProjectRoot() || process.cwd());
-        break;
-
-      case "doctor":
-        require("../lib/preferences").cmdDoctor(args, config.resolveProjectRoot() || process.cwd());
-        break;
-
-      case "opera": {
-        const opera = require("../lib/opera");
-        const sub = args[0];
-        const root = config.resolveProjectRoot() || process.cwd();
-        if (sub === "install") await opera.cmdInstall(root, args.slice(1));
-        else if (sub === "bootstrap") await opera.cmdBootstrap(root, args.slice(1));
-        else if (sub === "handoff") opera.cmdHandoff(root, args.slice(1));
-        else if (sub === "status") opera.cmdStatus(root);
-        else if (sub === "configure") opera.cmdConfigure(root, args.slice(1));
-        else if (sub === "upgrade") opera.cmdUpgrade(root, args.slice(1));
-        else { console.log(t("cli.usage.opera")); }
-        break;
-      }
-
-      case "skill": {
-        const skills = require("../lib/skills");
-        const sub = args[0];
-        const root = config.resolveProjectRoot() || process.cwd();
-        if (sub === "install") skills.cmdInstall(root, args[1]);
-        else if (sub === "list") skills.cmdList(root);
-        else if (sub === "remove") skills.cmdRemove(root, args[1]);
-        else if (sub === "catalog") skills.cmdCatalog();
-        else { console.log(t("cli.usage.skill")); }
-        break;
-      }
-
-      case "version":
-      case "--version":
-      case "-v":
-        console.log(pkg.version);
-        break;
-
-      case "help":
-      case "--help":
-      case "-h":
-      case undefined:
-        require("../lib/control").cmdHelp();
-        break;
-
-      default:
-        console.error(t("cli.error.unknownCommand", { command }));
-        console.error(t("cli.error.runHelp"));
-        process.exit(1);
-    }
+      case "workspace": {
+        const workspace = require("../lib/workspace");
+        const sub = args[0];
+        const root = config.resolveProjectRoot() || process.cwd();
+        if (sub === "status") workspace.cmdStatus(root);
+        else if (sub === "migrate") workspace.cmdMigrate(root, args.slice(1));
+        else console.log(t("cli.usage.workspace"));
+        break;
+      }
+
+      case "env": {
+        const env = require("../lib/env");
+        const sub = args[0];
+        const root = config.resolveProjectRoot() || process.cwd();
+        if (sub === "status") env.cmdStatus(root);
+        else if (sub === "sync") env.cmdSync(root);
+        else console.log(t("cli.usage.env"));
+        break;
+      }
+
+      case "release":
+        require("../lib/release").cmdRelease(config.resolveProjectRoot() || process.cwd(), args);
+        break;
+
+      case "locale":
+        require("../lib/preferences").cmdLocale(args, config.resolveProjectRoot() || process.cwd());
+        break;
+
+      case "doctor":
+        require("../lib/preferences").cmdDoctor(args, config.resolveProjectRoot() || process.cwd());
+        break;
+
+      case "opera": {
+        const opera = require("../lib/opera");
+        const sub = args[0];
+        const root = config.resolveProjectRoot() || process.cwd();
+        if (sub === "install") await opera.cmdInstall(root, args.slice(1));
+        else if (sub === "bootstrap") await opera.cmdBootstrap(root, args.slice(1));
+        else if (sub === "handoff") opera.cmdHandoff(root, args.slice(1));
+        else if (sub === "status") opera.cmdStatus(root);
+        else if (sub === "configure") opera.cmdConfigure(root, args.slice(1));
+        else if (sub === "upgrade") opera.cmdUpgrade(root, args.slice(1));
+        else { console.log(t("cli.usage.opera")); }
+        break;
+      }
+
+      case "skill": {
+        const skills = require("../lib/skills");
+        const sub = args[0];
+        const root = config.resolveProjectRoot() || process.cwd();
+        if (sub === "install") skills.cmdInstall(root, args[1]);
+        else if (sub === "list") skills.cmdList(root);
+        else if (sub === "remove") skills.cmdRemove(root, args[1]);
+        else if (sub === "catalog") skills.cmdCatalog();
+        else { console.log(t("cli.usage.skill")); }
+        break;
+      }
+
+      case "version":
+      case "--version":
+      case "-v":
+        console.log(pkg.version);
+        break;
+
+      case "help":
+      case "--help":
+      case "-h":
+      case undefined:
+        require("../lib/control").cmdHelp();
+        break;
+
+      default:
+        console.error(t("cli.error.unknownCommand", { command }));
+        console.error(t("cli.error.runHelp"));
+        process.exit(1);
+    }
   } catch (error) {
     console.error(error.message);
     process.exit(1);

package/lib/cli-format.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+/**
+ * CLI output formatting helpers for accessible, scannable terminal output.
+ * Supports a plain mode for screen readers, logs, and limited terminals.
+ */
+
+const state = {
+  plain: false,
+};
+
+const UNICODE_SEP = "\u2500".repeat(48);
+const PLAIN_SEP = "-".repeat(48);
+
+const STATUS_TOKENS = {
+  pending: ["\u23F3", "PENDING"],
+  in_progress: ["\uD83D\uDEA7", "IN PROGRESS"],
+  in_review: ["\uD83D\uDC40", "IN REVIEW"],
+  blocked: ["\u26D4", "BLOCKED"],
+  completed: ["\u2705", "DONE"],
+  cancelled: ["\uD83D\uDDD1\uFE0F", "CANCELLED"],
+};
+
+const CHECK_TOKENS = {
+  pass: ["\u2705", "PASS"],
+  warn: ["\u26A0\uFE0F", "WARN"],
+  fail: ["\u274C", "FAIL"],
+  pending: ["\u23F3", "PENDING"],
+};
+
+function configure(options = {}) {
+  if (Object.prototype.hasOwnProperty.call(options, "plain")) {
+    state.plain = Boolean(options.plain);
+  }
+}
+
+function isPlain() {
+  return state.plain;
+}
+
+function pick(unicodeValue, plainValue) {
+  return state.plain ? plainValue : unicodeValue;
+}
+
+function sep() {
+  console.log(pick(UNICODE_SEP, PLAIN_SEP));
+}
+
+function blank() {
+  console.log("");
+}
+
+function header(text) {
+  console.log("");
+  console.log(pick(UNICODE_SEP, PLAIN_SEP));
+  console.log(`  ${text}`);
+  console.log(pick(UNICODE_SEP, PLAIN_SEP));
+}
+
+function success(text) {
+  console.log(`  ${pick("\u2713", "OK")} ${text}`);
+}
+
+function info(text) {
+  console.log(`  ${text}`);
+}
+
+function step(label, value) {
+  if (value !== undefined) {
+    console.log(`  ${pick("\u2192", "->")} ${label}: ${value}`);
+  } else {
+    console.log(`  ${pick("\u2192", "->")} ${label}`);
+  }
+}
+
+function hint(text) {
+  console.log(`    ${text}`);
+}
+
+function warn(text) {
+  console.log(`  ${pick("\u26A0", "WARN")} ${text}`);
+}
+
+function bullet(text) {
+  console.log(`    - ${text}`);
+}
+
+function statusToken(status) {
+  const pair = STATUS_TOKENS[status] || [status, String(status || "").toUpperCase()];
+  return pick(pair[0], `[${pair[1]}]`);
+}
+
+function checkToken(status) {
+  const pair = CHECK_TOKENS[status] || [status, String(status || "").toUpperCase()];
+  return pick(pair[0], `[${pair[1]}]`);
+}
+
+function boolToken(value) {
+  return value ? pick("\u2705", "[YES]") : pick("\u274C", "[NO]");
+}
+
+module.exports = {
+  configure,
+  isPlain,
+  pick,
+  sep,
+  blank,
+  header,
+  success,
+  info,
+  step,
+  hint,
+  warn,
+  bullet,
+  statusToken,
+  checkToken,
+  boolToken,
+};