agent-afk 5.306.1 → 5.306.2

package/README.md

@@ -26,6 +26,9 @@ npm install -g agent-afk    # Node 22.22.2+, 24.15+, or 26+
 afk login                   # authenticate (auto-detects Claude Code / Codex creds)
 afk doctor                  # verify everything works
 afk chat "hello"             # first real conversation
+
+# Preview a behaviour change before applying it
+afk whatif --append "Always ask a clarifying question before using tools." --verify
 ```
 
 That's it. You're in.
@@ -50,6 +53,12 @@ Codex imports use `CODEX_HOME` when set (otherwise `~/.codex`) and also discover
 - **Cross-session memory** — Claude remembers preferences, decisions, and procedures across runs. See [Memory](#memory) below.
 - **Background subagent jobs** — dispatch a subagent with `mode:'background'`; results auto-deliver into the model's context when they finish. `/bgsub` lists running and completed jobs, `/bgsub:join <id>` replays a result manually.
 
+## What only afk does
+
+**`/whatif` behavioural impact predictor.** Before changing a prompt, model, skill, or memory rule, predict how the agent's behaviour will shift without touching your real config. Run `afk whatif --append "Always ask first." --verify` and the engine diffs the system prompts, predicts labelled behaviour shifts, then optionally verifies empirically by running sandboxed episodes and measuring rates. No real writes happen during the run. Source: `src/whatif/`, `docs/whatif.md`.
+
+**Jev calibrated judgment.** Jev is an external cross-family judge you configure as an MCP server in `~/.afk/config/mcp.json`. When present, `afk whatif --judge auto` selects Jev to grade verification episodes; it returns calibrated probabilities and removes Anthropic self-preference bias in verdicts. Falls back to Claude when Jev is not configured. Use `--judge claude` to keep all episode data within Anthropic. Source: `src/whatif/judge/jev-connect.ts`, `docs/whatif.md`.
+
 ## How it compares
 
 | | Claude Code | Agent AFK |

package/dist/agent/plugins/checkout-lifecycle.d.ts

@@ -0,0 +1,26 @@
+import type { ParsedSource } from './source.js';
+import * as git from './git.js';
+export declare function isLink(path: string): boolean;
+export declare function removeDest(dest: string): void;
+export declare function defaultGitName(parsed: Extract<ParsedSource, {
+    type: 'git' | 'github';
+}>): string;
+export declare function hasNonDefaultRef(dest: string, ref: string, gitOpts: git.GitOptions): Promise<boolean>;
+export interface CheckoutResult {
+    targetRef: string;
+    commit: string;
+    changed: boolean;
+    pickedSemverTag: boolean;
+    checkoutRef: string;
+}
+export interface AdvanceCachedCheckoutOptions {
+    explicitRef?: string;
+    storedRef: string | null | undefined;
+    pinnedRef: boolean | undefined;
+    isPinned: (defaultBranch: string) => boolean;
+}
+export declare function advanceCachedCheckout(dir: string, opts: AdvanceCachedCheckoutOptions, gitOpts: git.GitOptions, label: string, name: string): Promise<CheckoutResult>;
+export declare function prepareCachedCheckout(dest: string, explicitRef: string | undefined, gitOpts: git.GitOptions): Promise<{
+    ref: string;
+    commit: string;
+}>;