Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

fix: ship iii-config.docker.yaml in the npm tarball (#136) (#137)

Rohit Ghumareb864a7d26871
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e805f3c1..ac6bda3c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,20 @@ All notable changes to agentmemory will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [0.8.7] — 2026-04-14
+
+One-line fix for a brown-paper-bag bug reported in [#136](https://github.com/rohitg00/agentmemory/issues/136).
+
+### Fixed
+
+- **`npx @agentmemory/agentmemory` no longer crashes with "`/app/config.yaml` is a directory"** ([#136](https://github.com/rohitg00/agentmemory/issues/136), thanks [@stefano-medapps](https://github.com/stefano-medapps)) — the published tarball shipped `docker-compose.yml` but **not** `iii-config.docker.yaml`, even though the compose file mounts `./iii-config.docker.yaml:/app/config.yaml:ro`. Docker resolves missing host-path bind sources by silently creating them as empty directories, so the iii-engine container mounted an empty dir at `/app/config.yaml` and crashed with `Error: Failed to read config file '/app/config.yaml': Is a directory (os error 21)`. The `files` array in `package.json` now includes `iii-config.docker.yaml` alongside the regular `iii-config.yaml`.
+
+### Infrastructure
+
+- New regression test in `test/consistency.test.ts` parses every `./<path>:<container>` bind mount in `docker-compose.yml` and asserts the source file is shipped via the `files` array. Catches the class of bug where a new bind mount is added to compose without a corresponding entry in `files`.
+
+[0.8.7]: https://github.com/rohitg00/agentmemory/compare/v0.8.6...v0.8.7
+
## [0.8.6] — 2026-04-13
Finishes the `npx <shim>` story from #120 by moving the standalone package under the `@agentmemory` scope.
diff --git a/package-lock.json b/package-lock.json
index 1dc64cc5..3fd68b26 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@agentmemory/agentmemory",
- "version": "0.8.6",
+ "version": "0.8.7",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@agentmemory/agentmemory",
- "version": "0.8.6",
+ "version": "0.8.7",
"license": "Apache-2.0",
"dependencies": {
"@anthropic-ai/claude-agent-sdk": "^0.2.56",
diff --git a/package.json b/package.json
index d453232f..f5b14d33 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "@agentmemory/agentmemory",
- "version": "0.8.6",
+ "version": "0.8.7",
"description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives",
"type": "module",
"main": "dist/index.mjs",
@@ -41,6 +41,7 @@
"dist/",
"plugin/",
"iii-config.yaml",
+ "iii-config.docker.yaml",
"docker-compose.yml",
"LICENSE",
"README.md",
diff --git a/packages/mcp/package.json b/packages/mcp/package.json
index d1e5c344..f5a6f901 100644
--- a/packages/mcp/package.json
+++ b/packages/mcp/package.json
@@ -1,6 +1,6 @@
{
"name": "@agentmemory/mcp",
- "version": "0.8.6",
+ "version": "0.8.7",
"description": "Standalone MCP server for agentmemory — thin shim that re-exposes @agentmemory/agentmemory's MCP entrypoint",
"type": "module",
"bin": {
@@ -28,7 +28,7 @@
"homepage": "https://github.com/rohitg00/agentmemory#readme",
"bugs": "https://github.com/rohitg00/agentmemory/issues",
"dependencies": {
- "@agentmemory/agentmemory": "~0.8.6"
+ "@agentmemory/agentmemory": "~0.8.7"
},
"publishConfig": {
"access": "public",
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index 7dc2a270..3adc85fd 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "agentmemory",
- "version": "0.8.6",
+ "version": "0.8.7",
"description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 43 MCP tools, 4 skills, real-time viewer.",
"author": {
"name": "Rohit Ghumare",
diff --git a/src/functions/export-import.ts b/src/functions/export-import.ts
index 9c9ef7f7..b90dbb91 100644
--- a/src/functions/export-import.ts
+++ b/src/functions/export-import.ts
@@ -175,7 +175,7 @@ export function registerExportImportFunction(sdk: ISdk, kv: StateKV): void {
const strategy = data.strategy || "merge";
const importData = data.exportData;
- const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6"]);
+ const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6", "0.8.7"]);
if (!supportedVersions.has(importData.version)) {
return {
success: false,
diff --git a/src/types.ts b/src/types.ts
index b452a26a..4143dc9b 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -252,7 +252,7 @@ export interface ExportPagination {
}
export interface ExportData {
- version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6";
+ version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7";
exportedAt: string;
sessions: Session[];
observations: Record<string, CompressedObservation[]>;
diff --git a/src/version.ts b/src/version.ts
index 2596e7ca..e7cfada8 100644
--- a/src/version.ts
+++ b/src/version.ts
@@ -1 +1 @@
-export const VERSION: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" = "0.8.6";
+export const VERSION: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" = "0.8.7";
diff --git a/test/consistency.test.ts b/test/consistency.test.ts
index 092f51ae..c2a84524 100644
--- a/test/consistency.test.ts
+++ b/test/consistency.test.ts
@@ -58,4 +58,38 @@ describe("Consistency checks", () => {
expect(tool.inputSchema.type).toBe("object");
}
});
+
+ it("every host-path bind mount in docker-compose.yml is in the published files list (#136)", () => {
+ // Regression guard for #136: docker-compose.yml references
+ // ./iii-config.docker.yaml as a read-only bind mount, but the file
+ // was missing from the published tarball. Docker silently creates
+ // missing bind sources as empty directories, so the engine crashed
+ // with "Is a directory (os error 21)" at /app/config.yaml.
+ const compose = readText("docker-compose.yml");
+ const pkg = JSON.parse(readText("package.json"));
+ const files: string[] = pkg.files ?? [];
+
+ // Match `./<path>:<container-path>` style bind mounts. We only care
+ // about files that live in the repo root (so they'd be shipped via
+ // the `files` field). `iii-data:/data` (a named volume) has no `./`
+ // prefix and is correctly skipped.
+ const bindRe = /^\s*-\s+\.\/([^\s:]+):[^\s]+/gm;
+ const sources: string[] = [];
+ for (const m of compose.matchAll(bindRe)) sources.push(m[1]!);
+
+ expect(sources.length).toBeGreaterThan(0);
+ for (const src of sources) {
+ // Any nested path would need a directory entry in `files` (e.g.
+ // `dist/`); for top-level files, the exact name must be listed.
+ const topLevel = src.split("/")[0]!;
+ const covered =
+ files.includes(src) ||
+ files.includes(topLevel) ||
+ files.includes(`${topLevel}/`);
+ expect(
+ covered,
+ `docker-compose.yml mounts ./${src} but package.json "files" does not ship it — ${topLevel} would be auto-created as an empty dir on install, breaking \`npx @agentmemory/agentmemory\``,
+ ).toBe(true);
+ }
+ });
});
diff --git a/test/export-import.test.ts b/test/export-import.test.ts
index d724f832..a3953947 100644
--- a/test/export-import.test.ts
+++ b/test/export-import.test.ts
@@ -118,7 +118,7 @@ describe("Export/Import Functions", () => {
it("export produces valid ExportData structure", async () => {
const result = (await sdk.trigger("mem::export", {})) as ExportData;
- expect(result.version).toBe("0.8.6");
+ expect(result.version).toBe("0.8.7");
expect(result.exportedAt).toBeDefined();
expect(result.sessions.length).toBe(1);
expect(result.sessions[0].id).toBe("ses_1");