corvusmem 0.6.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,18 @@ All notable changes to **Corvusmem** are documented here.
4
4
  Format based on [Keep a Changelog](https://keepachangelog.com/); versions follow [SemVer](https://semver.org/).
5
5
 
6
6
  ## [Unreleased]
7
+ ### Fixed
8
+ - **`/corvus-absorb` works on a WSL project.** The command hard-coded `npx corvusmem import`, and a Windows `npx`
9
+ cannot reach a WSL path (`\\wsl$\…`, no UNC support), so the agent's absorb failed across the boundary. It now uses
10
+ the installed local CLI (`node "<…>/cli/corvusmem.mjs"`) like `/corvus-cortex` and `/corvus-install`, with `npx` only
11
+ as the fallback. README and docs gained a WSL note (run Claude Code and Corvus on the Linux side) and the **Node ≥18**
12
+ requirement is now explicit.
13
+
14
+ ### Changed
15
+ - **The Cortex is dark-only, opens in 3D, and pops the browser.** Removed the light-mode toggle (the standalone Cortex
16
+ is always dark; the web-embedded brain still follows the page theme so it is not a black box on a light page); the
17
+ view now starts in **3D** by default (2D still a click away); and `/corvus-cortex` now opens the generated HTML in the
18
+ browser immediately instead of only printing its path.
7
19
 
8
20
  ## [0.6.0] — 2026-11-18
9
21
  ### Added
package/README.md CHANGED
@@ -100,6 +100,10 @@ project (`--global`, in your home). It does **not** change where memory lives: p
100
100
  project, then commit `.corvusmem/` (the shared project memory) and `.claude/settings.json` — teammates get Corvus firing
101
101
  the moment they clone, with nothing to install. Never commit `~/.config/corvusmem/` — that is your private memory.
102
102
 
103
+ **On WSL**: if your project lives in WSL (`\\wsl$\…`), run **Claude Code and Corvus from inside WSL** so Node and
104
+ `npx` are Linux-native. A Windows `npx` cannot reach a `\\wsl$\…` path (no UNC support), which is what breaks
105
+ `npx corvusmem …` across the boundary; running on the Linux side — where the path is a normal `/home/…` — just works.
106
+
103
107
  ## Usage
104
108
  Once installed, the agent captures and recalls memory on its own — you don't do a thing. Two slash commands come with
105
109
  it (native — no `npx`):
@@ -7,11 +7,14 @@ You are absorbing this project's **existing** knowledge into Corvus. The goal is
7
7
  **Speak the user's language.** Every question, confirmation and the final report go in the language the user writes to you in (Spanish, etc.) — only this command's name and the saved `--keys` identifiers stay in English (and `--keys` should also include the user's own language).
8
8
 
9
9
  ## 1. Find the documents (deterministic — let the tool do this)
10
- Run:
10
+ Use the memory CLI's `import`, with the **fastest local path available** — do **not** default to `npx` (it is only the fallback for an agent with nothing installed, and a Windows `npx` cannot reach a WSL project at `\\wsl$\…` because it does not support UNC paths). Use the first that applies:
11
11
 
12
- ```
13
- npx corvusmem import --json
14
- ```
12
+ - **Plugin** (`CLAUDE_PLUGIN_ROOT` set): `node "$CLAUDE_PLUGIN_ROOT/cli/corvusmem.mjs" import --json`
13
+ - **Per-project** (`.corvusmem/cli/corvusmem.mjs` exists): `node "$CLAUDE_PROJECT_DIR/.corvusmem/cli/corvusmem.mjs" import --json`
14
+ - **Global** (`~/.config/corvusmem/cli/corvusmem.mjs` exists): `node "<that path>" import --json`
15
+ - **Nothing installed** (fallback only): `npx corvusmem import --json`
16
+
17
+ > **WSL:** if the project lives in WSL, run Claude Code (and Corvus) **inside WSL** so Node is Linux-native — mixing a Windows agent with a `\\wsl$\…` path is exactly what breaks `npx`.
15
18
 
16
19
  It returns the memory documents already in the repo in two tiers (`{ agent, docs, truncated, files: [{ tier, kind, rel, lines }] }`):
17
20
 
@@ -37,10 +40,10 @@ Keep every piece of **durable memory** — what should still be true next week:
37
40
  Leave out only the **noise**: install/run steps, step-by-step how-tos, API/parameter dumps you would re-read from the doc anyway, tool tutorials, generic boilerplate, anything obvious from the code, anything transient, and anything already covered by a fact you saved. **When in doubt whether something is durable, keep it** — storage is cheap and recall only ever surfaces the few relevant facts per message, so more good facts make memory richer, never noisier.
38
41
 
39
42
  ## 3. Save each item (deterministic sink)
40
- For every item worth keeping, run one command:
43
+ For every item worth keeping, run one command — the **same local CLI as step 1** (`node "<…>/cli/corvusmem.mjs"`), with `npx corvusmem` only as the fallback:
41
44
 
42
45
  ```
43
- npx corvusmem --save --dimension <family.topic> --value "<self-contained statement>" --keys "<term-en>,<term-native>" --source agente
46
+ node "<corvusmem cli>" --save --dimension <family.topic> --value "<self-contained statement>" --keys "<term-en>,<term-native>" --source agente
44
47
  ```
45
48
 
46
49
  - `family` is one of: `identity`, `preference`, `project`, `goal`, `pending`, `constraint`, `note`, `fact`, `learning`, `link`.
@@ -11,4 +11,6 @@ Run it with the **fastest local path available** — do not default to `npx` (th
11
11
  - **Global install** (`~/.config/corvusmem/cli/corvusmem.mjs` exists): `node "<that path>" --cortex`
12
12
  - **Nothing installed** (fallback only): `npx corvusmem --cortex`
13
13
 
14
- Pick the user's language for anything you say. The command writes a local HTML file and prints its path — tell the user the path so they can open it. Add `--cliente` for a client-facing view, or `--idioma en|es` to force the language. It renders only what is actually stored; never invent memory that is not there.
14
+ The command writes a local HTML file and prints its path. **Open it in the user's browser right away** — don't just hand them the path. Use your browser tool to navigate to the `file://` path if you have one, otherwise the OS opener: `start "" "<path>"` on Windows, `open "<path>"` on macOS, `xdg-open "<path>"` (or `wslview "<path>"` on WSL) on Linux. Then tell the user it is open and give the path too, in case they want to reopen it.
15
+
16
+ Pick the user's language for anything you say. Add `--cliente` for a client-facing view, or `--idioma en|es` to force the language. It renders only what is actually stored; never invent memory that is not there.
package/cortex/cortex.mjs CHANGED
@@ -245,7 +245,6 @@ const APP = String.raw`
245
245
  $$('[data-t-aria]').forEach(function (e) { e.setAttribute('aria-label', t(e.getAttribute('data-t-aria'))); });
246
246
  $$('[data-t-ph]').forEach(function (e) { e.setAttribute('placeholder', t(e.getAttribute('data-t-ph'))); });
247
247
  $$('[data-t-title]').forEach(function (e) { e.setAttribute('title', t(e.getAttribute('data-t-title'))); });
248
- $('#tema').textContent = raiz.getAttribute('data-theme') === 'light' ? t('oscuro') : t('claro');
249
248
  $('#pie').textContent = t('pie', { f: new Date(D.generado).toLocaleString(L) }) + ' ' + (D.cliente ? t('pieCliente') : t('pieDueno'));
250
249
  }
251
250
  var sel = $('#idioma');
@@ -440,17 +439,10 @@ const APP = String.raw`
440
439
  $('#buscar').addEventListener('input', function (e) { filtro = e.target.value.trim().toLowerCase(); limite = PAGINA; lista(); focoBusqueda(); });
441
440
  $('#mas').addEventListener('click', function () { limite += PAGINA * 3; lista(); });
442
441
  $('#cerrar').addEventListener('click', function () { $('#detalle').hidden = true; });
443
- var tema = $('#tema');
444
- tema.addEventListener('click', function () {
445
- var oscuro = raiz.getAttribute('data-theme') === 'light';
446
- raiz.setAttribute('data-theme', oscuro ? 'dark' : 'light');
447
- tema.textContent = oscuro ? t('claro') : t('oscuro'); todo();
448
- });
449
- // Embebido en la web (mismo origen → comparte localStorage): el Cortex SIGUE el tema de la web (clave 'theme';
450
- // 'light' = claro, si no oscuro) para no quedar como una caja negra sobre una página clara (ni texto ilegible en el
451
- // hero transparente). Reacciona al toggle de la web por el evento 'storage'.
442
+ // El Cortex es OSCURO (sin modo claro ni botón de tema). Única excepción: EMBEBIDO en la web (data-solo, mismo origen
443
+ // → comparte localStorage), sigue el tema de la página para no quedar como una caja negra sobre una página clara.
452
444
  function temaWeb() { try { return localStorage.getItem('theme') === 'light' ? 'light' : 'dark'; } catch (e) { return null; } }
453
- function aplicarTemaWeb() { var w = temaWeb(); if (!w) return; raiz.setAttribute('data-theme', w); try { tema.textContent = w === 'light' ? t('oscuro') : t('claro'); } catch (e) {} }
445
+ function aplicarTemaWeb() { if (!raiz.hasAttribute('data-solo')) return; var w = temaWeb(); if (w) raiz.setAttribute('data-theme', w); }
454
446
  aplicarTemaWeb();
455
447
  window.addEventListener('storage', function (e) { if (e.key === 'theme') { aplicarTemaWeb(); todo(); } });
456
448
  var cli = $('#cliente');
@@ -737,7 +729,7 @@ const APP = String.raw`
737
729
  });
738
730
  traducir();
739
731
  todo();
740
- if (raiz.hasAttribute('data-solo')) { var _b3 = $('[data-ir="3d"]'); if (_b3) _b3.click(); } // incrustado: arranca en 3D
732
+ var _b3 = $('[data-ir="3d"]'); if (_b3) _b3.click(); // arranca SIEMPRE en 3D (es la vista por defecto), no solo incrustado
741
733
  })();
742
734
  `;
743
735
 
@@ -786,14 +778,13 @@ export function htmlCortex(datos, { cli = null, idioma = null, soloCerebro = fal
786
778
  <p class="cifras" id="cifras"></p>
787
779
  </div>
788
780
  <div class="mandos">
789
- <span role="group" data-t-aria="vista"><button type="button" data-ir="2d" aria-pressed="true">2D</button> <button type="button" data-ir="3d" aria-pressed="false">3D</button></span>
781
+ <span role="group" data-t-aria="vista"><button type="button" data-ir="2d" aria-pressed="false">2D</button> <button type="button" data-ir="3d" aria-pressed="true">3D</button></span>
790
782
  ${cliente ? '' : `<button type="button" id="cliente" aria-pressed="false" data-t="vistaCliente" data-t-title="vistaClienteT">${es.vistaCliente}</button>`}
791
783
  ${datos.actividad && datos.actividad.pensamientos && datos.actividad.pensamientos.length ? `<button type="button" id="piensa" aria-pressed="false" data-t="piensa" data-t-title="piensaT">${es.piensa}</button>` : ''}
792
- <button type="button" id="tema">${es.claro}</button>
793
784
  <label><span class="sr" data-t="idioma">${es.idioma}</span><select id="idioma"></select></label>
794
785
  </div>
795
786
  </div>
796
- <div class="escenario" data-vista="2d">
787
+ <div class="escenario" data-vista="3d">
797
788
  <div class="v2d">
798
789
  <div class="dibujo">${cerebro()}</div>
799
790
  <p class="pista" data-t="pista">${es.pista}</p>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "corvusmem",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "Deterministic, offline, zero-dependency memory for AI coding agents (Claude Code, Codex) and a standalone CLI.",
5
5
  "type": "module",
6
6
  "bin": {