@ericrisco/rsc 0.1.20 → 0.1.21

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.20",
+  "version": "0.1.21",
   "counts": {
     "skills": 231
   },

package/package.json

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

package/scripts/install-apply.js

@@ -3,7 +3,7 @@ import { rmSync, existsSync, cpSync, mkdirSync, readFileSync, writeFileSync } fr
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { planInstall } from './install-plan.js';
-import { targetPaths, writeSkill, wireHook, baseDir } from '../targets/index.js';
+import { targetPaths, writeSkill, wireHook, unwireHook, baseDir, TARGET_IDS } from '../targets/index.js';
 import { readState, writeState } from './lib/state.js';
 
 const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
@@ -77,6 +77,34 @@ export async function uninstall({ skillIds, target, home, cwd = process.cwd(), d
   return removed;
 }
 
+// Remove EVERYTHING rsc put in this project: installed skills across all targets,
+// the wired hooks (settings.json entries / AGENTS-blocks / cursor rules), and the
+// shared `.rsc/` (base + hook scripts + version marker). `02-DOCS/` is the user's
+// own knowledge — kept unless `withDocs` is set. Returns the paths touched.
+export async function purge({ home, cwd = process.cwd(), withDocs = false, dryRun = false } = {}) {
+  const removed = [];
+  const drop = (p, recursive = false) => {
+    if (!existsSync(p)) return;
+    removed.push(p);
+    if (!dryRun) rmSync(p, { recursive, force: true });
+  };
+  for (const target of TARGET_IDS) {
+    const paths = targetPaths(target, home, cwd);
+    if (existsSync(paths.stateFile)) {
+      const state = readState(paths.stateFile);
+      for (const id of Object.keys(state.skills || {})) {
+        for (const f of state.skills[id].files || []) drop(f, true);
+      }
+      drop(paths.stateFile);
+    }
+    // unwireHook mutates files, so only run it for real (dry runs skip it).
+    if (!dryRun) removed.push(...unwireHook(target, paths));
+  }
+  drop(join(cwd, '.rsc'), true);
+  if (withDocs) drop(join(cwd, '02-DOCS'), true);
+  return removed;
+}
+
 if (import.meta.url === `file://${process.argv[1]}`) {
   const ids = process.argv.slice(2);
   applyInstall({ skillIds: ids, target: 'claude' }).then(() => console.log('installed', ids.join(', ')));

package/scripts/rsc.js

@@ -4,7 +4,7 @@ import { detectTarget, TARGETS } from '../targets/index.js';
 import { detectRepo } from './detect-repo.js';
 import { rank } from './consult.js';
 import { expandRecommends, toOutcomes, hasOutcome } from './lib/recommend.js';
-import { applyInstall, listInstalled, uninstall } from './install-apply.js';
+import { applyInstall, listInstalled, uninstall, purge } from './install-apply.js';
 import { doctor } from './doctor.js';
 import { say, select, pickFrom, banner, confirm } from './lib/ui.js';
 import { refreshRegistry, registryStatus } from './lib/registry.js';
@@ -19,6 +19,15 @@ function flag(name) {
   return i >= 0 ? (argv[i + 1] || true) : undefined;
 }
 
+// Remove everything rsc installed in this project (skills, hooks, .rsc/), across
+// every assistant. Keeps 02-DOCS/ unless --with-docs. `purge` / `uninstall --all`.
+async function runPurge(dryRun, withDocs) {
+  const removed = await purge({ cwd: process.cwd(), withDocs, dryRun });
+  say(`${dryRun ? 'Would remove' : 'Removed'} ${removed.length} path(s):`);
+  for (const r of removed) say(`  - ${r}`);
+  if (!withDocs) say('\nKept 02-DOCS/ (your knowledge base). Add --with-docs to remove it too.');
+}
+
 async function recommendIds(query, { labeledOnly = false } = {}) {
   const m = loadManifest();
   const repo = detectRepo();
@@ -207,13 +216,17 @@ async function main() {
     }
     case 'uninstall': {
       const dry = argv.includes('--dry-run');
+      // `uninstall --all` is an alias for a full purge.
+      if (argv.includes('--all')) return void (await runPurge(dry, argv.includes('--with-docs')));
       const ids = argv.slice(1).filter((a) => !a.startsWith('--'));
       const removed = await uninstall({ skillIds: ids, target, dryRun: dry });
       return void say((dry ? 'Would remove:\n' : 'Removed:\n') + (removed.join('\n') || '(nothing)'));
     }
+    case 'purge':
+      return void (await runPurge(argv.includes('--dry-run'), argv.includes('--with-docs')));
     default:
       say(`rsc: unknown command '${cmd}'.`);
-      say('Use: npx @ericrisco/rsc | add <id...> | install --profile <p> | consult "<text>" | list | audit | registry refresh | doctor | uninstall <id>');
+      say('Use: npx @ericrisco/rsc | add <id...> | install --profile <p> | consult "<text>" | list | audit | registry refresh | doctor | uninstall <id> | purge');
   }
 }
 

package/targets/_md-block.js

@@ -28,6 +28,19 @@ export function wireHook(paths, sourceMd) {
   return [paths.hookTarget];
 }
 
+// Inverse of wireHook: remove the marked rsc-suggest block from the shared
+// instructions file, leaving the user's own content intact. No-op when absent.
+export function unwireHook(paths) {
+  if (!existsSync(paths.hookTarget)) return [];
+  const doc = readFileSync(paths.hookTarget, 'utf8');
+  if (!doc.includes(MARK_START)) return [];
+  const cleaned = doc
+    .replace(new RegExp(`\\n*${MARK_START}[\\s\\S]*?${MARK_END}\\n*`), '\n')
+    .replace(/\n{3,}/g, '\n\n');
+  writeFileSync(paths.hookTarget, cleaned);
+  return [paths.hookTarget];
+}
+
 function stripFrontmatter(md) {
   return md.replace(/^---\n[\s\S]*?\n---\n?/, '');
 }

package/targets/claude.js

@@ -14,6 +14,29 @@ export function writeSkill(id, fromDir, toPath) {
   return linkOrCopy(fromDir, toPath);
 }
 
+// Inverse of wireHook: drop every rsc-wired hook entry (any command pointing at a
+// .rsc/ script — session-start, worklog-checkpoint, ship-guard, danger-guard, … —
+// plus the legacy cat-form) from settings.json, across all events. User hooks and
+// other settings are preserved. Empty event arrays (and an empty hooks object) are
+// pruned so we don't leave noise behind.
+export function unwireHook(paths) {
+  const file = paths.hookTarget;
+  if (!existsSync(file)) return [];
+  let settings;
+  try { settings = JSON.parse(readFileSync(file, 'utf8')); } catch { return []; }
+  if (!settings.hooks) return [];
+  for (const event of Object.keys(settings.hooks)) {
+    settings.hooks[event] = (settings.hooks[event] || []).filter((e) => {
+      const s = JSON.stringify(e);
+      return !s.includes('.rsc/') && !s.includes('skills/rsc/suggest');
+    });
+    if (settings.hooks[event].length === 0) delete settings.hooks[event];
+  }
+  if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
+  writeFileSync(file, JSON.stringify(settings, null, 2) + '\n');
+  return [file];
+}
+
 // SessionStart runs a project-local session-start.mjs via `node`: it prints
 // suggest's always-on body, an onboarding banner when the workspace has no harness
 // profile yet, and an auto-ingest nudge when the inbox has un-ingested material. We

package/targets/cursor.js

@@ -1,4 +1,4 @@
-import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 
 export function writeSkill(id, fromDir, toPath) {
@@ -15,6 +15,13 @@ export function wireHook(paths, sourceMd) {
   return [paths.hookTarget];
 }
 
+// Inverse of wireHook: the cursor detector is its own file, so just remove it.
+export function unwireHook(paths) {
+  if (!existsSync(paths.hookTarget)) return [];
+  rmSync(paths.hookTarget, { force: true });
+  return [paths.hookTarget];
+}
+
 function stripFrontmatter(md) {
   return md.replace(/^---\n[\s\S]*?\n---\n?/, '');
 }

package/targets/index.js

@@ -125,3 +125,13 @@ export function writeSkill(target, id, fromDir, toPath) {
 export function wireHook(target, paths, sourceMd) {
   return ADAPTER[SPEC[target].adapter].wireHook(paths, sourceMd);
 }
+
+// Inverse of wireHook — remove rsc's always-on surface for a target (settings.json
+// hook entries / AGENTS-block / cursor rule file). Returns the paths it touched.
+export function unwireHook(target, paths) {
+  const adapter = ADAPTER[SPEC[target].adapter];
+  return adapter.unwireHook ? adapter.unwireHook(paths) : [];
+}
+
+// Every known target id — used by `purge` to sweep all assistants, installed or not.
+export const TARGET_IDS = Object.keys(SPEC);