@przeprogramowani/10x-cli 1.27.0 → 1.29.0

package/README.md

@@ -309,13 +309,18 @@ releases and suggests running `10x sync`.
 10x changelog --since 2026-10-01 --limit 50
 ```
 
-Releases are listed newest first as `vX.Y.Z — <date>` followed by their notes, or
-`No toolkit changes since <baseline>.` Exit code is `0` whether or not there are
-new releases; an invalid `--since`/`--limit` exits `2`, a missing login `3`. Against
+The output starts with where the project stands (for example `This project is on
+toolkit v2.59.2 (recorded by 10x sync on 2026-10-05) — 2 newer releases:`), then
+lists releases newest first: `vX.Y.Z — <date>`, the release highlights as bullets,
+and the changed skills, prompts, rules and config templates with a status mark
+(`+` new, `~` changed, `-` removed, `>` renamed) and a one-line summary. Colours are
+used only on an interactive terminal and respect `NO_COLOR`. Exit code is `0`
+whether or not there are new releases; an invalid `--since`/`--limit` exits `2`, a
+missing login `3`, and an account without course access `4`. Against
 a backend that does not serve the changelog yet the command fails with
 `changelog_unsupported` (exit `1`); `get` and `sync` keep working. JSON output
-(`--json` or piped) is `{ baseline: { source, version?, date? }, newEntries,
-entries }`, where `source` is `flag`, `sync`, `applied` or `none`.
+(`--json` or piped) is `{ baseline: { source, version?, date?, recordedAt? },
+newEntries, entries }`, where `source` is `flag`, `sync`, `applied` or `none`.
 
 ### `10x bench`
 

package/dist/index.mjs

@@ -3183,7 +3183,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@przeprogramowani/10x-cli",
-  version: "1.27.0",
+  version: "1.29.0",
   description: "Open-source CLI for 10xDevs course content",
   repository: {
     type: "git",
@@ -3929,7 +3929,7 @@ function isChangelogEntry(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return false;
   const e2 = value;
-  if (e2["schemaVersion"] !== undefined && typeof e2["schemaVersion"] !== "number")
+  if (e2["schemaVersion"] !== 1)
     return false;
   if (typeof e2["version"] !== "string" || !e2["version"])
     return false;
@@ -3939,6 +3939,8 @@ function isChangelogEntry(value) {
     return false;
   if (e2["model"] !== null && typeof e2["model"] !== "string")
     return false;
+  if (!Array.isArray(e2["highlights"]) || !e2["highlights"].every((h2) => typeof h2 === "string"))
+    return false;
   const artifacts = e2["artifacts"];
   if (!artifacts || typeof artifacts !== "object" || Array.isArray(artifacts))
     return false;
@@ -3948,7 +3950,7 @@ function isChangelogEntry(value) {
       if (!item || typeof item !== "object")
         return false;
       const change = item;
-      return typeof change["name"] === "string" && typeof change["status"] === "string" && CHANGELOG_STATUSES.includes(change["status"]);
+      return typeof change["name"] === "string" && typeof change["status"] === "string" && CHANGELOG_STATUSES.includes(change["status"]) && (change["summary"] === null || typeof change["summary"] === "string");
     });
   });
 }
@@ -4565,6 +4567,38 @@ function formatReleaseAt(iso, now = new Date) {
     return `${absolute} (tomorrow)`;
   return `${absolute} (in ${days} days)`;
 }
+function colorsEnabled() {
+  return process.env["NO_COLOR"] === undefined && process.stderr.isTTY === true;
+}
+var STYLE = {
+  bold: "1",
+  dim: "2",
+  red: "31",
+  green: "32",
+  yellow: "33",
+  cyan: "36"
+};
+function paint(style, text) {
+  if (!colorsEnabled())
+    return text;
+  return `\x1B[${style}m${text}\x1B[0m`;
+}
+function wrapText(text, width, prefix, indent = " ".repeat(prefix.length)) {
+  const lines = [];
+  let line = prefix;
+  let empty = true;
+  for (const word of text.split(/\s+/).filter(Boolean)) {
+    if (!empty && line.length + 1 + word.length > width) {
+      lines.push(line);
+      line = indent + word;
+    } else {
+      line += (empty ? "" : " ") + word;
+    }
+    empty = false;
+  }
+  lines.push(line);
+  return lines;
+}
 
 // src/commands/bench.ts
 function registerBenchCommand(cli) {
@@ -4604,22 +4638,6 @@ function handleBenchError(ctx, status, code, error) {
   }
   outputError(ctx, code || "bench_failed", "Failed to load the leaderboard.", ExitCodes.ERROR, error ? `Server said: ${error}` : undefined);
 }
-function colorsEnabled() {
-  return process.env["NO_COLOR"] === undefined && process.stderr.isTTY === true;
-}
-var STYLE = {
-  bold: "1",
-  dim: "2",
-  red: "31",
-  green: "32",
-  yellow: "33",
-  cyan: "36"
-};
-function paint(style, text) {
-  if (!colorsEnabled())
-    return text;
-  return `\x1B[${style}m${text}\x1B[0m`;
-}
 function scoreStyle(percentage) {
   if (percentage >= 90)
     return STYLE.green;
@@ -5830,7 +5848,7 @@ function resolveManifestBaseline(ctx, projectRoot) {
   const { profile, manifest } = found;
   verbose(ctx, `using manifest in ${profile.manifestDir}/`);
   if (manifest.toolkit)
-    return { source: "sync", version: manifest.toolkit.version };
+    return { source: "sync", version: manifest.toolkit.version, recordedAt: manifest.toolkit.recordedAt };
   const applied = newestAppliedAt(manifest);
   if (applied)
     return { source: "applied", date: applied };
@@ -5854,6 +5872,9 @@ function handleChangelogError(ctx, status, code, error) {
   if (code === "changelog_unsupported") {
     outputError(ctx, code, "The 10x-toolkit API does not support the toolkit changelog yet.", ExitCodes.ERROR, "The changelog endpoint has not been deployed yet. Try again later; '10x sync' still updates your files.");
   }
+  if (status === 403) {
+    outputError(ctx, "course_access_denied", "Your account has no active course access, so there is no toolkit changelog to show.", ExitCodes.FORBIDDEN);
+  }
   if (status === 401) {
     outputError(ctx, "auth_required", "Your session is no longer valid.", ExitCodes.AUTH_REQUIRED, "Run '10x auth' to log in again.");
   }
@@ -5862,48 +5883,87 @@ function handleChangelogError(ctx, status, code, error) {
   }
   outputError(ctx, code || "changelog_failed", error || "Failed to load the toolkit changelog.", ExitCodes.ERROR);
 }
-function describeBaseline(baseline) {
-  return baseline.version ?? baseline.date ?? "";
-}
-function describeSource(baseline) {
+var day = (iso) => (iso ?? "").slice(0, 10);
+var plural = (n, word) => `${n} ${word}${n === 1 ? "" : "s"}`;
+function header(baseline, count) {
+  const v3 = paint(STYLE.bold, baseline.version ?? "");
   switch (baseline.source) {
+    case "sync":
+      return `This project is on toolkit ${v3} ${paint(STYLE.dim, `(recorded by 10x sync on ${day(baseline.recordedAt)})`)}${count ? ` — ${plural(count, "newer release")}:` : ""}`;
     case "flag":
-      return "from --since";
+      return baseline.version ? `Toolkit changes since ${v3}:` : `Toolkit changes since ${paint(STYLE.bold, day(baseline.date))}:`;
+    case "applied":
+      return `No toolkit version recorded in this project — showing changes since your last lesson apply (${day(baseline.date)}):`;
+    case "none":
+      return `No toolkit version recorded in this project — showing the latest ${plural(count, "release")}:`;
+  }
+}
+function emptyMessage(baseline) {
+  switch (baseline.source) {
     case "sync":
-      return "recorded by your last 10x sync";
+      return "You're up to date — no toolkit changes since then.";
+    case "flag":
+      return `No toolkit changes since ${baseline.version ?? day(baseline.date)}.`;
     case "applied":
-      return "last lesson applied in this project";
+      return `No toolkit changes since ${day(baseline.date)}.`;
     case "none":
-      return "no baseline recorded";
+      return "No toolkit changes published yet.";
   }
 }
+var MAX_WIDTH = 100;
+var CATEGORIES = [
+  ["skills", "Skills"],
+  ["prompts", "Prompts"],
+  ["rules", "Rules"],
+  ["configTemplates", "Config templates"]
+];
+var STATUS = {
+  added: { mark: "+", style: STYLE.green, label: "new" },
+  modified: { mark: "~", style: STYLE.yellow },
+  removed: { mark: "-", style: STYLE.red, label: "removed" },
+  renamed: { mark: ">", style: STYLE.cyan, label: "renamed" }
+};
+function renderEntry(entry, width) {
+  const lines = [`${paint(STYLE.bold, paint(STYLE.cyan, entry.version))} ${paint(STYLE.dim, `— ${entry.releasedAt.slice(0, 10)}`)}`];
+  for (const highlight of entry.highlights)
+    lines.push(...wrapText(sanitize(highlight), width, "  • "));
+  for (const [category, label] of CATEGORIES) {
+    const items = entry.artifacts[category];
+    if (items.length === 0)
+      continue;
+    lines.push("", `  ${paint(STYLE.bold, label)}`);
+    for (const item of items) {
+      const status = STATUS[item.status];
+      const suffix = status.label ? ` ${paint(STYLE.dim, `(${status.label})`)}` : "";
+      lines.push(`    ${paint(status.style, status.mark)} ${paint(STYLE.bold, sanitize(item.name))}${suffix}`);
+      if (item.summary)
+        lines.push(...wrapText(sanitize(item.summary), width, "      "));
+    }
+  }
+  return lines;
+}
+function pushSyncHint(lines, baseline) {
+  if (baseline.source !== "none" && baseline.source !== "applied")
+    return;
+  lines.push("", paint(STYLE.dim, "Run 10x sync to record this project's toolkit version; 10x changelog will then show only what changed since."));
+}
 function render(ctx, baseline, entries) {
   if (ctx.json) {
     output(ctx, "", { baseline, newEntries: entries.length, entries });
     return;
   }
-  const lines = [];
-  if (baseline.source === "none") {
-    lines.push(`Latest toolkit changes (${describeSource(baseline)})`);
-  } else {
-    lines.push(`Toolkit changes since ${describeBaseline(baseline)} (${describeSource(baseline)})`);
-  }
-  lines.push("");
   if (entries.length === 0) {
-    lines.push(baseline.source === "none" ? "No toolkit changes published yet." : `No toolkit changes since ${describeBaseline(baseline)}.`);
-  } else {
-    entries.forEach((entry, index) => {
-      if (index > 0)
-        lines.push("");
-      lines.push(`${entry.version} — ${entry.releasedAt.slice(0, 10)}`);
-      lines.push("");
-      lines.push(entry.markdown.trimEnd());
-    });
-  }
-  if (baseline.source === "none") {
-    lines.push("");
-    lines.push("Run 10x sync to record your baseline.");
+    const lines2 = baseline.source === "sync" ? [header(baseline, 0), emptyMessage(baseline)] : [emptyMessage(baseline)];
+    pushSyncHint(lines2, baseline);
+    output(ctx, lines2.join(`
+`), undefined);
+    return;
   }
+  const width = Math.min(process.stderr.columns || 80, MAX_WIDTH);
+  const lines = [header(baseline, entries.length)];
+  for (const entry of entries)
+    lines.push("", ...renderEntry(entry, width));
+  pushSyncHint(lines, baseline);
   output(ctx, lines.join(`
 `), undefined);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@przeprogramowani/10x-cli",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "description": "Open-source CLI for 10xDevs course content",
   "repository": {
     "type": "git",