@cat-factory/integrations 0.6.0

package/dist/modules/tasks/TaskConnectionService.js

@@ -0,0 +1,69 @@
+import { ConflictError, ValidationError } from '@cat-factory/kernel';
+import { requireWorkspace } from '@cat-factory/kernel';
+function toConnection(record) {
+    return {
+        source: record.source,
+        label: record.label,
+        connectedAt: record.createdAt,
+    };
+}
+export class TaskConnectionService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** The descriptors of every configured source (drives the connect UI). */
+    listSources() {
+        return this.deps.registry.list().map((p) => p.descriptor);
+    }
+    /** Resolve a provider for a source or throw if that source isn't configured. */
+    requireProvider(source) {
+        const provider = this.deps.registry.get(source);
+        if (!provider)
+            throw new ValidationError(`Unknown or unconfigured task source '${source}'`);
+        return provider;
+    }
+    /** Connect (or re-connect) a workspace to a task source. */
+    async connect(workspaceId, source, credentials) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const provider = this.requireProvider(source);
+        const normalized = provider.normalizeConnection(credentials);
+        const existing = await this.deps.taskConnectionRepository.getByWorkspace(workspaceId, source);
+        const record = {
+            workspaceId,
+            source,
+            credentials: normalized.credentials,
+            label: normalized.label,
+            createdAt: existing?.createdAt ?? this.deps.clock.now(),
+            deletedAt: null,
+        };
+        await this.deps.taskConnectionRepository.upsert(record);
+        return toConnection(record);
+    }
+    /** The workspace's current connection for a source, or null if not connected. */
+    async getConnection(workspaceId, source) {
+        const record = await this.deps.taskConnectionRepository.getByWorkspace(workspaceId, source);
+        return record ? toConnection(record) : null;
+    }
+    /** Every live connection the workspace holds, across sources. */
+    async listConnections(workspaceId) {
+        const records = await this.deps.taskConnectionRepository.listByWorkspace(workspaceId);
+        return records.map(toConnection);
+    }
+    /** Resolve the live connection (with credentials) or throw if not connected. */
+    async requireConnection(workspaceId, source) {
+        const record = await this.deps.taskConnectionRepository.getByWorkspace(workspaceId, source);
+        if (!record) {
+            throw new ConflictError(`Workspace '${workspaceId}' is not connected to ${source}`);
+        }
+        return record;
+    }
+    /** Disconnect a workspace from a source (tombstones the binding). */
+    async disconnect(workspaceId, source) {
+        const record = await this.deps.taskConnectionRepository.getByWorkspace(workspaceId, source);
+        if (!record)
+            return;
+        await this.deps.taskConnectionRepository.softDelete(workspaceId, source, this.deps.clock.now());
+    }
+}
+//# sourceMappingURL=TaskConnectionService.js.map

package/dist/modules/tasks/TaskConnectionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskConnectionService.js","sourceRoot":"","sources":["../../../src/modules/tasks/TaskConnectionService.ts"],"names":[],"mappings":"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"}

package/dist/modules/tasks/TaskImportService.d.ts

@@ -0,0 +1,34 @@
+import type { Clock } from '@cat-factory/kernel';
+import type { TaskSourceRegistry } from '@cat-factory/kernel';
+import type { TaskRecord, TaskRepository } from '@cat-factory/kernel';
+import type { SourceTask, TaskSearchResult, TaskSourceKind } from '@cat-factory/kernel';
+import type { WorkspaceRepository } from '@cat-factory/kernel';
+import type { TaskConnectionService } from './TaskConnectionService.js';
+export interface TaskImportServiceDependencies {
+    registry: TaskSourceRegistry;
+    taskRepository: TaskRepository;
+    connectionService: TaskConnectionService;
+    workspaceRepository: WorkspaceRepository;
+    clock: Clock;
+}
+/** Project a stored task record onto the wire shape (drops the tombstone). */
+export declare function toSourceTask(record: TaskRecord): SourceTask;
+export declare class TaskImportService {
+    private readonly deps;
+    constructor(deps: TaskImportServiceDependencies);
+    private requireProvider;
+    /** Fetch an issue (by key or URL) and upsert its projection; returns the issue. */
+    import(workspaceId: string, source: TaskSourceKind, ref: string): Promise<SourceTask>;
+    /**
+     * Search a tracker by free text, returning lean hits (not yet imported). The
+     * provider authenticates with the workspace's stored credentials and builds/
+     * parses the source-specific query. Throws if the source can't search (no
+     * provider `search`), so the controller can answer cleanly.
+     */
+    search(workspaceId: string, source: TaskSourceKind, query: string): Promise<TaskSearchResult[]>;
+    /** Every issue imported into the workspace, across sources, as wire shapes. */
+    listTasks(workspaceId: string): Promise<SourceTask[]>;
+    /** Resolve a stored task record or throw if not imported. */
+    requireTask(workspaceId: string, source: TaskSourceKind, externalId: string): Promise<TaskRecord>;
+}
+//# sourceMappingURL=TaskImportService.d.ts.map

package/dist/modules/tasks/TaskImportService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskImportService.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/TaskImportService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AASvE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,cAAc,EAAE,cAAc,CAAA;IAC9B,iBAAiB,EAAE,qBAAqB,CAAA;IACxC,mBAAmB,EAAE,mBAAmB,CAAA;IACxC,KAAK,EAAE,KAAK,CAAA;CACb;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAiB3D;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,6BAA6B,EAAI;IAEpE,OAAO,CAAC,eAAe;IAMvB,mFAAmF;IAC7E,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgC1F;IAED;;;;;OAKG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAQ7B;IAED,+EAA+E;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAG1D;IAED,6DAA6D;IACvD,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAMrB;CACF"}

package/dist/modules/tasks/TaskImportService.js

@@ -0,0 +1,96 @@
+import { ValidationError } from '@cat-factory/kernel';
+import { requireWorkspace } from '@cat-factory/kernel';
+import { buildTaskExcerpt } from './tasks.logic.js';
+/** Project a stored task record onto the wire shape (drops the tombstone). */
+export function toSourceTask(record) {
+    return {
+        source: record.source,
+        externalId: record.externalId,
+        title: record.title,
+        url: record.url,
+        status: record.status,
+        type: record.type,
+        assignee: record.assignee,
+        priority: record.priority,
+        labels: record.labels,
+        description: record.description,
+        comments: record.comments,
+        excerpt: record.excerpt,
+        linkedBlockId: record.linkedBlockId,
+        syncedAt: record.syncedAt,
+    };
+}
+export class TaskImportService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    requireProvider(source) {
+        const provider = this.deps.registry.get(source);
+        if (!provider)
+            throw new ValidationError(`Unknown or unconfigured task source '${source}'`);
+        return provider;
+    }
+    /** Fetch an issue (by key or URL) and upsert its projection; returns the issue. */
+    async import(workspaceId, source, ref) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const provider = this.requireProvider(source);
+        const externalId = provider.parseRef(ref);
+        if (!externalId) {
+            throw new ValidationError(`Could not resolve a ${source} issue key from '${ref}'`);
+        }
+        const connection = await this.deps.connectionService.requireConnection(workspaceId, source);
+        const content = await provider.fetchTask(connection.credentials, externalId);
+        // Preserve any existing block link across a re-import.
+        const existing = await this.deps.taskRepository.get(workspaceId, source, content.externalId);
+        const record = {
+            workspaceId,
+            source,
+            externalId: content.externalId,
+            title: content.title,
+            url: content.url,
+            status: content.status,
+            type: content.type,
+            assignee: content.assignee,
+            priority: content.priority,
+            labels: content.labels,
+            description: content.description,
+            comments: content.comments,
+            excerpt: buildTaskExcerpt(content),
+            linkedBlockId: existing?.linkedBlockId ?? null,
+            syncedAt: this.deps.clock.now(),
+            deletedAt: null,
+        };
+        await this.deps.taskRepository.upsert(record);
+        return toSourceTask(record);
+    }
+    /**
+     * Search a tracker by free text, returning lean hits (not yet imported). The
+     * provider authenticates with the workspace's stored credentials and builds/
+     * parses the source-specific query. Throws if the source can't search (no
+     * provider `search`), so the controller can answer cleanly.
+     */
+    async search(workspaceId, source, query) {
+        await requireWorkspace(this.deps.workspaceRepository, workspaceId);
+        const provider = this.requireProvider(source);
+        if (!provider.search) {
+            throw new ValidationError(`The ${source} source does not support search`);
+        }
+        const connection = await this.deps.connectionService.requireConnection(workspaceId, source);
+        return provider.search(connection.credentials, query, workspaceId);
+    }
+    /** Every issue imported into the workspace, across sources, as wire shapes. */
+    async listTasks(workspaceId) {
+        const records = await this.deps.taskRepository.listByWorkspace(workspaceId);
+        return records.map(toSourceTask);
+    }
+    /** Resolve a stored task record or throw if not imported. */
+    async requireTask(workspaceId, source, externalId) {
+        const record = await this.deps.taskRepository.get(workspaceId, source, externalId);
+        if (!record) {
+            throw new ValidationError(`${source} issue '${externalId}' has not been imported`);
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=TaskImportService.js.map

package/dist/modules/tasks/TaskImportService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskImportService.js","sourceRoot":"","sources":["../../../src/modules/tasks/TaskImportService.ts"],"names":[],"mappings":"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"}

package/dist/modules/tasks/TaskLinkService.d.ts

@@ -0,0 +1,30 @@
+import type { Block, SourceTask, TaskSourceKind } from '@cat-factory/kernel';
+import type { BlockRepository } from '@cat-factory/kernel';
+import type { BoardWritePort } from '@cat-factory/kernel';
+import type { TaskRepository } from '@cat-factory/kernel';
+export interface TaskLinkServiceDependencies {
+    boardService: BoardWritePort;
+    blockRepository: BlockRepository;
+    taskRepository: TaskRepository;
+}
+/** A board task created from an imported issue, plus the now-linked issue. */
+export interface TaskFromIssue {
+    block: Block;
+    task: SourceTask;
+}
+export declare class TaskLinkService {
+    private readonly deps;
+    constructor(deps: TaskLinkServiceDependencies);
+    /** Attach an imported issue to a board block as extra agent context. */
+    linkToBlock(workspaceId: string, blockId: string, source: TaskSourceKind, externalId: string): Promise<SourceTask>;
+    /**
+     * Create a new board task from an already-imported issue, inside a container
+     * (service frame or module), and link the issue to the new task for context.
+     * The title/description are seeded from the issue; the issue stays the source
+     * of truth (re-importing refreshes it) and is fed to every agent step via the
+     * link. Reuses BoardService.addTask so scope/placement rules stay in one place.
+     * `createdBy` (the signed-in user) flows onto the new task for notification routing.
+     */
+    createTaskFromIssue(workspaceId: string, containerId: string, source: TaskSourceKind, externalId: string, createdBy?: string | null): Promise<TaskFromIssue>;
+}
+//# sourceMappingURL=TaskLinkService.d.ts.map

package/dist/modules/tasks/TaskLinkService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskLinkService.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/TaskLinkService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAc,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAExF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAUzD,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,cAAc,CAAA;IAC5B,eAAe,EAAE,eAAe,CAAA;IAChC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,2BAA2B,EAAI;IAElE,wEAAwE;IAClE,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAarB;IAED;;;;;;;OAOG;IACG,mBAAmB,CACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,aAAa,CAAC,CAgCxB;CACF"}

package/dist/modules/tasks/TaskLinkService.js

@@ -0,0 +1,56 @@
+import { assertFound, ConflictError } from '@cat-factory/kernel';
+import { toSourceTask } from './TaskImportService.js';
+export class TaskLinkService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Attach an imported issue to a board block as extra agent context. */
+    async linkToBlock(workspaceId, blockId, source, externalId) {
+        const block = assertFound(await this.deps.blockRepository.get(workspaceId, blockId), 'Block', blockId);
+        const task = assertFound(await this.deps.taskRepository.get(workspaceId, source, externalId), 'Task', externalId);
+        await this.deps.taskRepository.linkBlock(workspaceId, source, externalId, block.id);
+        return toSourceTask({ ...task, linkedBlockId: block.id });
+    }
+    /**
+     * Create a new board task from an already-imported issue, inside a container
+     * (service frame or module), and link the issue to the new task for context.
+     * The title/description are seeded from the issue; the issue stays the source
+     * of truth (re-importing refreshes it) and is fed to every agent step via the
+     * link. Reuses BoardService.addTask so scope/placement rules stay in one place.
+     * `createdBy` (the signed-in user) flows onto the new task for notification routing.
+     */
+    async createTaskFromIssue(workspaceId, containerId, source, externalId, createdBy) {
+        const issue = assertFound(await this.deps.taskRepository.get(workspaceId, source, externalId), 'Task', externalId);
+        // An issue carries a single `linkedBlockId`, so creating a second task from it
+        // would silently re-point the link and orphan the first task's issue context.
+        // Refuse rather than lose the existing link (the issue is the source of truth).
+        if (issue.linkedBlockId) {
+            throw new ConflictError(`Issue ${externalId} is already linked to task ${issue.linkedBlockId}; unlink it first`);
+        }
+        // Resolve the container in the REQUEST workspace (like linkToBlock) so the new
+        // block and the issue projection share a workspace — the issue link is workspace-
+        // scoped, so creating the task in a service mounted from another workspace would
+        // leave the link unresolvable at execution time. A foreign/unknown container 404s.
+        assertFound(await this.deps.blockRepository.get(workspaceId, containerId), 'Block', containerId);
+        const block = await this.deps.boardService.addTask(workspaceId, containerId, {
+            title: issueTaskTitle(issue),
+            description: issueTaskDescription(issue),
+        }, createdBy ?? null);
+        // Link the issue to the new task so agents get the full issue (description,
+        // comments, metadata) as context — and the task carries the back-reference.
+        await this.deps.taskRepository.linkBlock(workspaceId, source, externalId, block.id);
+        return { block, task: toSourceTask({ ...issue, linkedBlockId: block.id }) };
+    }
+}
+/** Seed the new task's title from the issue (keyed for traceability). */
+function issueTaskTitle(issue) {
+    return `${issue.externalId}: ${issue.title}`;
+}
+/** Seed the new task's description: a source reference line + the issue body. */
+function issueTaskDescription(issue) {
+    const reference = `Imported from ${issue.url}`;
+    const body = issue.description.trim() || issue.excerpt.trim();
+    return body ? `${reference}\n\n${body}` : reference;
+}
+//# sourceMappingURL=TaskLinkService.js.map

package/dist/modules/tasks/TaskLinkService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskLinkService.js","sourceRoot":"","sources":["../../../src/modules/tasks/TaskLinkService.ts"],"names":[],"mappings":"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"}

package/dist/modules/tasks/github-issues.logic.d.ts

@@ -0,0 +1,35 @@
+import type { TaskSourceDescriptor } from '@cat-factory/kernel';
+/**
+ * What the connect UI renders. GitHub issues piggyback on the workspace's
+ * existing GitHub App installation, so there are NO credential fields — the
+ * connect form is just a confirmation, and `normalizeConnection` accepts an empty
+ * bag.
+ */
+export declare const GITHUB_ISSUES_DESCRIPTOR: TaskSourceDescriptor;
+/** The canonical `owner/repo#number` external id for an issue's parts. */
+export declare function githubIssueExternalId(id: GitHubIssueExternalId): string;
+/**
+ * Resolve a GitHub issue reference from raw user input into the canonical
+ * `owner/repo#number` external id. Accepts:
+ *   - a full issue URL: `https://github.com/octo/repo/issues/123`
+ *   - the `octo/repo/issues/123` path form
+ *   - the shorthand `octo/repo#123`
+ * Returns null when nothing parses. The owner/repo are kept verbatim (GitHub repo
+ * names are case-preserving); only surrounding whitespace is trimmed.
+ */
+export declare function parseGitHubIssueRef(input: string): string | null;
+/** The parts of a GitHub issue external id (`owner/repo#number`). */
+export interface GitHubIssueExternalId {
+    owner: string;
+    repo: string;
+    number: number;
+}
+/**
+ * Split a stored `owner/repo#number` external id back into its parts. Returns
+ * null if the id is malformed (defensive — ids are produced by
+ * {@link parseGitHubIssueRef}, but a stale/hand-edited row should not throw).
+ */
+export declare function parseGitHubIssueExternalId(externalId: string): GitHubIssueExternalId | null;
+/** The canonical web URL for an issue external id. */
+export declare function githubIssueUrl(id: GitHubIssueExternalId): string;
+//# sourceMappingURL=github-issues.logic.d.ts.map

package/dist/modules/tasks/github-issues.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issues.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/github-issues.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAU/D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,oBAQtC,CAAA;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAEvE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAED,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAI3F;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,EAAE,EAAE,qBAAqB,GAAG,MAAM,CAEhE"}

package/dist/modules/tasks/github-issues.logic.js

@@ -0,0 +1,67 @@
+// GitHub-issues task-source pure logic, kept out of the worker so it is
+// unit-testable without a live API: parsing an issue reference out of user input
+// and round-tripping the `owner/repo#number` external id the provider stores. The
+// fetch itself lives in the worker's GitHubIssuesProvider, which reuses the
+// workspace's installed GitHub App (so this source needs no credentials of its
+// own — unlike Jira). GitHub issue bodies are already Markdown, so there is no
+// body-conversion step here.
+/**
+ * What the connect UI renders. GitHub issues piggyback on the workspace's
+ * existing GitHub App installation, so there are NO credential fields — the
+ * connect form is just a confirmation, and `normalizeConnection` accepts an empty
+ * bag.
+ */
+export const GITHUB_ISSUES_DESCRIPTOR = {
+    source: 'github',
+    label: 'GitHub Issues',
+    icon: 'i-lucide-github',
+    credentialFields: [],
+    refLabel: 'Issue URL or owner/repo#number',
+    refPlaceholder: 'octo/repo#123  or  https://github.com/octo/repo/issues/123',
+    searchable: true,
+};
+/** The canonical `owner/repo#number` external id for an issue's parts. */
+export function githubIssueExternalId(id) {
+    return `${id.owner}/${id.repo}#${id.number}`;
+}
+// A GitHub owner/repo segment: letters, digits, '.', '_' and '-'. Deliberately
+// permissive but bounded so a stray path can't masquerade as a ref.
+const SEG = '[A-Za-z0-9._-]+';
+/**
+ * Resolve a GitHub issue reference from raw user input into the canonical
+ * `owner/repo#number` external id. Accepts:
+ *   - a full issue URL: `https://github.com/octo/repo/issues/123`
+ *   - the `octo/repo/issues/123` path form
+ *   - the shorthand `octo/repo#123`
+ * Returns null when nothing parses. The owner/repo are kept verbatim (GitHub repo
+ * names are case-preserving); only surrounding whitespace is trimmed.
+ */
+export function parseGitHubIssueRef(input) {
+    const trimmed = input.trim();
+    const url = trimmed.match(new RegExp(`github\\.com/(${SEG})/(${SEG})/issues/(\\d+)`));
+    if (url)
+        return `${url[1]}/${url[2]}#${url[3]}`;
+    const path = trimmed.match(new RegExp(`^(${SEG})/(${SEG})/issues/(\\d+)$`));
+    if (path)
+        return `${path[1]}/${path[2]}#${path[3]}`;
+    const short = trimmed.match(new RegExp(`^(${SEG})/(${SEG})#(\\d+)$`));
+    if (short)
+        return `${short[1]}/${short[2]}#${short[3]}`;
+    return null;
+}
+/**
+ * Split a stored `owner/repo#number` external id back into its parts. Returns
+ * null if the id is malformed (defensive — ids are produced by
+ * {@link parseGitHubIssueRef}, but a stale/hand-edited row should not throw).
+ */
+export function parseGitHubIssueExternalId(externalId) {
+    const m = externalId.match(new RegExp(`^(${SEG})/(${SEG})#(\\d+)$`));
+    if (!m)
+        return null;
+    return { owner: m[1], repo: m[2], number: Number(m[3]) };
+}
+/** The canonical web URL for an issue external id. */
+export function githubIssueUrl(id) {
+    return `https://github.com/${id.owner}/${id.repo}/issues/${id.number}`;
+}
+//# sourceMappingURL=github-issues.logic.js.map

package/dist/modules/tasks/github-issues.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issues.logic.js","sourceRoot":"","sources":["../../../src/modules/tasks/github-issues.logic.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,iFAAiF;AACjF,kFAAkF;AAClF,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,6BAA6B;AAE7B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAyB;IAC5D,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,eAAe;IACtB,IAAI,EAAE,iBAAiB;IACvB,gBAAgB,EAAE,EAAE;IACpB,QAAQ,EAAE,gCAAgC;IAC1C,cAAc,EAAE,4DAA4D;IAC5E,UAAU,EAAE,IAAI;CACjB,CAAA;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,EAAyB;IAC7D,OAAO,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,EAAE,CAAA;AAC9C,CAAC;AAED,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,GAAG,GAAG,iBAAiB,CAAA;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,iBAAiB,GAAG,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAA;IACrF,IAAI,GAAG;QAAE,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAA;IAC3E,IAAI,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAA;IACrE,IAAI,KAAK;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACvD,OAAO,IAAI,CAAA;AACb,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC3D,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAA;IACpE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACnB,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,EAAyB;IACtD,OAAO,sBAAsB,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC"}

package/dist/modules/tasks/jira.logic.d.ts

@@ -0,0 +1,28 @@
+import type { TaskSearchResult, TaskSourceDescriptor } from '@cat-factory/kernel';
+/** What the connect UI renders, and which credentials the provider needs. */
+export declare const JIRA_DESCRIPTOR: TaskSourceDescriptor;
+/**
+ * Build the JQL for a free-text issue search: match the term across summary and
+ * body (`text ~`), newest first. A bare key typed into the box still matches via
+ * `text ~`, so the search box doubles as a quick "jump to issue".
+ */
+export declare function buildJiraSearchJql(query: string): string;
+/** Map a Jira search response into lean hits; URLs are the canonical `/browse/KEY`. */
+export declare function parseJiraSearchResults(json: unknown, base: string): TaskSearchResult[];
+/**
+ * Resolve a Jira issue key from raw user input: a bare key (`PROJ-123`), a
+ * `/browse/PROJ-123` URL, or the `selectedIssue=PROJ-123` / `/issues/PROJ-123`
+ * board URL forms. The key is upper-cased (Jira keys are case-insensitive on
+ * input but canonically upper-case). Returns null when nothing parses.
+ */
+export declare function parseJiraRef(input: string): string | null;
+/**
+ * Convert an Atlassian Document Format node tree into lightweight Markdown: the
+ * same `#`/`##`/`###` headings, `- ` list items and blank-line block boundaries
+ * the generic excerpt/prompt logic consumes. ADF is a JSON document
+ * (`{ type: 'doc', content: [...] }`); we walk it defensively so a missing or
+ * unexpected node yields '' rather than throwing — Jira fields are sometimes
+ * null or a plain string on older issues.
+ */
+export declare function adfToMarkdown(node: unknown): string;
+//# sourceMappingURL=jira.logic.d.ts.map

package/dist/modules/tasks/jira.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/jira.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AASjF,6EAA6E;AAC7E,eAAO,MAAM,eAAe,EAAE,oBAuB7B,CAAA;AAOD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AASD,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgBtF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWzD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAUnD"}

package/dist/modules/tasks/jira.logic.js

@@ -0,0 +1,151 @@
+// Jira-specific pure logic, kept out of the worker so it is unit-testable
+// without a live site: parsing an issue key out of user input and converting an
+// issue's Atlassian Document Format (ADF) body into the lightweight Markdown the
+// generic excerpt/prompt logic consumes. The base-URL guard is shared with
+// Confluence (see ../../shared/atlassian.logic); the fetch itself lives in the
+// worker's JiraProvider.
+/** What the connect UI renders, and which credentials the provider needs. */
+export const JIRA_DESCRIPTOR = {
+    source: 'jira',
+    label: 'Jira',
+    icon: 'i-lucide-square-check',
+    credentialFields: [
+        {
+            key: 'baseUrl',
+            label: 'Site URL',
+            placeholder: 'https://your-team.atlassian.net',
+            help: 'e.g. https://your-team.atlassian.net',
+        },
+        { key: 'accountEmail', label: 'Account email', placeholder: 'you@company.com' },
+        {
+            key: 'apiToken',
+            label: 'API token',
+            secret: true,
+            placeholder: 'Paste a Jira API token',
+            help: 'Create one at id.atlassian.com → Security → API tokens',
+        },
+    ],
+    refLabel: 'Issue key or URL',
+    refPlaceholder: 'PROJ-123  or  https://…/browse/PROJ-123',
+    searchable: true,
+};
+/** Escape a user string for embedding inside a JQL double-quoted literal. */
+function escapeJql(query) {
+    return query.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/**
+ * Build the JQL for a free-text issue search: match the term across summary and
+ * body (`text ~`), newest first. A bare key typed into the box still matches via
+ * `text ~`, so the search box doubles as a quick "jump to issue".
+ */
+export function buildJiraSearchJql(query) {
+    return `text ~ "${escapeJql(query.trim())}" ORDER BY updated DESC`;
+}
+/** Map a Jira search response into lean hits; URLs are the canonical `/browse/KEY`. */
+export function parseJiraSearchResults(json, base) {
+    const body = (json ?? {});
+    const cleanBase = base.replace(/\/+$/, '');
+    const out = [];
+    for (const issue of Array.isArray(body.issues) ? body.issues : []) {
+        if (!issue.key)
+            continue;
+        out.push({
+            source: 'jira',
+            externalId: issue.key,
+            title: issue.fields?.summary ?? '(untitled)',
+            url: `${cleanBase}/browse/${issue.key}`,
+            status: issue.fields?.status?.name ?? '',
+            excerpt: '',
+        });
+    }
+    return out;
+}
+/**
+ * Resolve a Jira issue key from raw user input: a bare key (`PROJ-123`), a
+ * `/browse/PROJ-123` URL, or the `selectedIssue=PROJ-123` / `/issues/PROJ-123`
+ * board URL forms. The key is upper-cased (Jira keys are case-insensitive on
+ * input but canonically upper-case). Returns null when nothing parses.
+ */
+export function parseJiraRef(input) {
+    const trimmed = input.trim();
+    const KEY = /[A-Za-z][A-Za-z0-9]+-\d+/;
+    if (new RegExp(`^${KEY.source}$`).test(trimmed))
+        return trimmed.toUpperCase();
+    const browse = trimmed.match(new RegExp(`/browse/(${KEY.source})`));
+    if (browse)
+        return browse[1].toUpperCase();
+    const selected = trimmed.match(new RegExp(`[?&]selectedIssue=(${KEY.source})`));
+    if (selected)
+        return selected[1].toUpperCase();
+    const issues = trimmed.match(new RegExp(`/issues/(${KEY.source})`));
+    if (issues)
+        return issues[1].toUpperCase();
+    return null;
+}
+/**
+ * Convert an Atlassian Document Format node tree into lightweight Markdown: the
+ * same `#`/`##`/`###` headings, `- ` list items and blank-line block boundaries
+ * the generic excerpt/prompt logic consumes. ADF is a JSON document
+ * (`{ type: 'doc', content: [...] }`); we walk it defensively so a missing or
+ * unexpected node yields '' rather than throwing — Jira fields are sometimes
+ * null or a plain string on older issues.
+ */
+export function adfToMarkdown(node) {
+    if (node == null)
+        return '';
+    // Older issues / some fields come back as a plain string already.
+    if (typeof node === 'string')
+        return node.trim();
+    if (typeof node !== 'object')
+        return '';
+    const out = renderNode(node);
+    return out
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+/** Render a node's children, concatenated. */
+function renderChildren(node) {
+    if (!Array.isArray(node.content))
+        return '';
+    return node.content.map((child) => renderNode(child)).join('');
+}
+/** Render the inline text of a node (no block markers), for headings/list items. */
+function renderInline(node) {
+    if (node.type === 'text')
+        return node.text ?? '';
+    if (node.type === 'hardBreak')
+        return ' ';
+    return Array.isArray(node.content)
+        ? node.content.map((child) => renderInline(child)).join('')
+        : '';
+}
+function renderNode(node) {
+    if (typeof node !== 'object' || node === null)
+        return '';
+    switch (node.type) {
+        case 'text':
+            return node.text ?? '';
+        case 'hardBreak':
+            return '\n';
+        case 'paragraph':
+            return `${renderChildren(node)}\n\n`;
+        case 'heading': {
+            const level = Math.min(Math.max(Number(node.attrs?.level ?? 1) || 1, 1), 3);
+            return `${'#'.repeat(level)} ${renderInline(node).trim()}\n\n`;
+        }
+        case 'bulletList':
+        case 'orderedList':
+            return `${renderChildren(node)}\n`;
+        case 'listItem':
+            return `- ${renderInline(node).trim()}\n`;
+        case 'codeBlock':
+            return `\`\`\`\n${renderInline(node)}\n\`\`\`\n\n`;
+        case 'blockquote':
+            return renderChildren(node);
+        default:
+            // 'doc', 'mediaGroup', panels, tables, unknown marks: recurse into content.
+            return renderChildren(node);
+    }
+}
+//# sourceMappingURL=jira.logic.js.map

package/dist/modules/tasks/jira.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.logic.js","sourceRoot":"","sources":["../../../src/modules/tasks/jira.logic.ts"],"names":[],"mappings":"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"}