Search tasks

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Project decisions `PROJECT#N`: the tasks whose `decisions` field names one of them, in any status, also after the decision is superseded. `empty()` matches tasks that name no decision. An address that is not a `decision` entry of a project's case is refused rather than read as «no tasks»",
+  "examples": [
+    [
+      "TRK#15"
+    ]
+  ],
+  "title": "Decision"
+}

Previous value: -"Fields to return: `assignee`, `checks`, `constraints`, `context`, `created_at`, `created_by`, `description`, `features`, `goal`, `id`, `key`, `output`, `parent`, `previous_keys`, `priority`, `project`, `status`, `title`, `updated_at`, `version`. The key always comes back; an empty list returns whole tasks. `features` brings the computed features: `blocked`, `open_questions`, `open_blocking_questions`, `open_remarks`, `last_summary_at`, `last_entry_at`. `parent` is the parent's key and title, or `null`"New value: +"Fields to return: `assignee`, `checks`, `constraints`, `context`, `created_at`, `created_by`, `description`, `features`, `goal`, `id`, `key`, `output`, `parent`, `previous_keys`, `priority`, `project`, `status`, `title`, `updated_at`, `version`. The key always comes back; an empty list returns whole tasks. `features` brings the computed features: `blocked`, `open_questions`, `open_blocking_questions`, `open_remarks`, `open_warnings`, `last_summary_at`, `last_entry_at`. `parent` is the parent's key and title, or `null`"

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "1 for tasks with an open `warning`, 0 for the rest",
+  "title": "Open Warnings"
+}

Previous value: -"Query language string. A condition is written `name: [operator] values`: the operator stands **after** the colon, unlike SQL — `status: in open, in_progress`, not `status in (open, in_progress)`. Parentheses group conditions, not values.\n\nWithout an operator a condition means equality, and comma-separated values mean membership: `status: open, in_progress` equals `status: in open, in_progress`.\n\nFields: `assignee`, `blocked`, `key`, `last_entry_at`, `open_blocking_questions`, `open_questions`, `open_remarks`, `parent`, `priority`, `project`, `remarks_in_work`, `status`, `text`. Operators: `=`, `!=`, `>`, `>=`, `<`, `<=`, `~` (substring), `!~`, `in`, `not in`; `empty()` matches tasks without a value. Conditions combine with `and` and `or`.\n\nExamples:\n- `project: TRK and status: open and blocked: false`\n- `status: in open, in_progress`\n- `priority: >= high and text: ~ login`\n- `assignee: empty() or open_questions: > 0`\n\nA string that does not parse is refused with `invalid_search_query` and the character position, plus the correct form in `details.hint` where the error position determines it"New value: +"Query language string. A condition is written `name: [operator] values`: the operator stands **after** the colon, unlike SQL — `status: in open, in_progress`, not `status in (open, in_progress)`. Parentheses group conditions, not values.\n\nWithout an operator a condition means equality, and comma-separated values mean membership: `status: open, in_progress` equals `status: in open, in_progress`.\n\nFields: `assignee`, `blocked`, `decision`, `key`, `last_entry_at`, `open_blocking_questions`, `open_questions`, `open_remarks`, `open_warnings`, `parent`, `priority`, `project`, `remarks_in_work`, `status`, `text`, `under`. Operators: `=`, `!=`, `>`, `>=`, `<`, `<=`, `~` (substring), `!~`, `in`, `not in`; `empty()` matches tasks without a value. Conditions combine with `and` and `or`.\n\nExamples:\n- `project: TRK and status: open and blocked: false`\n- `status: in open, in_progress`\n- `priority: >= high and text: ~ login`\n- `assignee: empty() or open_questions: > 0`\n\nA string that does not parse is refused with `invalid_search_query` and the character position, plus the correct form in `details.hint` where the error position determines it"

Previous value: -[
-  {
-    "items": {
-      "description": "Task status",
-      "enum": [
-        "backlog",
-        "open",
-        "in_progress",
-        "waiting",
-        "done",
-        "cancelled"
-      ],
-      "type": "string"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "description": "Task status",
+      "enum": [
+        "backlog",
+        "open",
+        "in_progress",
+        "done",
+        "cancelled"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Root task keys: all their descendants at any depth, without the roots. `parent` is the direct children only. An unknown key is refused",
+  "examples": [
+    [
+      "TRK-7"
+    ]
+  ],
+  "title": "Under"
+}

Added value: +{
+  "title": "Open Warnings",
+  "type": "integer"
+}

Previous value: -[
-  "blocked",
-  "open_questions",
-  "open_blocking_questions",
-  "open_remarks",
-  "last_summary_at",
-  "last_entry_at"
-]New value: +[
+  "blocked",
+  "open_questions",
+  "open_blocking_questions",
+  "open_remarks",
+  "open_warnings",
+  "last_summary_at",
+  "last_entry_at"
+]

Previous value: -[
-  {
-    "description": "Task status",
-    "enum": [
-      "backlog",
-      "open",
-      "in_progress",
-      "waiting",
-      "done",
-      "cancelled"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "Task status",
+    "enum": [
+      "backlog",
+      "open",
+      "in_progress",
+      "done",
+      "cancelled"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Removed value: -{
-  "TaskPriority": {
-    "description": "Приоритет. Порядок членов — от низшего к высшему, на него опирается сортировка поиска.",
-    "enum": [
-      "low",
-      "normal",
-      "high",
-      "critical"
-    ],
-    "title": "TaskPriority",
-    "type": "string"
-  },
-  "TaskStatus": {
-    "description": "Зашитый список статусов (`CONCEPT.md`, 3.3).",
-    "enum": [
-      "backlog",
-      "open",
-      "in_progress",
-      "waiting",
-      "done",
-      "cancelled"
-    ],
-    "title": "TaskStatus",
-    "type": "string"
-  }
-}

Previous value: -"Исполнители, точным совпадением; `empty()` находит задачи без исполнителя"New value: +"Assignee names, exact match; `empty()` matches tasks without an assignee. A name covers every session signed with it: no value selects the tasks of one session"

Removed value: -[
-  [
-    "release_bot"
-  ]
-]

Previous value: -"Есть ли у задачи `blocked_by` на задачу не в `done` и не в `cancelled`. Вход в `in_progress` при `true` отклоняется"New value: +"Whether the task has `blocked_by` on a task that is neither `done` nor `cancelled`"

Previous value: -"Продолжение выдачи: значение `next_cursor` из прошлого ответа"New value: +"`next_cursor` of the previous page; without it, the first page"

Previous value: -[
-  "key",
-  "title",
-  "status",
-  "assignee",
-  "priority",
-  "features",
-  "parents"
-]New value: +[
+  "key",
+  "title",
+  "status",
+  "assignee",
+  "priority",
+  "features",
+  "parent"
+]

Previous value: -"Какие поля вернуть: `assignee`, `checks`, `constraints`, `context`, `created_at`, `created_by`, `description`, `features`, `goal`, `id`, `key`, `output`, `parents`, `priority`, `queue`, `status`, `title`, `updated_at`, `version`. Ключ приходит всегда, пустой список означает «задачу целиком»: разделы длинные. `features` приносит вычисляемые признаки строки: `blocked`, `open_questions`, `open_blocking_questions`, `open_remarks`, `last_summary_at`, `last_entry_at`. `parents` — прямые родители: ключ и название"New value: +"Fields to return: `assignee`, `checks`, `constraints`, `context`, `created_at`, `created_by`, `description`, `features`, `goal`, `id`, `key`, `output`, `parent`, `previous_keys`, `priority`, `project`, `status`, `title`, `updated_at`, `version`. The key always comes back; an empty list returns whole tasks. `features` brings the computed features: `blocked`, `open_questions`, `open_blocking_questions`, `open_remarks`, `last_summary_at`, `last_entry_at`. `parent` is the parent's key and title, or `null`"

Previous value: -"Ключи задач: спросить про несколько названных разом, а не по вызову на каждую. Несуществующий ключ отвечает отказом, а не пустой выдачей"New value: +"Task keys: several named tasks in one call. An unknown key is refused with `search_value_invalid`, `reason: task_not_found`, rather than left out"

Previous value: -"Сколько записей вернуть за раз. Без значения — размер страницы установки"New value: +"Page size. Without a value, the installation's default page size"

Removed value: -[
-  25
-]

Previous value: -"Из них помеченных `blocking`; `0` означает «ничто не мешает»"New value: +"Exact number of unanswered `blocking` questions; `0` means none blocks"

Previous value: -"Ровно столько вопросов без ответа. Для диапазонов есть язык запросов"New value: +"Exact number of unanswered questions; ranges go in `query`"

Previous value: -"Ровно столько замечаний без резолюции. Для диапазонов есть язык запросов"New value: +"Exact number of unresolved remarks; ranges go in `query`"

Previous value: -"Ключи родительских задач: в выдаче их **прямые** дети, на одно колено. `empty()` находит задачи без родителя — верхний уровень очереди. Несуществующий ключ отвечает отказом, а не пустой выдачей: пустота здесь читается как «детей нет», и опечатка спряталась бы за ответом"New value: +"Parent task keys: their **direct** children, one level down. `empty()` matches tasks without a parent, the top level of a project. An unknown key is refused rather than read as «no children»"

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/TaskPriority"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "description": "Task priority, from lowest to highest",
+      "enum": [
+        "low",
+        "normal",
+        "high",
+        "critical"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Приоритеты"New value: +"Priorities"

Removed value: -[
-  [
-    "high"
-  ]
-]

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Project keys",
+  "examples": [
+    [
+      "TRK"
+    ]
+  ],
+  "title": "Project"
+}

Previous value: -"Строка языка запросов. Условие пишется `имя: [оператор] значения` — оператор стоит **после** двоеточия, и это главное, чем язык отличается от SQL: `status: in open, in_progress`, а не `status in (open, in_progress)`. Скобки в языке есть, но группируют они условия, а не значения.\n\nБез оператора условие означает равенство, а несколько значений через запятую — вхождение в набор: `status: open, in_progress` то же самое, что `status: in open, in_progress`.\n\nПоля: `assignee`, `blocked`, `key`, `last_entry_at`, `open_blocking_questions`, `open_questions`, `open_remarks`, `parent`, `priority`, `queue`, `remarks_in_work`, `status`, `text`. Операторы: `=`, `!=`, `>`, `>=`, `<`, `<=`, `~` (вхождение подстроки), `!~`, `in`, `not in`; `empty()` находит задачи без значения. Условия связываются `and` и `or`.\n\nПримеры:\n- `queue: TRK and status: open and blocked: false`\n- `status: in open, in_progress`\n- `priority: >= high and text: ~ ключ`\n- `assignee: empty() or open_questions: > 0`\n\nОшибка разбора приходит с позицией символа, а там, где верная форма выводима из места ошибки, — и с ней самой в `details.hint`"New value: +"Query language string. A condition is written `name: [operator] values`: the operator stands **after** the colon, unlike SQL — `status: in open, in_progress`, not `status in (open, in_progress)`. Parentheses group conditions, not values.\n\nWithout an operator a condition means equality, and comma-separated values mean membership: `status: open, in_progress` equals `status: in open, in_progress`.\n\nFields: `assignee`, `blocked`, `key`, `last_entry_at`, `open_blocking_questions`, `open_questions`, `open_remarks`, `parent`, `priority`, `project`, `remarks_in_work`, `status`, `text`. Operators: `=`, `!=`, `>`, `>=`, `<`, `<=`, `~` (substring), `!~`, `in`, `not in`; `empty()` matches tasks without a value. Conditions combine with `and` and `or`.\n\nExamples:\n- `project: TRK and status: open and blocked: false`\n- `status: in open, in_progress`\n- `priority: >= high and text: ~ login`\n- `assignee: empty() or open_questions: > 0`\n\nA string that does not parse is refused with `invalid_search_query` and the character position, plus the correct form in `details.hint` where the error position determines it"

Previous value: -[
-  "queue: TRK and status: open and blocked: false",
-  "status: in open, in_progress",
-  "priority: >= high and text: ~ ключ",
-  "assignee: empty() or open_questions: > 0"
-]New value: +[
+  "project: TRK and status: open and blocked: false",
+  "status: in open, in_progress",
+  "priority: >= high and text: ~ login",
+  "assignee: empty() or open_questions: > 0"
+]

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "type": "string"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Ключи очередей",
-  "examples": [
-    [
-      "TRK"
-    ]
-  ],
-  "title": "Queue"
-}

Previous value: -"Замечаний, принятых в работу, чья задача-продолжение ещё не закрыта: «разобрано, но работа не доделана»"New value: +"Number of remarks resolved as `accepted` whose continuation task is not closed yet"

Previous value: -"Порядок, старший ключ первым; `-` в начале — по убыванию. Допустимы: `key`, `last_entry_at`, `priority`, `updated_at`"New value: +"Sort order, most significant key first; a leading `-` sorts descending. Allowed: `key`, `last_entry_at`, `priority`, `updated_at`"

Previous value: -[
-  {
-    "items": {
-      "$ref": "#/$defs/TaskStatus"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "description": "Task status",
+      "enum": [
+        "backlog",
+        "open",
+        "in_progress",
+        "waiting",
+        "done",
+        "cancelled"
+      ],
+      "type": "string"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Статусы задач"New value: +"Task statuses"

Removed value: -[
-  [
-    "open"
-  ]
-]

Previous value: -"Подстрока в названии или описании, без учёта регистра"New value: +"Substring of the title or description, case-insensitive"

Removed value: -[
-  "выдача ключей"
-]

Removed value: -{
-  "description": "Кто именно сделал действие.\n\n`tracker` — сам трекер: этим родом подписаны служебные записи дела и строки,\nзаведённые командой первичной инициализации. У него нет подписи, потому что\nназывать себя по имени ему незачем: трекер в установке один.",
-  "enum": [
-    "agent",
-    "human",
-    "tracker"
-  ],
-  "title": "AuthorKind",
-  "type": "string"
-}

Previous value: -"Кто сделал действие: род и подпись. У самого трекера подписи нет."New value: +"Who acted: kind and signature. The tracker itself has no signature."

Removed value: -"#/$defs/AuthorKind"

Added value: +"Kind of author. `tracker` signs the service entries the tracker files itself"

Added value: +[
+  "agent",
+  "human",
+  "tracker"
+]

Added value: +"string"

Previous value: -"Вычисляемые признаки задачи (`CONCEPT.md`, 4.3)."New value: +"Computed task features."

Previous value: -"Строка выдачи поиска: карточка задачи, у которой любое поле может отсутствовать.\n\nЕдинственная модель слоя с необязательными полями, и это не послабление типизации, а\nеё предмет. Список умеет отдавать подмножество полей (`fields`), и схема обязана\nчестно это показывать — ровно так же, как `TaskSearchRead` в REST.\n\nОтсюда же сериализатор ниже. SDK сворачивает результат вызовом\n`model_dump(mode=\"json\")` — **без** `exclude_unset`, — и незапрошенное поле приезжало\nбы агенту как `null`. Это не то же самое, что «поля нет»: пакет обязан совпадать с\nответом REST поле в поле, а тот отдаётся с `response_model_exclude_unset`.\n\nСхему сериализатор не портит, и это проверено: SDK строит `outputSchema` через\n`TypeAdapter(...).json_schema()`, у которого режим по умолчанию — **валидация**, а\nобёрточный сериализатор действует только на схему сериализации. У FastAPI режим\nпротивоположный, поэтому предупреждение заметки `docs/notes/api.md` («Отбросить\nпустые поля в ответе — значит потерять схему у клиента») сюда не переносится."New value: +"Search result row: the requested fields of one task."

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ParentView"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Removed value: -{
-  "anyOf": [
-    {
-      "items": {
-        "$ref": "#/$defs/ParentView"
-      },
-      "type": "array"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "title": "Parents"
-}

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Previous Keys"
+}

Previous value: -[
-  {
-    "$ref": "#/$defs/TaskPriority"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "Task priority, from lowest to highest",
+    "enum": [
+      "low",
+      "normal",
+      "high",
+      "critical"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/$defs/ProjectRefView"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null
+}

Removed value: -{
-  "anyOf": [
-    {
-      "$ref": "#/$defs/QueueRefView"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null
-}

Previous value: -[
-  {
-    "$ref": "#/$defs/TaskStatus"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "description": "Task status",
+    "enum": [
+      "backlog",
+      "open",
+      "in_progress",
+      "waiting",
+      "done",
+      "cancelled"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Previous value: -"Прямой родитель задачи в строке выдачи: ключ и название (`CONCEPT.md`, 4.4)."New value: +"Parent task: key and title."

Added value: +{
+  "description": "Project in one line: key and title.",
+  "properties": {
+    "key": {
+      "title": "Key",
+      "type": "string"
+    },
+    "title": {
+      "title": "Title",
+      "type": "string"
+    }
+  },
+  "required": [
+    "key",
+    "title"
+  ],
+  "title": "ProjectRefView",
+  "type": "object"
+}

Removed value: -{
-  "description": "Очередь одной строкой: ключ и название.",
-  "properties": {
-    "key": {
-      "title": "Key",
-      "type": "string"
-    },
-    "title": {
-      "title": "Title",
-      "type": "string"
-    }
-  },
-  "required": [
-    "key",
-    "title"
-  ],
-  "title": "QueueRefView",
-  "type": "object"
-}

Removed value: -{
-  "description": "Приоритет. Порядок членов — от низшего к высшему, на него опирается сортировка поиска.",
-  "enum": [
-    "low",
-    "normal",
-    "high",
-    "critical"
-  ],
-  "title": "TaskPriority",
-  "type": "string"
-}

Removed value: -{
-  "description": "Зашитый список статусов (`CONCEPT.md`, 3.3).",
-  "enum": [
-    "backlog",
-    "open",
-    "in_progress",
-    "waiting",
-    "done",
-    "cancelled"
-  ],
-  "title": "TaskStatus",
-  "type": "string"
-}

Added value: +"Cursor of the next page, sent back as `cursor`; `null` means this page is the last one"