hippocamp 0.1.1 → 0.2.1

package/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          package-manager-cache: false
+      - run: npm ci
+      - run: node --check scripts/*.cjs
+      - run: npm run mcp:help
+      - run: npm run mcp:smoke

package/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish Package
+
+on:
+  release:
+    types:
+      - published
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          registry-url: "https://registry.npmjs.org"
+          package-manager-cache: false
+      - run: npm ci
+      - run: node --check scripts/*.cjs
+      - run: npm run mcp:smoke
+      - name: Verify release tag matches package version
+        run: test "$GITHUB_REF_NAME" = "v$(node -p "require('./package.json').version")"
+      - run: npm publish

package/AGENTS.md

@@ -22,14 +22,18 @@ This repository is a local-first MCP package for Git-backed agent memory. Keep c
 
 ## Repository Map
 
-- `scripts/hippocamp.cjs`: small CLI wrapper for `dream`, `mcp`, `install-codex`, and `install-claude`.
+- `scripts/hippocamp.cjs`: small CLI wrapper for `dream`, `mcp`, `install-codex`, `install-claude`, and `install-grok`.
 - `scripts/hippocamp-dream.cjs`: offline Dream CLI for scheduled compaction of curated project wake-up files.
 - `scripts/hippocamp-memory.cjs`: local filesystem-backed Hippocamp memory helpers for MCP use.
 - `scripts/hippocamp-mcp.cjs`: local stdio MCP server for Hippocamp memory tools.
+- `scripts/eval-retrieval.cjs`: retrieval-only LongMemEval-S check for `searchMemory` against a BM25 reference.
 - `scripts/install-claude.cjs`: one-step installer for Claude Code MCP setup and user-level `CLAUDE.md` guidance.
 - `scripts/install-codex.cjs`: one-step installer for the Hippocamp skill and MCP server in Codex.
+- `scripts/install-grok.cjs`: one-step installer for the Hippocamp skill, Grok home rules, and MCP server in Grok Build.
 - `skills/hippocamp-memory/SKILL.md`: installable skill that tells agents how to use Hippocamp memory.
 - `assets/github-actions/hippocamp-dream.yml`: scheduled workflow template for Lagoon repos that opens one Dream PR per project.
+- `assets/railway/run-dream.sh`: short-lived hosted Dream runner that clones Lagoon and opens one Dream PR per project.
+- `Dockerfile.railway` and `railway.json`: optional Railway cron deployment for overnight Dream runs.
 - `assets/brand/hippocamp-mascot.png`: README mascot asset.
 
 ## Project Invariants
@@ -41,12 +45,15 @@ This repository is a local-first MCP package for Git-backed agent memory. Keep c
 - The current project slug is inferred from `HIPPOCAMP_PROJECT_ROOT` or the current working directory.
 - Event logs are append-only daily Markdown files under `events/YYYY-MM-DD.md`, with sibling `events/YYYY-MM-DD.index.json` cue indexes.
 - Curated files such as `current_state.md` and `open_threads.md` use explicit file writes.
-- Event entries should include concise `Cues:` values for fuzzy recall when possible.
+- MCP `append_event` requires a title and 1-8 cues; MCP `write_memory_file` rejects paths under `events/`; an explicit `projectRoot` must be a directory inside a Git repository.
+- `append_event` auto-stamps `Agent:` / `Session:` provenance when resolvable (installer env, MCP client name, or process session id). No manual user config.
 - Default sync is automatic through the local Lagoon repo.
 - Local MCP mode must not require `GITHUB_TOKEN`, GitHub App auth, or a cloud service.
 - Memory must not duplicate facts already tracked by GitHub commits, PRs, issues, reviews, or CI. Store references plus the missing rationale, preference, assumption, or follow-up context instead.
 - Dream compaction sends `current_state.md`, `open_threads.md`, and bounded cue-indexed event evidence for open-thread decisions. It must not dump full event logs, cue indexes, or raw GitHub-owned facts into the model prompt.
-- The Dream GitHub Actions workflow is a Lagoon repo template. It should remain schedule-only and create reviewable PRs rather than pushing directly to `main`.
+- Dream must compact coherent Markdown snapshots and fail without writing when the snapshot cannot fit. It must not crop wake-up files.
+- The Dream GitHub Actions workflow is a Lagoon repo template. It should remain schedule-only and create PRs rather than pushing directly to `main`. Auto-merge is allowed only for repositories named `lagoon` after exact changed-file validation.
+- The Railway Dream deployment is optional infrastructure. It must exit after each run, keep credentials in environment variables, and preserve the same PR policy.
 
 ## Change Rules
 
@@ -61,14 +68,15 @@ This repository is a local-first MCP package for Git-backed agent memory. Keep c
 When changing code, use the smallest verification that proves the change:
 
 - Run `node --check scripts/*.cjs` for script syntax changes.
+- Run `npm test` for Dream compaction or memory search changes.
 - Run `npm run mcp:help` when changing MCP registration or commands.
 - Run `npm run mcp:smoke` when changing memory reads, root resolution, or wake-up behavior.
 - Run `npm run dream -- --help` when changing Dream CLI arguments.
-- There is no dedicated test suite yet, so do not claim test coverage that does not exist.
+- Run `npm run eval:retrieval -- --limit 100` when changing search ranking or snippets; report Recall@5 against the BM25 row.
 
 ## Notes For Future Agents
 
 - The cloud/API version is intentionally deferred.
 - Do not reintroduce Next.js, GitHub API token auth, or GitHub App auth for the local MVP.
-- Keep Dream minimal: scheduled CLI compaction, current/open curated files plus bounded thread evidence, one PR per project.
+- Keep Dream minimal: scheduled coherent compaction, current/open curated files plus bounded thread evidence, one PR per project.
 - The local install story should stay: install MCP, point at Lagoon, rely on normal Git auth.

package/Dockerfile.railway

@@ -0,0 +1,15 @@
+FROM node:22-bookworm-slim
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends ca-certificates gh git \
+  && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+COPY package.json package-lock.json ./
+RUN npm ci --omit=dev
+
+COPY scripts ./scripts
+COPY assets/railway/run-dream.sh ./assets/railway/run-dream.sh
+
+CMD ["bash", "assets/railway/run-dream.sh"]

package/README.md

@@ -1,5 +1,7 @@
 # Hippocamp
 
+[![CI](https://github.com/guillaumegay13/hippocamp/actions/workflows/ci.yml/badge.svg)](https://github.com/guillaumegay13/hippocamp/actions/workflows/ci.yml)
+
 <p align="center">
   <img src="./assets/brand/hippocamp-mascot.png" alt="Hippocamp mascot" width="220" />
 </p>
@@ -45,6 +47,13 @@ npm install
 npm run install:claude
 ```
 
+For Grok Build:
+
+```bash
+npm install
+npm run install:grok
+```
+
 After publishing, the intended one-line install shape is:
 
 ```bash
@@ -56,6 +65,7 @@ Upgrade uses the same install path, so agents can refresh themselves without a s
 ```bash
 npx hippocamp@latest upgrade-codex
 npx hippocamp@latest upgrade-claude
+npx hippocamp@latest upgrade-grok
 ```
 
 From a source checkout:
@@ -65,17 +75,19 @@ git pull --ff-only
 npm install
 npm run upgrade:codex
 npm run upgrade:claude
+npm run upgrade:grok
 ```
 
-Both installers default to `~/.lagoon` as the memory repo. You can override it:
+Installers default to `~/.lagoon` as the memory repo. You can override it:
 
 ```bash
 npm run install:codex -- --global-root /absolute/path/to/lagoon
 npm run install:claude -- --global-root /absolute/path/to/lagoon
+npm run install:grok -- --global-root /absolute/path/to/lagoon
 ```
 
-The Codex installer refreshes `~/.codex/AGENTS.md`. The Claude installer refreshes `~/.claude/CLAUDE.md`.
-Both managed instruction blocks tell the agent to call `wake_up` at the start of new top-level coding tasks before repo exploration or edits.
+The Codex installer refreshes `~/.codex/AGENTS.md`. The Claude installer refreshes `~/.claude/CLAUDE.md`. The Grok installer refreshes `~/.grok/rules/hippocamp.md` and registers the MCP server with `HIPPOCAMP_AGENT=grok`.
+Managed instruction blocks tell the agent to call `wake_up` at the start of new top-level coding tasks before repo exploration or edits.
 
 ## Lagoon Repo
 
@@ -145,13 +157,13 @@ Typical agent flow:
 
 1. Call `wake_up` at the start of a top-level task.
 2. Read the returned global and project memory.
-3. Use `search_memory` only when wake-up files are not enough.
-4. Use `append_event` for meaningful milestones, with concise cues when possible.
+3. Use `search_memory` for task-specific recall after wake-up.
+4. Use `append_event` for meaningful milestones, with a title and 1-8 concise cues.
 5. Update curated files like `current_state.md` and `open_threads.md` before finishing.
 
 Writes sync by default. If sync fails or is skipped, call `sync_memory`.
 
-Event writes update a sibling `events/YYYY-MM-DD.index.json` file. The Markdown event remains the canonical memory; the sidecar keeps cue-based fuzzy search fast and rebuildable.
+Event writes update a sibling `events/YYYY-MM-DD.index.json` file. The Markdown event remains the canonical memory; the sidecar is rebuildable. Search ranks indexed events and curated files with BM25 and typo tolerance ([MiniSearch](https://github.com/lucaong/minisearch)), weighting cues above titles and titles above bodies. It returns small coherent evidence blocks from indexed events. If no indexed result is strong enough, it returns no event result instead of scanning whole event logs.
 
 ## Dream
 
@@ -162,7 +174,9 @@ projects/<project-slug>/current_state.md
 projects/<project-slug>/open_threads.md
 ```
 
-It does not dump event logs into the model prompt, does not rewrite append-only events, and does not run during normal MCP wake-up. When a project is over the threshold, Dream builds a capped thread evidence pack by searching cue-indexed project events for `open_threads.md` bullets. The evidence budget follows `--target-chars`, so the same size target controls both the desired output and the supporting context. This gives the model enough context to keep, rewrite, close, or promote threads without loading raw history.
+It does not dump event logs into the model prompt, does not rewrite append-only events, and does not run during normal MCP wake-up. When a project is over the threshold, Dream builds a capped thread evidence pack by searching cue-indexed project events for `open_threads.md` bullets. The evidence budget follows `--target-chars`, so the same size target controls both the desired output and the supporting context.
+
+Dream uses an Eve-style compaction loop. It rewrites the complete curated snapshot, measures the result, and compacts that coherent result again when it is still over the target. It never crops a wake-up file. After three passes, it fails without writing either file if the snapshot still does not fit.
 
 Dry-run is the default:
 
@@ -177,21 +191,43 @@ npm run dream -- --project my-project --write
 - `MANIFEST_API_KEY`
 - `HIPPOCAMP_DREAM_MODEL` (defaults to `auto`; override if you want a specific provider/model)
 
-The GitHub Actions template at `assets/github-actions/hippocamp-dream.yml` is meant to be copied into the private Lagoon memory repo as `.github/workflows/hippocamp-dream.yml`. It runs on a schedule only, scans projects over the wake-up threshold, and creates or updates one PR per project so each memory compaction is reviewable.
+The GitHub Actions template at `assets/github-actions/hippocamp-dream.yml` is meant to be copied into the private Lagoon memory repo as `.github/workflows/hippocamp-dream.yml`. It runs on a schedule only, scans projects over the wake-up threshold, and creates or updates one PR per project. With `HIPPOCAMP_DREAM_AUTO_MERGE=true`, Dream squash-merges the PR only when the repository name is `lagoon` and the PR changes only the two curated project files.
+
+### Railway
+
+Railway can run Dream overnight even when your computer is offline. The included cron service starts once per day at `03:17 UTC`, clones the private Lagoon repo, creates or updates one Dream PR per candidate project, and exits. Set `HIPPOCAMP_DREAM_AUTO_MERGE=true` to enable the same Lagoon-only auto-merge policy.
+
+[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/hippocamp)
+
+Required template variables:
+
+- `LAGOON_REPOSITORY`: private memory repo in `owner/repository` form
+- `GITHUB_TOKEN`: fine-grained GitHub token limited to that repo, with read/write access to Contents and Pull requests
+- `MANIFEST_BASE_URL`: Manifest/OpenAI-compatible base URL
+- `MANIFEST_API_KEY`: API key for Dream model requests
+
+Optional variables keep the CLI defaults: `HIPPOCAMP_DREAM_MODEL=auto`, `HIPPOCAMP_DREAM_THRESHOLD_CHARS=20000`, and `HIPPOCAMP_DREAM_TARGET_CHARS=15000`. `HIPPOCAMP_DREAM_AUTO_MERGE=true` enables a guarded squash merge for a repository named `lagoon`.
+
+Railway is an optional deployment target. Local MCP reads and writes do not use Railway or require these hosted credentials.
 
 ## Memory Rules
 
 - Keep memory concise.
 - Prefer curated summaries over raw event history.
-- Give events a short `Cues:` section so fuzzy search can recall them without scanning full bodies first.
+- Give events a short `Cues:` section; cues weigh the most in search ranking.
 - Do not duplicate GitHub-owned facts such as commits, PRs, issues, reviews, or CI results.
 - Store artifact references plus the missing rationale, preference, assumption, or follow-up context.
 - Use project scope for project-specific state.
 - Use global scope only for durable context that should follow you across projects.
 
+Events are stamped automatically with agent/session provenance when available (`Agent:` / `Session:` lines). Installers set `HIPPOCAMP_AGENT`; session defaults to a process-lifetime id. No manual config is required.
+
 Example event content:
 
 ```md
+Agent: claude
+Session: mcp-a1b2c3d4
+
 Cues:
 - local-first
 - token-free
@@ -215,12 +251,30 @@ npm run mcp
 npm run mcp:help
 npm run mcp:smoke
 npm run dream
+npm run dream:railway
+npm run eval:retrieval
 npm run install:codex
 npm run install:claude
+npm run install:grok
 npm run upgrade:codex
 npm run upgrade:claude
+npm run upgrade:grok
 ```
 
+`npm run eval:retrieval` measures search on LongMemEval-S without any model: Recall@5, Hit@5, MRR, returned context size, and latency, next to an in-process BM25 reference. Run it with `--help` for the one-time data download.
+
+## Releases
+
+Pull requests and pushes to `main` run syntax and MCP smoke checks in GitHub Actions.
+
+To publish a package version:
+
+1. Update the version in `package.json` and `package-lock.json`, then merge it to `main`.
+2. Publish a GitHub Release whose tag is `v<version>`.
+3. The `Publish Package` workflow verifies the tag, runs the MCP checks, and publishes to npm through trusted publishing.
+
+The npm package must trust the GitHub Actions workflow `publish.yml` in `guillaumegay13/hippocamp`. This uses short-lived OIDC credentials instead of an npm token.
+
 ## Configuration
 
 Environment variables are optional for local use:
@@ -233,6 +287,7 @@ Environment variables are optional for local use:
 - `HIPPOCAMP_DREAM_MODEL`: model used by Dream. Default: `auto`
 - `HIPPOCAMP_DREAM_THRESHOLD_CHARS`: wake-up size required before Dream proposes compaction. Default: `20000`
 - `HIPPOCAMP_DREAM_TARGET_CHARS`: target combined size for `current_state.md` and `open_threads.md`. Default: `15000`
+- `HIPPOCAMP_DREAM_AUTO_MERGE`: set to `true` for a guarded squash merge in a repository named `lagoon`
 
 ## What This Is Not
 

package/assets/github-actions/hippocamp-dream.yml

@@ -22,7 +22,9 @@ jobs:
       HIPPOCAMP_GLOBAL_ROOT: ${{ github.workspace }}
       HIPPOCAMP_DREAM_THRESHOLD_CHARS: "20000"
       HIPPOCAMP_DREAM_TARGET_CHARS: "15000"
+      HIPPOCAMP_DREAM_AUTO_MERGE: "true"
       HIPPOCAMP_DREAM_MODEL: ${{ secrets.HIPPOCAMP_DREAM_MODEL }}
+      LAGOON_REPOSITORY: ${{ github.repository }}
       MANIFEST_BASE_URL: ${{ secrets.MANIFEST_BASE_URL }}
       MANIFEST_API_KEY: ${{ secrets.MANIFEST_API_KEY }}
 
@@ -65,6 +67,31 @@ jobs:
         run: |
           set -euo pipefail
 
+          enable_lagoon_auto_merge() {
+            local project="$1"
+            local pr_number="$2"
+
+            [ "$HIPPOCAMP_DREAM_AUTO_MERGE" = "true" ] || return 0
+
+            if [ "${LAGOON_REPOSITORY##*/}" != "lagoon" ]; then
+              echo "Skipping auto-merge: ${LAGOON_REPOSITORY} is not a repository named lagoon." >&2
+              return 0
+            fi
+
+            local changed_path
+            while IFS= read -r changed_path; do
+              case "$changed_path" in
+                "projects/${project}/current_state.md"|"projects/${project}/open_threads.md") ;;
+                *)
+                  echo "Refusing auto-merge: unexpected changed path ${changed_path}." >&2
+                  return 1
+                  ;;
+              esac
+            done < <(git diff --name-only origin/main...HEAD)
+
+            gh pr merge "$pr_number" --squash --delete-branch
+          }
+
           while IFS= read -r project; do
             [ -n "$project" ] || continue
 
@@ -113,6 +140,7 @@ jobs:
             "After:",
             `- wake_up: ${result.afterWakeUpChars} chars`,
             `- current_state.md + open_threads.md: ${result.afterBytes} bytes`,
+            `- coherent compaction passes: ${result.compactionPasses}`,
             "",
             "Policy:",
             "- touched only `current_state.md` and `open_threads.md`",
@@ -128,10 +156,15 @@ jobs:
 
             if [ -n "$existing" ]; then
               gh pr edit "$existing" --title "$title" --body-file "/tmp/hippocamp-dream-${project}.md"
+              pr_number="$existing"
             else
-              gh pr create --title "$title" --body-file "/tmp/hippocamp-dream-${project}.md" --head "$branch" --base main
+              gh pr create --title "$title" --body-file "/tmp/hippocamp-dream-${project}.md" --head "$branch" --base main >/dev/null
+              pr_number="$(gh pr list --head "$branch" --state open --json number --jq '.[0].number // empty')"
             fi
 
+            [ -n "$pr_number" ] || { echo "Could not resolve Dream PR number for ${project}." >&2; exit 1; }
+            enable_lagoon_auto_merge "$project" "$pr_number"
+
             git checkout main
             git reset --hard origin/main
           done < /tmp/hippocamp-dream-projects.txt

package/assets/railway/run-dream.sh

@@ -0,0 +1,184 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+required=(
+  GITHUB_TOKEN
+  LAGOON_REPOSITORY
+  MANIFEST_API_KEY
+  MANIFEST_BASE_URL
+)
+
+for name in "${required[@]}"; do
+  if [[ -z "${!name:-}" ]]; then
+    echo "Missing required environment variable: ${name}" >&2
+    exit 1
+  fi
+done
+
+if [[ ! "$LAGOON_REPOSITORY" =~ ^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$ ]]; then
+  echo "LAGOON_REPOSITORY must use the owner/repository form." >&2
+  exit 1
+fi
+
+export GH_TOKEN="$GITHUB_TOKEN"
+export HIPPOCAMP_DREAM_MODEL="${HIPPOCAMP_DREAM_MODEL:-auto}"
+export HIPPOCAMP_DREAM_TARGET_CHARS="${HIPPOCAMP_DREAM_TARGET_CHARS:-15000}"
+export HIPPOCAMP_DREAM_THRESHOLD_CHARS="${HIPPOCAMP_DREAM_THRESHOLD_CHARS:-20000}"
+export HIPPOCAMP_DREAM_AUTO_MERGE="${HIPPOCAMP_DREAM_AUTO_MERGE:-false}"
+
+runner_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+work_root="$(mktemp -d)"
+lagoon_root="$work_root/lagoon"
+
+cleanup() {
+  rm -rf "$work_root"
+}
+
+trap cleanup EXIT
+
+gh auth setup-git
+gh repo clone "$LAGOON_REPOSITORY" "$lagoon_root"
+
+cd "$lagoon_root"
+git config user.name "${HIPPOCAMP_DREAM_GIT_NAME:-hippocamp-dream[bot]}"
+git config user.email "${HIPPOCAMP_DREAM_GIT_EMAIL:-hippocamp-dream[bot]@users.noreply.github.com}"
+
+export HIPPOCAMP_GLOBAL_ROOT="$lagoon_root"
+
+node "$runner_root/scripts/hippocamp-dream.cjs" \
+  --all \
+  --dry-run \
+  --json \
+  --threshold-chars "$HIPPOCAMP_DREAM_THRESHOLD_CHARS" \
+  > "$work_root/scan.json"
+
+node - "$work_root/scan.json" > "$work_root/projects.txt" <<'NODE'
+const fs = require("node:fs");
+const scan = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
+const projects = scan.results
+  .filter((item) => item.skipped === "dry_run")
+  .map((item) => item.project);
+process.stdout.write(`${projects.join("\n")}${projects.length ? "\n" : ""}`);
+console.error(`Dream candidates: ${projects.length ? projects.join(", ") : "none"}`);
+NODE
+
+failed=()
+
+enable_lagoon_auto_merge() {
+  local project="$1"
+  local pr_number="$2"
+
+  [[ "$HIPPOCAMP_DREAM_AUTO_MERGE" == "true" ]] || return 0
+
+  if [[ "${LAGOON_REPOSITORY##*/}" != "lagoon" ]]; then
+    echo "Skipping auto-merge: ${LAGOON_REPOSITORY} is not a repository named lagoon." >&2
+    return 0
+  fi
+
+  local changed_path
+  while IFS= read -r changed_path; do
+    case "$changed_path" in
+      "projects/${project}/current_state.md"|"projects/${project}/open_threads.md") ;;
+      *)
+        echo "Refusing auto-merge: unexpected changed path ${changed_path}." >&2
+        return 1
+        ;;
+    esac
+  done < <(git diff --name-only origin/main...HEAD)
+
+  gh pr merge "$pr_number" --repo "$LAGOON_REPOSITORY" --squash --delete-branch
+}
+
+while IFS= read -r project; do
+  [[ -n "$project" ]] || continue
+
+  branch="dream/${project}"
+  result_file="$work_root/${project}.json"
+  body_file="$work_root/${project}.md"
+
+  git fetch origin main
+  git checkout -B "$branch" origin/main
+
+  if ! node "$runner_root/scripts/hippocamp-dream.cjs" \
+    --project "$project" \
+    --write \
+    --json \
+    --threshold-chars "$HIPPOCAMP_DREAM_THRESHOLD_CHARS" \
+    --target-chars "$HIPPOCAMP_DREAM_TARGET_CHARS" \
+    > "$result_file"; then
+    echo "Dream failed for ${project}; continuing with remaining projects." >&2
+    failed+=("$project")
+    git checkout -- .
+    continue
+  fi
+
+  if git diff --quiet -- "projects/${project}/current_state.md" "projects/${project}/open_threads.md"; then
+    echo "No Dream diff for ${project}"
+    continue
+  fi
+
+  git add "projects/${project}/current_state.md" "projects/${project}/open_threads.md"
+  git commit -m "Dream compact ${project} memory"
+
+  if git ls-remote --exit-code --heads origin "refs/heads/${branch}" >/dev/null 2>&1; then
+    git fetch origin "refs/heads/${branch}:refs/remotes/origin/${branch}"
+  fi
+
+  git push --force-with-lease origin "HEAD:refs/heads/${branch}"
+
+  node - "$project" "$result_file" > "$body_file" <<'NODE'
+const fs = require("node:fs");
+const project = process.argv[2];
+const payload = JSON.parse(fs.readFileSync(process.argv[3], "utf8"));
+const result = payload.results[0];
+const lines = [
+  `Dream compacted \`${project}\` curated memory.`,
+  "",
+  "Before:",
+  `- wake_up: ${result.wakeUpChars} chars`,
+  `- current_state.md: ${result.files["current_state.md"]} bytes`,
+  `- open_threads.md: ${result.files["open_threads.md"]} bytes`,
+  "",
+  "Context:",
+  `- open threads found: ${result.context.openThreads}`,
+  `- threads with event evidence: ${result.context.threadsWithEvidence}`,
+  `- event evidence snippets: ${result.context.evidenceItems}`,
+  `- evidence budget used: ${result.context.evidenceChars}/${result.context.evidenceBudgetChars} chars`,
+  "",
+  "After:",
+  `- wake_up: ${result.afterWakeUpChars} chars`,
+  `- current_state.md + open_threads.md: ${result.afterBytes} bytes`,
+  `- coherent compaction passes: ${result.compactionPasses}`,
+  "",
+  "Policy:",
+  "- touched only `current_state.md` and `open_threads.md`",
+  "- used bounded cue-indexed event evidence for thread decisions",
+  "- did not modify append-only events or cue indexes",
+  "- moved historical detail out of wake-up context",
+];
+console.log(lines.join("\n"));
+NODE
+
+  existing="$(gh pr list --repo "$LAGOON_REPOSITORY" --head "$branch" --state open --json number --jq '.[0].number // empty')"
+  title="Dream compact ${project} memory"
+
+  if [[ -n "$existing" ]]; then
+    gh api --method PATCH "repos/${LAGOON_REPOSITORY}/pulls/${existing}" \
+      --raw-field title="$title" \
+      --field "body=@${body_file}" \
+      >/dev/null
+    pr_number="$existing"
+  else
+    gh pr create --repo "$LAGOON_REPOSITORY" --title "$title" --body-file "$body_file" --head "$branch" --base main >/dev/null
+    pr_number="$(gh pr list --repo "$LAGOON_REPOSITORY" --head "$branch" --state open --json number --jq '.[0].number // empty')"
+  fi
+
+  [[ -n "$pr_number" ]] || { echo "Could not resolve Dream PR number for ${project}." >&2; exit 1; }
+  enable_lagoon_auto_merge "$project" "$pr_number"
+done < "$work_root/projects.txt"
+
+if ((${#failed[@]})); then
+  echo "Dream failed for: ${failed[*]}" >&2
+  echo "Exiting 0 so the cron deployment is not marked crashed; failures above are transient per-project model errors." >&2
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hippocamp",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "private": false,
   "description": "Local Git-backed memory for AI agents.",
   "license": "MIT",
@@ -24,20 +24,27 @@
     "hippocamp-dream": "scripts/hippocamp-dream.cjs",
     "hippocamp-mcp": "scripts/hippocamp-mcp.cjs",
     "hippocamp-install-codex": "scripts/install-codex.cjs",
-    "hippocamp-install-claude": "scripts/install-claude.cjs"
+    "hippocamp-install-claude": "scripts/install-claude.cjs",
+    "hippocamp-install-grok": "scripts/install-grok.cjs"
   },
   "scripts": {
     "dream": "node scripts/hippocamp-dream.cjs",
+    "dream:railway": "bash assets/railway/run-dream.sh",
+    "eval:retrieval": "node scripts/eval-retrieval.cjs",
     "install:claude": "node scripts/install-claude.cjs",
     "install:codex": "node scripts/install-codex.cjs",
+    "install:grok": "node scripts/install-grok.cjs",
     "mcp": "node scripts/hippocamp-mcp.cjs",
     "mcp:help": "node scripts/hippocamp-mcp.cjs --help",
     "mcp:smoke": "node scripts/hippocamp-mcp.cjs --smoke",
+    "test": "node --test test/*.test.cjs",
     "upgrade:claude": "node scripts/install-claude.cjs",
-    "upgrade:codex": "node scripts/install-codex.cjs"
+    "upgrade:codex": "node scripts/install-codex.cjs",
+    "upgrade:grok": "node scripts/install-grok.cjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "minisearch": "^7.2.0",
     "zod": "^4.3.6"
   }
 }

package/railway.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://railway.com/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile.railway"
+  },
+  "deploy": {
+    "cronSchedule": "17 3 * * *",
+    "restartPolicyType": "NEVER",
+    "startCommand": "bash assets/railway/run-dream.sh"
+  }
+}