.o. oooo .o88o. .o8
 .888. `888 888 `" "888
 .8"888. 888 o888oo oooo d8b .ooooo. .oooo888
 .8' `888. 888 888 `888""8P d88' `88b d88' `888
 .88ooo8888. 888 888 888 888ooo888 888 888
 .8' `888. 888 888 888 888 .o 888 888
o88o o8888o o888o o888o d888b `Y8bod8P' `Y8bod88P"

"Why do we fall, Bruce?"

"So we can retry({ backoff: 'exponential', jitter: 'decorrelated' })."

Resilience patterns for async operations. Tuff 'nuff for most stuff.

This repository contains the Alfred package ecosystem. Each package is published independently, but the entire ecosystem shares a single version number so you never have to guess which versions are compatible.

Alfred is a policy engine for async resilience: composable, observable, testable — and eventually operable (live-tunable by ID without redeploy).

v0.10.2 (2026年02月06日) — Audit-first command pipeline + auth hooks for the control plane.

• @git-stunts/alfred: npm JSR
• @git-stunts/alfred-live: npm JSR

• @git-stunts/alfred — Resilience policies and composition utilities for async operations.
• @git-stunts/alfred-live — Control plane primitives, live policy plans, and the alfredctl CLI.

• All packages use the same version (for example, 0.8.0).
• A release bumps every package even if only one changed.
• The goal is zero version-mismatch ambiguity across the ecosystem.

1. Run tests:

pnpm test

2. Bump the version across all packages:

pnpm release:patch
# or
pnpm release:minor
# or
pnpm release:major

3. Publish (runs changelog aggregation and preflight checks first):

pnpm release:publish

See ROADMAP.md for upcoming milestones and package ownership.

See COOKBOOK.md for practical setup recipes.

The publish flow runs release:preflight, which verifies:

• All package versions match.
• jsr.json versions match package.json.
• package.json exports exist on disk and are included in files.
• jsr.json exports match package.json exports.
• pnpm install --frozen-lockfile succeeds (lockfile matches specs).
• npm pack --dry-run succeeds for each published package.

• alfred/ — Core package
• alfred-live/ — Control plane package
• scripts/release/ — Release tooling

Apache-2.0 © 2026 by James Ross

_{Built by FLYING•ROBOTS}