ai-foreman 1.7.10 → 1.7.11

package/README.md

@@ -15,9 +15,9 @@ Loop Claude Code or Codex through tickets.
 - **Rich ticket system** — tickets carry acceptance criteria, required tests, dependencies, priority, size, and risk level. The agent reads the full context before starting each step.
 - **Future work tracking** — when the builder discovers out-of-scope work during a run, `ai-foreman tickets discover` captures it without derailing the current ticket. Discovered items live in a separate inbox until you promote them.
 - **QA that actually gates** — QA runs after every completed ticket and checks code quality, test passing, and regression protection. The ticket only closes after QA passes. QA turns do not count against `--steps`.
-- **Visible long-running work** — one elapsed-time activity line identifies provider, phase, tools, retries, and quiet periods; redirected output receives timestamped heartbeats instead of ANSI animation.
+- **Visible long-running work** — semantic activity rows identify provider, phase, tools, retries, and quiet periods; cursor-capable terminals update changing counters in place, while record-oriented terminals coalesce them.
 
-Provider-managed retries are reported immediately as durable lines. A quiet-provider warning appears after 60 seconds without a signal, but Foreman does not add retries, abort the provider, or change provider retry limits. Non-TTY output receives a heartbeat every 30 seconds while work remains pending.
+Provider-managed retries are reported immediately as durable lines. A quiet-provider warning appears after 60 seconds without a signal, but Foreman does not add retries, abort the provider, or change provider retry limits. Non-TTY output receives a heartbeat every 30 seconds while work remains pending. TTY rendering defaults to automatic detection: Codex, CI, and `TERM=dumb` use newline records and suppress spinner- or number-only repeats; other terminals redraw those changes in place and retain a row when the textual status changes. Use `RAFI_ACTIVITY_RENDER_MODE=auto|cursor|records` to override detection.
 
 ## Install
 
@@ -146,7 +146,7 @@ Saved `tickets.build` defaults in `rafi-config.yaml` can enable branch-per-ticke
 
 With the saved `current` strategy, Foreman works in the active branch while the user owns Git. It may edit, test, run QA, and update tracker/recovery state, but all branch/worktree, commit, push, merge, rebase, and review lifecycle commands are fenced. An unexpected active ref or worktree change pauses the run. Explicit isolated flags are reported as run overrides.
 
-The active terminal line always includes the current role/provider, activity, truthful context state, successful compaction count, and handoff generation. At the Builder threshold, Foreman settles the in-flight action, verifies native compaction plus a fresh provider usage sample, and resumes the frozen action. The configured maximum defaults to ten successful compactions per location-scoped provider session; the next crossing uses a validated fresh handoff instead of exceeding it. Disposable QA snapshots never reuse a prior QA conversation in a new `/tmp/rafi-qa-*` worktree; they transfer cumulative state through an accepted handoff.
+The current terminal status includes the role/provider, activity, truthful context state, successful compaction count, and handoff generation. At the Builder threshold, Foreman settles the in-flight action, verifies native compaction plus a fresh provider usage sample, and resumes the frozen action. The configured maximum defaults to ten successful compactions per location-scoped provider session; the next crossing uses a validated fresh handoff instead of exceeding it. Disposable QA snapshots never reuse a prior QA conversation in a new `/tmp/rafi-qa-*` worktree; they transfer cumulative state through an accepted handoff.
 
 ### GitHub PR Failure Recovery
 

package/dist/activity.d.ts

@@ -11,7 +11,10 @@ export interface ActivityReporterOptions {
     tickMs?: number;
     heartbeatMs?: number;
     quietWarningMs?: number;
+    /** Override automatic TTY capability detection for tests or embedding hosts. */
+    ttyMode?: ActivityTtyMode;
 }
+export type ActivityTtyMode = "auto" | "cursor" | "records";
 /** One process-local live view shared by nested RAFI operations. */
 export declare class ActivityReporter {
     readonly command: string;
@@ -21,6 +24,7 @@ export declare class ActivityReporter {
     private readonly tickMs;
     private readonly heartbeatMs;
     private readonly quietWarningMs;
+    private readonly ttyMode;
     private readonly commandStartedAt;
     private readonly phases;
     private nextPhaseId;
@@ -33,6 +37,7 @@ export declare class ActivityReporter {
     private quietWarningPrinted;
     private lastHeartbeatAt;
     private lineVisible;
+    private lastSemanticKey?;
     private paused;
     private agentStatusLine?;
     constructor(command: string, options?: ActivityReporterOptions);
@@ -45,7 +50,7 @@ export declare class ActivityReporter {
     pulse(detail?: string): void;
     note(message: string): void;
     writePersistent(text: string): void;
-    /** Keep role/provider/context state in the single bottom-most TTY line. */
+    /** Keep role/provider/context state attached to the current activity status. */
     setAgentStatus(line: string | undefined): void;
     pause(): () => void;
     dispose(): void;

package/dist/activity.js

@@ -10,6 +10,7 @@ export class ActivityReporter {
     tickMs;
     heartbeatMs;
     quietWarningMs;
+    ttyMode;
     commandStartedAt;
     phases = new Map();
     nextPhaseId = 1;
@@ -22,6 +23,7 @@ export class ActivityReporter {
     quietWarningPrinted = false;
     lastHeartbeatAt = 0;
     lineVisible = false;
+    lastSemanticKey;
     paused = 0;
     agentStatusLine;
     constructor(command, options = {}) {
@@ -35,6 +37,7 @@ export class ActivityReporter {
         this.tickMs = options.tickMs ?? 1_000;
         this.heartbeatMs = options.heartbeatMs ?? 30_000;
         this.quietWarningMs = options.quietWarningMs ?? 60_000;
+        this.ttyMode = resolveTtyMode(options.ttyMode);
         this.commandStartedAt = this.now();
     }
     begin(label) {
@@ -91,7 +94,7 @@ export class ActivityReporter {
             this.output.write("\n");
         this.render(true);
     }
-    /** Keep role/provider/context state in the single bottom-most TTY line. */
+    /** Keep role/provider/context state attached to the current activity status. */
     setAgentStatus(line) {
         this.agentStatusLine = line ? clean(line, 500) : undefined;
         if (this.agentStatusLine && !this.timer) {
@@ -130,7 +133,6 @@ export class ActivityReporter {
     }
     idle() {
         if (this.agentStatusLine) {
-            this.clearLine();
             this.detail = undefined;
             this.provider = undefined;
             this.model = undefined;
@@ -145,6 +147,7 @@ export class ActivityReporter {
         this.provider = undefined;
         this.model = undefined;
         this.agentStatusLine = undefined;
+        this.lastSemanticKey = undefined;
     }
     currentPhase() {
         return [...this.phases.values()].at(-1);
@@ -168,8 +171,21 @@ export class ActivityReporter {
         const body = [phase?.label, provider || undefined, phase ? quiet : undefined, this.agentStatusLine].filter(Boolean).join(" — ");
         if (this.output.isTTY) {
             const line = `${FRAMES[this.frame++ % FRAMES.length]} RAFI working: ${body} (${formatDuration(now - this.commandStartedAt)})`;
+            const semanticKey = semanticStatusKey(body);
+            if (this.ttyMode === "records") {
+                if (semanticKey === this.lastSemanticKey)
+                    return;
+                this.output.write(`${line}\n`);
+                this.lastSemanticKey = semanticKey;
+                return;
+            }
+            if (this.lineVisible && semanticKey !== this.lastSemanticKey) {
+                this.output.write("\n");
+                this.lineVisible = false;
+            }
             this.output.write(`\r\x1b[2K${line}`);
             this.lineVisible = true;
+            this.lastSemanticKey = semanticKey;
             return;
         }
         if (force || now - this.lastHeartbeatAt >= this.heartbeatMs) {
@@ -260,6 +276,27 @@ function briefInput(input) {
 function clean(value, maximum) {
     return value.replace(/[\r\n\t]+/g, " ").replace(/\s+/g, " ").trim().slice(0, maximum);
 }
+function semanticStatusKey(body) {
+    return body.replace(/\p{Number}+(?:[.,]\p{Number}+)*/gu, "#");
+}
+function resolveTtyMode(requested) {
+    const configured = requested ?? configuredTtyMode(process.env.RAFI_ACTIVITY_RENDER_MODE);
+    if (configured === "cursor" || configured === "records")
+        return configured;
+    return truthyEnvironmentValue(process.env.CODEX_CI)
+        || truthyEnvironmentValue(process.env.CI)
+        || process.env.TERM?.toLowerCase() === "dumb"
+        ? "records"
+        : "cursor";
+}
+function configuredTtyMode(value) {
+    return value === "cursor" || value === "records" || value === "auto" ? value : "auto";
+}
+function truthyEnvironmentValue(value) {
+    if (value === undefined)
+        return false;
+    return !["", "0", "false"].includes(value.trim().toLowerCase());
+}
 function formatDuration(milliseconds) {
     const seconds = Math.max(0, Math.floor(milliseconds / 1_000));
     if (seconds < 60)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.7.10",
+  "version": "1.7.11",
   "description": "An orchestrator that keeps Codex CLI / Claude Code builders moving through their step list unattended. Part of Rafi.",
   "license": "Apache-2.0",
   "type": "module",