.laplaspack

<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="assets/mark-dark.svg">
  <img src="assets/mark-light.svg" width="92" alt="the LAPLAS mark — concentric diamonds">
</picture>

# `.laplaspack`

**The open format for editable, portable AI memory.**<br>
One file that holds a mind — typed entities, causal links, human thoughts, and the provenance of how they got there.<br>
<sub>Verifiable two ways, both offline: <b>walk</b> the reasoning (<code>--why</code>, stdlib reader) · <b>check</b> the seal (Ed25519, seal tool).</sub><br>
<sub><b><a href="MANIFESTO.md">Read the manifesto →</a></b> — memory is context, not results.</sub>

<p>
  <img src="https://img.shields.io/badge/spec-v3_draft-111111?style=flat-square" alt="spec v3 draft">
  <img src="https://img.shields.io/badge/reader-stdlib_only-111111?style=flat-square" alt="zero dependencies">
  <img src="https://img.shields.io/badge/license-MIT-111111?style=flat-square" alt="MIT">
  <a href="https://discord.gg/utU3U7kb3"><img src="https://img.shields.io/badge/community-Discord-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a>
</p>

<sub>an <b>◈ ISOMORPH</b> project — the format under <a href="https://laplas-landing.vercel.app">LAPLAS</a> and <a href="https://laplas-manifesto.vercel.app">Manifesto</a></sub>

<sub>🇰🇷 <b>팩을 만들러 오셨나요?</b> 한국어 제작 가이드 → <a href="./README.ko.md"><b>README.ko.md</b></a></sub>

</div>

<br>

> Your memory should not live and die with someone else's server. A `.laplaspack`
> is designed to be **owned, verified, mounted, and moved** — independently of any
> model, app, or vendor.

## Try it in 30 seconds

No install, no network, no model. The reference reader is a single stdlib-only Python file:

```bash
git clone https://github.com/AnYejun/laplaspack && cd laplaspack

python3 laplaspack_reader.py examples/demo.laplaspack
```
```text
laplaspack: examples/demo.laplaspack
  format_version = 3
  entities=4  edges=3  thinks=2
  causal roles: derived-from×2, supports×1
```

Now ask the pack **why** it believes something:

```bash
python3 laplaspack_reader.py examples/demo.laplaspack --why "Subscription is the core offer"
```
```text
why «Subscription is the core offer» — 3 ancestor(s):
  1. (derived-from) Single-origin only                 [decision]
  2. (derived-from) Direct trade doubles farm income   [proof]
  3. (supports)     Own roastery in Mapo               [differentiator]
```

That ordered chain is not a search result — it is the pack's own recorded
reasoning, walked from the graph. There are also `--todos`, `--entity "…"`, and
`--json` for piping.

Seal it, and any edit becomes detectable (the one tool here that needs a
dependency — `pip install cryptography`; stdlib has no Ed25519):

```bash
python3 laplaspack_seal.py keygen --key me.key
python3 laplaspack_seal.py sign   examples/demo.laplaspack --key me.key
python3 laplaspack_seal.py verify examples/demo.laplaspack   # VALID — sealed by 1a2b…
```

And two minds **add**. Packs whose shared nodes declare an authored id
(`>>id: lp_…`) merge mechanically — no model in the loop; where they disagree,
the losing claim is kept losslessly and can even become a `contradicts` edge,
so *"where do our teams disagree?"* turns into a graph query
([SPEC §3.9](./SPEC.md#39-merge-declared-identity)):

```bash
python3 laplaspack_merge.py teamA.laplaspack teamB.laplaspack -o org.laplaspack \
    --conflicts materialize
python3 laplaspack_reader.py org.laplaspack --why "Deploy policy"   # walks BOTH teams' evidence
```

## Mount a pack into any MCP client

A pack someone handed you becomes a live, queryable memory inside Claude,
Cursor, or any other MCP client — one config line, zero dependencies, no
account, nothing leaves your machine
([`laplaspack_mcp.py`](./laplaspack_mcp.py)):

```json
{ "mcpServers": { "my-pack": {
    "command": "python3",
    "args": ["/path/to/laplaspack_mcp.py", "/path/to/mind.laplaspack"] } } }
```

The client gets five read-only tools: `find` (full-text over atoms), `open`
(one atom's properties + typed links + thoughts), `directory` (the map of the
mind), `why` (the recorded reasoning chain), and `blind_spots` — unclosed
loops in the typed graph (exact $H_1$): what this memory *doesn't know it's
missing*. Mount several packs at once by passing several paths.

## Make your own — with an AI, in minutes

Any capable model can compile raw material (your company story, your résumé,
project notes) into LMD; the stdlib writer turns that into a pack:

```bash
# 1 · paste prompts/lmd-compiler.md into Claude/ChatGPT/Gemini + your raw text
# 2 · save the returned LMD, then:
python3 laplaspack_writer.py story.lmd --owner you --name "My story"
python3 laplaspack_reader.py story.laplaspack --why "<one of your decisions>"
```

No raw material yet? Use the **interview**:
[`prompts/manifesto-interview.md`](./prompts/manifesto-interview.md) turns the
model into an interviewer that pulls your company's story out one question at
a 

... (truncated)