@cat-factory/integrations 0.6.0

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

@@ -0,0 +1,12 @@
+import type { TaskSourceKind } from '@cat-factory/kernel';
+import type { TaskSourceProvider, TaskSourceRegistry, TaskContent } from '@cat-factory/kernel';
+import type { TaskRecord } from '@cat-factory/kernel';
+import { MapSourceRegistry } from '@cat-factory/kernel';
+export type { TaskContextView } from '@cat-factory/kernel';
+export { renderTaskContext } from '@cat-factory/kernel';
+/** A trivial in-memory provider registry built from the wired providers. */
+export declare class MapTaskSourceRegistry extends MapSourceRegistry<TaskSourceKind, TaskSourceProvider> implements TaskSourceRegistry {
+}
+/** A short plain-text excerpt of an issue: its summary + the start of its description. */
+export declare function buildTaskExcerpt(content: TaskContent | TaskRecord, max?: number): string;
+//# sourceMappingURL=tasks.logic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAgC,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAErF,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAQvD,4EAA4E;AAC5E,qBAAa,qBACX,SAAQ,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAC5D,YAAW,kBAAkB;CAAG;AAElC,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,SAAM,GAAG,MAAM,CAIrF"}

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

@@ -0,0 +1,17 @@
+import { markdownToText, buildExcerpt, MapSourceRegistry } from '@cat-factory/kernel';
+export { renderTaskContext } from '@cat-factory/kernel';
+// Source-agnostic helpers shared by every task source: a trivial provider
+// registry, deriving a plain-text excerpt from an issue, and rendering an issue
+// into the compact Markdown section fed to agents as context. Providers normalize
+// their description/comment bodies to lightweight Markdown so these stay
+// independent of any one source's format. Kept pure for easy testing.
+/** A trivial in-memory provider registry built from the wired providers. */
+export class MapTaskSourceRegistry extends MapSourceRegistry {
+}
+/** A short plain-text excerpt of an issue: its summary + the start of its description. */
+export function buildTaskExcerpt(content, max = 280) {
+    const description = markdownToText(content.description);
+    const lead = description ? `${content.title} — ${description}` : content.title;
+    return buildExcerpt(lead, max);
+}
+//# sourceMappingURL=tasks.logic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.logic.js","sourceRoot":"","sources":["../../../src/modules/tasks/tasks.logic.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,0EAA0E;AAC1E,gFAAgF;AAChF,kFAAkF;AAClF,yEAAyE;AACzE,sEAAsE;AAEtE,4EAA4E;AAC5E,MAAM,OAAO,qBACX,SAAQ,iBAAqD;CAC7B;AAElC,0FAA0F;AAC1F,MAAM,UAAU,gBAAgB,CAAC,OAAiC,EAAE,GAAG,GAAG,GAAG;IAC3E,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IACvD,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAA;IAC9E,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAChC,CAAC"}

package/dist/modules/tracker/TicketTrackerService.d.ts

@@ -0,0 +1,45 @@
+import type { CreateTicketRequest, CreatedTicket, TicketTrackerProvider, TrackerSettingsRepository } from '@cat-factory/kernel';
+/** Jira Cloud credentials (HTTP Basic: account email + API token against a site). */
+export interface JiraConnection {
+    baseUrl: string;
+    accountEmail: string;
+    apiToken: string;
+}
+export interface TicketTrackerServiceDependencies {
+    trackerSettingsRepository: TrackerSettingsRepository;
+    /**
+     * Files a GitHub issue for the request's service frame and returns the created
+     * ticket, or null when GitHub isn't configured for the workspace. The facade
+     * resolves the repo + auth (App installation token on Cloudflare, a token + env
+     * repo on Node). Absent → the GitHub tracker passes through.
+     */
+    fileGitHubIssue?: (request: CreateTicketRequest) => Promise<CreatedTicket | null>;
+    /**
+     * Resolves the workspace's Jira credentials, or null when Jira isn't configured.
+     * Absent → the Jira tracker passes through.
+     */
+    resolveJiraConnection?: (workspaceId: string) => Promise<JiraConnection | null>;
+    /**
+     * HTTP transport for the Jira create call. Injected by each runtime (both expose
+     * a global `fetch`) so this package needs no DOM lib; absent → Jira passes through.
+     */
+    fetchImpl?: FetchLike;
+}
+/** The minimal slice of the Fetch API the Jira create call needs (no DOM lib). */
+export type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export declare class TicketTrackerService implements TicketTrackerProvider {
+    private readonly deps;
+    constructor(deps: TicketTrackerServiceDependencies);
+    createTicket(request: CreateTicketRequest): Promise<CreatedTicket | null>;
+    private createJiraIssue;
+}
+//# sourceMappingURL=TicketTrackerService.d.ts.map

package/dist/modules/tracker/TicketTrackerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TicketTrackerService.d.ts","sourceRoot":"","sources":["../../../src/modules/tracker/TicketTrackerService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAA;AAc5B,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gCAAgC;IAC/C,yBAAyB,EAAE,yBAAyB,CAAA;IACpD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IACjF;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC/E;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACpE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAA;AAIhG,qBAAa,oBAAqB,YAAW,qBAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,gCAAgC,EAAI;IAEjE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAM9E;YAEa,eAAe;CAkC9B"}

package/dist/modules/tracker/TicketTrackerService.js

@@ -0,0 +1,52 @@
+import { buildJiraIssuePayload } from './jira.create.logic.js';
+import { toBase64 } from './base64.js';
+const USER_AGENT = 'cat-factory';
+export class TicketTrackerService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async createTicket(request) {
+        const settings = await this.deps.trackerSettingsRepository.get(request.workspaceId);
+        if (!settings?.tracker)
+            return null;
+        if (settings.tracker === 'github')
+            return (await this.deps.fileGitHubIssue?.(request)) ?? null;
+        if (settings.tracker === 'jira')
+            return this.createJiraIssue(request, settings.jiraProjectKey);
+        return null;
+    }
+    async createJiraIssue(request, projectKey) {
+        const { resolveJiraConnection, fetchImpl } = this.deps;
+        if (!resolveJiraConnection || !fetchImpl || !projectKey)
+            return null;
+        const connection = await resolveJiraConnection(request.workspaceId);
+        if (!connection)
+            return null;
+        const { baseUrl, accountEmail, apiToken } = connection;
+        if (!baseUrl || !accountEmail || !apiToken)
+            return null;
+        const base = baseUrl.replace(/\/+$/, '');
+        const url = `${base}/rest/api/3/issue`;
+        const auth = toBase64(`${accountEmail}:${apiToken}`);
+        const res = await fetchImpl(url, {
+            method: 'POST',
+            headers: {
+                authorization: `Basic ${auth}`,
+                accept: 'application/json',
+                'content-type': 'application/json',
+                'user-agent': USER_AGENT,
+            },
+            body: JSON.stringify(buildJiraIssuePayload({ projectKey, title: request.title, body: request.body })),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`Jira POST ${url} → ${res.status}: ${text.slice(0, 300)}`);
+        }
+        const json = (await res.json().catch(() => null));
+        if (!json?.key)
+            throw new Error('Jira returned no issue key for the created issue');
+        return { externalId: json.key, url: `${base}/browse/${json.key}` };
+    }
+}
+//# sourceMappingURL=TicketTrackerService.js.map

package/dist/modules/tracker/TicketTrackerService.js.map

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

package/dist/modules/tracker/base64.d.ts

@@ -0,0 +1,2 @@
+export declare function toBase64(input: string): string;
+//# sourceMappingURL=base64.d.ts.map

package/dist/modules/tracker/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../src/modules/tracker/base64.ts"],"names":[],"mappings":"AAMA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY9C"}

package/dist/modules/tracker/base64.js

@@ -0,0 +1,18 @@
+// Pure base64 encoder for ASCII credentials (HTTP Basic auth). Avoids depending on
+// `btoa` (DOM lib) or `Buffer` (Node lib) so this package stays runtime-neutral.
+// Jira account emails + API tokens are ASCII, so a byte-per-char encode is correct.
+const ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+export function toBase64(input) {
+    let out = '';
+    for (let i = 0; i < input.length; i += 3) {
+        const b0 = input.charCodeAt(i) & 0xff;
+        const b1 = i + 1 < input.length ? input.charCodeAt(i + 1) & 0xff : 0;
+        const b2 = i + 2 < input.length ? input.charCodeAt(i + 2) & 0xff : 0;
+        out += ALPHABET[b0 >> 2];
+        out += ALPHABET[((b0 & 0x03) << 4) | (b1 >> 4)];
+        out += i + 1 < input.length ? ALPHABET[((b1 & 0x0f) << 2) | (b2 >> 6)] : '=';
+        out += i + 2 < input.length ? ALPHABET[b2 & 0x3f] : '=';
+    }
+    return out;
+}
+//# sourceMappingURL=base64.js.map

package/dist/modules/tracker/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../../src/modules/tracker/base64.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,iFAAiF;AACjF,oFAAoF;AAEpF,MAAM,QAAQ,GAAG,kEAAkE,CAAA;AAEnF,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;QACrC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACpE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACpE,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;QACxB,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/C,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAC5E,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IACzD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/modules/tracker/github.create.logic.d.ts

@@ -0,0 +1,16 @@
+import type { FetchLike } from './TicketTrackerService.js';
+export interface GitHubIssueTokenRequest {
+    fetchImpl: FetchLike;
+    token: string;
+    owner: string;
+    repo: string;
+    title: string;
+    body: string;
+    apiBase?: string;
+}
+/** File an issue and return its number + canonical web URL. */
+export declare function createGitHubIssueViaToken(req: GitHubIssueTokenRequest): Promise<{
+    number: number;
+    url: string;
+}>;
+//# sourceMappingURL=github.create.logic.d.ts.map

package/dist/modules/tracker/github.create.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.create.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tracker/github.create.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAU1D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,+DAA+D;AAC/D,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB1C"}

package/dist/modules/tracker/github.create.logic.js

@@ -0,0 +1,25 @@
+/** File an issue and return its number + canonical web URL. */
+export async function createGitHubIssueViaToken(req) {
+    const base = (req.apiBase ?? 'https://api.github.com').replace(/\/+$/, '');
+    const url = `${base}/repos/${req.owner}/${req.repo}/issues`;
+    const res = await req.fetchImpl(url, {
+        method: 'POST',
+        headers: {
+            authorization: `Bearer ${req.token}`,
+            accept: 'application/vnd.github+json',
+            'content-type': 'application/json',
+            'user-agent': 'cat-factory',
+            'x-github-api-version': '2022-11-28',
+        },
+        body: JSON.stringify({ title: req.title, body: req.body }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`GitHub POST ${url} → ${res.status}: ${text.slice(0, 300)}`);
+    }
+    const json = (await res.json().catch(() => null));
+    if (!json?.number)
+        throw new Error('GitHub returned no issue number for the created issue');
+    return { number: json.number, url: json.html_url ?? '' };
+}
+//# sourceMappingURL=github.create.logic.js.map

package/dist/modules/tracker/github.create.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.create.logic.js","sourceRoot":"","sources":["../../../src/modules/tracker/github.create.logic.ts"],"names":[],"mappings":"AAoBA,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,GAA4B;IAE5B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC1E,MAAM,GAAG,GAAG,GAAG,IAAI,UAAU,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,SAAS,CAAA;IAC3D,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACnC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE;YACpC,MAAM,EAAE,6BAA6B;YACrC,cAAc,EAAE,kBAAkB;YAClC,YAAY,EAAE,aAAa;YAC3B,sBAAsB,EAAE,YAAY;SACrC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;KAC3D,CAAC,CAAA;IACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAC7C,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,MAAM,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;IAC9E,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAGxC,CAAA;IACR,IAAI,CAAC,IAAI,EAAE,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAC3F,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAA;AAC1D,CAAC"}

package/dist/modules/tracker/jira.create.logic.d.ts

@@ -0,0 +1,31 @@
+interface AdfText {
+    type: 'text';
+    text: string;
+}
+interface AdfNode {
+    type: string;
+    content?: (AdfNode | AdfText)[];
+    attrs?: Record<string, unknown>;
+}
+export interface AdfDoc {
+    type: 'doc';
+    version: 1;
+    content: AdfNode[];
+}
+/**
+ * Convert lightweight Markdown into ADF. Deliberately minimal — paragraphs split
+ * on blank lines, `#`/`##`/`###` headings, and `- ` bullet lists — which covers
+ * the analysis reports the tech-debt pipeline produces. Anything else is carried
+ * through as paragraph text so no content is lost. An empty body yields a single
+ * empty paragraph (ADF requires non-empty `content`).
+ */
+export declare function markdownToAdf(markdown: string): AdfDoc;
+/** Build the POST /rest/api/3/issue request body for a new issue. */
+export declare function buildJiraIssuePayload(input: {
+    projectKey: string;
+    title: string;
+    body: string;
+    issueType?: string;
+}): Record<string, unknown>;
+export {};
+//# sourceMappingURL=jira.create.logic.d.ts.map

package/dist/modules/tracker/jira.create.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.create.logic.d.ts","sourceRoot":"","sources":["../../../src/modules/tracker/jira.create.logic.ts"],"names":[],"mappings":"AAKA,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AACD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AACD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,OAAO,EAAE,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCtD;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS1B"}

package/dist/modules/tracker/jira.create.logic.js

@@ -0,0 +1,59 @@
+// Pure helpers for filing a Jira issue: converting a Markdown body into the
+// minimal Atlassian Document Format (ADF) Jira's create API expects, and building
+// the request payload. Kept out of the worker so it is unit-testable without a
+// live site (the inverse of `jira.logic.ts`'s `adfToMarkdown`).
+/**
+ * Convert lightweight Markdown into ADF. Deliberately minimal — paragraphs split
+ * on blank lines, `#`/`##`/`###` headings, and `- ` bullet lists — which covers
+ * the analysis reports the tech-debt pipeline produces. Anything else is carried
+ * through as paragraph text so no content is lost. An empty body yields a single
+ * empty paragraph (ADF requires non-empty `content`).
+ */
+export function markdownToAdf(markdown) {
+    const blocks = markdown.replace(/\r\n/g, '\n').split(/\n{2,}/);
+    const content = [];
+    for (const raw of blocks) {
+        const block = raw.trim();
+        if (!block)
+            continue;
+        const heading = block.match(/^(#{1,3})\s+(.*)$/);
+        if (heading) {
+            content.push({
+                type: 'heading',
+                attrs: { level: heading[1].length },
+                content: [{ type: 'text', text: heading[2].trim() }],
+            });
+            continue;
+        }
+        const lines = block.split('\n');
+        const isList = lines.every((l) => /^\s*[-*]\s+/.test(l));
+        if (isList) {
+            content.push({
+                type: 'bulletList',
+                content: lines.map((l) => ({
+                    type: 'listItem',
+                    content: [
+                        { type: 'paragraph', content: [{ type: 'text', text: l.replace(/^\s*[-*]\s+/, '') }] },
+                    ],
+                })),
+            });
+            continue;
+        }
+        content.push({ type: 'paragraph', content: [{ type: 'text', text: lines.join(' ') }] });
+    }
+    if (content.length === 0)
+        content.push({ type: 'paragraph', content: [] });
+    return { type: 'doc', version: 1, content };
+}
+/** Build the POST /rest/api/3/issue request body for a new issue. */
+export function buildJiraIssuePayload(input) {
+    return {
+        fields: {
+            project: { key: input.projectKey },
+            summary: input.title.slice(0, 250),
+            description: markdownToAdf(input.body),
+            issuetype: { name: input.issueType ?? 'Task' },
+        },
+    };
+}
+//# sourceMappingURL=jira.create.logic.js.map

package/dist/modules/tracker/jira.create.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.create.logic.js","sourceRoot":"","sources":["../../../src/modules/tracker/jira.create.logic.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAC/E,gEAAgE;AAiBhE;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC9D,MAAM,OAAO,GAAc,EAAE,CAAA;IAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;QACxB,IAAI,CAAC,KAAK;YAAE,SAAQ;QACpB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QAChD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE;gBACpC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,CAAC;aACtD,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACxD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;qBACvF;iBACF,CAAC,CAAC;aACJ,CAAC,CAAA;YACF,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACzF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1E,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;AAC7C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,KAKrC;IACC,OAAO;QACL,MAAM,EAAE;YACN,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE;YAClC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAClC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;YACtC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM,EAAE;SAC/C;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@cat-factory/integrations",
+  "version": "0.6.0",
+  "description": "External-system integration domain logic for the Agent Architecture Board (GitHub, documents, tasks, environments, runners).",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ai": "^6.0.208",
+    "@cat-factory/contracts": "0.6.0",
+    "@cat-factory/kernel": "0.6.0"
+  },
+  "devDependencies": {
+    "typescript": "7.0.1-rc",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:run": "vitest run"
+  }
+}