nyldn/claude-octopus v9.22.0

v9.22.0 — Memory contract, Gemini fallback, output cap, doctor smoke fix

on GitHub

What's new

Added

• Memory provider contract (scripts/lib/memory.sh) — unified façade over claude-mem and mcp-memory-service backends. Callers use memory_search, memory_observe, memory_context, memory_available. Auto-detects mcp-memory-service by scanning mcpServers config — detection never spawns uvx speculatively (avoids accidental Torch/CUDA pull). Env overrides: OCTOPUS_MEMORY_BACKEND, OCTOPUS_MEMORY_SCOPE, OCTOPUS_MEMORY_SEARCH_MERGE. Closes #220 discussion.
• Gemini in-band model fallback (scripts/helpers/gemini-exec.sh) — on 404 / ModelNotFoundError, retries with next entry in OCTOPUS_GEMINI_FALLBACK_MODELS (default: gemini-2.5-flash). Transient errors (429, 5xx) are not retried. Stdin cached to tempfile so replay works across attempts. Configurable via OCTOPUS_GEMINI_FALLBACK_QUIET.
• Agent output cap — run_agent_sync truncates at OCTOPUS_AGENT_MAX_OUTPUT_BYTES (default 256 KiB, set to 0 to disable). Tail-biased: preserves first 4 KiB + last ~252 KiB so Codex-style deliverable summaries survive.
• Partial-writes diagnostic on timeout — when dispatch exits 124/143, surfaces files written before SIGTERM so users know completed work exists. Skips silently on macOS BSD find.

Fixed

• doctor smoke silently aborting — five converging defects resolved:
  1. ((var++)) under set -eo pipefail — changed to ((++var))
  2. Double shift in orchestrate.sh discarded the smoke category arg
  3. Codex 0.120.0 rejects prompt as positional arg — now piped via stdin
  4. Gemini cold-start exceeded hardcoded 10s timeout — OCTOPUS_GEMINI_SMOKE_TIMEOUT (default 30s)
  5. Concurrent-write race corrupted /tmp/octo-model-cache-*.json — self-heals via jq -cse
• Scheduler version hardcoded to v8.16.0 — 7 major versions stale. New octopus_plugin_version() reads from plugin.json at runtime. validate-release.sh warns when no git tag matches current version.

Changed

• session.sh routes phase-completion observations through memory_observe instead of calling claude-mem-bridge.sh directly — existing claude-mem deployments unaffected.
• README update/reinstall steps include marketplace update / marketplace remove to prevent stale cache.
• CI: actions/github-script v8 → v9.

Upgrading

claude plugin marketplace update https://github.com/nyldn/claude-octopus.git
claude plugin update octo