cyberhub-pracenv 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to **cyberhub-pracenv** (`chpe`) are documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2026-06-26
+
+### Added
+- **`changelog` command** — view this changelog from inside the platform so you
+  can see what has changed across versions without leaving the shell.
+- **`requirements` command (alias `rq`)** — show the rank ladder and how many
+  more points are needed to reach the next rank. The rank thresholds now live in
+  one place (`ui.RANKS`) shared by `rankFor` and this view.
+- **`scoreboard` command** — an operative leaderboard listing every user with
+  their rank, points, and solved count. A secret `sb` shortcut is also available.
+- A secret `ch` shortcut for the `challenges`/`ls` listing.
+
+### Changed
+- `help` now lists the `changelog`, `requirements`, and `scoreboard` commands.
+  The `ch` and `sb` shortcuts are intentionally left undocumented.
+
 ## [1.1.0] - 2026-06-25
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyberhub-pracenv",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A beginner-friendly, fully terminal-based cybersecurity (CTF) practice platform in the ICOA terminal style.",
   "keywords": [
     "cybersecurity",

package/src/commands.js

@@ -6,6 +6,7 @@
 //
 // The command table at the bottom drives both dispatch and the `help` listing.
 
+const fs = require('fs');
 const path = require('path');
 const store = require('./store');
 const auth = require('./auth');
@@ -38,6 +39,9 @@ function cmdHelp(ctx) {
     ['get <id> <file>', 'Copy an attached file into your launch directory'],
     ['submit <id> <flag>', 'Submit a flag to solve a challenge'],
     ['stats (whoami)', 'Show your full user breakdown'],
+    ['scoreboard', 'Show the operative leaderboard'],
+    ['requirements (rq)', 'Show the points needed to rank up'],
+    ['changelog', 'Show what has changed across versions'],
     ['admin', 'Unlock admin mode (requires the admin password)'],
     ['clear', 'Clear the screen'],
     ['help', 'Show this help'],
@@ -445,6 +449,83 @@ function cmdClear(ctx) {
   print(ctx, c.title('CyberHub Practice Environment') + c.dim('  —  type `help` for commands'));
 }
 
+// Show the bundled CHANGELOG.md so operatives can see what has changed without
+// leaving the platform. The markdown is lightly styled for the terminal.
+function cmdChangelog(ctx) {
+  const file = path.join(__dirname, '..', 'CHANGELOG.md');
+  let text;
+  try {
+    text = fs.readFileSync(file, 'utf8');
+  } catch (_err) {
+    print(ctx, c.err('Changelog is not available.'));
+    return;
+  }
+  print(ctx, c.title('Changelog'));
+  for (const line of text.replace(/\s+$/, '').split('\n')) {
+    if (/^#{1,6}\s/.test(line)) {
+      print(ctx, c.accent(line.replace(/^#{1,6}\s+/, '')));
+    } else if (/^\s*[-*]\s/.test(line)) {
+      print(ctx, c.dim('  • ') + line.replace(/^\s*[-*]\s+/, ''));
+    } else {
+      print(ctx, line);
+    }
+  }
+}
+
+// Show the rank ladder and how far the operative is from the next rank.
+function cmdRequirements(ctx) {
+  const profile = store.getProfile();
+  const points = profile.points || 0;
+  const current = ui.rankFor(points);
+
+  print(ctx, c.title('Rank requirements'));
+  const rows = ui.RANKS.map((r) => ({
+    cur: r.name === current ? '➤' : ' ',
+    rank: r.name,
+    points: r.min,
+  }));
+  print(ctx, ui.table(rows, [
+    { key: 'cur', label: ' ', color: c.ok },
+    { key: 'rank', label: 'Rank', color: c.accent },
+    { key: 'points', label: 'Min points' },
+  ]));
+
+  print(ctx, '');
+  print(ctx, ` ${c.bold('You')} : ${c.accent(current)} with ${c.ok(points)} pts`);
+  const next = ui.nextRank(points);
+  if (next) {
+    print(ctx, c.dim(` ${next.min - points} more point(s) to reach ${next.name}.`));
+  } else {
+    print(ctx, c.dim(' You have reached the top rank. Outstanding.'));
+  }
+}
+
+// Show a leaderboard of operatives. The platform uses a single local profile,
+// so the scoreboard ranks that operative — but it is built to render any number
+// of profiles so it keeps working if more are ever added.
+function cmdScoreboard(ctx) {
+  const total = store.listChallenges().length;
+  const users = [store.getProfile()];
+  const rows = users
+    .slice()
+    .sort((a, b) => (b.points || 0) - (a.points || 0))
+    .map((u, i) => ({
+      pos: i + 1,
+      name: u.name,
+      rank: ui.rankFor(u.points || 0),
+      points: u.points || 0,
+      solved: `${(u.solved || []).length}/${total}`,
+    }));
+  print(ctx, c.title('Scoreboard'));
+  print(ctx, ui.table(rows, [
+    { key: 'pos', label: '#', color: c.dim },
+    { key: 'name', label: 'Operative', color: c.accent },
+    { key: 'rank', label: 'Rank' },
+    { key: 'points', label: 'Pts', color: c.ok },
+    { key: 'solved', label: 'Solved' },
+  ]));
+}
+
 function cmdExit(ctx) {
   print(ctx, c.dim('Stay sharp. Goodbye.'));
   ctx.requestExit();
@@ -459,6 +540,7 @@ const COMMANDS = {
   '?': cmdHelp,
   challenges: cmdChallenges,
   ls: cmdChallenges,
+  ch: cmdChallenges, // secret shortcut (intentionally undocumented)
   open: cmdOpen,
   show: cmdOpen,
   files: cmdFiles,
@@ -469,6 +551,11 @@ const COMMANDS = {
   stats: cmdStats,
   whoami: cmdStats,
   profile: cmdStats,
+  scoreboard: cmdScoreboard,
+  sb: cmdScoreboard, // secret shortcut (intentionally undocumented)
+  requirements: cmdRequirements,
+  rq: cmdRequirements,
+  changelog: cmdChangelog,
   admin: cmdAdmin,
   login: cmdAdmin,
   logout: cmdLogout,

package/src/ui.js

@@ -95,12 +95,30 @@ function progressBar(done, total, width = 24) {
   return `${bar} ${safeDone}/${safeTotal} ${c.dim(`(${pct}%)`)}`;
 }
 
+// The rank ladder: the minimum points required to hold each rank, ascending.
+// rankFor() and the in-platform `requirements` command both read from this so
+// the thresholds live in exactly one place.
+const RANKS = [
+  { name: 'Recruit', min: 0 },
+  { name: 'Script Kiddie', min: 100 },
+  { name: 'Pentester', min: 300 },
+  { name: 'Operator', min: 600 },
+  { name: 'Elite', min: 1000 },
+];
+
 function rankFor(points) {
-  if (points >= 1000) return 'Elite';
-  if (points >= 600) return 'Operator';
-  if (points >= 300) return 'Pentester';
-  if (points >= 100) return 'Script Kiddie';
-  return 'Recruit';
+  const pts = Number(points) || 0;
+  let rank = RANKS[0].name;
+  for (const r of RANKS) {
+    if (pts >= r.min) rank = r.name;
+  }
+  return rank;
+}
+
+// The next rank above the given points, or null if already at the top.
+function nextRank(points) {
+  const pts = Number(points) || 0;
+  return RANKS.find((r) => r.min > pts) || null;
 }
 
 module.exports = {
@@ -109,5 +127,7 @@ module.exports = {
   welcomeScreen,
   table,
   progressBar,
+  RANKS,
   rankFor,
+  nextRank,
 };