harnery 0.32.0 → 0.33.0

package/dist/commands/init.js

@@ -141,6 +141,9 @@ export function registerInitCommand(program, emit, binName) {
             actions.push(`+ wired ${wired} hook(s), upgraded ${upgraded} stale command(s), and removed ` +
                 `${removed} legacy hook(s) in ${rel(projectRoot, settingsPath)} (${already} already present)`);
         }
+        const authorizationReview = codexHookReviewAction(adapter);
+        if (authorizationReview)
+            actions.push(authorizationReview);
         // ── 3. agent-facing instructions block + skills ────────────────────────
         // A misconfigured host addendum aborts here rather than half-writing: the
         // apply step validates the configured source before it touches a file, so
@@ -166,6 +169,13 @@ export function registerInitCommand(program, emit, binName) {
         emit.text(render(projectRoot, dryRun, actions, [...applied.warnings, ...gitHooks.warnings]));
     });
 }
+export function codexHookReviewAction(adapter) {
+    if (adapter !== "codex")
+        return null;
+    return ("! Codex authorizes hook commands separately. Before starting work, review them in " +
+        "the terminal UI with `/hooks` or in Codex Desktop under Settings > Hooks. " +
+        "After approval, start a fresh task so SessionStart can run.");
+}
 /**
  * Merge agent-hook entries into a adapter settings object in place, idempotently.
  * Preserves every existing hook; rewrites events already wired to

package/dist/commands/instructions.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+export declare function registerInstructionsCommand(program: Command, emit: EmitContext): void;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/commands/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/commands/instructions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAcnD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAmDrF"}

package/dist/commands/instructions.js

@@ -0,0 +1,100 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { countTokens } from "gpt-tokenizer/model/gpt-4o";
+import { monorepoRoot } from "../core/agents/index.js";
+import { buildInstructionBundle, } from "../lib/instructions/bundle.js";
+export function registerInstructionsCommand(program, emit) {
+    const command = program
+        .command("instructions")
+        .description("Inspect and version the repo-authored instruction bundle loaded by each adapter.");
+    command
+        .command("manifest [paths...]")
+        .description("Emit a machine-readable bundle manifest for one or more working paths")
+        .option("--adapter <adapter>", "claude-code, cursor, codex, or all", "all")
+        .option("--format <type>", "Output format: json or table", "json")
+        .option("-o, --output <file>", "Write the complete JSON manifest to a file")
+        .action((paths, options) => {
+        if (options.format === "json")
+            emit.config({ format: "json" });
+        const coordRoot = monorepoRoot() ?? process.cwd();
+        const adapters = parseAdapters(options.adapter);
+        const profiles = (paths.length > 0 ? paths : [process.cwd()]).flatMap((path) => adapters.map((adapter) => enrichBundle(buildInstructionBundle({ coordRoot, cwd: resolve(path), adapter }), coordRoot)));
+        const manifest = {
+            ok: true,
+            schema_version: 1,
+            generated_at: new Date().toISOString(),
+            source_commit: gitHead(coordRoot),
+            tokenizer: "o200k_base",
+            coord_root: ".",
+            profile_count: profiles.length,
+            profiles,
+        };
+        if (options.output) {
+            const output = resolve(options.output);
+            writeFileSync(output, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+            emit.data({
+                ok: true,
+                output,
+                schema_version: manifest.schema_version,
+                generated_at: manifest.generated_at,
+                source_commit: manifest.source_commit,
+                profile_count: manifest.profile_count,
+            });
+        }
+        else {
+            emit.data(manifest);
+        }
+    });
+}
+function parseAdapters(value) {
+    if (value === "all")
+        return ["claude-code", "cursor", "codex"];
+    if (value === "claude-code" || value === "cursor" || value === "codex")
+        return [value];
+    throw new Error(`unsupported adapter '${value}' (expected claude-code, cursor, codex, or all)`);
+}
+function enrichBundle(bundle, coordRoot) {
+    const components = bundle.components.map((component) => enrichComponent(component, coordRoot));
+    const canonicalSources = bundle.canonical_sources.map((component) => enrichComponent(component, coordRoot));
+    return {
+        ...bundle,
+        coord_root: ".",
+        components,
+        canonical_sources: canonicalSources,
+        totals: totals(components),
+        canonical_source_totals: totals(canonicalSources),
+    };
+}
+function enrichComponent(component, coordRoot) {
+    const bytes = readFileSync(resolve(coordRoot, component.path));
+    const text = bytes.includes(0) ? null : bytes.toString("utf8");
+    return {
+        ...component,
+        chars: text?.length ?? null,
+        tokens: text === null ? null : countTokens(text),
+    };
+}
+function totals(components) {
+    const roles = ["always_loaded", "just_in_time", "runtime_config"];
+    return {
+        files: components.length,
+        bytes: components.reduce((sum, component) => sum + component.bytes, 0),
+        tokens: components.reduce((sum, component) => sum + (component.tokens ?? 0), 0),
+        by_role: Object.fromEntries(roles.map((role) => {
+            const selected = components.filter((component) => component.role === role);
+            return [
+                role,
+                {
+                    files: selected.length,
+                    bytes: selected.reduce((sum, component) => sum + component.bytes, 0),
+                    tokens: selected.reduce((sum, component) => sum + (component.tokens ?? 0), 0),
+                },
+            ];
+        })),
+    };
+}
+function gitHead(root) {
+    const result = spawnSync("git", ["rev-parse", "HEAD"], { cwd: root, encoding: "utf8" });
+    return result.status === 0 ? result.stdout.trim() : null;
+}

package/dist/commands/presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA0BnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAwKjF"}
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AA0BnD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CA8KjF"}

package/dist/commands/presence.js

@@ -133,7 +133,10 @@ export function registerPresenceCommand(program, emit) {
             for (const a of m.agents) {
                 const task = a.task ? `  "${a.task.slice(0, 70)}"` : "";
                 const files = a.files_touched?.length ? `  [${a.files_touched.length} files]` : "";
-                emit.text(`  agent-${a.name ?? a.instance_id.slice(0, 8)}${task}${files}\n`);
+                const lifecycle = a.task_state === "blocked" && a.task_state_reason
+                    ? `${a.task_state}: ${a.task_state_reason}`
+                    : a.task_state;
+                emit.text(`  agent-${a.name ?? a.instance_id.slice(0, 8)}${task}${files}  activity=${a.activity} lifecycle=${lifecycle}\n`);
             }
         }
     });

package/dist/core/agents/canonical-emit.d.ts

@@ -28,7 +28,7 @@ export interface CanonicalEmitInput {
  * `agents status`, and no sequence of CLI commands can satisfy it.
  */
 export declare function resolveEmitRoot(start?: string): string | null;
-export declare function emitCanonical(input: CanonicalEmitInput): void;
+export declare function emitCanonical(input: CanonicalEmitInput): boolean;
 /**
  * Normalize the heartbeat's `platform` field to the canonical Adapter type.
  */

package/dist/core/agents/canonical-emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAsC7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG"}
+{"version":3,"file":"canonical-emit.d.ts","sourceRoot":"","sources":["../../../src/core/agents/canonical-emit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAwChE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAIjG"}

package/dist/core/agents/canonical-emit.js

@@ -26,10 +26,10 @@ export function resolveEmitRoot(start = process.cwd()) {
 export function emitCanonical(input) {
     const root = resolveEmitRoot();
     if (!root)
-        return;
+        return false;
     const binary = coordBinPath("agent-coord", root);
     if (!binary)
-        return;
+        return false;
     try {
         const args = [
             "emit-event",
@@ -62,10 +62,12 @@ export function emitCanonical(input) {
         if (result.error || result.status !== 0) {
             const why = result.error ? result.error.message : `exit ${result.status}`;
             process.stderr.write(`emitCanonical: ${input.type} emit failed (${why})\n`); // lint-ok-emission: soft-fail diagnostic promised by the module doc; silent drops cost blocked turns
+            return false;
         }
+        return true;
     }
     catch {
-        /* never break the caller */
+        return false;
     }
 }
 /**

package/dist/core/agents/cli.js

@@ -564,8 +564,11 @@ async function handlePromptContext(root, rest) {
     const sessionNameNudge = args["session-name-nudge"] === "true";
     const taskNudge = args["task-nudge"] === "true";
     const statusFooterNudge = args["status-footer-nudge"] === "true";
+    // Value is the adapter id; a bare flag (parsed as "true") still enables the
+    // reminder with the adapter-neutral wording.
+    const turnRitualNudge = args["turn-ritual-nudge"] === "true" ? "generic" : args["turn-ritual-nudge"];
     if (!instanceId) {
-        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--session-name-nudge] [--task-nudge] [--status-footer-nudge]\n");
+        process.stderr.write("agent-coord prompt-context --instance <id> [--session <id>] [--name <agent-name>] [--session-name-nudge] [--task-nudge] [--status-footer-nudge] [--turn-ritual-nudge <adapter>]\n");
         return 2;
     }
     const { renderPromptContext } = await import("./render/prompt-context.js");
@@ -577,6 +580,7 @@ async function handlePromptContext(root, rest) {
         sessionNameNudge,
         taskNudge,
         statusFooterNudge,
+        turnRitualNudge,
     });
     process.stdout.write(text);
     return 0;

package/dist/core/agents/coord-client.d.ts

@@ -40,16 +40,27 @@ export interface Heartbeat {
     task?: string;
     /** UTC ISO-8601 timestamp when task was last set/cleared. Used by adapters without Stop enforcement to compute staleness. 2026-05-24. */
     task_updated_at?: string | null;
+    /** Current evidence-derived activity axis. */
+    activity?: "unknown" | "working" | "needs_input" | "idle";
+    activity_updated_at?: string;
+    activity_source?: string;
+    /** Explicit task lifecycle axis. */
+    task_state?: "active" | "blocked" | "done";
+    task_state_updated_at?: string;
+    task_state_reason?: string;
     /** Session name built on the first non-empty set-task; its presence means "this session has been named". 2026-08-09. */
     suggested_session_name?: string;
     /** Stamped by turn.stop once the suggested name is seen in assistant reply text. 2026-08-09. */
     session_name_seen_at?: string;
+    /** Which suggested name the latest sighting covered. */
+    session_name_seen_for?: string;
     /** Auto-generated per-turn summary written by the Stop hook via Haiku. 2026-05-23. */
     turn_summary?: string | null;
     /** UTC ISO-8601 timestamp when turn_summary was last refreshed. */
     turn_summary_updated_at?: string | null;
     /** Hook client: `claude-code` (default) or `cursor`. Cursor Phase 1. */
     platform?: string;
+    workflow_run_id?: string;
 }
 /**
  * Resolve the monorepo root for coord-state purposes.

package/dist/core/agents/coord-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"coord-client.d.ts","sourceRoot":"","sources":["../../../src/core/agents/coord-client.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/index.d.ts

@@ -11,4 +11,5 @@
 export * from "./canonical-emit.js";
 export * from "./coord-client.js";
 export * from "./session-events.js";
+export * from "./state/session-state.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC"}

package/dist/core/agents/index.js

@@ -11,3 +11,4 @@
 export * from "./canonical-emit.js";
 export * from "./coord-client.js";
 export * from "./session-events.js";
+export * from "./state/session-state.js";

package/dist/core/agents/render/prompt-context.d.ts

@@ -43,6 +43,12 @@ export interface PromptContextOpts {
     /** When true, append the non-deduplicated Codex status-footer reminder.
      * The caller enables this only for human-facing Codex sessions. */
     statusFooterNudge?: boolean;
+    /** Adapter id whose Stop hook ENFORCES the end-of-turn ritual (task_set +
+     * status check). When set, append a fresh per-prompt reminder of that
+     * contract so the model satisfies it before ending the turn instead of
+     * being bounced into a retry. Not hash-deduped, same rationale as the
+     * status footer. */
+    turnRitualNudge?: string;
 }
 /**
  * Build the combined UserPromptSubmit additionalContext string. Returns "" when

package/dist/core/agents/render/prompt-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAqCH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;kFAC8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CA0CnE"}
+{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA0CH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;8EAC0E;IAC1E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;kFAC8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;uEACmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;wBAIoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAqDnE"}

package/dist/core/agents/render/prompt-context.js

@@ -45,7 +45,7 @@ import { formatPendingCouncils } from "./session-context.js";
  * councils are pending, matching the bash behavior).
  */
 export function renderPromptContext(opts) {
-    const { coordRoot, instanceId, sessionId, agentName, sessionNameNudge, taskNudge, statusFooterNudge, } = opts;
+    const { coordRoot, instanceId, sessionId, agentName, sessionNameNudge, taskNudge, statusFooterNudge, turnRitualNudge, } = opts;
     const sections = [];
     // 1. Peer table with hash dedup.
     const peerTable = computePeerTableIfChanged(coordRoot, instanceId, sessionId);
@@ -76,8 +76,32 @@ export function renderPromptContext(opts) {
         if (statusMsg)
             sections.push(statusMsg);
     }
+    // 5. Adapters whose Stop hook ENFORCES the turn ritual get a fresh reminder
+    // on every prompt. Reminding before the reply is drafted is far cheaper than
+    // the bounce-and-retry the Stop hook otherwise forces: enforcement-only
+    // compliance was measured missing on a double-digit share of turns. Not
+    // hash-deduped for the same reason as the Codex footer.
+    if (turnRitualNudge) {
+        const ritualMsg = renderTurnRitualReminder(coordRoot, instanceId, turnRitualNudge);
+        if (ritualMsg)
+            sections.push(ritualMsg);
+    }
     return sections.join("\n\n");
 }
+function renderTurnRitualReminder(coordRoot, selfInstanceId, adapter) {
+    const hb = readHeartbeat(join(coordRoot, ".harnery", "active", `${selfInstanceId}.json`));
+    if (!hb || hb.kind === "subagent" || hb.kind === "transient" || hb.workflow_run_id)
+        return "";
+    const bin = resolveBinName(coordRoot);
+    const statusCommand = endOfTurnStatusCommand(coordRoot);
+    // Claude Code renders the status box only if the reply carries it; Cursor
+    // shows the box inline on its own, so it is never asked for a second copy.
+    const paste = adapter === "claude-code"
+        ? " and paste its output verbatim in a fenced code block at the end of your reply"
+        : "";
+    return (`Turn ritual (Stop-enforced): on any turn that uses tools, run \`${bin} agents set-task "<short focus>"\` at some point during the turn (required every turn, even when the focus is unchanged; pass an empty string when there is no meaningful focus), then make \`${statusCommand}\` your final tool call${paste}. ` +
+        "A turn that ends without these is bounced by the Stop hook and costs a retry.");
+}
 function renderStatusFooterReminder(coordRoot, selfInstanceId) {
     const hb = readHeartbeat(join(coordRoot, ".harnery", "active", `${selfInstanceId}.json`));
     if (!hb || hb.kind === "subagent" || hb.kind === "transient" || hb.workflow_run_id)
@@ -116,13 +140,17 @@ function computeFocusNudgeIfChanged(coordRoot, selfInstanceId, opts) {
     let needsNudge = false;
     let message = "";
     let nudgeKind = "";
-    if (opts.sessionNameNudge && !hb.suggested_session_name) {
+    if (opts.sessionNameNudge &&
+        (!hb.suggested_session_name ||
+            (hb.session_name_seen_for !== undefined &&
+                hb.suggested_session_name !== hb.session_name_seen_for))) {
         // Keyed on "a name was ever produced", not task_updated_at: a bare clear
         // as the first declaration must not end the naming window.
         needsNudge = true;
         nudgeKind = "session-name";
-        message =
-            `This session has no name yet: run \`${bin} agents set-task "<2-5 word session topic>"\` as your first tool call. ` +
+        message = hb.suggested_session_name
+            ? `This session's lifecycle changed its suggested name. Reproduce this value by itself inside a fenced code block at the very top of your reply so the operator can one-click-copy it as the session/tab title: ${hb.suggested_session_name}`
+            : `This session has no name yet: run \`${bin} agents set-task "<2-5 word session topic>"\` as your first tool call. ` +
                 "When it returns `first_of_session: true`, reproduce its `suggested_session_name` value by itself inside a fenced code block at the very top of your reply so the operator can one-click-copy it as the session/tab title. " +
                 "Then continue with the task; that `set-task` also satisfies this turn's focus declaration.";
     }
@@ -204,6 +232,9 @@ function computePeerTableIfChanged(coordRoot, selfInstanceId, selfSessionIdFallb
         started_at: p.started_at ?? null,
         files_touched: Array.from(p.files_touched ?? []).sort(),
         platform: p.platform ?? null,
+        activity: p.activity ?? "unknown",
+        task_state: p.task_state ?? "active",
+        task_state_reason: p.task_state_reason ?? null,
     }))
         .sort((a, b) => (a.instance_id ?? "").localeCompare(b.instance_id ?? ""));
     // Remote basis: machine + per-agent identity/task/files (published_at is
@@ -214,6 +245,9 @@ function computePeerTableIfChanged(coordRoot, selfInstanceId, selfSessionIdFallb
             instance_id: a.instance_id,
             name: a.name ?? null,
             task: a.task ?? null,
+            activity: a.activity,
+            task_state: a.task_state,
+            task_state_reason: a.task_state_reason ?? null,
             files_touched: Array.from(a.files_touched ?? []).sort(),
         })),
     }));
@@ -393,6 +427,7 @@ function renderSubtable(rows, header, nowSec) {
 }
 function formatRow(r, nowSec) {
     const taskPart = r.task ? ` "${r.task.slice(0, 60)}"` : "";
+    const statePart = formatState(r);
     // Fall back started_at → last_heartbeat; if neither is a valid timestamp,
     // show "age unknown" rather than the epoch-derived "20608d ago" ghost.
     const startedSec = parseIsoSec(r.started_at) ?? parseIsoSec(r.last_heartbeat);
@@ -403,7 +438,13 @@ function formatRow(r, nowSec) {
     // Prefer a short instance_id over a bare "unknown" so an incomplete row is
     // still identifiable.
     const label = r.name ?? (r.instance_id ? r.instance_id.slice(0, 8) : "unknown");
-    return `  - agent-${label}${taskPart}   (${ageFrom}, ${filesPart}${lastActivity})${turnSummary}`;
+    return `  - agent-${label}${taskPart}   (${statePart}, ${ageFrom}, ${filesPart}${lastActivity})${turnSummary}`;
+}
+function formatState(r) {
+    const activity = r.activity ?? "unknown";
+    const lifecycle = r.task_state ?? "active";
+    const reason = lifecycle === "blocked" && r.task_state_reason ? `: ${r.task_state_reason.slice(0, 80)}` : "";
+    return `activity=${activity}, lifecycle=${lifecycle}${reason}`;
 }
 function fmtFiles(files) {
     if (files.length === 0)

package/dist/core/agents/render/session-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAyC,QAAQ,EAAE,MAAM,SAAS,CAAC;AAsB1E,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+BAC2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA6E7D;AA+ID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBvD;AAwDD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiDlF;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iBAAW,CAAC"}
+{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/render/session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAyC,QAAQ,EAAE,MAAM,SAAS,CAAC;AA0B1E,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;+BAC2B;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA6E7D;AAuJD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBvD;AAwDD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAiDlF;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,iBAAW,CAAC"}

package/dist/core/agents/render/session-context.js

@@ -101,7 +101,10 @@ function formatRemoteMachines(coordRoot) {
                 const files = a.files_touched?.length
                     ? `holds: ${a.files_touched.slice(0, 3).join(", ")}${a.files_touched.length > 3 ? `, +${a.files_touched.length - 3} more` : ""}`
                     : "nothing held";
-                lines.push(`  - agent-${a.name ?? a.instance_id.slice(0, 8)} @${m.machine}${task} (${files})`);
+                const reason = a.task_state === "blocked" && a.task_state_reason
+                    ? `: ${a.task_state_reason.slice(0, 80)}`
+                    : "";
+                lines.push(`  - agent-${a.name ?? a.instance_id.slice(0, 8)} @${m.machine}${task} (activity=${a.activity}, lifecycle=${a.task_state}${reason}, ${files})`);
             }
         }
         return `Sessions on other machines (advisory, via presence refs):\n${lines.join("\n")}`;
@@ -179,11 +182,14 @@ function renderSubtable(rows, header, nowSec) {
 }
 function formatRow(r, nowSec) {
     const taskPart = r.task ? ` "${r.task.slice(0, 60)}"` : "";
+    const activity = r.activity ?? "unknown";
+    const lifecycle = r.task_state ?? "active";
+    const reason = lifecycle === "blocked" && r.task_state_reason ? `: ${r.task_state_reason.slice(0, 80)}` : "";
     const ageFrom = fmtAge(nowSec - parseIsoSec(r.started_at));
     const filesPart = fmtFiles(r.display_files);
     const lastActivity = fmtLastActivity(r, nowSec);
     const turnSummary = r.turn_summary ? `\n    last turn: ${r.turn_summary.slice(0, 80)}` : "";
-    return `  - agent-${r.name ?? "unknown"}${taskPart}   (${ageFrom}, ${filesPart}${lastActivity})${turnSummary}`;
+    return `  - agent-${r.name ?? "unknown"}${taskPart}   (activity=${activity}, lifecycle=${lifecycle}${reason}, ${ageFrom}, ${filesPart}${lastActivity})${turnSummary}`;
 }
 function fmtFiles(files) {
     if (files.length === 0)

package/dist/core/agents/rules/stop-hook.js

@@ -222,18 +222,18 @@ export function evaluateStopHook(coordRoot, req) {
     // `session_name_present` (assistant-text-only transcript scan), mirroring
     // how rule 2/3 rides `status_box_present`.
     if (ackSignal === "status_box_present") {
-        const namingTaskSet = inTurn.find((e) => e.event_type === "state.task_set" &&
-            e.data.first_of_session === true &&
+        const namingEvent = inTurn.find((e) => ((e.event_type === "state.task_set" && e.data.first_of_session === true) ||
+            (e.event_type === "state.task_state" && e.data.name_reminted === true)) &&
             typeof e.data.suggested_session_name === "string" &&
             e.data.suggested_session_name.length > 0);
-        if (namingTaskSet) {
+        if (namingEvent) {
             // ANY in-window turn.stop with the flag satisfies the rule, not just the
             // latest: once seen, `session_name_seen_at` is stamped and later
             // turn.stops OMIT the field, so a later block on a different rule (whose
             // repair fires a fresh turn.stop) must not un-satisfy this one.
             const namePresent = inTurn.some((e) => e.event_type === "turn.stop" && e.data.session_name_present === true);
             if (!namePresent) {
-                return sessionNameBlock(String(namingTaskSet.data.suggested_session_name));
+                return sessionNameBlock(String(namingEvent.data.suggested_session_name));
             }
         }
     }

package/dist/core/agents/state/heartbeat-projector.d.ts

@@ -9,6 +9,7 @@
  * through the canonical event stream) survive each projector run.
  */
 import type { CanonicalEvent } from "../events/consume.js";
+import { type AgentActivity, type TaskState } from "./session-state.js";
 export interface V2Heartbeat {
     instance_id: string;
     session_id: string;
@@ -17,6 +18,10 @@ export interface V2Heartbeat {
     name?: string;
     kind?: "session" | "subagent" | "transient";
     model?: string;
+    instruction_bundle_id?: string;
+    instruction_source_id?: string;
+    instruction_profile_root?: string;
+    instruction_component_count?: number;
     platform?: string;
     subagent_call_id?: string;
     parent_session_id?: string;
@@ -30,6 +35,12 @@ export interface V2Heartbeat {
     last_tool_at?: string;
     task?: string;
     task_updated_at?: string;
+    activity?: AgentActivity;
+    activity_updated_at?: string;
+    activity_source?: string;
+    task_state?: TaskState;
+    task_state_updated_at?: string;
+    task_state_reason?: string;
     suggested_session_name?: string;
     session_name_seen_at?: string;
     session_name_seen_for?: string;

package/dist/core/agents/state/heartbeat-projector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-projector.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,CAAC,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,cAAc,EAAE,GAChC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAE,CAoD9D;AAsbD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"heartbeat-projector.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-projector.ts"],"names":[],"mappings":"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"}

package/dist/core/agents/state/heartbeat-projector.js

@@ -10,6 +10,7 @@
  */
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { applySessionStateEvent } from "./session-state.js";
 export function projectHeartbeats(coordRoot, events) {
     const perOwner = {};
     // Events that must NOT seed a heartbeat for an owner with no live file.
@@ -122,6 +123,13 @@ function apply(hb, ev, coordRoot) {
     hb.v2_meta.last_projected = new Date().toISOString();
     if (ev.turn_id)
         hb.last_turn_id = ev.turn_id;
+    const sessionState = applySessionStateEvent(hb, ev);
+    hb.activity = sessionState.activity;
+    hb.activity_updated_at = sessionState.activity_updated_at;
+    hb.activity_source = sessionState.activity_source;
+    hb.task_state = sessionState.task_state;
+    hb.task_state_updated_at = sessionState.task_state_updated_at;
+    hb.task_state_reason = sessionState.task_state_reason;
     const d = ev.data;
     switch (ev.event_type) {
         case "session.start":
@@ -131,6 +139,19 @@ function apply(hb, ev, coordRoot) {
                 const model = pickStr(d, "model");
                 if (model)
                     hb.model = model;
+                const instructionBundleId = pickStr(d, "instruction_bundle_id");
+                if (instructionBundleId)
+                    hb.instruction_bundle_id = instructionBundleId;
+                const instructionSourceId = pickStr(d, "instruction_source_id");
+                if (instructionSourceId)
+                    hb.instruction_source_id = instructionSourceId;
+                const instructionProfileRoot = pickStr(d, "instruction_profile_root");
+                if (instructionProfileRoot)
+                    hb.instruction_profile_root = instructionProfileRoot;
+                const instructionComponentCount = pickNum(d, "instruction_component_count");
+                if (instructionComponentCount !== undefined) {
+                    hb.instruction_component_count = instructionComponentCount;
+                }
                 const platform = pickStr(d, "platform") ?? adapterToPlatform(ev.adapter);
                 hb.platform = platform;
                 const name = pickStr(d, "name");
@@ -273,6 +294,20 @@ function apply(hb, ev, coordRoot) {
             }
             break;
         }
+        case "state.task_state": {
+            const suggested = pickStr(d, "suggested_session_name");
+            if (suggested && suggested !== hb.suggested_session_name) {
+                // Older heartbeats predate session_name_seen_for. A lifecycle re-mint
+                // still needs a mismatch the prompt and Stop paths can enforce, so
+                // attribute the prior title before replacing it. Ordinary legacy
+                // heartbeats remain quiet until a real lifecycle event changes them.
+                if (!hb.session_name_seen_for && hb.suggested_session_name) {
+                    hb.session_name_seen_for = hb.suggested_session_name;
+                }
+                hb.suggested_session_name = suggested;
+            }
+            break;
+        }
         case "state.status_checked":
             hb.last_status_at = ev.ts;
             break;
@@ -464,6 +499,10 @@ function writeHeartbeat(coordRoot, instanceId, hb) {
         setIfDefined(merged, "workflow_run_id", hb.workflow_run_id);
         setIfDefined(merged, "workflow_agent_id", hb.workflow_agent_id);
         setIfDefined(merged, "model", hb.model);
+        setIfDefined(merged, "instruction_bundle_id", hb.instruction_bundle_id);
+        setIfDefined(merged, "instruction_source_id", hb.instruction_source_id);
+        setIfDefined(merged, "instruction_profile_root", hb.instruction_profile_root);
+        setIfDefined(merged, "instruction_component_count", hb.instruction_component_count);
         setIfDefined(merged, "platform", hb.platform);
         setIfDefined(merged, "started_at", hb.started_at);
         // files_touched is a required-array invariant for every reader
@@ -477,6 +516,17 @@ function writeHeartbeat(coordRoot, instanceId, hb) {
         setIfDefined(merged, "last_tool_at", hb.last_tool_at);
         setIfDefined(merged, "task", hb.task);
         setIfDefined(merged, "task_updated_at", hb.task_updated_at);
+        setIfDefined(merged, "activity", hb.activity);
+        setIfDefined(merged, "activity_updated_at", hb.activity_updated_at);
+        setIfDefined(merged, "activity_source", hb.activity_source);
+        setIfDefined(merged, "task_state", hb.task_state);
+        setIfDefined(merged, "task_state_updated_at", hb.task_state_updated_at);
+        if (hb.task_state_reason) {
+            merged.task_state_reason = hb.task_state_reason;
+        }
+        else if (hb.task_state) {
+            delete merged.task_state_reason;
+        }
         setIfDefined(merged, "suggested_session_name", hb.suggested_session_name);
         setIfDefined(merged, "session_name_seen_at", hb.session_name_seen_at);
         if (hb.session_name_seen_for) {
@@ -525,3 +575,7 @@ function pickBool(o, k) {
     const v = o[k];
     return typeof v === "boolean" ? v : undefined;
 }
+function pickNum(o, k) {
+    const v = o[k];
+    return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}