@cat-factory/agents 0.140.1 → 0.142.0

package/dist/agents/kinds/pr-reviewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-reviewer.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/pr-reviewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAkD3E,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;EAAoD,CAAA;AAEzE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AAyB9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAA;AA+E7C,eAAO,MAAM,yBAAyB,QAsEK,CAAA;AAE3C,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,EA6CxD,CAAA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEzE;AAED,OAAO,EACL,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,UAAU,EACV,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"pr-reviewer.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/pr-reviewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAkD3E,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;EAAoD,CAAA;AAEzE,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAA;AAyB9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAA;AA+E7C,eAAO,MAAM,yBAAyB,QAsEK,CAAA;AAE3C,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,EA6CxD,CAAA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEzE;AAED,OAAO,EACL,oBAAoB,EACpB,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,UAAU,EACV,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAA"}

package/dist/agents/kinds/pr-reviewer.js

@@ -286,5 +286,5 @@ export const PR_REVIEWER_AGENT_KINDS = [
 export function registerPrReviewerAgent(registry) {
     registry.registerAll(PR_REVIEWER_AGENT_KINDS);
 }
-export { PR_DIFF_CONTEXT_FILE, PR_EXISTING_COMMENTS_CONTEXT_FILE, PR_PRIOR_REVIEW_CONTEXT_FILE, PR_STANDARDS_INDEX_CONTEXT_FILE, planSlices, prReviewerDiffPreOp, prReviewerExistingCommentsPreOp, prReviewerStandardsPreOp, renderExistingReviewComments, renderPrDiffContext, renderPriorReviewContext, renderStandardContext, renderStandardsIndex, resolvePrNumber, standardsContextFileName, } from './pr-review-context.js';
+export { PR_DIFF_CONTEXT_FILE, PR_EXISTING_COMMENTS_CONTEXT_FILE, PR_PRIOR_REVIEW_CONTEXT_FILE, PR_STANDARDS_INDEX_CONTEXT_FILE, planSlices, prReviewerDiffPreOp, prReviewerExistingCommentsPreOp, prReviewerStandardsPreOp, renderExistingReviewComments, renderPrDiffContext, renderPriorReviewContext, renderStandardContext, renderStandardsIndex, resolvePrHeadNumber, resolvePrNumber, standardsContextFileName, } from './pr-review-context.js';
 //# sourceMappingURL=pr-reviewer.js.map

package/dist/agents/kinds/pr-reviewer.js.map

@@ -1 +1 @@
-{"version":3,"file":"pr-reviewer.js","sourceRoot":"","sources":["../../../src/agents/kinds/pr-reviewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pr-reviewer.js","sourceRoot":"","sources":["../../../src/agents/kinds/pr-reviewer.ts"],"names":[],"mappings":"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"}

package/dist/agents/kinds/traits.d.ts

@@ -161,17 +161,56 @@ export declare const SPEC_AWARE_GUIDANCE: string;
  *    `reviewer` companion is a built-in listed here while the coder declares its own).
  */
 export declare const STANDARD_AGENT_TRAITS: Partial<Record<AgentKind, AgentTrait[]>>;
+/**
+ * What a dispatch actually PUT IN FRONT OF the agent, for guidance that names an artifact.
+ *
+ * Trait guidance is composed from the kind alone, and several of these strings point at a
+ * `.cat-context/` file the ENGINE decides whether to inject. When the injection did not happen
+ * the guidance is a pointer to a path that does not exist, which reads to the agent as a platform
+ * fault rather than as an absence, and the graders kept filing it: a ~200-word reuse mandate
+ * riding every turn of a run whose deployment has no catalog to reuse from.
+ *
+ * `contextPaths` absent means the CALLER DOES NOT KNOW, not that nothing was delivered, and those
+ * are opposite facts. The prompt editor measuring what the platform appends to an override, the
+ * sandbox composing a candidate and a test asking for a kind's prompt all legitimately have no
+ * dispatch, and each renders the guidance in FULL. That direction of the error is the safe one, the
+ * same reasoning `containerDispatchDirectivesFor` records: over-reporting a rule a workspace cannot
+ * delete costs a line in an editor, under-reporting hides one.
+ */
+export interface TraitDelivery {
+    /**
+     * The `.cat-context/` paths this dispatch injected, or `undefined` when unknown. An empty array
+     * is a real answer: the dispatch injected nothing.
+     */
+    contextPaths?: readonly string[];
+}
 /** Definition of a (custom) trait: its id and optional system-prompt guidance. */
 export interface AgentTraitDefinition {
     /** The trait id used in `STANDARD_AGENT_TRAITS` / `AgentKindDefinition.traits`. */
     id: AgentTrait;
     /**
-     * Guidance folded into the system prompt of every kind carrying this trait. A function
-     * form receives the kind id. Omit for a pure marker trait whose effect lives in the
+     * Guidance folded into the system prompt of every kind carrying this trait. A function form
+     * receives the kind id plus what the dispatch delivered ({@link TraitDelivery}), and may return
+     * `undefined` to contribute NOTHING for this dispatch, which is what guidance naming an injected
+     * file does when the file is not there. Omit for a pure marker trait whose effect lives in the
      * engine (like `code-aware`).
      */
-    guidance?: string | ((kind: AgentKind) => string);
+    guidance?: string | ((kind: AgentKind, delivery: TraitDelivery) => string | undefined);
 }
+/**
+ * The {@link TraitDelivery} for a resolved dispatch: what the engine put in front of THIS agent.
+ *
+ * One helper for all three prompt-composing surfaces (container dispatch, the inline executor, a
+ * consensus panel) rather than a `.map(f => f.path)` at each, because the three must agree: a
+ * surface that built the set differently would gate the same kind's guidance differently for no
+ * reason a reader could find. An absent `injectedContextFiles` yields an EMPTY list rather than an
+ * unknown one, and deliberately: the field is absent exactly when the dispatch injected nothing.
+ */
+export declare function traitDeliveryFor(context: {
+    injectedContextFiles?: readonly {
+        path: string;
+    }[];
+}): TraitDelivery;
 /**
  * The standard trait DEFINITIONS, pre-loaded onto every {@link AgentKindRegistry} instance
  * (its constructor installs them) — the analogue of `STANDARD_AGENT_TRAITS`, but for the
@@ -201,6 +240,10 @@ export declare function standardsVerbosityFor(kind: AgentKind, registry: AgentKi
  * The guidance lines contributed by the traits a kind carries, in trait order. Folded
  * into the kind's system prompt by `systemPromptFor`. Marker traits (no guidance, e.g.
  * `code-aware`) contribute nothing here. Trait definitions are read off the injected registry.
+ *
+ * `delivery` is what the dispatch actually injected, so guidance that names a `.cat-context/` file
+ * can decline to say anything when the file is not there. Omitted, every trait renders in full:
+ * see {@link TraitDelivery} for why unknown is not the same as absent.
  */
-export declare function traitGuidanceFor(kind: AgentKind, registry: AgentKindRegistry): string[];
+export declare function traitGuidanceFor(kind: AgentKind, registry: AgentKindRegistry, delivery?: TraitDelivery): string[];
 //# sourceMappingURL=traits.d.ts.map

package/dist/agents/kinds/traits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EASf,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAetD,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,UAAwB,CAAA;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAAyB,CAAA;AAExD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAA4B,CAAA;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAA6B,CAAA;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAA4B,CAAA;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAA8B,CAAA;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,EAAE,UAAmC,CAAA;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAAqC,CAAA;AAEhF,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,QAK9B,CAAA;AAEZ;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAA4B,CAAA;AAE9D,gGAAgG;AAChG,eAAO,MAAM,sBAAsB,QAIvB,CAAA;AAEZ,8FAA8F;AAC9F,eAAO,MAAM,+BAA+B,QAIhC,CAAA;AAEZ,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,QAWpB,CAAA;AAEZ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,CAAC,CA4C1E,CAAA;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,EAAE,EAAE,UAAU,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;CAClD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,oBAAoB,EAiBrE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC,UAAU,CAAC,CAKvF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEjG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,OAAO,CAElB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAQvF"}
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/agents/kinds/traits.ts"],"names":[],"mappings":"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"}

package/dist/agents/kinds/traits.js

@@ -227,6 +227,27 @@ export const STANDARD_AGENT_TRAITS = {
     [INITIATIVE_INTERVIEWER_AGENT_KIND]: [INTERVIEW_GATE_TRAIT],
     [DOC_INTERVIEWER_AGENT_KIND]: [INTERVIEW_GATE_TRAIT],
 };
+/**
+ * Whether `path` was injected for this dispatch, treating an unknown delivery as delivered.
+ *
+ * The default is what keeps the change additive: every caller that cannot know (the editor, the
+ * sandbox, a unit test) composes exactly the prompt it composed before.
+ */
+function wasDelivered(delivery, path) {
+    return delivery.contextPaths === undefined || delivery.contextPaths.includes(path);
+}
+/**
+ * The {@link TraitDelivery} for a resolved dispatch: what the engine put in front of THIS agent.
+ *
+ * One helper for all three prompt-composing surfaces (container dispatch, the inline executor, a
+ * consensus panel) rather than a `.map(f => f.path)` at each, because the three must agree: a
+ * surface that built the set differently would gate the same kind's guidance differently for no
+ * reason a reader could find. An absent `injectedContextFiles` yields an EMPTY list rather than an
+ * unknown one, and deliberately: the field is absent exactly when the dispatch injected nothing.
+ */
+export function traitDeliveryFor(context) {
+    return { contextPaths: (context.injectedContextFiles ?? []).map((file) => file.path) };
+}
 /**
  * The standard trait DEFINITIONS, pre-loaded onto every {@link AgentKindRegistry} instance
  * (its constructor installs them) — the analogue of `STANDARD_AGENT_TRAITS`, but for the
@@ -243,8 +264,26 @@ export const STANDARD_TRAIT_DEFINITIONS = [
     // A marker: the queued skills each render their own prompt section through the shared skill
     // delivery, so there is nothing static to fold for a kind that carries it.
     { id: REVIEW_SKILLS_TRAIT },
-    { id: FOUNDATIONAL_CATALOG_TRAIT, guidance: FOUNDATIONAL_CATALOG_GUIDANCE },
-    { id: FOUNDATIONAL_CONTRACTS_TRAIT, guidance: FOUNDATIONAL_CONTRACTS_GUIDANCE },
+    // The two foundational traits are gated on their own file arriving. Each is a long section whose
+    // FIRST sentence points at a `.cat-context/` path, and the engine injects neither when no
+    // `FoundationalServiceResolver` is wired (`resolveFoundationalContext` returns nothing at all
+    // there) — so on such a deployment both were pure overhead pointing at nothing. Where a resolver
+    // IS wired the file is always written, empty catalog and failed read included, each SAYING which
+    // it is; those states are exactly what the guidance asks the agent to act on, so presence is the
+    // right condition and emptiness is not.
+    {
+        id: FOUNDATIONAL_CATALOG_TRAIT,
+        guidance: (_kind, delivery) => wasDelivered(delivery, FOUNDATIONAL_CATALOG_FILE) ? FOUNDATIONAL_CATALOG_GUIDANCE : undefined,
+    },
+    {
+        id: FOUNDATIONAL_CONTRACTS_TRAIT,
+        guidance: (_kind, delivery) => wasDelivered(delivery, FOUNDATIONAL_INDEX_FILE) ? FOUNDATIONAL_CONTRACTS_GUIDANCE : undefined,
+    },
+    // NOT gated, deliberately, though it names a file the same way. Its own text handles the absent
+    // case as a REFUSAL ("If that file is absent, the platform could not provide storage — do not
+    // attempt any upload; state it in your report and stop generating"), which is a thing the agent
+    // must be told rather than a pointer to drop: gated off, a binary-generating kind with no
+    // storage would generate happily and deliver nowhere.
     { id: BINARY_OUTPUT_TRAIT, guidance: BINARY_OUTPUT_GUIDANCE },
     // A marker: the pictures are delivered as context (files or attached parts) and the prompt
     // section that names them is rendered from what the dispatch actually achieved, so there is no
@@ -284,14 +323,20 @@ export function standardsVerbosityFor(kind, registry) {
  * The guidance lines contributed by the traits a kind carries, in trait order. Folded
  * into the kind's system prompt by `systemPromptFor`. Marker traits (no guidance, e.g.
  * `code-aware`) contribute nothing here. Trait definitions are read off the injected registry.
+ *
+ * `delivery` is what the dispatch actually injected, so guidance that names a `.cat-context/` file
+ * can decline to say anything when the file is not there. Omitted, every trait renders in full:
+ * see {@link TraitDelivery} for why unknown is not the same as absent.
  */
-export function traitGuidanceFor(kind, registry) {
+export function traitGuidanceFor(kind, registry, delivery = {}) {
     const lines = [];
     for (const trait of traitsFor(kind, registry)) {
         const guidance = registry.traitDefinition(trait)?.guidance;
         if (!guidance)
             continue;
-        lines.push(typeof guidance === 'function' ? guidance(kind) : guidance);
+        const rendered = typeof guidance === 'function' ? guidance(kind, delivery) : guidance;
+        if (rendered)
+            lines.push(rendered);
     }
     return lines;
 }

package/dist/agents/kinds/traits.js.map

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

package/dist/agents/prompts/bespoke-kinds.d.ts

@@ -1,5 +1,6 @@
 import type { AgentKind } from '@cat-factory/kernel';
 import type { AgentKindRegistry } from '../kinds/registry.js';
+import type { TraitDelivery } from '../kinds/traits.js';
 import { type BespokeSystemPrompt } from './bespoke.js';
 /**
  * The EDITABLE half of the `merger` prompt: what the agent is for. Replaced wholesale by a
@@ -86,6 +87,12 @@ export declare function shippedBasePromptFor(kind: AgentKind, registry: AgentKin
  * alone is the bug it replaces: for the inline ENGINE kinds that returns the thin `roles.ts` line
  * plus a second copy of directives the base already carried, so a candidate was graded on a prompt
  * no run ever sends and could not be promoted unchanged.
+ *
+ * `delivery` is forwarded so trait guidance naming an injected `.cat-context/` file can stay silent
+ * when the dispatch did not inject it. A bespoke kind carries no trait guidance (its directives are
+ * a declared constant), so it ignores the argument rather than pretending to honour it. The Sandbox
+ * passes none: a graded candidate is composed against the maximal prompt, which is the honest thing
+ * to grade against and matches what the prompt editor shows.
  */
-export declare function composedSystemPromptFor(kind: AgentKind, registry: AgentKindRegistry, replacement?: string): string;
+export declare function composedSystemPromptFor(kind: AgentKind, registry: AgentKindRegistry, replacement?: string, delivery?: TraitDelivery): string;
 //# sourceMappingURL=bespoke-kinds.d.ts.map

package/dist/agents/prompts/bespoke-kinds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bespoke-kinds.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/bespoke-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAyB7E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAMmC,CAAA;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAIP,CAAA;AAEvB,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,QAAyC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAKsC,CAAA;AAEtE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAMR,CAAA;AAEvB,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,QAA2C,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAiBlF,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEzF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAIR"}
+{"version":3,"file":"bespoke-kinds.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/bespoke-kinds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAyB7E;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAMmC,CAAA;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAIP,CAAA;AAEvB,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,QAAyC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAKsC,CAAA;AAEtE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAMR,CAAA;AAEvB,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,QAA2C,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAiBlF,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAEzF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,aAAa,GACvB,MAAM,CAIR"}

package/dist/agents/prompts/bespoke-kinds.js

@@ -143,11 +143,17 @@ export function shippedBasePromptFor(kind, registry) {
  * alone is the bug it replaces: for the inline ENGINE kinds that returns the thin `roles.ts` line
  * plus a second copy of directives the base already carried, so a candidate was graded on a prompt
  * no run ever sends and could not be promoted unchanged.
+ *
+ * `delivery` is forwarded so trait guidance naming an injected `.cat-context/` file can stay silent
+ * when the dispatch did not inject it. A bespoke kind carries no trait guidance (its directives are
+ * a declared constant), so it ignores the argument rather than pretending to honour it. The Sandbox
+ * passes none: a graded candidate is composed against the maximal prompt, which is the honest thing
+ * to grade against and matches what the prompt editor shows.
  */
-export function composedSystemPromptFor(kind, registry, replacement) {
+export function composedSystemPromptFor(kind, registry, replacement, delivery) {
     const bespoke = BESPOKE_SYSTEM_PROMPTS[kind];
     if (bespoke)
         return composeBespokePrompt(bespoke, replacement);
-    return systemPromptFor(kind, registry, replacement);
+    return systemPromptFor(kind, registry, replacement, delivery);
 }
 //# sourceMappingURL=bespoke-kinds.js.map

package/dist/agents/prompts/bespoke-kinds.js.map

@@ -1 +1 @@
-{"version":3,"file":"bespoke-kinds.js","sourceRoot":"","sources":["../../../src/agents/prompts/bespoke-kinds.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAA4B,MAAM,cAAc,CAAA;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,+FAA+F;AAC/F,kFAAkF;AAClF,EAAE;AACF,0FAA0F;AAC1F,gGAAgG;AAChG,kFAAkF;AAClF,iGAAiG;AACjG,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,wFAAwF;AACxF,uCAAuC;AACvC,EAAE;AACF,gGAAgG;AAChG,iGAAiG;AACjG,8FAA8F;AAC9F,gGAAgG;AAChG,+FAA+F;AAC/F,0DAA0D;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,+EAA+E;IAC/E,6FAA6F;IAC7F,sFAAsF;IACtF,mFAAmF;IACnF,yFAAyF;IACzF,gEAAgE,CAAA;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,4BAA4B;IAC5B,yFAAyF;IACzF,kBAAkB;IAClB,qBAAqB,CAAA;AAEvB,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,kFAAkF;IAClF,iFAAiF;IACjF,sFAAsF;IACtF,qFAAqF;IACrF,oEAAoE,CAAA;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,oBAAoB;IACpB,wFAAwF;IACxF,8DAA8D;IAC9D,sFAAsF;IACtF,gDAAgD;IAChD,qBAAqB,CAAA;AAEvB,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAoD;IACrF,GAAG,4BAA4B;IAC/B,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACrF,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE;IAC1F,2FAA2F;IAC3F,+FAA+F;IAC/F,8FAA8F;IAC9F,sDAAsD;IACtD,EAAE;IACF,+FAA+F;IAC/F,wFAAwF;IACxF,8DAA8D;IAC9D,cAAc,EAAE;QACd,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,uBAAuB;KACpC;CACF,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,QAA2B;IAC/E,OAAO,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAe,EACf,QAA2B,EAC3B,WAAoB;IAEpB,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,OAAO;QAAE,OAAO,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAC9D,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"bespoke-kinds.js","sourceRoot":"","sources":["../../../src/agents/prompts/bespoke-kinds.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAA4B,MAAM,cAAc,CAAA;AAC7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,+FAA+F;AAC/F,kFAAkF;AAClF,EAAE;AACF,0FAA0F;AAC1F,gGAAgG;AAChG,kFAAkF;AAClF,iGAAiG;AACjG,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,wFAAwF;AACxF,uCAAuC;AACvC,EAAE;AACF,gGAAgG;AAChG,iGAAiG;AACjG,8FAA8F;AAC9F,gGAAgG;AAChG,+FAA+F;AAC/F,0DAA0D;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,+EAA+E;IAC/E,6FAA6F;IAC7F,sFAAsF;IACtF,mFAAmF;IACnF,yFAAyF;IACzF,gEAAgE,CAAA;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,4BAA4B;IAC5B,yFAAyF;IACzF,kBAAkB;IAClB,qBAAqB,CAAA;AAEvB,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,kFAAkF;IAClF,iFAAiF;IACjF,sFAAsF;IACtF,qFAAqF;IACrF,oEAAoE,CAAA;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,oBAAoB;IACpB,wFAAwF;IACxF,8DAA8D;IAC9D,sFAAsF;IACtF,gDAAgD;IAChD,qBAAqB,CAAA;AAEvB,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAoD;IACrF,GAAG,4BAA4B;IAC/B,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACrF,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,kBAAkB,EAAE;IAC1F,2FAA2F;IAC3F,+FAA+F;IAC/F,8FAA8F;IAC9F,sDAAsD;IACtD,EAAE;IACF,+FAA+F;IAC/F,wFAAwF;IACxF,8DAA8D;IAC9D,cAAc,EAAE;QACd,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,wBAAwB;QAC9B,UAAU,EAAE,uBAAuB;KACpC;CACF,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAe,EAAE,QAA2B;IAC/E,OAAO,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAClF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAe,EACf,QAA2B,EAC3B,WAAoB,EACpB,QAAwB;IAExB,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;IAC5C,IAAI,OAAO;QAAE,OAAO,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAC9D,OAAO,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC/D,CAAC"}

package/dist/agents/prompts/built-in-container.d.ts

@@ -29,6 +29,33 @@ export declare function mergerUserPrompt(context: AgentRunContext, dispatch?: Ag
  * generic prompt is what makes this a regression investigation rather than a code read.
  */
 export declare function onCallUserPromptSuffix(context: AgentRunContext, dispatch?: AgentDispatchContext): string;
+/**
+ * The `task-reassessor`'s task prompt: read the change the run actually landed and score the
+ * three triage axes against it.
+ *
+ * The checkout is the pr-reviewer's: the BASE branch plus the pull request's head fetched as
+ * `origin/pr-head` by the harness. That shape rather than a clone of the PR branch because the
+ * branch is DELETED once the pull request merges, while `refs/pull/<n>/head` survives it, so the
+ * same step reads the same diff whether it runs before the merge or after it. The pull request it
+ * names is the one the harness fetched: the kind declares `prHeadSource: 'run'`, so that is
+ * `block.pullRequest` and not a PR the task might separately name.
+ *
+ * A REPLACEMENT prompt rather than a `userPromptSuffix`, and the two things that costs are both
+ * deliberate. What it drops is the fold of every prior step's output, which on this pipeline
+ * position CONTAINS THE FORECAST: the estimator's own step output is `summarizeEstimate`, in
+ * percentages. This kind must not see it (an assessment handed the number it is revising anchors
+ * on it, and the delta is arithmetic the platform does from the two records), so the fold is the
+ * thing being withheld rather than a casualty of withholding it. What it must NOT drop is the
+ * account of what the work was: the task's description and, above all, the system it belongs to,
+ * both re-stated below, because the impact axis is a blast radius and a bare title names no
+ * software for one to be judged against.
+ *
+ * A MULTI-REPO task is named rather than silently under-scored. The peer PRs' repositories are not
+ * in this checkout (resolving them is the merger's combined-diff path, which is that kind's alone),
+ * so the assessment covers the primary repository's change and has to SAY so, or a reader takes a
+ * partial score for the whole one.
+ */
+export declare function taskReassessorUserPrompt(context: AgentRunContext, dispatch?: AgentDispatchContext): string;
 /**
  * The conflict-resolver's task prompt: a COMPACT task reference, deliberately NOT the generic
  * block-context prompt.

package/dist/agents/prompts/built-in-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-container.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/built-in-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAmBhF,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,QAEQ,CAAA;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,QAEgC,CAAA;AAE1E,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,QAGkE,CAAA;AAErG,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,QAGiD,CAAA;AAMvF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,CAqBR;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,CAwBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAG3E"}
+{"version":3,"file":"built-in-container.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/built-in-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAqBhF,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,QAEQ,CAAA;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B,QAEgC,CAAA;AAE1E,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,QAGkE,CAAA;AAErG,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,QAGiD,CAAA;AAMvF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,CAqBR;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,CAwBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,CAwCR;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAG3E"}

package/dist/agents/prompts/built-in-container.js

@@ -1,3 +1,5 @@
+import { TRIAGE_JSON_CONTRACT } from './roles.js';
+import { ownServiceSection } from './standard.js';
 // ---------------------------------------------------------------------------
 // The task prompts + structured-output shape hints for the BUILT-IN container kinds that assess
 // rather than produce (`merger`, `on-call`) and for the tester family's reply shape.
@@ -113,6 +115,72 @@ export function onCallUserPromptSuffix(context, dispatch) {
         'Respond with ONLY a JSON object {"culpritConfidence":0.0,"recommendation":"revert"|"hold"|"monitor","rationale":"…","evidence":["…"]}.',
     ].join('\n');
 }
+/**
+ * The `task-reassessor`'s task prompt: read the change the run actually landed and score the
+ * three triage axes against it.
+ *
+ * The checkout is the pr-reviewer's: the BASE branch plus the pull request's head fetched as
+ * `origin/pr-head` by the harness. That shape rather than a clone of the PR branch because the
+ * branch is DELETED once the pull request merges, while `refs/pull/<n>/head` survives it, so the
+ * same step reads the same diff whether it runs before the merge or after it. The pull request it
+ * names is the one the harness fetched: the kind declares `prHeadSource: 'run'`, so that is
+ * `block.pullRequest` and not a PR the task might separately name.
+ *
+ * A REPLACEMENT prompt rather than a `userPromptSuffix`, and the two things that costs are both
+ * deliberate. What it drops is the fold of every prior step's output, which on this pipeline
+ * position CONTAINS THE FORECAST: the estimator's own step output is `summarizeEstimate`, in
+ * percentages. This kind must not see it (an assessment handed the number it is revising anchors
+ * on it, and the delta is arithmetic the platform does from the two records), so the fold is the
+ * thing being withheld rather than a casualty of withholding it. What it must NOT drop is the
+ * account of what the work was: the task's description and, above all, the system it belongs to,
+ * both re-stated below, because the impact axis is a blast radius and a bare title names no
+ * software for one to be judged against.
+ *
+ * A MULTI-REPO task is named rather than silently under-scored. The peer PRs' repositories are not
+ * in this checkout (resolving them is the merger's combined-diff path, which is that kind's alone),
+ * so the assessment covers the primary repository's change and has to SAY so, or a reader takes a
+ * partial score for the whole one.
+ */
+export function taskReassessorUserPrompt(context, dispatch) {
+    const prNumber = context.block.pullRequest?.number;
+    const pr = prNumber !== undefined ? ` (PR #${prNumber})` : '';
+    // With no dispatch context there is no checkout and therefore no branch to name: say what to
+    // read without asserting a branch name the caller never resolved.
+    const readGuidance = dispatch
+        ? `You are on the base branch \`${dispatch.baseBranch}\`, and the change${pr} has been ` +
+            'fetched for you as `origin/pr-head`:\n' +
+            `  git diff --name-status origin/${dispatch.baseBranch}...origin/pr-head   # the shape of the change\n` +
+            `  git diff origin/${dispatch.baseBranch}...origin/pr-head -- <path>       # one file's diff\n` +
+            'Start from the shape, then read the diffs that decide the score. If `origin/pr-head` is ' +
+            'absent (the fetch was skipped), say so in your rationale and score from the evidence above ' +
+            'rather than guessing.'
+        : `Score the change${pr} from the evidence you have been given.`;
+    const peers = context.block.peerPullRequests?.length ?? 0;
+    const scope = peers > 0
+        ? `This task also changed ${peers} connected service repositor${peers === 1 ? 'y' : 'ies'}, ` +
+            'which are NOT in this checkout. Score the change you can read, and state in your ' +
+            'rationale that the connected repositories were out of scope.'
+        : null;
+    const description = context.block.description?.trim();
+    // The system the work belongs to, or the explicit statement that nothing named one. Rendered
+    // rather than omitted for the reason `ownServiceSection` exists: the impact axis is a blast
+    // radius, and a model given no system to judge one against supplies one. Trimmed because the
+    // shared helper leads with its own blank lines for the generic prompt's line list.
+    const ownService = ownServiceSection(context).trim();
+    return [
+        'The implementation for this task has landed. Assess what was ACTUALLY built and return the ' +
+            'complexity / risk / impact scores + rationale as JSON.',
+        '',
+        readGuidance,
+        ...(scope ? ['', scope] : []),
+        '',
+        `Task: ${context.block.title}`,
+        ...(description ? ['', description] : []),
+        ...(ownService ? ['', ownService] : []),
+        '',
+        TRIAGE_JSON_CONTRACT,
+    ].join('\n');
+}
 /**
  * The conflict-resolver's task prompt: a COMPACT task reference, deliberately NOT the generic
  * block-context prompt.

package/dist/agents/prompts/built-in-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"built-in-container.js","sourceRoot":"","sources":["../../../src/agents/prompts/built-in-container.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"built-in-container.js","sourceRoot":"","sources":["../../../src/agents/prompts/built-in-container.ts"],"names":[],"mappings":"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"}

package/dist/agents/prompts/companion.d.ts

@@ -1,5 +1,43 @@
-import type { AgentKind } from '@cat-factory/kernel';
+import type { AgentDispatchContext, AgentKind, AgentRunContext } from '@cat-factory/kernel';
 import type { AgentKindRegistry } from '../kinds/registry.js';
 /** The companion system prompt for `kind`, or undefined when `kind` is not a companion. */
 export declare function companionSystemPrompt(kind: AgentKind, registry: AgentKindRegistry): string | undefined;
+/**
+ * Where a container-backed companion's review STARTS: the refs its checkout actually has, the two
+ * commands that turn them into the change, and the rule that it plans from the shape before it
+ * reads anything.
+ *
+ * The `pr-reviewer` has had this since it shipped, as an injected `.cat-context/pr-diff.md` its
+ * prompt tells it to read first; the container-backed companions had nothing equivalent and were
+ * told only to "diff against the base branch", which they had to first work out the name of. What
+ * this states instead is what the DISPATCH resolved, which is the one thing the agent cannot
+ * derive: `AgentDispatchContext.baseBranch` is the branch the engine forked from, and it is a
+ * per-deployment fact (`main`, `master`, `develop`, a release line).
+ *
+ * A SECTION rather than an injected file, deliberately: a `.cat-context/pr-diff.md` would mean a
+ * preOp reading the change back over HTTP to write bytes the checkout already has, and would
+ * duplicate the diff into a prompt that is re-sent on every turn. The commands cost the reviewer
+ * two turns and the output lands only in the turns that need it.
+ *
+ * No `git fetch` is named, and that is the point: the container agent holds NO git credential of
+ * its own (the token lives with the harness and rides GIT_ASKPASS per harness-issued command), so
+ * an agent-issued fetch fails outright on a private repo. The refs are the harness's job — a
+ * companion dispatch clones with full history, which brings `origin/<base>` with it, and the
+ * warm-pool path refreshes it (`exploreCheckoutRefs`). Naming a command the agent cannot run would
+ * put an error on the very first instruction the review is anchored on.
+ *
+ * Returns `undefined` when there is no change to measure, which is every case the commands would
+ * lie about:
+ *   - a non-companion kind, or an INLINE companion (no checkout at all, so naming git commands
+ *     would be the exact "things that are not true of this run" failure);
+ *   - no resolved dispatch (a consensus panel participant: no filesystem, no tools);
+ *   - a checkout that IS the base branch. A `clone.branch: 'pr'` dispatch falls back to base when
+ *     the producer opened no pull request, and there `<base>...HEAD` is empty: the reviewer would
+ *     be told to plan from a diffstat showing nothing and not to go looking past it, and would
+ *     grade an empty change as the work;
+ *   - a base branch whose name cannot be safely quoted, which is REPORTED rather than silently
+ *     shortened: the section states the branch it could not name and stops, leaving the system
+ *     prompt's own "start from what actually changed" instruction to stand.
+ */
+export declare function companionCheckoutSection(context: AgentRunContext, registry: AgentKindRegistry, dispatch?: AgentDispatchContext): string | undefined;
 //# sourceMappingURL=companion.d.ts.map

package/dist/agents/prompts/companion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAc7D,2FAA2F;AAC3F,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,SAAS,CAoHpB"}
+{"version":3,"file":"companion.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/companion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAc7D,2FAA2F;AAC3F,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,SAAS,CAiIpB;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,MAAM,GAAG,SAAS,CAkCpB"}

package/dist/agents/prompts/companion.js

@@ -24,19 +24,32 @@ export function companionSystemPrompt(kind, registry) {
         // rework loop's scores wander instead of climb: the step's `threshold` can only mean
         // something if two consecutive rounds mean the same thing by 0.8.
         anchoredQualityScale('the standard for this deliverable'),
+        // The numeric bar is deliberately NOT named here, nor pointed at. It is a per-STEP operator
+        // setting that `withGradingBar` states with the work, and that wrapper is absent on every
+        // surface with no live companion loop to read one off — the prompt editor, the Sandbox
+        // composing a graded candidate, a dispatch whose step carries no companion state. A sentence
+        // here promising the number "below" is a dangling pointer on exactly those surfaces, which is
+        // the same defect this prompt's own trait guidance is gated to avoid. The scale's anchors are
+        // self-contained without it.
+        //
         // A container-backed companion gets a real, read-only checkout of the producer's PR
         // branch. Reviewing the producer's summary reply alone is worthless — judge the ACTUAL
         // artifact: open and read the changed files / the full committed document and whatever
         // surrounding repository context you need to assess it properly. The preceding step's
         // reply (if any) is only a pointer; the repository on disk is the source of truth.
+        //
+        // It names no commands and points at none, for the same reason: `companionCheckoutSection`
+        // WITHHOLDS them wherever they would describe a checkout that is not a change (a dispatch that
+        // fell back to the base branch, a base ref that cannot be safely quoted). This instruction has
+        // to stand on its own in those runs, so it states the rule rather than deferring to a section.
         ...(isContainerBackedCompanion(kind, registry)
             ? [
                 '',
-                'You have a read-only checkout of the branch under review. Do NOT judge from the',
-                "summary alone: inspect what actually changed (diff the branch against the repo's",
-                'default/base branch), then open and read the changed files in full — plus any',
-                'related code or documents in the repository you need for context — before rating.',
-                'Ground every comment in what the files actually contain. Make no commits.',
+                'You have a read-only checkout of the branch under review, with full history.',
+                'Do NOT judge from the summary alone: start from what actually changed, then open and',
+                'read the changed files in full, plus any related code or documents in the repository',
+                'you need for context, before rating. Ground every comment in what the files actually',
+                'contain. Make no commits.',
             ]
             : []),
         // The document reviewer carries `doc-aware`, so the engine folds the task's
@@ -125,4 +138,86 @@ export function companionSystemPrompt(kind, registry) {
         FINAL_ANSWER_IN_REPLY,
     ].join('\n');
 }
+/**
+ * A branch name safe to interpolate into a shell command and a markdown code span.
+ *
+ * The base branch is PROVIDER-supplied, and git permits far more in a ref than a shell does: a
+ * backtick closes the code span and reflows the rest of this section as prose, and `$(…)` in a
+ * command the agent is told to run is a substitution the agent's own shell tool performs. Model-
+ * and provider-authored strings that become git arguments are validated for MAGIC rather than
+ * merely for traversal, so this is an ALLOW-list of what a ref may contain, not a deny-list of
+ * what bites. Leading `-` is excluded separately: it turns the name into an option.
+ */
+const SAFE_BRANCH_NAME = /^[A-Za-z0-9._/][A-Za-z0-9._/-]*$/;
+/**
+ * Where a container-backed companion's review STARTS: the refs its checkout actually has, the two
+ * commands that turn them into the change, and the rule that it plans from the shape before it
+ * reads anything.
+ *
+ * The `pr-reviewer` has had this since it shipped, as an injected `.cat-context/pr-diff.md` its
+ * prompt tells it to read first; the container-backed companions had nothing equivalent and were
+ * told only to "diff against the base branch", which they had to first work out the name of. What
+ * this states instead is what the DISPATCH resolved, which is the one thing the agent cannot
+ * derive: `AgentDispatchContext.baseBranch` is the branch the engine forked from, and it is a
+ * per-deployment fact (`main`, `master`, `develop`, a release line).
+ *
+ * A SECTION rather than an injected file, deliberately: a `.cat-context/pr-diff.md` would mean a
+ * preOp reading the change back over HTTP to write bytes the checkout already has, and would
+ * duplicate the diff into a prompt that is re-sent on every turn. The commands cost the reviewer
+ * two turns and the output lands only in the turns that need it.
+ *
+ * No `git fetch` is named, and that is the point: the container agent holds NO git credential of
+ * its own (the token lives with the harness and rides GIT_ASKPASS per harness-issued command), so
+ * an agent-issued fetch fails outright on a private repo. The refs are the harness's job — a
+ * companion dispatch clones with full history, which brings `origin/<base>` with it, and the
+ * warm-pool path refreshes it (`exploreCheckoutRefs`). Naming a command the agent cannot run would
+ * put an error on the very first instruction the review is anchored on.
+ *
+ * Returns `undefined` when there is no change to measure, which is every case the commands would
+ * lie about:
+ *   - a non-companion kind, or an INLINE companion (no checkout at all, so naming git commands
+ *     would be the exact "things that are not true of this run" failure);
+ *   - no resolved dispatch (a consensus panel participant: no filesystem, no tools);
+ *   - a checkout that IS the base branch. A `clone.branch: 'pr'` dispatch falls back to base when
+ *     the producer opened no pull request, and there `<base>...HEAD` is empty: the reviewer would
+ *     be told to plan from a diffstat showing nothing and not to go looking past it, and would
+ *     grade an empty change as the work;
+ *   - a base branch whose name cannot be safely quoted, which is REPORTED rather than silently
+ *     shortened: the section states the branch it could not name and stops, leaving the system
+ *     prompt's own "start from what actually changed" instruction to stand.
+ */
+export function companionCheckoutSection(context, registry, dispatch) {
+    if (!dispatch || !isContainerBackedCompanion(context.agentKind, registry))
+        return undefined;
+    const base = dispatch.baseBranch;
+    if (dispatch.checkoutBranch === base)
+        return undefined;
+    if (!SAFE_BRANCH_NAME.test(base)) {
+        return ('\nThis checkout is a change measured against the repository base branch. Its name contains ' +
+            'characters this prompt cannot safely quote, so the diff commands are omitted here: derive ' +
+            'the base ref yourself (`git branch -r`) before reading anything, and say in your summary ' +
+            'that you had to.');
+    }
+    const lines = [
+        '',
+        `The change under review is this checkout measured against \`${base}\`, the base branch it ` +
+            'forked from. Establish the shape before you read anything:',
+        `- \`git diff --stat origin/${base}...HEAD\` for which files moved and by how much.`,
+        `- \`git diff origin/${base}...HEAD -- <path>\` for the change to a file or a directory.`,
+        'Plan the review from that diffstat: it already tells you which files this change is about, so ' +
+            'do not go looking for them. Read a changed file in full where the diff alone cannot settle ' +
+            'whether it is correct, and read unchanged code where you need it for context.',
+    ];
+    if (dispatch.multiRepo) {
+        lines.push(
+        // What is true of a peer leg and no more. An explore peer carries `cloneBranch` only when the
+        // caller pinned one (today only the merger's combined-diff builder does), so a peer is
+        // otherwise checked out at its OWN default branch: claiming they share this branch would send
+        // the reviewer to run a diff that resolves to nothing and read the emptiness as a verdict.
+        'This change spans MULTIPLE repositories, each checked out as a sibling directory. Establish ' +
+            "each one's own base the same way before you read it, and rate the COMBINED change as a " +
+            'single verdict, not one per repository.');
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=companion.js.map