Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

M21: CI matrix tightening + bin/regen-hooks generator

AkitaOnRails2d262010afe9
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 02a07563..991f18d2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -32,14 +32,56 @@ jobs:
- run: cargo clippy --workspace --all-targets -- -D warnings
test:
- name: test
- runs-on: ubuntu-latest
+ name: test (${{ matrix.os }})
+ strategy:
+ fail-fast: false
+ matrix:
+ # macOS catches stat / SELinux / case-sensitivity assumptions
+ # that wouldn't show up on a Linux-only matrix. Stays in step
+ # with the homelab deploy which is Linux.
+ os: [ubuntu-latest, macos-latest]
+ runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- uses: dtolnay/rust-toolchain@stable
- uses: Swatinem/rust-cache@v2
- run: cargo test --workspace --all-targets
+ # Build the release binary on its own so a release-only failure
+ # (LTO crash, codegen issue, dead-code-with-debug-assertions) doesn't
+ # ship to Docker Hub silently.
+ release-build:
+ name: cargo build --release
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v4
+ - uses: dtolnay/rust-toolchain@stable
+ - uses: Swatinem/rust-cache@v2
+ - run: cargo build --release --bin ai-memory
+
+ # End-to-end docker smoke: builds the published image and confirms
+ # the binary inside runs. Catches Dockerfile drift (missing COPY,
+ # bad ENTRYPOINT) before it lands in production.
+ docker-smoke:
+ name: docker image smoke
+ runs-on: ubuntu-latest
+ needs: release-build
+ steps:
+ - uses: actions/checkout@v4
+ - uses: docker/setup-buildx-action@v3
+ - name: build image (local tag only)
+ run: docker build -f docker/Dockerfile -t ai-memory:ci .
+ - name: --version smoke
+ run: docker run --rm ai-memory:ci --version
+ - name: bundled hooks present
+ run: docker run --rm --entrypoint sh ai-memory:ci -c "ls /usr/local/share/ai-memory/hooks/"
+ - name: --help lists the v0.3 subcommands
+ run: |
+ out=$(docker run --rm ai-memory:ci --help)
+ for sub in bootstrap install-mcp install-hooks setup-agent generate-auth-token; do
+ echo "$out" | grep -q "$sub" || { echo "missing subcommand: $sub"; exit 1; }
+ done
+
deny:
name: cargo-deny
runs-on: ubuntu-latest
diff --git a/bin/regen-hooks b/bin/regen-hooks
new file mode 100755
index 00000000..18dd23b3
--- /dev/null
+++ b/bin/regen-hooks
@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# Regenerate every hook script under hooks/*/*.sh.
+#
+# The 21 hook scripts (3 agents × 7 events) are nearly identical —
+# only the `event=` query string and the agent name in comments
+# differ. Maintaining them by hand drifts; this script is the single
+# source of truth.
+#
+# Adding a new lifecycle event:
+# 1. Add a row to the EVENTS array below.
+# 2. Add the matching variant to CLAUDE_CODE_EVENTS in
+# crates/ai-memory-cli/src/commands/render_shared.rs
+# (keep them in sync — the Rust constant drives the install-hooks
+# JSON config, this script drives the on-disk scripts).
+# 3. Run `bin/regen-hooks`.
+# 4. Commit both changes together.
+#
+# Run from anywhere; resolves the repo root from $0.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+HOOKS_DIR="$ROOT/hooks"
+
+# Map: agent dir → agent= query string the server expects.
+declare -A AGENT_QUERY=(
+ [claude-code]="claude-code"
+ [codex]="codex"
+ [opencode]="open-code"
+)
+
+# Map: agent dir → human-readable name used in script comments.
+declare -A AGENT_LABEL=(
+ [claude-code]="Claude Code"
+ [codex]="codex"
+ [opencode]="opencode"
+)
+
+# Each row: (filename-no-extension, event-query-value). Keep in sync
+# with crates/ai-memory-cli/src/commands/render_shared.rs.
+EVENTS=(
+ "session-start:session-start"
+ "user-prompt-submit:user-prompt"
+ "pre-tool-use:pre-tool-use"
+ "post-tool-use:post-tool-use"
+ "pre-compact:pre-compact"
+ "stop:stop"
+ "session-end:session-end"
+)
+
+write_simple_hook() {
+ local dir=$1 event_file=$2 event_q=$3
+ local agent_q="${AGENT_QUERY[$dir]}"
+ local agent_label="${AGENT_LABEL[$dir]}"
+ cat > "$HOOKS_DIR/$dir/$event_file.sh" <<EOF
+#!/bin/sh
+# $agent_label $event_q hook.
+# Forwards the event JSON to the ai-memory server. Adds an
+# Authorization: Bearer header when AI_MEMORY_AUTH_TOKEN is set in
+# this hook's environment (set it via install-hooks --auth-token).
+SERVER="\${AI_MEMORY_HOOK_URL:-http://127.0.0.1:49374}"
+post_hook() {
+ if [ -n "\${AI_MEMORY_AUTH_TOKEN:-}" ]; then
+ curl -s --max-time 0.5 -X POST "\$1" \\
+ -H "Content-Type: application/json" \\
+ -H "Authorization: Bearer \$AI_MEMORY_AUTH_TOKEN" \\
+ --data-binary @-
+ else
+ curl -s --max-time 0.5 -X POST "\$1" \\
+ -H "Content-Type: application/json" \\
+ --data-binary @-
+ fi
+}
+post_hook "\$SERVER/hook?event=$event_q&agent=$agent_q" >/dev/null 2>&1 || true
+exit 0
+EOF
+}
+
+write_session_start_hook() {
+ local dir=$1
+ local agent_q="${AGENT_QUERY[$dir]}"
+ local agent_label="${AGENT_LABEL[$dir]}"
+ cat > "$HOOKS_DIR/$dir/session-start.sh" <<EOF
+#!/bin/sh
+# $agent_label SessionStart hook.
+#
+# 1. Forwards the event JSON to the ai-memory server (fire-and-forget).
+# 2. Synchronously fetches any pending cross-agent handoff and prints
+# it to stdout — agent CLIs prepend session-start hook stdout to
+# the next session, so the resuming agent sees prior context with
+# no human in the loop.
+#
+# Both calls carry an Authorization: Bearer header when
+# AI_MEMORY_AUTH_TOKEN is set in this hook's environment.
+SERVER="\${AI_MEMORY_HOOK_URL:-http://127.0.0.1:49374}"
+PAYLOAD=\$(cat)
+
+post_hook() {
+ if [ -n "\${AI_MEMORY_AUTH_TOKEN:-}" ]; then
+ curl -s --max-time 0.5 -X POST "\$1" \\
+ -H "Content-Type: application/json" \\
+ -H "Authorization: Bearer \$AI_MEMORY_AUTH_TOKEN" \\
+ --data-binary @-
+ else
+ curl -s --max-time 0.5 -X POST "\$1" \\
+ -H "Content-Type: application/json" \\
+ --data-binary @-
+ fi
+}
+
+get_handoff() {
+ if [ -n "\${AI_MEMORY_AUTH_TOKEN:-}" ]; then
+ curl -s --max-time 1.0 "\$1" \\
+ -H "Authorization: Bearer \$AI_MEMORY_AUTH_TOKEN"
+ else
+ curl -s --max-time 1.0 "\$1"
+ fi
+}
+
+echo "\$PAYLOAD" | post_hook "\$SERVER/hook?event=session-start&agent=$agent_q" >/dev/null 2>&1 || true
+get_handoff "\$SERVER/handoff?agent=$agent_q" 2>/dev/null || true
+exit 0
+EOF
+}
+
+written=0
+for dir in claude-code codex opencode; do
+ mkdir -p "$HOOKS_DIR/$dir"
+ for row in "${EVENTS[@]}"; do
+ IFS=':' read -r event_file event_q <<< "$row"
+ case "$event_file" in
+ session-start)
+ write_session_start_hook "$dir"
+ ;;
+ *)
+ write_simple_hook "$dir" "$event_file" "$event_q"
+ ;;
+ esac
+ written=$((written + 1))
+ done
+done
+
+chmod +x "$HOOKS_DIR"/*/*.sh
+
+echo "✓ Regenerated $written hook scripts across $(ls "$HOOKS_DIR" | wc -l) agents."
+echo " Verify the change: git diff hooks/"
+echo " Restore on regret: git restore hooks/"