@danypops/tickets 0.5.0 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/tickets",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Unified CLI, daemon, and TypeScript library for issue tracking across GitHub, GitLab, and Jira.",
   "type": "module",
   "license": "MIT",

package/src/adapters/jira.ts

@@ -295,6 +295,24 @@ export class JiraRepository {
     return result.jql;
   }
 
+  /**
+   * BoardFilterDiscoverable -- resolves a board's own real base scope: its saved
+   * filter's JQL, via `GET /rest/agile/1.0/board/{boardId}/configuration` (filter
+   * id) then `GET /rest/api/2/filter/{id}` (that filter's JQL). This is the actual
+   * project/query scope a board tracks -- assuming a board scopes to a single named
+   * project (e.g. matching a URL path segment) is a guess, not a fact; a project can
+   * be renamed or a board's filter can span multiple projects, so this is always
+   * resolved from Jira, never inferred from a project key string.
+   */
+  async discoverBoardFilterJql(boardId: number): Promise<string> {
+    const config = await this.call<{ filter?: { id?: string } }>(() => this.agileClient().board.getConfiguration({ boardId }));
+    const filterId = config?.filter?.id;
+    if (!filterId) throw new Error(`jira: board ${boardId} has no configured filter`);
+    const filter = await this.call<{ jql?: string }>(() => this.client.filters.getFilter({ id: Number(filterId) }));
+    if (!filter?.jql) throw new Error(`jira: filter ${filterId} (board ${boardId}'s own filter) has no JQL`);
+    return filter.jql;
+  }
+
   private agileClientInstance?: AgileClient;
 
   private agileClient(): AgileClient {

package/src/application/service.ts

@@ -8,6 +8,7 @@ import type { Comment, CreateInput, Issue, ListFilter, UpdateInput } from "../do
 import { parseRef } from "../domain/issue.js";
 import type { Template } from "../domain/template.js";
 import {
+  hasBoardFilterDiscovery,
   hasBoardQuickFilterDiscovery,
   hasComments,
   hasFieldDiscovery,
@@ -133,4 +134,11 @@ export class TicketService {
     if (!hasBoardQuickFilterDiscovery(repo)) throw new NotSupportedError(backend, "board quick filter discovery");
     return repo.discoverBoardQuickFilterJql(boardId, quickFilterId);
   }
+
+  /** Resolves a Jira board's own real base scope (its saved filter's JQL) -- never assume a board tracks one named project. */
+  async discoverBoardFilterJql(backend: string, boardId: number): Promise<string> {
+    const repo = this.repo(backend);
+    if (!hasBoardFilterDiscovery(repo)) throw new NotSupportedError(backend, "board filter discovery");
+    return repo.discoverBoardFilterJql(boardId);
+  }
 }

package/src/cli/index.ts

@@ -230,6 +230,15 @@ discoverCmd
     );
   });
 
+discoverCmd
+  .command("board_filter")
+  .description("resolve a Jira board's own real base scope -- its saved filter's JQL -- instead of assuming it tracks one named project")
+  .requiredOption("-b, --backend <name>", "backend name")
+  .requiredOption("--board <id>", "board id", (v) => Number.parseInt(v, 10))
+  .action(async (opts) => {
+    await withClient((client) => client.call("discover.board_filter", { backend: opts.backend, boardId: opts.board }));
+  });
+
 const queryCmd = program.command("query").description("save and run named raw backend queries (Jira JQL) -- e.g. a board's sprint or backlog view");
 
 queryCmd

package/src/daemon/ops.ts

@@ -30,6 +30,7 @@ export type TicketOperation =
   | "discover.statuses"
   | "discover.template"
   | "discover.board_quickfilter"
+  | "discover.board_filter"
   | "query.save"
   | "query.list"
   | "query.remove"
@@ -57,6 +58,7 @@ export interface TicketOpInputs extends Record<TicketOperation, unknown> {
   "discover.statuses": { backend: string };
   "discover.template": { backend: string; project: string; issueType: string; sampleSize?: number };
   "discover.board_quickfilter": { backend: string; boardId: number; quickFilterId: number };
+  "discover.board_filter": { backend: string; boardId: number };
   "query.save": { name: string; backend: string; query: string; description?: string };
   "query.list": Record<string, never>;
   "query.remove": { name: string };
@@ -85,6 +87,7 @@ export interface TicketOpOutputs extends Record<TicketOperation, unknown> {
   "discover.statuses": { mappings: Record<string, string> };
   "discover.template": { template: Template | null };
   "discover.board_quickfilter": { jql: string };
+  "discover.board_filter": { jql: string };
   "query.save": { query: SavedQuery };
   "query.list": { queries: SavedQuery[] };
   "query.remove": { removed: boolean };
@@ -113,6 +116,7 @@ export const TICKET_OPERATIONS: TicketOperation[] = [
   "discover.statuses",
   "discover.template",
   "discover.board_quickfilter",
+  "discover.board_filter",
   "query.save",
   "query.list",
   "query.remove",

package/src/daemon/server.ts

@@ -94,6 +94,7 @@ export const TICKET_OP_HANDLERS: { [Op in TicketOperation]: Handler<Op> } = {
   "discover.board_quickfilter": async (deps, input) => ({
     jql: await deps.service.discoverBoardQuickFilterJql(input.backend, input.boardId, input.quickFilterId),
   }),
+  "discover.board_filter": async (deps, input) => ({ jql: await deps.service.discoverBoardFilterJql(input.backend, input.boardId) }),
   "query.save": async (deps, input) => ({ query: deps.queries.save(input.name, input.backend, input.query, input.description) }),
   "query.list": async (deps) => ({ queries: deps.queries.list() }),
   "query.remove": async (deps, input) => ({ removed: deps.queries.remove(input.name) }),

package/src/ports/repository.ts

@@ -88,3 +88,15 @@ export interface BoardQuickFilterDiscoverable {
 export function hasBoardQuickFilterDiscovery(repo: IssueRepository): repo is IssueRepository & BoardQuickFilterDiscoverable {
   return typeof (repo as Partial<BoardQuickFilterDiscoverable>).discoverBoardQuickFilterJql === "function";
 }
+
+/**
+ * Optional capability — resolves a Jira board's own real base scope (its saved
+ * filter's JQL) rather than assuming a board tracks one named project. Jira only.
+ */
+export interface BoardFilterDiscoverable {
+  discoverBoardFilterJql(boardId: number): Promise<string>;
+}
+
+export function hasBoardFilterDiscovery(repo: IssueRepository): repo is IssueRepository & BoardFilterDiscoverable {
+  return typeof (repo as Partial<BoardFilterDiscoverable>).discoverBoardFilterJql === "function";
+}

package/src/vehicle/tickets-vehicle.ts

@@ -112,6 +112,13 @@ const OPERATIONS: readonly OperationSpec[] = [
     properties: { backend: stringProp, boardId: numberProp, quickFilterId: numberProp },
     required: ["backend", "boardId", "quickFilterId"],
   },
+  {
+    action: "discover.board_filter",
+    description: "Resolves a Jira board's own real base scope -- its saved filter's JQL -- rather than assuming it tracks one named project.",
+    effect: "read",
+    properties: { backend: stringProp, boardId: numberProp },
+    required: ["backend", "boardId"],
+  },
   {
     action: "query.save",
     description: "Saves a raw backend query (Jira JQL) under a name, so it can be run again later without retyping it -- e.g. a board's sprint or backlog view.",