chief-clancy 0.2.0 → 0.3.1

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

@@ -0,0 +1,85 @@
+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>;
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../../src/scripts/board/linear/linear.ts"],"names":[],"mappings":"AAeA,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,CAO1C;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,CA0DA;AAED;;;;;;;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"}

package/dist/scripts/board/linear/linear.js

@@ -0,0 +1,209 @@
+/**
+ * Clancy Linear board script.
+ *
+ * Fetches an issue from Linear's GraphQL API, creates branches,
+ * invokes Claude, squash merges, transitions status, and sends notifications.
+ *
+ * Important: Linear personal API keys do NOT use "Bearer" prefix.
+ * Only OAuth tokens use "Bearer". This is intentional per Linear docs.
+ */
+import { linearIssueUpdateResponseSchema, linearIssuesResponseSchema, linearViewerResponseSchema, linearWorkflowStatesResponseSchema, } from '../../../schemas/linear.js';
+const SAFE_ID_PATTERN = /^[a-zA-Z0-9_-]+$/;
+const LINEAR_API_URL = 'https://api.linear.app/graphql';
+/**
+ * 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 function isValidTeamId(teamId) {
+    return SAFE_ID_PATTERN.test(teamId);
+}
+/**
+ * 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 async function linearGraphql(apiKey, query, variables) {
+    let response;
+    try {
+        response = await fetch(LINEAR_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+    }
+    catch (err) {
+        console.warn(`⚠ Linear API request failed: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    }
+    if (!response.ok) {
+        console.warn(`⚠ Linear API returned HTTP ${response.status}`);
+        return undefined;
+    }
+    try {
+        return await response.json();
+    }
+    catch {
+        console.warn('⚠ Linear API returned invalid JSON');
+        return undefined;
+    }
+}
+/**
+ * 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 async function pingLinear(apiKey) {
+    const raw = await linearGraphql(apiKey, '{ viewer { id } }');
+    const parsed = linearViewerResponseSchema.safeParse(raw);
+    if (parsed.success && parsed.data.data?.viewer?.id)
+        return { ok: true };
+    return { ok: false, error: '✗ Linear auth failed — check LINEAR_API_KEY' };
+}
+/**
+ * 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 async function fetchIssue(env) {
+    const label = env.CLANCY_LABEL?.trim();
+    const hasLabel = Boolean(label);
+    const labelFilter = hasLabel ? 'labels: { name: { eq: $label } }' : '';
+    const query = `
+    query($teamId: String!${hasLabel ? ', $label: String!' : ''}) {
+      viewer {
+        assignedIssues(
+          filter: {
+            state: { type: { eq: "unstarted" } }
+            team: { id: { eq: $teamId } }
+            ${labelFilter}
+          }
+          first: 1
+          orderBy: priority
+        ) {
+          nodes {
+            id
+            identifier
+            title
+            description
+            parent { identifier title }
+          }
+        }
+      }
+    }
+  `;
+    const variables = {
+        teamId: env.LINEAR_TEAM_ID,
+    };
+    if (hasLabel)
+        variables.label = label;
+    const raw = await linearGraphql(env.LINEAR_API_KEY, query, variables);
+    const parsed = linearIssuesResponseSchema.safeParse(raw);
+    if (!parsed.success) {
+        console.warn(`⚠ Unexpected Linear response shape: ${parsed.error.message}`);
+        return undefined;
+    }
+    const nodes = parsed.data.data?.viewer?.assignedIssues?.nodes;
+    if (!nodes?.length)
+        return undefined;
+    const issue = nodes[0];
+    return {
+        key: issue.identifier,
+        title: issue.title,
+        description: issue.description ?? '',
+        provider: 'linear',
+        issueId: issue.id,
+        parentIdentifier: issue.parent?.identifier,
+    };
+}
+/**
+ * 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 async function lookupWorkflowStateId(apiKey, teamId, stateName) {
+    const query = `
+    query($teamId: String!, $name: String!) {
+      workflowStates(filter: {
+        team: { id: { eq: $teamId } }
+        name: { eq: $name }
+      }) {
+        nodes { id }
+      }
+    }
+  `;
+    const raw = await linearGraphql(apiKey, query, { teamId, name: stateName });
+    const parsed = linearWorkflowStatesResponseSchema.safeParse(raw);
+    if (!parsed.success) {
+        console.warn(`⚠ Unexpected Linear workflowStates response: ${parsed.error.message}`);
+        return undefined;
+    }
+    return parsed.data.data?.workflowStates?.nodes?.[0]?.id;
+}
+/**
+ * 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 async function executeStateTransition(apiKey, issueId, stateId) {
+    const mutation = `
+    mutation($issueId: String!, $stateId: String!) {
+      issueUpdate(id: $issueId, input: { stateId: $stateId }) {
+        success
+      }
+    }
+  `;
+    const raw = await linearGraphql(apiKey, mutation, { issueId, stateId });
+    const parsed = linearIssueUpdateResponseSchema.safeParse(raw);
+    if (!parsed.success) {
+        console.warn(`⚠ Unexpected Linear issueUpdate response: ${parsed.error.message}`);
+        return false;
+    }
+    return parsed.data.data?.issueUpdate?.success === true;
+}
+/**
+ * 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 async function transitionIssue(apiKey, teamId, issueId, stateName) {
+    try {
+        const stateId = await lookupWorkflowStateId(apiKey, teamId, stateName);
+        if (!stateId) {
+            console.warn(`⚠ Linear workflow state "${stateName}" not found — check team configuration`);
+            return false;
+        }
+        return await executeStateTransition(apiKey, issueId, stateId);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=linear.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../../../src/scripts/board/linear/linear.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,qBAAqB,CAAC;AAG7B,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAC3C,MAAM,cAAc,GAAG,gCAAgC,CAAC;AAaxD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAc,EACd,KAAa,EACb,SAAmC;IAEnC,IAAI,QAAkB,CAAC;IAEvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,MAAM;gBACrB,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACnF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEzD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IAExE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;AAC7E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAc;IAO7C,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,KAAK,GAAG;4BACY,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;;;;;;cAMjD,WAAW;;;;;;;;;;;;;;;GAetB,CAAC;IAEF,MAAM,SAAS,GAA4B;QACzC,MAAM,EAAE,GAAG,CAAC,cAAc;KAC3B,CAAC;IAEF,IAAI,QAAQ;QAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC;IAEtC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,uCAAuC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5E,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC;IAE9D,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEvB,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,UAAU;QACrB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;QACpC,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,MAAc,EACd,SAAiB;IAEjB,MAAM,KAAK,GAAG;;;;;;;;;GASb,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,kCAAkC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CACV,gDAAgD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACvE,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,OAAe,EACf,OAAe;IAEf,MAAM,QAAQ,GAAG;;;;;;GAMhB,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAE9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CACV,6CAA6C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACpE,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;AACzD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,MAAc,EACd,OAAe,EACf,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,4BAA4B,SAAS,wCAAwC,CAC9E,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,MAAM,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/scripts/once/once.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Run the once orchestrator — full ticket lifecycle.
+ *
+ * @param argv - Process arguments (supports `--dry-run` flag).
+ *
+ * @example
+ * ```ts
+ * await run(process.argv);
+ * ```
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=once.d.ts.map

package/dist/scripts/once/once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"once.d.ts","sourceRoot":"","sources":["../../../src/scripts/once/once.ts"],"names":[],"mappings":"AAuPA;;;;;;;;;GASG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0NvD"}

package/dist/scripts/once/once.js

@@ -0,0 +1,330 @@
+/**
+ * Unified once orchestrator — replaces all three `clancy-once-*.sh` scripts.
+ *
+ * Full lifecycle: preflight → detect board → fetch ticket → compute branches →
+ * [dry-run gate] → transition In Progress → create branch → invoke Claude →
+ * squash merge → transition Done → log → notify.
+ *
+ * All errors exit with code 0 (not 1). This is intentional — the AFK runner
+ * detects stop conditions by parsing stdout, not exit codes.
+ */
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { closeIssue, fetchIssue as fetchGitHubIssue, isValidRepo, pingGitHub, } from '../../scripts/board/github/github.js';
+import { buildAuthHeader, fetchTicket as fetchJiraTicket, isSafeJqlValue, pingJira, transitionIssue as transitionJiraIssue, } from '../../scripts/board/jira/jira.js';
+import { fetchIssue as fetchLinearIssue, isValidTeamId, pingLinear, transitionIssue as transitionLinearIssue, } from '../../scripts/board/linear/linear.js';
+import { computeTargetBranch, computeTicketBranch, } from '../../scripts/shared/branch/branch.js';
+import { invokeClaudeSession } from '../../scripts/shared/claude-cli/claude-cli.js';
+import { detectBoard } from '../../scripts/shared/env-schema/env-schema.js';
+import { checkout, currentBranch, deleteBranch, ensureBranch, squashMerge, } from '../../scripts/shared/git-ops/git-ops.js';
+import { sendNotification } from '../../scripts/shared/notify/notify.js';
+import { runPreflight } from '../../scripts/shared/preflight/preflight.js';
+import { appendProgress } from '../../scripts/shared/progress/progress.js';
+import { buildPrompt } from '../../scripts/shared/prompt/prompt.js';
+import { bold, dim, green, red, yellow } from '../../utils/ansi/ansi.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function formatDuration(ms) {
+    const secs = Math.floor(ms / 1000);
+    if (secs < 60)
+        return `${secs}s`;
+    const mins = Math.floor(secs / 60);
+    const remSecs = secs % 60;
+    return remSecs > 0 ? `${mins}m ${remSecs}s` : `${mins}m`;
+}
+// ─── Board-specific fetch ────────────────────────────────────────────────────
+async function fetchTicket(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            const ticket = await fetchJiraTicket(env.JIRA_BASE_URL, auth, env.JIRA_PROJECT_KEY, env.CLANCY_JQL_STATUS ?? 'To Do', env.CLANCY_JQL_SPRINT, env.CLANCY_LABEL);
+            if (!ticket)
+                return undefined;
+            const blockerStr = ticket.blockers.length
+                ? `Blocked by: ${ticket.blockers.join(', ')}`
+                : 'None';
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.epicKey ?? 'none',
+                blockers: blockerStr,
+            };
+        }
+        case 'github': {
+            const { env } = config;
+            const ticket = await fetchGitHubIssue(env.GITHUB_TOKEN, env.GITHUB_REPO, env.CLANCY_LABEL);
+            if (!ticket)
+                return undefined;
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.milestone ?? 'none',
+                blockers: 'None',
+            };
+        }
+        case 'linear': {
+            const { env } = config;
+            const ticket = await fetchLinearIssue({
+                LINEAR_API_KEY: env.LINEAR_API_KEY,
+                LINEAR_TEAM_ID: env.LINEAR_TEAM_ID,
+                CLANCY_LABEL: env.CLANCY_LABEL,
+            });
+            if (!ticket)
+                return undefined;
+            return {
+                key: ticket.key,
+                title: ticket.title,
+                description: ticket.description,
+                parentInfo: ticket.parentIdentifier ?? 'none',
+                blockers: 'None',
+                linearIssueId: ticket.issueId,
+            };
+        }
+    }
+}
+// ─── Board-specific ping ─────────────────────────────────────────────────────
+async function pingBoard(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            return pingJira(env.JIRA_BASE_URL, env.JIRA_PROJECT_KEY, auth);
+        }
+        case 'github':
+            return pingGitHub(config.env.GITHUB_TOKEN, config.env.GITHUB_REPO);
+        case 'linear':
+            return pingLinear(config.env.LINEAR_API_KEY);
+    }
+}
+// ─── Board-specific validation ───────────────────────────────────────────────
+function validateInputs(config) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            if (!isSafeJqlValue(env.JIRA_PROJECT_KEY)) {
+                return '✗ JIRA_PROJECT_KEY contains invalid characters';
+            }
+            if (env.CLANCY_LABEL && !isSafeJqlValue(env.CLANCY_LABEL)) {
+                return '✗ CLANCY_LABEL contains invalid characters';
+            }
+            if (env.CLANCY_JQL_STATUS && !isSafeJqlValue(env.CLANCY_JQL_STATUS)) {
+                return '✗ CLANCY_JQL_STATUS contains invalid characters';
+            }
+            return undefined;
+        }
+        case 'github': {
+            if (!isValidRepo(config.env.GITHUB_REPO)) {
+                return '✗ GITHUB_REPO format is invalid — expected owner/repo';
+            }
+            return undefined;
+        }
+        case 'linear': {
+            if (!isValidTeamId(config.env.LINEAR_TEAM_ID)) {
+                return '✗ LINEAR_TEAM_ID contains invalid characters';
+            }
+            return undefined;
+        }
+    }
+}
+// ─── Board-specific transitions ──────────────────────────────────────────────
+async function transitionToStatus(config, ticket, statusName) {
+    switch (config.provider) {
+        case 'jira': {
+            const { env } = config;
+            const auth = buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN);
+            const issueKey = ticket.key;
+            const ok = await transitionJiraIssue(env.JIRA_BASE_URL, auth, issueKey, statusName);
+            if (ok)
+                console.log(`  → Transitioned to ${statusName}`);
+            break;
+        }
+        case 'github': {
+            // GitHub Issues only has open/closed — status transitions not applicable
+            // closeIssue is called separately after merge
+            break;
+        }
+        case 'linear': {
+            const { env } = config;
+            if (!ticket.linearIssueId)
+                break;
+            const ok = await transitionLinearIssue(env.LINEAR_API_KEY, env.LINEAR_TEAM_ID, ticket.linearIssueId, statusName);
+            if (ok)
+                console.log(`  → Transitioned to ${statusName}`);
+            break;
+        }
+    }
+}
+// ─── Main orchestrator ───────────────────────────────────────────────────────
+/**
+ * Run the once orchestrator — full ticket lifecycle.
+ *
+ * @param argv - Process arguments (supports `--dry-run` flag).
+ *
+ * @example
+ * ```ts
+ * await run(process.argv);
+ * ```
+ */
+export async function run(argv) {
+    const dryRun = argv.includes('--dry-run');
+    const startTime = Date.now();
+    console.log(dim('┌──────────────────────────────────────┐'));
+    console.log(dim('│') + bold('  🤖 Clancy — once mode              ') + dim('│'));
+    console.log(dim('│') + dim('  "Let\'s roll."                      ') + dim('│'));
+    console.log(dim('└──────────────────────────────────────┘'));
+    console.log('');
+    let originalBranch;
+    try {
+        // 1. Preflight
+        const preflight = runPreflight(process.cwd());
+        if (!preflight.ok) {
+            console.log(preflight.error);
+            return;
+        }
+        if (preflight.warning) {
+            console.log(preflight.warning);
+        }
+        // 2. Detect board
+        const boardResult = detectBoard(preflight.env);
+        if (typeof boardResult === 'string') {
+            console.log(boardResult);
+            return;
+        }
+        const config = boardResult;
+        // 3. Validate board-specific inputs
+        const validationError = validateInputs(config);
+        if (validationError) {
+            console.log(validationError);
+            return;
+        }
+        // 4. Ping board
+        const ping = await pingBoard(config);
+        if (!ping.ok) {
+            console.log(ping.error);
+            return;
+        }
+        console.log(green('✅ Preflight passed'));
+        // 5. Fetch ticket
+        const ticket = await fetchTicket(config);
+        if (!ticket) {
+            console.log(dim('No tickets found. All done!'));
+            return;
+        }
+        // 6. Compute branches
+        const baseBranch = config.env.CLANCY_BASE_BRANCH ?? 'main';
+        const parent = ticket.parentInfo !== 'none' ? ticket.parentInfo : undefined;
+        const ticketBranch = computeTicketBranch(config.provider, ticket.key);
+        const targetBranch = computeTargetBranch(config.provider, baseBranch, parent);
+        // 7. Dry-run gate
+        if (dryRun) {
+            const parentLabel = config.provider === 'github' ? 'Milestone' : 'Epic';
+            console.log('');
+            console.log(yellow('── Dry Run ──────────────────────────────────────'));
+            console.log(`  Ticket:         ${bold(`[${ticket.key}]`)} ${ticket.title}`);
+            console.log(`  ${parentLabel}:${' '.repeat(14 - parentLabel.length)}${ticket.parentInfo}`);
+            if (config.provider !== 'github') {
+                console.log(`  Blockers:       ${ticket.blockers}`);
+            }
+            console.log(`  Target branch:  ${ticketBranch} → ${targetBranch}`);
+            console.log(yellow('─────────────────────────────────────────────────'));
+            console.log(dim('  No changes made. Remove --dry-run to run for real.'));
+            return;
+        }
+        // 8. Print ticket info
+        const parentLabel = config.provider === 'github' ? 'Milestone' : 'Epic';
+        console.log('');
+        console.log(`🎫 ${bold(`[${ticket.key}]`)} ${ticket.title}`);
+        console.log(dim(`  ${parentLabel}: ${ticket.parentInfo} | Branch: ${ticketBranch} → ${targetBranch}`));
+        if (config.provider !== 'github' && ticket.blockers !== 'None') {
+            console.log(yellow(`  Blockers: ${ticket.blockers}`));
+        }
+        console.log('');
+        // 9. Git: set up branches
+        originalBranch = currentBranch();
+        ensureBranch(targetBranch, baseBranch);
+        checkout(targetBranch);
+        checkout(ticketBranch, true);
+        // 10. Transition to In Progress (best-effort)
+        const statusInProgress = config.env.CLANCY_STATUS_IN_PROGRESS;
+        if (statusInProgress) {
+            await transitionToStatus(config, ticket, statusInProgress);
+        }
+        // 11. Build prompt and invoke Claude
+        const prompt = buildPrompt({
+            provider: config.provider,
+            key: ticket.key,
+            title: ticket.title,
+            description: ticket.description,
+            parentInfo: ticket.parentInfo,
+            blockers: config.provider !== 'github' ? ticket.blockers : undefined,
+        });
+        const claudeOk = invokeClaudeSession(prompt, config.env.CLANCY_MODEL);
+        if (!claudeOk) {
+            console.log(yellow('⚠ Claude session exited with an error. Skipping merge.'));
+            return;
+        }
+        // 12. Squash merge
+        checkout(targetBranch);
+        const commitMsg = `feat(${ticket.key}): ${ticket.title}`;
+        const hadChanges = squashMerge(ticketBranch, commitMsg);
+        if (!hadChanges) {
+            console.log(yellow('⚠ No changes staged after squash merge. Claude may not have committed any work.'));
+        }
+        // 13. Delete feature branch
+        deleteBranch(ticketBranch);
+        // 14. Transition to Done / close issue (best-effort)
+        const statusDone = config.env.CLANCY_STATUS_DONE;
+        if (config.provider === 'github') {
+            const issueNumber = parseInt(ticket.key.replace('#', ''), 10);
+            if (Number.isNaN(issueNumber)) {
+                console.log(`⚠ Could not parse issue number from ${ticket.key}. Close it manually on GitHub.`);
+            }
+            else {
+                const closed = await closeIssue(config.env.GITHUB_TOKEN, config.env.GITHUB_REPO, issueNumber);
+                if (!closed) {
+                    console.log(`⚠ Could not close issue ${ticket.key}. Close it manually on GitHub.`);
+                }
+            }
+        }
+        else if (statusDone) {
+            await transitionToStatus(config, ticket, statusDone);
+        }
+        // 15. Log progress
+        appendProgress(process.cwd(), ticket.key, ticket.title, 'DONE');
+        const elapsed = formatDuration(Date.now() - startTime);
+        console.log('');
+        console.log(green(`🏁 ${ticket.key} complete`) + dim(` (${elapsed})`));
+        console.log(dim('  "Bake \'em away, toys."'));
+        // 16. Send notification (best-effort)
+        const webhook = config.env.CLANCY_NOTIFY_WEBHOOK;
+        if (webhook) {
+            await sendNotification(webhook, `✓ Clancy completed [${ticket.key}] ${ticket.title}`);
+        }
+    }
+    catch (error) {
+        // Unexpected errors — print and exit cleanly (exit 0 for AFK loop compat)
+        const msg = error instanceof Error ? error.message : String(error);
+        const elapsed = formatDuration(Date.now() - startTime);
+        console.error('');
+        console.error(red(`❌ Clancy stopped`) + dim(` (${elapsed})`));
+        console.error(red(`   ${msg}`));
+        console.error(dim('  "I\'d rather let Herman go."'));
+        // Best-effort: restore the branch the user was on before Clancy started
+        if (originalBranch) {
+            try {
+                checkout(originalBranch);
+            }
+            catch {
+                // Ignore — branch restore is best-effort
+            }
+        }
+    }
+}
+// Main guard — self-execute when run directly (e.g. node .clancy/clancy-once.js)
+if (process.argv[1] &&
+    fileURLToPath(import.meta.url) === resolve(process.argv[1])) {
+    run(process.argv);
+}
+//# sourceMappingURL=once.js.map