@ericrisco/rsc 0.1.11 → 0.1.13

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.11",
+  "version": "0.1.13",
   "counts": {
     "skills": 231
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ericrisco/rsc",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Eric Risco's agent-skills catalog as a granular, self-recommending CLI installer.",
   "type": "module",
   "bin": {

package/scripts/lib/ui.js

@@ -57,13 +57,33 @@ function hsl(h, s = 1, l = 0.6) {
 }
 
 // One frame: rainbow per character, diagonal phase, revealed up to `cols`.
-function frame(phase, cols) {
+const SPARK = ['✦', '✧', '⋆', '✺', '·', '*'];
+const SPARK_C = ['\x1b[1;97m', '\x1b[1;93m', '\x1b[1;96m']; // bright white / yellow / cyan
+
+// `n` random twinkles as a Map "r,c" -> pre-coloured glyph string.
+function sparkles(n, rows, W) {
+  const m = new Map();
+  for (let i = 0; i < n; i++) {
+    const r = Math.floor(Math.random() * rows);
+    const c = Math.floor(Math.random() * W);
+    const g = SPARK[Math.floor(Math.random() * SPARK.length)];
+    m.set(`${r},${c}`, SPARK_C[Math.floor(Math.random() * SPARK_C.length)] + g);
+  }
+  return m;
+}
+
+// One frame: rainbow per character (or white), revealed up to `cols`, with
+// sparkles overlaid on top wherever the map has a position.
+function frame(phase, cols, sparks, white) {
   return ART.map((line, r) => {
     const chars = [...line];
     let out = '';
     for (let c = 0; c < chars.length && c < cols; c++) {
+      const sp = sparks && sparks.get(`${r},${c}`);
+      if (sp) { out += sp; continue; }
       const ch = chars[c];
       if (ch === ' ') { out += ' '; continue; }
+      if (white) { out += `\x1b[1;97m${ch}`; continue; }
       const [rr, gg, bb] = hsl((c * 5 + r * 14 + phase * 20) % 360);
       out += `\x1b[1;38;2;${rr};${gg};${bb}m${ch}`;
     }
@@ -83,27 +103,31 @@ export async function banner() {
   const W = Math.max(...ART.map((l) => [...l].length));
   stdout.write('\x1b[?25l'); // hide cursor
   say('');
-  // 1) letters slide in left → right
+  // 1) letters slide in left → right, a sparkle riding the drawing edge
   let first = true;
   for (let cols = 2; cols <= W; cols += 2) {
     if (!first) stdout.write(`\x1b[${rows}A`);
     first = false;
-    stdout.write(frame(0, cols));
+    const edge = new Map();
+    const er = Math.floor(Math.random() * rows);
+    edge.set(`${er},${Math.min(cols - 1, W - 1)}`, '\x1b[1;97m✦');
+    if (Math.random() < 0.5) edge.set(`${Math.floor(Math.random() * rows)},${Math.min(cols, W - 1)}`, '\x1b[1;93m·');
+    stdout.write(frame(0, cols, edge));
     await sleep(12);
   }
-  // 2) flowing rainbow diagonal sweeps
+  // 2) flowing rainbow diagonal sweeps with twinkling sparkles
   for (let phase = 1; phase <= 30; phase++) {
     stdout.write(`\x1b[${rows}A`);
-    stdout.write(frame(phase, W));
+    stdout.write(frame(phase, W, sparkles(4, rows, W)));
     await sleep(26);
   }
-  // 3) double white flash — the pop
+  // 3) double white flash with a sparkle burst — the pop
   for (let f = 0; f < 2; f++) {
     stdout.write(`\x1b[${rows}A`);
-    stdout.write(ART.map((l) => `\x1b[2K\x1b[1;97m${l}\x1b[0m`).join('\n') + '\n');
+    stdout.write(frame(0, W, sparkles(12, rows, W), true));
     await sleep(60);
     stdout.write(`\x1b[${rows}A`);
-    stdout.write(frame(15, W));
+    stdout.write(frame(15, W, sparkles(3, rows, W)));
     await sleep(60);
   }
   // settle on a final rainbow snapshot
@@ -143,7 +167,7 @@ function tuiSelect(question, options) {
     const paint = makePainter();
     const render = () => paint([
       C.bold(question),
-      C.dim('  ↑↓ move · enter select'),
+      C.dim('  ↑↓ move · enter select · esc back'),
       ...options.map((o, idx) =>
         idx === i ? `${C.cyan('❯')} ${C.cyan(o.label)}` : `  ${o.label}`),
     ]);
@@ -152,7 +176,8 @@ function tuiSelect(question, options) {
       if (key.name === 'up' || key.name === 'k') { i = (i - 1 + options.length) % options.length; render(); }
       else if (key.name === 'down' || key.name === 'j') { i = (i + 1) % options.length; render(); }
       else if (key.name === 'return') { stop(); resolve(options[i].key); }
-      else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) { stop(); stdout.write('\n'); process.exit(130); }
+      else if (key.name === 'escape') { stop(); resolve(null); }              // back / cancel
+      else if (key.ctrl && key.name === 'c') { stop(); stdout.write('\n'); process.exit(130); } // hard quit
     });
   });
 }
@@ -177,7 +202,7 @@ function tuiChecklist(title, items) {
       const more = items.length > VISIBLE ? C.dim(`  (${cur + 1}/${items.length})`) : '';
       paint([
         C.bold(title),
-        C.dim('  ↑↓ move · space toggle · a all · enter confirm') + more,
+        C.dim('  ↑↓ move · space toggle · a all · enter confirm · esc back') + more,
         ...rows,
       ]);
     };
@@ -188,7 +213,8 @@ function tuiChecklist(title, items) {
       else if (key.name === 'space') { sel.has(cur) ? sel.delete(cur) : sel.add(cur); render(); }
       else if (str === 'a') { if (sel.size === items.length) sel.clear(); else items.forEach((_, idx) => sel.add(idx)); render(); }
       else if (key.name === 'return') { stop(); resolve([...sel].sort((x, y) => x - y).map((idx) => items[idx].id)); }
-      else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) { stop(); stdout.write('\n'); process.exit(130); }
+      else if (key.name === 'escape') { stop(); resolve(null); }              // back without changing
+      else if (key.ctrl && key.name === 'c') { stop(); stdout.write('\n'); process.exit(130); } // hard quit
     });
   });
 }

package/scripts/rsc.js

@@ -31,15 +31,19 @@ async function recommendIds(query, { labeledOnly = false } = {}) {
 }
 
 // Pick skills by browsing the domains, accumulating across rounds.
+// Returns the chosen skill ids, or null if the user backed out to the main menu.
 async function manualSelect() {
   const chosen = new Set();
   for (;;) {
     const opts = DOMAINS.map((d, i) => ({ key: String(i), label: `${d.title} (${d.ids.length})` }));
-    opts.push({ key: 'done', label: chosen.size ? `✅ Finish & install (${chosen.size} chosen)` : 'Finish without choosing anything' });
+    opts.push({ key: 'done', label: chosen.size ? `✅ Finish & install (${chosen.size} chosen)` : 'Finish (install nothing)' });
+    opts.push({ key: 'back', label: '← Back to the main menu' });
     const k = await select('\nWhich area do you want to install skills from?', opts);
-    if (k === 'done' || k === null) break;
+    if (k === 'back' || k === null) return null;          // esc or Back → main menu
+    if (k === 'done') break;
     const d = DOMAINS[parseInt(k, 10)];
-    (await pickFrom(`${d.title}:`, d.ids)).forEach((id) => chosen.add(id));
+    const picked = await pickFrom(`${d.title}:`, d.ids);  // null = esc → leave this area unchanged
+    if (picked) picked.forEach((id) => chosen.add(id));
     say(`   → ${chosen.size} skills chosen so far.`);
   }
   return [...chosen];
@@ -54,6 +58,7 @@ async function selectAgents() {
     label: `${t.label}  (${t.hint})${t.id === detected ? '   ⟵ detected here' : ''}`,
   }));
   const chosen = await pickFrom('Which assistants do you want to install for? (space to toggle, a = all)', items);
+  if (chosen === null) return null;          // esc → back to the main menu
   return chosen.length ? chosen : [detected];
 }
 
@@ -91,39 +96,48 @@ async function wizard() {
   const m = loadManifest();
   await banner();
   say('  the skill catalog for your assistant (Claude Code · Codex · Cursor · Gemini · Antigravity)\n');
-  const choice = await select('What do you want to do?', [
-    { key: 'base', label: 'Base install — the essentials (orient + suggest + harness + init)' },
-    { key: 'sdd', label: 'Base + Spec-Driven Development — the specify → plan → implement → ship flow' },
-    { key: 'manual', label: 'Pick skills by hand, by area' },
-  ]);
+  // Navigable loop: esc / "← Back" / "no" all return here instead of quitting.
+  for (;;) {
+    const choice = await select('What do you want to do?', [
+      { key: 'base', label: 'Base install — the essentials (orient + suggest + harness + init)' },
+      { key: 'sdd', label: 'Base + Spec-Driven Development — the specify → plan → implement → ship flow' },
+      { key: 'manual', label: 'Pick skills by hand, by area' },
+    ]);
+    if (choice === null) { say('\nOK — nothing installed. Anytime: npx @ericrisco/rsc'); return; }
 
-  let ids = [];
-  if (choice === 'base') ids = skillsForProfile(m, 'minimal');
-  else if (choice === 'sdd') ids = skillsForProfile(m, 'core');
-  else if (choice === 'manual') ids = await manualSelect();
-  else { say("Didn't catch that. Run again: npx @ericrisco/rsc"); return; }
+    let ids;
+    if (choice === 'base') ids = skillsForProfile(m, 'minimal');
+    else if (choice === 'sdd') ids = skillsForProfile(m, 'core');
+    else if (choice === 'manual') {
+      const picked = await manualSelect();
+      if (picked === null) continue;          // backed out → re-show this menu
+      ids = picked;
+    } else continue;
 
-  // The floor is always installed: the compass + the detector.
-  ids = [...new Set(['orient', 'suggest', ...ids])];
-  if (ids.length <= 2 && choice !== 'base') {
-    say('\nNo skills were chosen. Anytime: npx @ericrisco/rsc');
-    return;
-  }
+    // The floor is always installed: the compass + the detector.
+    ids = [...new Set(['orient', 'suggest', ...ids])];
+    if (ids.length <= 2 && choice !== 'base') {
+      say('\nNothing chosen — back to the menu.');
+      continue;
+    }
 
-  const targets = await selectAgents();
-  say(`\nI'll install ${ids.length} skills for: ${targets.join(', ')}`);
-  say('   ' + ids.join(', '));
-  say('   (real files live once in .rsc/skills/ — each assistant just links to them)');
-  if (!(await confirm('Install it?'))) {
-    say('No problem. Anytime: npx @ericrisco/rsc');
+    const targets = await selectAgents();
+    if (targets === null) continue;           // esc in the assistant picker → back to menu
+    say(`\nI'll install ${ids.length} skills for: ${targets.join(', ')}`);
+    say('   ' + ids.join(', '));
+    say('   (real files live once in .rsc/skills/ — each assistant just links to them)');
+    if (!(await confirm('Install it?'))) {
+      say('Cancelled — back to the menu.');
+      continue;                                // "no" / esc → back to menu, not quit
+    }
+    for (const target of targets) {
+      await applyInstall({ skillIds: ids, target });
+      say(`   ✅ ${target}`);
+    }
+    say(`\n✅ Installed ${ids.length} skills for ${targets.length} assistant(s).`);
+    printNextSteps(targets, ids);
     return;
   }
-  for (const target of targets) {
-    await applyInstall({ skillIds: ids, target });
-    say(`   ✅ ${target}`);
-  }
-  say(`\n✅ Installed ${ids.length} skills for ${targets.length} assistant(s).`);
-  printNextSteps(targets, ids);
 }
 
 async function main() {