@smwb/onreel-git-mcp 0.2.1 → 0.3.0

package/dist/tracker/index.js

@@ -9,6 +9,13 @@ var TRACKER_PAGE_LIMIT_DEFAULT = 50;
 var TRACKER_ERROR_BODY_MAX = 300;
 var TRACKER_SECRETS_FILE = "tracker-secrets.json";
 var TRACKER_LOCAL_AUTHOR = "owner";
+var ISSUE_FILTERS = ["status", "labels", "assignee", "author", "search", "createdAfter", "createdBefore", "updatedAfter", "updatedBefore"];
+var ISSUE_SORT_FIELDS = ["created", "updated", "priority", "title", "comments"];
+var COMMENT_FILTERS = ["updatedAfter"];
+var LEGACY_ISSUE_CAPABILITIES = {
+  list: { filters: ["status"], clientSide: ["status"], sorts: [] },
+  comments: { filters: [], clientSide: [], order: ["asc"] }
+};
 
 // src/tracker/tracker.lib.ts
 var TrackerError = class extends Error {
@@ -50,6 +57,89 @@ function nameOf(table, category) {
 function priorityName(table, priority) {
   return Object.entries(table).find(([, value]) => value === priority)?.[0];
 }
+function usedFilters(query, names) {
+  return names.filter((name) => {
+    const value = query[name];
+    return value !== void 0 && !(Array.isArray(value) && value.length === 0);
+  });
+}
+function assertListQuery(subject, capabilities, query, names) {
+  const used = usedFilters(query, names);
+  for (const name of used) {
+    if (!capabilities.filters.includes(name)) throw new TrackerError("unsupported", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F.`);
+  }
+  const sort = query.sort;
+  if (sort !== void 0 && !capabilities.sorts.includes(sort.field)) {
+    throw new TrackerError("unsupported", `${subject}: \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0430 \u043F\u043E ${sort.field} \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F.`);
+  }
+  if (sort?.direction !== void 0 && sort.direction !== "asc" && sort.direction !== "desc") {
+    throw new TrackerError("invalid_request", `${subject}: \u043D\u0430\u043F\u0440\u0430\u0432\u043B\u0435\u043D\u0438\u0435 \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0438 \u2014 asc \u0438\u043B\u0438 desc.`);
+  }
+  const limit = query.limit;
+  if (limit !== void 0 && !(typeof limit === "number" && Number.isSafeInteger(limit) && limit >= 1)) {
+    throw new TrackerError("invalid_request", `${subject}: limit \u2014 \u0446\u0435\u043B\u043E\u0435 \u0447\u0438\u0441\u043B\u043E \u043E\u0442 1.`);
+  }
+  for (const name of used) {
+    const value = query[name];
+    if (isTimeFilter(name)) {
+      if (typeof value !== "number" || !(Number.isSafeInteger(value) && value >= 0)) {
+        throw new TrackerError("invalid_request", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u2014 \u0432\u0440\u0435\u043C\u044F \u0432 \u043C\u0441, \u0446\u0435\u043B\u043E\u0435 \u0447\u0438\u0441\u043B\u043E \u043E\u0442 0.`);
+      }
+      continue;
+    }
+    if (isArrayFilter(name)) {
+      if (!Array.isArray(value) || value.some((item) => typeof item !== "string" || item.trim() === "")) {
+        throw new TrackerError("invalid_request", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u2014 \u0441\u043F\u0438\u0441\u043E\u043A \u043D\u0435\u043F\u0443\u0441\u0442\u044B\u0445 \u0441\u0442\u0440\u043E\u043A.`);
+      }
+      continue;
+    }
+    if (value === null) continue;
+    if (typeof value === "string") {
+      if (value.trim() === "") throw new TrackerError("invalid_request", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u2014 \u043F\u0443\u0441\u0442\u0430\u044F \u0441\u0442\u0440\u043E\u043A\u0430.`);
+      continue;
+    }
+    if (Array.isArray(value)) {
+      if (value.some((item) => typeof item !== "string" || item.trim() === "")) {
+        throw new TrackerError("invalid_request", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u2014 \u0441\u043F\u0438\u0441\u043E\u043A \u043D\u0435\u043F\u0443\u0441\u0442\u044B\u0445 \u0441\u0442\u0440\u043E\u043A.`);
+      }
+      continue;
+    }
+    throw new TrackerError("invalid_request", `${subject}: \u0444\u0438\u043B\u044C\u0442\u0440 ${name} \u2014 \u0441\u0442\u0440\u043E\u043A\u0430, \u0441\u043F\u0438\u0441\u043E\u043A \u0441\u0442\u0440\u043E\u043A \u0438\u043B\u0438 null.`);
+  }
+}
+function isTimeFilter(name) {
+  return name.endsWith("After") || name.endsWith("Before");
+}
+function isArrayFilter(name) {
+  return name === "status" || name === "labels";
+}
+function assertCommentQuery(subject, capabilities, query) {
+  assertListQuery(subject, { filters: capabilities.filters, clientSide: capabilities.clientSide, sorts: [] }, query, COMMENT_FILTERS);
+  if (query.order !== void 0 && !capabilities.order.includes(query.order)) {
+    throw new TrackerError("unsupported", `${subject}: \u043F\u043E\u0440\u044F\u0434\u043E\u043A ${query.order} \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F.`);
+  }
+}
+function issueCapabilitiesOf(definition) {
+  return definition.issues ?? LEGACY_ISSUE_CAPABILITIES;
+}
+function isoTime(ms) {
+  return new Date(ms).toISOString();
+}
+function inTimeRange(value, after, before) {
+  if (after === void 0 && before === void 0) return true;
+  if (value === void 0) return false;
+  return (after === void 0 || value >= after) && (before === void 0 || value <= before);
+}
+function containsText(texts, needle) {
+  const lower = needle.toLowerCase();
+  return texts.some((value) => value !== void 0 && value.toLowerCase().includes(lower));
+}
+function quoted(value) {
+  return `"${value.replace(/[\\"]/g, "\\$&")}"`;
+}
+function keysFor(table, values) {
+  return Object.entries(table).filter(([, value]) => values.includes(value)).map(([key]) => key);
+}
 
 // src/tracker/mapping.const.ts
 var SOURCECRAFT_STATUSES = {
@@ -66,6 +156,12 @@ var SOURCECRAFT_STATUS_SLUGS = {
   done: "closed",
   declined: "declined"
 };
+var SOURCECRAFT_STATUS_FILTER = {
+  open: ["open", "paused"],
+  in_progress: ["in_progress"],
+  done: ["closed"],
+  declined: ["declined", "duplicate"]
+};
 var SOURCECRAFT_PRIORITIES = {
   trivial: "trivial",
   minor: "minor",
@@ -130,11 +226,7 @@ async function requestJson(url, request) {
     throw new TrackerError("failed", redactSecretText(`\u0422\u0440\u0435\u043A\u0435\u0440 \u043D\u0435 \u043E\u0442\u0432\u0435\u0442\u0438\u043B (${hostOf(url)}): ${error instanceof Error ? error.message : String(error)}`));
   }
   const raw = await response.text();
-  if (!response.ok) {
-    if (response.status === 404 && request.missingIsIssue === true) throw new TrackerError("unknown_issue", "\u0417\u0430\u0434\u0430\u0447\u0430 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0442\u0440\u0435\u043A\u0435\u0440\u0435.");
-    const detail = redactSecretText(raw.replace(/\s+/g, " ").trim()).slice(0, TRACKER_ERROR_BODY_MAX);
-    throw new TrackerError("failed", `\u0422\u0440\u0435\u043A\u0435\u0440 ${hostOf(url)} \u043E\u0442\u0432\u0435\u0442\u0438\u043B ${String(response.status)}${detail === "" ? "" : `: ${detail}`}.`);
-  }
+  if (!response.ok) throw failureOf(url, response, raw, request);
   if (raw === "") return { body: void 0, headers: response.headers };
   try {
     return { body: JSON.parse(raw), headers: response.headers };
@@ -142,6 +234,38 @@ async function requestJson(url, request) {
     throw new TrackerError("failed", `\u0422\u0440\u0435\u043A\u0435\u0440 ${hostOf(url)} \u0432\u0435\u0440\u043D\u0443\u043B \u043D\u0435 JSON.`);
   }
 }
+function failureOf(url, response, raw, request) {
+  const status = response.status;
+  if (status === 404 && request.missing !== void 0) return new TrackerError(request.missing.failure, request.missing.message);
+  if (status === 404 && request.missingIsIssue === true) return new TrackerError("unknown_issue", "\u0417\u0430\u0434\u0430\u0447\u0430 \u043D\u0435 \u043D\u0430\u0439\u0434\u0435\u043D\u0430 \u0432 \u0442\u0440\u0435\u043A\u0435\u0440\u0435.");
+  const detail = redactSecretText(raw.replace(/\s+/g, " ").trim()).slice(0, TRACKER_ERROR_BODY_MAX);
+  const answered = `\u0422\u0440\u0435\u043A\u0435\u0440 ${hostOf(url)} \u043E\u0442\u0432\u0435\u0442\u0438\u043B ${String(status)}${detail === "" ? "" : `: ${detail}`}.`;
+  if (request.conflictOn?.includes(status) === true) return new TrackerError("conflict", answered);
+  const secondaryLimit = status === 403 && (response.headers.get("x-ratelimit-remaining")?.trim() === "0" || retryAfterOf(response.headers.get("retry-after")?.trim(), Date.now()) !== void 0);
+  if (status === 429 || secondaryLimit) {
+    const delay = retryDelayOf(response.headers);
+    return new TrackerError("rate_limited", `\u0422\u0440\u0435\u043A\u0435\u0440 ${hostOf(url)} \u043E\u0433\u0440\u0430\u043D\u0438\u0447\u0438\u043B \u0447\u0430\u0441\u0442\u043E\u0442\u0443 \u0437\u0430\u043F\u0440\u043E\u0441\u043E\u0432${delay === void 0 ? "" : `, \u043F\u043E\u0432\u0442\u043E\u0440 \u0447\u0435\u0440\u0435\u0437 ${String(delay)} \u0441`}.`);
+  }
+  return new TrackerError("failed", answered);
+}
+function retryDelayOf(headers, now = Date.now()) {
+  const retryAfter = retryAfterOf(headers.get("retry-after")?.trim(), now);
+  if (retryAfter !== void 0) return retryAfter;
+  for (const name of ["x-ratelimit-reset", "ratelimit-reset"]) {
+    const reset = headers.get(name)?.trim();
+    if (reset !== void 0 && /^\d+$/.test(reset)) return resetDelay(Number(reset), now);
+  }
+  return void 0;
+}
+function retryAfterOf(value, now) {
+  if (value === void 0 || value === "") return void 0;
+  if (/^\d+$/.test(value)) return Number(value);
+  const at = Date.parse(value);
+  return Number.isFinite(at) ? Math.max(0, Math.ceil((at - now) / 1e3)) : void 0;
+}
+function resetDelay(reset, now) {
+  return reset >= 1e9 ? Math.max(0, reset - Math.floor(now / 1e3)) : reset;
+}
 function hostOf(url) {
   try {
     return new URL(url).host;
@@ -179,7 +303,13 @@ function listTrackers() {
 var DEFAULT_API = "https://api.github.com";
 var TARGET = /^[\w.-]+\/[\w.-]+$/;
 var NUMBER = /^[1-9]\d{0,14}$/;
+var LIST_SUBJECT = "\u0417\u0430\u0434\u0430\u0447\u0438 GitHub";
+var COMMENTS_SUBJECT = "\u041A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 GitHub";
 function githubTracker() {
+  const issues = {
+    list: { filters: ISSUE_FILTERS, clientSide: ["status"], sorts: ["created", "updated", "comments"] },
+    comments: { filters: ["updatedAfter"], clientSide: [], order: ["asc"] }
+  };
   return {
     descriptor: {
       tracker: "github",
@@ -191,13 +321,15 @@ function githubTracker() {
       ],
       features: { create: true, update: true, comment: true, priority: true, labels: true, assignee: true, statuses: ["open", "in_progress", "done", "declined"] }
     },
-    create: (context) => createGithubAdapter(context)
+    create: (context) => createGithubAdapter(context, issues),
+    issues
   };
 }
-function createGithubAdapter({ connection, fetch }) {
+function createGithubAdapter({ connection, fetch }, capabilities) {
   const target = requireTarget(connection.target, "owner/repo \u0440\u0435\u043F\u043E\u0437\u0438\u0442\u043E\u0440\u0438\u044F GitHub");
   if (!TARGET.test(target)) throw new TrackerError("invalid_request", "target GitHub \u2014 owner/repo.");
-  const root = `${baseUrl(connection.url, DEFAULT_API)}/repos/${target}/issues`;
+  const api = baseUrl(connection.url, DEFAULT_API);
+  const root = `${api}/repos/${target}/issues`;
   const headers = {
     accept: "application/vnd.github+json",
     "x-github-api-version": "2022-11-28",
@@ -213,14 +345,13 @@ function createGithubAdapter({ connection, fetch }) {
   };
   return {
     list: async (query) => {
+      assertListQuery(LIST_SUBJECT, capabilities.list, query, ISSUE_FILTERS);
+      assertCsvLabels(query.labels);
       const page = pageOf(query.cursor);
-      const params = new URLSearchParams({ state: stateFilter(query.status), per_page: String(query.limit), page: String(page) });
-      const { body, headers: responseHeaders } = await requestJson(`${root}?${params.toString()}`, { fetch, headers });
-      const items = (Array.isArray(body) ? body : []).filter((item) => isRecord(item) && item.pull_request === void 0).map(issueOf);
-      return {
-        items: query.status === void 0 ? items : items.filter((issue) => query.status?.includes(issue.status.category) === true),
-        .../rel="next"/.test(responseHeaders.get("link") ?? "") ? { nextCursor: String(page + 1) } : {}
-      };
+      const search = needsSearch(query);
+      const params = search ? searchParams(target, query, page) : issuesParams(query, page);
+      const { body, headers: responseHeaders } = await requestJson(`${search ? `${api}/search/issues` : root}?${params.toString()}`, { fetch, headers });
+      return issuePageOf(rowsOf(body, search), query, responseHeaders.get("link") ?? "", page);
     },
     get: async (key) => issueOf(await rawOf(key)),
     create: async (input) => {
@@ -239,8 +370,10 @@ function createGithubAdapter({ connection, fetch }) {
       return issueOf(response.body);
     },
     comments: async (key, query) => {
+      assertCommentQuery(COMMENTS_SUBJECT, capabilities.comments, query);
       const page = pageOf(query.cursor);
       const params = new URLSearchParams({ per_page: String(query.limit), page: String(page) });
+      if (query.updatedAfter !== void 0) params.set("since", isoTime(query.updatedAfter));
       const { body, headers: responseHeaders } = await requestJson(`${root}/${number(key)}/comments?${params.toString()}`, { fetch, headers, missingIsIssue: true });
       return { items: (Array.isArray(body) ? body : []).map(commentOf), .../rel="next"/.test(responseHeaders.get("link") ?? "") ? { nextCursor: String(page + 1) } : {} };
     },
@@ -257,6 +390,68 @@ function stateFilter(status) {
   if (status.every((item) => item === "done" || item === "declined")) return "closed";
   return "all";
 }
+function needsSearch(query) {
+  return query.search !== void 0 || query.createdAfter !== void 0 || query.createdBefore !== void 0 || query.updatedBefore !== void 0;
+}
+function assertCsvLabels(labels) {
+  if (labels?.some((label) => label.includes(",")) === true) throw new TrackerError("invalid_request", `${LIST_SUBJECT}: \u043C\u0435\u0442\u043A\u0430 \u043D\u0435 \u0434\u043E\u043B\u0436\u043D\u0430 \u0441\u043E\u0434\u0435\u0440\u0436\u0430\u0442\u044C \u0437\u0430\u043F\u044F\u0442\u0443\u044E.`);
+}
+function issuesParams(query, page) {
+  const params = new URLSearchParams({ state: stateFilter(query.status), per_page: String(query.limit), page: String(page) });
+  if (query.labels !== void 0 && query.labels.length > 0) params.set("labels", query.labels.join(","));
+  if (query.assignee !== void 0) params.set("assignee", query.assignee ?? "none");
+  if (query.author !== void 0) params.set("creator", query.author);
+  if (query.updatedAfter !== void 0) params.set("since", isoTime(query.updatedAfter));
+  if (query.sort !== void 0) {
+    params.set("sort", query.sort.field);
+    params.set("direction", query.sort.direction ?? "desc");
+  }
+  return params;
+}
+function searchParams(target, query, page) {
+  const params = new URLSearchParams({ q: searchQuery(target, query), per_page: String(query.limit), page: String(page) });
+  const sort = query.sort;
+  params.set("sort", sort?.field ?? "created");
+  params.set("order", sort?.direction ?? "desc");
+  return params;
+}
+function searchQuery(target, query) {
+  const parts = [`repo:${target}`, "is:issue"];
+  const state = searchStateFilter(query.status);
+  if (state !== void 0) parts.push(state);
+  for (const label of query.labels ?? []) parts.push(`label:${quoted(label)}`);
+  if (query.assignee !== void 0) parts.push(query.assignee === null ? "no:assignee" : `assignee:${quoted(query.assignee)}`);
+  if (query.author !== void 0) parts.push(`author:${quoted(query.author)}`);
+  const created = timeRangeQualifier("created", query.createdAfter, query.createdBefore);
+  if (created !== void 0) parts.push(created);
+  const updated = timeRangeQualifier("updated", query.updatedAfter, query.updatedBefore);
+  if (updated !== void 0) parts.push(updated);
+  if (query.search !== void 0) parts.push(quoted(query.search));
+  return parts.join(" ");
+}
+function timeRangeQualifier(field, after, before) {
+  if (after !== void 0 && before !== void 0) return `${field}:${isoTime(after)}..${isoTime(before)}`;
+  if (after !== void 0) return `${field}:>=${isoTime(after)}`;
+  if (before !== void 0) return `${field}:<=${isoTime(before)}`;
+  return void 0;
+}
+function rowsOf(body, search) {
+  if (!search) return Array.isArray(body) ? body : [];
+  return isRecord(body) && Array.isArray(body.items) ? body.items : [];
+}
+function searchStateFilter(status) {
+  if (status === void 0) return void 0;
+  if (status.every((item) => item === "open" || item === "in_progress")) return "is:open";
+  if (status.every((item) => item === "done" || item === "declined")) return "is:closed";
+  return void 0;
+}
+function issuePageOf(rows, query, link, page) {
+  const items = rows.filter((row) => isRecord(row) && row.pull_request === void 0).map(issueOf);
+  return {
+    items: query.status === void 0 ? items : items.filter((issue) => query.status?.includes(issue.status.category) === true),
+    .../rel="next"/.test(link) ? { nextCursor: String(page + 1) } : {}
+  };
+}
 function composeLabels(plain, priority, status) {
   const priorityLabel = priority === void 0 ? void 0 : priorityName(GITHUB_PRIORITY_LABELS, priority);
   return [...plain, ...priorityLabel === void 0 ? [] : [priorityLabel], ...status === "in_progress" ? [GITHUB_IN_PROGRESS_LABEL] : []];
@@ -308,6 +503,16 @@ function commentOf(raw) {
 var DEFAULT_URL = "https://gitlab.com";
 var TARGET2 = /^(\d{1,15}|[\w.-]+(\/[\w.-]+)+)$/;
 var IID = /^[1-9]\d{0,14}$/;
+var ISSUE_CAPABILITIES = {
+  list: { filters: ISSUE_FILTERS, clientSide: ["status"], sorts: ["created", "updated", "priority", "title"] },
+  comments: { filters: COMMENT_FILTERS, clientSide: COMMENT_FILTERS, order: ["asc", "desc"] }
+};
+var ORDER_BY = {
+  created: "created_at",
+  updated: "updated_at",
+  priority: "priority",
+  title: "title"
+};
 function gitlabTracker() {
   return {
     descriptor: {
@@ -320,7 +525,8 @@ function gitlabTracker() {
       ],
       features: { create: true, update: true, comment: true, priority: true, labels: true, assignee: false, statuses: ["open", "in_progress", "done"] }
     },
-    create: (context) => createGitlabAdapter(context)
+    create: (context) => createGitlabAdapter(context),
+    issues: ISSUE_CAPABILITIES
   };
 }
 function createGitlabAdapter({ connection, fetch }) {
@@ -335,8 +541,26 @@ function createGitlabAdapter({ connection, fetch }) {
   const currentOf = async (key) => issueOf2((await requestJson(`${root}/${iid(key)}`, { fetch, headers, missingIsIssue: true })).body);
   return {
     list: async (query) => {
+      assertListQuery("\u0417\u0430\u0434\u0430\u0447\u0438 GitLab", ISSUE_CAPABILITIES.list, query, ISSUE_FILTERS);
       const page = pageOf2(query.cursor);
-      const params = new URLSearchParams({ state: stateFilter2(query.status), per_page: String(query.limit), page: String(page), order_by: "created_at", sort: "desc" });
+      const params = new URLSearchParams({
+        state: stateFilter2(query.status),
+        per_page: String(query.limit),
+        page: String(page),
+        order_by: query.sort === void 0 ? "created_at" : ORDER_BY[query.sort.field] ?? "created_at",
+        sort: query.sort?.direction ?? "desc"
+      });
+      if (query.labels !== void 0 && query.labels.length > 0) {
+        if (query.labels.some((label) => label.includes(","))) throw new TrackerError("invalid_request", "\u0417\u0430\u0434\u0430\u0447\u0438 GitLab: \u043C\u0435\u0442\u043A\u0430 \u043D\u0435 \u0434\u043E\u043B\u0436\u043D\u0430 \u0441\u043E\u0434\u0435\u0440\u0436\u0430\u0442\u044C \u0437\u0430\u043F\u044F\u0442\u0443\u044E.");
+        params.set("labels", query.labels.join(","));
+      }
+      if (query.assignee !== void 0) params.set(query.assignee === null ? "assignee_id" : "assignee_username", query.assignee === null ? "None" : query.assignee);
+      if (query.author !== void 0) params.set("author_username", query.author);
+      if (query.search !== void 0) params.set("search", query.search);
+      if (query.createdAfter !== void 0) params.set("created_after", isoTime(query.createdAfter));
+      if (query.createdBefore !== void 0) params.set("created_before", isoTime(query.createdBefore));
+      if (query.updatedAfter !== void 0) params.set("updated_after", isoTime(query.updatedAfter));
+      if (query.updatedBefore !== void 0) params.set("updated_before", isoTime(query.updatedBefore));
       const { body, headers: responseHeaders } = await requestJson(`${root}?${params.toString()}`, { fetch, headers });
       const items = (Array.isArray(body) ? body : []).map(issueOf2);
       const next = responseHeaders.get("x-next-page");
@@ -356,11 +580,12 @@ function createGitlabAdapter({ connection, fetch }) {
       return issueOf2((await requestJson(`${root}/${iid(key)}`, { fetch, headers, method: "PUT", body: patchBody2(patch, current), missingIsIssue: true })).body);
     },
     comments: async (key, query) => {
+      assertCommentQuery("\u041A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 GitLab", ISSUE_CAPABILITIES.comments, query);
       const page = pageOf2(query.cursor);
-      const params = new URLSearchParams({ sort: "asc", order_by: "created_at", per_page: String(query.limit), page: String(page) });
+      const params = new URLSearchParams({ sort: query.order ?? "asc", order_by: "created_at", per_page: String(query.limit), page: String(page) });
       const { body, headers: responseHeaders } = await requestJson(`${root}/${iid(key)}/notes?${params.toString()}`, { fetch, headers, missingIsIssue: true });
       const next = responseHeaders.get("x-next-page");
-      const items = (Array.isArray(body) ? body : []).filter((note) => isRecord(note) && note.system !== true).map(commentOf2);
+      const items = (Array.isArray(body) ? body : []).filter((note) => isRecord(note) && note.system !== true && inTimeRange(toTimestamp(note.updated_at), query.updatedAfter, void 0)).map(commentOf2);
       return { items, ...next === null || next === "" ? {} : { nextCursor: next } };
     },
     comment: async (key, body) => commentOf2((await requestJson(`${root}/${iid(key)}/notes`, { fetch, headers, method: "POST", body: { body }, missingIsIssue: true })).body)
@@ -430,6 +655,11 @@ var PROJECT_KEY = /^[A-Z][A-Z0-9_]{0,49}$/;
 var ISSUE_KEY = /^[A-Z][A-Z0-9_]{0,49}-[1-9]\d{0,14}$/;
 var FIELDS = "summary,description,status,priority,labels,assignee,created,updated";
 var CATEGORY_JQL = { open: '"To Do"', in_progress: '"In Progress"', done: "Done" };
+var ISSUE_CAPABILITIES2 = {
+  list: { filters: ISSUE_FILTERS, clientSide: [], sorts: ["created", "updated", "priority", "title"] },
+  comments: { filters: COMMENT_FILTERS, clientSide: COMMENT_FILTERS, order: ["asc", "desc"] }
+};
+var JIRA_SORT_FIELDS = { created: "created", updated: "updated", priority: "priority", title: "summary" };
 function jiraTracker() {
   return {
     descriptor: {
@@ -443,7 +673,8 @@ function jiraTracker() {
       ],
       features: { create: true, update: true, comment: true, priority: true, labels: true, assignee: false, statuses: ["open", "in_progress", "done"] }
     },
-    create: (context) => createJiraAdapter(context)
+    create: (context) => createJiraAdapter(context),
+    issues: ISSUE_CAPABILITIES2
   };
 }
 function createJiraAdapter({ connection, fetch }) {
@@ -462,7 +693,8 @@ function createJiraAdapter({ connection, fetch }) {
   const load = async (value) => toIssue2((await requestJson(`${api}/issue/${key(value)}?fields=${FIELDS}`, { fetch, headers, missingIsIssue: true })).body);
   return {
     list: async (query) => {
-      const jql = listJql(project, query.status);
+      assertListQuery("\u0417\u0430\u0434\u0430\u0447\u0438 Jira", ISSUE_CAPABILITIES2.list, query, ISSUE_FILTERS);
+      const jql = listJql(project, query);
       if (jql === void 0) return { items: [] };
       if (query.cursor?.startsWith("s:") !== true) {
         const params2 = new URLSearchParams({ jql, fields: FIELDS, maxResults: String(query.limit) });
@@ -507,23 +739,44 @@ function createJiraAdapter({ connection, fetch }) {
       return load(value);
     },
     comments: async (value, query) => {
+      assertCommentQuery("\u041A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 Jira", ISSUE_CAPABILITIES2.comments, query);
       const startAt = query.cursor === void 0 ? 0 : Number(query.cursor);
-      const params = new URLSearchParams({ startAt: String(Number.isInteger(startAt) && startAt >= 0 ? startAt : 0), maxResults: String(query.limit), orderBy: "created" });
+      const params = new URLSearchParams({ startAt: String(Number.isInteger(startAt) && startAt >= 0 ? startAt : 0), maxResults: String(query.limit), orderBy: query.order === "desc" ? "-created" : "created" });
       const { body } = await requestJson(`${api}/issue/${key(value)}/comment?${params.toString()}`, { fetch, headers, missingIsIssue: true });
       const record = isRecord(body) ? body : {};
-      const items = Array.isArray(record.comments) ? record.comments : [];
+      const raw = Array.isArray(record.comments) ? record.comments : [];
+      const items = raw.filter((item) => inTimeRange(toTimestamp(isRecord(item) ? item.updated : void 0), query.updatedAfter, void 0));
       const total = typeof record.total === "number" ? record.total : 0;
       const at = typeof record.startAt === "number" ? record.startAt : 0;
-      return { items: items.map(commentOf3), ...at + items.length < total && items.length > 0 ? { nextCursor: String(at + items.length) } : {} };
+      return { items: items.map(commentOf3), ...at + raw.length < total && raw.length > 0 ? { nextCursor: String(at + raw.length) } : {} };
     },
     comment: async (value, body) => commentOf3((await requestJson(`${api}/issue/${key(value)}/comment`, { fetch, headers, method: "POST", body: { body }, missingIsIssue: true })).body)
   };
 }
-function listJql(project, status) {
-  const base = `project = "${project}"`;
-  if (status === void 0) return `${base} ORDER BY created DESC`;
-  const names = status.flatMap((item) => CATEGORY_JQL[item] ?? []);
-  return names.length === 0 ? void 0 : `${base} AND statusCategory in (${names.join(", ")}) ORDER BY created DESC`;
+function listJql(project, query) {
+  const clauses = [];
+  if (query.status !== void 0) {
+    const names = query.status.flatMap((item) => CATEGORY_JQL[item] ?? []);
+    if (names.length === 0) return void 0;
+    clauses.push(`statusCategory in (${names.join(", ")})`);
+  }
+  for (const label of query.labels ?? []) clauses.push(`labels = ${quoted(label.replace(/\s+/g, "-"))}`);
+  if (query.assignee !== void 0) clauses.push(query.assignee === null ? "assignee is EMPTY" : `assignee = ${quoted(query.assignee)}`);
+  if (query.author !== void 0) clauses.push(`reporter = ${quoted(query.author)}`);
+  if (query.search !== void 0) clauses.push(`text ~ ${quoted(query.search)}`);
+  if (query.createdAfter !== void 0) clauses.push(`created >= ${quoted(jiraTime(query.createdAfter, "down"))}`);
+  if (query.createdBefore !== void 0) clauses.push(`created <= ${quoted(jiraTime(query.createdBefore, "up"))}`);
+  if (query.updatedAfter !== void 0) clauses.push(`updated >= ${quoted(jiraTime(query.updatedAfter, "down"))}`);
+  if (query.updatedBefore !== void 0) clauses.push(`updated <= ${quoted(jiraTime(query.updatedBefore, "up"))}`);
+  const sort = query.sort;
+  const field = sort === void 0 ? "created" : sort.field;
+  const direction = sort?.direction ?? "desc";
+  return `${[`project = ${quoted(project)}`, ...clauses].join(" AND ")} ORDER BY ${JIRA_SORT_FIELDS[field]} ${direction.toUpperCase()}`;
+}
+function jiraTime(ms, outward) {
+  const at = new Date(outward === "down" ? Math.floor(ms / 6e4) * 6e4 : Math.ceil(ms / 6e4) * 6e4);
+  const pad = (value) => String(value).padStart(2, "0");
+  return `${String(at.getUTCFullYear())}/${pad(at.getUTCMonth() + 1)}/${pad(at.getUTCDate())} ${pad(at.getUTCHours())}:${pad(at.getUTCMinutes())}`;
 }
 function fieldsOf(patch) {
   return {
@@ -578,6 +831,14 @@ function commentOf3(raw) {
 
 // src/tracker/local.lib.ts
 var STATUS_NAMES = { open: "Open", in_progress: "In progress", done: "Done", declined: "Declined" };
+var ISSUE_CAPABILITIES3 = {
+  list: {
+    filters: ["status", "labels", "assignee", "search", "createdAfter", "createdBefore", "updatedAfter", "updatedBefore"],
+    clientSide: ["labels", "assignee", "search", "createdAfter", "createdBefore", "updatedAfter", "updatedBefore"],
+    sorts: []
+  },
+  comments: { filters: COMMENT_FILTERS, clientSide: COMMENT_FILTERS, order: ["asc"] }
+};
 function localTracker() {
   return {
     descriptor: {
@@ -586,6 +847,7 @@ function localTracker() {
       fields: [],
       features: { create: true, update: true, comment: true, priority: true, labels: true, assignee: true, statuses: [...ALL_STATUSES] }
     },
+    issues: ISSUE_CAPABILITIES3,
     create: (context) => createLocalAdapter(context)
   };
 }
@@ -600,9 +862,11 @@ function createLocalAdapter({ store, projectId, author }) {
     return row;
   };
   return {
-    list: (query) => {
+    // list и comments async: отказ проверки запроса — rejected promise, как у остальных адаптеров.
+    list: async (query) => {
+      assertListQuery("\u0417\u0430\u0434\u0430\u0447\u0438 Local", ISSUE_CAPABILITIES3.list, query, ISSUE_FILTERS);
       const page = store.listLocalIssues(projectId, { limit: query.limit, ...query.cursor === void 0 ? {} : { cursor: query.cursor }, ...query.status === void 0 ? {} : { status: query.status } });
-      return Promise.resolve({ items: page.items.map(toIssue), ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor } });
+      return { items: page.items.filter((row) => matchesIssueQuery(row, query)).map(toIssue), ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor } };
     },
     get: (key) => Promise.resolve(toIssue(mustGet(key))),
     create: (input) => Promise.resolve(toIssue(store.createLocalIssue(projectId, input))),
@@ -611,13 +875,22 @@ function createLocalAdapter({ store, projectId, author }) {
       if (row === void 0) throw new TrackerError("unknown_issue", `\u0412 \u043B\u043E\u043A\u0430\u043B\u044C\u043D\u043E\u043C \u0442\u0440\u0435\u043A\u0435\u0440\u0435 \u043D\u0435\u0442 \u0437\u0430\u0434\u0430\u0447\u0438 ${key}.`);
       return Promise.resolve(toIssue(row));
     },
-    comments: (key, query) => {
+    comments: async (key, query) => {
+      assertCommentQuery("\u041A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 Local", ISSUE_CAPABILITIES3.comments, query);
       const page = store.listLocalComments(projectId, mustGet(key).number, { limit: query.limit, ...query.cursor === void 0 ? {} : { cursor: query.cursor } });
-      return Promise.resolve({ items: page.items.map(toComment), ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor } });
+      const items = query.updatedAfter === void 0 ? page.items : page.items.filter((row) => inTimeRange(row.createdAt, query.updatedAfter, void 0));
+      return { items: items.map(toComment), ...page.nextCursor === void 0 ? {} : { nextCursor: page.nextCursor } };
     },
     comment: (key, body) => Promise.resolve(toComment(store.addLocalComment(projectId, mustGet(key).number, body, author)))
   };
 }
+function matchesIssueQuery(row, query) {
+  if (query.labels !== void 0 && !query.labels.every((label) => row.labels.includes(label))) return false;
+  const assignee = query.assignee;
+  if (assignee !== void 0 && (assignee === null ? row.assignee !== void 0 : row.assignee !== assignee)) return false;
+  if (query.search !== void 0 && !containsText([row.title, row.description], query.search)) return false;
+  return inTimeRange(row.createdAt, query.createdAfter, query.createdBefore) && inTimeRange(row.updatedAt, query.updatedAfter, query.updatedBefore);
+}
 function toIssue(row) {
   return {
     key: String(row.number),
@@ -641,6 +914,16 @@ var DEFAULT_API2 = "https://api.sourcecraft.tech";
 var DEFAULT_WEB = "https://sourcecraft.dev";
 var TARGET3 = /^[\w.-]+\/[\w.-]+$/;
 var SLUG = /^[\w-]{1,100}$/;
+var ISSUE_SORT_FIELDS_UPSTREAM = {
+  created: "created_at",
+  updated: "updated_at",
+  priority: "priority",
+  title: "title"
+};
+var ISSUE_CAPABILITIES4 = {
+  list: { filters: ISSUE_FILTERS, clientSide: ["assignee"], sorts: ["created", "updated", "priority", "title"] },
+  comments: { filters: COMMENT_FILTERS, clientSide: COMMENT_FILTERS, order: ["asc", "desc"] }
+};
 function sourcecraftTracker() {
   return {
     descriptor: {
@@ -653,6 +936,7 @@ function sourcecraftTracker() {
       ],
       features: { create: true, update: true, comment: true, priority: true, labels: false, assignee: false, statuses: [...ALL_STATUSES] }
     },
+    issues: ISSUE_CAPABILITIES4,
     create: (context) => createSourceCraftAdapter(context)
   };
 }
@@ -670,12 +954,18 @@ function createSourceCraftAdapter({ connection, fetch }) {
   const toIssue2 = (raw) => issueOf4(raw, web);
   return {
     list: async (query) => {
+      assertListQuery("\u0417\u0430\u0434\u0430\u0447\u0438 SourceCraft", ISSUE_CAPABILITIES4.list, query, ISSUE_FILTERS);
       const params = new URLSearchParams({ page_size: String(query.limit) });
       if (query.cursor !== void 0) params.set("page_token", query.cursor);
+      const filter = issueFilterOf(query);
+      if (filter !== void 0) params.set("filter", filter);
+      if (query.sort !== void 0) params.set("sort_by", `${query.sort.direction === "asc" ? "" : "-"}${issueSortFieldOf(query.sort.field)}`);
       const { body } = await requestJson(`${root}?${params.toString()}`, { fetch, headers });
       const record = isRecord(body) ? body : {};
-      const issues = (Array.isArray(record.issues) ? record.issues : []).map(toIssue2);
-      return { items: query.status === void 0 ? issues : issues.filter((issue) => query.status?.includes(issue.status.category) === true), ...nextOf(record.next_page_token) };
+      let issues = (Array.isArray(record.issues) ? record.issues : []).map(toIssue2);
+      if (query.status !== void 0) issues = issues.filter((issue) => query.status?.includes(issue.status.category) === true);
+      if (query.assignee === null) issues = issues.filter((issue) => issue.assignee === void 0);
+      return { items: issues, ...nextOf(record.next_page_token) };
     },
     get: async (key) => toIssue2((await requestJson(`${root}/${slug(key)}`, { fetch, headers, missingIsIssue: true })).body),
     create: async (input) => {
@@ -684,11 +974,15 @@ function createSourceCraftAdapter({ connection, fetch }) {
     },
     update: async (key, patch) => toIssue2((await requestJson(`${root}/${slug(key)}`, { fetch, headers, method: "PATCH", body: patchBody3(patch), missingIsIssue: true })).body),
     comments: async (key, query) => {
+      assertCommentQuery("\u041A\u043E\u043C\u043C\u0435\u043D\u0442\u0430\u0440\u0438\u0438 SourceCraft", ISSUE_CAPABILITIES4.comments, query);
       const params = new URLSearchParams({ page_size: String(query.limit) });
       if (query.cursor !== void 0) params.set("page_token", query.cursor);
+      if (query.order !== void 0) params.set("sort_by", query.order === "asc" ? "created_at" : "-created_at");
       const { body } = await requestJson(`${root}/${slug(key)}/comments?${params.toString()}`, { fetch, headers, missingIsIssue: true });
       const record = isRecord(body) ? body : {};
-      return { items: (Array.isArray(record.issue_comments) ? record.issue_comments : []).map(commentOf4), ...nextOf(record.next_page_token) };
+      const rawComments = Array.isArray(record.issue_comments) ? record.issue_comments : [];
+      const filtered = query.updatedAfter === void 0 ? rawComments : rawComments.filter((raw) => inTimeRange(toTimestamp(isRecord(raw) ? raw.updated_at : void 0), query.updatedAfter, void 0));
+      return { items: filtered.map(commentOf4), ...nextOf(record.next_page_token) };
     },
     comment: async (key, body) => commentOf4((await requestJson(`${root}/${slug(key)}/comments`, { fetch, headers, method: "POST", body: { body }, missingIsIssue: true })).body)
   };
@@ -705,6 +999,27 @@ function nextOf(token) {
   const value = text(token);
   return value === void 0 ? {} : { nextCursor: value };
 }
+function issueSortFieldOf(field) {
+  const upstream = ISSUE_SORT_FIELDS_UPSTREAM[field];
+  if (upstream === void 0) throw new TrackerError("unsupported", `\u0417\u0430\u0434\u0430\u0447\u0438 SourceCraft: \u0441\u043E\u0440\u0442\u0438\u0440\u043E\u0432\u043A\u0430 \u043F\u043E ${field} \u043D\u0435 \u043F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u0442\u0441\u044F.`);
+  return upstream;
+}
+function issueFilterOf(query) {
+  const clauses = [];
+  if (query.status !== void 0 && query.status.length > 0) {
+    const slugs = [...new Set(query.status.flatMap((category) => SOURCECRAFT_STATUS_FILTER[category]))];
+    clauses.push(`status in (${slugs.join(", ")})`);
+  }
+  for (const label of query.labels ?? []) clauses.push(`label_slug=${quoted(label)}`);
+  if (typeof query.assignee === "string") clauses.push(`assignee_slug=${quoted(query.assignee)}`);
+  if (query.author !== void 0) clauses.push(`author_slug=${quoted(query.author)}`);
+  if (query.search !== void 0) clauses.push(`title=${quoted(query.search)}`);
+  if (query.createdAfter !== void 0) clauses.push(`created_at>=${quoted(isoTime(query.createdAfter))}`);
+  if (query.createdBefore !== void 0) clauses.push(`created_at<=${quoted(isoTime(query.createdBefore))}`);
+  if (query.updatedAfter !== void 0) clauses.push(`updated_at>=${quoted(isoTime(query.updatedAfter))}`);
+  if (query.updatedBefore !== void 0) clauses.push(`updated_at<=${quoted(isoTime(query.updatedBefore))}`);
+  return clauses.length === 0 ? void 0 : clauses.join(" and ");
+}
 function issueOf4(raw, web) {
   const item = isRecord(raw) ? raw : {};
   const status = isRecord(item.status) ? item.status : {};
@@ -794,17 +1109,22 @@ function deleteTrackerToken(dataDir, projectId, sink = defaultSecretSink) {
 }
 export {
   ALL_STATUSES,
+  COMMENT_FILTERS,
   GITHUB_CLOSE_REASONS,
   GITHUB_IN_PROGRESS_LABEL,
   GITHUB_PRIORITY_LABELS,
   GITLAB_IN_PROGRESS_LABEL,
   GITLAB_PRIORITY_LABELS,
+  ISSUE_FILTERS,
+  ISSUE_SORT_FIELDS,
   JIRA_ISSUE_TYPE,
   JIRA_PRIORITIES,
   JIRA_PRIORITY_NAMES,
   JIRA_STATUS_CATEGORIES,
+  LEGACY_ISSUE_CAPABILITIES,
   SOURCECRAFT_PRIORITIES,
   SOURCECRAFT_STATUSES,
+  SOURCECRAFT_STATUS_FILTER,
   SOURCECRAFT_STATUS_SLUGS,
   TRACKER_ERROR_BODY_MAX,
   TRACKER_LOCAL_AUTHOR,
@@ -812,20 +1132,28 @@ export {
   TRACKER_SECRETS_FILE,
   TRACKER_TIMEOUT_MS,
   TrackerError,
+  assertCommentQuery,
+  assertListQuery,
   baseUrl,
   clipText,
+  containsText,
   deleteTrackerToken,
   findTracker,
   githubTracker,
   gitlabTracker,
   hasTrackerToken,
+  inTimeRange,
   isRecord,
+  isoTime,
+  issueCapabilitiesOf,
   jiraTracker,
+  keysFor,
   listTrackers,
   localTracker,
   lookup,
   nameOf,
   priorityName,
+  quoted,
   readTrackerToken,
   registerBuiltinTrackers,
   registerTracker,
@@ -835,6 +1163,7 @@ export {
   stringList,
   text,
   toTimestamp,
+  usedFilters,
   writeTrackerToken
 };
 //# sourceMappingURL=index.js.map