chief-clancy 0.6.0 → 0.7.1

package/dist/scripts/board/jira/jira.js

@@ -1,378 +0,0 @@
-/**
- * Clancy Jira board script.
- *
- * Fetches a ticket from Jira Cloud, creates branches, invokes Claude,
- * pushes feature branches, creates PRs, and transitions status.
- *
- * Uses the new POST `/rest/api/3/search/jql` endpoint (old GET `/search`
- * was removed by Atlassian in August 2025).
- */
-import { jiraIssueLinksResponseSchema, jiraSearchResponseSchema, jiraTransitionsResponseSchema, } from '../../../schemas/jira.js';
-import { jiraHeaders, pingEndpoint } from '../../../scripts/shared/http/http.js';
-const SAFE_VALUE_PATTERN = /^[a-zA-Z0-9 _\-'.]+$/;
-const ISSUE_KEY_PATTERN = /^[A-Z][A-Z0-9]+-\d+$/;
-/**
- * Build Jira Basic auth header value.
- *
- * @param user - The Jira username (email).
- * @param token - The Jira API token.
- * @returns The Base64-encoded `user:token` string for Basic auth.
- */
-export function buildAuthHeader(user, token) {
-    return Buffer.from(`${user}:${token}`).toString('base64');
-}
-/**
- * Validate that a user-controlled value is safe for JQL injection.
- *
- * @param value - The value to validate.
- * @returns `true` if the value matches the safe pattern.
- */
-export function isSafeJqlValue(value) {
-    return SAFE_VALUE_PATTERN.test(value);
-}
-/**
- * Ping the Jira API to verify connectivity and credentials.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param projectKey - The Jira project key.
- * @param auth - The Base64-encoded Basic auth string.
- * @returns An object with `ok` and optional `error` message.
- *
- * @example
- * ```ts
- * const result = await pingJira('https://example.atlassian.net', 'PROJ', authHeader);
- * if (!result.ok) console.error(result.error);
- * ```
- */
-export async function pingJira(baseUrl, projectKey, auth) {
-    return pingEndpoint(`${baseUrl}/rest/api/3/project/${projectKey}`, jiraHeaders(auth), {
-        401: '✗ Jira auth failed — check credentials',
-        403: '✗ Jira permission denied for this project',
-        404: `✗ Jira project "${projectKey}" not found`,
-    }, '✗ Could not reach Jira — check network');
-}
-/**
- * Build the JQL query for fetching the next ticket.
- *
- * @param projectKey - The Jira project key.
- * @param status - The JQL status to filter by (default: `"To Do"`).
- * @param sprint - If set, adds an open sprint filter.
- * @param label - If set, adds a label filter.
- * @returns The JQL query string.
- */
-export function buildJql(projectKey, status, sprint, label, excludeHitl) {
-    const parts = [`project="${projectKey}"`];
-    if (sprint)
-        parts.push('sprint in openSprints()');
-    if (label)
-        parts.push(`labels = "${label}"`);
-    if (excludeHitl)
-        parts.push('labels != "clancy:hitl"');
-    parts.push(`assignee=currentUser()`);
-    parts.push(`status="${status}"`);
-    return parts.join(' AND ') + ' ORDER BY priority ASC';
-}
-/**
- * Extract all text strings from a Jira ADF (Atlassian Document Format) description.
- *
- * Recursively walks the ADF tree and collects all string values.
- *
- * @param adf - The ADF description object (or `undefined`).
- * @returns A single string with all text content joined by spaces.
- */
-export function extractAdfText(adf) {
-    if (!adf || typeof adf !== 'object')
-        return '';
-    const strings = [];
-    function walk(node) {
-        if (typeof node === 'string') {
-            strings.push(node);
-            return;
-        }
-        if (Array.isArray(node)) {
-            for (const item of node)
-                walk(item);
-            return;
-        }
-        if (node && typeof node === 'object') {
-            for (const value of Object.values(node)) {
-                walk(value);
-            }
-        }
-    }
-    walk(adf);
-    return strings.join(' ');
-}
-/**
- * Fetch the next available ticket from Jira.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param projectKey - The Jira project key.
- * @param status - The JQL status to filter by.
- * @param sprint - Optional sprint filter.
- * @param label - Optional label filter.
- * @returns The fetched ticket, or `undefined` if no tickets are available.
- */
-export async function fetchTicket(baseUrl, auth, projectKey, status, sprint, label) {
-    const results = await fetchTickets(baseUrl, auth, projectKey, status, sprint, label, false, 1);
-    return results[0];
-}
-/**
- * Fetch multiple candidate tickets from Jira.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param projectKey - The Jira project key.
- * @param status - The JQL status to filter by.
- * @param sprint - Optional sprint filter.
- * @param label - Optional label filter.
- * @param excludeHitl - If `true`, excludes tickets with the `clancy:hitl` label.
- * @param limit - Maximum number of results to return (default: 5).
- * @returns Array of fetched tickets (may be empty).
- */
-export async function fetchTickets(baseUrl, auth, projectKey, status, sprint, label, excludeHitl, limit = 5) {
-    const jql = buildJql(projectKey, status, sprint, label, excludeHitl);
-    let response;
-    try {
-        response = await fetch(`${baseUrl}/rest/api/3/search/jql`, {
-            method: 'POST',
-            headers: {
-                ...jiraHeaders(auth),
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({
-                jql,
-                maxResults: limit,
-                fields: [
-                    'summary',
-                    'description',
-                    'issuelinks',
-                    'parent',
-                    'customfield_10014',
-                ],
-            }),
-        });
-    }
-    catch (err) {
-        console.warn(`⚠ Jira API request failed: ${err instanceof Error ? err.message : String(err)}`);
-        return [];
-    }
-    if (!response.ok) {
-        console.warn(`⚠ Jira API returned HTTP ${response.status}`);
-        return [];
-    }
-    let json;
-    try {
-        json = await response.json();
-    }
-    catch {
-        console.warn('⚠ Jira API returned invalid JSON');
-        return [];
-    }
-    const parsed = jiraSearchResponseSchema.safeParse(json);
-    if (!parsed.success) {
-        console.warn(`⚠ Unexpected Jira response shape: ${parsed.error.message}`);
-        return [];
-    }
-    return parsed.data.issues.map((issue) => {
-        const fields = issue.fields;
-        // Extract blockers
-        const blockers = (fields.issuelinks ?? [])
-            .filter((link) => link.type?.name === 'Blocks' && link.inwardIssue?.key)
-            .map((link) => link.inwardIssue?.key)
-            .filter((key) => Boolean(key));
-        // Extract epic (next-gen parent OR classic customfield)
-        const epicKey = fields.parent?.key ?? fields.customfield_10014 ?? undefined;
-        return {
-            key: issue.key,
-            title: fields.summary,
-            description: extractAdfText(fields.description),
-            provider: 'jira',
-            epicKey,
-            blockers,
-        };
-    });
-}
-/**
- * Check whether a Jira issue is blocked by unresolved blockers.
- *
- * Fetches the issue's links and checks for inward "Blocks" relationships
- * where the blocking issue's statusCategory is not "done".
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param key - The Jira issue key (e.g., `'PROJ-123'`).
- * @returns `true` if any blocker is unresolved, `false` otherwise.
- */
-export async function fetchBlockerStatus(baseUrl, auth, key) {
-    if (!ISSUE_KEY_PATTERN.test(key))
-        return false;
-    try {
-        const response = await fetch(`${baseUrl}/rest/api/3/issue/${key}?fields=issuelinks`, { headers: jiraHeaders(auth) });
-        if (!response.ok)
-            return false;
-        const json = await response.json();
-        const parsed = jiraIssueLinksResponseSchema.safeParse(json);
-        if (!parsed.success)
-            return false;
-        const links = parsed.data.fields?.issuelinks ?? [];
-        // Check for inward "Blocks" links with unresolved status
-        return links.some((link) => {
-            if (link.type?.name !== 'Blocks')
-                return false;
-            if (!link.inwardIssue?.key)
-                return false;
-            const categoryKey = link.inwardIssue.fields?.status?.statusCategory?.key;
-            // If status info is missing, assume not blocked
-            if (!categoryKey)
-                return false;
-            return categoryKey !== 'done';
-        });
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Fetch the children status of a Jira epic (dual-mode).
- *
- * Tries the `Epic: {key}` text convention first (children with "Epic: PROJ-100"
- * in their description). If no results, falls back to the native `parent = {key}`
- * JQL query for backward compatibility with pre-v0.6.0 children.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param parentKey - The parent issue key (e.g., `'PROJ-100'`).
- * @returns The children status, or `undefined` on failure.
- */
-export async function fetchChildrenStatus(baseUrl, auth, parentKey) {
-    if (!ISSUE_KEY_PATTERN.test(parentKey))
-        return undefined;
-    try {
-        // Mode 1: Try Epic: text convention (scoped to project to avoid cross-project matches)
-        const projectPrefix = parentKey.split('-')[0];
-        const epicTextResult = await fetchChildrenByJql(baseUrl, auth, `project = "${projectPrefix}" AND description ~ "Epic: ${parentKey}"`);
-        if (epicTextResult && epicTextResult.total > 0)
-            return epicTextResult;
-        // Mode 2: Fall back to native parent API
-        return await fetchChildrenByJql(baseUrl, auth, `parent = ${parentKey}`);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Fetch children status using a JQL query (total and incomplete counts).
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param jql - The JQL query to find children.
- * @returns The children status, or `undefined` on failure.
- */
-async function fetchChildrenByJql(baseUrl, auth, jql) {
-    // Fetch total count
-    const totalResponse = await fetch(`${baseUrl}/rest/api/3/search/jql`, {
-        method: 'POST',
-        headers: {
-            ...jiraHeaders(auth),
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({ jql, maxResults: 0 }),
-    });
-    if (!totalResponse.ok)
-        return undefined;
-    const totalJson = (await totalResponse.json());
-    const total = totalJson.total ?? 0;
-    if (total === 0)
-        return { total: 0, incomplete: 0 };
-    // Fetch incomplete count
-    const incompleteResponse = await fetch(`${baseUrl}/rest/api/3/search/jql`, {
-        method: 'POST',
-        headers: {
-            ...jiraHeaders(auth),
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({
-            jql: `${jql} AND statusCategory != "done"`,
-            maxResults: 0,
-        }),
-    });
-    if (!incompleteResponse.ok)
-        return undefined;
-    const incompleteJson = (await incompleteResponse.json());
-    const incomplete = incompleteJson.total ?? 0;
-    return { total, incomplete };
-}
-/**
- * Look up a Jira transition ID by status name.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param issueKey - The Jira issue key (e.g., `'PROJ-123'`).
- * @param statusName - The target status name (e.g., `'In Progress'`).
- * @returns The transition ID, or `undefined` if not found.
- */
-export async function lookupTransitionId(baseUrl, auth, issueKey, statusName) {
-    if (!ISSUE_KEY_PATTERN.test(issueKey))
-        return undefined;
-    let response;
-    try {
-        response = await fetch(`${baseUrl}/rest/api/3/issue/${issueKey}/transitions`, { headers: jiraHeaders(auth) });
-    }
-    catch (err) {
-        console.warn(`⚠ Jira transitions request failed: ${err instanceof Error ? err.message : String(err)}`);
-        return undefined;
-    }
-    if (!response.ok)
-        return undefined;
-    let json;
-    try {
-        json = await response.json();
-    }
-    catch {
-        console.warn('⚠ Jira transitions returned invalid JSON');
-        return undefined;
-    }
-    const parsed = jiraTransitionsResponseSchema.safeParse(json);
-    if (!parsed.success) {
-        console.warn(`⚠ Unexpected Jira transitions response: ${parsed.error.message}`);
-        return undefined;
-    }
-    const transition = parsed.data.transitions.find((t) => t.name === statusName);
-    return transition?.id;
-}
-/**
- * Transition a Jira issue to a new status.
- *
- * Fetches available transitions and executes the one matching the target status name.
- * Best-effort — never throws on failure.
- *
- * @param baseUrl - The Jira Cloud base URL.
- * @param auth - The Base64-encoded Basic auth string.
- * @param issueKey - The Jira issue key (e.g., `'PROJ-123'`).
- * @param statusName - The target status name (e.g., `'In Progress'`).
- * @returns `true` if the transition succeeded.
- */
-export async function transitionIssue(baseUrl, auth, issueKey, statusName) {
-    try {
-        const transitionId = await lookupTransitionId(baseUrl, auth, issueKey, statusName);
-        if (!transitionId) {
-            console.warn(`⚠ Jira transition "${statusName}" not found for ${issueKey}`);
-            return false;
-        }
-        const response = await fetch(`${baseUrl}/rest/api/3/issue/${issueKey}/transitions`, {
-            method: 'POST',
-            headers: {
-                ...jiraHeaders(auth),
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ transition: { id: transitionId } }),
-        });
-        return response.ok;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=jira.js.map

package/dist/scripts/board/jira/jira.js.map

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

package/dist/scripts/board/linear/linear.d.ts

@@ -1,129 +0,0 @@
-import type { Ticket } from '../../../types/index.js';
-type LinearEnv = {
-    LINEAR_API_KEY: string;
-    LINEAR_TEAM_ID: string;
-    CLANCY_LABEL?: string;
-    CLANCY_BASE_BRANCH?: string;
-    CLANCY_STATUS_IN_PROGRESS?: string;
-    CLANCY_STATUS_DONE?: string;
-    CLANCY_MODEL?: string;
-    CLANCY_NOTIFY_WEBHOOK?: string;
-};
-/**
- * Validate that a team ID is safe for use in GraphQL variables.
- *
- * @param teamId - The Linear team ID to validate.
- * @returns `true` if the ID matches the safe pattern.
- */
-export declare function isValidTeamId(teamId: string): boolean;
-/**
- * Make a GraphQL request to the Linear API.
- *
- * Personal API keys are passed directly (no "Bearer" prefix).
- *
- * @param apiKey - The Linear personal API key.
- * @param query - The GraphQL query string.
- * @param variables - The GraphQL variables object.
- * @returns The raw JSON response, or `undefined` on failure.
- */
-export declare function linearGraphql(apiKey: string, query: string, variables?: Record<string, unknown>): Promise<unknown>;
-/**
- * Ping the Linear API to verify connectivity and credentials.
- *
- * @param apiKey - The Linear personal API key.
- * @returns An object with `ok` and optional `error` message.
- */
-export declare function pingLinear(apiKey: string): Promise<{
-    ok: boolean;
-    error?: string;
-}>;
-/**
- * Fetch the next available issue from Linear.
- *
- * Filters by `state.type: "unstarted"` (enum, works regardless of team
- * column naming) and optionally by label.
- *
- * @param env - The Linear environment variables.
- * @returns The fetched ticket with optional parent info, or `undefined` if none available.
- */
-export declare function fetchIssue(env: LinearEnv): Promise<(Ticket & {
-    issueId: string;
-    parentIdentifier?: string;
-}) | undefined>;
-/** Linear ticket with issue ID and optional parent info. */
-export type LinearTicket = Ticket & {
-    issueId: string;
-    parentIdentifier?: string;
-};
-/**
- * Fetch multiple candidate issues from Linear.
- *
- * @param env - The Linear environment variables.
- * @param excludeHitl - If `true`, excludes issues with the `clancy:hitl` label.
- * @param limit - Maximum number of results to return (default: 5).
- * @returns Array of fetched tickets (may be empty).
- */
-export declare function fetchIssues(env: LinearEnv, excludeHitl?: boolean, limit?: number): Promise<LinearTicket[]>;
-/**
- * Check whether a Linear issue is blocked by unresolved blockers.
- *
- * Queries the issue's relations for `blockedBy` type relationships and checks
- * if any blocking issues have an unresolved state (not "completed" or "canceled").
- *
- * @param apiKey - The Linear personal API key.
- * @param issueId - The Linear issue UUID.
- * @returns `true` if any blocker is unresolved, `false` otherwise.
- */
-export declare function fetchBlockerStatus(apiKey: string, issueId: string): Promise<boolean>;
-/** Result of checking children status for a parent issue. */
-export type ChildrenStatus = {
-    total: number;
-    incomplete: number;
-};
-/**
- * Fetch the children status of a Linear parent issue (dual-mode).
- *
- * Tries the `Epic: {identifier}` text convention first (searches for issues
- * with "Epic: {parentIdentifier}" in their description). If no results, falls
- * back to the native `children` API for backward compatibility.
- *
- * @param apiKey - The Linear personal API key.
- * @param parentId - The Linear parent issue UUID.
- * @param parentIdentifier - The Linear parent identifier (e.g., `'ENG-42'`).
- *   Required for Epic: text convention search. Falls back to native API only if not provided.
- * @returns The children status, or `undefined` on failure.
- */
-export declare function fetchChildrenStatus(apiKey: string, parentId: string, parentIdentifier?: string): Promise<ChildrenStatus | undefined>;
-/**
- * Look up a Linear workflow state ID by name and team.
- *
- * @param apiKey - The Linear personal API key.
- * @param teamId - The Linear team ID.
- * @param stateName - The workflow state name (e.g., `'In Progress'`).
- * @returns The state ID, or `undefined` if not found.
- */
-export declare function lookupWorkflowStateId(apiKey: string, teamId: string, stateName: string): Promise<string | undefined>;
-/**
- * Execute a state transition on a Linear issue.
- *
- * @param apiKey - The Linear personal API key.
- * @param issueId - The Linear issue internal ID.
- * @param stateId - The target workflow state ID.
- * @returns `true` if the mutation succeeded.
- */
-export declare function executeStateTransition(apiKey: string, issueId: string, stateId: string): Promise<boolean>;
-/**
- * Transition a Linear issue to a new workflow state.
- *
- * Looks up the workflow state ID by name, then executes the `issueUpdate` mutation.
- * Best-effort — never throws on failure.
- *
- * @param apiKey - The Linear personal API key.
- * @param teamId - The Linear team ID.
- * @param issueId - The Linear issue internal ID.
- * @param stateName - The target workflow state name (e.g., `'In Progress'`).
- * @returns `true` if the transition succeeded.
- */
-export declare function transitionIssue(apiKey: string, teamId: string, issueId: string, stateName: string): Promise<boolean>;
-export {};
-//# sourceMappingURL=linear.d.ts.map

package/dist/scripts/board/linear/linear.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../../src/scripts/board/linear/linear.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAK/C,KAAK,SAAS,GAAG;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsC1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CACrD,CAAC,MAAM,GAAG;IACR,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC,GACF,SAAS,CACZ,CAGA;AAED,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,CAAC,EAAE,OAAO,EACrB,KAAK,SAAI,GACR,OAAO,CAAC,YAAY,EAAE,CAAC,CA8EzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAiBrC;AAuFD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB7B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAelB"}