cc-cream 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -6,6 +6,20 @@ All notable changes to cc-cream are documented here. Format follows
 
 ## [Unreleased]
 
+## [0.3.2] — 2026-05-30
+
+### Fixed
+- **`npm run coverage` (and the pre-push hook) no longer crash on Node ≥ 26.** `c8@11` does `require('yargs/yargs')`, and yargs 17's `exports` map resolves that to an **extensionless** CJS file; under Node 26's `require(ESM)` loader an extensionless file in a `"type": "module"` package is parsed as ESM, throwing `ReferenceError: require is not defined in ES module scope`. This broke the `simple-git-hooks` pre-push gate, forcing `SKIP_SIMPLE_GIT_HOOKS=1` on every push. Pinned yargs to `^18.0.0` via `overrides` — its `./yargs` export is a proper `.mjs` that Node 26 loads cleanly, and `c8@11` works against it unchanged (all 248 scenarios green under coverage). Dev-only; no runtime-dependency or published-package impact.
+- **The uninstall receipt's cache-path escape hatch is now copy-pasteable.** It printed `…/cc-cream/cc-cream/<version>/src/install.js`, but the receipt reaches the user through the `/cc-cream:uninstall` slash command, whose output Claude Code renders as **markdown — which strips `<version>` as an HTML-like tag**. The user saw `cc-cream//src` (empty version) and pasting it failed with `MODULE_NOT_FOUND`, breaking the documented npm-free recovery path exactly when it's needed. The receipt now prints install.js's own resolved absolute path — via the slash command that's the real versioned cache copy — so it's both version-accurate and free of any stripped placeholder. The README uses a markdown-safe `VERSION` placeholder with an `ls` hint to read off the real one (CREAM-rhtrzwss).
+
+### Internal
+- **Internal spec/working docs and the fp-managed `FP_CLAUDE.md` are no longer tracked in git.** `docs/` (PRD, release plan, code-review notes, install-lifecycle notes) and `FP_CLAUDE.md` are local working references, now gitignored and removed from the repo to keep the public tree focused on shipped code. No effect on the published npm package — its `files` allowlist (`src/`, `LICENSE`, `README.md`, `CHANGELOG.md`) never included them.
+
+## [0.3.1] — 2026-05-30
+
+### Fixed
+- **`/cc-cream:setup` and `/cc-cream:uninstall` now actually show their result.** A `!` bang command's output is injected as model *context*, not displayed to the user (Claude Code's design), and the command bodies never told the model to surface it — so the install/uninstall *worked* but the model just replied "ready, what's next?" and the receipt (including how to clear the lingering cache) was never shown, on every model. Both command files now instruct the model to print the command output verbatim.
+
 ## [0.3.0] — 2026-05-30
 
 ### Added

package/README.md

@@ -151,9 +151,12 @@ message — restart an already-open session to drop it immediately.
 > `statusLine` line still lingers in `settings.json`.
 >
 > To clear that leftover line once the plugin is gone, the **guaranteed** route is
-> the copy of the uninstaller still in the cache — npm-free and always present:
+> the copy of the uninstaller still in the cache — npm-free and always present.
+> `VERSION` is the single directory under that path (run the `ls` first to read it
+> off); `/cc-cream:uninstall` also prints the fully-resolved command:
 > ```bash
-> node ~/.claude/plugins/cache/cc-cream/cc-cream/<version>/src/install.js --uninstall
+> ls ~/.claude/plugins/cache/cc-cream/cc-cream/        # e.g. 0.3.1
+> node ~/.claude/plugins/cache/cc-cream/cc-cream/VERSION/src/install.js --uninstall
 > # add --purge to also remove your config
 > ```
 > The npm bin does the same job, but **not always**: a *freshly published* version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-cream",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Claude Code cache/context/cost status-line tool",
   "directories": {
     "doc": "docs"
@@ -60,5 +60,8 @@
     "c8": "^11.0.0",
     "knip": "^6.14.2",
     "simple-git-hooks": "^2.13.1"
+  },
+  "overrides": {
+    "yargs": "^18.0.0"
   }
 }

package/src/install.js

@@ -21,6 +21,12 @@ import { isEntrypoint } from './utils.js';
 
 export { writeFileAtomic } from './settings.js';
 
+// Absolute path of THIS install.js. When the /cc-cream:uninstall slash command
+// runs it, that's the versioned plugin-cache copy — the durable, npm-free
+// escape hatch we advertise in the uninstall receipt (resolved, not guessed, so
+// it carries the real version and no markdown-stripped placeholder).
+const SELF_PATH = fileURLToPath(import.meta.url);
+
 const TRUST_NOTE =
   'The bar appears on your next message — restart only an already-open session, and the workspace must be trusted.';
 
@@ -255,18 +261,32 @@ async function uninstall({ purge }) {
   printUninstallReceipt();
 }
 
+// Shorten an absolute path under $HOME to a `~/…` form for display. The shell
+// still expands `~`, so the result stays copy-pasteable.
+function tildeify(p) {
+  const home = os.homedir();
+  return p === home || p.startsWith(`${home}/`) ? `~${p.slice(home.length)}` : p;
+}
+
 // The closing receipt. No Claude Code host removal path drops our statusLine OR
 // the version cache, so spell out what's gone, what the host leaves behind, and
 // the npm-free escape hatch (the lingering cache always has a working install.js).
 // See project memory cc-cream-plugin-lifecycle-findings.
+//
+// The escape-hatch line prints SELF_PATH — this install.js's real, resolved
+// location — NOT a `<version>` placeholder. The receipt reaches the user through
+// the slash command, whose output Claude Code renders as markdown; `<version>`
+// was silently stripped to an empty segment (cc-cream//src), breaking copy-paste
+// exactly when it's needed (CREAM-rhtrzwss). Via the slash command SELF_PATH IS
+// the versioned cache copy, so the path is both accurate and markdown-safe.
 function printUninstallReceipt() {
   console.log('\nDone — the bar disappears on your next message (restart an already-open session to drop it now).');
   console.log('The host leaves the rest behind; to fully remove cc-cream:');
   console.log('  • Plugin: /plugin uninstall cc-cream  then  /plugin marketplace remove cc-cream');
   console.log('  • Version cache (never auto-removed): rm -rf ~/.claude/plugins/cache/cc-cream');
   console.log('  • The /cc-cream:* slash commands linger in this session until you restart Claude Code.');
-  console.log('Already removed the plugin? This same uninstall lives in the cache:');
-  console.log('  node ~/.claude/plugins/cache/cc-cream/cc-cream/<version>/src/install.js --uninstall [--purge]');
+  console.log('Re-run this uninstall later (e.g. the plugin is gone but the bar lingers) — it lives at:');
+  console.log(`  node ${tildeify(SELF_PATH)} --uninstall [--purge]`);
 }
 
 // `cc-cream-setup --check-config`: lint ~/.claude/cc-cream.json against the