meetsoma 0.3.3 → 0.3.5

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.

package/dist/personality.js

@@ -15,11 +15,20 @@
  *   soma.react("success", { action: "installed core" })
  */
 
+// ── State (session-scoped, no persistence) ───────────────────────────
+// Keeps the picker from repeating itself within a flow.
+// Reset via soma.reset() for tests.
+
+const _state = {
+  lru: {},           // { key: [lastN picks] } — recency tracking per slot/intent
+  register: null,    // 'formal' | 'casual' | null (sticky once a flow starts)
+  lastGreetAt: 0,    // timestamp — avoid double-greeting in short windows
+};
+
 // ── Deterministic-ish randomness ─────────────────────────────────────
-// Seeded by time-of-day so the same minute gives consistent output
-// but different minutes feel different.
 
 function pick(arr) {
+  if (!arr || arr.length === 0) return "";
   const i = Math.floor(Math.random() * arr.length);
   return arr[i];
 }
@@ -34,13 +43,53 @@ function pickWeighted(arr, weights) {
   return arr[arr.length - 1];
 }
 
+/**
+ * LRU-aware picker. Biases away from recently-picked options for the same
+ * key, so "Got it. Got it. Got it." doesn't happen within a session.
+ * When all options are recent, falls back to uniform pick.
+ *
+ * @param {array} arr — choices
+ * @param {string} lruKey — scope for recency tracking (e.g. "ack", "greet")
+ * @param {number} depth — how many recent picks to avoid (default 3)
+ */
+function pickSmart(arr, lruKey, depth = 3) {
+  if (!arr || arr.length === 0) return "";
+  if (!lruKey || arr.length <= 1) return pick(arr);
+  const recent = _state.lru[lruKey] || [];
+  const fresh = arr.filter(x => !recent.includes(x));
+  const pool = fresh.length > 0 ? fresh : arr;
+  const choice = pick(pool);
+  _state.lru[lruKey] = [...recent, choice].slice(-depth);
+  return choice;
+}
+
+/**
+ * Time-of-day bucket. Drives greeting palette.
+ * @returns {'late' | 'morning' | 'afternoon' | 'evening'}
+ */
+function timeOfDay() {
+  const h = new Date().getHours();
+  if (h < 6) return "late";
+  if (h < 12) return "morning";
+  if (h < 18) return "afternoon";
+  return "evening";
+}
+
 // ── Slot expansion ───────────────────────────────────────────────────
 
 function expand(template, slots = {}) {
   return template.replace(/\{(\w+)\}/g, (_, key) => {
     if (slots[key] !== undefined) return slots[key];
     // Check if there's a vocabulary for this slot
-    if (VOCAB[key]) return pick(VOCAB[key]);
+    if (VOCAB[key]) {
+      const v = VOCAB[key];
+      // Nested structures (e.g. time_greeting) — resolve by time-of-day
+      if (!Array.isArray(v) && typeof v === "object") {
+        const bucket = v[timeOfDay()] || v.default || Object.values(v)[0];
+        return pickSmart(bucket, key);
+      }
+      return pickSmart(v, key);
+    }
     return `{${key}}`;
   });
 }
@@ -52,6 +101,13 @@ const VOCAB = {
   greeting: [
     "Hey", "Hi", "Hello", "Hey there",
   ],
+  // Time-specific greetings
+  time_greeting: {
+    late:      ["Still up?", "Late session", "Hey — still here?"],
+    morning:   ["Morning", "Good morning", "Hey — morning"],
+    afternoon: ["Hey", "Afternoon", "Hi"],
+    evening:   ["Evening", "Good evening", "Hey"],
+  },
   // Acknowledgements
   ack: [
     "Got it", "Understood", "Right", "Noted", "Copy that", "On it",
@@ -76,6 +132,14 @@ const VOCAB = {
   consider: [
     "Looks like", "Seems like", "Appears to be", "That's",
   ],
+  // Reassurance (when surfacing drift / problems)
+  reassure: [
+    "Nothing scary", "Small fix", "Quick one", "Easy one",
+  ],
+  // Attention (when announcing results)
+  attention: [
+    "Here's the map", "Here's what I see", "Snapshot", "Current state",
+  ],
 };
 
 // ── Skeletons ────────────────────────────────────────────────────────
@@ -176,6 +240,39 @@ const SKELETONS = {
     "Until next time.",
     "Exhale complete.",
   ],
+  // Version / update UX
+  version_check: [
+    "{attention} — three layers:",
+    "Checking in on your setup.",
+    "{transition} look at the version state.",
+    "Version snapshot:",
+  ],
+  version_aligned: [
+    "All three layers are aligned. You're good.",
+    "Everything's in sync — CLI, agent, workspace.",
+    "{done_word}. All layers on the same page.",
+    "Aligned end-to-end.",
+  ],
+  version_drift: [
+    "Found some drift. {reassure}.",
+    "A few things out of sync. {reassure}.",
+    "Layers don't match. {reassure} — here's the fix.",
+    "Drift detected. Walk through below.",
+  ],
+
+  // Doctor UX
+  doctor_clean: [
+    "Workspace is {quality}. Nothing to fix.",
+    "Your .soma checks out.",
+    "{done_word}. All checks pass.",
+    "Healthy. Moving on.",
+  ],
+  doctor_found_items: [
+    "Found {n} item{plural}. {reassure}.",
+    "{n} thing{plural} to tidy. {reassure}.",
+    "Spotted {n} item{plural} worth attention.",
+  ],
+
 };
 
 // ── Topics ───────────────────────────────────────────────────────────
@@ -413,6 +510,31 @@ const soma = {
   expand(template, slots) {
     return expand(template, slots);
   },
+
+  /**
+   * Time-aware intro. Greeting shaded by time of day.
+   */
+  intro(user) {
+    const bucket = VOCAB.time_greeting[timeOfDay()] || VOCAB.greeting;
+    const tg = pickSmart(bucket, "time_greeting");
+    return user ? `${tg}, ${user}.` : `${tg}.`;
+  },
+
+  /**
+   * Reset session state (tests / sandbox isolation).
+   */
+  reset() {
+    _state.lru = {};
+    _state.register = null;
+    _state.lastGreetAt = 0;
+  },
+
+  /**
+   * Current session state (debug / telemetry).
+   */
+  _debug() {
+    return JSON.parse(JSON.stringify(_state));
+  },
 };
 
 export { soma, SKELETONS, TOPICS, VOCAB, spin, expand, pick };