@on-par/factory-core 0.9.28-next.2 → 0.9.28-next.21

package/dist/work/linear-client.js

@@ -0,0 +1,69 @@
+// packages/core/src/work/linear-client.ts — read-only Linear GraphQL client (#3889).
+import { z } from 'zod';
+const LINEAR_GRAPHQL_ENDPOINT = 'https://api.linear.app/graphql';
+const ISSUE_QUERY = `query FactoryIssue($id: String!) {
+  issue(id: $id) {
+    id identifier title description url
+    state { type }
+    labels { nodes { name } }
+  }
+}`;
+const IssueSchema = z.object({
+    id: z.string().min(1),
+    identifier: z.string().min(1),
+    title: z.string(),
+    description: z.string().nullable().optional(),
+    url: z.url(),
+    state: z.object({ type: z.string() }),
+    labels: z.object({ nodes: z.array(z.object({ name: z.string() })) }),
+});
+const ResponseSchema = z.object({
+    data: z.object({ issue: IssueSchema.nullable() }).nullable().optional(),
+    errors: z.array(z.object({ message: z.string() })).optional(),
+});
+export class LinearApiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LinearApiError';
+    }
+}
+export function createLinearClient(opts) {
+    const fetchImpl = opts.fetch ?? globalThis.fetch;
+    return {
+        async fetchIssue(ref) {
+            const res = await fetchImpl(opts.endpoint ?? LINEAR_GRAPHQL_ENDPOINT, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: opts.apiKey },
+                body: JSON.stringify({ query: ISSUE_QUERY, variables: { id: ref } }),
+                signal: AbortSignal.timeout(opts.timeoutMs ?? 30_000),
+            });
+            if (!res.ok) {
+                throw new LinearApiError(`Linear API returned HTTP ${res.status} for ${ref}`);
+            }
+            const parsed = ResponseSchema.safeParse(await res.json());
+            if (!parsed.success) {
+                const first = parsed.error.issues[0];
+                const where = first ? `${first.path.join('.')}: ${first.message}` : 'unknown';
+                throw new LinearApiError(`malformed Linear response for ${ref}: ${where}`);
+            }
+            const { data, errors } = parsed.data;
+            if (errors && errors.length > 0) {
+                throw new LinearApiError(`Linear API error for ${ref}: ${errors.map((e) => e.message).join('; ')}`);
+            }
+            const issue = data?.issue;
+            if (issue == null) {
+                throw new LinearApiError(`Linear issue ${ref} not found`);
+            }
+            return {
+                id: issue.id,
+                identifier: issue.identifier,
+                title: issue.title,
+                description: issue.description ?? '',
+                url: issue.url,
+                stateType: issue.state.type,
+                labels: issue.labels.nodes.map((l) => l.name),
+            };
+        },
+    };
+}
+//# sourceMappingURL=linear-client.js.map

package/dist/work/linear-client.js.map

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

package/dist/work/linear-issue.d.ts

@@ -0,0 +1,11 @@
+import { type WorkSourceAdapter } from './index.js';
+export declare const LINEAR_ISSUE_SOURCE = "linear-issue";
+export interface LinearIssueSourceDeps {
+    fetch?: typeof globalThis.fetch;
+    env?: Readonly<Record<string, string | undefined>>;
+    endpoint?: string;
+}
+/** Turns "ON-12" or a linear.app issue URL into the upper-cased issue key. */
+export declare function parseLinearIssueRef(input: string): string;
+export declare function createLinearIssueAdapter(deps?: LinearIssueSourceDeps): WorkSourceAdapter;
+//# sourceMappingURL=linear-issue.d.ts.map

package/dist/work/linear-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-issue.d.ts","sourceRoot":"","sources":["../../src/work/linear-issue.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkD,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpG,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAOlD,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAazD;AAUD,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,qBAA0B,GAAG,iBAAiB,CA2B5F"}

package/dist/work/linear-issue.js

@@ -0,0 +1,69 @@
+// packages/core/src/work/linear-issue.ts — read-only Linear issue input-source adapter (#3889).
+import { extractAcceptanceCriteria } from './acceptance.js';
+import { InvalidWorkRequestInputError } from './index.js';
+import { createLinearClient } from './linear-client.js';
+import { toWorkKey } from './work-key.js';
+export const LINEAR_ISSUE_SOURCE = 'linear-issue';
+const EXPECTED_FORM = 'expected a Linear issue key like "ON-12" or a URL like https://linear.app/<workspace>/issue/ON-12';
+const KEY_RE = /^[A-Za-z][A-Za-z0-9]*-[1-9]\d*$/;
+const CLOSED_STATE_TYPES = new Set(['completed', 'canceled']);
+function usageError(input) {
+    const shown = input.length > 200 ? `${input.slice(0, 200)}…` : input;
+    return new InvalidWorkRequestInputError(LINEAR_ISSUE_SOURCE, `${EXPECTED_FORM}, got "${shown}"`);
+}
+/** Turns "ON-12" or a linear.app issue URL into the upper-cased issue key. */
+export function parseLinearIssueRef(input) {
+    const trimmed = input.trim();
+    if (KEY_RE.test(trimmed))
+        return trimmed.toUpperCase();
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch {
+        throw usageError(trimmed);
+    }
+    if (url.protocol !== 'https:' || url.hostname !== 'linear.app')
+        throw usageError(trimmed);
+    const [workspace, segment, key] = url.pathname.split('/').filter((s) => s !== '');
+    if (!workspace || segment !== 'issue' || key === undefined || !KEY_RE.test(key))
+        throw usageError(trimmed);
+    return key.toUpperCase();
+}
+function rawRef(params) {
+    if (typeof params === 'string')
+        return params;
+    if (typeof params === 'object' && params !== null && 'ref' in params && typeof params.ref === 'string') {
+        return params.ref;
+    }
+    return undefined;
+}
+export function createLinearIssueAdapter(deps = {}) {
+    return {
+        kind: LINEAR_ISSUE_SOURCE,
+        async resolve(params) {
+            const raw = rawRef(params);
+            if (raw === undefined) {
+                throw new InvalidWorkRequestInputError(LINEAR_ISSUE_SOURCE, EXPECTED_FORM);
+            }
+            const ref = parseLinearIssueRef(raw);
+            const apiKey = (deps.env ?? process.env).LINEAR_API_KEY?.trim();
+            if (!apiKey) {
+                throw new Error('LINEAR_API_KEY is not set — export a Linear personal API key to resolve Linear issues');
+            }
+            const issue = await createLinearClient({ apiKey, fetch: deps.fetch, endpoint: deps.endpoint }).fetchIssue(ref);
+            return {
+                id: `${LINEAR_ISSUE_SOURCE}:${issue.identifier}`,
+                kind: LINEAR_ISSUE_SOURCE,
+                key: toWorkKey(issue.identifier),
+                title: issue.title,
+                brief: issue.description,
+                acceptanceCriteria: extractAcceptanceCriteria(issue.description),
+                state: CLOSED_STATE_TYPES.has(issue.stateType) ? 'closed' : 'open',
+                labels: issue.labels,
+                reference: { externalId: issue.id, url: issue.url },
+            };
+        },
+    };
+}
+//# sourceMappingURL=linear-issue.js.map

package/dist/work/linear-issue.js.map

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

package/dist/work/linear-preflight.d.ts

@@ -0,0 +1,21 @@
+import type { LinearTrackerConfig } from '../config/tracker-section.js';
+export declare const LINEAR_API_KEY_ENV = "LINEAR_API_KEY";
+export declare const LINEAR_GRAPHQL_URL = "https://api.linear.app/graphql";
+export type LinearPreflightResult = {
+    kind: 'unauthorized';
+} | {
+    kind: 'team-missing';
+    teamKey: string;
+} | {
+    kind: 'error';
+    message: string;
+} | {
+    kind: 'ok';
+    readyIssues: number;
+    unmappedProjects: string[];
+};
+export declare function probeLinearSetup(input: {
+    apiKey: string;
+    linear: LinearTrackerConfig;
+}, fetchFn?: typeof fetch): Promise<LinearPreflightResult>;
+//# sourceMappingURL=linear-preflight.d.ts.map

package/dist/work/linear-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-preflight.d.ts","sourceRoot":"","sources":["../../src/work/linear-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,kBAAkB,mCAAmC,CAAC;AAEnE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA2BpE,wBAAsB,gBAAgB,CACpC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,EACtD,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CA+ChC"}

package/dist/work/linear-preflight.js

@@ -0,0 +1,67 @@
+export const LINEAR_API_KEY_ENV = 'LINEAR_API_KEY';
+export const LINEAR_GRAPHQL_URL = 'https://api.linear.app/graphql';
+const MAX_PAGES = 10;
+const QUERY = `query($team: String!, $label: String!, $state: String!, $after: String) {
+  teams(filter: { key: { eq: $team } }) { nodes { id } }
+  issues(first: 100, after: $after, filter: { team: { key: { eq: $team } }, state: { name: { eq: $state } }, labels: { some: { name: { eq: $label } } } }) {
+    nodes { project { id name } }
+    pageInfo { hasNextPage endCursor }
+  }
+}`;
+export async function probeLinearSetup(input, fetchFn = fetch) {
+    const { apiKey, linear } = input;
+    const redact = (text) => text.split(apiKey).join('***');
+    const fail = (message) => ({ kind: 'error', message: redact(message) });
+    const projects = new Set();
+    let readyIssues = 0;
+    let after = null;
+    for (let page = 0; page < MAX_PAGES; page++) {
+        let res;
+        try {
+            res = await fetchFn(LINEAR_GRAPHQL_URL, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: apiKey },
+                body: JSON.stringify({
+                    query: QUERY,
+                    variables: { team: linear.teamKey, label: linear.readyLabel, state: linear.states.ready, after },
+                }),
+                signal: AbortSignal.timeout(15_000),
+            });
+        }
+        catch (err) {
+            return fail(err instanceof Error ? err.message : String(err));
+        }
+        let body;
+        try {
+            body = (await res.json());
+        }
+        catch {
+            body = undefined;
+        }
+        const errors = body?.errors ?? [];
+        if (res.status === 401 || res.status === 403 || errors.some((e) => e.extensions?.code === 'AUTHENTICATION_ERROR')) {
+            return { kind: 'unauthorized' };
+        }
+        if (!res.ok)
+            return fail(`HTTP ${res.status}`);
+        if (body === undefined)
+            return fail('Linear returned a non-JSON response');
+        if (errors.length > 0)
+            return fail(errors[0]?.message ?? 'Linear returned a GraphQL error');
+        if ((body.data?.teams?.nodes ?? []).length === 0)
+            return { kind: 'team-missing', teamKey: linear.teamKey };
+        const issues = body.data?.issues;
+        for (const node of issues?.nodes ?? []) {
+            readyIssues++;
+            const project = node.project;
+            if (project && !(project.name in linear.projects) && !(project.id in linear.projects))
+                projects.add(project.name);
+        }
+        const info = issues?.pageInfo;
+        if (!info?.hasNextPage || !info.endCursor)
+            break;
+        after = info.endCursor;
+    }
+    return { kind: 'ok', readyIssues, unmappedProjects: [...projects].sort() };
+}
+//# sourceMappingURL=linear-preflight.js.map

package/dist/work/linear-preflight.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@on-par/factory-core",
-  "version": "0.9.28-next.2",
+  "version": "0.9.28-next.21",
   "description": "Core engine: model router, constitutions, checkers, and pipeline phases for the Software Factory.",
   "type": "module",
   "main": "dist/index.js",
@@ -54,10 +54,10 @@
     "prepack": "node ../../scripts/pack-hygiene-cli.ts prepack"
   },
   "dependencies": {
-    "@on-par/adr-kit": "0.9.28-next.2",
-    "@on-par/contracts": "0.9.28-next.2",
-    "@on-par/factory-config": "0.9.28-next.2",
-    "@on-par/repo-context": "0.9.28-next.2",
+    "@on-par/adr-kit": "0.9.28-next.21",
+    "@on-par/contracts": "0.9.28-next.21",
+    "@on-par/factory-config": "0.9.28-next.21",
+    "@on-par/repo-context": "0.9.28-next.21",
     "@octokit/rest": "^22.0.0",
     "execa": "^10.2.1",
     "gray-matter": "^4.0.3",