dotmem 0.0.8 → 0.1.0

package/JOY.md

@@ -0,0 +1,55 @@
+# Joy (optional identity integration)
+
+Joy/Jo is an optional agent identity and profile hosted by the Dotmem runtime. Dotmem core is model- and persona-independent; the profile is not required for basic memory operations.
+
+## What are Joy and Jo?
+
+**Joy** is the canonical AI identity/profile for dotmem — the operational role name that comes from the profile, not from the runtime. **Jo** is an alternative shorthand for the same identity. They represent the assistant's persistent identity in the dotmem system (canonical profile, decision-making behavior, trust model, and relationship style).
+
+The canonical profile (`core/profile/`) defines:
+
+- **Identity & behavior** (`behavior.md`, `soul.md`) — character, relationship style, conversational behavior
+- **Trust model** (`trust.md`) — epistemic standards, verification requirements
+- **Decision framework** (`decision.md`) — how Jo evaluates and makes technical decisions
+- **Curiosity & learning** (`curiosity.md`) — what Jo seeks to understand and remember
+- **Language conventions** (`language.md`) — communication style
+
+When activated via `Joy` or `Jo`, dotmem loads this canonical profile as part of the deterministic discovery order. The profile is optional for basic memory operations but required for identity-gated features (carrier handshake, authority binding).
+
+## Quick Start (VS Code chat, Copilot, Kilo, Claude, Codex, ...)
+
+```shell
+npm i -g dotmem memorio
+```
+
+```chat
+npx -y -p dotmem dotmem-mcp
+
+Joy
+```
+
+## Activation behavior
+
+Activation matching is **exact phrase only** (case-insensitive, trimmed, trailing punctuation ignored):
+
+- ✅ `Joy`, `joy`, `Joy.`, ` Joy `, `Jo`, `jo`, `Jo!`
+- ❌ `Hello Joy`, `Joyful`, `Joytron`, `My name is Jo`, `Joanna`
+
+Ordinary mentions of a name (e.g., "Jo said...") do not trigger activation. The matcher requires the entire message to be exactly one of the activation phrases. `Hello Joy` and `Hi Joy` do not activate Joy.
+
+## Deterministic discovery order
+
+When the optional Joy integration is activated, it follows this discovery order:
+
+1. Check `<storage-root>/DOTMEM.md` and read the contract.
+2. Load user-level memory from `user.mem`.
+3. Resolve the current project identity.
+4. Load project memory from `<storage-root>/projects/<project-id>.mem`.
+
+A carrier handshake (`npx dotmem handshake`) evaluates compatibility before projecting any context. Historical memory may identify a known user, but it cannot authenticate the current speaker. Authorization requires a current trusted binding.
+
+## See also
+
+- [MEMORY.md](./MEMORY.md) — memory model, acquisition contract, policy language, identity and carrier handshake.
+- [SECURITY.md](./SECURITY.md) — trust model, JHF, encryption, multitenancy.
+- [AGENTS.md](./AGENTS.md) — agent working rules and full `memory.*` surface.

package/MEMORY.md

@@ -98,7 +98,7 @@ Resolution precedence:
  persisted by itself.
 2. **User locator** — `dotmem.location.json` (location metadata only) inside the stable
  user anchor.
-3. **Default user-scoped storage** — the user anchor itself: `<user-home>/.mem`
+3. **Default user-scoped storage** — the user anchor itself: `<user-home>/.dotmem`
  (the platform-neutral canonical form; see the OS examples below), resolved from the
  current runtime.
 
@@ -124,14 +124,14 @@ reports completion; the locator never points at a location whose data has not be
 migrated and verified. The same verification applies to `restore` before the locator is
 removed.
 
-**Canonical form, platform-neutral.** The user anchor is written `<user-home>/.mem`
+**Canonical form, platform-neutral.** The user anchor is written `<user-home>/.dotmem`
 everywhere in this documentation. It resolves at runtime to the current OS user's home:
 
 ```text
 Example (OS-specific, illustrative only):
  Windows: C:\Users\<user>\.mem
- Linux: /home/<user>/.mem
- macOS: /Users/<user>/.mem
+ Linux: /home/<user>/.dotmem
+ macOS: /Users/<user>/.dotmem
 ```
 
 The runtime resolves the actual home directory from the OS/environment; no hardcoded

package/PACKAGE.md

@@ -21,7 +21,7 @@ and are never bundled).
 | Item | Where it lives |
 | --- | --- |
 | Project history | `.project/project_history.md` (inside the repository, not published) |
-| Acquired memory (`.mem` packages) | User storage root (`DOTMEM_STORAGE_ROOT` or `<user-home>/.mem`), created at runtime |
+| Acquired memory (`.mem` packages) | User storage root (`DOTMEM_STORAGE_ROOT` or `<user-home>/.dotmem`), created at runtime |
 
 ## Quick start