meetsoma 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -1,215 +1,47 @@
 # Changelog
 
-All notable changes to Soma (`meetsoma` on npm).
+Notable changes to [meetsoma](https://www.npmjs.com/package/meetsoma) — the CLI for [Soma](https://soma.gravicity.ai).
 
-Format follows [Keep a Changelog](https://keepachangelog.com/). Versioning follows [Semantic Versioning](https://semver.org/).
+## [0.3.4] — 2026-04-17
 
-## [0.3.2] — 2026-04-10
+- **Fixed: fresh `npm install -g meetsoma` now actually works.** Previous 0.3.3 shipped a broken tarball (imports from `./lib/` and `./welcome/` that weren't included). Now bundled as a single self-contained file via esbuild.
+- **Added: pre-publish smoke test.** Tarball is extracted and run before allowing publish. Broken tarballs cannot ship.
+- **Changed: `soma init`** no longer updates the runtime — it's for project init only.
+- **Changed: `soma update`** actually performs the runtime update now (was status-only).
+- **Added: `soma check-updates`** preserves the old status-only behavior.
+- **Added: Pi runtime drift check** in `soma status` / `soma doctor`.
+- **Added: periodic update notice** — statusline checks for updates every 30min; next `soma` launch prints one-line notice.
 
-### Fixed
-- **Health check warnings**: now shows "passed (N warnings)" instead of silent "All checks passed" when warnings exist
+## [0.3.3] — 2026-04-12
 
-## [0.3.1] — 2026-04-10
-
-Re-release of 0.3.0 (npm doesn't allow republish of unpublished versions).
+- Script discovery: `soma <name>` finds and runs scripts from your project
+- Improved health checks and doctor warnings
+- Extracted modules for faster startup
 
 ## [0.3.0] — 2026-04-10
 
-Corresponds to Soma agent v0.9.0+.
-
-### Added
-- **Script discovery**: `soma <name>` routes to `soma-<name>.sh` scripts via chain (bundled → project → global)
-- `soma code`, `soma verify`, `soma refactor` work from any project with scripts installed
-- `soma --help scripts` lists all discovered scripts with descriptions
-
-### Changed
-- Extracted `lib/` and `welcome/` modules from thin-cli.js (1650→902 lines)
-- Removed stale agent copies — CLI is a pure thin wrapper now
-
-### Fixed
-- **CORE_DIR respects `SOMA_CODING_AGENT_DIR`** — thin-cli.js and cli.js no longer hardcode `~/.soma/agent`. Sandbox testing and env overrides now work correctly.
+- `soma code`, `soma verify`, `soma refactor` work from any terminal
+- `soma --help scripts` lists all discovered scripts
+- Cleaner thin-cli architecture
 
 ## [0.2.0] — 2026-04-02
 
-Corresponds to Soma agent v0.8.0.
-
-### New
-
-- **`soma doctor`** — check project health, auto-fix stale settings/body/protocols, run migrations.
-- **`soma status` / `soma health`** — quick project health check (renamed from old `soma doctor`).
-- **`soma --version`** — shows both agent and CLI versions.
-- **`soma --help`** — delegates to core agent for full help output.
-- **`--scan` / `--all` flags** — doctor multi-project support (delegates to core).
-
-### Changed
-
-- **CLI routing overhaul** — doctor/status/health/update/version all route through thin-cli properly.
-- **Stale protocol detection** — doctor identifies outdated bundled protocols and offers to update them.
-- **Version-aware pending file** — `_doctor-pending.md` injected on boot when migration is available.
-
-### Fixed
-
-- **Help header** — shows "CLI v0.2.0" instead of bare version number.
-- **Orphaned `showStatus()`** — removed dead code from thin-cli.
-- **Placeholder text** — replaced thin-cli stubs with real output.
-
----
+- `soma doctor` — check project health, auto-fix settings and templates
+- `soma status` — quick health overview
+- `soma --version` — shows agent + CLI versions
 
 ## [0.1.4] — 2026-03-28
 
-Corresponds to Soma agent v0.6.5.
-
-### New
-
-- **`soma inhale --list`** — see available preloads with age and staleness markers.
-- **`soma inhale <name>`** — load a specific preload by date, session ID, or substring.
-- **`soma inhale --load <path>`** — load any file as a preload.
-- **`soma map <name>`** — run a MAP with prompt-config and targeted preload.
-- **`soma map --list`** — see available MAPs with status and description.
-- **`--preload` flag deprecated** — use `soma inhale` or `soma map` instead (still works).
-
-### Changed
-
-- **Settings-driven heat overrides** — per-project AMPS heat control via `settings.heat.overrides`.
-- **Statusline** shows preload status. Smart `/exhale` detects edit vs write mode.
-- **Restart signal** — auto-detects when extensions change, prompts for restart.
-
-### Fixed
-
-- **Crash on partial settings** — `settings.heat` access now defensive (won't crash with old config files).
-- **Breathe grace period** — was 60s, now correctly 30s matching settings default.
-- **5 auto-breathe UX gaps** — smarter context warnings, resume awareness.
-
----
-
-## [0.1.3] — 2026-03-23
-
-### New
-
-- **Body architecture** — structured identity in `.soma/body/`. Create `soul.md` (who the agent is), `voice.md` (how it communicates), `body.md` (project context). Each file becomes a `{{variable}}` usable in templates.
-- **Template engine** — `_mind.md` controls your system prompt structure. Add `{{soul}}`, `{{voice}}`, custom text. 5 modifiers: `|tldr`, `|section:Name`, `|lines:N`, `|last:N`, `|ref`.
-- **Smart AMPS loading** — warm protocols and muscles now appear as `<available_skills>` entries (Claude's native format). Agent reads them on demand instead of loading everything into the prompt.
-- **`/body` command** — inspect your template system. `check` (health report), `vars` (all variables), `map` (structure), `render` (full compiled prompt).
-- **`/exit`** command — save state and quit cleanly.
-- **`SOMA.md`** — new canonical identity file name. Replaces `identity.md` (still works as fallback).
-
-### Changed
-
-- **Boot messages** rewritten — "You woke up" instead of "You've booted into a session."
-- **Auto-breathe** — agent no longer guesses context percentages. Trusts the system to prompt when it's time.
-- **Muscle heat** — muscles gain heat when loaded at boot, not just when explicitly read.
-
-### Fixed
-
-- **Stale conversation injection** — removed scanner that picked up old sessions from wrong runtime.
-- **Identity frontmatter** — no longer leaks YAML into the system prompt.
-
----
+- `soma inhale` — load session preloads by name, date, or path
+- `soma map` — run workflow templates
+- Per-project settings for AMPS heat
 
 ## [0.1.2] — 2026-03-22
 
-### New
-
-- **`/hub` command** — install, fork, share, find, and browse community content from one command. Replaces `/install` and `/list`.
-- **Drop-in commands** — add scripts to `.soma/amps/scripts/commands/` and they become `/soma <name>` commands instantly.
-- **Community hub: 40 items** — protocols, muscles, scripts, automations, and templates. Browse at soma.gravicity.ai/hub.
-- **Smart sharing** — `/hub share` runs quality checks, auto-fixes private paths, opens a PR to the community.
-- **Multiple git emails** — `guard.gitIdentity.email` now accepts an array for multi-account users.
-- **Preload improvements** — Weather (session tone) and Warnings (traps for next session) in default template.
-
-### Changed
-
-- `/install` and `/list` now redirect to `/hub install` and `/hub list`.
-- Protocols that document built-in behavior no longer load into the prompt (saves ~2000 tokens).
-
-### Fixed
-
-- `/hub list --remote` now works (flag was parsed as type filter).
-
-## [0.6.2] — 2026-03-21
-
-### New
-
-- **Muscle heat from natural use.** Running scripts or editing files now bumps related muscles automatically — no `/pin` needed.
-- **`soma doctor`** — checks workspace health, auto-fixes stale frontmatter, detects version drift.
-- **Community sync on boot.** Missing protocols fetched from community repo automatically. Always current, works offline.
-
-### Fixed
-
-- **No more "Update Available" banner.** Runtime delegation fixed.
-- **Fresh installs** now include version tracking in settings.json.
-- Welcome flow is honest about being a personality engine, not the agent.
-
-### Changed
-
-- Muscle activation fields simplified — triggers, keywords, topic merged into single list. Old format still works.
-
----
-
-## [0.6.1] — 2026-03-20
-
-### New
-
-- **Published to npm.** `npm install -g meetsoma` — lightweight launcher, runtime downloads on first run.
-- **Engine updated to Pi 0.61.1** — keybinding stability, session path fixes, suspend/resume.
-- AMPS overview doc, migration guide (from CLAUDE.md/.cursorrules), troubleshooting page.
-- Docs reorganised into 5 sections. Collapsible sidebar with section icons.
-- Known Gaps sections — honest about heat system limitations and planned fixes.
-
-### Fixed
-
-- CLI crash on Pi 0.61.0 (`getEditorKeybindings` renamed upstream).
-- `content-cli.js` import removed (moved to main.js in 0.61.0).
-- `--help` fixed (`printGumHelp` removed upstream).
-- Heat system docs corrected — `.protocol-state.json` → `state.json`.
-
-## [0.6.0] — 2026-03-20
-
-### New
-
-- **Soma has a voice.** Run `soma` and it talks to you. Every message is different — same meaning, different words each time. No AI involved. Just clever writing.
-- **Ask questions from the CLI.** Press `?` when you run `soma` and ask about memory, heat, protocols, muscles, or anything else. Soma answers — differently every time.
-- **No compaction. Ever.** Other agents compress your conversation when context fills up. You wait. Quality degrades. Soma doesn't compact — it breathes. Full context, every session.
-- **`soma init`** — Install the Soma runtime. Downloads automatically, no auth needed.
-- **`soma doctor`** — Health check. Tells you what's working and what needs attention.
-- **`soma update`** — Check for new versions.
-- **`soma status`** — See your installation state at a glance.
-- **`soma about`** — Learn how Soma works. Identity, protocols, muscles, breath cycle, scripts.
-- **`soma focus <keyword>`** — Start a focused session primed for a specific topic.
-- **`soma --map <name>`** — Load a workflow template.
-- **Typing animation** — Responses type out character by character. Soma feels present.
-- **Daily concepts** — The welcome screen shows a different idea each day.
-- **23 documentation pages** — Models & providers, keybindings, themes, settings, sessions, prompts, skills, terminal setup, and more.
-- **30 automated E2E tests** — Branding, paths, infrastructure, models, identity all verified in sandbox.
-
-### Changed
-
-- Engine updated to Pi 0.61.0.
-- License changed to BSL 1.1 (converts to MIT on 2027-09-18).
-- The npm package is a lightweight launcher. The runtime installs separately via `soma init`.
-- Project paths resolve to `.soma/` (not `.pi/`) — correct config dir delegation.
-
-### Fixed
-
-- Auto-breathe timeout and session log naming bugs resolved.
-- Session ID stability on resume — no more orphan logs.
-- Edit tool detection in preload generation.
-
-## [0.5.1] — 2026-03-12
-
-- Content management commands.
-- 15 in-session slash commands.
-
-## [0.3.0] — 2026-03-10
-
-- Auto-init on first run.
-- Session continuation with `/inhale` and `/breathe`.
-
-## [0.2.1] — 2026-03-09
-
-- Core agent modules and built-in protocols.
-- Context warnings and auto-exhale at 85%.
+- `/hub` command — install, share, and browse community content
+- Drop-in commands via `.soma/amps/scripts/commands/`
+- Community hub with 40+ items
 
 ## [0.1.0] — 2026-03-08
 
-- Initial release on npm.
+- Initial release. `npm install -g meetsoma` — thin launcher that bootstraps the Soma runtime.