meetsoma 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,24 +1,73 @@
-# 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.1] — 2026-03-20
 
-### 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
+- **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.
 
-### 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)
+- 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,100 @@
-# meetsoma
+# σ Soma
 
-> σῶμα — the body. The vessel that grows around you.
+> Memory isn't retrieval. Memory is change.
 
-An AI coding agent with self-growing memory. Identity, protocols, and muscles that evolve with use.
+An AI coding agent that grows with you. Identity, protocols, and muscle memory that evolve through use — not configuration.
 
-Built on [Pi](https://github.com/badlogic/pi-mono). Made by [Gravicity](https://gravicity.ai).
+Most agents forget everything between sessions. Soma doesn't. Each session leaves the agent slightly different than the one before.
 
 ## Install
 
 ```bash
 npm install -g meetsoma
-```
-
-## Quick Start
-
-```bash
-cd your-project
 soma
 ```
 
-On first run, Soma creates `.soma/` and writes her own identity based on your workspace. Next session, she picks up where she left off.
+That's it. On first run, Soma downloads the runtime, sets up `~/.soma/`, and you're ready. Run `soma` in any project directory to start a session.
 
-### 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
-```
+## What Happens
 
-## What Grows Over Time
+Run `soma` and you'll see a rotating concept about how the system works — and you can ask questions right from the CLI. Press `?` to explore:
 
-**Session 1:** Empty. Soma discovers her identity. Protocols load by default heat.
+```
+  σ
 
-**Session 5:** Preloads carry context between sessions. Muscles start forming from repeated patterns.
+  Soma — the AI agent that remembers
 
-**Session 20:** Hot protocols stay loaded, cold ones fade. Muscles auto-surface when relevant. Your `.soma/` is shaped by your work.
+  ❝ No compaction. Ever.
 
-## The Breath Cycle
+  Other agents hit context limits and compact — squeezing your
+  entire session into a degraded summary. You wait while it
+  processes. Soma skips compaction entirely. When context gets
+  tight, the agent writes a briefing for its next self. Then
+  it starts fresh. Full context window. Zero wait. Nothing lost.
 
-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.
+Every answer is generated fresh — different wording each time you run it.
 
 ## Commands
 
+### Getting Started
+
 | 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 |
+| `soma` | See what Soma is about, or start a session |
+| `soma init` | Install the runtime |
+| `soma about` | How Soma works — identity, protocols, muscles, breath, scripts |
+| `soma doctor` | Verify installation health |
+| `soma update` | Check for new versions |
+| `soma status` | Show installation state |
 
-## Memory Structure
+### After Install
 
-```
-.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
-```
+| Command | What it does |
+|---------|-------------|
+| `soma` | Start a session |
+| `soma focus <keyword>` | Start a focused session |
+| `soma inhale` | Resume from last session's preload |
+| `soma --map <name>` | Load a specific workflow |
 
-## Philosophy
+## How It Works
 
-- **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.
+**Identity** — The agent maintains a self-written identity file. It knows your project, your patterns, your preferences. This isn't configuration. It's self-knowledge.
 
-## Provider Setup
+**Protocols** — Behavioural rules that shape how the agent works. "Read before write." "Test before commit." They have heat — used ones stay hot, unused ones fade.
 
-```bash
-export ANTHROPIC_API_KEY=sk-...    # Anthropic (Claude)
-export GOOGLE_API_KEY=...          # Google (Gemini)
-export OPENAI_API_KEY=sk-...       # OpenAI
-```
+**Muscles** — Learned patterns. "Use esbuild for bundling." "This API uses OAuth." Muscles grow from corrections and repetition. Correct the agent twice and it crystallises a muscle — permanent learning.
+
+**Breath Cycle** — Every session follows three phases. Inhale (load state) → Hold (work) → Exhale (save state). At context limits, the agent writes a preload for its next self — a briefing, not a summary. No compaction. No quality loss. Full context window every session.
+
+**Scripts** — The agent builds tools for itself. What it does twice manually, it automates. Scripts survive across sessions, context resets, and model swaps.
+
+**Heat** — Every protocol and muscle has a heat score. Use it? Heat rises. Ignore it for three sessions? It cools. The agent's prompt compiles itself based on what's actually relevant — not what someone configured months ago.
+
+## Source Available
+
+Soma is source-available under BSL 1.1. View the code, use it personally, contribute.
+
+- **Get access:** [soma.gravicity.ai/beta](https://soma.gravicity.ai/beta) — register for source access + contributor tier
+- **Docs:** [soma.gravicity.ai/docs](https://soma.gravicity.ai/docs)
+
+Converts to MIT on 2027-09-18.
+
+## Requirements
+
+- Node.js ≥ 20.6.0
+- git
+- An API key for your preferred provider (Anthropic, Google, OpenAI)
 
 ## Documentation
 
-Full docs at [soma.gravicity.ai](https://soma.gravicity.ai) and [GitHub](https://github.com/meetsoma/agent).
+[soma.gravicity.ai](https://soma.gravicity.ai)
 
 ## License
 
-[MIT](LICENSE) — [Gravicity](https://gravicity.ai)
+[BSL 1.1](LICENSE) — © 2026 Curtis Mercier.