ruminate 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Finn Bodimeade
+
+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.

package/README.md

@@ -0,0 +1,81 @@
+# Ruminate
+
+Persistent memory and task context for coding agents.
+
+```sh
+npx ruminate init
+```
+
+> **Status:** pre-release. This package currently reserves the name and prints a pointer
+> to [ruminate.so](https://ruminate.so). `init` ships in `0.1.0`.
+
+## What it does
+
+Ruminate reads a repository you already have checked out and writes a `.ruminate/`
+directory describing what the project is, how it is built, and how it fits together. That
+directory is plain Markdown, committed alongside your code, so any coding agent — Claude
+Code, Cursor, Codex, whatever comes next — starts with the context a new teammate would
+get on their first day instead of rediscovering it every session. It runs locally, needs
+no account and no API key, and finishes in seconds.
+
+## Demo
+
+<!-- asciinema -->
+
+## What gets created
+
+```
+.ruminate/
+├── project.md        # what this is, stack, entrypoints, how to run
+├── architecture.md   # major components and how they relate
+├── context.md        # merged existing agent context (AGENTS.md, CLAUDE.md, …)
+├── tasks.md          # unfinished work, in a shape agents can pick up
+├── decisions.md      # choices worth not relitigating
+└── manifest.json     # file hashes, scan timestamp, version
+```
+
+Commit it. It is written for humans and agents to read the same way, with stable headings
+and deterministic ordering, so re-running `init` produces a clean diff rather than churn.
+
+## How it works
+
+`ruminate init` resolves your git root, walks the tree while respecting every applicable
+`.gitignore`, and reads your manifests (`package.json`, `pyproject.toml`, `Cargo.toml`,
+`go.mod`, and friends) to identify the stack and entrypoints. It then ranks files by
+import centrality — how much of the codebase depends on them — to find the parts that
+actually matter.
+
+Existing agent context files are treated as authoritative. If your repo already has an
+`AGENTS.md`, a `CLAUDE.md`, or `.cursorrules`, what they say wins over anything Ruminate
+infers.
+
+Re-running `init` will not overwrite your edits. Ruminate hashes what it wrote, reports
+what has drifted since, and requires `--force` before replacing anything you changed by
+hand.
+
+## Privacy
+
+No telemetry. No analytics. No phone-home. The first pass makes no network calls at all
+and requires no API key — everything it produces comes from files already on your disk.
+
+## Requirements
+
+Node.js 20 or newer.
+
+## Contributing
+
+After a release is published, verify it from the registry rather than from a local
+checkout:
+
+```sh
+scripts/verify-release.sh              # defaults to ruminate@latest
+scripts/verify-release.sh ruminate@0.0.1
+```
+
+It runs `npx` against the published package in a clean temp directory with a cold cache,
+so it exercises the registry fetch, the bin shim and the shebang — the path a new user
+actually takes. It exits non-zero and loudly on any failure.
+
+## Licence
+
+MIT

package/bin/ruminate.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+console.log('ruminate: not released yet — follow along at https://ruminate.so');

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "ruminate",
+  "version": "0.0.1",
+  "description": "Persistent memory and task context for coding agents",
+  "type": "module",
+  "bin": { "ruminate": "bin/ruminate.js" },
+  "files": ["bin"],
+  "keywords": [
+    "ai",
+    "agents",
+    "coding-agent",
+    "context",
+    "memory",
+    "cli",
+    "codebase",
+    "mcp"
+  ],
+  "engines": { "node": ">=20" },
+  "license": "MIT",
+  "author": "Finn Bodimeade",
+  "homepage": "https://ruminate.so",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/getruminate/ruminate.git"
+  }
+}