meetsoma 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,24 +1,93 @@
-# Soma — Changelog
+# Changelog
 
-## [0.1.0] - 2026-03-08
+All notable changes to Soma (`meetsoma` on npm).
 
-### Born
+Format follows [Keep a Changelog](https://keepachangelog.com/). Versioning follows [Semantic Versioning](https://semver.org/).
 
-- σῶμα — the body. The vessel that grows around you.
-- Built on Pi 0.56.2 with `piConfig.configDir: ".soma"`
-- Identity system: `.soma/identity.md` — discovered, not configured
-- Memory structure: `.soma/memory/` — muscles, sessions, preloads
-- Breath cycle: sessions exhale what was learned, next session inhales it
+## [0.6.2] — 2026-03-21
 
-### First Session
+### New
 
-- Designed logo with Curtis — planet + moon mascot through 36 SVG iterations
-- Built collaborative voting UI (preview.html, click-to-vote, WINNER overlay)
-- Created `svg-logo-design` muscle from iterative learning
-- Installed `logo-designer` skill from neonwatty/logo-designer-skill
+- **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.
 
-### Known Issues
+### Fixed
 
-- No extensions installed — auto-flush and preload loading don't work yet
-- Skills install to `~/.agents/skills/` instead of `~/.soma/agent/skills/`
-- Startup shows Pi's changelog instead of this one (fixed in settings)
+- **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%.
+
+## [0.1.0] — 2026-03-08
+
+- Initial release on npm.

package/LICENSE

@@ -1,21 +1,66 @@
-MIT License
-
-Copyright (c) 2026 Gravicity
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Curtis Mercier
+Licensed Work:        Soma Agent. The Licensed Work is (c) 2026
+                      Curtis Mercier
+Additional Use Grant: You may make use of the Licensed Work, provided that
+                      you do not use the Licensed Work for a Competing Use.
+                      A "Competing Use" means making available any product
+                      or service that competes with or substantially
+                      replicates the functionality of the Licensed Work,
+                      including hosting it as a service, reselling modified
+                      versions, or incorporating substantial portions into
+                      a competing product.
+Change Date:          2027-09-18
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact c.mercier@gravicity.ca.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/README.md

@@ -1,100 +1,84 @@
-# meetsoma
+<div align="center">
 
-> σῶμα — the body. The vessel that grows around you.
+<br>
 
-An AI coding agent with self-growing memory. Identity, protocols, and muscles that evolve with use.
+### σ Soma
 
-Built on [Pi](https://github.com/badlogic/pi-mono). Made by [Gravicity](https://gravicity.ai).
+*Memory isn't retrieval. Memory is change.*
 
-## Install
+<br>
 
 ```bash
 npm install -g meetsoma
+soma
 ```
 
-## Quick Start
+<br>
 
-```bash
-cd your-project
-soma
-```
+[Docs](https://soma.gravicity.ai/docs) · [Blog](https://soma.gravicity.ai/blog) · [Hub](https://soma.gravicity.ai/hub) · [Source](https://soma.gravicity.ai/beta)
 
-On first run, Soma creates `.soma/` and writes her own identity based on your workspace. Next session, she picks up where she left off.
+</div>
 
-### Session Modes
+---
 
-```bash
-soma                # Fresh session — identity + protocols, clean slate
-soma --continue     # Resume — picks up where you left off
-soma --resume       # Select a previous session to resume
-```
+An AI coding agent that grows with you. Identity, protocols, and muscle memory — all evolving through use, not configuration.
+
+Most agents forget everything between sessions. Soma doesn't.
 
-## What Grows Over Time
+## What Happens
 
-**Session 1:** Empty. Soma discovers her identity. Protocols load by default heat.
+On first run, you'll meet the personality engine — no AI, just sentence templates. It introduces Soma and lets you ask questions before committing. Press Enter to install.
 
-**Session 5:** Preloads carry context between sessions. Muscles start forming from repeated patterns.
+```
+  σ
 
-**Session 20:** Hot protocols stay loaded, cold ones fade. Muscles auto-surface when relevant. Your `.soma/` is shaped by your work.
+  Soma — the AI agent that remembers
 
-## The Breath Cycle
+  ❝ No compaction. Ever.
 
-Sessions are breaths. **Exhale** writes what Soma learned. **Inhale** picks it up.
+  ──────────────────────────────────────────────────────────
 
-```
-Session 1 (inhale) → work → exhale (preload written)
-                                    ↓
-Session 2 (inhale) ← picks up preload → work → exhale
-                                                      ↓
-Session 3 (inhale) ← ...and so on
+  → Enter  Install Soma
+  → ?      Ask me something first
 ```
 
-At 85% context, Soma auto-exhales and continues seamlessly. No context is lost.
+After install, run `soma` in any project. It creates `.soma/`, reads your codebase, and writes its own identity. By session two, it remembers.
 
 ## Commands
 
-| Command | What it does |
-|---------|-------------|
-| `/exhale` | Save state, write preload for next session |
-| `/inhale` | Start fresh — reload identity + protocols |
-| `/pin <name>` | Pin a protocol/muscle to hot (stays loaded) |
-| `/kill <name>` | Kill a protocol/muscle (drops to cold) |
-| `/soma status` | Show memory status |
-| `/soma init` | Create `.soma/` in current directory |
+```bash
+soma                     # start a session
+soma focus <keyword>     # load relevant muscles + MAPs
+soma inhale              # resume from last session
+soma --map <name>        # load a workflow
+
+soma init                # install the runtime
+soma doctor              # check health
+soma update              # check for updates
+```
 
-## Memory Structure
+## The Five Ideas
 
-```
-.soma/
-├── identity.md          ← who Soma becomes (discovered, not configured)
-├── STATE.md             ← project architecture truth
-├── protocols/           ← behavioral rules (heat-tracked)
-├── memory/
-│   ├── muscles/         ← patterns learned from experience
-│   ├── preload-next.md  ← continuation for next session
-│   └── sessions/        ← daily logs
-└── scripts/             ← dev tooling
-```
+**Identity** — a self-written file. It knows your project, your patterns, your stack.
 
-## Philosophy
+**Protocols** — behavioral rules. "Read before write." Hot ones load. Cold ones fade.
 
-- **Identity is discovered, not configured.** Soma writes who she is after she's worked, not before.
-- **Structure is earned, not imposed.** Starts minimal. Grows where needed.
-- **Memory is cultivated, not stored.** Patterns emerge from use.
-- **Sessions are breaths.** Each exhale writes what was learned. Each inhale picks it up.
+**Muscles** — learned patterns. Correct it twice → permanent learning.
 
-## Provider Setup
+**Breath** — inhale, work, exhale. No compaction. Full context every session.
 
-```bash
-export ANTHROPIC_API_KEY=sk-...    # Anthropic (Claude)
-export GOOGLE_API_KEY=...          # Google (Gemini)
-export OPENAI_API_KEY=sk-...       # OpenAI
-```
+**Heat** — attention management. Used things stay. Unused things cool.
+
+## Requirements
+
+- Node.js ≥ 20.6
+- git
+- API key (Anthropic, Google, or OpenAI)
 
-## Documentation
+---
 
-Full docs at [soma.gravicity.ai](https://soma.gravicity.ai) and [GitHub](https://github.com/meetsoma/agent).
+<div align="center">
 
-## License
+<sub>BSL 1.1 © Curtis Mercier — open source 2027</sub>
 
-[MIT](LICENSE) — [Gravicity](https://gravicity.ai)
+</div>