@animalabs/connectome-host 0.3.9 → 0.4.0

package/docs/DEV-ENVIRONMENT.md

@@ -1,6 +1,6 @@
 # Connectome Dev Environment — Setup Guide
 
-**Status:** Working notes, uncommitted. Snapshot of the dev layout as of 2026-05-30.
+**Status:** Working notes. Snapshot of the dev layout as of 2026-07-22 (originally 2026-05-30; all feature branches in the original table have since merged to `main`).
 **Goal:** Reproduce the current development state — every component as a local git
 checkout, wired together so the host runs against editable source.
 
@@ -24,17 +24,22 @@ that holds a recipe + `.env` + chronicle data and references the code by absolut
 
 All cloned as siblings under `~/connectome-local/`:
 
-| Dir | GitHub repo | Branch | Ver | Role |
+| Dir | GitHub repo | Branch | Ver (2026-07-22) | Role |
 |---|---|---|---|---|
-| `forking-knowledge-miner` | `anima-research/connectome-host` | `feat/tui-mem-stats-and-strategy-passthrough` | 0.3.0 | the host app (run via **bun**) |
-| `agent-framework` | `anima-research/agent-framework` | `fix/lazy-register-locus-and-send-failure-marker` | 0.5.0 | host runtime: gate, MCPL orchestration, locus routing, `think` |
-| `discord-mcpl` | `anima-research/discord-mcpl` | `main` | 0.1.0 | Discord surface (MCPL server) |
-| `heartbeat-mcpl` | `anima-research/heartbeat-mcpl` | `main` | 0.1.0 | periodic self-wake (MCPL server) |
-| `terminal-sessions-mcp` | `antra-tess/terminal-sessions-mcp` ⚠️ | `main` | 1.0.1 | shell: session daemon (ws://localhost:3100) + per-agent MCP stdio frontend |
-| `membrane` | `antra-tess/membrane` ⚠️ | `fix/before-request-hook-on-stream-paths` | 0.5.47 | LLM client lib — **single shared instance required** |
-| `context-manager` | `anima-research/context-manager` | `feat/adaptive-resolution` | 0.4.0 | context compilation / autobiographical memory |
-| `chronicle` | `anima-research/chronicle` | `main` | 0.1.1 | record / chronicle store |
-| `mcpl-core-ts` | `anima-research/mcpl-core-ts` | `main` | 0.1.0 | MCPL protocol types (discord-mcpl path dep) |
+| `forking-knowledge-miner` | `anima-research/connectome-host` | `main` | 0.3.10 | the host app (run via **bun**) |
+| `agent-framework` | `anima-research/agent-framework` | `main` | 0.6.10 | host runtime: gate, MCPL orchestration, locus routing, `think` |
+| `discord-mcpl` | `anima-research/discord-mcpl` | `main` | 0.1.4 | Discord surface (MCPL server) |
+| `heartbeat-mcpl` | `anima-research/heartbeat-mcpl` | `main` | 0.1.3 | periodic self-wake (MCPL server) |
+| `terminal-sessions-mcp` | `antra-tess/terminal-sessions-mcp` ⚠️ | `main` | 1.6.0 | shell: session daemon (ws://localhost:3100) + per-agent MCP stdio frontend |
+| `membrane` | `antra-tess/membrane` ⚠️ | `main` | 0.5.74 | LLM client lib — **single shared instance required** |
+| `context-manager` | `anima-research/context-manager` | `main` | 0.5.14 | context compilation / autobiographical memory |
+| `chronicle` | `anima-research/chronicle` | `main` | 0.2.7 | record / chronicle store |
+| `mcpl-core-ts` | `anima-research/mcpl-core-ts` | `main` | 0.2.1 | MCPL protocol types |
+
+> Versions drift; treat the column as a dated snapshot. The published npm
+> releases now track `main` closely (typically within a patch), so the
+> stock `bun install` path is sufficient for host-level work — use the
+> checkout layout below when editing the libraries themselves.
 
 > ⚠️ **Org note:** `terminal-sessions-mcp` and `membrane` still live under the
 > personal `antra-tess` org, not `anima-research`. Consider migrating them for
@@ -51,19 +56,15 @@ All cloned as siblings under `~/connectome-local/`:
 ```bash
 mkdir -p ~/connectome-local && cd ~/connectome-local
 
-git clone -b feat/tui-mem-stats-and-strategy-passthrough \
-  git@github.com:anima-research/connectome-host.git forking-knowledge-miner
-git clone -b fix/lazy-register-locus-and-send-failure-marker \
-  git@github.com:anima-research/agent-framework.git
-git clone -b main  git@github.com:anima-research/discord-mcpl.git
-git clone -b main  git@github.com:anima-research/heartbeat-mcpl.git
-git clone -b main  git@github.com:antra-tess/terminal-sessions-mcp.git
-git clone -b fix/before-request-hook-on-stream-paths \
-  git@github.com:antra-tess/membrane.git
-git clone -b feat/adaptive-resolution \
-  git@github.com:anima-research/context-manager.git
-git clone -b main  git@github.com:anima-research/chronicle.git
-git clone -b main  git@github.com:anima-research/mcpl-core-ts.git
+git clone git@github.com:anima-research/connectome-host.git forking-knowledge-miner
+git clone git@github.com:anima-research/agent-framework.git
+git clone git@github.com:anima-research/discord-mcpl.git
+git clone git@github.com:anima-research/heartbeat-mcpl.git
+git clone git@github.com:antra-tess/terminal-sessions-mcp.git
+git clone git@github.com:antra-tess/membrane.git
+git clone git@github.com:anima-research/context-manager.git
+git clone git@github.com:anima-research/chronicle.git
+git clone git@github.com:anima-research/mcpl-core-ts.git
 ```
 
 ---
@@ -82,8 +83,9 @@ terminal-sessions-mcp
 
 In each: `npm install && npm run build` (build script is `tsc`).
 
-> `discord-mcpl` depends on `@connectome/mcpl-core` via `file:../mcpl-core-ts`
-> (a path dep), so build `mcpl-core-ts` first.
+> `discord-mcpl` now depends on `@animalabs/mcpl-core` as a regular npm
+> dependency (the old `file:../mcpl-core-ts` path dep is gone). A sibling
+> `mcpl-core-ts` checkout is only needed when changing mcpl-core itself.
 
 ---
 

package/docs/LOCUS-ROUTING-DESIGN.md

@@ -1,7 +1,10 @@
 # Conversational Locus & Output Routing — Design Note
 
-**Status:** Agreed design, implementation deferred.
-**Date:** 2026-05-29
+**Status:** Implemented — the locus now lives in `agent-framework`
+(`src/mcpl/channel-registry.ts`; `routeSpeech` fires at turn completion in
+`framework.ts`) and has grown beyond this note (global-locus fallback for
+heartbeats, fork/home-channel semantics). Kept as design rationale.
+**Date:** 2026-05-29 (status updated 2026-07-21)
 **Context:** Surfaced while wiring periodic heartbeats for an agent instance
 running headless on a Linux VPS.
 
@@ -95,6 +98,9 @@ discord-mcpl patch.
 
 ## Bugs found in passing (separate fixes, worth upstreaming)
 
+*(Update 2026-07-21: #3 has been fixed upstream — `agent-framework`'s
+feature-set-manager now normalizes array→record on ingest.)*
+
 1. **discord-mcpl `connect()` race** — resolved on `login()` (before gateway
    READY), so `registerDiscordChannels` enumerated an empty `guilds.cache`.
    *Fixed*: `connect()` now awaits the `ready` event. (Not yet

package/package.json

@@ -1,22 +1,23 @@
 {
   "name": "@animalabs/connectome-host",
-  "version": "0.3.9",
+  "version": "0.4.0",
   "description": "General-purpose agent TUI host with recipe-based configuration",
   "type": "module",
   "scripts": {
     "start": "bun src/index.ts",
     "dev": "bun --watch src/index.ts",
     "test": "bun test",
+    "version": "bun scripts/release-changelog.ts && git add CHANGELOG.md",
     "build:web": "npm --prefix web install && npm --prefix web run build",
     "build:web:ci": "npm ci --prefix web && npm --prefix web run build",
     "relock:web": "rm -rf web/node_modules web/package-lock.json && npm --prefix web install",
     "postinstall": "test -d web && npm --prefix web install && npm --prefix web run build || true"
   },
   "dependencies": {
-    "@animalabs/agent-framework": "^0.6.8",
+    "@animalabs/agent-framework": "^0.7.0",
     "@animalabs/chronicle": "^0.2.0",
-    "@animalabs/context-manager": "^0.5.13",
-    "@animalabs/membrane": "^0.5.73",
+    "@animalabs/context-manager": "^0.6.0",
+    "@animalabs/membrane": "^0.5.75",
     "@opentui/core": "^0.1.82"
   },
   "devDependencies": {

package/scripts/release-changelog.ts

@@ -0,0 +1,32 @@
+// Runs as npm's `version` lifecycle hook (see package.json): at that point
+// package.json already carries the new version, and files staged here are
+// included in the release commit that `npm version` then creates and tags.
+import { readFileSync, writeFileSync } from "node:fs";
+
+const { version } = JSON.parse(readFileSync("package.json", "utf8"));
+const path = "CHANGELOG.md";
+const text = readFileSync(path, "utf8");
+
+const header = text.match(/^## Unreleased[ \t]*$/m);
+if (!header || header.index === undefined) {
+  console.error("CHANGELOG.md: no '## Unreleased' section — add one before releasing.");
+  process.exit(1);
+}
+
+const escaped = version.replace(/[.]/g, "\\.");
+if (new RegExp(`^## ${escaped}([^0-9]|$)`, "m").test(text)) {
+  console.error(`CHANGELOG.md: a '## ${version}' section already exists.`);
+  process.exit(1);
+}
+
+const afterHeader = text.slice(header.index + header[0].length);
+const nextSection = afterHeader.search(/^## /m);
+const unreleasedBody = nextSection === -1 ? afterHeader : afterHeader.slice(0, nextSection);
+if (!/^\s*[-*] /m.test(unreleasedBody)) {
+  console.error(`CHANGELOG.md: '## Unreleased' has no entries — nothing to release as ${version}.`);
+  process.exit(1);
+}
+
+const date = new Date().toISOString().slice(0, 10);
+writeFileSync(path, text.replace(header[0], `## Unreleased\n\n## ${version} — ${date}`));
+console.log(`CHANGELOG.md: cut Unreleased into '## ${version} — ${date}'.`);