@cat-factory/contracts 0.346.2 → 0.347.0

package/dist/bugFishing.d.ts

@@ -57,6 +57,147 @@ export type BugFishingFindingKind = v.InferOutput<typeof bugFishingFindingKindSc
 /** How sure the agent is that the finding is real — its own judgement, never platform-derived. */
 export declare const bugFishingConfidenceSchema: v.PicklistSchema<["high", "medium", "low"], undefined>;
 export type BugFishingConfidence = v.InferOutput<typeof bugFishingConfidenceSchema>;
+/**
+ * The most container dispatches one expedition may make when nobody names a number.
+ *
+ * Three times today's eight-angle expedition. This is a COUNT, not a spend gate: the engine
+ * already runs the workspace's budget check before every dispatch, so an over-budget workspace
+ * pauses between passes regardless. What this bounds is a run that is within budget and
+ * unreasonably long, which is what a partitioned codebase makes possible: six territories under
+ * eight angles is forty-eight passes, and most of that matrix is not worth fishing.
+ */
+export declare const BUG_FISHING_DEFAULT_PASS_BUDGET = 24;
+/** The most a task may raise its own pass budget to. */
+export declare const BUG_FISHING_MAX_PASS_BUDGET = 96;
+/**
+ * The most paths one pass's `filesRead` may carry before the list stops being a coverage report.
+ *
+ * A territory is sized to what one pass can read a meaningful share of, so its manifest is
+ * hundreds of files and never thousands. This is the shape backstop above that, not a limit an
+ * honest pass approaches.
+ */
+export declare const BUG_FISHING_MAX_FILES_READ = 2000;
+/**
+ * A cohesive slice of the codebase the expedition fishes as one unit.
+ *
+ * A large codebase cannot be fished as one scope: a pass told to "decide where this angle could
+ * bite, then read narrowly" reads whatever its first grep pointed at, and a module nobody read
+ * then reports exactly like a module that was read and found clean. Territories are the platform
+ * COMPUTING the partition (from the repository tree, blueprint modules first, then package and
+ * directory boundaries) so the model can go on judging code rather than inventing a module map.
+ *
+ * A territory id is an OPEN vocabulary, unlike a phase id: it is derived from the tree, and the
+ * tree moves. Nothing looks a territory up by id at render time, which is why the label and the
+ * roots are RECORDED here rather than re-derived: a phase whose territory a later survey no
+ * longer produces is still rendered from what the run itself fished.
+ */
+export declare const bugFishingTerritorySchema: v.ObjectSchema<{
+    /** Stable within one expedition; derived from the territory's root path. */
+    readonly id: v.StringSchema<undefined>;
+    /** Human label (the module name, or the directory the territory is rooted at). */
+    readonly label: v.StringSchema<undefined>;
+    /** Repo-relative roots the territory owns. Empty ⇒ the whole codebase (the single-territory case). */
+    readonly roots: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+    /** How many source files the manifest counted under those roots. */
+    readonly fileCount: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    /**
+     * Approximate source tokens (bytes / 4 over the tree's blob sizes). The sizing input, and what
+     * the window shows a human deciding whether a low coverage share is a big territory or a lazy
+     * pass. Approximate is stated in the NAME, because it is a byte estimate and never a count.
+     */
+    readonly approxTokens: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    /**
+     * How the territory was derived, so a reader can tell a blueprint's own decomposition from the
+     * fallback the platform computed for a repository that has never been blueprinted.
+     */
+    readonly source: v.OptionalSchema<v.PicklistSchema<["blueprint", "directory", "whole-codebase"], undefined>, "directory">;
+    /**
+     * The subtree shas of the territory's roots, one per root, in `roots` order. A string compare
+     * against a later survey answers "has this territory changed since it was fished" with no diff.
+     * Recorded now because it comes free with the tree read.
+     */
+    readonly subtreeShas: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+}, undefined>;
+export type BugFishingTerritory = v.InferOutput<typeof bugFishingTerritorySchema>;
+/**
+ * The single territory a codebase small enough to fish whole is partitioned into.
+ *
+ * Named rather than spelled out at each site because the PASS-THROUGH is a property worth
+ * pinning: a small repository plans one territory, its phases carry no territory id, and the
+ * expedition it gets is byte-for-byte the one that shipped before territories existed.
+ */
+export declare const WHOLE_CODEBASE_TERRITORY_ID = "whole-codebase";
+/**
+ * One cell of the matrix that was planned but NOT fished, because the pass budget ran out.
+ *
+ * A cap silent about its tail teaches the reader that the tail was clean. This is the tail,
+ * named: which angle over which territory nobody looked at on this run.
+ */
+export declare const bugFishingUnfishedCellSchema: v.ObjectSchema<{
+    readonly territoryId: v.StringSchema<undefined>;
+    /** The territory's label as it stood when the plan was made (never looked up at render time). */
+    readonly territoryLabel: v.StringSchema<undefined>;
+    readonly phaseId: v.StringSchema<undefined>;
+    /** The angle's label as it stood when the plan was made. */
+    readonly phaseTitle: v.StringSchema<undefined>;
+}, undefined>;
+export type BugFishingUnfishedCell = v.InferOutput<typeof bugFishingUnfishedCellSchema>;
+/**
+ * What the expedition DECIDED to fish, and what it decided not to.
+ *
+ * Written before the first pass runs, so the window can state the shape of the hunt while it is
+ * still in flight, and so the record of an expedition a human stopped early says what was left.
+ */
+export declare const bugFishingPlanSchema: v.ObjectSchema<{
+    /** Most dispatches this expedition may make. */
+    readonly passBudget: v.NumberSchema<undefined>;
+    /** How many cells the full (territory x angle) matrix had, before the budget trimmed it. */
+    readonly plannedCells: v.NumberSchema<undefined>;
+    /** The cells the budget cut, by territory and angle. Empty when the matrix fitted. */
+    readonly unfished: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly territoryId: v.StringSchema<undefined>;
+        /** The territory's label as it stood when the plan was made (never looked up at render time). */
+        readonly territoryLabel: v.StringSchema<undefined>;
+        readonly phaseId: v.StringSchema<undefined>;
+        /** The angle's label as it stood when the plan was made. */
+        readonly phaseTitle: v.StringSchema<undefined>;
+    }, undefined>, undefined>, readonly []>;
+    /**
+     * True when the provider TRUNCATED the tree the survey partitioned. A truncated tree is not a
+     * manifest: the territories cover what was read, and the coverage record below is a share of
+     * that rather than of the repository. Stated because the two readings are opposite and nothing
+     * else in the record can tell them apart.
+     */
+    readonly treeTruncated: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    /**
+     * Set when the codebase survey could not run at all (no repository bound to the run, or the
+     * bound client cannot enumerate a tree). The expedition then fishes the whole codebase as one
+     * territory, which is the shipped behaviour, and this says WHY rather than leaving a
+     * single-territory plan looking like a small repository.
+     */
+    readonly surveyUnavailableReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type BugFishingPlan = v.InferOutput<typeof bugFishingPlanSchema>;
+/**
+ * What one pass actually read, intersected with its territory's manifest.
+ *
+ * SELF-REPORTED, and the record says so in the field name: the agent lists the paths it read and
+ * the engine computes the share against the manifest it handed over. A territory with a low share
+ * is what tells a human that "found nothing" here means "did not look", which is the distinction
+ * the whole partition exists to preserve. Verifying it against the tool-call trajectory sink is a
+ * later, different producer, and would say so.
+ */
+export declare const bugFishingCoverageSchema: v.ObjectSchema<{
+    /** How many manifest files the pass reported reading. */
+    readonly filesRead: v.NumberSchema<undefined>;
+    /** How many files the territory's manifest held. Zero ⇒ nothing to be a share OF. */
+    readonly manifestFiles: v.NumberSchema<undefined>;
+    /** Paths the pass reported that the manifest does not have (a wander, or a stale read). */
+    readonly offManifest: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+    /** Always `self-reported` today; the field exists so a verified record can say it is one. */
+    readonly source: v.OptionalSchema<v.PicklistSchema<["self-reported"], undefined>, "self-reported">;
+}, undefined>;
+export type BugFishingCoverage = v.InferOutput<typeof bugFishingCoverageSchema>;
 /** A phase's lifecycle across the expedition's successive dispatches. */
 export declare const bugFishingPhaseStatusSchema: v.PicklistSchema<["pending", "fishing", "completed", "failed"], undefined>;
 export type BugFishingPhaseStatus = v.InferOutput<typeof bugFishingPhaseStatusSchema>;
@@ -81,6 +222,36 @@ export declare const bugFishingPhaseSchema: v.ObjectSchema<{
     readonly settledAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
     /** Why the pass failed, when it did. Null otherwise. */
     readonly failureReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /**
+     * The territory this pass fished, or null for the whole codebase. Null is what every
+     * expedition stored before territories existed carries, and what a small codebase still
+     * carries today, so a stored run parses unchanged either way.
+     */
+    readonly territoryId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /**
+     * The territory's label as it stood when this pass ran. Recorded rather than looked up: a
+     * territory is derived from the tree, and a later survey of a moved tree may not produce it.
+     */
+    readonly territoryLabel: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /** What the pass reported reading, against the manifest it was given. Null when it reported none. */
+    readonly coverage: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        /** How many manifest files the pass reported reading. */
+        readonly filesRead: v.NumberSchema<undefined>;
+        /** How many files the territory's manifest held. Zero ⇒ nothing to be a share OF. */
+        readonly manifestFiles: v.NumberSchema<undefined>;
+        /** Paths the pass reported that the manifest does not have (a wander, or a stale read). */
+        readonly offManifest: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+        /** Always `self-reported` today; the field exists so a verified record can say it is one. */
+        readonly source: v.OptionalSchema<v.PicklistSchema<["self-reported"], undefined>, "self-reported">;
+    }, undefined>, undefined>, undefined>;
+    /**
+     * How many findings were dropped for pointing OUTSIDE this pass's territory. The brief tells a
+     * pass what it is not responsible for and the platform holds it to that at coercion, so a pass
+     * that wanders is corrected rather than exhorted. Counted rather than silent, so a human can
+     * see how often it happens. Absent on a pass that was never scoped to a territory, which is a
+     * different fact from a scoped pass that dropped none.
+     */
+    readonly outOfScopeFindings: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
 }, undefined>;
 export type BugFishingPhase = v.InferOutput<typeof bugFishingPhaseSchema>;
 /**
@@ -166,6 +337,8 @@ export declare const bugFishingFindingSchema: v.ObjectSchema<{
     readonly id: v.StringSchema<undefined>;
     /** The phase that surfaced it (a phase id; see {@link describeBugFishingPhase}). */
     readonly phaseId: v.StringSchema<undefined>;
+    /** The territory the pass was fishing, or null for a whole-codebase pass. */
+    readonly territoryId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     /** Repo-relative path the finding concerns; empty when it is not anchored to one file. */
     readonly path: v.StringSchema<undefined>;
     /** The line the finding anchors to, or null. */
@@ -249,6 +422,36 @@ export declare const bugFishingStepStateSchema: v.ObjectSchema<{
         readonly settledAt: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         /** Why the pass failed, when it did. Null otherwise. */
         readonly failureReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /**
+         * The territory this pass fished, or null for the whole codebase. Null is what every
+         * expedition stored before territories existed carries, and what a small codebase still
+         * carries today, so a stored run parses unchanged either way.
+         */
+        readonly territoryId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /**
+         * The territory's label as it stood when this pass ran. Recorded rather than looked up: a
+         * territory is derived from the tree, and a later survey of a moved tree may not produce it.
+         */
+        readonly territoryLabel: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+        /** What the pass reported reading, against the manifest it was given. Null when it reported none. */
+        readonly coverage: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+            /** How many manifest files the pass reported reading. */
+            readonly filesRead: v.NumberSchema<undefined>;
+            /** How many files the territory's manifest held. Zero ⇒ nothing to be a share OF. */
+            readonly manifestFiles: v.NumberSchema<undefined>;
+            /** Paths the pass reported that the manifest does not have (a wander, or a stale read). */
+            readonly offManifest: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+            /** Always `self-reported` today; the field exists so a verified record can say it is one. */
+            readonly source: v.OptionalSchema<v.PicklistSchema<["self-reported"], undefined>, "self-reported">;
+        }, undefined>, undefined>, undefined>;
+        /**
+         * How many findings were dropped for pointing OUTSIDE this pass's territory. The brief tells a
+         * pass what it is not responsible for and the platform holds it to that at coercion, so a pass
+         * that wanders is corrected rather than exhorted. Counted rather than silent, so a human can
+         * see how often it happens. Absent on a pass that was never scoped to a territory, which is a
+         * different fact from a scoped pass that dropped none.
+         */
+        readonly outOfScopeFindings: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>, undefined>, readonly []>;
     /**
      * Index into {@link bugFishingStepStateSchema}'s `phases` of the pass currently being fished
@@ -263,6 +466,8 @@ export declare const bugFishingStepStateSchema: v.ObjectSchema<{
         readonly id: v.StringSchema<undefined>;
         /** The phase that surfaced it (a phase id; see {@link describeBugFishingPhase}). */
         readonly phaseId: v.StringSchema<undefined>;
+        /** The territory the pass was fishing, or null for a whole-codebase pass. */
+        readonly territoryId: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         /** Repo-relative path the finding concerns; empty when it is not anchored to one file. */
         readonly path: v.StringSchema<undefined>;
         /** The line the finding anchors to, or null. */
@@ -308,6 +513,74 @@ export declare const bugFishingStepStateSchema: v.ObjectSchema<{
         /** Set when a human dismissed the finding: it stays on the record, struck through. */
         readonly dismissed: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
     }, undefined>, undefined>, readonly []>;
+    /**
+     * The partition the survey computed, in the order the expedition fishes them. One entry whose
+     * `source` is `whole-codebase` for a codebase small enough to fish whole.
+     *
+     * DESCRIPTORS only, never file lists: this rides the run's `detail` blob, re-serialised on
+     * every progress write, and a thousand paths per territory would put the manifest in the blob
+     * thirty times over. The per-pass manifest is re-rendered from the cached tree at dispatch.
+     *
+     * ABSENT, never `[]`, on an expedition that predates territories: an empty array would claim
+     * the codebase was surveyed and found to contain nothing.
+     */
+    readonly territories: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** Stable within one expedition; derived from the territory's root path. */
+        readonly id: v.StringSchema<undefined>;
+        /** Human label (the module name, or the directory the territory is rooted at). */
+        readonly label: v.StringSchema<undefined>;
+        /** Repo-relative roots the territory owns. Empty ⇒ the whole codebase (the single-territory case). */
+        readonly roots: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+        /** How many source files the manifest counted under those roots. */
+        readonly fileCount: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+        /**
+         * Approximate source tokens (bytes / 4 over the tree's blob sizes). The sizing input, and what
+         * the window shows a human deciding whether a low coverage share is a big territory or a lazy
+         * pass. Approximate is stated in the NAME, because it is a byte estimate and never a count.
+         */
+        readonly approxTokens: v.OptionalSchema<v.NumberSchema<undefined>, 0>;
+        /**
+         * How the territory was derived, so a reader can tell a blueprint's own decomposition from the
+         * fallback the platform computed for a repository that has never been blueprinted.
+         */
+        readonly source: v.OptionalSchema<v.PicklistSchema<["blueprint", "directory", "whole-codebase"], undefined>, "directory">;
+        /**
+         * The subtree shas of the territory's roots, one per root, in `roots` order. A string compare
+         * against a later survey answers "has this territory changed since it was fished" with no diff.
+         * Recorded now because it comes free with the tree read.
+         */
+        readonly subtreeShas: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+    }, undefined>, undefined>, undefined>;
+    /** What the expedition planned to fish, and what the pass budget cut. */
+    readonly plan: v.OptionalSchema<v.NullableSchema<v.ObjectSchema<{
+        /** Most dispatches this expedition may make. */
+        readonly passBudget: v.NumberSchema<undefined>;
+        /** How many cells the full (territory x angle) matrix had, before the budget trimmed it. */
+        readonly plannedCells: v.NumberSchema<undefined>;
+        /** The cells the budget cut, by territory and angle. Empty when the matrix fitted. */
+        readonly unfished: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly territoryId: v.StringSchema<undefined>;
+            /** The territory's label as it stood when the plan was made (never looked up at render time). */
+            readonly territoryLabel: v.StringSchema<undefined>;
+            readonly phaseId: v.StringSchema<undefined>;
+            /** The angle's label as it stood when the plan was made. */
+            readonly phaseTitle: v.StringSchema<undefined>;
+        }, undefined>, undefined>, readonly []>;
+        /**
+         * True when the provider TRUNCATED the tree the survey partitioned. A truncated tree is not a
+         * manifest: the territories cover what was read, and the coverage record below is a share of
+         * that rather than of the repository. Stated because the two readings are opposite and nothing
+         * else in the record can tell them apart.
+         */
+        readonly treeTruncated: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+        /**
+         * Set when the codebase survey could not run at all (no repository bound to the run, or the
+         * bound client cannot enumerate a tree). The expedition then fishes the whole codebase as one
+         * territory, which is the shipped behaviour, and this says WHY rather than leaving a
+         * single-territory plan looking like a small repository.
+         */
+        readonly surveyUnavailableReason: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     /** Identifier of the model that fished, for transparency. */
     readonly model: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     /**
@@ -329,6 +602,18 @@ export type BugFishingStepState = v.InferOutput<typeof bugFishingStepStateSchema
 export declare const bugFishingAgentOutputSchema: v.ObjectSchema<{
     /** What this pass covered and what it concluded, in one paragraph. */
     readonly summary: v.SchemaWithFallback<v.OptionalSchema<v.StringSchema<undefined>, undefined>, undefined>;
+    /**
+     * The paths this pass actually READ, in the frame the agent works in (its own working directory,
+     * which is the service's subtree in a monorepo), so the engine can compute a coverage record
+     * against the territory manifest it handed over.
+     *
+     * Bounded in the schema rather than only in the prompt, and the bound is a BACKSTOP well above
+     * any real territory: {@link BUG_FISHING_MAX_FILES_READ} paths is more than a manifest sized for
+     * one pass can hold, so an honest pass never meets it. A list that overruns it is not a coverage
+     * report at all, and falls back to none: the phase then records NO coverage, the same answer a
+     * pass that listed nothing gets, because neither one said anything the platform can count.
+     */
+    readonly filesRead: v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithFallback<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, "">, undefined>, v.MaxLengthAction<string[], 2000, undefined>]>, readonly []>;
     /** The findings this pass surfaced. */
     readonly findings: v.SchemaWithFallback<v.ArraySchema<v.SchemaWithFallback<v.ObjectSchema<{
         readonly path: v.SchemaWithFallback<v.StringSchema<undefined>, "">;

package/dist/bugFishing.d.ts.map

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

package/dist/bugFishing.js

@@ -169,6 +169,137 @@ export const bugFishingFindingKindSchema = v.picklist([
 ]);
 /** How sure the agent is that the finding is real — its own judgement, never platform-derived. */
 export const bugFishingConfidenceSchema = v.picklist(['high', 'medium', 'low']);
+/**
+ * The most container dispatches one expedition may make when nobody names a number.
+ *
+ * Three times today's eight-angle expedition. This is a COUNT, not a spend gate: the engine
+ * already runs the workspace's budget check before every dispatch, so an over-budget workspace
+ * pauses between passes regardless. What this bounds is a run that is within budget and
+ * unreasonably long, which is what a partitioned codebase makes possible: six territories under
+ * eight angles is forty-eight passes, and most of that matrix is not worth fishing.
+ */
+export const BUG_FISHING_DEFAULT_PASS_BUDGET = 24;
+/** The most a task may raise its own pass budget to. */
+export const BUG_FISHING_MAX_PASS_BUDGET = 96;
+/**
+ * The most paths one pass's `filesRead` may carry before the list stops being a coverage report.
+ *
+ * A territory is sized to what one pass can read a meaningful share of, so its manifest is
+ * hundreds of files and never thousands. This is the shape backstop above that, not a limit an
+ * honest pass approaches.
+ */
+export const BUG_FISHING_MAX_FILES_READ = 2_000;
+// ---- Territories: the partition of a large codebase --------------------------
+/**
+ * A cohesive slice of the codebase the expedition fishes as one unit.
+ *
+ * A large codebase cannot be fished as one scope: a pass told to "decide where this angle could
+ * bite, then read narrowly" reads whatever its first grep pointed at, and a module nobody read
+ * then reports exactly like a module that was read and found clean. Territories are the platform
+ * COMPUTING the partition (from the repository tree, blueprint modules first, then package and
+ * directory boundaries) so the model can go on judging code rather than inventing a module map.
+ *
+ * A territory id is an OPEN vocabulary, unlike a phase id: it is derived from the tree, and the
+ * tree moves. Nothing looks a territory up by id at render time, which is why the label and the
+ * roots are RECORDED here rather than re-derived: a phase whose territory a later survey no
+ * longer produces is still rendered from what the run itself fished.
+ */
+export const bugFishingTerritorySchema = v.object({
+    /** Stable within one expedition; derived from the territory's root path. */
+    id: v.string(),
+    /** Human label (the module name, or the directory the territory is rooted at). */
+    label: v.string(),
+    /** Repo-relative roots the territory owns. Empty ⇒ the whole codebase (the single-territory case). */
+    roots: v.optional(v.array(v.string()), []),
+    /** How many source files the manifest counted under those roots. */
+    fileCount: v.optional(v.number(), 0),
+    /**
+     * Approximate source tokens (bytes / 4 over the tree's blob sizes). The sizing input, and what
+     * the window shows a human deciding whether a low coverage share is a big territory or a lazy
+     * pass. Approximate is stated in the NAME, because it is a byte estimate and never a count.
+     */
+    approxTokens: v.optional(v.number(), 0),
+    /**
+     * How the territory was derived, so a reader can tell a blueprint's own decomposition from the
+     * fallback the platform computed for a repository that has never been blueprinted.
+     */
+    source: v.optional(v.picklist(['blueprint', 'directory', 'whole-codebase']), 'directory'),
+    /**
+     * The subtree shas of the territory's roots, one per root, in `roots` order. A string compare
+     * against a later survey answers "has this territory changed since it was fished" with no diff.
+     * Recorded now because it comes free with the tree read.
+     */
+    subtreeShas: v.optional(v.array(v.string()), []),
+});
+/**
+ * The single territory a codebase small enough to fish whole is partitioned into.
+ *
+ * Named rather than spelled out at each site because the PASS-THROUGH is a property worth
+ * pinning: a small repository plans one territory, its phases carry no territory id, and the
+ * expedition it gets is byte-for-byte the one that shipped before territories existed.
+ */
+export const WHOLE_CODEBASE_TERRITORY_ID = 'whole-codebase';
+/**
+ * One cell of the matrix that was planned but NOT fished, because the pass budget ran out.
+ *
+ * A cap silent about its tail teaches the reader that the tail was clean. This is the tail,
+ * named: which angle over which territory nobody looked at on this run.
+ */
+export const bugFishingUnfishedCellSchema = v.object({
+    territoryId: v.string(),
+    /** The territory's label as it stood when the plan was made (never looked up at render time). */
+    territoryLabel: v.string(),
+    phaseId: v.string(),
+    /** The angle's label as it stood when the plan was made. */
+    phaseTitle: v.string(),
+});
+/**
+ * What the expedition DECIDED to fish, and what it decided not to.
+ *
+ * Written before the first pass runs, so the window can state the shape of the hunt while it is
+ * still in flight, and so the record of an expedition a human stopped early says what was left.
+ */
+export const bugFishingPlanSchema = v.object({
+    /** Most dispatches this expedition may make. */
+    passBudget: v.number(),
+    /** How many cells the full (territory x angle) matrix had, before the budget trimmed it. */
+    plannedCells: v.number(),
+    /** The cells the budget cut, by territory and angle. Empty when the matrix fitted. */
+    unfished: v.optional(v.array(bugFishingUnfishedCellSchema), []),
+    /**
+     * True when the provider TRUNCATED the tree the survey partitioned. A truncated tree is not a
+     * manifest: the territories cover what was read, and the coverage record below is a share of
+     * that rather than of the repository. Stated because the two readings are opposite and nothing
+     * else in the record can tell them apart.
+     */
+    treeTruncated: v.optional(v.boolean(), false),
+    /**
+     * Set when the codebase survey could not run at all (no repository bound to the run, or the
+     * bound client cannot enumerate a tree). The expedition then fishes the whole codebase as one
+     * territory, which is the shipped behaviour, and this says WHY rather than leaving a
+     * single-territory plan looking like a small repository.
+     */
+    surveyUnavailableReason: v.optional(v.nullable(v.string())),
+});
+/**
+ * What one pass actually read, intersected with its territory's manifest.
+ *
+ * SELF-REPORTED, and the record says so in the field name: the agent lists the paths it read and
+ * the engine computes the share against the manifest it handed over. A territory with a low share
+ * is what tells a human that "found nothing" here means "did not look", which is the distinction
+ * the whole partition exists to preserve. Verifying it against the tool-call trajectory sink is a
+ * later, different producer, and would say so.
+ */
+export const bugFishingCoverageSchema = v.object({
+    /** How many manifest files the pass reported reading. */
+    filesRead: v.number(),
+    /** How many files the territory's manifest held. Zero ⇒ nothing to be a share OF. */
+    manifestFiles: v.number(),
+    /** Paths the pass reported that the manifest does not have (a wander, or a stale read). */
+    offManifest: v.optional(v.number(), 0),
+    /** Always `self-reported` today; the field exists so a verified record can say it is one. */
+    source: v.optional(v.picklist(['self-reported']), 'self-reported'),
+});
 /** A phase's lifecycle across the expedition's successive dispatches. */
 export const bugFishingPhaseStatusSchema = v.picklist(['pending', 'fishing', 'completed', 'failed']);
 /**
@@ -192,6 +323,27 @@ export const bugFishingPhaseSchema = v.object({
     settledAt: v.optional(v.nullable(v.number())),
     /** Why the pass failed, when it did. Null otherwise. */
     failureReason: v.optional(v.nullable(v.string())),
+    /**
+     * The territory this pass fished, or null for the whole codebase. Null is what every
+     * expedition stored before territories existed carries, and what a small codebase still
+     * carries today, so a stored run parses unchanged either way.
+     */
+    territoryId: v.optional(v.nullable(v.string())),
+    /**
+     * The territory's label as it stood when this pass ran. Recorded rather than looked up: a
+     * territory is derived from the tree, and a later survey of a moved tree may not produce it.
+     */
+    territoryLabel: v.optional(v.nullable(v.string())),
+    /** What the pass reported reading, against the manifest it was given. Null when it reported none. */
+    coverage: v.optional(v.nullable(bugFishingCoverageSchema)),
+    /**
+     * How many findings were dropped for pointing OUTSIDE this pass's territory. The brief tells a
+     * pass what it is not responsible for and the platform holds it to that at coercion, so a pass
+     * that wanders is corrected rather than exhorted. Counted rather than silent, so a human can
+     * see how often it happens. Absent on a pass that was never scoped to a territory, which is a
+     * different fact from a scoped pass that dropped none.
+     */
+    outOfScopeFindings: v.optional(v.number()),
 });
 /**
  * How far a marked finding's spawn has got.
@@ -282,6 +434,8 @@ export const bugFishingFindingSchema = v.object({
     id: v.string(),
     /** The phase that surfaced it (a phase id; see {@link describeBugFishingPhase}). */
     phaseId: v.string(),
+    /** The territory the pass was fishing, or null for a whole-codebase pass. */
+    territoryId: v.optional(v.nullable(v.string())),
     /** Repo-relative path the finding concerns; empty when it is not anchored to one file. */
     path: v.string(),
     /** The line the finding anchors to, or null. */
@@ -341,6 +495,20 @@ export const bugFishingStepStateSchema = v.object({
     currentPhaseIndex: v.optional(v.number(), 0),
     /** Every finding surfaced so far, oldest phase first, severity-ordered within a phase. */
     findings: v.optional(v.array(bugFishingFindingSchema), []),
+    /**
+     * The partition the survey computed, in the order the expedition fishes them. One entry whose
+     * `source` is `whole-codebase` for a codebase small enough to fish whole.
+     *
+     * DESCRIPTORS only, never file lists: this rides the run's `detail` blob, re-serialised on
+     * every progress write, and a thousand paths per territory would put the manifest in the blob
+     * thirty times over. The per-pass manifest is re-rendered from the cached tree at dispatch.
+     *
+     * ABSENT, never `[]`, on an expedition that predates territories: an empty array would claim
+     * the codebase was surveyed and found to contain nothing.
+     */
+    territories: v.optional(v.array(bugFishingTerritorySchema)),
+    /** What the expedition planned to fish, and what the pass budget cut. */
+    plan: v.optional(v.nullable(bugFishingPlanSchema)),
     /** Identifier of the model that fished, for transparency. */
     model: v.optional(v.nullable(v.string())),
     /**
@@ -362,6 +530,18 @@ export const bugFishingStepStateSchema = v.object({
 export const bugFishingAgentOutputSchema = v.object({
     /** What this pass covered and what it concluded, in one paragraph. */
     summary: v.fallback(v.optional(v.string()), undefined),
+    /**
+     * The paths this pass actually READ, in the frame the agent works in (its own working directory,
+     * which is the service's subtree in a monorepo), so the engine can compute a coverage record
+     * against the territory manifest it handed over.
+     *
+     * Bounded in the schema rather than only in the prompt, and the bound is a BACKSTOP well above
+     * any real territory: {@link BUG_FISHING_MAX_FILES_READ} paths is more than a manifest sized for
+     * one pass can hold, so an honest pass never meets it. A list that overruns it is not a coverage
+     * report at all, and falls back to none: the phase then records NO coverage, the same answer a
+     * pass that listed nothing gets, because neither one said anything the platform can count.
+     */
+    filesRead: v.fallback(v.pipe(v.array(v.fallback(v.pipe(v.string(), v.maxLength(400)), '')), v.maxLength(BUG_FISHING_MAX_FILES_READ)), []),
     /** The findings this pass surfaced. */
     findings: v.fallback(v.array(v.fallback(v.object({
         path: v.fallback(v.string(), ''),

package/dist/bugFishing.js.map

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

package/dist/entities.d.ts

@@ -273,6 +273,7 @@ export declare const blockSchema: v.ObjectSchema<{
         readonly reviewSkillIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>, v.MaxLengthAction<string[], 8, undefined>]>, undefined>;
         readonly fishingPhaseIds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 60, undefined>]>, undefined>, v.MaxLengthAction<string[], 32, undefined>]>, undefined>;
         readonly fishingFocus: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+        readonly fishingMaxPasses: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 96, undefined>]>, undefined>;
         readonly custom: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>;
     }, undefined>, undefined>, undefined>;
     /**