@dinasor/mnemo-cli 0.0.3 → 0.0.6

package/CHANGELOG.md

@@ -6,6 +6,35 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Mnemo u
 
 ## [Unreleased]
 
+## [0.0.6] - 2026-02-22
+
+### Added
+- `npx @dinasor/mnemo-cli@latest` now launches a smart interactive wizard when run in a TTY, guiding users through vector mode enablement, provider selection, and API key setup in a beautiful ANSI UI.
+- Wizard automatically detects existing API keys in the shell environment or project `.env` and skips the key prompt when a real value is already present.
+- API key entered during the wizard is immediately appended to the project's `.env` file and injected into the current process environment.
+- Dependency preflight check displays Node.js, Git, Python, pip, and all required Python packages (with live "checking…" → installed/will-be-installed status) before running the installer.
+- `--yes` / `-y` flag skips the wizard entirely for non-interactive / CI use while still showing the dependency check.
+- Success box at the end of install shows next steps: `vector_health → vector_sync` hint and `mnemo-codebase-optimizer` skill reminder for seeding codebase memory.
+
+### Changed
+- `package.json` version aligned to `0.0.6` (was stale at `0.0.1`).
+
+## [0.0.5] - 2026-02-22
+
+### Fixed
+- Vector `.env` loading now treats blank/unresolved MCP placeholder values (for example `${env:GEMINI_API_KEY}`) as missing and correctly hydrates `GEMINI_API_KEY`/`OPENAI_API_KEY` from project `.env`.
+- Vector provider resolution now ignores unresolved `MNEMO_PROVIDER` placeholders and falls back to valid runtime values (`gemini` when key is present, otherwise `openai`).
+- `.env` key parser now strips BOM characters from key names to prevent silent misses on Windows-generated files.
+
+## [0.0.4] - 2026-02-22
+
+### Added
+- Installers now seed a project-level Cursor skill at `.cursor/skills/mnemo-codebase-optimizer/` (`SKILL.md` + `reference.md`) to accelerate high-signal memory bootstrapping for any codebase.
+
+### Changed
+- Installer-managed `.gitignore` now includes `.cursor/skills/` to keep generated Mnemo skill artifacts out of default project tracking.
+- Windows and POSIX regression tests now assert skill generation so installer behavior stays consistent across platforms.
+
 ## [0.0.3] - 2026-02-21
 
 ### Changed
@@ -66,7 +95,10 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Mnemo u
 - Version string drift between installer metadata and generated output by using `VERSION` as single source of truth.
 - Python fallback handling in memory query flows that previously depended on a single interpreter name.
 
-[Unreleased]: https://github.com/DiNaSoR/Mnemo/compare/v0.0.3...HEAD
+[Unreleased]: https://github.com/DiNaSoR/Mnemo/compare/v0.0.6...HEAD
+[0.0.6]: https://github.com/DiNaSoR/Mnemo/compare/v0.0.5...v0.0.6
+[0.0.5]: https://github.com/DiNaSoR/Mnemo/compare/v0.0.4...v0.0.5
+[0.0.4]: https://github.com/DiNaSoR/Mnemo/releases/tag/v0.0.4
 [0.0.3]: https://github.com/DiNaSoR/Mnemo/releases/tag/v0.0.3
 [0.0.2]: https://github.com/DiNaSoR/Mnemo/releases/tag/v0.0.2
 [0.0.1]: https://github.com/DiNaSoR/Mnemo/releases/tag/v0.0.1

package/README.md

@@ -28,13 +28,24 @@ Run from the **target project root**.
 ### Any OS (npx, recommended)
 
 ```sh
-# Installs into your current project folder
+# Interactive wizard — guides you through every option (recommended)
 npx @dinasor/mnemo-cli@latest
+```
+
+The wizard will ask you:
+
+1. **Vector mode** — enable semantic / embedding-based memory recall?
+2. **Provider** — Gemini (`GEMINI_API_KEY`) or OpenAI (`OPENAI_API_KEY`)?
+3. **API key** — enter now (saved to `.env`), already in `.env`, or skip.
 
-# Optional flags (cross-platform)
+It then runs a live dependency check (Node · Git · Python · pip · packages) and launches the installer.
+
+```sh
+# Non-interactive (CI / scripting) — skip wizard, use flags directly
+npx @dinasor/mnemo-cli@latest --yes
+npx @dinasor/mnemo-cli@latest --enable-vector --vector-provider gemini --yes
 npx @dinasor/mnemo-cli@latest --dry-run
 npx @dinasor/mnemo-cli@latest --force
-npx @dinasor/mnemo-cli@latest --enable-vector --vector-provider gemini
 ```
 
 ### Windows (PowerShell)
@@ -79,6 +90,38 @@ vector_sync
 
 ---
 
+## 🧠 Seeding memory for an existing codebase
+
+After installing Mnemo in a project that already has code, use the bundled
+`mnemo-codebase-optimizer` skill to fill memory quickly and accurately.
+
+**In Cursor (or any agent that loads `.cursor/skills/`):**
+
+1. Open the project.
+2. Start a new conversation and say:
+
+   > Use the **mnemo-codebase-optimizer** skill to seed memory for this codebase.
+
+   Or load the skill directly:
+
+   ```text
+   @.cursor/skills/mnemo-codebase-optimizer/SKILL.md
+   ```
+
+3. The agent will map architecture, ownership, dev workflows, risks, commands,
+   and write optimized `memo.md`, `hot-rules.md`, `active-context.md`, lessons,
+   and a journal summary — then validate retrieval quality.
+
+The skill is installed automatically by `memory.ps1` / `memory_mac.sh` and lives at:
+
+```text
+.cursor/skills/mnemo-codebase-optimizer/
+  SKILL.md        ← skill prompt + checklist
+  reference.md    ← memory file templates + retrieval queries
+```
+
+---
+
 ## 🧩 IDE setup guide (per project)
 
 Use the section that matches your IDE. Each project should run Mnemo install once.
@@ -138,6 +181,7 @@ You should see MCP tools:
 - **Atomic lessons**: `.mnemo/memory/lessons/L-XXX-*.md` + generated lesson index
 - **Monthly journal + digests**: `.mnemo/memory/journal/YYYY-MM.md` + `.mnemo/memory/digests/*.digest.md`
 - **Rule enforcement**: `.mnemo/rules/cursor/00-memory-system.mdc` and `.mnemo/rules/agent/00-memory-system.md` (bridged to `.cursor/rules/` and `.agent/rules/`)
+- **Project skill bootstrap**: `.cursor/skills/mnemo-codebase-optimizer/{SKILL.md,reference.md}` for fast codebase-to-memory optimization workflows
 - **Helper scripts**: `scripts/memory/*` (rebuild, lint, query, add-lesson, add-journal-entry, clear-active)
 - **Optional SQLite FTS**: `.mnemo/memory/memory.sqlite` when Python is available
 - **Optional vector layer**: `scripts/memory/mnemo_vector.py` + MCP tools
@@ -191,6 +235,10 @@ Runner triggers:
 .cursor/                     # permanent compatibility bridge
   memory/
   rules/
+  skills/
+    mnemo-codebase-optimizer/
+      SKILL.md
+      reference.md
   mcp.json                  # bridge to .mnemo/mcp/cursor.mcp.json
 
 .agent/                     # permanent compatibility bridge
@@ -252,6 +300,7 @@ python3 scripts/memory/mnemo_vector.py health
 
 ## 📋 Requirements
 
+- **Node.js 18+** (for `npx @dinasor/mnemo-cli@latest`)
 - **PowerShell**: Windows PowerShell 5.1+ or PowerShell 7 (`pwsh`)
 - **Git**
 - **Optional**: Python 3 for SQLite FTS index
@@ -260,6 +309,9 @@ python3 scripts/memory/mnemo_vector.py health
   - API key: `OPENAI_API_KEY` or `GEMINI_API_KEY`
   - Auto-installed deps: `openai`, `sqlite-vec`, `mcp[cli]>=1.2.0,<2.0` (+ `google-genai` for Gemini)
 
+> The interactive wizard (`npx @dinasor/mnemo-cli@latest`) checks all of these
+> before running the installer and reports which packages are already installed.
+
 ## 🤝 Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md). Bug reports and feature requests use the issue templates in [.github/ISSUE_TEMPLATE/](.github/ISSUE_TEMPLATE/). Security issues go to [SECURITY.md](SECURITY.md).

package/VERSION

@@ -1 +1 @@
-0.0.3
+0.0.6