@mobrienv/autoloop 0.10.0 → 0.11.0

package/.agents/skills/autoloop-memory/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: autoloop-memory
+description: Persist and recall Autoloop loop memory — add learnings and preferences, list and find entries, and render memory into prompts. Use when the user asks to remember something across loop runs, inspect loop memory, or configure a memory plugin.
+argument-hint: "[add|list|find|render|status|remove] [args...]"
+---
+
+# Autoloop Memory
+
+Loop memory is the durable store a loop reads into each iteration prompt. The default plugin is `jsonl` (`.autoloop/memory.jsonl`). A loop uses memory without forking core: pick a plugin with `memory.kind` in `autoloops.toml`.
+
+Parse `$ARGUMENTS` to choose a verb. If none, list memory.
+
+## Verbs
+
+```bash
+# Persist
+autoloop memory add learning "insight the next iteration should keep"
+autoloop memory add preference Workflow "Always run tests before review.ready"
+autoloop memory add meta smoke_iteration "2"
+
+# Recall
+autoloop memory list
+autoloop memory find "pattern"
+autoloop memory status
+
+# Prompt-shaped render (same text the harness injects, no budget)
+autoloop memory list
+
+# Remove (tombstone; append-only)
+autoloop memory remove <id>
+```
+
+`autoloop inspect memory` shows the same rendered block (`--format md`) or raw store (`--format json`).
+
+## Default jsonl store
+
+Unless `memory.kind` is set, Autoloop uses the built-in `jsonl` plugin:
+
+- Path: `AUTOLOOP_MEMORY_FILE` or `core.memory_file` (default `.autoloop/memory.jsonl`)
+- Entries: learning, preference, meta, tombstone
+- Prompt injection is truncated to `memory.prompt_budget_chars` (default 8000)
+
+`file` is a second built-in plugin with the same jsonl file store.
+
+To **replace** jsonl with Honcho, SuperMemory, Mnemosyne, or another store, install that product's Autoloop adapter and set `memory.module`. Autoloop does not ship those products.
+
+```toml
+[memory]
+kind = "honcho"
+module = "@example/autoloop-memory-honcho"   # or "./memory/honcho.cjs"
+prompt_budget_chars = 8000
+```
+
+The module exports `createMemoryPlugin({ projectDir, kind })` (or `default` / `plugin`) implementing add / list / find / render. API keys stay in the adapter env. `registerMemoryPlugin` still works in-process.
+
+## When to write memory
+
+- **learning** — a durable lesson discovered during a run
+- **preference** — a categorized behavioral rule (always project-scoped)
+- **meta** — a small key/value the next iteration should see
+
+Do not invent a second memory product. Use these verbs against the configured plugin.

package/README.md

@@ -102,6 +102,24 @@ If Ralph is the broader experimentation surface, autoloop is the cleaner runtime
 npm install -g @mobrienv/autoloop
 ```
 
+### Standalone binary (no Node required)
+
+npm remains the primary and recommended installation channel. For a Node-free
+installation, download the binary for your OS and architecture plus
+`SHA256SUMS` from the [GitHub release](https://github.com/mikeyobrien/autoloop/releases):
+
+```bash
+VERSION=v0.10.1
+TARGET=darwin-arm64 # darwin-arm64, darwin-x64, linux-arm64, or linux-x64
+curl -LO "https://github.com/mikeyobrien/autoloop/releases/download/${VERSION}/autoloop-${TARGET}"
+curl -LO "https://github.com/mikeyobrien/autoloop/releases/download/${VERSION}/SHA256SUMS"
+grep "  autoloop-${TARGET}$" SHA256SUMS > SHA256SUMS.current
+sha256sum -c SHA256SUMS.current # Linux
+# shasum -a 256 -c SHA256SUMS.current # macOS
+chmod +x "autoloop-${TARGET}"
+sudo mv "autoloop-${TARGET}" /usr/local/bin/autoloop
+```
+
 ### From source
 
 ```bash
@@ -311,8 +329,25 @@ See [CLI reference](https://mikeyobrien.github.io/autoloop/reference/cli#mock-ba
 - [Worktree isolation](https://mikeyobrien.github.io/autoloop/features/worktree)
 - [Releasing](https://mikeyobrien.github.io/autoloop/development/releasing)
 
+## Local CI / merge gate
+
+No GitHub Actions on PRs. Prove green locally, then sign off. Full pattern:
+[docs/ci-local.md](docs/ci-local.md).
+
+```sh
+npm ci
+npm run build
+npm run check          # biome + tsc --noEmit + vitest coverage
+
+gh extension install basecamp/gh-signoff
+gh signoff             # posts context `signoff` — required to merge
+```
+
+Publish and docs deploy still run on tags / `main` (`publish-npm.yml`,
+`docs.yml`). Do not add a PR `ci.yml` back.
+
 ## Contributing
 
 Bug reports and pull requests are welcome at [github.com/mikeyobrien/autoloop](https://github.com/mikeyobrien/autoloop/issues).
 
-Prerequisites for development: Node.js >= 18, npm. Run `npm install && npm run build` to get started, then `npm test` to verify.
+Prerequisites for development: Node.js >= 18, npm. Run `npm install && npm run build` to get started, then `npm run check` to verify. Merge requires local proof plus `gh signoff` (see [docs/ci-local.md](docs/ci-local.md)).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "Simpler, opinionated loop harness for inspectable long-running agent workflows",
   "type": "module",
@@ -20,6 +20,8 @@
     "bin/autoloop",
     "dist",
     "plugins/autoloop",
+    "plugins/autoloop-memory",
+    ".agents/skills",
     "README.md"
   ],
   "engines": {
@@ -73,7 +75,7 @@
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs",
     "prepare": "husky",
-    "version": "node -e \"const p=require('./plugins/autoloop/.claude-plugin/plugin.json');p.version=require('./package.json').version;require('fs').writeFileSync('./plugins/autoloop/.claude-plugin/plugin.json',JSON.stringify(p,null,2)+'\\n')\" && git add plugins/autoloop/.claude-plugin/plugin.json"
+    "version": "node -e \"const fs=require('fs');const v=require('./package.json').version;for (const dir of ['plugins/autoloop','plugins/autoloop-memory']){const f=dir+'/.claude-plugin/plugin.json';const p=JSON.parse(fs.readFileSync(f,'utf8'));p.version=v;fs.writeFileSync(f,JSON.stringify(p,null,2)+'\\n')}\" && git add plugins/autoloop/.claude-plugin/plugin.json plugins/autoloop-memory/.claude-plugin/plugin.json"
   },
   "lint-staged": {
     "*.{ts,js,json}": [
@@ -93,9 +95,9 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@mobrienv/autoloop-cli": "0.10.0",
-    "@mobrienv/autoloop-core": "0.10.0",
-    "@mobrienv/autoloop-harness": "0.10.0",
-    "@mobrienv/autoloop-presets": "0.10.0"
+    "@mobrienv/autoloop-cli": "0.11.0",
+    "@mobrienv/autoloop-core": "0.11.0",
+    "@mobrienv/autoloop-harness": "0.11.0",
+    "@mobrienv/autoloop-presets": "0.11.0"
   }
 }

package/plugins/autoloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "autoloop",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up.",
   "homepage": "https://github.com/mikeyobrien/autoloop",
   "repository": "https://github.com/mikeyobrien/autoloop",

package/plugins/autoloop-memory/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "autoloop-memory",
+  "version": "0.11.0",
+  "description": "Persist and recall Autoloop loop memory — add, list, find, and render learnings and preferences.",
+  "homepage": "https://github.com/mikeyobrien/autoloop",
+  "repository": "https://github.com/mikeyobrien/autoloop",
+  "license": "MIT",
+  "keywords": ["autoloop", "memory", "ai-agents"]
+}