@wirecat/cli-core 0.376.0 → 0.377.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ shape of this file.
 
 ## Unreleased
 
+## 0.377.0 — 20.10.2026
+
+### Added
+
+- **A document hit says how many other paragraphs match.** `ProjectEvidenceItem.moreMatches` (on a document item
+  with `around`) counts the paragraphs after the one `around` centres on that also name a lane word. See
+  [project gathering](docs/dev/PROJECT-GATHERING.md).
+
+### Fixed
+
+- **A document hit's `around` followed the lane that found it first, not the document.** It centred on that lane's
+  first matching paragraph (in a measured 145 KB document, paragraph 60 found by the key, not paragraph 4 that
+  names the project). It now centres on the first paragraph that names a word of any lane, in document order, as
+  the guide says. No extra reads or charged bytes.
+
 ## 0.376.0 — 20.10.2026
 
 ### Added

package/dist/services/project-gathering-around.d.ts

@@ -20,6 +20,20 @@ export interface ProjectNeighbourReader {
     }[]>;
 }
 export declare const storedMessageNeighbours: (messages: Pick<MessagesStore, "around">) => ProjectNeighbourReader;
+/**
+ * The paragraphs around the first one that names a word of any query, in document order, with the hit's own marked
+ * found, and how many later paragraphs name one too.
+ */
+export declare const documentMatches: (text: string, queries: string[], window: {
+    before: number;
+    after: number;
+}) => {
+    around: {
+        text: string;
+        found: boolean;
+    }[];
+    moreMatches: number;
+};
 /** The paragraphs around the first one that names the query, in document order; the hit's own is marked found. */
 export declare const documentPassage: (text: string, query: string, window: {
     before: number;

package/dist/services/project-gathering-around.js

@@ -19,22 +19,30 @@ export const storedMessageNeighbours = (messages) => ({
     },
 });
 const wordsOf = (text) => (text.match(/[\p{L}\p{N}\p{M}]+/gu) ?? []).map(fold);
-/** The paragraphs around the first one that names the query, in document order; the hit's own is marked found. */
-export const documentPassage = (text, query, window) => {
+/**
+ * The paragraphs around the first one that names a word of any query, in document order, with the hit's own marked
+ * found, and how many later paragraphs name one too.
+ */
+export const documentMatches = (text, queries, window) => {
     const paragraphs = text
         .split(/\n\s*\n/)
         .map((part) => part.replace(/\s+/g, " ").trim())
         .filter(Boolean);
+    const query = queries.join(" ");
     const words = new Set(wordsOf(query));
-    const hit = paragraphs.findIndex((part) => wordsOf(part).some((word) => words.has(word)));
-    if (hit < 0 || paragraphs.length < 2)
-        return [];
+    const matching = paragraphs.flatMap((part, index) => (wordsOf(part).some((word) => words.has(word)) ? [index] : []));
+    const hit = matching[0];
+    if (hit === undefined || paragraphs.length < 2)
+        return { around: [], moreMatches: 0 };
     const from = Math.max(0, hit - window.before);
-    return paragraphs.slice(from, hit + window.after + 1).map((part, index) => ({
+    const around = paragraphs.slice(from, hit + window.after + 1).map((part, index) => ({
         text: excerpt(part, query, 200, { literal: true }),
         found: from + index === hit,
     }));
+    return { around, moreMatches: matching.length - 1 };
 };
+/** The paragraphs around the first one that names the query, in document order; the hit's own is marked found. */
+export const documentPassage = (text, query, window) => documentMatches(text, [query], window).around;
 /**
  * Neighbours are context for reading a hit, not matches: they never join `items`, and their text counts against
  * the run's read bytes.

package/dist/services/project-gathering.d.ts

@@ -36,6 +36,8 @@ export interface ProjectEvidenceItem extends Omit<ContextEvidenceItem, "text"> {
     fingerprint: string;
     around?: ProjectNeighbour[] | null;
     aroundIssue?: string | null;
+    /** A document hit with `around`: how many paragraphs after the one it centres on also name a lane word. */
+    moreMatches?: number;
 }
 /** Strongest first: a hit that names the project, then one only from a linked chat, then one naming only a person. */
 export type ProjectEvidenceContext = "project" | "linked-chat" | "person-only";

package/dist/services/project-gathering.js

@@ -2,7 +2,7 @@ import { CliError } from "@wirecat/cli-base";
 import { CONTEXT_MAX_READ_BYTES, contextEvidenceFingerprint } from "../context/evidence.js";
 import { createContextEvidenceReader } from "./context-evidence.js";
 import { excerpt } from "./excerpt.js";
-import { attachNeighbours, documentPassage, } from "./project-gathering-around.js";
+import { attachNeighbours, documentMatches, } from "./project-gathering-around.js";
 import { decodeCheckpoint, encodeCheckpoint, projectGatheringRequest, projectUnits, seenKey, } from "./project-gathering-request.js";
 const terminal = new Set(["done", "unavailable", "failed"]);
 const CONTEXTS = ["person-only", "linked-chat", "project"];
@@ -31,6 +31,7 @@ export const gatherProjectEvidence = async (ports, request) => {
         plan.sources.map(() => ({ state: "not-requested", history: null, code: null }));
     const seen = new Set(previous?.seen ?? []);
     const signal = plan.signal;
+    const queries = plan.lanes.flatMap((lane) => (lane.query === null ? [] : [lane.query]));
     if (plan.fetch === "before-read" && !ports.fetcher)
         throw new CliError("configuration_error", "this host cannot fetch source history; use fetch none", {
             param: "fetch",
@@ -114,8 +115,10 @@ export const gatherProjectEvidence = async (ports, request) => {
             context: contextOf(lane),
         };
         if (kind === "document" && lane.query !== null && plan.around.before + plan.around.after) {
+            const passage = documentMatches(item.text, queries, plan.around);
             entry.around = [];
-            for (const part of documentPassage(item.text, lane.query, plan.around)) {
+            entry.moreMatches = passage.moreMatches;
+            for (const part of passage.around) {
                 const bytes = Buffer.byteLength(part.text);
                 if (bytes > plan.budgets.maxReadBytes - usage.readBytes - usage.aroundBytes) {
                     entry.aroundIssue = "read-bytes";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.376.0",
+  "version": "0.377.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",