bareloop 0.37.0 → 0.39.0

package/types/legs.d.ts

@@ -56,6 +56,18 @@ export function watchdogNotePath(spineFile: string, leg: number): string;
  * @returns {string}
  */
 export function stopFilePath(spineFile: string): string;
+/**
+ * Did a run (or one leg) END on a cap? The ONE spelling of the rule every surface follows (hamr 2026-10-08): the
+ * outcome is `cap-halt` / `wall-halt`, or it is `escalated` and the last escalation's category names the cap —
+ * `wall-halt`, or `cap-halt` backed by a `money-halt` record (a strike-ladder `cap-halt` is not the money cap).
+ * @param {{outcome: string|null|undefined, category?: string|null, moneyHalt?: boolean}} o
+ * @returns {'money'|'time'|null}
+ */
+export function capKindOf(o: {
+    outcome: string | null | undefined;
+    category?: string | null;
+    moneyHalt?: boolean;
+}): "money" | "time" | null;
 /** The marker record's `type`. */
 export const LEG_RESUME: "leg-resume";
 export type Leg = {

package/types/panel/authorsession.d.ts

@@ -9,6 +9,20 @@ export function latestStep(steps: StepLine[], id: string): StepLine | undefined;
  * @param {StepLine[]} steps @param {string} id @param {string} [detail] (absent = keep what the line has)
  */
 export function advanceSteps(steps: StepLine[], id: string, detail?: string): void;
+/**
+ * The confirm turn's plan as the chat shows it: ONE owner of the text (hamr, 2026-10-09: the one-blob "Plan: ...
+ * Checks: ... Not checked: ..." was unreadable). Each section is a heading on its own line, its content on the next,
+ * and a blank line between sections. `#NOT CHECKED:` and `#QUESTIONS:` appear only when there is something to say.
+ * The CLI composes its own plan screen (src/authorrun.js) and shares no text with this one.
+ * @param {{goal?: string, checks?: string[], notChecked?: string[], questions?: string[]}} p
+ * @returns {string}
+ */
+export function planText(p: {
+    goal?: string;
+    checks?: string[];
+    notChecked?: string[];
+    questions?: string[];
+}): string;
 /**
  * `true` when `jobs/<name>.json` already exists in the repo's own jobs/ dir
  * (resolved from THIS module's own on-disk location, never `process.cwd()`,
@@ -96,7 +110,7 @@ export function validateJobCard(card: any, opts?: {
 /**
  * ONE session's engine — created already RUNNING (the caller awaits nothing;
  * the pipeline drives itself, reporting through `state`). `state.pendingAsk`
- * is the ONE thing a person answers next; `answer()`/`send()`/`revise()`/
+ * is the ONE thing a person answers next; `answer()`/`send()`/
  * `signPrepare()` are the only ways in.
  * @param {any} card the validated job card (see {@link validateJobCard})
  * @param {{env?: Record<string,string|undefined>, sessionsRoot?: string, home?: string, timeoutMs?: number,

package/types/panel/server.d.ts

@@ -1,5 +1,5 @@
 /**
- * `[✓]`/`[✗]`/`[▶]` — the ONLY vocabulary a result is ever rendered in
+ * `[✓]`/`[✗]`/`[■]`/`[▶]` — the ONLY vocabulary a result is ever rendered in
  * (auto-memory `ui-verdict-words.md`: never the words green/red/soft-green
  * anywhere in the page). `null` (no `job-end` reached — a killed-mid-run or
  * still-running spine) reads `▶` — the same "in progress / unresolved" glyph
@@ -7,9 +7,9 @@
  * running attempt and an archived spine that never reached its own end are
  * the same fact from this read-only side: no verdict has been recorded yet.
  * @param {string|null} outcome
- * @returns {'✓'|'✗'|'▶'}
+ * @returns {'✓'|'✗'|'■'|'▶'}
  */
-export function glyphForOutcome(outcome: string | null): "\u2713" | "\u2717" | "\u25B6";
+export function glyphForOutcome(outcome: string | null): "\u2713" | "\u2717" | "\u25A0" | "\u25B6";
 /**
  * `deterministic` (green) / `rubric` (soft-green) / `unknown` (a class this
  * reader doesn't recognize) — the settled UI wording (PANEL-BUILD.md §6),
@@ -381,7 +381,7 @@ export function reuseLine(record: {
  * to copy: change the job: Clear the card). `null` when the runid is not listed.
  * @param {string} runid
  * @param {{ home?: string, model?: string }} [opts] `model` = the Model box's current Name (the estimate counts only runs on that worker); absent = the card's own Model
- * @returns {{ok: true, origin: {runid: string, job: string}, card: Record<string, any>, from: 'signed job',
+ * @returns {{ok: true, origin: {runid: string, job: string}, outcome: string|null, card: Record<string, any>, from: 'signed job',
  *   locked: readonly string[], open: readonly string[], note: string|null,
  *   specHash: string, workflowKey: string, spec: any, specPath: string,
  *   trackRecord: ReturnType<typeof trackRecordFor>, line: string}|{ok: false, error: string}|null}
@@ -395,6 +395,7 @@ export function getStartFrom(runid: string, opts?: {
         runid: string;
         job: string;
     };
+    outcome: string | null;
     card: Record<string, any>;
     from: "signed job";
     locked: readonly string[];

package/types/panel/status.d.ts

@@ -60,7 +60,7 @@ export const STATUS: Readonly<{
         word: "capped";
     }>;
     stopped: Readonly<{
-        sign: "✗";
+        sign: "■";
         word: "stopped";
     }>;
     died: Readonly<{

package/types/providers.d.ts

@@ -1,3 +1,10 @@
+/**
+ * The per-call options the rubric JUDGE's model calls carry for this provider
+ * instance, from the allow-list above. Empty for any provider/model not listed.
+ * @param {any} provider a constructed bare-agent provider
+ * @returns {Record<string, any>}
+ */
+export function judgeCallOptions(provider: any): Record<string, any>;
 /**
  * Look up a provider's table entry. Throws a NAMED error on an unrecognized
  * provider — never a silent default (the `resolveRates`-style-substring-

package/types/ralph.d.ts

@@ -242,9 +242,13 @@ export function boundGap(s: string, keepPattern?: string): string;
  *   (PRD item 27/M3 Part B), forwarded to the raw `close` path's `runClose`
  *   call unchanged; a caller supplying `judge` instead already closed over
  *   its own `closeDir` and this param does nothing for it.
+ * @param {string} [opts.phase] the phase this loop runs in, when it is not the step loop
+ *   (the fix loop passes `'fix'`): the person's-stop text then names it ("during the fix
+ *   phase") instead of saying a resume re-enters "this step", which only the step loop has.
+ *   Text only — it changes no category, outcome or option.
  * @returns {Promise<'green'|'escalated'>}
  */
-export function ralph({ middle, close, judge, capRuns, ladder, emit, redact, closeTimeoutMs, cwd, expect, judged, gapKeep, workerWrites, closeDir }: {
+export function ralph({ middle, close, judge, capRuns, ladder, emit, redact, closeTimeoutMs, cwd, expect, judged, gapKeep, workerWrites, closeDir, phase }: {
     middle: (iteration: number, gap?: string) => void | Promise<void>;
     close?: string[] | undefined;
     judge?: (() => Promise<{
@@ -270,6 +274,7 @@ export function ralph({ middle, close, judge, capRuns, ladder, emit, redact, clo
     gapKeep?: string | undefined;
     workerWrites?: (() => string[]) | undefined;
     closeDir?: string | null | undefined;
+    phase?: string | undefined;
 }): Promise<"green" | "escalated">;
 /**
  * What the close child must NOT be able to read (operator ruling, 2026-07-31:

package/types/trend.d.ts

@@ -54,6 +54,7 @@ export function createTrend({ stageOrder, limit, blindCap, seed, directions }?:
      * @param {{gap?: string, stage?: string|null, value?: number|null}} o either a
      *   raw gap (parsed here) or an already-read `{stage, value}` — never both
      *   spellings of the same reading in one call.
+     *   (A judged stage's value is its distinct red COUNT, supplied by the caller.)
      * @returns {{iteration: number, stage: string, value: number|null, improved: boolean,
      *   comparable: boolean, noProgress: number, limit: number, stageIndex: number}}
      */