@joenandez/academy 0.4.0-rc.1 → 0.4.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "academy",
   "description": "Academy v3 — portable AI agents.",
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0",
   "hooks": "./hooks/hooks.json"
 }

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 The heading at the top of this file is the version in `package.json`.
 
+## 0.4.0 — 2026-09-02
+
+First stable release.
+
+### Changed
+
+- **Stable registry channel.** `npm install -g @joenandez/academy` installs
+  the finished 0.4.0 release. Release checks can validate an explicit new
+  target while the previous candidate tag remains.
+- **Published guidance.** The README documents stable registry installation
+  and the enforced `threads.md` budget.
+
+### Fixed
+
+- **Memory bridge opt-in.** The observation bridge copies client observations
+  only when `ACADEMY_MEMORY_BRIDGE=1`. Session tracking and pending
+  consolidation remain active when the bridge is off.
+- **Bare-run scheduler stability.** A bare run leaves the saved runtime and
+  the existing nightly registration unchanged. An explicit runtime flag is
+  the only run action that changes them.
+- **Lifecycle recovery guidance.** The integration guide explains that an
+  archive or delete change can complete before an event-log failure. It tells
+  clients to recover with `list --json`.
+
 ## 0.4.0-rc.1 — 2026-08-31
 
 First release candidate, and the first Academy artifact that can be installed

package/README.md

@@ -10,8 +10,8 @@ against whatever project you are in. Every command also answers JSON, so a
 desktop app, a web service, or another CLI can render and manage agents without
 reading Academy's source.
 
-**Status: `0.4.0-rc.1`, contract version 1.** Academy is not on the npm registry
-yet. Install it from a checkout, as below.
+**Status: `0.4.0`, contract version 1.** The stable release is on npm.
+Install it with `npm install -g @joenandez/academy`.
 
 ## Requirements
 
@@ -26,6 +26,10 @@ yet. Install it from a checkout, as below.
 ## Install
 
 ```bash
+# Stable release install
+npm install -g @joenandez/academy
+
+# Contributor checkout
 git clone https://github.com/joenandez/academy.git
 cd academy
 npm link          # makes `academy` available globally
@@ -73,7 +77,7 @@ every `academy run` compile them into
 | `knowledge.md` | Domain expertise, frameworks, patterns | ~1500–2500 |
 | `goals.md` | Strategic objectives (cap 3) | ~150 |
 | `priorities.md` | Weekly direction (3–5 visible) | ~250 |
-| `threads.md` | Active work pursuits | ~700 |
+| `threads.md` | Active work pursuits | ~1750 |
 | `notes.md` | Micro-steering staging area | ~500 |
 | `dailys.md` | Last 7 working days | ~1000 |
 
@@ -133,7 +137,7 @@ The shape in one line: success is JSON on stdout with exit 0, failure is JSON on
 stderr with exit 1, and exit status is 0 if and only if `ok` is true.
 
 ```json
-{ "contract_version": 1, "ok": true, "command": "doctor", "version": "0.4.0-rc.1" }
+{ "contract_version": 1, "ok": true, "command": "doctor", "version": "0.4.0" }
 ```
 
 Academy ships a conformance suite for client authors. It imports no Academy

package/docs/integration-guide.md

@@ -588,6 +588,12 @@ Every published command except `unarchive` answers `agent_archived` for it — i
 is never reported as missing, because a client told an archived specialist does
 not exist would offer to hire a replacement for somebody who is still there.
 
+**Committed-mutation failure.** Academy moves the directory before it appends
+the lifecycle event. If `archive --json` answers `log_corrupt` or
+`internal_error`, the move can already have landed. Recover with one
+`academy list --json` call and replace the client roster and watermark from that
+response.
+
 Errors: `invalid_name`, `agent_not_found`, `agent_archived`,
 `not_academy_owned`, `agent_exists`, `unsafe_agent_path`,
 `runtime_unavailable`, `unschedule_failed`, `log_corrupt`, `lock_timeout`.
@@ -635,6 +641,12 @@ agent that no longer exists. If it cannot be put back because the slot has been
 refilled, the answer is `unschedule_failed_restore_blocked` and the `error`
 object names the `quarantine` path an operator must recover by hand.
 
+**Committed-mutation failure.** Academy removes the quarantined directory before
+it appends the lifecycle event. If `delete --json` answers `log_corrupt` or
+`internal_error`, the removal can already have landed. Recover with one
+`academy list --json` call and replace the client roster and watermark from that
+response.
+
 Errors: `invalid_name`, `agent_not_found`, `agent_archived`,
 `not_academy_owned`, `unsafe_agent_path`, `runtime_unavailable`,
 `unschedule_failed`, `unschedule_failed_restore_blocked`, `log_corrupt`,
@@ -723,6 +735,10 @@ code.
 `internal_error` is the floor and can answer any command. The other fourteen
 are raised only by the commands whose sections list them in §5.
 
+For `archive` and `delete`, `log_corrupt` or `internal_error` can follow a
+committed directory move or removal. Use `list --json` as the atomic roster and
+watermark recovery call described in §8.
+
 **Handling guidance.** `agent_not_found`, `agent_exists`, `invalid_name`,
 `agent_archived` and `invalid_spec` are user-facing and should be rendered as
 such. `unsafe_agent_path`, `runtime_unavailable`, `log_corrupt`, `lock_timeout`

package/hooks/sync_memory.mjs

@@ -19,7 +19,9 @@ export function syncAcademyMemory(payload, env = process.env) {
   // agent still consolidates when the memory bridge is unavailable.
   if (env.ACADEMY_NIGHTLY_RUN !== '1') markPendingConsolidation(memoryDir);
 
-  return { synced: syncBridgeObservations(env, observationsDir, sessionId) };
+  const synced =
+    env.ACADEMY_MEMORY_BRIDGE === '1' ? syncBridgeObservations(env, observationsDir, sessionId) : 0;
+  return { synced };
 }
 
 if (isMainModule(import.meta.url)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joenandez/academy",
-  "version": "0.4.0-rc.1",
+  "version": "0.4.0",
   "description": "Academy v3 — portable AI agents with 8 boot surfaces and a skills primitive.",
   "type": "module",
   "bin": {

package/scripts/cli/run.mjs

@@ -81,8 +81,8 @@ function prepareAgentRun(name, requestedRuntime, passthrough) {
       ? { ...writeCodexProfile(dir, name), runtimeContextPath: codexRuntimeContextPath() }
       : undefined;
   if (codex) writeCodexHooks(codex.runtimeContextPath);
-  const nightlyTask = registerNightlyConsolidationTask(dir, name);
-  if (!nightlyTask.registered && process.env.ACADEMY_SKIP_NIGHTLY_TASK !== '1') {
+  const nightlyTask = requestedRuntime ? registerNightlyConsolidationTask(dir, name) : null;
+  if (nightlyTask && !nightlyTask.registered && process.env.ACADEMY_SKIP_NIGHTLY_TASK !== '1') {
     console.error(
       `Warning: nightly consolidation job "${nightlyTask.id}" not updated: ${nightlyTask.reason}`,
     );