npm - @grepr/cli - Versions diffs - 1.12.6-1abf9fb → 1.12.6-2c9d4d7 - Mend

@@ -16,7 +16,7 @@ Files a new issue. Creating never deduplicates: search first, and update or reco
 - name: entities (optional)
   type: object
-  description: The `entity:*` tags it concerns; an unprefixed key is put in the `entity:` namespace.
+  description: The `entity:*` tags it concerns; an unprefixed key is put in the `entity:` namespace. Keys are stored in lower case, and values as given; searches match both in any case.
 - name: evidence (optional)
   type: array of `IssueEvidence`

@@ -32,7 +32,7 @@ One durable problem or task on the organization's issue board.
 - name: entities (optional)
   type: object
-  description: The `entity:*` tags it concerns, the same vocabulary as memory tags, sorted by key.
+  description: The `entity:*` tags it concerns, the same vocabulary as memory tags, keys in lower case, sorted by key.
 - name: evidence (optional)
   type: array of `IssueEvidence`

@@ -1,6 +1,6 @@
 # IssueGuidanceRead
-One investigation whose agent was given a guidance comment in its known-issues context.
+One investigation whose agent was given a guidance comment: returned by its `get_issue`, or in the issue it was handed.
 **Type**: `object`

@@ -11,7 +11,7 @@ Filters for searching the issues the caller can see. Every filter is optional; a
 - name: closedWithinDays (optional)
   type: integer
-  description: Include closed issues closed within this many days. Absent: 30 when `states` is absent, and no window when it is given.
+  description: Include closed issues closed within this many days. Absent: 30 when `states` is absent, with those closed as IGNORED or NOT_A_PROBLEM kept at any age, and no window when it is given. Given, it's exact.
 - name: cursor (optional)
   type: string
@@ -19,7 +19,7 @@ Filters for searching the issues the caller can see. Every filter is optional; a
 - name: entities (optional)
   type: object
-  description: Entity tags to match: every key must match, and any of a key's values matches it. An unprefixed key is put in the `entity:` namespace.
+  description: Entity tags to match: every key must match, and any of a key's values matches it. Keys and values match in any case. An unprefixed key is put in the `entity:` namespace.
 - name: fingerprint (optional)
   type: string
@@ -42,11 +42,11 @@ Filters for searching the issues the caller can see. Every filter is optional; a
 - name: query (optional)
   type: string
-  description: Full-text search over titles, descriptions and comments.
+  description: Words to search the whole issue for, comments included, split and stemmed as the issue is, so checkout-api is also checkout and api: an issue matches when it has any one of them, and those with the most, above all in their title, fingerprint and entities, come first.
 - name: states (optional)
   type: array of enum: `TRIAGE`, `READY`, `IN_PROGRESS`, `WAITING`, `MONITORING`, `CLOSED`
-  description: Only issues in these states. Absent: open issues plus those closed within `closedWithinDays`.
+  description: Only issues in these states. Absent: open issues plus those closed within `closedWithinDays`, and, when that is absent too, those closed as IGNORED or NOT_A_PROBLEM at any age.
 - name: teamIds (optional)
   type: array of string

@@ -12,7 +12,7 @@ Request body for the manual-trigger endpoint. The engineer's user identity is ta
 - name: issueId (optional)
   type: string
-  description: When set, hands the agent this issue (its TSID): the run's subject, which its known issues hold alone and whose history records the handoff. Only a person may hand off an issue, and a handoff can't be a continuation. `null` for a plain run.
+  description: When set, hands the agent this issue (its TSID): the run's subject, which its first message holds and whose history records the handoff. Only a person may hand off an issue, and a handoff can't be a continuation. `null` for a plain run.
 - name: next (optional)
   type: boolean

@@ -1,6 +1,6 @@
 {
   "name": "@grepr/cli",
-  "version": "1.12.6-1abf9fb",
+  "version": "1.12.6-2c9d4d7",
   "description": "Official Grepr CLI tool for submitting synchronous batch jobs with OAuth authentication",
   "main": "build/dist/grepr.js",
   "type": "module",

@grepr/cli 1.12.6-1abf9fb → 1.12.6-2c9d4d7